docs(card): 需求卡片-秘宝体系实现重构落地批 v1.0 定稿(零待裁——C1逐件分配/C2代号即名/C3开发期删档/C4槽位树接缝调试注入/C5天眼全额兑付)+06 卡片指针登记

This commit is contained in:
DKChan committed 2026-10-11 07:49:39 +08:00
1 parent 2a0284b506
commit 5cb59a3bf2
2 files changed
+106

No files matched your search

+2
View File
@@ -138,6 +138,8 @@
**内容**:① 新目录 12 件按「目录(重设计 v1)」实装(2026-10-11 裁:回能器删〔孤儿件〕、换装券撤〔终裁冒险中不存在任何更换途径〕、第四只手删〔净收益为零自指件〕)(数据行重建/迁移、解锁混合制——钥石购买面+解锁条件表〔由 attunement_growth.tres 改造,逐件条件随需求卡片〕、装配与同调位面、秘宝匣柜台语义、使用代价各形态实现〔关卡级/战斗级限量、转化获取三通道——见秘宝.md 设计骨架代价轴〕);② 旧数据行清理(表外四行+旧九件行+提灯行拆线+卡④接线拆除,deferred 态清零——文档与数据表的窗口期不一致随本批消解);③ 专长侧联动:`feats.tres` 27 件旧行删除(名单=素材库表二)+新专长框架实装衔接;④ 空配置验收闸(三选一池空兜底/商店空货架/装配面空目录);⑤ 池结构选型三案(概率上限解耦的耦合案随批选型)与配额数字;⑥ 效果引擎扩签核实与停手挂点;⑦ 件级跨事件状态账、秘宝参数注入面两疑似漏项 T0 核实。
**需求卡片**:design/research/需求卡片-秘宝体系实现重构落地批-2026-10-11.md(v1.0 定稿零待裁——C1-C5 已裁,2026-10-11;含逐件分配锁定表/装配不可变契约/槽位树接缝)
**归属**:[秘宝](systems/跨局循环/秘宝.md)「目录(重设计 v1)」实装 + [道具退役素材库](../research/道具退役素材库.md) 对应清理面
**状态**:待办(冻结——2026-10-10 迭代规划冻结令覆盖,重启=用户直接发令)
@@ -0,0 +1,104 @@
# 需求卡片:秘宝体系实现重构落地批(2026-10-11)
> 状态:**定稿(零待裁点,开工门=U0)**——C1-C5 经用户 2026-10-11 逐点裁决全落(裁决记录见 §10)
> 来源:06-待办清单「秘宝体系实现重构落地批」条(2026-10-10 用户令登记);设计正主=秘宝.md v2.9(裁点已清零,2026-10-11 grilling 收官)
## 1. 目标与完成定义
把秘宝从旧目录(14 行退役数据)整体换代到新目录 12 件:数据行重建、解锁混合制(钥石购买+条件解锁)、装配不可变(冒险开始前配置、冒险中零更换)、使用代价各形态(战斗级/关卡级限量、转化获取)、旧数据行与旧装配关系清理、验收闸落地。
**完成定义**:新 12 件全部可解锁、可装配、可生效且效果与订阅行声明逐件一致;旧 14 行与旧装配关系清除(开发期直接废弃旧存档,无迁移代码);护栏校验/覆盖检查/装配不可变断言全绿;冒烟全绿零回归。
## 2. 现状事实(代码级,2026-10-11 实查)
| # | 事实 | 出处 |
|---|---|---|
| F1 | 数据表现行 14 行全部为旧目录件(probe_dust/sapper_order/loot_compass/nest_pendulum/catacomb_scroll/blast_kit/venom_edge/flag_burst/nest_counter/dawn_order/dig_charge/luck_coin/pick_refresh/fog_lantern),无一行属新 12 件 | `game/data/tables/treasure_items.tres`(grep item_id=14) |
| F2 | 同调位数量=秘宝侧里程碑谓词表实时求值(Σ达成 grant clamp slot_cap)——树侧接线前的过渡基座 | `game/core/attunement.gd:24-27` |
| F3 | 消费口=spend_keystone(钥石);装配写口=toggle_attunement(装配/换装唯一写口,满位禁选) | `game/core/meta_progression.gd:351`、:59/:194/:223 |
| F4 | meta.tres 三行族现役:forge_products(:7 属性锻造三档)/workshop_items(:39 旧工坊解锁行)/attune_refresh_upgrade(:80 Y 刷新升级行族) | `game/data/tables/meta.tres` |
| F5 | 效果引擎三词表封闭:EVENTS(:20)/EFFECT_KINDS(:31)/FACTS(:38)——新件效果行只能用现役词或扩签 | `game/core/effect_engine.gd` |
| F6 | 存档 v6:meta 域含 attunement_equipped(v4,装配关系有序数组)/attune_refresh_level(v4)/tree_nodes+fork_sides(v5);旧档缺键补空 | `game/core/save_manager.gd:13/:42` |
| F7 | treasure_inventory(过渡形态关卡域库存)现役在册但机械惰性(投放渠道全退役恒空),仍被 adventure_runner 引用 | `game/core/adventure_runner.gd:601-620` |
| F8 | feats.tres 含 magic_vs_magic 死条件行(:25-33,clamp_check+matchup eq);该行所属件是否在素材库表二 27 件删除名单内=本批 T0 核对点 | `game/data/tables/feats.tres` |
| F9 | 旧件订阅行在役(淬毒刃纹=attack_commit/标中殉爆=flag_hit/惊巢反制=mine_hit 等按件声明)——删旧行时订阅行随行消亡,效果引擎零特判 | `treasure_items.tres` 各行 + `effect_engine.gd` |
| F10 | 营地秘宝匣柜台现役=解锁进度呈现+同调装配段(toggle_attunement)+Y 刷新升级行购买;树面板为程序占位 | `meta_progression.gd` + `design/gdd/ux/camp.md` |
## 3. 设计契约(违反即返工,🔴=L3 停机呈报)
1. 🔴 **装配不可变**:装配只在冒险开始前于营地配置;冒险中不存在任何更换途径(拾取与效果均不产生装配变化)——实现不得出现任何运行中装配写口。
2. 🔴 **槽位约束**:槽位共 3 格(由天赋树同调位节点提供:1=普通格/2=优秀格/3=稀有格递增),槽位可装 ≤ 槽位档位的件;每件固定占 1 格。**本批不实现槽位来源**(只留树接口接缝;无槽位即不可装配——2026-10-11 用户裁);谓词表槽位求值职责随批移除;测试经调试功能注入槽位,不走正常流程。
3. 🔴 **棋盘事实不可变**:秘宝效果不移除/不增改危险格位置与邻接数字——效果只允许信息呈现与开格动作。
4. 🔴 **真视窄域 ≤3×3**、零随机、排雷玩法零特判、危险格与安全格分布同池冻结(资源面件只动权重投影)——承重契约全条(秘宝.md 速览)。
5. 🔴 **两域正交**:秘宝件经同调位装配生效,不入局内道具背包,与奇物背包互不混装。
6. 解锁=混合制(基础件钥石购买/特定件条件解锁),逐件分配按 C1 裁决;旧「档位谓词分级」口径作废。
7. 全部数值(价格/阈值/充能数/面值)provisional——本批可投占位值,终值归调参批。
8. 🔴 **逐件分配锁定表**(2026-10-11 用户裁 C1):
| 件 | 解锁方式 | 条件(阈值 provisional 归调参批) |
|---|---|---|
| 晨操令 / 阔视野带 / 试炼镐 / 储备罐 / 巢穴预告 / 线香 | 钥石购买 | — |
| 双管装填 | 钥石购买 | — |
| 远程镐 | 条件解锁 | 通关 1 次 |
| 刷新执照 | 条件解锁 | Boss 击杀 3 次 |
| 天眼 | 条件解锁 | 通关 3 次 且 Boss 击杀 4 次 |
| 信标网络 | 条件解锁 | 真视类工具累计使用 10 次(行为条件——使用计数器随批新增) |
9. 🔴 **命名锁定**(C2):12 件代号即正式名(晨操令/阔视野带/试炼镐/储备罐/巢穴预告/线香/双管装填/远程镐/刷新执照/天眼/信标网络——11 件有效名,随 C1 表)。
## 4. 范围边界
**做**:新 12 件数据行与效果订阅行;解锁混合制与秘宝匣柜台换代;装配/充能账(各使用代价形态);旧 14 行删除与存档迁移;装配不可变与空配置验收闸(装配面部分);效果引擎接入与词表核实。
**不收件(去向)**:③专长侧 feats 27 旧行删除+新专长框架衔接→**奇物侧需求卡片另行写卡**(06 条目保留该行);⑤奇物池结构选型三案与配额数字→奇物侧(同上);④空配置验收闸的三选一池空兜底/商店空货架两部分→奇物/商店侧(本批只做装配面空目录断言);旧件玩家可见 UI 文案清扫→代码文案批(另批);槽位来源实现→天赋树实装批(本批只留接缝,C4 裁);存档迁移→不存在(C3 裁:开发期删档)。
## 5. 关联文档同步面
| 文档 | 关联点 | 同步义务 |
|---|---|---|
| `design/registry/entities.yaml` | aux_items 条目(表名/行数/字段/解锁口径全换代)+treasure_items 新行登记+attunement_growth→解锁条件表条目 | **机械面:随批更新** |
| `design/gdd/06-待办清单.md` | 实装批条状态(已开工/已入库)、magic_vs_magic 交叉核对结果销号 | **机械面:随批更新** |
| roadmap | 秘宝实装批行状态 | **机械面:随批更新** |
| active.md | 批次状态记录 | **机械面:随批更新** |
| `design/gdd/systems/跨局循环/秘宝.md` | 逐件效果格归属与使用代价形态登记、表名换代、解锁条件表实录 | **设计权威:反哺点**(实现报告列明,用户裁决后另批落文) |
| `design/gdd/systems/跨局循环/元进度.md` | 秘宝匣行实现态、同调装配段呈现 | **设计权威:反哺点** |
| `design/gdd/ux/camp.md` | 秘宝匣柜台呈现细则(解锁购买面/条件解锁状态/分档呈现) | **设计权威:反哺点** |
| `design/gdd/systems/表现与支撑/存档序列化.md` | 迁移规则(v6→v7 若扩域) | **设计权威:反哺点**(若本批扩存档域则随批机械更新+文档换代归反哺) |
## 6. 任务卡
| # | 任务 | 估时 |
|---|---|---|
| T0 | 现状复核与四项核实:X/Y 字母与两账对表;magic_vs_magic 所属件×表二名单交叉核对(决定武器锻造批③是否作废);效果引擎扩签清单(12 件效果逐条比对 EFFECT_KINDS——缺词列扩签面与停手挂点);件级跨事件状态账/秘宝参数注入面两疑似漏项核实;真视使用计数器接入点核实(信标网络行为条件的数据源) | 0.5d |
| T1 | 数据层:treasure_items.tres 新 12 行(订阅行 on/when/do+档位+使用代价形态+解锁方式字段)重建;旧 14 行删除;attunement_growth.tres 改造为解锁条件表(游玩里程碑/行为计数行——槽位求值职责移除) | 1d |
| T2 | 核心层:解锁服务(钥石购买走 spend_keystone/条件解锁读解锁条件表);装配扩档位格约束(toggle_attunement 校验件档≤格档)+槽位树接口接缝(默认 0、调试注入面);充能账各形态(战斗级/关卡级限量按周期重置、转化获取积点账本、常时件零账);装配不可变(运行中零写口) | 1.5d |
| T3 | 效果引擎:12 件订阅行接入与行为对拍(每件配最小行为断言);扩签词表落地(T0 清单若需);停手挂点 | 1d |
| T4 | 呈现:秘宝匣柜台换代(钥石购买钮/条件解锁进度/分档装配呈现/槽位档位显示);旧件文案清除;装配不可变(无任何运行中调装入口) | 1d |
| T5 | 存档面:旧存档直接废弃(开发期删档,C3 裁——零迁移代码);attunement_equipped 域保留、写新件 id;treasure_inventory 惰性面随批拆除或保留注记 | 0.25d |
| T6 | 验收闸与冒烟:护栏校验(真视≤3×3)/覆盖检查(三方向)/装配不可变断言(冒险全程快照)/装配面空目录合法态断言/全量冒烟回归 | 0.5d |
| T7 | **文档同步闸**:机械面五件更新完毕+反哺点四条逐条列明待裁决;轻闸全绿后合并 | 0.5d |
合计 6d(区间 5-7d;超 8d 触发切分预案:T3 效果引擎拆独立批)
## 7. 验证闸
轻闸=冒烟全绿+本批新断言全绿;重闸=全量冒烟;实现级 UI 终验归用户目检(两入口铁规:仅 /iter 开发与用户点名跑测试)。
## 8. 异常分级
L1 自救(表值/文案/断言微调);L2 记录继续(效果引擎缺词且可绕行——登记并走现役词表达);L3 停机呈报(触碰 🔴 契约/迁移数据丢失风险/树批次时序冲突)。
## 9. 代拍板白名单
- 各件解锁条件表行值与价格的 provisional 占位值(结构按裁决,数值微调不呈报);
- 订阅行 on/when/do 的等价实现细节(词表现役集内);
- 冒烟断言的种子与夹具选择;
- 文案措辞(不改变效果语义)。
## 10. 裁决记录(2026-10-11 用户逐点裁,零待裁点)
- **C1 逐件分配**:按推荐分配表(契约 8)——普通档全钥石购买、优秀档钥石+条件混编、稀有档全条件(含信标网络行为条件示范)。
- **C2 正式命名**:代号即正式名,随目录锁定;日后改名由用户另行提出。
- **C3 存档迁移**:不存在迁移问题——开发期直接删除旧存档,零迁移代码。
- **C4 批序/槽位**:本批只开发秘宝相关功能;无槽位即不能带;测试利用调试功能注入,不走正常流程(谓词表槽位职责移除、批序问题消解)。
- **C5 天眼开格兑付**:按普通挖格规则全额兑付(含连锁展开与格面资源),免行动点即效果本身。