docs(reqcard): 专长秘宝实装批需求卡片 v1.0——T0-T11+五待裁点(2026-10-11 用户发令写卡)

- 设计前置检查过:奇物 v3.15+秘宝 v2.8 裁点清零
- 现状事实代码级考证:Boss 通关兑付=提升三选一属换代非新增(adventure_runner.gd:44);kind=relic 路由/凭证三计数器/断点扩列先例在役
- T0-T11 十二卡 ≈14-18d,切分预案四迭代窗口;五待裁点 Q1-Q5 待 grilling
- 06 实装批条目登记卡片指针+状态升级;active 452
This commit is contained in:
DKChan committed 2026-10-11 07:20:09 +08:00
1 parent 2ab1aa5316
commit 2a0284b506
3 files changed
+91 -1

No files matched your search

+1
View File
@@ -49,3 +49,4 @@
451. **专长件第一版命名批——九件代号换代+对外命名纪律登记(2026-10-11,用户令「对外命名不要有雷跟插旗相关名词……插旗系用封印、踩雷系用陷阱/怪物巢穴」并圈定第一版命名;worktree feat-naming-v1,主会话直执,纯文档零测试)**:①**纪律立尺**(术语表新增「对外命名纪律」节 v1.6):「雷/插旗」及相关字面禁入对外命名——对外世界观=探索/挖掘地下城、「扫雷插旗」仅系内部用语;插旗对外=封印、危险格对外风味=地下城陷阱/怪物巢穴(巢穴仅风味层:清巢者出处/美术纹样);适用=件名/显示名/UI 文案/成就百科;机制文档内部用语(旗/标中/踩雷)不受限。②**九件换代**(奇物.md v3.15):插旗系=旗语回响→封印回响/猎旗手→封印匠/铁旗→封印桩;踩雷系=爆芯→陷阱本能/连爆→连环陷阱/爆心冲击→陷阱爆发/雷蜜→血蜜;跨族桥=引信标定→破封一击;迁入登记=标中殉爆→封印爆裂;对账锚行随改(血蜜);示警烟火/疼痛记忆/保险丝/见血开窍/石肤/背水/爆破会计保留(无雷/旗字)。③历史版本行引用旧代号留痕不动;现行正文终验零残留。
450. **第四只手删除批+跨域概念撤回(2026-10-11,用户推导质询「带上它 4 个秘宝和没带上 3 个效果等同」;master 3e2ae8f)**:①**主会话两处错误认账**:a=净收益算术错误——上轮把系统送的槽当净增量(3→4 件),漏扣件自身占位,用户算对=占一槽换一槽 3=3、且自锁唯一稀有格(它自己是唯一能进稀有格的候选),严格劣于任何真秘宝=必删;b=「跨域」系过度引申——用户 Q2 裁决原话只是「只有 2 和 3 会影响槽位」(事实陈述),我引申成树对槽位的所有权排他,用户澄清树与秘宝同为角色属性贡献者,概念撤回。②执行=第四只手删除(稀有档 3→2、全目录 13→12 件五处换代);「归天赋树管」措辞改中性「由树节点提供」(道具从哪来节);速览/负责表上限表述改「固定 3 格」;效果轴容量扩展格改空位;残余「第四只手」命中均为空位成因注记与版本行(合法)。
451. **裁撤草案入库+设计复查收官(2026-10-11,用户令「移除的件放素材库作参考+复查是否还有设计问题」;worktree glossary-batch)**:①素材库新增表四「新目录裁撤草案 3 件」(回能器/换装券/第四只手——从未实现的成文草案,裁撤原因各注,回收三关同规);②设计复查终扫=巢穴预告冗余风险事实核查通过(HUD 只显示剩余安全格计数、无危险格总数呈现——巢穴预告给出盲赌公式的关键输入 |M|,有真实作用);同档不支配复检无违规(晨操令 vs 双管装填系跨档递进不违规);其余件无孤儿/自指结构;③结论=设计侧无待讨论问题,剩余开口全部有闸(正式命名归用户/逐件分配与逐件归属归需求卡片/数值归调参批/退役词表清扫 handoff 已交付);写卡待用户发令。
452. **专长秘宝实装批需求卡片成文(2026-10-11,用户发令「可以进行文档的更新落地」=写卡段开工;worktree reqcard-curio-batch,主会话直执,纯文档零测试)**:①**设计前置检查过**:奇物.md v3.15(设计+裁定+命名清零)+秘宝.md v2.8 裁点全清,满足设计定稿前置。②**写卡前代码考证**(新事实三件):Boss 通关兑付现役=提升三选一(adventure_runner.gd:44 信号注释非末关恰一次)——目标设计=专长三选一+回血,**属换代非新增**(此前呈报为「接线」,卡片订正);kind="relic"→_feats 持有集路由在役(:411-440),属性类走 CURIO_APPLY_ROUTES 声明式;凭证三计数器(保底/限购/出现 :93-95,:819-826)+断点扩列先例(:218-219)在役。③**卡片**:design/research/需求卡片-专长秘宝实装批-2026-10-11.md——T0-T11 十二卡 ≈14-18d(超软盒,切分预案=四迭代窗口 A 引擎池/B 专长内容/C 兑付存档/D 秘宝),五待裁点 Q1-Q5 待 grilling(Q1 Boss 兑付换代 vs 追加〔荐换代〕/Q2 秘宝命名代号占位〔荐〕/Q3 秘宝逐件解锁分配/占位期全钥石〔荐〕/Q4 数值占位策略〔荐 GDD 锚内占位〕/Q5 迭代切分);同步面=机械面五件+反哺点五文档;设计契约七条含 🔴 词表封闭/层级纪律/棋盘事实不可变。④06 实装批条目登记卡片指针+状态升级写卡段进行中。⑤下一步=grilling 多轮清零 Q1-Q5,卡片成立后待编入迭代。
+1 -1
View File
@@ -142,7 +142,7 @@
**状态**:待办(冻结——2026-10-10 迭代规划冻结令覆盖,重启=用户直接发令)
**进展注记(2026-10-10)**:数据文件面本批不依赖武器锻造线;**槽位面依赖修正(2026-10-10 设计骨架批后)**——同调位数量与品质的语义已裁归天赋树同调位节点(树侧接线归天赋树线/天赋树实装批),本批与该批存在槽位定序点(先树后宝或合并评估,随排期裁),现役谓词表求值作为本批落地前的过渡基座仍成立;秘宝体系文档正确性检查已过(五文件交叉核对:仅 registry 三处现行旧称「魔法道具」残留,已随检查批修正;其余命中均为版本历史与更名记载的合法引述)——**检查通过;设计侧裁点经 grilling 审查轮+设计骨架批已清零(秘宝.md v2.3),按三段流程设计段完成,写卡待用户发令**。两条线交叉核对点一处随本批 T0:feats.tres 的 magic_vs_magic 条件值所属专长件是否在素材库表二 27 件删除名单内(若在,武器锻造实装批③「改值复活」随之作废)。
**进展注记(2026-10-10)**:数据文件面本批不依赖武器锻造线;**槽位面依赖修正(2026-10-10 设计骨架批后)**——同调位数量与品质的语义已裁归天赋树同调位节点(树侧接线归天赋树线/天赋树实装批),本批与该批存在槽位定序点(先树后宝或合并评估,随排期裁),现役谓词表求值作为本批落地前的过渡基座仍成立;秘宝体系文档正确性检查已过(五文件交叉核对:仅 registry 三处现行旧称「魔法道具」残留,已随检查批修正;其余命中均为版本历史与更名记载的合法引述)——**检查通过;设计侧裁点经 grilling 审查轮+设计骨架批已清零(秘宝.md v2.3),按三段流程设计段完成;**需求卡片已成文(2026-10-11 用户发令)**:design/research/需求卡片-专长秘宝实装批-2026-10-11.md(T0-T11 ≈14-18d,五待裁点 Q1-Q5 待 grilling 清零;奇物侧设计+命名+裁定齐备〔奇物.md v3.15〕)——状态升级=写卡段进行中,grilling 清零后成立**。两条线交叉核对点一处随本批 T0:feats.tres 的 magic_vs_magic 条件值所属专长件是否在素材库表二 27 件删除名单内(若在,武器锻造实装批③「改值复活」随之作废)。
#### 效果引擎条件事实扩签——生命比例(背水实现前置需求)(2026-10-11 用户批登记)
@@ -0,0 +1,89 @@
# 需求卡片:专长秘宝实装批
> 2026-10-11 立卡(用户发令写卡)。设计前置检查:奇物.md v3.15(设计+裁定+命名清零)与秘宝.md v2.8(设计骨架+拾取渠道终裁)裁点全清零,满足设计定稿前置;本卡承接 [06-待办清单]「秘宝体系实现重构落地批」条目全部七项并并入本会话新增面(Boss 兑付换代/凭证五件/生命比例扩签/池结构案D 实装)。
## 1. 目标与完成定义
把奇物(专长/属性值提升/资源)与秘宝两套新设计从文档落进代码与数据表:新专长 27 件替换旧 27 件、资源凭证件表(新 5+留任 2)替换旧四项、池结构按案 D 换代(曝光槽 2+1+令牌语义+概率上限解耦)、Boss 通关兑付换代为专长三选一、秘宝 15 件实装与旧数据行清理。
**完成定义**:①新 27 件专长全部可触发、行为与订阅行声明一致(MC 对拍留证);②池结构与四级档位按案 D 运转;③Boss 通关=回血+专长三选一;④秘宝 15 件可解锁、可装配、可使用;⑤旧 27 件/旧道具件数据行清零;⑥冒烟全绿+run_all 全绿+换代后 MC 新基线落档。
## 2. 现状事实(代码级,开工自行复核)
1. `game/data/tables/feats.tres` = 旧 27 件行(feat_id/display_name/rarity/triggers 各 27 实证),订阅行 schema(on/when/do)在役。
2. `game/core/effect_engine.gd:20-44` 封闭词表:EVENTS 16 / MINE_EVENTS 7 / EFFECT_KINDS 24 / FACTS 9 / OPS 10;`:106` 加载期 assert 出域即拒。
3. `game/data/tables/adventure.tres:8-22` 旧三档配额结构(curio_quota_attack_common 18 等);`:31-34` 凭证四参(chance 20/quota 2/limit 1/pity 5);`adventure_table.gd:22` 注释仍写旧资源四项。
4. `game/core/adventure_runner.gd:44` Boss 通关兑付=**提升三选一**(信号注释「非末关通关恰一次」)+部分回血——与目标设计(专长三选一+回血)不符,属换代非新增;`:411-440` `_apply_curio_pick`:kind="relic"→`_feats` 持有集、refresh→`_attune_refresh_x`、属性类走 CURIO_APPLY_ROUTES 声明式路由(新加算类零代码);`:93-95/:819-826` 凭证保底/限购/出现三计数器在役;`:218-219` 断点扩列先例(feat_ticket_pity/sold)。
5. `game/data/tables/treasure_items.tres:76,111` 淬毒刃纹/封印爆裂(原标中殉爆)两行在役待迁。
6. 冒烟基线 840 项 0 失败(design/qa/iter19-card0 出口报告);MC 链=adventure_monte_carlo.gd+analyze_playtest.py 聚合。
7. 06 在册:秘宝实装批条目(七项,冻结)、生命比例扩签前置条、旧 MC 行为锚作废重锚归数值批条。
## 3. 设计契约(违反即返工;🔴 触碰=L3 停机呈报)
1. 🔴 效果引擎四词表封闭——扩项只走本卡 T1 扩签任务,禁绕过加载 assert 运行时直加。
2. 🔴 层级纪律:奇物不入同调位、秘宝不入当局随机渠道(adventure_runner.gd:85 注释承载面)。
3. 🔴 棋盘事实不可变(秘宝 v2.4 承重契约):危险格位置/邻接数字不得移除增改。
4. 配额是结构锚:令牌数与档配额改动须用户重裁(TP0 纪律)——本批换代系已裁换代,换代后的新配额数字如需偏离 GDD 占位须呈报。
5. 排雷玩法零特判:对侧代码零为奇物/秘宝而写的分支。
6. 对外命名纪律(术语表):无「雷/插旗」字面;插旗=封印、危险格=陷阱/巢穴(风味层)。
7. 数值纪律:全部 provisional 归调参批;占位值不得超 GDD 结构锚描述的形态。
## 4. 范围边界
做:T0-T11 所列(专长 27 件换代/凭证件/Boss 兑付换代/池结构案 D/秘宝 15 件/旧行清理/存档与 MC 适配)。
不做:秘宝解锁条件逐件分配的正式数值(占位先行)、正式命名之外的第二轮命名、武器锻造实装(另批)、配额正式数值扫描(归数值批)、game/ 内 UI 文案旧词清扫的与实装无关部分。
不收件去向:命名二轮/数值批/锻造批均已在 06 在册,本批不新增登记面。
## 5. 关联文档同步面(同步闸 v2)
| 文档 | 关联点 | 同步义务 |
|---|---|---|
| registry entities.yaml | curio/feat/adventure/relics 行、kind 词族 | **机械面**:随批更新,合并前完毕 |
| roadmap.md | 迭代行(编入后)/本批进度 | **机械面**:随批更新 |
| game/README.md | 数据表清单与批节 | **机械面**:随批更新 |
| 06-待办清单 | 实装批条目状态/生命比例前置条 | **机械面**:随批更新(开工=已开工,收口=已入库销号) |
| tools/balance_verifier.py | 「道具工坊」旧称(在册残留) | **机械面**:随批顺带 |
| 奇物.md | 实装后行为与数值反馈 | 反哺点:迭代实现报告列明,用户裁决后另批落文 |
| 秘宝.md | 实装反馈(解锁条件表/使用代价形态落地实态) | 反哺点:同上 |
| 冒险结构.md | 「关卡大奖励」节陈述(通关两层兑付→回血+专长三选一) | 反哺点:同上 |
| 难度曲线与Boss.md | 配额投放读数 | 反哺点:同上 |
| 02-系统清单.md | 奇物/秘宝行状态 | 反哺点:同上 |
## 6. 任务卡
| 卡 | 内容 | 估时 |
|---|---|---|
| T0 | 开工三查+两疑似漏项核实(件级跨事件状态账/秘宝参数注入面)+magic_vs_magic 交叉核对(决定锻造批③作废与否)+解耦三案实装侧选型(登记三案,依代码事实定,预期案②令牌池+提前退役计数器) | 0.5d |
| T1 | 效果引擎词表扩签:9 条新事实+生命比例+停手挂点+新效果类型(heal/直伤/AC 状态/减伤等按 27 件声明清单)+加载校验同步 | 1.5-2d |
| T2 | 池结构案 D 实装:令牌语义+曝光槽 2+1+子池回退+概率上限解耦落地+adventure.tres 四级配额表重构(70/25/3→四级) | 1.5-2d |
| T3 | 专长数据行换代:feats.tres 旧 27 行删除+新 27 行订阅行重建(含淬毒刃纹/封印爆裂自 treasure_items 迁入) | 1.5d |
| T4 | 凭证件实装:新 5 件数据行与兑付路由(刷新券先行 F-1 修复/储备金袋 RAP/时沙 AP/完美保险/同调电池跨层)+留任 2 件改名迁移+行动点上限归属性轴 | 1.5-2d |
| T5 | Boss 兑付面换代:通关提升三选一→专长三选一+回血(专长候选按档配比加权抽取;呈现层复用;奖励节点/商店不动) | 1-1.5d |
| T6 | 件级跨事件状态账:攒层/计数类件账本承载(T0 结论落地) | 1d |
| T7 | 断点存档扩容:已拿计数器/新账面/池状态进断点附随件+存档键白名单登记 | 0.5-1d |
| T8 | MC 对账适配+基线重投:池换代行为变更后新锚落档(06 旧行为锚作废条联动) | 0.5-1d |
| T9 | 秘宝 15 件实装:数据行+解锁条件表(attunement_growth 改造)+装配面+秘宝匣+使用代价形态 | 3-4d |
| T10 | 旧数据行清理:treasure_items 旧行删除/魔法提灯拆线/卡④接线拆除 | 0.5d |
| T11 | 空配置验收闸(三选一池空兜底/商店空货架/装配面空目录)+**文档同步闸**(机械面全绿+反哺点逐条列明) | 0.5d |
合计 ≈14-18d——**超软时间盒,切分预案**:预挂三个迭代窗口,A=T0-T2(引擎与池)、B=T3-T6(专长内容线,做完即可玩)、C=T5+T7-T8(兑付与存档收尾)、D=T9-T11(秘宝线);切法随迭代规划期定,本卡按需求单位整体交付。
## 7. 验证闸
轻闸=冒烟全绿(基线 840,换代后数字随断言增减但 0 失败)+行为探针;重闸=run_all 全绿+MC 新基线对拍+断点回放(新旧档兼容口径:旧档按 06 冻结令=破坏性废弃不迁移,开发阶段无存量玩家);两入口铁规不破;批末人闸=实机目检。
## 8. 异常分级
L1 自救(断言失败自查表值/占位值);L2 记录继续(扩签落法与三案选型的代码事实冲突、呈现层组件复用受阻);L3 停机呈报(触碰 🔴 契约/池换代后发现 GDD 结构锚自相矛盾/旧档兼容面超出破坏性废弃口径)。
## 9. 代拍板白名单
效果引擎扩签的查询面落法映射;schema 新字段英文键命名;冒烟断言形态与种子选择;占位数值在 GDD 结构锚形态内取整;卡面文案直读行 desc;代称与注释措辞。超出清单必呈报。
## 10. 待裁点
1. **Q1 Boss 兑付换代口径**:换代(通关提升三选一整体退出、专长三选一进驻+回血——设计正主,核心循环图如此)vs 追加(保留提升三选一并增专长三选一双停点)。**推荐换代**;淘汰依据=追加使 Boss 渠道失去「专长独占」形状,渠道轴设计作废一半。
2. **Q2 秘宝 15 件 display_name**:代号占位上线、命名单独一轮 vs 写卡期定名。**推荐代号占位**(对外纪律尺已立,命名单独一轮保节奏;专长 27 件已定名,秘宝命名单独收口)。
3. **Q3 秘宝逐件解锁分配**(06 Q12 遗留:哪几件钥石、哪几件条件解锁)。**推荐**随本卡 grilling 逐件裁,占位期全按钥石可购。
4. **Q4 数值占位策略**:按 GDD 结构锚给 provisional 占位值 vs 全零待调参批。**推荐占位值**(可跑可测;全零无法验证行为)。
5. **Q5 迭代切分**:三窗口预挂方案(A 引擎池/B 专长内容/C 兑付存档/D 秘宝)vs 用户另定。**推荐预挂方案**,随迭代规划期落 roadmap。