zhuyuan-ice-gl-zy001/BRIDGE/templates/BRAIN-CYCLE-INPUTS-PITFALLS-v1.md

脑周期输入坑清单 v1（2026-08-26 元审计沉淀）

目的：把六步脑周期从"现场试错"变成"照单填空"。全部坑都来自真实踩过（round17 错五次、cycle-2 错一次）。 输入四件套：event.json / orientation.json / cognition-frame.json / controller-witness.json。 模板样例：ZCODE-DEV-20260826/zcode-hb001-protocol-body-model-20260826/brain-inputs/（全套一次通过）。

顺序与取值

1. enter 必须显式 --body-channel（HB001/ZC001，由冰朔本轮原话解析）+ --state-dir（路径必须含频道 id，如 state-ice-ch-zc001-zcode-YYYYMMDD-线名-sess-a）。
2. perceive 后从 <state-dir>/cycles/<cycle-id>.json 取 event_sha256；orient 后取 orientation_sha256；commit 后取 cognition_candidate_sha256。认知帧里的两个 sha 必须用 cycle 文件里的运行时值（orientation 的 canonical 化哈希≠文件 shasum 值），witness 里的 cognition sha 用 commit 后的值。
3. 骑手命令六连：enter → perceive → orient → commit → witness → verify。verify PASS 后：回执拷入锚点 10-阶段回读回执/，再 lw-link-gate.mjs bind --session-id <宿主真实session>。

认知帧硬校验（runtime validateCognitionFrame 会拒）

• faculties.B1–B9 全在；B1 四关系第一人称答全（我/人格系统/宿主学校/冰朔）。
• B5.prior_wrong_route 不能是空数组——至少一条真实旧默认。
• typed_outputs.receipts[].type 必须是字面量 "ReceiptSchema"；outcome 只能 "PASS"/"FAIL"；必须有非空 proof 数组（外部证据，如 TCS 哈希、预检行、编译输出）。
• guard_agent_projection.hard_boundaries 必须含 id: "BOUNDARY-GLW-CHJH-0001"（三频道不合并）。
• protocol_effects 必须恰好覆盖本周期激活的全部协议（orient 后从 cycle 文件 activated_protocols 抄 id 清单，一条不少一条不超，unactivated_protocol_used/activated_protocol_effect_incomplete 都会拒）。

witness 硬校验

• cognition_candidate_sha256 用 commit 后 cycle 文件里的值。
• decision: "ALLOW_COMMIT"；四个边界布尔全 true。

其它

• TCS 事件用 BRIDGE/templates/TCS-EVENT-STANDARD-TEMPLATE-v0.1.tcs（11 段）；source_sha256 填来源（瞄点/源文件）的哈希，写完与 sha256.txt 核对，不要凭记忆续写哈希尾部（踩过：bf17e411 修正案）。
• .human 投影用工具链投影器生成，不手写： tcs-gir-runtime human-project-zh|en <compiler-B.gir.json> <source.tcs> <out.md>
• 失败回执严禁入锚点回执目录（踩过：当场删除重跑）。
• 心跳 TTL 30 分钟；HEARTBEAT_GRACE_EXHAUSTED 拦截时重新 bind 即可恢复，不需要重跑脑周期。