tick-stock-panel 首次使用向导实战：从登录到第一次选股的完整路径
【免费下载链接】tick-stock-panelTSP自托管、零运维的 A 股「选股 + 监控 + 回测」量化工作台 | LLM能力驱使策略定制+个股分析+复盘 | 自由接入第三方数据源与个性化扩展数据 | 个人开源项目地址: https://gitcode.com/GitHub_Trending/ti/tick-stock-panel
tick-stock-panel（TSP）是一款自托管、零运维的 A 股「选股 + 监控 + 回测」量化工作台，数据全部落在本地，行情、选股、回测、监控一体化。本文带你走通首次使用的完整路径：从打开面板、登录设密、完成 5 步引导向导，到跑通第一次盘后数据管道，最后在选股页点一下策略卡片，完成人生第一次全 A 股扫描。全程不需要写一行代码。
一、准备工作：一条命令跑起面板
首次使用 tick-stock-panel 只需要本机装好 Docker，然后执行一条命令：
docker run -d --name tsp -p 3018:3018 -v ${PWD}/data:/app/data ghcr.io/shy3130/tick-stock-panel:latest浏览器打开http://localhost:3018即可进入面板。本地无需 Python / Node，数据目录data/会挂载在宿主机，行情、回测、监控记录全部在自己手里。更多部署方式（Compose 本地构建、Dev 开发模式、老 CPU 兼容）见 docs/deployment.md，配置项详解见 docs/configuration.md。
💡 完全不想碰命令行的用户，也可以把 README 中「方式 C」的提示词直接发给本机 AI 编程助手，让它代你完成部署。
二、第一步：登录或设置访问密码
打开面板后，你会先到达访问认证页（源码：frontend/src/pages/Auth.tsx），它复用同一套组件处理两种状态：
| 场景 | 页面表现 |
|---|---|
| 首次访问（未设密码） | 显示「设置访问密码」，设置并进入即完成 |
| 已设过密码 | 显示「登录访问」，输入密码继续 |
两个实用细节：
- 登录失败有后端限流保护（5 次失败锁定 5 分钟），别暴力尝试；
- 公网部署时，首次设置密码只允许本机或内网访问，防止陌生人抢先锁死你的面板。若提示被拒，可改用环境变量
AUTH_PASSWORD预置，或走 SSH 端口转发，方法见 docs/deployment.md。
⚠️ 密码至少 6 位，否则会被跳过。设好之后改密码请走「设置 → 修改密码」，不要依赖环境变量。
三、5 步引导向导：一分钟完成初始化
登录成功后，首次使用会自动进入 onboarding 引导向导（源码：frontend/src/pages/Onboarding.tsx），共 5 步：声明 → 欢迎 → 数据源 → 能力路由 → 完成。
1. 声明：先看清使用边界
第一步是使用声明：本项目为个人开源项目，仅供学习研究，不构成投资建议。点「我已了解，继续」进入下一步。
2. 欢迎：认识九大核心能力
第二步展示 TSP 的能力卡片：看板与自选、策略选股、个股分析、连板梯队、概念行业、财务分析、回测验证、实时监控、本地优先。花 10 秒扫一眼，心里有数后面每个页面是干什么的。
3. 数据源：不填 Key 也能用
这是向导里唯一需要你「动手」的步骤，而且可跳过：
- 默认使用内置TickFlow数据源，Key 留空即为免费 None 模式，可直接同步历史日K，足够完成首次选股；
- 如果注册了 TickFlow 或 fuyao 的 API Key，粘贴进去点「验证并保存」——先验证、通过后才落盘到本地
secrets.json，填错不会污染配置； - 数据源随时可在「设置 → 数据源」中切换或新增自有数据源（YAML 声明自有 HTTP 接口即可），详见 docs/custom-data-source.md。
4. 能力路由：矩阵即真相
第四步自动按优先级（TickFlow → fuyao → stock-sdk）为每类数据集分配数据源，并以能力路由矩阵呈现：日K、除权、实时、分钟K、财务各数据集当前生效的是哪个源、是否可用，一目了然。
5. 完成：写标记进入面板
点「进入面板」，向导写入完成标记并跳转主页——引导页不会再来打扰你。
四、跑盘后管道：备齐第一批选股数据
进入面板后，选股、回测、监控全都依赖一张本地 enriched 指标表。首次使用必须手动跑一次数据管道：
- 打开设置 → 凭据与能力，点「重新检测」，确认当前数据源档位与能力矩阵正常（源码：frontend/src/pages/settings/Keys.tsx）；
- 打开数据页（源码：frontend/src/pages/Data.tsx），点「立即跑盘后管道」：拉日K → 计算 enriched 指标表 → 就绪。
💡 之后每天 15:35（CST）管道会自动执行同样的流程，首次手动跑只是把「等一个交易日」变成「等几分钟」。None / Free 档位下当日数据通常在盘后 1-2 小时可用。
五、（可选）先把常用股票放进自选
正式选股前，建议先到自选页（源码：frontend/src/pages/Watchlist.tsx）把几只关注股票加进自选池：
- 支持多分组管理（M:N 关系），表格 / 卡片双视图切换；
- 表格中自带换手、量比、RSI 等实时指标，盘中按档位自动分流刷新；
- 支持 CSV 导入，懒得手动一只只加的话直接传文件。
六、第一次选股：点一下策略卡片，扫描全 A 股
来到重头戏——选股页（源码：frontend/src/pages/Screener.tsx）：
- 页面顶部可切换
股票 / ETF两个资产池，新手默认选股票； - 策略卡片墙展示了25 个内置策略（趋势突破、均线多头、MACD 金叉放量、量价齐升、超跌反弹、低波动龙头……），每张卡片即一个独立策略文件；
- 点击任意策略卡片，Polars 向量化毫秒级扫完全 A 股，命中标的即时列出，支持结果导出。
几个降低上手难度的细节：
- 内置 4 个策略（见 backend/app/strategy/builtin/）打开即可用，无需配任何参数；
- 想按自己的条件选股？页面上可直接配置自定义信号（数值比较 + 交叉条件），或让 AI 根据一句自然语言描述生成信号；
- 策略触发、回测、监控共用同一套 enriched 口径，你在选股页看到的信号和回测里的入场信号是同一套逻辑，不会「回测很猛、实盘对不上」。
策略体系（内置策略清单 + 三种扩展方式）完整说明见 docs/strategy.md。
七、选股之后：回测验证 + 监控盯盘
拿到一批候选股后，建议顺手把研究闭环走完：
- 回测（源码：frontend/src/pages/Backtest.tsx）：选策略 + 区间，查看净值曲线、夏普、最大回撤、胜率、盈亏比，真实约束 T+1 / 手续费 / 滑点全算上，进度 SSE 流式推送，切页不丢任务；结果可导出 CSV、保存候选一键复测；
- 监控中心：给策略或个股配置监控规则，盘中命中实时弹窗 + 语音播报，触发记录持久化，还能推送到飞书 / 企业微信。
八、首次使用路径速查
| 步骤 | 操作 | 入口 |
|---|---|---|
| 1 | Docker 一条命令启动面板 | 终端 |
| 2 | 设置访问密码 / 登录 | 浏览器首屏 |
| 3 | 完成 5 步引导向导（Key 可留空） | 自动进入 |
| 4 | 重新检测数据源能力 | 设置 → 凭据与能力 |
| 5 | 立即跑盘后管道 | 数据页 |
| 6 | （可选）添加自选股 | 自选页 |
| 7 | 点策略卡片完成第一次选股 | 选股页 |
| 8 | （进阶）回测验证 + 配置监控 | 回测页 / 监控中心 |
到这里，你已经完整走通了 tick-stock-panel 从登录到第一次选股的主路径。接下来可以按 docs/features.md 逐步解锁个股分析、因子平台、异动监控等模块——它们都建立在同一套本地数据与统一口径之上，越用越顺。
⚠️ 本项目仅供学习与量化研究，不构成任何投资建议。回测结果不代表未来收益，A 股有风险，入市需谨慎。
【免费下载链接】tick-stock-panelTSP自托管、零运维的 A 股「选股 + 监控 + 回测」量化工作台 | LLM能力驱使策略定制+个股分析+复盘 | 自由接入第三方数据源与个性化扩展数据 | 个人开源项目地址: https://gitcode.com/GitHub_Trending/ti/tick-stock-panel
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
