shy3130/tick-stock-panel

▲ 108 stars today★ 7,589⑂ 1,852

TSP自托管、零运维的 A 股「自建策略 + 监控 + 回测」量化工作台 | LLM能力驱使策略定制+个股分析+复盘 | 自由接入第三方数据源与个性化扩展数据 | 个人开源

About shy3130/tick-stock-panel

shy3130/tick-stock-panel is an open-source project on GitHub, mainly written in Python. TSP自托管、零运维的 A 股「自建策略 + 监控 + 回测」量化工作台 | LLM能力驱使策略定制+个股分析+复盘 | 自由接入第三方数据源与个性化扩展数据 | 个人开源 It currently holds 7,589 stars and 1,852 forks with 61 open issues, and was last pushed on 2026-11-11 (repository created 2026-06-18).

Project Overview

Git Homed tracks it on the Today's Trending board, currently at rank #47 with 108 new stars today.

GitHub Repository Details

Repository shy3130/tick-stock-panel · default branch main · size 41755 KB · watchers 40 · source: GitHub REST API and repository README

README

TSP · A股智能量化工作台

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

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

3.11+
_{Python 后端}

20+
_{Node 前端}

18
_{React · TypeScript}

3000+
_{测试全绿 · CI 守护}

ms 级
_{全市场策略扫描}

1 容器
_{零外部数据库}

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

---

https://github.com/shy3130/tick-stock-panel/blob/HEAD/赞助支持 Sponsor

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

---

[!IMPORTANT]

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

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

---

💡 为什么做 TSP

✨ 核心功能

数据与策略研究

市场观察与监控

开放能力与工作区扩展

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

---

📸 界面预览

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

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

📸 查看更多界面截图 »

---

🏗️ 架构

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

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

一句话:核心是引擎,其余皆插件。下面这张图,先看懂虚线框与实线框的边界,就看懂了 TSP。

总览 · 网关居中的开放单体

双通道并行:面板走密码会话,外部走 Token 网关 —— 互不影响、互不挤占限流。核心域 8 个域是数据与语义的所有者;扩展域 5 条通道只消费契约,零核心改动。

架构特点

核心域 / 扩展域边界

按「数据与语义的归属 + 依赖箭头方向」划分,而非页面外观:

| | 内容 | 划线依据 | | :------------------ | :--------------------------------------------------------------------------------------------------------------------- | :---------------------------------------- | | 核心域 · 8 | 数据底座 / 能力路由 / 订阅锚点(自选) / 策略与回测 / 因子与挖掘 / 环境数据生产 / 监控推送管道 / 扩展数据存储 + 认证配置 | 被多个模块消费其数据与语义,自身不依赖外围 | | 扩展域 · 5 通道 | 数据源插件 · 扩展数据表 · 自定义策略/信号 · 页面扩展(单文件源码 + 运行时页面插件) · 后端 custom 模块 | 只消费核心契约,可整体替换/移除而不伤核心 |

设置 → 菜单设置里每个页面带 核心 / 扩展 架构徽标与 内置 / 自定义 / 扩展 类型徽标;11 个官方页面(概念/行业/个股/财务分析、监控中心、异动、持仓提醒、模拟盘、信号库、复盘、连板梯队)已全部落地为 frontend/src/custom//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//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 拷进后端镜像 |

---

⚡ 性能

不是口号 —— 每一行都有机制支撑,数字全部来自本仓库的真实测试与实现。

核心引擎

开放层的性能(网关裁决 O(1)、契约快照守护、亚秒级事件推送等)见下方开放能力章节。

---

🌐 开放能力(Open API + MCP)

面板的核心能力不只长在页面上 —— 全部开放成受控接口,外部程序与 AI 客户端平等消费:

🌐 开放平台门户已上线 → tsp.shy313.com

浏览 TSP 全部功能 · 注册账户 · 邀请好友 · 创建 API Key · 在线调用开放接口,一个入口直达。

设置 → 开放接口 · Token 管理 _{明文只显示一次,六档 scope 按需授予}	设置 → 菜单设置 · 架构标注 _{每页核心/扩展徽标,悬停看归属原因}

开放接口面向本部署的二次开发与本地工具集成(自有页面、脚本、机器人、MCP 客户端),不作为数据对外分发通道;公网部署默认仅接受内网 Token 调用,详见 configuration.md → 开放接口网络门禁。

# 十行内跑通第一个调用
curl -H "Authorization: Bearer tsp_xxxx" \
  "http://localhost:3018/api/kline/daily?symbol=600519.SH&limit=10"

---

🤖 AI 对话助手

不想挨个页面点着找数据?把问题直接问出来 —— 助手在本地真实数据上调用工具取数, 逐字流式作答, 每次取数都可展开核对。

能问什么

21 个查询工具覆盖全站页面能力, 5 个动作工具经确认卡放行 (可开免确认):

交互设计

工具足迹卡 — 每次调用的工具名、参数、耗时、结果摘要均可展开核对; 取数可核对是设计铁律
动作确认卡 — 生成信号/回测/加自选/数据补全等写操作先弹确认卡(完整待执行参数可见), 你点

GitHub Stars & Activity

7,589Stars

1,852Forks

61Open issues

PythonLanguage

GitHub Popularity

GitHub stars7,589

Forks1,852

Open issues61

Primary languagePython

LicenseMIT

Stars gained today108

Created2026-06-18

Last pushed2026-11-11

Trending History

Daily boardrank #47 · ▲ 108 stars