Compare commits

..
1 Commits
+12 -9
View File
@@ -18,8 +18,8 @@ cc-cursor/
│ ├── cli/ # 命令行 & 验证脚本
│ ├── reports/ # 自动日报输出目录
│ └── .env # 环境变量配置(API Key / 分析范围)
├── djapi/ # Django API 后端(已有
├── mcp-servers/ # MCP ServerSerena
├── djapi/ # Django API 后端(A 股数据 + 新闻联播 + 日报查询
├── mcp-servers/ # MCP ServerSerena,本机工具,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 | 日报查询 ×2news/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
## 数据库连接