llm-quant/docs/TODO.md

83 lines
5.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 项目工作总览
> 汇总全局工作项,统一标记完成情况,避免重复维护;如需细化请在同一条目下更新备注。状态含义:✅ 已完成|🔄 进行中|⏳ 待启动。
## 数据与特征
| 工作项 | 状态 | 说明 |
| --- | --- | --- |
| 因子计算流水线 | ✅ | 新增 `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。 |