Files
easy_tdx_max/web-ui
GitHub 33d44ba5d6 feat(webui)!: 行情终端重大升级——市场看板/自选/个股与板块弹窗 + SSE 实时推送
展示层对标专业看盘终端(tick-stock-panel 模式),数据全部来自通达信协议直连:

- 市场看板:五大指数实时条(迷你分时)、涨跌统计、四维情绪雷达、
  全市场涨跌分布直方图(约 5500 只 22 桶、鼠标跟随浮窗)、涨停雷达、
  行业/概念热冷榜(可下钻)、涨幅/跌幅/成交额/换手四联排行榜、异动雷达
- 自选行情:6 位代码即加(symbol-info 自动取名)、SSE 实时全表刷新、
  行内迷你分时;SQLite 持久化(watchlist.db,幂等加删)
- 个股弹窗:五档盘口 + 1/3/5 日分时 + 日K(MA/BOLL/EMA + MACD/KDJ/RSI
  前端本地计算)+ 一键加自选 + 一键全策略寻优
- 板块弹窗:板块分时/日K + 成分股涨跌榜直达个股
- SSE 架构:QuoteStreamer 单循环轮询 fan-out(独立队列 + 背压丢旧、
  无订阅休眠、盘中 8s/盘外 60s 降频);前端 pinia 单连接指数退避重连
- fix(codec): SH 000 系大盘指数与 881/885 板块指数报价按 2 位小数解析
  (曾缩小 10 倍:科创50 1647.53→164.753);880 统计指数保持 3 位
- fix: 前端批量五档路径 /security/quotes→/quotes、SSE 五档白名单
  bid1_vol→bid_vol1、MAC 排行 close 列归一化、日K v-if 撑满、
  寻优查看跳转 /→/backtest、FastAPI 0.141 _IncludedRouter 测试适配

新增 27 个单测(streamer/自选/小数位语义),全套 1078 passed
2026-09-01 17:45:07 +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