docs: 迭代 16 四份任务书起草并登记入册(纯文档零代码零测试)——①敌人表行集多行批(行集恰一敌种校验放开,enemy_table.gd:108-112 等代码考证在册,T0-T8≈4.25d,4 裁点)②M4 数值批(削弱终值/点评五条/迭代10联动欠账①②/元进度定价剩余面四件合一+T6T7 读数义务+damage_probe A1 顺路,跑批批准制,T0-T8≈6.0d,4 裁点)③暂停层只读入口批(钥石余额+三柜台进度局内只读,复用 UiKit 公共件零新素材,T0-T5≈3.0d,4 裁点)④生涯界面设计立项(设计提纲版不实装,T0-T2≈1.25d,6 裁点);roadmap M-4 表追加迭代 16 四行+迭代 15②卡标注修正(文档+数据层落籍 c571af2,实施段回归迭代 15 在飞);06 七条目状态行追加编入注记
This commit is contained in:
1 parent
413c936b79
commit
ffd45eb5d4
6 files changed
+774
-9
No files matched your search
@@ -128,7 +128,7 @@
|
||||
|
||||
**归属**:随[关卡节点地图](systems/冒险循环/关卡节点地图.md)定稿改键一并裁决
|
||||
|
||||
**状态**:部分收口(2026-09-17)——同层多遭遇问题已由关卡节点地图 v1.0 的**节点编号升级**消解(`node_depth` 语义 = 关卡内唯一节点编号,同层不同节点各查各行,键结构零改动);**不设精英 / Boss 编码位**(Boss = 最大编号节点,精英 P2 内容承载)。剩余面继续待办并改归属:同场多敌种(同一编号行集多行)的行集校验放开 ——归属**敌人表行集多行批(战斗侧,排技能池实施批落地后)**(混编伏击上限取值口径面已随 2026-09-20 单轮上限删除消解)
|
||||
**状态**:部分收口(2026-09-17)——同层多遭遇问题已由关卡节点地图 v1.0 的**节点编号升级**消解(`node_depth` 语义 = 关卡内唯一节点编号,同层不同节点各查各行,键结构零改动);**不设精英 / Boss 编码位**(Boss = 最大编号节点,精英 P2 内容承载)。剩余面继续待办并改归属:同场多敌种(同一编号行集多行)的行集校验放开 ——归属**敌人表行集多行批(战斗侧,排技能池实施批落地后)**(混编伏击上限取值口径面已随 2026-09-20 单轮上限删除消解)。**已编入 roadmap 迭代 16 卡①(2026-10-05——任务书已成文待 U0:design/research/任务书-敌人表行集多行批-2026-10-05.md;前置「技能池实施批落地」已于 2026-10-05 满足〔d3fa887〕,开工门已解,余 4 项待用户裁点)**
|
||||
|
||||
|
||||
#### 技能池情境条件触发器
|
||||
@@ -177,7 +177,7 @@
|
||||
|
||||
**归属**:战斗结算与地图战斗资源共裁(数值终值归状态层重设计批)
|
||||
|
||||
**状态**:待办(语义已定案,数值未闭合)
|
||||
**状态**:待办(语义已定案,数值未闭合)——**已编入 roadmap 迭代 16 卡② M4 数值批(2026-10-05——任务书已成文待 U0:design/research/任务书-M4数值批-2026-10-05.md;duration 终值与当量锚复算 = 件①,跑批发起前须用户批准)**
|
||||
|
||||
#### 单体寻址的接口扩展位
|
||||
|
||||
@@ -223,7 +223,7 @@
|
||||
|
||||
**归属**:①元进度设计批 + 曲线调参批 ②曲线调参批(现行窗) ③~~秘宝同调实施批~~(已清偿 2026-10-03)
|
||||
|
||||
**状态**:已登记(2026-10-01,迭代 10 批随批)
|
||||
**状态**:已登记(2026-10-01,迭代 10 批随批)——**①②已编入 roadmap 迭代 16 卡② M4 数值批(2026-10-05——任务书已成文待 U0:design/research/任务书-M4数值批-2026-10-05.md;钥石产出重标 + 通关率带重扫 = 件③,跑批发起前须用户批准)**
|
||||
|
||||
#### 调参批数值点评登记(八型批随批登记)
|
||||
|
||||
@@ -231,7 +231,7 @@
|
||||
|
||||
**归属**:[难度曲线与Boss](systems/冒险循环/难度曲线与Boss.md)难度曲线调参批
|
||||
|
||||
**状态**:待办(随调参批一并裁决)
|
||||
**状态**:待办(随调参批一并裁决)——**已编入 roadmap 迭代 16 卡② M4 数值批(2026-10-05——任务书已成文待 U0:design/research/任务书-M4数值批-2026-10-05.md;五条点评逐条裁决 = 件②)**
|
||||
|
||||
#### 基线通关率越带,加难杠杆扫描未执行
|
||||
|
||||
@@ -247,7 +247,7 @@
|
||||
|
||||
**归属**:元进度设计批
|
||||
|
||||
**状态**:部分收口(2026-09-21 元进度实现批再收窄;2026-09-23 换算率标定批再收窄)——**三柜台结构与 provisional 定价已落地**(属性锻造三档血+3/攻+1/甲+1、base 10 公比 150;Boss 两档 L1 5/1·L2 8/2·L3 12/3;工坊六件阈值 1/1/2/2/3/3 按总通关次数——全部读 `data/tables/meta.tres`);换算率三行已投值 6/9/1(同批,冒险条件口径实测,护甲行强条目重测履行);剩余面 = 定价数字与 Boss 两档
|
||||
**状态**:部分收口(2026-09-21 元进度实现批再收窄;2026-09-23 换算率标定批再收窄)——**三柜台结构与 provisional 定价已落地**(属性锻造三档血+3/攻+1/甲+1、base 10 公比 150;Boss 两档 L1 5/1·L2 8/2·L3 12/3;工坊六件阈值 1/1/2/2/3/3 按总通关次数——全部读 `data/tables/meta.tres`);换算率三行已投值 6/9/1(同批,冒险条件口径实测,护甲行强条目重测履行);剩余面 = 定价数字与 Boss 两档——**已编入 roadmap 迭代 16 卡② M4 数值批(2026-10-05——任务书已成文待 U0:design/research/任务书-M4数值批-2026-10-05.md;定价数字与 Boss 两档终值 = 件④。注:本条「base 10 公比 150」文本滞后——meta.tres 现行 forge base_price=20(2026-09-22 数值设计批对齿 10→20),随件④收口时刷新)**
|
||||
|
||||
#### 解锁界面与钥石呈现的交互形态(残余:暂停层只读入口)
|
||||
|
||||
@@ -255,7 +255,7 @@
|
||||
|
||||
**归属**:HUD 批(M-4,批未立项)
|
||||
|
||||
**状态**:待办(2026-10-03 06 清账批瘦身——视觉终稿半兑现销号,本条仅存暂停层残余)
|
||||
**状态**:待办(2026-10-03 06 清账批瘦身——视觉终稿半兑现销号,本条仅存暂停层残余)——**已编入 roadmap 迭代 16 卡③(2026-10-05——任务书已成文待 U0:design/research/任务书-暂停层只读入口批-2026-10-05.md;4 项待用户裁点〔入口位置/与既有弹窗层关系/展示范围/减动效联动〕,美术红线=复用现行公共件零新素材)**
|
||||
#### 第一关亮墨数字直画观感优化(2026-10-01 T17 目检体感登记)
|
||||
|
||||
**现状**:迭代 9 T4 数字承载切换后第一关=亮墨三档直画(白亮字直接印棕色地板、无色牌垫底),机制可读性过闸(用户实机确认三档冷暖可分、凑近与离屏均可读);同日 T17 目检体感「表现和描述一样,但非常难看」——直画字与地板的组合观感待优化。第二/三关米色小牌形态未获同类反馈。
|
||||
@@ -343,7 +343,7 @@
|
||||
|
||||
**归属**:新界面立项(用户发令后排批);退役落码随 UI 落码批 M8/M9
|
||||
|
||||
**状态**:待办(生涯未做前,冒险中无任何历史回看入口——已知代价,用户知情裁决)
|
||||
**状态**:待办(生涯未做前,冒险中无任何历史回看入口——已知代价,用户知情裁决)——**已编入 roadmap 迭代 16 卡④(2026-10-05——设计提纲版任务书已成文待 U0:design/research/任务书-生涯界面设计立项-2026-10-05.md;只做设计不做实装,6 项待用户裁点,实装批另行立项)**
|
||||
|
||||
### GP 经济
|
||||
|
||||
|
||||
@@ -0,0 +1,190 @@
|
||||
# 任务书:M4 数值批(v1.0 定稿,待发令开工)
|
||||
|
||||
> 成文 2026-10-05。**性质**:四件数值收口合一批 + 两件读数义务随批跑 + 一件既有探针红灯顺路修复。
|
||||
> 归属迭代:**迭代 16 · 卡②**(迭代 16 四卡:①敌人表行集多行批 ②本批 ③暂停层只读入口批 ④生涯界面设计立项)。
|
||||
> 满足 loop engineering 八件(见 §9 逐条对照)。
|
||||
> 🔴 **铁规前置(违反即返工)**:①本批一切 MC / verifier 跑批**发起前须用户批准**(先推算后重跑铁规 + MC 触发细则:数值验证场景才触发,四档硬闸在册);②**调参联动禁独立调参网络**——行动经济 F1 条款3 v0.8 已立 β 带 [1.2,2.5] 逐 u 检算口径,任何数值调整须按调参联动表同窗检算,禁单参数孤立改。
|
||||
|
||||
---
|
||||
|
||||
## 1. 目标与完成定义
|
||||
|
||||
### 1.1 一句话目标
|
||||
|
||||
把四笔在册数值欠账一次收掉:削弱档位终值、调参批数值点评、迭代 10 奖励重构联动欠账两件、元进度定价剩余面;顺带把迭代 14 留下的两件读数义务跑完、把 damage_probe A1 改前既有红灯修掉。
|
||||
|
||||
### 1.2 完成定义(出口判定清单)
|
||||
|
||||
| # | 判定项 | 量化标准 |
|
||||
|---|---|---|
|
||||
| 1 | 四件欠账各有着落 | ①削弱 duration 终值投定 + 当量锚复算落文;②数值点评五条逐条裁决落文(维持/调整各有结论,无「再看看」);③钥石产出重标完成(provisional 摘除或转正式登记);④元进度定价数字与 Boss 两档终值投定 |
|
||||
| 2 | 读数义务两件履行 | T6 MC 四带复算读数出报告;T7 技能池节奏重测读数出报告(均须用户批准后发起) |
|
||||
| 3 | damage_probe A1 转绿 | 「fresh 池 Boss 21 拍攻击链」断言修复或通过断言换代诚实关闭(换代须呈报依据),damage_probe 七项全绿 |
|
||||
| 4 | 文档三类同步 | 凡动数值:`.tres` + GDD 正文表格 + registry entities.yaml + 06 状态行四类同步(doc-conventions §5 双写失同步禁止条款) |
|
||||
| 5 | 重闸全绿 + 人闸完成 | 冒烟全量(基线 T0 重测回填)· run_all 十五套件 · doc 三闸零新增 · 熵增闸 PASS;provisional 追认清单与读数报告交付用户 |
|
||||
|
||||
> ⚠️ **基线纪律**:起草时点 master 头 = 413c936,冒烟基线 772/0,run_all 14/15(reward_overlay_test 红 = 迭代 15② 奇物批遗留基线红,与本批无关,对照口径 = 零新增)。T0 重测回填,禁止沿用本文数字。
|
||||
|
||||
## 2. 现状事实(代码级考证,2026-10-05 起草时点;T0 须自行复核)
|
||||
|
||||
### 2.1 件① 削弱档位终值(06「削弱档位的最终数值」条)
|
||||
|
||||
| # | 事实 | 读数 |
|
||||
|---|---|---|
|
||||
| F1 | 现行表值 | `status_effects.tres`:`weaken` magnitude **−65**(percent)· `duration_settlements` **2** · `stack_policy` refresh(叠层改续时语义已定案,2026-09-18 盘问会话 + 结构修复批落地)· max_stack 16(续时语义下结构性不触顶) |
|
||||
| F2 | 欠账内容 | duration 终值(现值 2 为临时值)+ 当量锚复算(「标中旗必须比随便挖一格更值」的当量终值,战斗结算与地图战斗资源共裁) |
|
||||
| F3 | 取值域 | [60,85](06 条目登记,源自旧体系裁决);复算须按 β 带 [1.2,2.5] 逐 u 检算口径(行动经济 F1 条款3 v0.8) |
|
||||
| F4 | 关联新变量 | 2026-10-05 判式换代批已投 `flag_hit_premium=125`(provisional,旗溢价 ×1.25)——削弱当量复算须把旗溢价纳入同窗检算(难度曲线与Boss 调参联动表已登记 δ↔p_perfect↔ap_per_round 联动面) |
|
||||
|
||||
### 2.2 件② 调参批数值点评(06「调参批数值点评登记」条)
|
||||
|
||||
| # | 事实 | 读数 |
|
||||
|---|---|---|
|
||||
| F5 | 条目现行登记 = **五条** | ①增伤型奖励/惩罚幅度 50/25 不对称是否有意;②削弱型 65/25 同问(percent 套个位数取整偏粗——主角攻击 2 点时 ±25% 常取整无感);③回血奖励过薄(值 1、权重全池最低 2);④警觉/行动点修正两词数值全 provisional;⑤行动经济「满停一轮 = 一刷」节拍在 AP±1 修正下的对账 |
|
||||
| F6 | ⚠️ 口径差异呈报 | 任务背景写「八条」,06 条目现行登记为**五条**(①-⑤,「八型批随批登记」指八型资源批,非八条点评)。本任务书以 06 条目五条为准;若用户另有所指的八条,T0 呈报后补登 |
|
||||
|
||||
### 2.3 件③ 迭代 10 奖励重构联动欠账①②(06「迭代 10 奖励重构联动欠账」条)
|
||||
|
||||
| # | 事实 | 读数 |
|
||||
|---|---|---|
|
||||
| F7 | 欠账①钥石产出重标 | 渠道已改「Boss/精英击杀逐杀掉落」(大奖励 `keystone_per_level` 退役);`meta.tres` `boss_keystone` 现值 = 首杀 **3/3/3**(三关统一)· 复杀 **2/2/3**,provisional(迭代 10 P-B 乙拍板重锚);精英掉 1 为预留行未实装 |
|
||||
| F8 | 欠账②通关率带重扫 | 通关回血已改 20%(`clear_heal_pct`,血回满→部分回血,难度上压方向)+ 三选一件值/权重/次数上限 knob(AP 件 = 每场战斗首轮 +1 AP,强度敏感轴)——难度曲线与Boss P1 行已登记 |
|
||||
| F9 | 欠账③已清偿 | 同调位读数源切换已于 2026-10-03 迭代 11 第①批完成,不在本批范围 |
|
||||
| F10 | 现行带值 | 难度曲线与Boss.md 带换代(2026-10-03 迭代 9 出口):A[0,10] / B[50,85] / C[30,60] 预立 / D 响应曲线 ≤15pp·S 形;旧三带作废 |
|
||||
|
||||
### 2.4 件④ 元进度定价剩余面(06「三方向各自的解锁清单与定价」条)
|
||||
|
||||
| # | 事实 | 读数 |
|
||||
|---|---|---|
|
||||
| F11 | 柜台定价现值 | `meta.tres` forge_products 三行:`base_price` **20** · `price_ratio_pct` **150**(血+3/攻+1/甲+1 不变)——⚠️ **06 条目文本写「base 10 公比 150」,与表值不符**:2026-09-22 数值设计批(关卡成长×永久成长对齿)已把 base_price 10→20,06 条目文本滞后未刷新,本批随件④收口时一并刷新该句 |
|
||||
| F12 | Boss 两档现值 | 同 F7(首杀 3/3/3 · 复杀 2/2/3,provisional);剩余面 = 定价数字与 Boss 两档**终值**投定 |
|
||||
| F13 | 工坊六件 | 阈值 1/1/2/2/3/3 按总通关次数(channel=total_clears)已落地;06 注记「钥石直购价随定价批后补」——直购价是否立列随批裁(P4) |
|
||||
| F14 | 换算率 | conversion 三行已投 6/9/1(2026-09-23 标定批,冒险条件口径实测)——不在本批范围,除非重标读数破带 |
|
||||
|
||||
### 2.5 读数义务与顺路修复
|
||||
|
||||
| # | 事实 | 读数 |
|
||||
|---|---|---|
|
||||
| F15 | 读数义务 A | **T6 MC 四带复算**(初始展开收窄批后置,2026-10-05 落籍时按切分预案挂 07 现行义务):收窄批(剃雷域 r=1 + R₀≤cap 重掷闸)后的四带通关率复算 |
|
||||
| F16 | 读数义务 B | **T7 技能池节奏重测**(07 现行义务,技能池执行批挂单):≥50 distinct seeds 节奏重测,过涝判读带 = Boss 半血后特殊技密度上探;S2 过涝越带 → 解锁技权重/倍率回调**呈报禁自动调** |
|
||||
| F17 | 顺路修复 | **damage_probe A1 红灯**(`smoke/damage_probe.gd:72`「A1 攻击链健康(fresh 池·掷点口径):非蓄力拍 d_tick = max(下限, 掷点档位基线+附加)」)——判式换代批出口报告 §四.7 在册:**改前既有红**(26374ac 复跑同败,非任何在册批引入),原登记「归独立 mini-loop 处置」,现按用户令编入本批顺路修复 |
|
||||
|
||||
## 3. 范围边界(🔴 不可越界)
|
||||
|
||||
| 禁项 | 理由 |
|
||||
|---|---|
|
||||
| 🔴 **MC/verifier 跑批先报批** | 一切跑批(T6 复算 / T7 重测 / 投值前后验证锚)发起前须用户批准;先推算后重跑铁规 + MC 四档硬闸(一档只能用户发起;二档 ≤40/档 ≤20;三档 ≤20;四档 ≤5) |
|
||||
| 🔴 **禁独立调参网络** | 任一数值调整必须按难度曲线与Boss 调参联动表同窗检算(β 带 [1.2,2.5] 逐 u 检算);旗溢价 δ↔p_perfect↔ap_per_round 联动面不得单动 |
|
||||
| **雷安同池与结构冻结不动** | 池结构、雷安同池、技能类型枚举等结构冻结面非本批范围 |
|
||||
| **双写失同步禁止** | 动任何数值必须 `.tres` + GDD 正文 + registry + 06 状态行四类同步,缺步即视为未完成(doc-conventions §5) |
|
||||
| **非数值面零触碰** | 本批不改机制、不改呈现、不改存档 schema |
|
||||
| **迭代 15② 奇物批不交叉** | 渠道分离与入池实施段归迭代 15 继续完成,与本批无关;reward_overlay_test 基线红归②批处置,本批只守零新增 |
|
||||
|
||||
## 4. 设计契约(🔴 触碰 = L3 停机)
|
||||
|
||||
| # | 契约 | 验证方式 |
|
||||
|---|---|---|
|
||||
| 🔴 R1 | **跑批批准制**:任何 MC/verifier 发起前拿到用户明示批准,批准口径(档位/局数/种子)随工作日志留痕 | 工作日志逐笔记 |
|
||||
| 🔴 R2 | **联动检算**:每个投值点附 β 带逐 u 检算行(u=1/2/3),破带不擅调、呈报 | 投值 commit 随附检算 |
|
||||
| 🔴 R3 | **先推算后重跑**:所有读数先给静态推算/预期区间,批不准不动模拟器 | 读数报告含推算节 |
|
||||
| 🔴 R4 | **provisional 纪律**:新投值一律 provisional 标注并归出口追认清单;摘除 provisional 须读数支撑 | 出口追认清单 |
|
||||
| 🔴 R5 | **改前锚留盘禁补跑**:凡改前/改后对比,改前锚同 seed0 配对留盘,禁补跑禁覆盖 | sim-data 锚清单 |
|
||||
|
||||
## 5. 任务卡(逐卡一个 loop 轮次)
|
||||
|
||||
| 卡 | 内容 | 估时 | 轻闸 | 完成判据 |
|
||||
|---|---|---|---|---|
|
||||
| **T0** | 开工:worktree + 基线重测回填 + §2 事实表复核(重点 F1/F7/F11/F17)+ 四件欠账的静态推算稿(每件先给推算结论与建议值区间) | 0.75d | 冒烟基线 | 推算稿四件齐 + 基线回填;推算结论呈用户并**请批跑批计划**(R1/R3) |
|
||||
| **T1** | 件①削弱终值:duration 终值与当量锚复算(推算 → 用户批跑批 → 投值)+ 文档四类同步 | 0.75d | 冒烟 | β 带检算行随 commit;provisional 归出口追认 |
|
||||
| **T2** | 件②数值点评五条逐条裁决呈报(每条:维持/调整 + 依据;调整项推算先行) | 0.75d | 冒烟(动值轮) | 五条全有结论落文(难度曲线与Boss.md 或对应正主文档 + 06 状态行) |
|
||||
| **T3** | 件③联动欠账:钥石产出重标(F7 读数推算 + 现行产出结构对账)+ 通关率带重扫(F8,须用户批跑批) | 1.0d | 冒烟 | ①②两条 06 状态行收口;重扫读数落报告 |
|
||||
| **T4** | 件④定价剩余面:柜台定价数字终值 + Boss 两档终值(推算 → 批跑 → 投值)+ 06 文本滞后句刷新(F11) | 0.75d | 冒烟 | meta.tres 终值落 + 四类同步 |
|
||||
| **T5** | 读数义务两件:T6 MC 四带复算 + T7 技能池节奏重测(用户批准后发起,可与其他卡窗口期并行等结果) | 0.75d | — | 两份读数报告落 design/qa/;S2 越带按呈报口径处理 |
|
||||
| **T6** | damage_probe A1 修复:归因(fresh 池 21 拍攻击链判式与判式换代后口径对账)→ 修探针或修判式换代断言 | 0.5d | damage_probe 七项 | 七项全绿;若判断言换代,换代依据落报告 |
|
||||
| **T7** | 重闸 + 人闸材料:全量闸 + provisional 追认清单 + 读数报告三件打包 | 0.5d | 重闸全绿 | §1.2 判定 5 |
|
||||
| **T8** | 收口五步 + 06 四条状态行收口 | 0.25d | — | 收口五步齐 |
|
||||
|
||||
> 估时合计 ≈ **6.0d**,显著超软时间盒 3 日上限——知情预挂:**天然切分点 = T4 末**(段一 T0-T4 四件欠账 ≈4.25d / 段二 T5-T8 读数与修复 ≈2.0d);超限即按 L3 呈报切点,不擅切。读数跑批的墙钟时间不计估时(用户批准后后台跑)。
|
||||
|
||||
## 6. 验证闸
|
||||
|
||||
- **轻闸**(每轮):run_smoke 全量 + ui_input_probe(本批不触 presentation,预计无需加跑探针)。
|
||||
- **重闸**(T7):全量轻闸 + doc 三闸零新增 + 熵增闸 + damage_probe 七项全绿。
|
||||
- **MC/verifier**:全部走 R1 批准制;改前/改后锚同 seed0 配对、改前锚留盘禁补跑;≥60 局采集先 N=5 pilot 校验字段;二/三/四档会话累计 ≤20 分钟。
|
||||
|
||||
## 7. 代拍板白名单与待用户裁点
|
||||
|
||||
**白名单内**(实现层无争议项):
|
||||
- 推算稿的行文组织与报告文件命名(落 design/qa/,按日期命名惯例)
|
||||
- damage_probe A1 的具体修法选择(修探针判式 vs 修断言换代——依据充分时;换代须附依据落报告)
|
||||
- 06 状态行与文档同步的措辞
|
||||
|
||||
**待用户裁点**:
|
||||
|
||||
### P1 · 削弱 duration 终值候选(推算后回填,起草期先呈框架)
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲 | 维持 2 场结算,magnitude 在 [60,85] 内按当量锚复算终值 | 改动面最小;续时语义下 2 场已覆盖大多数战斗长度 |
|
||||
| 乙 | duration 抬至 3,magnitude 相应下调保持当量 | 覆盖更长战斗;代价是当量稀释、标中旗即时感变弱 |
|
||||
| 丙 | 维持现值 −65/2 不动,仅完成当量锚复算落文 | 若复算证实现值已落 β 带内,这是合法出口——「终值」可以是现值转正 |
|
||||
|
||||
> 三案取捨依赖 T1 推算读数,本任务书不预设推荐;推算结论随 T0/T1 呈报。
|
||||
|
||||
### P2 · 数值点评①②的「不对称是否有意」裁决方向
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲 | 承认不对称是有意(奖励厚于惩罚),落文为设计立场 | 与「奖励驱动挖掘」的现行体验方向一致;零数值改动 |
|
||||
| 乙 | 对齐对称(惩罚抬至与奖励同幅) | 数学整齐;代价是惩罚侧显著变痛,需通关率复测(跑批成本) |
|
||||
| 丙 | 对齐对称(奖励压至与惩罚同幅) | 淘汰候选:奖励变薄直接削弱挖掘动机,与回血过薄点评③同向恶化 |
|
||||
|
||||
### P3 · 钥石产出重标的终值方向
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲 | 维持首杀 3/3/3 · 复杀 2/2/3 转正 | 现行读数(迭代 10 四代锚钥石 1.38/3.01)未显示失衡;零改动 |
|
||||
| 乙 | 按定价终值(P4 联动)倒推产出重锚 | 产出与定价同账收口最彻底;代价是定价未定前产出无法先定,两裁点强耦合 |
|
||||
| 丙 | 精英掉落行实装并纳入产出账 | 淘汰候选:精英属 P2 内容承载(06 已裁不设精英编码位),本批不引新内容轴 |
|
||||
|
||||
### P4 · 工坊六件是否立钥石直购价
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲 | 维持总通关次数阈值单一渠道,不立直购价 | 门槛语义清晰(玩得多自然解锁);零新定价面 |
|
||||
| 乙 | 补立直购价(次数或钥石二选一兑付) | 给「缺一两件但不想再刷」的玩家出口;代价是定价又多一组待标数字,本批定价面扩大 |
|
||||
|
||||
> P3/P4 与件④定价终值同属一本账,建议同一裁决轮次处理。
|
||||
|
||||
## 8. 异常分级
|
||||
|
||||
| 级 | 触发 | 处置 |
|
||||
|---|---|---|
|
||||
| **L1** | 单轮轻闸红 / 推算与复测同向但量级偏差小 | 一次重试自查;仍红 → L2 |
|
||||
| **L2** | 推算与复测方向一致但量级差 >50% / 连续 3 轮同红灯 | 记录进任务书与工作日志,修订推算模型后继续 |
|
||||
| **L3** | 任一 🔴 R1–R5 破 / 推算与复测方向相反 / 复算暴露结构性破线(β 带全 u 破、带值整体失效)/ 跑批未获批 | 停机写报告等用户发令;**窗口不足如实挂起,禁在二/三/四档下带值结论** |
|
||||
|
||||
## 9. loop engineering 八件对照(合规自证)
|
||||
|
||||
| # | 八件要求 | 本文对应 |
|
||||
|---|---|---|
|
||||
| 1 | 计划书八节 | §1 目标与完成定义 · §2 现状事实 · §4 设计契约 · §3 范围边界 · §5 任务卡 · §6 验证闸 · §8 异常分级 · §7 白名单与裁点 |
|
||||
| 2 | T0 开工 | §5 T0(worktree + 基线重测 + 推算稿 + 跑批请批) |
|
||||
| 3 | 循环骨架 | §5 各卡 |
|
||||
| 4 | 轻闸 | §6 轻闸段 |
|
||||
| 5 | 重闸 | §6 重闸段 + §5 T7 |
|
||||
| 6 | 人闸 | §5 T7(provisional 追认清单 + 读数报告 = 本批人闸材料) |
|
||||
| 7 | 异常分级 | §8 |
|
||||
| 8 | 收口五步 | §5 T8 |
|
||||
|
||||
## 10. 现状留痕(供执行会话读序)
|
||||
|
||||
```
|
||||
1. design/gdd/06-待办清单.md 四条:「削弱档位的最终数值」/「调参批数值点评登记」/「迭代 10 奖励重构联动欠账」/「三方向各自的解锁清单与定价」
|
||||
2. game/data/tables/status_effects.tres(weaken 行)· meta.tres(forge_products/boss_keystone/workshop_items/conversion)
|
||||
3. design/gdd/systems/冒险循环/难度曲线与Boss.md(带换代节 + 调参联动表——β 带 [1.2,2.5] 逐 u 检算口径)
|
||||
4. design/gdd/systems/排雷循环/行动经济.md F1 条款3 v0.8(判式换代后现行口径)
|
||||
5. design/gdd/07-体验验证清单.md「验收读数重测义务」节(T6/T7 挂单原文)
|
||||
6. design/qa/m4iter14-mineq-exit-report-2026-10-05.md §四.7(damage_probe A1 改前既有红的在册登记)
|
||||
7. design/qa/m4iter14-narrow 相关读数与 design/qa/m3-iter10-clear-rate-readings-2026-10-01.md(重扫基线)
|
||||
```
|
||||
@@ -0,0 +1,191 @@
|
||||
# 任务书:敌人表行集多行批(v1.0 定稿,待发令开工)
|
||||
|
||||
> 成文 2026-10-05。**性质**:数据表校验与生成机制放开 + 配套呈现适配,允许同一场遭遇混编多种敌人。
|
||||
> 事实源 = [06-待办清单](../gdd/06-待办清单.md)「同深度第二敌种与精英 / Boss 编码位」条剩余面(该条前半「同层多遭遇」已由关卡节点地图 v1.0 节点编号升级消解,剩余即本卡);设计权威 = [敌人系统](../gdd/systems/战斗循环/敌人系统.md) v0.13(技能池执行批已落籍,Boss 半血解锁技已入表)。
|
||||
> 归属迭代:**迭代 16 · 卡①**(迭代 16 四卡:①本批 ②M4 数值批 ③暂停层只读入口批 ④生涯界面设计立项)。
|
||||
> 满足 loop engineering 八件(见 §9 逐条对照)。
|
||||
> 开工门:**已解**——前置「技能池实施批落地」已于 2026-10-05 完成(技能池执行批合并进 master,提交 d3fa887,冒烟 772/0)。
|
||||
|
||||
---
|
||||
|
||||
## 1. 目标与完成定义
|
||||
|
||||
### 1.1 一句话目标
|
||||
|
||||
放开敌人表「同一(关卡序号 × 节点深度)行集内只允许一种敌人」的加载期校验,让同一场遭遇可以在表内配多种敌人混编上场,并把生成、呈现、断言全链接通。
|
||||
|
||||
### 1.2 完成定义(出口判定清单——五条全满足才算本批完成)
|
||||
|
||||
| # | 判定项 | 量化标准 |
|
||||
|---|---|---|
|
||||
| 1 | 校验放开 | 敌人表同一行集配两种以上敌人不再触发加载期致命错误;新的行集构成纪律(§5 R2 的具体条款,先随 P1/P4 裁决落文再落码)由加载期校验兜底 |
|
||||
| 2 | 生成链接通 | 混编行集开战后,各敌种按裁决后的数量语义(P1)实例化上场,各自实例池独立摇号;固定顺位、死亡顺延、范围效果全体现行语义不破 |
|
||||
| 3 | 零内容期零漂移 | 在未投放任何混编行的表状态下,MC 与冒烟数值断言对基线**逐位一致**(机制放开但表内容不变 = 行为必须不变) |
|
||||
| 4 | 重闸全绿 | 冒烟全量(基线数字 T0 重测回填,禁止沿用本文历史数字)· run_all 十五套件 · 场景探针(触呈现加 ui_struct_probe / ui_click_probe / ui_layout_probe)· doc 三闸对基线零新增 · 熵增闸 PASS |
|
||||
| 5 | 人闸完成 | 混编遭遇实机目检清单过(若在 P3 裁「本批投放首个混编行」)+ 代拍板追认清单过;收口五步齐 |
|
||||
|
||||
> ⚠️ **基线纪律**:本任务书起草时 master 头 = 413c936(ui-struct-probe mini-loop 合并后),冒烟基线 772/0。开工 T0 必须重测基线取实际值回填,禁止把本文数字当闸门。
|
||||
|
||||
## 2. 现状事实(代码级考证,2026-10-05 起草时点;T0 须自行复核)
|
||||
|
||||
| # | 事实 | 读数 |
|
||||
|---|---|---|
|
||||
| F1 | 「每行集恰一敌种」校验位置 | `game/data/schemas/enemy_table.gd:108-112`——按 `(level_index, node_depth)` 聚合,行集内出现第二个 `enemy_id` 即报 `rowset_rule` 类错误,加载期致命中止 |
|
||||
| F2 | 行集解析双算法共存 | ①`EnemyTable.resolve_rowset`(`enemy_table.gd:121-132`)= **floor 语义**(取 ≤ 请求坐标的最近行),仅 `smoke_all.gd:3383/3385/3415/3418` 四处使用;②`ConfigDbResolver.resolve_enemy_rowset`(`config_db_resolver.gd:33-34` → `_resolve_progress`)= **ceil 语义**(向上取整保证偏难,2026-09-18 拍板),是全部生产消费面入口。两函数都**只返回单行** |
|
||||
| F3 | 双算法处置是既有待裁项 | 工作日志 312(2026-10-02 代码质量修复批)呈报的七拍板点之一「enemy_table.resolve_rowset 双算法」至今未裁——本批动行集解析必然擦到这条,列入 §8 待裁点 P2 |
|
||||
| F4 | 生成消费点 | `unit_container.gd:47` `spawn()` 取单行后按 `unit_count`(或遭遇骰传入的数量)生成 count 个**同种**实例;数量域常量 `EnemyTable.UNIT_COUNT_MIN/MAX = [1,3]`,表校验与 spawn 守卫共用(`enemy_table.gd:18-21`) |
|
||||
| F5 | 其余消费点 | `battle_orchestrator.gd:220`(战前预取行 erow_pre)· `battle_narrator.gd:75`(叙述取敌种)· `smoke/skill_rhythm_probe.gd:17` · `smoke/damage_probe.gd:270/421` · `smoke_all.gd` 十余处 · `tests/unit/data_config/config_db_test.gd:59-61`(双表精确行契约断言) |
|
||||
| F6 | GDD 侧结构冻结 | 敌人系统.md 规则表「每个坐标只出一种敌种」(:75)+ 结构冻结条款含「每坐标恰一敌种」(:263)——属**结构冻结面**,修订须先走 GDD 修订流程落文再落码,禁止码先文后 |
|
||||
| F7 | 表内容现状 | `enemy.tres` 共 21 行、8 敌种(地精/熊地精/食人魔酋长/巨蜘蛛/蛛化卓尔精灵/灰矮人/钩爪恐魔/灰矮人石君王),现行每行集恰一行 |
|
||||
| F8 | 遭遇骰与数量骰 | 数量区间(`unit_count`/`unit_count_max`)由战斗结算遭遇骰同流在 spawn 期掷定一次传入确定值(敌人系统零随机纪律——本系统只收确定结果);攻击区间同理。混编不改这条纪律 |
|
||||
| F9 | 难度修饰 | `resolve_difficulty_modifiers` 按 (L,D) 精确匹配返回 hp_mult/atk_mult,施加于行值快照之前(`unit_container.gd:61-63`)——混编后该修饰**对行集内全部敌种同乘**,不改变异 |
|
||||
| F10 | 范围效果语义 | 敌人系统.md:75「敌方效果对全体生效」规则的前提是「场上敌人全同种,范围效果作用于所有存活敌人是天然兼容的默认」——混编后「全体存活敌人共享」的结算语义**不需要改**(效果本就按存活单位逐一生效),但 GDD 该句前提描述须随批修订 |
|
||||
| F11 | 现行同类先例 | 同表多行已有合法形态:`pool` 数组内多技能行、`unit_count` 区间;跨表「双表精确行契约」(board_gen × enemy 同坐标精确行)由 `smoke_all.gd:294-311` 与单测断言维护——混编放开后该契约的「精确行」语义须改为「精确行集」 |
|
||||
|
||||
## 3. 改动清单(分四组,逐组独立可提交)
|
||||
|
||||
### 组 A · GDD 修订先行(结构冻结面的合法修订通道)
|
||||
|
||||
| 文件 | 改动 |
|
||||
|---|---|
|
||||
| `敌人系统.md` | 「每个坐标只出一种敌种」规则改写为混编口径(行集多行、数量语义按 P1 裁决落文);结构冻结条款对应项改写;「敌方效果对全体生效」前提描述修订(F10);版本历史 +1 |
|
||||
| `难度曲线与Boss.md` | 混编遭遇首放行集的难度归属注记(行值 provisional 归调参的既有口径不变) |
|
||||
| `design/registry/entities.yaml` | 敌人表行集条目的契约描述同步 |
|
||||
| `06-待办清单.md` | 「同深度第二敌种与精英 / Boss 编码位」条状态行收口(剩余面完成日期留痕,条目本体按解决口径处理) |
|
||||
|
||||
### 组 B · 表 schema 与解析层
|
||||
|
||||
| 文件 | 改动 |
|
||||
|---|---|
|
||||
| `enemy_table.gd` | 「每行集恰一敌种」校验(:108-112)替换为混编构成纪律校验(条款随 P1/P4 裁决:如行集总行数上限、Boss 行是否允许多行、同敌种重复行仍禁止);键结构 `(L,D,enemy_id)` 不变(dup_key 校验不动) |
|
||||
| `config_db_resolver.gd` | `resolve_enemy_rowset` 由返回单行改为返回**行集数组**(ceil 命中 (l*,d*) 后取该坐标全部行);单行访问器保留还是全量换代随 P2 裁决 |
|
||||
| `enemy_table.gd` floor 版 | 随 P2 裁决:退役或对齐;冒烟四处调用点同步 |
|
||||
|
||||
### 组 C · 生成与战斗编排
|
||||
|
||||
| 文件 | 改动 |
|
||||
|---|---|
|
||||
| `unit_container.gd` | `spawn()` 改受理行集:逐行按各自数量语义实例化,行主序生成序保持(`default_target` 固定顺位语义自然兼容);实例池快照逐行独立(现行逐实例快照逻辑天然兼容);数量域守卫改为行集级(上限随 P1) |
|
||||
| `battle_orchestrator.gd:220` | 战前预取改行集形态 |
|
||||
| `battle_narrator.gd:75` | 叙述取敌种改行集形态(混编遭遇的开战叙述口径——逐种列名还是取首种,随批定,属呈现文案) |
|
||||
|
||||
### 组 D · 断言与探针
|
||||
|
||||
| 文件 | 改动 |
|
||||
|---|---|
|
||||
| `smoke_all.gd` | 行集结构断言换代:「行集恰一敌种」相关断言(:2900 注释口径、L2/L3 定点行集断言 :3383-3420 等)改断言新构成纪律;「双表精确行契约」断言改「精确行集」口径;新增混编正反断言(违规构成定位到类别) |
|
||||
| `config_db_test.gd:59-61` | 同通道断言换代 |
|
||||
| `skill_rhythm_probe.gd` / `damage_probe.gd` | 取数面随行集形态适配(行为零变更期逐位一致是验收条件) |
|
||||
|
||||
## 4. 范围边界(🔴 不可越界)
|
||||
|
||||
| 禁项 | 理由 |
|
||||
|---|---|
|
||||
| **零混编内容期行为零漂移** | 本批的默认形态 = 机制放开 + 表内容不变。P3 若裁「本批投放首个混编行」,投放行本身属内容变更,须单独 MC 取证(先推算后重跑铁规:跑批发起前须用户批准) |
|
||||
| **不改遭遇骰/数量骰随机流** | 敌人系统零随机纪律与 RNG 单点红线不变;混编的数量语义若需新摇号,必须走既有封闭流扩签并先经用户裁决(列入 P1 子项) |
|
||||
| **不改键结构与存档** | `(L,D,enemy_id)` 键、断点存档、跨局存档零触碰 |
|
||||
| **不设精英/Boss 编码位** | 06 条目已裁「不设精英 / Boss 编码位」(精英 P2 内容承载),本批不重开 |
|
||||
| **技能池构成纪律不动** | 每池恰一普攻、增益 ≤1、unlock_hp_pct 投放纪律(仅 Boss 行)原样 |
|
||||
| **数值零触碰** | hp/atk/unit_count/权重行值一律不动(P3 投新行除外,且新行行值 provisional 归调参) |
|
||||
|
||||
## 5. 设计契约(🔴 触碰 = L3 停机)
|
||||
|
||||
| # | 契约 | 验证方式 |
|
||||
|---|---|---|
|
||||
| 🔴 R1 | **零内容期逐位零漂移**:未投混编行的表状态下,全量冒烟数值断言 + MC 对基线逐项一致 | 冒烟全量 + MC 同种子逐项比对(跑批先报批) |
|
||||
| 🔴 R2 | **GDD 先行**:结构冻结面修订必须先落 `敌人系统.md` 再落码;码先文后即返工 | 组 A 提交先于组 B/C |
|
||||
| 🔴 R3 | **fail-fast 语义保持**:行集构成违例仍加载期致命中止,错误类别可定位;禁软回退 | 组 D 正反断言 |
|
||||
| 🔴 R4 | **RNG 单点**:不新增 `randomize()`/自建随机源;如需新摇号点一律经 RngService 封闭流并先报批 | 静态审查 + rng 日志比对 |
|
||||
| 🔴 R5 | **双表精确行契约不破**:board_gen × enemy 同坐标覆盖义务(`smoke_all.gd:294-311`)在混编口径下仍成立 | 组 D 断言换代后全绿 |
|
||||
|
||||
## 6. 任务卡(逐卡一个 loop 轮次)
|
||||
|
||||
| 卡 | 内容 | 估时 | 轻闸 | 完成判据 |
|
||||
|---|---|---|---|---|
|
||||
| **T0** | 开工:worktree + 基线重测回填 §1.2(冒烟/run_all/探针/doc 三闸)+ `git status` 归属核对 + §2 事实表复核(重点 F1/F2/F5 行号) | 0.5d | 全量冒烟基线 | 基线数字回填且全绿;事实表差异如实修订并呈报 |
|
||||
| **T1** | 组 A:GDD 修订(敌人系统.md 混编口径 + 结构冻结条款 + F10 前提句 + 版本历史)+ registry + 06 状态行 | 0.5d | doc 三闸 | 三闸零新增;修订句读者测试过(只读该节能答三问) |
|
||||
| **T2** | 组 B:schema 校验换代 + resolver 行集数组化(P1/P2 裁决后) | 0.75d | 冒烟 | 正反断言红绿各验;旧「恰一敌种」违例行按新纪律判定正确 |
|
||||
| **T3** | 组 C:spawn 行集受理 + battle_orchestrator/narrator 适配 | 0.75d | 冒烟 + ui_struct_probe | 零内容期冒烟逐位绿 |
|
||||
| **T4** | 组 D:smoke/单测/探针断言面换代 + 新增混编构成断言 | 0.5d | 冒烟 + run_all | 十五套件绿;新断言负向验证红(故意配违规行集能抓到) |
|
||||
| **T5** | (条件卡,P3 裁投放才执行)首个混编遭遇行投放 + 行值 provisional 登记 | 0.5d | 冒烟 + MC(先报批) | 混编遭遇开战/结算/胜利全链断言过 |
|
||||
| **T6** | 重闸:全量轻闸 + doc 三闸 + 熵增闸 + MC 逐项比对(零内容期) | 0.5d | 重闸全绿 | §1.2 判定 3/4 |
|
||||
| **T7** | 人闸:目检清单(T5 执行时含混编遭遇实机目检)+ 代拍板追认 | 0.5d | 目检过 | §1.2 判定 5 |
|
||||
| **T8** | 收口五步(active.md 快照 → 工作日志 → roadmap 迭代 16 行标注 → 06 收口 → 闸序列留痕) | 0.25d | — | 收口五步齐 |
|
||||
|
||||
> 估时合计 ≈ **4.25d**(含 T5)/ **3.75d**(不含 T5),超 roadmap 软时间盒 3 日上限——知情预挂:T4 后按 L3 呈报切点,不擅切(沿迭代 9/秘宝批先例)。
|
||||
|
||||
## 7. 验证闸
|
||||
|
||||
- **轻闸**(每轮):run_smoke 全量 + ui_input_probe;触 presentation 的轮次(T3/T5)加 ui_click_probe + ui_layout_probe + ui_struct_probe(2026-10-05 起 ui_struct_probe 已入默认必跑段)。
|
||||
- **重闸**(T6):全量轻闸 + doc 三闸(doc_link / gdd_lint / doc_term,对基线零新增)+ 熵增闸 + MC 逐项比对。
|
||||
- **MC 触发**:零内容期对拍属「结构位移类存档锚」,**发起前先向用户请示定性**(CLAUDE.md MC 触发细则);T5 投放行属数值验证场景,同样先报批。两入口铁规全程有效。
|
||||
|
||||
## 8. 代拍板白名单与待用户裁点
|
||||
|
||||
**白名单内**(执行会话可直接决断,commit 记录):
|
||||
- 行集数组在 GDScript 层的具体返回形态(Array[Dictionary] 的键序、空集表达)
|
||||
- 新校验错误类别命名与报错文案(沿用 `rowset_rule` 类别还是新增)
|
||||
- 各组内提交粒度与改名措辞
|
||||
|
||||
**待用户裁点**(每个裁点列全备选案,含淘汰依据):
|
||||
|
||||
### P1 · 混编数量语义
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲(推荐) | 每行各自 `unit_count` 独立实例化,行集总数上限另立(如 ≤4);数量域 [1,3] 仍约束单行 | 表意最直白,作者按行写数即可;代价是 UNIT_COUNT_MAX 语义从「单场总数」改为「单种数」,须同步改校验与 spawn 守卫 |
|
||||
| 乙 | 行集总数仍 ≤3,按行权重或行序分配各种只数 | 场上规模完全不变、数值面最稳;淘汰理由:分配规则本身是新的隐性机制,作者无法直接表达「我要 1 蜘蛛 + 2 地精」,表意失真 |
|
||||
| 丙 | 每种恒 1 只 | 最简;淘汰理由:混编的主要价值(强弱搭配的数量结构)被阉割,等于只允许「2-3 种各 1 只」一种形态 |
|
||||
|
||||
### P2 · 行集解析双算法处置(工作日志 312 既有待裁项随批)
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲(推荐) | 本批顺带统一:`EnemyTable.resolve_rowset`(floor 版,仅冒烟四处用)退役,全仓统走 resolver ceil 版 | 行集解析本来就要换代,双算法一起收是最便宜时点;一次批内只多 4 处调用点改动 |
|
||||
| 乙 | 本批不动 floor 版,只把 ceil 版行集化;双算法待裁项保持独立 | 批面更纯;淘汰理由:换代后 floor 版从「双算法」变成「三形态」(floor 单行 / ceil 单行 / ceil 行集),债更重 |
|
||||
|
||||
### P3 · 本批是否投放首个混编遭遇行
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲 | 本批只放开机制、零内容投放;首个混编遭遇归后续难度曲线/内容批 | 机制批零数值变更,MC 零跑或仅零扰动对拍,批面最干净 |
|
||||
| 乙(推荐) | 本批顺带投放一个教学位混编行(候选:L2 某普通战斗节点,巨蜘蛛 1 + 钩爪恐魔 1,行值 provisional 归调参) | 机制没有内容验证等于没验收;一个定点行即覆盖全链(生成/叙述/结算/胜利);代价是需 MC 取证(先报批)与行值 provisional 登记 |
|
||||
|
||||
### P4 · Boss 行集是否允许多行
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲(推荐) | 本批仅普通战斗节点放开;Boss 节点行集仍恰一行(加载期校验保留 Boss 行单行约束) | Boss 半血解锁技刚落籍、节奏重测(T7 读数)未跑,Boss 战形态此时不应再加变量;护卫型 Boss 属内容设计,归后续批单议 |
|
||||
| 乙 | Boss 行同样放开 | 淘汰理由:半血解锁/独占技/难度带全部读数面失效风险,且无任何已裁设计支撑 Boss 护卫形态 |
|
||||
|
||||
## 9. loop engineering 八件对照(合规自证)
|
||||
|
||||
| # | 八件要求 | 本文对应 |
|
||||
|---|---|---|
|
||||
| 1 | 计划书八节 | §1 目标与完成定义 · §2 现状事实 · §5 设计契约 · §4 范围边界 · §6 任务卡 · §7 验证闸 · §10 异常分级 · §8 白名单与裁点 |
|
||||
| 2 | T0 开工 | §6 T0(worktree + 基线重测回填 + 归属核对) |
|
||||
| 3 | 循环骨架 | §6 各卡(读卡 → 对事实源 → 实装 → 轻闸 → 提交 → 工作日志) |
|
||||
| 4 | 轻闸 | §7 轻闸段 |
|
||||
| 5 | 重闸 | §7 重闸段 + §6 T6 |
|
||||
| 6 | 人闸 | §6 T7 |
|
||||
| 7 | 异常分级 | §10 |
|
||||
| 8 | 收口五步 | §6 T8 |
|
||||
|
||||
## 10. 异常分级
|
||||
|
||||
| 级 | 触发 | 处置 |
|
||||
|---|---|---|
|
||||
| **L1** | 单轮轻闸红 | 一次重试(自查漏改/调用点遗漏);仍红 → L2 |
|
||||
| **L2** | 同类错误连续 3 轮 / 事实表与 §2 不符 | 记录进本任务书与工作日志,修订事实表后继续;不阻断全批 |
|
||||
| **L3** | 任一 🔴 R1–R5 破 / P1–P4 久决不下 / 发现需要新增随机消费点或改存档 | 停机写报告(列事实 + 影响面 + 方案对比),等用户发令;不自行决断 |
|
||||
|
||||
## 11. 现状留痕(供执行会话读序)
|
||||
|
||||
```
|
||||
1. design/gdd/06-待办清单.md「同深度第二敌种与精英 / Boss 编码位」条(本批登记源,剩余面=行集校验放开)
|
||||
2. design/gdd/systems/战斗循环/敌人系统.md v0.13(设计权威;:75 规则表 / :263 结构冻结 = 组 A 修订对象)
|
||||
3. game/data/schemas/enemy_table.gd(F1 校验点 + floor 版解析)
|
||||
4. game/core/config_db_resolver.gd(ceil 版解析,生产消费面)
|
||||
5. game/core/unit_container.gd spawn(生成消费点,F4)
|
||||
6. 工作日志 312(2026-10-02,enemy_table.resolve_rowset 双算法待裁项出处 = §8 P2)
|
||||
```
|
||||
@@ -0,0 +1,172 @@
|
||||
# 任务书:暂停层只读入口批(v1.0 定稿,待发令开工)
|
||||
|
||||
> 成文 2026-10-05。**性质**:功能性 UI 交互新增——局内暂停层,承载钥石余额与营地柜台解锁进度的**只读**查看。
|
||||
> 事实源 = [06-待办清单](../gdd/06-待办清单.md)「解锁界面与钥石呈现的交互形态(残余:暂停层只读入口)」条。
|
||||
> 归属迭代:**迭代 16 · 卡③**(迭代 16 四卡:①敌人表行集多行批 ②M4 数值批 ③本批 ④生涯界面设计立项)。
|
||||
> 满足 loop engineering 八件(见 §9 逐条对照)。
|
||||
> **美术红线(2026-10-05 用户立规)**:本批不得包含观感类、素材类内容;呈现必须复用现行公共件(UiKit 工厂件)与 ui_kit 色板 token,**不新画任何素材、不新建任何色值**。功能性 UI 交互不算美术。
|
||||
|
||||
---
|
||||
|
||||
## 1. 目标与完成定义
|
||||
|
||||
### 1.1 一句话目标
|
||||
|
||||
冒险进行中(战斗屏与关卡地图屏)给玩家一个暂停入口,打开一层只读界面,查看当前钥石余额与营地三柜台的解锁进度(永久强化已买到什么程度),看完即关,不提供任何购买或修改操作。
|
||||
|
||||
### 1.2 完成定义(出口判定清单)
|
||||
|
||||
| # | 判定项 | 量化标准 |
|
||||
|---|---|---|
|
||||
| 1 | 入口可达 | 局内两个主屏(战斗屏 / 关卡地图屏)均可按 P1 裁决的形态打开暂停层;入口在对局外(主菜单)不误出现 |
|
||||
| 2 | 只读数据正确 | 暂停层展示的钥石余额、三柜台进度与 `MetaProgression` 访问器读数逐项一致;无任何可点购买/切换控件 |
|
||||
| 3 | 公共件复用 | 全部构成件来自 UiKit 现行工厂(modal_shell / bcard / label / badge / icon_rect / verb_button 等)与色板 token;零新素材、零新色值、零新字体 |
|
||||
| 4 | 模态纪律 | 登记进 modal_stack 登记册(main.gd:332 同款),z 序与输入锁行为符合缺陷⑤纪律;与既有弹窗层的关系按 P2 裁决落实 |
|
||||
| 5 | 重闸全绿 + 人闸 | 冒烟全量(基线 T0 重测回填)· run_all 十五套件 · ui_struct_probe / ui_click_probe / ui_input_probe 全绿 · doc 三闸零新增 · 熵增闸 PASS;实机目检清单过 |
|
||||
|
||||
> ⚠️ **基线纪律**:起草时点 master 头 = 413c936,冒烟 772/0,run_all 14/15(reward_overlay_test 基线红归迭代 15②批,本批守零新增)。T0 重测回填。
|
||||
|
||||
## 2. 现状事实(代码级考证,2026-10-05 起草时点;T0 须自行复核)
|
||||
|
||||
| # | 事实 | 读数 |
|
||||
|---|---|---|
|
||||
| F1 | 现行无暂停层 | 全仓无 pause/暂停 实现;局内模态层 = 图例 / 节点兑付 / 关卡画面 / 三选一 / 终局 / 商店 / 营地 / 设置 / 确认弹窗 / 调试浮窗(main.gd:332 登记册 + :242 z 序注记) |
|
||||
| F2 | 模态基础设施现成 | `modal_stack.gd` 状态机 + `_open_modal`/`_close_modal` 单口(main.gd:353 起)+ 输入锁 = `modal_stack.has_open()` 开态查询;新层照登记册追加即可,零新机制 |
|
||||
| F3 | 公共件清单 | `presentation/views/ui_kit.gd`:`modal_shell`(:229)· `verb_button`(:343,图标+动词+tooltip 三件套)· `bcard`(:455,BCard 竖卡:色带/图标槽/价签/底注参数化)· `switch_toggle`(:484)· `styled_slider`(:489)· label / badge / icon_rect 等;色板 token(WARM / STONE / INK_ON_GOLD / 烛光黄徽章形制等)同文件单点 |
|
||||
| F4 | 按钮宽度纪律 | `UiKit.button(text, min_w=216)` 全站最小宽度基准 + SIZE_FILL(2026-10-05 ui-struct-probe 批);行板/角标/图标钮豁免 9 处先例在册;ui_struct_probe 已入轻闸默认必跑段(按钮互压/等宽/出屏/零尺寸断言) |
|
||||
| F5 | 数据面现成 | `meta_progression.gd` 只读访问器齐全:`keystone_balance()`(:28)· `forge_level/forge_flat/forge_price`(:34-44)· `workshop_status()`(:90)· `is_item_unlocked`(:85)· `attune_camp_status()`(:370)· `attune_refresh_charges()`(:397)· `tree_camp_rows()`(:260)· Boss 击杀计数面(`boss_kill_count` 等)——暂停层只读消费,零核心层改动 |
|
||||
| F6 | 钥石呈现现状 | 营地屏顶栏钥石徽(camp_overlay_view.gd:82-93,烛光黄底+深墨字徽章形制)与结算屏入账明细已落地;**战斗屏内 GP/钥石已迁出**(hero_info_panel_view.gd:4-6 注记)——局内想看钥石余额没有任何入口,正是 06 条残余面的由来 |
|
||||
| F7 | 营地三柜台现行构成 | 属性锻造(forge 三行)· 道具工坊(workshop 六件按总通关次数解锁)· 天赋树(迭代 12 批次二营地树 UI);另有同调装配面(attune)。暂停层展示范围见 P3 裁点 |
|
||||
| F8 | 设置面先例 | `settings_overlay.gd` = 最小设置面(音量/全屏/减动效),SettingsOverlay 实例由 main.gd:260 创建并登记模态——暂停层与其关系见 P2 裁点 |
|
||||
| F9 | 减动效开关 | 已转正(迭代 8 卡④,settings_store 承载);排播队列与轮横幅在减动效开时延迟归零——暂停层进出呈现须遵守同一开关(P4 裁点) |
|
||||
| F10 | 调试浮窗先例 | debug_overlay(迭代 15①)= 悬浮 Dialog 形态、DS_DEBUG 门控、仅开始菜单可开——其「角标入口 + Dialog 层」形态是暂停层的最近先例,但门控与可达域不同(暂停层 = 玩家常态功能,对局内可达) |
|
||||
|
||||
## 3. 改动清单(两组)
|
||||
|
||||
### 组 A · 暂停层本体(新文件一个)
|
||||
|
||||
| 文件 | 改动 |
|
||||
|---|---|
|
||||
| `presentation/views/pause_overlay.gd`(新) | 只读覆盖层:标题区 + 钥石余额行(复用营地同款徽章形制:icon_rect(TEX_ICON_KEYSTONE) + label,色板 token 取现行值)+ 三柜台进度区(范围随 P3)+ 关闭钮;全部经 UiKit 工厂件拼装,零自绘 |
|
||||
| `main.gd` | 实例化 + 登记 modal_stack 登记册(z 序位置随 P2)+ 打开/关闭接线 |
|
||||
|
||||
### 组 B · 入口与断言
|
||||
|
||||
| 文件 | 改动 |
|
||||
|---|---|
|
||||
| 入口挂点(随 P1 裁决:战斗屏 HUD / 关卡地图屏 / Esc 通道) | 入口控件复用 verb_button 或角标先例(debug 角标形制),宽度纪律遵守 min_w=216 或申请豁免(角标类已有豁免先例) |
|
||||
| `smoke/ui_struct_probe.gd` / `ui_click_probe.gd` / `ui_input_probe.gd` | 暂停层结构断言(不出屏/零尺寸/按钮宽度)+ 打开关闭行为断言 + 只读性断言(层内无购买信号连接) |
|
||||
| `smoke_all.gd` | 数据一致性断言(暂停层投影 = MetaProgression 访问器读数) |
|
||||
|
||||
## 4. 范围边界(🔴 不可越界)
|
||||
|
||||
| 禁项 | 理由 |
|
||||
|---|---|
|
||||
| 🔴 **零素材零新色值** | 用户 2026-10-05 立规:美术/素材由用户独立成批自理;本批只拼公共件。发现「这里缺一个图标/色值」的冲动一律转 06 登记,不自产 |
|
||||
| **只读,零写操作** | 暂停层不接任何购买/切换/设置写通路;设置修改仍走设置面 |
|
||||
| **核心层零改动** | 只消费 `MetaProgression` 既有只读访问器;不改 meta_progression.gd、不改存档、不改数值 |
|
||||
| **不冻结游戏逻辑** | 自动战斗逻辑确定性、无实时压力;暂停层 = 纯查看层,不做「时间停止」机制(逻辑本无自走时钟,无需冻结——若 P2 裁出排播暂停需求,单独呈报) |
|
||||
| **不做生涯/历史回看** | 跨局汇总与历史冒险回看归迭代 16 卡④(生涯界面设计立项),本批不越界承接 |
|
||||
| **不触碰迭代 15② 在飞文件** | 奇物批渠道分离实施段在迭代 15 继续,本批与其零文件交集(若 T0 复核发现交集,停机呈报) |
|
||||
|
||||
## 5. 设计契约(🔴 触碰 = L3 停机)
|
||||
|
||||
| # | 契约 | 验证方式 |
|
||||
|---|---|---|
|
||||
| 🔴 R1 | **公共件单点**:一切面板/按钮/徽章/卡片经 UiKit 工厂产出;禁裸色值字面量、禁自建 PanelContainer 样式 | ui_struct_probe + 静态审查 |
|
||||
| 🔴 R2 | **模态登记纪律**:新层必须登记 modal_stack 登记册,z 序=树序=登记序(缺陷⑤纪律);禁绕模态栈直开(迭代 6 卡⑨事故先例) | ui_click_probe 断言 |
|
||||
| 🔴 R3 | **输入锁语义**:暂停层开启时棋盘/节点输入锁定(has_open 开态查询),关闭后恢复原屏交互,无状态残留 | ui_input_probe 断言 |
|
||||
| 🔴 R4 | **数据只读同源**:展示值一律实时读访问器,禁止开层时拷贝快照后长期持有(余额在层开启期间不变化的前提是层内无操作——快照可接受但须随 P3 一并披露口径) | 冒烟断言 |
|
||||
| 🔴 R5 | **减动效遵守**:层进出若有动效,减动效开 = 动效归零(settings_store 现行开关消费) | 探针双态断言 |
|
||||
|
||||
## 6. 任务卡(逐卡一个 loop 轮次)
|
||||
|
||||
| 卡 | 内容 | 估时 | 轻闸 | 完成判据 |
|
||||
|---|---|---|---|---|
|
||||
| **T0** | 开工:worktree + 基线重测回填 + §2 事实表复核(重点 F1/F3/F5/F6)+ 与迭代 15② 在飞面交集核对 | 0.25d | 冒烟基线 | 基线回填;交集核对零命中或停机呈报 |
|
||||
| **T1** | 组 A:pause_overlay.gd 本体(按 P1-P4 裁决落形态)+ main.gd 登记接线 | 1.0d | 冒烟 + ui_struct_probe | 层可开关;结构断言绿 |
|
||||
| **T2** | 组 B:入口挂点 + 三探针断言(结构/点击/输入)+ 冒烟数据一致性断言 | 0.75d | 冒烟 + 三探针 | §1.2 判定 1/2/4 |
|
||||
| **T3** | 重闸:全量轻闸(含 ui_struct/ui_click/ui_layout)+ doc 三闸 + 熵增闸 | 0.25d | 重闸全绿 | §1.2 判定 5 前半 |
|
||||
| **T4** | 人闸:实机目检清单(双屏入口/只读性/数据正确/减动效双态/与设置面关系)+ 代拍板追认 | 0.5d | 目检过 | §1.2 判定 5 |
|
||||
| **T5** | 收口五步 + 06 状态行收口 | 0.25d | — | 收口五步齐 |
|
||||
|
||||
> 估时合计 ≈ **3.0d**,贴软时间盒上限——知情预挂:T2 末为天然切分点,超限按 L3 呈报不擅切。
|
||||
|
||||
## 7. 验证闸
|
||||
|
||||
- **轻闸**(每轮):run_smoke 全量 + ui_input_probe + ui_struct_probe(本批触 presentation,三轮加 ui_click_probe + ui_layout_probe)。
|
||||
- **重闸**(T3):全量轻闸 + doc 三闸零新增 + 熵增闸。
|
||||
- **MC**:纯呈现批,零数值改动 → **零 MC**(两入口铁规 + 无数值改动禁跑 MC)。
|
||||
|
||||
## 8. 代拍板白名单与待用户裁点
|
||||
|
||||
**白名单内**(实现层无争议项):
|
||||
- 层内行序与分组的具体排布(哪个柜台在上、余额行位置)——复用营地屏同序即可
|
||||
- 断言编号与探针 case 命名
|
||||
- 关闭钮文案(「返回」/「继续」级措辞)
|
||||
|
||||
**待用户裁点**(呈全备选案,含淘汰依据):
|
||||
|
||||
### P1 · 暂停入口位置与唤起形态
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲 | 战斗屏与关卡地图屏各加一个角标按钮(复用 debug 角标形制,玩家常态可见、无门控) | 发现性最好,触屏/鼠标直点;代价是两个屏各加一个常驻控件 |
|
||||
| 乙 | Esc 键唤起(PC 惯例) | 零常驻控件;淘汰候选:发现性差(无提示玩家不知道),且全仓现行无键盘输入处理(06 键盘/手柄条目排期 Beta),为暂停层单独开键盘通道属越级 |
|
||||
| 丙 | 并入既有设置入口——设置面内加「钥石与解锁进度」页 | 入口零新增;淘汰候选:设置是「改」的面、暂停层是「看」的面,语义混居;且查看进度要先进设置,路径变深 |
|
||||
| 丁(推荐) | 甲 + 乙 组合:常驻角标为主入口,Esc 作为附加快捷通道登记 06 排期 Beta 随键盘批统一接 | 当前只落甲,Esc 不单独开通道而是并进键盘批——发现性与批面干净兼得 |
|
||||
|
||||
### P2 · 与既有弹窗层的关系(modal 登记序位置与遮罩)
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲(推荐) | 登记在设置层同档(登记册尾段、确认弹窗之前),带 dim 遮罩(modal_shell 现行 dim 参数),开启时不可再开其他层 | 与设置/确认同语义档,z 序行为可预期;modal_shell 现成 |
|
||||
| 乙 | 半透明无遮罩,允许层下屏可见可操作 | 淘汰候选:违反模态输入锁纪律(R3),「暂停」语义不成立 |
|
||||
| 丙 | 全屏独立屏(LevelMapScreen 式) | 淘汰候选:暂停层是轻量查看面,独立屏形态过重;且独立屏有进出互斥编排成本,与「看一眼就关」的场景不配 |
|
||||
|
||||
### P3 · 展示内容范围
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲(推荐) | 钥石余额 + 三柜台进度(属性锻造三行已购等级 / 道具工坊六件解锁态 / 天赋树已购概览) | 与 06 条「钥石余额与解锁态(营地三柜台进度)」字面一致 |
|
||||
| 乙 | 甲 + 同调装配态(attune 装备中件与充能余量) | 信息更全;淘汰候选:同调是局内机制投影,与「跨局解锁进度」主题不同类,且局内 C 区已有秘宝槽呈现,重复 |
|
||||
| 丙 | 仅钥石余额一行 | 淘汰候选:信息太薄,为看一个数字开一层不值——06 条明确含解锁态 |
|
||||
|
||||
### P4 · 减动效联动口径
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲(推荐) | 暂停层进出默认零动效(直开直关),减动效开关无新增消费 | 最简且天然合规;只读查看层本无演出需求 |
|
||||
| 乙 | 进出加淡入淡出(200ms 档,复用关卡屏先例),减动效开 = 归零 | 观感更柔;代价是多一个动效轴要维护双态断言,且淡入淡出属观感微调,擦「美术红线」边 |
|
||||
|
||||
## 9. loop engineering 八件对照(合规自证)
|
||||
|
||||
| # | 八件要求 | 本文对应 |
|
||||
|---|---|---|
|
||||
| 1 | 计划书八节 | §1 目标与完成定义 · §2 现状事实 · §5 设计契约 · §4 范围边界 · §6 任务卡 · §7 验证闸 · §10 异常分级 · §8 白名单与裁点 |
|
||||
| 2 | T0 开工 | §6 T0 |
|
||||
| 3 | 循环骨架 | §6 各卡 |
|
||||
| 4 | 轻闸 | §7 轻闸段(触 presentation 加跑三件已写明) |
|
||||
| 5 | 重闸 | §7 重闸段 + §6 T3 |
|
||||
| 6 | 人闸 | §6 T4 |
|
||||
| 7 | 异常分级 | §10 |
|
||||
| 8 | 收口五步 | §6 T5 |
|
||||
|
||||
## 10. 异常分级
|
||||
|
||||
| 级 | 触发 | 处置 |
|
||||
|---|---|---|
|
||||
| **L1** | 单轮探针/冒烟红 | 一次重试自查(登记序/modal 树序——Godot 4.7 modal 屏 queue_sort 坑在册:探针采样须强制 queue_sort,ui-struct-probe 批已留手法) |
|
||||
| **L2** | 同类红连续 3 轮 / 与既有层 z 序冲突 | 记录进任务书与工作日志,调整登记序后继续 |
|
||||
| **L3** | 任一 🔴 R1–R5 破 / 发现需要新素材或新色值才能达成裁决形态 / 与迭代 15② 在飞面出现文件交集 | 停机写报告等用户发令 |
|
||||
|
||||
## 11. 现状留痕(供执行会话读序)
|
||||
|
||||
```
|
||||
1. design/gdd/06-待办清单.md「解锁界面与钥石呈现的交互形态(残余:暂停层只读入口)」条
|
||||
2. game/presentation/modal_stack.gd + main.gd:242/:332(登记册与 z 序纪律)
|
||||
3. game/presentation/views/ui_kit.gd(公共件与色板单点:modal_shell/bcard/verb_button/徽章形制)
|
||||
4. game/core/meta_progression.gd(只读访问器面,F5)
|
||||
5. game/presentation/views/settings_overlay.gd(最小设置面先例)· debug_overlay.gd(角标+Dialog 先例)
|
||||
6. design/qa/ui-struct-probe-exit-report-2026-10-05.md(按钮宽度纪律 216 与结构探针口径)
|
||||
```
|
||||
@@ -0,0 +1,208 @@
|
||||
# 任务书:生涯界面设计立项(v1.0 设计提纲版,只做设计不做实装)
|
||||
|
||||
> 成文 2026-10-05。**性质**:纯设计批——产出「生涯」界面的设计提纲(信息架构 + 承载内容清单 + 与既有界面的关系 + 分期实装建议 + 待裁点),**本批零实装、零代码、零数据面改动**。
|
||||
> 事实源 = [06-待办清单](../gdd/06-待办清单.md)「『生涯』界面——冒险中数据回看的唯一承接处」条(2026-10-04 用户裁决 P-C7:冒险中不给数据回看,历史战报/结算明细的查看去向 = 新「生涯」界面;生涯未做前冒险中无历史回看入口 = 已知代价,用户知情裁决)。
|
||||
> 归属迭代:**迭代 16 · 卡④**(迭代 16 四卡:①敌人表行集多行批 ②M4 数值批 ③暂停层只读入口批 ④本批)。
|
||||
> **实装批另行立项**:本任务书只交付设计提纲文档与裁点呈报;任何实装(数据面/界面/存档域)须用户审毕提纲后另行发令立项。
|
||||
> 满足 loop engineering 八件(按设计批形态适配,见 §9 逐条对照)。
|
||||
|
||||
---
|
||||
|
||||
## 1. 目标与完成定义
|
||||
|
||||
### 1.1 一句话目标
|
||||
|
||||
为「生涯」界面立一份可供裁决的设计提纲:说清这个界面是谁、装什么、和既有界面怎么分工、分几期做、每期做什么,以及开工前需要用户拍板哪些点。
|
||||
|
||||
### 1.2 完成定义(出口判定清单)
|
||||
|
||||
| # | 判定项 | 量化标准 |
|
||||
|---|---|---|
|
||||
| 1 | 提纲成文 | 设计提纲落正主候选位置(建议 `design/gdd/systems/跨局循环/生涯.md` 或按 P0 裁决的载体),含信息架构 / 承载内容清单 / 与既有界面关系 / 分期实装建议 / 待裁点五节 |
|
||||
| 2 | 事实对齐 | 提纲中的现状描述经代码级复核(§2 事实表),无凭印象书写 |
|
||||
| 3 | 裁点齐备 | §8 待裁点逐条列全备选案(含淘汰依据),无「待定」二字悬空 |
|
||||
| 4 | 零实装 | 本批 diff 仅含设计文档与 06 状态行;`game/` 零改动、存档零改动、零测试执行(两入口铁规:非 loop 实施批且用户未点名测试) |
|
||||
| 5 | 人闸 | 设计提纲交付用户评审;06 状态行更新为「设计提纲已成文待评审」 |
|
||||
|
||||
## 2. 现状事实(代码级考证,2026-10-05 起草时点;T0 须自行复核)
|
||||
|
||||
| # | 事实 | 读数 |
|
||||
|---|---|---|
|
||||
| F1 | 冒险中回看已退役 | M9(P-C7 裁)落码:`battle_end_overlay.gd:90` 明细回看钮退役、`review_pressed` 信号退役;`battle_log_view.gd:47` 战报带改单行「上轮摘要(回看归「生涯」)」、:115 带点击回看入口退役;`ui_assembler.gd:67` 注记「明细回看 overlay 已随 M9/P-C7 退役——冒险中回看归「生涯」06 登记」 |
|
||||
| F2 | 遗留文件 | `presentation/views/settlement_review_overlay.gd` 文件本体仍在,冒险中已无入口(处置见 P5 裁点:实装期复活承接还是退役删除) |
|
||||
| F3 | 跨局持久面 = save v5 meta 域 | `keystone_balance` / `forge_levels` / `item_unlocks` / `level_clear_counts` / `boss_first_kill` / `boss_kill_count` / `tree_nodes` / `fork_sides` / `attunement_equipped` / `attune_refresh_level` / `first_adventure_done`(save_manager.gd:39 schema 注记 + meta_progression.gd 访问器面) |
|
||||
| F4 | 🔴 **无历史冒险记录面** | `settle_adventure()`(meta_progression.gd:129)只做入账(钥石余额累加、工坊解锁刷新、通关计数),**每局摘要不留痕**——历史冒险回看需要新建数据面(每局摘要的持久化域),这是本设计提纲最大的数据设计题 |
|
||||
| F5 | 当局结算呈现仍在 | 冒险收束时结算屏入账明细(钥石 +N、新解锁)现行保留——退役的只是「局后任意时刻回看」,不是收束当下 |
|
||||
| F6 | 跨局汇总数据源现成 | 总通关次数(level_clear_counts 按关)、Boss 首杀/总击杀、钥石余额与累计流(余额在,累计收支无流水)、锻造/工坊/天赋树解锁态——「跨局汇总」页大部分字段可直接读访问器,零新数据面 |
|
||||
| F7 | 图鉴承接的候选内容 | 06 在册相关条目:「敌方技能图鉴 / 学习呈现」(P2,见过→认得→记谱);奖励格图鉴柜台空置(2026-10-04 配比预设批裁决该柜台承接配比容量,后随配比预设整体挂起——柜台仍空);秘宝/奇物均无图鉴面 |
|
||||
| F8 | 相邻界面分工现状 | 营地 = 跨局成长**操作**面(花钥石买强化);主菜单 = 入口面(新冒险/继续上局/营地/设置/调试);设置面 = 环境开关;教学「帮助」手册(Beta 批初裁:全部内容放一个文档,未实装);暂停层(迭代 16 卡③)= 局内只读查看钥石与解锁进度 |
|
||||
| F9 | 06 条目原文口径 | 「跨局汇总 / 历史冒险回看 / 图鉴承接」三段内容清单是 06 条目给定骨架,本提纲在其上展开,不另起炉灶 |
|
||||
| F10 | 阶段语境 | 教学引导五条目已整体改排 Beta(2026-10-04 拍板);生涯未标阶段——分期建议须回答「生涯第几期落在 Alpha 后哪个窗口」 |
|
||||
|
||||
## 3. 设计提纲(本批交付物本体)
|
||||
|
||||
### 3.1 信息架构(草案,待 P1 裁决)
|
||||
|
||||
「生涯」是**局外只读界面**,与营地平级挂在主菜单(或按 P1 裁为营地内页签)。一句话定位:**营地管「花」,生涯管「看」**——所有跨局数据的回看集中在这里,冒险中一律不给回看(P-C7 裁决的延续)。
|
||||
|
||||
```
|
||||
主菜单
|
||||
├─ 新冒险 / 继续上局
|
||||
├─ 营地(操作面:花钥石、装配、天赋树)
|
||||
├─ 生涯(只读面,本提纲)
|
||||
│ ├─ 跨局汇总(累计战绩与解锁总览)
|
||||
│ ├─ 历史冒险回看(逐局摘要与结算明细)
|
||||
│ └─ 图鉴(敌人 / 秘宝 / 奇物——范围随 P3)
|
||||
├─ 设置
|
||||
└─ 退出
|
||||
```
|
||||
|
||||
### 3.2 承载内容清单(草案,逐段标数据可行性)
|
||||
|
||||
| 段 | 内容 | 数据源 | 可行性 |
|
||||
|---|---|---|---|
|
||||
| 跨局汇总 | 冒险总局数 / 通关局数 / 各关通关次数 / Boss 首杀与总击杀 / 钥石余额(累计收支流水可选)/ 三柜台解锁完成度概览 | F6 全现成(除累计流水) | **期一即可做,零新数据面**(累计流水若做需补记账点,随 P2) |
|
||||
| 历史冒险回看 | 逐局摘要:第 N 局、结局(通关/失败/放弃)、走到哪、钥石收入、关键构筑(可选);单局结算明细回看(复活 settlement_review 承载) | F4 **需新建数据面**(每局摘要持久化) | **期二**,数据面范围是最大裁点(P2) |
|
||||
| 图鉴承接 | 敌人图鉴(06 在册 P2 条目承接:见过→认得→记谱)/ 秘宝图鉴 / 奇物图鉴 / 奖励格图鉴(空置柜台) | 逐类立「见过」记账面 | **期三**,范围与顺序随 P3 |
|
||||
|
||||
### 3.3 与既有界面的关系(分工一句话矩阵)
|
||||
|
||||
| 界面 | 管什么 | 与生涯的边界 |
|
||||
|---|---|---|
|
||||
| 营地 | 跨局成长的**操作**(买/装配/点树) | 营地不改生涯只读定位;生涯不做任何购买入口,「去买」按钮也不放(跳转型入口随 P4) |
|
||||
| 暂停层(迭代 16 卡③) | **局内**只读看钥石与解锁进度 | 暂停层看「这一局进行中的当前值」,生涯看「跨局累计与历史」;局内是否给生涯入口随 P4 |
|
||||
| 结算屏 | 当局收束当下的入账明细 | 收束当下保留;生涯承接的是收束之后的任意时刻回看 |
|
||||
| 帮助手册(Beta 批) | 规则与玩法的说明文档 | 手册讲「怎么玩」,生涯讲「我玩过什么」;图鉴条目文案与手册条目是否共用内容源,归 Beta 批一并裁(本提纲只登记接口) |
|
||||
| 图例面板(legend_overlay) | 局内符号/徽标解码 | 局内即时解码不动;图鉴是跨局收集面,两者不合并 |
|
||||
|
||||
### 3.4 分期实装建议(供裁决,实装批另行立项)
|
||||
|
||||
| 期 | 内容 | 前置 | 建议窗口 |
|
||||
|---|---|---|---|
|
||||
| 期一 | 跨局汇总页(零新数据面,纯只读投影)+ 生涯入口落位 | 本提纲裁决完毕 | Alpha 后最近一个 UI 窗口(可与暂停层批同迭代序列后续) |
|
||||
| 期二 | 历史冒险回看(新建每局摘要数据面 + 逐局列表 + 单局明细,settlement_review 复活承接随 P5) | 期一 + P2 数据面裁决 | 期一落地后独立批 |
|
||||
| 期三 | 图鉴承接(范围与顺序随 P3) | P3 裁决 + 对应「见过」记账面 | Beta 窗口候选(与教学引导同阶段评估——「认得」轴与教学相关) |
|
||||
|
||||
### 3.5 本批不做
|
||||
|
||||
实装、数据面 schema 设计细节(字段级)、界面布局稿(观感稿归用户美术批纪律)、任何代码。期一/二/三均为**另行立项**的实装批,本任务书不预占。
|
||||
|
||||
## 4. 范围边界(🔴 不可越界)
|
||||
|
||||
| 禁项 | 理由 |
|
||||
|---|---|
|
||||
| 🔴 **零实装零代码** | 本批 diff 仅限设计文档与 06 状态行;`game/` 任何文件不得出现在 diff 中 |
|
||||
| 🔴 **零测试执行** | 两入口铁规:纯文档批且用户未点名——不跑冒烟/探针/MC,结论全部来自静态阅读 |
|
||||
| **不推翻 P-C7** | 「冒险中不给数据回看」是用户裁决,本提纲不提议在冒险中恢复回看入口(暂停层卡③的只读查看是另一裁决面,不冲突) |
|
||||
| **不新增美术/素材内容** | 2026-10-05 用户立规:美术由用户独立成批自理;本提纲不含布局稿/视觉稿/素材需求清单(如需素材,登记为实装批的前置待办即可) |
|
||||
| **不预占实装排期** | 分期建议是建议不是排期;roadmap 迭代位由用户逐期点名 |
|
||||
|
||||
## 5. 设计契约(🔴 触碰 = L3 停机)
|
||||
|
||||
| # | 契约 | 验证方式 |
|
||||
|---|---|---|
|
||||
| 🔴 R1 | **事实先于设计**:提纲中每一句现状描述须能指回 §2 事实表或代码位置;凭印象书写即返工 | 评审逐节抽查 |
|
||||
| 🔴 R2 | **引用不转述**:提及既有系统的规则时只引用规范名 + 链接,不复述对方数值与口径(doc-conventions §8) | doc 三闸(文档批可按用户点名补跑) |
|
||||
| 🔴 R3 | **无正主不下定义**:生涯尚无正主文档——本提纲即正主候选;在正主落位前,其他文档不得替「生涯」补定义 | 提纲 P0 载体裁决落实 |
|
||||
| 🔴 R4 | **黑话禁令**:提纲全文白话,机制概念不造词;「生涯」一词是用户已用的玩家可见名,可直接用 | 写后自查 |
|
||||
|
||||
## 6. 任务卡
|
||||
|
||||
| 卡 | 内容 | 估时 | 验证 | 完成判据 |
|
||||
|---|---|---|---|---|
|
||||
| **T0** | 开工:worktree + §2 事实表复核(重点 F1/F2/F4/F7——逐条指到代码行)+ 差异呈报 | 0.25d | 静态复核(零测试) | 事实表全绿或差异呈报修订 |
|
||||
| **T1** | 提纲成文:§3 五节按裁决框架写全(信息架构 / 内容清单 / 界面关系 / 分期建议 / 待裁点),落载体随 P0 | 0.75d | 读者测试(只读各节第一段能看懂全篇) | §1.2 判定 1/2/3 |
|
||||
| **T2** | 人闸交付 + 06 状态行更新 + 收口 | 0.25d | 用户评审 | §1.2 判定 4/5 |
|
||||
|
||||
> 估时合计 ≈ **1.25d**,在软时间盒内。
|
||||
|
||||
## 7. 验证闸
|
||||
|
||||
- 本批为纯文档批:**零测试**(两入口铁规)。
|
||||
- doc 三闸(doc_link / doc_term / 熵增)**默认不跑**;用户点名则按点名执行并对基线零新增。
|
||||
|
||||
## 8. 代拍板白名单与待用户裁点
|
||||
|
||||
**白名单内**:
|
||||
- 提纲文档的小节组织与行文措辞
|
||||
- 06 状态行更新措辞
|
||||
|
||||
**待用户裁点**(呈全备选案,含淘汰依据):
|
||||
|
||||
### P0 · 提纲与正主载体
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲(推荐) | 提纲成文即落 `design/gdd/systems/跨局循环/生涯.md`(状态=范围草案),同步 02-系统清单索引 | 「吸收即死」纪律:中间文档不留;正主早立早受益(R3) |
|
||||
| 乙 | 提纲暂存 design/research/ 待评审后再转正 | 评审前不动 GDD 树;淘汰候选:与「吸收即死」纪律冲突,且评审意见最终还是要落正主,多一次搬运 |
|
||||
|
||||
### P1 · 生涯入口位置
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲(推荐) | 主菜单一级入口,与营地平级 | 「生涯 = 跨局数据的家」与营地同级最直白;主菜单按钮组有现行形制可复用(实装期) |
|
||||
| 乙 | 营地内页签/分区 | 入口少一个;淘汰候选:营地是操作面,把只读回看塞进操作面会让营地更挤,且「看」与「买」混居违反分工矩阵 |
|
||||
| 丙 | 结算屏内加入口 | 淘汰候选:只有收束时可达,违背「任意时刻回看」的承接定位 |
|
||||
|
||||
### P2 · 历史冒险回看的数据面范围(期二核心裁点,本批只呈框架)
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲 | 每局一行摘要(结局/到达关卡/钥石收入/用时),上限存最近 N 局(N 候选 20/50) | 存储最小、实现最简;回看粒度到「局」不到「战」 |
|
||||
| 乙 | 甲 + 每局完整结算明细留痕(逐行结算单据全存) | 回看最完整;淘汰候选:单局结算单据量大,存档体积与 schema 复杂度显著上升,且 99% 的回看诉求摘要即可满足 |
|
||||
| 丙 | 不存历史,历史回看段整段取消(生涯只做汇总+图鉴) | 淘汰候选:06 条目明列「历史冒险回看」,且 P-C7 裁决的代价(冒险中无回看)正是由它补偿 |
|
||||
|
||||
### P3 · 图鉴承接的内容范围与顺序(期三核心裁点)
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲 | 敌人图鉴优先(06 在册 P2 条目「敌方技能图鉴/学习呈现」直接承接),秘宝/奇物随后 | 在册条目有先约,敌人是玩家信息需求最硬的一类 |
|
||||
| 乙 | 秘宝/奇物图鉴优先 | 收集类游戏惯例;淘汰候选:无在册条目支撑,且秘宝/奇物件数少(秘宝九件目录),图鉴价值密度低 |
|
||||
| 丙 | 奖励格图鉴(空置柜台)并入期三 | 该柜台已随配比预设挂起冻结(2026-10-05 用户令),本提纲只登记不激活——重启须用户另行发令 |
|
||||
|
||||
### P4 · 局内是否给生涯入口 / 生涯内是否放「去营地」跳转
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲(推荐) | 均不放:局内只看暂停层(卡③),生涯只在主菜单;生涯内纯只读零跳转 | 分工矩阵最干净;暂停层与生涯零重叠 |
|
||||
| 乙 | 生涯内放「去营地」跳转 | 看完进度顺手去买动线短;代价是只读面开始出现操作引导,边界稀释 |
|
||||
| 丙 | 局内暂停层放「生涯」入口 | 淘汰候选:违反 P-C7(冒险中不给数据回看)——历史回看经局内可达等于绕回退役前 |
|
||||
|
||||
### P5 · settlement_review_overlay.gd 遗留文件处置(实装期执行,本批只裁方向)
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲(推荐) | 期二实装批复活承接(作为单局明细回看的呈现载体,改挂生涯) | 现成件,结算明细的排版逻辑都在;复活成本远低于新画 |
|
||||
| 乙 | 本批随提纲删文件 | 死代码早清;淘汰候选:期二大概率要用,删了再写是浪费;且本批零代码边界禁动 game/ |
|
||||
| 丙 | 永久退役删除,期二新写 | 淘汰候选:同乙的浪费理由;除非期二裁决换新呈现形态 |
|
||||
|
||||
## 9. loop engineering 八件对照(设计批适配自证)
|
||||
|
||||
| # | 八件要求 | 本文对应 |
|
||||
|---|---|---|
|
||||
| 1 | 计划书八节 | §1 目标与完成定义 · §2 现状事实 · §5 设计契约 · §4 范围边界 · §6 任务卡 · §7 验证闸 · §10 异常分级 · §8 白名单与裁点 |
|
||||
| 2 | T0 开工 | §6 T0(worktree + 事实复核;设计批无基线跑测) |
|
||||
| 3 | 循环骨架 | §6 各卡(设计批三卡串行) |
|
||||
| 4 | 轻闸 | §7(纯文档批零测试,符合两入口铁规) |
|
||||
| 5 | 重闸 | §7(doc 三闸默认不跑,用户点名则对基线零新增) |
|
||||
| 6 | 人闸 | §6 T2(设计提纲评审 = 本批唯一人闸) |
|
||||
| 7 | 异常分级 | §10 |
|
||||
| 8 | 收口五步 | §6 T2(active.md 快照 + 工作日志 + 06 状态行 + roadmap 迭代 16 行随批登记) |
|
||||
|
||||
## 10. 异常分级
|
||||
|
||||
| 级 | 触发 | 处置 |
|
||||
|---|---|---|
|
||||
| **L1** | 提纲某节读者测试不过 | 当节重写(可读性第一纪律),不重试机制 |
|
||||
| **L2** | 事实复核发现 §2 与代码不符 | 修订事实表并记录;若差异动摇提纲结构 → L3 |
|
||||
| **L3** | 🔴 R1–R4 任一破 / 发现 06 条目与代码实态冲突(如回看退役实际未落码)/ 裁点框架本身不成立 | 停机呈报差异,等用户发令 |
|
||||
|
||||
## 11. 现状留痕(供执行会话读序)
|
||||
|
||||
```
|
||||
1. design/gdd/06-待办清单.md「『生涯』界面——冒险中数据回看的唯一承接处」条(P-C7 裁决原文指路)
|
||||
2. design/research/UI重设计原型v2落码-差异对照与改动计划-2026-10-04.md §七(P-C7 裁决记录出处)
|
||||
3. game/presentation/views/battle_end_overlay.gd / battle_log_view.gd / settlement_review_overlay.gd(退役与遗留实态)
|
||||
4. game/core/meta_progression.gd settle_adventure + save_manager.gd:39(跨局数据面与「无历史记录面」考证点)
|
||||
5. design/gdd/06-待办清单.md「敌方技能图鉴 / 学习呈现」条(图鉴承接的在册先约)
|
||||
```
|
||||
+6
-2
@@ -61,8 +61,12 @@
|
||||
| 迭代 13 | **工程债与测试基建批(含 D6 爆破工兵包实施)**:六条目=ui_click_probe 完整局适配(D1——分派链序修正+停点/锁期/重放三态断言)/探针只读出口(D2——六出口 26 直入清零)/ArmedTimer helper(D3——P4 乙三处计时收口缝零动)/main.gd 二期瘦身(D4——bonus_interact_controller+camp_shop_presenter 拆件 1370→1119,家族②契约3绑定面留置;~900±50 锚差=族级清单上限不自洽已归因)/aux 二期合并(T5 判不合收口)/杂项尾差四件(D5)/爆破工兵包中立移除雷格(D6——P1 甲邻接冻结/P2 甲退色降档,判定逻辑零改动,充能表驱动零新码)。**✅ 已落籍(2026-10-04,台账 342)**:worktree m4iter13-debt-20261004 八提交 cd7d3ea…2402877 合并 eff8cb8;闸=冒烟 718/0(断言数持平基线)+run_all 15+click 三种子绿+全探针绿+doc 三闸零新增+熵增 PASS+MC 零跑(静态零漂移证明);合并后主区全量复跑同绿 | 迭代 12 出口 | T0-T9 ≈4.8-5.3d(知情超限单批,实际单会话) |
|
||||
| 迭代 14 | **初始展开收窄批(2026-10-04 用户拍板甲乙混合立项)**:甲=先布后删剃雷域收窄至出生 3×3∪外扩 r 环(参数化半径,现值 r=1——开阔地均值从板面 66.5% 根因性降至约三成)+乙=生成重掷闸 R₀≤cap(合法性门序列、cap=板面 30% 锚〔10×10=30/12×12=43/13×13=51〕、重试耗尽走既有三分出口);**玩法侧零改动路线**(排雷玩法「初始展开恰等」验收原样为真,minesweeper_rules.gd 零 diff);裸数字截断路否决退役(可见 0 格+未开邻居=扫雷不可能态)。可行性报告=`design/research/研究-初始展开收窄可行性-2026-10-04.md`,任务书=`design/research/任务书-初始展开收窄批-2026-10-04.md`(T0-T8≈5.25d,读数批 T5-T6 可切独立后批;拍板点 P1-P3 全读数后置;停机点 S1 相变警戒/S2 带越界回调)。**✅ 实施批落地(2026-10-05,worktree m4iter14-narrow-20261005 台账 357;S1 停机呈报已裁=用户方案A)**:T0-T4+T7+T8 全落(T5 结构读数随批出讫;T6 MC 四带复算读数批按切分预案后置,跑批待用户批准挂 07 现行义务)——甲=剃雷域收窄(shave_ring_radius 参数化,r=1→出生 5×5,全域 flood 剃雷退役,零 RNG 消费变化)+乙=R₀≤cap 重掷闸(合法性闸序列+同流重试+耗尽三分出口诚实降级+r0_cap_rejected 指标)+参数面两列(schema 域校验加载期致命+19 行投值)+断言面 +12(R₀≤cap/ring_removed 量级/cap 压线诚实降级/确定性逐位)+夹具复核 3 处(relic 候选身份按 TP0 v2.2=kind|tier|relic_id、商店购买笔数推导防 GP 流漂移、极性探针种子自愈);**S1 停机实录**=r=1 自然 R₀ 均值 39>cap30 锚结构性倒挂(94% 拒绝/inf 0.976→0.719/常态非法板)→用户裁方案A「10×10 cap 30→45」〔P1 上调预案字面〕,12×12/13×13 健康侧维持;改后结构读数=R₀ 均值 39.7/37.9/42.8/46.6(收窄自 68.6/83.2——10×10 −42%、12×12 −54%)/尾部闸精确截断/雷密度 19.2-21.6%<25% 相变线/inf 全行达标;玩法侧零改动(minesweeper_rules.gd 零 diff、「初始展开恰等」验收原样为真);闸=冒烟 767/0(+12);registry initial_expansion_narrowing 条+棋盘生成.md v0.5+07⑬ 四信号组;06 视野条目已于 745b92ea 清账批退役(收窄立项即正主)。**②挖掘风险不等式判式换代批(2026-10-04 用户裁编入本迭代,作为迭代内需求)**:判式三层换代(条款2 标中旗锚/条款3 聚合健康式「(1−ρ̂)E_dig−ρ̂V_mine≥0」/旗边际引理+条件二旗溢价)+β 比值带判读 [1.2,2.5](u=3 登记态)+标中兑付溢价 δ=1.25(形态 a 兑付公式一处·雷安同池冻结不动)+runsum 旗行为五字段+audit 工具常量刷新(池 77/直伤 6-8-8/AP 8);裁决全落零新拍板点(方案报告 §九(已退役,git 1da9a41)),任务书=`.zcode/plans/mine-inequality-revision-miniloop-plan-2026-10-04.md`(T0-T5≈2.5d;条件二 T3 落文按登记已知破·T4 机制转绿;契约红线=DamageController 零改/直伤雷 6-8-8 与 p_perfect 不动——iter8 缺口四选一解绑独立在案;开工门=U0)。**✅ 实施批落地(2026-10-05,worktree m4iter14-mineq-20261005 台账 356)**:T0-T5 全落——audit 工具常量刷新(改前静态锚与方案报告 §四 逐位吻合)+runsum 五字段(行侧判据考证=授予行专带 highlight,87行==87插旗1:1)+F1 条款3 重立三层口径(v0.8)+战斗结算 v0.25+难度联动表+6 行+registry clause3_inequality 重立条(改前锚+P7 修正注记)+06 破线条收口+**T4 标中兑付溢价机制**(settlement.flag_hit_premium=125 provisional,grant 单点只挂 flag_hit 正向·percent 幅度贯穿应用与呈现,标空/挖格不乘,DamageController 零改/同池冻结)+smoke 750/0(+3 断言;max 路径种子 42→43 重采);判读三件=β 带 u=1/2 带内 u=3 登记态/δ 敏感度行为无感(η 位移 <1.4pp<5pp,保留+登记)/条件二判式口径等号压线转绿(整数量级实现 u=1/2 绿·u=3 微欠 −1.1% 登记面);改后锚换代 runsum_m4iter14mineq_post_n200_20261005(perfect 冒险通关 65.3%→72.0% 增强向位移,四带判读归 M-4);出口报告=design/qa/m4iter14-mineq-exit-report-2026-10-05.md(provisional 追认单 8 项+07⑫ 人工项);damage_probe A1 红灯=改前既有非本批新增(在册)。**③全局作用域变异首发批(2026-10-04 用户拍板立项——调研报告 P1-P8+盘问 Q1-Q4 全按推荐案落,批内序位待排)**:L2/L3 Boss 图恒定一型 scope=global 变异,首发型=**案A 资源面·微贫向偏斜**(正向格面池合计不变、进攻族 attack/blast/pierce/magic 权重上浮/生存族 heal/defense 明显下调、EV 微降 3-5% provisional、gp/action 白名单不动;v1.0「沃土+雷密对冲」形勘误作废——雷数Line truncated
|
||||
| 迭代 15 | **①调试功能整合批(2026-10-05 用户令自「14.5」临时卡改编入册——原周期外 0.5 卡,落地事实与验证读数零变化,只改编号归属)**:主菜单三调试散件(随机种子输入框/角色数值调整板/两层调试入口)收一张调试浮窗 DebugOverlay——入口=开始覆盖层右下角「调试」角标(与主按钮组非平级,DS_DEBUG=1 环境变量门控沿用迭代 8 卡④口径);浮窗=悬浮菜单之上 Dialog(不隐藏开始层,同确认弹窗形态;旧 TunePanel「与开始层互斥」形态与类整体吸收退役含 .uid);可扩展滚动列表页四区块(随机种子/数值调整/批量模拟/两层调试入口——后续调试项往下追加滚轮下探)。四拍板全落(2026-10-04 用户裁)=P1 甲 DS_DEBUG 门控/P2 乙全摊平/P3 仅开始菜单可开·对局不可达(_show_debug_overlay 门禁护栏+对局发起随开随收)/P4 可扩展列表。**✅ 已全批落籍(2026-10-05,worktree iter145-debug-hub 两提交 48c0b34/46dadbb,主区 merge --no-ff d0a3c6b/10c301b,台账 352)**:闸=冒烟 747/0+探针 ui_tune/ui_click/ui 三绿(worktree+主区双跑,主区跑前 --import 重刷类名缓存在册坑);遗留=实机目检归用户(DS_DEBUG=1 启动→右下角角标→浮窗四区块→两层调试入口) | 卡①门:迭代 14 出口(注:本卡先于迭代 14 出口落籍——编入时点迭代 14 ③已闭/①②④⑤在飞/⑥挂起,门列仅记编入时点状态,不构成追溯闸) | 单批已落地(原估 0.5d,实际一次会话);后续扩调试项=debug_overlay.gd _build() 列表区追加区块(P4 扩展口径) |
|
||||
| 迭代 15 | **②奇物概念收口与词族对齐批(2026-10-05 用户令编入本迭代)**:概念层已由用户逐轮裁定定稿(《奇物》v1.0→v2.7,7 轮),本批只做**落地对齐**、不做二次设计。三批内容:**①三套旧词族全面对齐**(顶层已改名「奇物」而代码仍叫旧名=用户最初抱怨的"文档与代码分开"):`feature_*`→`curio_*`(103 处/7 文件)、`relic_*`→`feat_*`(162 处/12 文件)、运行层 `bonus_*`→`curio_*`(160 处/8 文件)。**硬约束:`reward_*` 已被 `reward_pick`/`reward_node`/`reward_preview` 占用,统一词族不得使用**;`relic_table.gd` 与两个控制器类改名须同步 Godot `.uid`/`.tscn`(非文本层无法自证)。**②三条渠道按分类分离**(现行三渠道共用同一个 98 张池、三类混编):关底 Boss 击败=通过这一关→只出专长;奖励节点/商店→属性值提升+资源、专长在此**只以门票形式**出现。**兑付频率红线**:奇物不是打一场战斗给一份,关内普通战斗节点打完不给任何奇物,一关之内只兑付一次(用户 2026-10-05 纠错)。**③两个新种类入池**=刷新次数(须先与"商店独立刷新机制"划清边界)+ 专长获取门票(拿到即开不可囤积/罕见只在概率/一局限购一次/计步保底:连续 5 次三选一展示未出→第 6 次必出,刷新重展计入、奖励节点与商店共享计数);附带 `shop.tres` 补回复(默认原则要求分类内成员都在该出现的渠道池里)与 charge 标签补至 ≥4 件(现仅 3 件,档二永远达不到——数据缺陷)。设计事实源=`design/gdd/systems/冒险循环/奇物.md` v2.7,任务书=`design/research/任务书-奇物词族对齐与渠道分离批-2026-10-05.md`(T0-T8≈4.5d,两段切分预案在册〔段一词族 T0-T3≈2d/段二渠道+入表 T4-T8≈2.5d〕,切分点=T3 出口;11 条设计契约含 6 条 🔴 停机级;12 条批末验收断言;代拍板白名单 5 项;待用户裁点 4 项〔玩家可见面违规/第四关档二复裁/门票四参数终值/存档键正式迁移〕)。**开工门**:与在途 M-4 各批(判式换代/全局变异/配比预设)撞同一批文件(`adventure_table.gd`/`level_runner.gd`/`adventure.tres`),须确认不并行或用户明示插队 | 卡②门:迭代 14 出口 | 卡①已落籍(原估 0.5d);卡②T0-T8≈4.5d(可两段切分:词族对齐段 + 渠道入表段) |
|
||||
| 迭代 15 | **③秘宝代码词族对齐批(2026-10-05 用户令编入本迭代)**:设计侧已完成(消歧更名批 `430419c`+`06e94b7`,26 个设计文档「魔法道具」→「**秘宝**」,同调位机制名保留不变),本批只做**代码侧对齐**、不做二次设计。内容:`aux_*`/`AuxItem*` 词族全族换词 **358 处 / 36 文件**(重灾 `adventure_runner.gd`79 / `level_runner.gd`27 / `bonus_interact_controller.gd`19 / `battle_orchestrator.gd`18 / `config_db.gd`14 / `main.gd`13),分五组落:**A 玩家可见文案(P0,5 处)**=`battle_narrator.gd:117-118` + `bonus_interact_controller.gd:76` + `hero_info_panel_view.gd:56`(槽位标题 `UiKit.label`)+ `:178`(tooltip)· B schema 与数据表(`aux_item_table.gd`/`aux_items.tres`/`aux_items.gd` 文件名+类名+`ConfigDB` 持有变量与访问器全链跟改,**须同步 Godot `.uid`/`.tscn` + `--import` 重刷类名缓存**——迭代 14.5 实证在册坑)· C 文档链接修复(含 `architecture.md` 两处既有断债顺带清偿)· D 中文注释层(**须分色**:`魔法矢`/`魔法反噬`/`魔法族`/`魔法护甲` 属敌方伤害护甲语汇🔴不动)· E 测试文件名+内部变量。**用户三项拍板**:全族彻底改(含数据表)· **断点存档键一律保留**(`bonus_aux_carry`/`aux_detail`/`aux_cleared`/`aux_cleared_last`/`aux_items` 断点数组/`attunement_charges` 共 34 处引用一字不改,破档即进度丢失)· registry 条目键 `aux_items` 不改(数据契约键)。设计事实源=`design/gdd/systems/排雷循环/秘宝.md` v0.9,任务书=`design/research/任务书-秘宝代码词族对齐批-2026-10-05.md`(T0-T9≈5.0d,**超软盒 3 日上限·知情预挂**:T7 段末闸后 L3 呈报切点不擅切;**三档降级面 G1/G2/G3 在册**〔G3 下限=仅组 A 完成〕;5 条设计契约含 5 条 🔴 停机级〔存档兼容零破坏/数值零漂移/schema 契约面零变更/零字段更名/核心层零 await〕;代拍板白名单 5 项;**C1/C2 已裁关闭·全改保一致·待裁点 0 项**)。**撞批已消解**:② 奇物批 2026-10-05 收口落库(合并 `c571af2`),并行风险解除,本批为迭代 15 唯一在途需求;**T0 须重取基线**(判式换代批 T5 读数 750/0、② 又动数据层,§1.2 的 747 为②前旧数禁沿用)并复核事实表。**✅ 裁决(用户 2026-10-05「全改保一致」)**:C1 `"aux_item"` 域串**照改**(实测连锁面收窄——`reward.tres` 已零 aux_item 数据行,池种随迭代 11 T7 退役;16 处字面量全在代码内闭合无存档依赖;唯一连锁项=`smoke_all.gd:3932` 断言须同步)· C2 `aux_items` 一名两义**拆分**(ConfigDB 持有变量+表注册键✅改 / 断点存档键+冒烟夹具🔴禁改——**「键名禁改」与「变量名禁改」是两回事**,禁改的只是落盘字面量)。新增**组 F**(分派语汇与域串 16 处),任务卡扩为 T0-T10≈5.5d。**开工门**:✅ 已无待裁点,可直接发 T0 | 卡③门:迭代 14 出口(**裁点已全决·可开工**) | 卡①已落籍(原估 0.5d);卡②已落籍(`c571af2`);**卡③ ✅ 已全批落籍(2026-10-05,worktree m4iter15-mibao 九提交 b4b8bb3..收口笔,主区 merge --no-ff 哈希见台账/active.md 快照行;出口报告=[iter15-3-mibao-exit-report](design/qa/iter15-3-mibao-exit-report-2026-10-05.md))**:词族实数 364 处/36 文件全换尽(例外 43+2 处=存档键引号字面量+夹具,穷举在报告 §五);闸=冒烟 755/0+run_all 14/15(唯一红=②批遗留基线红 reward_overlay,对照零新增)+行为探针四件全绿+doc 三闸/熵增闸零新增+存档键六键普查零差异+MC 按 goal 令豁免(静态零漂移证明代);渲染像素五闸屏蔽挂账 07⑮;遗留=实机目检归用户(07⑮)+reward_overlay 基线红归②批处置 |
|
||||
| 迭代 15 | **②奇物概念收口与词族对齐批(2026-10-05 用户令编入本迭代)**:概念层已由用户逐轮裁定定稿(《奇物》v1.0→v2.7,7 轮),本批只做**落地对齐**、不做二次设计。三批内容:**①三套旧词族全面对齐**(顶层已改名「奇物」而代码仍叫旧名=用户最初抱怨的"文档与代码分开"):`feature_*`→`curio_*`(103 处/7 文件)、`relic_*`→`feat_*`(162 处/12 文件)、运行层 `bonus_*`→`curio_*`(160 处/8 文件)。**硬约束:`reward_*` 已被 `reward_pick`/`reward_node`/`reward_preview` 占用,统一词族不得使用**;`relic_table.gd` 与两个控制器类改名须同步 Godot `.uid`/`.tscn`(非文本层无法自证)。**②三条渠道按分类分离**(现行三渠道共用同一个 98 张池、三类混编):关底 Boss 击败=通过这一关→只出专长;奖励节点/商店→属性值提升+资源、专长在此**只以门票形式**出现。**兑付频率红线**:奇物不是打一场战斗给一份,关内普通战斗节点打完不给任何奇物,一关之内只兑付一次(用户 2026-10-05 纠错)。**③两个新种类入池**=刷新次数(须先与"商店独立刷新机制"划清边界)+ 专长获取门票(拿到即开不可囤积/罕见只在概率/一局限购一次/计步保底:连续 5 次三选一展示未出→第 6 次必出,刷新重展计入、奖励节点与商店共享计数);附带 `shop.tres` 补回复(默认原则要求分类内成员都在该出现的渠道池里)与 charge 标签补至 ≥4 件(现仅 3 件,档二永远达不到——数据缺陷)。设计事实源=`design/gdd/systems/冒险循环/奇物.md` v2.7,任务书=`design/research/任务书-奇物词族对齐与渠道分离批-2026-10-05.md`(T0-T8≈4.5d,两段切分预案在册〔段一词族 T0-T3≈2d/段二渠道+入表 T4-T8≈2.5d〕,切分点=T3 出口;11 条设计契约含 6 条 🔴 停机级;12 条批末验收断言;代拍板白名单 5 项;待用户裁点 4 项〔玩家可见面违规/第四关档二复裁/门票四参数终值/存档键正式迁移〕)。**开工门**:与在途 M-4 各批(判式换代/全局变异/配比预设)撞同一批文件(`adventure_table.gd`/`level_runner.gd`/`adventure.tres`),须确认不并行或用户明示插队 | 卡②门:迭代 14 出口 | 卡①已落籍(原估 0.5d);卡②=**文档+数据层落籍(c571af2),渠道分离与入池实施段+curio 换名回归迭代 15 继续完成(2026-10-05 用户令)**——原估 T0-T8≈4.5d(可两段切分:词族对齐段 + 渠道入表段);**迭代 15 整行保持开放不标完成** |
|
||||
| 迭代 15 | **③秘宝代码词族对齐批(2026-10-05 用户令编入本迭代)**:设计侧已完成(消歧更名批 `430419c`+`06e94b7`,26 个设计文档「魔法道具」→「**秘宝**」,同调位机制名保留不变),本批只做**代码侧对齐**、不做二次设计。内容:`aux_*`/`AuxItem*` 词族全族换词 **358 处 / 36 文件**(重灾 `adventure_runner.gd`79 / `level_runner.gd`27 / `bonus_interact_controller.gd`19 / `battle_orchestrator.gd`18 / `config_db.gd`14 / `main.gd`13),分五组落:**A 玩家可见文案(P0,5 处)**=`battle_narrator.gd:117-118` + `bonus_interact_controller.gd:76` + `hero_info_panel_view.gd:56`(槽位标题 `UiKit.label`)+ `:178`(tooltip)· B schema 与数据表(`aux_item_table.gd`/`aux_items.tres`/`aux_items.gd` 文件名+类名+`ConfigDB` 持有变量与访问器全链跟改,**须同步 Godot `.uid`/`.tscn` + `--import` 重刷类名缓存**——迭代 14.5 实证在册坑)· C 文档链接修复(含 `architecture.md` 两处既有断债顺带清偿)· D 中文注释层(**须分色**:`魔法矢`/`魔法反噬`/`魔法族`/`魔法护甲` 属敌方伤害护甲语汇🔴不动)· E 测试文件名+内部变量。**用户三项拍板**:全族彻底改(含数据表)· **断点存档键一律保留**(`bonus_aux_carry`/`aux_detail`/`aux_cleared`/`aux_cleared_last`/`aux_items` 断点数组/`attunement_charges` 共 34 处引用一字不改,破档即进度丢失)· registry 条目键 `aux_items` 不改(数据契约键)。设计事实源=`design/gdd/systems/排雷循环/秘宝.md` v0.9,任务书=`design/research/任务书-秘宝代码词族对齐批-2026-10-05.md`(T0-T9≈5.0d,**超软盒 3 日上限·知情预挂**:T7 段末闸后 L3 呈报切点不擅切;**三档降级面 G1/G2/G3 在册**〔G3 下限=仅组 A 完成〕;5 条设计契约含 5 条 🔴 停机级〔存档兼容零破坏/数值零漂移/schema 契约面零变更/零字段更名/核心层零 await〕;代拍板白名单 5 项;**C1/C2 已裁关闭·全改保一致·待裁点 0 项**)。**撞批已消解**:② 奇物批 2026-10-05 收口落库(合并 `c571af2`),并行风险解除,本批为迭代 15 唯一在途需求;**T0 须重取基线**(判式换代批 T5 读数 750/0、② 又动数据层,§1.2 的 747 为②前旧数禁沿用)并复核事实表。**✅ 裁决(用户 2026-10-05「全改保一致」)**:C1 `"aux_item"` 域串**照改**(实测连锁面收窄——`reward.tres` 已零 aux_item 数据行,池种随迭代 11 T7 退役;16 处字面量全在代码内闭合无存档依赖;唯一连锁项=`smoke_all.gd:3932` 断言须同步)· C2 `aux_items` 一名两义**拆分**(ConfigDB 持有变量+表注册键✅改 / 断点存档键+冒烟夹具🔴禁改——**「键名禁改」与「变量名禁改」是两回事**,禁改的只是落盘字面量)。新增**组 F**(分派语汇与域串 16 处),任务卡扩为 T0-T10≈5.5d。**开工门**:✅ 已无待裁点,可直接发 T0 | 卡③门:迭代 14 出口(**裁点已全决·可开工**) | 卡①已落籍(原估 0.5d);卡②文档+数据层落籍(`c571af2`,实施段回归迭代 15 在飞——2026-10-05 用户令);**卡③ ✅ 已全批落籍(2026-10-05,worktree m4iter15-mibao 九提交 b4b8bb3..收口笔,主区 merge --no-ff 哈希见台账/active.md 快照行;出口报告=[iter15-3-mibao-exit-report](design/qa/iter15-3-mibao-exit-report-2026-10-05.md))**:词族实数 364 处/36 文件全换尽(例外 43+2 处=存档键引号字面量+夹具,穷举在报告 §五);闸=冒烟 755/0+run_all 14/15(唯一红=②批遗留基线红 reward_overlay,对照零新增)+行为探针四件全绿+doc 三闸/熵增闸零新增+存档键六键普查零差异+MC 按 goal 令豁免(静态零漂移证明代);渲染像素五闸屏蔽挂账 07⑮;遗留=实机目检归用户(07⑮)+reward_overlay 基线红归②批处置 |
|
||||
| 迭代 16 | **①敌人表行集多行批(2026-10-05 用户令编入本迭代,纯功能与数值轴四卡之一)**:放开敌人表「同一(关卡序号 × 节点深度)行集恰一敌种」加载期校验(enemy_table.gd:108-112 考证在册),允许同场遭遇混编多种敌人——生成(unit_container spawn 行集受理)/编排(battle_orchestrator/narrator)/断言面全链接通 + GDD 结构冻结面修订先行(敌人系统.md:75/:263)。事实源=06「同深度第二敌种与精英/Boss 编码位」条剩余面(前半已由关卡节点地图 v1.0 消解);前置=技能池实施批已落籍(d3fa887)开工门已解。任务书=`design/research/任务书-敌人表行集多行批-2026-10-05.md`(T0-T8≈4.25d 含条件卡 T5 首行投放/3.75d 不含;🔴 契约 5 条含零内容期逐位零漂移;代拍板白名单 3 项;**待用户裁点 4 项**〔P1 混编数量语义三案/P2 行集解析双算法处置〔工作日志 312 既有待裁随批〕/P3 本批是否投首个混编行/P4 Boss 行是否放开〕——裁点裁决后 U0 开工) | 迭代 15 出口 | T0-T8≈4.25d(超软盒预挂,T4 末切分点) |
|
||||
| 迭代 16 | **②M4 数值批(2026-10-05 用户令编入本迭代)**:四件数值欠账合一批——①削弱档位终值(weaken 现值 −65/duration 2/refresh 考证在册;叠层改续时语义已定案,差 duration 终值+当量锚复算)②调参批数值点评(06 条目现行登记五条——任务口径「八条」与条目五条不符,任务书 §2.2 已呈报差异以条目为准)③迭代 10 奖励重构联动欠账①②(钥石产出重标 boss_keystone 首杀 3/3/3·复杀 2/2/3 provisional + 通关率带重扫〔通关回血 20%+AP 件首轮 +1〕)④元进度定价剩余面(forge base 20/比 150 考证在册——06 条目文本「base 10」滞后于 2026-09-22 对齿批已呈报;Boss 两档终值)。读数义务随批=迭代 14 两件后置复算(T6 MC 四带复算+T7 技能池节奏重测,均挂 07);顺路修复 damage_probe A1 改前既有红灯(判式换代批出口报告 §四.7 在册)。**硬约束:一切 MC/verifier 跑批发起前须用户批准;调参联动禁独立调参网络(β 带 [1.2,2.5] 逐 u 检算)**。任务书=`design/research/任务书-M4数值批-2026-10-05.md`(T0-T8≈6.0d,天然切分点 T4 末;🔴 契约 5 条含跑批批准制;**待用户裁点 4 项**〔P1 削弱终值三案推算后裁/P2 点评不对称裁决方向/P3 钥石产出终值/P4 工坊直购价立否〕) | 迭代 15 出口 | T0-T8≈6.0d(超软盒预挂,段一 T0-T4≈4.25d/段二 T5-T8≈2.0d) |
|
||||
| 迭代 16 | **③暂停层只读入口批(2026-10-05 用户令编入本迭代)**:新增局内暂停层,承载钥石余额与解锁态(营地三柜台进度)只读查看——事实源=06「解锁界面与钥石呈现的交互形态(残余:暂停层只读入口)」条。考证在册:现行无暂停层;模态栈/设置面/调试浮窗三先例齐;UiKit 公共件(modal_shell/bcard/verb_button/徽章形制)与色板 token 单点现成;MetaProgression 只读访问器面齐全;战斗屏 GP/钥石已迁出=局内零查看入口正是本批由来。**美术红线:复用现行公共件与色板,零新素材零新色值(2026-10-05 用户立规)**。任务书=`design/research/任务书-暂停层只读入口批-2026-10-05.md`(T0-T5≈3.0d;🔴 契约 5 条含公共件单点/模态登记纪律;**待用户裁点 4 项**〔P1 入口位置四案荐丁/P2 与既有弹窗层关系三案荐甲/P3 展示范围三案荐甲/P4 减动效联动两案荐甲〕) | 迭代 15 出口 | T0-T5≈3.0d(贴软盒,T2 末切分点) |
|
||||
| 迭代 16 | **④生涯界面设计立项(2026-10-05 用户令编入本迭代;只做设计提纲不做实装)**:事实源=06「『生涯』界面——冒险中数据回看的唯一承接处」条(P-C7 裁:M9 已退役局内结算明细回看,历史数据现无承接面=用户知情裁决)。考证在册:回看退役已落码(battle_end_overlay/battle_log_view/ui_assembler 三处注记)+settlement_review_overlay.gd 遗留件在盘+跨局持久面=save v5 meta 域+**无历史冒险记录面**(settle_adventure 只入账不留痕=最大数据设计题)。任务书形态=设计提纲版:信息架构+承载内容清单(跨局汇总/历史冒险回看/图鉴承接)+与既有界面关系+三期实装建议+待裁点,标注「实装批另行立项」。任务书=`design/research/任务书-生涯界面设计立项-2026-10-05.md`(T0-T2≈1.25d 纯文档零测试;**待用户裁点 6 项**〔P0 载体/P1 入口位置/P2 历史数据面范围/P3 图鉴范围与顺序/P4 跳转边界/P5 遗留件处置〕) | 迭代 15 出口 | T0-T2≈1.25d(软盒内) |
|
||||
|
||||
## 执行纪律(2026-09-27 用户立规)
|
||||
|
||||
|
||||
Reference in new issue
Block a user