diff --git a/design/engineering/process-conventions.md b/design/engineering/process-conventions.md index a5ce00c5..09307339 100644 --- a/design/engineering/process-conventions.md +++ b/design/engineering/process-conventions.md @@ -41,7 +41,7 @@ **环境与基线** 4. **一切批独立 worktree＋拷导入缓存**——按 §1 建 worktree；涉代码域跑闸或测试的批先拷主区 `.godot/` 目录与字体 `.import` 边车（纯文档批免拷），否则全量重导入资源近似卡死。检出工作区零测试，直接开工（2026-10-22 频率规则）；闸壳每次跑批先自检/自愈本区 user 目录隔离（§1 第 1 条），建不起来即拒跑 -5. **涉数值改动先采改前读数**——与改后同随机种子配对比较并写明逐项比对口径；无数值改动禁跑模拟 +5. **涉数值改动先采改前读数**——与改后同随机种子配对比较并写明逐项比对口径；无数值改动禁跑模拟。**Alpha 阶段口径（2026-11-04 用户裁）**：Alpha 阶段先做机制与内容填充，数值层统一修正殿后——本阶段的投放批与内容批零读数、零 MC 取证，改前读数与难度带读数义务后移到数值统一修正批执行；本条对数值统一修正批本身恢复原义。 **实施** 6. **新功能必配新测试**——新增玩法/机制必须配套新测试套件进 `tests/run_all`；没有对应测试的变更不许合并；并按 test-conventions §8 挂进改动—验收对照表，没有对照表行的行为改动同样不许合并。拆件/重构产出的新 core 件不属新增玩法，由 test-conventions §8.3「新增 core 件的覆盖登记义务」承接（被 tests 面点名，或在能力行申报「经宿主链覆盖」），核对动作归本清单第 10 条的收尾提交 diff --git a/design/gdd/08-Alpha版本标准.md b/design/gdd/08-Alpha版本标准.md index 52ea0a53..abf5b61e 100644 --- a/design/gdd/08-Alpha版本标准.md +++ b/design/gdd/08-Alpha版本标准.md @@ -2,7 +2,7 @@ > **一句话定位**：本文定义这个项目的 **Alpha 版本包含哪些东西**——它是里程碑 M3 的完成标准，也是判断"还差什么"的对照表。 > **本文只列条目，不写内容**：每样东西是什么、规则怎么走，一律归各自的权威文档，本文只给指路链接。想知道某样东西的定义，请点链接，不要在本文里找解释。 -> **状态**：**已定稿（v1.25）**——2026-10-13 用户令定稿，历次升版明细见 git 提交史。Alpha 的内容范围自此冻结：增删条目一律须经用户裁决。 +> **状态**：**已定稿（v1.26）**——2026-10-13 用户令定稿，历次升版明细见 git 提交史。Alpha 的内容范围自此冻结：增删条目一律须经用户裁决。 > **成文**：2026-10-13。 ## 本文怎么用 @@ -92,7 +92,7 @@ Alpha 内以玩法循环本身的内容与表现为主（棋盘、关卡、战 | 元进度配置 | `meta.tres` | 在役 | | 天赋树节点集 | `meta_tree.tres` | 在役 | | 锻造工坊路线行族 | `forge.tres` | 在役（定价 provisional 归 M4；表名订正与入库依据见 git 提交史） | -| 混编遭遇行集 | `enemy.tres` | 在役（首批；第二批移挂 Beta，裁决与明细见 git 提交史；2026-10-22 迭代 34 起按〔关卡，行类，深度带〕三参寻址，行集键已迁移） | +| 混编遭遇行集 | `enemy.tres` | 在役（首批 (2,5) 2026-10-07；2026-11-04 追加 (1,3)；第二批（Boss 多行）移挂 Beta，裁决与明细见 git 提交史；2026-10-22 迭代 34 起按〔关卡，行类，深度带〕三参寻址，行集键已迁移） | --- diff --git a/design/gdd/systems/冒险循环/难度曲线与Boss.md b/design/gdd/systems/冒险循环/难度曲线与Boss.md index fb1d892f..0c3ad45d 100644 --- a/design/gdd/systems/冒险循环/难度曲线与Boss.md +++ b/design/gdd/systems/冒险循环/难度曲线与Boss.md @@ -1,7 +1,7 @@ # 难度曲线与Boss > 一句话：难度曲线、期望值带与 Boss 设计 -> 状态：已定稿（自旧体系迁移）；现行为 v1.2 +> 状态：已定稿（自旧体系迁移）；现行为 v1.3 ## 设计目的 @@ -276,7 +276,7 @@ Boss 战的棋盘用本关最大板形（板形行值读棋盘参数表），板 敌人表行值（行集与坐标覆盖随后续批次扩展，行值读 `enemy.tres`——本文只登记行模板与坐标语义）： -**混编行集难度归属注记（2026-10-07 行集多行批——机制放开、本批零投放）**：敌人表同一坐标允许多行混编多种敌种后，混编遭遇的难度 = 行集内各行值按既有口径独立生效再叠加（数量区间各行各掷、行集实例总数 ≤ 4），不引入新的难度轴或乘区；首个混编行连同 Boss 多行的实际投放归后续内容批，投时行值 provisional 归本文调参的既有口径不变，且投放批须附 MC 取证（先报批）与难度带读数。机制批次（本批）零内容投放、零数值变更。 +**混编行集难度归属注记（2026-10-07 行集多行批——机制放开、本批零投放）**：敌人表同一坐标允许多行混编多种敌种后，混编遭遇的难度 = 行集内各行值按既有口径独立生效再叠加（数量区间各行各掷、行集实例总数 ≤ 4），不引入新的难度轴或乘区；投时行值 provisional 归本文调参的既有口径不变。**投放记录**：第一行 = (2, 5) 熊地精重击手 + 巨蜘蛛巢群（2026-10-07 迭代 18 卡⑤）；第二行 = (1, 3) 地精 + 熊地精（2026-11-04 用户裁，随大地精数据行退役改混编，行值整行复用既有地精 / 熊地精行——零数值新增）；Boss 多行第二批仍挂后置。**读数义务（2026-11-04 用户裁）**：Alpha 阶段数值层统一修正殿后，本阶段投放批零读数、零 MC 取证，难度带读数义务后移到数值统一修正批（本行与后续 Alpha 投放批同此口径）。机制批次（2026-10-07 本批）零内容投放、零数值变更。 | 坐标 | 敌种（数据键） | 生命 | 攻击（浮动区间） | 数量 | 技能池（权重） | 护甲 | |---|---|---|---|---|---|---| diff --git a/design/gdd/systems/战斗循环/敌人系统.md b/design/gdd/systems/战斗循环/敌人系统.md index e0200b83..838151c6 100644 --- a/design/gdd/systems/战斗循环/敌人系统.md +++ b/design/gdd/systems/战斗循环/敌人系统.md @@ -1,7 +1,7 @@ # 敌人系统 > 一句话：敌人数据、技能池出招、意图呈现 -> 状态：已定稿（自旧体系迁移）；现行为 v1.5 +> 状态：已定稿（自旧体系迁移）；现行为 v1.6 ## 设计目的 @@ -78,8 +78,6 @@ 首发敌种三种——地精、熊地精、食人魔酋长（末者为首发关底 Boss）；L2/L3 内容批扩至现行八种。名字是玩家可见专名，池权重与护甲等级行值一律读配置表，本表只存敌种语义模板： -> **hobgoblin 缺口登记（2026-10-13 迭代 24 反哺④）**：敌人表有 `hobgoblin` 数据行（寻址键 (1, battle, 3) 的「大地精」行），**无立绘、不在本敌种表**——登记在案的已知缺口（敌种语义模板未成文故呈现面无定义可依），本批未动；补齐归敌种内容批（立绘+语义模板+敌种表行三件套）。 - | 敌种 | 技能池构成（权重读表） | 护甲类型 | 护甲等级 | 定位 | |---|---|---|---|---| | 地精 | 普通攻击 + 突刺（低权重特殊技） | 行值读表 | 行值读表 | 首发杂兵；教学位节点数量开战掷定（区间行值读表） | diff --git a/体验验证清单.md b/体验验证清单.md index ba705294..469421cb 100644 --- a/体验验证清单.md +++ b/体验验证清单.md @@ -178,11 +178,11 @@ - **红灯信号**：战斗结算后弹奇物；凭证进持有集；货架出现专长单件（非凭证形态）；refresh 件写进角色加成区。 - **结论回流**：呈现面违规改法+档位呈现三路=C1 待裁（呈现批）；强度体感归 Beta 阶段（未排期）带判读（本批 MC 只测不判）。 -### ⑱ 首批混编遭遇目检与读数义务（迭代 18 卡⑤投放顺带登记——首个混编遭遇落表） +### ⑱ 混编遭遇目检与读数义务（迭代 18 卡⑤投放顺带登记；2026-11-04 补登第二行 (1,3)） -- **投放内容**：(2,5) 双行行集 = 熊地精重击手（既有行零变更）+ 巨蜘蛛巢群（新行，行值整行复制 (2,6) 巢群行——零数值新增）；行序 = 重击手在前（默认目标）·巢群在后（R6 行序契约：文件序 = 声明序 = 生成序）。 -- **实机目检三项**（混编遭遇至少触发一次——L2 节点 5）：同场两敌种呈现（重击手与蜘蛛同屏）；行序与表一致（默认目标 = 重击手，蜘蛛随后）；实例总数 ≤4 目视（3-4 只 = 重击手 1 + 蜘蛛 2-3）。 -- **难度带读数义务**：L2 含混编后的难度带位移——随 Alpha 收官 M4 数值批统一执行，届时另报批（本批 MC 零跑）。 +- **投放内容**：(2,5) 双行行集 = 熊地精重击手（既有行零变更）+ 巨蜘蛛巢群（新行，行值整行复制 (2,6) 巢群行——零数值新增）；行序 = 重击手在前（默认目标）·巢群在后（R6 行序契约：文件序 = 声明序 = 生成序）。第二行 = **(1,3) 双行行集 = 熊地精 + 地精**（2026-11-04 用户裁，随大地精数据行退役）：行值整行复用 (1,2) 熊地精（1 只 / hp22 / ac2）与 (1,0) 地精（1–2 只 / hp8 / ac0），零数值新增；静态最坏骰和 1+2=3 ≤4；行序 = 熊地精在前（默认目标与开战叙述取首行）。 +- **实机目检三项**（混编遭遇至少触发一次——L1 节点 3 与 L2 节点 5）：同场两敌种呈现（L1 熊地精与地精同屏 / L2 重击手与蜘蛛同屏）；行序与表一致（L1 默认目标 = 熊地精、地精随后；L2 默认目标 = 重击手、蜘蛛随后）；实例总数 ≤4 目视（L1 2-3 只 = 熊地精 1 + 地精 1-2；L2 3-4 只 = 重击手 1 + 蜘蛛 2-3）。 +- **难度带读数义务**：L1 / L2 含混编后的难度带位移——统一后移到数值统一修正批（2026-11-04 用户裁：Alpha 阶段零读数、零 MC 取证，本批与后续投放批同此口径）。 - **首遇教学位与断言面复核（本批已履行）**：巨蜘蛛首遇位 (2,4)「固定 2 不加骰」零触碰、钩爪恐魔 (3,0)/(3,1) 固定数量零触碰；expect_pools 三元键池模板 + (2,5) 行集构成/行序/静态最坏骰和 ≤4 断言顺带入冒烟全绿。 - **红灯信号**：(2,5) 只出一种敌种；敌人数 5 只以上（越 spawn 守卫应不可能——出现即报缺陷）；首遇位 (2,4) 数量出现掷骰波动（应恒 2）。 - **Boss 多行（第二批投放）六面读数清单维持**：Boss 名取首行显示 / Boss 遭遇骰逐行区间骰（每行各掷自己区间——卡① Q8 逐行骰换代口径）/ 半血解锁 / 独占技 / 难度带 / 首遇教学位复核——逐项过，随第二批需求卡片执行。 @@ -259,7 +259,7 @@ **现行义务**：**T7 技能池节奏重测（2026-10-05 技能池执行批挂单）**——≥50 distinct seeds 节奏重测（过涝判读带=Boss 半血后特殊技密度上探；跑批须用户批准；S2 过涝越带→解锁技权重/倍率回调呈报禁自动调；**2026-10-06 联审批注：判读带立单于案C 行为换代前，执行前须按案C 新行为复核「半血后」窗口与密度分母是否仍有效，失权即停机呈报重立带**）→ ~~T19 真人标定局~~（⑤已完成）→ 真人侧读数换 81000 锚补算 k 终值（随迭代 9 出口重锚批出，模拟锚 2026-09-19 判读报告的现行锚地位由 81000 锚+真人两局承接）。工具面：`analyze_playtest.py` / `balance_verifier.py` 冒险段 / JSONL 日志现役。 -**后续内容批义务（2026-10-06 敌人表行集多行批 P3 丙二裁挂单）**：首个混编遭遇行投放（连同 Boss 多行内容，敌种候选与坐标由内容批裁）——投时 MC 取证先报批（数值验证场景二档起）、难度带读数义务随投登记、首遇教学位纪律与 expect_pools 断言面逐项复核（巨蜘蛛首遇位「固定 2 不加骰」等表注释为准）、Boss 多行投放时 Boss 名取首行显示/Boss 遭遇骰逐行区间骰〔每行各掷自己区间——2026-10-07 卡① Q8 逐行骰换代，旧「读首行区间」口径消解〕/半血解锁/独占技/难度带六面读数逐项过。——**已编入 roadmap 迭代 18 卡⑤混编遭遇首批投放批（2026-10-06 用户令；读数义务维持顺带登记，MC 取证跑批顺延 Alpha 收官 M4 数值批统一执行〔未排期，届时另令——数值统一调整殿后〕）。进展：首批已于 2026-10-07 落表（(2,5) 双行，目检与读数义务见 ⑱）；剩余面 = Boss 多行第二批（六面读数随投逐项过）** +**后续内容批义务（2026-10-06 敌人表行集多行批 P3 丙二裁挂单）**：首个混编遭遇行投放（连同 Boss 多行内容，敌种候选与坐标由内容批裁）——投时 MC 取证先报批（数值验证场景二档起；Alpha 阶段按 2026-11-04 用户裁统一后移到数值统一修正批）、难度带读数义务随投登记、首遇教学位纪律与 expect_pools 断言面逐项复核（巨蜘蛛首遇位「固定 2 不加骰」等表注释为准）、Boss 多行投放时 Boss 名取首行显示/Boss 遭遇骰逐行区间骰〔每行各掷自己区间——2026-10-07 卡① Q8 逐行骰换代，旧「读首行区间」口径消解〕/半血解锁/独占技/难度带六面读数逐项过。——**已编入 roadmap 迭代 18 卡⑤混编遭遇首批投放批（2026-10-06 用户令；读数义务维持顺带登记，MC 取证跑批顺延数值统一修正批统一执行〔未排期，届时另令——数值统一调整殿后〕）。进展：首批已于 2026-10-07 落表（(2,5) 双行）；第二行已于 2026-11-04 落设计（(1,3) 地精＋熊地精，随大地精数据行退役，目检与读数义务见 ⑱）；剩余面 = Boss 多行第二批（六面读数随投逐项过）** ## ㉖ 代码架构技术债修复批——全流程走查（迭代 27 卡①顺带登记；能力验证半=冒烟 V1-V9+parity 三变体逐位一致、与基线数据逐项比对五跑全同） diff --git a/待办清单.md b/待办清单.md index f1f07c99..ac7b17be 100644 --- a/待办清单.md +++ b/待办清单.md @@ -2,15 +2,13 @@ 本清单是流水线的唯一登记处：以后才做的事在此登记一条，随流水线段推进改状态，做完整条删除（条目记进度，不是各段的开工前置）；各系统文档的「待办」节只留一行指路存根，不再自建条目。条目格式（标题＝登记元数据含可选优先级，正文＝实况/缺口/改动面/状态四属性）与状态机以 [doc-conventions §12.1](design/engineering/doc-conventions.md) 为权威。 -#### hobgoblin 内容三件套补齐（2026-11-01 登记，来源=审计发现） +#### L1 深度 3 改地精＋熊地精混编（大地精数据行退役）（2026-11-04 登记，来源=会话提及） -**实况**：敌人表 hobgoblin 行（寻址键 (1, battle, 3)）数值完整在役、战斗正常运行，但内容三件套未交付——立绘、敌种语义模板、敌人系统.md 敌种表行均缺，呈现面因语义模板未成文无定义可依。登记凭据=[敌人系统](design/gdd/systems/战斗循环/敌人系统.md) v1.1「hobgoblin 缺口登记」节（2026-10-13 迭代 24 反哺④）。 +**实况**：关联文档清单——[敌人系统](design/gdd/systems/战斗循环/敌人系统.md) v1.6（hobgoblin 缺口登记整块删除，敌种表维持八种）· [难度曲线与Boss](design/gdd/systems/冒险循环/难度曲线与Boss.md) v1.3（混编投放记录与 Alpha 读数义务口径）· [08-Alpha版本标准](design/gdd/08-Alpha版本标准.md) v1.26（混编遭遇行集状态行补第二行）· [流程规范](design/engineering/process-conventions.md) §3 第 5 条（Alpha 阶段零读数口径，2026-11-04 用户裁）· [体验验证清单](体验验证清单.md) ⑱（目检范围扩至 L1 节点 3）。事项来由与设计定值：用户 2026-11-04 裁不做大地精敌种，原「hobgoblin 内容三件套补齐」条目同批删除；(1, battle, 3) 改双行混编，行值整行复用 (1, battle, 2) 熊地精（1 只 / hp22 / ac2）与 (1, battle, 0) 地精（1–2 只 / hp8 / ac0），行序熊地精在前（默认单体目标与开战叙述取首行），静态最坏骰和 1+2=3，Alpha 阶段零读数。 -**缺口**：还差敌种语义模板的文档设计讨论闭合（呈现面定义、池构成口径），闭合后立绘走美术线。 +**改动面**：文档＋游戏代码＋工具代码 -**改动面**：文档＋美术素材＋游戏代码 - -**状态**：待文档设计 +**状态**：文档设计已闭合＋待写卡 #### 架构审查余项——闸面缺口、豁免存废、零测试点名与架构文档漂移（2026-11-03 登记，来源=批次移交）