game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,897 Commits 23 Branches 0 Tags
98c61d50c3c07f2e15b94de48d4fcb9ea3466f63
Commit Graph
524 Commits
Author SHA1 Message Date
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
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 865eaa3030 fix(06): M4 五条欠账状态纠正——已写卡引用已退役卡片（2026-10-16 删卡令），退回待文档设计＋缺口注明重新归属待用户裁；主区闸实跑暴露（worktree 文件未删致假绿），闸首日即拦下真不一致 2026-10-18 05:22:15 +08:00
DKChan 8f66ae1559 docs(roadmap): roadmap 压成「里程碑时间线＋迭代总表」＋流水线闸注册上电 08c——删除「当前位置」节与主路线表全部巨型行（各迭代过程叙述/T 段明细/读数/闸数字/裁决记录退役归 git 史，116→89 行），新建六列迭代总表 30 行一行一迭代（状态=已完成＋落地日期自「✅ 完成/已入库」句提取，迭代 17 任务书日期与文本冲突从文本=2026-10-07；需求卡片列 design/research 实存十卡写实路径、卡片已退役十一迭代写保留字、迭代 1~8/10 无卡片制填「—」；编入时间 9~12/14~30 从文本与编入提交可考取真、其余「—」；预计周期历史行全「—」不做 ≤2 周判；实现报告 iter27/28/29/30 写 reports/ 实存路径、其余二十六迭代写退役保留字），M3/M4 里程碑语义立规注（2026-10-09 用户立规）压缩三行后置于里程碑时间线表后语义全保留，执行纪律/批次 loop 规范/维护纪律三节原样保留（含未迁 process-conventions 的迭代粒度界定等立规），执行纪律第 3 条「当前位置挂起清单」指针随节删除改指 active.md 未决面；pipeline_gate.py 机检扩容对齐新表（需求卡片/编入时间/预计周期三列「—」合法=历史行豁免＋实现报告列已完成=存在路径或退役保留字、对「—」维持判红，头注旧格式声明换代），doc-conventions §12.2 四列规则同步补「历史迭代不可考填—」与已完成报告列严格句；run_all_gates.sh 文档域 08b 之后注册「08c 流水线闸」（照抄相邻行形态，闸序其余零改动）＋头注 --docs 闸清单补 08c＋域横幅 6–8c；baseline.json 手工加入 08c 绿记录（新闸件无基线记录必判闸况变化拦合回收执，其余条目原样保留）；06 修存量退役词四笔「随批呈报→顺带呈报」（b4671802 回填批带入、doc_term --strict 首次全量跑暴露，非本批引入）。自检：python tools/pipeline_gate.py=PASS（06 条目 51·总表数据行 30·交叉核 0 链全过）exit 0；bash tools/run_all_gates.sh --docs=六闸全绿无新增红 exit 0 2026-10-18 05:15:32 +08:00
DKChan b4671802aa docs(06): 待办清单存量条目全量回填 §12.1 新格式——73 条逐一处置：改写 51 条（标题=登记日期＋来源四选一＋设计面五选一，正文=现状/缺口/归属/状态四属性；M4 数值批五条统一「文档设计已闭合（卡 v1.2）＋已写卡」累积态，配比预设冻结挂起记已写卡（备选），工程直入类记待写卡，备选/触发条件类加（备选）后缀，二三关棋盘观感/美术链路 P0/迭代 30 剔除登记用双轨并列段，教学五条与敌人系统四条补缺口属性；六条无日期条目按可考日期或 2026-10-18 补登）；删除 22 条（13 条批次已完成＋6 条反哺点已写入＋解锁界面残余/闸分域代拍板/文档闸欠账 3 条义务已清——落点逐条核实：art-bible v3.14 §4.1/§7.6/§8.2、锻造工坊 v0.5-v0.7、元进度 v1.18、敌人系统 v0.18、难度曲线与Boss v0.29、registry 祝福条目、architecture 装配合同与存活性矩阵节、code-conventions §4 第 9-11 条、test-conventions §7-§8、07 ㉔-㉘、reports/ 三份实现报告、gdd_lint 三件 PASS 与 doc_link 零死链复跑）；文件头引言改两句（登记处定性＋doc-conventions §12.1 权威指针，§5 单一事实源）；分组分节与条目顺序零变动；流水线闸 06 部分零红（PASS：06 条目 51；roadmap 旧格式红属下一批整改面） 2026-10-18 04:56:18 +08:00
DKChan 9a335cb305 docs(08): 混编遭遇第二批裁挂 Beta v1.10（2026-10-18 用户令「挂 beta 吧，不需要再进行讨论了」）——未决项六项减五项（第 4 行删除、5/6 重编号）、二·内容量混编行现状注改写（裁决细节入版本历史，单元格保持净态）、文头状态行 v1.9→v1.10；零代码零内容变更，Boss 多行投放连同 MC 取证与数值统标一系移交 Beta 阶段再议。三闸全绿（gdd_lint 0 不通过/doc_link 死链 0/doc_term 疑似现行 0） 2026-10-18 01:33:36 +08:00
DKChan a185077759 docs(迭代30): 卡②③剔除——战斗一屏样张与二三关棋盘观感移 06 状态「待设计」（2026-10-17 用户令，零回滚）——用户裁定两卡本质为设计澄清/美术定稿环节、无现成素材可消费，不满足「迭代=代码实现批」开发条件；卡①经质量复查裁「没有问题」保留零回滚。roadmap 三处换代（迭代 30 表行改单卡①＋剔除注／迭代进度行／近期主战场行）；06 新登待设计条两卡分列（前置=设计讨论→需求澄清→美术定稿，v1.4 原卡留 design/research 作素材）；active.md 快照/已裁在册/待发令/在盘待删四处换代＋状态记录 513。文档域闸零新增红 2026-10-17 20:24:40 +08:00
DKChan b1df21b471 merge master into iter30-fb-20261017——并入线头收编批（art-standee 合入＋doc-adr-fixes 判废删除）与 06 用语换代批 
active.md 解冲突一处：快照两行取 master 版＋本批文档批从句；状态记录
511 撞号（master 线头收编批已占 511），本批文档批按 iter29 先例改
512；未决面追认行表述修正（iter30 追认单为独立文件、不计入「实现
报告的追认单节」）＋在途分支行在盘待删清单增记 g-plan2-iter30-fb。

06/art-bible/battle.md/tools/research 均为 master 侧改动自动合并：
徽章条与两带统一条、战斗区背景图替换条、v3.15 与 §8.2/§8.3 修正
共存无互踩。合并后 --docs 五闸全绿零新增红。
 2026-10-17 17:44:38 +08:00
DKChan 34f3cdb36d docs(iter30-fb): 迭代 30 卡① 文档批——代拍板七项追认＋反哺点七条回写 
用户令「追认没有问题;反哺点可以都进行回写」两项一波走完（文档批，
不占迭代号，分支 iter30-fb-20261017，基于 master 0a164958）。

追认：
- reports/iter30-代拍板追认单-2026-10-17.md 文末加追认结果行——§9
  白名单 7 项全部同意。

反哺点七条全部回写：
- 06-待办清单：徽章条状态待办→已完成（入库 7ffd1dc0、冒烟 1151/0、
  单测 34 套、探针 case⑰、07 ㉘ 人闸五项）；色相措辞修正为「样张
  v2 冻结既裁值，本批只动明度」；2026-10-05 实查读数刷新
  （bonus_pick_overlay.gd 已改名 curio_pick_overlay.gd:97、TG_* 五族
  在役 ui_kit.gd:49-53、裸 Color8 读数作废）；新增「卡顶色带与格面
  微光两带统一」待办条（Q3 甲案）。
- HUD框架：实装状态行转「已实装（迭代 30 卡① 2026-10-17 入库，
  合并 7ffd1dc0）」；验收行转正式验收；版本历史 v0.19；口径史注记
  后补两带分工注记（卡顶带=条目级静态色带／格面微光=棋盘格内动态
  微光，禁互为引用）。
- 08-Alpha版本标准：「五 · 表现」表新增「未开格类型微光（五组色相＋
  明度档）」行（在役；明度档 provisional 值，样张批复核转正）；
  版本历史 v1.9；文头状态行 v1.8→v1.9。
- art-bible：五组明度档 provisional 值（芥末黄 #F7DF43／黄绿 #68D042／
  青 #30A6A6／紫罗兰 #7B5BD6／绯红 #A61D37＝冻结 #FF2D55 的 V=0.65
  档，五组 ΔH ≤0.13° 色相零移动）＋生成口径（渲染合成空间伽马阶梯、
  相邻组模型 CR 1.245/1.234/1.239/1.270、判据线 1.20、实测最弱对
  1.232、群伤暗档停机呈报留痕）落版本历史 v3.15；§4.2/§4.6.3 权威面
  零改动、§2.1 未追加（Q5 甲案静态）；头注「现行为」v3.11→v3.15
  漏更订正。
- roadmap：迭代进度行、近期主战场行与迭代 30 表行状态列同步卡①已
  入库（②③待 /iter 发令）。
- 07-体验验证清单：新增 ㉘ 节五项人闸（五组一眼可分／不遮数字
  〔环不外溢〕／出圈灭入圈复亮／整屏不脏／群伤暗档 #A61D37 观感
  〔provisional，读数归样张批〕）；版本历史 v1.5。
- reports/iter30-反哺点-2026-10-17.md 加「回写结果」节逐条标已回写。
- active.md：快照「更新于」行追加文档批从句；未决面待用户追认行补
  iter30 七项已同意；追加状态记录 511。

验收：文档域闸 tools/run_all_gates.sh --docs 五闸（06 gdd_lint／07
doc_link／08 doc_term／08b active.md 体量／10 熵增）全绿，闸况与
基线一致无新增红，回执 commit=分支尖。

遗留：卡②③待 /iter 发令；07 ㉘ 实机目检五项待用户过目；群伤暗档
provisional 待样张批转正；g-plan2-iter30-fb 工作区待合回后清理。
 2026-10-17 17:40:29 +08:00
DKChan 4203d6bea3 docs(06): 战斗区背景图替换条用语换代——随批→顺带两处（闸 08 doc_term 抓出；该条 10-07 成文于退役替换之前、从未落 master 故漏扫）；熵增闸面清理：_tmp_standee_new 已抢救至主区 artwork/archive 后删除 2026-10-17 17:34:19 +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 9a7dfcf619 docs(追认): 迭代 27/28/29 代拍板追认单落状态——2026-10-17 用户令「追认单的所有我都是同意的」，40 项全部同意（27 十五项／28 十三项含四条白名单外／29 十二项），三份实现报告追认单节各加追认结果行；iter28 第 14 项只认本批动作、「req-card 双副本是否取齐」维持待裁；06 闸分域批条①②改判已追认、③迁位欠账补计 iter29 报告（原条漏计）；roadmap 迭代进度行三处「追认单待用户」换代为已追认 2026-10-17 05:38:09 +08:00
DKChan b27e4710b6 feat(闸): 验证闸按改动域分跑 + 迭代批禁写 design/ + 新建 reports/ 收实现批产出物 
用户裁定（2026-10-17）五条：①代码批只跑代码闸、文档批只跑文档闸；②迭代批是代码实现批，
禁写 design/，文档只读、是实现批写测试与代码的输入依据；③迭代实现报告不写在 design/ 内；
④不设文档编写 skill——文档由用户在会话中讨论后落地；⑤本批属工具/规则面，不占迭代号。

一、tools/run_all_gates.sh（域划分唯一出处）
- 新增 `--code`（01 冒烟/02 单元/03 探针 --click/04 探针 --full/05 渲染闸/09 静态扫描/11 回放对拍）
  与 `--docs`（06 gdd_lint/07 doc_link/08 doc_term/08b active.md 体量）；10 熵增闸两域都含
  （文档批新增或挪动 .md 同样会绊它，且纯文本秒级）；不带参数＝全量，改闸件本身或跨两域时用。
- 域外闸不入 NAMES，不产生假变化；同时修「基线绿 → 现 SKIP」被误判为闸况变化（--quick 回执
  此前永远自带三条假红）。
- 回执增 domain 与 not_run 字段。
- 导出 PYTHONIOENCODING=utf-8：GBK 控制台下 06/10 两闸打印 ✅/✗ 直接崩（假红）、09 的 FAIL 行
  写成乱码字节致指纹漂移（假「红项清单变化」）、末尾汇总自身崩打不出结论——2026-10-16 实踩。
- 新增代码域素材齐盘预检：game/assets/art/** 与一切 *.import 边车都不入 git（2026-09-29 裁定），
  worktree 冷检出必空盘 → main_theme.tres 解析失败 → 冒烟 V1 七项假红。缺位即拒跑并列缺哪件，
  附处置命令（cp 主区素材 + --editor --quit 刷导入；--import 不生成新素材边车）。

二、tools/render_gate.sh（空跑判绿改判红）
- 棋盘/菜单两段 golden 在素材缺位时原为 SKIP，而闸末照样打印「全绿」exit 0——一个像素都没比
  却报通过。2026-10-16 菜单废基线事故正是靠这个信号盲区混过 worktree 自检的。现改判红。

三、reports/ 新顶层目录（实现批唯一可写目录）
- 收迭代实现报告/代拍板追认单/GDD 反哺点清单；repo_structure_audit.py TOP_DIRS 与 CLAUDE.md
  Project Layout 两处白名单同批改齐（熵增闸自陈的强制口径）；reports/README.md 立范围与生命周期。

四、规则文本五处同步
- CLAUDE.md：验收口径改按域；硬性红线新增「两类批」条（迭代批禁写 design/ 与根规则文件、
  产出只落 reports/、只跑代码域闸；非迭代批不占迭代号）；Project Layout 登记 reports/。
- process-conventions：§3.10 批末按域验收；§3.12 补 active.md 例外（会话状态唯一源，钩子本就
  豁免）；§3.13 重写为「实现批禁写文档、产出物落 reports/、反哺点由文档批裁决后写入」；
  §4 分级周期口径改三档；§2 三段流程「三·实现」行加禁写面。
- doc-conventions 载体分工表：迭代实现报告落位由 design/qa/ 改 reports/。
- architecture.md「测试与质量域」：新增「改动域划分」节（域表＋唯一出处声明＋素材预检缘由），
  本表是现状登记非第二份清单。
- 06-待办清单：登记本批两处代拍板（active.md 例外读法、reports/ 新顶层目录）与旧实现报告
  iter27/iter28 两份仍在 design/qa/ 未迁位的欠账。

五、连带（不在本仓库，gitignored 本地 harness 配置）
- .zcode/hooks/worktree-guard.sh：合回校验由「不碰 game/ 即全免」改为按 diff 路径推定所需域、
  要求回执 domain 覆盖之；未登记路径按最严处理，禁默认放行。旧豁免的漏洞：改闸件本身反而零验证。
- ~/.zcode/skills/iter/SKILL.md：顶部加批性质与闸域两条强制声明；批末重闸移出 doc 三闸；
  总收口产出物改落 reports/、roadmap 换代移出本批；定义面入库注明是搬运非撰写。

验证：--docs 域全绿（06 由基线红改善为绿，因 fcb8c3f8 已补 01 篇流程图）；素材预检反例实测
（移走 button_stone.png → 拒跑 exit 1，还原后正常）；渲染闸缺盘反例实测（exit 1 并报 FAIL）；
--code --docs 互斥与非法参数 exit 2；guard 内嵌 python 编译通过并按 docs 域回执放行 docs 批。
 2026-10-17 00:40:53 +08:00
DKChan fcb8c3f843 docs(gdd): 01 篇「一场战斗的流程」节补轮次流程图——06 闸 gdd_lint R5 红灯结案 
根因：9846a29f 把节标题从「一场战斗：扫雷的因，战斗的果」改为「一场战斗的流程」，R5 按节名含
「流程」触发，该节内容自始无代码块图——改名即造红，非本批引入亦非内容缺失（272cc1ad 提交说明已
自陈系并行会话既有问题并另报）。

改法：按 R5 意图补图而非改节名规避（节确为流程描述，图属应有内容）。流程图内容取自本节四条编号
步骤与实现事实源逐条对齐：轮末判定优先级先判 hero 再判敌人（verdict_segment.gd:18-21 三裁定
defeat/victory/continue）、清图轮发清图奖励后换图、未清图同图续挖（battle_orchestrator.gd:1068
cleared 轮恒走 new_board）。轮内刷新与清图奖励的守卫规则归行动经济权威面，本图不复述以免双载体。

验证：gdd_lint 本文件 PASS（0 不通过，表格占比 43%／最长括号跨度 33 字／最大节点直接内容 12 行）；
doc_link --strict 死链 0；doc_term --strict 疑似现行 0。
 2026-10-17 00:23:41 +08:00
DKChan fff4f120d3 merge: 迭代29测试分层与门禁语义修正批入库（十提交, worktree g-plan2-iter29-testlayers） 2026-10-17 00:13:57 +08:00
DKChan 04df1ede5f docs(06): 成长系数条定性落账（2026-10-16 用户口径「与 M4 数值任务就是一类」）——条目标题「语义待澄清」改「同日用户定性＝数值校准类」；状态行 待裁→已定性：并入数值欠账组随组重新归属（按里程碑立规属 Beta 阶段面，Alpha 不排期），甲/乙两读随定性消解；维持不进 08（数值调优义务 v1.6 起不入版本标准）。三闸全绿（gdd_lint 0 不通过/doc_link 死链 0/doc_term --strict 疑似现行 0） 2026-10-16 20:08:32 +08:00
DKChan d728c52996 docs(playnote二轮): playnote 增量三条按讨论必要性框架入库（2026-10-16 用户令：不需要讨论的写进 08 并同步 06、需要讨论的挂 06 待裁）——08 升 v1.8：①「三 · 界面」暂停层行改名状态面板（局内）（随 2026-10-13 改名批换代，08 行名漏扫）并在役→部分在役：瘦身义务入册（去跨关解锁内容〔秘宝匣解锁态 12 行概览/天赋树已购概览〕、只留本局五件〔带的秘宝/已获专长/当前属性/现有 GP/钥石总量〕，零待裁点=用户原话清单）；②成长系数节奏条语义两读（读法甲节奏缺陷归数值欠账组/读法乙设计哲学归难度曲线反哺）不进 08、挂 06 专条待裁；③路径长度统计与递增增幅补进 06 关卡节点图重构专条作设计输入（验收方向：实测三关基线→定递增曲线与增幅尺度）。06 新立两专条（状态面板瘦身=08 同步面〔含 camp.md/元进度双入口框架反哺点待裁〕+成长系数待裁条）。三闸全绿（gdd_lint 本批 2 文件 0 不通过/doc_link 1224 链接死链 0/doc_term --strict 疑似现行 0） 2026-10-16 19:33:44 +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 c3b6403018 docs(迭代29 T8): 回写架构事实源三张表 + 06 登记遗留七条 
architecture.md「测试与质量域」节（测试域唯一事实源）按批末真实状态回写：
· 五模块归属表：run_all 承载由「27 套件」改「33 套（单元＋L2 集成）」，判定口径列由「SCRIPT ERROR
  扫描缺失／断言数下限缺失」改为三硬闸齐备，并记下「子进程输出须落盘再读——OS.execute 管道在本机恒空」
  这一本机事实；probe_gate 增 screen_flow_probe 与 verdict 判定口径。
· 三条判定硬闸矩阵：probe_gate 的「退出码优先」与「SCRIPT ERROR 扫描」由缺失改在位；run_all 的
  「SCRIPT ERROR 扫描」「断言数下限」由缺失改在位；render_gate 的脚本错误扫描维持缺失并注明本批未收。
· 静态扫描域 S 表：S3 由「未落地…路径不存在恒零命中」改「在位（warning 级，路径已修正＋零命中自检）」；
  S5 由未落地改「在位（硬失败）」。
· 新增「三层承载与判定原则」小节：L1/L2/L3 各自的判什么／承载／入闸，以及判定原则——三硬闸是底线、
  PASS 串不作判据，两类静默失效（扫描面为空、子进程输出丢失）都以显式自检拦住。

06 待办清单新增「测试域遗留」条，集中登记本批未收的七项（均不阻塞不排期）：余下 3 个 core 零指名
模块、render_gate 的脚本错误扫描缺失、S7／S8（S6 亦仍在 TODO）、E 级卫生件、行覆盖率度量、
smoke_all 拆分、parity 触面判定偏粗。
 2026-10-16 16:18:17 +08:00