game-group/gplan-2
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
909 Commits 23 Branches 0 Tags
8e2694de4998323d47ffdd4f0e79a9a1ab25b781
Commit Graph
17 Commits
Author SHA1 Message Date
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