# 项目工作总览

> 汇总全局工作项，统一标记完成情况，避免重复维护；如需细化请在同一条目下更新备注。状态含义：✅ 已完成｜🔄 进行中｜⏳ 待启动。

## 数据与特征

| 工作项 | 状态 | 说明 |
| --- | --- | --- |
| 因子计算流水线 | ✅ | 新增 `scripts/run_factor_pipeline.py` 支撑增量/干跑模式，并提供 `factor_audit` 审计报表。 |
| DataBroker 弹性 | ✅ | 集成 `evaluate_data_quality()` 评分与分级汇总，可直接输出阻塞项。 |
| 因子库扩展 | ✅ | 补齐因子权重优化与组合回测评估，支持组合度量与组件表现。 |
| 新闻数据接入 | ✅ | 实体识别与时效热度打分落地，并配套单元测试验证字段持久化。 |
| 数据完整性体系 | ✅ | 新增 `scripts/run_data_integrity.py` 自动巡检，异常触发告警并可联动补数。 |
| 选股使用预计算因子 | ✅ | 回测引擎统一加载 `factors.*` 快照，默认不再重复计算核心因子。 |
| 因子公式复核 | ✅ | 提供 `factor_audit` 工具与文档，支持公式复核与漂移检测。 |

## 决策优化与强化学习

| 工作项 | 状态 | 说明 |
| --- | --- | --- |
| DecisionEnv 扩展 | ✅ | Episode 指标现已包含 Sharpe/Calmar，奖励函数集成风险惩罚并覆写提示版本、function 策略等部门控制。 |
| 强化学习基线 | ✅ | PPO/SAC 等连续动作算法已接入并形成实验基线。 |
| 奖励与评估体系 | ✅ | 决策环境奖励结合风险/Turnover/Sharpe-Calmar，并同步输出成交与资金曲线指标。 |
| 实时持仓链路 | ✅ | 新增 `app/utils/portfolio_sync.py`，回测与实时持仓、成交数据统一写入 `portfolio_*` 表供离线调参与监控共享。 |
| 全局参数搜索 | ✅ | epsilon-greedy + 高斯过程贝叶斯优化 + BOHB 继任者已落地，输出全量调参与指标。 |

## 多智能体协同与 LLM

| 工作项 | 状态 | 说明 |
| --- | --- | --- |
| Provider 与 function 架构 | ✅ | Provider 管理、function-calling 降级与重试策略已收敛。 |
| 提示模板治理 | ✅ | LLM 设置提供模板版本治理、元数据维护与调用监控，待补充成本/效果分析。 |
| 部门遥测可视化 | ✅ | 设置页已支持部门/全局遥测筛选、导出与动态限额调节。 |
| 多轮逻辑博弈框架 | ✅ | 主持 briefing、预测对齐、风险复核与冲突回合均已串联上线。 |
| LLM 稳定性提升 | ✅ | Provider 级限速、响应缓存与成本守卫协同生效，支撑平滑降级策略。 |

## UI 与监控

| 工作项 | 状态 | 说明 |
| --- | --- | --- |
| 一键重评估入口 | ✅ | 今日计划页提供批量/全量重评估入口，待收集反馈再做优化。 |
| 回测实验对比 | ✅ | 会话实验保存、曲线/指标对比与日期过滤均已落地，后续按需扩充提示参数。 |
| 实时指标面板 | ✅ | Streamlit 监控页已具备核心实时指标。 |
| 异常日志钻取 | ✅ | 日志视图支持时间/级别/阶段筛选、关键词搜索及双日期历史对比导出。 |
| 仅监控模式 | ✅ | 今日计划页新增监控模式一键重评估，预览策略而不写入数据库。 |
| 风险预警面板 | ✅ | 风险预警能力已落地，仍需持续扩充指标。 |

## 风险控制与执行

| 工作项 | 状态 | 说明 |
| --- | --- | --- |
| 风险代理决策闭环 | ✅ | `risk_round` 支持按场景回写 `risk_assessment`、触发人手/自动兜底策略，并已接入决策追踪报表。 |
| 风险事件持久化 | ✅ | `risk_round` 事件现已批量写入 `bt_risk_events`，附带风险状态/元数据并在回测面板支持 Drill-down。 |
| 实时告警接入 | ✅ | 引入告警分发器支持配置化 webhook 通道，风险阻断/复核即时推送至外部渠道。 |
| 风险场景测试 | ✅ | 新增停牌、仓位超限、黑名单等集成测试覆盖，验证风险闭环执行。 |

## 测试与质量保障

| 工作项 | 状态 | 说明 |
| --- | --- | --- |
| 单元/集成测试覆盖 | ⏳ | 补充部门上下文、LLM 调用、回测指标等核心路径测试。 |
| 决策流程回归集 | ⏳ | 建立提示模板调整后的回归用例，确保行为可复现。 |
| 数据质量验证 | 🔄 | 自检页面新增候选/策略/持仓/新闻质量检查，后续补自动化管线。 |
| 教程与示例 | ⏳ | 编写 Notebook 或 End-to-End 教程覆盖“数据→回测→调参→评估”。 |
| 日志收集机制 | ⏳ | 完善日志聚合与查询工具，支撑问题定位。 |

## 文档与知识库

| 工作项 | 状态 | 说明 |
| --- | --- | --- |
| README 对外化 | 🔄 | 重写支持快速了解定位、功能、部署方式（本轮更新进行中）。 |
| 原理文档分册 | 🔄 | 多智能体、强化学习调参、风险控制等原理文档按专题拆分。 |
| 业务流程手册 | ⏳ | 梳理投研/交易流程，评估代码实现是否吻合业务需求。 |
| 文档同步机制 | ⏳ | 建立功能迭代后的文档更新流程与责任人。 |

## 架构与代码整洁

| 工作项 | 状态 | 说明 |
| --- | --- | --- |
| 全量代码审查 | 🔄 | 已制定 `docs/architecture/code_review_checklist.md`，按 checklist 推进模块审查。 |
| TODO 标记治理 | 🔄 | 新增 `scripts/todo_report.py` 支撑定期扫描，待梳理遗留项目。 |
| 业务逻辑体检 | ✅ | 梳理业务链路完成，已拆分采集/覆盖/决策模块；详见 docs/architecture/business_logic_healthcheck.md。 |