## 一、业务定位
`quant-platform` 是一个 本地运行的 A 股 / ETF 量化研究、回测与交易一体化终端 ,面向个人量化交易者与投研人员。它把交易流程串成一条完整链路:
行情采集 → 策略研究 → 历史回测 → 模拟盘验证 → 实盘委托(可选)
业务价值在于:不用搭环境就能把「一个想法」在几秒内跑成「有资金曲线、有逐笔交易、有风险指标」的可验证结论,再用同一套代码在模拟盘和真实券商上执行,避免研究代码与交易代码两套逻辑。
## 二、功能清单
前端是单页应用,按四个页签组织( index.html )。
### 1. 数据管理
- 支持按 6 位代码下载 东方财富前复权日线 ,腾讯证券作为备用源,均无需 API Key
- 无网络时自动回退 确定性演示行情 (同一代码结果稳定,便于验证功能)
- 支持本地 CSV 导入,兼容中英文列名(日期/开盘/最高/最低/收盘/成交量)
- 所有行情写入 SQLite 缓存,图表展示 K 线 + 成交量
- 定时更新:可配置周期、标的列表、K 线天数,并保留同步日志
### 2. 策略回测
- 13 个内置策略 :双均线、MACD、RSI 均值回归、唐奇安突破、布林突破/回归、动量、量能确认、乖离回归、网格、长趋势过滤、放量突破、买入持有( strategies.py )
- 每个策略参数可在界面调节,服务端统一做范围裁剪与逻辑校验(如快线必须小于慢线)
- 三种引擎可选 :内置引擎、Backtrader(交叉验证用)、Qlib(Alpha158 因子 + LightGBM 机器学习)
- Qlib 多标的组合回测 :2~12 个标的,横截面打分后每日持有 Top-K 等权轮动
- 批量回测 :多标的各配一套参数,逐条跑并汇总
- 输出十余项绩效指标:总收益、年化、基准收益、最大回撤(含起止日)、波动率、夏普、索提诺、卡玛、胜率、盈亏因子、交易次数、平均盈亏、平均持仓天数、持仓占比
- 资金曲线、回撤曲线、逐笔交易明细;每次回测自动存研究记录,可删除
- AI 回测解读 :把指标和最近交易喂给大模型,输出「总体评价、主要风险、改进建议、适用行情」
### 3. 交易中心
- 模拟盘 :多账户、初始资金、现金/市值/总资产/收益率、持仓成本核算、委托流水、一键重置
- 撮合规则贴近 A 股:本地最新收盘价成交、佣金万三(最低 5 元)、卖出千一印花税、买入 100 股整数倍、资金与持仓双重校验
- 实盘 :支持通过券商登录券商网关(HTTP)后进行股票/ETF、期货、期权委托,能查看实盘账户、持仓、委托回报
- 内置 SimNow 仿真、西部证券 QMT、东方证券、老虎证券、自定义 CTP 等预设;未配置网关时 明确报错而不是伪造成交
浏览器 web/index.html + app.js + ECharts(零构建、无前端框架)
│ HTTP / JSON
FastAPI app/main.py ─── 统一异常映射(ValueError→400, KeyError→404)
├─ 行情层 data.py 东方财富/腾讯/CSV/演示 → db.py → SQLite
├─ 研究层 strategies.py(信号)→ engine.py(撮合与绩效)
├─ 桥接层 bridge.py ─┬ bt_adapter.py Backtrader
│ └ qlib_pipeline.py Qlib + LightGBM
├─ 交易层 broker.py ─→ 自建券商网关 HTTP
│ qmt_gateway.py:9400(xtquant)
│ vnpy_gateway.py:9300(CTP)
└─ 辅助 llm.py / news.py / scheduler.py
### 关键实现决策
1. 信号与成交错日 :收盘后计算信号,次日开盘成交,杜绝未来函数( engine.py );期末强制按最后收盘价平仓,保证胜率统计完整。
2. 成本模型内建 :佣金`max(万三, 5 元)` 、卖出印花税千一、滑点按比例作用在成交价上,买入按 100 股向下取整并可回退手数确保不超现金。
3. 数据整表覆盖 :同一标的每次同步先`DELETE` 再批量插入,避免真实数据与演示数据混在一起( data.py )。
4. Python 版本隔离 :主平台跑在 3.14,而 Qlib / vn.py 扩展只提供 ≤3.13 的构建,因此`research/.venv` 与`.venv-vnpy` 独立,通过「临时 JSON 文件 + 子进程」通信,主进程无需安装重依赖( bridge.py )。
5. 统一网关抽象 :QMT 与 vn.py 都对外暴露同一套`POST /login、/logout、/orders` 与`GET /account、/positions、/orders` 契约,主平台不感知底层柜台差异;券商 token 只存内存、不落库。
6. 定时任务安全 :自动同步强制`source=eastmoney` ,失败只记日志, 绝不用演示数据覆盖真实行情 ( scheduler.py )。
7. 零依赖前端 :无 npm、无打包,`StaticFiles` 直接托管,降低使用门槛。