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
65 Commits
Author SHA1 Message Date
DKChan 0341bdc2a9 docs(营地场景图口径回写): 帐篷与木围墙口径落地 design/ 
依据＝reports/提案-营地场景图美术生成方案-2026-10-22.md §12 分层元素描述表／§11 修订清单第 2·4·7·9 条，
以及 reports/提案-营地色彩与氛围脚本-2026-10-23.md（色彩与氛围依据，色值为候选未拍板）：

- art-bible §2.8：承载元素中景改木围墙（密排竖木桩／桩顶削尖／不透缝无横木），承载件由床铺换为帐篷
- art-bible §6.2：场景构成补「中景带自底部往上约 2/3 处起」＋「近景可覆盖围墙、门洞必须留空」；交付形态承载件改帐篷；
  新增「色彩与氛围依据」指路（指 reports 脚本，本节不复述色值）与「待裁」三项（环境子板色值／门扇门洞高宽比／帐篷落地尺寸）
- art-bible §7.5：七物件名与「近景可覆盖中景、门洞除外」口径同步
- asset-path-map §3：scene_camp_bed → scene_camp_tent
- art-assets-checklist §3.5：承载件素材名同步改 tent
- camp.md（design/gdd/ux/）：v2.1，物件表与纵深段按帐篷／木围墙口径重写，画法与尺寸口径回指 art-bible §6.2

术语表 43/56、02-系统清单 82、08-Alpha 106/200、art-status-checklist 32 五处经核对已在前批落地，本次零改动。
文档域闸 tools/run_all_gates.sh --docs 全绿。
 2026-10-24 07:04:18 +08:00
agent 291f5122fc docs(营地美术设计段): 营地场景图定稿条款落文 + 旧「三柜台」说法全面换代 
- art-bible: §2 明度禁令缩窄至情绪域(状态表达不再受限)、§2.8 承载元素换七物件场景图、
  §4.1 新增色板分层(语义/UI token 48 + 每屏环境子板 ≤32)、§6.2 营地场景整条重写、
  §7.5 营地界面整条重写、§7.6 禁用态加注(场景物件另按 §6.2)
- camp.md 整份重写为「可点击场景图 + 七物件点选」
- asset-path-map 增 scene/ 子目录; 资产清单 §3.5 重写; 状态清单营地行换代
- GDD 侧「柜台」用词换代: 术语表(顺带消除三/四柜台自相矛盾)、系统清单、Alpha 标准、
  不做清单、核心循环、内容规模、level-clear、元进度、HUD框架
- 待办清单: 新增「营地五界面窗口化批」(优先级=绝对, 强依赖卡④); 卡④条 P1 同步为已裁=B
- reports/提案-营地场景图美术生成方案-2026-10-22.md (本轮讨论裁定与修订清单 §11)
 2026-10-23 02:50:36 +08:00
DKChan b028a84e03 docs(定名传导批): 增益状态正名「状态池」＋两份美术文档「金币」换代 GP＋定名传导遗留条销账 
- 增益状态.md 与 6 份引用文档：账/账本（15 处）与容器（45 处）统一换为「状态池」，动词按行改写（入账→入列、开账→初始化、记账→登记）；术语表「增益容器」括注同步
- art-bible §4.1/§4.2 与 art-assets-checklist §3：金币→GP（2026-10-18 用户裁的全库禁令遗留面）；entities.yaml 部分随 registry 注销作废，旧分支 gpsweep-20261019 不合、不 pick
- 待办清单「2026-10-19 定名传导遗留二项」整条删除

文档域闸 --docs 全绿（回执 commit=629dbc50）
 2026-10-23 01:18:50 +08:00
DKChan 1864f157b4 docs(迭代33反哺写入＋收尾批): 16 项反哺点按 2026-10-22 用户裁决全部落文＋三卡与四件产出物退役＋账面换代 
- 存档序列化.md：三存档位承载段（#1）＋负责表/读写时机图换代＋无激活拒写（#2）＋P2 多存档槽位后置条注销（#3）＋旧单档一次性迁移段（#4）＋消费面纪律补窥视读器返回结构与 has_file 口径（#10）
- 生涯.md v1.1：信息架构三入口结构树＋定位改营地平级（#7/#11）；camp.md v1.6：营地入口改「进入存档→选档→进档/新档」＋双入口框架句同步（#12）
- 08-Alpha版本标准.md v1.13：「三 · 界面」增选档界面行（#8）＋主菜单行换代与入口拓扑注记（#13）——两条均 2026-10-22 用户裁批准；营地交互重做五卡行按实态同步（部分实装）
- art-bible.md v3.18：§7.4 豁免清单 excision「主菜单分组 overline×2」两片段、余清单不动（#15）
- 体验验证清单：新增 ㉛ 迭代 33 实机目检总清单五项＋⑯/⑲ 旧入口引述按三钮换代（#14）
- 账面：待办清单增「迭代 33 反哺点写入」专条（状态=已写入）＋营地五卡条推进（①②③ 落地、④⑤ 未编排，去「已编迭代 33」段）（#5/#9/#16）；roadmap 迭代 33 行「已完成（2026-10-22）」＋卡片/报告列退役保留字＋当前位三行换代（#6）
- 退役七件（吸收即死＋证据只留最新，引用面已改写）：iter33 实现报告/反哺点清单/验收审计/代拍板追认单＋三张需求卡片；代拍板 12 项随专条备案（veto 窗口开放至用户明示）
〔迭代 33 收口登记：卡① ebf40947／卡③ 5c2a7bcf／卡② 508f190b／总收口 6e8f72b2〕
 2026-10-22 23:34:13 +08:00
DKChan 4d03c3457c docs(关卡节点图重构): 关卡节点图生成 v1.0 落定＋关卡节点地图 v2.0 多终点换代——产出规格唯一陈述处/五旋钮参数档/深度带配池/每终点前一店，文档域闸全绿（回执 domain=docs） 2026-10-21 04:42:51 +08:00
DKChan f2b2558098 docs(迭代32反哺写入批): 卡①卡②两份反哺点清单 29 项按 2026-10-21 用户裁决全部落文 
- 措辞换代：八件 design/ 文档「完美排雷」→「完美封印」（art-bible v3.17）；术语表「退役词对照」增行成 S11 词表权威来源
- 闸扩面：tools/doc_term_audit.py 词表加「完美排雷」＋扫描域扩 design/art（用户裁 2026-10-21）；变异验证＝注入见红 EXIT=1、还原回绿
- architecture.md v1.9：effect_engine/orchestrator 行与战斗域装配节改 ctx 形态、架构原则补第 8 条「系统无状态」、flag_missed→seal_missed 两处订正
- 提案 v1.3：§7.7/§7.10.3/§7.10.12 三处依卡片 §12 裁①②订正；sim-data/README 纪律③⑦批次例外登记
- 账面：待办清单增反哺专条×2／重锚批准条目／game/ 域欠账条目，无状态原则条「文档设计已闭合」；体验验证清单增 ㉚ 目检五项
- 代拍板两单 14 条用户全部追认（2026-10-21）；文档域闸 --docs 全绿（含 08c 流水线闸 70 条目零红）
 2026-10-21 03:51:28 +08:00
DKChan f100e19275 docs(gdd): 删除「关卡节点图生成」旧版文档（用户令 2026-10-21）——出度≤2/层宽≤4 旧规随档退场；引用面八处改指路文本（02 索引行/08 行/关卡节点地图/冒险结构/level-map/待办清单两处/Alpha梳理）；归档副本落主区 archive/，随关卡节点图重构批重写 2026-10-21 00:53:42 +08:00
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 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 6d601d23dc chore(禁写变更记录批): 版本历史节/日期批注全面废除——gdd_lint R4 反转禁设＋三工具去豁免＋48 文档删节＋game/README 流水段删＋代码注释 900 余行轨迹标签清偿（约束句保留）＋规约/skills 五层指令面同批改指 git 沿革 2026-10-20 00:22:18 +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 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 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 4a65f9eb6d Merge branch 'master' into art-standee-20261006 
# Conflicts:
#	design/art/art-bible.md
 2026-10-17 17:31:22 +08:00
DKChan 86169065af docs(用语): A 表全量词面换代批（2026-10-16 用户令第一步）——design 四域 36 文件机械替换约 371 处：随批→顺带 123、收口→完成 114、落文→写入文档 76、不得→禁止 53、台账→状态记录 35、对拍→逐项比对 12、销号/销账→注销 12、在飞→正在执行中 3、不报错→不返回错误 1；豁免面零触碰——版本历史既有行、对照性替换记载句（「X」→「Y」）、术语表与 doc-conventions 条文自身、engine-reference 留档区、美术审计会话存档、buff/debuff 代码标识符、「不得不」惯用语；难度曲线与Boss「随批次扩展」改「随后续批次扩展」避词面误中；三闸全绿（gdd_lint 0 不通过/doc_link 死链 0/doc_term 疑似现行 0 含 --strict 复核）；闸门升级（--strict 入钩子+豁免基线清单）按用户令留待后续讨论 2026-10-16 02:17:00 +08:00
DKChan 4d3f8d6653 merge: master 二次吸收（ADR 体系废除批+布局闸入库） 
# Conflicts:
#	design/gdd/02-系统清单.md
#	design/gdd/systems/冒险循环/冒险结构.md
#	design/gdd/systems/表现与支撑/数据配置.md
#	design/gdd/ux/battle.md
 2026-10-16 00:08:01 +08:00
DKChan 6c2dbc37c1 docs: ADR 体系废除 + architecture.md 确立为架构唯一事实源（2026-10-15 用户令：决策记录归 git commit log，不另存决策文档） 
- 删除 design/dev/architecture/adr-0001~0007 共 7 份文件（内容留 git 历史可查）
- architecture.md：删「ADR 审计」「ADR 立项清单」两节；清除全文 ADR-000X 注记、QQ 表/S 表 ADR 引用；未决表关闭已落定项（QQ-01/02/03），立项清单在途事项转登记 QQ-11~14；补 A1 生成姿态事实、autoload 四件清单、board_generator 性能姿态；文档状态立「事实源地位」条
- CLAUDE.md：恢复 RNG 单点硬性红线（去 ADR-0007 引用）；新增「架构事实唯一源」红线；规范导航架构行标注唯一事实源
- doc-conventions：§5 增「架构事实唯一源」行；§11 活文档清单补架构文档
- registry：architecture.yaml 删 18 处 adr 字段、autoload_set 补 SaveManager/MetaProgression、board_rending 更新为 Node2D 已落地事实；entities.yaml 12 处引用清除
- game/ 代码注释约 60 处清 ADR-000X 引用（事实与日期保留）；豁免标记 ADR-0007-exempt → rng-seed-exempt（main.gd/static_scan.sh/architecture.md/06/iter27 五处同步）
- GDD/qa 实现报告/research 卡片/roadmap/tests README 引用全清；死链校验 1206 链接 0 死链、gdd_lint 0 不通过
- 代码中 adr/adr5 等为 adventure_runner 既有局部变量名（非 ADR 引用），未动
 2026-10-15 23:52:30 +08:00
DKChan 83c88c4566 docs(gdd): 用语规范批 W3——表现与支撑 16 处+ux 55 处词面换代（收口 19/台账 17/随批 11/不得 12/buff 1 等按 A 表）＋死链终清（config_fatal_probe 迭代19退役去向双证并入数据配置 v0.4 行注）＋camp 文头 v1.5/level-clear Last Updated 失同步补齐。伏击者留痕与验收口径子串误报按豁免保留 2026-10-15 23:11:18 +08:00
DKChan b01253245e docs(改名补漏): camp.md状态面板两处正文换代——原改名批漏扫本文件(grep路径误写design/ux/不存在=假阴性零命中,用户质询发现);版本历史行旧名按记载保留+版本行v1.4 2026-10-13 06:20:30 +08:00
DKChan f22b2036a0 迭代22裁决落文批: A单十五条裁决收口+B单七条反哺全落文+⑤改自动兑付代码批——追认单(①②③⑥⑦⑧⑨⑩⑪⑫⑬⑭⑮追认/④追认+积点账裁战斗级/⑤推翻改自动兑付)收口; ⑤代码=满charge_n=8自动当轮grant_ap无玩家入口(_on_cell_revealed揭示缓冲点兑付=cell_revealed批先于本格扣费故AP归零恰逢满点先兑再扣轮不结束/授予段积点段迁除/use_attune_convert受理口消解/attune_convert_state改造进度读数口+item_id键/use_treasure的ap_charge_safe死分支与_usable_now死条件删/tres试炼镐desc换代+counter_spend受理闸删)——HUD兑换钮整链退役(ap_bar convert信号+钮/board_zone转发/main接线与_sync_convert_button/_on_convert_pressed)+C区秘宝槽悬停浮窗进度(controller投影note字段/hero_info_panel tooltip拼接/main _refresh_presentations加refresh_slots重查); 单测④段重写自动兑付断言(7格零兑付/第8格AP+1/读数口/未装配反例); B落文=秘宝.md v3.0(目录三表实态三列+试炼镐自动兑付换代+代价轴转化获取行含战斗级重置与兑付时序+解锁条件实录钥石10/25四条件件三计数键+实装批落地前句全换代+退役指针补代码旧行已删)/元进度.md v1.17/camp.md v1.3(柜台呈现细则节+暂停层12行)/存档序列化.md v1.6(vision_used域+断点随件+bonus_aux_carry退役+v6扩列不升版)/行动经济.md v0.12(finish_round_stop转存率参数化)+术语表v1.2(自动兑付/真视使用计数两词条)+07㉑观测点随⑤换代; 报告修正=⑮提交号勘正(master实际T5=73db171,原记7095505系amend前被弃旧提交——merge-base实证)+十五条裁决标注+反哺七条已落文标注; 06收口=状态行换代+裁决小节。冒烟898/0+单测22套+probe_gate --click --full全绿(worktree拷.godot/字体与图标边车/art素材后) 2026-10-12 23:23:01 +08:00
DKChan 4688d09627 fix(presentation): 奇物呈现修复批——C 区/关卡页聚合行退役改逐件行「件名 ×N」+卡面摘族名（僵尸呈现整改，呈现改法=甲）+07/报告§五.5/battle.md/README/06 条收口移除+反哺点⑤销账+475 号状态记录 2026-10-12 08:04:16 +08:00
DKChan 081027c579 docs(fix): 文档一致性修复批（定时检查呈报项①②：死链7处+lint三文件清零；纯文档零测试） 
①死链修复7处：秘宝.md 10-10目录归位批漏网5处改指 systems/跨局循环/秘宝.md（01-核心循环v1.6行/02-系统清单v1.3行/奇物.md v3.5行〔连反斜杠路径一并改正〕/地形变异.md负责表+依赖表两行）+camp.md树面板行两处补../systems/前缀（天赋树/HUD框架）；数据配置.md:221存量挂账维持（iter19基线在册）
②gdd_lint三文件清零：01-核心循环 R10版本历史v1.5同号顺延（10-10分界尺行→v1.7）+R5「生命周期轴（五档）」节补五档嵌套字符画〔报错原文误记「死了之后」系工具prev/cur错位——tools/gdd_lint.py R5报错节名一行修正〕+「死了之后」节顺带补死亡重开环字符画；02-系统清单 R6术语表行多余版本列摘除+R3三行状态格改写现行白话句并换代（天赋树v0.4换代定稿29节点/武器锻造v0.2/奇物27件扩容后）+版本v1.21；03-内容规模 R1超长段拆两段+目录计数换代15→12件（普通7/优秀3/稀有2——回能器删/换装券撤/第四只手删三轮漏网面）+版本v1.3
闸：gdd_lint 9文件2不通过（=06/07基线存量，01/02/03转绿）/doc_link死链2（=06:505 worktree环境假象待主区复验+数据配置221存量）/熵增PASS；版本行01 v1.8/02 v1.21/03 v1.3
 2026-10-11 16:14:08 +08:00
DKChan ac19754374 docs(glossary): 退役词对照表全库强制清扫——正主→现行事实源130行+落籍→已入库79行（39文件194行，语境微调=权威文档/权威定义节/拼表制主选/入库注记等；对照性文本豁免保留）+五词终验零真残留+术语表v1.3+active 446（2026-10-11 用户令收尾） 2026-10-11 05:46:49 +08:00
DKChan 6951632d25 docs(glossary): 术语表建立+全库术语统一批——危险格/整图/专长凭证（2026-10-11 用户四裁）+秘宝.md v2.5 可读性审查批 
- 新建 design/gdd/术语表.md v1.0（四节术语+退役词对照；02 清单登记；用户令查表阅读）
- 全库更名：雷格/惩罚格→危险格（113 处）、雷安→危险格与安全格（39）、板级→整图（29）、门票→专长凭证（88）、雷位→危险格位置（5）；排雷玩法定义句换代+版本行
- 秘宝.md v2.5 可读性批：术语指路+黑话清扫（正主/落籍/P1甲死指针/charges/结构闸等）+承重契约白话化+验收分层白话化+两处过时事实修正（战斗道具窗口 2026-09-15 已下线/21 项义务死指针）+版本行序修复
 2026-10-11 03:56:12 +08:00
DKChan be1cf39e97 docs(structure): 秘宝.md 系统目录归位——自排雷循环迁入跨局循环（2026-10-10 用户发现结构问题） 
- 生命周期裁定：解锁/装配/存档持久全在跨局侧，排雷循环仅生效现场；成因=前身辅助道具系切片期掉落形态旧置排雷循环，同调换代未随迁
- git mv+文内同目录引用改跨目录路径；全仓反向引用 33 处同步（版本历史/注记行内历史路径按纪律保留）
- 02-系统清单 v1.19：文档树两区换行+系统总表行移区+命名对照表不动（AUXILIARY_ITEMS/a5 不变）
 2026-10-10 17:28:38 +08:00
DKChan 9ae7c60c9c docs(sync): 天赋树裁定跨文档同步——锻造工坊解锁门登记+06重构批条+「道具工坊」改名「秘宝匣」九文件扫改（2026-10-10 用户令） 
- A 武器锻造.md v0.2：柜台承载节补树侧解锁门（本柜台前置=树「锻造工坊」免费节点，攻/甲淬炼累计各≥2）
- B 06：新登「天赋树结构重构批」实装待办条（meta_tree 33→31/v4→v5 迁移重做/schema 等级阈值前置/柜台解锁门/秘宝匣改名连带面/地脉共鸣/同调位1）+武器锻造实装批条补关联句
- C 九文件现行正文「道具工坊→秘宝匣」扫改+各记版本行（版本历史行零触碰）：元进度 v1.13/秘宝 v1.8/HUD框架 v0.16/camp v1.2/art-bible v3.13/03 v1.2/07 v0.5/README 新节/art-assets-checklist 补建版本表；registry 术语条「秘宝匣」（别名「道具工坊」保留检索）
- 红线：天赋树.md 与 game/ 代码数据表零触碰；design/research 与 design/qa 零触碰
- active.md：快照条+工作日志 431 随批
 2026-10-10 06:48:08 +08:00
DKChan bb371cabc3 docs(tree): 天赋树欠账三分流——已建未接面记 06+registry 过期词条换代+camp.md 补树面板（2026-10-09 用户三令） 
- 06 新条「天赋树已建未接面两件——设计定案、实现缺失」：同调位 2/3 槽位收编+命中线 flat 注入（设计正主《整合定稿》git 8e02dcf 取证定性质=实现缺失非设计缺口；处置=实装批+数值批，冻结待排期）
- registry entities.yaml「永久强化」词条：「『天赋树』同日退役——本作无树形结构」过期句按最新口径换代（树迭代 12 在役+正主指路+新旧概念划界）；L870 批注行系历史留痕不动
- camp.md 补树面板结构位行（图鉴柜台下段程序占位；呈现终稿归 HUD框架；两信号名）——树侧跨文档欠账清偿
- 设计灰色地带（刷新升级节点/树四线×武器锻造叠加关系）不入本批=用户另会话设计讨论，prompt 已交付 chat
- worktree g-plan2-wforge 分支 tree-debt-gdd 基点 e39a4d6；纯文档零测试
 2026-10-09 23:36:17 +08:00
DKChan bbc849eac5 docs(audit): 文档正确性审查·独立复核批（worktree docaudit-2026-10-09，基点 03c4b4c——18 文件语义级清漏，主区零触碰） 
R1 状态与证据对齐（全部代码实证）：
- 存档序列化 v2→v6 换代（save_manager.gd SAVE_FORMAT_VERSION=6 实证）：数据模型 JSON+域清单补 v4 同调三域/v5 树域/v6 生涯两域逐行 owner、版本与迁移节五件迁移链、调参表常量 6；v3-v6 四次升版当时均未回写本文，本批一次清偿（v1.4）
- 数据配置表清单四处失同步：变异表六行→七行（variation.tres 实测 7 行含贫矿脉）/RewardConfigTable 行删除（reward_config.tres 与类名全仓零命中）/AuxItemTable→TreasureItemTable（treasure_items.tres）/MetaTable 四行族→五行族（+attune_refresh_upgrade）+HeroTable 补 armor_class（v0.6）
- node-reward 令牌池六种→七种（adventure_table.gd CURIO_KINDS 实测七类含 refresh，curio_quota_refresh_rare=2 在役；v2.5 修订漏登，v2.6）
- interaction-patterns #19 inventory_panel_view.gd『已实现』系失实登记（git 全史零记录，从未入库）→占位失效
- level-clear『加权洗牌掷 3』漏网旧口径→令牌池洗牌不放回（与冒险结构 v0.14 对齐）
- 奇物依赖表 relics.tres→feats.tres（表文件已换代）+§1.3 异质性账清单对齐凭证件表（AP 上限摘除）（v3.10）

R3/R4 退役残留清漏：
- 行动经济依赖表『挖/插/拔』拔旗残留（v0.4 批漏网，v0.11）
- 地图战斗资源依赖表『秘宝的背包』同调形态残留（v0.22）
- 冒险结构『秘宝件受同调位约束』替换交互无现役触发面补注+『06 在册』悬空指针清偿（v0.19）
- HUD框架秘宝义务行『库存条常读』→装配件与充能常读（v0.15）
- 教学引导/P0 闭环/战斗结算/level-clear 等六处『秘宝背包/关卡末清库』补机械惰性承载注（treasure_inventory 代码实证在役但投放渠道全退役恒空、拆线归实装批——battle.md『无关卡域清库面』表述精确化）

R2 里程碑/批次口径：
- level-map 四处 M-1/M-2 前缀删（迭代 2 框材组=git 9abf5ff 实证；迭代 4 三处）
- 07『难度修正批』全替『数值批（Beta 阶段，未排期）』（v0.4）
- 教学引导『里程碑定位 Alpha』两处→Beta 阶段（2026-10-04 用户拍板漏同步，v0.5）
- HUD框架 P1『秘宝内容重定批』过期批次名→node-reward v2.5 在役

指路断链：
- 06 archive 死链改写（不入库目录表述）+两条『用户令删除』死条目整条移除（git 留痕）
- 07 三处伪死链去链接语法
- 奇物 §1.6 两处 ../ux/→../../ux/（v2.7 旧债，doc_link 复验清零）+06 欠账条目同步清偿注

规范两份：
- doc-conventions §1『现行文档不跑 lint』与现实对齐（gdd_lint=机检三闸之一在役，v14）
- code-conventions active.md 旧路径迁根目录+版本表补建（v2）

doc 三闸终验：doc_link 死链 4→1（剩 1=版本历史行内历史引文按纪律保留）；gdd_lint 5 不通过/doc_term 6 旗均与基线持平零新增
 2026-10-09 21:25:40 +08:00
DKChan 03c4b4c933 docs: 文档正确性审查批+去毒+命名统一+天赋树成文等十一批落籍（2026-10-09 用户令） 
一、里程碑语义立规：M3=Alpha 完整实现/M4=Beta 完整实现，未明令关闭 M3 前只排 M3 需求（roadmap M-4 节头立规注+M-3 节头口径指针+迭代 21+ 行注+06 倍率差条注）；迭代 20/21/22 规划冻结（roadmap 迭代 20 行注——先解决眼前问题，重启=用户直接发令）
二、文档正确性审查批三波：全 GDD 29 份过审——状态记录按代码证据订正/里程碑删前缀（M-x+迭代N→迭代N，裸 M-4→Beta 阶段（未排期））/退役词退役件当现役清零/在役旧实现节加隔离横幅；重件=秘宝.md v1.7 老正文深层清算（横幅重写消「过渡形态已退役」误读/沿革节换代/六件旧件登记摘除/验收与 charges 矛盾订正）+奇物 v3.8+冒险结构 v0.18+关卡节点地图 v1.7+图生成 v0.7+难度曲线与Boss v0.26+战斗结算 v0.27+敌人系统 v0.16+地图战斗资源 v0.21+增益状态 v0.13+战斗表现 v0.6+元进度 v1.9+生涯 v0.3+00 v1.3+02 v1.16+03 v1.1+ux 八份（battle 23 处/camp/shop/node-reward/level-clear/interaction-patterns/settlement-summary/level-map）
三、去毒批：奇物 v3.7（魔法道具→秘宝/档名三档→四级/门票与刷新「尚未入表」假话订正/验收第 3 条改令牌口径/资源成员指路凭证件表）+秘宝 v1.6（速览旧目录退役标注/退役件示例换现役）
四、道具退役素材库新建（design/research/道具退役素材库.md，案乙已追认）：秘宝退役 9 件含去向+专长退役 27 件名单+待核 4 行；魔法提灯（fog_lantern）裁退役（06 条目已裁+秘宝.md 注记换代+素材库迁表一；拆线归实装批）
五、B2/B3/B4 裁决落文：元进度.md 道具工坊行删旧写新（v1.10——旧六行登记作废、指路秘宝新目录+解锁门槛谓词分级）；奇物.md P1「两项合成高阶项」注销（v3.9——用户定性脏信息）；§3 刷新句按最新口径换代（刷新券替代、不进持有集）
六、天赋树独立成文（B1 裁决）：新建 design/gdd/systems/跨局循环/天赋树.md v0.1（33 节点机制全按 meta_tree.tres 实态+迭代 12 落籍裁决+被删底稿 git 取证——脊柱行门槛/钥石单币/Fork A/B 面/存档 v5 域/注入双通道）+元进度.md 定名节换代（v1.11）+02-系统清单跨局循环区加行（v1.17）
七、A 类卫生包：版本历史表理排四份（秘宝/奇物含 v2.7 断裂行修复/敌人系统/图生成，只调行序）+缺号注记三处（增益状态 v0.6 未考/冒险结构 v0.15/关卡节点地图 v1.6=MC-1 批）+node-reward v2.2 双号改 a/b+07 补建版本历史表+06 删「设置与本地化」空节+「文档/结构闸存量欠账」块挪文末「文档与结构」节+「L1 商店编排」两悬空指针改指 GP 换算失衡条+难度曲线两处过期指向核销注记（v0.27）+B5「现役 UI/文案两处自相冲突」登记 06 待办（battle_narrator.gd:160 旧话/hero_info_panel 两段同标「特性」——随后续迭代修）
八、命名统一（用户令「任务书」全库改「需求卡片」）：167 文件约 800 处（design/ 全部文档+roadmap+CLAUDE.md+active.md+entities.yaml+game/ 注释与数据批注）；两文件改名（需求卡片-M4数值批/需求卡片-冒险前资源配比预设批）；残留=自造短语全量清单（黑话证据文档故意跳过）
九、CLAUDE.md：批次工作流标准清单收口段新增第 12 条「文档同步闸」（需求卡片必列关联文档同步面、合并前同步完毕方算收口，原 12/13 顺延）；呈报六问铁规适用范围补立（前序批随批落籍）
十、active.md 快照节+工作日志 414-421（并行会话 416 黑话清扫条目按共享工作日志惯例一并入库）；06 中并行会话「active.md 定性与裁剪」条目未提交，按零吞并纪律留在工作区未入库

零测试（文档批两入口铁规）；主区前序脏件（.gitignore/.zcode/config.json/playnote/project.godot/.zcodeignore/美术审计报告 html 等）未带
 2026-10-09 19:12:46 +08:00
DKChan 8e02dcf05b 清理: design/存量超期批——删86件（dev四组11+qa证据39=只留最新规首跑+research 34）+引用改写17处/15文件+doc-conventions §11新增证据只留最新（v13）+美术审计报告留置呈报（工作日志 413） 2026-10-09 03:58:50 +08:00
DKChan 9556539a1f docs: P1-P3 全裁归档+光柱区表述解耦+06 新登「战斗区背景图替换」（P1 甲=溢出盒顶 N px 不裁切，判定与光柱脱钩——光柱系临时氛围层，背景插画到位后退役；P2 甲=明细带改覆盖层；P3 甲=棋盘小人不随批；art-bible §8.2/battle.md 措辞随改） 2026-10-07 06:03:11 +08:00
DKChan 0aa85ddb87 docs: 八敌立绘逐键定档 + 方案二排版批（美术线自立批讨论稿定稿，纯文档 + 管线脚本常量） 
源委=P0 收口讨论批（2026-10-06，用户令「讨论期只改文档」）——派生自 3549 次
可读性实测（24 糊/32 可读/48 清楚/64 细节完整）与用户三体型约束（钩爪恐魔>灰矮人、
灰矮人<熊地精、食人魔酋长>熊地精）+ 定档总图用户确认。

① 八敌站桩源档由「全敌共用 48」改逐键定档（tools/pixelize_candidates.py 新增
   STANDEE_TIER_H：地精36/巨蜘蛛38/灰矮人46/钩爪恐魔58/熊地精62/食人魔酋长74/
   蛛化卓尔90/灰矮人石君王94；主角 48 不变，显示一律 ×2 整数 NEAREST=72–188）。
   旧 f_enemy=48/max_h 系数退役（它把普通怪压到 21–24px、全员低于可读门槛）；
   SIZES 明确降级为「中间分辨率表」（决定中间图多细，不决定最终体量），并纠注
   ogre_chief=192 系分辨率选择非 Boss 档归属。派生管线 = pixel-1 紧裁 → 等比缩
   至各自档高 → dom_block_resize 块内众数降采样（禁走 recon / 重跑 remove_bg）。
② 排版改方案二：B 区 252→270（≈1/3 屏）/ C·D 548→530，扫雷盘 438×438 原尺寸
   不缩、格子不变（压缩由面板空档吸收）；站桩内部重排=立绘双脚落石台上缘、血条
   +状态/名字行落底排全场一线；大体档（drider/duergar_king）头部探出盒顶压进光
   柱区，血条仍落底、意图徽标压胸；「血条悬浮头顶 + 盒内居中」排式退役。
③ 体量语义修订（character-design §5.2）：强度先验 → 生物体型，小块精英与大体普
   通怪并存；§5.1 新增主角描边例外（深褐 40,19,13，浅砖面对比更高）；§5.5 登记
   钩爪恐魔「宽≥高」豁免（58 高窄条长臂束状剪影，待样张批复验）。
④ 定值单点纪律（art-bible §8 头注）：数字定值只落 §4.1 主色板 + §8.2，其余章指
   路禁复述；§4.1 新增色板 48 色上限 + 新色须与既有任一色 RGB 三通道差 ≥8。
⑤ §8.3 归档纪律（图片不入 git / 过程稿归档+对象存储 / 主文档禁引 artwork 散路径）
   + 三检查器挂点（色板检查器 / 路径核对器 / standee_asset_check 硬闸升级规格）。
⑥ 方向:=ission:24 rectifikace 地形色值对齐 §4.1（岩石 #8B755B→#C9AF83、地面
   #564232→#B39A78，两处提示词同步）；生图渠道改为「远程对话式正主 + 本地
   ComfyUI 备选」；地形瓦片改拼表制正主（三步法），分张降为回退路径。
⑦ 对账更正：asset-path-map 废路径 production/mockups → artwork/mockups；
   art-status-checklist 格子样张 ⬜→✅、受击反馈/弹道 ⬜→◐（共 ✅4/◐8/⬜3）。
⑧ 06 新登记四条：站桩帧动画（Alpha 定版闸前）/ 主角描边素材侧复核 / 3349 草稿
   dry-run 整理 / 口号型条款机检化（三档标注格式已拍板）。

纯文档 + 1 个 Python 常量表改动，未出图未动引擎代码；重产与实装归后续任务书批。
doc 三闸/冒烟未跑（讨论批：非 loop 批且用户未点名，两入口铁规）。
 2026-10-07 01:51:09 +08:00
DKChan 049aa62e2e 奇物批T8：批末重闸全绿（run_all 16套历史首次全绿+五探针绿+doc三闸零新增〔3处本批改名断链随修：奇物.md relics.tres→feats.tres×2+node-reward.md curio_pick_overlay〕+熵增闸违例=主区同款既有归archify批）+MC n200读数采完（normal 0.5%/perfect 77.5%,只测不判,autoplay门票分支修后n20与主区基线逐位一致）+出口报告终稿+07⑰人闸材料（专长兑付时点单列检查项） 2026-10-05 21:07:06 +08:00
DKChan c571af226f merge: 奇物概念收口与词族对齐（迭代15②号卡·文档与数据层） 
概念层由用户逐轮裁定定稿（《奇物》v1.0→v2.7），本批只做落地对齐。

主要内容：
- 新建 design/gdd/systems/冒险循环/奇物.md v2.7（本概念唯一定义文档）
- 新建 design/research/任务书-奇物词族对齐与渠道分离批-2026-10-05.md
  （loop engineering 八件成文 + 12 条批末验收断言 + 11 条设计契约含 6 条停机级）
- 代码词族对齐：feature_* → FEATURE_KINDS/feature_quota_*/feature_value_*
  （adventure_table.gd 24 字段 + 方法 + 常量，adventure.tres 21 键，值零变更）
- 三个 schema 补概念指路注释；relic_table.gd / adventure_table.gd 概念注释指向奇物.md
- ux/battle.md、level-map.md、HUD框架.md、06-待办清单.md、02-系统清单.md、
  registry/entities.yaml 同步称谓与元信息

六处冲突解法：
- 02-系统清单.md：版本历史整段重编（master v0.1-v1.3 原号复原，奇物系列从 v1.4 起）
- ux/battle.md：取分支侧新称谓，但「魔法道具槽」须写「秘宝槽」（master v1.3 已更名）
- adventure_table.gd：合成并集（取本批改名 + 保留 master SR-1 商店刷新三字段）
- level_map_screen.gd：块1 取 master M5 底栏结构，块2 取本批配色与称谓
- registry/entities.yaml：7 处三方混战，块1-5/7 取 master，块6 取本批
- roadmap.md：迭代 15 两卡并存（①调试 已落籍 / ②奇物 待开工）

合并后自查修正：
- 批量替换误伤 70 处（清图奖励/安全格奖励/关卡大奖励/奖励身份预读 等
  属地图战斗资源域；「奖励道具经济」旧文件名与「迭代 10 奖励重构」属历史留痕）→ 全部回退
- battle.md 历史修订行误改 → 恢复 master 原文
- 奇物.md 5 处死链（../ux/ 少一层、魔法道具.md 已更名）→ 修
- registry 条目 markdown 链接 → 改纯路径（同文件惯例）
- 奇物.md R1 散文段 656 字 → 拆段，现在零结构性告警

验证读数（合并后主区全量复跑）：
- 冒烟 755 项 / 0 失败，三闸全过
- ui_input_probe 十六断言全绿
- ui_layout_probe 四区尺寸逐位吻合 battle.md 规格
- doc_link 死链 0；doc_term 与基线同；gdd_lint 零新增
- 旧标识符残留全 0；_status_box 未成死代码，四个投喂键齐全
 2026-10-05 07:24:15 +08:00
DKChan 430419cf01 消歧更名批：魔法道具 → 秘宝（仅文档层，代码零改动） 
用户拍板 2026-10-05。命名理由：「魔法」一词在本作已被征用为敌方侧
伤害/护甲语汇（magic_bolt 魔法矢 / magic_recoil 魔法反噬 / magic 魔法族
格面微光 / ward 魔法护甲），「魔法道具」易被读成"魔法属性的道具"；
「秘宝」取"神秘·强大·稀有"义，与九件内容气质（工兵/工程/手艺向）契合，
且与局内道具（奇物）不冲突。**同调位机制名保留不变**（attunement 仍为
DND 词，机制血统不受更名影响）。

改动面（26 个文件，仅 design/ 目录）：
- 正主重命名 systems/排雷循环/魔法道具.md → 秘宝.md，正文 17 处 + v0.9 版本行
- 称谓权威源 02-系统清单：文档树行 + 命名对照表 a5 行；英文代号
  AUXILIARY_ITEMS 沿用不变（代码标识符口径，另批对齐）
- registry/entities.yaml 30 处（referenced_by 九处 / owner 路径三处 /
  存档域注释 / 承重规则段）；文件头新增 2026-10-05 注记并还原
  2026-09-16 段旧名原文
- GDD 现行文档 16 个 + 美术 2 个 + 架构 1 个
- 历史定稿加名称已变更横幅（正文不改）：同调提案底稿（现行形态设计权威）、
  同调实施批任务书
- 修复 research 内 2 处指向旧文件名的活链接（历史文档不改称谓但链接须可达）

刻意保留旧名：8 处版本历史行 + 自造短语全量清单 16 处（出口即删的
中间审计底稿，改称谓会令统计失真）。

代码层零改动（用户明令），遗留欠债 4 项待可跑冒烟批次收口：
1. 代码标识符仍为 aux_* / AUXILIARY_ITEMS（auxiliary 词根为过渡形态遗留）
2. battle_narrator.gd:117-118 仍输出"魔法道具"，且与同文件 139 行
   arch_names["magic"]="魔法" 同屏两义共现——"魔法道具"进入玩家视野的
   唯一残余通道
3. bonus_interact_controller.gd:76 清空 toast 仍写"魔法道具"
4. Godot 类名与文件名（AuxItemTable 等）改需同步 .uid 与 .tscn 引用

校验：registry 键集合前后一致（214 键零丢失零新增，仅增 7 行注记）；
改动文件正文类零残留（残留 8 处全在版本历史/换名说明内）；owner 路径
全部可达；链接检查除 2 处既有欠债（architecture.md 的 ../../design/ 多一层，
改动前即存在）外零断链。

注：局内道具名「奇物」全仓 md 零命中，本批未碰，避免两个换名批纠缠。
 2026-10-05 06:50:44 +08:00
DKChan a2ce5d7e01 奇物 v2.4：顶层定名 Wondrous Item（奇物） 
顶层概念由「奖励」改名为「奇物」（Wondrous Item）。

定名依据：DND 魔法物品九分类中的 Wondrous Item，官方中文译名即「奇物」，
是专装"不好归类但有奇效之物"的兜底杂类。选它的理由——本概念下三个分类
（规则 / 数字 / 余量）本来就没有共同点，能把它们拢在一起的只有一个
"不好归类但有用"的名字，而奇物天生就是干这个的。

落选者（都登记在 06 备查）：
- Treasure（宝物）：DMG 第 7 章正式术语，定义含 coins/gems/art objects/
  magic items，四条筛选全中，但偏"财物"，装不下专长这种
  "你会了件以前不会的事"
- Relic：roguelike 品类惯例（杀戮尖塔 / Soulbound / 铲子骑士 Pocket Dungeon /
  Die in the Dungeon，后两个明确"局内可买可捡、run 结束清零"，与本作同构），
  但用户已否决「遗物」
- 全部自造词（进益 / 造化 / 机缘 / 遇获）：用户否决

**代码词族定为 curio_* / ADVENTURE_CURIO，不用 reward_***——
reward_pick（rng 封闭流 scope）/ reward_node（grant_aux_item context）/
reward_preview（道具 kind）已占用 reward 词族，照 reward_* 对齐会撞车。
06 里原「feature_* → reward_* 对齐」待办据此改写为 → curio_*。

改名范围（文档名 奖励.md → 奇物.md）：
- 全文称谓、判据句（当局清零的是奇物，跨局带走的是魔法道具）
- 1.5 命名出处节重写（补 Wondrous Item 出处与落选理由）
- 02-系统清单：文档树行改名、ADVENTURE_REWARD → ADVENTURE_CURIO、v1.7/v1.8
- 06-待办清单：链接与称谓、三层约束表、命名统一后续条目（目标词族改 curio_*）、
  「顶层命名待定」条目改为已定
- entities.yaml：reward → curio、owner 路径、正文称谓（保护「奖励节点」）
- battle.md / level-map.md：奇物列表；HUD框架.md：奇物段先例
- 两个 schema 概念指路注释

**保护未动**：「奖励节点」（渠道名）、格面奖励 / 清图奖励 / 大奖励 /
节点奖励 / 奖励重构等历史与他概念用词——全部逐条核对未误伤。

数据层数值零变更；未 merge 回 master（本会话零测试）。
 2026-10-05 05:25:28 +08:00
DKChan 3d6078494b M9 结算屏双情绪+回看退役（UI落码第三波）——①印章52px嵌封印旗②三行账GP/钥石/本关加成(组合根投影_bonus_summary_text)③GP数字滚动0.8s守减动效④庆祝idle浮动占位⑤败徽记灰化+行维持隐藏(P-C4/OQ14)⑦粒子两套并存+调试浮窗风格开关(P-C5)；P-C7明细回看退役=settlement_review_overlay删除+band点击撤+明细回看钮撤+main.gd四处接线清+click探针两段退役+battle.md换代。闸=冒烟747/0+probe_gate全绿+layout0+fx_probe全链路通过 2026-10-05 03:23:08 +08:00
DKChan 33fcac79e8 奖励 v2.0：顶层改名 + 重构为两根轴（分类轴 × 渠道轴） 
顶层概念「特性」改名为「奖励（Reward）」。改名动因：这个筐里既装
"角色自身的变化"也装金币这类一次性兑付物，用"自身提升 vs 持有物"
已经切不开——边界判据改由生命周期承担：
  一次冒险内获得、冒险收束即清零的是奖励；跨冒险跟着你走的是魔法道具。

分类由两类扩为三个枚举（分类轴 = 给的是什么）：
- 机制类（专长 Feat）      → relics.tres
- 属性提升类（ASI，生命/AC/攻击三轴）→ adventure.tres
- 资源与机会类（命名待定：行动点上限/刷新次数/金币/回复）→ adventure.tres
  类内异质性显式登记：金币与回复是即时兑付，不进持有集、不持续生效，
  与行动点上限/刷新次数生命周期不同。

新增第 2 节「渠道轴 × 分类轴」交叉开关表：机制类主渠道＝关底 Boss
击败后（不新增节点类型），罕见旁路＝奖励节点/商店的「专长获取」；
属性提升类与资源与机会类＝奖励节点 + 商店。两根轴互不决定。

gp/heal 不再当作"该移出去的脏东西"（用户 2026-10-05 选暂不处置＝
不做结构性迁移、不动配额），改为安置在资源与机会类里并登记异质性。

同步：02-系统清单（文档树改名 + ADVENTURE_FEATURE → ADVENTURE_REWARD +
v1.5）、06-待办清单（BD 分层条目改写 + 新立「两个新种类入池」条目 +
「命名统一后续」补 feature_* → reward_* 对齐项）、entities.yaml
（feature 条目 → reward，新增 axes / 三类 categories / open_questions）、
两个 schema 的概念指路注释、battle.md / level-map.md / HUD框架.md 称谓。

未动：数据层数值与表结构（值零变更）；feature_* 标识符尚未换到
reward_*（属临时态，已登记待办，须在可跑冒烟批次收口）；game/ 下
运行层称谓换名同批。本会话按测试执行两入口铁规零测试。
 2026-10-05 03:01:13 +08:00
DKChan 5cf7f4b6ae 立《特性》概念：局内加强物品统一命名为「特性」，两种形态收敛为枚举值 + 文档/称谓/数据层标识符统一 
- 新增 design/gdd/systems/冒险循环/特性.md（概念唯一定义文档）
  定义=一次冒险内角色自身得到的提升（不是持有物）；作用范围、生命周期、
  获取途径（战场奖励/商店·训练）、关联与边界五要素齐全；数值一律指路表不入正文
- 02-系统清单：冒险循环补行 + 命名对照表补 ADVENTURE_FEATURE
- registry entities.yaml：新增 feature 概念条目（owner/referenced_by）+ adventure_table 字段名同步
- 数据层标识符 112 处换名（值零变更）：BONUS_IDS→FEATURE_KINDS、bonus_token_count→feature_quota、
  bonus_value→feature_value、token_*/bonus_*_flat→feature_quota_*/feature_value_*
- 称谓统一 94 处：旧称「流派件/数值件/本关强化」→ 特性 + 形态修饰语（规则改写型/属性加成型）
- 两张 schema 顶部加概念指路注释，代码可直接查到定义文档
- 06-待办清单：BD 分层条目现状改写 + 新增「命名统一后续」条目（relic 词族与类名对齐待实施）

未动：类名与文件名（Godot .uid/.tscn 引用需跑测试自证）、断点存档键（兼容）
 2026-10-05 01:46:35 +08:00
DKChan fd6a8325f0 TP0令牌池落地（迭代12条件卡——node-reward v2.2追认b实施批）：三选一池改固定配额令牌池70/25/3=98张（罕见档道具件2席随aux池种退役收窄=台账自决披露项；schema validate结构锚硬断言）+抽签Fisher-Yates同kind去重+选中踢池未选回池+池耗即枯竭+种类次数上限退役+恢复件+6新入池rare档+数值对全落；MC策略316-f落地（autoplay 1级最稀有/2级最左_pick_token单点）；货架=令牌级抽签价格tier-blind维持批②裁定+消费在架令牌本体；断点扩键bonus_deck余库逐枚还原（旧断点缺键=满库重建防御单版本周期）；跨表校验⑥改令牌配额检查；文档四正主=node-reward v2.4+冒险结构v0.14+registry+06落地状态；normal档重锚runsum_m4iter12_tp0_n20_20261003（seed0=90000配对读数同带0/5/0零结构位移+316-f构成佐证）——闸=冒烟670/0三闸+run_all 15套+探针五绿click存量红零新增+doc三闸零新增+熵增PASS 2026-10-04 00:17:39 +08:00
DKChan d79afd2241 迭代11第②批：GP商店房重构——三选一同构化（P1共享池账本+抽3买1全重抽+A/b乘法定价ceil+断点扩键+货架同构呈现+MC off/on分层；冒烟671/0+off对拍off_n60逐位PASS+探针三件绿） 2026-10-03 18:19:57 +08:00
DKChan a6a2bf885e 迭代11第①批：魔法道具同调实施批 T0-T10 全落（重闸 645/0 + MC off 逐位 PASS） 
- T1 表与schema：attunement_growth.tres 谓词表（m1/m2/m3+Σgrant≤slot_cap 校验+slots() 求值口径）+道具表扩列（form/charges/slot_cost/unlock_requires/effective_rounds/charge_n+effect_kinds 九kind+KEY_WHITELIST 零裸flat护栏）+七同调行
- T2 save v4（boss_kill_count 收束入账+attunement_equipped+attune_refresh_level+断点 attunement_charges+迁移链 v3→v4）
- T3 Attunement 求值服务（纯函数零 await 零 RNG）
- T4 营地装配覆盖层（工坊扩容程序占位+Y 升级行 attune_refresh_upgrade 行族）
- T5 被动六件接线+装配注入链+刷新 X/Y 双源（BonusPickOverlay 刷新钮，autoplay 默认不刷）
- T6 掘进蓄能全链+摆钟能力面（骑库存面差额注入+断点充能键）；炸格 P5 甲影响评估破面大→用户裁拆后批，blast_kit deferred 留位
- T7 退役面五件（BONUS_IDS 除名 aux_item+transitional_sync_slots 过渡键退役=迭代10欠账③清偿+授予路/四容量闸拆除+nest_pendulum 换装 active_charged）
- T8 冒烟六新断言（645/0）+MC attune 开关+贪心画像分层 off/on 各 N=60 双策略（on 画像功率显著带平移归调参批；off 新锚=对拍正主留盘主区 sim-data，81000 降批入口基准）
- T9 连带修订九件（魔法道具定位重写/元进度v1.6/地图战斗资源v0.16/行动经济v0.7/05不做v1.3/关卡节点地图v1.4/node-reward v2.2/registry 三处/06 收口+炸格拆后批新条）
- T10 重闸全绿：冒烟 645/0+熵增 PASS+doc 三闸零新增+MC off 复跑同种子逐位一致 PASS；出口人闸后移迭代 12（用户 2026-10-03 令）
 2026-10-03 15:41:30 +08:00
DKChan 1237cbf971 迭代10追认落文批：b=三档位令牌池全裁（70/25/5+细分+数值对+种类上限退役）+f=MC策略最稀有/最左改判（调研条销号）+a/c/g/d已认定（d系误会澄清钥石增量行保留）——06新条+node-reward v2.2+台账316；b/f归M-4数值批 2026-10-03 03:34:29 +08:00
DKChan a6833b6ac3 docs: 中间产物死亡清单 A/B 桶执行批——git rm 83 件(A1跟踪12+A2全部8+B1跟踪19+B2全部9含playtests/conversion-calibration/t5预览两目录)+指路句改写13文件37处改结论内联或git提交号(art-bible/level-map/07/魔法道具/HUD框架/难度曲线/关卡节点地图/元进度/entities/06/roadmap+三render脚本);删前核三过一留(alpha-acceptance-battle-screen系Alpha验收销项底单留待裁);在飞域四件挂债未碰;死亡清单补执行记录节(部分执行不自删);闸=死链4环境差+术语1既有+熵增PASS全回基线;依2026-10-01吸收即死铁律与doc-conventions§11 2026-10-02 05:39:51 +08:00
DKChan cc8807e66c iter10 目检修复批: 掷定前置落籍（用户推荐案获批）——道具件具体道具随候选抽定（_last_draw_aux/reward_pick流序内挪）+卡片直显「魔法道具/道具名·效果摘要」（_aux_card_line+Narrator aux_line参）+断点快照随载aux_detail（续玩详情不丢）+node_bonus_candidates扩dict+候选一致要求降级（冒险结构/level-clear 措辞软化——用户裁决非验收义务）+fx_shot_probe演出抓帧探针入册+目检台账收口（7/9/10/11/14机测承载或实测PASS/8项用户终裁非本迭代不追）（冒烟628/0+run_all 15套+五探针+三闸零新增+熵增PASS） 2026-10-01 16:10:11 +08:00
DKChan 4f62a489b6 iter10 追加批: 奖励节点三选一共享池（用户拍板）——AdventureRunner 节点API+AuxItems 句柄面+main 共用面分派+node_overlay 道具面退役+autoplay 节点驱动+reward_overlay_test 随面迁移+a裁备选(L3复杀3)+g裁semver(v2兼容断言+存档序列化v1.3)+f裁调研待办(06新条)+文档五件+任务书（冒烟628/0+run_all 15套+五探针+三闸零新增+熵增PASS） 2026-10-01 06:12:25 +08:00
DKChan 49b263fbc8 iter10 T1+T2: 文档批——冒险结构v0.12三层奖励框架/行动经济v0.6失同步清偿+AP加成轴/难度曲线精英登记+带重扫P1/元进度v1.5渠道改一/01核心循环/03/节点地图/06联动欠账条/registry四条目/level-clear v2三选一交互/settlement v1.1/battle钥石三面化（三闸零新增） 2026-10-01 03:26:08 +08:00
DKChan 899bd33672 docfix-b: 第五循环目录搬家批（拍板点11甲执行）——元进度.md 自冒险循环迁入跨局循环（git mv）+全仓27处指向链接改写+同目录裸链接跨目录修复9处+02-系统清单立跨局循环组与命名对照表同步+registry两owner路径同步 2026-09-30 19:51:32 +08:00