docs: 记录 v3 开发执行状态（M9 + 支撑线 + 延后项）

docs/DEV_PLAN_v3.md

@@ -44,7 +44,18 @@ SQLite→MySQL 迁移数据 16,057,265 行校验一致（M-DB）。
 
 ---
 
-## 1. 下一阶段主线：M9 可视化与成交口径（对齐 v3 新重点）
+## 1. 执行状态（2026-09：主线与可自证支撑已交付）
+
+> M9（Chart/回测历史/个股页/双图库/复权口径/Bar Replay）、B1（指数历史成分）、
+> C1（因子相关性）、C2（单股上限执行）、D1（Job stage+列表/取消）、D2（选股 Job 化）、
+> D4（Agent 14 工具）均已完成并提交（ROADMAP V3 行含 commit；每阶段全量 pytest + ruff，
+> 前端 tsc 通过；B1/D2 迁移已应用 MySQL）。
+> 延后项与原因：B2/B3（停牌/ST/三大报表：依赖 Tushare 对应接口权限，离线无法端到端验证，
+> 留 `sync` 扩展点）、B4（结果实体化：现行 JSON 快照已可复现，实体化按需）、
+> C3（Qlib 模型选股：计划标注「按需」）、D3（Redis：未出现排队/广播触发场景，
+> config 预留 `redis.url` 即可启用）。
+
+## 2. 主线：M9 可视化与成交口径（对齐 v3 新重点）
 
 > 目标：把已能产生的 Selection / Signal / Backtest 结果变成**同一时间轴上、可解释、
 > Signal↔Fill 分明**的个股与组合视图。前端一律消费 Chart API 的 ChartResult（v3 §20.1），

docs/ROADMAP.md

@@ -25,6 +25,9 @@
 | M6 ✅ | 选股系统主线（Universe + Selection A条件/B评分 + 落库/API + 回测共用 + Web 页） | 2026-09 · f3586ad…0ab9038 |
 | M7 ✅ | 因子层（factor_definition 入库 + Composite 模块化/落库 + 口径显式化） | 2026-09 · 8f47b5b…ef09d5b |
 | M8 ✅ | Signal/Portfolio/Strategy + Agent 工具(10) + Web 做实 | 2026-09 · ba52edc…e5a23f1（M8.4 模型选股：按需延后） |
+| V3-M9 ✅ | v3 主线：Chart Service/API + Signal↔Fill 历史 + 个股研究页 + 双图库 + 复权口径 + Bar Replay | 2026-09 · 995ed08…03fb463 |
+| V3-S ✅ | 支撑线：B1 指数历史成分、C1 因子相关、C2 单股上限、D1 Job stage/取消、D2 选股 Job 化、D4 Agent 14 工具 | 2026-09 · 9cc4bfc…861a405 |
+| V3-DEFERRED | B2/B3（停牌·ST·三大报表，依赖真实数据权限）、B4（结果实体化）、C3（Qlib 模型选股）、D3（Redis 触发） | 按需延后 · 见 DEV_PLAN_v3 §1 |
 
 每阶段结束时同步更新：README / AGENT.md 相关清单 / 文档；**禁止跨阶段提前堆量**（AGENT.md §38）。
 

docs/USAGE.md

@@ -23,7 +23,7 @@
 | 策略 | `strategy` 落库 + `/api/strategies`（命名策略，可展开为回测 spec） |
 | Web | `frontend/web`：总览 / 股票池 / **股票筛选** / 因子研究 / 因子组合 / **交易信号** / 选股回测 / 实验 |
 | 异步与归档 | Job 状态机 + Experiment 自动归档 + 一键复跑 + SSE 进度 |
-| AI Agent | 10 个受控工具 + LLM 编排（需配置模型 Key） |
+| AI Agent | **14 个受控工具**（v3 §25 全清单）+ LLM 编排 |
 
 **技术栈**：Python 3.12(uv) · FastAPI · SQLAlchemy 2 · Alembic · **MySQL(pymysql)**（SQLite 兜底）· pandas · pyarrow(Parquet) · pyqlib 0.9.8.dev32(源码安装) · LightGBM · Next.js 15 · ECharts · Redis（本机 127.0.0.1:6379 已就绪，触发时接入）
 
@@ -260,7 +260,13 @@ curl -X POST http://127.0.0.1:8000/api/backtests \
 | `GET /api/experiments` | 实验归档列表（收益摘要/代码版本） |
 | `GET /api/experiments/{id}` | 实验详情（spec + 完整结果） |
 | `POST /api/experiments/{id}/rerun` | 一键复跑 → 新 Job |
-| `POST /api/agent/chat` | AI 研究助手（见 §7） |
+| `GET /api/stocks/{symbol}/chart\|signals\|selections` | Chart API：K线/量/MA/复权显示 + 该股历史标记 |
+| `GET /api/backtests/{experiment_id}/stocks/{symbol}/chart\|trades\|positions` | 回测个股图（fills/成交）/明细 |
+| `POST /api/factor-correlations` | 多因子横截面 Spearman 相关矩阵 |
+| `POST /api/replays` | Bar Replay 线性重放（as_of 逐日，白名单≤40/区间≤90） |
+| `GET /api/jobs` / `POST /api/jobs/{id}/cancel` | Job 列表 / 取消（含 stage 字段上报） |
+| `POST /api/selections/jobs` | 全市场/长任务选股异步 Job（Web 页「异步」按钮） |
+| `POST /api/agent/chat` | AI 研究助手（见 §7，14 个受控工具） |
 
 **防未来函数与真实性**：回测在调仓日收盘成交、自次日起计收益；财务数据只使用
 `announce_date` 之前已公告内容；成本（佣金/印花税/滑点）、涨跌停、停牌已建模；
@@ -327,7 +333,7 @@ pnpm run build
 
 ## 9. 已知限制与说明
 
-1. **Qlib 模型选股（Selection 模式 C）未实现**：当前选股为条件（A）/因子评分（B）；
+1. **Qlib 模型选股（Selection 模式 C）按需延后**（v3 §14.1C）：当前选股为条件（A）/因子评分（B）；
    模型预测选股（Alpha158 + LightGBM walk-forward，M8.4）为「按需」延后项
    （见 docs/DEV_PLAN_v2.md §6.4）。
 2. **全市场选股为同步请求**：无白名单的全市场选股约需 60s+；Agent 工具要求传 `symbols`