merge: 迭代17五任务书联审修订落籍(用户十裁 Q1-Q10 全落 d6e8424——五卡'零待裁点'经审查重建;纯文档零代码零测试)
This commit is contained in:
commit
68b8f15c68
8 files changed
+148
-127
No files matched your search
@@ -136,7 +136,7 @@
|
||||
|
||||
**归属**:[排雷玩法](systems/排雷循环/排雷玩法.md)(动作语义与 8 向目标规则主责)+ [HUD 框架](systems/表现与支撑/HUD框架.md)(键盘光标与合法性反馈呈现)+ [设置与本地化](systems/表现与支撑/设置与本地化.md)(键位自定义,可选面)
|
||||
|
||||
**状态**:待办——排期 **Beta 阶段**(2026-10-04 登记;可行性已核毕,立项时按 roadmap 开卡)
|
||||
**状态**:待办——排期 **Beta 阶段**(2026-10-04 登记;可行性已核毕,立项时按 roadmap 开卡)。**2026-10-06 增补登记**:暂停层 Esc 快捷通道并入本条随键盘批统一实施(迭代 17 卡③暂停层批 P1 裁决=常驻角标本批落码、Esc 键不单独开通道;批出全屏弹层后本条③「弹层界面现行全鼠标」清单 +1 项=暂停层)
|
||||
|
||||
#### 挖掘风险不等式对账破线
|
||||
|
||||
@@ -154,7 +154,7 @@
|
||||
|
||||
**归属**:随[关卡节点地图](systems/冒险循环/关卡节点地图.md)定稿改键一并裁决
|
||||
|
||||
**状态**:部分收口(2026-09-17)——同层多遭遇问题已由关卡节点地图 v1.0 的**节点编号升级**消解(`node_depth` 语义 = 关卡内唯一节点编号,同层不同节点各查各行,键结构零改动);**不设精英 / Boss 编码位**(Boss = 最大编号节点,精英 P2 内容承载)。剩余面继续待办并改归属:同场多敌种(同一编号行集多行)的行集校验放开 ——归属**敌人表行集多行批(战斗侧,排技能池实施批落地后)**(混编伏击上限取值口径面已随 2026-09-20 单轮上限删除消解)。**已编入 roadmap 迭代 17 卡①(2026-10-05——任务书已成文待 U0:design/research/任务书-敌人表行集多行批-2026-10-05.md;前置「技能池实施批落地」已于 2026-10-05 满足〔d3fa887〕,开工门已解,4 项裁点已全裁〔2026-10-06 用户令:P1甲/P2甲/P3乙投放教学位行/P4乙 Boss 行亦放开·零内容投放不变〕)**
|
||||
**状态**:部分收口(2026-09-17)——同层多遭遇问题已由关卡节点地图 v1.0 的**节点编号升级**消解(`node_depth` 语义 = 关卡内唯一节点编号,同层不同节点各查各行,键结构零改动);**不设精英 / Boss 编码位**(Boss = 最大编号节点,精英 P2 内容承载)。剩余面继续待办并改归属:同场多敌种(同一编号行集多行)的行集校验放开 ——归属**敌人表行集多行批(战斗侧,排技能池实施批落地后)**(混编伏击上限取值口径面已随 2026-09-20 单轮上限删除消解)。**已编入 roadmap 迭代 17 卡①(2026-10-05——任务书已成文待 U0:design/research/任务书-敌人表行集多行批-2026-10-05.md;前置「技能池实施批落地」已于 2026-10-05 满足〔d3fa887〕,开工门已解,4 项裁点已全裁并经 2026-10-06 联审二裁修订:P1甲〔Q8/Q9 补全=每行一骰·RNG 扩签先报批·实例总数≤4〕/P2甲/P3丙〔改裁撤投放——首混编行连同 Boss 多行归后续内容批,投时 MC 取证先报批+难度带读数义务随批登记 07〕/P4乙 Boss 行亦放开·零内容投放不变)**
|
||||
|
||||
|
||||
#### 技能池情境条件触发器
|
||||
@@ -203,7 +203,7 @@
|
||||
|
||||
**归属**:战斗结算与地图战斗资源共裁(数值终值归状态层重设计批)
|
||||
|
||||
**状态**:待办(语义已定案,数值未闭合)——**已编入 roadmap 迭代 18 M4 数值批〔2026-10-06 用户令自迭代 17 卡②移出——不影响 17 在飞开发〕(2026-10-05——裁点已全裁〔2026-10-06 用户令:P1甲/P2甲/P3甲/P4甲〕待 U0:design/research/任务书-M4数值批-2026-10-05.md;duration 终值与当量锚复算 = 件①,跑批发起前须用户批准)**
|
||||
**状态**:待办(语义已定案,数值未闭合)——**已编入 roadmap 迭代 18 M4 数值批〔2026-10-06 用户令自迭代 17 卡②移出——不影响 17 在飞开发〕(2026-10-05——裁点已全裁并经同日联审二裁修订:P1甲〔带内落定随出口追认〕/P2甲/P3甲〔转正顺延至重扫读数到账且带内〕/P4甲〕待 U0:design/research/任务书-M4数值批-2026-10-05.md〔v1.2〕;duration 终值与当量锚复算 = 件①,跑批发起前须用户批准)**
|
||||
|
||||
#### 单体寻址的接口扩展位
|
||||
|
||||
@@ -281,7 +281,7 @@
|
||||
|
||||
**归属**:HUD 批(M-4,批未立项)
|
||||
|
||||
**状态**:待办(2026-10-03 06 清账批瘦身——视觉终稿半兑现销号,本条仅存暂停层残余)——**已编入 roadmap 迭代 17 卡③(2026-10-05——裁点已全裁〔2026-10-06 用户令全按推荐:P1丁/P2甲/P3甲/P4甲〕待 U0:design/research/任务书-暂停层只读入口批-2026-10-05.md,美术红线=复用现行公共件零新素材)**
|
||||
**状态**:待办(2026-10-03 06 清账批瘦身——视觉终稿半兑现销号,本条仅存暂停层残余)——**已编入 roadmap 迭代 17 卡③(2026-10-05——裁点已全裁〔2026-10-06 用户令全按推荐:P1丁/P2甲/P3甲/P4甲〕,任务书经同日联审修订 v1.1〔badge 工厂化裁决/基线换代/R4 口径收敛〕;Esc 快捷通道已按 P1 丁增补登记进本清单键盘/手柄条〔2026-10-06〕;待 U0:design/research/任务书-暂停层只读入口批-2026-10-05.md,美术红线=复用现行公共件零新素材)**
|
||||
#### 第一关亮墨数字直画观感优化(2026-10-01 T17 目检体感登记)
|
||||
|
||||
**现状**:迭代 9 T4 数字承载切换后第一关=亮墨三档直画(白亮字直接印棕色地板、无色牌垫底),机制可读性过闸(用户实机确认三档冷暖可分、凑近与离屏均可读);同日 T17 目检体感「表现和描述一样,但非常难看」——直画字与地板的组合观感待优化。第二/三关米色小牌形态未获同类反馈。
|
||||
@@ -401,7 +401,7 @@
|
||||
|
||||
**归属**:新界面立项(用户发令后排批);退役落码随 UI 落码批 M8/M9
|
||||
|
||||
**状态**:待办(生涯未做前,冒险中无任何历史回看入口——已知代价,用户知情裁决)——**已编入 roadmap 迭代 17 卡④(2026-10-05——设计提纲版裁点已全裁〔2026-10-06 用户令全按推荐:P0甲/P1甲/P2甲/P3甲/P4甲/P5甲〕待 U0:design/research/任务书-生涯界面设计立项-2026-10-05.md,实装批另行立项)**
|
||||
**状态**:待办(生涯未做前,冒险中无任何历史回看入口——已知代价,用户知情裁决)——**已编入 roadmap 迭代 17 卡④(2026-10-05——设计提纲版裁点已全裁〔2026-10-06 用户令全按推荐:P0甲/P1甲/P2甲/P3甲/P4甲/P5甲〕,并经同日五任务书联审修订〔v1.1〕:历史摘要面实为 recent_summaries 现役 cap=10 非空白、P2 甲口径重述=扩容+补用时埋点、总局数/通关局数标注涉存档 schema、营地既有最近冒险清单去留列入设计稿必答项;待 U0:design/research/任务书-生涯界面设计立项-2026-10-05.md,实装批另行立项)**
|
||||
|
||||
### GP 经济
|
||||
|
||||
|
||||
@@ -169,4 +169,6 @@
|
||||
|
||||
**已履行**(按序换代,旧读数各随其批作废留痕不入本单):①验收读数重测批(2026-09-19——Boss 单独出列/承伤带/通关率基线全量重测,硬化翻倍期·乏力死效果期·充能期旧读数作废);②迭代 5 基线重测(统一随机流后 MC+verifier 双窗);③**数值修复批新尺重测(2026-10-01)**——模拟档位重构后全量重测,新锚 `sim-data/runsum_numfix_final_n200_20261001.jsonl`,全旧带作废只测不判([numfix 报告](../qa/numfix-newruler-readings-2026-10-01.md));④**迭代 10 奖励重构批重锚(2026-10-01)**——四代锚 77000/78000/79000/80000(改前/重构后/共享池后/掷定前置后,各 400 局),普通 L1 41.8%/L2 10.2% 带内([读数报告](../qa/m3-iter10-clear-rate-readings-2026-10-01.md));⑤**T19 真人标定局收口(2026-10-03 用户裁)**——有效局 2(1 通关 1 死于 L3 首战,[读数报告](../qa/t19-real-playtest-readings-2026-10-02.md)),用户裁定**佐证级收口不再补局**;k 预期带同日立(**正常 >0.5、预警 <0.3**),字段随 81000 重锚入库后补算终值。
|
||||
|
||||
**现行义务**:**T7 技能池节奏重测(2026-10-05 技能池执行批挂单)**——≥50 distinct seeds 节奏重测(过涝判读带=Boss 半血后特殊技密度上探;跑批须用户批准;S2 过涝越带→解锁技权重/倍率回调呈报禁自动调)→ ~~T19 真人标定局~~(⑤已收口)→ 真人侧读数换 81000 锚补算 k 终值(随迭代 9 出口重锚批出,模拟锚 2026-09-19 判读报告的现行锚地位由 81000 锚+真人两局承接)。工具面:`analyze_playtest.py` / `balance_verifier.py` 冒险段 / JSONL 日志现役。
|
||||
**现行义务**:**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 遭遇骰读首行区间/半血解锁/独占技/难度带六面读数逐项过。
|
||||
@@ -1,6 +1,6 @@
|
||||
# 任务书:M4 数值批(v1.1 定稿——案C 增补,待发令开工)
|
||||
# 任务书:M4 数值批(v1.2 定稿——案C 增补+联审修订,开工门=U0 用户发令)
|
||||
|
||||
> 成文 2026-10-05。**性质**:四件数值收口合一批 + 两件读数义务随批跑 + 一件既有探针红灯顺路修复。
|
||||
> 成文 2026-10-05,v1.2 修订 2026-10-06(五任务书联审:P3 转正顺延、检算工具入留痕、T3/T5 跑批并账、06 死数字补登记、R5/F19 调停、估时勘误)。**性质**:四件数值收口合一批 + 两件读数义务随批跑 + 一件既有探针红灯顺路修复。
|
||||
> 归属迭代:**迭代 18**(2026-10-06 用户令自迭代 17 卡②移出独立成批——不影响迭代 17 在飞开发;迭代 17 余卡=⓪内容数据驱动扩展 ①敌人表行集多行批 ③暂停层只读入口批 ④生涯界面设计立项)。
|
||||
> 满足 loop engineering 八件(见 §9 逐条对照)。
|
||||
> 🔴 **铁规前置(违反即返工)**:①本批一切 MC / verifier 跑批**发起前须用户批准**(先推算后重跑铁规 + MC 触发细则:数值验证场景才触发,四档硬闸在册);②**调参联动禁独立调参网络**——行动经济 F1 条款3 v0.8 已立 β 带 [1.2,2.5] 逐 u 检算口径,任何数值调整须按调参联动表同窗检算,禁单参数孤立改。
|
||||
@@ -21,7 +21,7 @@
|
||||
| 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 追认清单与读数报告交付用户 |
|
||||
| 5 | 重闸全绿 + 人闸完成 | 冒烟全量(基线 T0 重测回填)· run_all 十七套件 · doc 三闸零新增 · 熵增闸 PASS;provisional 追认清单与读数报告交付用户 |
|
||||
|
||||
> ⚠️ **基线纪律**:起草时点 master 头 = 413c936,冒烟基线 772/0,run_all 14/15(reward_overlay_test 红 = 迭代 15② 奇物批遗留基线红,与本批无关,对照口径 = 零新增)。**v1.1 增补时点(2026-10-06)master 头 = 7d3e88fc,冒烟 783/0,run_all 17 套全绿——案C 地图伤害账殿后批已换代每轮结算行为序,本批一切 MC 读数按新行为首采**。T0 重测回填,禁止沿用本文数字。
|
||||
|
||||
@@ -33,8 +33,9 @@
|
||||
|---|---|---|
|
||||
| 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) |
|
||||
| F3 | 取值域 | [60,85](06 条目登记,源自旧体系裁决);复算须按 β 带 [1.2,2.5] 逐 u 检算口径(行动经济 F1 条款3 v0.8)。⚠️ **带有效性未复核(v1.2 补)**:[60,85] 是案C 行为换代+收窄批两层变更前的旧裁决产物,weaken 计入收益侧、magnitude 越大 β 越高——T0 推算稿须给出「β 约束下的 magnitude 可行子区间」,若 85 处逐 u 破带则可行带收窄,按 L3 呈报用户裁带,禁默认全带可用 |
|
||||
| F4 | 关联新变量 | 2026-10-05 判式换代批已投 `flag_hit_premium=125`(provisional,旗溢价 ×1.25)——削弱当量复算须把旗溢价纳入同窗检算(难度曲线与Boss 调参联动表已登记 δ↔p_perfect↔ap_per_round 联动面) |
|
||||
| F4b | 检算工具载体(v1.2 补) | 当量锚/β 带复算的常设重跑入口 = `tools/clear_dominance_audit.py`(行动经济.md:134 明文),该工具 **51 行硬编码 `WEAKEN_PCT = 65`**——magnitude 投到非 65 值而工具常量不同步,投值前后全部复算读数按旧值错算。**工具常量随投值同步**是 T1 完成判据之一,且该文件入 §10 留痕清单、常量刷新入四类同步面 |
|
||||
|
||||
### 2.2 件② 调参批数值点评(06「调参批数值点评登记」条)
|
||||
|
||||
@@ -56,7 +57,7 @@
|
||||
|
||||
| # | 事实 | 读数 |
|
||||
|---|---|---|
|
||||
| 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 条目文本滞后未刷新,本批随件④收口时一并刷新该句 |
|
||||
| F11 | 柜台定价现值 | `meta.tres` forge_products 三行:`base_price` **20** · `price_ratio_pct` **150**(血+3/攻+1/甲+1 不变)——⚠️ **06 条目同一句有两处死文本**(v1.2 补全):「base 10 公比 150」(2026-09-22 数值设计批已 10→20,文本滞后)+「Boss 两档 L1 5/1·L2 8/2·L3 12/3」(迭代 10 重锚前死数字,现值 3/3/3·2/2/3)。T4 判据「06 文本滞后句刷新(F11)」按两句全刷执行,只刷 base 句出口后 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 标定批,冒险条件口径实测)——不在本批范围,除非重标读数破带 |
|
||||
@@ -65,8 +66,8 @@
|
||||
|
||||
| # | 事实 | 读数 |
|
||||
|---|---|---|
|
||||
| F15 | 读数义务 A | **T6 MC 四带复算**(初始展开收窄批后置,2026-10-05 落籍时按切分预案挂 07 现行义务):收窄批(剃雷域 r=1 + R₀≤cap 重掷闸)后的四带通关率复算 |
|
||||
| F16 | 读数义务 B | **T7 技能池节奏重测**(07 现行义务,技能池执行批挂单):≥50 distinct seeds 节奏重测,过涝判读带 = Boss 半血后特殊技密度上探;S2 过涝越带 → 解锁技权重/倍率回调**呈报禁自动调** |
|
||||
| F15 | 读数义务 A | **T6 MC 四带复算**(初始展开收窄批后置,2026-10-05 落籍时按切分预案挂 07 现行义务):收窄批(剃雷域 r=1 + R₀≤cap 重掷闸)后的四带通关率复算。⚠️ **与 F8 同一测量(v1.2 并账)**:件③「通关率带重扫」与本义务口径同为现行构建四带通关率(balance_verifier 冒险段派生),**一次跑批双认账**,禁两个卡各跑一遍(R3 先推算后重跑)。另:07「现行义务」节尾还有「真人侧读数换 81000 锚补算 k 终值」一段,是否随 T5 履行 T0 呈报定性,禁默认顺延 |
|
||||
| F16 | 读数义务 B | **T7 技能池节奏重测**(07 现行义务,技能池执行批挂单):≥50 distinct seeds 节奏重测,过涝判读带 = Boss 半血后特殊技密度上探;S2 过涝越带 → 解锁技权重/倍率回调**呈报禁自动调**。⚠️ **判读带换代复核(v1.2 补)**:判读带挂单于 2026-10-05(案C 之前),案C 移动地图伤害兑付时点 → 战斗轮数与 Boss 血量曲线移位 → 「半血后」窗口与密度分母都漂——T7 执行前先复核判读带在案C 新行为下是否仍有权,失权即停机呈报重立带 |
|
||||
| F17 | 顺路修复 | **damage_probe A1 红灯**(`smoke/damage_probe.gd:72`「A1 攻击链健康(fresh 池·掷点口径):非蓄力拍 d_tick = max(下限, 掷点档位基线+附加)」)——判式换代批出口报告 §四.7 在册:**改前既有红**(26374ac 复跑同败,非任何在册批引入),原登记「归独立 mini-loop 处置」,现按用户令编入本批顺路修复 |
|
||||
|
||||
### 2.6 案C 行为换代事实(v1.1 增补——2026-10-06 起草时点后发生)
|
||||
@@ -87,6 +88,7 @@
|
||||
| **双写失同步禁止** | 动任何数值必须 `.tres` + GDD 正文 + registry + 06 状态行四类同步,缺步即视为未完成(doc-conventions §5) |
|
||||
| **非数值面零触碰** | 本批不改机制、不改呈现、不改存档 schema |
|
||||
| **迭代 15② 奇物批不交叉** | 渠道分离与入池实施段归迭代 15 继续完成,与本批无关;reward_overlay_test 基线红归②批处置,本批只守零新增 |
|
||||
| **与迭代 17 卡⓪/卡① 的交叠声明(v1.2 补)** | 卡⓪重写 battle_orchestrator 事件挂点+授予/兑付分支、卡①放开行集多行改遭遇构成——两者都在本批 T6 damage_probe A1 归因、对拍锚重推导、四带通关率分母的同文件同管线上。时序安全(本批前置=迭代 17 出口),但:①A1 红灯归因与修法在卡⓪落地后可能变样,T6 执行时按卡⓪出口报告重对账;②T0 事实表复核清单含「按卡⓪/卡①出口报告重取受影响事实」,禁照抄本文行号 |
|
||||
|
||||
## 4. 设计契约(🔴 触碰 = L3 停机)
|
||||
|
||||
@@ -96,23 +98,23 @@
|
||||
| 🔴 R2 | **联动检算**:每个投值点附 β 带逐 u 检算行(u=1/2/3),破带不擅调、呈报 | 投值 commit 随附检算 |
|
||||
| 🔴 R3 | **先推算后重跑**:所有读数先给静态推算/预期区间,批不准不动模拟器 | 读数报告含推算节 |
|
||||
| 🔴 R4 | **provisional 纪律**:新投值一律 provisional 标注并归出口追认清单;摘除 provisional 须读数支撑 | 出口追认清单 |
|
||||
| 🔴 R5 | **改前锚留盘禁补跑**:凡改前/改后对比,改前锚同 seed0 配对留盘,禁补跑禁覆盖 | sim-data 锚清单 |
|
||||
| 🔴 R5 | **改前锚留盘禁补跑**:凡改前/改后对比,改前锚同 seed0 配对留盘,禁补跑禁覆盖。**口径调停(v1.2)**:本批合法的「改前锚」= T0 按案C 新行为新立的锚(F19:sim-data 在盘旧锚全作废、只作历史存档)——禁拿在盘旧锚充当改前配对,两节字面冲突以此为准 | sim-data 锚清单 |
|
||||
|
||||
## 5. 任务卡(逐卡一个 loop 轮次)
|
||||
|
||||
| 卡 | 内容 | 估时 | 轻闸 | 完成判据 |
|
||||
|---|---|---|---|---|
|
||||
| **T0** | 开工:worktree + 基线重测回填 + §2 事实表复核(重点 F1/F7/F11/F17/F19)+ 四件欠账的静态推算稿(每件先给推算结论与建议值区间)+ 对拍锚按案C 新序重推导(F19) | 1.0d | 冒烟基线 | 推算稿五件齐(含对拍锚按案C 新序重推导)+ 基线回填;推算结论呈用户并**请批跑批计划**(R1/R3) |
|
||||
| **T1** | 件①削弱终值:duration 终值与当量锚复算(推算 → 用户批跑批 → 投值)+ 文档四类同步 | 0.75d | 冒烟 | β 带检算行随 commit;provisional 归出口追认 |
|
||||
| **T0** | 开工:worktree + 基线重测回填 + §2 事实表复核(重点 F1/F7/F11/F17/F19 + 按卡⓪/卡①出口报告重取受影响事实)+ 四件欠账的静态推算稿(每件先给推算结论与建议值区间;**件①含 β 约束下的 magnitude 可行子区间推算**——[60,85] 带有效性复核,v1.2 补)+ 对拍锚按案C 新序重推导(F19) | 1.0d | 冒烟基线 | 推算稿五件齐(含对拍锚按案C 新序重推导+可行子区间)+ 基线回填;推算结论呈用户并**请批跑批计划**(R1/R3) |
|
||||
| **T1** | 件①削弱终值:duration 终值与当量锚复算(推算 → 用户批跑批 → 投值;**投值值非 65 时同步刷新 `tools/clear_dominance_audit.py` WEAKEN_PCT 常量**,v1.2 补)+ 文档四类同步 | 0.75d | 冒烟 | β 带检算行随 commit;工具常量同步或值=65 的说明随 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 四带复算(案C 新行为首采——旧锚全作废,新锚自本批立,F19)+ T7 技能池节奏重测(用户批准后发起,可与其他卡窗口期并行等结果) | 0.75d | — | 两份读数报告落 design/qa/;S2 越带按呈报口径处理 |
|
||||
| **T3** | 件③联动欠账:钥石产出重标(F7 读数推算 + 现行产出结构对账)+ 通关率带重扫(F8——**与 T5 的 T6 四带复算并账,一次跑批双认账,v1.2**;须用户批跑批) | 1.0d | 冒烟 | ①②两条 06 状态行收口;重扫读数落报告 |
|
||||
| **T4** | 件④定价剩余面:柜台定价数字终值 + Boss 两档终值(推算 → 批跑 → 投值)+ 06 文本滞后句刷新(F11,**两句全刷**——base 句+Boss 两档死数字句) | 0.75d | 冒烟 | meta.tres 终值落 + 四类同步 |
|
||||
| **T5** | 读数义务两件:T6 MC 四带复算(案C 新行为首采——旧锚全作废,新锚自本批立,F19;**与 T3 重扫并账同一次跑批**)+ T7 技能池节奏重测(用户批准后发起,判读带先按 F16 换代复核;可与其他卡窗口期并行等结果) | 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.25d**(v1.1 增补 +0.25d),显著超软时间盒 3 日上限——知情预挂:**天然切分点 = T4 末**(段一 T0-T4 四件欠账 ≈4.5d / 段二 T5-T8 读数与修复 ≈2.0d);超限即按 L3 呈报切点,不擅切。读数跑批的墙钟时间不计估时(用户批准后后台跑)。
|
||||
> 估时合计 ≈ **6.25d**(v1.1 增补 +0.25d),显著超软时间盒 3 日上限——知情预挂:**天然切分点 = T4 末**(段一 T0-T4 四件欠账 ≈**4.25d**——v1.2 算术勘误:1.0+0.75+0.75+1.0+0.75=4.25,v1.0/v1.1 写 4.5 系加总错误且已传播进 roadmap,同批修正 / 段二 T5-T8 读数与修复 ≈2.0d);超限即按 L3 呈报切点,不擅切。读数跑批的墙钟时间不计估时(用户批准后后台跑)。
|
||||
|
||||
## 6. 验证闸
|
||||
|
||||
@@ -153,11 +155,11 @@
|
||||
|
||||
### P3 · 钥石产出重标的终值方向
|
||||
|
||||
**✅ 裁决(2026-10-06 用户令):案甲**——首杀 3/3/3 · 复杀 2/2/3 转正。
|
||||
**✅ 改裁(2026-10-06 二裁,用户令,Q4 甲):维持案甲方向、转正时点顺延**——首杀 3/3/3 · 复杀 2/2/3 维持、摘 provisional 的时点改为 **T3/T5 重扫读数到账且带内后随出口追认**。改裁依据:一裁的支撑读数「迭代 10 四代锚钥石 1.38/3.01」出自 F19 宣告全数作废的旧行为锚(且先于收窄批一层),按本批自家契约 R4「摘除 provisional 须读数支撑」,该依据在重扫读数到账前不成立;且 per-run 钥石收入=通关率×掉落值,案C 后通关率预期上行(F20),产出账须按新行为读数重验。**零改动落码不变,变的只是摘 provisional 的合法时点。**
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲 | 维持首杀 3/3/3 · 复杀 2/2/3 转正 | 现行读数(迭代 10 四代锚钥石 1.38/3.01)未显示失衡;零改动 |
|
||||
| 甲 | 维持首杀 3/3/3 · 复杀 2/2/3,转正顺延至重扫读数到账且带内(二裁生效) | 零改动;读数支撑面按 R4 合法补齐 |
|
||||
| 乙 | 按定价终值(P4 联动)倒推产出重锚 | 产出与定价同账收口最彻底;代价是定价未定前产出无法先定,两裁点强耦合 |
|
||||
| 丙 | 精英掉落行实装并纳入产出账 | 淘汰候选:精英属 P2 内容承载(06 已裁不设精英编码位),本批不引新内容轴 |
|
||||
|
||||
@@ -202,9 +204,10 @@
|
||||
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(重扫基线)
|
||||
7. design/qa/m4iter14-narrow 相关读数与 design/qa/m3-iter10-clear-rate-readings-2026-10-01.md(重扫基线——仅历史参照,锚已随 F19 作废)
|
||||
8. 06-待办清单「旧行为 MC 行为锚全数作废——重锚归数值批」条(2026-10-06 登记——F19 正主)
|
||||
9. game/core/battle_orchestrator.gd 暂存闸 `_defer_board_damage`/`_deferred_board`(案C 实现载体——T6 读数判读前须读案C 批提交 58dfb56 diff)
|
||||
10. tools/clear_dominance_audit.py(β 带/当量锚复算常设工具,:51 WEAKEN_PCT 硬编码——F4b/T1 同步义务载体,v1.2 补)
|
||||
```
|
||||
|
||||
## 11. 版本记录
|
||||
@@ -213,3 +216,4 @@
|
||||
|---|---|---|
|
||||
| v1.0 | 2026-10-05 | 初稿定稿(四件欠账+两件读数+damage_probe A1 顺路修;P1-P4 拍板点框架) |
|
||||
| v1.1 | 2026-10-06 | **案C 增补**:§2.6 三事实(F18 行为换代/F19 锚全作废/F20 难度走向预判);T0 推算稿四件→五件(+对拍锚按新序重推导,估时 0.75→1.0d,合计 6.0→6.25d);T5 读数卡 T6 项注明案C 新行为首采立新锚;基线纪律注换代(783/0+17 套全绿);§10 留痕 +3 条。增补动因=案C 地图伤害账殿后批(git 7ef18ac)换代结算行为序,06 2026-10-06 条登记重锚义务归本批 |
|
||||
| v1.2 | 2026-10-06 | **五任务书联审修订**:P3 转正顺延至重扫读数后(一裁依据系 F19 作废锚);F3 带有效性复核+F4b 检算工具(clear_dominance_audit.py WEAKEN_PCT)入留痕与 T1 判据;F11 补 Boss 两档死数字、T4 两句全刷;F15 与 F8 并账一次跑批双认账;F16 判读带案C 换代复核;§3 交叠声明(卡⓪/卡①同管线);R5 与 F19 调停(改前锚=本批新立案C 锚);run_all 十五→十七;估时段一 4.5→4.25d 算术勘误(roadmap 同步)。裁决 Q4 甲随批落文 |
|
||||
@@ -1,7 +1,9 @@
|
||||
# 任务书-内容数据驱动扩展批(迭代 17 卡⓪)-2026-10-06
|
||||
|
||||
状态:任务书 v1.0(**全部裁决已落、零待裁点**,开工门=U0 用户发令)。设计权威=调研报告 [研究-内容数据驱动扩展架构-2026-10-06](研究-内容数据驱动扩展架构-2026-10-06.md)+本会话盘问裁决实录(台账 370)。
|
||||
排期:**迭代 17 头卡(2026-10-06 用户令插队)**,迭代 17 原①-④卡顺延(任务书与裁点状态原样保留)。
|
||||
状态:任务书 v1.1(**全部裁决已落、零待裁点**,开工门=U0 用户发令)。设计权威=调研报告 [研究-内容数据驱动扩展架构-2026-10-06](研究-内容数据驱动扩展架构-2026-10-06.md)+本会话盘问裁决实录(台账 370)。
|
||||
排期:**迭代 17 头卡(2026-10-06 用户令插队)**,迭代 17 现=卡⓪①③④四卡(M4 数值批已移迭代 18,roadmap 现行口径)。
|
||||
|
||||
**v1.1 修订记录(2026-10-06 五任务书联审,用户裁决 Q2 甲/Q6/Q7 + 事实勘误)**:①效果类型闭集扩两型(`damage_mult` 伤害倍率修正、`open_ticket` 新建伤害单)——nest_counter/flag_burst/war_banner 三处现状行为原词汇表装不下;②事件词汇补 `charge_full`(charge 满层沿);③pick_refresh 改走主动件分发通道不入事件订阅;④level_clear 归登记不实施(用户裁 Q6,§3.1 起草越界已删);⑤对拍判据两套口径落文(Q7,正主读数档升格为引用件);⑥计数勘误(事件/效果类型/消费点三处);⑦映射表五处语义修正(luck_coin 归属、deep_drill 降级、armory_prep 转移、boss 血量阈值事件改名通用化、first_dig fact 改每战口径);⑧断言面随迁与订阅重建时机补列。
|
||||
|
||||
---
|
||||
|
||||
@@ -9,80 +11,83 @@
|
||||
|
||||
把「内容的效果行为」从散布在结算代码里的硬编码分支,搬进内容数据行的三个字段——**订阅哪个事件(on)/ 什么条件(when)/ 什么效果(do)**——由一个通用解释器(EffectEngine)统一执行。完成后:加一件「已有效果类型」的新专长/新秘宝=只改 `.tres` 数据行,零代码。
|
||||
|
||||
**完成定义**:①旧 23 挂点枚举删除,27 行专长数据全部迁为事件订阅形态且行为等价(MC 对拍锚逐位一致);②六件按 id 硬编码的被动秘宝迁毕、按 id 特判清零;③文案表值化(效果说明进数据行);④一个迭代内完成、一次合并登记。
|
||||
**完成定义**:①旧 23 挂点枚举删除,27 行专长数据全部迁为事件订阅形态且行为等价(对拍判据两套,见 §六 T6 与 §八);②六件按 id 硬编码的被动秘宝迁毕、按 id 特判清零;③文案表值化(效果说明进数据行);④一个迭代内完成、一次合并登记。
|
||||
|
||||
## 二、裁决实录(2026-10-06 用户逐条裁定,全数有效)
|
||||
|
||||
| # | 裁决 | 内容 |
|
||||
|---|---|---|
|
||||
| R1 | 架构模型 | 发布订阅:结算管线同步 emit 事件(无队列无异步,确定性优先)→ EffectEngine 遍历持有集匹配订阅 → 执行数据行里声明的效果。**不是**代码级插件/监听器类——订阅关系本身是配置 |
|
||||
| R2 | 拦截能力 | 不做通用拦截器链;只保留**一个改写窗口**(伤害单据 open_ticket 后、submit 前,modify 类效果收集后单点按声明序施加)。断链/否决能力不建,将来需要时加 veto 位 |
|
||||
| R2 | 拦截能力 | 不做通用拦截器链;只保留**改写窗口**(伤害单据 open_ticket 后、submit 前,modify 类效果收集后单点按声明序施加)。断链/否决能力不建,将来需要时加 veto 位。**窗口归属澄清(v1.1)**:armor_roll_rewrite / roll_discount 的现行消费点在护甲掷骰与克制判定的判定点内部,不在 open→submit 单点窗口——它们随各自事件(armor_roll / clamp_check)在判定点就地按声明序施加;modify_ticket 的「单点窗口」仅指 attack_commit 系单据 |
|
||||
| R3 | 多订阅与冲突 | 一事件多订阅=常态(持有集即订阅集);冲突在**效果类型层用组合规则封死**(见 §四),内容行只能选类型不能自定义合并行为。遍历顺序=数据表声明序,写死保种子复放 |
|
||||
| R4 | 旧挂点处置 | 23 个 hook 枚举**删除**(概念消亡:事件名+效果类型取代);其中 first_dig_spell、terrain_dig_double 退化为纯条件行;dig_count_segments 与 round_dig_bonus 保留为**两件独立内容**(效果类型不同:攻击分段 vs 攻击加值),订阅同事件 |
|
||||
| R5 | 范围判据 | **现有实现全部改造**(含 luck_coin 偏运硬币→reward_roll 事件、文案硬编码、令牌 match、树规则键);**06 在册待办只登记不实施**(curio_roll/shop_purchase/gp_settle/level_clear 四事件只登记事件名与发射点设计,哪个 06 内容开工时随批加) |
|
||||
| R6 | 框架先行 | round_start / boss_hp_threshold / treasure_used 等发射点一律埋进本批,不论当前有无订阅者 |
|
||||
| R6 | 框架先行 | round_start / enemy_hp_threshold / treasure_used 等发射点一律埋进本批,不论当前有无订阅者 |
|
||||
| R7 | 交付形态 | **一个迭代完成**,按模块垂直切需求卡(框架/专长/秘宝/令牌树),不分批不分迭代、批末一次合并 |
|
||||
| R8 | 术语纪律 | 事件=`.on("xxx")` 的 "xxx";订阅后逻辑=效果类型;多订阅叠加规则=组合规则。禁用「挂点/hook/合并律/挂账」等自造词(存量文档随 T7 换代) |
|
||||
|
||||
## 三、事件词汇表(定稿:实施 17,登记暂不做 4)
|
||||
## 三、事件词汇表(定稿:实施 16,登记暂不做 4)
|
||||
|
||||
### 3.1 本批实施(17 个发射点)
|
||||
### 3.1 本批实施(16 个发射点)
|
||||
|
||||
| 事件名 | 发布时机(发射点,现有代码位置) | 载荷要点 |
|
||||
|---|---|---|
|
||||
| `dig_reveal` | 安全开格结算完成(battle_orchestrator 挖格段) | cell、round、is_first_dig_of_level、terrain_kind |
|
||||
| `dig_paid` | 付费开掘发起、动作经济闸收对价前 | cell、ap_cost |
|
||||
| `dig_reveal` | 安全开格结算完成(battle_orchestrator 挖格段) | cell、round、is_first_dig_of_battle、terrain_kind |
|
||||
| `dig_paid` | 付费开掘发起、动作经济闸收对价前 | cell、ap_cost、ap_surplus |
|
||||
| `flag_hit` | 标中雷兑付时 | cell、round、adjacent_terrain |
|
||||
| `mine_hit` | 踩雷时(含计数清零语义面) | cell、round、damage |
|
||||
| `level_clear` | 一张图清空兑付时 | round |
|
||||
| `attack_commit` | 我方伤害单据开立(damage_controller.open_ticket 入口) | atk、target、matchup、feats_ctx |
|
||||
| `clamp_check` | 克制关系判定修正点 | matchup(magic_vs_magic/magic_vs_heavy/pierce_vs_light/…) |
|
||||
| `armor_roll` | 敌护甲掷骰判定 | target_ac、roll |
|
||||
| `kill` | 敌人死亡确认 | target、overflow余量 |
|
||||
| `damage_taken` | 我方受到伤害(kind ∈ {enemy_skill, terrain};雷伤走 mine_hit 不重复发) | kind、amount、source |
|
||||
| `boss_hp_threshold` | Boss 血量跌破阈值(unit_container.check_skill_unlocks 同点) | unit、pct |
|
||||
| `enemy_hp_threshold` | 敌人血量跌破其 unlock_hp_pct 阈值(unit_container.check_skill_unlocks 同点,开轮摇号前;**对所有带该字段的敌人逐个发射,非 Boss 专属**——Boss 语义留给订阅者 when 判定) | unit、pct、is_boss |
|
||||
| `round_start` | 每轮开始 | round |
|
||||
| `flag_settle` | 轮末旗伤结算(轮末序:旗伤开单→AP结转→积层反打,顺序显式在发射代码) | flags_hit_all、flags_count |
|
||||
| `round_end` | 每轮结算收口 | round |
|
||||
| `reward_roll` | 格面资源掷定(摇号前权重合成层,luck_coin 迁移落点) | cell、polarity、weights |
|
||||
| `treasure_used` | 使用主动秘宝(use_treasure 受理面) | item_id、target |
|
||||
| (`curio_roll` 邻位)三选一候选生成现有钩位仅供**对拍观测**,不改发布面 | —— | —— |
|
||||
| `charge_full` | charge 积层到达上限的沿(patient_burst 触发点,v1.1 补入) | unit、layers |
|
||||
| (`curio_roll` 邻位)三选一候选生成现有钩位仅供**对拍观测**,不改发布面(观测行不计入发射点数) | —— | —— |
|
||||
|
||||
### 3.2 登记暂不做(3 个,发射点设计一行,随对应 06 内容批实施;R5 裁决)
|
||||
### 3.2 登记暂不做(4 个,发射点设计一行,随对应 06 内容批实施;R5 裁决 + Q6 裁决)
|
||||
|
||||
`curio_roll`(三选一候选生成时发布→服务「战利品鉴定」)/ `shop_purchase`(商店成交时发布→服务「符文重铸」)/ `gp_settle`(金币结算入账时发布→服务「贪婪契约」)。三者均系 06 在册二期件的前置,本批只在本文登记,不写发射代码。
|
||||
`curio_roll`(三选一候选生成时发布→服务「战利品鉴定」)/ `shop_purchase`(商店成交时发布→服务「符文重铸」)/ `gp_settle`(金币结算入账时发布→服务「贪婪契约」)/ `level_clear`(一张图清空兑付时发布,载荷含 round 与清图统计→服务后续内容批;**本批不写发射代码**——Q6 裁决:R5 原文有效,v1.0 §3.1 的实施行系起草越界,已删)。四者均系 06 在册内容件的前置,本批只在本文登记。
|
||||
|
||||
### 3.3 效果类型词汇表(16 个,解释器 switch 闭集)
|
||||
### 3.3 效果类型词汇表(定稿:19 行 23 个,解释器 switch 闭集;v1.0 计数「16」系勘误,v1.1 扩 `damage_mult`/`open_ticket` 两型)
|
||||
|
||||
| 效果类型 | 语义 | 收编的现状 |
|
||||
|---|---|---|
|
||||
| `add_ticket_rider` | 单据追加固定伤 | hero_attack_rider、venom_edge |
|
||||
| `modify_ticket` | 改写单据数值(改写窗口,按序施加) | clamp_modifier×3、roll_discount、nest_aura、hit_trade、armor_roll_rewrite |
|
||||
| `modify_ticket` | 改写单据数值(改写窗口,按序施加;窗口归属见 R2 澄清) | clamp_modifier×3、roll_discount、nest_aura、hit_trade、armor_roll_rewrite |
|
||||
| `damage_mult` | **伤害倍率修正(v1.1 新增)**:对指定来向伤害乘系数(乘法族,正负分桶) | nest_counter 的踩雷减半面(mine_hit_halve) |
|
||||
| `open_ticket` | **新建一张伤害单(v1.1 新增)**:从事件现场按通道开新单(attack/board_blast 等),与 add_ticket_rider(向已有单追加)相区分 | flag_burst 爆板(open_ticket(KIND_BOARD_BLAST))、war_banner 战旗轮末自开单 |
|
||||
| `attack_bonus` | 攻击力加值 | round_dig_bonus |
|
||||
| `attack_segments` | 攻击拆多段 | dig_count_segments(连珠矢) |
|
||||
| `yield_mult` | 开格产出乘区(正负分桶) | dig_yield_mult×3、terrain_dig_double(条件行) |
|
||||
| `spawn_spell` | 生成一次必中魔法矢 | first_dig_spell(条件行) |
|
||||
| `overflow` | 击杀溢出弹射 | kill_overflow |
|
||||
| `grant_material` | 掉落格面资源 | flag_resource、terrain_refund |
|
||||
| `grant_ap` | 给行动点 | ap_carry |
|
||||
| `grant_gp` / `bias_wallet` | 金币面 | luck_coin(经 reward_roll) |
|
||||
| `grant_ap` | 给行动点。**转移形态声明(v1.1)**:`mode:"transfer"`=轮末剩余 AP 转蓄力层(上限 3)**替代** RAP 转存并作废 cleared 口径——是转移非加法,不入加法族、按序单独施加 | ap_carry |
|
||||
| `grant_gp` / `bias_wallet` | 金币面(**本批无现状收编,预留型**;luck_coin 实际归 bias_rewards,见下行——v1.1 勘误) | —— |
|
||||
| `shield` | 减伤层 | charge_shield |
|
||||
| `spike` | 满层反打 | charge_spike |
|
||||
| `spike` | 满层反打 | charge_spike(触发事件=charge_full) |
|
||||
| `apply_status` | 授予状态(复用 status_effects.tres 词汇) | heavy_debuff |
|
||||
| `counter_add` / `counter_spend` | 计数器增减(重置点数据声明:round_start/round_end/level) | round_dig 计数、variant_counter、dig_charge 积点、nest_counter |
|
||||
| `counter_add` / `counter_spend` | 计数器增减(重置点数据声明:round_start/round_end/level) | round_dig 计数、variant_counter、dig_charge 积点(nest_counter 移出本行——其真身是减半+反打,见 damage_mult/open_ticket 两型,v1.1 勘误) |
|
||||
| `rewrite_board` | 改写棋盘格状态 | flag_neutralize |
|
||||
| `reveal_tiles` / `remove_mines` | 显影/移除(主动件既有通道合流) | mine_reveal、cell_removal |
|
||||
| `bias_rewards` / `refresh_pick` / `preview` | 抽取面 | reward_weight_bias、bonus_refresh、pick_refresh |
|
||||
| `reveal_tiles` / `remove_mines` / `refresh_pick` | 显影/移除/刷新(**主动件 kind 分发通道**,不经事件订阅——刷新是玩家主动动作,v1.1 澄清) | mine_reveal、cell_removal、pick_refresh |
|
||||
| `bias_rewards` / `preview` | 抽取面 | reward_weight_bias(=luck_coin 现行 effect_kinds,经 reward_roll)、bonus_refresh |
|
||||
|
||||
### 3.4 组合规则(5 条,效果类型的必填属性,解释器内置)
|
||||
### 3.4 组合规则(6 条,效果类型的必填属性,解释器内置)
|
||||
|
||||
| 规则 | 语义 | 适用 |
|
||||
|---|---|---|
|
||||
| 加法族 | 数值相加(可交换,顺序无关) | add_ticket_rider、attack_bonus、grant_*、counter_add、shield |
|
||||
| 乘法族 | 收集后一次施加(正负分桶) | yield_mult |
|
||||
| 加法族 | 数值相加(可交换,顺序无关) | add_ticket_rider、attack_bonus、grant_material、grant_ap(非 transfer)、counter_add、shield |
|
||||
| 乘法族 | 收集后一次施加(正负分桶) | yield_mult、damage_mult |
|
||||
| 任意真族 | 任一命中即生效 | spawn_spell、overflow、spike |
|
||||
| 按序改写族 | 收集→单点按声明序施加 | modify_ticket 及一切改写窗口效果 |
|
||||
| 按序消耗族 | 按订阅序消耗共享资源,耗尽即止、拒绝走 reason 通道 | counter_spend |
|
||||
| 按序消耗族 | 按订阅序消耗共享资源,耗尽即止、拒绝走 reason 通道;**可选声明 `fallback`**(v1.1):资源不足时改付声明的基础对价(deep_drill 降级面——AP 富余付全价积计数、不足只付常规基础 1) | counter_spend |
|
||||
| 即时执行族 | 每条命中订阅各自执行一次,天然可叠加、执行序=声明序 | open_ticket、grant_ap(mode:transfer) |
|
||||
|
||||
## 四、数据行目标形态与 schema
|
||||
|
||||
@@ -100,7 +105,7 @@
|
||||
|
||||
- schema 校验照旧封闭且保留全部现有护栏:`on` ∈ 事件词汇、`do.kind` ∈ 效果词汇、`when.fact` ∈ fact 表、行键白名单、悬空引用加载致命、零裸 flat 禁令、流派扫雷触发点铁律(MINE_HOOKS 改为「每流派 ≥1 行订阅扫雷侧事件」同义校验)。
|
||||
- **存档零改动**:持有集/装备存 id 不变,换的只是解释方式——纯重构可对拍的前提。
|
||||
- fact 表(条件词汇,闭集 ~15):matchup、is_first_dig_of_level、terrain_kind、target_armor_class、flags_count、charge_layers、nest_count、round_index、counter 值等只读查询。
|
||||
- fact 表(条件词汇,**封闭枚举 9 项**,v1.0「~15 等」开放写法系勘误):`matchup`、`is_first_dig_of_battle`(**现行口径=每战首次开格**,begin_battle 归零——v1.0 的 `is_first_dig_of_level` 与现行语义相反,已随 provisional 定案改正)、`terrain_kind`、`target_armor_class`、`flags_count`、`charge_layers`、`nest_count`、`round_index`、`counter`(按 counter_id 取值)。T2 落码时若发现 9 项装不下现状条件,属闭集缺口——停机呈报补表,禁在行内私开 fact。
|
||||
|
||||
## 五、23 挂点逐行移植映射表(等价性对拍底单)
|
||||
|
||||
@@ -108,7 +113,7 @@
|
||||
|---|---|---|
|
||||
| hero_attack_rider | arcane_ember | on:attack_commit → add_ticket_rider |
|
||||
| clamp_modifier | mana_weaver / azure_oath / hunter_rapier(穿刺) | on:clamp_check + when(matchup) → modify_ticket |
|
||||
| first_dig_spell | mana_resonance | on:dig_reveal + when(is_first_dig_of_level) → spawn_spell |
|
||||
| first_dig_spell | mana_resonance | on:dig_reveal + when(is_first_dig_of_battle) → spawn_spell |
|
||||
| kill_overflow | pierce_shot | on:kill → overflow |
|
||||
| dig_count_segments | chain_arrows | on:dig_reveal→counter_add;on:attack_commit→attack_segments |
|
||||
| roll_discount | weak_instinct | on:clamp_check → modify_ticket(档位移) |
|
||||
@@ -117,46 +122,46 @@
|
||||
| armor_roll_rewrite | focus_mind | on:armor_roll → modify_ticket(免掷恒折扣) |
|
||||
| heavy_debuff | armor_crack | on:attack_commit + when(重甲) → apply_status |
|
||||
| dig_yield_mult | greedy_lantern / vein_intuition / gambler_pact | on:dig_reveal → yield_mult(乘法族) |
|
||||
| deep_dig | deep_drill | on:dig_paid → counter_spend(ap 对价) |
|
||||
| deep_dig | deep_drill | on:dig_paid + when(ap 富余) → counter_spend(对价,fallback=常规基础 1);深层产出配额=counter fact 条件(cap=4) |
|
||||
| flag_resource | mine_atlas | on:flag_hit → grant_material |
|
||||
| nest_aura | nest_hunter | on:attack_commit + fact(nest_count) → modify_ticket |
|
||||
| flag_all_hit | perfect_defense | on:flag_settle + when(全中) → yield_mult(旗伤乘区) |
|
||||
| flag_strike | war_banner | on:flag_settle → 开单(attack 通道) |
|
||||
| ap_carry | armory_prep | on:round_end → grant_ap |
|
||||
| flag_strike | war_banner | on:flag_settle → open_ticket(attack 通道)(v1.1 改:战旗是自开单,非向已有单追加) |
|
||||
| ap_carry | armory_prep | on:round_end → grant_ap(mode:transfer)(转蓄力层上限 3、替代 RAP 转存——转移非加法,v1.1 改) |
|
||||
| charge_shield | iron_wall | on:damage_taken + fact(charge_layers) → shield |
|
||||
| charge_spike | patient_burst | on:charge 满层沿 → spike |
|
||||
| charge_spike | patient_burst | on:charge_full(满层沿)→ spike(v1.1 改:charge 事件原不在词汇表,已补入) |
|
||||
| terrain_refund | ley_harvest | on:damage_taken(kind=terrain) → grant_material |
|
||||
| terrain_dig_double | thorn_weaver | on:dig_reveal + when(伤害型地形) → yield_mult(×2) |
|
||||
| flag_neutralize | purge_sapper | on:flag_hit + when(邻伤害地形) → rewrite_board |
|
||||
| variant_counter | magma_body | on:damage_taken→counter_add;on:round_end→counter_spend 反打 |
|
||||
|
||||
秘宝侧六件:venom_edge(attack_commit→add_ticket_rider)、luck_coin(reward_roll→bias_wallet)、dawn_order(round_start→grant_ap 队列)、dig_charge(dig_reveal→counter_add + dig_paid→counter_spend)、nest_counter(damage_taken→counter_add + 反打)、flag_burst(flag_hit→burst);pick_refresh(curio_pick 面→refresh_pick)。
|
||||
秘宝侧六件:venom_edge(attack_commit→add_ticket_rider)、luck_coin(reward_roll→**bias_rewards**,现行 effect_kinds=reward_weight_bias;v1.1 勘误:原误归 bias_wallet)、dawn_order(round_start→grant_ap 队列)、dig_charge(dig_reveal→counter_add + dig_paid→counter_spend)、nest_counter(mine_hit→damage_mult(0.5) 减半 + open_ticket(reflect 通道) 反打——v1.1 改:原 counter_add 归类与现状不符,现实现无计数器)、flag_burst(flag_hit→open_ticket(board_blast));pick_refresh(**主动件 kind 分发→refresh_pick,不经事件订阅**)。
|
||||
|
||||
## 六、任务卡(T0-T7 ≈4.5d,软时间盒超限 L3 呈报切点)
|
||||
|
||||
| 卡 | 内容 | 估时 |
|
||||
|---|---|---|
|
||||
| T0 | 开工三查:worktree+基线复读(冒烟/探针/run_all/MC 对拍锚)+git status 归属核对(在飞 mapdmg/standee/uialign 只标旗不碰) | 0.25d |
|
||||
| T1 | EffectEngine 框架:事件枚举+发射点 17 处埋点+订阅装载(开局从持有集/装备集构建 trigger 列表)+组合规则+改写窗口+计数器账本+确定性声明序 | 1.0d |
|
||||
| T1 | EffectEngine 框架:事件枚举+发射点 16 处埋点+订阅装载(**重建时机(v1.1 补)=每战 begin_battle 从持有集/装备集重建 trigger 列表**——冒险中途获得/换取的专长下一战生效,同战内不热载,确定性优先)+组合规则+改写窗口+计数器账本+确定性声明序 | 1.0d |
|
||||
| T2 | 词汇表落码:schema 换代(feats/treasure 两表 trigger 形态+校验规则换代+fact 表)+护栏迁移(MINE_HOOKS 同义校验等) | 0.5d |
|
||||
| T3 | 专长迁移:27 行数据改写(§五映射表逐行)+旧枚举删除+_feat_flags_for 退役+消费点 24 处拆除+文案入表(battle_narrator 两处) | 1.25d |
|
||||
| T3 | 专长迁移:27 行数据改写(§五映射表逐行)+旧枚举删除+_feat_flags_for 退役+消费点拆除(**口径=研究文档的 23 个消费点,v1.0「24 处」系勘误;执行时逐处 grep 清点对账**)+文案入表(battle_narrator.gd:142 一处;v1.0「两处」系与 T4 重复计数)+**断言面随迁(v1.1 补)**:smoke_all 直呼断言(含「27 件」计数断言与 _feat_flags_for/HOOKS 直呼)与 damage_math_test 6 处 hook 引用同步改写,不列修断言工作项即开工=必红 | 1.25d |
|
||||
| T4 | 秘宝迁移:六件被动+dig_charge 特判+主动件 kind 分发合流+luck_coin 经 reward_roll+curio_interact_controller 文案入表 | 0.75d |
|
||||
| T5 | 令牌/树收尾:_apply_curio_pick match 收敛进效果类型+meta_tree 规则键走同面 | 0.5d |
|
||||
| T6 | 回归闸:MC 对拍现行锚逐位一致+七流派成型画像重锚同带+冒烟+run_all+探针+确定性复放 | 0.5d |
|
||||
| T6 | 回归闸(**对拍判据两套,v1.1 落文(Q7 裁决)**:①确定性复放与冒烟断言=**逐位一致**;②MC 统计量(通关率/画像)=**成型画像同带**——统计量无「逐位」可言,禁混用。锚口径正主=`design/qa/m4iter12-t7-batch1-readings-2026-10-04.md`(runsum 锚、seed0=90000、N=20、off/formed 配对、L1 通关率判读带),T0 按该口径自采 pre 锚留盘、T6 采 post 锚配对)+冒烟+run_all+探针+确定性复放 | 0.5d |
|
||||
| T7 | 文档正主换代+出口报告:奇物.md/秘宝.md/敌人系统.md 词汇换代+registry 条目+06 状态收口+退出人闸材料包 | 0.25d |
|
||||
|
||||
## 七、契约红线(🔴 违反即停机呈报)
|
||||
|
||||
1. **存档零破坏**:存档键/存档格式/断点结构一字不改;换的只是运行时解释方式。
|
||||
2. **数值等价**:迁移前后行为逐位等价——MC 对拍锚逐位一致是硬闸;发现必要偏差(如旧实现 bug 被顺带修正)必须停机呈报,禁静默吸收。
|
||||
2. **数值等价**:迁移前后行为等价——判据两套(T6/v1.1):确定性复放与冒烟断言逐位一致;MC 统计量同带(m4iter12 口径)。发现必要偏差(如旧实现 bug 被顺带修正)必须停机呈报,禁静默吸收。
|
||||
3. **确定性**:全同步调用、无队列无异步无 signal 时序依赖;遍历序=数据声明序。
|
||||
4. **护栏保留**:封闭枚举校验/键白名单/悬空引用致命/零裸 flat 禁令/流派扫雷触发铁律全部以新形态延续,禁以「数据驱动」名义放开任何护栏。
|
||||
5. **battle_orchestrator 历史脏件**:全程 worktree 批、主区禁直改;并行在飞三线(mapdmg/standee/uialign)只标旗不碰,T0 重取基线。
|
||||
|
||||
## 八、停机点与验证闸
|
||||
|
||||
- **S1**(T3 段末):首个流派(魔法流)迁移完跑 MC 对拍——若逐位不一致且定位超出映射表误差,停机呈报。
|
||||
- **S2**(T6):对拍锚不一致/成型画像越带/冒烟红——任一命中停机,禁带病合并。
|
||||
- **S1**(T3 段末):首个流派(魔法流)迁移完跑对拍——若确定性复放非逐位一致且定位超出映射表误差,停机呈报。
|
||||
- **S2**(T6):确定性复放不一致/成型画像越带/冒烟红——任一命中停机,禁带病合并。
|
||||
- 验证闸:冒烟全量+run_all 全套+五探针+MC 对拍+确定性复放(同种子两次逐位一致)。
|
||||
- 代拍板白名单:事件载荷字段命名、fact 表个别查询面落法、smoke 断言数漂移追认、发射点微调(±1 处)。
|
||||
- 呈报不停机级:文案措辞、注释层、台账撞号顺延。
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
# 任务书:敌人表行集多行批(v1.0 定稿,待发令开工)
|
||||
# 任务书:敌人表行集多行批(v1.1 定稿,零待裁点,开工门=U0 用户发令)
|
||||
|
||||
> 成文 2026-10-05。**性质**:数据表校验与生成机制放开 + 配套呈现适配,允许同一场遭遇混编多种敌人。
|
||||
> 成文 2026-10-05,v1.1 修订 2026-10-06(五任务书联审:P3 改裁丙撤投放、P1 补遭遇骰机制与实例总数语义、F2/F5/F7 事实勘误、套件数与头注换代、expect_pools 与行序契约补列)。
|
||||
> **性质**:数据表校验与生成机制放开 + 配套呈现适配,允许同一场遭遇混编多种敌人。
|
||||
> 事实源 = [06-待办清单](../gdd/06-待办清单.md)「同深度第二敌种与精英 / Boss 编码位」条剩余面(该条前半「同层多遭遇」已由关卡节点地图 v1.0 节点编号升级消解,剩余即本卡);设计权威 = [敌人系统](../gdd/systems/战斗循环/敌人系统.md) v0.13(技能池执行批已落籍,Boss 半血解锁技已入表)。
|
||||
> 归属迭代:**迭代 17 · 卡①**(迭代 17 四卡:①本批 ②M4 数值批 ③暂停层只读入口批 ④生涯界面设计立项)。
|
||||
> 归属迭代:**迭代 17 · 卡①**(迭代 17 现=卡⓪数据驱动扩展批+①本批+③暂停层只读入口批+④生涯界面设计立项;M4 数值批已移迭代 18,roadmap 现行口径)。
|
||||
> 满足 loop engineering 八件(见 §9 逐条对照)。
|
||||
> 开工门:**已解**——前置「技能池实施批落地」已于 2026-10-05 完成(技能池执行批合并进 master,提交 d3fa887,冒烟 772/0)。
|
||||
|
||||
@@ -21,7 +22,7 @@
|
||||
| 1 | 校验放开 | 敌人表同一行集配两种以上敌人不再触发加载期致命错误;新的行集构成纪律(§5 R2 的具体条款,先随 P1/P4 裁决落文再落码)由加载期校验兜底 |
|
||||
| 2 | 生成链接通 | 混编行集开战后,各敌种按裁决后的数量语义(P1)实例化上场,各自实例池独立摇号;固定顺位、死亡顺延、范围效果全体现行语义不破 |
|
||||
| 3 | 零内容期零漂移 | 在未投放任何混编行的表状态下,MC 与冒烟数值断言对基线**逐位一致**(机制放开但表内容不变 = 行为必须不变) |
|
||||
| 4 | 重闸全绿 | 冒烟全量(基线数字 T0 重测回填,禁止沿用本文历史数字)· run_all 十五套件 · 场景探针(触呈现加 ui_struct_probe / ui_click_probe / ui_layout_probe)· doc 三闸对基线零新增 · 熵增闸 PASS |
|
||||
| 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 必须重测基线取实际值回填,禁止把本文数字当闸门。
|
||||
@@ -31,12 +32,12 @@
|
||||
| # | 事实 | 读数 |
|
||||
|---|---|---|
|
||||
| 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 拍板),是全部生产消费面入口。两函数都**只返回单行** |
|
||||
| F2 | 行集解析双算法共存 | ①`EnemyTable.resolve_rowset`(`enemy_table.gd:121-132`)= **floor 语义**(取 ≤ 请求坐标的最近行),仅 `smoke_all.gd:3452/3454/3484/3487` 四处使用(v1.0 行号 3383/3385/3415/3418 系起草后漂移,2026-10-06 复核);②`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`(双表精确行契约断言) |
|
||||
| F5 | 其余消费点 | `battle_orchestrator.gd:225`(战前预取行 erow_pre;v1.0 写 220 系漂移,2026-10-06 复核)· `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 敌种(地精/熊地精/食人魔酋长/巨蜘蛛/蛛化卓尔精灵/灰矮人/钩爪恐魔/灰矮人石君王),现行每行集恰一行 |
|
||||
| F7 | 表内容现状 | `enemy.tres` 共 **19 行、9 敌种**(地精/熊地精/霍布地精/食人魔酋长/巨蜘蛛/蛛化卓尔精灵/灰矮人/钩爪恐魔/灰矮人石君王;v1.0 写「21 行 8 敌种」系事实错误,漏霍布地精,2026-10-06 复核 `grep -c '"enemy_id"'`=19,冒烟断言文案自证「十九行」),现行每行集恰一行 |
|
||||
| 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 该句前提描述须随批修订 |
|
||||
@@ -66,14 +67,14 @@
|
||||
| 文件 | 改动 |
|
||||
|---|---|
|
||||
| `unit_container.gd` | `spawn()` 改受理行集:逐行按各自数量语义实例化,行主序生成序保持(`default_target` 固定顺位语义自然兼容);实例池快照逐行独立(现行逐实例快照逻辑天然兼容);数量域守卫改为行集级(上限随 P1) |
|
||||
| `battle_orchestrator.gd:220` | 战前预取改行集形态 |
|
||||
| `battle_orchestrator.gd:225` | 战前预取改行集形态 |
|
||||
| `battle_narrator.gd:75` | 叙述取敌种改行集形态(混编遭遇的开战叙述口径——逐种列名还是取首种,随批定,属呈现文案) |
|
||||
|
||||
### 组 D · 断言与探针
|
||||
|
||||
| 文件 | 改动 |
|
||||
|---|---|
|
||||
| `smoke_all.gd` | 行集结构断言换代:「行集恰一敌种」相关断言(:2900 注释口径、L2/L3 定点行集断言 :3383-3420 等)改断言新构成纪律;「双表精确行契约」断言改「精确行集」口径;新增混编正反断言(违规构成定位到类别) |
|
||||
| `smoke_all.gd` | 行集结构断言换代:「行集恰一敌种」相关断言(:2900 注释口径、L2/L3 定点行集断言 :3452-3487 段等)改断言新构成纪律;「双表精确行契约」断言改「精确行集」口径;**expect_pools 逐坐标池模板断言(:2973-2996)换代**——现行按 `"L_D"` 键每坐标一池精确比对,同坐标第二行即红,须改 `(L,D,enemy_id)` 键口径,且「十九行池模板」等文案随 F7 换代(v1.1 补列,原漏);新增混编正反断言(违规构成定位到类别) |
|
||||
| `config_db_test.gd:59-61` | 同通道断言换代 |
|
||||
| `skill_rhythm_probe.gd` / `damage_probe.gd` | 取数面随行集形态适配(行为零变更期逐位一致是验收条件) |
|
||||
|
||||
@@ -82,10 +83,10 @@
|
||||
| 禁项 | 理由 |
|
||||
|---|---|
|
||||
| **零混编内容期行为零漂移** | 本批的默认形态 = 机制放开 + 表内容不变。P3 若裁「本批投放首个混编行」,投放行本身属内容变更,须单独 MC 取证(先推算后重跑铁规:跑批发起前须用户批准) |
|
||||
| **不改遭遇骰/数量骰随机流** | 敌人系统零随机纪律与 RNG 单点红线不变;混编的数量语义若需新摇号,必须走既有封闭流扩签并先经用户裁决(列入 P1 子项) |
|
||||
| **不改遭遇骰/数量骰随机流** | 敌人系统零随机纪律与 RNG 单点红线不变;P1 已裁混编需新摇号(每行一骰),必须走既有封闭流扩签并先经用户批准(P1 裁决补充段已含此门) |
|
||||
| **不改键结构与存档** | `(L,D,enemy_id)` 键、断点存档、跨局存档零触碰 |
|
||||
| **不设精英/Boss 编码位** | 06 条目已裁「不设精英 / Boss 编码位」(精英 P2 内容承载),本批不重开 |
|
||||
| **技能池构成纪律不动** | 每池恰一普攻、增益 ≤1、unlock_hp_pct 投放纪律(仅 Boss 行)原样 |
|
||||
| **技能池构成纪律不动** | 每池恰一普攻、增益 ≤1、unlock_hp_pct 投放纪律(仅 Boss 行)原样。**知悉(v1.1)**:「原样」实为无硬闸——`enemy_table.gd:94-95` 注释明写纪律系文档登记非校验;P4 乙放开 Boss 多行后,「Boss 行带 unlock_hp_pct 可静默过校验」的无闸面随之扩大,后续内容批投放 Boss 多行时须逐行人工复核此面 |
|
||||
| **数值零触碰** | hp/atk/unit_count/权重行值一律不动(P3 投新行除外,且新行行值 provisional 归调参) |
|
||||
|
||||
## 5. 设计契约(🔴 触碰 = L3 停机)
|
||||
@@ -97,6 +98,7 @@
|
||||
| 🔴 R3 | **fail-fast 语义保持**:行集构成违例仍加载期致命中止,错误类别可定位;禁软回退 | 组 D 正反断言 |
|
||||
| 🔴 R4 | **RNG 单点**:不新增 `randomize()`/自建随机源;如需新摇号点一律经 RngService 封闭流并先报批 | 静态审查 + rng 日志比对 |
|
||||
| 🔴 R5 | **双表精确行契约不破**:board_gen × enemy 同坐标覆盖义务(`smoke_all.gd:294-311`)在混编口径下仍成立 | 组 D 断言换代后全绿 |
|
||||
| 🔴 R6 | **混编行文件行序纪律(v1.1 补)**:同一 (L,D) 的多行在表文件内必须相邻且行序=声明序=生成序——resolver 返回序、battle_narrator 取首行叙述、expect_pools 断言、spawn 行主序全部依赖文件行序,行序即契约 | 组 B 校验(同坐标行不相邻即报错)+ 组 D 断言 |
|
||||
|
||||
## 6. 任务卡(逐卡一个 loop 轮次)
|
||||
|
||||
@@ -106,19 +108,19 @@
|
||||
| **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 |
|
||||
| **T4** | 组 D:smoke/单测/探针断言面换代 + 新增混编构成断言 | 0.5d | 冒烟 + run_all | 十七套件绿;新断言负向验证红(故意配违规行集能抓到) |
|
||||
| **T5** | (条件卡,**P3 二裁丙=本批不触发,不执行**——投放连同 Boss 多行归后续内容批,该批开工时按本卡口径执行+MC 取证先报批+难度带读数义务) | 0.5d | — | — |
|
||||
| **T6** | 重闸:全量轻闸 + doc 三闸 + 熵增闸 + MC 逐项比对(零内容期——本批唯一 MC 面;先报批) | 0.5d | 重闸全绿 | §1.2 判定 3/4 |
|
||||
| **T7** | 人闸:目检清单(T5 执行时含混编遭遇实机目检)+ 代拍板追认 | 0.5d | 目检过 | §1.2 判定 5 |
|
||||
| **T8** | 收口五步(active.md 快照 → 工作日志 → roadmap 迭代 17 行标注 → 06 收口 → 闸序列留痕) | 0.25d | — | 收口五步齐 |
|
||||
|
||||
> 估时合计 ≈ **4.25d**(含 T5)/ **3.75d**(不含 T5),超 roadmap 软时间盒 3 日上限——知情预挂:T4 后按 L3 呈报切点,不擅切(沿迭代 9/秘宝批先例)。
|
||||
> 估时合计 ≈ **3.75d**(T5 撤投放后全批;v1.0「含 T5 4.25d」口径随 P3 改裁作废),超 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 投放行属数值验证场景,同样先报批。两入口铁规全程有效。
|
||||
- **MC 触发**:零内容期对拍属「结构位移类存档锚」,**发起前先向用户请示定性**(CLAUDE.md MC 触发细则);T5 本批不触发(P3 丙),后续内容批投放时属数值验证场景、同样先报批。两入口铁规全程有效。
|
||||
|
||||
## 8. 代拍板白名单与待用户裁点
|
||||
|
||||
@@ -131,11 +133,13 @@
|
||||
|
||||
### P1 · 混编数量语义
|
||||
|
||||
**✅ 裁决(2026-10-06 用户令):案甲**——每行各自 unit_count 独立实例化,行集总数上限另立 ≤4;UNIT_COUNT_MAX 语义改「单种数」随批换代校验与 spawn 守卫。
|
||||
**✅ 裁决(2026-10-06 用户令):案甲**——每行各自 unit_count 独立实例化;**行集实例总数(各行骰后数量求和)≤4**(Q9 二裁消歧:「总数」=实例数非行数,行数不另设上限);UNIT_COUNT_MAX 语义改「单种数」随批换代校验与 spawn 守卫。
|
||||
|
||||
**裁决补充·遭遇骰交互(Q8 二裁,v1.0 漏裁)**:混编行集落地后**每行各掷一次数量骰**(与「每行各自 unit_count」语义自洽),单一行集仍吃单个 `unit_count_override` 且仅作用于该行集整体传入值按行分配的现行路径不存在——override 命中时跳过行内掷骰直接取值;每行一骰=遭遇骰封闭流新增消费点,**实现前须按 R4 报批扩签**(随机流消费次数变化牵动全部种子面),未获批准前 T2/T3 不得落码。
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲(推荐) | 每行各自 `unit_count` 独立实例化,行集总数上限另立(如 ≤4);数量域 [1,3] 仍约束单行 | 表意最直白,作者按行写数即可;代价是 UNIT_COUNT_MAX 语义从「单场总数」改为「单种数」,须同步改校验与 spawn 守卫 |
|
||||
| 甲(推荐,已裁) | 每行各自 `unit_count` 独立实例化,行集实例总数上限 ≤4;数量域 [1,3] 仍约束单行 | 表意最直白,作者按行写数即可;代价是 UNIT_COUNT_MAX 语义从「单场总数」改为「单种数」,须同步改校验与 spawn 守卫 |
|
||||
| 乙 | 行集总数仍 ≤3,按行权重或行序分配各种只数 | 场上规模完全不变、数值面最稳;淘汰理由:分配规则本身是新的隐性机制,作者无法直接表达「我要 1 蜘蛛 + 2 地精」,表意失真 |
|
||||
| 丙 | 每种恒 1 只 | 最简;淘汰理由:混编的主要价值(强弱搭配的数量结构)被阉割,等于只允许「2-3 种各 1 只」一种形态 |
|
||||
|
||||
@@ -150,16 +154,17 @@
|
||||
|
||||
### P3 · 本批是否投放首个混编遭遇行
|
||||
|
||||
**✅ 裁决(2026-10-06 用户令):案乙**——投放教学位混编行(L2 普通节点:巨蜘蛛 1 + 钩爪恐魔 1,行值 provisional 归调参);MC 取证跑批发起前仍须用户批准(用户知情接受此门)。
|
||||
**✅ 改裁(2026-10-06 二裁,用户令,推翻一裁案乙):案丙(撤投放)**——本批回到纯结构批,混编行只建机制不投内容;首个混编遭遇行(连同 Boss 多行内容)归后续内容批统一投放。改裁依据(联审实据):一裁案乙的「巨蜘蛛 1+钩爪恐魔 1」与现行首遇教学位纪律正面冲突——巨蜘蛛首遇位 (2,4) 表注释与冒烟断言均为「固定 2 只不加骰」,投 1 只直接违反;钩爪恐魔真首遇位在 L3 (3,1) 固定不加骰,L2 投放使其名存实亡;且 L2 每个 battle 坐标都有断言撞面((2,0) 撞首遇绿档 12 种子扫描、(2,4) 撞固定 2 断言、(2,5/6/7) 撞 expect_pools 精确池),一裁「L2 某普通节点」无可落地坐标。投放义务随批登记 07(后续内容批连同 Boss 多行一起投、投时 MC 取证先报批、难度带读数义务同登记)。
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲 | 本批只放开机制、零内容投放;首个混编遭遇归后续难度曲线/内容批 | 机制批零数值变更,MC 零跑或仅零扰动对拍,批面最干净 |
|
||||
| 乙(推荐) | 本批顺带投放一个教学位混编行(候选:L2 某普通战斗节点,巨蜘蛛 1 + 钩爪恐魔 1,行值 provisional 归调参) | 机制没有内容验证等于没验收;一个定点行即覆盖全链(生成/叙述/结算/胜利);代价是需 MC 取证(先报批)与行值 provisional 登记 |
|
||||
| 甲 | 本批只放开机制、零内容投放;首个混编遭遇归后续难度曲线/内容批 | 与丙同向但未点名承接批,义务易悬空 |
|
||||
| 乙(一裁,已推翻) | 本批顺带投放教学位混编行(L2 某普通节点,巨蜘蛛 1 + 钩爪恐魔 1,行值 provisional) | 推翻理由见上:与首遇教学位纪律/表注释/冒烟断言三面冲突,无合法坐标 |
|
||||
| 丙(二裁,生效) | 撤投放,纯结构批;混编行内容归后续内容批(与 Boss 多行同批),投放时 MC 取证先报批 + 难度带读数义务随批登记 07 | 机制批零数值变更零 MC;投放的教学价值不抵三面断言/纪律/读数连带代价 |
|
||||
|
||||
### P4 · Boss 行集是否允许多行
|
||||
|
||||
**✅ 裁决(2026-10-06 用户令):案乙(否决推荐案甲)**——Boss 行集校验同样放开(多行合法)。知情代价随批登记:Boss 半血解锁/独占技/难度带读数面自此可被 Boss 行内容变量影响;**本批零内容投放不变**(P3 乙教学位行在普通节点),Boss 多行的实际内容投放归后续内容批,投放时节奏重测义务在册(07 T7)。
|
||||
**✅ 裁决(2026-10-06 用户令):案乙(否决推荐案甲)**——Boss 行集校验同样放开(多行合法)。知情代价随批登记:Boss 半血解锁/独占技/难度带读数面自此可被 Boss 行内容变量影响;**另有两个具体读数面(v1.1 补列)**:①`battle_narrator.gd:70-77` `boss_name()` 取行集**首个命中行**的 display_name——Boss 行集多行后 Boss 名显示可能变成护卫名(取决于文件行序,R6 纪律的呈现面后果);②Boss 节点遭遇骰同样读首行 `unit_count` 区间(`battle_orchestrator.gd:225`),多行后首行区间即全行集骰域。**本批零内容投放不变**(P3 已改裁丙=撤投放),Boss 多行的实际内容投放归后续内容批,投放时节奏重测义务 07 在册、上述读数面逐项复核。
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
@@ -185,7 +190,7 @@
|
||||
|---|---|---|
|
||||
| **L1** | 单轮轻闸红 | 一次重试(自查漏改/调用点遗漏);仍红 → L2 |
|
||||
| **L2** | 同类错误连续 3 轮 / 事实表与 §2 不符 | 记录进本任务书与工作日志,修订事实表后继续;不阻断全批 |
|
||||
| **L3** | 任一 🔴 R1–R5 破 / P1–P4 久决不下 / 发现需要新增随机消费点或改存档 | 停机写报告(列事实 + 影响面 + 方案对比),等用户发令;不自行决断 |
|
||||
| **L3** | 任一 🔴 R1–R6 破 / P1–P4 久决不下 / 发现需要新增随机消费点或改存档 | 停机写报告(列事实 + 影响面 + 方案对比),等用户发令;不自行决断 |
|
||||
|
||||
## 11. 现状留痕(供执行会话读序)
|
||||
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
# 任务书:暂停层只读入口批(v1.0 定稿,待发令开工)
|
||||
# 任务书:暂停层只读入口批(v1.1 定稿,零待裁点,开工门=U0 用户发令)
|
||||
|
||||
> 成文 2026-10-05。**性质**:功能性 UI 交互新增——局内暂停层,承载钥石余额与营地柜台解锁进度的**只读**查看。
|
||||
> 成文 2026-10-05,v1.1 修订 2026-10-06(五任务书联审:R4 快照口径收敛、badge 工厂路径裁决〔Q10 甲〕、P1 丁的 06 Esc 登记补办、基线换代 iter16ui 批后、F5/F10 事实勘误、入口守卫与只读断言口径补列)。
|
||||
> **性质**:功能性 UI 交互新增——局内暂停层,承载钥石余额与营地柜台解锁进度的**只读**查看。
|
||||
> 事实源 = [06-待办清单](../gdd/06-待办清单.md)「解锁界面与钥石呈现的交互形态(残余:暂停层只读入口)」条。
|
||||
> 归属迭代:**迭代 17 · 卡③**(迭代 17 四卡:①敌人表行集多行批 ②M4 数值批 ③本批 ④生涯界面设计立项)。
|
||||
> 归属迭代:**迭代 17 · 卡③**(迭代 17 现=卡⓪数据驱动扩展批+①敌人表行集多行批+③本批+④生涯界面设计立项;M4 数值批已移迭代 18,roadmap 现行口径)。
|
||||
> 满足 loop engineering 八件(见 §9 逐条对照)。
|
||||
> **美术红线(2026-10-05 用户立规)**:本批不得包含观感类、素材类内容;呈现必须复用现行公共件(UiKit 工厂件)与 ui_kit 色板 token,**不新画任何素材、不新建任何色值**。功能性 UI 交互不算美术。
|
||||
|
||||
@@ -20,11 +21,11 @@
|
||||
|---|---|---|
|
||||
| 1 | 入口可达 | 局内两个主屏(战斗屏 / 关卡地图屏)均可按 P1 裁决的形态打开暂停层;入口在对局外(主菜单)不误出现 |
|
||||
| 2 | 只读数据正确 | 暂停层展示的钥石余额、三柜台进度与 `MetaProgression` 访问器读数逐项一致;无任何可点购买/切换控件 |
|
||||
| 3 | 公共件复用 | 全部构成件来自 UiKit 现行工厂(modal_shell / bcard / label / badge / icon_rect / verb_button 等)与色板 token;零新素材、零新色值、零新字体 |
|
||||
| 3 | 公共件复用 | 全部构成件来自 UiKit 工厂(modal_shell / bcard / label / icon_rect / verb_button 等)与色板 token;**badge 由本批在 ui_kit 新增工厂件并同步迁入营地钥石徽(Q10 甲裁决)**;零新素材、零新色值、零新字体 |
|
||||
| 4 | 模态纪律 | 登记进 modal_stack 登记册(main.gd:332 同款),z 序与输入锁行为符合缺陷⑤纪律;与既有弹窗层的关系按 P2 裁决落实 |
|
||||
| 5 | 重闸全绿 + 人闸 | 冒烟全量(基线 T0 重测回填)· run_all 十五套件 · ui_struct_probe / ui_click_probe / ui_input_probe 全绿 · doc 三闸零新增 · 熵增闸 PASS;实机目检清单过 |
|
||||
| 5 | 重闸全绿 + 人闸 | 冒烟全量(基线 T0 重测回填)· run_all 十七套件 · ui_struct_probe / ui_click_probe / ui_input_probe / ui_contrast_probe 全绿 · doc 三闸零新增 · 熵增闸 PASS;实机目检清单过 |
|
||||
|
||||
> ⚠️ **基线纪律**:起草时点 master 头 = 413c936,冒烟 772/0,run_all 14/15(reward_overlay_test 基线红归迭代 15②批,本批守零新增)。T0 重测回填。
|
||||
> ⚠️ **基线纪律(v1.1 换代)**:起草时点 master 头 = 413c936(冒烟 772/0);**v1.1 修订时点现行头 = ed38c54**,中间落了整个 iter16ui 批(12+ 提交触 ui_kit.gd,F3 行号全部漂移失效)+ M4 移批,现行基线读数=冒烟 782/0、run_all 17 套件、**ui_contrast_probe 已入 probe_gate 默认必跑段**(新增文字层必须过对比度机检)。§2 行号系 413c936 时点考证,T0 按现行 HEAD 重取回填,禁止沿用本文行号与数字。
|
||||
|
||||
## 2. 现状事实(代码级考证,2026-10-05 起草时点;T0 须自行复核)
|
||||
|
||||
@@ -32,14 +33,14 @@
|
||||
|---|---|---|
|
||||
| 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 / 烛光黄徽章形制等)同文件单点 |
|
||||
| F3 | 公共件清单 | `presentation/views/ui_kit.gd`:`modal_shell` · `verb_button`(图标+动词+tooltip 三件套)· `bcard`(BCard 竖卡:色带/图标槽/价签/底注参数化)· `switch_toggle` · `styled_slider` · label / icon_rect 等;色板 token(WARM / STONE / INK_ON_GOLD / CANDLE 等)同文件单点。**badge 工厂现状不存在(v1.1 勘误)**:营地钥石徽系 camp_overlay_view.gd:80-93 本地拼装(panel_flat+icon_rect+label)非公共件——处置=Q10 甲裁决,见 §3 组 A |
|
||||
| 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 条残余面的由来 |
|
||||
| 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` 实际在 `core/save_manager.gd:250`(v1.0 误记 meta_progression.gd,2026-10-06 勘误)**——暂停层只读消费,零核心层改动 |
|
||||
| F6 | 钥石呈现现状 | 营地屏顶栏钥石徽(camp_overlay_view.gd:80-93,烛光黄底+深墨字徽章形制,**本地拼装**——badge 工厂化后迁入 ui_kit)与结算屏入账明细已落地;**战斗屏内 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 层」形态是暂停层的最近先例,但门控与可达域不同(暂停层 = 玩家常态功能,对局内可达) |
|
||||
| F10 | 调试浮窗先例 | debug_overlay(**迭代 14.5 调试整合批,git 48c0b34**——v1.0 误记迭代 15①,2026-10-06 勘误)= 悬浮 Dialog 形态、DS_DEBUG 门控、仅开始菜单可开——其「角标入口 + Dialog 层」形态是暂停层的最近先例,但门控与可达域不同(暂停层 = 玩家常态功能,对局内可达) |
|
||||
|
||||
## 3. 改动清单(两组)
|
||||
|
||||
@@ -47,15 +48,16 @@
|
||||
|
||||
| 文件 | 改动 |
|
||||
|---|---|
|
||||
| `presentation/views/pause_overlay.gd`(新) | 只读覆盖层:标题区 + 钥石余额行(复用营地同款徽章形制:icon_rect(TEX_ICON_KEYSTONE) + label,色板 token 取现行值)+ 三柜台进度区(范围随 P3)+ 关闭钮;全部经 UiKit 工厂件拼装,零自绘 |
|
||||
| `presentation/views/ui_kit.gd` | **新增 badge 工厂件(Q10 甲裁决)**:钥石徽形制(icon_rect+label 徽章)参数化收编;营地钥石徽(camp_overlay_view.gd:80-93 本地拼装)同步迁入工厂调用,消单点重复——营地侧改动仅替换拼装为工厂调用,观感零变化 |
|
||||
| `presentation/views/pause_overlay.gd`(新) | 只读覆盖层:标题区 + 钥石余额行(badge 工厂件: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` | 暂停层结构断言(不出屏/零尺寸/按钮宽度)+ 打开关闭行为断言 + 只读性断言(层内无购买信号连接) |
|
||||
| 入口挂点(P1 已裁丁=**常驻角标**,Esc 不落码) | 战斗屏 HUD 与关卡地图屏各一角标(复用 debug 角标形制);**装配落点 T0 复核后在 ui_assembler / 两屏装配段中定点(白名单内决断)**;宽度纪律遵守 min_w=216 或申请豁免(角标类已有豁免先例)。**入口守卫(v1.1 补)**:其他模态(商店/三选一/营地/设置等)开启时角标置灰不可点(has_open 守卫)——iter16ui 后商店/三选一系全屏 page_shell 会盖住角标,守卫防「看得见点不着」态 |
|
||||
| `smoke/ui_struct_probe.gd` / `ui_click_probe.gd` / `ui_input_probe.gd` | 暂停层结构断言(不出屏/零尺寸/按钮宽度)+ 打开关闭行为断言 + 只读性断言(**口径(v1.1 补)=巡检层内控件的 signal 连接清单(get_signal_connection_list),断言无任何指向购买/解锁/写入路径的连接;巡检信号名清单 T2 落码时列全进探针**) |
|
||||
| `smoke_all.gd` | 数据一致性断言(暂停层投影 = MetaProgression 访问器读数) |
|
||||
|
||||
## 4. 范围边界(🔴 不可越界)
|
||||
@@ -76,8 +78,8 @@
|
||||
| 🔴 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 现行开关消费) | 探针双态断言 |
|
||||
| 🔴 R4 | **数据只读同源**:展示值一律实时读访问器;**快照口径(v1.1 收敛,原句先禁后允系起草矛盾)**——开层时预取快照仅允许在**单次开层生命周期**内使用,禁跨开层持有,采用快照时须在 T4 目检材料中披露口径(读哪几个访问器、何时取值) | 冒烟断言 |
|
||||
| 🔴 R5 | **减动效遵守**:P4 已裁零动效直开直关——本契约收敛为「**零动效路径存在断言**」(探针断言层进出无过渡动画节点/时长归零路径),减动效开关无新增消费 | 探针断言 |
|
||||
|
||||
## 6. 任务卡(逐卡一个 loop 轮次)
|
||||
|
||||
@@ -87,14 +89,14 @@
|
||||
| **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 |
|
||||
| **T4** | 人闸:实机目检清单(双屏入口/**其他模态开着时角标守卫态**/只读性/数据正确/零动效直开直关/**开层时排播队列排空副作用观察**〔_open_modal 开层前 _flush_row_queue 系既有层同款行为,与玩家「暂停」预期之差记入目检确认项〕/与设置面关系)+ 代拍板追认 | 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)。
|
||||
- **轻闸**(每轮):run_smoke 全量 + ui_input_probe + ui_struct_probe + **ui_contrast_probe(v1.1 补——已入 probe_gate 默认必跑段,本批新增文字层必须过对比度机检)**(本批触 presentation,三轮加 ui_click_probe + ui_layout_probe)。
|
||||
- **重闸**(T3):全量轻闸 + doc 三闸零新增 + 熵增闸。
|
||||
- **MC**:纯呈现批,零数值改动 → **零 MC**(两入口铁规 + 无数值改动禁跑 MC)。
|
||||
|
||||
@@ -109,7 +111,7 @@
|
||||
|
||||
### P1 · 暂停入口位置与唤起形态
|
||||
|
||||
**✅ 裁决(2026-10-06 用户令):案丁**——常驻角标为主入口,Esc 附加快捷通道登记 06 排期 Beta 随键盘批统一接。
|
||||
**✅ 裁决(2026-10-06 用户令):案丁**——常驻角标为主入口,Esc 附加快捷通道登记 06 排期 Beta 随键盘批统一接(**06 登记已于 2026-10-06 联审批补办落文**——v1.0 裁后未执行,属行政漏步;另注:该登记同时使 06 键盘条目「弹层界面现行全鼠标」清单 +1 项,属本批连带披露)。
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
# 任务书:生涯界面设计立项(v1.0 设计提纲版,只做设计不做实装)
|
||||
# 任务书:生涯界面设计立项(v1.1 设计提纲版,零待裁点,开工门=U0 用户发令)
|
||||
|
||||
> 成文 2026-10-05。**性质**:纯设计批——产出「生涯」界面的设计提纲(信息架构 + 承载内容清单 + 与既有界面的关系 + 分期实装建议 + 待裁点),**本批零实装、零代码、零数据面改动**。
|
||||
> 成文 2026-10-05,v1.1 修订 2026-10-06(五任务书联审:F4 事实改正——recent_summaries 现役在存、P2 甲口径重述〔Q5 甲〕、总局数/通关局数标注涉存档 schema、营地既有最近冒险清单列入设计稿必答项、N 候选补「维持 10」、文件名与行号勘误、UiKit 对齐与 save v6 义务补登记)。
|
||||
> **性质**:纯设计批——产出「生涯」界面的设计提纲(信息架构 + 承载内容清单 + 与既有界面的关系 + 分期实装建议 + 待裁点),**本批零实装、零代码、零数据面改动**。
|
||||
> 事实源 = [06-待办清单](../gdd/06-待办清单.md)「『生涯』界面——冒险中数据回看的唯一承接处」条(2026-10-04 用户裁决 P-C7:冒险中不给数据回看,历史战报/结算明细的查看去向 = 新「生涯」界面;生涯未做前冒险中无历史回看入口 = 已知代价,用户知情裁决)。
|
||||
> 归属迭代:**迭代 17 · 卡④**(迭代 17 四卡:①敌人表行集多行批 ②M4 数值批 ③暂停层只读入口批 ④本批)。
|
||||
> 归属迭代:**迭代 17 · 卡④**(迭代 17 现=卡⓪数据驱动扩展批+①敌人表行集多行批+③暂停层只读入口批+④本批;M4 数值批已移迭代 18,roadmap 现行口径)。
|
||||
> **实装批另行立项**:本任务书只交付设计提纲文档与裁点呈报;任何实装(数据面/界面/存档域)须用户审毕提纲后另行发令立项。
|
||||
> 满足 loop engineering 八件(按设计批形态适配,见 §9 逐条对照)。
|
||||
|
||||
@@ -28,14 +29,14 @@
|
||||
|
||||
| # | 事实 | 读数 |
|
||||
|---|---|---|
|
||||
| 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 登记」 |
|
||||
| F1 | 冒险中回看已退役 | M9(P-C7 裁)落码:`battle_end_overlay.gd:106` 明细回看钮退役(v1.0 写 :90 系漂移,:90 现为 GP 账目行;signal 退役注记在 :9)、`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)只做入账(钥石余额累加、工坊解锁刷新、通关计数),**每局摘要不留痕**——历史冒险回看需要新建数据面(每局摘要的持久化域),这是本设计提纲最大的数据设计题 |
|
||||
| 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` / **`recent_summaries`**(save_manager.gd:39 schema 注记 + meta_progression.gd 访问器面;v1.0 键集漏列 recent_summaries,v1.1 补) |
|
||||
| F4 | ⚠️ **历史冒险记录面现状(v1.1 事实改正——v1.0 误记「无历史冒险记录面」)** | **`recent_summaries` 现役在存**:`save_manager.gd:40` `const SUMMARY_CAP := 10`(注释「最近冒险摘要保留条数(最新在前)」)、`:325-338` `apply_adventure_summary()` 逐局 push_front 归档(附 boss_drops 副本)、`:316` `recent_summaries()` 访问器;`settle_adventure()`(meta_progression.gd:129)**经** `apply_adventure_summary` 留痕(:125 注记「keystone_drops 副本随摘要入 recent_summaries」);registry entities.yaml:73 meta 域九件明列。**真实缺口只有三件**:①cap 10→N 扩容(P2 甲);②摘要五件事(结局/到达关卡/钥石合计/种子)**无「用时」字段**——全仓 grep elapsed/ticks/duration 零采集点,补用时=新增埋点;③**冒险总局数/通关局数无 lifetime 计数域**(`first_adventure_done` 是布尔、`level_clear_counts` 按关计次反推不出局数、cap 10 摘要不能累 lifetime)——总局数/通关局数须新增计数域,**涉存档 schema(save v6 迁移义务)**,归期一实装批 |
|
||||
| F5 | 当局结算呈现仍在 | 冒险收束时结算屏入账明细(钥石 +N、新解锁)现行保留——退役的只是「局后任意时刻回看」,不是收束当下 |
|
||||
| F6 | 跨局汇总数据源现成 | 总通关次数(level_clear_counts 按关)、Boss 首杀/总击杀、钥石余额与累计流(余额在,累计收支无流水)、锻造/工坊/天赋树解锁态——「跨局汇总」页大部分字段可直接读访问器,零新数据面 |
|
||||
| F6 | 跨局汇总数据源现状 | 总通关次数(level_clear_counts 按关)、Boss 首杀/总击杀、钥石余额与累计流(余额在,累计收支无流水)、锻造/工坊/天赋树解锁态——大半字段可直接读访问器;**「冒险总局数 / 通关局数」两格无数据源(v1.1 勘误——v1.0 误标「全现成·零新数据面」)**:须新增 lifetime 计数域,涉存档 schema,见 F4③ |
|
||||
| F7 | 图鉴承接的候选内容 | 06 在册相关条目:「敌方技能图鉴 / 学习呈现」(P2,见过→认得→记谱);奖励格图鉴柜台空置(2026-10-04 配比预设批裁决该柜台承接配比容量,后随配比预设整体挂起——柜台仍空);秘宝/奇物均无图鉴面 |
|
||||
| F8 | 相邻界面分工现状 | 营地 = 跨局成长**操作**面(花钥石买强化);主菜单 = 入口面(新冒险/继续上局/营地/设置/调试);设置面 = 环境开关;教学「帮助」手册(Beta 批初裁:全部内容放一个文档,未实装);暂停层(迭代 17 卡③)= 局内只读查看钥石与解锁进度 |
|
||||
| F8 | 相邻界面分工现状 | 营地 = 跨局成长**操作**面(花钥石买强化)**+ 既有只读「最近冒险」清单**(camp_overlay_view.gd:431 `_rebuild_recent()` 渲染逐局「完成/放弃/失败 · 通关 N 关 · 钥石 +N · 种子 N」,camp_shop_presenter.gd:85 投影 `"recent"`——生涯期二落地后此清单去留/迁移/去重是设计稿必答项,v1.1 补);主菜单 = 入口面(新冒险/继续上局/营地/设置/调试);设置面 = 环境开关;教学「帮助」手册(Beta 批初裁:全部内容放一个文档,未实装);暂停层(迭代 17 卡③)= 局内只读查看钥石与解锁进度 |
|
||||
| F9 | 06 条目原文口径 | 「跨局汇总 / 历史冒险回看 / 图鉴承接」三段内容清单是 06 条目给定骨架,本提纲在其上展开,不另起炉灶 |
|
||||
| F10 | 阶段语境 | 教学引导五条目已整体改排 Beta(2026-10-04 拍板);生涯未标阶段——分期建议须回答「生涯第几期落在 Alpha 后哪个窗口」 |
|
||||
|
||||
@@ -61,15 +62,15 @@
|
||||
|
||||
| 段 | 内容 | 数据源 | 可行性 |
|
||||
|---|---|---|---|
|
||||
| 跨局汇总 | 冒险总局数 / 通关局数 / 各关通关次数 / Boss 首杀与总击杀 / 钥石余额(累计收支流水可选)/ 三柜台解锁完成度概览 | F6 全现成(除累计流水) | **期一即可做,零新数据面**(累计流水若做需补记账点,随 P2) |
|
||||
| 历史冒险回看 | 逐局摘要:第 N 局、结局(通关/失败/放弃)、走到哪、钥石收入、关键构筑(可选);单局结算明细回看(复活 settlement_review 承载) | F4 **需新建数据面**(每局摘要持久化) | **期二**,数据面范围是最大裁点(P2) |
|
||||
| 图鉴承接 | 敌人图鉴(06 在册 P2 条目承接:见过→认得→记谱)/ 秘宝图鉴 / 奇物图鉴 / 奖励格图鉴(空置柜台) | 逐类立「见过」记账面 | **期三**,范围与顺序随 P3 |
|
||||
| 跨局汇总 | 冒险总局数 / 通关局数 / 各关通关次数 / Boss 首杀与总击杀 / 钥石余额(累计收支流水可选)/ 三柜台解锁完成度概览 | F6 大半现成;**总局数/通关局数两格需新增 lifetime 计数域(涉存档 schema,F4③)** | 期一可做,但**非「零新数据面」**——两个计数域随期一实装批走 save v6 迁移(v1.1 勘误) |
|
||||
| 历史冒险回看 | 逐局摘要:第 N 局、结局(通关/失败/放弃)、走到哪、钥石收入、关键构筑(可选)、用时;单局结算明细回看(复活 settlement_review 承接) | **F4 现役 recent_summaries(cap 10)+ 扩容 N + 补用时埋点(P2 甲口径重述)** | **期二**,数据面改动=扩容+加字段+迁移旧档摘要(P2) |
|
||||
| 图鉴承接 | 敌人图鉴(06 在册 P2 条目承接:见过→认得→记谱)/ 秘宝图鉴 / 奇物图鉴 / 奖励格图鉴(空置柜台) | 逐类立「见过」记账面=**新增 meta 域,涉存档 schema(save v6 迁移义务,v1.1 补)** | **期三**,范围与顺序随 P3 |
|
||||
|
||||
### 3.3 与既有界面的关系(分工一句话矩阵)
|
||||
|
||||
| 界面 | 管什么 | 与生涯的边界 |
|
||||
|---|---|---|
|
||||
| 营地 | 跨局成长的**操作**(买/装配/点树) | 营地不改生涯只读定位;生涯不做任何购买入口,「去买」按钮也不放(跳转型入口随 P4) |
|
||||
| 营地 | 跨局成长的**操作**(买/装配/点树)+ 既有只读「最近冒险」清单(F8) | 营地不改生涯只读定位;生涯不做任何购买入口,「去买」按钮也不放(跳转型入口随 P4);**营地「最近冒险」清单的去留/迁移/去重是设计稿必答项(v1.1 补)**——期二落地后两处逐局列表并存还是营地侧撤下并入生涯,设计稿须给明确建议 |
|
||||
| 暂停层(迭代 17 卡③) | **局内**只读看钥石与解锁进度 | 暂停层看「这一局进行中的当前值」,生涯看「跨局累计与历史」;局内是否给生涯入口随 P4 |
|
||||
| 结算屏 | 当局收束当下的入账明细 | 收束当下保留;生涯承接的是收束之后的任意时刻回看 |
|
||||
| 帮助手册(Beta 批) | 规则与玩法的说明文档 | 手册讲「怎么玩」,生涯讲「我玩过什么」;图鉴条目文案与手册条目是否共用内容源,归 Beta 批一并裁(本提纲只登记接口) |
|
||||
@@ -79,9 +80,11 @@
|
||||
|
||||
| 期 | 内容 | 前置 | 建议窗口 |
|
||||
|---|---|---|---|
|
||||
| 期一 | 跨局汇总页(零新数据面,纯只读投影)+ 生涯入口落位 | 本提纲裁决完毕 | Alpha 后最近一个 UI 窗口(可与暂停层批同迭代序列后续) |
|
||||
| 期二 | 历史冒险回看(新建每局摘要数据面 + 逐局列表 + 单局明细,settlement_review 复活承接随 P5) | 期一 + P2 数据面裁决 | 期一落地后独立批 |
|
||||
| 期三 | 图鉴承接(范围与顺序随 P3) | P3 裁决 + 对应「见过」记账面 | Beta 窗口候选(与教学引导同阶段评估——「认得」轴与教学相关) |
|
||||
| 期一 | 跨局汇总页(大半只读投影;总局数/通关局数两个 lifetime 计数域走 save v6 迁移)+ 生涯入口落位 | 本提纲裁决完毕 + **实装批前置义务(v1.1 补):对齐 iter16ui 后现行 UI 基线**——FS_* 六档字号/TG_* 语义色/BUTTON_MIN_H=40/ui_kit 色板单源/page_shell 模态栈纪律(与卡③任务书同款红线);UI 基线对齐义务由本提纲登记、实装批承接 | Alpha 后最近一个 UI 窗口(可与暂停层批同迭代序列后续) |
|
||||
| 期二 | 历史冒险回看(recent_summaries 扩容 N+补用时埋点+旧档摘要迁移 + 逐局列表 + 单局明细,settlement_review 复活承接随 P5;营地「最近冒险」清单去留一并落地) | 期一 + P2 数据面裁决 | 期一落地后独立批 |
|
||||
| 期三 | 图鉴承接(范围与顺序随 P3;「见过」记账面新增 meta 域=**save v6 迁移义务**) | P3 裁决 + 对应「见过」记账面 | Beta 窗口候选(与教学引导同阶段评估——「认得」轴与教学相关) |
|
||||
|
||||
> 本地化文案权(v1.1 补):生涯界面本体按钮/页签/空态文案归「设置与本地化」线(全仓无 i18n 实装,先例=教学文案权登记),图鉴条目文案与手册共源已在 §3.3 登记接口——实装批承接。
|
||||
|
||||
### 3.5 本批不做
|
||||
|
||||
@@ -131,11 +134,11 @@
|
||||
|
||||
### P0 · 提纲与正主载体
|
||||
|
||||
**✅ 裁决(2026-10-06 用户令)**:案甲——提纲直接落 design/gdd/systems/跨局循环/生涯.md(状态=范围草案),同步 02-系统清单索引。
|
||||
**✅ 裁决(2026-10-06 用户令)**:案甲——提纲直接落 design/gdd/systems/跨局循环/生涯.md(状态=范围草案),同步 02-系统清单.md(**根索引正名,v1.0 误写「02-系统清单索引」,全仓无此文件名**)。
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲(推荐) | 提纲成文即落 `design/gdd/systems/跨局循环/生涯.md`(状态=范围草案),同步 02-系统清单索引 | 「吸收即死」纪律:中间文档不留;正主早立早受益(R3) |
|
||||
| 甲(推荐) | 提纲成文即落 `design/gdd/systems/跨局循环/生涯.md`(状态=范围草案),同步 02-系统清单.md 根索引 | 「吸收即死」纪律:中间文档不留;正主早立早受益(R3) |
|
||||
| 乙 | 提纲暂存 design/research/ 待评审后再转正 | 评审前不动 GDD 树;淘汰候选:与「吸收即死」纪律冲突,且评审意见最终还是要落正主,多一次搬运 |
|
||||
|
||||
### P1 · 生涯入口位置
|
||||
@@ -150,11 +153,11 @@
|
||||
|
||||
### P2 · 历史冒险回看的数据面范围(期二核心裁点,本批只呈框架)
|
||||
|
||||
**✅ 裁决(2026-10-06 用户令)**:案甲——每局一行摘要(结局/到达关卡/钥石收入/用时),上限存最近 N 局;N=20/50 实装期按存档体积读数定。
|
||||
**✅ 裁决(2026-10-06 用户令:案甲;同日 Q5 甲二裁口径重述)**:每局一行摘要(结局/到达关卡/钥石收入/用时),上限存最近 N 局;N=20/50 实装期按存档体积读数定。**口径重述(v1.1——一裁建立在 v1.0「无历史冒险记录面」误记上,实际 recent_summaries 现役 cap=10)**:本裁的实际工作量=①**扩容 cap 10→N**(非新建数据面,向后兼容);②**补「用时」字段埋点**(现无任何采集点,属新增数据面改动,随期二);③旧档既有 ≤10 条摘要原样保留迁移;④N 候选补第三案「**维持 10 不动**」——实装期读数三选一(20/50/维持 10),读数方法(谁测、体积门槛几何、何时测)与设计稿参数化维度(列表形态/滚动/分页/上限提示)由设计稿给出、实装期执行。
|
||||
|
||||
| 案 | 内容 | 淘汰/保留依据 |
|
||||
|---|---|---|
|
||||
| 甲 | 每局一行摘要(结局/到达关卡/钥石收入/用时),上限存最近 N 局(N 候选 20/50) | 存储最小、实现最简;回看粒度到「局」不到「战」 |
|
||||
| 甲 | 每局一行摘要(结局/到达关卡/钥石收入/用时),上限存最近 N 局(N 候选 20/50/维持 10) | 存储最小、实现最简;回看粒度到「局」不到「战」;现役面只需扩容+补字段 |
|
||||
| 乙 | 甲 + 每局完整结算明细留痕(逐行结算单据全存) | 回看最完整;淘汰候选:单局结算单据量大,存档体积与 schema 复杂度显著上升,且 99% 的回看诉求摘要即可满足 |
|
||||
| 丙 | 不存历史,历史回看段整段取消(生涯只做汇总+图鉴) | 淘汰候选:06 条目明列「历史冒险回看」,且 P-C7 裁决的代价(冒险中无回看)正是由它补偿 |
|
||||
|
||||
@@ -215,6 +218,6 @@
|
||||
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(跨局数据面与「无历史记录面」考证点)
|
||||
4. game/core/meta_progression.gd settle_adventure + save_manager.gd:39-40/:316/:325-338(跨局数据面与 recent_summaries 现役面考证点)
|
||||
5. design/gdd/06-待办清单.md「敌方技能图鉴 / 学习呈现」条(图鉴承接的在册先约)
|
||||
```
|
||||
+4
-4
@@ -64,11 +64,11 @@
|
||||
| 迭代 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);卡② ✅ **已全批落籍(2026-10-05,worktree curio-wordfamily 七提交 d4cde73..049aa62+master 同步 23547b5,主区 merge 见台账;出口报告=[iter15-2-curio-exit-report](design/qa/iter15-2-curio-exit-report-2026-10-05.md))**:三套词族代码层全换(feature_→curio_ 93 处/bonus_ 运行层→curio_/relic_→feat_——feat_table.gd/feats.tres/feats_engine.gd 改名);渠道白名单分离(总池-渠道子集多级缓存形=用户裁);门票入表(四参数 provisional 20%/2/1/5+拿到即开+计步保底+限购 1+节点商店共享计数);refresh 入池(B 案 heal 5→3 挤占)+shop.tres 补 heal 行+门票行;T2 裁点甲案=六存档键禁改(含任务书漏登记的 "relics" 键);charge 缺陷登记不硬补;autoplay 门票分支缺陷批内实测修复(MC timeout 形态);闸=冒烟 782/0(+10)+run_all 16 套历史首次全绿(reward_overlay 红转绿=M7 bcard 成因修复)+五探针绿+doc 三闸零新增+MC n200 只测不判(normal 0.5%/perfect 77.5%);遗留=07⑰ 目检归用户+C1 呈现批/C2 第四关批/C3 调参批/C4 存档批四移交。原估 T0-T8≈4.5d(实际一次会话);迭代 15 三卡全落籍(①352/②本批/③8944dca 前身③批+本批) |
|
||||
| 迭代 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);卡② ✅ 已全批落籍(2026-10-05 merge 3c6f2c9,台账 362——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 基线红归②批处置 |
|
||||
| 迭代 16 | **UI 设计对齐批(2026-10-05 用户令:迭代 16 改编为 UI 优化需求实现,原四卡全数顺延迭代 17;美术线用户自理立规的例外面=本批只改 UI 设计代码、零美术资源改动)**:三路改进整合轴的代码侧落地——事实源=`design/research/UI预览demo三路改进整合对照-2026-10-04.md`(A 落码差异对照+OPT-A 机检+WB 变体三路整合,基线原型 v2.1)。**红线=不修改美术资源**:game/assets/art 与 artwork/ 均不动、不生新素材不重烘,只改 UI 设计代码(ui_kit 色板 token/字号档/布局纪律/对比度垫底/抖动呈现/panel_skinned 接线等)。无分歧可直接收项=对比度 7 处 FAIL 修法(血数 2.09→12.29 垫底等已复算)/站桩溢出 3.2px/4 处裸色收 ui_kit/status 图标 preload 违规/tg-* 类型色接线。**前置待裁=六分歧点**(①底色冷暖 ②棋盘格边长 32/44/45 ③字号档位 ④九宫格切片 ⑤圆角去留 ⑥图标尺寸解法,对照表 §三)+开放项(抖动范围/色板唯一来源,§五)。任务书=`design/research/任务书-UI设计对齐批-2026-10-05.md`(T0-T11≈7.25d,**超软盒 3d 预挂**,三段切分=段一 2.0d 无阻断〔T0-T4a〕/ 段二 4.0d 待裁〔T4b-T8〕/ 段三 1.0d 收口〔T9-T11〕;🔴 契约 7 条 R1-R7;无分歧收项 N1-N6 已逐处 file:line 考证;**待用户裁点 11 项**=六分歧 P1 底色冷暖/P2 棋盘格边长/P3 字号档位/P4 九宫格切片/P5 圆角去留/P6 图标尺寸解法 + 开放项 P7 色板唯一来源/P8 抖动范围/P9 §五 已决注销清单/P10 记忆态口径/P11 装饰 caption 豁免;**六分歧与开放项一律呈全备选案含淘汰依据**)。**事实校正(实查,2026-10-05)**:9 处色板漂移实测 4 已收 5 未收;`tg-*` 五族在 ui_kit 并不存在(以裸 Color8 内联于 bonus_pick_overlay/shop_overlay_view,缺第五族);panel_skinned 消费面实测 8 处+工厂 1 处;棋盘格边长=动态公式 clamp[26,46] 与 §8.1 锚点 45/36 三方互不等;手绘图标十枚 20×20 已入库,真问题转为 64×64 柜台四枚显示倍率;站桩溢出实机存在 1px 余量同型写法(standee_body.gd:476);demo 基线 md5 已再次漂移(实测 78ebbee0…)。状态=**任务书已起草(2026-10-05)+ 取向已定(2026-10-06)**:✅ P1=甲(维持暖化零改动)/ P2=丁(棋盘格边长零改动,46/45/44 不一致登记为已知偏差);✅ **其余八项取向已定**(用户采纳推荐)——**跟 demo**:P4 九宫格切片 8→16 / P7 五处色板向 demo / P10 记忆态纹理灰罩;**按条款解**:P3 字号立 FS_* 档(demo 34 处<14、54 处<16 不可跟)/ P6 图标显示档(demo 自身 0.3125× 违规)/ P8 抖动只做卡顶色带(demo 渐变+blur 违反像素纪律)/ P11 装饰 caption 12px 豁免;P5 两路同结论。**「以 demo 为准」三层优先级栈=任务书 §8.3**(①用户终裁>②冻结条款>③demo);三条结构级差异(卡片 232×352 / 商店全屏化 / 地图底栏合并)**不入本批、已登记 06 待立项**。估时 T0-T11≈**6.9d**(段一 2.15d 无阻断可发令 / 段二 3.75d / 段三 1.0d;三段同属一迭代、**只在段三末合并一次**);**拷打轮一 9 问已全部落地**(Q1 `panel_skinned` content margin clamp / Q2 不走独立样张闸改并进 T10 目检 / Q3 柜台图标统一 32px / Q4 商店补类型分族 / Q5 血数 11px 与装饰 caption 合并写一条豁免 / Q6 槽两态不新增通道 / Q7 一次合并 / Q8 已知偏差已登记 06 / Q9 demo 取值抄录表为唯一引用源)。**✅ 已全批落籍(2026-10-06 单会话,worktree g-plan2-iter16ui 分支 iter16-ui-20261005 十二提交 85ea024..T11 收口笔,主区 merge --no-ff 哈希见 active.md 快照行;出口报告=[iter16-ui-exit-report](design/qa/iter16-ui-exit-report-2026-10-06.md))**:T0-T10 全落(T10 人闸材料包=[iter16-ui-human-gate-checklist](design/qa/iter16-ui-human-gate-checklist-2026-10-06.md)——实机目检+代拍板追认八项归用户);闸=冒烟 782/0(断言数持平基线)+run_all 16 套全绿+探针五件全绿(新增 ui_contrast_probe 11 对测点+ui_struct⑥standee 断言族入默认段)+doc 三闸/熵增零新增+MC 零跑(纯呈现批——核心/数据层 diff=0 实证)+素材零触碰;T0 实机复算三处修法改向(意图徽标垫牌/槽位字深化/RAP 零改动——demo 口径在实机反向)+N4a 裸色实数 25 处/10 文件全收 ui_kit(任务书 5 处系漏记)+字号 107 位点归档 FS_* 六档;偏差八条在出口报告§汇总;遗留=06 新登记「呈现层残余 <4.5:1 文字位」一条(名行四墨/顺位徽标/RAP 反馈——批外邻接发现) | 迭代 15 出口 | 预算 T0-T11≈6.9d(三段切分)——**实际单会话一次跑完(2026-10-06)** |
|
||||
| 迭代 17 | **⓪内容数据驱动扩展批(2026-10-06 用户令插队为头卡——①-④卡顺延,其任务书与裁点状态原样保留)**:把内容效果行为从结算代码硬编码搬进数据行「订阅事件(on)+条件(when)+效果类型(do)」,通用解释器 EffectEngine 统一执行——完成后加「已有效果类型」的新专长/秘宝=纯改 `.tres` 零代码。裁决八条全落(R1 发布订阅同步 emit 确定性优先/R2 仅一个改写窗口不做拦截器链/R3 一事件多订阅+组合规则封冲突面/R4 旧 23 挂点枚举删除·2 个退化条件行/R5 现有实现全改造+06 在册只登记〔curio_roll/shop_purchase/gp_settle 三事件登记不实施〕/R6 框架先行发射点不论有无订阅者全埋/R7 一个迭代四模块垂直切一次合并/R8 术语纪律:事件=发布订阅 topic、效果类型=订阅后逻辑、组合规则=叠加规则,禁 hook/合并律等自造词)。词汇表定稿=**实施 17 事件**+效果类型 16+组合规则 5;存档零改动;文案表值化随批(现有实现判据);luck_coin 经 reward_roll 迁移随批。任务书=`design/research/任务书-内容数据驱动扩展批-2026-10-06.md`(T0-T7≈4.5d,零待裁点,🔴 契约 5 条含 MC 对拍逐位等价+护栏保留+确定性;停机点 S1 首流派对拍/S2 批末闸;开工门=U0) | 迭代 15 出口(已解) | T0-T7≈4.5d |
|
||||
| 迭代 17 | **①敌人表行集多行批(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 项;**✅ 裁点全裁(2026-10-06 用户令:P1甲/P2甲/P3乙投放教学位行〔MC 取证先报批〕/P4乙 Boss 行亦放开——零内容投放不变,Boss 多行内容归后续内容批);开工=U0**) | 迭代 15 出口 | T0-T8≈4.25d(超软盒预挂,T4 末切分点) |
|
||||
| 迭代 17 | **⓪内容数据驱动扩展批(2026-10-06 用户令插队为头卡——①-④卡顺延,其任务书与裁点状态原样保留)**:把内容效果行为从结算代码硬编码搬进数据行「订阅事件(on)+条件(when)+效果类型(do)」,通用解释器 EffectEngine 统一执行——完成后加「已有效果类型」的新专长/秘宝=纯改 `.tres` 零代码。裁决八条全落(R1 发布订阅同步 emit 确定性优先/R2 仅一个改写窗口不做拦截器链/R3 一事件多订阅+组合规则封冲突面/R4 旧 23 挂点枚举删除·2 个退化条件行/R5 现有实现全改造+06 在册只登记〔curio_roll/shop_purchase/gp_settle 三事件登记不实施〕/R6 框架先行发射点不论有无订阅者全埋/R7 一个迭代四模块垂直切一次合并/R8 术语纪律:事件=发布订阅 topic、效果类型=订阅后逻辑、组合规则=叠加规则,禁 hook/合并律等自造词)。词汇表定稿=**实施 16 事件**+效果类型 19 行 23(v1.1 扩 damage_mult/open_ticket 两型装下减半/开单现状)+组合规则 6;存档零改动;文案表值化随批(现有实现判据);luck_coin 经 reward_roll 迁移随批。任务书=`design/research/任务书-内容数据驱动扩展批-2026-10-06.md`(v1.1 2026-10-06 联审修订:level_clear 归登记不实施/对拍判据两套〔确定性复放与冒烟=逐位、MC 统计量=成型画像同带 m4iter12 口径〕/映射表五处语义修正/断言面随迁与订阅重建时机补列;T0-T7≈4.5d,零待裁点,🔴 契约 5 条含行为等价两套判据+护栏保留+确定性;停机点 S1 首流派对拍/S2 批末闸;开工门=U0) | 迭代 15 出口(已解) | T0-T7≈4.5d |
|
||||
| 迭代 17 | **①敌人表行集多行批(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`(**v1.1 2026-10-06 联审修订**:F7 勘误 19 行 9 敌种/P1 补遭遇骰交互〔每行一骰·RNG 扩签先报批〕与实例总数≤4 消歧/P3 改裁丙撤投放/新增契约 R6 混编行行序纪律/expect_pools 断言换代入组 D;T0-T8≈3.75d〔T5 撤投后,超软盒预挂,T4 末切分点〕;🔴 契约 6 条;**✅ 裁点全裁(2026-10-06 用户令:P1甲〔Q8/Q9 二裁补全〕/P2甲/P3丙〔Q3 二裁撤投放——一裁乙与首遇教学位纪律三面冲突〕/P4乙 Boss 行亦放开·知情代价六面在册);开工=U0**) | 迭代 15 出口 | T0-T8≈3.75d(超软盒预挂,T4 末切分点) |
|
||||
| 迭代 17 | **③暂停层只读入口批(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 条含公共件单点/模态登记纪律;**✅ 裁点全裁(2026-10-06 用户令全按推荐:P1丁/P2甲/P3甲/P4甲);开工=U0**) | 迭代 15 出口 | T0-T5≈3.0d(贴软盒,T2 末切分点) |
|
||||
| 迭代 17 | **④生涯界面设计立项(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 纯文档零测试;**✅ 裁点全裁(2026-10-06 用户令全按推荐:P0甲/P1甲/P2甲〔N 实装期定〕/P3甲/P4甲/P5甲);开工=U0**) | 迭代 15 出口 | T0-T2≈1.25d(软盒内) |
|
||||
| 迭代 18 | **M4 数值批(2026-10-05 用户令编入迭代 17 卡②;2026-10-06 用户令移出独立成批——不影响迭代 17 在飞开发,17 卡号 ③④ 维持原号不重排)**:四件数值欠账合一批——①削弱档位终值(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`(**v1.1 2026-10-06 案C 增补**:§2.6 三事实〔行为换代/锚全作废/难度预判〕+T0 推算稿第五件=对拍锚按新序重推导+T6 四带复算按案C 新行为首采;T0-T8≈6.25d,天然切分点 T4 末;🔴 契约 5 条含跑批批准制;**✅ 裁点全裁(2026-10-06 用户令:P1甲=维持 2 场·magnitude [60,85] 当量锚复算终值随批呈报/P2甲 不对称有意/P3甲 3-3-3·2-2-3 转正/P4甲 不立直购价);开工=U0**) | 迭代 17 出口 | T0-T8≈6.25d(超软盒预挂,段一 T0-T4≈4.5d/段二 T5-T8≈2.0d) |
|
||||
| 迭代 17 | **④生涯界面设计立项(2026-10-05 用户令编入本迭代;只做设计提纲不做实装)**:事实源=06「『生涯』界面——冒险中数据回看的唯一承接处」条(P-C7 裁:M9 已退役局内结算明细回看,历史数据现无承接面=用户知情裁决)。考证在册:回看退役已落码(battle_end_overlay/battle_log_view/ui_assembler 三处注记)+settlement_review_overlay.gd 遗留件在盘+跨局持久面=save v5 meta 域+recent_summaries 现役逐局留痕(cap=10,save_manager.gd SUMMARY_CAP——2026-10-06 联审勘误:原记「无历史冒险记录面」系事实错误;真实缺口=cap 扩容+用时埋点+总局数/通关局数 lifetime 计数域〔涉存档 schema〕+营地既有最近冒险清单的去留设计)。任务书形态=设计提纲版:信息架构+承载内容清单(跨局汇总/历史冒险回看/图鉴承接)+与既有界面关系+三期实装建议+待裁点,标注「实装批另行立项」。任务书=`design/research/任务书-生涯界面设计立项-2026-10-05.md`(**v1.1 2026-10-06 联审修订**:F4 改正 recent_summaries 现役/P2 甲口径重述=扩容+用时埋点/总局数通关局数标注涉 schema/营地清单去列入设计稿必答项/N 候选补「维持 10」;T0-T2≈1.25d 纯文档零测试;**✅ 裁点全裁(2026-10-06 用户令全按推荐:P0甲/P1甲/P2甲〔N 实装期定〕/P3甲/P4甲/P5甲);开工=U0**) | 迭代 15 出口 | T0-T2≈1.25d(软盒内) |
|
||||
| 迭代 18 | **M4 数值批(2026-10-05 用户令编入迭代 17 卡②;2026-10-06 用户令移出独立成批——不影响迭代 17 在飞开发,17 卡号 ③④ 维持原号不重排)**:四件数值欠账合一批——①削弱档位终值(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`(**v1.2 2026-10-06 案C 增补+联审修订**:v1.1 三事实与第五推算件照旧;联审=P3 转正顺延至重扫读数后/检算工具 WEAKEN_PCT 入同步面/F11 两句死文本全刷/T3·T5 四带复算并账一次跑批双认账/R5 改前锚=本批新立案C 锚/估时段一勘误 4.25d;案C 增补内容照旧=§2.6 三事实〔行为换代/锚全作废/难度预判〕+T0 推算稿第五件=对拍锚按新序重推导+T6 四带复算按案C 新行为首采;T0-T8≈6.25d,天然切分点 T4 末;🔴 契约 5 条含跑批批准制;**✅ 裁点全裁(2026-10-06 用户令:P1甲=维持 2 场·magnitude [60,85] 带内当量锚复算、具体值随出口 provisional 追认/P2甲 不对称有意/P3甲 3-3-3·2-2-3 维持、转正顺延至重扫读数到账且带内(Q4 二裁)/P4甲 不立直购价);开工=U0**) | 迭代 17 出口 | T0-T8≈6.25d(超软盒预挂,段一 T0-T4≈4.25d〔v1.2 勘误,原 4.5 系加总错误〕/段二 T5-T8≈2.0d) |
|
||||
|
||||
## 执行纪律(2026-09-27 用户立规)
|
||||
|
||||
|
||||
Reference in new issue
Block a user