Files
easy_tdx_max/web-ui
GitHub c49ba4c4b5 feat: 组合回测分析体系对齐单标的 — 组合级WF/一条龙/完整25项绩效/AI解读
组合回测(一策略×多标的)此前只能看 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 绿)
2026-09-03 23:22:48 +08:00
..

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