mirror of
https://ghfast.top/https://github.com/aeroxw/tick-stock-panel.git
synced 2026-09-12 17:54:15 +08:00
Jinfeng SunandClaude Opus 4.8
e5a94c42d5
* feat(screener): 选股引擎支持 ETF - 12 个内置策略打 asset_types 白名单 + strategy_supports_asset;涨停类 (连板/断板反包)仅股票,其余 10 个技术类对 ETF 开放 - ScreenerService(repo, asset_type) 分流取数,ETF 复用 kline_etf_enriched, 跳过股票专用历史缓存与涨停信号;进程级 _history_cache key 含 asset_type - API /run、/run_preset 透传 asset_type;/strategies 按资产过滤; 股票专有策略在 ETF 下返回空 - 新增 enriched_dirname(asset_type) 共享 helper;get_enriched_latest_asset 增 refresh 参数(供轮询线程避免冷缓存同步重算) - 前端「策略」页加 股票/ETF 切换,ETF 走实时单跑(空日期→用 ETF 自身最新日); QK.screenerStrategies 按 asset_type keyed - 测试:test_screener_etf.py Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * feat(backtest): 回测支持 ETF(个股/因子/策略组合) - 三条回测路径 + 共用 BacktestEngine 面板加载按 asset_type 路由到 kline_etf_enriched(复用 enriched_dirname);PanelCache key 隔离资产; ETF 跳过股票专用 get_enriched_range 缓存 - 面板 compute_all/名称 JOIN 按 asset_type 取维表(get_instruments_asset), 修复 ETF 策略回测用错股票维表致名称为空/涨停信号算错 - BacktestConfig/FactorConfig/StrategyBacktestConfig 增 asset_type - 三个回测 API + SSE stream 透传 asset_type;_make_job_key 纳入 asset_type (修复 stream 与 cancel job_key 不对齐致取消失效的回归) - 前端策略组合页/因子页加 股票/ETF 切换,标的搜索与策略列表跟随资产; assetType 持久化 - 测试:test_backtest_etf.py(含 job_key 一致性回归);既有回测测试替身同步 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * feat(monitor): 监控规则支持 ETF - engine.evaluate(df, asset_type) 按规则 asset_type 分轮评估;quote_service 增开 ETF 评估轮(用 ETF enriched 快照),股票轮不受影响、不重置其策略结果 - ETF 评估轮独立 try(异常不丢弃已算出的股票告警)+ refresh=False(不在轮询 线程触发 ETF 冷缓存同步重算) - ETF 版历史加载器(main.py 注入)+ 按规则 asset_type 选加载器 - _strategy_pools 按 (sid, asset_type) 键,避免同策略股票/ETF 规则互相覆盖 - name_map 仅在有 ETF 规则时补 ETF 维表, setdefault 保股票名优先 - RuleModel/normalize 增 asset_type(默认 stock,持久化往返) - 前端 RuleEditor 加 股票/ETF 选择,策略列表与标的搜索跟随资产 - 测试:test_monitor_etf.py Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * feat(etf): 前端 API 绑定透传 asset_type + 文档 - api.ts: screener/backtest 绑定加 assetType 参数,MonitorRule 类型加 asset_type - docs/features.md: 标注选股/回测/监控的 ETF 支持范围与前提 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(reliability): 管道并发/原子写/能力探测/监控告警多处加固 后端可靠性专项修复(均带回归测试, backend 全套 64 passed): 并发与数据完整性: - 盘后管道单飞: JobStore.create() 去重纳入 pending∨running, 关闭"两次快速点击" 并发双跑窗口; 新增 _heavy_run_lock 执行槽挡住 reap 后僵尸线程并发写 parquet - adj_factor/minute 全部改走原子写(tmp+replace), 消除 kill/断电致 all.parquet 损坏 - 分块拉取失败聚合 WARNING 可见化(不再静默当成功); 复权失败标的会保持旧价已提示 能力探测: - 周期重探(60min)热更新 app.state.capabilities, 付费 Key 过期/续费无需重启即可见 - 瞬时探测失败(超时/连接/5xx, 按 _is_transient 判定)不降级、保留旧付费档; 真 401/无权限仍正常降级回落 free-api 监控告警: - 评估仅在连续竞价(9:30-11:30/13:00-15:00)+ 快照当日新鲜度下进行, 避开集合竞价/ 收盘后陈旧价与节假日误告警 - scope=sector fail-closed(validate 拒绝新建 + _apply_scope 返回空), 修复板块规则 对全市场刷屏 - 飞书 webhook 加退避重试并移到独立线程池 fire-and-forget, 不再阻塞行情轮询线程 单标的新鲜度: 新增 repo.symbols_lagging() 检测掉队标的并 WARNING + 计入 job 结果 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
📈 A股智能量化工作台
自托管、零运维的 A 股「选股 + 监控 + 回测」量化工作台
面向个人散户与量化爱好者而生
本项目个人开源，基于 TickFlow 数据源，非 TickFlow 官方项目。仅供学习研究使用，与 TickFlow 官方无任何隶属或合作关系。
明确不做:不对标同花顺 / 通达信,不内置「AI 荐股 / 涨停预测」。
⚠️ 考虑到 tickflow 数据源没有人气/资金流向等个性化数据,我将开放自有的第三方数据以供大佬们研究使用,包括但不限于当前内置的 ths 概念/ths 行业(后续更新在这里)。
有更多想法,或提交建议/意见的道友可以邮件到 415333856@qq.com,Q 群 109338242。
觉得有用可以点个 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
镜像已内置 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 推送(QMT/掘金下单)· 板块异动 · 早晚报 · 更多扩展 | 🚧 |
📚 完整文档
| 文档 | 内容 |
|---|---|
| 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 社区。