From 5cb59a3bf2fe5fca8e4a34c8aac70d5d313d3f69 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sun, 11 Oct 2026 07:49:17 +0800 Subject: [PATCH] =?UTF-8?q?docs(card):=20=E9=9C=80=E6=B1=82=E5=8D=A1?= =?UTF-8?q?=E7=89=87-=E7=A7=98=E5=AE=9D=E4=BD=93=E7=B3=BB=E5=AE=9E?= =?UTF-8?q?=E7=8E=B0=E9=87=8D=E6=9E=84=E8=90=BD=E5=9C=B0=E6=89=B9=20v1.0?= =?UTF-8?q?=20=E5=AE=9A=E7=A8=BF=EF=BC=88=E9=9B=B6=E5=BE=85=E8=A3=81?= =?UTF-8?q?=E2=80=94=E2=80=94C1=E9=80=90=E4=BB=B6=E5=88=86=E9=85=8D/C2?= =?UTF-8?q?=E4=BB=A3=E5=8F=B7=E5=8D=B3=E5=90=8D/C3=E5=BC=80=E5=8F=91?= =?UTF-8?q?=E6=9C=9F=E5=88=A0=E6=A1=A3/C4=E6=A7=BD=E4=BD=8D=E6=A0=91?= =?UTF-8?q?=E6=8E=A5=E7=BC=9D=E8=B0=83=E8=AF=95=E6=B3=A8=E5=85=A5/C5?= =?UTF-8?q?=E5=A4=A9=E7=9C=BC=E5=85=A8=E9=A2=9D=E5=85=91=E4=BB=98=EF=BC=89?= =?UTF-8?q?+06=20=E5=8D=A1=E7=89=87=E6=8C=87=E9=92=88=E7=99=BB=E8=AE=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/gdd/06-待办清单.md | 2 + ...求卡片-秘宝体系实现重构落地批-2026-10-11.md | 104 ++++++++++++++++++ 2 files changed, 106 insertions(+) create mode 100644 design/research/需求卡片-秘宝体系实现重构落地批-2026-10-11.md diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index fbad352b..01439039 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -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 迭代规划冻结令覆盖，重启=用户直接发令） diff --git a/design/research/需求卡片-秘宝体系实现重构落地批-2026-10-11.md b/design/research/需求卡片-秘宝体系实现重构落地批-2026-10-11.md new file mode 100644 index 00000000..9e248ab3 --- /dev/null +++ b/design/research/需求卡片-秘宝体系实现重构落地批-2026-10-11.md @@ -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 天眼开格兑付**：按普通挖格规则全额兑付（含连锁展开与格面资源），免行动点即效果本身。