diff --git a/README.md b/README.md index 04932b2..cc1e573 100644 --- a/README.md +++ b/README.md @@ -18,8 +18,8 @@ cc-cursor/ │ ├── cli/ # 命令行 & 验证脚本 │ ├── reports/ # 自动日报输出目录 │ └── .env # 环境变量配置(API Key / 分析范围) -├── djapi/ # Django API 后端(已有) -├── mcp-servers/ # MCP Server(Serena) +├── djapi/ # Django API 后端(A 股数据 + 新闻联播 + 日报查询) +├── mcp-servers/ # MCP Server(Serena,本机工具,git 忽略) ├── shared/ # 共享工具(SSH 隧道脚本) ├── docs/ # 文档 & 使用指南 └── .claude/ # Claude Code 配置 @@ -60,8 +60,9 @@ Agent 编排层 | Sprint 4 | ML 模型 | LightGBM + CatBoost + 特征工程 | ✅ | | Sprint 5 | 情绪因子 | Qwen + 三源新闻聚合 + 日期对齐 | ✅ | | Sprint 6 | Agent 系统 | 4 Agent + 编排器 + CLI + 自动日报 | ✅ | +| Sprint 7 | djapi API | 日报查询 ×2(news/reports + news/events) | ✅ | -**全部 7 个 Sprint 已完成。** +**全部 8 个 Sprint 已完成。** --- @@ -117,7 +118,7 @@ result = OptunaEngine(engine_bt).optimize( # → 夏普: 0.37→0.60 (+62%), 回撤: -19.1%→-1.8% (10倍改善) ``` -6 种优化目标 + 4 个预置搜索空间 + Walk-Forward 滚动验证 + 快捷函数。 +7 种优化目标 + 4 个预置搜索空间 + Walk-Forward 滚动验证 + 快捷函数。 ### ML 模型 `finance/models/` @@ -181,6 +182,7 @@ python finance/cli/demo_backtest.py # Sprint 2 — 回测引擎 python finance/cli/demo_optimizer.py # Sprint 3 — 参数优化 python finance/cli/demo_ml.py # Sprint 4 — ML 模型 python finance/cli/demo_sentiment.py # Sprint 5 — 情绪因子 +python finance/cli/demo_sentiment_detail.py # Sprint 5 — 情绪因子(单股详情) ``` --- @@ -189,16 +191,16 @@ python finance/cli/demo_sentiment.py # Sprint 5 — 情绪因子 | 组件 | 技术 | 版本 | 状态 | |------|------|------|------| -| 数据获取 | AkShare | 1.18 | ✅ | +| 数据获取 | AkShare | 1.18.64 | ✅ | | 数据库 | MariaDB (SSH 隧道) | — | ✅ | -| 因子/特征 | pandas / numpy / sklearn | 3.0 / 2.4 / 1.9 | ✅ | +| 因子/特征 | pandas / numpy / sklearn | 2.3 / 2.0 / 1.9 | ✅ | | 回测引擎 | VectorBT | 1.0 | ✅ | | 参数优化 | Optuna | 4.9 | ✅ | | ML 模型 | LightGBM / CatBoost | 4.6 / 1.2 | ✅ | | NLP 情绪 | Qwen (DashScope / Ollama) | turbo / 2.5 | ✅ | | Agent 框架 | 自研编排器 | — | ✅ | | API 后端 | Django + uWSGI | 5.2 | 已有 | -| 代码分析 | Serena MCP | — | 已配置 | +| 代码分析 | Serena MCP | — | 本机工具(不随仓库分发) | --- @@ -209,16 +211,17 @@ python finance/cli/demo_sentiment.py # Sprint 5 — 情绪因子 - **数据层统一**:策略/模型不直连数据源,全部通过 DataManager - **Agent 不重建轮子**:Agent 通过依赖注入复用已有引擎,编排而非重建 - **防前视偏差**:时间序列交叉验证、expanding window 统计量 -- **渐进演进**:全链路 7 个 Sprint 平滑推进,无推倒重写 +- **渐进演进**:全链路 8 个 Sprint 平滑推进,无推倒重写 ## 文档 - [使用指南](./docs/usage.md) — 详细使用说明(12 章节,含代码示例) - [使用指南 (HTML)](./docs/usage.html) — 网页版使用指南 +- [新闻日报 API](./docs/news_report_api.md) — djapi 日报查询接口使用手册 ## 子项目 -- [djapi](./djapi/README.md) — Django API 后端,A 股数据 API + 新闻联播视频处理 +- [djapi](./djapi/README.md) — Django API 后端:A 股数据 API(16 端点)+ 新闻联播处理 + 日报查询(news/reports、news/events) ## 数据库连接