TickFlow股票面板

🚀 快速开始

已装 Docker?一条命令跑起来 ⬇️

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 管理

</div>

<br/>

方式 B:Docker Compose(本地构建,全套挂载)

```bash cp .env.example .env docker compose up --build

方式 C:本机 AI 代部署(AI玩家首选)

装一个本机 AI 编程助手(Trae / Codex / OpenCode / ZCode / WorkBuddy 等,任选其一),新建一个空文件夹用助手打开,把下面这段话原样发给它:

帮我部署开源项目 https://github.com/shy3130/tick-stock-panel 到本机:
克隆到当前文件夹;有 Docker 优先拉 ghcr.io/shy3130/tick-stock-panel:latest 现成镜像,没有就走 Dev 模式;
缺少的依赖(Docker / Python / Node)帮我一起装好;
最后告诉我浏览器打开哪个地址、需要填哪些 Key。

AI 会自动完成克隆、装依赖、启动服务,完成后浏览器打开 <http://localhost:3018> 即可;TICKFLOW_API_KEY 等配置按 AI 提示填,详见 配置。

docker-compose.yml 的 app 服务

mem_limit: 1500m memswap_limit: 3g # 留 swap 缓冲, 避免偶发峰值直接触发 OOM kill

- **不要在 2 GB 机器上跑回测/参数优化/因子挖掘**:这类任务会另起独立 worker 进程并重新加载整套后端,单个约 800 MB,与主进程叠加必然超出。
- **不要多开实例**:每个后端实例都会各自构建一份历史缓存。重复运行启动脚本会叠加占用,Windows 可用下面的命令确认是否只有一个:

  

• 确认预热规模:data/logs/backend.log 中的 enriched 历史缓存: N rows 表示本次预热实际载入的行数,N 越大占用越高。历史数据较少时(例如首次只同步了几十天)内存会明显低于上表。

跑起来后的第一次使用

1. 设置 → 凭据与能力 → 点 重新检测,确认档位标签与能力路由矩阵
2. 设置 → 立即跑盘后管道:拉日 K + 计算 enriched 表(None / Free 走 free-api,当日数据盘后 1-2 小时可用)
3. 自选页加标的 → 策略页点策略卡片扫描 / 配自定义信号
4. 回测页选策略 + 区间 → 看净值 / 夏普 / 交易明细(SSE 实时进度),结果可导出 CSV、存候选一键复测
5. 监控中心配规则,盘中实时弹窗 + 持久化记录;异动监控覆盖竞价/盘中/偏移全时段
6. 配好 AI Key 后,悬浮球 / ⌘K 呼出 AI 对话助手,直接问「今天市场怎么样」「我的自选表现如何」「我的扩展数据表里有什么」,或让它「生成一个放量站上 20 日线的信号」「检查一下数据完整性」——写操作会先弹确认卡, 你点确认才执行
7. 想接自己的程序?设置 → 开放接口建个 Token,照着 examples/open-api 十分钟跑通第一个脚本;AI 玩家直接配 MCP
8. 想定制页面?核心之外 11 个官方页面都是单文件扩展(新装默认隐藏,在设置 → 菜单设置开启);自己开发的页面用 frontend/page-pack-template 打包,经设置 → 页面插件上传即用,宿主无需重建

---

📸 界面预览

看板 Dashboard	策略 Screener
回测 Backtest	挖掘 Mining
监控中心 Monitor	市场环境 Regime

📸 [查看更多界面截图 »](./screenshots/README.md)

</div>

---

.env

POLARS_MAX_THREADS=2 # 主要收益项: 用约 40% 的构建耗时换 500MB 内存

⚙️ 配置

所有配置从根目录 .env 读取(复制 .env.example 开始),也可在面板 设置 页修改。最常用的三项:

TICKFLOW_API_KEY=              # 留空 = None 模式(历史日K免费);填 Key 解锁更多
AI_API_KEY=                    # 留空 = 关闭 AI;填 Key 启用策略生成与 AI 对话助手
PORT=3018                      # 服务端口

📖 完整配置项(数据源档位、AI、服务、密码、老 CPU 兼容)见 docs/configuration.md。

---

🌐 开放能力(Open API + MCP)

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

🌐 开放平台门户已上线 → tsp.shy313.com 浏览 TSP 全部功能 · 注册账户 · 邀请好友 · 创建 API Key · 在线调用开放接口,一个入口直达。

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

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

```bash

核心域 / 扩展域边界

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

设置 → 菜单设置里每个页面带 核心 / 扩展 架构徽标与 内置 / 自定义 / 扩展 类型徽标;11 个官方页面(概念/行业/个股/财务分析、监控中心、异动、持仓提醒、模拟盘、信号库、复盘、连板梯队)已全部落地为 frontend/src/custom/<ns>/extension.tsx 单文件扩展 —— 删除目录即卸载、复制目录即导入;例如监控中心页面可换,规则引擎与推送管道属核心照常运行。新装默认隐藏这些扩展页面(菜单设置一键开启),老用户升级自动保持原菜单位置与排序。免宿主重建的运行时分发走页面插件(设置 → 页面插件,契约见 docs/page-sdk.md)。详见 docs/open-platform-plan.md。