From f9bc51d20348e7239f45625afa19539a09e2a3fd Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Sun, 11 Oct 2026 07:57:11 +0800 Subject: [PATCH] =?UTF-8?q?docs(reqcard):=20=E4=B8=93=E9=95=BF=E5=AE=9E?= =?UTF-8?q?=E8=A3=85=E6=89=B9=E5=8D=A1=E7=89=87=E6=9B=B4=E6=AD=A3=E2=80=94?= =?UTF-8?q?=E2=80=94=E9=94=99=E5=90=8D=E6=92=A4=E9=94=80=E9=87=8D=E7=AB=8B?= =?UTF-8?q?+=E7=A7=98=E5=AE=9D=E9=9D=A2=E5=85=A8=E6=92=A4=EF=BC=882026-10-?= =?UTF-8?q?11=20=E7=94=A8=E6=88=B7=E4=B8=A5=E6=89=B9=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 卡片改名「专长实装批（奇物）」：秘宝 15 件实装/提灯拆线/秘宝命名/解锁分配全数移出归秘宝实装批 - 任务重排 T0-T10 ≈10-12d；同调电池留卡（秘宝充能账在役不依赖秘宝批） - 待裁点收敛：Q1 Boss 兑付换代已裁，余 Q2 数值占位/Q3 迭代切分 - 06 指针改正：秘宝实装批③拆出独立成卡注记，余项维持冻结 --- active.md | 1 + design/gdd/06-待办清单.md | 2 +- ...-2026-10-11.md => 需求卡片-专长实装批-2026-10-11.md} | 50 +++++++++---------- 3 files changed, 26 insertions(+), 27 deletions(-) rename design/research/{需求卡片-专长秘宝实装批-2026-10-11.md => 需求卡片-专长实装批-2026-10-11.md} (56%) diff --git a/active.md b/active.md index ff021fcc..bdb7accf 100644 --- a/active.md +++ b/active.md @@ -51,3 +51,4 @@ 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，卡片成立后待编入迭代。 452. **秘宝实装批需求卡片定稿（2026-10-11，用户发令写卡；master 5cb59a3）**：design/research/需求卡片-秘宝体系实现重构落地批-2026-10-11.md v1.0（req-card 十节结构+代码级事实核查 F1-F10）——**零待裁点，开工门=U0**；五裁记录=C1 逐件分配锁定表（普通 6+双管装填钥石、远程镐通关 1/刷新执照 Boss3/天眼通关 3 且 Boss4/信标网络真视使用 10 次行为条件）、C2 代号即正式名、C3 开发期删档零迁移、C4 本批只做秘宝功能+槽位树接缝（无槽位不能带、测试调试注入、谓词表槽位职责移除）、C5 天眼开格按普通挖格全额兑付；估时 6d（区间 5-7）；范围边界=专长侧/奇物池选型/商店闸部分不收件（奇物侧另卡）；06 实装批条已登记卡片指针。**实现段开工=用户发令**（迭代冻结仍在册）。 +453. **专长实装批卡片更正批——错名撤销重立+秘宝面撤出（2026-10-11，用户严批「本会话哪里有半点提到跟秘宝有关系」；worktree card-fix，主会话直执，纯文档零测试）**：①**事故定性**：原卡「专长秘宝实装批」范围错 bundling——成因=照搬 06 秘宝实装批条目「③专长侧联动」的打包结构，未核对会话授权边界；本会话授权=奇物（专长）实装，秘宝实装系另一冻结批，用户明令「但凡提出半点秘宝相关算你赢」。②**更正**：卡片改名需求卡片-专长实装批-2026-10-11.md（git mv+全文重写）；秘宝面全撤（T9 秘宝 15 件实装/T10 提灯拆线卡④接线/Q2 秘宝命名/Q3 秘宝解锁分配全数移出归秘宝实装批）；任务重排 T0-T10 ≈10-12d（同调电池留卡=秘宝充能账在役 attunement.gd 不依赖秘宝批，现状事实第 8 条补证）；待裁点收敛=Q1 Boss 兑付换代已裁（换代），余 Q2 数值占位策略/Q3 迭代切分两项；06 指针改正=秘宝实装批条目③拆出独立成卡注记+余项维持冻结+⑥扩签由专长批 T1 先行承载。③教训=写卡范围以会话授权为准，不以 06 打包结构为准；跨批打包项拆卡须在 06 留拆出注记。 diff --git a/design/gdd/06-待办清单.md b/design/gdd/06-待办清单.md index 01439039..ea0f9881 100644 --- a/design/gdd/06-待办清单.md +++ b/design/gdd/06-待办清单.md @@ -144,7 +144,7 @@ **状态**：待办（冻结——2026-10-10 迭代规划冻结令覆盖，重启=用户直接发令） -**进展注记（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-10）**：数据文件面本批不依赖武器锻造线；**槽位面依赖修正（2026-10-10 设计骨架批后）**——同调位数量与品质的语义已裁归天赋树同调位节点（树侧接线归天赋树线/天赋树实装批），本批与该批存在槽位定序点（先树后宝或合并评估，随排期裁），现役谓词表求值作为本批落地前的过渡基座仍成立；秘宝体系文档正确性检查已过（五文件交叉核对：仅 registry 三处现行旧称「魔法道具」残留，已随检查批修正；其余命中均为版本历史与更名记载的合法引述）——**检查通过；设计侧裁点经 grilling 审查轮+设计骨架批已清零（秘宝.md v2.3），按三段流程设计段完成**。**③专长侧联动已拆出独立成卡（2026-10-11 用户发令；同日用户纠正=奇物线单独成卡、秘宝面不并入）**：design/research/需求卡片-专长实装批-2026-10-11.md（T0-T10 ≈10-12d；Q1 Boss 兑付换代已裁=换代，余 Q2 数值占位/Q3 迭代切分两项待 grilling；奇物侧设计+命名+裁定齐备〔奇物.md v3.15〕）——本条目余项（①②④⑤⑥⑦）维持冻结待发令，其中⑥效果引擎扩签核实与停手挂点由专长实装批 T1 先行承载。两条线交叉核对点一处随本批 T0：feats.tres 的 magic_vs_magic 条件值所属专长件是否在素材库表二 27 件删除名单内（若在，武器锻造实装批③「改值复活」随之作废）。 #### 效果引擎条件事实扩签——生命比例（背水实现前置需求）（2026-10-11 用户批登记） diff --git a/design/research/需求卡片-专长秘宝实装批-2026-10-11.md b/design/research/需求卡片-专长实装批-2026-10-11.md similarity index 56% rename from design/research/需求卡片-专长秘宝实装批-2026-10-11.md rename to design/research/需求卡片-专长实装批-2026-10-11.md index 29665402..4bf8df61 100644 --- a/design/research/需求卡片-专长秘宝实装批-2026-10-11.md +++ b/design/research/需求卡片-专长实装批-2026-10-11.md @@ -1,12 +1,12 @@ -# 需求卡片：专长秘宝实装批 +# 需求卡片：专长实装批（奇物） -> 2026-10-11 立卡（用户发令写卡）。设计前置检查：奇物.md v3.15（设计+裁定+命名清零）与秘宝.md v2.8（设计骨架+拾取渠道终裁）裁点全清零，满足设计定稿前置；本卡承接 [06-待办清单]「秘宝体系实现重构落地批」条目全部七项并并入本会话新增面（Boss 兑付换代/凭证五件/生命比例扩签/池结构案D 实装）。 +> 2026-10-11 立卡（用户发令写卡；同日用户纠正=本卡范围仅奇物线，秘宝实装系另批冻结条目不并入——原「专长秘宝实装批」错名撤销重立）。设计前置检查：奇物.md v3.15（设计+裁定+命名清零），满足设计定稿前置。本卡承接 [06-待办清单]「秘宝体系实现重构落地批」条目 **③专长侧联动**（拆出独立成卡）+ 本会话奇物线新增面（Boss 兑付换代/凭证五件/池结构案 D 实装/生命比例扩签前置）。 ## 1. 目标与完成定义 -把奇物（专长/属性值提升/资源）与秘宝两套新设计从文档落进代码与数据表：新专长 27 件替换旧 27 件、资源凭证件表（新 5+留任 2）替换旧四项、池结构按案 D 换代（曝光槽 2+1+令牌语义+概率上限解耦）、Boss 通关兑付换代为专长三选一、秘宝 15 件实装与旧数据行清理。 +把奇物新设计从文档落进代码与数据表：新专长 27 件替换旧 27 件、资源凭证件表（新 5+留任 2）替换旧四项、池结构按案 D 换代（曝光槽 2+1+令牌语义+概率上限解耦）、Boss 通关兑付换代为专长三选一。 -**完成定义**：①新 27 件专长全部可触发、行为与订阅行声明一致（MC 对拍留证）；②池结构与四级档位按案 D 运转；③Boss 通关=回血+专长三选一；④秘宝 15 件可解锁、可装配、可使用；⑤旧 27 件/旧道具件数据行清零；⑥冒烟全绿+run_all 全绿+换代后 MC 新基线落档。 +**完成定义**：①新 27 件专长全部可触发、行为与订阅行声明一致（MC 对拍留证）；②池结构与四级档位按案 D 运转；③Boss 通关=回血+专长三选一；④旧 27 件数据行清零、两迁出行自 treasure_items 删除；⑤冒烟全绿+run_all 全绿+换代后 MC 新基线落档。 ## 2. 现状事实（代码级，开工自行复核） @@ -14,9 +14,10 @@ 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` 淬毒刃纹/封印爆裂（原标中殉爆）两行在役待迁。 +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 行为锚作废重锚归数值批条。 +7. 06 在册：秘宝实装批条目（③专长侧联动由本卡承载）、生命比例扩签前置条、旧 MC 行为锚作废重锚归数值批条。 +8. 秘宝充能账在役（attunement.gd）——凭证件「同调电池」的跨层写入目标账已存在，不依赖秘宝实装批。 ## 3. 设计契约（违反即返工；🔴 触碰=L3 停机呈报） @@ -24,15 +25,15 @@ 2. 🔴 层级纪律：奇物不入同调位、秘宝不入当局随机渠道（adventure_runner.gd:85 注释承载面）。 3. 🔴 棋盘事实不可变（秘宝 v2.4 承重契约）：危险格位置/邻接数字不得移除增改。 4. 配额是结构锚：令牌数与档配额改动须用户重裁（TP0 纪律）——本批换代系已裁换代，换代后的新配额数字如需偏离 GDD 占位须呈报。 -5. 排雷玩法零特判：对侧代码零为奇物/秘宝而写的分支。 +5. 排雷玩法零特判：对侧代码零为奇物而写的分支。 6. 对外命名纪律（术语表）：无「雷/插旗」字面；插旗=封印、危险格=陷阱/巢穴（风味层）。 7. 数值纪律：全部 provisional 归调参批；占位值不得超 GDD 结构锚描述的形态。 ## 4. 范围边界 -做：T0-T11 所列（专长 27 件换代/凭证件/Boss 兑付换代/池结构案 D/秘宝 15 件/旧行清理/存档与 MC 适配）。 -不做：秘宝解锁条件逐件分配的正式数值（占位先行）、正式命名之外的第二轮命名、武器锻造实装（另批）、配额正式数值扫描（归数值批）、game/ 内 UI 文案旧词清扫的与实装无关部分。 -不收件去向：命名二轮/数值批/锻造批均已在 06 在册，本批不新增登记面。 +做：T0-T10 所列（专长 27 件换代/凭证件/Boss 兑付换代/池结构案 D/两迁出行删除/存档与 MC 适配）。 +不做：秘宝 15 件实装与解锁条件表（秘宝实装批另批冻结）、秘宝命名与逐件解锁分配、魔法提灯拆线与卡④接线拆除（归秘宝批）、武器锻造实装（另批）、配额正式数值扫描（归数值批）、game/ 内 UI 文案旧词清扫的与实装无关部分。 +不收件去向：秘宝面归秘宝实装批、命名二轮/数值批/锻造批均已在 06 在册，本批不新增登记面。 ## 5. 关联文档同步面（同步闸 v2） @@ -41,32 +42,29 @@ | registry entities.yaml | curio/feat/adventure/relics 行、kind 词族 | **机械面**：随批更新，合并前完毕 | | roadmap.md | 迭代行（编入后）/本批进度 | **机械面**：随批更新 | | game/README.md | 数据表清单与批节 | **机械面**：随批更新 | -| 06-待办清单 | 实装批条目状态/生命比例前置条 | **机械面**：随批更新（开工=已开工，收口=已入库销号） | -| tools/balance_verifier.py | 「道具工坊」旧称（在册残留） | **机械面**：随批顺带 | +| 06-待办清单 | 本批条目状态/生命比例前置条/秘宝实装批③拆出注记 | **机械面**：随批更新（开工=已开工，收口=已入库销号） | | 奇物.md | 实装后行为与数值反馈 | 反哺点：迭代实现报告列明，用户裁决后另批落文 | -| 秘宝.md | 实装反馈（解锁条件表/使用代价形态落地实态） | 反哺点：同上 | | 冒险结构.md | 「关卡大奖励」节陈述（通关两层兑付→回血+专长三选一） | 反哺点：同上 | | 难度曲线与Boss.md | 配额投放读数 | 反哺点：同上 | -| 02-系统清单.md | 奇物/秘宝行状态 | 反哺点：同上 | +| 02-系统清单.md | 奇物行状态 | 反哺点：同上 | ## 6. 任务卡 | 卡 | 内容 | 估时 | |---|---|---| -| T0 | 开工三查+两疑似漏项核实（件级跨事件状态账/秘宝参数注入面）+magic_vs_magic 交叉核对（决定锻造批③作废与否）+解耦三案实装侧选型（登记三案，依代码事实定，预期案②令牌池+提前退役计数器） | 0.5d | +| T0 | 开工三查+件级跨事件状态账核实（攒层/计数类≈8 件的账本承载）+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 | +| T4 | 凭证件实装：新 5 件数据行与兑付路由（刷新券先行 F-1 修复/储备金袋 RAP/时沙 AP/完美保险/同调电池跨层写充能账〔在役〕）+留任 2 件改名迁移+行动点上限归属性轴 | 1.5-2d | +| T5 | Boss 兑付面换代：通关提升三选一→专长三选一+回血（专长候选按档配比加权抽取；呈现层复用；奖励节点/商店不动）——Q1 已裁换代 | 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 | +| T9 | 迁出收尾：treasure_items 两迁出行删除（venom_edge/flag_burst——迁出即删） | 0.25d | +| T10 | 空配置验收闸（三选一池空兜底/商店空货架）+**文档同步闸**（机械面全绿+反哺点逐条列明） | 0.5d | -合计 ≈14-18d——**超软时间盒，切分预案**：预挂三个迭代窗口，A=T0-T2（引擎与池）、B=T3-T6（专长内容线，做完即可玩）、C=T5+T7-T8（兑付与存档收尾）、D=T9-T11（秘宝线）；切法随迭代规划期定，本卡按需求单位整体交付。 +合计 ≈10-12d——**超软时间盒，切分预案**：预挂三个迭代窗口，A=T0-T2（引擎与池）、B=T3-T4+T6（专长内容线，做完即可玩）、C=T5+T7-T10（兑付与存档收尾）；切法随迭代规划期定，本卡按需求单位整体交付。 ## 7. 验证闸 @@ -82,8 +80,8 @@ L1 自救（断言失败自查表值/占位值）；L2 记录继续（扩签落 ## 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。 +已裁一项：**Q1 Boss 兑付换代口径=换代**（本会话用户裁——通关提升三选一整体退出、专长三选一进驻+回血保留）。 + +余两项： +1. **Q2 数值占位策略**：按 GDD 结构锚给 provisional 占位值 vs 全零待调参批。**推荐占位值**（可跑可测；全零无法验证行为）。 +2. **Q3 迭代切分**：三窗口预挂方案（A 引擎池/B 专长内容/C 兑付存档收尾）vs 用户另定。**推荐预挂方案**，随迭代规划期落 roadmap。