mirror of
https://ghfast.top/https://github.com/aeroxw/tick-stock-panel.git
synced 2026-09-12 20:14:16 +08:00
Jinfeng SunandClaude Fable 5
b0d1f2f742
* feat: 自选/个股分析/K线查询接入 ETF 数据层此前已完成 ETF 同步与存储 (instruments_etf / kline_etf_* / adj_factor_etf), 但查询侧仍只走股票路径。本次把已有的 ETF 读取能力 接到面向用户的接口上: - repository: 新增 get_etf_symbol_set / resolve_asset_type 按 symbol 判定资产类型; get_minute / get_minute_batch / latest_minute_date 增加 asset_type 参数切换 ETF 分钟K存储 - kline API: instruments/search 增加 asset_types 参数 (默认 stock, 既有调用方行为不变), 结果附 asset_type; instruments/names 合并 ETF 名称; /daily /minute /minute-batch 按资产类型分流 - watchlist API: /enriched 合并 ETF enriched 缓存行, 名称补齐支持 ETF - 个股分析: /levels 与 AI 分析按资产类型分流, ETF 无财务数据走 已有兜底提示 - 前端: 自选搜索框传 asset_types=stock,etf 并显示 ETF 标记 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix: 修复 ETF 接入的审查发现问题 多智能体代码审查确认的 9 处问题修复: - watchlist /enriched: 仅自选实际含 ETF 时才加载 ETF enriched 缓存, 避免无 ETF 用户在缓存冷启动时触发全量懒加载阻塞请求; 恢复股票 enriched 预热期间 all-or-nothing 旧契约 (不再返回只有 ETF 的部分结果); as_of 取股票/ETF 两类缓存中较旧者, 不再把旧 ETF 行标成股票缓存日期 - repository: refresh_cache 失效 _etf_enriched_cache, 盘后管道跑完 ETF 行不再停留在旧日期; get_etf_symbol_set / get_index_symbol_set 增加 memo (随 instruments 缓存失效), 热路径不再每请求重建全量集合; 新增 get_name_map 统一股票+ETF 名称解析, 收敛三处重复合并逻辑 - kline /daily: 实时蜡烛注入改为资产感知, ETF 开启实时拉取时同样 注入今日 bar (未开启时由"非今日不注入"守卫自然跳过) - kline search: 空关键词早退提前到数据处理之前; symbol 列 dtype 归一到 Utf8, 防两份缓存来源 dtype 不一致导致 concat SchemaError 已知限制 (不在本次范围): kline_etf_minute 目前无盘后同步写入方, ETF 分时依赖"本地缺失 → TickFlow 实时补拉"路径, 与其他未同步分钟K 标的行为一致。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <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
📖 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 提供数据服务,使用前请遵守其服务条款。
社区
本开源项目已链接并认可 LINUX DO 社区。