From f100e1927518b45927454970d6f5cb69cfcbabba Mon Sep 17 00:00:00 2001 From: DKChan <524912269@qq.com> Date: Wed, 21 Oct 2026 00:53:42 +0800 Subject: [PATCH] =?UTF-8?q?docs(gdd):=20=E5=88=A0=E9=99=A4=E3=80=8C?= =?UTF-8?q?=E5=85=B3=E5=8D=A1=E8=8A=82=E7=82=B9=E5=9B=BE=E7=94=9F=E6=88=90?= =?UTF-8?q?=E3=80=8D=E6=97=A7=E7=89=88=E6=96=87=E6=A1=A3=EF=BC=88=E7=94=A8?= =?UTF-8?q?=E6=88=B7=E4=BB=A4=202026-10-21=EF=BC=89=E2=80=94=E2=80=94?= =?UTF-8?q?=E5=87=BA=E5=BA=A6=E2=89=A42/=E5=B1=82=E5=AE=BD=E2=89=A44=20?= =?UTF-8?q?=E6=97=A7=E8=A7=84=E9=9A=8F=E6=A1=A3=E9=80=80=E5=9C=BA=EF=BC=9B?= =?UTF-8?q?=E5=BC=95=E7=94=A8=E9=9D=A2=E5=85=AB=E5=A4=84=E6=94=B9=E6=8C=87?= =?UTF-8?q?=E8=B7=AF=E6=96=87=E6=9C=AC=EF=BC=8802=20=E7=B4=A2=E5=BC=95?= =?UTF-8?q?=E8=A1=8C/08=20=E8=A1=8C/=E5=85=B3=E5=8D=A1=E8=8A=82=E7=82=B9?= =?UTF-8?q?=E5=9C=B0=E5=9B=BE/=E5=86=92=E9=99=A9=E7=BB=93=E6=9E=84/level-m?= =?UTF-8?q?ap/=E5=BE=85=E5=8A=9E=E6=B8=85=E5=8D=95=E4=B8=A4=E5=A4=84/Alpha?= =?UTF-8?q?=E6=A2=B3=E7=90=86=EF=BC=89=EF=BC=9B=E5=BD=92=E6=A1=A3=E5=89=AF?= =?UTF-8?q?=E6=9C=AC=E8=90=BD=E4=B8=BB=E5=8C=BA=20archive/=EF=BC=8C?= =?UTF-8?q?=E9=9A=8F=E5=85=B3=E5=8D=A1=E8=8A=82=E7=82=B9=E5=9B=BE=E9=87=8D?= =?UTF-8?q?=E6=9E=84=E6=89=B9=E9=87=8D=E5=86=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- design/gdd/02-系统清单.md | 1 - design/gdd/08-Alpha版本标准.md | 2 +- design/gdd/systems/冒险循环/关卡节点图生成.md | 214 ------------------ design/gdd/systems/冒险循环/关卡节点地图.md | 2 +- design/gdd/systems/冒险循环/冒险结构.md | 2 +- design/gdd/ux/level-map.md | 2 +- .../Alpha未完成事项梳理-2026-10-13.md | 2 +- 待办清单.md | 4 +- 8 files changed, 7 insertions(+), 222 deletions(-) delete mode 100644 design/gdd/systems/冒险循环/关卡节点图生成.md diff --git a/design/gdd/02-系统清单.md b/design/gdd/02-系统清单.md index f0b61b3e..7c669554 100644 --- a/design/gdd/02-系统清单.md +++ b/design/gdd/02-系统清单.md @@ -43,7 +43,6 @@ | 文件 | 一句话概要 | 状态 | |---|---|---| | `关卡节点地图.md` | 单关内的节点图选路与推进 | 已定稿 | -| `关卡节点图生成.md` | 单关节点图的逐局随机来源：图模板池、抽签与实例化（实施排队统一流裁决后） | 设计草案·拍板点全部已写入 | | `冒险结构.md` | 整局冒险的关卡序列、失败与大奖励 | 已定稿·自旧体系迁移 | | `难度曲线与Boss.md` | 难度曲线、期望值带与 Boss 设计 | 已定稿·自旧体系迁移 | | `奇物.md` | 一次冒险内各渠道给予玩家的增益总称（专长=触发器句式的机制件 / 属性值提升 / 补给=给系统资源加一笔的转换源凭证 × 三条渠道：奖励节点 / 商店 / 关底 Boss 击败） | 已实现·迭代 20 专长实装批落地（29 行=基础 27+迁入 2，流派机制退役；池结构案D 四级 104，通关兑付=专长三选一按档配比加权） | diff --git a/design/gdd/08-Alpha版本标准.md b/design/gdd/08-Alpha版本标准.md index 860640da..8e723532 100644 --- a/design/gdd/08-Alpha版本标准.md +++ b/design/gdd/08-Alpha版本标准.md @@ -46,7 +46,7 @@ | 冒险结构 | [冒险结构](systems/冒险循环/冒险结构.md) | 在役 | | 关卡节点地图 | [关卡节点地图](systems/冒险循环/关卡节点地图.md) | 在役（待重构，见下一条） | | 关卡节点图重构（增加可选节点） | [关卡节点地图](systems/冒险循环/关卡节点地图.md) | 待做（须先做文档设计，不可直接开发） | -| 关卡节点图生成 | [关卡节点图生成](systems/冒险循环/关卡节点图生成.md) | 在役 | +| 关卡节点图生成 | 旧版文档已删，随关卡节点图重构批重写 | 在役（待重构，与上一条同批） | | 难度曲线与 Boss | [难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md) | 在役 | | 奇物 | [奇物](systems/冒险循环/奇物.md) | 在役 | diff --git a/design/gdd/systems/冒险循环/关卡节点图生成.md b/design/gdd/systems/冒险循环/关卡节点图生成.md deleted file mode 100644 index caad54b6..00000000 --- a/design/gdd/systems/冒险循环/关卡节点图生成.md +++ /dev/null @@ -1,214 +0,0 @@ -# 关卡节点图生成 - -> 一句话：单关节点图怎么从固定配置变成逐局随机——图模板池、抽签与实例化 -> 状态：**v0.5 台阶一已实施**（迭代 5 T5，2026-09-28 落 master 前挂 worktree m3-iter5-20260928——15 张骨架+node_map 扩签+首次冒险固定脚本+池内全模板校验+MC 分层出数，冒烟 576/0；文档本节规则与实现一致性以本批落地为准，台阶二/三仍后置） -> 旧版参考：无（旧体系未单独成文；事项自 2026-09-20 立项，池重生成已落地〔2026-09-29 返工批，二轮目检 15/15 过〕，原待办清单条目已完成移除） - -## 设计目的 - -现行每关的节点图是关卡表里写死的一行行集——玩家每一局走的是完全相同的图。对照参照游戏：杀戮尖塔每层抽一张新地图，哈迪斯的房间编排逐局变化——布局变化本身就是"再来一局"的驱动力的一部分，而本作这块目前是零。 - -本文立项把单关节点图从固定配置升级为逐局随机。边界先说死：本文只管**图从哪里来**；图怎么走、走到每个节点发生什么、图合法性怎么校验，全部仍是[关卡节点地图](关卡节点地图.md)的现行规则，本设计对它们零改动——生成侧的职责止于"生产一张合法的图"，生产出来的图进的是既有校验、既有行进、既有兑付。 - -## 系统范围 - -边界这样划：图模板与模板池是内容资产（与敌人表行、棋盘参数同级的配置内容），抽签是玩法随机（消费主种子派生流），实例化的产物就是关卡表行集——行集内容的责任方仍是[冒险结构](冒险结构.md)，本文管的是行集**怎么被生产出来**。 - -负责： - -| 负责 | 说明 | -|---|---| -| 图模板的结构定义 | 一张模板有哪些组成部分、满足什么条件才算一张合法模板 | -| 模板池与关卡表接线 | 每关从哪个池抽、池怎么随关卡表配置 | -| 抽签时机与随机流 | 什么时候抽、消费哪条封闭流、可复现域怎么覆盖 | -| 实例化与校验交接 | 模板落成行集，交给既有的图合法性校验 | -| 台阶路线与测量对账 | 三级台阶的推进条件；模拟读数不被随机污染的口径 | - -不负责： - -| 不负责 | 归谁 | -|---|---| -| 节点图怎么走、选路、兑付触发、收束点 | [关卡节点地图](关卡节点地图.md)（现行规则零改动） | -| 图合法性校验的检查项与算法 | [关卡节点地图](关卡节点地图.md)（LevelTable.validate 现行——生成侧只是它的上游供给方） | -| 池里放几张模板、每张模板里放什么遭遇数值 | [冒险结构](冒险结构.md)（行集内容责任方）与[难度曲线与Boss](难度曲线与Boss.md)（数值所有权） | -| 战斗节点内部的敌人配置与初始化 | 战斗循环（节点编号寻址口径零改动） | -| 节点图的画面呈现 | [HUD框架](../表现与支撑/HUD框架.md)（节点态照旧读图，零新呈现语义） | - -## 在核心循环中的位置 - -``` -冒险结构 ──开始关卡──▶ 关卡节点图生成（抽模板 → 实例化行集）──行集──▶ 关卡节点地图（校验 → 选路行进） -``` - -[核心循环](../../01-核心循环.md)里"关卡：节点链逐节点推进"这一段之前，多了一步"这一关的图是哪张"的抽签——本系统就站在这一步。它向上接冒险结构的开始关卡请求，向下把实例化好的行集交给关卡节点地图；生成之后的一切（校验、行进、兑付、收束）与本系统无关。 - -## 核心规则 - -### 概念三件套：图模板、模板池、图模板抽签 - -**人话阶段**：本系统只有三个概念，弄清它们谁包含谁，整个系统就读懂了。 - -**图模板**（本文含义：一张手工编写的合法节点图骨架——一个节点集合〔每个节点带类型标注与关卡内唯一编号〕加一个连线集合）是内容资产，不是运行期生成物。**实例化**（本文含义：把模板原样照抄落成该关的行集——节点集合与连线进关卡表行，零变换）之后，它就是关卡节点地图要加载的那张图。 - -| 概念 | 一句话定义 | 归谁 | -|---|---|---| -| 图模板 | 手工编写的合法节点图骨架；实例化即行集 | 本文（结构规则）；内容归冒险结构 | -| 模板池 | 关卡表逐关行配置的同关可抽模板集合，池大小 N（N≥1） | 本文（规则）；配置承载归数据配置 | -| 图模板抽签 | 关卡开始时从池中均匀抽一张 | 本文（时机与流）；流基础设施归数据配置 | - -模板池挂在关卡表逐关行上：行集从"单一节点集合"扩为"模板池"。**N=1 的池里只有现行那张图，逐局抽签退化回固定图**——这是**回滚档**（本文含义：任何一关把池缩回一张模板，该关行为就与今日固定配置逐位等价的保险形态）。整个设计因此可增量落地：先全关 N=1，再逐关扩池。 - -抽签消费主种子派生的统一随机流，走扩签通道新立用途标签 `node_map`（统一流口径已定——2026-09-27 两轮复裁落地；标签不参与派生、只进事件日志）。 - -**出度上限与层宽（2026-10-01 用户拍板 T17 目检）**：单节点出边数（出度）**最大为 2**——加载校验第七检（`fanout_violation` 加载致命）。规则连带（数学约束）：出度 ≤2 + 入口唯一下，BFS 层宽上限 = **4**（层宽序列上限 1,2,4；2026-09-29 旧规则「层宽上限 5」与出度约束不相容，随本拍板废止）。现行池 = `tools/t17_fanout2_rebuild.py` 按两规则重建（五骨架：宽廊双干〔现行〕/三干中廊/宽廊斜岔/三干宽门/窄廊短支——层宽序列 1-2-4-1-1 / 1-2-3-2-1 / 1-2-2-2-1，最大层宽 4 应用足）。 - -**内容纪律**：每张新模板等于一个小内容批——模板里每个战斗与 Boss 节点都必须在敌人与棋盘生成的数值表里有精确行，义务从冒险结构加关纪律的"每关一行集"细化到"每模板一行集"；冒烟覆盖义务同批扩为遍历池内全部模板校验，不只抽中的那张。 - -### 抽签时机与可复现 - -**人话阶段**：什么时候抽、抽完怎么保证复盘对得上，是本系统接入现有随机纪律的两件事。抽签时点 = **开始关卡处理内、加载节点图之前**，逐关各抽一次（不是冒险开始一次抽齐三关）——抽签时机贴着"这一关的图要用"的时点，主种子的复现域天然覆盖。 - -``` -冒险结构（开始关卡：关卡序号、当前生命、生效上限） - → 关卡节点图生成：按关卡序号取模板池 → 抽一张（图模板抽签流，恰一 scope） - → 实例化为行集 → 交图合法性校验（关卡节点地图现行，零改动） - → 关卡节点地图加载行集 → 呈现选路停点（现行流程原样续跑） -``` - -可复现域沿用既有口径：主种子 + 全局取数计数器（2026-09-27 统一流；旧表述系并流前口径）（语义权威归[冒险结构](冒险结构.md)「失败重开与主种子」节，本文不复述）。抽签每次消费恰一个带编号的 scope，计数器随既有快照契约入档——[存档序列化](../表现与支撑/存档序列化.md)零新增域。同主种子同操作序列的两局，逐位同一张图。 - -教学位随骨架走：各骨架的"第一场战斗节点"沿用教学位纪律（首遇位固定数量不加骰）——教学位属性是骨架的内容标注，不跟节点编号走（拍板点①裁决后第一关也参与抽签，例外见下节）。 - -### 首次冒险的固定脚本（拍板点①裁决写入文档） - -**人话阶段**：教学关不该第一局就随机——玩家第一次玩，地图必须是设计好的那一张。拍板点①裁决（2026-09-27）：**全部关卡都参与抽签，唯独玩家的第一次冒险全程走固定脚本**。这也是参照游戏的通用做法（首次冒险特殊脚本）。 - -| 事项 | 规则 | -|---|---| -| 判定标志 | 存档域新增布尔位「首次冒险已进行」（owner=存档序列化，实施批落 schema） | -| 判定时机 | 开始新冒险时读标志：false = 首次脚本模式；true = 正常抽签 | -| 脚本模式内容 | 全关零抽签——每关直接取池内的现行固定模板（即回滚档成员），逐位等价今日行为，无需新做脚本内容 | -| 置位时机 | 冒险收束点置位（完成/失败/放弃三结局同写）——存档级属性冒险期只读、写入只在收束挂点（既有纪律） | - -两条边界：首次冒险中途退出游戏（未到任何收束点）则标志未写，下次新冒险仍走脚本——教学重放，可接受；首次冒险内死亡或放弃即结算置位，第二次冒险起抽签。 - -测量口径：模拟试玩与数值验证夹具恒置标志为 true（永远走抽签路径）——首次脚本分支不进任何读数。 - -### 三级台阶路线 - -**人话阶段**：2026-09-21 呈报的三级台阶（图模板抽签 → 骨架固定+属性随机 → 全程序生成）随本批立项成文为正式路线。每一级都比上一级多一点随机，每一级都必须过同样两条不变量：①产物过图合法性校验（检查项口径归关卡节点地图，本文不复述）；②商店房"每关恰 1、关底 Boss 前一位必经位"的编排约束在生成侧成立——冒烟断言照旧把关，校验零新增。 - -| 台阶 | 内容 | 前置条件 | -|---|---|---| -| 一：图模板抽签 | 每关模板池 N≥1，逐局从池中抽一张手工模板实例化 | 测量对账条款先行（见下节）；每张新模板按内容纪律配齐数值行 | -| 二：骨架固定+属性随机 | 模板拓扑定型，节点类型在**候选槽位**（本文含义：模板给某个可变位列出的允许节点类型集合，实例化时从集合内均匀掷一个——例：某槽位允许{奖励,恢复}，掷中哪个就是哪个）内掷定 | 台阶一完成；商店房所在位排除出候选槽位（保必经位） | -| 三：全程序生成 | 读参数（深度、分支密度、节点类型配比）直接构造图，构造失败重掷（重掷预算同棋盘生成 max_gen_attempts 纪律） | 台阶二完成；图合法性校验作最终守门 | - -台阶二的随机量入账：候选槽位掷定消费同一条图模板抽签流的后续 scope，计数器域照旧覆盖，可复现性零损失。台阶三的参数取值域届时随本文修订登记，本草案不预设。 - -台阶一用一句话说：**给每关手工做几张不同的地图骨架，每局开始时随机抽一张用**（用户裁决路线确认：骨架不完全固定、多份随机调取）。玩家看到的是同一关每局长得不一样——这局岔路多、下局一条窄道——但每张都是人工画好、审过合法性的图，不是程序乱长。台阶一不做两件事：房间类型不掷骰（某房间是奖励房还是恢复房仍由骨架定死——那是台阶二），程序不算图（那是台阶三）。首版池规模 = 每关 5 张（拍板点④），其中 1 张 = 现行固定图。 - -### 测量对账：别让随机污染读数 - -**人话阶段**：2026-09-21 呈报暂缓的三理由之一是"污染 MC 读数"——模拟试玩与数值验证的通关率是按固定图测的，图一随机，读数波动就混进了布局差异。本节是消解条款，三条： - -1. **分层出数**：模拟试玩与数值验证工具的读数按「关卡 × 图模板」分层记录；混合池的整体通关率 = 各模板条件通关率的加权平均（权重 = 抽中概率，均匀池即算术平均）。 -2. **基线可比**：基线批（与基线数据逐项比对、重投）跑固定模板口径——把池临时缩到 N=1（回滚档）或固定抽签 scope，保证新旧基线在同一张图上对话。 -3. **实施门**：随机量（扩池）上线排在[难度曲线与Boss](难度曲线与Boss.md)曲线调参批完成之后——现行行值 provisional 收带前叠加布局随机，归因会失真；抽签机制本身可先行落地（池保持 N=1 行为零变化，见拍板点③选项 C）。 - -另两条暂缓理由顺带消解：**类型集未稳**——五类节点封闭枚举已随商店房批定稿，扩类走文档修订的既有通道对模板同样适用（模板 schema 跟随枚举走）；**内容量不足**——台阶一的模板就是内容批，按内容批节奏逐张走，不设批量生产目标。 - -## 拍板点（登记 [待办清单](../../../../待办清单.md)，顺带更新条目） - -| # | 拍板点 | 状态 | -|---|---|---| -| ① | 第一关（教学关）是否参与抽签 | **已裁决（2026-09-27）**：参与——仅首次冒险走固定脚本，见「首次冒险的固定脚本」节 | -| ② | `node_map` 随机流增流 | **已裁决（2026-09-27 两轮复裁）**：统一用一个流——全游戏 rng 架构批先行（评估书已交付，2026-09-27），本特性实施排队其后 | -| ③ | 台阶一实施时点 | **已裁决（2026-09-27）**：机制先行骨架随后——特性内先落抽签机制（池暂 N=1 行为零变化）、骨架内容批随后扩池；整体仍排在架构批落地之后 | -| ④ | 首版池规模 | **已裁决（2026-09-27）**：每关 5 张起步（调参表已投值） | -| ⑤ | 抽签时点 = 关卡开始逐关抽 | **已裁决（2026-09-27）**：确认 | - -#### 证据面 A：随机流与「增流」是什么（拍板点②的背景） - -**人话**：本项目的随机数只有一个总入口（随机服务，代码名 rng_service），硬性红线禁止任何代码绕开它自己掷骰——"同一个种子+同样操作序列 = 逐位相同的一局"靠这条保证，调试复盘和模拟对账都依赖它。总入口内部按用途分账：每种用途占一栏，叫一条**流**（本文含义：随机服务内部按用途分开记账的一栏独立随机序列，各有各的编号，互不串账）。现行清单七条：雷图生成、奖励抽取、敌人数量掷骰、命中掷点、出招摇号、变异布置、GP 掉落——清单是封闭的，新用途必须在清单里开新栏。 - -图模板抽签是一笔新用途的随机账，要在清单里新开一栏（拟名 `node_map`）——「增流」就是这个动作：**给封闭流清单加一条新流**。它之所以要拍板：加流有固定成本（改代码 + 补一组校验用黄金向量 + 加冒烟断言，纪律规定的三件套），不是随手配置。 - -| 选项 | 内容 | 代价 | -|---|---|---| -| A 增流（原荐） | 清单加 `node_map` 栏，抽签独立记账 | 三件套成本；图的抽签可独立复现，与其它系统零耦合 | -| B 借现有流 | 从某条现有流取号 | 省三件套；但这笔账和那个系统的账搅在一起——重放对方系统的随机序列会被抽签挤位，复现口径变含糊，不推荐 | - -**裁决注记（2026-09-27）**：用户两轮复裁后终选「统一用一个流」（全面执行），执行路径 = 全游戏 rng 架构批先行、本特性排队其后。评估书已交付（2026-09-27，git 历史可查）——核心发现：字面目标「单一随机源、逐位可复现」现行架构已满足（七条流系同一主种子的七个盐值分栏而非七个随机源）；待裁决项 = 是否进一步并掉分栏计数器（方案甲维持分栏 / 乙物理并流 / 丙并流+全事件日志）。 - -#### 证据面 B：台阶一详解与实施时点（拍板点③的背景） - -台阶一（图模板抽签）落地后的样子： - -- **玩家看到什么**：同一关，每局地图的房间连接方式不一样（这局岔路多、下局一条窄道），但每张都是人工画好、审过合法性的图——不是程序乱长。 -- **做三件事**：①每关 5 张骨架（拍板点④，其中 1 张 = 现行固定图）；②开始关卡时抽一张实例化；③首次冒险走固定脚本（拍板点①）。 -- **不做两件事**：房间类型不掷骰（那是台阶二）；程序不生成图（那是台阶三）。 -- **内容形态**：一个内容批 = 15 张骨架（3 关 × 5）+ 池内全模板加载校验 + 冒烟断言。骨架里只有房间和连线，**不新增敌人数值**——遭遇表按节点编号共用：两张骨架若都在 3 号位开战，3 号位打的敌人是同一套（表键不含骨架维）；骨架差异体现在拓扑与房型排布，不体现在"同编号打不同敌人"。要打破这条需给遭遇表键加骨架维，归实施批 schema 拍板。 - -实施时点三个选项： - -| 选项 | 内容 | 后果 | -|---|---|---| -| A 机制+骨架立即全上 | 现在做完整内容批（含扩池到 5 张） | 曲线调参批未完成，数值基线在动；地图一随机，模拟读数的波动归因变难（数值动了还是图动了分不清） | -| B 全部等调参批完成（v0.1 原荐） | 机制与内容都排在曲线调参批后 | 读数对账最干净；机制落地要等 | -| C 机制先行、骨架随后（原荐） | 先落抽签机制但每关池暂放 1 张现行图（行为零变化），骨架内容批画好后一次扩到 5 张——扩池时点守测量对账实施门 | 机制与内容解耦：扩池前读数零污染，扩池后分层出数条款接管；不用等调参批 | - -## 依赖与输出 - -这张表就是删除任何一方时的影响面清单。 - -| 方向 | 系统 / 文档 | 接口要点 | -|---|---|---| -| 上游 | [冒险结构](冒险结构.md) | 开始关卡流程是抽签时点的宿主；主种子与派生流的语义权威；行集内容责任方（模板内容归它） | -| 上游 | [数据配置](../表现与支撑/数据配置.md) | 关卡表模板池列的承载与统一读取；node_map 统一流用途标签（扩签已落地 v0.5）与流种子派生公式的基础设施 | -| 上游 | [难度曲线与Boss](难度曲线与Boss.md) | 模板内遭遇数值的所有权；曲线调参批完成是台阶一的实施门 | -| 下游 | [关卡节点地图](关卡节点地图.md) | 实例化行集的供给方；其图合法性校验与全部行进规则零改动 | -| 下游 | [存档序列化](../表现与支撑/存档序列化.md) | 抽签 scope 计数器入既有快照契约（主种子 + 流计数器），零新增域；「首次冒险已进行」布尔位为唯一新增存档字段（实施批落 schema） | -| 下游 | [HUD框架](../表现与支撑/HUD框架.md) | 零新语义——节点态照旧读图，模板差异对呈现层透明 | - -## P0 最小闭环（台阶一实施批）——✅ 已落地（v0.5，2026-09-28） - -> 实施前置已解除：统一随机流批已落地（2026-09-27 两轮复裁——统一流+全事件日志）；抽签接入形态 = 统一流扩签新用途标签 `node_map`（扩签通道 = 改代码 + 评审）。 - -1. 关卡表逐关行扩模板池结构（承载归数据配置，schema 细节随实施批定）。 -2. 池内全部模板加载期预校验（违规致命，fail-fast 不变）。 -3. 存档域加「首次冒险已进行」布尔位：开始新冒险读标志（false = 首次脚本模式，全关零抽签取现行固定模板），冒险收束点置位（三结局同写，写入只在收束挂点）。 -4. 开始关卡处理内抽签实例化（`node_map` 流恰一 scope——拍板点②）。 -5. 既有图合法性校验照跑零改动；关卡节点地图与战斗侧全链零改动。 -6. 冒烟断言：抽签确定性（同种子逐位同图）、池内全模板校验、N=1 池与现行固定图逐位等价、首次脚本分支（标志 false = 固定图 / true = 抽签）。 - -## P1 / P2 后置 - -| 优先级 | 内容 | 后置原因 | -|---|---|---| -| P1 | 台阶二：骨架固定+属性随机（候选槽位掷定） | 台阶一完成后另批立项；商店必经位的槽位排除规则顺带成文 | -| P2 | 台阶三：全程序生成（参数化构造） | 台阶二完成后另批立项；参数取值域与重掷预算顺带修订本文 | - -## 调参表 - -本系统无已锁数值。台阶一实施后进表： - -| 参数 | 域 | 现行值 | 说明 | -|---|---|---|---| -| 模板池大小 N | int [1,+∞)，关卡表逐关行 | 每关 5（2026-09-27 拍板点④；2026-09-28 台阶一实施批落地，3 关 × 5） | N=1 = 回滚档；扩池 = 内容批 | -| 重掷预算（台阶三） | 未立项不设值 | — | 台阶三立项时随本文修订登记 | - -## 验收标准（草案——随拍板点裁决完成，实施批落地时按本节验收） - -- 池内全模板加载期通过图合法性校验，违规致命（校验面不只抽中的那张）。 -- 抽签确定性：同主种子同操作序列逐位同一张图；抽签 scope 可独立回放。 -- 回滚档成立：N=1 池的关卡与现行固定图逐位等价。 -- 首次冒险脚本：存档标志 false 时全程固定图（逐位等价现行行集），冒险收束点置位标志恰一次；标志 true 后每局抽签。 -- 商店房编排约束在每张模板上成立：每关恰 1 个商店房、关底 Boss 前一位必经位。 -- 零新面：关卡节点地图行进/兑付/收束断言与战斗侧寻址断言全绿，零改动。 -- 测量分层：模拟读数含「关卡 × 图模板」维度；基线批可固定模板复现。 -- 内容纪律：每张新模板的战斗与 Boss 节点在敌人与棋盘生成的数值表中有精确行（冒烟遍历池内全模板）。 - -## 待办 - -本系统无未决待办（结构随机生成池已落地）；后续新增待办统一登记待办清单，本节不再逐条登记。 diff --git a/design/gdd/systems/冒险循环/关卡节点地图.md b/design/gdd/systems/冒险循环/关卡节点地图.md index 13508256..17c0136a 100644 --- a/design/gdd/systems/冒险循环/关卡节点地图.md +++ b/design/gdd/systems/冒险循环/关卡节点地图.md @@ -61,7 +61,7 @@ 商店房的编排规则（2026-09-20 用户拍板）：每关**恰 1 个**商店房，位置 = **关底 Boss 前一位**——哈迪斯式的"决战前最后一个补给点"：买到的属性还有整段战斗可消费，错过的成长也没有第二家店可补。Boss 前一位同时是**必经位**：图拓扑收束使所有入口→Boss 的路径都穿过它，成长保底成为图结构事实而非玩家自觉。这条位置约束不由加载校验承载——图合法性六检零新增，商店房的"每关恰 1 + 必经"由冒烟断言把关。 -每个节点在关卡内领一个**节点编号**（本文含义：关卡内不重复的序号，用来当战斗的定位地址；数据键沿用切片字段 `node_depth`）。Boss 的编号恒为全图最大——"最深处的房间是关底"这条直感由此保留。单链特例：一张每步只有一条连线的图就是一条链，此时节点编号等于它前面走过的战斗场数。第一关行集就是单链特例，切片代码零改动运行；分支图行集已落地（v1.0.1 起；模板池见[关卡节点图生成](关卡节点图生成.md)）。 +每个节点在关卡内领一个**节点编号**（本文含义：关卡内不重复的序号，用来当战斗的定位地址；数据键沿用切片字段 `node_depth`）。Boss 的编号恒为全图最大——"最深处的房间是关底"这条直感由此保留。单链特例：一张每步只有一条连线的图就是一条链，此时节点编号等于它前面走过的战斗场数。第一关行集就是单链特例，切片代码零改动运行；分支图行集已落地（v1.0.1 起；图的来源与模板池随关卡节点图重构批重写，旧生成文档已删）。 呈现侧口径（2026-09-17 用户拍板）：节点图的画面表达走**方块地牢观感**——节点画成地牢房间的方块、连线画成通道——但逻辑拓扑就是本文的节点图，不产生任何额外选路或探索语义。关卡画面本体即节点链进度的呈现载体（选路覆盖层的常驻形态，节点态直接读图：已过暗金 / 当前金 / 候选下一跳通道亮金 / Boss 封印黑描边（旗朱→封印紫→封印黑 #000000，2026-09-28 用户拍板现行）），不另设进度条组件；视觉规格归 [HUD 框架](../表现与支撑/HUD框架.md)。 diff --git a/design/gdd/systems/冒险循环/冒险结构.md b/design/gdd/systems/冒险循环/冒险结构.md index 2cd50169..c024aad8 100644 --- a/design/gdd/systems/冒险循环/冒险结构.md +++ b/design/gdd/systems/冒险循环/冒险结构.md @@ -261,7 +261,7 @@ GP（显示名「GP」）是冒险内的一次性属性提升货币：战斗胜 | 参数 | 域 | 现行值 | 说明 | |---|---|---|---| -| 关卡行集（关数与节点链模板） | 关卡表逐关行 | 三关现行（逐关 templates 池 3 关 × 5，模板 0 = 回滚档——见[关卡节点图生成](关卡节点图生成.md)） | 加关 = 内容批（链行 + 敌我数值 + 新元素同批）；L1 回滚档模板 = 两战 → 奖励 → 两战 → 恢复 → 关底 Boss（7 节点，战斗深度 5） | +| 关卡行集（关数与节点链模板） | 关卡表逐关行 | 三关现行（逐关 templates 池 3 关 × 5，模板 0 = 回滚档；生成机制随关卡节点图重构批重写，旧生成文档已删） | 加关 = 内容批（链行 + 敌我数值 + 新元素同批）；L1 回滚档模板 = 两战 → 奖励 → 两战 → 恢复 → 关底 Boss（7 节点，战斗深度 5） | | 恢复比例 | int [0,100]，逐关行 | 见 level.tres rest_heal_pct（provisional） | 恢复点回复生效上限的百分比；随上限加成同步放大；100 = 恢复点变全满泉，0 = 死节点 | | 上限提升 | int [0,999]，冒险表逐件列 | adventure_table bonus_attack_flat / bonus_max_hp_flat / bonus_armor_flat（provisional） | 三选一属性件各自兑付值；值锚与上调约束归难度曲线与Boss | | 三选一件值（其余） | int [0,999]，冒险表 kind×tier 列族 | adventure_table curio_value_*（GP 袋 / AP 件 / 恢复 / 刷新，provisional） | 令牌件值读表；道具件授予件数随秘宝件出池退役 | diff --git a/design/gdd/ux/level-map.md b/design/gdd/ux/level-map.md index 3f62caec..902bc4c3 100644 --- a/design/gdd/ux/level-map.md +++ b/design/gdd/ux/level-map.md @@ -7,7 +7,7 @@ > **Template**: UX Spec > **覆盖范围**: 独立屏形态（关卡停点全景）· 入口停点 · 岔路停点 · 单链停点 · 放弃冒险入口 > **不覆盖**: 节点覆盖层（NodeOverlay——奖励/恢复兑付反馈，spec：[node-reward.md](node-reward.md)）、商店覆盖层（spec：[shop.md](shop.md)）、关卡结算屏（[level-clear.md](level-clear.md)）、战斗屏（[battle.md](battle.md)） -> **机制权威**: [关卡节点地图](../systems/冒险循环/关卡节点地图.md)（选路、兑付、停点语义；节点图逐局随机的来源另见[关卡节点图生成](../systems/冒险循环/关卡节点图生成.md)——只换图的来源，不换本屏的呈现语义）；**系统契约**: [HUD框架](../systems/表现与支撑/HUD框架.md)（订阅纪律、模态层级、可访问性基线） +> **机制权威**: [关卡节点地图](../systems/冒险循环/关卡节点地图.md)（选路、兑付、停点语义；节点图的来源随关卡节点图重构批重写，旧生成文档已删——只换图的来源，不换本屏的呈现语义）；**系统契约**: [HUD框架](../systems/表现与支撑/HUD框架.md)（订阅纪律、模态层级、可访问性基线） --- diff --git a/design/research/Alpha未完成事项梳理-2026-10-13.md b/design/research/Alpha未完成事项梳理-2026-10-13.md index a8d067c3..cfa5253d 100644 --- a/design/research/Alpha未完成事项梳理-2026-10-13.md +++ b/design/research/Alpha未完成事项梳理-2026-10-13.md @@ -63,7 +63,7 @@ | 编号 | 事项 | 状态 | 来源 | |---|---|---|---| | D1 | 剧情 / 世界观文本资产 | **缺失且有意不做**——[05-不做清单](../gdd/05-不做清单.md)「重叙事」永久排除（不写长篇文本，世界观只做碎片点缀）。现行只有层名（地精洞窟 / 幽暗地域 / 灰矮人矿城）与显示名，**零描述文本、零碎片叙事载体** | 05 确定不做节；[00-游戏概念](../gdd/00-游戏概念.md) | -| D2 | 关卡节点图模板池扩容（现行 15 骨架 = 3 关 × 5，随 A1 重构需重生成） | **待做**（A1 连带面） | [关卡节点图生成](../gdd/systems/冒险循环/关卡节点图生成.md)；06 A1 条「范围」段 | +| D2 | 关卡节点图模板池扩容（现行 15 骨架 = 3 关 × 5，随 A1 重构需重生成） | **待做**（A1 连带面） | 关卡节点图生成（旧版文档已删、随重构重写）；06 A1 条「范围」段 | | D3 | 事件类节点候选 | **缺失**（无内容系统承载，扩类须走文档修订） | [关卡节点地图](../gdd/systems/冒险循环/关卡节点地图.md) P2 | #### 乙-3 角色与敌人配置 diff --git a/待办清单.md b/待办清单.md index a22bd434..8f45c5ea 100644 --- a/待办清单.md +++ b/待办清单.md @@ -95,7 +95,7 @@ **现行实态**（`level.tres` 实查，三关各 5 张模板）：**第一关五张模板全是单链排列变体**——7 个节点＝战斗 ×4 + 奖励 + 休整 + Boss，战斗深度序单调保难度坡，**变化面只有奖励与休整两位的先后次序**，全链零分叉，玩家在选路上**没有任何选择**；第二/三关是网状图（10 节点，带 `next` 分支，最大层宽 4–5），有分叉，但用户仍判选择量不足。参考方向＝Peglin（哥布林弹珠）的节点图移动与选路方式。 -**范围（重构面，非呈现面）**：节点数量、分叉度、选路自由度。连带三面——① [关卡节点图生成](design/gdd/systems/冒险循环/关卡节点图生成.md)（模板池与抽签机制，现行 15 张骨架＝3 关 ×5 需重生成）；② [level-map](design/gdd/ux/level-map.md)（选路枢纽三停点布局定稿版，图结构改则屏面随之改）；③ [敌人系统](design/gdd/systems/战斗循环/敌人系统.md)（遭遇表按 `enemy.tres` 的 (level_index, node_depth) 坐标索引，节点数与编号一改，行集坐标与首遇教学位断言面全部随动）。 +**范围（重构面，非呈现面）**：节点数量、分叉度、选路自由度。连带三面——① 关卡节点图生成（旧版文档已删、随重构重写；现行 15 张骨架＝3 关 ×5 已判过期，随重构清理）；② [level-map](design/gdd/ux/level-map.md)（选路枢纽三停点布局定稿版，图结构改则屏面随之改）；③ [敌人系统](design/gdd/systems/战斗循环/敌人系统.md)（遭遇表按 `enemy.tres` 的 (level_index, node_depth) 坐标索引，节点数与编号一改，行集坐标与首遇教学位断言面全部随动）。 **量化要求补登（2026-10-16 playnote 用户补写）**：「需要统计一下第 123 关 path 的路径长度，路径长度需要递增，并且后续关卡的节点数增幅应该更大」（第 123 关＝第 1/2/3 关）——重构设计讨论的验收方向两条：先实测三关路径长度基线，再定递增曲线与后续关增幅尺度。 @@ -103,7 +103,7 @@ **缺口**：还差参考调研＋重构方案的设计讨论（含路径长度基线实测与递增曲线两条验收方向），过人闸后才能开卡。 -**归属**：[关卡节点地图](design/gdd/systems/冒险循环/关卡节点地图.md)（图结构与节点语义，主责）+ [关卡节点图生成](design/gdd/systems/冒险循环/关卡节点图生成.md)（模板池与抽签）+ [level-map](design/gdd/ux/level-map.md)（选路呈现）+ [敌人系统](design/gdd/systems/战斗循环/敌人系统.md)（遭遇行集坐标连带）；版本标准侧已登记为 Alpha 待做项，见 [08-Alpha版本标准](design/gdd/08-Alpha版本标准.md)「一 · 系统 · 冒险循环」 +**归属**：[关卡节点地图](design/gdd/systems/冒险循环/关卡节点地图.md)（图结构与节点语义，主责）+ 关卡节点图生成（旧版文档已删、随重构重写）+ [level-map](design/gdd/ux/level-map.md)（选路呈现）+ [敌人系统](design/gdd/systems/战斗循环/敌人系统.md)（遭遇行集坐标连带）；版本标准侧已登记为 Alpha 待做项，见 [08-Alpha版本标准](design/gdd/08-Alpha版本标准.md)「一 · 系统 · 冒险循环」 **状态**：待文档设计