game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1,638 Commits 23 Branches 0 Tags
cddd13ff4081a42b983757a538687942a5cd45d3
Commit Graph
1638 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
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 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 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 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 becb675aca merge: active.md 残留清理批入库——10-18 五张待执行卡摘「唯一例外=active.md」假指令15处＋baseline 08b 死记录再删＋recolor 头注出处摘除（全量闸 066a9f7e 全绿，零新增红；09 静态扫描红转绿改善） 2026-10-20 01:14:50 +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 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
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