README

TSP · A股智能量化工作台













自托管 · 零运维 · 核心能力全部开放成接口的 A 股量化工作台



策略 · 回测 · 监控 · 因子挖掘 · AI 助手 · Polars · React





3.11+Python 后端
20+Node 前端
18React · TypeScript
3000+测试全绿 · CI 守护
ms 级全市场策略扫描
1 容器零外部数据库


✨ 核心功能 · 📸 界面预览 · 🏛️ 架构 · ⚡ 性能 · 🌐 开放能力 · 🚀 快速开始 · 📚 完整文档 · 💬 交流群



---






  



  


本项目由 RunningHub 提供支持 · 单一接口直连 400+ 主流大模型 · DeepSeek v4.1 Flash 3-6 折 · 免费测试



---

 [!IMPORTANT]
 ⚠️ 本项目谨作为本地量化提供解决思路与方案，不作为投资软件或者看盘软件。明确不做：不对标同花顺 / 通达信，不内置「AI 荐股 / 涨停预测」。数据源已插件化，可任意接入第三方数据源。仅供学习研究使用。

📮 有任何项目问题可邮件联系 [email protected] · 觉得有用请点个 ⭐ Star

---




 💡 为什么做 TSP

| 用脚本/拼凑工具做量化,你大概率遇到过         | TSP 的解法                                                                                               |
| :------------------------------------------- | :------------------------------------------------------------------------------------------------------- |
| 数据源绑死,换一家要重写整套拉数代码          | 能力路由矩阵:6 类数据集按源能力独立路由,随时换源,指标与回测口径不变                                  |
| 策略、回测、监控各用一套工具,口径对不上      | 全站统一 enriched 数据口径:策略 → 回测 → 监控 → 复盘一条链                                           |
| 盘中异动靠人盯盘,错过就是错过                | 竞价/盘中/偏移全时段异动 + 实时弹窗、语音播报、飞书推送                                              |
| 想查个数据要在几个页面之间来回点             | AI 对话助手:一句话问出全站数据,取数过程逐条可见、可展开核对;还能经确认卡放行生成信号、跑回测、补数据 |
| 想基于面板数据做自己的工具/机器人,只能爬页面 | 开放接口 + MCP:Token 六档权限、65 端点契约化、SSE 事件流,AI 客户端即插即用                           |
| 付费终端贵、云端平台数据出不了本地           | 自托管:Docker 单容器,数据全部落在本地 Parquet,零运维                                                 |




 ✨ 核心功能

 数据与策略研究

| 模块 | 功能 |
| :--- | :--- |
| 🔀 能力路由 | 6 类数据集按源能力独立路由, 换源不换口径 |
| 📊 指标流水线 | 68 列指标与信号, 一次扫表落盘 enriched Parquet |
| 🔍 策略引擎 | 全自定义策略 + 自定义信号 + AI 生成, 毫秒级扫全 A 股 |
| 🧪 回测研究 | 因子/策略/分钟回测, T+1/费用/滑点, 因子归因 |
| 🔬 因子平台 | DSL 自定义因子 + 检验组合, 与策略双向联动 |
| ⛏️ 因子挖掘 | 样本外搜索多因子组合, 显式发布、永不上线 |

 市场观察与监控

| 模块 | 功能 |
| :--- | :--- |
| 🌡️ 市场环境 | 情绪周期 6 阶段 + 概念/行业主线排名 |
| 🚨 异动监控 | 竞价/盘中/偏移三类异动一页覆盖 |
| 📡 监控中心 | 四类规则 AND/OR + 语音播报 + 飞书推送 |
| 📈 个股分析 | 9 类关键价位 + AI 四维分析 |
| 🏆 连板梯队 | 连板统计 + 概念轮动 + 盘后 AI 复盘 |
| 🧰 数据扩展 | 插件化数据源, 扩展字段成页, 两级拉取配方, 按日历史回补 |

 开放能力与工作区扩展

| 模块 | 功能 |
| :--- | :--- |
| 🌐 开放接口 | Token 六档权限, 65 端点契约化, 读+写闭环 |
| 🔌 MCP 服务器 | 12 个工具把面板能力交给任意 AI 客户端 |
| 🧠 AI 对话助手 | 一句话问全站数据, 工具足迹逐条可核对 |
| 🧩 扩展页面 | 11 个官方页面单文件化, 删目录即卸载、复制即导入 |
| 📦 页面插件 | 页面打包产物上传即挂载, 免重建宿主, 刷新生效 |
| 🎛️ 菜单设置 | 显隐/排序 + 内置/自定义/扩展三类管理与架构徽标 |

 📄 19 个页面的完整功能细节见 docs/features.md 与 screenshots/ —— 上表之外, 回测四种研究视图、异动三时间线、页面插件运行时分发等都在其中。

---




 📸 界面预览

以下为已配置环境的实际截图。策略与扩展内容需自行创建或导入，具体界面随版本、数据源与配置而变化；点击图片可查看原图。


  
    看板 Dashboard市场全貌、情绪与观察记录。
    策略 Screener组织策略池，查看命中结果。
  
  
    回测 Backtest净值、回撤与交易明细对照。
    挖掘 Mining因子组合、样本外检验与发布。
  
  
    监控中心 Monitor配置监控规则，追踪告警记录。
    市场环境 Regime情绪周期、概念与行业主线。
  




 📸 查看更多界面截图 »



---





 🏗️ 架构

TSP 的一切设计围绕一条主线:核心底座 + 扩展层。

- 核心域(8 个) 拥有数据与语义 —— 数据底座、能力路由、指标与执行、事件与开放通道。它们是自洽的最小系统,不依赖任何外围。
- 扩展域(5 条通道) 只消费核心契约 —— 数据源插件、扩展数据表、自定义策略/信号、页面扩展、后端 custom 模块。可整体替换或移除而不伤核心:删除目录即卸载、复制目录即导入。
- 你看到的 19 个页面里,11 个官方页面本身就是扩展(单文件 frontend/src/custom//extension.tsx)—— 监