自托管 · 零运维 · 核心能力全部开放成接口的 A 股量化工作台
策略 · 回测 · 监控 · 因子挖掘 · AI 助手 · Polars · React
| 3.11+ Python 后端 |
20+ Node 前端 |
18 React · TypeScript |
3000+ 测试全绿 · CI 守护 |
ms 级 全市场策略扫描 |
1 容器 零外部数据库 |
✨ 核心功能 · 📸 界面预览 · 🏛️ 架构 · ⚡ 性能 · 🌐 开放能力 · 🚀 快速开始 · 📚 完整文档 · 💬 交流群
Important
📮 有任何项目问题可邮件联系 shy3130@qq.com · 觉得有用请点个 ⭐ Star
| 用脚本/拼凑工具做量化,你大概率遇到过 | TSP 的解法 |
|---|---|
| 数据源绑死,换一家要重写整套拉数代码 | 能力路由矩阵:6 类数据集按源能力独立路由,随时换源,指标与回测口径不变 |
| 策略、回测、监控各用一套工具,口径对不上 | 全站统一 enriched 数据口径:策略 → 回测 → 监控 → 复盘一条链 |
| 盘中异动靠人盯盘,错过就是错过 | 竞价/盘中/偏移全时段异动 + 实时弹窗、语音播报、飞书推送 |
| 想查个数据要在几个页面之间来回点 | AI 对话助手:一句话问出全站数据,取数过程逐条可见、可展开核对;还能经确认卡放行生成信号、跑回测、补数据 |
| 想基于面板数据做自己的工具/机器人,只能爬页面 | 开放接口 + MCP:Token 六档权限、65 端点契约化、SSE 事件流,AI 客户端即插即用 |
| 付费终端贵、云端平台数据出不了本地 | 自托管:Docker 单容器,数据全部落在本地 Parquet,零运维 |
|
🔀 能力路由 |
🔍 策略引擎 |
📊 指标流水线 |
|
🧪 回测研究 |
🔬 因子平台 |
⛏️ 因子挖掘 |
|
🌡️ 市场环境 |
🚨 异动监控 |
📡 监控中心 |
|
📈 个股分析 |
🏆 连板梯队 |
🧰 数据扩展 |
|
🌐 开放接口 |
🔌 MCP 服务器 |
🧠 AI 对话助手 |
|
🧩 扩展页面 |
📦 页面插件 |
🎛️ 菜单设置 |
📄 19 个页面的完整功能细节见 docs/features.md 与 screenshots/ —— 上表之外, 回测四种研究视图、异动三时间线、页面插件运行时分发等都在其中。
| 看板 Dashboard | 策略 Screener |
 |
 |
| 回测 Backtest | 挖掘 Mining |
 |
 |
| 监控中心 Monitor | 市场环境 Regime |
 |
 |
TSP 的一切设计围绕一条主线:核心底座 + 扩展层。
- 核心域(8 个) 拥有数据与语义 —— 数据底座、能力路由、指标与执行、事件与开放通道。它们是自洽的最小系统,不依赖任何外围。
- 扩展域(5 条通道) 只消费核心契约 —— 数据源插件、扩展数据表、自定义策略/信号、页面扩展、后端 custom 模块。可整体替换或移除而不伤核心:删除目录即卸载、复制目录即导入。
- 你看到的 19 个页面里,11 个官方页面本身就是扩展(单文件
frontend/src/custom/<ns>/extension.tsx)—— 监控中心页面可以整个换掉,规则引擎与推送管道属核心照常运行。连 AI 对话助手都是扩展域的参考实现。
一句话:核心是引擎,其余皆插件。下面这张图,先看懂虚线框与实线框的边界,就看懂了 TSP。
| 架构特点 | 一句话说明 |
|---|---|
| 🔀 能力路由矩阵 | 6 类数据集按源声明能力独立路由——换源不换口径,指标与回测结果不变 |
| 🧬 单一 enriched 口径 | 只存 15 列基础数据、现算 68 列指标信号;策略 → 回测 → 监控 → 复盘吃同一份数据 |
| 📁 文件型零运维存储 | Parquet + DuckDB,单容器零外部数据库,数据 100% 落在本地 |
| 🔁 回测 = 实盘同路径 | 策略执行只此一条 StrategyEngine.run;分钟策略逐日回放 +「当日已知」纪律,杜绝未来函数 |
| 🛡️ 稳健参数筛选 | 参数按 K 段折外稳健分(0.6×中位+0.4×最差)排名而非样本内得分:主目标白名单 + 最小交易数门槛 + Top-20 全窗退化率 + 冠军收敛/高原判据;滚动样本外检验每折重优化防过拟合,冠军/最新折参数一键应用到策略 |
| 🛡️ 策略守护 | 发布的策略自动落基线,每日用新数据 K 段真实回测复验:退化自动判定 健康/观察/退役(交易数枯竭即退役),连续观察告警;退役只标记不删档,支持任意策略手动入护(尾随参考基线)。冠军按稳健分(中位+最差折)选出并做权重精调;健康冠军间低相关(日收益 Pearson≤0.7)可一键生成组合策略并入护;实验室战报聚合守护/挖掘/名额,挖掘名额满时新候选等位 |
| 🏛️ 网关居中的开放单体 | 面板密码会话与 Token 网关双通道并行;65 端点契约快照 + CI 守护,SSE 事件流与 MCP 平等开放 |
| 🚀 重活进程隔离 | 回测跑在 spawn worker 子进程,刷新/切页重连不丢任务,主服务永不被计算卡住 |
双通道并行:面板走密码会话,外部走 Token 网关 —— 互不影响、互不挤占限流。核心域 8 个域是数据与语义的所有者;扩展域 5 条通道只消费契约,零核心改动。
按「数据与语义的归属 + 依赖箭头方向」划分,而非页面外观:
| 内容 | 划线依据 | |
|---|---|---|
| 核心域 · 8 | 数据底座 / 能力路由 / 订阅锚点(自选) / 策略与回测 / 因子与挖掘 / 环境数据生产 / 监控推送管道 / 扩展数据存储 + 认证配置 | 被多个模块消费其数据与语义,自身不依赖外围 |
| 扩展域 · 5 通道 | 数据源插件 · 扩展数据表 · 自定义策略/信号 · 页面扩展(单文件源码 + 运行时页面插件) · 后端 custom 模块 | 只消费核心契约,可整体替换/移除而不伤核心 |
设置 → 菜单设置里每个页面带 核心 / 扩展 架构徽标与 内置 / 自定义 / 扩展 类型徽标;11 个官方页面(概念/行业/个股/财务分析、监控中心、异动、持仓提醒、模拟盘、信号库、复盘、连板梯队)已全部落地为 frontend/src/custom/<ns>/extension.tsx 单文件扩展 —— 删除目录即卸载、复制目录即导入;例如监控中心页面可换,规则引擎与推送管道属核心照常运行。新装默认隐藏这些扩展页面(菜单设置一键开启),老用户升级自动保持原菜单位置与排序。免宿主重建的运行时分发走页面插件(设置 → 页面插件,契约见 docs/page-sdk.md)。详见 docs/open-platform-plan.md。
| 机制 | 说明 |
|---|---|
| 能力路由矩阵 | 各数据集按源声明能力独立路由,注册表集中定义、可扩展:TICKFLOW 档位探测(None/Free/Starter/Pro/Expert)+ 插件源能力声明,fail-closed(声明 pct_unit 未声明即拒)。同一数据集可随时换源,指标与回测口径不变 |
| 财务多源合并 | 按 (symbol, period_end) 报告期累积,多源取并集、逐列按公告日取最新(PIT);公告前一律空值,绝不填 0 |
| 非路由数据集直连 | 龙虎榜/盘前风向标/交易日历等 fuyao 专有能力不进路由矩阵,由独立服务直连消费——按日 JSON 缓存(历史不可变)、交易日回退、四态降级 |
| 回测执行隔离 | 回测在 spawn worker 子进程运行,持久 run ID,刷新/切页重连不丢任务;子进程结果消息经锁保护回传 |
| 开放网关 | Token 通道与面板密码会话并行互不影响:网络门禁(默认仅本机/内网, API_TOKEN_LOCAL_ONLY=0 放开) → 认证 → 六档 scope 校验 → 每 Token 滑动窗口限流(默认 120 次/分,O(1) 内存)→ 放行;管理面(数据同步/表结构/设置)永不开放给 Token |
| 事件总线 | 进程内发布/订阅(慢消费者丢旧保新,广播失败不反噬主流程),告警落盘唯一入口已挂接;SSE 流按票据 scope 过滤,票据一次性 60 秒过期 |
| 交易日探针 | fuyao 交易日历(确定性,含调休)→ tickflow 全市场行情时间戳探针(OR 语义)→ 工作日兜底;节假日自动停掉实时轮询与分钟增量,零无效请求 |
| 扩展自动发现 | 后端 app/custom/<包>/ 启动时自动发现、注册独立路由(版本不符或 setup 失败即隔离跳过);前端 src/custom/<ns>/extension.tsx 单文件即完整扩展(组件+路由+导航),构建时自动挂载 —— 删除目录即整体卸载、复制目录即导入;运行时分发走页面插件(上传即挂载,免重建宿主) |
| 层 | 选型 |
|---|---|
| 后端 |    APScheduler · sse-starlette |
| 数据 |  （计算）·  （查询）· Parquet（存储） |
| 回测 | 自研仓位模拟引擎(T+1/费用/滑点/分钟回放)· vectorbt(部分路径) |
| 数据源 | TickFlow 官方 SDK · fuyao(同花顺 REST) · TdxQuant(通达信量化,实时/五档/日K/复权/分钟) · 插件化扩展(YAML 自定义源) |
| AI(可选) |  Chat Completions 与 Responses 双协议 · DeepSeek / 通义 / Ollama 等 · 策略生成 / 报告 / 对话助手(助手依赖工具调用能力, 需 OpenAI 兼容接口) |
| MCP | mcp-server(官方 SDK 2.x, stdio) — 12 工具按 scope 暴露,权限裁决复用开放网关 |
| 前端 |     Tanstack Query · Lightweight Charts(TradingView 开源) ·  · dnd-kit |
| 部署 |  两阶段构建,前端 dist 拷进后端镜像 |
不是口号 —— 每一行都有机制支撑,数字全部来自本仓库的真实测试与实现。
| 场景 | 表现 | 靠什么 |
|---|---|---|
| 全市场策略扫描 | 毫秒级 | Polars 列式引擎 + enriched 预计算,谓词下推过滤 |
| 指标与信号 | 只存 15 列基础数据,现算 68 列指标信号 | 分层缓存:存储最小化、读取零冗余、写入即失效 |
| 盘后管道 | 增量分区,只算新交易日 | enriched 按日分区 + 指标流水线增量帧 |
| 实时行情 | 自选优先,全市场按档位分流 | 交易日探针,节假日自动停轮,零无效请求 |
| 回测 | 子进程隔离不卡主服务,刷新重连不丢任务 | spawn worker + 持久 run ID + 重活并发闸 |
| 部署与兼容 | 单容器零外部数据库(Parquet + DuckDB 文件型) · 新老 CPU 双内核 | polars rtcompat 兼容内核,运行时自动探测 |
开放层的性能(网关裁决 O(1)、契约快照守护、亚秒级事件推送等)见下方开放能力章节。
| 能力 | 表现 | 靠什么 |
|---|---|---|
| 开放 API | 65 端点 · 每 Token 120 次/分 | 进程内滑动窗口限流,O(1) 内存,零外部依赖 |
| 网关裁决 | 认证→scope→限流,纯内存单函数完成 | 单一裁决点(evaluate),无数据库往返 |
| 契约稳定性 | 机器可读契约 + 快照测试守护 | 开放面增删必须显式改快照,CI 拦截无意识变更 |
| 数据写闭环 | 外部写入复用管理端同一校验/落盘路径 | write:ext 只写行数据,表结构锁死管理面 |
| 事件推送 | 告警落盘即广播,亚秒级到 SSE 流 | 进程内事件总线(丢旧保新)+ 一次性票据订阅 |
| MCP 工具调用 | 12 工具按 scope 联动暴露 | 薄桥零业务逻辑,权限裁决复用网关 |
| 质量保障 | 3000+ 测试全绿,约 100 秒跑完 | GitHub Actions CI(后端全量 + 前端构建) |
面板的核心能力不只长在页面上 —— 全部开放成受控接口,外部程序与 AI 客户端平等消费:
🌐 开放平台门户已上线 → tsp.shy313.com 浏览 TSP 全部功能 · 注册账户 · 邀请好友 · 创建 API Key · 在线调用开放接口,一个入口直达。
| 设置 → 开放接口 · Token 管理 明文只显示一次,六档 scope 按需授予 |
设置 → 菜单设置 · 架构标注 每页核心/扩展徽标,悬停看归属原因 |
 |
 |
| 能力 | 说明 |
|---|---|
| API Token | 设置 → 开放接口 创建,明文只显示一次,SHA-256 哈希存储,吊销立即生效 |
| 网络门禁 | Token 通道默认仅本机/内网调用,公网一律 403(API_TOKEN_LOCAL_ONLY=0 显式放开,远程推荐 SSH 隧道);门禁先于验签,不泄露 Token 有效性也不消耗限流额度 |
| 六档 scope | read:market / read:ext / write:ext / read:analysis / run:backtest / paper:trade,管理面永不开放给 Token |
| 65 端点契约 | GET /api/openapi.json?tier=a 机器可读,Postman/代码生成即用;契约快照测试 + CI 守护,开放面变更必须显式确认 |
| 数据写闭环 | write:ext 程序化写入扩展表行数据(与内置数据同台分析),表结构锁死在管理面 |
| SSE 事件流 | 60 秒一次性票据订阅实时告警推送,票据只继承 scope 不放大权限 |
| MCP 服务器 | 12 个精选工具,按 Token scope 暴露;模拟盘交易刻意不交给 AI |
| 示例与文档 | examples/open-api 四个零依赖可运行示例 · docs/features.md → 开放接口 · 开放平台设计方案 |
开放接口面向本部署的二次开发与个人工具集成(自有页面、脚本、机器人、MCP 客户端),不作为数据对外分发通道;公网部署默认仅接受内网 Token 调用,详见 configuration.md → 开放接口网络门禁。
# 十行内跑通第一个调用
curl -H "Authorization: Bearer tsp_xxxx" \
"http://localhost:3018/api/kline/daily?symbol=600519.SH&limit=10"不想挨个页面点着找数据?把问题直接问出来 —— 助手在本地真实数据上调用工具取数, 逐字流式作答, 每次取数都可展开核对。
| 打开方式 | 说明 |
|---|---|
| 悬浮球 | 可拖动, 位置记忆; 生成中带状态指示点 |
| 侧栏「AI 助手」行 | 左上角状态区 (AI 配置行下方), 一键展开 |
| ⌘K / Ctrl+K | 全局快捷键随时呼出, Esc 关闭 |
能问什么 — 21 个查询工具覆盖全站页面能力, 5 个动作工具经确认卡放行 (可开免确认):
| 类别 | 覆盖能力 |
|---|---|
| 个股 | 实时行情快照(支持批量) · 日线区间 · 关键价位分析 · 财务五表(指标/利润/资负/现金流/股本) |
| 大盘 | 看板总览(涨跌家数·成交额·涨停连板·情绪雷达) · 指数行情 · 市场环境(regime) · 异动监控 |
| 板块 | 概念/行业板块盘中轮动、切换事件与资金排名 |
| 我的数据 | 自选列表(含备注与实时涨跌) · 持仓提醒 · 信号库 |
| 策略与因子 | 策略目录 · 执行策略取标的 · 因子目录 · 因子全市场排名 |
| 扩展内容 | 扩展数据表(列表·字段·数据日期, 读行支持过滤/排序/日期范围) · 自定义策略与信号 |
| 数据健康 | 完整性检查(日线/enriched/分钟K 覆盖区间与停更、财务表缺口、单标的滞后) · 同步任务进度 |
| 动作(须确认) | 生成信号策略(声明式白名单条件, 落库即用) · 创建 AI 策略草稿(草稿态, 发布后生效) · 运行策略回测 · 加入自选 · 数据补全(盘后管道/财务表/分钟K扩展, 后台执行·单飞去重) |
交互设计
- 工具足迹卡 — 每次调用的工具名、参数、耗时、结果摘要均可展开核对; 取数可核对是设计铁律
- 动作确认卡 — 生成信号/回测/加自选/数据补全等写操作先弹确认卡(完整待执行参数可见), 你点「确认执行」才真正运行; 拒绝或 120 秒超时自动取消; 可在助手界面开启免确认(默认关, 轮次检查点安全阀不受影响)
- 逐字流式 + 非模态面板 — 从页面右缘滑入可拖宽(宽度记忆), 边看行情边问; 新会话带分组快捷建议, 个股问答附走势双图(日K + 分时)
- 会话历史跨设备 — 服务端注册表同步(回测/挖掘/优化/滚动任务同步接回), 本地存储降级为缓存
- 固定合规提示 — 每条回答完成后附风险提示与数据口径提示; 轮次检查点与连续执行上限可在设置调整
扩展域的参考实现 — 后端 app/custom/assistant/ + 前端 src/custom/assistant/ 各自独立, 删除目录即整体卸载(见上方架构); 数据补全工具与数据页共用同一条触发路径, 单飞去重天然一致。未配置 AI Key 或供应商不支持工具调用时 fail-closed, 直接提示前往设置页。
⚠️ 助手是数据分析工具, 不提供买卖指令; 涉及交易决策的问题会转换为客观的技术/财务状态、关键价位、风险因素与条件情景。
docker run -d --name tsp -p 3018:3018 -v ${PWD}/data:/app/data ghcr.io/shy3130/tick-stock-panel:latest打开 http://localhost:3018 即可使用 · 多架构镜像(linux/amd64 · arm64)由 CI 自动发布,本地无需 Python / Node
还没决定要不要部署? 先逛逛 官网 tsp.shy313.com —— 功能总览 · 账户注册 · API Key 管理
| 方式 | 适合谁 | 前置要求 |
|---|---|---|
| A · GHCR 现成镜像(即上方一条命令) | 多数用户，拿来即用 ⭐ 推荐 | Docker |
| B · Compose 本地构建 | 跑自己改过的代码 / 全套挂载 | Docker |
| C · 本机 AI 代部署 | 完全不想碰命令行 | 任一本机 AI 编程助手 |
| D · Dev 模式 | 二次开发 | Python ≥ 3.11 · Node ≥ 20 · uv · pnpm(npm i -g pnpm) |
| E · 桌面客户端 | 想要原生桌面窗口、免装环境 | Windows 10+ / macOS(Apple Silicon) |
本项目每次推送都由 GitHub Actions 自动构建多架构镜像并发布到 GHCR,拿来即用:
- 需要配置时:从 .env.example 复制出
.env,命令里加--env-file .env。 - Linux
docker run部署:容器内要通过host.docker.internal访问宿主机服务(如自定义数据源)时,命令需加--add-host=host.docker.internal:host-gateway;升级重建容器时务必保留-v ${PWD}/data:/app/data挂载并提前备份data/,否则容器层数据会随旧容器静默丢失(详见 docs/deployment.md)。 - 跑自己改过的代码:fork 后到仓库 Actions 页启用 workflow(fork 默认禁用),构建出的
ghcr.io/<你的用户名>/tick-stock-panel用法相同。 - 想用 compose 编排(挂载
.env/tiers.yaml):参考 docker-compose.yml,把build:段换成image: ghcr.io/shy3130/tick-stock-panel:latest。 - 现成镜像默认不含老 CPU 兼容内核(体积考虑),有此需求请用方式 B 自构建,详见 docs/deployment.md。
cp .env.example .env
docker compose up --build
# 打开 http://localhost:3018🐳 Codex CLI 挂载、版本覆盖与插件开关(点开查看)
镜像内置固定版本的 Codex CLI，Compose 会将主机 ${HOME}/.codex 只读挂载到容器，因此主机需先完成 Codex 登录。若主机 Codex 使用 loopback local-access provider，容器会保留实际端口并自动将主机名映射为 host.docker.internal。需要覆盖镜像内版本时可设置构建参数：
CODEX_CLI_VERSION=0.144.3 docker compose up --buildWindows 用户注意：纯 PowerShell / CMD 下
HOME环境变量通常未设置，会导致挂载路径解析失败、容器读不到 Codex 登录态。请在.env中显式指定主机 Codex 目录：# PowerShell 示例(实际路径以本机为准) echo "CODEX_HOME_HOST=C:\Users\你的用户名\.codex" >> .env
Codex CLI 模式允许 TickFlow 容器读取本机 Codex 登录凭据，仅应在受信任的本机环境启用。凭据目录以只读方式挂载，不会写入镜像。
📖 Docker 进阶、老 CPU 兼容、访问密码设置等见 docs/deployment.md。