股票复盘维护手册

本手册只描述如何生成和检查公开的日级复盘。市场矩阵、字段语义和策略版本规则见股票复盘模块说明。本机 MCP 配置、原始行情缓存、完整策略公式、持仓和交易信息都不进入仓库。

每日节奏

复盘使用 Asia/Shanghai 的 reviewDate 作为主键，同一记录分两次补齐：

亚洲市场收盘后采集 A 股、港股、日本、韩国、台湾指数，以及 A 股市场宽度、自选行情和盘后策略结果。
次日早晨补充对应交易日的美股指数与自选行情。

每个市场保留自己的 sessionDate、asOf、时区、来源和 fresh / stale / closed / pending / failed 状态。休市或来源失败时不伪造收盘数据，也不把一个市场的时间替换成另一个市场的时间。

生成与校验

# 校验仓库中全部公开快照
npm run stock-review:validate

# 先对本机 Skill 生成的标准化输入做只读预演
npm run stock-review:stage -- --input /absolute/path/to/capture.json --dry-run

# 人工核对后原子合并到日级目录
npm run stock-review:stage -- --input /absolute/path/to/capture.json

阶段输入必须使用 captureVersion: 1，并显式标注 stage: asia | us。脚本只接受已经裁剪的日级公开字段，不联网，也不读取 MCP 原始缓存。

提交前检查

确认 reviewDate 不早于公开档案起点 2026-09-11，并与各市场 sessionDate 的关系合理。
确认市场、自选和策略记录均带来源、数据时间和明确状态。
确认 tdx-b1 的策略 ID、版本、参数摘要、输入时间、股票池与公开名次完整；provider 失败时整次策略运行必须失败关闭。
确认公开文件不含 MCP 配置、Token、服务地址、持仓、交易、完整公式或细粒度原始数据。
依次运行 Skill 自测（策略输入变化时）、npm run stock-review:validate、npm run check、npm run build、相关单元测试和四个股票页面的 Edge 视觉回归。

失败处理

单一市场失败只影响自己的来源状态，不应覆盖其他市场的成功数据。
美股补全失败时保留亚洲阶段结果，并明确显示尚未补齐。
上游数量骤降、字段口径变化、时间倒退或价格异常时，拒绝覆盖上次成功数据。
可以沿用上一份数据作为降级展示，但必须保留它自己的真实时间和来源。
采集成功、快照提交、Release 制品生成和 ECS 上线是不同状态，不能互相代替。

普通提交不会自动发布生产。新增或改变策略公式、参数、股票池、复权方式和资格规则时，先登记新版本，再生成后续记录；不能用新规则重写旧日结果。