game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,698 Commits 23 Branches 0 Tags
bdb09c5a3046f41aeb5fa169f79a20ffc8d73446
Commit Graph
493 Commits
Author SHA1 Message Date
DKChan 7aee5eb71a docs(流程文档迁出GDD批): 待办清单与体验验证清单移到仓库根并去掉编号前缀 
两文件是流水线流程件而非游戏描述件，此前住在 design/gdd/ 造成三处不适配：
gdd_lint 必须为它们逐条关掉体裁规则、格式权威却写在 doc-conventions §12、
与同族的 roadmap（在仓库根）分居两处。迁到根后按 roadmap.md 的无编号风格改名。

- 迁出：design/gdd/06-待办清单.md → 待办清单.md；07-体验验证清单.md → 体验验证清单.md
- 指向改写 53 个文件：GDD 各系统文档指路存根、四份规约、02 根索引、README/roadmap/AGENTS
- 两份清单自身 74 处出站链接按新基址重指（../art → design/art、systems → design/gdd/systems）
- gdd_lint：待办/体验验证两文件的 R1/R3/R5/R7 豁免行随迁删除（已脱离扫描面），后门表清零
- pipeline_gate 默认路径、log_analysis/render_gate 称谓、repo_structure_audit 根文件白名单同步
- 保护面补写：两份清单列入实现批禁写清单（AGENTS 两类批条 / process-conventions §12 / 架构文档域表），
  条目状态只由流水线各段推进
- 范围外未动（用户令「全不碰」）：reports/ 与 design/research/ 的 22 处历史指向、game/ 两处注释
 2026-10-21 00:09:40 +08:00
DKChan 811f988032 rules(规则审阅落地批): 十条评审意见落地——呈报四问/文件头缩窄/禁词表冻结/lean死条文退役/日期批注清除/AGENTS瘦身/分域闸口径/状态栏纯化 
- AGENTS.md: 呈报六问改读后自检四问；文件头红线删行数上限与白名单；日期批注清除；回执五况细则挪 process-conventions §3.10；流水线闸过时状态句改事实句
- process-conventions: §1.2 非迭代批改按改动域跑闸；§3.10 承接五况；两处日期批注清除；§2 表格凭据落点改现状清单
- code-conventions: §1.4.1 重写（删 8 行上限/两类白名单/90 文件清偿义务）；§2.1 联动；两处日期批注清除
- test-conventions: 三处日期批注清除（三处实证日期属证据保留）
- doc-conventions: §1 lean 死条文删除；§4 词表冻结条款；§12.1 重写（状态行只写状态词；现状=关联文档清单；删括号凭据全部条款）；三处日期批注清除；§5 重复词修复
- 术语表: 用语规范节加词表冻结句
- 06-待办清单: 11 条带括号状态行迁移（括号证据移入现状关联文档清单；待裁决说明并入现状；每条状态行只留状态词）
- tools/audit_file_headers.py: 删 R1 行数上限（R0 载体/R2 日期/R3 变更叙事保留）
- tools/gdd_lint.py: R2 表格占比判据与 R2_EXEMPT 整体退役（lean 解读对象已亡，只产存量噪音）
- tools/doc_term_audit.py: 词表冻结注释
- tools/pipeline_gate.py: 状态栏括号凭据核对废止，新增状态行禁括号判据（点名病因短路）；闭合证据改现状正文核对（卡片路径磁盘存在性+交叉核、文档路径+版本、art-bible+版本）
- game/tests/static_scan.sh: S10 注释同步

变异验证（test-conventions §6）：pipeline_gate 注入括号→状态行含括号内容红 exit1；删正文卡片路径→正文缺卡片路径+交叉核红 exit1；audit_file_headers 注入变更叙事→R2/R3 红 exit1、头注 12 行纯说明→0 红（上限停用实证）。坑册新增：未提交工作区禁 git checkout 变异还原（会连带回滚在途改动），须备份文件法。

全批净变化 +155/−146（12 文件）。
 2026-10-20 23:15:05 +08:00
DKChan f230bde1c3 docs(卡①失效避让陈述清账): 06 归属段与卡片三处（契约 10／不做表行／停机条件 5）删去「changelog-retire-20261019 在盘未合回」避让前提（该批已于 c5200b6b 入 master，前提失效），约束本体保留并改挂流水线红线依据（迭代批禁写 design/ 与根规则文件）；顺带把旧目录 design/dev/ 三处写法改为 design/engineering/ 2026-10-20 20:02:20 +08:00
DKChan bd0ad0e441 docs(迭代 32 编排): 效果引擎无状态化批编入迭代 32——roadmap 行卡片列追加为第二执行序、预计周期 ≈0.5 周改 ≈1.75 周、当前位迭代位同步两卡；06 条目状态末尾追加「已编迭代 32」（累积段保留）；卡片「不做」表补两行：当前位归编排段维护、与卡①禁并行开工（同改三文件注释面） 2026-10-20 19:25:09 +08:00
DKChan 44e5743d8a fix(06 死链): 代码注释禁用词清扫批条目归属行的旧目录路径 design/dev/ → design/engineering/（07 doc_link 严格档死链归零） 2026-10-20 19:23:20 +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 76825590c2 docs(iter31 反哺点落文): 术语表补 seal_* 契约键与效果词条；奇物完美保险落表指向与豁免账；07 ㉙ 七项目检；美术件名 seal_mark 与规约守卫例外条款；06 新增玩家面残留禁字候选 
- 术语表：封印行补代码契约键 seal_*（原 flag_* 全族换代）与单字字形「封」；新增 seal_missed／forgive_seal_miss 词条；退役词表加 flag_*→seal_*；用语规范 B 类补第 4 条「被检查的禁字不算使用」与复扫口径
- 奇物.md：v3.18 件表注③「归独立批」指向改指迭代 31 卡②合回 commit 3e076e22；§1.3 补完美资格豁免走订阅式自有累加账
- 07：新增 ㉙ 节七个目检项（GP 显示、封印字样、结算来源名、seal_mark.png 加载、完美保险文案、稀有档三选一、豁免后第二份额）
- interaction-patterns：perfect_broken 判据句读作「首次标错受检」（B=乙，代码零动）
- art-bible v3.16／asset-path-map：封印印记件名 flag_seal.png → seal_mark.png，补 32×32 规格
- 06：新增「玩家面残留禁字清扫」候选条目（来源=批次移交，设计面=工程直入）
 2026-10-20 15:27:25 +08:00
DKChan ca86d18811 fix(06): 阔视野带新条去掉退役词「随批」——改「在这次收尾中退役」（08 doc_term 新红修正） 2026-10-20 15:08:38 +08:00
DKChan 893aac795f chore(批后收尾): 迭代 30 产出物退役——实现报告/代拍板追认单/反哺点清单三份按吸收即死删除（反哺点七条已于 2026-10-17 全部回写并复核落文、7 项代拍板已追认、07 ㉘ 五项实机目检在册、.uid 卫生缺口已随后续批闭合）；报告 §六-1 阔视野带表述冲突迁 06 新条（秘宝表与 treasure_items.tres desc 仍写「类型微光 8→12 格」，与 HUD框架「微光不随视野扩」冲突，待数据文本订正）；存档制卡片 F8 的基线读数指路改内联＋commit 7ffd1dc0；roadmap 迭代 30 行实现报告列改退役保留字 2026-10-20 15:08:18 +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 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 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 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 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 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 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 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 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 d54cbed7a5 docs(registry): 注销 design/registry 两处 yaml——GDD 现在时指针 76 处改指真权威＋地形变异/存档序列化/数据配置等同批换代＋iter31 反哺点 §三 registry 节删除＋doc_term 登记 registry 退役词 --strict 零疑似现行 2026-10-19 19:57:00 +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 17ef0180af docs(术语): 系统资源定名向各系统文档传导——复述改指路＋旧称换代（22 文件） 
承接 42d64ec2（定义源定稿）。按 concept-conventions §2「单点定义＋引用不转述」：
不做全库换词，只处理两类——**复述概念定义处改成「规范名＋指路 01-核心循环」**、
**用旧称处换成规范名**。共 141 处，22 文件 129+/129−。

  行动经济：定义句「这本账」→ 行动点这一笔系统资源；表行「行动点账本」→
    行动点（当前池）；「AP 分两本账」→ 行动点分两笔；扣费入口表述统一
  秘宝：「存量账+临时账两本账」→ 存量＋临时两笔；三处表头「写哪本账」→
    「写哪笔系统资源」；「各周期账本独立」→ 系统资源独立
  冒险结构：「生命账本／GP 冒险账本」表行与节标题 →「生命／GP」；GP 节标题
    改「### GP：…」，全库指路「GP 冒险账本」节同步改「GP」节（元进度／战斗结算／
    难度曲线／shop.md／01-核心循环）
  元进度：「独立资源口径…两条平行独立资源」→「系统资源口径…两条平行独立的
    系统资源」；钥石表行改「钥石（存档级）」
  排雷玩法／战斗结算／存档序列化／难度曲线／天赋树／关卡节点地图／锻造工坊／
    教学引导／ux(camp,shop,settlement-summary)／00／03／05／08：同上两类处理
  术语表＋奇物.md：「时沙挂账」→「时沙暂记」（与 01 定义用词一致）

显式不动（有依据）：
  「入账／不进账／到账」＝写入动作义（用户 2026-10-19 明示不改）；
  「结账时机双模式／地图账」＝战斗结算自有结构概念（2026-10-06 用户裁）；
  「同调段账本／充能账」＝秘宝内部计数器；「随机账」＝关卡节点图生成的工程比喻；
  「资源不足／资源面／点阵资源显示」＝UI pattern 既有名（resource_face，牵动探针断言）；
  「账号」非账本；地图战斗资源／格面资源语义；06/07 登记处（用户定不改）；
  art 域「金币」（用户另会话处理，分支 gpsweep-20261019）；版本历史行一律不改字面。

信息守恒：7 文件关键属性抽查全在位（守恒检查 5/5、6/6、5/5、4/4、4/4、4/4、3/4——
shop 的「不算价」系检查项笔误，原文为「不算账」已改为「不作计算」）。
闸：worktree 内 run_all_gates.sh --docs 验收通过，对基线零新增红。
 2026-10-19 19:11:19 +08:00
DKChan 42d64ec2d5 docs(术语): 定名批——「系统资源」立规范名＋奇物第三类改名「补给」（用户裁） 
依据：用户 2026-10-19 两项裁定——①GP／AP／钥石／RAP／刷新／生命／充能等
「战斗数值以外的数值资源」统一叫「系统资源」；②奇物第三分类原「资源」改名
「补给」，且**补给才是转换源**（给系统资源加一笔的一次性凭证，不是资源本身）。

动机：原类名与游戏内资源同词，读者会把"给系统资源加一笔的件"误读成
"系统资源本身"；且旧称「账／账本」「独立资源」「系统数值」三个 Agent 词
并存互不相通（2026-10-19 考古：均无用户裁断记录，最早见于 d79afd22／
6e054466），是全库歧义根。

做法（按 concept-conventions §2 单点定义＋引用不转述，非全库换词）：
  01-核心循环：小节「两条独立资源」→「系统资源」，立唯一定义（成员带寿命档
    标注＋总线/抽屉两坐标＋保留「GP 与钥石平行独立、不立统一上位概念」原裁
    论断＋显式排除增益容器）；总线/抽屉/一次性结算/五档表/指针节同步换代
  奇物.md：§1.3 标题与判据句、§1.4、分类表、交叉表、凭证件表、异质性节
    换代为「补给」；§1.5 保留命名沿革并记改名理由；新增 v3.20 版本行
  术语表：节名「资源与经济」→「系统资源与经济」；新增「系统资源」「补给」
    词条；AP 词条去「次数资源」
  entities.yaml：curio categories/hierarchy/acquisition 按 owner（奇物.md）
    同步；kind 字面是账名非分类名，代码零改动
  02-系统清单：奇物行换代
  历史行 v2.5／v3.2 不改字面，行尾追加更正注（v3.2 的「五件新凭证用户裁准」
    失实记载同批注明）

信息守恒：34/34 项原文属性/清单/档位/指路逐项核对保留（脚本核对＋人工复核）。
闸：worktree 内 run_all_gates.sh --docs 验收通过，对基线零新增红
（doc_term 一度报「充能」疑似现行——按闸内上下文白名单改为「主动件充能」，
与术语表 :47 词条口径一致，非操纵闸门）。

不在本批：06/07 登记处、art 域「金币」（用户另会话处理）、增益状态「账」
（待用户确认）、在役草案（待另一会话审查结果）、其余 12 系统文档与 ux/ 的
复述处（定义源定稿后按纪律逐处改指路）。
 2026-10-19 18:52:57 +08:00
DKChan 0fbabd26fa docs(奇物): 专长凭证归类误记载订正批——三处改写为渠道兑付形态＋依赖指针改指 §1.4 
依据：用户 2026-10-18 表态不认同「凭证归专长」归类，2026-10-19 定性为写文档时的误记并令改。

证据（git 溯源）：归类陈述引入与后续两次改写的三笔提交
  d6c13809（原句，当时文件名为 奖励.md；「用户明确」小节仅覆盖机制：非 Boss
    渠道给门票、拿到即开、不可囤积、一局限购、计步保底）
  b6b43ebc（v2.7 子节点定名批，改写归类措辞；该批用户输入＝三个分类去「类」字后缀）
  6951632d（2026-10-11 术语批，门票→专长凭证）
三笔分别只承载机制、定名、更名，无一处含归类裁断记录；后续 2026-10-18 凭证件
裁削批反而把它当依据引用一次（奇物.md:125 与 v3.18 行「见 §1.1 判据」）。

改动：
  奇物.md:209（1.1）／:295（2.2）／entities.yaml:629 —— 三处改写为「专长在非 Boss
    渠道的兑付形态」，不再对凭证作归类论断
  奇物.md:125、v3.18 行 —— 完美保险改归专长的依据指针 §1.1 → §1.4（归属结论不动）
  奇物.md:469（v2.2 行）—— 不改字面，行尾追加更正注记指向 v3.19
  奇物.md 新增 v3.19 版本行 —— 记全案与溯源
  06-待办清单 冒记案条目 —— 拆为 ①已解决（凭据＝奇物.md v3.19）②待裁决

机制零改动：非 Boss 渠道仍只给凭证、拿到即开、不可囤积、一局限购与计步保底全部
不变，交叉表专长行仍记「凭证形式」。纯文档批，代码与数值零改动。

闸：文档域 run_all_gates.sh --docs 验收通过，对基线零新增红（worktree 内实测）。
未处理（非本批，等用户发令）：奇物.md:480 v3.2 版本行同源失实句；entities.yaml:629
退役词「门票」×2 与 :626 成员名单陈旧；第 2 项（§1.3 资源判据句）待心智模型对齐后裁。
 2026-10-19 07:30:17 +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 04014c0164 docs(术语): 术语刷新补扫批——组一定性条目＋组二正文漏网＋组三批名全换代（2026-10-18 用户三裁） 
- 组一定性条目八处：registry「封印」条由「插旗的呈现名/纯呈现层命名」改判正式动作名（全库统一）、「金币（GP）」条键名更名 GP＋删「玩家侧显示名『金币』」、battle.md:128 呈现术语注记同判（占位字形目标改「封」、注明现行代码旧字形随代码批换代）、显示名「金币」四处（关卡节点地图/难度曲线/元进度/秘宝 GP 付费档）＋level-map 金币图标＋05:13 旗做道具行（与 08:186 同条目两半的一致性补齐）
- 组二正文漏网约 110 行/21 文件：旗生命周期节正文与结局表、行动经济价目表封印行/资格条款/条款2 封印标中锚/δ 系数/η 分母、战斗结算极性矩阵句/四情况标题/标中资格段/完美排雷句/事件面/验收清单、增益状态标空封印行与来源列、地图战斗资源九型字典 gp 行（gloss 金币→财货，随 art-bible 既有口径）、奇物跨族桥/凭证件表、07 各观测条、06 两条现状行、battle 布局/输入映射/演出/光标语义、entities.yaml 约 30 行现行条目（flag_rules/标中旗→封印标中/连锁不越封印条键/display_name/链不越封印等）＋正文雷格五处补扫（#注释留痕保留）
- 组三批名全换代：插旗不可逆批/插旗不可逆四情况→封印不可逆（全库含 07/行动经济/结算/排雷玩法/地形变异/教学/entities，122/126 不一致抹平）、标中旗锚→封印标中锚、拔旗动作退役→移除动作退役
- 有意保留：术语表对照行、06:546 裁定引文、用户原话引举（07:80「不能挖旗格」/07:28 旧预期列）、更名记载（排雷玩法:10）、原「口袋旗」「拔旗重插」对照引用、旗朱色彩沿革链（2026-09-28 人设脱钩裁定的在役概念，组四用户裁保留）、battle:402/403 历史落稿留痕清单、entities # 注释留痕两处、代码键名（flag_* 归代码批）；美术（design/art/）零触碰
- 自检：doc_term_audit --strict 零疑似现行（378 命中全留档类）；gdd_lint 10 文件零不通过；doc_link 死链 0；正文残留终审仅余上述有意保留项
 2026-10-18 23:55:15 +08:00
DKChan 9ebd2a6430 merge: 卫生批入库（分支 hygiene-20261018 尖 53ad8c9e）——architecture 闸域表与 roadmap 重闸步的触发路径口径对齐机器（代码域唯一触发＝game/，7bdf53e3 漏改两处）；删退役仪表盘 tools/loop_dashboard.py（529 行，其独有的版本落后比对按现存格式重立为 doc-consistency-check 第 10 项）＋tools/path_check.py 去掉失效跳过项；06 登记 L3 屏壳探针被共享存档断点污染一条（工程直入·待写卡，判据三条在内）＋配比预设条凭据版本复核注记；baseline.json 的 08b 记录本批不动（删它要触 game/ 且会撞上那两道假红），归该修复批顺带清。文档域五闸零新增红，回执=53ad8c9e。 2026-10-18 20:20:16 +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 53ad8c9e0b Merge branch 'master' into hygiene-20261018 
# Conflicts:
#	design/gdd/06-待办清单.md
 2026-10-18 20:14:02 +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 8833943e12 docs(06): 登记 L3 屏壳探针被存档断点污染一条（工程直入·待写卡）＋配比预设条凭据版本复核注记——前者根因链完整（main.gd:476-482 有断点即弹确认框并返回 / 探针第④步假设无断点 / 移开 save 立刻全绿 / 主区同代码同红 / game 代码自 7ffd1dc0 零改动），后者核到元进度.md v1.16 与 v1.18 仅追加说明未推翻通道结论，故 v1.0 凭据按历史记载保留不改号 2026-10-18 17:14:26 +08:00
DKChan 807256851e docs(06): M4 数值欠账归属裁定落文件——留 06、未设计未启动、不另行归属（2026-10-18 用户裁）：五条统一缺口换代＋天赋树欠账/GP 换算/调参点评/成长系数/三选一刷新五处挂 M4 措辞改未来数值标定窗口＋三处归属字段同步 2026-10-18 08:05:59 +08:00
DKChan 44b900dad0 docs(06): 撤下「九条存疑待抽查」一条——并行会话 rulings-fix（f1e47e64/2121af42）已由用户逐条裁完毕，两孤儿点删除、七条维持现行判法，义务已清偿故不迁留（本条原拟自废止的会话状态文件未决面迁入，主区合回时该裁决尚未见诸 06，属信息时差） 2026-10-18 07:33:03 +08:00
DKChan b8dbb7f046 Merge branch 'master' into active-purge-20261018 2026-10-18 07:30:15 +08:00
DKChan 27812167ef refactor(状态规矩): 废除根目录会话状态文件 active.md 与全套执法件（2026-10-18 用户裁） 
判据（对 869 个 ZCode 会话与 16 个 Qoder 会话的读写统计）：active.md 被整文件读 448 次、
单次中位数 14 KB、累计 6.09 MB 进上下文，311/320 个碰它的会话把它当第一个工具调用读；
但 7311 个提及它的思考片段的语境分布是——写入与编号簿记 327 个会话、并行冲突与避让 234 个、
退役与失真核对 162 个，而明确写「从它所载内容得知某事实」的只有 20 个会话。
逐条核 41 个条目：独特且现行 2 条（另 3 个子句）、别处已有权威源 14 条、陈旧或自相矛盾 7 条、
已完结批次的历史叙述 18 条；按字节约 95% 属后三类。失实样本：architecture 版本记 v1.6 实为 v1.8、
规则文件数记 7 份实为 6 份、迭代 27/28 记「位预留追加卡」而 roadmap 记已完成、三个已删 worktree
仍记「在盘待删」、同一条既宣称「文档禁列闸清单」又自行列出 01–11 全套闸。
执法件已建一轮仍拦不住：08b 体量闸只测条目数/行数/编号/死链，测不出语义失真；钩子不随仓库传播，
只有 ZCode 在跑；10-15 清到 8.6 KB、10-17 回到 40 KB，用户为「只写不删」连续三次发火。

改动面：
- 删 active.md 与 tools/audit_active_state.py；run_all_gates.sh 摘除 08b 闸件与头注、
  baseline.json 删 08b 记录（现存 12 闸）、repo_structure_audit.py 根文件白名单去 active.md
- doc-conventions §10 改写为「仓库根不设状态文件」并留裁决与判据（保持 §11/§12 编号不漂）；
  §11 表两行去状态文件口径；§4 适用范围去 active.md
- process-conventions §1 第 2/3 条（合回前查尾号防撞号、豁免面）、§3 第 12 条（批次完成后的
  登记义务）、§6 分级周期口径（闸件清单不再在文档重列）四处换代
- code-conventions「实现批收尾双登记」改为单登记；CLAUDE.md 目录节、规范导航行、worktree 豁免
  行三处换代，红线新增「仓库根禁止设会话状态文件」一条
- roadmap.md 顶部新增「当前位」三行（阶段／迭代位／下一步）接替原快照职责，头注、执行纪律第 3 条、
  loop 规范第 8 条、维护纪律四处改指 06 与本文；reports/README.md 与 sim-data/README.md 两处
  现行指路改口；architecture.md 文档域闸表行去 active.md 体量闸与触发路径
- 06-待办清单迁入七条真残值（原仅载于该文件）：卡片入库纪律悬空待办、req-card 两副本取齐、
  魔法道具与罕见残留（实数 23/17 处，旧记约 30/18）、通关口径统一（gdd 内 188 处，旧记 273）、
  黑话第二波待发令、数据整改批九条存疑待抽查（该批未提交面所载）、发布前删除 main.gd:196 调试
  入口写死行（工程直入·待写卡）

harness 侧另批处理（.zcode/ 与用户级技能不入 git）：session-snapshot.sh 与 config.json 注册、
worktree-guard.sh 的 active.md 豁免白名单、active-closing 技能、doc-consistency-check 第 8/9 项、
iter 与 req-card 技能里的「唯一例外=active.md」与查尾号条款。
 2026-10-18 07:28:48 +08:00
DKChan f1e47e6436 docs(06): 九条存疑裁决落文件——删迭代 30 剔除登记条（三份重复剔一部）＋删奇物呈现备忘两孤儿点（两点均已被正式条目承接，指认句两处清偿）；其余七条维持现行判法（2026-10-18 用户逐条裁） 2026-10-18 07:26:40 +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 bbd49abfb0 docs(术语): 设计文档术语刷新批全量入库——2026-10-18 用户裁定（金币/插旗/旗/雷格/惩罚格 五词）design/+tools/ 域落文 
- 术语表 v1.13：GP 唯一正式命名（删「局内金币」别名）＋旗/控制词条更名封印/控制＋封印定性由「插旗的对外表达」更正为正式动作名（全库统一、非比喻）＋禁用字面从对外命名扩为全库＋删「机制文档内部用语不受限」条款＋退役词对照表补三行（金币→GP/插旗→封印/旗→封印印记）＋危险格词条「被旗控制」→「被封印控制」＋B3 豁免例举去旗
- 机检扩容 tools/doc_term_audit.py：RETIRED_TERMS 新增 金币→GP、插旗|标旗→封印 两行（DEFAULT_DIRS 不变，game/ 扫描归代码批）；拔旗|撤旗行继任措辞随批换代（插旗不可逆→封印不可逆）
- GDD 全域正文换代约 200 行/31 文件：金币→GP（金币袋→GP 袋）、插旗/标旗→封印、雷格/惩罚格→危险格（2026-10-11 退役批存量补扫）、旗概念→封印印记（旗判定→封印判定/标中旗→封印标中/标错旗→标错封印/旗格→封印格/旗位→封印位等复合词系）；00-游戏概念「封印降级为类型风味词」定性翻转；修订记录/版本历史/禁令引举/更名记载等留档行零动
- registry/entities.yaml（信标网络可达性/事件序/回执驱动三处）＋art 五件（art-bible 封印印记六处/comfyui 背旗→背负封印印记/两清单）＋dev 七件（architecture 旗集→封印集/code-conventions-cases/test-conventions/架构图 html json 四件）随批换代
- tools 四脚本注释与图内标注换代（clear_dominance_audit/render_sample_sheet×2/analyze_playtest；代码标识符零动归代码批）
- design/qa/代码术语审计报告-2026-10-18.md 随批入库（本批参考素材，06:578 引用闭合 doc_link 死链）
- 06-待办清单/术语表两在途脏件（代码术语批 06 登记＋A 表头「不用→禁用」）随批一并入库

自检：doc_term_audit --strict 零疑似现行（45 文件 434 命中全留档类）；文档域六闸验收通过无新增红（gdd_lint R3 对 00 正文修订注记一次打回已去注记化改写；doc_link 死链经报告入库闭合）；正文残留仅 06:73「拔旗」一处（件派生动词白名单豁免语境、机检同款豁免，设计意图记录不动）
 2026-10-18 06:15:38 +08:00