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
36 Commits
Author SHA1 Message Date
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 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 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 d54cbed7a5 docs(registry): 注销 design/registry 两处 yaml——GDD 现在时指针 76 处改指真权威＋地形变异/存档序列化/数据配置等同批换代＋iter31 反哺点 §三 registry 节删除＋doc_term 登记 registry 退役词 --strict 零疑似现行 2026-10-19 19:57:00 +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 4688d09627 fix(presentation): 奇物呈现修复批——C 区/关卡页聚合行退役改逐件行「件名 ×N」+卡面摘族名（僵尸呈现整改，呈现改法=甲）+07/报告§五.5/battle.md/README/06 条收口移除+反哺点⑤销账+475 号状态记录 2026-10-12 08:04:16 +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 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 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 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 5dde454b54 docfix-a: 文档卫生批（拍板点10甲执行）——GDD审计口径冲突逐项回写21文件：6/9/1勘误/三关序列/难度带现行口径+判读口径行重建/库存已随迭代7落地/封印黑现行/载体退役留档/SCHEMA_VERSION=2/图上点击唯一通道/敌型四型/refresh_cap表值口径等+八文版本史数值升序重排 2026-09-30 19:38:53 +08:00
DKChan cf5d8a0974 settle-fix: 拍板点2闭环补齐批——①命名变体全量收口：战斗结算画面(battle:113-114/关卡节点地图:86:166/level-map:140)+战斗胜利总结结算四字变体(level-clear三处)+摘要结算画面(冒险结构两处)全改正名并指路spec；②载体实态修正：冒险总结结算=同一battle_end_overlay双形态(末关通关=open_victory金蜡封+GP行/倒下放弃=open_defeat)，无独立冒险终局面板实体；③spec口径节变体清单扩至五项+06体例豁免注记；④报告总清单1.5行改已落地+B类①行标已裁；doc死链闸=新文档零死链(3处均既有基线) 2026-09-30 15:47:52 +08:00
DKChan bd82229559 ux-spec: 拍板点2收口批——用户裁丙（两面分节+纯呈现轻量）：新建 ux/settlement-summary.md v1.0（战斗总结结算/冒险总结结算两节+命名收口+GP钥石分工+禁重复展示，零新概念）+02索引补两行(settlement-summary/node-reward补登)+battle.md OQ14与level-clear OQ1/OQ3改指路并退役结算画面旧措辞；报告拍板点2改已裁记录(甲乙循环错位否决+呈报反思) 2026-09-30 15:21:56 +08:00
DKChan a5832af946 concept-fix: 拍板点1收口批——用户裁决甲=同调终局方向：魔法道具.md 定位沿革节(现行=切片期过渡/终局=局外同调件/底稿=attunement提案八拍板)+口径回写(罗盘退役/投放覆盖豁免面/解锁门控/预读集/验收)+关卡节点地图与registry节点奖励词条改现行三选一口径+元进度工坊行+node-reward过渡注记+battle.md清不立spec旧拍板+06销节点奖励spec条立同调实施批条；审计报告拍板点1改已裁记录+C29冲突条(同调vs迭代7)+拍板点8并行落实注记 2026-09-30 14:11:14 +08:00
DKChan 9d69c7ef4b docs(art-bible): v3.0 中修批(案B 用户拍板)——明度分层/色牌降级/语义色域限定/装饰解禁/舞台正面目标/整屏样张闸/全局对比度/字号字重/档位方向;连带六文档+06三挂账 2026-09-29 17:59:03 +08:00
DKChan 30002f85fd docs(ux): T1 level-map 形态升格独立屏批——规格先行（M-2 迭代 3 首卡） 
用户裁决落规格：独立屏=最终形态，覆盖层实现定性=测试阶段形态。level-map.md：Status/覆盖范围/到达方式/Navigation Position「模态覆盖层形态（暗幕 0.6 底层透出）」全量改写「独立屏独占呈现（战斗屏宿主整体隐藏零透出）」+Layout 屏底（BG_ROOT+石纹底噪=M-1 框材件）+Transitions 独立屏淡入 200ms（alpha 非明度——§2）+AC「模态纪律」改「独立性断言」（激活期战斗屏隐藏/战斗节点提交后恢复/兑付覆盖层关闭后本屏恢复）+节点商店覆盖层本屏域内弹出语义明确+实现锚改名 level_map_screen.gd+修订记录。interaction-patterns pattern 6 When-NOT-to-Use 补独立屏退出注记（node/shop 域内弹出仍属）；battle.md 三处「选路覆盖层常驻形态」措辞随改；level-clear.md 核对零改（其覆盖层措辞指自身形态）。战后回图/零自动推进语义零改动——改的只是呈现形态。
 2026-09-28 06:20:23 +08:00
DKChan e440360ea5 feat(art): 封印黑批(用户拍板 2026-09-28)——封印色 封印紫 #7C3AA8→封印黑 #000000(紫与微光蓝族色相冲突,黑无色相天然合规):UiKit.SEAL_PURPLE→SEAL_BLACK+board_view/board_fx_view 换色+胜利彩带紫位改亮金(紫赤 Boss 独占不入装饰)+样张脚本同步(旗面/图例/UIKIT 键)+字体素材路径随迁目录收敛(artwork/ui-reuse);文档七文件现行规则改封印黑(圣经 §4.1 条目重写+v2.11 行/character-design/comfyui/远程单 purple→black 十六进制重锁/清单/battle.md),历史注记与 v2.10 行按 ADR 纪律留痕不改;冒烟 557/0+ui_probe/ui_input_probe PASS+样张机检 12/12+doc 三闸零新增 2026-09-28 02:57:26 +08:00
DKChan 5c8c3f5d98 docs(ux): 关卡画面 UX spec 建档——ux/level-map.md 占位升格版(信息层级五层/三停点布局/组件清单/GP 常驻徽章/交互映射/AC)+三项设计提案挂 06 待拍板(HP 常驻读数/图上点击选路/放弃二次确认);停点标题措辞修正清偿台账 143 遗留;HUD框架 屏级权威按屏分治+义务清单挂指针;02 入册 v1.1;battle/level-clear 导航行互链(doc_link 死链 0/已知 0;gdd_lint 失败集=基线 8 文件零新增;term 疑似 1 既有) 2026-09-27 15:36:21 +08:00
DKChan b18819f45f docs(ux): UX 文档欠账处置批——battle.md 四幽灵引用处置(player-journey 不建/accessibility 改指 HUD框架/node-reward 挂魔法道具内容重定批/level-clear 建档)+胜利导航残留按代码实态修正;新建 ux/level-clear.md 义务锁定版;HUD框架 幽灵措辞改指设置与本地化;06 登记 GP 归属不一致待拍板+节点奖励屏 spec 债挂内容批;02 补 ux/ 目录入索引;doc_link_known.txt 欠账 4 行清空(doc_link 死链 0/已知 0;gdd_lint 零新增;熵增闸 PASS) 2026-09-27 14:35:07 +08:00
DKChan 7f24b640ea refactor: production 解散+docs 并入 design+tests 归 game 三层收敛——active.md/roadmap/stage/review-mode 升根目录;qa 报告→design/qa(gate-checks/alpha 验收/任务书→research);docs/→design/dev+registry 并档+散提案→research;tests/→game/tests(空架子 README+示例,真测试在 game/smoke);game/tools→tools+样例输出→sim-data;qa-data→sim-data;design/ux→gdd/ux;删 loop-dashboard.html(可再生成)+route_overlay_preview(零引用);钩子三件+loop_dashboard/balance_verifier/render_sample_sheet 路径随迁;断链修复 12 文件,余 7 条全为搬前幽灵链 2026-09-27 04:56:27 +08:00