shy3130
3ae7ead21a
评分模型重新设计(regime_builder.py) - 归一化: _LIN 多点插值 → _score(low,high)(与看板 market_overview_builder 同款, 简洁不易设错) - 维度: 赚钱效应/指数趋势/板块结构/活跃度 → 赚钱/投机/抗跌/趋势(对齐看板轻量维度) - 新增「抗跌」维度(原模型完全缺失): 用 strong_down_pct 识别大跌日, 这是 weak 能出现的关键 原 board_structure(涨停-跌停对比, A股涨停常年>跌停致虚高)移除; activity(成交额曾恒满分)移除 - 权重调整 + _score 参考点用 A股真实分位数校准(非拍脑袋) - 阈值与看板统一: 75/60/40/25 → 70/55/45/30 _aggregate_daily 增强 - 新增聚合列: avg_pct/median_pct/strong_up_pct/strong_down_pct(供新评分模型 + 未来策略扩展) - 全部 polars group_by 向量化(不回退逐日 filter) 性能 - _scan_enriched_fallback needed 去掉 vol_ratio_5d(实测 compute_limit_signals 函数体未实际使用) → 全量补算数据量 657MB→617MB(省40MB), 配合分批内存峰值维持 ~1.9GB 修复 upsert schema 迁移(导致 recompute 500 的真实 bug) - _aggregate_daily 新增4列后, 旧 regime parquet(15列)与新产出(19列)concat 报 schema lengths differ - upsert_regime_history concat 前做 schema 对齐: 以新列名+顺序为权威给旧数据补缺失列(null) → 旧 parquet 首次重写时自动迁移到新 schema 前端饼图标签重叠修复(Regime.tsx) - 状态分布饼图标签外置 + 虚线引导线(labelLine), 解决5个状态标签互相重叠 - labelLayout 防重叠, formatter 从两行改一行 验证 - 后端 583 passed(含新增抗跌维度专项测试) - 真实数据全量分布: weak 从 0% → 有合理占比(原模型永不出现 weak) - 内存峰值 ~1.9GB(分批+needed白名单保障) - tsc + pnpm build 通过
📈 A股智能量化工作台
自托管、零运维的 A 股「选股 + 监控 + 回测」量化工作台
面向个人散户与量化爱好者而生
本项目个人开源，基于 TickFlow 数据源，非 TickFlow 官方项目。仅供学习研究使用，严禁商业用途。
⚠️ 小白请绕路，本开源项目谨作为本地量化提供解决思路Demo，不作为投资软件或者看盘软件。
明确不做:不对标同花顺 / 通达信,不内置「AI 荐股 / 涨停预测」。
有问题可以邮件415333856@qq.com,交流群二维码在文末。
觉得有用可以点个 Star
✨ 核心功能
| 模块 | 一句话 | 详见 |
|---|---|---|
| 🔍 选股引擎 | 18 个内置策略 + 自定义信号 + AI 生成 + 代码迁移,Polars 毫秒级扫全 A 股 | strategy.md |
| 📊 指标流水线 | MA/EMA/MACD/RSI/KDJ/布林/量比等,一次扫表落盘 enriched Parquet | features.md |
| 🧪 回测引擎 | 三种模式(个股/策略组合/自由信号),T+1/手续费/滑点/止损,SSE 流式进度 | features.md |
| 📡 监控中心 | 四类监控(策略/个股信号/价格/异动),多条件 AND/OR + 语音播报 + 飞书推送 | features.md |
| 📈 个股分析 | 9 类关键价位 + AI 四维分析(技术/基本面/财务/消息面) | features.md |
| 🏆 连板梯队 | 连板层级统计 + 概念涨幅轮动 + 盘后 AI 复盘 + 炸板/翘板预警 | features.md |
| 🧰 数据扩展 | TickFlow 多源 + 第三方接入(接口/推送/CSV/JSON)同台分析 | features.md |
📦 主要页面与功能
📊 行情总览
- 看板 Dashboard — 市场情绪评分 + 涨跌/成交额榜单 + 概念领涨领跌 + 大盘异动事件流,一日全貌
- 自选 Watchlist — 自选股池,表格/卡片双视图,换手/量比/RSI 等实时指标
- 指数 Indices — 沪深指数浏览与同步
🔍 选股与回测
- 策略 Screener — Polars 毫秒级扫描全 A 股,18 个内置策略卡片 + 自定义条件
- 回测 Backtest — 两种模式:
- 因子回测 — IC/IR、分层收益、多空组合,先筛掉无效指标
- 策略回测 — 净值曲线、回撤、夏普、胜率,支持 T+1/手续费/滑点/止损,SSE 流式进度
📈 个股与板块分析
- 个股分析 Stock Analysis (Beta) — 日K + 9 类关键价位 + AI 四维分析(技术/基本面/财务/消息面)
- 财务分析 Financials — 利润表/资负表/现金流/关键指标 + AI 解读
- 概念分析 Concept Analysis — ths 概念涨幅轮动矩阵 + 领涨/领跌主线 + 个股穿透
- 行业分析 Industry Analysis — 行业分层涨幅轮动 + 领涨/领跌主线 + 成分股
- 连板梯队 Limit Up Ladder — 连板层级统计 + 概念/行业分布 + 封单监控(可切换连跌梯队)
🔔 监控与复盘
- 监控中心 Monitor — 策略/个股信号/价格/异动四类规则,盘中实时弹窗 + 语音播报(播报个股名称与信号) + 触发记录持久化
- 复盘 Review (Beta) — 盘后 AI 自动生成市场复盘,可定时执行、推送飞书、下载 Markdown
🗄️ 数据与扩展
- 数据 Data — 本地数据画像与同步状态(维表/日K/除权/Enriched/指数/ETF/分钟K/财务),盘后管道与历史扩展
- 扩展分析 (动态菜单) — 把任意第三方/扩展数据字段配成一级菜单,与内置数据同台分析
- 设置 Settings — TickFlow Key 与订阅档位、AI 接口、实时监控、扩展页面、信号库、菜单与系统设置
📸 界面预览
| 看板 Dashboard | 策略 Screener |
 |
 |
| 回测 Backtest | 监控中心 Monitor |
 |
 |
| 连板梯队 Limit Ladder | 概念分析 Concept |
 |
 |
🚀 快速开始
前置依赖:Python ≥ 3.11 · Node ≥ 20 ·
uv·pnpm(npm i -g pnpm)
方式 A:Dev 模式(二次开发推荐)
cp .env.example .env # 按需填 TICKFLOW_API_KEY(留空 = None 模式)
./dev.sh # Windows: .\dev.ps1
自动检查 / 下载依赖、释放端口、同时起前后端。后端 → http://localhost:3018 · 前端 → http://localhost:3011。
方式 B:Docker(部署最省心)
cp .env.example .env
docker compose up --build
# 打开 http://localhost:3018
Docker 镜像内置固定版本的 Codex CLI，Compose 会将主机 ${HOME}/.codex 只读挂载到容器，因此主机需先完成 Codex 登录。若主机 Codex 使用 loopback local-access provider，容器会保留实际端口并自动将主机名映射为 host.docker.internal。需要覆盖镜像内版本时可设置构建参数：
CODEX_CLI_VERSION=0.144.3 docker compose up --build
Windows 用户注意：纯 PowerShell / CMD 下
HOME环境变量通常未设置，会导致挂载路径解析失败、容器读不到 Codex 登录态。请在.env中显式指定主机 Codex 目录：# PowerShell 示例(实际路径以本机为准) echo "CODEX_HOME_HOST=C:\Users\你的用户名\.codex" >> .env
Codex CLI 模式允许 TickFlow 容器读取本机 Codex 登录凭据，仅应在受信任的本机环境启用。凭据目录以只读方式挂载，不会写入镜像。
镜像已内置 stock-sdk 数据源插件(Node 运行时 + 依赖),开箱即用。
📖 Docker 进阶、GitHub Actions 自构建、老 CPU 兼容、访问密码设置等见 docs/deployment.md。
跑起来后的第一次使用
- 设置 → 凭据与能力 → 点 重新检测,确认档位标签
- 设置 → 立即跑盘后管道:拉日 K + 计算 enriched 表(None / Free 走 free-api,当日数据盘后 1-2 小时可用)
- 自选页加标的 → 选股页点策略卡片扫描 / 配自定义信号
- 回测页选策略 + 区间 → 看净值 / 夏普 / 交易明细(SSE 实时进度)
- 监控中心配规则,盘中实时弹窗 + 持久化记录
⚙️ 配置
所有配置从根目录 .env 读取(复制 .env.example 开始),也可在面板 设置 页修改。最常用的三项:
TICKFLOW_API_KEY= # 留空 = None 模式(历史日K免费);填 Key 解锁更多
AI_API_KEY= # 留空 = 关闭 AI;填 Key 启用策略生成
PORT=3018 # 服务端口
📖 完整配置项(数据源档位、AI、服务、密码、老 CPU 兼容)见 docs/configuration.md。
🏗️ 技术栈
| 层 | 选型 |
|---|---|
| 后端 | FastAPI · Pydantic v2 · APScheduler · sse-starlette |
| 数据 | Polars(计算)· DuckDB(查询)· Parquet(存储) |
| 回测 | vectorbt(全项目唯一 pandas 边界) |
| 数据源 | TickFlow 官方 SDK · 其他数据源后续迭代实装 |
| AI(可选) | OpenAI 兼容接口(DeepSeek / 通义 / Ollama 等) |
| 前端 | React 18 · Vite · TypeScript · Tailwind · Tanstack Query · Lightweight Charts · ECharts · dnd-kit |
| 部署 | Docker 两阶段构建,前端 dist 拷进后端镜像,单容器 |
🗺️ 路线图
| Phase | 内容 | 状态 |
|---|---|---|
| 0-1 | 仓库骨架 · FastAPI 壳 · 能力探测 · K 线同步与分析页 | ✅ |
| 2-3 | Polars enriched 流水线 · Screener · vectorbt 回测(T+1/手续费/止损) | ✅ |
| 4-5 | 监控引擎 · 四类监控规则 · 实时 SSE 推送 · 持久化记录 | ✅ |
| 6 | 个股分析(专用日 K + 9 类关键价位 + AI 四维分析) | ✅ |
| v2 | Webhook 推送· 板块异动 · 早晚报 · 更多扩展 | 🚧 |
📚 完整文档
| 文档 | 内容 |
|---|---|
| docs/deployment.md | 部署方式(Dev / Docker / GH Actions)、老 CPU 兼容、更新代码、访问密码 |
| docs/configuration.md | 所有 .env 配置项详解(数据源、AI、服务、密码、数据目录) |
| docs/features.md | 各功能模块详细说明(选股/指标/回测/监控/个股分析/数据扩展) |
| docs/custom-data-source.md | 自定义数据源接入、YAML 配置与 mock 联调示例 |
| docs/strategy.md | 策略体系(18 内置策略 + 三种扩展方式 + 文件结构) |
| backend/app/strategy/prompts/strategy-guide.md | 策略开发完整规范(AI 生成与手写) |
fork同时请点个star哦,欢迎 Issue 和 PR。
💬 交流群
欢迎加入交流群,讨论交流。
⚠️ 免责声明
本项目仅供学习与量化研究,不构成任何投资建议。回测结果不代表未来收益。A 股有风险,入市需谨慎。数据准确性以数据源 TickFlow 官方为准。
📄 License
MIT © tickflow-stock-panel contributors
本项目依赖 TickFlow 提供数据服务,使用前请遵守其服务条款
数据源插件 stock-sdk 遵循其各自的 ISC 协议。
社区
本开源项目已链接并认可 LINUX DO 社区。