Commit Graph
12 Commits
Author SHA1 Message Date
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 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 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 5dde454b54 docfix-a: 文档卫生批(拍板点10甲执行)——GDD审计口径冲突逐项回写21文件:6/9/1勘误/三关序列/难度带现行口径+判读口径行重建/库存已随迭代7落地/封印黑现行/载体退役留档/SCHEMA_VERSION=2/图上点击唯一通道/敌型四型/refresh_cap表值口径等+八文版本史数值升序重排 2026-09-30 19:38:53 +08:00
DKChan dfd2eac0f2 rulings-4a-4b-5: 三裁决执行——①4A=乙+元进度配套:新建 ux/camp.md v1.0(存档级呈现面:三柜台/钥石徽/退役封存件状态语义)+元进度解锁双入口节更新(spec指路+9A终稿已落)+node-reward:22悬空指认修复;②4B=甲+乙:新建 ux/shop.md v1.0+关卡节点地图商店覆盖层呈现编排小节+level-map不覆盖清单对齐;③拍板点5=三分工原则(GDD概念/ArtBible美术/UX设计)裁甲:HUD框架立「可挖域指示(接触带微光)」节(五要素,生命周期按代码实态set_dig_glow_enabled=挖掘期门控)与类型微光成对;④新增拍板点11呈报=元进度树位结构性问题(用户立项,三案:甲第五循环目录/乙域声明/丙仅索引;分析三实据)⑤02索引补camp/shop+报告4A/4B/5收口记录+孤儿清零+流程义务段更新;doc死链闸=新文档零死链 2026-09-30 16:38:41 +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 9d69c7ef4b docs(art-bible): v3.0 中修批(案B 用户拍板)——明度分层/色牌降级/语义色域限定/装饰解禁/舞台正面目标/整屏样张闸/全局对比度/字号字重/档位方向;连带六文档+06三挂账 2026-09-29 17:59:03 +08:00
DKChan 70deba153c docs(ux): T5 文档回填——level-map OQ4 视觉终稿收口+art-bible v2.14 冻结落文+M-2 出口闸检查单 2026-09-28 14:01:25 +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 754df5c13d docs(ux): 关卡画面三拍板收口——底栏=状态展示(生命/属性/本关已选加成三组常读,布局决策4)+图上点击为唯一选路通道(候选按钮退役,布局决策2)+放弃二次确认定稿(布局决策3);信息层级六层/组件/States/交互/数据锚/AC/线框随改;06 拍板点条目解决移除(doc_link 死链 0/已知 0;gdd_lint 8 文件=基线;term 215+1 既有;熵增闸 PASS) 2026-09-27 16:28:30 +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