From e62bb84c6373e9fca762febb0fbd06b395864d43 Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Mon, 26 Oct 2026 00:54:00 +0800 Subject: [PATCH] =?UTF-8?q?docs(=E7=BB=93=E9=A1=B9=E8=A1=A5=E8=AE=B0):=20?= =?UTF-8?q?=E8=BF=AD=E4=BB=A337=E6=8B=86=E4=BB=B6=E5=90=8E=20design/=20?= =?UTF-8?q?=E8=A1=8C=E5=8F=B7=E5=BC=95=E7=94=A8=E6=94=B9=E6=8C=87=E7=8E=B0?= =?UTF-8?q?=E5=9D=80=EF=BC=8B=E4=B8=A4=E5=A4=84=E6=96=87=E6=A1=A3=E7=89=88?= =?UTF-8?q?=E6=9C=AC=E5=A4=B4=E6=8D=A2=E4=BB=A3=EF=BC=88=E8=A7=84=E5=88=99?= =?UTF-8?q?=E6=95=B0=E5=80=BC=E9=9B=B6=E5=8F=98=E5=8C=96=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/gdd/systems/跨局循环/生涯.md | 6 +++--- design/gdd/systems/跨局循环/锻造工坊.md | 4 ++-- design/gdd/ux/settlement-summary.md | 4 ++-- 体验验证清单.md | 2 +- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/design/gdd/systems/跨局循环/生涯.md b/design/gdd/systems/跨局循环/生涯.md index fc52d19d..da2f87c2 100644 --- a/design/gdd/systems/跨局循环/生涯.md +++ b/design/gdd/systems/跨局循环/生涯.md @@ -47,7 +47,7 @@ ### 历史冒险回看（期二） -数据面现役事实：每局冒险收束时已有逐局摘要自动入档——`recent_summaries`（默认域 `save_manager.gd:116`、值拷贝访问器 `:316`、入账原语 `:325-338` 逐局插最前并按上限截断），上限 `SUMMARY_CAP := 10`（`:40`）。摘要字段在冒险收束时组装（`adventure_runner.gd:1005-1018`：结局 result、通关关数 levels_cleared、止步关 stopped_at、钥石合计 keystone_total、本局主种子 master_seed，另附逐杀掉落 keystone_drops 与终局专长持有集 relics（存档键名沿用历史形态）等）；摘要的内容口径 owner = [冒险结构](../冒险循环/冒险结构.md)，本文不复述其口径。 +数据面现役事实：每局冒险收束时已有逐局摘要自动入档——`recent_summaries`（默认域 `save_manager.gd:116`、值拷贝访问器 `:316`、入账原语 `:325-338` 逐局插最前并按上限截断），上限 `SUMMARY_CAP := 10`（`:40`）。摘要字段在冒险收束时组装（`adventure_runner.gd:812-826` 的 `_settle`：结局 result、通关关数 levels_cleared、止步关 stopped_at、钥石合计 keystone_total、本局主种子 master_seed，另附逐杀掉落 keystone_drops 与终局专长持有集 relics（存档键名沿用历史形态）等）；摘要的内容口径 owner = [冒险结构](../冒险循环/冒险结构.md)，本文不复述其口径。 2026-10-06 用户裁（P2 甲）：每局一行摘要，行内给**结局 / 到达关卡 / 钥石收入 / 用时**四件事，上限存最近 N 局。对应三件实绩（本批代码级复核确认的缺口，非新建数据面）： @@ -57,7 +57,7 @@ 单局结算明细回看：遗留件 `settlement_review_overlay.gd`（`game/presentation/views/`，文件本体在盘、全仓无实例化引用——仅 `ui_kit.gd:356` 样式注记提及）由期二实装批复活承接，改挂生涯（2026-10-06 用户裁 P5 甲）。 -可选增强（不占期、不上列）：关键构筑列——摘要已附终局专长持有集 relics（`adventure_runner.gd:1017`——存档键名沿用历史形态），实装期评估是否呈现。 +可选增强（不占期、不上列）：关键构筑列——摘要已附终局专长持有集 relics（`adventure_runner.gd:825`——存档键名沿用历史形态），实装期评估是否呈现。 ### 图鉴（期三） @@ -71,7 +71,7 @@ |---|---|---| | 营地（[camp UX spec](../../ux/camp.md)） | 跨局成长**操作**面（花钥石买强化 / 装配 / 点树）+ 底栏「最近冒险」条带——`camp_overlay_view.gd:431` `_rebuild_recent()` 逐局拼行（`:442`「完成/放弃/失败 · 通关 N 关 · 钥石 +N · 种子 N」，无截断上限），数据源 = `camp_shop_presenter.gd:85` 投影的同一份 `recent_summaries` | 营地不改生涯只读定位；生涯不做任何购买入口，也不放「去买」按钮。营地条带的去留是本提纲必答项——见 §五 P6 | | 状态面板（迭代 17 卡③，并行批开发中） | **局内**只读查看这一局进行中的钥石与本局冒险进度 | 状态面板看当局当前值，生涯看跨局累计与历史；局内无生涯入口（P4 甲） | -| 结算屏（[settlement-summary UX spec](../../ux/settlement-summary.md)） | 冒险收束当下的入账明细——`main.gd:537` `_on_adventure_finished` 收束时呈现摘要与钥石明细（复用终局面账行，`battle_end_overlay.gd:118-129`） | 收束当下的呈现保留不动；生涯承接的是收束之后的任意时刻回看 | +| 结算屏（[settlement-summary UX spec](../../ux/settlement-summary.md)） | 冒险收束当下的入账明细——`main.gd:408` 的 `_on_adventure_finished`（实体在 `main_adventure_flow.gd:84`）收束时呈现摘要与钥石明细（复用终局面账行，`battle_end_overlay.gd:118-129`） | 收束当下的呈现保留不动；生涯承接的是收束之后的任意时刻回看 | | 帮助手册（Beta 批，未实装——教学内容归 Beta 帮助手册，`ui_assembler.gd:99` 注记） | 讲「怎么玩」 | 生涯讲「我玩过什么」。图鉴条目文案与手册是否共用内容源，接口登记归 Beta 批一并裁 | | 图例面板（legend_overlay） | 局内符号/徽标即时解码 | 不合并——图例是局内解码面，图鉴是跨局收集面 | diff --git a/design/gdd/systems/跨局循环/锻造工坊.md b/design/gdd/systems/跨局循环/锻造工坊.md index d1cf5e06..c7a1bcb3 100644 --- a/design/gdd/systems/跨局循环/锻造工坊.md +++ b/design/gdd/systems/跨局循环/锻造工坊.md @@ -1,7 +1,7 @@ # 锻造工坊 > 一句话：营地的武器与护甲成长——武器锻造区三条路线、护甲锻造区三条路线各练各的，钥石消费，一次冒险各选一件，满级特效留位本期不做 -> 状态：**v0.8 迭代 21 反哺④残余写入文档（2026-10-13）**——「树侧钥匙」句换代：钥匙节点 forge_workshop 已随迭代 21 实装在役（free 无前置、点亮展开本柜台、锁定态零购买路径），原「实装归待办清单」悬置指针终结。承 v0.7 迭代 23 反哺写入（2026-10-13）——正文补 Q1 等级语义衔接（0 = 未练合法态）、效果类型闭集 24→31 订正、实装边界 1 回填实装实态（已随迭代 23 入库）。承 v0.6 完备性检查批（承 v0.5 B 组定案——**17 裁点全数清零**：1 丙 / 1a 一次冒险一件武器+一件甲 / 1b 营地可换·战斗禁换 / 1c 免费 / 2a 伪裁点消解 / 2b 随 3a 消解 / 3a 魔法护甲统一命名 / 3b 敌方攻击缺省普通·克制反向当下生效 / 3c 每型独立路线 / 4a 前缓后陡 / 4b 锻造内自闭环 / 4b-1 并联双通道 / 5b 纯钥石 / 5c 零材料 / 6 满级特效本期不做留扩展位 / 8a 工作间两区定名；2c、5a 已于 v0.4 结案）。**v0.6 变更（2026-10-12 完备性检查批·grilling 用户逐条裁）**：现役事实基线换代（forge_products 行族已随迭代 21 T5 退役、定价参数改历史考古口径）；**两根类型轴所有权移交**（默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除、选中态写存档+参数面注入）；「与秘宝混合制同构」与「激活穿刺系专长」两处无依据表述订正删除。**满级特效本期不做**（只留扩展位）；全部数值 provisional，终值归 Alpha 收官 M4 数值批〔未排期〕；实装已随迭代 23 入库（2026-10-12） +> 状态：**v0.9（2026-10-26 迭代 37 结项：实现载体行号引用改指现址，规则与数值零变化）；承 v0.8 迭代 21 反哺④残余写入文档（2026-10-13）**——「树侧钥匙」句换代：钥匙节点 forge_workshop 已随迭代 21 实装在役（free 无前置、点亮展开本柜台、锁定态零购买路径），原「实装归待办清单」悬置指针终结。承 v0.7 迭代 23 反哺写入（2026-10-13）——正文补 Q1 等级语义衔接（0 = 未练合法态）、效果类型闭集 24→31 订正、实装边界 1 回填实装实态（已随迭代 23 入库）。承 v0.6 完备性检查批（承 v0.5 B 组定案——**17 裁点全数清零**：1 丙 / 1a 一次冒险一件武器+一件甲 / 1b 营地可换·战斗禁换 / 1c 免费 / 2a 伪裁点消解 / 2b 随 3a 消解 / 3a 魔法护甲统一命名 / 3b 敌方攻击缺省普通·克制反向当下生效 / 3c 每型独立路线 / 4a 前缓后陡 / 4b 锻造内自闭环 / 4b-1 并联双通道 / 5b 纯钥石 / 5c 零材料 / 6 满级特效本期不做留扩展位 / 8a 工作间两区定名；2c、5a 已于 v0.4 结案）。**v0.6 变更（2026-10-12 完备性检查批·grilling 用户逐条裁）**：现役事实基线换代（forge_products 行族已随迭代 21 T5 退役、定价参数改历史考古口径）；**两根类型轴所有权移交**（默认值归锻造工坊配置常驻持有、hero.tres 静态表两轴删除、选中态写存档+参数面注入）；「与秘宝混合制同构」与「激活穿刺系专长」两处无依据表述订正删除。**满级特效本期不做**（只留扩展位）；全部数值 provisional，终值归 Alpha 收官 M4 数值批〔未排期〕；实装已随迭代 23 入库（2026-10-12） > 成文底稿：提案过程稿《提案-武器锻造系统-2026-10-07》（**已退役**——中间产物吸收即死，2026-10-22 删除；全部备选案与淘汰依据、用户原案逐条对照已逐条落进本文，结论不依赖过程稿；**满级特效候选池已于 2026-10-21 迁入本文「满级特效扩展位」节**；考古＝git 历史——删除批 603eba31，删除前全稿见历史版本 f958a03f） ## 设计目的 @@ -145,7 +145,7 @@ | 甲效矩阵 normal 行取值：轻甲 0 / 魔法护甲 +1 / 重甲 −1（整数点数：+1 被克 / 0 中性 / −1 挡住） | `settlement.tres:31-47` | | 敌方攻击类型轴**未开**——单据 `attack_type` 栏现役为 `""`（空串恒不查矩阵，`""` 与"群伤/反噬/地形/敌方技"同列无类型族）；`enemy.tres` 登记「敌方技能攻击类型轴仍未开（全部 normal 档）」 | `damage_controller.gd:19/:550-552`、`enemy.tres:527` | | 效果引擎效果类型闭集 **31 种**（原记 24 系 2026-10-07 旧快照——迭代 20 T1 +7、迭代 22 T3 +1，2026-10-13 迭代 23 反哺写入订正；冒烟断言钉 31，将来加词即转红提示复核） | `effect_engine.gd` | -| 营地消费货币=钥石（现役入口 tree_buy / buy_attune_refresh → spend_keystone——buy_forge 随 forge_products 退役删除）；GP=局内一次性货币，开局清零不入存档 | `meta_progression.gd:175/:354`、`adventure_runner.gd:116` | +| 营地消费货币=钥石（现役入口 tree_buy / buy_attune_refresh → spend_keystone——buy_forge 随 forge_products 退役删除）；GP=局内一次性货币，开局清零不入存档 | `meta_progression.gd:175/:354`、`adventure_runner.gd:100` | ## 实装边界（执行归实装批，本文只登记方案） diff --git a/design/gdd/ux/settlement-summary.md b/design/gdd/ux/settlement-summary.md index e321f8bc..b0ae7b96 100644 --- a/design/gdd/ux/settlement-summary.md +++ b/design/gdd/ux/settlement-summary.md @@ -1,7 +1,7 @@ # 结算总结 UX spec（settlement-summary） -> 状态：v1.3（2026-10-15 简明技术中文用语规范（用户令）批：词面修正 8 处——两面分节、纯呈现轻量 spec 不变；无新概念） -> 事实源：`game/presentation/views/battle_end_overlay.gd`（胜利金蜡封 / 失败暮蓝双形态载体）+ `main.gd`（胜利接线 main.gd:398 调试与迭代 8 卡⑥冒险主路径 / 冒险终局接线 main.gd:339-346） +> 状态：v1.4（2026-10-26 迭代 37 结项：事实源行号引用改指拆件后现址，呈现设计与规则零变化；承 v1.3（2026-10-15 简明技术中文用语规范（用户令）批：词面修正 8 处——两面分节、纯呈现轻量 spec 不变；无新概念）） +> 事实源：`game/presentation/views/battle_end_overlay.gd`（胜利金蜡封 / 失败暮蓝双形态载体）+ `main.gd`（胜利接线：调试 `main.gd:455-461`、冒险主路径 `main_adventure_flow.gd:165`；冒险终局接线：`main_adventure_flow.gd:19` 的 `adventure_finished.connect`） > 相邻：[battle.md](battle.md)（战斗屏出口锚与信息归属两原则）/ [level-clear.md](level-clear.md)（关卡结算屏——Boss 胜利走大奖励面，非本 spec）/ [level-map.md](level-map.md)（GP 常驻徽章） ## 定位 diff --git a/体验验证清单.md b/体验验证清单.md index bca7b1a3..85950173 100644 --- a/体验验证清单.md +++ b/体验验证清单.md @@ -399,7 +399,7 @@ ## ㉟ 迭代 37——缺陷定点修＋结构重构四卡实机目检总清单（2026-10-25 随批后收尾登记） -> 四卡＝卡① 行为缺陷定点修＋卡②③④ main 判离/boardview 拆件/runner 拆件与断点 schema 单点（等价重构），玩法语义零变化，但动了呈现装配与商店/三选一接线。机检已覆盖撤销证明、断点 27 键逐键对拍与双树原始面逐字节比对；真机上「看着是否与改前一致」仍要人眼看。登记不阻塞（2026-10-12 真人检测立规）；总收口时点=迭代 37 实现报告（已退役，git 可考）。 +> 四卡＝卡① 行为缺陷定点修＋卡②③④ main 判离/boardview 拆件/runner 拆件与断点 schema 单点（等价重构），玩法语义零变化，但动了呈现装配与商店/三选一接线。机检已覆盖撤销证明、断点 27 键逐键比对与双树原始面逐字节比对；真机上「看着是否与改前一致」仍要人眼看。登记不阻塞（2026-10-12 真人检测立规）；总收口时点=迭代 37 实现报告（已退役，git 可考）。 | # | 目检项 | 判据 | |---|---|---|