Files
easy_tdx_max/web-ui
GitHub 917295edaf release: v1.27.0 — 通达信公式解析器三通道 + 轮动组合引擎 + 回测页WF/评估开关 + Docker 部署
升级计划 P3 + P4(部分)。全量 1252 单测、ruff/mypy strict、前端 vue-tsc+vite build 全绿。

- 通达信公式解析器(formula.py):自建 tokenizer + 递归下降 AST + 30+ 函数白名单求值
  (不走 Python eval);命名布尔输出=信号列、数值输出=排名列;除零→NaN、预热期不出信号
- 公式三通道:CLI easy-tdx formula compute|screen|backtest;REST /formula/validate|compute|
  backtest|screen(run/async);Python API run_formula_backtest(买/卖列自动挑选)
- 轮动组合引擎(rotation.py):排名定期换仓(打分只用截至当日数据)、槽位等额、
  跌出排名自动补位、日/周/月刷新、槽内止盈止损;momentum_score/formula_score 打分;
  REST /backtest/rotation/run/async
- 回测页附加分析开关(Web UI):勾选后随回测并行跑 WF(逐窗红涨绿跌柱状图+汇总卡,
  窗口数 2~12)与一条龙评估(评分分项条/高适配徽标/买入持有对比/8 项适配检查);
  新增 WalkForwardPanel/EvaluatePanel 组件与 store runWalkforward/runEvaluate;
  WF 端点 ?n_windows= 透传;修复报告 numpy 标量 REST 400(源头清洗)
- Docker 部署(Dockerfile + docker-compose.yml,/data 卷 + 健康检查)与
  scripts/verify_ci.sh 一键门禁
- 升级计划文档 docs/upgrade-plan-2026H2.md(四阶段全部完成 + 诚实实测数据)
- 未做(独立排期):Playwright E2E、WebSocket 实时联动、引擎逐 bar 向量化
2026-09-01 22:17:57 +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