game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,729 Commits 23 Branches 0 Tags
8a2f80fe7cc6a587d08175347f080d4428eced75
Commit Graph
203 Commits
Author SHA1 Message Date
DKChan cd72943032 docs(迭代32收尾批): 批后收尾与中间文档退役——八件产出物退役＋账面换代，文档域闸全绿 
- reports/ 退役六件 iter32 产出物（实现报告/代拍板追认单/反哺点清单×2卡）＋两张需求卡片（判据全过：29 项反哺已写入、代拍板 14 条用户全追认、遗留读数义务已迁体验验证清单 ㉚/待办清单重锚条目）
- 待办清单整条删除四处：计数器寿命域未统一／代码注释禁用词清扫批（完成即删）／卡①卡②反哺专条（已写入即删）；重锚条目指针改结论内联＋git 提交号
- 提案死链改写（卡片指路句换 git 提交号 f2bb5871）；roadmap 迭代 32 行「已完成（2026-10-21）」＋卡片与报告列填退役保留字；当前位三行换代（下一动作=编排迭代 33）
〔迭代 32 收口登记：卡① 880ee91b／卡② d00f24a8／反哺写入 fc1e8027〕
 2026-10-21 04:19:06 +08:00
DKChan f2b2558098 docs(迭代32反哺写入批): 卡①卡②两份反哺点清单 29 项按 2026-10-21 用户裁决全部落文 
- 措辞换代：八件 design/ 文档「完美排雷」→「完美封印」（art-bible v3.17）；术语表「退役词对照」增行成 S11 词表权威来源
- 闸扩面：tools/doc_term_audit.py 词表加「完美排雷」＋扫描域扩 design/art（用户裁 2026-10-21）；变异验证＝注入见红 EXIT=1、还原回绿
- architecture.md v1.9：effect_engine/orchestrator 行与战斗域装配节改 ctx 形态、架构原则补第 8 条「系统无状态」、flag_missed→seal_missed 两处订正
- 提案 v1.3：§7.7/§7.10.3/§7.10.12 三处依卡片 §12 裁①②订正；sim-data/README 纪律③⑦批次例外登记
- 账面：待办清单增反哺专条×2／重锚批准条目／game/ 域欠账条目，无状态原则条「文档设计已闭合」；体验验证清单增 ㉚ 目检五项
- 代拍板两单 14 条用户全部追认（2026-10-21）；文档域闸 --docs 全绿（含 08c 流水线闸 70 条目零红）
 2026-10-21 03:51:28 +08:00
DKChan f100e19275 docs(gdd): 删除「关卡节点图生成」旧版文档（用户令 2026-10-21）——出度≤2/层宽≤4 旧规随档退场；引用面八处改指路文本（02 索引行/08 行/关卡节点地图/冒险结构/level-map/待办清单两处/Alpha梳理）；归档副本落主区 archive/，随关卡节点图重构批重写 2026-10-21 00:53:42 +08:00
DKChan 0b95a0c333 docs(代码注释禁用词清扫批·目录整改): 卡①从 design/research/ 移入 reports/（需求卡片唯一容器规约）——06 状态行与 roadmap 迭代 32 行卡片列两处路径同批改指，流水线闸两红（凭据缺失／已编迭代无可引卡路径）消解，现 PASS 2026-10-20 19:22:14 +08:00
DKChan 3002ae9a8c merge: master 同步（迭代 30/31 收尾批＋效果引擎无状态化卡片与 06 条目入盘）——roadmap 总表取 master 现况并保留迭代 32 行，06 三条目并存 2026-10-20 19:03:03 +08:00
DKChan d42c8f1a7e merge: master 同步（迭代 30/31 收尾批）——06 末尾两条目并存，冲突逐条保留 2026-10-20 18:57:42 +08:00
DKChan df4518d878 chore(批后收尾): 迭代 31 产出物与两卡退役——吸收即死删除，06/roadmap 账面换代 
- 反哺点 14 条已于 7682559 落文（术语表 seal_* 契约键与效果词条、奇物完美保险指向、07 ㉙ 七项目检、美术件名与守卫例外条款、06 新候选）
- 代拍板追认：13 项全部追认（卡① 1-6、卡② 7-13）；待裁 A=甲——玩家面残留禁字另开小批、已登记 06；B=乙——perfect_broken 判据句改文档措辞、代码零动
- 实现报告 §六-1 未闭项迁 06「计数器寿命域未统一」：domain=battle/adv​enture 寿命判据无法由单测 rig 变异证红，闭合时补 runner/MC 对照读数或确认不设机检
- 06 删除两条已完成条目（代码术语刷新批、凭证件裁削批·代码侧）
- roadmap 迭代 31 行改「已完成（2026-10-19）」、两列改已退役保留字；当前位换代至迭代 1–31 全完成
- 代码术语审计报告的卡片指路句改指合回 commit 4f953ce8/3e076e22（卡片退役后不留死径）
 2026-10-20 15:28:38 +08:00
DKChan f2bb587170 docs(效果引擎无状态化·写卡): 需求卡片成文（reports/需求卡片-效果引擎无状态化批-2026-10-20.md，零待裁点开工门=U0）——T0–T8 九卡带签名/断言/落点、验收 V1–V14 三问逐条可答、变异验证五条、V12 具名锚＋锚新鲜度核对步；06 条目推进「已写卡（本卡路径）」；提案 §10.1 补行号再漂移注记（c5200b6b 注释清偿后以卡片开工前实查为准）；卡片经独立会话对抗复核五项回炉全落（行号群订正/V9 assert 侧闭环/判定函数名落定/估时对齐/裸引擎段实数 53 处）——--docs 闸全绿 2026-10-20 07:19:29 +08:00
DKChan f513463d27 docs(效果引擎无状态化·设计闭合): 提案 v1.2 状态改「可写卡」——§4.3 六卡点/§4.4 八缺口/§4.5 六澄清全闭合，定值集中 §7.10（ctx=EffectContext 引用束每战一次／写口改静态纯函数 bucket_of 单点／前缀校验双落点＋E2 并入 F1 带引号旧 id 零命中／U2 随导出消失而消解／round_start 定位 :97／G1 分组判读 pain_layers 零位移／B6 dig_combo 死路删除）；06 计数器条目改写推进待写卡＋新增无状态原则缺条目登记（--docs 闸全绿） 2026-10-20 06:46:12 +08:00
DKChan 8a68c9ea11 merge: 同步 master e92a18e1（卡片落位 reports/＋dev→engineering 改名批）——四处版本历史节冲突取本批删除侧，reports 卡片重放禁写变更记录清理，06b 闸扫描面扩 reports/ 2026-10-20 05:46:28 +08:00
DKChan d6356d8dbe merge: 同步 master d5f95e7f（art/ 边界批）——三处冲突＝对方 art 改名/迁移 vs 我方路径重基准，取对方内容改动＋按新落位换算路径（comfyui-prompts→art-prompts、美术审计件迁 research/） 2026-10-20 05:30:37 +08:00
DKChan 0616af94fb docs(卡片): 需求卡片落位迁至 reports/——路径依赖、规则说明、流水线闸、工作流技能全量同步 
用户裁：需求卡片属过程件，不留在 design/；统一落 reports/（不新设目录，卡片靠「需求卡片-」文件名前缀与报告区分）。

搬移：
- 10 张在役卡片 design/research/ → reports/（git mv，历史保留）
- 卡内相对链接全部重基准：../gdd→../design/gdd、../art→../design/art、../../→../、
  同目录 research 引用→../design/research/（营地澄清、playnote、资源配比提案）；
  链接解析校验 BROKEN=0

路径依赖（全库 48 处）：
- 06 待办清单 10 条卡片路径、roadmap 迭代 31 行 2 条、reports/iter31 报告与反哺点各 1 条
- 代码术语审计报告 2 处、会话提示 1 处、资源配比提案 1 处

规则说明：
- AGENTS.md Project Layout：design/research 行注明「需求卡片不在此」；reports 行扩为「过程件容器」
- doc-conventions §11 暂存地表拆为两处；§12.1 状态机示例改 reports/
- reports/README.md：定位由「迭代批产出物」扩为「过程件容器」并新增需求卡片行

流水线闸：
- pipeline_gate.py CARD_DIR / RESEARCH_RE / 报错文案三处改 reports/（闸 PASS，卡片口径 10 张全过）

工作流技能（.zcode/skills，不入 git）：
- req-card :8 落位 / :27 三份已退役范本改指现行卡片 / :92 06 回写口径
- iter :19、iter-plan :28/:66、batch-closure :3/:63/:65
- 用户级副本 C:/Users/DK/.workbuddy/skills/req-card/SKILL.md 同步三处（技能列表启动时加载，需重开会话生效）

未动：design/art、design/qa、提案、playnote、道具退役素材库、会话交接件（归其它会话）。
闸：run_all_gates.sh --docs 验收通过。
 2026-10-20 05:28:42 +08:00
DKChan 2b5f1d1a54 docs(art目录边界): art/ 判据定为载体性质——审计报告与调研归 research/，提示词库改名 art-prompts，规约补正文单点维护 
art/ 三份审计产物处置：cursor 会话存档与 canvas 转 HTML 两份迁 design/research/（各自头部写明接收方），
2026-10-06 美术资产链路审计报告 HTML 从未入版本库、移入 gitignored archive/ 后从 art/ 清除；
06 与 08 两处裁决录链接、两张需求卡片的四路指针随迁移改指 research/。
comfyui-prompts.md 改名 art-prompts.md（名字指本地 ComfyUI 与实际渠道不符），五处现行指针与链接标签跟随，
版本历史留痕行按文档纪律不改写。
doc-conventions 第 5 节加「正文单点维护」一行（一条规则句只写在 owner 文档，执行侧必须带字面值时豁免但须注明冲突以 owner 为准），
第 11 节「六目录」改「各子目录」；据此把生图操作单里复述封印黑与旗朱色值及沿革的那条注记改成指向 character-design §5.4 的指针。
repo_structure_audit.py 加第六查 design/art/ 内容白名单（只许 .md 与 references/），文首查数与通过行随改；
AGENTS.md Project Layout 的 art/ 与 research/ 两行按新判据改写。
06 新增待裁决一条：candidates 目录在熵增闸退役名单与 asset-path-map 现行目录表里得到相反答案，两份操作单又指它。
变异验证：art/ 放 .html 与放子目录两况均 FAIL，清场后 PASS。
 2026-10-20 05:15:02 +08:00
DKChan a082f8a4fd docs(card): 需求卡片 v1.3——二轮开工前自查，五处批末验收雷全部拆掉 
回应用户「是否还有需裁断项」的全量审计（五词原始命中 119 行逐处实测）：

1. S11 词表若收「退役词对照」首列全词 → 巢穴 20 处（玩家专名「巢穴
   预告」＋风味层）与旗 6 处（闸门自指 5＋更名记载 1）批末必红 →
   立显式排除单（巢穴／旗，理由：术语表风味层除外注＋B3 专名豁免＋
   doc_term_audit 既有判例「旗单字不入表」）。
2. enemy.tres:653 落籍留档不被旧 25 子串信号过滤豁免 → 批末 S11＋A6
   必红；且该过滤实测误伤 14/17 处活注释（→／历史／登记／豁免等子串
   误判）→ 废信号过滤，改显式留档豁免单 4 处＋显式待清清单。
3. 误伤的 14 处活注释补入清单：N1 16→21、N2 26→33（hud_presenter／
   ui_input_probe 两文件整文件旧漏）、N3 38→39、N4 12→14；T2/T3/T4/T5
   任务清单与 §4 计数同步（复算对拍：待清 21+33+36+13+9=112）。
4. T7 行序调换＋hl 两态化会漂移 parity JSONL（_on_step_row 逐行落盘
   含 highlight，11 号闸 sha256 逐位比对）→ 立契约 12：本批不发起
   parity（NEED-APPROVAL 态 all_green 不受影响）、漂移记档、合回后另立
   用户批准的重锚批；N7 验收走 A10/A11/A12 正向断言（纪律①主力）。
5. A2 补 board_fx_view.gd:102 静态覆盖（S11 只扫注释面，字符串字面量
   归断言面）；S11 扫描面补 .sh；规则说明立禁令引举句式（否则闸本体
   头注被自己判红）。

另订正：§10/§8 旧修法措辞（上移豁免→后移 _emit_row）、契约编号去重
（原两个 9）、N1 表内计数、06 条目同步（含修其自指引爆的 doc_term
红——bash tools/run_all_gates.sh --docs 复跑全绿）。
 2026-10-20 04:08:52 +08:00
DKChan fe47f48e0c merge: 同步 master e8a29342（qa目录退役批）——四张卡冲突按「卡已退役」取删除，master 侧改动仅为 design/qa/ 路径内联，信息零损失 2026-10-20 03:51:25 +08:00
DKChan 55cdf683da docs(卡片): 退役 11 张失归属需求卡片（迭代 20–30 已完成批）＋清偿全部指路与死链 
按 doc-conventions §11「吸收即死」「删除不留死链」执行：
- 删 11 张：迭代 20–30 各批卡片（含迭代 28 启动装配卡——roadmap 卡片列早已写「已退役」、文件却仍在盘，属漏删）
- roadmap 卡片列 10 行改「已退役（git 历史可考）」（流水线闸对保留字豁免，pipeline_gate.py:303-309）
- reports/iter27–30 四份报告头部卡片路径改保留字，不留指向已删文件的路径
- 保留卡（战斗一屏样张批／二三关棋盘观感批）对已删卡的 6 处指路改结论内联＋提交号
  （徽章卡 7ffd1dc0／测试分层卡 fff4f120），各加一行「指路订正（2026-10-20）」
- 顺带清偿 2 处既存死链：07-体验验证清单 ㉑ 节、HUD框架 视野迷雾注记（两卡早已退役，历史删卡未做引用面清理）
- 顺带清偿 3 处 game//tools/ 下遗漏引用：theme/README、forge.tres T1 注、parity_anchor.py 头注

保留 10 张未开工卡（迭代 31 两张、06 在册营地五卡＋资源配比、被剔除回待设计的样张/观感两张）。
零设计裁决变更、零数值变更。
 2026-10-20 03:37:31 +08:00
DKChan 869d00d678 docs(card): 需求卡片 v1.2——开工前自查，钉死四处会卡住施工方的口径 
逐条自查「施工方会不会回头问」，查出并定死四处（另有两处笔误订正）：

**1. S11 词表范围与 §4「不做」自相矛盾（最严重）**
原 T1 写「词表＝退役词对照 ＋ 用语规范 A 表禁用列全部」，但 §4 已把 A 表词
（不得 14／报错 18／对标 1／若干 1／buff 22）列为「不做、待用户另裁」。
⇒ 原写法会让 S11 一落闸就红 56 处，批末闸必然红、无法合回。
定死：词表＝退役词对照节第一列 ＋ 显式追加「完美排雷」完整短语；
明确不收 A 表词、不收单字「雷」。A 表将来裁入时另行扩表并单独立批。

**2. 单字「雷」会误伤 26 处保留词**
「排雷玩法／排雷规则」是内部机制名（§10 明定不扩大禁词面），
按单字「雷」扫会全部误判。定死：只收「完美排雷」完整短语。

**3. N7 修法不可行——_fx_emit 有状态，重复调用重复消费限次**
_fx_emit = _fx.dispatch（battle_orchestrator.gd:90-93），forgive_seal_miss 行
走 when lt 1 限次并由 _apply_counter_hit 记账 ⇒ 「先跑一次算 hl 再跑原循环」
会消费两次限次、归因行发两次。
定死：改为把 _emit_row("seal_miss")（:302）**后移**到 _fx_emit 循环（:308-317）之后，
循环跑完 _perfect_forgiven 已就位再判 hl。已实测
grep "insurance_used|perfect_insurance" game/smoke/smoke_all.gd 零命中
⇒ 行序调换不涉冒烟断言。

**4. A10／A11 断言落点不可执行**
原写「断言日志出现/不出现字样」，但日志文本由呈现层 battle_log_view._format_row
生成，core 层单测拿不到。定死：断言 seal_miss 行的 highlight 字段值
（未装备 == "perfect_broken"／装备 == ""），落点 tests/unit/core/；
另加 A12 断言两态文案与呈现分支一致且不含「雷」。

**另订正两处**：§4「做」列表重复第 6 项（完美排雷出现两次）；
T4 步骤 adventure_runner.gd 漏列 :771（写 11 处只列 10 个行号）。

**同步新增**：契约 9 S11 闸门自指豁免（smoke_all.gd:1319 的禁字面检查行与
ui_font_asset_test.gd:18-19 字形夹具不含对照性信号，会被自指判红）；
变异验证增「去掉自指豁免」一条；代拍板/范围边界措辞同步。
处数对账复核：T3=26／T4=35／T5=11／T6=9，与 §2 清单一致。

流水线闸 PASS：06 条目 64 · 总表数据行 32 · 交叉核 3 链 · 卡片口径 22 张全过。
 2026-10-20 03:32:59 +08:00
DKChan b8d24b465d merge: master 同步（active.md 残留清理批／根 README 纯指路牌批／batch-closure 指认批） 2026-10-20 02:34:04 +08:00
DKChan 75fafc3965 docs(qa目录退役): design/qa/ 清空删除，四路分流＋§11 立接收方条款 
- 40 张取证照与同名对比报告 → game/tests/evidence/ui-audit-2026-10-06/（该目录既有章程「人工测试证据」，目录根新增 .gdignore 令 Godot 整目录跳过导入，图不生成 .import 边车也不进导出包；parity/anchor.json 走文件系统路径读取不受影响）
- 有接收方的两份审计（代码术语审计→06:546＋迭代31 卡①／测试审计→测试分层卡片）平移 design/research/；iter27-探针迁移对照（T1 未施工＝活交付物）迁 reports/，reports/README 放什么表补一行交付物类型
- 已核销的迭代18-实机目检总清单（2026-10-14 十八项全过）删除，顺带清掉其内 4 条指向 8e02dcf0 已删件的回指
- doc-conventions §11：暂存地唯一归 design/research/，验证凭据不归文档目录；新增「落档必写接收方」一行——写不出接收方的不落文件，内容在会话里交付
- tools/balance_verifier.py 报告与原始数据改落 sim-data/（QA_DIR→READINGS_DIR）
- 活指针 13 处改判：AGENTS.md:22/30 与 Project Layout game 行、06:546、07:103、career 卡片×4、art-bible §8.2 L490 与 生涯.md:81 两处 8e02dcf0 遗留死指涉、game/tests/README 分级表与台账行、reports/README
- 结构闸白名单三处同批收口：IMAGE_PREFIXES 去 design/qa/ 加 game/tests/evidence/、DESIGN_SUBDIRS 去 qa、RETIRED 加 design/qa（目录复活即 FAIL）
- .qoder 技能 doc-consistency-check 两处指路改判（harness 配置不入 git，主区直接改）

单件试跑全绿：gdd_lint 10/10、doc_link --strict 死链 0、doc_term --strict 疑似现行 0、pipeline_gate 63 条目/21 卡、repo_structure_audit PASS。
本批 diff 触及 game/ 路径，合回需全量档回执（含代码域测试），待用户点名。
 2026-10-20 02:07:39 +08:00
DKChan 8575e1b16c docs(card): 需求卡片 v1.1——新增 N7 归因锚判据修正，T2 对外文案改概念驱动两态写法 
grilling 复核门查出概念冲突，按用户 2026-10-20 裁定（Q5=A）并入本批：

**新增 §0 概念定义节**：明确「完美封印」＝一张图的**清图奖励加倍条件**——
判据＝零有效误标 且 至少一次封印标中；有效误标＝误标总数 − 豁免数；
成立效果＝清图奖励追加第二份同身份兑付；被破之后＝只发一份不加倍。
出处：战斗结算.md:161 本体／:108 当量公式／:116 乘数字义／:321 调参表。

**新增 N7（真缺陷）**：`grant_segment.gd:300` 用 RAW 计数
`_perfect_hit_false == 1` 判「已破」，而 `battle_orchestrator.gd:1299`
`perfect_sweep_earned()` 用有效误标；豁免累加（:314）又排在 `_emit_row`
（:302）之后。⇒ 装备「完美保险」时日志打印「已破」，实际加倍照发，
日志断言了与真值相反的状态。修法：判据改 `_perfect_hit_false -
_perfect_forgiven == 1`，豁免累加上移到 `_emit_row` 之前。

**T2 措辞订正**：对外文案不再作机械换词，改为按 §0 概念的两态改写——
未豁免态 `（本图完美封印已破——清图奖励不再加倍）`；
已豁免态 `（首次封印落空已豁免——不计入完美封印判定）`
（后者与 feats.tres:861 desc 口径一致）。
原三候选（机械换词）作废。

**契约增两条**：语义先行禁纯词面替换；完美封印判据单点（只允许由
perfect_sweep_earned() 派生，两处不一致即缺陷）。

**验收清单增 A10／A11**（未豁免态应「已破」、豁免态应无「已破」），
变异验证增两条（N7 判据正／反）。

估时由 ≈6.5–7.5h 上调为 ≈8.5–10.0h，切分预案同步。
流水线闸 PASS：卡片口径 22 张全过。
 2026-10-20 02:04:42 +08:00
DKChan bf5c379b32 docs(card): 需求卡片 v1.0 修订——S11 扫描面改全域，N1 落点措辞订正 
按用户裁决（2026-10-20）落两处：
- T1 S11 扫描面：由「game/core＋game/presentation 下 .gd」改为「game/ 全域
  （.gd/.tres/.md/.json）」，与迭代 31 V4 判据口径对齐——退役词残留同样落在
  .tres 注释与 README.md，只扫 .gd 会漏。
- T2 第 4 步措辞订正：原「其余 13 处注释／文档正文」不准确，改为
  「11 处代码注释／文档注释 ＋ 4 处冒烟断言描述文本与夹具期望字面量」
  （smoke_all.gd:3512/3516/4076/6201 中 6201 是断言比对的期望字面量，非注释）。

另两条按推荐锁定：Q2＝门票标识符与数据键零改动；Q3＝S11 扫描面取全域。
 2026-10-20 01:30:29 +08:00
DKChan 3e3bc136f9 docs(card): 需求卡片·代码注释禁用词清扫批 v1.0 ＋ 06 条目推进「已写卡」 
卡片落 design/research/需求卡片-代码注释禁用词清扫批-2026-10-20.md，六需求点：
N1 完美排雷→完美封印（全库统一，含对外文案 3 处）／N2 板级→整图／
N3 门票→专长凭证（仅注释措辞）／N4 正主→现行事实源／N5 落籍→已入库／
N6 代码域静态扫描闸新增 S11「代码注释禁用词」规则。

上游依据＝2026-10-19 用户裁（完美排雷全库统一换代为完美封印，含代码内部注释），
据此推翻 需求卡片-凭证件裁削批:108「内部开发用语按 v3.15 纪律保留」半句，
该卡片条款订正归文档轨批。

契约八条：标识符零改动（feat_ticket_*／SHELF_KINDS／存档键）／游戏行为零变化
（唯一例外＝对外文案三处文本）／S11 先落规则后修码／S11 词表从术语表解析不内联／
S11 带扫描面零命中自检／禁碰并行会话在改文件（AGENTS.md／code-conventions.md）／
对照性文本豁免。

不做（去向）：design/ 全部文档归 reports/ 反哺点；门票标识符与数据键不动；
shop.tres:86 与 curio_interact_controller.gd:165-166 移交文档侧定性；
A 表词／流程动词／STC 通用词待用户另裁。

06 条目状态：待写卡 → 已写卡（卡片路径）。
流水线闸 PASS：卡片口径 22 张全过。
 2026-10-20 00:45:43 +08:00
DKChan 066a9f7e31 docs(active残留): active.md 废除补刀——10-18 五张待执行卡摘「唯一例外=active.md」假指令15处＋baseline.json 08b 死记录再删＋recolor_terrain_tiles.py 头注出处注记摘除 
08b 复活成因：roadmap 压缩批 8f66ae15 与废除提交 27812167 同日、worktree 分叉早于废除，
合回时旧 baseline 被原样带回（该批自记「其余条目原样保留」）——再删并留此记录防三犯。
历史文档约 19 处过去时引用按 registry 注销批（d54cbed7）先例保留不动；
在途分支合回时 diff 再见 08b/active.md 一律就地拒收。
 2026-10-20 00:39:26 +08:00
DKChan 6d601d23dc chore(禁写变更记录批): 版本历史节/日期批注全面废除——gdd_lint R4 反转禁设＋三工具去豁免＋48 文档删节＋game/README 流水段删＋代码注释 900 余行轨迹标签清偿（约束句保留）＋规约/skills 五层指令面同批改指 git 沿革 2026-10-20 00:22:18 +08:00
DKChan b99a46beed docs(research): 效果引擎无状态化提案用词对齐系统资源定名——指计数器容器的「账/账本」35 处改为「计数器容器」 
2026-10-19 用户裁：GP／AP／钥石／RAP／刷新次数／生命／充能这一层统一叫「系统资源」，
「账／账本／独立资源／系统数值」退役。提案里的「账／账本」指的是 RunLedger 持有的
计数器容器，不属系统资源，沿用旧词会在读者端与新定名相撞。
本次只换词不改内容：容器一律写「计数器容器」或直接写标识符，动词「记账／落账」
改「写入计数」，另订正「文档欠账」→「文档缺口」。提案自身的判断与结论一字未动。
 2026-10-19 19:27:28 +08:00
DKChan b206120b8e docs(research): 效果引擎无状态化提案 v1——计数器四桶外置·搬运链删除 
背景：EffectEngine 持运行时账本 _counters（effect_engine.gd:87）被判违反
ECS「系统无状态」原则。目标形态＝引擎退化为纯计算引擎，计数器按
round/battle/level/adventure 四桶外置、由各生命周期宿主持有并随宿主生灭，
事件触发时经 ctx 传入；counters_export/seed 搬运链整段删除。

本文件为提案草案（非需求卡片），经 2026-10-19 三轮 code-level 复核：

§2  现状实查（行号全部实核：effect_engine.gd 五行 +3 偏移系迭代 31 卡②
    forgive_seal_miss 扩签插入三行；硬编码清除名单在 adventure_runner.gd:840-842；
    断点写键 :1035；现役 distinct counter_id 共 16 枚非 13；写口 6 处非 5，
    漏 grant_segment.gd:327 即卡②保险记账唯一通路；读口 5 处非 2）
§3  目标形态：四桶宿主（LevelRunner/BattleOrchestrator×2/RunLedger）＋
    id 前缀归属（round_/lvl_/adv_/无前缀=meta_非法）零运行时机制
§7  N1–N6 全部由既有约束推得定值（非裁决单），采集问题按 sim-data 配套
    纪律⑦「零数值改动=零 MC」定不发起
§7.8 run_ledger.gd:42 判空早退缺陷全解：自锁（全新开局连玩则 adventure 域
    四枚整局不落账，唯一解锁=断点回填 :206-208）；git log -S 实证该守卫由
    6fd7d782 迭代 27 T3 逐字搬入，旧形态下合理（判共享引用有效性），收口后
    判据与被防风险脱钩
§4.1 验收测试清单 13 条（机制正向验收为主力）
§4.2 载体可达性核验：仅 C2/E1E2 闭合，余半闭合或未闭合
§4.3 未闭合项 U1–U6
§4.4 实现设计缺口 A1–A8（A1 ctx 结构／A2 桶接口／A3 树合成行漏前缀校验为阻塞级）
§4.5 需求澄清未对齐 B1–B6

状态：设计未闭合，尚不可写需求卡片。

已知行为变更（修后）：twin_digs 真跨战累积；tree_sense 锋/守由「每战限 2
次」修回「每关限 2 次」＝显著削弱（一关 4–5 战，理论上限比 4–5:1），系回到
设计意图（effect_engine.gd:140 注释），不构成数值改动。

反哺点（本批为文档产物，不落 design/）：①architecture.md 缺「系统无状态」
原则条目（ECS 依据目前仅在 2026-10-19 会话裁定中）；②06-待办清单:627
「计数器寿命域未统一」解法方向被本提案推翻；③entities.yaml counter_id 前缀
规则；④tree_sense 削弱登记 07 目检；⑤roadmap 当前位 stale（仍写迭代 31
待开工，卡②已合入）。

范围：代码+文档，不含美术。零待裁点（A1/A2/A3/A6/A7 由本轮自行补齐）。
 2026-10-19 19:14:20 +08:00
DKChan 1deaa55341 chore(rules): 根规则文件改名 CLAUDE.md→AGENTS.md＋全库旧名引用同步 
- 结构闸白名单 ROOT_FILES 收编 AGENTS.md（改名后主区曾判「根文件越界」红）
- 流水线闸禁写根规则文件标志名只留 AGENTS.md（用户裁：旧名不留双保险）
- design/dev 五份规约＋architecture、roadmap、registry、06、三个 README、
  在役需求卡与 QA 标准的引用逐处换代；历史 reports/ 与 .workbuddy 留痕不动
- 顺修三处换名后会误导的行号引用（:56→:59、:63→:68、71 行计数加注）
- 三份主区未跟踪文档（测试审计标准／启动装配卡／营地会话提示）随批搬入并登记
 2026-10-19 06:04:09 +08:00
DKChan ed2dfaf66f docs(迭代31): 审计报告加读数订正注记＋卡① 估时句落用户裁决（不上调） 
- 审计报告合计行下方补一段实测口径说明：原表把全库读数（金币 381／插旗 600／雷格 394 处）记进 game/ 范围，flag 侧低估约一倍；实测净 543 处/42 文件，施工判据指向卡片 §2 复现命令。表体数字保留作历史读数，报告仍为卡① 声明的设计事实源
- 卡① §6 估时段落：删去「是否上调归编排段／用户裁」的待裁表述，落 2026-10-18 用户裁定语「不上调」，估时保持 ≈3.75d、roadmap 预计周期维持 ≈1.5 周
 2026-10-19 01:33:35 +08:00
DKChan b7b94d1163 chore(主区): 术语补扫批遗留两项入库——project.godot 为编辑器保存时段落重排（[debug] 段位与 default_texture_filter 行位，5 增 5 删内容零变化），playnote 为玩家试玩反馈原样追加 11 行 2026-10-19 01:32:54 +08:00
DKChan 64535632d1 docs(需求卡片): M4 数值批卡删除入库——2026-10-16 用户令作废该批，06 的「M4 数值欠账」条目留档（未设计未启动、不另行归属），本卡属作废内容按「证据只留最新」退役 2026-10-19 01:28:55 +08:00
DKChan 09f57842d9 docs(需求卡片): 卡② §10 前置门 2 改判为已满足——奇物.md v3.18 已随 39523dd4 进 HEAD，06 状态行也已推进；删去「归用户／文档批」的过时落笔责任句 2026-10-19 00:23:13 +08:00
DKChan 929b74ac43 docs(迭代31): 两卡记载改为可复现实测读数＋06 凭证件条状态与设计面口径闭合 
用户令：本会话不做开发，只把需求卡片与迭代 31 相关文档改对。逐条对现行代码复核后的订正：

卡① v1.4（代码术语刷新批）
- §2 总量改为可复现实测：game/ 含 flag 的文件 57 个共 617 处，剔除 size_flags_* 70 处（19 个文件，v1.3 只记 ui_assembler 一个）与 _fatal_flag 4 处后净待改 543 处/42 个文件；原记 ~314 处/29 文件低估约一倍、文件数少记 24 个，并附复现命令
- §2 逐文件表按净命中重排 13 行；N2 中文表改实测（金币 39／插旗 62／雷格 75／惩罚格 1／旗含复合 376 处——原记 ~15 严重低估）；插旗 top3 文件误记订正
- 补三处真实漏项：FACTS 两键全链（flags_count→seals_count 三处、dug_under_flag→dug_under_seal 十一处，含 effect_words_t1_test 断言）入 §3 新契约与 T3.1；ui_click_probe 净 21 处（原只记注释 3 处）；T5.20–T5.24 补五个卡片完全未列的文件（screen_flow_probe 8 处等）
- ui_assembler.gd:203 注释「min/flags」改判为须改写（非豁免项），否则 V1 零命中判据永远红一项；估时 ≈3.75d 未自改，标注按旧读数定、上调与否归编排段／用户

卡② v1.1 补订：EFFECT_KINDS 现 31 项（原记 30，本卡 T4 扩签后 32）；其余 §2 全部行号与 rare 配额构成（ap3＋rap2＋battery1＋时沙2＋保险1＝9→7）逐条实测核对无误

06-待办清单
- 「凭证件裁削批·代码侧迁移」：设计面 工程直入→文档轨；状态 待写卡→文档设计已闭合（奇物.md v3.18）＋已写卡（卡片路径）＋已编迭代 31；现状句「候选名 forgive_flag_miss，命名待用户定」改为已裁 forgive_seal_miss
- 「代码术语刷新批」：现状句 game/ 读数改实测值，并注明审计报告读数属全库/代码域混记、两种口径均不可复现

验证：流水线闸 PASS（06 条目 60·总表 31 行·交叉核 1→2 链·卡片口径 21 张）；文档域全闸与基线一致、无新增红。
 2026-10-18 20:18:33 +08:00
DKChan ad48d2a2d2 docs(需求卡片): 迭代31两卡冲突修订——卡① v1.3／卡② v1.1 
- 卡② D1 换代 forgive_flag_miss → forgive_seal_miss（2026-10-18 用户补裁），并加「标识符形态通则」：现状事实里的旧名与行号按卡① 合回后的 seal_ 形态复核，新写一律 seal_ 族
- 卡① 补 T3.1 漏链：flag_missed → seal_missed（含 effect_engine.gd:149/:152 天赋树合成行），否则 V1 零命中必红；§3 新增与卡② 的命名接续契约
- 两卡「关联文档同步面」与任务卡的文档义务由旧口径「机械面随批」改列 reports/ 反哺点（req-card §6/§7 2026-10-17 改口径：实现批禁写 design/ 与根规则文件）
- 两卡各补「设计事实源」声明；卡② 契约 8 实证订正为字段集不重叠、文件集重叠（effect_engine/grant_segment/battle_orchestrator 三文件两卡同改，禁并行开 worktree）；§10 补两项前置门
 2026-10-18 19:42:16 +08:00
DKChan 39523dd424 docs(奇物): 凭证件裁削批——同调电池删除／完美保险改归专长＋卡②写卡编入迭代 31 
用户 2026-10-18 逐裁：①同调电池删除（秘宝＝局外同调件、冒险中零更换途径，
与 cf04bd66 撤换装券／删回能器同一原则，UI 层从未接线选件入口）；②完美保险
改归专长（给的是规则豁免而非可调动的余量，符合 §1.1 判据）；③配额处置＝净删
（rare 9→7／总量 104→102）；④计数器寿命域本批不动，完美保险按现役
domain=battle 落地。

文档面（奇物.md v3.18）：
- 凭证件表「新 5+留任 2」→「新 3+留任 2」，删同调电池行、完美保险行
- §1.3 异质性「被写入的账」注销「秘宝充能」「完美资格」两账；attune_charges
  账本与 _seed_attune_charges 仍属秘宝基础设施保留（迭代 11）
- 迁入登记节增写「资源类迁出件（完美保险）」段
- 头注删除「2026-10-07 五件新凭证用户裁准写入文档」失实陈述（当日所裁实为
  池结构案D；「资源成员＝转换源」判据句本身本批不动，是否复裁归 06 在册）
- entities.yaml:633 凭证五件入池句加裁削注（104 读数保留代码现值）
- 07-体验验证清单两处加注销标；需求卡片-专长实装批五处加失效／改判注记
- 06-待办清单新增三条：计数器寿命域未统一／凭证件裁削批·代码侧迁移／
  2026-10-18 冒记案遗留待裁两项

卡②写卡与编入：
- 新增 design/research/需求卡片-凭证件裁削批-2026-10-18.md——T0–T8 共
  ≈2.75–4.75d；设计契约 8 条；验证闸 11 个需求点＋6 条变异注入表；
  代拍板白名单 5 条；D1–D3 已裁（forgive_flag_miss／rarity rare＋cap 省略＋
  desc「本场首次封印落空，不计入完美封印判定」／roadmap 措辞不变）
- roadmap 迭代 31 改为双卡：卡①代码术语刷新批＋卡②凭证件裁削批·代码侧，
  周期改 ≈1.5 周

闸：run_all_gates.sh --docs 验收通过。首轮曾报 8 项红（06 三条标题元数据词
不在词表、需求卡片列多卡写法不合 CARD_SEP_RE、周期非「≈N 周」形态），
已按闸规修正：元数据归一（会话提及／审计发现／文档轨／工程直入）、
多卡改「、」分隔纯路径、周期改 ≈1.5 周。

代码零改动——代码侧迁移归迭代 31 卡②另行实施。
 2026-10-18 19:04:04 +08:00
DKChan ea69670c39 docs(卫生): 配比提案存档入库批（案甲，2026-10-18 用户令）——提案原样入库＋退役头注，06「git 历史可考」由失真转真 
- 提案-冒险前资源配比预设-2026-10-04.md：入库（此前从未进 git，唯一副本=主区未跟踪件）——06 条目「该提案文件已随吸收即死退役，git 历史可考」对文件本身失真，入库即闭合、06 零改动；文头补退役横幅（吸收即死，裁决结论唯一事实源=06 条＋需求卡片，本文只作推导与淘汰依据历史档）；文头六处 gdd 链接多一层 ../ 修正；姊妹研究方案-挖掘风险不等式修订已随 cf799b32 退役批删除，去链改已退役注记（git 历史可考对该件成立）
- 需求卡片-冒险前资源配比预设批：裁决事实源行换代——恢复提案链接（随入库复活）＋退役存档注记（上一批 8084527b 的「未入库」临时注记随之作废）
- 主区未跟踪原件在合并后按超集验证 checkout 丢弃（入库版=原件＋头注＋链接修复）
 2026-10-18 08:10:55 +08:00
DKChan 8084527b68 docs(卫生): 死链清偿批——锻造工坊文头过期指路＋配比卡死内链＋Alpha梳理七处死指针（2026-10-18 用户令） 
- 锻造工坊.md：文头状态行尾句「实装待办在册 06「锻造工坊实装批」条」过期指路——该 06 条已随批次完成销号，改记实装已随迭代 23 入库（2026-10-12，见 v0.7 行）；版本历史补 v0.10 行
- 需求卡片-冒险前资源配比预设批：裁决事实源内链指向已退役未入库的提案文件（本仓 git 无全文，仅工作区未跟踪副本）——去链接改文字注记，裁决结论改指 06 在册条目
- Alpha未完成事项梳理：iter23 实现报告死路径改已退役注记；六处已销号 06 条目指路换代（第一关遭遇表数值异常/锻造工坊实装批×2/第二关技能池与投放/天赋树欠账三条/未开格类型徽章呈现时机——末者改记徽章批已交付 2026-10-17）
- 全库同类扫描其余命中均为版本历史行/历史记载/运行时产物/并行未跟踪件，按纪律零动；状态格一律未动（E1/E5/H2 疑已随迭代 24/徽章批落地，另行呈报待裁）
 2026-10-18 07:14:06 +08:00
DKChan 8313aab66c docs: 营地交互重做五卡入库＋06 条目按 §12 新格式登记 
design/research/ 入库六件：
- 需求澄清-营地交互重做-2026-10-18.md（唯一事实源，补标 v1.0 版本行供 06 闭合凭据引用）
- 五张需求卡片：存档制数据层改造／主菜单三入口化／选档界面新建／营地场景图新建／Esc 浮窗与营地顶栏

design/gdd/06-待办清单.md 末尾条目改 doc-conventions §12 新格式：
- 标题补登记元数据（2026-10-18 登记，来源=会话提及，设计面=文档轨）
- 正文改四属性（现状／缺口／归属／状态）；卡④五项美术前置（P1 渠道 A/B 待裁 … P5 落文）记入缺口
- 状态按状态机累积制：文档设计已闭合（凭据）+ 待美术设计 + 已写卡（五卡路径，顺序=执行顺序）

闸：文档域全绿（06 gdd_lint／07 doc_link／08 doc_term／08b active.md／08c 流水线闸／10 熵增闸），流水线闸 06 条目 52 全过。
 2026-10-18 05:45:56 +08:00
DKChan 4a65f9eb6d Merge branch 'master' into art-standee-20261006 
# Conflicts:
#	design/art/art-bible.md
 2026-10-17 17:31:22 +08:00
DKChan abe5f180fb docs(反哺): 迭代 27/28/29 GDD 反哺点八条＋一条建议逐点裁决写入（2026-10-17 用户令「全部按推荐案」）——①③④⑤architecture.md v1.8：新增「战斗域装配现状」（结算五段/RunLedger 四账）与「呈现层装配与会话生命周期」（三屏壳/装配合同立条款不摘录表/RunScope 九阶段×五引用面矩阵认账/ModalFlow tags）两节＋初始化顺序补启动后置条件六条，呈现层 D1 行与实现实证读数换代；②code-conventions.md §4 第 7–12 条（S9 三规则口径/:= {} 不算债/type-hint-ignore 与 rng-seed-exempt 两豁免通道/禁裸 autoload/Variant 参数化口径）；⑥⑦⑨test-conventions.md 新增 §7 判定三硬闸（含新写测试件全类型标注写法纪律）与 §8 判定可靠性优先于覆盖率（含脚本错误静默中断断言的机制事实与自证义务）；⑧07 v1.4：㉖① 保留不注销、加 screen_flow_probe 机检承接注记。同步清三笔在册旧账：iter27/28/29 三份实现报告 git mv 往 reports/（06 条③迁位账清零，全库引用改指新路径、iter24/25/26 等已删报告死指针改「已退役（git 历史可考）」）；iter29 报告 §六第 0 项按合并现实（fff4f120，两红各自结案 dac9a94b/fcb8c3f8＋8c18b52b）改写；06 补登迭代 29 反哺专条（该批漏登）。登记时「16 层/十断言」读数按代码实态 17 项/11 条订正。非迭代批不占迭代号；active.md 改动留主区工作副本不随本批提交，等闸回执。 2026-10-17 06:25:28 +08:00
DKChan 480d811820 docs(cards): 迭代30三卡 v1.4——开工前预授权 U1 落卡 
用户在开工前一次性决断四项，防开发中反复打断；不写进卡片则
/iter 仍会按原文停机等话，故逐条落卡（2026-10-17）：

卡① 未开格类型徽章批
- T0-③ shader 原型帧改「判据自判」：满足三条像素判据（五组去色相
  可分／砖心不遮数字／接触带不越圈且非生效格零变化）即自行推进铺码，
  不等回话；调参轮次上限 2 轮，超限停线回 Q1 复议（原「目检不过不过夜、
  不承诺轮数」）
- §8 增设「L3 预授权类」：共存撞墙退 a 案程序绘制兜底／golden 换代按
  契约 6 显式流程／色弱不可分先在 provisional 梯度内自调一轮——三件
  批内处置+留痕；触既有裁决面类（翻动五组色相/on-off 位差/T3 触发/
  重开裁点）维持停机
- §10 开工门新增 U1 预授权条

卡③ 二三关棋盘观感批
- Q2 甲/乙由「延裁·T1 出口现场裁」改「判据自动裁」：甲案候选样张读数
  达标即走甲不停机，仅读数证伪「纹理太碎」才呈报裁乙
- V2 定向目标带授权批内按 T1 实测读数自定、随定性报告呈报即生效；
  T1 出口定性人闸（06 已裁硬步骤）只确认轴归因与修法方向
- §10 开工门新增 U1 预授权条，其余 L3 维持停机

卡② 战斗一屏样张批（复查结论留痕，零机制改动）
- U1 预授权对本卡不适用：两处人闸（T1 方向稿选划／T3 气质终审）是
  防不满意机制本体，取消即拆机制
- 四项 L3 经分类全部属「触既有裁决面／超本批面」，维持停机呈报；
  §6 留分类结论注防重复呈报

闸：tools/run_all_gates.sh --docs 零新增红。roadmap/CLAUDE.md/
game/tests/README.md 与闸脚本零触碰。
 2026-10-17 04:04:55 +08:00
DKChan d5fe747083 docs(cards): 按 2026-10-17 文档同步闸 v3 换代迭代 30 三卡（补遗） 
在分支既有 v1.3 口径修订基础上补齐缺口，三卡对齐"代码实现批禁写
design/ 与根规则文件、产出物只落 reports/"的新批次规则：

卡① 未开格类型徽章批
- T2 末条「全闸」改「代码域闸（批末重闸）」：tools/run_all_gates.sh
  --code 对基线零新增红，并明示文档域闸不属本批改动域
- §11 grilling 审查记录末尾加 v1.3 口径注记：「三文档闸」一类闸件
  枚举只读为历史记录，闸清单唯一出处=run_all_gates.sh

卡② 战斗一屏样张批
- §7.5 D4「迭代 29 门禁语义改动先后」由待定依赖改写为已结案：
  2026-10-16 合入 master（fff4f120，roadmap.md:88 状态=已入库），
  闸口径直接按当期语义跑 --code，原两分支消解
- §0 与开工门两处「迭代 29 自身 U0 未解」陈旧读数同步作废（与 D4
  同源，避免卡内自相矛盾），「不构成排期承诺」口径不变
- §9 grilling 审查记录末尾加 v1.3 口径注记：「doc 三闸」一类闸件
  枚举与「写入文档/登记 06」类落文表述只读为历史记录

卡③ 二三关棋盘观感批
- T1 采样源与 V2 判据两处「读数表进实现报告」补落位路径
  reports/iter30-实现报告-<完成日>.md

闸：tools/run_all_gates.sh --docs 零新增红（回执 commit=d6b0c9fc 与
分支尖一致）。CLAUDE.md/roadmap.md/game/tests/README.md 与闸脚本零触碰。
 2026-10-17 03:35:48 +08:00
DKChan e65e967dd8 docs(cards): 迭代30三需求卡片v1.3——文档同步闸v3口径修订 
按 2026-10-17 用户六条裁定（纯文档批 carddoc-20261017）：
- 实现批禁写 design/ 与根规则文件：三卡同步面义务全部改列
  reports/iter30-反哺点-<完成日>.md，用户会话裁决后归文档批落文
- 产出物落位换代：实现报告/代拍板追认单/反哺点清单落 reports/，
  不再 design/qa/
- 末卡改「产出物落位卡」（三份 reports/ 文件写齐才算收口）
- 闸口径按域选档指路 tools/run_all_gates.sh，摘除死闸件名单与
  「全量档全绿」「文档三闸」字样
- 实机目检项转 reports/ 实现报告目检总清单，「入册 07」转反哺点
- 裁定留痕原文不动，落文类表述加执行口径注记（卡①§10/卡②§7/§7.5）
- roadmap/CLAUDE.md/game/tests/README.md 零触碰
 2026-10-17 01:24:50 +08:00
DKChan 3dc168cd3d merge: 同步 master（60449941 迭代 30 编入批 + 08 状态刷新批）并解决 roadmap 冲突 
roadmap 冲突面：本批改了迭代 29 行与「迭代进度／近期主战场」两处，master 同期编入了迭代 30
（UI 呈现三卡批）并把空位行顺延为「迭代 31+」。以 master 为基重新应用本批三处换代：
迭代 29 行（卡片 v1.4→v2.0、门列→实耗、状态→已入库）、迭代进度行、近期主战场行
（下一前沿改指迭代 30，迭代 29 收口遗留注明 11 号闸待批准）。
active.md 与 06 无冲突（自动合并）：状态记录 505 在册，快照三行换代保留。
 2026-10-16 16:33:15 +08:00
DKChan 272cc1ad58 docs(迭代): 迭代 30 编入 UI 呈现三卡批（2026-10-16 用户令）——三卡经「建卡→grilling→按推荐方案代拍板」三步全流程：①未开格类型徽章卡（渲染路线丙=shader 为主+程序兜底、明度档 provisional、开关丙、静态态、两套色带不并入）②战斗一屏样张卡（丙=样张即设计目标图、仅战斗屏、引擎实拍+shader 乙为主半天试验件前置、字重丙、死指涉甲、双口径乙两闸分跑）③二三关棋盘观感卡（L2/L3 同批甲、定性人闸走 06 既裁、素材轴甲/乙裁点挂 T1 出口呈报硬步骤）。grilling 翻案账照卡内审查记录落档：整屏闸机检实存（本批定性=闸后补跑）、五组色相既裁不再问、③卡 Q1 依 06:449 既裁撤销、目检「不阻塞+否决回补」对齐 CLAUDE.md 既裁。roadmap 迭代 30 表行新增（迭代内串行①→②→③、禁三线并行=汇聚文件冲突、合计 ≈11–14d 按批次分会话逐个 U0）、原空位行改迭代 31+（M4 禁令原文保留）、当前位置与近期主战场两处同步；06 三条状态行加编入注记（徽章条 2026-10-05 过期读数标注批内刷新义务）。三闸：doc_link 死链 0、doc_term 疑似现行 0（--strict exit 0）、gdd_lint 本批文件全过——01-核心循环 R5 红灯为并行会话提交 9846a29f 既有问题，非本批引入，另报 2026-10-16 05:01:58 +08:00
DKChan 698d864dcc docs(迭代29 T0): 开工日基线冻结与三反例缺陷坐实 
基线（master 752c9a0a，worktree 同点实测）：冒烟 1127/0、run_all 27 套、在闸探针 9（轻闸4+click1+full4）、
墙钟 run_all 34s/smoke 71s/轻闸 quick 363s、存量红仅 09 静态扫描 exit=1（S10 文件头 127 处）。

T0-① 三反例全部判绿＝三硬闸缺陷坐实（非推断）：
a 零断言套件 → run_all PASS；b SCRIPT ERROR 套件 → run_all PASS（错误未中断后续断言，仅外部扫描可抓）；
c 打印 PASS 后 quit(1) 的探针 → probe_gate 报「全绿」。三靶子验后已还原。

T0-④ 复核 F1'-F11' 全部 file:line 无漂移（core 23 文件、7 个真零指名、status_container 2 指名、
呈现层 5 件零指名、smoke 29 .gd/12 .tscn 均复核）。
 2026-10-16 05:00:06 +08:00
DKChan 849e4b1cd2 docs(卡片): 测试分层与门禁语义修正批升 v2.0（三轮复查结论落文，U0 门只欠发令） 
grilling 两轮＋一轮只读深挖后一次性升版。首轮十一问按推荐全裁（L2 承载+2 例／parity 收编为条件闸件以守「MC 无数值改动零跑」红线／CI timeout 前提已死改铸为轻闸墙钟预算／integration 并入 run_all manifest／S9 存量豁免维持但新写测试件全类型标注〔升契约 8〕／golden 显式重制+呈报+复闸／smoke 两名不改名只加注）；第二轮 N1＝§2 改指针（事实面归 architecture.md 测试域三张表，禁双载体漂移）、N2＝T6 收 S3 路径修正＋零命中自检（+0.25d）。

事实订正四处：PASS 串判定面实为 8 件探针（非 4）；game/smoke 实为 29 个 .gd（非 38）；T5 的 status_container 不是零覆盖（2 单测已指名）→ 换 board_generator；README「ci-removal 批已改写门禁节」前提不成立（分支未合入）→ CI 残留 8 处改由本批 T2 清除。死引用订正：CLAUDE.md 旧节号（文件已压到 71 行）、tests.yml（已删）、golden_compare.py 行号。新增义务：批末回写 architecture.md 三硬闸矩阵与 S 表。估时 T0-T8≈6.0-7.5d，软盒 7d。active.md 快照两行同步＋状态记录 504。文档三闸全绿。
 2026-10-16 04:24:29 +08:00
DKChan aad2999aba chore(zcode): 移除 .zcode 工具配置并更新忽略规则 
删除 .zcode 下的 hooks 与 plans 配置，将 .zcode/ 和
.zcodeignore 加入 .gitignore；同时重写试玩问题记录文档，
用新条目替换垂直切片 v1 的旧内容。
 2026-10-16 04:14:23 +08:00
DKChan 21c83f5736 docs(roadmap): 迭代 29 编入测试分层与门禁语义修正批（2026-10-16 用户令） 
roadmap：迭代 29 行改写为「测试分层与门禁语义修正批」——需求卡片=design/research/需求卡片-测试分层与门禁语义修正批-2026-10-15.md（v1.4，T0-T8≈5.5-7d，开工门=U0〔Q3-Q7 裁点＋卡片 v2.0 重核＋/iter 发令〕）；新增「迭代 30+ 位空」行——原 M4 数值批已废（2026-10-16 用户删卡令「它就不是一个应该存在的东西」），禁止再以该名义立批/规划/引用已删卡，四项数值欠账归 06 在册、重新归属待用户裁；当前位置节迭代进度与近期主战场两处换代（下一前沿=迭代 29）；迭代 23+ 行（M4 原始泊位）追加作废注，仅作排期史保留。

需求卡片 v1.5：排期行与 §5 roadmap 同步行更新；登记 v2.0 重核遗留项（残留 CI 措辞四漏网点＋事实基线换代：冒烟 1086→1125/0、门禁五闸→run_all_gates.sh 编排、architecture.md 测试域节已成文、Q3 的 CI timeout 前提消失）；订正 v1.3 版本条目尾部重复段。文档三闸全绿（gdd_lint 0 不通过／死链 0／疑似现行 0）。
 2026-10-16 03:09:34 +08:00
DKChan 6c2dbc37c1 docs: ADR 体系废除 + architecture.md 确立为架构唯一事实源（2026-10-15 用户令：决策记录归 git commit log，不另存决策文档） 
- 删除 design/dev/architecture/adr-0001~0007 共 7 份文件（内容留 git 历史可查）
- architecture.md：删「ADR 审计」「ADR 立项清单」两节；清除全文 ADR-000X 注记、QQ 表/S 表 ADR 引用；未决表关闭已落定项（QQ-01/02/03），立项清单在途事项转登记 QQ-11~14；补 A1 生成姿态事实、autoload 四件清单、board_generator 性能姿态；文档状态立「事实源地位」条
- CLAUDE.md：恢复 RNG 单点硬性红线（去 ADR-0007 引用）；新增「架构事实唯一源」红线；规范导航架构行标注唯一事实源
- doc-conventions：§5 增「架构事实唯一源」行；§11 活文档清单补架构文档
- registry：architecture.yaml 删 18 处 adr 字段、autoload_set 补 SaveManager/MetaProgression、board_rending 更新为 Node2D 已落地事实；entities.yaml 12 处引用清除
- game/ 代码注释约 60 处清 ADR-000X 引用（事实与日期保留）；豁免标记 ADR-0007-exempt → rng-seed-exempt（main.gd/static_scan.sh/architecture.md/06/iter27 五处同步）
- GDD/qa 实现报告/research 卡片/roadmap/tests README 引用全清；死链校验 1206 链接 0 死链、gdd_lint 0 不通过
- 代码中 adr/adr5 等为 adventure_runner 既有局部变量名（非 ADR 引用），未动
 2026-10-15 23:52:30 +08:00
DKChan eea345882b feat(迭代27 T6+T7): 波五b 卫生件包+文档同步闸——对拍全同 
T6 卫生件（P2 组收口）:
- 死代码 13 函数删除（审计 16 处复核=ui_kit:486 实读现役不删，追认单#14）+FeatsEngine
  整文件退役（class_name 注销）
- 字符串 Callable×10 位→方法引用形态（编译期方法存在性校验；语法实证 METHOD_REF=true）
- 状态机 enum 化: adventure State（外部 String 契约 getter 词表逐位一致+外部纯读实证）/
  standee HeroState（register/set String 形参零变化+probe 面恒等）
- ConfigDB _fatal 退出归根（核心层去 quit/crash→_fatal_flag，决策归组合根 fail-fast 通道）
  +resolver 诊断/数据通道全面 Callable 化（ConfigDb↔Resolver 类型环断根）

T7 文档同步闸:
- 实现报告 design/qa/iter27-实现报告-2026-10-14.md（五波+闸表+追认单十五项+反哺点两条+目检五件）
- 06 迭代 27 条销号+GDD 反哺点两条新条；07 ㉖ 目检节+v1.0 版本行；roadmap ✅ 换代
- 审计报告本体按退役规则 git rm（吸收即死；修正计数由卡片承载）；卡片来源行改指路

闸: 对拍三变体全同（第五跑）+冒烟 1081/0+run_all 27 套+probe click+render golden+static_scan 全绿
 2026-10-15 01:41:37 +08:00