# 星图达人视频传播数据导出 Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** 导出 CSV 前按配置调用 `get_author_spread_info`，追加个人视频和星图视频传播指标列。

**Architecture:** 新增独立的 spread-info 模块负责参数配置、URL、响应映射和并发加载；列表解析保留 `authorId`，额外保存 `spreadAuthorId` 作为 `o_author_id`；CSV exporter 只负责把已加载的 spread metrics 输出成列。导出入口在生成 CSV 前补齐 spread metrics。

**Tech Stack:** TypeScript, Chrome content script, Vitest, jsdom.

---

### Task 1: Spread Info Client And Mapping

**Files:**
- Create: `src/content/market/spread-info.ts`
- Modify: `src/content/market/types.ts`
- Test: `tests/spread-info.test.ts`

- [ ] **Step 1: Write failing tests**

Cover URL construction, label/header generation, response mapping, personal-video fixed params, and Xingtu-video multi-param configs.

- [ ] **Step 2: Run failing tests**

Run: `npx vitest run tests/spread-info.test.ts`
Expected: FAIL because `spread-info.ts` does not exist.

- [ ] **Step 3: Implement spread-info module and types**

Implement typed configs, formatter helpers, response mapper, client, and limited-concurrency loader.

- [ ] **Step 4: Run tests**

Run: `npx vitest run tests/spread-info.test.ts`
Expected: PASS.

### Task 2: Preserve Spread Author ID From Search Rows

**Files:**
- Modify: `src/content/market/types.ts`
- Modify: `src/content/market/market-list-row.ts`
- Modify: `src/content/market/page-bridge.ts`
- Test: `tests/market-page-bridge.test.ts`
- Test: `tests/silent-export-controller.test.ts`

- [ ] **Step 1: Write failing tests**

Verify `attribute_datas.id` is retained as `spreadAuthorId` and preferred over top-level `star_id` for spread-info requests.

- [ ] **Step 2: Run failing tests**

Run focused tests for row parsing and silent export.

- [ ] **Step 3: Implement parser changes**

Store `spreadAuthorId` on snapshots and merge it in result store.

- [ ] **Step 4: Run focused tests**

Expected: PASS.

### Task 3: CSV Columns

**Files:**
- Modify: `src/content/market/csv-exporter.ts`
- Test: `tests/csv-exporter.test.ts`

- [ ] **Step 1: Write failing tests**

Verify spread headers append after backend metrics and blank cells are exported when metrics are absent.

- [ ] **Step 2: Implement CSV spread columns**

Read `record.spreadMetrics` by generated header names.

- [ ] **Step 3: Run focused tests**

Run: `npx vitest run tests/csv-exporter.test.ts`
Expected: PASS.

### Task 4: Export Hydration

**Files:**
- Modify: `src/content/market/index.ts`
- Modify: `src/content/market/result-store.ts`
- Test: `tests/market-content-entry.test.ts`

- [ ] **Step 1: Write failing tests**

Verify export calls spread-info with `spreadAuthorId`, waits before CSV generation, preserves row order, and leaves blanks on failure.

- [ ] **Step 2: Implement hydration**

Inject `loadSpreadMetrics` for tests, default to spread-info loader, and hydrate records before `buildCsv`.

- [ ] **Step 3: Run focused tests**

Run focused content-entry tests.

### Task 5: Final Verification

- [ ] Run `npm test`.
- [ ] Run `npm run build`.
- [ ] Review `git diff`.