simon/myquant
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(README): 同步项目现状（Sprint 7 日报 API、优化目标 7 种、技术栈版本修正）

Browse Source
This commit is contained in:
simon
2026-08-05 21:03:21 +08:00
parent d4cfcc8f56
commit 6e1ac0c46b
1 changed files with 12 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+12 -9
View File
@@ -18,8 +18,8 @@ cc-cursor/
│ ├── cli/ # 命令行 & 验证脚本 │ ├── cli/ # 命令行 & 验证脚本
│ ├── reports/ # 自动日报输出目录 │ ├── reports/ # 自动日报输出目录
│ └── .env # 环境变量配置（API Key / 分析范围） │ └── .env # 环境变量配置（API Key / 分析范围）
├── djapi/ # Django API 后端（已有） ├── djapi/ # Django API 后端（A 股数据 + 新闻联播 + 日报查询）
├── mcp-servers/ # MCP Server（Serena） ├── mcp-servers/ # MCP Server（Serena，本机工具，git 忽略）
├── shared/ # 共享工具（SSH 隧道脚本） ├── shared/ # 共享工具（SSH 隧道脚本）
├── docs/ # 文档 & 使用指南 ├── docs/ # 文档 & 使用指南
└── .claude/ # Claude Code 配置 └── .claude/ # Claude Code 配置
@@ -60,8 +60,9 @@ Agent 编排层
| Sprint 4 | ML 模型 | LightGBM + CatBoost + 特征工程 | ✅ | | Sprint 4 | ML 模型 | LightGBM + CatBoost + 特征工程 | ✅ |
| Sprint 5 | 情绪因子 | Qwen + 三源新闻聚合 + 日期对齐 | ✅ | | Sprint 5 | 情绪因子 | Qwen + 三源新闻聚合 + 日期对齐 | ✅ |
| Sprint 6 | Agent 系统 | 4 Agent + 编排器 + CLI + 自动日报 | ✅ | | 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倍改善) # → 夏普: 0.37→0.60 (+62%), 回撤: -19.1%→-1.8% (10倍改善)
``` ```
6 种优化目标 + 4 个预置搜索空间 + Walk-Forward 滚动验证 + 快捷函数。 7 种优化目标 + 4 个预置搜索空间 + Walk-Forward 滚动验证 + 快捷函数。
### ML 模型 `finance/models/` ### 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_optimizer.py # Sprint 3 — 参数优化
python finance/cli/demo_ml.py # Sprint 4 — ML 模型 python finance/cli/demo_ml.py # Sprint 4 — ML 模型
python finance/cli/demo_sentiment.py # Sprint 5 — 情绪因子 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 隧道) | — | ✅ | | 数据库 | MariaDB (SSH 隧道) | — | ✅ |
| 因子/特征 | pandas / numpy / sklearn | 3.0 / 2.4 / 1.9 | ✅ | | 因子/特征 | pandas / numpy / sklearn | 2.3 / 2.0 / 1.9 | ✅ |
| 回测引擎 | VectorBT | 1.0 | ✅ | | 回测引擎 | VectorBT | 1.0 | ✅ |
| 参数优化 | Optuna | 4.9 | ✅ | | 参数优化 | Optuna | 4.9 | ✅ |
| ML 模型 | LightGBM / CatBoost | 4.6 / 1.2 | ✅ | | ML 模型 | LightGBM / CatBoost | 4.6 / 1.2 | ✅ |
| NLP 情绪 | Qwen (DashScope / Ollama) | turbo / 2.5 | ✅ | | NLP 情绪 | Qwen (DashScope / Ollama) | turbo / 2.5 | ✅ |
| Agent 框架 | 自研编排器 | — | ✅ | | Agent 框架 | 自研编排器 | — | ✅ |
| API 后端 | Django + uWSGI | 5.2 | 已有 | | API 后端 | Django + uWSGI | 5.2 | 已有 |
| 代码分析 | Serena MCP | — | 已配置 | | 代码分析 | Serena MCP | — | 本机工具（不随仓库分发） |
--- ---
@@ -209,16 +211,17 @@ python finance/cli/demo_sentiment.py # Sprint 5 — 情绪因子
- **数据层统一**：策略/模型不直连数据源，全部通过 DataManager - **数据层统一**：策略/模型不直连数据源，全部通过 DataManager
- **Agent 不重建轮子**：Agent 通过依赖注入复用已有引擎，编排而非重建 - **Agent 不重建轮子**：Agent 通过依赖注入复用已有引擎，编排而非重建
- **防前视偏差**：时间序列交叉验证、expanding window 统计量 - **防前视偏差**：时间序列交叉验证、expanding window 统计量
- **渐进演进**：全链路 7 个 Sprint 平滑推进，无推倒重写 - **渐进演进**：全链路 8 个 Sprint 平滑推进，无推倒重写
## 文档 ## 文档
- [使用指南](./docs/usage.md) — 详细使用说明（12 章节，含代码示例） - [使用指南](./docs/usage.md) — 详细使用说明（12 章节，含代码示例）
- [使用指南 (HTML)](./docs/usage.html) — 网页版使用指南 - [使用指南 (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）
## 数据库连接 ## 数据库连接