Commit Graph
9 Commits
Author SHA1 Message Date
DKChan 7e5b6d99b4 秘宝批T5组B-2:ConfigDB注册键treasure_items/持有变量/五访问器全族+调用方+桩表+loaded取键同步(冒烟755/0;run_all对照基线零新增——reward_overlay_test红系②批遗留基线红,treasure_items_test由红转绿系本批修复T4桩回退行漏改) 2026-10-05 08:34:57 +08:00
DKChan 2532c8fceb 秘宝批T4组B-1:aux_items.gd/aux_item_table.gd/aux_items.tres/aux_interact_controller.gd 四文件+类名→treasure词族(.uid稳定/.tres ext_resource同步/--import重刷,冒烟755/0) 2026-10-05 08:29:32 +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 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 c25e8bab3e T1机制件基建(迭代12双层BD——relic_table+档位激活引擎+机制件带池接线):RelicTable schema新建(relic_id/rarity三档对齐令牌池/archetype七流派标签/hook挂点枚举23点位/effects键白名单零裸flat同族护栏+扫雷触发点铁律=有行流派各≥1扫雷端〔部分填充合法·七流派全量归T7出口〕);RelicsEngine纯函数引擎(集2档一/4档二/散件保底·成型=tier≥1·挂点投影表序稳定);relics.tres空表合法态(池98张零扰动硬断言);池接线=relic活行每件1张入稀有/罕见档(common/rare→rare·rarest→rarest·永不入普通档)+令牌身份键relic_id(同档多件可同屏)+兑付入持有集先校验后摘牌+_relics冒险级跨关携带+断点扩键relics持有集/余库relic_id随还原+摘要additive键relics(清账前快照——pool_stock同坑预防)+RUNSUM行relics字段;呈现=relic卡「流派件·流派名」+卡片id三段复合键;autoplay读数面;冒烟14新断言(空表零扰动/引擎四断言/接线含断点往返)→684/0+run_all 15套全绿 2026-10-04 00:39:26 +08:00