game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
2,761 Commits 23 Branches 0 Tags
master
Commit Graph
71 Commits
Author SHA1 Message Date
DKChan 986fb46e76 文档(文档清账·用户令): 全库权威文档批次账清零——08/roadmap/待办清单/architecture/ux八件/art七件/systems十八件/根清单与规约; 日期·迭代号·卡号·入库·合回·反哺号·取代链·删除线注记·历史验收读数剥离, 现行事实·权威短戳·指针句保留; 体验验证清单删核销条目与改动速览章, 死指针㊶/⑳引用改内联事实; gdd_lint零红+--changelog-only零红+死链0+pipeline_gate PASS 2026-11-04 14:54:51 +08:00
DKChan d7846e6966 文档(战斗一屏样张过闸落文·用户裁通过): 体验验证清单 ㊶ 加核销注(三项按通过处理未逐项呈报读数,连带 ㉘ 第5项群伤暗档 provisional 观感复核了结); 08-Alpha版本标准 v1.26→v1.27——五·表现样张行「部分在役」→「在役」＋未开格类型微光行复核句换代; art-bible v3.39→v3.40——§1.4 样张登记句转过闸口径; 战斗表现.md v1.2→v1.3——「前置美术测试是硬前置」节加硬前置解除句; 02-系统清单 08 行指针 v1.26→v1.27; 凭据以指路形式书写规避 R3 修订注记(日期不入裁决类括号); gdd_lint 19 文件 0 不通过＋pipeline_gate PASS＋--docs 零新增红 2026-11-04 04:25:37 +08:00
DKChan 41aa8d8b48 文档(站桩帧动画改排Beta·用户裁): 待办清单条目末句换代——2026-11-04 用户裁移出 Alpha 定版前置清单,缺口改 Beta 立项批拍板,状态改待美术设计(备选);标题「Alpha 定版闸前完成」按登记元数据禁改条款保留并在实况注明;08-Alpha版本标准 v1.25→v1.26——五·表现站桩帧动画行删除＋六·Alpha 不含新行(排 Beta,取代 2026-10-06/10-13 口径),战斗一屏样张行末句随动(该行的定版前置指称摘除,主角＋三Boss 重产依赖照旧);02-系统清单 08 行版本指针 v1.21→v1.26 顺带追平落后账;pipeline_gate PASS＋--docs 零新增红 2026-11-04 01:21:16 +08:00
DKChan b5433285b4 文档(alpha清单状态刷新·用户令): 08-Alpha版本标准三行现状换代——①营地交互重做行换代(卡④美术设计闭合=样张过审2026-10-31+v3.0现行有效卡重立,与卡⑤Esc浮窗同编迭代47待开工;删'余三前置未销号/卡⑤未编排'过期句)②真人试玩轮次行换代(未核销面=㉚–㊸待用户核销,旧句'㉚㉛未核销+迭代34三项待登记'过期——三项已登记㉜,迭代42无玩家可见改动未登记)③战斗一屏样张行待做→部分在役(规格半闭合=目标规格清单落art-bible五张规格表2026-10-30+五项实装定值与样张机检随迭代43入库;未结半=出口未达,方向稿用户目检㊶先行)——v1.20→v1.21,02系统清单版本指针随动;条目零增删,Alpha内容范围冻结不动 2026-11-01 03:13:03 +08:00
DKChan 00312e12f4 清理(GDD 实现内容·批5): 30 篇 GDD 去 124 处代码指证——能力审计纯度红项归零 
- `.gd`／`.py`／`.sh` 路径（含 data/schemas 脚本路径）、测试与探针名、代码行号、提交号全部清出 design/gdd/；唯一保留＝game/data/tables/*.tres 表索引（用户裁：GDD 禁实现内容，仅配置索引例外）
- 锻造工坊：删「现役代码事实」「实装边界」两节——实装已随迭代 23 收官、设计事实正文已有（默认值所有权／敌方攻击轴未开／存档域／满级不实装），无独有事实需迁 architecture；正文去指证并清交叉引用
- UX 三份 spec 的「> 事实源＝代码路径」体例统一改指设计件；battle／level-map／interaction-patterns 三张组件表的「现有 demo 组件／现有实现锚／状态」列改「载体」，只留状态与设计载体名
- 术语表与 08-Alpha 的事实源列去闸件路径，改指 process-conventions 运行与验证节；08 v1.19→v1.20 与 02 根索引指针随动
- 事实订正三处：存档调参表版本 6→7、数据模型样本 version 6→7（v7 锻造域已落地）；冒险结构调参表冒险表字段名按现行表结构对齐（value_segment／quota_segment）；删除「存档版本＝表结构版本常量同源」这一错误断言（实为两个独立常量）
- 架构文档的未提交改动（迭代 41 反哺落文）非本批产物，未纳入本提交
 2026-10-29 02:07:56 +08:00
DKChan b92601387e docs(08 Alpha状态刷新): 节点图行刷新收口——「关卡节点图生成」行补记超预算图随动缺口（生成图 L3 深度域 0–13 超出关卡地图屏画布屏预算约 10 层——等比缩放／滚动视口两升级路径未设计待裁，待办清单「超预算图策略升级路径」条在册 2026-10-24 登记）；「关卡节点地图」「关卡节点图重构」两行既有事实核验无漂移零改动（信息迷雾可见性迭代 34 卡④／迭代 35 卡①② 合回／㉝ 目检登记不阻塞均仍成立）；02 系统清单 08 版本指针 v1.17→v1.19 随动（v1.17→v1.18 上批漏更本批补）；条目零增删，v1.18→v1.19 2026-10-28 08:35:15 +08:00
DKChan af0e28d655 收尾(迭代38批后): 账面换代＋反哺点1-16落文＋产出物退役（用户裁「反哺落文没有问题、代拍板全部追认、卡②状态可一并更新」）——①待办清单四条完成即整删（效果引擎校验文案计数错误／明细行扩展总型收敛批／奖励节点过时表述清扫批／调试入口写死行必须在发布前删除）＋「结算明细日志行序重锚批」随卡④裁点甲出账删除＋「闸与探针存量噪声两件」拆注改名（件①产品码类型错随卡⑥出账，保留件②闸壳挂死防护＝工程直改待执行，改动面降为工具代码）；卡②条目现态由并行会话登记「gdstyle存量债全量清偿」波7承接（原「结构审查未立项小件候审」条目已并入该条），本批不重复回退；②roadmap 迭代38行换代（状态已完成（2026-10-26）／需求卡片列与实现报告列填退役保留字）＋顶部当前位迭代位与下一步两行换代＋表下加带红合并〔用户特批 2026-10-26〕注记一行；③体验验证清单新增 ㊱ 迭代38 六卡目检总清单五项（含红灯信号与结论回流；卡② 无改动不登记）——反哺点17 前提证伪：根目录 体验验证清单.md 一直存在且被 git 跟踪（414 行、㉖–㟟 逐迭代节俱全），当时误判系 Windows 中文文件名编码显示问题，故两选一裁决作废、直接按既有格式落登记；④反哺落文六处：战斗结算「扩展行」节过渡句换代为单一扩展行型+effect_id 口径（v1.0→v1.1）、08-Alpha版本标准 三选一条目改两渠道均在役（v1.16→v1.17，02-系统清单 指针随动）、ux/battle 调试浮窗与调试变体两处改发布态恒隐＋415 历史留痕加口径指引、生涯 调试浮窗两行换代、test-conventions 调试注入两层加发布态注记、code-architecture.json debug 节点副标 DS_DEBUG 门控→发布态恒隐；architecture.md §1.3 与 roadmap 重锚指路句按卡①预期零改动/随②出账；⑤退役删除十件：四份迭代38产出物（实现报告§八落笔清单已逐条出账、审计报告两项阻断均有处置记录、代拍板21条经用户追认、反哺点1-16已落文）＋六张已完成需求卡片（levelmap／效果文案／明细收敛／奖励节点／结算行缓冲／调试入口）；卡② 结构小件定点修卡与其 WIP 留存随波7 重裁保留在册，卡内对已删 levelmap 卡的链接改指 git 提交 b85b3b45/8ea7cfba；pipeline_gate 绿（51条目/39行/2链）、gdd_lint 绿、文档域闸绿（07 doc_link 基线红转绿） 2026-10-26 19:16:07 +08:00
DKChan 6376356539 docs(通关口径统一): 「通关」全库退役——主体明确短语族替代歧义单义词：单关=关卡完成、整局=冒险成功、终结统称=冒险落幕（2026-10-26 用户裁） 
改写范围：design/gdd 18+ 文件约 130 行非豁免正文＋「冒险终结→冒险落幕」13 行＋根件（体验验证清单/待办清单正文/AGENTS）。三类豁免不动：带日期历史行、待办条目标题（冻结登记元数据）、「」UI 引语（生涯页「通关局数」等玩家字样另按对外命名纪律单独裁）。术语表：「通关」「通过第 N 关」两行退役，新立关卡完成/冒险成功/冒险落幕三行，三选一行随改；退役词对照收通关/冒险终结。闸词表：doc_term_audit 收两词＋通关的引语语境豁免，此后正文误用即机检拦截。特判三处：棋盘生成「可通关」＝棋盘第三义改「可清图」；地形变异「双关同型」改「两关同型」；00-游戏概念 minesweeper 双关系 pun 义保留。计数器键名（adventure_cleared/level_clear_counts）与测量数据键零触碰。「通关口径混用」条目（2026-10-18 登记）完成即删。--docs 域闸全绿（退役词疑似现行 0）
 2026-10-26 06:05:20 +08:00
DKChan 0ed5fcf201 docs(账面同步批): 体检遗留两批改（2026-10-26 用户审核方案后发令）——A 批版本引用刷新：待办元进度闭合凭据注记 v1.21→v1.25（已复核 v1.22→v1.25 三次换代未触参数面与覆盖值通道节）＋营地卡④状态行重复段「已写卡＋已写卡」删一＋根索引四处版本滞后行（术语表 v1.23/08 v1.16/settlement-summary v1.4/camp v2.1）；B 批配额硬值摘除：奇物净删重裁句/冒险结构案D池句/node-reward 同库同池耗两处——四级档位框架与结构锚规则句保留、枚数一律改读 adventure.tres（doc-conventions 数值纪律：正文定规则取值域单位，现行平衡值不进正文）；带日期历史记载按豁免不动。待办 v2.8 旧引用一项由 navfix3 批先行消解不重复改。game 面 schema 与表值统一债留待办:685 走写卡通道，本批不碰 2026-10-26 02:44:31 +08:00
DKChan 066c808de3 docs(旧词清扫): 魔法道具/罕见两旧叫法清扫＋入退役词表防再犯，条目出账 
2026-10-26 用户裁「扫描然后修改」。事实修正：两词的失效原因与条目所记不符——魔法道具=秘宝旧中文规范名（2026-10-05 消歧更名，AUXILIARY_ITEMS 代号不变）；罕见=旧三档档位名，现行四级第三档=稀有（档名映射见 adventure_table.gd 头注）。清扫面：01-核心循环 罕见度→稀有度；地图战斗资源「极致罕见」→「出现概率极低」；node-reward v2.9 档名对齐四级框架且配额随现行结构锚更正（旧文 70/25/3=98 张已漂移——现行 TIER_QUOTAS 70/25/7/0=102，现行值指读 adventure.tres）＋MC 优先度档名四级化＋02-系统清单行 v2.5→v2.9（并修「六种令牌池」→七种）；术语表退役词对照＋doc_term_audit 词表各入两行（词表冻结的扩表入口=本用户裁决）。game/ 面残留（golden README、验证集清单、tres 头注旧档名旧总量自相矛盾）留代码域批承接。--docs 域闸全绿（07 doc_link 较基线转绿改善；回执见合并信息）
 2026-10-26 00:44:25 +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 4d03c3457c docs(关卡节点图重构): 关卡节点图生成 v1.0 落定＋关卡节点地图 v2.0 多终点换代——产出规格唯一陈述处/五旋钮参数档/深度带配池/每终点前一店，文档域闸全绿（回执 domain=docs） 2026-10-21 04:42:51 +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 6d601d23dc chore(禁写变更记录批): 版本历史节/日期批注全面废除——gdd_lint R4 反转禁设＋三工具去豁免＋48 文档删节＋game/README 流水段删＋代码注释 900 余行轨迹标签清偿（约束句保留）＋规约/skills 五层指令面同批改指 git 沿革 2026-10-20 00:22:18 +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 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 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 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 f22adb5564 docs: 落库 10-15 日间未提交文档改动——architecture.md v1.5（测试与质量域节迁入+中文化+现状同步）/ CLAUDE.md 规约导航表去 adr 指针（同 diff 删了 RNG 单点红线一行，疑似误删，由 ADR 清除批处理）/ 02-系统清单补 08-Alpha 登记行（10-13 遗留） 2026-10-15 23:02:55 +08:00
DKChan e0ec255d7c docs(gdd): 用语规范批 W1——主档五篇词面与失同步（01 篇六处+行序归位；08 篇状态行 v1.4+现状四值枚举+销号注销；02 篇三处含 08 行版本同步；07 篇 35 处流程动词换代；术语表 A 表补注销词义限定注）。03/04/05 零改动有据 2026-10-15 22:11:19 +08:00
DKChan c8bc193c77 docs(gdd): 锻造工坊 v0.5 定案落文 + C/D 改名小批执行收口（文档跟随面全批） 
A. 锻造工坊.md v0.5 定案落文（B 组 15 裁点逐裁 + 同日五点澄清）：
- 「待裁决清单」换代为「裁决结果清单（17 裁点全表）」+ 新增「工作间内容清单」两件交付
- 2a 伪裁点消解（统一伤害轴）/ 2b 随 3a 消解 / 3a 魔法护甲统一命名（「魔法甲」笔误不立别名）/ 3b 敌方攻击缺省普通（跨系统汇合点登记）/ 6 满级特效留扩展位本期不实装 / 8a 两区定名+路线行名（长剑锻造等）
- 02-系统清单.md 锻造工坊行版本注、06 实装批条 v0.5 口径、active.md 471/472 登记

B. 玩家向显示名改名小批执行收口（代码侧已由 0c93a71/0144f60 合入 master，本提交=文档跟随面）：
- 06 改名小批条状态「已完成」：C 执行路径（worktree rename-blessing-20261012→0c93a71）、D 解阻过程（smoke_all.gd:1199 断言同步）、残留肃清（blessing-residue-sweep-20261012→0144f60）三段登记
- 跟随版本行：地图战斗资源.md v0.23、增益状态.md v0.14、战斗结算.md v0.20、敌人系统.md v0.17
- 现役描述跟随：art-bible §4.6.1/§4.6.2 键名列、07 体验验证清单⑫、地图战斗资源九型字典表+设计意图句、增益状态五处、战斗结算/敌人系统各一处
- active.md：474 状态记录、第二条 472 撞号接续指针、未决面过期项（货架锻升改名）摘除

registry entities.yaml「祝福」条目登记未执行——归锻造工坊实装批术语登记面。零代码零数值改动。
 2026-10-12 07:54:46 +08:00
DKChan 73acee05e6 docs(gdd/roadmap): 迭代21需求卡片 v1.7——2026-10-12 完备性审查十一裁落地 
卡片：新增契约4补款(开发阶段无视文档层条款、禁为本批增设豁免/例外条款)与契约12(守侧=失误补偿，触发主语=当回合标错动作非在场标错旗，单格最多一次，末轮不返)；T3 六键实现口径重写(锋挂点现成不用改/守挂 _flag_miss_seen 闸后走 grant_ap mode:queue 下轮到账/限次复用 adventure_counters+关卡切换清零不升v7/散只覆盖商品购买价改键名 gp_cost_mult/聚乘算落入账前)；T0 缩至0.25d(标错机制与 boss_kill_count 消费面两项已预查结案，contingency 作废)；T5 生涯三投影整行删；V1/V8/V10/V15/V20/V21 同步；新增 §11 完备性审查裁决表。roadmap：迭代21行 v1.1/29节点/v0.4 → v1.7/33→12节点/v0.8，补开工门=U0。06/02-系统清单/元进度：状态同步，树侧实质内容收敛为纯指路(唯一事实源=天赋树.md)。
 2026-10-12 06:18:50 +08:00
DKChan 74215b66ff docs(gdd): 迭代20反哺落文批②③④——关卡大奖励换代+投放读数注记+奇物行换代（2026-10-12 用户逐裁） 
- 冒险结构.md v0.20：通关兑付=专长三选一（按档配比加权）+回血——标题/概览/框架表/生命周期图/序列图/验收/结构冻结七处换代；提升池七种表+洗牌抽取段退役移交奇物.md池结构节（案D四级104事实源单点化）；本节留结构层（共享池单例/库存=剩余令牌/reward_pick封闭流/MC 316-f/断点余库）
- 难度曲线与Boss.md v0.28：期望值带节新增迭代20投放读数只测不判注记（四级104构成+止步90/10→93/7归因曝光槽；数值零变更）
- 02-系统清单.md v1.24：奇物行状态格换代（29行=27+2/流派机制退役/案D四级104）
- 06反哺点①-④全部销号（⑤归奇物呈现条）+active.md状态记录466
- doc三闸：gdd_lint回基线3失败（全存量）；link/term零新增
 2026-10-12 03:46:46 +08:00
DKChan 8e78792678 docs(forge): 锻造工坊 A 组定案落文——四柜台承载+生命归树脊柱+攻防所有权切分+钥匙无前置（2026-10-11 用户逐裁） 
- 承载节换代：营地四柜台并排（树淬炼/锻造工坊/秘宝匣/奖励格图鉴）、攻防独立、工作间两区并列、滚动条兜底、视觉终稿归 HUD 批；道具工坊退役词清除
- 生命档移除：生命唯一入口=树脊柱生命线，工作间纯攻防（实装边界①同步）
- 攻防所有权切分：攻击唯一入口=武器路线、AC 唯一入口=甲路线，树零攻防来源（红线）；注入衔接=当前武器攻击+当前甲 AC，只按当前选中生效
- 树侧钥匙改无前置直接可点亮（原等级阈值前置随两线砍除作废；树侧 29→21 归天赋树会话交接批）
- 2c 结案（D 组核结：魔网织者在素材库表二退役名单，复活作废）+5a 结案（A② 吸收）落 17 裁点表
- 存档域改旧档废弃口径（开发阶段无迁移）
- 06 锻造工坊实装批条①③④与前置/关联换代+秘宝批 T0 核结落文；02 系统清单 v1.23 随迁
- B 组 15 裁点挂起待用户发令
 2026-10-11 23:36:10 +08:00
DKChan bafc5567f8 docs(forge): 系统更名批——武器锻造→锻造工坊（2026-10-11 用户令） 
- 设计文档改名 锻造工坊.md（v0.3 更名行落版本历史），与树上钥匙节点同名
- 全库现行指路换代：天赋树×5 链接（v0.5 机械随迁行）/元进度指路句（v1.15）/02-系统清单两行（v1.22）/06 实装批条名与归属链接/三张需求卡片/素材库符文重铸行
- 历史记载保留：提案过程稿文件名、playnote 用户原案引文、迭代 18 qa 清单、各版本历史行、06 提案专条（2026-10-06）、旧树节点名（武器锻造/护身锻造/甲胄锻造）
- 区名「武器锻造区/护甲锻造区」暂留，随承载裁决收口另改
- 机制设计零改动
 2026-10-11 22:21: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 e6e73c7cb2 docs(glossary): 秘宝.md v2.5 可读性批补齐+02 术语表登记+排雷玩法版本行（上一提交 6951632 只含清扫半批，本提交补齐白话化半批） 2026-10-11 03:57:18 +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 2eb3fbf6a4 docs(curio): 奇物.md 生存件扩容批——件表 23→27+生命比例扩签前置待办登记 06（2026-10-11 用户逐裁） 
- 石肤（on 受伤：AC +1 本场累计上限 M）——恒定减伤被否（用户裁太硬霸），改受击成长型护甲，入踩雷/受伤系 7→9
- 背水（when 生命 ≤50%：受伤额外 −N）——风险联动减伤；生命比例条件事实=实现前置需求（用户批扩签），06 新立条目登记
- 铁旗（on 标中：本轮 AC +N）——生存奖励挂正确推理，入插旗系 3→4
- 战地包扎（on 战斗胜利：回复 N）——战后通用恢复补非自爆流缺口，入战斗系 2→3
- 件表 23→27；四类占比换代=减伤2/护甲3/恢复2 对增伤8≈1:1；02-系统清单奇物行随批同步
 2026-10-11 01:11:20 +08:00
DKChan 268695b607 docs(curio): 奇物.md 自爆流扩容批——踩雷系 3→7+跨族桥+扩签三条+对账锚（2026-10-11 用户逐裁） 
- 踩雷/受伤系 3→7：爆芯（踩雷→本轮攻击+N 走面板）/连爆（同轮多雷递进加层，与疼痛记忆 combo）/爆心冲击（踩雷→全体敌 雷伤×倍率 直伤，倍率>1 结构锚——互相吃伤害系用户形态本体）/雷蜜（踩雷→回复 N，比值<1 结构锚）
- 跨族桥引信标定：挖开有旗雷格→+1 层（插旗×踩雷推理闭环，棋盘事实判定非读心）
- 扩签登记+3：本轮踩雷数计数器/被挖格当时有旗/雷罚伤害量
- 踩雷转化对账锚随批登记：净血账期望须为负、两轮压不住砍雷蜜（喂雷流 R5 甲教训同源 kill-switch）；主动/误踩不判定（用户裁：不预判玩家意图）
- 防御向两件（保险丝/安全帽）保留——双刃剑两刃相辅相成（用户裁）
- 附带修正战斗系计数 3→2（v3.0 起表头与行数不符）；件表总 18→23；02-系统清单奇物行随批同步
 2026-10-11 00:34:49 +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 621f8f466b docs(forge): 武器锻造成文批——正式设计文档 v0.1 落地+关联面同步+主区积压三件随批（2026-10-09 用户令） 
- 新建 design/gdd/systems/跨局循环/武器锻造.md v0.1：按 2026-10-07 提案 v1.1 推荐案收录定案口径（柜台就地改造/三武器三甲型独立路线/纯钥石零材料/前缓后陡/复用为主特效框架零新效果类型/六处相邻边界显式化）；17 裁点按推荐案记录+开放表在册待用户逐点裁决（推翻即改）；数值 provisional 归 M4 数值批；代码零实现
- 02-系统清单 v1.18：文档树跨局循环区+系统总表补行（无代码实现面，代号随实装批对齐）
- 元进度 v1.12：三柜台节补指路句（攻击/护甲两档路线化改造设计正主=武器锻造，落地前三档直购维持现役）
- 06-待办清单：武器锻造专条状态改已成文转正（设计正主指新文档）+新登记武器锻造系统实装批待办条（迁移面七项，状态=冻结待排期）
- 随批：active.md 立宪大裁新版（含 424-428 条）+06 大裁四条迁移（定性条/美术 P0 两条/filter-repo/奇物备忘）+提案-武器锻造系统 3 处任务书→需求卡片命名替换（命名统一批漏暂存件）
- worktree g-plan2-wforge 分支 wforge-gdd 基点 bbc849e；纯文档零测试（两入口铁规）
 2026-10-09 22:23:07 +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 442cd511a0 修复: design/结构批——diagrams 迁入 dev/architecture（案甲，熵增闸红灯清零）+旧档 GDD 引用全量摘除（31处/29文档+code/schema头注13文件+registry 5行）+doc双工具摘design/ux死路径（工作日志 412） 2026-10-09 03:29:09 +08:00
DKChan 6e05446606 docs: 道具三层重设计框架批——生命周期轴/职责分界/跨层档位/地图四档池/奇物层全落地（审查+调研落档） 
01 v1.3-v1.5（生命周期轴五档/三层职责分界/档位与获取规则=普通·优秀·稀有·传说）+行动经济v0.9 AP两账+冒险结构v0.17 GP独立资源+元进度v1.7钥石+秘宝v1.1刷新两账/v1.2机能件定位+05v1.4第14条收窄（未开格预读雷安）+art-bible v3.12微光组粒度

地图战斗资源 v0.17-v0.20：类型层身份=规划素材层（微光）/兑付形态差异化方向（案A）/四档概率结构与保底（T1攻击·T2增益GP小袋·T3回复保底·T4惊喜）/对外档名映射

奇物 v2.9-v3.4：专长体系框架级推倒（流派标签+档位作废）→基础框架18件（触发器句式+事件族五族+契约尖点）；资源=转换源+新凭证5（刷新券/储备金袋/同调电池/时沙/完美保险）；池结构与抽取案D（归档打底做翼+曝光槽2全池+1高档池）；概率与上限解耦约束+耦合问题三案登记；02 v1.13-v1.14行同步

06登记：格面负向倍率差回调⑥/GP经济换算失衡/袋装摇号/微光组粒度注记

design/research 落档七份：三层审查四份（秘宝/奇物/地图战斗资源/总览）+玩法变异调研两份（roguelike/扫雷类）+综合可选项菜单一份——均为重设计原材料

纯文档零代码——实装归后续批次；数值全 provisional 归调参批
 2026-10-08 07:16:10 +08:00
DKChan 10df8bae86 生涯设计提纲 v0.1 成文（迭代17卡④T1——五节落 systems/跨局循环/生涯.md 状态=范围草案；P0-P5 已裁结论落文+新发现待裁点 P6 营地最近冒险条带去留；02-系统清单树补行+CAREER 代号行+v1.12 版本行；纯文档零代码零测试） 2026-10-06 20:56:55 +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 b6b43ebc2f 奇物 v2.7：三个子节点正式定名（专长 / 属性值提升 / 资源） 
用户指出缺口：父节点有专名，子节点只有描述没有专名。理由站得住——帮助 /
百科 / 成就页一定会把分类露给玩家（「首次集齐 4 件专长」「三件属性值提升」），
效果描述里的指代也需要名字；卡面不带分类是**呈现面规则**，与命名是两件事。

定名：**专长（Feat）/ 属性值提升（ASI）/ 资源**——去掉「类」字后缀。
- 前两个是 DND 官方中文，且与用户 v1.1 原话一致（当时原话就是
  「属性提升（ASI）」与「专长」，v1.1 落文时被加了后缀而退化成描述）
- 「机制类」这个叫法另有硬伤：28 个成员里没一件是"机制"，实际是
  "在结算挂点上改一条规则"，读者会误解为游戏机制
- 「资源」虽偏泛，但 1.3 已有判据句托底，且是用户自己的裁定

新增 1.6 节「三层结构与命名」——用户拍板的玩家可见三层：
  一层 奇物（总称）／二层 专长·属性值提升·资源／三层 具体单件
明确写成规矩：**命名归本节，呈现归 battle.md / node-reward.md 裁决**，
并记明代码侧四套词族对应（curio_* / feat_* / asi_* / res_*）。

连带修掉批量替换撞出的七处自撞（专长（专长）、专长 = 专长、资源（资源））、
1.1 节标题的「专长：专长」、1.5 节残留的「命名待定」与旧括注、
02-系统清单文档树行的重嵌套。另把五处「这一类/这类」改为专名指代——
专名定下后仍用「这一类」指代会让读者不知道在说哪个。

同步：entities.yaml（categories 补专名与定名依据、新增 hierarchy 字段、
naming_note 记 v2.7）、06-待办清单、02-系统清单 v1.9、任务书 T3 词族目标
（顶层 curio_* 与内层 feat_* 分属两套词族）、两个 schema 概念指路注释。

数据层零变更；未 merge 回 master（本会话零测试）。
 2026-10-05 06:42:48 +08:00
DKChan 128078780f 奇物 v2.5：第三类定名「资源类」+ 回复归属定案 
父节点定为「奇物」后，Q6（第三类命名）解锁，本批收口。

一、第三类定名「资源类」（用户拍板）
四个成员——行动点上限 / 刷新次数 / 金币 / 回复——都是可以调动、可以
花掉的余量，故名资源类。「资源」偏泛（能力资源、财富资源都叫资源），
因此在两处写死判据句，这是把泛用词收回本类定义的唯一凭据：
- 1.3 节新增专属判据：**给的是可以调动、可以花掉的余量，不是角色基础
  属性的永久抬升**。拿不准时问一句：它会不会进角色自己的属性数值？
  会进的归属性提升类，不会进、变成手里多出的次数或钱的，归资源类
- 1.5 命名出处节记明该偏泛性并指回 1.3 的判据句
（1.4 是三分类总判据，1.3 是资源类专属判据，层次不同不重复）

二、回复归属定案：留在资源类，不拆第四类
理由是它与金币同为**即时兑付**、都给的是可花掉的余量，判据完全同源。
拆出去之后第四类只剩两项，且与资源类的判据重合——分类的价值在于判据
能一刀切得开，拆一个判据同源的类只会让读者多查一张表。

三、附带修掉两处结构问题
- **1.5 段末与「### 2. 渠道轴」标题粘连**（缺换行，导致第 2 节标题被
  吞进 1.5 段落里，目录层级失真）
- entities.yaml open_questions 编号跳号（缺②、含两条已解决项③⑦），
  重排为五项：类内异质性登记 / 门票四参数无事实源 / 档二不可达延后复裁 /
  charge 仅 3 件数据缺陷 / 断点存档键换名待裁
- entities.yaml naming_note 笔误：「v2.0 曾名「奇物」」→ 修正为
  「v2.0 改名为「奖励」，v2.4 定名为「奇物」」

同步：06-待办清单（条目标题、交叉表行、待拍板项由三项减为两项、现状
描述）、02-系统清单（文档树行 + v1.8）、两个 schema 概念指路注释。
全文「资源与机会类」零残留（仅 02-系统清单 v1.5 版本历史行保留原名，
按规范版本历史不改写）。

数据层数值与表结构零变更；未 merge 回 master（本会话零测试）。
 2026-10-05 05:46:54 +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 d472ef061f 奖励 v2.1：交叉表收口 + 计价物不自售规则 
一、Boss 渠道收口（用户拍板）
- Boss 渠道**只出专长**：属性提升类与资源与机会类在此均不出现
- 兑付只发生在**终局前**的 Boss；终局 Boss 不给（打赢时冒险已结束，
  无后续关卡可消费）——此前"最终关是否也给"的待定项由此收口
- 交叉表形状定为「一块独占 + 两块并行」：专长靠打赢，其余靠抽取与购买，
  两者的获取节奏由完全不同的机制决定

二、金币不进商店：写成规则，不拆分类也不开特例（用户提问）
用户问"资源与机会是否拆开？GP 是单独分类还是特判"。定为第三条路：
  **计价物不自售**——凡是以某渠道的计价物为内容的奖励，不进该渠道货架。
  商店计价物＝GP，故 GP 不进商店。
- 不拆第四个分类：分类轴回答"给的是什么"，GP 给的是余量，与 AP/刷新
  同类；按"能不能进商店"反推分类＝用渠道轴去切分类轴，两根轴缠回去
- 不开特例：特例是孤立的、靠记忆维护的；规则对所有渠道成立，将来
  任何渠道用自己的计价物当奖励内容时自动适用，不需补第二个特例
- 它是**两轴交叉处的一条约束**，实现上是货架候选构建的过滤条件，
  不是奖励自身的属性

三、待确认
- 回复当前也不在商店货架（现行 shop.tres 货架只有攻击/生命上限/护甲/
  行动点四项）。回复不是计价物，严格说不适用于「计价物不自售」——
  它不进商店是同一条规则管还是另有口径，待拍板
- 专长总量：终局 Boss 不给已定，一局确定性兑付次数＝终局前 Boss 个数
  （三关＝两次），而档位阈值是同标签 2 件档一 / 4 件档二，档二须靠
  罕见旁路补齐——归曲线调参批观察

同步：06-待办清单（BD 分层条目改写为交叉表 + 待拍板项由四项减为两项）、
entities.yaml（acquisition 收口 + 新增 channel_rule + open_questions 去重）、
02-系统清单 v1.6。验收标准补第 9 条（金币不进商店是规则结果而非分类）。

数据层数值零变更；未 merge 回 master（本会话零测试）。
 2026-10-05 03:21:56 +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 8e7acaa903 特性 v1.1/v1.2：分类重构 + 专长渠道落定 
v1.1 分类重构（用户拍板）：
- 两类由「规则改写型 / 属性加成型」改为「属性提升（ASI）/ 专长（Feat）」
- 属性提升内部再分纯属性组（生命上限 / AC / 攻击）与特殊组
  （行动点上限 / 刷新次数 / 专长获取）
- 刷新次数的作用对象是选择界面而非角色，作为例外显式登记，不进加算区
- 回答「刷新次数是否构成第三个枚举」：否——枚举轴（是什么）与
  渠道轴（从哪来）是两根轴，同项出现在两个渠道不改枚举数量

v1.2 专长渠道落定（用户拍板）：
- 专长的专属渠道 = 关底 Boss 击败后兑付；不新增节点类型，
  节点类型仍为封闭枚举五种，改动落在 Boss 节点兑付面
  （「是否扩类」悬案由此收口）
- 罕见旁路明确为「普通奖励里的专长 N 选一」，罕见且全局限量

新增待拍板 / 待观察：
- gp（金币袋）与 heal（恢复）不进持有集、不持续生效、无生命周期，
  按「自身得到提升」的定义是否仍属本类待拍板（甲案移出另立即时兑付 /
  乙案放宽定义；动池须重裁档位结构锚 70/25/3）
- 最终关 Boss 后是否也兑付专长
- 确定性渠道一局两次专长 vs 档位阈值（同标签 2 件档一 / 4 件档二）

同步：02-系统清单 v1.4、06-待办清单 BD 分层条目改写 + 新立「两个新种类
入池」条目、entities.yaml feature 条目（form → categories、新增
open_questions）、两个 schema 的概念指路注释换用新分类名。

未动：数据层数值与表结构（值零变更）；game/ 下运行层旧称谓换名
留待可跑冒烟批次（本会话按测试执行两入口铁规零测试）。
 2026-10-05 02:48:17 +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 9b920a9039 测试优化批（2026-10-03 用户裁「测试要快要准」）: ①gdd_lint 规则分域——R1/R2 豁免清单/登记/概念文体裁文件（06/07 豁 R1；01/04/05/06/07 豁 R2；R3/R4/R7 不豁免），终结算 8/8 常红零信号（perf 报告 §6.2 实证）②00-05 文档手术 12 处——R3 日期批注括注迁出正文入各文版本历史表（02/03 追加行；00/01/04/05 新建版本历史节=R4 补齐），事件出处逐行注记，语义零变更③06 分级条补模拟档触发口径行——MC/verifier 仅数值验证触发不进每次变更闸，MC 日常 normal 为主（约8分钟）perfect 仅上界读数（约56分钟）调参随跑用 --quick；余 06/07 文档 R3/R4/R7 约 62 处待 T17 在飞批落地窗口手术（两文件系其在飞编辑区，本批回避防撞） 2026-10-03 00:33:30 +08:00