shy3130 / tick-stock-panel

# TSP · A股智能量化工作台
**自托管 · 零运维 · 核心能力全部开放成接口的 A 股量化工作台**
`策略` · `回测` · `监控` · `因子挖掘` · `AI 助手` · `Open API` · `MCP`
 65 开放 API 端点 
 6 Token 权限档 
 12 MCP 工具 
 2400+ 测试全绿 · CI 守护 
 ms 级 全市场策略扫描 
 1 容器 零外部数据库 
**✨ 核心功能** · **📸 界面预览** · **🏛️ 架构** · **⚡ 性能** · **🌐 开放能力** · **🚀 快速开始** · **📚 完整文档**
---
**本项目由 RunningHub 提供支持** · 单一接口直连 400+ 主流大模型 · DeepSeek v4.1 Flash 3-6 折 · 免费测试
---
> [!IMPORTANT]
> ⚠️ 本项目谨作为本地量化提供解决思路与方案，**不作为投资软件或者看盘软件**。**明确不做**：不对标同花顺 / 通达信，不内置「AI 荐股 / 涨停预测」。数据源已插件化，可任意接入第三方数据源。仅供学习研究使用。
📮 有任何项目问题可邮件联系 **shy3130@qq.com** · 觉得有用请点个 ⭐ Star
---
## 💡 为什么做 TSP
| 用脚本/拼凑工具做量化,你大概率遇到过 | TSP 的解法 |
| :------------------------------------------- | :------------------------------------------------------------------------------------------------------- |
| 数据源绑死,换一家要重写整套拉数代码 | **能力路由矩阵**:6 类数据集按源能力独立路由,随时换源,指标与回测口径不变 |
| 策略、回测、监控各用一套工具,口径对不上 | 全站统一 **enriched 数据口径**:策略 → 回测 → 监控 → 复盘一条链 |
| 盘中异动靠人盯盘,错过就是错过 | **竞价/盘中/偏移**全时段异动 + 实时弹窗、语音播报、飞书推送 |
| 想查个数据要在几个页面之间来回点 | **AI 对话助手**:一句话问出全站数据,取数过程逐条可见、可展开核对;还能经确认卡放行生成信号、跑回测、补数据 |
| 想基于面板数据做自己的工具/机器人,只能爬页面 | **开放接口 + MCP**:Token 六档权限、65 端点契约化、SSE 事件流,AI 客户端即插即用 |
| 付费终端贵、云端平台数据出不了本地 | **自托管**:Docker 单容器,数据全部落在本地 Parquet,零运维 |
## ✨ 核心功能
**🔀 能力路由** 6 类数据集按源能力独立路由, 换源不换口径
**🔍 策略引擎** 全自定义策略 + 自定义信号 + AI 生成, 毫秒级扫全 A 股
**📊 指标流水线** 68 列指标与信号, 一次扫表落盘 enriched Parquet
**🧪 回测研究** 因子/策略/分钟回测, 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`)—— 监控中心页面可以整个换掉,规则引擎与推送管道属核心照常运行。**连 AI 对话助手都是扩展域的参考实现。**
> 一句话:核心是引擎,其余皆插件。下面这张图,先看懂虚线框与实线框的边界,就看懂了 TSP。
| 架构特点 | 一句话说明 |
| :--- | :--- |
| 🔀 **能力路由矩阵** | 6 类数据集按源声明能力独立路由——换源不换口径,指标与回测结果不变 |
| 🧬 **单一 enriched 口径** | 只存 15 列基础数据、现算 68 列指标信号;策略 → 回测 → 监控 → 复盘吃同一份数据 |
| 📁 **文件型零运维存储** | Parquet + DuckDB,单容器零外部数据库,数据 100% 落在本地 |
| 🔁 **回测 = 实盘同路径** | 策略执行只此一条 `StrategyEngine.run`;分钟策略逐日回放 +「当日已知」纪律,杜绝未来函数 |
| 🏛️ **网关居中的开放单体** | 面板密码会话与 Token 网关双通道并行;65 端点契约快照 + CI 守护,SSE 事件流与 MCP 平等开放 |
| 🚀 **重活进程隔离** | 回测跑在 spawn worker 子进程,刷新/切页重连不丢任务,主服务永不被计算卡住 |
### 总览 · 网关居中的开放单体
> **双通道并行**:面板走密码会话,外部走 Token 网关 —— 互不影响、互不挤占限流。核心域 8 个域是数据与语