game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,614 Commits 23 Branches 0 Tags
6e04fa60f637f98e6f6218455780fecf914c24bc
Commit Graph
1614 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
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 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
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 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 163608b0b2 merge: 迭代 31 反哺点补扫结果（文档域回执 c46d9768 零新增红） 2026-10-19 16:41:52 +08:00
DKChan c46d976811 docs(reports): 迭代 31 反哺点补扫结果——门禁词全类型复扫零命中成文＋玩家面残留「雷/插」五处全表 
原 V1/V4 判据按四类扩展名扫，本次按 game/ 全部文件类型不排除扩展名重扫：
金币/插旗/雷格/惩罚格 0 命中、flag 不分大小写减豁免后 0 命中；
「旗」仅存在于守卫被检查字面量六处（改写＝自毁对外命名纪律守卫），已建议成文；
玩家可见文本残留 雷/排雷/插 由一处补全为五处全表（含字形「雷」连带 golden 基线换代的提示）。
 2026-10-19 16:41:26 +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 d7d3f28332 Merge branch 'agentsmd-20261019' 2026-10-19 06:11:42 +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 858bfad8b9 merge: 迭代 31 反哺点补 roadmap 两条（文档域回执 da67a871 零新增红） 2026-10-19 05:25:50 +08:00
DKChan da67a87130 docs(reports): 迭代 31 反哺点补 roadmap 两条（迭代行状态换代＋当前位换代） 
卡② §5 明列 roadmap 属反哺点面，前笔漏列，随收口补齐（本批仍禁写根规则文件）。
 2026-10-19 05:25:23 +08:00
DKChan afe91cb5a7 merge: 迭代 31 收口产出物（实现报告／代拍板追认单／反哺点清单） 
合回凭据＝worktree iter31-closeout-20261019 文档域回执（commit 85470918，无新增红）。
本笔只落 reports/ 三份，design/ 与根规则文件零改动——文档面全部以反哺点形式待你裁决。
 2026-10-19 05:24:52 +08:00
DKChan 85470918f0 docs(reports): 迭代 31 三卡收口产出物——实现报告＋代拍板追认单＋反哺点清单 
两卡状态、改前改后读数对照（卡① 120 行真差异 0／jsonl 六面行数全同；卡② 差异面归因到裁断）、
变异验证 6 条记录、实机目检总清单 7 项、遗留读数义务 4 项、代拍板 13 项、反哺点 18 条。
禁写 design/ 与根规则文件：06 推进句、术语表、entities.yaml、art-bible/asset-path-map、
07 目检项、roadmap 行换代全部列进反哺点清单等你裁决后归文档批落笔。
 2026-10-19 05:24:26 +08:00
DKChan 3e076e226e merge: 迭代 31 卡② 凭证件裁削批（同调电池删除／完美保险迁专长／配额净删 104→102） 
合回凭据＝worktree iter31-c2-curio-20261019 代码域全量回执（commit 0170071d，all_green=true，
8 闸零新增红，对拍锚随批重锚）；卡② §7.2 变异验证 5/6 证红、寿命域变异单测不可观测已登记遗留读数义务。
 2026-10-19 05:14:45 +08:00
DKChan 0170071da7 test(凭证件裁削): 卡② 对拍锚重锚（删件后牌库与豁免语义变化随批换代） 
三变体各 N=20×2 策略重跑；差异面=稀有档候选集少两件（attune_battery/perfect_insurance 零出现）
＋完美保险改订阅式后的完美判定面，与用户裁断一致（差异归类见 reports/iter31 实现报告）。
 2026-10-19 04:54:17 +08:00
DKChan 072c19b4a5 feat(凭证件裁削): 卡② 同调电池删除＋完美保险迁专长＋配额净删落地（迭代 31 卡②） 
用户 2026-10-18 逐裁四项落码：
- T1/T2 同调电池整件删除：CURIO_KINDS 摘 kind、三字段与三处分发表分支删净、
  runner 侧 _battery_pending/断点键/getter/choose_battery_target 全清（呈现层零接线=有账本无入口）。
- T3 完美保险出池：kind/字段/分发摘除，_pending_insurance 与 level_runner 注入通道
  （voucher_insurance 键、set_voucher_grants 第三参）整链拆除，battle_orchestrator._fx_insurance 删。
- T4 引擎扩签 forgive_seal_miss（EFFECT_KINDS 31→32）＋两账相减：新增 _perfect_forgiven 单向累加、
  谓词抽成 perfect_sweep_earned()（有效误标=误标总数−豁免数），_perfect_hit_false 保持纯净=契约 2；
  seal_missed 发射时机与消费点零改动=契约 3（危险直觉·守同事件订阅面在验收组里对拍）。
- T5 feats.tres 第 30 行完美保险专长：rarity rare／cap 省略／domain=battle 显式写出（战斗域首例）／
  desc「本场首次封印落空，不计入完美封印判定」；限次由行 when counter(insurance_used) lt 1 承载，
  do 自带 counter_id 记账由授予段消费点落账（代拍板 3 选型：单行落表，理由见实现报告）。
- T6 配额净删：TIER_QUOTAS rare 9→7、令牌池总量 104→102，validate() 硬断言过；smoke 配额锚/牌库
  构成/专长行数随批换代。
- T7 验收：feat_vouchers_test 39 项全绿（出池反例/断点缺键兼容/账本保留/配额锚/装载/限次一次/
  计数纯净/两账相减真值表/跨战清零/事件不吞）＋forge_table 词表闭集断言 31→32。
  变异验证 6 条：5 条证红；「domain battle→adventure」在本 rig 不可观测（未红），已如实登记。
- 存量缺陷顺带修：旧 _emit_row("insurance_used","",…) 空来源会触发行来源断言（旧路径无消费点故从未走红），
  新订阅面给出 source_class=seal_miss。

基线（卡① 合回后 master 4f953ce8）：冒烟 1151/0、单元 34 套全绿、探针 --click 全绿（user:// 存档移开态）。
 2026-10-19 04:45:49 +08:00
DKChan 4f953ce829 merge: 迭代 31 卡① 代码术语刷新批（flag→seal 全族换代＋game/ 禁用词清扫） 
合回凭据＝worktree iter31-c1-term-20261019 全量档回执（commit 2c5cece4，域=code＋docs，
all_green=true，12 闸零新增红；对拍锚随批重锚）。主区素材实体已随批改名 flag_seal.png→seal_mark.png。
 2026-10-19 04:00:25 +08:00
DKChan 2c5cece48d test(代码术语): 卡① 对拍锚重锚（seal_ 标签面，用户裁案甲随批） 
三变体 base/attune/shop 各 N=20×2 策略重跑，RUNSUM 面仅标签名换代、数值零差异（差异取证见 reports/iter31 实现报告）；jsonl 面 sha256 随新事件名重生。
 2026-10-19 03:04:59 +08:00
DKChan 26d182f845 docs(代码术语): 卡① 注记面禁字提及还原（被检查的禁字不是使用） 
feats.tres 头注 desc 禁字清单还原为「雷/旗」、命名纪律对照句改「旗〔旧称〕=封印」；
battle_orchestrator 注释双等号读顺。均为注释面，零数据零行为。
 2026-10-19 02:54:19 +08:00
DKChan 32fdf957fd refactor(代码术语): 卡① flag→seal 全族换代＋game/ 禁用词清扫（迭代 31 卡①） 
标识符面：flag_*→seal_ 族（含 Godot 信号 flag_judged→seal_judged 与连接/回调同名、
FACTS 两键 flags_count→seals_count／dug_under_flag→dug_under_seal 全链、
.tres 键名与 schema .gd 同批同步）；显式豁免零改动=size_flags_*（Godot 布局属性）＋_fatal_flag。
中文面：金币→GP（金币袋→GP 袋）／插旗→封印／雷格→危险格／惩罚格→危险格／旗→封印·封印印记族，
game/ 内 *.gd/.tres/.md/.json 四类禁用词与 flag 双双零命中（V1/V4）。
守卫字面量不动（被检查的禁字不是使用）：smoke_all V21 零「雷/旗」检查面、
ui_font_asset_test 字形集攻/雷/旗/封 保持原断言逻辑。
代拍板：板面单字槽 glyph「旗」→「封」（禁字纪律＋单字位宽，消费面四处同名随动）。
素材换代（2026-10-18 用户裁案甲）：assets/art/board/flag_seal.png→seal_mark.png（素材不入 git，
盘上改名＋导入重刷），代码两处 res:// 字符串＋COL_FLAG/CURSOR_FLAG 常量同步，
闸件四处随批（run_all_gates.sh/render_gate.sh/golden_baseline_refresh.sh/path_check.py）。
anchor.json 键名手改，重锚与改前改后 diff 随本卡收口（同裁案甲）。

基线读数（改前，主区 ed2dfaf6）：冒烟 1151 检查 0 失败／单元 34 套全绿／探针 --click
存量红仅 screen_flow_probe（user:// 断点污染在册已知项）。
改后同批读数（本 worktree）：冒烟 1151 检查 0 失败／探针 --click 同一存量红、其余全绿。
 2026-10-19 02:52:38 +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 d659b065c1 chore(导入): 8 个 .uid 入库——迭代 30 期编辑器刷导入生成，此前一直未跟踪 2026-10-19 01:28:41 +08:00
DKChan 09f57842d9 docs(需求卡片): 卡② §10 前置门 2 改判为已满足——奇物.md v3.18 已随 39523dd4 进 HEAD，06 状态行也已推进；删去「归用户／文档批」的过时落笔责任句 2026-10-19 00:23:13 +08:00
DKChan 0e92704acd Merge branch 'term-sweep-20261018' 2026-10-18 23:55:49 +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 76868d7228 feat(闸): pipeline_gate 补两条卡片机检 C1/C2——卡片冲突修订批的防回归兜网 
- C1 文档义务口径（生效＝文件名日期 ≥2026-10-17）：关联文档同步面表内目标格指向 design/（含 ../gdd/ 等相对写法）或根规则文件、义务格仍写「随批」者红——req-card §6 改口径后旧措辞「机械面随批」不得再入卡
- C2 设计事实源声明（生效 ≥2026-10-18）：全文既无「设计事实源」也无「唯一事实源」者红；两种合格写法都认（独立小节／头部「来源：…（唯一事实源：…）」），避免按小节名字面判死全库卡
- 只追新规生效日之后的卡，更早的卡属已实现批次历史留档，不回头改（同「换代清零＋定期跑批」先例，不设豁免清单、不加编辑期钩子）
- 负向验证已做：临时卡注入两处违例→两红（design 目标红、game/README 行不误红）→删除复跑绿；文档域闸全绿无新增红（回执 commit=ad48d2a2）
- 同批另修两份技能文件的「设计事实源」字面对齐（.zcode/skills 与 .qoder/skills 双写逐字一致）——两目录均被 gitignore，该改动只在本机盘上、不入 git
 2026-10-18 19:56:11 +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 e4c97d13bc merge: 五技能全项目级收口（worktree g-plan2-skill-loc2，分支 skill-loc2-20261018，ffb931c2）——req-card/iter 二技能挪回项目 .zcode/skills/，CLAUDE.md 与 process-conventions 措辞同步为五者全项目级；文档域闸全绿 2026-10-18 17:29:13 +08:00
DKChan ffb931c292 docs(技能): req-card/iter 二技能同批挪回项目 .zcode/skills/（2026-10-18 用户裁定项目专用不留用户级），CLAUDE.md 导航行与 process-conventions §2 措辞同步为五技能全项目级 2026-10-18 17:29:03 +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 5c42f593f5 Merge branch 'master' into hygiene-20261018 2026-10-18 17:12:47 +08:00
DKChan 678669d826 revert(闸基线): 08b 记录回到原样——本批退回文档域 2026-10-18 17:12:46 +08:00
DKChan e941c5d836 merge: 技能安放位置换代（worktree g-plan2-skill-loc，分支 skill-loc-20261018，defe4454）——doc-design/asset-ingest/iter-plan 三技能挪回项目 .zcode/skills/（gitignored 本机生效，同钩子先例；用户级副本已删防重复触发），CLAUDE.md 与 process-conventions 措辞同步；文档域闸全绿 2026-10-18 17:05:30 +08:00
DKChan defe4454a6 docs(技能): 技能安放位置换代——doc-design/asset-ingest/iter-plan 三技能自用户级挪回项目 .zcode/skills/（2026-10-18 用户裁定：项目专用不留用户级），CLAUDE.md 导航行与 process-conventions §2 措辞同步（req-card/iter 系 2026-10-08/11 既有用户级技能、维持原位），规约措辞两处去用户级限定 2026-10-18 17:05:17 +08:00
DKChan c167affae2 chore(卫生): 闸域表口径对齐机器＋删退役仪表盘工具＋清基线 08b 记录（2026-10-18 用户点令三项） 
①architecture.md 闸域表第三列与机器侧不一致已修：原写代码域触发含 `game/`、`tools/`、`artwork/`，而 worktree-guard 现行判定只有 `_p.startswith("game/")`（:149-151）、run_all_gates.sh 头注也只认触及 game/——`7bdf53e3` 改判时漏改的第二处。同时查出 roadmap.md:88「重闸」步仍带同一条旧口径与「改闸件本身→全量」旧条款（该义务已由 7bdf53e3 换成「闸件自身改动不占合回全量，质量义务＝落批时变异验证」），一并换代。

②删 `tools/loop_dashboard.py`（529 行）：roadmap 早在 2026-09-27 重整批就宣布它退役、职责交 06 与状态记录，全仓现行文档/闸序列/技能零调用（git grep 只命中自身）；它的主要数据源之一 active.md 快照节已于本日废除，「台账健康」栏（撞号检测与下一编号建议）随编号方案一起失效。它唯一不重复的能力＝引用版本与被引文档现行版本的落后比对，已按现存格式重立为 `doc-consistency-check` 技能第 10 项人工核对（比对面从已消失的 07「当前批次来源」行改到 06 的闭合凭据）。试跑该新件即命中真问题：06 有一条凭据写「元进度.md v1.0」而该文档现行已 v1.21，另有一条 character-design.md v1.9 取不到现行版本可核。

③删 `game/tests/.gates/baseline.json` 的「08b active.md 体量」记录（基线 13 闸→12），本批 diff 因此触及 game/，按域判据跑全量档（代码域＋文档域）。附带 `tools/path_check.py` 去掉已失效的 active.md 跳过项并把注释里「排除台账类文件」的旧说法改成与实际扫描面一致的表述（实查该工具扫的只有 .gd/.tscn 与 design/art/*.md，从未跳过 *checklist*/*memory*）。
 2026-10-18 16:18:13 +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 bfafbcad21 merge: M4 数值欠账归属裁定落文件（worktree g-plan2-m4-note，分支 m4-note-20261018，80725685）——留 06、未设计未启动、不另行归属（2026-10-18 用户裁）：五条统一缺口换代＋五处挂 M4 措辞改未来数值标定窗口＋三处归属字段同步；文档域闸全绿 2026-10-18 08:06:09 +08:00