feat: 板块指数分析 PR4 — Pipeline/CLI 集成（Phase 1）

[ZhuLinsen]

背景

拆分自 #2063（板块指数分析 — 方案讨论），承接 #2208（PR3 数据路由）之后的 PR 4：Pipeline 集成。

范围

• 在 Pipeline 能力矩阵中接入指数标的（搜索、报告生成、DecisionSignal 等下游消费方需识别 asset_type = index）。
• Phase 1（本 PR 范围）：CLI 入口（main.py --stocks 等）支持指数标的分析。
• Phase 2（后续，不在本 issue 范围内）：Web / Bot / GitHub Actions 定时任务接入。
• 复用现有 src/core/pipeline.py、src/services/ 报告与信号生成逻辑，不新建平行分析链路。

验收标准

• CLI 可对至少一个指数标的（如 000300.CSI）跑通完整分析并生成报告，报告结构与个股报告保持兼容（新增字段而非破坏性变更）。
• 补充覆盖指数标的分析入口的确定性测试。
• 若涉及报告结构变化，同步 docs/*.md 与 docs/CHANGELOG.md。
• 明确说明 Phase 2（Web/Bot/Actions）不在本 PR 范围，作为独立后续任务跟进。

依赖

• 依赖 feat: 板块指数分析 PR3 — 指数数据源 fallback 路由 #2208（指数数据源 fallback 路由）。

[ZhuLinsen]

结论
这个 PR4 的 Phase 1 可以直接落在现有 CLI -> Pipeline 主链路上做，没必要新开平行分析入口。当前仓库里 main.py 和 TaskService 已经接了 resolve_index_stock_code_for_analysis，但仍然把 --stocks 压平成普通字符串列表传给 src/core/pipeline.py，所以真正缺的不是“CLI 参数支持”，而是把指数目标的 asset_type=index 语义保留到分析、报告和下游消费阶段。

建议排查

• 入口建议直接从 main.py 的 --stocks 解析切到 src/services/stock_list_parser.py 的结构化目标，而不是继续只用 resolve_index_stock_code_for_analysis。原因是现有 parse_analysis_target() 已经明确了“显式指数前缀才识别为 index、裸六码默认仍是 stock”的契约，能避免把 000300 这类裸码语义改坏；验收示例里如果要跑 000300.CSI，也建议先统一成仓库当前已存在的显式指数 token 规范，否则还要额外补一层别名映射。
• src/core/pipeline.py 当前 run()、process_single_stock()、analyze_stock() 都是按 List[str] / code: str 设计的，Phase 1 最小实现应当是在这条链路上增加“目标对象或最少的 asset_type/canonical_id 元信息”透传，而不是只在 main.py 做一次解析后又丢掉。否则后面的 get_stock_name()、get_realtime_quote()、get_chip_distribution()、_get_analysis_context_with_market_fallback() 仍会把指数当普通股票处理。
• 下游兼容点要优先收口在报告与 DecisionSignal。现在 src/services/decision_signal_extractor.py 仍按 stock_code + market + source_type=analysis 建信号，且 get_market_for_stock(normalize_stock_code(raw_code)) 是前置条件；如果指数代码不能被这套市场识别逻辑稳定接受，保存历史后会静默跳过信号提取。Phase 1 至少要明确二选一：要么让指数也能走同一条 DecisionSignal 语义链路，要么先保留报告兼容、并对 index 显式跳过信号提取且补测试，避免出现“分析成功但下游无结果且无明确边界”的状态。
• 测试不要只补 main.py 参数解析，至少覆盖 3 条确定性路径：--stocks 显式指数 token 能进入 pipeline；src/core/pipeline.py 对 index 不会错误走个股默认分支；报告/历史快照里新增字段后仍兼容现有个股结构。现有更接近的落点是新增独立的 CLI/Pipeline 回归测试文件，而不是塞进无关的通知或调度测试。
• 文档上建议同步 docs/CHANGELOG.md，并在相关 docs/*.md 明确写清楚“本 PR 仅支持 CLI Phase 1，Web / Bot / GitHub Actions 仍不在范围内”；另外最好把可用的指数输入写成实际支持的 token 形式，避免验收标准继续使用仓库里尚未形成统一契约的 000300.CSI。

---

🤖 此回复由 OpenReview Bot 自动生成，仅供参考。如有疑问请 @维护者。