From 6e1ac0c46b67db98bba6ebaa6f60546c72389cad Mon Sep 17 00:00:00 2001 From: Simon Date: Wed, 5 Aug 2026 21:03:21 +0800 Subject: [PATCH] =?UTF-8?q?docs(README):=20=E5=90=8C=E6=AD=A5=E9=A1=B9?= =?UTF-8?q?=E7=9B=AE=E7=8E=B0=E7=8A=B6=EF=BC=88Sprint=207=20=E6=97=A5?= =?UTF-8?q?=E6=8A=A5=20API=E3=80=81=E4=BC=98=E5=8C=96=E7=9B=AE=E6=A0=87=20?= =?UTF-8?q?7=20=E7=A7=8D=E3=80=81=E6=8A=80=E6=9C=AF=E6=A0=88=E7=89=88?= =?UTF-8?q?=E6=9C=AC=E4=BF=AE=E6=AD=A3=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) 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） ## 数据库连接