本指南按真实研究流程介绍 StockPro。安装与服务排障见 本地运行手册，产品规则见 产品规格。
- 打开
http://localhost:4444。 - 使用
backend/.env中配置的管理员账号登录。 - 左侧显示 13 个一级工作区：首页、行情、股票池、因子、策略、回测、模拟、盯盘、信号、监控、复盘、数据、AI 研发；以“策略 → 回测 → 模拟”为执行主线。页面顶部或内容区内的下划线标签用于切换二级视图。
- 设置面板可以切换“红涨绿跌 / 绿涨红跌”。
管理员可以执行写操作。访客默认只读，只能在明确配额内运行允许的回测。
进入“数据”工作区，优先检查：
- 最新交易日和数据截止时间；
- 研究数据是否达到可用状态；
- 数据集覆盖率、质量结果和缺失项；
- TuShare/AKShare 来源与 Provider 权限；
- 最近同步任务是否成功；
- 日终计划是否启用、上次和下次运行时间。
“页面能打开”不代表数据可用于研究。过期、部分缺失、无权限和质量失败都会单独显示。
“导入导出”用于交换扩展数据。上传 CSV、JSON 或 XLSX 后，数据只处于“仅暂存·未映射”状态；可重新导出为三种格式或删除。XLSX 公式、超过 5MB、10000 行或 200 列的文件会被拒绝。暂存成功不代表数据已经进入策略或回测。
HTTP 导入默认不可用。管理员必须先在服务配置中填写精确主机白名单；页面会显示允许主机。HTTP 地址必须使用 HTTPS，且不能重定向或解析到私网地址。
全市场同步会调用外部 Provider 并写入 PostgreSQL。执行前确认目标日期、数据范围、Provider 权限和预计任务量。不要为了解决页面空状态反复点击同步。
首页用于快速判断：
- 当前交易时段与市场状态；
- 指数、市场宽度、涨跌停、成交概况、行业强弱和异动边缘；
- 热门板块、告警事件与风险；
- 数据、回测和 Paper 的关键状态。
“首次就绪检查”逐项显示管理员安全、PostgreSQL、研究数据源和封存快照四个必需项，以及策略、Paper、复盘三个后续阶段。点击卡片进入唯一 Owner 页面处理；检查本身不会同步数据或修改配置。“统一复盘”可从首页或模拟盘进入。
行情工作区按二级标签组织：
- 市场结构：指数、涨跌家数、成交和板块轮动；
- 指数：查看主要指数缓存、涨跌幅、来源状态和更新时间；
- 自选：显式添加观察证券与备注；价格、涨跌幅、成交额、换手和量比始终读取当前行情缓存；
- 情绪/涨停：涨停、跌停、炸板、封板率和连板梯队；
- 事件：新闻、公告和市场催化；
- 日历：交易日和重要市场事件；
- 个股研究：日线、分时、盘口、基本面和 AI 证据。
查看任何结论时同时确认交易日、采集时间、来源和新鲜度。不可用值不应被理解为 0。
进入“因子”后，可以：
- 在因子目录中按分类、方向、状态和关键词筛选。
- 查看研究假设、定义、依赖、回看期、版本和发布状态。
- 提交计算任务并查看计算记录。
- 在单因子分析中检查覆盖率、缺失、IC/RankIC、分层收益、换手与衰减。
- 在多因子与相关性视图中判断冗余、暴露和组合关系。
- 查看某次发布的因子值和绑定快照。
平台提供 100 个参考因子作为研究目录。只有已经完成计算、质量检查和发布的因子快照才能被策略稳定引用。
- 选择规则或研究条件。
- 确认使用的数据日期和股票范围。
- 基础条件规则可组合收盘价、开高低、成交量、成交额和涨跌幅，选择“全部满足 AND”或“任一满足 OR”；条件会写入规则版本和成员证据。
- 生成候选结果，检查每只股票的入选原因和命中条件。
- 复核 ST、停牌、板块、上市状态和流动性约束。
- 封存股票池快照。
- 将固定快照交给回测，而不是让回测重新运行一次可变筛选。
进入“策略”：
- 从目录选择策略或创建新策略。
- 在“选股与输入”中进入基础条件、因子、板块/事件选股，生成并封存股票池快照；未封存候选不能作为正式回测输入。
- 编写普通 Python 策略，使用平台提供的
StockPro Strategy API v1。 - 配置参数、依赖、股票范围、运行限制和说明。
- 执行静态验证。
- 保存为不可变版本。
已有版本不会被覆盖。修改代码或参数会创建新的子版本。策略代码不能自行访问网络、TuShare、AKShare、PostgreSQL、文件写入或券商。
回测页顶部“因子验证”进入现有因子诊断引擎；创建向导中的“参数矩阵”用于 1–24 个组合的稳定性检验，Walk-forward 用滚动训练/OOS窗口验证参数。三者都是诊断或研究证据，不能绕过完整回测的 Paper 晋级门控。
- 选择固定策略版本。
- 选择数据快照、股票池/因子快照和时间范围。
- 配置基准、初始资金、手续费、印花税、滑点和容量参数。
- 先用快速回测排查明显问题，再提交完整回测。
- 需要滚动样本外验证时，先用“Walk-forward 预览”根据封存快照生成训练/测试折，再配置不超过12组参数和优化目标后启动持久化任务。
- Walk-forward每折在训练区间选参、在紧邻OOS区间验证；结果展示OOS复利收益、一致性、IS→OOS退化、最优参数和子运行证据，但不能直接晋级模拟盘。
- 在任务列表查看排队、运行、完成、失败、取消和重试状态。
- 在详情中复核收益、基准、超额、回撤、风险指标、月度表现、持仓、订单、成交、日志、代码和参数。
日线策略不能在产生信号的同一根收盘价成交。只有完整回测及其样本外、成本和流动性证据可以用于 Paper 晋级判断。
- 从验证通过的固定策略版本创建 Paper 实例。
- 配置模拟账户、资金、风险规则和执行参数。
- 启动实例并观察心跳和最新周期。
- 检查信号如何经过风控成为订单、成交和持仓。
- 对异常周期、拒单、账本差异和过期行情进行处理。
- 停止实例时确认最终周期和账户证据已保存。
Paper 只做模拟撮合。页面不提供真实券商订单或资金操作。
- 盯盘：从业务视角查看策略、股票、信号、订单、成交、持仓、风控和 K 线上下文。“规则”页可创建策略信号、指标、价格和异动四类观察规则；先用“只读预览”查看命中，再由管理员显式选择“评估并生成告警”。这两个动作都不会下单，只有后者会写入站内告警与通知。
- 监控：从系统视角查看实例心跳、周期、异常、数据健康、风险和通知。
- 复盘：按交易日保存市场结构、热点、风险、操作回顾和下一交易日计划。
正在运行的实例与行情新鲜度是两个不同状态。绿色运行状态不代表数据一定新鲜，黄色或红色告警必须单独处理。
AI 研发用于辅助整理个股或研究对象的证据：
- 选择研究对象和固定证据。
- 确认数据日期、模型和 Provider 可用状态。
- 提交分析并阅读结构化结果。
- 将结果作为研究材料人工复核。
未配置 QWEN_API_KEY 时，外部模型分析不可用。AI 结果不会自动创建策略、自动运行 Paper 或构成投资建议。
先到数据中心检查交易日、同步任务、Provider 权限和质量状态。不要把“暂无数据”理解为数值 0。
检查来源更新时间、调度状态和最近任务。API 的响应时间不等于市场数据更新时间。
通常是策略未验证、输入快照未封存、股票范围为空、参数不合法或当前账号无权限。
检查信号、风控拒绝、T+1、整数手、涨跌停、停牌、现金、最早成交时间和可用行情。
检查 QWEN_API_KEY、网络、模型配置和证据是否完整。不要用假数据绕过不可用状态。
执行 ./restart.sh，然后查看 logs/backend.log、logs/frontend.log 和后端健康接口。详细步骤见 本地运行手册。