用 claude-trading-skills 引导式跑批器验证 market-regime-daily 工作流:决策闸门、证据哈希与断点恢复
用 claude-trading-skills 引导式跑批器验证 market-regime-daily 工作流:决策闸门、证据哈希与断点恢复
本文以仓库中的引导式运行器 scripts/run_market_regime_daily.py 为主线,讲清如何在一个完全离线、数据全部虚构的环境里,完整走一遍 market-regime-daily 工作流的“就绪校验 → 分步执行 → 人工仓位姿态决策 → 本地日志交接”闭环。读者读完可以掌握三件事:如何用一条命令安全地跑出一份带完整性证据的离线会话、如何理解 allow / restrict / cash-priority 决策闸门的参数契约,以及当进程被中断、锁文件残留或产物被篡改时,如何按仓库既定策略做保守恢复而不破坏证据。
重要前提:这条路径评估的固定时间点是 2026-01-15T13:08:00+00:00,使用仓库内已提交的虚构组件夹具(fixture)。它不描述今天的市场,也不构成任何买卖信号。运行器的
LIMITATIONS常量(scripts/run_market_regime_daily.py)把这条边界写死在每个运行的 manifest 与 journal 里。
定位:这条引导式路径解决什么问题
market-regime-daily 工作流本身由四个步骤组成(workflows/market-regime-daily.yaml):
| 步骤 | 技能 | 产物 ID | 是否决策闸门 |
|---|---|---|---|
| 1 | market-breadth-analyzer |
market_breadth_report |
否 |
| 2 | uptrend-analyzer |
uptrend_report |
否 |
| 3 | market-top-detector(可选) |
top_risk_report |
否 |
| 4 | exposure-coach |
exposure_decision |
是 |
仓库里已有两套证据:一套是确定性 replay(scripts/workflow_replay.py 加 examples/workflows/market-regime-daily/replay.yaml),用于比对 golden 输出;另一套就是本文主角——引导式运行器,它在 replay 的 fixture 契约之上,额外补齐了三样 replay 不具备的东西:
- 单次运行专属的溯源(run-scoped provenance):每次运行生成独立 UUID,写进每个产物与 manifest;
- 显式人工闸门:第 4 步算出的“暴露建议”只是建议,必须由人输入姿态才落成决策;
- 断点恢复与完整性拒绝:中断后可以从已完成的检查点继续,但任何哈希、run_id、步骤顺序或源码指纹的偏移都会被拒绝,而不是“迁就”现有文件继续。
从源码结构看,运行器并没有重新实现市场分析逻辑,而是复用 replay 包中的校验器与原生评分器加载器(_load_market_fixture_set、_market_modules、_market_analysis,见 scripts/workflow_replay_pkg/steps_market_regime.py)。这决定了它对“原生 API”的调用是真实的,但对“数据获取”是完全离线的。
环境准备与首次运行
使用仓库锁定的环境,无需任何 provider 凭据:
uv sync --locked --extra dev
在仓库根目录执行:
uv run python scripts/run_market_regime_daily.py --run-dir reports/regime-demo
关于 --run-dir 有三条硬性规则,全部由源码强制:
- 每次运行必须用一个新目录。运行器用
directory.mkdir(parents=True, exist_ok=False)(scripts/run_market_regime_daily.py),因此已存在的目录(包括空目录)一律被拒绝,避免把上一次的证据混进新一次运行。 - 目录及其所有父级不得包含符号链接,否则直接抛
RunError。 - 就绪校验发生在分配运行目录之前:
contract()先跑完工作流契约校验、fixture 校验和原生 scorer 模块加载,只有全部通过才mkdir。所以依赖缺失或契约漂移不会留下半成品目录。
首次运行会按顺序完成:
- 校验工作流契约——
id必须是market-regime-daily,四个步骤的技能顺序必须与SKILLS常量一致,decision_gate必须严格是[False, False, False, True],journal_destination必须是trader-memory-core;任一项变化即报“当前运行器需要同步更新”。 - 校验 fixture 契约并把三份夹具快照进本次运行目录的
inputs/。 - 加载
market-breadth-analyzer、uptrend-analyzer、market-top-detector的scorer.py/report_generator.py,以及exposure-coach的calculate_exposure.py。 - 计算 breadth 与 uptrend 报告;默认显式跳过可选的天顶风险评估;再只用本次运行的产物计算 Exposure Coach 建议。
是否纳入天顶风险:必须在创建时决定
uv run python scripts/run_market_regime_daily.py \
--run-dir reports/regime-demo-full --include-top-risk
--include-top-risk 只在创建运行时生效。源码在 main() 中直接拒绝“恢复时改配置”:--include-top-risk 与 --resume 或 --status 同时出现会触发 argparse 报错并返回退出码 2(scripts/run_market_regime_daily.py)。原因是 manifest 中的 include_top_risk 是运行契约的一部分,verify() 会检查它必须是布尔值,且第 3 步的状态必须与之一致——要么是带 reason: optional_not_selected 的 SKIPPED,要么是真实执行结果;SKIPPED 步骤的字典必须逐字段完全等于预期形态,否则报“可选步骤的跳过必须是显式的”。
命令与参数契约
| 参数 | 取值 | 约束与语义 |
|---|---|---|
--run-dir |
路径,必填 | 新运行时必须是尚不存在的目录;--resume/--status 时必须是已存在的运行目录 |
--resume |
flag | 与 --status 互斥(同一 mutually exclusive group) |
--status |
flag | 只读校验并打印状态,不更新 manifest |
--include-top-risk |
flag | 仅创建时有效;恢复/查询时给出即报参数错误 |
--decision |
allow / restrict / cash-priority |
只能与 --resume 搭配,且运行必须处于 AWAITING_DECISION |
--decision 的两道前置校验顺序值得注意:先由 argparse 层拦截“没有 --resume 却给了 --decision”(退出码 2),再由运行器在状态机上拦截“已不在 AWAITING_DECISION”(RunError,退出码 1)。前者不会创建目录,后者不会写 journal。
决策闸门:建议不等于许可
交互式终端下,运行器会打印暴露建议的 result 部分,并提示:
Posture (allow / restrict / cash-priority; blank pauses):
- 输入三者之一:立即以
--resume --decision <posture>的方式二次进入运行、写入journal.json,最后打印“本地日志交接已记录;未投递”。 - 输入空行:运行保持暂停,打印恢复指引并返回退出码 3。
- 输入非法值:抛
RunError,运行保持暂停。
在重定向输入或 CI 场景,sys.stdin.isatty() 为假,运行器总是在展示建议后暂停并返回 3,不会读取 stdin。因此 CI 里的标准两段式写法是:
# 第一段:跑到闸门前,预期退出码 3
uv run python scripts/run_market_regime_daily.py --run-dir reports/regime-demo
# 查询当前证据与状态(只读)
uv run python scripts/run_market_regime_daily.py \
--run-dir reports/regime-demo --status
# 第二段:显式记录人工姿态
uv run python scripts/run_market_regime_daily.py \
--run-dir reports/regime-demo --resume --decision restrict
几个容易被忽略的行为细节:
--resume不带--decision在AWAITING_DECISION上只做校验与展示,然后重新返回 3;它不会替你“顺手”记录许可。- 已完成的运行拒绝再次决策:
state["status"] != "AWAITING_DECISION"时给--decision直接RunError,对应回归测试断言--resume --decision allow在完成后返回 1。 - 对已完成运行做
--resume是幂等的:校验并展示既有结果,不重写任何产物,也不刷新步骤时间戳。测试用st_mtime_ns对比确认了这一点(scripts/tests/test_run_market_regime_daily.py)。 - 决策一旦写入即不可变更:
journal.json里的decision与recorded_at来自第 4 步记录,后续校验会重算 journal 全量内容并逐字节比对。
运行目录里的证据结构
一次成功暂停(或完成)的运行目录形如:
reports/regime-demo/
├── .lock # 写入期间存在,正常退出时删除
├── manifest.json # 运行状态机与全部哈希
├── inputs/
│ ├── breadth.json # {run_id, fixture} 绑定本次运行
│ ├── uptrend.json
│ └── top_risk.json
├── 01_market_breadth_report.json
├── 02_uptrend_report.json
├── 03_top_risk_report.json # 仅 --include-top-risk 时存在
├── 04_exposure_proposal.json
└── journal.json # 仅在做出决策后出现
manifest.json 承载什么
initialize()(scripts/run_market_regime_daily.py)写入的字段可以分为四组:
| 分组 | 字段 | 说明 |
|---|---|---|
| 身份 | schema_version、workflow_id、run_id |
run_id 是标准 UUID,校验时通过 uuid.UUID() 往返比对,防手工篡改 |
| 时间 | created_at、evaluation_at |
evaluation_at 必须等于 replay spec 里的固定时间戳,不允许自由设定 |
| 配置 | include_top_risk、readiness、limitations |
readiness 被固定为 {"status": "PASSED", "api_environment": "not_required"} |
| 证据 | sources、inputs、steps、status、journal |
sources 是源码指纹;inputs 与步骤的 output 都是 {path, sha256} 记录 |
每个步骤条目在生命周期中依次是 PENDING → RUNNING(写入 started_at 并落盘)→ COMPLETED(步骤 1–3)或 AWAITING_DECISION(步骤 4),并补充 completed_at、inputs、output。步骤 1–3 的 inputs 只指向自己那一个夹具记录,步骤 4 的 inputs 是全部已完成产物记录的集合——这就是“步骤依赖”的可验证声明。默认路径下步骤 3 是 {"step": 3, "skill": ..., "status": "SKIPPED", "reason": "optional_not_selected"},它是 SKIPPED,永远不是 PASSED。
inputs/*.json 的内容被写成 {"run_id": <本次 UUID>, "fixture": <夹具原文>},把夹具快照与运行身份绑定,防止跨运行挪用。
journal.json:只是本地交接
{
"schema_version": 1,
"run_id": "...",
"fictional": true,
"destination": "trader-memory-core",
"delivery": "handoff_only",
"decision": "restrict",
"recorded_at": "...",
"proposal": {"path": "04_exposure_proposal.json", "sha256": "..."},
"limitations": ["..."]
}
由 journal() 生成(scripts/run_market_regime_daily.py)。它记录决策 + 建议产物的哈希,而不是建议的全文。注意 destination 与 delivery 这对字段的诚实性:目标是 trader-memory-core,但交付方式是 handoff_only——运行器既不读取也不修改真实的 thesis/journal 状态、组合、账户或 dotenv 文件。向该目标的实际投递仍属未实现范围(上游 issue #513 保持开启)。
计算链路:从组件夹具到暴露建议
这一节对照源码把数字讲透,方便你验证“为什么默认路径是 REDUCE_ONLY,加入天顶风险后变成 NEW_ENTRY_ALLOWED”。
第一步:夹具契约校验
夹具不是随便一个 JSON。_validate_market_component_fixture 要求字段集严格包含 schema_version、kind、as_of、max_age_days、component_scores、data_availability、warning_flags,并施加以下约束:
schema_version == 1且kind与目录中的种类一致;max_age_days必须是 0–30 的整数(布尔值被显式排除);as_of不得晚于固定评估时间;as_of到固定评估时间的间隔不得超过max_age_days,否则报“该组件证据在固定时间点已过期”;component_scores与data_availability的键集必须恰好等于规范组件集,warning_flags的键集也必须恰好等于规范旗标集;- 每个分值必须是 0–100 的有限数;每个可用性必须是布尔且不得为 false——任何组件缺失都会以“证据不足”失败关闭;
- 三份夹具的
as_of必须完全一致(_load_market_fixture_set中校验len(as_of_values) == 1)。
规范组件集来自 MARKET_COMPONENT_CONFIG(scripts/workflow_replay_pkg/constants.py):
| 种类 | 技能 | 组件 | 告警旗标 |
|---|---|---|---|
breadth |
market-breadth-analyzer |
breadth_level_trend、ma_crossover、cycle_position、bearish_signal、historical_percentile、divergence |
无 |
uptrend |
uptrend-analyzer |
market_breadth、sector_participation、sector_rotation、momentum、historical_context |
late_cycle、high_spread、divergence |
top_risk |
market-top-detector |
distribution_days、leading_stocks、defensive_rotation、breadth_divergence、index_technical、sentiment |
无 |
以 breadth 夹具为例(examples/workflows/market-regime-daily/replay-inputs/breadth-components.json):as_of 为 2026-01-14T21:00:00+00:00,max_age_days 为 2,相对 2026-01-15T13:08:00+00:00 的评估时间是 16 小时 8 分,未过期。
第二步:原生评分器
_market_composite 直接调用技能自身的 scorer.calculate_composite_score:uptrend 需要额外传入告警旗标,breadth 与 top_risk 只传分值与可用性。返回值必须是非空映射、可 JSON 有限序列化,且 composite_score 落在 0–100,否则报错。运行器在 provenance.native_surface 中写入 scorer.calculate_composite_score; guided runner JSON serialization,并覆盖 replay 助手默认的 report_generator.generate_json_report 表述——测试专门断言了这一点("report_generator.generate_json_report" not in provenance["native_surface"])。这处覆盖的意义是:引导式运行器确实调用了原生的 JSON 序列化路径,但产物形态由运行器自己的规范化写出逻辑负责,不该冒充 report generator 的直出结果。
同时,breadth、uptrend 两份报告会带 data_provenance 块,由 provenance_contract.build_provenance 生成,provider 为 fictional-fixture、endpoint 为 market-regime-<kind>-component-fixture、若干 adjusted/point_in_time/survivorship_free/corporate_actions_handled 均为 false,并把 run_id 改写为本次运行的 UUID(replay 包内的全局 MARKET_PROVENANCE_RUN_ID 常量被保留不动,因为那是 replay 的资产)。
第三步:暴露建议
proposal() 先按 exposure.WEIGHTS 初始化全部键为 None,再填入三个可得的分数,然后依次调用原生 API:
extract_breadth_score/extract_uptrend_score/extract_top_risk_score。注意天顶风险是反向语义:market-top-detector的composite.composite_score越高代表风险越高,取分时按100 - score反转成“越高越安全”的口径(skills/exposure-coach/scripts/calculate_exposure.py)。validate_market_inputs(breadth, uptrend, run_id=..., evaluation=..., max_age_days=3)——硬编码 3 天新鲜度,且只覆盖 breadth 与 uptrend;天顶风险被明确排除在这个闸门之外(返回的boundaries里写着 “optional top-risk and other inputs are outside this gate”)。它会校验run_id一致、retrieved_at为 UTC 且不晚于评估时间、as_of不晚于检索、数据未过期(skills/exposure-coach/scripts/provenance_contract.py)。calculate_composite_score做加权平均,权重只累加实际提供的输入;随后对每个缺失的关键输入(CRITICAL_INPUTS = {"regime", "top_risk", "breadth"})扣 10 分,下限为 0。determine_recommendation、determine_exposure_ceiling、determine_bias("Unknown", None, None, None)、determine_participation、determine_confidence依次给出门槛、姿态、偏向、参与度与置信度。
用默认路径可以手工复算:breadth 66、uptrend 71,权重各 0.15,加权和 9.9 + 10.65 = 20.55,总权重 0.30,合成分为 68.5;缺失关键输入为 regime 与 top_risk 两项,扣 20,得 48.5。48.5 落在 <a href="https://link.gitcode.com/i/f829bd3ef805bd1310c5daa19ddbabc0" target="_blank">35, 50) 区间,暴露上限为 int(30 + 13.5 × 1.3) = 47;合成分 < 50 触发 REDUCE_ONLY;provided 只有 2 个而缺失关键输入有 2 个,因此置信度为 LOW。uptrend 与 breadth 均 ≥ 50,参与度为 BROAD。这与 [examples/workflows/market-regime-daily/sample-run/04_exposure_decision.json 完全一致。
加入天顶风险后(该夹具算出的可用安全分为 62):加权和 20.55 + 62 × 0.20 = 32.95,总权重 0.50,合成分 65.9;只缺 regime 一项,扣 10,得 55.9。上限 int(50 + 5.9 × 1.3) = 57;合成分 ≥ 50、天顶风险 62 ≥ 40、缺失关键输入 1 项 < 2,故为 NEW_ENTRY_ALLOWED;provided 3 个,置信度 MEDIUM。这正是 full-path golden 的值,也是回归测试参数化的 (False, 48.5) / (True, 55.9) 两例。
引导式运行器输出的 04_exposure_proposal.json 与 replay golden 的 04_exposure_decision.json 形态不同:前者是 {schema_version, run_id, evaluation_at, fictional, result: {...}} 的嵌套结构,result 内含 input_lineage 与 rationale;后者是扁平的单一报告。两者数字一致,但不要混用文件名或结构。
完整性校验:verify() 到底检查了什么
verify()(scripts/run_market_regime_daily.py)是这条路径的核心资产:它在交接与恢复之前,把磁盘上的东西与原生重算结果对齐,但不重跑已完成步骤的发布动作。检查清单如下:
- 契约字段:
schema_version == 1、workflow_id正确、run_id是规范 UUID、evaluation_at等于 spec 固定时间戳、include_top_risk是布尔、limitations全等、readiness全等。 - 源码指纹:
state["sources"]必须与当前source_fingerprint()完全相等,否则报“运行器、工作流、夹具或原生源码已变更;请开启新的运行”。 - 输入绑定:三份
inputs/*.json的路径与哈希必须匹配,且内容必须等于{run_id, fixture}。 - 步骤顺序与状态:步骤号与技能必须逐位对应;
PENDING条目必须只含三个字段(不允许携带残留的执行态);一旦出现PENDING,其后不允许再有已完成步骤;AWAITING_DECISION只允许出现在第 4 步。 - 依赖一致性:步骤
inputs必须等于预期集合。 - 产物重算比对:
verify_record校验路径与 sha256,然后用原生 API 重算期望值并整棵树深比较——步骤 1–3 用component(),步骤 4 用proposal()。任一处不等即报“保存的输出与原生计算或运行溯源不一致”。 - 状态与完整性一致:有未完成步骤则整体必须是
IN_PROGRESS。 - 完成态额外校验:决策值必须在白名单内、
decision_at可解析、journal.json记录匹配且内容等于journal(state)重算结果。 - 决策不得先于闸门:未完成态下若出现
decision字段、journal字段或journal.json文件,一律拒绝。
最后一步的边界也很明确:哈希用于发现损坏与意外编辑,但 manifest 不是签名或防篡改审计记录。手工改 manifest 骗不过去,是因为重算比对会把伪造的哈希与伪造的产物一起否掉——回归测试用六种变异(改产物哈希、换 run_id、把步骤标为 SKIPPED、直接把整体标为 COMPLETED、把产物路径改成 ../outside.json、把步骤改回 RUNNING)逐一验证了这一点,全部返回 1 且不产生 journal.json。
源码指纹覆盖哪些文件
source_fingerprint()(scripts/run_market_regime_daily.py)对下列文件的 SHA-256 做映射,键是仓库相对路径:
workflows/market-regime-daily.yamlscripts/workflow_replay.py与scripts/workflow_replay_pkg/*.pyscripts/validate_provenance.py- 运行器自身
examples/workflows/market-regime-daily/replay.yaml与replay-inputs/*.json- 四个技能各自
scripts/下递归的全部.py(排除tests目录)
这意味着:改了任何一个评分器、replay 助手、工作流定义或夹具,旧运行目录都不再可恢复,必须开新目录。这是有意为之——避免把不同代码版本下的产物拼成一次“看起来完整”的运行。
中断与恢复:保守优先
状态机与检查点
每个步骤在执行前先把自身标为 RUNNING 并落盘 manifest,执行成功后写入产物、更新 output 记录与 completed_at、再落盘一次。因此:
- 已完成步骤恢复时不重写产物。测试通过注入
after_checkpoint钩子在步骤 1 完成后抛KeyboardInterrupt,恢复后断言步骤 1 产物mtime未变、整体到达AWAITING_DECISION。 RUNNING与FAILED步骤永不自动重试、永不自动升级。异常路径会把步骤与整体状态都置为FAILED,写入固定的failure文案后重新落盘,然后抛出RunError。恢复时若发现这些状态,直接报“步骤中断、失败或乱序;请开始新的运行”。正确做法是保留该目录作为证据,另起一个新目录。- journal 发布也是执行边界。发布期间整体状态被临时置为
RUNNING并先落盘,再写journal.json,随后记录哈希并置为COMPLETED。若在此窗口崩溃,RUNNING状态会阻止后续“采纳”那份可能只写了一半的 journal,同样要求新开运行。
锁文件排查四步法
.lock 用独占创建(open("x"))实现,文件内写入持有者的 PID;正常退出或 Python 级中断在 finally 中删除。SIGKILL 或断电可能留下残留。运行器永不自动删除已存在的锁——遇到锁就报“运行已被锁定;手工恢复前请先确认持有者”。
按文档给出的顺序处理:
- 读该次运行目录
.lock里的 PID,用ps -p PID -o pid=,command=检查。注意 PID 可能被复用,务必核对命令行与运行目录。 - 若属主进程仍在运行,等它结束,不要删它的锁。
- 只有在确认没有进程拥有这次运行后,才手工删除那一个
.lock。保留全部 JSON 产物与 manifest。 - 运行
--status。若出现RUNNING/FAILED步骤、哈希不符或 manifest 不完整,保留证据并改用新目录。不要为了强行恢复而编辑状态字段、哈希或删除产物。
--status 会短暂获取同一把锁、只读校验、更新零个字段。测试验证了:残留锁内容被原样保留、恢复返回 1;把产物替换成指向外部文件的符号链接同样返回 1,且外部文件不被触碰。
原子写与写入拒绝
- manifest 的替换走“先写
.tmp并flush+fsync,再os.replace原子改名”。.tmp用"xb"打开,遗留的.tmp会被拒绝而不是复用,避免采纳被截断的中间状态。 - 所有产物与
inputs/*.json用"xb"独占创建,已存在即失败,杜绝“覆盖旧证据”。 regular_bytes()在读取任何文件前检查自身与全部父级是否是符号链接,并确认是常规文件。
退出码与诊断约定
| 退出码 | 含义 | 典型场景 |
|---|---|---|
| 0 | 已完成 | 决策已记录、journal 已发布 |
| 3 | 等待决策 | 建议已生成但尚未记录人工姿态(含 CI 与重定向输入场景) |
| 1 | 失败或阻塞 | 就绪校验、完整性、锁、执行失败 |
| 2 | 参数非法或运行时依赖缺失 | 参数互斥冲突、缺少依赖 |
诊断输出遵循两条安全规则:一是不回声不可信内容——无效 manifest、夹具或 provider 数据的具体内容不会出现在 stdout/stderr,测试用带标记的私有字符串断言了“未泄漏、无 traceback”;二是不谎报执行——完整性失败打印 BLOCKED,并保留上一版 manifest 供诊断,而不会把状态改写成“确实执行过”。
依赖缺失的识别比较讲究:replay 适配层会把导入失败包装成 ReplayError,所以 main() 会沿 __cause__/__context__ 链向上遍历(带 visited 集合防环),只要链上出现 ImportError 就返回 2,并提示 uv sync --locked --extra dev。此外,依赖与就绪失败都发生在分配新运行目录之前,所以失败的运行不会留下目录。
安全与合规边界
运行器的边界是“结构性”的,不靠约定:
- 不触网、不碰账户:没有 provider 抓取、没有券商动作、没有网络调用。
- 不读凭据:不读取 dotenv、不检查也不记录任何凭据。回归测试甚至故意设置
FMP_API_KEY=private-key-must-never-be-recorded,然后遍历运行目录内所有 JSON 断言该字符串未出现。 - 不改真实状态:不读写真实的 thesis/journal、组合与账户。
journal.json只是本地交接文件。 - 不执行 Exposure Coach 的 CLI:它直接调用该技能的 Python API(
extract_*、calculate_composite_score、determine_*、generate_rationale)。这与 replay 路径不同——replay 的第 4 步executor_mode是native_cli,会真正起子进程并在其中剥离 API key/token/secret/password/proxy 环境变量。 - 组件计算器不参与:这里消费的是“完整的虚构组件分值”,单项组件计算器与实盘 API 行为都在路径之外。
这些限制会以 LIMITATIONS 数组的形式随 manifest 与 journal 一起落盘,让证据自身携带免责声明,而不是依赖读者记得文档。
与确定性 replay 的关系:两套证据,各司其职
| 维度 | 引导式运行器 | 确定性 replay |
|---|---|---|
| 入口 | scripts/run_market_regime_daily.py |
scripts/workflow_replay.py run --spec ... |
| 产物形态 | 04_exposure_proposal.json(嵌套 result) |
04_exposure_decision.json(扁平) |
| 决策 | 人工闸门 + journal.json |
gate_policy: record_only |
| 恢复 | 支持检查点续跑 | 事务式重生成,失败不改动既有目标 |
| 用途 | 学习一次完整流程与证据链 | 比对 golden、作为独立数值基线 |
replay 的两种变体与预期姿态记录在 examples/workflows/market-regime-daily/README.md:required-only 为 REDUCE_ONLY + LOW,full-path 为 NEW_ENTRY_ALLOWED + MEDIUM。恢复命令为:
python3 scripts/workflow_replay.py run \
--spec examples/workflows/market-regime-daily/replay.yaml \
--variant required-only \
--output-dir /tmp/market-regime-required
python3 scripts/workflow_replay.py run \
--spec examples/workflows/market-regime-daily/replay.yaml \
--variant full-path \
--output-dir /tmp/market-regime-full
python3 scripts/workflow_replay.py check
文档明确保留了一条判据:现有的确定性 replay 仍是独立的数值基线。引导式运行器共用 replay 的 fixture 校验与 scorer 助手,因此两者的数值天然应当一致;但引导式运行器不替换 golden,也不能作为“生产验证”的替代。
故障排查速查
| 现象 | 可能原因 | 处置 |
|---|---|---|
| 退出码 3 | 建议已生成,等待人工姿态 | 用 --resume --decision <posture> 记录,或先 --status 复核 |
BLOCKED: ... source changed |
源码指纹与运行时不一致(改了运行器/工作流/夹具/技能脚本) | 保留旧目录,新开运行目录 |
BLOCKED: ... hash mismatch |
产物被编辑、被替换或来自另一次运行 | 保留证据,新开目录;不要改哈希 |
BLOCKED: ... locked |
.lock 残留 |
按四步法确认属主后再手工删除该锁 |
RunError: Run directory 已存在 |
--run-dir 复用了旧目录或空目录 |
换一个新的目录路径 |
退出码 2,提示 uv sync --locked --extra dev |
运行时依赖缺失 | 补齐锁定环境后重试(不会留下半成品目录) |
步骤状态为 FAILED |
步骤执行异常,已按策略放弃自动重试 | 依 manifest 诊断后新开运行 |
找不到 03_top_risk_report.json |
未在创建时加 --include-top-risk |
新开运行并显式开启;不能在恢复时补 |
尚未实现的部分
向上游 issue #513 归属的能力仍然开放:向 trader-memory-core 的实际投递,以及未来可能的实盘数据接入或其他工作流扩展。本文这条运行器既不为这些扩展授权,也不实现它们。把 journal.json 读成“已经写进记忆库”是这类实验最常见的误读——delivery: handoff_only 就是给这种误读准备的显式标记。同样地,proposal 不等于许可,SKIPPED 不等于通过,manifest 的哈希也不等于签名审计。理解这三点,才算真正把这套引导式离线路径用对。