game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
2,057 Commits 23 Branches 0 Tags
1d26fbb9ffc22e76b6fefb225f8ec7bfe2aeea67
Commit Graph
2057 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
DKChan 3e06cd52a2 Merge branch 'iter27-closure-20261020' 2026-10-20 14:55:15 +08:00
DKChan ed19453d25 chore(批后收尾): 迭代 27 产出物退役——实现报告与探针迁移对照按吸收即死删除（反哺点已落 architecture/code-conventions 2026-10-17 版、追认单十五项已追认、目检已登记 07 ㉖、观察义务已迁 06）；roadmap 迭代 27 行实现报告列改退役保留字，reports/README 示例注记退役 2026-10-20 14:54:53 +08:00
DKChan f7be1f47c4 docs(效果引擎无状态化·写卡补丁): grilling 审查轮事实修正——T3 补 :390 回灌调用删除（漏列即编译断裂面）；T2/T1 补 run_ledger 头注与 level_runner :630 过期契约句清理面（「战斗侧只走 read/append 原语」随 ctx 直写字面失义）；T5 counter_id_legal 修回提案 §3.3 字面（仅 meta_ 非法——「其余未知前缀非法」语法不可判定，残剩风险归 V10 扫描与评审） 2026-10-20 07:39:30 +08:00
DKChan bd2faab7d6 fix(research/治理批): 08 的 playnote 链接相对层级订正（../→../../） 2026-10-20 07:35:10 +08:00
DKChan 31fe87d122 docs(research/治理批): 暂存地职责收口——§11 立「research/ 无常驻例外」＋卡片死期=实现批合回 master＋跨会话交接文件禁入库＋根 playnote 定性用户随手记；道具退役素材库迁 design/content-archive/ 转正活文档（3 处 GDD 引用同步）；playnote.md 挪仓库根（引用面 6 处＋ROOT_FILES 白名单）；research/ 清 6 件（会话交接四件＋读数 dump＋Alpha梳理已吸收件，H11 指路改结论内联）；熵增闸 DESIGN_SUBDIRS/ROOT_FILES 白名单同批改；技能层旧卡片路径 7 处在主区就地修（harness 配置不入 git） 2026-10-20 07:34:46 +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 c5200b6be9 merge: 禁写变更记录批入库——规约/AGENTS/闸壳/技能四层指令面废除文档内变更日志（gdd_lint R4 反转为禁设＋06b 新闸＋三工具去豁免），48 份文档版本历史节与 game/README 流水段删除、代码注释 900 余行批次标签清偿（约束句保留、去注释零触碰自证）、卡片「修订记录」块改「审查回写要点」（--docs 闸 dafc5540 六件全绿＋变异验证三态真拦：版本历史/修订记录/修改记录） 
# Conflicts:
#	game/tests/static_scan.sh
 2026-10-20 05:52:25 +08:00
DKChan dafc554093 fix(闸壳): 06b 变更记录节档只报 R4——全规则集归默认档，避免体裁红混入禁设判定 2026-10-20 05:50:13 +08:00
DKChan e8b6751b6a chore(闸壳): 06b 变更记录节入存量基线（绿档）——同 08c 流水线闸先例 2026-10-20 05:49:03 +08:00
DKChan cddd13ff40 docs(禁写变更记录批·补): iter30 反哺点末处「版本历史追加」措辞换代首状态行 2026-10-20 05:46:51 +08:00
DKChan 8a68c9ea11 merge: 同步 master e92a18e1（卡片落位 reports/＋dev→engineering 改名批）——四处版本历史节冲突取本批删除侧，reports 卡片重放禁写变更记录清理，06b 闸扫描面扩 reports/ 2026-10-20 05:46:28 +08:00
DKChan 8847d960b5 docs(game/tests注释重基准): 三件套注释路径随 dev→engineering 改名同步（用户特别授权主区直改，纯注释零行为变更） 2026-10-20 05:43:39 +08:00
DKChan d345f1191b docs(禁写变更记录批·补): roadmap 五步登记句去日期裁注（R3 清账） 2026-10-20 05:40:49 +08:00
DKChan e92a18e10f merge: dev 目录正名批入库——design/dev → design/engineering（架构+五规约+引擎参考的工程知识域名实对齐），13 文件 34 处引用＋熵增闸白名单同批；顺带修除 AGENTS.md 误入库存的冲突标记（文档域闸 f19d893a 全绿，白名单漏改真红实录） 2026-10-20 05:37:51 +08:00
DKChan f19d893a08 merge: 同步 master 71b88e3b（卡片落位迁 reports/ 批）——AGENTS.md Project Layout 冲突取双方意图（engineering 行＋卡片批新版 research 行），顺带修除 master AGENTS.md 误入库存的未解决冲突标记（上批闸不扫 AGENTS.md 致漏网） 2026-10-20 05:37:36 +08:00
DKChan f406002766 docs(dev目录正名·engineering): design/dev 更名 design/engineering——名实对齐（目录实存=架构+五规约+引擎参考的工程知识域） 
- git mv 15 件本体；13 个引用文件 34 处路径同步＋熵增闸 DESIGN_SUBDIRS 白名单同批改判
- 白名单漏改时熵增闸当场真红（子目录越界拦截能力实录验证），同步后全绿
- game/tests 三件套注释按用户特别授权批后主区直改（不入本批）；reports/research 暂存档按吸收即死原则不改
- 文档域闸全绿：gdd_lint/doc_link/doc_term/流水线闸/熵增闸
 2026-10-20 05:33:34 +08:00
DKChan 71b88e3be3 merge: 需求卡片落位迁至 reports/ 入库——10 张卡搬移＋卡内链接重基准（BROKEN=0）＋48 处路径依赖＋AGENTS/doc-conventions/reports README 规则同步＋pipeline_gate 三处改 reports/＋.zcode 四技能与用户级副本同步（--docs 闸 d6356d8d 验收通过，已同步 master d5f95e7f） 2026-10-20 05:31:09 +08:00
DKChan d6356d8dbe merge: 同步 master d5f95e7f（art/ 边界批）——三处冲突＝对方 art 改名/迁移 vs 我方路径重基准，取对方内容改动＋按新落位换算路径（comfyui-prompts→art-prompts、美术审计件迁 research/） 2026-10-20 05:30:37 +08:00
DKChan d5f95e7f8d merge: art/ 边界批入库——art/ 判据定为载体性质（审计报告迁 research/ 并写接收方、06-10-06 HTML 出盘）＋提示词库改名 art-prompts＋熵增闸加第六查 art/ 内容白名单＋规约补「正文单点维护」并据此把生图操作单的色值复述改指 character-design §5.4＋candidates 目录判作废路径统一改指 artwork/candidates/（文档域闸 2b5f1d1a／e4897cdd 全绿，变异验证两况真拦） 2026-10-20 05:28:53 +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 e4897cddef docs(candidates作废): 乙案——候选图入库路径统一改指 artwork/candidates/，06 该条随裁删除 
用户裁乙：design/art/candidates/ 从未创建、判作废，熵增闸退役名单保留该路径作守卫。
四处现行指针改指在途工作区：asset-path-map 目录表行与流程第 1/6 步与素材朝向注、
art-prompts 使用流程第 2/5 步、remote-gen-prompts 登记义务与出图注各一处、art-bible §8.3 命名规范句。
06「候选图目录两处判据冲突」条已裁删除。art-bible 与 art-status-checklist 里指旧路径的版本历史留痕行与
已注明描述性引用的行不改写。
 2026-10-20 05:22:59 +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 a2d446d9e0 merge: 需求卡片退役批入库——删 11 张失归属卡（迭代 20–30 已完成批）＋roadmap 十行与 reports 四处改「已退役」保留字＋保留卡 6 处指路改提交号＋清偿 5 处死链（全量闸 fe47f48e 验收通过，09 静态扫描基线红转绿；已同步 master e8a29342） 2026-10-20 04:03:39 +08:00
DKChan fe47f48e0c merge: 同步 master e8a29342（qa目录退役批）——四张卡冲突按「卡已退役」取删除，master 侧改动仅为 design/qa/ 路径内联，信息零损失 2026-10-20 03:51:25 +08:00
DKChan e8a2934208 docs(qa目录退役·B1): game/tests/README 一行不改，欠账登记进 06——本批收回纯文档域 
- 用户裁 B1：撤回对 game/tests/README.md:81 的指针修正（相对 master 的 game/ 路径改动清零），避免零代码改动的批被合回闸按路径前缀推成代码域、强制全量测试
- 06 新增一条欠账登记（### 文档与结构 段顶）：分级表 Config/Data 行仍指已退役的 design/qa/，正解 sim-data/，等下一批真改 game/ 时一并纠正；写明「死链闸扫不到」（doc_link_audit 只扫 design/gdd/）与「推域规则触发条件」两条成因，来源=批次移交，状态=待写卡（备选）
- 五道文档域闸全绿：gdd_lint／doc_link --strict（1205 处链接 死链 0）／doc_term --strict（疑似现行 0）／pipeline_gate（06 条目 64、卡片口径 21 张全过）／repo_structure_audit PASS
 2026-10-20 03:46:04 +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 897a074292 docs(qa目录退役·改判A): 40 张取证照与对比报告删除不留档——git 历史即档案 
- 用户裁 A：验证截图不是黄金图（黄金图有 golden_baseline_refresh.sh 生成、golden_compare.py 逐像素比对，本批 40 张零代码消费），不配占仓库位置
- 撤回上一提交的搬移：game/tests/evidence/ 复原（README 回到改动前、.gdignore 撤销）、ui-audit-2026-10-06 整包 41 件（40 图＋同名报告）删除——原件全在 master 树内，回看走 git show becb675a:design/qa/...
- 删前核对未决面：报告 §① 底栏重设计草案已落码（game/presentation/views/level_map_screen.gd:122-125 定高 85px＋特性持有行限宽截断＋tooltip，注释直书「2026-10-06 审计差距①」），无未决项随删丢失
- 判据改写：doc-conventions §11「暂存地非档案库」行改为 design/ 六目录不留验证截图（结论进 06/卡片后图像即弃，在途图归 artwork/，机检基线才入库走 game/tests/golden/）；AGENTS.md Project Layout 两行与结构闸 IMAGE_PREFIXES 同步复原到不含 evidence
- 五道文档域闸全绿（gdd_lint/doc_link --strict/doc_term --strict/pipeline_gate/repo_structure_audit）
 2026-10-20 03:37:30 +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 0da014d4f1 docs(roadmap): 迭代 32 编排——卡①代码注释禁用词清扫批 
iter-plan 编排四查全过：
① 卡片文件存在：design/research/需求卡片-代码注释禁用词清扫批-2026-10-20.md 在盘（v1.1）
② 设计闭合凭据齐：06 条目设计面=工程直入 → 现状含代码级证据指认
   （全量扫描读数 195 文件／逐词计数／file:line 落点／根因／上游裁定）
③ 总估时 ≈8.5–10.0h ≈ ≈0.5 周 ≤ 2 周
④ 流水线闸 PASS

roadmap 迭代总表增一行（六列）：
| 迭代 32 | 待开工 | design/research/需求卡片-代码注释禁用词清扫批-2026-10-20.md | 2026-10-20 | ≈0.5 周 | — |

顶部「当前位」三行换代：迭代位 1–31 已完成或已终止，迭代 32 待开工；
下一步＝迭代 32 开工令（U0）归用户发。

06 条目状态推进：已写卡（卡片路径）→ ＋已编迭代 32。
 2026-10-20 02:34: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 becb675aca merge: active.md 残留清理批入库——10-18 五张待执行卡摘「唯一例外=active.md」假指令15处＋baseline 08b 死记录再删＋recolor 头注出处摘除（全量闸 066a9f7e 全绿，零新增红；09 静态扫描红转绿改善） 2026-10-20 01:14:50 +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 9c1fd6f152 merge: 根 README 纯指路牌批——四个链接零规则重述（文档域闸 0e711ac1 全绿，零新增红） 2026-10-20 00:37:16 +08:00
DKChan 0e711ac106 docs(readme): 根 README 落地为纯指路牌——设计/流程/当前位/待办四个链接零规则重述（用户裁：只要告诉别人怎么开发的介绍，权威各自原文承担）；同批两处白名单义务：AGENTS.md Project Layout 根目录行＋repo_structure_audit ROOT_FILES 2026-10-20 00:36:57 +08:00
DKChan 6d601d23dc chore(禁写变更记录批): 版本历史节/日期批注全面废除——gdd_lint R4 反转禁设＋三工具去豁免＋48 文档删节＋game/README 流水段删＋代码注释 900 余行轨迹标签清偿（约束句保留）＋规约/skills 五层指令面同批改指 git 沿革 2026-10-20 00:22:18 +08:00
DKChan 6e04fa60f6 docs(06): 登记「代码注释禁用词清扫批」条目（工程直入） 
来源=会话提及，设计面=工程直入——凭 2026-10-19 全量扫描的可复核实测读数
（范围 game/ 195 文件；口径=剔除对照性/历史文本行）跳过设计轨。

现状登记三组事实：
- 确定违规（术语表「退役词对照」在册，落于代码注释面）：板级 26／门票 38／
  正主 12（含误报 1）／落籍 10（含历史注记 1，不追改）
- 含「雷」字面 16 处，其中 3 处为玩家可见文案，违反术语表「对外命名纪律」
- 已核实清零（迭代 31 成果）：金币／插旗／标旗／雷格／惩罚格／旗 均为 0

根因：迭代 31 卡① 完成判据 V4 只覆盖四词，排雷／雷族未入判据；且机检闸
doc_term_audit.py 的 DEFAULT_DIRS 只含 design/gdd，代码注释面从未进闸。

上游依据＝2026-10-19 用户裁：完美排雷全库统一换代为「完美封印」（含代码
内部注释），据此推翻 需求卡片-凭证件裁削批:108「内部开发用语按 v3.15 纪律
保留」半句，该卡片条款订正归文档轨批。
 2026-10-20 00:12:57 +08:00
DKChan 13b5e37853 merge: 批后收尾技能 batch-closure 指认批——四处规约指针接上「归文档批做」悬空（文档域闸 fdaa10cb 全绿，零新增红） 2026-10-20 00:11:16 +08:00
DKChan fdaa10cb1c docs(rules): 批后收尾技能 batch-closure 落地指认——AGENTS.md 技能对照加第六入口＋process-conventions 12/13 接上悬空的「归文档批做」＋doc-conventions §11 删除方式与 reports/README 生命周期各补执行入口；技能文件本身在 .zcode/skills/（不入 git），反哺落文仍归 doc-design，本技能只做退役编排 2026-10-20 00:10:43 +08:00
DKChan b2327eb9ce merge: registry 注销批——两处 yaml 删除＋270 处引用面分层处理（文档域闸 776f5dc1 全绿，零新增红） 2026-10-19 20:11:15 +08:00
DKChan 776f5dc130 chore(留档): 摘除旧 GDD 模板 .claude/docs/templates/——解读对象 design/archive 已删，模板内两处 registry 指针随注销批一并消失；doc-conventions 第 1 节与 gdd_lint 头注改指现行口径 2026-10-19 20:10:53 +08:00
DKChan d54cbed7a5 docs(registry): 注销 design/registry 两处 yaml——GDD 现在时指针 76 处改指真权威＋地形变异/存档序列化/数据配置等同批换代＋iter31 反哺点 §三 registry 节删除＋doc_term 登记 registry 退役词 --strict 零疑似现行 2026-10-19 19:57:00 +08:00
DKChan 049544d1d7 docs(rules): registry 注销第一批——规则文本与闸脚本层改指真权威（AGENTS.md/五份规约/6 个 tools）＋架构文档补吸收 CJK 字体与呈现层订阅禁令两项 2026-10-19 19:50:44 +08:00
DKChan 1460cf9077 docs(收尾): 定名传导批补漏——22 文档版本历史行＋06 登记遗留三项 
补 42d64ec2／17ef0180 两笔漏掉的两件执行层：

一、版本历史行（22 个文档各一行，doc-conventions R4 与项目惯例要求每批改动落行）
  00 v1.4／01 v1.10／02 v1.28／03 v1.4／05 v1.5／08 v1.11／关卡节点地图 v1.9／
  冒险结构 v0.23／难度曲线 v0.30／战斗结算 v0.30／排雷玩法 v0.7／行动经济 v0.14／
  存档序列化 v1.10／教学引导 v0.6／元进度 v1.22／天赋树 v0.12／秘宝 v2.5／
  锻造工坊 v0.11／camp v1.6／settlement-summary v1.4／shop v1.2／术语表 v1.14
  （奇物.md 已于前批加 v3.20，不重复）

二、06 新建两条（pipeline_gate PASS：06 条目 63）
  「定名传导遗留二项」（来源=会话提及，设计面=文档轨）：
    ①增益状态.md 用「账」指战斗内状态容器——经用户确认与「系统资源」不是同一个
      东西，仅用词冲突；改名与否（候选：容器／状态池）与连带范围待用户裁
    ②art/ 两处＋entities.yaml 三处 GP 更名已在分支 gpsweep-20261019 改完但未合回
      master，合并归用户另会话，本批不代做
  「代码注释旧称二处」（来源=会话提及，设计面=工程直入，状态=待写卡）：
    adventure_table.gd:21/:24 注释仍写「资源类」；kind 字面是账名不是分类名，
    数据零改动，只改注释两处；按用户令等建需求卡片

坑：06 状态行写「金币分支」触发 doc_term（「金币」退役 2026-10-18，该行无日期
白名单信号）→ 改「GP 更名分支」；06 现状段引述退役词带日期信号，合规放行。

闸：worktree 内 run_all_gates.sh --docs 验收通过，对基线零新增红。
 2026-10-19 19:41:47 +08:00
DKChan 35439e2399 merge: 提案-效果引擎无状态化 用词对齐系统资源定名（文档域闸 b99a46be 全绿，零新增红） 2026-10-19 19:28:14 +08:00