mirror of
https://ghfast.top/https://github.com/aeroxw/easy_tdx_max.git
synced 2026-09-12 14:34:18 +08:00
GitHub
c49ba4c4b5
组合回测（一策略×多标的）此前只能看 4 个数字，本轮把单标的的整条 分析链路在组合端补齐（WebUI/REST 双端）： - portfolio_engine：合并净值+汇总成交喂 PerformanceAnalyzer，输出 完整 25 项指标（SQN/最大连胜连亏/Ulcer/VaR/CVaR 等）+ 组合层 trades（symbol 列）；修复假年化与回撤口径（负值+固定分母 → 逐点峰值，与单标的/多策略一致） - walkforward：新增 PortfolioWalkForwardEngine，按标的日期并集切窗、 每窗独立开仓、合成组合窗内净值，复用 WalkForwardResult 结构 - benchmark：新增 evaluate_portfolio 一条龙（组合回测+组合WF+ 跨标的多数口径适配性体检+综合评分+组合评级+等权买入持有基准对比）， 报告结构与单标的 evaluate_strategy 同构 - performance：FIFO 持仓天数配对支持 symbol 分组 - Web：新增 POST /backtest/portfolio/wf/run/async 与 /backtest/portfolio/evaluate/run/async；组合回测响应附带 grade（组合净值口径）与 score；新增 _normalize_bars_dt 修复 按标的取数路径的字符串日期/遗留 date 列崩溃（E2E 揭露） - 前端：组合页新增附加分析勾选区与组合绩效指标/WF/一条龙/成交明细 区块；buildPortfolioAiPrompt 组合版 Prompt；抽通用 AiInterpretModal（回测页迁移共用，行为不变）；TradeTable 支持 showSymbol；EvaluatePanel 支持 gradeOverride - 测试：后端 +17 例（pytest 1603 绿）、aiPrompt 组合版 2 例、 Playwright 组合页 E2E 2 例（9/9 绿）
easy-tdx 回测 Web UI
单标的策略回测的可视化前端（Vue3 + ECharts）。对应后端回测 REST API（/api/v1/backtest/*）。
快速开始
需要两个进程：后端 FastAPI（提供回测 + 行情 API）+ 前端 Vite dev server。
# 1. 启动后端（仓库根目录，使用 venv）
venv/Scripts/easy-tdx serve --port 8000
# 2. 启动前端（本目录）
npm install # 首次
npm run dev # 启动在 http://localhost:5173
浏览器打开 http://localhost:5173。开发期 /api 请求由 vite proxy 转发到后端 127.0.0.1:8000，无需处理跨域。
功能（MVP-A）
- 选标的取行情：沪深北市场，日线/周线/分钟线，调
/api/v1/bars - 策略选择 + 动态参数表单：下拉选预置策略（MA交叉/MACD/布林/RSI/KDJ），参数表单按后端 schema 自动渲染
- 回测报告：
- K线主图 + 买卖点标注（ECharts candlestick + markPoint）
- 净值曲线 + 回撤双轴图
- 19 项绩效指标表（收益/风险/交易分组）
- 成交记录表
技术栈
| 层 | 技术 | 说明 |
|---|---|---|
| 框架 | Vue 3.5 + TypeScript | Composition API + <script setup> |
| 构建 | Vite 8 | dev proxy 解决跨域 |
| 状态 | Pinia | 策略列表 / OHLCV / 回测结果 |
| 路由 | Vue Router 4 | MVP 仅 /，预留组合/寻优/对比 |
| 图表 | ECharts（按需引入） | candlestick / line / markPoint |
目录结构
src/
├── main.ts # 入口（Pinia + Router）
├── App.vue # 根布局
├── router.ts # 路由
├── api.ts # fetch 封装（strategies/bars/backtest）
├── types.ts # 后端 schema 的 TS 镜像
├── echarts-setup.ts # ECharts 按需注册
├── style.css # 深色金融主题
├── stores/backtest.ts # 状态管理
├── views/BacktestView.vue # 主页面（左配置 / 右报告）
└── components/
├── StrategyPicker.vue # 策略下拉 + 动态参数表单
├── SymbolPicker.vue # 选标的取行情
├── KlineChart.vue # K线 + 买卖点
├── EquityChart.vue # 净值 + 回撤
├── MetricTable.vue # 绩效指标表
└── TradeTable.vue # 成交记录表
生产构建
npm run build # 产物在 dist/，由 FastAPI 同源托管（待后续配置）
注意事项
- 取行情需要网络：
/api/v1/bars通过 TDX 协议取真实行情，需后端能连通行情服务器。无网络时可手动构造 OHLCV（后续可加内联数据粘贴入口）。 - A股配色惯例：红涨绿跌（与 ECharts 默认相反），见
echarts-setup.ts。