📈 A股智能量化工作台

• 🆓 开箱即用 — 留空 Key 即进 None 模式,历史日 K 免费体验,无需付费
• 🏠 自托管零运维 — Docker 单容器部署,数据完全掌握在自己手里
• 🔍 三位一体 — 选股(20 内置策略)+ 实时监控 + 向量化回测,Polars 毫秒级扫描全 A 股
• 🤖 AI 加持 — 一句话生成策略代码,任意 OpenAI 兼容接口均可接入(留空即关闭)
• 🔌 自由扩展 — 自有量化项目数据,与内置数据同台分析
• 🇨🇳 A 股专用 — 盘后自动AI复盘并推送至飞书等;连板梯队、涨停动量、内置ths 概念 / 行业

基于 TickFlow 数据源。明确不做:不对标同花顺 / 通达信,不内置「AI 荐股 / 涨停预测」。

⚠️ 考虑到tickflow数据源没有人气/资金流向等个性化数据,我将开放自有的第三方数据以供大佬们研究使用,包括但不限于当前内置的ths概念/ths行业(后续更新在这里)

有更多稳定免费数据源推荐,或者提交建议/意见的大佬可以邮件到 415333856@qq.com,q群 109338242

觉得有用可以点个 Star，蟹蟹 🌹

🎯 项目定位

面向个人散户与量化爱好者的 A 股分析工作台,聚焦「选股 + 监控 + 回测」三大场景,LLM能力驱动进行市场分析，掌控市场节奏；让普通投资者也能拥有一套可自定义策略的量化工具。

📸 界面预览

看板 Dashboard	策略 Screener
回测 Backtest	监控中心 Monitor
连板梯队 Limit Ladder	概念分析 Concept

🚀 快速开始

前置依赖

方式 A:Dev 模式(二次开发推荐)

cp .env.example .env       # 按需填 TICKFLOW_API_KEY(留空 = None 模式)
./dev.sh                   # Windows: .\dev.ps1

自动检查 / 下载依赖、释放端口、同时起前后端,Ctrl-C 一并关闭。默认:

• 后端 → http://localhost:3018 · 前端 → http://localhost:3011
• 自定义端口:BACKEND_PORT=8000 FRONTEND_PORT=5173 ./dev.sh

方式 B:Docker(部署最省心)

cp .env.example .env
docker compose up --build
# 打开 http://localhost:3018

# 后端
cd backend && uv sync --extra backtest   # 含回测依赖
uv run uvicorn app.main:app --reload --port 3018

# 前端
cd frontend && pnpm install && pnpm dev   # http://localhost:3011

🔄 更新代码(已部署用户必读)

拉取新版本只需一条命令:

git pull

整个 data/ 目录都不纳入 git——行情 K线、财务、自选、回测、监控记录,乃至概念/行业扩展数据,全部是程序运行时生成/拉取的用户数据,git pull 物理上无法影响它们。新用户首次启动时,概念/行业两份扩展数据会自动从远程接口拉取,无需任何手动操作。

⚠️ 切勿使用以下命令"解决冲突"或"清理",它们会一次性删光 data/ 下所有未被 git 跟踪的数据:

• git clean -fdx(最危险,会删掉所有 .gitignore 忽略的文件)
• git reset --hard
• 直接删除整个项目文件夹重新 git clone

若 git pull 报冲突,通常是本地误改了被跟踪的文件,请先 git stash 暂存再 pull,或单独联系作者,不要直接执行上面的命令。

🧭 跑起来后的第一次使用

1. 设置 → 凭据与能力 → 点 重新检测,确认档位标签
2. 设置 → 立即跑盘后管道:拉日 K + 计算 enriched 表(None / Free 走 free-api,当日数据盘后 1-2 小时可用)
3. 自选页加标的 → 选股页点策略卡片扫描 / 配自定义信号
4. 回测页选策略 + 区间 → 看净值 / 夏普 / 交易明细(SSE 实时进度)
5. 监控中心配规则(策略 / 个股信号 / 价格 / 异动),盘中实时弹窗 + 持久化记录

✨ 核心功能

🔍 选股引擎(Screener)

20 个内置策略,每个策略一个独立 Python 文件,基于 Polars 表达式向量化实现(backend/app/strategy/builtin/):

扩展策略的三种方式:

📊 指标流水线(Indicators)

原生 Polars 向量化,全 A 股一次扫表落盘 enriched Parquet:

• 均线 / 趋势:MA(5-60)· EMA · MACD · 动量 · 布林带
• 震荡 / 波动:RSI · KDJ · ATR · 年化波动率 · 振幅
• 量能 / 涨跌停:量比 · 量均线 · 涨停信号 · 连板数
• 原子信号:MA / MACD 金叉死叉 · N 日新高新低 · 布林突破
• 复权:基于除权因子自动前复权,回测与指标口径一致

🧪 回测引擎(Backtest)

基于 vectorbt:三种模式(个股 / 策略组合 / 自由信号组合),真实约束(T+1 · 手续费 · 滑点 · 止损 · 最大持仓天数),组合管理(最大持仓 · 敞口 · 等权 / 自定义仓位)。SSE 流式进度支持切页重连,输出净值曲线 · 夏普 · 最大回撤 · 胜率 · 交易明细。

📡 监控中心(Monitor)

统一规则引擎,一个页面管理四类监控(策略 · 个股信号 · 价格涨跌 · 全市场异动):

• 多条件 AND/OR + 冷却期去重 + 严重级别(info/warn/critical)
• 多入口配置:监控中心新建 / 个股详情页「加监控」/ 策略卡片一键开启
• 命中后右下角弹窗(可配声效)+ 持久化到 alerts.jsonl,菜单未读徽标
• 触发记录详情:每条记录展示命中的具体条件(如 RSI>80)与当前价位,一眼看清为何触发
• 飞书 Webhook 推送:全局一处配置飞书群机器人地址,启用推送的规则命中即推送到飞书群(支持签名校验);可在设置页设「默认推送渠道」,新建规则自动预填

📈 个股分析(Beta)

以「行情 + 关键价位」为主体的单标的决策页:

• 专用日 K 图表:主图 + 成交量 + 滑块,默认近 6 个月
• 9 类关键价位(纯函数实时计算,毫秒级):压力支撑 · 成交密集区 · 枢轴点 · 前高前低 · Keltner 通道 · ATR 止损 · 缺口位 · 斐波那契 · 整数关口
• AI 四维分析:技术 / 基本面 / 财务 / 消息面流式生成,实战派交易员视角

🧰 数据与扩展

• TickFlow 多源数据:日 K / 分钟 K / 指数 / 财务 / 实时行情
• 🔌 第三方接入(重点):Tushare 等 HTTP 定时拉取 · CSV / Excel 上传 · JSON 写入,自动 schema 发现 + 符号归一,页面可视化配置,可与自有量化项目数据并入 DuckDB 同台分析
• 盘后定时管道:APScheduler 15:30 CST 自动拉日 K + 重算 enriched + 跑监控
• 令牌桶限流:适配各档位 rpm / batch,批量合并 + 增量拉取

⚙️ 配置

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

数据源:TickFlow

TICKFLOW_API_KEY=              # 留空 = None 模式(历史日K免费);填 Key = 按订阅档位解锁

留空即 None 模式,通过 free-api 使用历史日 K(当日数据盘后 1-2 小时可用);免费注册 Key 后进 Free 模式,开启自选股实时监控。实时行情按档位:

完整能力矩阵见 tickflow.org/pricing,高等档位含较低档全部权益。

AI(可选)

用于自然语言生成策略。所有配置留空即跳过,不影响核心功能。支持任意 OpenAI 兼容接口:

AI_PROVIDER=openai_compat              # openai_compat | ollama
AI_BASE_URL=https://api.deepseek.com/v1
AI_API_KEY=                            # 留空 = 关闭 AI
AI_MODEL=deepseek-chat
AI_DAILY_TOKEN_BUDGET=500000           # 每日 token 预算上限

服务与数据

HOST=0.0.0.0          # 监听地址
PORT=3018             # 服务端口
LOG_LEVEL=INFO        # DEBUG | INFO | WARNING | ERROR
DATA_DIR=./data       # Parquet / DuckDB 数据存储目录

访问密码

面板首次设置访问密码时,出于安全考虑仅允许本机或内网访问(防公网陌生人抢先设置锁死面板)。公网服务器部署有两种方式设首个密码:

1. 环境变量预置(推荐) — 在 .env 填入 AUTH_PASSWORD,首次启动自动初始化(哈希后写入 auth.json,之后不再读取):

   AUTH_PASSWORD=你的密码    # 至少 6 位;仅首次生效,已设过则不覆盖

2. SSH 端口转发 — 本机执行 ssh -L 3018:127.0.0.1:3018 用户@服务器IP,浏览器开 http://127.0.0.1:3018 设密码

详细步骤与重置密码见 docs/deploy-password.md。设完密码后改密码走页面 UI(设置 → 修改密码)。

🏗️ 技术栈

🗺️ 路线图

📚 文档与贡献

• docs/strategy-guide.md —— 策略开发指南(AI 生成与手写规范)
• docs/ —— 策略构建步骤、示例

欢迎 Issue 和 PR。新增内置策略:在 backend/app/strategy/builtin/ 参照现有文件实现 StrategyDef,引擎自动发现。

⚠️ 免责声明

本项目仅供学习与量化研究,不构成任何投资建议。回测结果不代表未来收益。A 股有风险,入市需谨慎。数据准确性以数据源 TickFlow 官方为准。

📄 License

MIT © tickflow-stock-panel contributors · 本项目依赖 TickFlow 提供数据服务,使用前请遵守其服务条款。

社区

本开源项目已链接并认可 LINUX DO 社区。