合并(迭代53批后收尾+CI追绿修复): 收尾批=反哺点落文(用户四点裁决在案:3按方案/7-9照落/4裁入数据表行/5登记待办)——反哺点3 GDD退役名清退(术语表v1.27+地图战斗资源v1.6掷格件两路投影换机制名订阅加权+00-游戏概念删旧六行专名,退役记录句保留)+反哺点4规范句落战斗结算v1.8(明细文案=数据面字段读表拼行)+反哺点7 golden台账补lmap冻结日+反哺点8能力行名实回表+反哺点9探针直读受控例外注记; 未决迁账面(结算明细文案入表条目待文档设计/闸机超时守卫缺陷与mac两Shot基线登记待执行); 体验验证清单52节两目检项; 吸收即死退役五件(反哺点清单/实现报告/验收审计/两需求卡片); roadmap迭代53行已完成+当前位换代(迭代1–53)。追绿批=run87三红修复: forge_table_test效果类型闭集32→31(卡②摘spike断言随动)+level_map_info_fog_test布局缓存换代断言第三判据等强换键(位置差前提随画布同帧收敛失义,失效重算正常,换键=重算字典键数恰为新图节点数)+capability_audit真实入口锚面补probe_funcs(探针共用面,不属放宽)+level_map_shot_probe.gd.uid边车补入库+待办清单QA条目补仓库内证据句(修run86起流水线闸红)。验证: 两修复套件窄测绿(forge42/fog21全绿)+流水线闸PASS(27条目)+能力审计红项0+--docs全绿回执909a9709。post-merge钩子推送触发远端CI
# Conflicts: # 待办清单.md
This commit is contained in:
commit
ec1c0da1ff
20 files changed
+68
-669
No files matched your search
@@ -77,7 +77,7 @@
|
|||||||
|
|
||||||
### 8.2 四层与真实入口
|
### 8.2 四层与真实入口
|
||||||
|
|
||||||
- **单元**:不依赖场景树和真实宿主的纯逻辑;测试从领域类的对外方法进出,断言钉对外可观测面(返回值/信号/查询接口/落盘内容)。内部字段直查=受控例外:仅当该行为没有公开可观测面可钉时允许,对照表该行注明理由;存量不回头清扫,被批次触碰时顺带换代。
|
- **单元**:不依赖场景树和真实宿主的纯逻辑;测试从领域类的对外方法进出,断言钉对外可观测面(返回值/信号/查询接口/落盘内容)。内部字段直查=受控例外:仅当该行为没有公开可观测面可钉时允许,对照表该行注明理由;存量不回头清扫,被批次触碰时顺带换代。探针直读视口承载子件结构(画布取视口首子件、渐隐带两片与平移提示子件按名取)属此类——断言对象即承载结构本身,无公开可观测面可钉,理由随对照表行申报。
|
||||||
- **接口**:模块边界的公开契约——数据表加载、存档与断点、事件载荷、命令接口;测试从公开入口进出。接口级断言随单元套件落(`unit/contracts/`),不另设承载目录。
|
- **接口**:模块边界的公开契约——数据表加载、存档与断点、事件载荷、命令接口;测试从公开入口进出。接口级断言随单元套件落(`unit/contracts/`),不另设承载目录。
|
||||||
- **集成**:跨宿主的接线、持久、生命周期——例如 LevelRunner 把 level_counters 传给 BattleOrchestrator、两场战斗共享同一个桶、断点续玩;测试必须实例化真实宿主链,禁止用裸 EffectEngine 代替。
|
- **集成**:跨宿主的接线、持久、生命周期——例如 LevelRunner 把 level_counters 传给 BattleOrchestrator、两场战斗共享同一个桶、断点续玩;测试必须实例化真实宿主链,禁止用裸 EffectEngine 代替。
|
||||||
- **探针/golden**:玩家可达性与观感;真实实例化场景、驱动真实输入。
|
- **探针/golden**:玩家可达性与观感;真实实例化场景、驱动真实输入。
|
||||||
|
|||||||
@@ -47,12 +47,6 @@
|
|||||||
|
|
||||||
| 专名 | 是什么 | 出处条目 |
|
| 专名 | 是什么 | 出处条目 |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| 显影尘 | 信息类秘宝 | aux_items |
|
|
||||||
| 工兵令 | 加行动点的秘宝 | aux_items |
|
|
||||||
| 探宝罗盘 | 预读奖励身份的秘宝 | aux_items |
|
|
||||||
| 探巢摆钟 | 探知巢穴位置的秘宝 | aux_items |
|
|
||||||
| 地穴全图卷 | 全图级稀有秘宝 | aux_items |
|
|
||||||
| 爆破工兵包 | 行动点 + 探巢的稀有秘宝 | aux_items |
|
|
||||||
| 地精 / 熊地精 / 食人魔酋长 | 首发三敌种(末者为 Boss) | enemy |
|
| 地精 / 熊地精 / 食人魔酋长 | 首发三敌种(末者为 Boss) | enemy |
|
||||||
| 第一层 · 地精洞窟 | 首关层名 | level_table |
|
| 第一层 · 地精洞窟 | 首关层名 | level_table |
|
||||||
| 封印 | 正式动作名(全库统一,非比喻、非呈现层别名)——对未开格实施封印,印记=封印印记 | terminology |
|
| 封印 | 正式动作名(全库统一,非比喻、非呈现层别名)——对未开格实施封印,印记=封印印记 | terminology |
|
||||||
|
|||||||
@@ -38,7 +38,7 @@ MVP 不加新敌种,也不做同深度多敌种混搭;敌种扩容走 `enemy
|
|||||||
|
|
||||||
目录(重设计 v1)已定稿 **12 件**(普通 7 / 优秀 3 / 稀有 2——代号制,正式命名归用户;数值全 provisional 归调参批),现行事实源=[秘宝](systems/跨局循环/秘宝.md)「目录(重设计 v1)」节。数据行随实装批落表(同调件数据表 = `data/tables/treasure_items.tres`),MVP 不新增。
|
目录(重设计 v1)已定稿 **12 件**(普通 7 / 优秀 3 / 稀有 2——代号制,正式命名归用户;数值全 provisional 归调参批),现行事实源=[秘宝](systems/跨局循环/秘宝.md)「目录(重设计 v1)」节。数据行随实装批落表(同调件数据表 = `data/tables/treasure_items.tres`),MVP 不新增。
|
||||||
|
|
||||||
旧目录(旧 aux_items 六行:显影尘/工兵令/探宝罗盘/探巢摆钟/地穴全图卷/爆破工兵包,及过渡形态诸件)已全数退役、只作素材库(design/content-archive/道具退役素材库.md);旧行删除归实装批。
|
旧目录(旧 aux_items 六行:显影尘/工兵令/探宝罗盘/探巢摆钟/地穴全图卷/爆破工兵包,及过渡形态诸件)已全数退役、留底 design/content-archive/道具退役素材库.md(数据表旧行已删净——treasure_items.tres 旧六名扫描零命中)。
|
||||||
|
|
||||||
## 增益与状态
|
## 增益与状态
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
# 地图战斗资源
|
# 地图战斗资源
|
||||||
|
|
||||||
> 一句话:格面资源的产出、极性字典与清图奖励封装
|
> 一句话:格面资源的产出、极性字典与清图奖励封装
|
||||||
> 状态:已定稿;现行为 v1.5
|
> 状态:已定稿;现行为 v1.6
|
||||||
|
|
||||||
## 设计目的
|
## 设计目的
|
||||||
|
|
||||||
@@ -96,7 +96,7 @@
|
|||||||
|
|
||||||
- **档由两个参数定义:概率位 + 保底上限**。「永不保底」不单立规则——T4 的保底上限 = 0 即其统一表达;T1/T2 上限同为 0。
|
- **档由两个参数定义:概率位 + 保底上限**。「永不保底」不单立规则——T4 的保底上限 = 0 即其统一表达;T1/T2 上限同为 0。
|
||||||
- **保底数量挂在型上、不挂在档上**:每个型各自登记「每板至少出几个」。档内登记保底的型数 ≤ 档上限 → 全部兑现;> 上限 → 每板从登记型中随机选定「上限」个兑现,其余型该板按普通概率出现、不保底。
|
- **保底数量挂在型上、不挂在档上**:每个型各自登记「每板至少出几个」。档内登记保底的型数 ≤ 档上限 → 全部兑现;> 上限 → 每板从登记型中随机选定「上限」个兑现,其余型该板按普通概率出现、不保底。
|
||||||
- **补签纪律**:执行序 = 装板摇号(含偏运硬币投影)→ 按上限定本期保底型集合 → 校验补签 → 板上全程只读。补签只改类型身份:危险格与安全格不动(补签格可为雷可为安全格,危险格与安全格同池不破)、不消费权重(补签不是一次取号)、清图判定不动、不泄露元信息(补签格与摇号格不可区分)。粒度 = 板,换板重新校验。
|
- **补签纪律**:执行序 = 装板摇号(含订阅加权投影)→ 按上限定本期保底型集合 → 校验补签 → 板上全程只读。补签只改类型身份:危险格与安全格不动(补签格可为雷可为安全格,危险格与安全格同池不破)、不消费权重(补签不是一次取号)、清图判定不动、不泄露元信息(补签格与摇号格不可区分)。粒度 = 板,换板重新校验。
|
||||||
- **GP 数值锚**:以战斗结束 GP 奖励为锚——小 GP 袋 ≈ 其 1/10、大宝箱 ≈ 其 1 倍(具体数值归调参批)。
|
- **GP 数值锚**:以战斗结束 GP 奖励为锚——小 GP 袋 ≈ 其 1/10、大宝箱 ≈ 其 1 倍(具体数值归调参批)。
|
||||||
- 大宝箱为枚举新增(九型→十型走本文修订流程,不随手加行);微光归通用增益组(五色相不变,组内不细分正好容下)。
|
- 大宝箱为枚举新增(九型→十型走本文修订流程,不随手加行);微光归通用增益组(五色相不变,组内不细分正好容下)。
|
||||||
- **对外稀有度映射**(现行事实源=[核心循环](../../01-核心循环.md)「档位与获取规则」节):T1=普通 / T2=优秀 / T3=稀有 / T4=传说;任何概率提升禁止改变本档保底承诺(保底=承诺非概率)。
|
- **对外稀有度映射**(现行事实源=[核心循环](../../01-核心循环.md)「档位与获取规则」节):T1=普通 / T2=优秀 / T3=稀有 / T4=传说;任何概率提升禁止改变本档保底承诺(保底=承诺非概率)。
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
# 战斗结算
|
# 战斗结算
|
||||||
|
|
||||||
> 一句话:轮末结算的编排与逐行兑现
|
> 一句话:轮末结算的编排与逐行兑现
|
||||||
> 状态:已定稿;现行为 v1.7
|
> 状态:已定稿;现行为 v1.8
|
||||||
|
|
||||||
## 设计目的
|
## 设计目的
|
||||||
|
|
||||||
@@ -84,7 +84,7 @@
|
|||||||
| 判定行 | 胜 / 负 / 继续各一行;终局判定行同时是胜负画面的数据锚 |
|
| 判定行 | 胜 / 负 / 继续各一行;终局判定行同时是胜负画面的数据锚 |
|
||||||
| 高光行 | 完美封印成立时一行,只记实际有效兑付 |
|
| 高光行 | 完美封印成立时一行,只记实际有效兑付 |
|
||||||
|
|
||||||
每行还携带公共字段:来源类别、来源格、轮次、显示名、数值,以及可空的高光标记(用于强调封印标中、清图奖励这类值得高亮的结果)。奖励直伤行的数值字段沿用 `effectiveness` 键名、值为整数点数——键名与量纲是数据导出与分析工具的兼容契约,改动须连动分析工具面。没生效也要留痕:两类"未生效"行如实记录合法例外,呈现时聚合计数,不逐行刷屏。
|
每行还携带公共字段:来源类别、来源格、轮次、显示名、数值,以及可空的高光标记(用于强调封印标中、清图奖励这类值得高亮的结果)。**显示名等玩家可见文案是数据面字段:文案值登记在数据表行,代码按来源类别与效果身份读表拼行,不在代码里写死文案字串**(2026-11-06 用户裁——文案归属数据表承载;承载表与字段形态归表结构设计段定,设计闭合后由实装批落表)。奖励直伤行的数值字段沿用 `effectiveness` 键名、值为整数点数——键名与量纲是数据导出与分析工具的兼容契约,改动须连动分析工具面。没生效也要留痕:两类"未生效"行如实记录合法例外,呈现时聚合计数,不逐行刷屏。
|
||||||
|
|
||||||
任何一行找不到来源即断言失败——宁可返回错误,也不让"合并到看不出来源"的呈现混过数据层。但有些行天然没有棋盘来源,断言为此留了两层豁免,豁免集合是封闭清单,改动同样走本文修订。
|
任何一行找不到来源即断言失败——宁可返回错误,也不让"合并到看不出来源"的呈现混过数据层。但有些行天然没有棋盘来源,断言为此留了两层豁免,豁免集合是封闭清单,改动同样走本文修订。
|
||||||
|
|
||||||
|
|||||||
+2
-2
@@ -1,7 +1,7 @@
|
|||||||
# 术语表
|
# 术语表
|
||||||
|
|
||||||
> 全库专用术语的唯一对照表(2026-10-11 用户令建立)。规矩:新术语先登记本表、再在文档使用;退役词见文末对照表,文档正文一律使用现行词。文档中遇到看不懂的词,查本表。用词纪律(禁用词、替换值、豁免范围)见「用语规范」节。
|
> 全库专用术语的唯一对照表(2026-10-11 用户令建立)。规矩:新术语先登记本表、再在文档使用;退役词见文末对照表,文档正文一律使用现行词。文档中遇到看不懂的词,查本表。用词纪律(禁用词、替换值、豁免范围)见「用语规范」节。
|
||||||
> 状态:**现行 v1.26**——2026-10-11 建立;历次升版明细见 git 提交史。
|
> 状态:**现行 v1.27**——2026-10-11 建立;历次升版明细见 git 提交史。
|
||||||
|
|
||||||
## 格与棋盘
|
## 格与棋盘
|
||||||
|
|
||||||
@@ -95,7 +95,7 @@
|
|||||||
| 术语 | 定义 |
|
| 术语 | 定义 |
|
||||||
|---|---|
|
|---|---|
|
||||||
| 效果端口件 | 战斗业务类(伤害管线/行动经济)唯一的效果发射出口:收事件与载荷、交效果引擎结算、取回命中批——业务类零引擎直连(机制归属见架构文档「战斗编排域拆件定稿」节轴戊;实现类 EffectPort) |
|
| 效果端口件 | 战斗业务类(伤害管线/行动经济)唯一的效果发射出口:收事件与载荷、交效果引擎结算、取回命中批——业务类零引擎直连(机制归属见架构文档「战斗编排域拆件定稿」节轴戊;实现类 EffectPort) |
|
||||||
| 掷格件 | 装配期格面资源摇号的承载件:池行装配、区间行 roll、权重合成(偏运硬币/board_skew 两路投影);受理账面留守地图战斗资源件(机制归属同上;实现类 RewardRoller) |
|
| 掷格件 | 装配期格面资源摇号的承载件:池行装配、区间行 roll、权重合成(订阅加权/board_skew 两路投影);受理账面留守地图战斗资源件(机制归属同上;实现类 RewardRoller) |
|
||||||
| `seal_missed` | 封印落空事件(旧名已换代):封印动作落在安全格上时发出,订阅面据此做限次与豁免判定 |
|
| `seal_missed` | 封印落空事件(旧名已换代):封印动作落在安全格上时发出,订阅面据此做限次与豁免判定 |
|
||||||
| `forgive_seal_miss` | 本场首次封印落空豁免——专长「完美保险」的效果类型,`domain=battle` 首例;有效误标=误标总数 − 豁免数,豁免不改写误标账 |
|
| `forgive_seal_miss` | 本场首次封印落空豁免——专长「完美保险」的效果类型,`domain=battle` 首例;有效误标=误标总数 − 豁免数,豁免不改写误标账 |
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1 @@
|
|||||||
|
uid://j4ax48si4nq5
|
||||||
@@ -160,7 +160,7 @@ tests/
|
|||||||
| 四柜台拆解后五界面入口改挂与写口零回归 | 营地五界面 | 五界面意图信号 → `CampShopPresenter` → `MetaProgression.tree_buy()` 写口 | `forge_workbench_test.gd:_run`(承载类同迁断言十二项);`ui_click_probe.gd:_ready`(写口链段) |
|
| 四柜台拆解后五界面入口改挂与写口零回归 | 营地五界面 | 五界面意图信号 → `CampShopPresenter` → `MetaProgression.tree_buy()` 写口 | `forge_workbench_test.gd:_run`(承载类同迁断言十二项);`ui_click_probe.gd:_ready`(写口链段) |
|
||||||
| 营地篝火回主菜单与笔记本改挂动线 | 营地交互流 | 笔记本命中区 → `CareerOverlay.open()`;篝火命中区 → ConfirmDialog 二次确认 → 主菜单 | `ui_struct_probe.gd:_ready`(career 段);`screen_flow_probe.gd:_ready`(篝火/开合段) |
|
| 营地篝火回主菜单与笔记本改挂动线 | 营地交互流 | 笔记本命中区 → `CareerOverlay.open()`;篝火命中区 → ConfirmDialog 二次确认 → 主菜单 | `ui_struct_probe.gd:_ready`(career 段);`screen_flow_probe.gd:_ready`(篝火/开合段) |
|
||||||
| 关卡画面视口跟随 | 关卡画面(选路枢纽) | 停点切换与兑付回图经真实屏流程;读面 `LevelMapViewport.viewport_center_canvas_pos()` | `level_map_viewport_probe.gd:_probe_follow_anchor`;`level_map_viewport_probe.gd:_probe_smooth_scroll_reduced_motion` |
|
| 关卡画面视口跟随 | 关卡画面(选路枢纽) | 停点切换与兑付回图经真实屏流程;读面 `LevelMapViewport.viewport_center_canvas_pos()` | `level_map_viewport_probe.gd:_probe_follow_anchor`;`level_map_viewport_probe.gd:_probe_smooth_scroll_reduced_motion` |
|
||||||
| 关卡画面视口平移 | 关卡画面(选路枢纽) | 合成拖拽沿与滚轮沿经 `push_input`(`ProbeUiUtil.push_drag_at()`/`push_wheel_at()`) | `level_map_viewport_probe.gd:_probe_drag_pan`;`level_map_viewport_probe.gd:_probe_wheel_pan`;`level_map_viewport_probe.gd:_probe_clamp_bounds`;`level_map_viewport_probe.gd:_probe_drag_no_submit` |
|
| 关卡画面视口平移 | 关卡画面(选路枢纽) | 合成拖拽沿与滚轮沿经 `push_input`(`ProbeUiUtil.push_drag_at()`/`push_wheel_at()`) | `level_map_viewport_probe.gd:_probe_drag_pan`;`level_map_viewport_probe.gd:_probe_wheel_pan`;`level_map_viewport_probe.gd:_probe_clamp_bounds_and_columns`;`level_map_viewport_probe.gd:_probe_drag_no_submit` |
|
||||||
| 关卡画面视口指引 | 关卡画面(选路枢纽) | 深图经 `LevelMapScreen.open_choices()` 真实停点 | `level_map_viewport_probe.gd:_probe_guidance_chrome` |
|
| 关卡画面视口指引 | 关卡画面(选路枢纽) | 深图经 `LevelMapScreen.open_choices()` 真实停点 | `level_map_viewport_probe.gd:_probe_guidance_chrome` |
|
||||||
| 营地图鉴占位挂起态与反参照结构纪律 | 营地场景视图 | 布告板命中区 → `CampSceneView._gui_input()`(object_pressed 信号) → 图鉴占位视图;营地根态场景树审计 | `ui_struct_probe.gd:_ready`(占位禁词/禁行段);`ui_struct_probe.gd:_ready`(结构禁词段) |
|
| 营地图鉴占位挂起态与反参照结构纪律 | 营地场景视图 | 布告板命中区 → `CampSceneView._gui_input()`(object_pressed 信号) → 图鉴占位视图;营地根态场景树审计 | `ui_struct_probe.gd:_ready`(占位禁词/禁行段);`ui_struct_probe.gd:_ready`(结构禁词段) |
|
||||||
| 营地刷新单口与场景根 HUD 同步 | 营地刷新总线 | 写口尾 → `CampRefreshBus.refresh()` → 现开界面刷新+场景根 HUD 刷新 | `ui_struct_probe.gd:_ready`(顶栏位段);`ui_click_probe.gd:_ready`(写口尾刷新段) |
|
| 营地刷新单口与场景根 HUD 同步 | 营地刷新总线 | 写口尾 → `CampRefreshBus.refresh()` → 现开界面刷新+场景根 HUD 刷新 | `ui_struct_probe.gd:_ready`(顶栏位段);`ui_click_probe.gd:_ready`(写口尾刷新段) |
|
||||||
|
|||||||
@@ -18,7 +18,7 @@
|
|||||||
|
|
||||||
## 时效判定纪律
|
## 时效判定纪律
|
||||||
|
|
||||||
基线冻结于 2026-09-30。**判定先于动作**:每代换代面(视觉/素材/布局改动)
|
基线冻结于 2026-09-30;关卡视口两 Shot(lmap_entry/lmap_boss)冻结于 2026-11-05——两 Shot 面口径(只对拍入口停点与 Boss 节点)见上文现持清单行。**判定先于动作**:每代换代面(视觉/素材/布局改动)
|
||||||
跑批时先跑一次渲染闸看差异落不落在裁剪区与容差内——
|
跑批时先跑一次渲染闸看差异落不落在裁剪区与容差内——
|
||||||
|
|
||||||
- **判有效**(changed 远低于 2% 阈值):基线**留在位**,不得顺手重制;
|
- **判有效**(changed 远低于 2% 阈值):基线**留在位**,不得顺手重制;
|
||||||
|
|||||||
@@ -212,9 +212,10 @@ func _test_negative_cases() -> void:
|
|||||||
# ---- V11:效果类型闭集零新增(满级特效本期不开新词)----
|
# ---- V11:效果类型闭集零新增(满级特效本期不开新词)----
|
||||||
# 实数订正(L2 在册):卡片 F11「24 种」系设计文档事实快照,
|
# 实数订正(L2 在册):卡片 F11「24 种」系设计文档事实快照,
|
||||||
# 现行 31;本套件零扩签,钉现行数(将来任何加词即转红提示复核)。
|
# 现行 31;本套件零扩签,钉现行数(将来任何加词即转红提示复核)。
|
||||||
|
# 32→31:改写族清退批摘 spike(CI run 87 追绿——词表合法收窄的断言随动)。
|
||||||
|
|
||||||
func _test_effect_kinds_closed() -> void:
|
func _test_effect_kinds_closed() -> void:
|
||||||
Kit.check("效果引擎效果类型闭集 32 种(甲案词表退役——overflow/attack_segments 摘名)〔锻造工坊批 V11〕",
|
Kit.check("效果引擎效果类型闭集 31 种(甲案词表退役 overflow/attack_segments+改写族清退摘 spike)〔锻造工坊批 V11〕",
|
||||||
EffectEngineScript.EFFECT_KINDS.size() == 32)
|
EffectEngineScript.EFFECT_KINDS.size() == 31)
|
||||||
Kit.check("效果引擎事件词表在册 21 种(charge_full 位摘名——蓄力层删键批)〔锻造工坊批 V11〕",
|
Kit.check("效果引擎事件词表在册 21 种(charge_full 位摘名——蓄力层删键批)〔锻造工坊批 V11〕",
|
||||||
EffectEngineScript.EVENTS.size() == 21)
|
EffectEngineScript.EVENTS.size() == 21)
|
||||||
@@ -221,7 +221,10 @@ func _test_layout_cache(db) -> void:
|
|||||||
await process_frame # 换代图真实绘制路径重算(缓存随内容变失效重写)
|
await process_frame # 换代图真实绘制路径重算(缓存随内容变失效重写)
|
||||||
var pc1: Dictionary = screen.layout_probe(chain)
|
var pc1: Dictionary = screen.layout_probe(chain)
|
||||||
var pc2: Dictionary = screen.layout_probe(chain)
|
var pc2: Dictionary = screen.layout_probe(chain)
|
||||||
|
# 第三判据原=新旧图 id0 位置差——改前靠容器延迟收敛的 origin 中间态偶然成立(换图首探针
|
||||||
|
# 画布未及重排,origin≠0);视口化批画布同帧收敛(canvas.size 恒=内容包络)后两图 origin
|
||||||
|
# 恒等、id0 同层同槽位置恒等,前提失义。等强换键=重算字典键数恰为新图节点数(旧缓存
|
||||||
|
# 63 键,换代不重算必不成立),同一性判据(核心失效重算面)不动。
|
||||||
Kit.check("布局缓存换代:新图查询返回新实例非旧缓存(失效重算生效)〔levelmap批 V2〕",
|
Kit.check("布局缓存换代:新图查询返回新实例非旧缓存(失效重算生效)〔levelmap批 V2〕",
|
||||||
not is_same(p1, pc1) and is_same(pc1, pc2)
|
not is_same(p1, pc1) and is_same(pc1, pc2) and pc1.size() == chain.size())
|
||||||
and (pc1[chain[0]] as Vector2) != (p1[nodes[0]] as Vector2))
|
|
||||||
screen.queue_free()
|
screen.queue_free()
|
||||||
@@ -1,21 +0,0 @@
|
|||||||
# 迭代 53 反哺点清单(2026-11-05)
|
|
||||||
|
|
||||||
- 接收方:[待办清单](../待办清单.md)(反哺点裁决后由文档批/工程批写入并把本清单条目清掉)。
|
|
||||||
- 依据:`reports/iter53-实现报告-2026-11-05.md`;两卡「关联文档同步面」逐条落点如下。
|
|
||||||
|
|
||||||
| # | 落点(哪个文件哪一节) | 改成什么 | 依据 |
|
|
||||||
|---|---|---|---|
|
|
||||||
| 1 | `design/gdd/systems/跨局循环/锻造工坊.md` §满级特效扩展位——重甲反震候选条 | 实现前提句补一句:反弹伤害需新开消费点(本批摘 `spike` 词表位后彻底无位,候选=「需新代码」档) | 卡② §6 第 2 行;damage_controller.gd 摘除后 `open_ticket` reflect 通道为唯一反弹面且零现役表行 |
|
|
||||||
| 2 | `design/gdd/systems/战斗循环/增益状态.md`/`伤害与护甲.md` | 零命中备案——两文档叙述「按序改写族」的句子未挂退役件名,无需改动 | 卡② §6 机械面核对读数(40 名扫描两文件零命中) |
|
|
||||||
| 3 | `design/gdd/systems/冒险循环/奇物.md`、`systems/战斗循环/地图战斗资源.md`、`design/gdd/术语表.md`、`00-游戏概念.md`、`03-内容规模.md` | 各文仍提退役内容名的句子逐处换机制名(清退口径同卡② T3:只换名不换职责) | 卡② §5 去向表;40 名扫描命中所在(GDD 面不在本批可写域) |
|
|
||||||
| 4 | 结算明细标签是否入表(文案硬编码 `reward_grant.gd:226`) | 规范裁决点:玩家可见明细文案归属——维持代码硬编码 or 入数据表行;裁决后改对应规范文档 | 卡② §5 去向表末条;本批已把标签换代为「挖掘惩罚减半(%d→%d)」 |
|
|
||||||
| 5 | `tools/gate_platform.sh` `gate_run_timeout` | 修 Windows 恒 124 缺陷:`kf` 改「先赋路径、`rm -f` 后置守卫」(probe_gate.sh run_suite 同款正确写法);连带修 `golden_baseline_refresh.sh` 的 guard 子Shell kill 短路(7 分钟等待症状) | iter53 实现报告「遗留读数义务与发现呈报」第 1 条;实证=直接调用 4 秒返回 124、refresh 两次 7m1s |
|
|
||||||
| 6 | `game/tests/golden/mac/` | mac 侧补冻关卡视口两 Shot 基线(跑 `golden_baseline_refresh.sh --lmap`) | 渲染闸 lmap 段缺基线记 SKIP;windows 已冻结(6394abf7),mac 冻结后两平台同盯 |
|
|
||||||
| 7 | `game/tests/golden/README.md` §时效判定纪律 | 「基线冻结于 2026-09-30」句补 lmap 两 Shot 冻结日(2026-11-05)与两 Shot 面口径指针 | 本批 golden/README 台账已改现持清单,冻结纪律节的时间句留待文档批随批换代 |
|
|
||||||
| 8 | `game/tests/README.md` 能力行 :163(关卡画面视口平移) | 代表用例名 `_probe_clamp_bounds` 回表为落地名 `_probe_clamp_bounds_and_columns`(实现按卡 §8 对照表外的更 descriptive 名落地,回表归写卡段) | 验收审计 D1(建议级):名实回表义务 |
|
|
||||||
| 9 | 探针直读申报口径(test-conventions §8.2/§8.4 受控例外注记) | 「探针直读视口子件结构(`get_child(0)` 画布位、按名取指引子件 FadeL/FadeR/PanHint)」补进探针直读惯例的申报面注记 | 验收审计 D2(观察级):直读有注释理由、零风险,补成文口径 |
|
|
||||||
| 10 | `reports/iter53-实现报告-2026-11-05.md` 决定 3 | 已随本清单同批订正(case⑰→⑱ 笔误)——归档备查,无文档批动作 | 验收审计 D3 |
|
|
||||||
|
|
||||||
## 零反哺备案
|
|
||||||
|
|
||||||
- 卡① `design/gdd/ux/level-map.md`:实现未发现 spec 缺口——布局决策 5 行为四条+像素级判据①–④+AC 260–271 全部有绿读数承载(实现报告对照表 R1–R9+golden 段)。
|
|
||||||
@@ -1,80 +0,0 @@
|
|||||||
# 迭代 53 实现报告(2026-11-05)
|
|
||||||
|
|
||||||
- 接收方:[待办清单](../待办清单.md)条目「超预算图策略升级路径——等比缩放与滚动视口两案待裁」(卡①卷轴视口批)+「damage_controller 按序改写族——内容孤儿机制与退役名注释层」(卡②改写族清退批)。
|
|
||||||
- 需求卡片:`reports/需求卡片-卷轴视口批-2026-11-05.md`(验收档:中)+`reports/需求卡片-改写族孤儿机制与退役名清退批-2026-11-05.md`(验收档:中)。
|
|
||||||
- 独立验收审计:`reports/iter53-验收审计-2026-11-05.md`(未参与实现的会话执行;两卡均按中档深度)。
|
|
||||||
- 执行形态:整迭代单工作区(`g-plan2-iter53`,两卡均未声明可并行),卡序=卷轴视口 → 改写族清退。
|
|
||||||
|
|
||||||
## 各卡状态
|
|
||||||
|
|
||||||
| 卡 | 状态 | T 卡 | 凭据摘要 |
|
|
||||||
|---|---|---|---|
|
|
||||||
| 卡①卷轴视口批 | 完成(T0–T4 全收口+golden 扩项冻结) | T0 基线读数在案/T1–T3 实现波提交 c1043902/T4 指针反转 4e87a012/golden 扩项 6394abf7 | 新探针 26 断言全绿+探针族全绿+冒烟 15/0+S13 基线内 7 新增 0+渲染闸全绿(lmap 双图 changed=0.00%) |
|
|
||||||
| 卡②改写族清退批 | 完成(T0–T5 全收口) | T0 基线读数在案/T1 b5c21e3a/T2 1bd50304/T3+T4 并笔 ed793e8c | 三套件+四套窄测 exit=0+对拍六组逐字节 diff=0+四探针负域全拒+契约 1 三条 grep 全零+40 名注释面清零 |
|
|
||||||
|
|
||||||
## 卡① 实际改动—验收对照表
|
|
||||||
|
|
||||||
| 需求点 | 改动(文件:行) | 验收测试(落点+尾缀) | 层级 | 真实入口 | 判据绑定面 | 结果 |
|
|
||||||
|---|---|---|---|---|---|---|
|
|
||||||
| R1 浅图整幅居中无裁切 | level_map_screen.gd 三段页承载+level_map_viewport.gd `_axis_center_offset` 居中分支 | `level_map_viewport_probe.gd:71/74/76`〔卷轴批 V1〕 | 探针 | `open_choices` 真实停点(L1 固定种子直构 runner) | 画布≤窗居中 offset 定位+画布矩形 encloses 于视口 | 绿 |
|
|
||||||
| R2 停点切换当前节点居中 x=640±2 | level_map_viewport.gd `reanchor`+screen `_viewport_anchor`/open_choices 接线 | `level_map_viewport_probe.gd:221`〔卷轴批 V2〕 | 探针 | 断点停点重建+真实 `open_choices` | 当前节点画布投影=视口中线±2 | 绿 |
|
|
||||||
| R3 拖拽平移 | screen `_on_canvas_motion` 拖拽态逐帧 `pan_by`(含激活帧位移) | `level_map_viewport_probe.gd:137`〔卷轴批 V3〕 | 探针 | `push_drag_at` 合成沿走 `push_input` | 视线位移=拖拽位移(40px 逐位) | 绿 |
|
|
||||||
| R4 滚轮横滚 | screen `_wheel_pan_step` 映射(下/右=前进向) | `level_map_viewport_probe.gd:114/116/120`〔卷轴批 V4〕 | 探针 | `push_wheel_at` 合成滚轮沿 | 单档 ±60 逐位+窗内不钉边界 | 绿 |
|
|
||||||
| R5 clamp 包络与首末列可达 | level_map_viewport.gd `_axis_pan_offset`/`is_clamped_at_edge` | `level_map_viewport_probe.gd:88/102/158/160/161/167/168`〔卷轴批 V5〕 | 探针 | 超包络拖拽沿两极 | 中线恒在夹紧域+两极 edge=true+首末列中心入屏+入口组包围盒锚点 | 绿 |
|
|
||||||
| R6 拖拽不触发选路 | screen `_on_canvas_click` 拖拽抬杆不提交 | `level_map_viewport_probe.gd:200/201/206`〔卷轴批 V6〕 | 探针 | 拖拽沿/完整点击沿起止候选上方 | `route_chosen` 零发射+屏未关;完整点击仍提交=1 | 绿 |
|
|
||||||
| R7 平滑滚动与减动效瞬切 | level_map_viewport.gd `reanchor(smooth)` tween `UiKit.motion(0.3)`+`ArmedTimer.motion_still` 跳终态 | `level_map_viewport_probe.gd:245/249/258`〔卷轴批 V7〕 | 探针 | 可见屏停点切换+`UiKit.motion_scale` 置位 | 平滑有 tween 中间帧(同向在途)+减动效即达 | 绿 |
|
|
||||||
| R8 指引件可见性与几何 | level_map_viewport.gd `_build_guidance`/`_sync_guidance` | `level_map_viewport_probe.gd:271–287`〔卷轴批 V8〕 | 探针 | 深图真实停点+浅图复验 | 渐隐带 70px+chip 240×30 居中可见;浅图隐藏 | 绿 |
|
|
||||||
| R9 schema 头注指针反转(非行为) | level_gen_params.gd:3-4/:66 头注 | 静态判据:grep「调参表」残留=0、「参数契约节」指向=2;`--check-only` 零错 | 静态 | — | 全仓无「域并单点=调参表」残留 | 绿 |
|
|
||||||
| golden 两 Shot 面(2026-11-05 用户裁) | level_map_shot_probe.gd+golden/windows/lmap_entry·lmap_boss+render_gate.sh 对拍段 | 渲染闸「关卡视口 golden 逐像素」段(changed=0.00% 双绿);重采集确定性=0.00% | golden | 窗口化真实渲染+固定种子 | 两 Shot 逐像素 ≤16 差/≤2% | 绿 |
|
|
||||||
|
|
||||||
非行为改动行:无(R9 之外全部行为面;`.uid` 边车随新件入库)。
|
|
||||||
|
|
||||||
## 卡② 实际改动—验收对照表
|
|
||||||
|
|
||||||
| # | 需求点 | 改动(文件:行) | 验收测试(落点+尾缀) | 层级 | 真实入口 | 判据绑定面 | 结果 |
|
|
||||||
|---|---|---|---|---|---|---|---|
|
|
||||||
| R1 | 摘四段不可达改写分支 | damage_controller.gd(原 :297-302/:305-309/:310-314/:316-323/:350-353/:367-372/:623 全摘+spike_ready 键摘) | `damage_controller_test.gd`(exit=0);`roll_multiplier_test.gd`(exit=0);`round_flow_skill_pool_test.gd`(exit=0);dump_battle 六组改前改后逐字节比对 diff=0 | 单元+集成 | `BattleOrchestrator.begin_battle()` 全链 | step_row 流逐位=改前基线(L{1,2}×S{42,779401,779501});静态=契约 1 三条 grep 全零+摘后 `spike_ready` 零残留。观测面局限申报:零现役注册行使分支不可达,禁注入表行取证(卡 §8 申报在案) | 绿 |
|
|
||||||
| R2 | EFFECT_KINDS 摘 spike | effect_engine.gd:30 | `effect_kind_retired_test.gd:89`「effect_kind_retired_test/③词表闭面:kind=spike 出域拒绝」 | 单元(负面,独立进程) | `ConfigDB.load_tables()` → `validate_trigger_row` | do.kind=spike 行被拒+error 诊断在案+退出码 1(负面期望码) | 绿 |
|
|
||||||
| R3 | DO_KEYS 摘 trade_hit/trade_atk | effect_engine.gd:82 | `effect_kind_retired_test.gd:92`「effect_kind_retired_test/④do 键闭面:trade_hit 出域拒绝」 | 单元(负面,独立进程) | 同上 | 带 trade_hit 键 do 字典被拒+退出码 1 | 绿 |
|
|
||||||
| R4 | 注释面退役名清零(13 文件) | T3 35 处注释改写(对照卡 3.3 表逐处) | 静态判据:40 名全扫仅剩卡 §5 留底 3 行(treasure_items_test:31/33/35 StubDB 夹具名);宿主套件逐位不变(四套窄测 exit=0) | 静态(闸件扫描) | 宿主套件回归(改写面不进运行期) | 注释面命中 0+套件绿 | 绿 |
|
|
||||||
| R5 | 减半明细行去退役件名 | reward_grant.gd:226(标签→「挖掘惩罚减半(%d→%d)」+effect_id→nest_halve) | `meta_progression_forge_test.gd:694/697/699/700`(断言串随动,非空+等值+不含旧词强度不降) | 集成(信号采集) | 锻造锋线满级特效 → begin_battle → mine_hit 减半路径 → step_row | display_name==「挖掘惩罚减半(6→3)」+power 减半数值与发射次数逐字不变+grep nest_counter=0 | 绿 |
|
|
||||||
| R6 | 空集拒绝 reason 去退役件名 | reward_grant.gd:189(→「中立移除:…」) | 静态判据:grep 爆破工兵包 reward_grant.gd=0;`table_structure_guard_test.gd` exit=0 | 静态+单元 | 通道校验面(零现役行不可达) | grep 零命中+通道校验绿。观测面局限申报:reason 不可达,禁造行取证 | 绿 |
|
|
||||||
| R7 | 反弹明细标签去退役件名 | grant_segment.gd:166(标签→「反弹伤害」+归因串→attune_nest_halve;channel=="reflect" 判据与开单参数字典逐字不动) | 静态判据:grep 惊巢反制 game/=0、attune_nest_counter=0;`round_flow_skill_pool_test.gd` exit=0 | 静态+集成 | mine_hit 订阅施加链(reflect 行族零表行,今天不可达) | grep 零命中+发射面零变化回归。观测面局限申报:禁造行取证 | 绿 |
|
|
||||||
| R8 | sim 恒 false 匹配删除 | level_autoplay.gd(原 :415 注释+:421 contains(雷区图谱) 条件删,highlight==seal_hit 单判据保留) | 静态判据:grep 雷区图谱 game/=0;sim 驱动链套件绿(四套窄测含 autoplay 消费面 exit=0) | 静态+单元 | autoplay 驱动链(测量面) | grep 零命中+套件绿。观测面局限申报:恒 false 条件不可达 | 绿 |
|
|
||||||
|
|
||||||
非行为改动行:T3 注释面 35 处(由 R4 行覆盖);契约 3 约束下 :226/:166 仅标签与归因串文本变动、取值/位序/载荷键逐字未动(R1 对拍 diff=0 为其逐位证据)。
|
|
||||||
|
|
||||||
## 读数义务对账(卡内 T 卡产出)
|
|
||||||
|
|
||||||
- **卡①T0**:S13 基线无 `level_map_screen` 键(记「无键、按工具默认」);ui_struct_probe PASS 全屏结构断言零红;screen_flow_probe PASS;冒烟 15 项 0 失败。
|
|
||||||
- **卡①T4 复跑**:S13 基线内 7 条、新增 0(`_on_canvas_input` 重构触发的 max-branches 新违规已拆 `_on_canvas_motion`/`_on_canvas_click`/`_wheel_pan_step` 归零);ui_struct_probe/screen_flow_probe 复跑绿(探针族全绿内含)。
|
|
||||||
- **卡②T0**:契约 1 三条 grep——`game/data/tables/` 内 spike/armor_rewrite/discount_shift/trade_hit/trade_atk 全零(对照记录=feats.tres:855 clamp_bonus 现役一行);tree_rules 面零;effect_kinds 面 cell_removal 表面零(仅 schema 在册:treasure_item_table.gd:20/:26,本批不摘通道)。S13 四文件无登记键(damage_controller/effect_engine/reward_grant/level_autoplay 均按工具默认)。改前对拍基线六组落盘(L{1,2}×S{42,779401,779501})。改前断言串=「惊巢反制——危险格挖掘惩罚减半(6→3)」(:693/:698-701 现行文本抄录在案)。
|
|
||||||
- **卡②T5**:改后对拍六组 diff=0;40 名全扫终读数=3 行留底夹具;R5–R8 静态 grep 全零;负域套件 exit=1(期望码)四探针全拒。
|
|
||||||
- **存量触面 S13 对照**:damage_controller(分支数/函数长度随摘除下降,无新增键);effect_engine(常量字面量变短,方法数/成员数不变);reward_grant/level_autoplay(删文本与恒 false 条件)——S13 终读数=基线内 7、新增 0、恶化 0。
|
|
||||||
|
|
||||||
## 实机目检总清单(登记不阻塞)
|
|
||||||
|
|
||||||
| 目检项 | 来源卡 | 承载 |
|
|
||||||
|---|---|---|
|
|
||||||
| 深度 13+ 图拖拽可达首末列、推进跟随方向感、chip 不碍选路 | 卡① | 窗口化实跑截图已冻结(golden/windows/lmap_entry·lmap_boss);真人试玩复核登记体验验证清单(归批后收尾) |
|
|
||||||
| 结算明细行减半标签「挖掘惩罚减半(6→3)」一眼可读、无退役件名突兀感 | 卡② | 实现报告登记;真人目检归体验验证清单(归批后收尾) |
|
|
||||||
|
|
||||||
## 实现决定记录(超白名单/超卡片明列面逐条备案)
|
|
||||||
|
|
||||||
1. **拖拽态成员落屏侧**(卡①§11 把 `_drag_active`/`_drag_accum` 枚举进视口件成员,§6 职责边界却写明视口件「只管裁切/offset/clamp/跟随」、拖拽判定留画布)——取 §6 职责边界优先:拖拽判定状态随输入处理落 screen(`_drag_active`/`_drag_press_pos`),视口件成员 6 个(≤8 达标)、公开方法 5 个(≤20 达标)。撤销方式=成员迁视口件+canvas 经方法驱动(纯结构搬移)。
|
|
||||||
2. **open_choices 平滑判据=有无当前节点**(卡①§6 写「reanchor(false) 首锚」、T2 写「停点切换/回图接 reanchor(true)」,open_choices 同时承载两路径)——合并读法:入口停点(current_node_id<0)即达=首锚,其余停点/兑付回图平滑=跟随。R2/R7 断言均经此路径。
|
|
||||||
3. **提交沿移至抬杆**(原提交在按下沿;布局决策 5 阈值区分语义下按下时无法预知是否成拖拽,R6 要求拖拽沿零发射)——完整点击(按下→未超阈值抬杆)提交、拖拽抬杆不提交;ui_input_probe case⑫/⑱ 补 release 沿适配(验收审计 D3 订正:原呈报误写⑰,实际落点两处)(判据语义「图上真实点击提交选路」不变,输入形态更完整)。
|
|
||||||
4. **滚轮步进 60px、渐隐带色 BG_ROOT 不透明端 0.9、chip 底 HP_BAR_BACK/描边 STONE/文字 WARM、缓动 TRANS_CUBIC+EASE_OUT**——卡 §12 白名单 4/5/3 授权面内定值。
|
|
||||||
5. **视口件 NOTIFICATION_RESIZED 即席重锚**——首开布局晚于 open_choices 锚定(隐藏子树容器排序首可见帧才传播,4.7 行为;实证=探针首跑 y 锚偏 88px),resize 即席 `reanchor(false)` 收敛;同时是窗口尺寸变化的正确行为。
|
|
||||||
6. **_fit_canvas 画布尺寸同帧收敛**(`canvas.size = _content_size` 显式置)——视口锚点数学与 `_layout` 同源读画布尺寸,容器延迟收敛不等锚点。
|
|
||||||
7. **mouse_exited 清拖距跟踪器**——按下即武装的跟踪器在丢失 release 沿(alt-tab 等)后残留会把后续 motion 误判为拖拽激活(ui_input_probe case⑰⑧ press-only 实证);非拖拽态离画布即解除。
|
|
||||||
8. **卡②探针①注入 do.kind="spike"**(卡 T2 括注 kind=modify_ticket+mode=spike 形态)——括注形态无拒绝通道(`validate_trigger_row` 无 mode 值域检查,mode 属载荷字段非词表),按断言名「词表闭面:kind=spike 出域拒绝」与 R2 判据绑定面(effect_kinds 出域文案)的机制注入 kind 形态。
|
|
||||||
9. **golden 两 Shot 面口径**(卡①现状事实写「本批不触渲染闸对拍」、批纪律 iter 4.4+test-conventions §8.2 要求扩项)——呈裁用户,2026-11-05 裁「只处理最初始的和最终的:关卡最开始+关卡 Boss 节点,中间过程不对拍」,按两 Shot 面扩项冻结。
|
|
||||||
10. **卡② T3 与 T4 并笔提交**——卡 §10 白名单授权面。
|
|
||||||
|
|
||||||
## 遗留读数义务与发现呈报
|
|
||||||
|
|
||||||
1. **闸件缺陷呈报(工程批)**:`tools/gate_platform.sh` 的 `gate_run_timeout` 用 `mktemp` 造超时标志文件——mktemp 即建文件,末尾 `[ -f "$kf" ]` 在 Windows(Git Bash)恒真→**恒返回 124**。被各闸「判定锚工件而非退出码」口径掩住(菜单/棋盘 golden 段与本批 lmap 段均工件锚定,不受影响);`tools/golden_baseline_refresh.sh` 的 7 分钟等待症状(guard 子Shell `sleep 420` 未被 kill 短路)同根。修法=改 `kf="$TMP/..." ; rm -f "$kf"`(run_suite 同款,probe_gate.sh 已是正确写法)。本批不代修(闸件改动归工程批)。
|
|
||||||
2. **mac 端关卡视口基线冻结义务**:`golden/mac/` 缺 lmap_entry/lmap_boss——渲染闸缺基线记 SKIP 不判红(windows 已锚即盯),mac 冻结归 mac 侧跑 `golden_baseline_refresh.sh --lmap`。
|
|
||||||
3. **效果通道与事件词的零现役普查**——已在待办清单在册(卡② §5 去向),本批不扩。
|
|
||||||
4. 卡① level-map.md 同步面:实现未发现 spec 缺口(布局决策 5 行为四条+像素级判据+AC 全部有绿读数承载),零反哺。
|
|
||||||
@@ -1,122 +0,0 @@
|
|||||||
# 迭代 53 验收审计(2026-11-05)
|
|
||||||
|
|
||||||
- 审计员:独立会话子代理——未参与本迭代任何实现、设计或写卡工作,只读证据做审计。
|
|
||||||
- 审计对象:迭代 53 两张需求卡片——卡①卷轴视口批(`reports/需求卡片-卷轴视口批-2026-11-05.md`)+卡②改写族孤儿机制与退役名清退批(`reports/需求卡片-改写族孤儿机制与退役名清退批-2026-11-05.md`)+卡① golden 扩项(2026-11-05 用户裁两 Shot 面)。
|
|
||||||
- 实现报告:`reports/iter53-实现报告-2026-11-05.md`(两卡「实际改动—验收对照表」为逐行核对基准)。
|
|
||||||
- 验收档与实际执行深度:两卡均申报「中」档;本次按 test-conventions §8.7 中档执行——对照表逐行全量核对(两卡 R 行逐行)、判据绑定面抽查(超出下限)、测试削弱检查逐处、直查例外核对逐条、判据出处抽查 6 处。**最窄测试复跑=省略,该格写「合回后 CI 现查补记」**(合并尚未发生——本审计为合并前置闸,远端 CI 现查读数待合回落地后按 `tools/ci_check.sh <合并提交>` 补记;静态 grep/文件核对类检查由审计员当场重跑,不属省略面)。
|
|
||||||
- 基线提交:`709d9a85..8b4399ad`(iter53 分支;7 笔实现笔 c1043902/4e87a012/b5c21e3a/1bd50304/ed793e8c/6394abf7/78e08234 + 1 笔并 master 8b4399ad)。工作树存在本机 Godot 导入元数据漂移(若干 `*.png.import` 未提交改动),不属提交面审计对象。
|
|
||||||
- 审计动作面:`git diff 709d9a85..HEAD` 全量过目(37 文件);测试/探针/闸件改动逐 hunk 核对;契约 1 五词 grep、40 名退役名全扫、契约 5 残留 grep 由审计员当场重跑。
|
|
||||||
|
|
||||||
## 卡① 卷轴视口批(验收档:中|执行深度:中档)
|
|
||||||
|
|
||||||
### 对照表逐行核对(全量)
|
|
||||||
|
|
||||||
| 行 | 结论 | 依据(文件:行) |
|
|
||||||
|---|---|---|
|
|
||||||
| R1 浅图整幅居中无裁切 | 通过 | 断言在案且尾缀可 grep:`game/probe/level_map_viewport_probe.gd:71/74/76`〔卷轴批 V1〕;承载改造落地 `level_map_viewport.gd:30-36`(setup/clip_contents)+`level_map_screen.gd:134-145`(CenterContainer→视口件);真实入口=`open_choices` 真实停点(探针 :62-64,L1 固定种子直构 runner,start_level_external 注入)。运行读数=实现者「绿」在案;合回后 CI 现查补记 |
|
|
||||||
| R2 停点切换当前节点居中 x=640±2 | 通过 | 断言 `level_map_viewport_probe.gd:221`〔卷轴批 V2〕;断言钉屏空间投影(当前节点屏幕 x 对视口中心 ±2)——比卡面所写 `viewport_center_canvas_pos()` 调用更外层的真实观测,与 level-map.md:101/:154 判据①「居屏中线 x=640±2」同义,非削弱(观察 4);真实入口=断点停点重建+真实 `open_choices`(探针 :216-217)→ screen `reanchor` 接线 `level_map_screen.gd:312-315`+锚点提供方 :483-516。合回后 CI 现查补记 |
|
|
||||||
| R3 拖拽平移 | 通过 | 断言 `level_map_viewport_probe.gd:137`〔卷轴批 V3〕;真实输入沿=`ProbeUiUtil.push_drag_at`(`game/probe/probe_ui_util.gd:146-166`,press→motion×4→release 全经 `push_input`)打真实画布 `_gui_input`(`level_map_screen.gd:381-403` 拖拽态逐帧 `pan_by`)——**未绕过改动点**(探针全文零 `pan_by` 直调,grep 证);判据=视线位移=拖拽位移 40px 逐位。合回后 CI 现查补记 |
|
|
||||||
| R4 滚轮横滚 | 通过 | 断言 `level_map_viewport_probe.gd:114/116/120`〔卷轴批 V4〕;`push_wheel_at`(probe_ui_util.gd:168-176)经 `push_input`;映射 `_wheel_pan_step`(level_map_screen.gd:426-433,下/右=+60 前进向,代拍板白名单 5 授权)。合回后 CI 现查补记 |
|
|
||||||
| R5 clamp 包络与首末列可达 | 通过 | 断言 `level_map_viewport_probe.gd:88/102/158/160/161/167/168`〔卷轴批 V5〕;判据绑定 `viewport_center_canvas_pos()` 夹紧域(level_map_viewport.gd:76-77/:97-100/:111-114)+`is_clamped_at_edge()` 两极翻转(:81-86)+极值列入屏(:161-169,等价 spec 判据④);真实入口=超包络拖拽沿两极。合回后 CI 现查补记 |
|
|
||||||
| R6 拖拽不触发选路 | 通过 | 断言 `level_map_viewport_probe.gd:200/201/206`〔卷轴批 V6〕;**拖拽沿确从候选节点上方起沿**(:193 `gpos`=候选屏幕投影,:197 `push_drag_at(self, gpos, …)` 起点即候选);判据绑 `route_chosen` 发射面零计数(screen `route_chosen.emit` :465)+屏未关+阈值另一侧完整点击提交=1(:203-206,点击沿 press+release 成对经 push_input)。合回后 CI 现查补记 |
|
|
||||||
| R7 平滑滚动与减动效瞬切 | 通过 | 断言 `level_map_viewport_probe.gd:245/249/258`〔卷轴批 V7〕;tween 单段缓动 TRANS_CUBIC-EASE_OUT UiKit.motion(0.3)(level_map_viewport.gd:57-59);减动效走 `ArmedTimer.motion_still()`(armed_timer.gd:16-17=motion_scale<1)跳终态——探针置 `UiKit.motion_scale=0.5` 即设置面单点(settings_overlay.gd:96 同驱),判据同向在途+即达。合回后 CI 现查补记 |
|
|
||||||
| R8 指引件可见性与几何 | 通过 | 断言 `level_map_viewport_probe.gd:272-278`+浅图隐藏 :289〔卷轴批 V8〕;几何常量 FADE_BAND_W=70(level_map_viewport.gd:10)、CHIP_SIZE 240×30(:11)直挂 spec 判据②③;可见性=`_sync_guidance` 画布超窗判据(:181-191)。合回后 CI 现查补记 |
|
|
||||||
| R9 schema 头注指针反转(非行为) | 通过(静态重跑) | `level_gen_params.gd:3-4`+:70 反转落地;审计员重跑 grep:该文件「调参表」残留=0、「参数契约节」指向=2、`--check-only` 读数实现者在案。全仓唯一「调参表」残留=variation_table.gd:41(地形变异 v1.2 owner,不同文件不同域,不属本卡清退面) |
|
|
||||||
| golden 两 Shot 面(用户裁) | 通过 | `game/probe/level_map_shot_probe.gd`(PASS 签名 :36+落盘 fail-fast :89-91)+`game/tests/golden/windows/lmap_entry.png`/`lmap_boss.png` 已入库(6394abf7,Bin 215164/211513 字节)+`tools/render_gate.sh:168-197` 对拍段(PASS 签名+双图非零工件锚定+平台缺基线 SKIP 不判红)+`tools/golden_baseline_refresh.sh` --lmap 模式(:59-85,素材齐盘守卫)+`game/tests/golden/README.md` 台账随动;mac 缺基线义务已呈报(实现报告遗留 2+反哺点 6)。运行读数(changed=0.00% 双绿)=实现者在案;合回后 CI 现查补记 |
|
|
||||||
|
|
||||||
卡①补充核对:26 断言计数属实(探针 26 处 `_check`+尾缀〔卷轴批 V1..V8〕27 行含 1 处缺位告警);`tools/probe_gate.sh:137-141` 注册新探针;ui_struct_probe 本批零改动(未触其结构断言面,卡①削弱申报该项落空=无事);实现报告实现决定 1-7(拖拽态落屏侧/open_choices 平滑判据/提交沿移抬杆/代拍板白名单定值/resize 即席重锚/_fit_canvas 同帧/mouse_exited 清跟踪器)均有代码承载且不越卡 §12 白名单;7 笔实现笔无一触碰 `design/`/两份根清单/`game/tests/README.md`(逐笔 name-only 核对)。
|
|
||||||
|
|
||||||
### 判据绑定面抽查(本卡抽 4 行,超中档下限 2 行)
|
|
||||||
|
|
||||||
- R6(如上)——`route_chosen` 零发射+屏未关+完整点击仍提交,三面钉在「拖拽不提交/点击提交」的特有提交面上。
|
|
||||||
- R2(如上)——当前节点屏空间投影=视口中线 ±2。
|
|
||||||
- R5(如上)——夹紧域+两极 edge 翻转+极值列入屏。
|
|
||||||
- R3(如上)——拖拽位移与视线位移逐位一致,且全程走引擎输入管线。
|
|
||||||
|
|
||||||
### 直查例外核对(逐条)
|
|
||||||
|
|
||||||
| 直查行 | 申报状态 | 结论 |
|
|
||||||
|---|---|---|
|
|
||||||
| `level_map_viewport_probe.gd:67` `vp.get_child(0)`(取视口画布子件) | 探针内注释已给理由(「画布=视口首子件——setup 注入序」,:61),对照表/实现报告**未单列申报口径** | 缺漏(建议级,见末节 D2)——断言对象即承载结构本身,无公开可观测面可钉,风险零 |
|
|
||||||
| `level_map_viewport_probe.gd:266-268/:287-288` 按名取 FadeL/FadeR/PanHint | 同上——探针内注释在案,对照表未单列 | 缺漏(建议级,并入 D2)——R8 断言对象即指引子件结构本身 |
|
|
||||||
| screen 侧私有成员 | 新探针**未直读**任何 screen 私有成员(`_drag_active`/`_drag_press_pos` 零探针触达);既有「探针直读冻结」惯例面(level_map_screen.gd:39/:57-64)未扩 | 通过 |
|
|
||||||
|
|
||||||
## 卡② 改写族孤儿机制与退役名清退批(验收档:中|执行深度:中档)
|
|
||||||
|
|
||||||
### 对照表逐行核对(全量)
|
|
||||||
|
|
||||||
| # | 结论 | 依据(文件:行) |
|
|
||||||
|---|---|---|
|
|
||||||
| R1 摘四段不可达改写分支 | 通过(静态面重跑一致;运行读数合回后 CI 现查补记) | diff 逐段核对:`damage_controller.gd` 命中侧交换/免掷覆盖/spike 置位/移档调用/增伤侧/spike 倍乘/`_discount_shift_up` 整函数全摘;`_ctx_rewrites` 返回键集={roll_read,threshold,crit,discount,clamp_hits}(:301-303)、`_hero_attack_ctx` 摘 spike_ready(:278-281)——与卡 T1 收窄键集逐字一致;armor_roll 发射点保留不接收返回值(:289-290,卡 3.6 口径);spike_ready/ar_hits/shift 残留 grep=0(审计员重跑)。六组逐字节对拍 diff=0 与三套件 exit=0=实现者读数在案;dump_battle 六组参数面(seed 42 默认+参数覆盖,dump_battle.gd:13/:21)核对成立 |
|
|
||||||
| R2 EFFECT_KINDS 摘 spike | 通过 | `effect_engine.gd:30` 词表摘名;断言 `effect_kind_retired_test.gd:89`「③词表闭面:kind=spike 出域拒绝」在案,沿既有 `_assert_rejected`/`_inject` 骨架(卡 T2 明示沿用);注入形态偏差(do.kind=spike,非卡 T2 括注 kind=modify_ticket+mode=spike)=实现决定 8 申报在案且经审计员核实——`validate_trigger_row`(effect_engine.gd:382-396)确无 mode 值域检查,括注形态无拒绝通道,实现口径与断言名/R2 判据绑定面(词表出域)一致。运行读数(负域套件 exit=1 四探针全拒)合回后 CI 现查补记 |
|
|
||||||
| R3 DO_KEYS 摘 trade_hit/trade_atk | 通过 | `effect_engine.gd:80-82` 摘两键;断言 `effect_kind_retired_test.gd:92`「④do 键闭面:trade_hit 出域拒绝」在案。运行读数合回后 CI 现查补记 |
|
|
||||||
| R4 注释面退役名清零 | 通过(40 名全扫审计员重跑) | 审计员自解析 `design/content-archive/道具退役素材库.md` 两表 40 名(41 减现役淬毒刃纹)重扫 `game/` 全域 .gd/.tres/.md/.tscn:命中仅 3 行=`treasure_items_test.gd:31/33/35` StubDB 夹具名——与卡 §5 留底申报逐行一致;契约 2 抽 4 处(grant_segment.gd:232「完美布防→封印全中倍率」、damage_controller.gd:109「猎巢人→nest_count 订阅消费面」、reward_grant.gd:130「掘进蓄能→付费积点账本」、grant_segment.gd:359「雷区图谱→标中雷追加」)——职责陈述(做什么/按什么序/取值从哪来)逐处保留,只换名;宿主套件绿=实现者读数,合回后 CI 现查补记 |
|
|
||||||
| R5 减半明细行去退役件名 | 通过 | `reward_grant.gd:226` 标签→「挖掘惩罚减半(%d→%d)」+effect_id→nest_halve;断言随动 `meta_progression_forge_test.gd:694/697/699-700`,强度三件(nc_hit 非空+等值「挖掘惩罚减半(6→3)」+零「挖雷」)与改前逐项对齐(基线 709d9a85:693-701 核对);grep nest_counter=0(审计员重跑)。合回后 CI 现查补记 |
|
|
||||||
| R6 空集拒绝 reason 去退役件名 | 通过(静态重跑) | `reward_grant.gd:189` reason 前缀→「中立移除:…」,`{"ok": false}` 形态未动(diff 核对);grep 爆破工兵包 game/=0(审计员重跑);观测面局限申报(reason 不可达、禁造行)在卡 §8/对照表一致在案 |
|
|
||||||
| R7 反弹明细标签去退役件名 | 通过(静态重跑) | `grant_segment.gd:165-166` 标签→「反弹伤害」+归因串→attune_nest_halve;**契约 3 逐字核对成立**:`channel=="reflect"` 判据、开单参数字典(channel/base_value/target_rule/ri/origin_cell)、`reward_grant.submit` 调用全未动(diff 对照基线 709d9a85:164-170);grep 惊巢反制/attune_nest_counter=0(审计员重跑)。运行读数合回后 CI 现查补记 |
|
|
||||||
| R8 sim 恒 false 匹配删除 | 通过(静态重跑) | `level_autoplay.gd:414-418` highlight=="seal_hit" 单判据保留、contains(雷区图谱) 条件与 :415 注释随删;grep 雷区图谱 game/=0(审计员重跑)。套件绿=实现者读数,合回后 CI 现查补记 |
|
|
||||||
|
|
||||||
卡②补充核对(契约逐条):契约 1 三条 grep 审计员重跑全零——tables 五词 0、tree_rules 面 0、cell_removal 表面 0 仅 schema 在册(treasure_item_table.gd:20/:26);`feats.tres:855` clamp_bonus 现役一行对照记录与实现报告 T0 一致,表内现存 mode 值(queue/round/battle/clamp_bonus/refresh)零退役四模式。契约 5 禁留空壳——spike_ready/ar_hits/shift/_discount_shift_up 残留 grep 全零(审计员重跑)。契约 6 实现批禁写文档——7 笔实现笔 name-only 核对零触 design//待办清单/体验验证清单/game/tests/README.md。契约 7 零新增数值——diff 内零 .tres 表值改动。反哺点清单 7 条落点齐(含「明细标签是否入表」裁决点+增益状态/伤害与护甲零命中备案)。
|
|
||||||
|
|
||||||
### 判据绑定面抽查(本卡抽 3 行)
|
|
||||||
|
|
||||||
- R2/R3(如上)——负域探针钉「退役词/键注入行→load_tables 拒绝+error 诊断≥1+进程退出码 1」;归属由夹具结构保证(copy_tables 全量现役表+唯一异常探针行)。观察 5:卡面写的「error 载荷含 effect_kinds 出域文案」未做逐字断言——沿用卡 T2 明示的既有骨架语义,非削弱。
|
|
||||||
- R5(如上)——step_row display_name 等值断言+非空+零旧词,判据绑减半路径特有发射面。
|
|
||||||
- R1 静态面(如上)——收窄键集逐字核对+摘除残留 grep,钉在「分支消亡」这一改动特有提交面。
|
|
||||||
|
|
||||||
### 测试削弱检查(逐处,两卡合并过目)
|
|
||||||
|
|
||||||
`git diff 709d9a85..HEAD -- game/tests/ game/probe/` 全量 hunk 过目,共 5 文件:
|
|
||||||
|
|
||||||
1. `effect_kind_retired_test.gd`:**纯新增**(两探针常量+两次 `_assert_rejected` 调用+PASS 文案随动);既有探针①②与 quit 语义零改动;`run_all.gd:195` 在册条目 expect=1/negative=true 未动。无削弱。
|
|
||||||
2. `meta_progression_forge_test.gd`:恰 4 处期望串随 R5 换代(:694 匹配串/:697 描述/:699-700 等值串)+2 行注释(卡 3.3 表申报面)——断言强度逐项不降(非空+等值+不含旧词全保留),与卡 §8 削弱申报逐字吻合。无申报外削弱。
|
|
||||||
3. `variant_placement_test.gd`:1 行注释(偏运硬币→订阅行,卡 3.3 表 :239 申报面),断言零改动。无削弱。
|
|
||||||
4. `ui_input_probe.gd`:+16 行=case⑫断言段(图上命中提交沿)+case⑱ 雾段(雾下点击零提交)各补 release 沿——实现报告决定 3 申报在案;判据语义核对:雾段=零提交不变(且改为完整点击沿后更强)、命中段=提交沿随新语义移至抬杆(单 press 沿在新语义下不再是提交沿,不适配则必红——必要适配非放宽)。**呈报笔误**:申报写「case⑫⑰⑧」,实际落点两处、无 ⑰(case⑰ 未开格类型微光走 `_push_click` 既有成对沿,无需适配)(建议级 D3)。
|
|
||||||
5. `ui_struct_probe.gd`:零改动——卡①「适配须保持语义」条款无事可核,非缺漏。
|
|
||||||
|
|
||||||
无申报外的断言删除、阈值放宽、扫描面缩小、换下层直调。
|
|
||||||
|
|
||||||
### 判据出处抽查(6 处,超下限 4 处)
|
|
||||||
|
|
||||||
| 断言预期值 | 规格出处 | 独立可写出性 |
|
|
||||||
|---|---|---|
|
|
||||||
| 居中 ±2(探针 R2 :221) | level-map.md:101「屏中线 x=640±2」/:154 判据①/:269 | 能——规格句直接给出 640±2 |
|
|
||||||
| 渐隐带 70px(探针 R8 :273-274) | level-map.md:104/:154 判据②「屏缘两侧各 70px 渐隐带」 | 能 |
|
|
||||||
| chip 240×30(探针 R8 :275-276) | level-map.md:104/:154 判据③「240×30、圆角 6」 | 能 |
|
|
||||||
| 「挖掘惩罚减半(6→3)」(forge 测试 :699-700) | 卡② §8 R5 判据明文+reward_grant.gd:226 契约 3 边界;6→3 可由测试构造独立推出(heal 行 power=6×halve 50% ceil=3) | 能——预期值在卡内先行锁定,非镜像实现 |
|
|
||||||
| 拖拽阈值 8px(DRAG_THRESHOLD,level_map_screen.gd:34) | 卡① §12 白名单 2「8px 附近 provisional 区间内定值」授权;spec :103 明示阈值实现期定值 | 能——授权面在卡,值属 provisional 自主面 |
|
|
||||||
| golden 两 Shot 面 | 2026-11-05 用户裁决(实现报告决定 9 在案):只对拍关卡最开始+Boss 节点 | 能——裁决记录在实现报告与 golden/README 台账双在案 |
|
|
||||||
|
|
||||||
六处均非「预期值只在实现里出现」的同义反复。
|
|
||||||
|
|
||||||
## 附加核对
|
|
||||||
|
|
||||||
- 能力行名实(game/tests/README.md:162-164 三行)::162 跟随行(_probe_follow_anchor/_probe_smooth_scroll_reduced_motion)与 :164 指引行(_probe_guidance_chrome)名实一致;**:163 平移行的 `_probe_clamp_bounds` 与落地名 `_probe_clamp_bounds_and_columns` 不一致**(建议级 D1——卡① §5「批末收尾核对表上名与落地一致(改名则回表)」未回表,反哺点清单亦未收录;实现批禁写 README,正确通道=回写卡段/反哺点)。
|
|
||||||
- 负面套件在册:`game/tests/run_all.gd:195` effect_kind_retired_test expect=1/negative=true 登记在位,卡② T2 未动在册条目——一致。
|
|
||||||
- S13 基线读数:`tools/gdstyle_baseline.txt` 恰 7 条且无本批触面键(level_map_screen/damage_controller/effect_engine/reward_grant/level_autoplay 均无键)——与实现报告 T0/T4 读数一致。
|
|
||||||
- 闸件缺陷呈报核实(实现报告遗留 1):`tools/gate_platform.sh:37` `kf="$(mktemp …)"` 即建文件+:48 `[ -f "$kf" ]` 恒真→恒 124,呈报描述与代码相符;probe_gate.sh:97 `kf="$TMP/killed.$RANDOM"`(先赋路径不预建)为正确写法参照——呈报属实;该缺陷修法归工程批,本审计不裁定(不在验收对象内,已入反哺点 5)。
|
|
||||||
|
|
||||||
## 缺漏与观察清单
|
|
||||||
|
|
||||||
阻断级:无。
|
|
||||||
|
|
||||||
建议级(不阻断合并,归批后收尾/文档批):
|
|
||||||
|
|
||||||
- D1:能力清单 `game/tests/README.md:163` 代表用例名 `_probe_clamp_bounds` ≠ 落地名 `_probe_clamp_bounds_and_columns`(卡① §5 名实核对义务未回表;反哺点清单漏收)。
|
|
||||||
- D2:新探针对宿主内部结构的直查(`level_map_viewport_probe.gd:67` get_child(0)+:266-268/:287-288 按名取指引子件)未按 test-conventions §8.7 第 4 条在对照表逐条申报口径;探针内注释已给理由(断言对象=承载结构本身,无公开观测面),screen 侧既有「探针直读冻结」惯例未被动用、新私有成员零直读,风险零。
|
|
||||||
- D3:实现报告/提交信息写「ui_input_probe case⑫⑰⑧ 补 release 沿」,实际落点为 case⑫断言段+case⑱雾段两处、无 ⑰——呈报笔误,判据语义已核保持。
|
|
||||||
|
|
||||||
观察(记录在案,不构成缺漏):
|
|
||||||
|
|
||||||
- O1:R2 判据绑定面用屏空间投影而非卡面所写 `viewport_center_canvas_pos()` 调用——更外层真实观测,与 spec 判据①同义,非削弱;连带 `game/tests/README.md:162` 读面句与实况有轻微出入。
|
|
||||||
- O2:卡② R2/R3 负域探针未逐字断言错误文案(沿用卡 T2 明示骨架语义;归属由夹具唯一异常行结构保证)。
|
|
||||||
- O3:卡① T1 写「探针宿主沿组合根真实屏」、卡 §8 对照表写「场景探针实例化本屏」——卡内两处口径不一,实现取对照表口径且在对照表真实入口格如实呈现;`push_input` 真实输入管线口径照守(禁合成投喂的实质红线未破)。
|
|
||||||
- O4:探针宿主直构 runner(start_level_external)属 test-conventions §5.4 自动化测试直构口径,探针头注已申报。
|
|
||||||
|
|
||||||
## 审计结论
|
|
||||||
|
|
||||||
**通过**(可合并;合并落地后按中档梯度以 `tools/ci_check.sh <合并提交>` 现查读数补记「最窄复跑」格——零触发或不可判不作绿证)。
|
|
||||||
|
|
||||||
- 卡①卷轴视口批(验收档:中):对照表 10 行全通过;绑定面抽查 4 行钉面成立;削弱零申报外;判据出处 4+ 处独立可写出;缺漏 3 项均建议级(D1 能力行名实回表、D2 直查申报口径补记、D3 呈报笔误)。
|
|
||||||
- 卡②改写族清退批(验收档:中):对照表 8 行全通过;契约 1/2/3/5/6/7 审计员重跑/逐处核对全部成立;削弱恰为申报内 4 处期望串且强度不降;40 名扫描与卡 §5 留底逐行一致;无阻断项。
|
|
||||||
- golden 扩项:两 Shot 面用户裁决在案、基线入库、闸件对拍段与台账齐;mac 冻结义务已呈报(反哺点 6)。
|
|
||||||
@@ -1,140 +0,0 @@
|
|||||||
# 需求卡片:卷轴视口批(关卡画面选路屏视口化)
|
|
||||||
|
|
||||||
- 来源:[待办清单](../待办清单.md)「超预算图策略升级路径——等比缩放与滚动视口两案待裁」条(状态=文档设计已闭合+待写卡,2026-11-05 用户裁滚动视口案落地)。
|
|
||||||
- **唯一事实源**:[level-map.md v2.0](../design/gdd/ux/level-map.md) §布局决策 5(行为四条表 :101–104+内嵌视口效果图 :108–153+像素级视觉判据 :154)+[关卡节点图生成.md v1.5](../design/gdd/systems/冒险循环/关卡节点图生成.md) §参数契约(图规模无呈现侧上限)。设计讨论四口子与效果图人审均 2026-11-05 用户裁决在案。
|
|
||||||
- **验收档:中**(呈现交互面——玩家可见但不损持久状态;无存档写读、无结算公式、无 RNG 触碰;批卡 U0 时确认或改判)。
|
|
||||||
|
|
||||||
## 1. 目标与完成定义
|
|
||||||
|
|
||||||
关卡画面(选路屏)落卷轴视口范式:画布随图生长可超屏,屏为窗口——①视口锚点=当前节点居中;②停点切换与兑付回图平滑滚动跟随(减动效瞬切);③拖拽+滚轮手动平移(clamp 画布包络、拖拽不触发选路);④屏缘渐隐带+平移提示 chip 指引。
|
|
||||||
|
|
||||||
完成定义:验证闸对照表 R1–R9 全部有绿读数;场景探针家族扩展件当轮真实跑批通过;代码域闸全绿;用户实机目检「深度 13 图拖拽可达首末列、推进跟随方向感」登记不阻塞。
|
|
||||||
|
|
||||||
## 2. 现状事实(开工自行复核)
|
|
||||||
|
|
||||||
- [level_map_screen.gd:26-32](../game/presentation/views/level_map_screen.gd) 冻结公式常量:`LAYER_BASE_X=70`/`LAYER_STEP_X=122`/`SLOT_BASE_Y=52`/`SLOT_STEP_Y=58`/`NODE_ICON_PX=20.0`/`NODE_HALF(36.5,25)`(52×36 的 1.4× 绘制)/`HIT_PAD=6.0`。
|
|
||||||
- [level_map_screen.gd:66-69](../game/presentation/views/level_map_screen.gd) `_content_size(620,240)`、`_layout_cache`——`open_choices` 按图拟合画布尺寸。
|
|
||||||
- [level_map_screen.gd:77-82](../game/presentation/views/level_map_screen.gd) 画布由 `CenterContainer`(`PRESET_FULL_RECT`)承载:整幅居中、无裁切无平移——超屏图(L3 层深 13,画布宽 1700.5px)两侧各 ~210px 出屏。
|
|
||||||
- [level_gen_params.tres:41](../game/data/tables/level_gen_params.tres) L3 `layers=13`——深度 13 是现行定值,非极端情形。
|
|
||||||
- [level_gen_params.gd:3-4、:69](../game/data/schemas/level_gen_params.gd) 头注「域校验沿关卡节点图生成.md v1.1 调参表已锁条款」「域并单点(关卡节点图生成.md v1.4 调参表)」——owner 文档已 v1.5 换代参数契约节,指针失效待反转(本卡 T4 随动)。
|
|
||||||
- [ui_kit.gd:231-232](../game/presentation/views/ui_kit.gd) `UiKit.motion(dur)` 呈现层 tween 时长单点包装(减动效面)。
|
|
||||||
- [ui_struct_probe.gd:204](../game/probe/ui_struct_probe.gd) `_audit("level_map", ...)` 既有结构审计锚;[golden/README.md:8](../game/tests/golden/README.md) level_map 全屏 golden=历史留根、现行闸件未对拍(本批不触渲染闸对拍)。
|
|
||||||
- 全文件 662 行——超 code-conventions §1.1 的 ~400 行审视线,视口承载拆件有据。
|
|
||||||
|
|
||||||
## 3. 设计契约(违反=L3 停机呈报)
|
|
||||||
|
|
||||||
- 🔴 **冻结值零改动**:节点图标 20px 烘焙 1:1、通道折线 2/3/4px、画布公式(宽=70+层深×122+44.5、高=52+槽位×58+25+24、下限 620×256)、节点方块 52×36×1.4 绘制、编号 10px——视口批只加行为,不动任何像素冻结件(level-map.md:69、:154)。
|
|
||||||
- 🔴 **视口纯呈现态**:平移位置零核心写、不进存档(重进本屏按锚点规则重新定位);Core 层零触碰、RNG 零触碰(level-map.md:103 行、:107 视口为纯呈现态句)。
|
|
||||||
- 🔴 **选路唯一通道**:图上点击提交语义零改动;拖拽超阈值不得触发选路提交(level-map.md:103)。
|
|
||||||
- 🔴 **零自动推进**:视口跟随只随停点切换/兑付回图发生,不构成任何自动前进路径(level-map.md:141 零自动推进纪律不变)。
|
|
||||||
- 🔴 **拆分边界纪律**(code-conventions §1.1,2026-10-28 用户裁):每个拆出单元有可陈述职责语句与单一变化原因;拆出单元有集体身份;「过阈值」只作发现信号;拆不出内聚单元=停卡走豁免通道,禁硬拆凑绿。
|
|
||||||
- 🔴 **禁为机检文本保留无效成员**(code-conventions §1.1⑤):机检键与卡片契约互斥=停卡呈报,禁自造第三条路。
|
|
||||||
|
|
||||||
## 4. 范围边界
|
|
||||||
|
|
||||||
做:视口承载件、锚点跟随、平滑滚动、减动效瞬切、拖拽/滚轮平移、clamp、渐隐带与提示 chip、探针断言、schema 头注指针反转。
|
|
||||||
不做:缩放与缩略图(等比缩放案已否决)、其余视口暗示形态(边缘回弹等——布局决策 5 注后置)、顶栏/底栏/放弃按钮/覆盖层改动、生成器与参数表改动、键盘/手柄输入(排 Beta)。
|
|
||||||
|
|
||||||
## 5. 关联文档同步面
|
|
||||||
|
|
||||||
| 文档 | 关联点 | 同步义务 |
|
|
||||||
|---|---|---|
|
|
||||||
| [level-map.md](../design/gdd/ux/level-map.md) v2.0 | 布局决策 5 行为实现与 AC :260–271——实现若发现 spec 缺口 | 设计权威——实现批禁写,缺口逐条列反哺点清单由文档批落 |
|
|
||||||
| [game/tests/README.md](../game/tests/README.md) 能力清单 | 本卡新增能力行三行(写卡段已同批落表,见 §8 能力行列) | 机械面——实现批禁写;批末收尾核对表上名与落地一致(改名则回表) |
|
|
||||||
| [level_gen_params.gd](../game/data/schemas/level_gen_params.gd) | 头注 :3-4/:69 指针失效(owner 已 v1.5 参数契约) | 本卡 T4 随批反转指针(非行为改动——`game/` 内实现批可写面) |
|
|
||||||
| [关卡节点图生成.md](../design/gdd/systems/冒险循环/关卡节点图生成.md) v1.5 | 无——本批实现不改变其任何陈述 | 无同步义务 |
|
|
||||||
|
|
||||||
## 6. 文件结构图(行为改动→对照表行互指)
|
|
||||||
|
|
||||||
| 文件 | 职责 | 改动性质 |
|
|
||||||
|---|---|---|
|
|
||||||
| `game/presentation/views/level_map_viewport.gd` | 新增——卷轴视口承载件:画布宿主与裁切、平移状态与 clamp、锚点跟随、平滑滚动、指引件(拖拽/滚轮判定留画布 `_gui_input`——事件流同源) | 行为改动(R2–R8)·新增 |
|
|
||||||
| `game/presentation/views/level_map_screen.gd` | 修改——CenterContainer 承载换视口件;停点切换/回图接线 `reanchor()`;`_content_size` 拟合后调 `reanchor(false)` 首锚 | 行为改动(R1+R2/R3 随动)·复用既有文件 |
|
|
||||||
| `game/data/schemas/level_gen_params.gd` | 修改——头注指针反转(owner 单点改为本文件域校验+参数契约指针) | 非行为改动(R9)·复用既有文件 |
|
|
||||||
| `game/probe/level_map_viewport_probe.gd` + `.tscn` | 新增——视口行为场景探针(真输入驱动) | 行为改动(R2–R8 验收载体)·新增 |
|
|
||||||
| `game/probe/probe_ui_util.gd` | 修改——新增拖拽沿与滚轮沿真输入合成工具 `push_drag_at`/`push_wheel_at`(沿 `push_click_at` :717-733 同式;探针共用面唯一落点) | 非行为改动(探针侧工具)·复用既有文件 |
|
|
||||||
|
|
||||||
## 7. 任务卡 T0..T4
|
|
||||||
|
|
||||||
### T0 读数与基线(0.5 工作日)
|
|
||||||
- [ ] 核对 `tools/gdstyle_baseline.txt` 有无 `level_map_screen` 相关 S13 键;有则记录登记值(改后只降不升),无则记「无键、按工具默认」
|
|
||||||
- [ ] 跑场景探针现状读数:`…console.exe --headless --path . res://probe/ui_struct_probe.tscn`(level_map 审计段绿)+ `res://probe/screen_flow_probe.tscn`——读数记入本步提交信息
|
|
||||||
- [ ] 跑冒烟 `python tools/run_smoke.py`——基线读数在案
|
|
||||||
|
|
||||||
### T1 视口承载件与手动平移(1–1.5 工作日)
|
|
||||||
- [ ] 新增 `level_map_viewport.gd`(接口块见 §10):`setup(canvas, anchor_provider, viewport_size)`、`pan_by(delta)`、`viewport_center_canvas_pos() -> Vector2`、`is_clamped_at_edge() -> bool`;`clip_contents=true`;成员 ≤8
|
|
||||||
- [ ] `level_map_screen.gd` 承载改造:CenterContainer 换视口件实例;`open_choices` 拟合后调 `reanchor(false)` 首锚(入口停点锚入口组、其余锚当前节点——`anchor_provider` 由 screen 提供画布坐标)
|
|
||||||
- [ ] 拖拽/滚轮判定落**画布既有 `_gui_input`**(画布已持有鼠标事件流——悬停/选路同源,禁在视口件层做父子事件路由竞争;视口件只管裁切/offset/clamp/跟随):拖动距离阈值(provisional 8px)判定,超阈值进拖拽态逐帧调 `viewport.pan_by()`;滚轮横滚映射 `pan_by`(代拍板:滚轮下=向右/前进向)
|
|
||||||
- [ ] clamp:`pan_by` 后 offset 收敛在画布包络内(`viewport_center_canvas_pos()` 画布坐标恒在 `[half_view, canvas_size-half_view]` 夹紧域;**画布小于视口=居中分支**——夹紧域退化为居中定位);探针宿主沿 ui_struct_probe :204 同款(组合根真实屏 `main.ui.modals.run.level_screen`),禁合成投喂替代真实路径
|
|
||||||
- [ ] 探针 `level_map_viewport_probe.gd`:断言 R3(拖拽移视口)、R4(滚轮移视口)、R5(clamp 边界)、R6(拖拽不触发选路——`route_chosen` 零发射);真实入口=probe_ui_util 合成沿走 `push_input`
|
|
||||||
|
|
||||||
### T2 锚点跟随与平滑滚动(0.5–1 工作日)
|
|
||||||
- [ ] `reanchor(smooth)`:目标 offset=锚点画布坐标−视口半宽(居中);`smooth=true` 走单段缓动 tween 时长 `UiKit.motion(0.3)`(provisional);`smooth=false` 即达;重入先杀在飞 tween 再建新(快速连续停点切换防叠加)
|
|
||||||
- [ ] 减动效:`UiKit.motion` 通道既有减动效语义下滚动跳终态——探针断言 R7(减动效开=位置即达,无 tween 中间帧)
|
|
||||||
- [ ] level_map_screen.gd 停点切换与兑付回图路径接 `reanchor(true)`——入口停点锚入口节点组(多入口取组包围盒居中)
|
|
||||||
- [ ] 探针断言 R2(停点切换后当前节点画布坐标投影=视口中线 x=640±2)
|
|
||||||
|
|
||||||
### T3 指引件(0.5 工作日)
|
|
||||||
- [ ] 视口件内渐隐带:屏缘左右各 70px 渐变(色取屏底同族——代拍板渐变 stops);浅图画布不超屏时渐隐带隐藏(无暗示必要)
|
|
||||||
- [ ] 平移提示 chip:240×30 圆角 6、深底石灰描边、文案「◄ 拖拽画布 / 滚轮平移 ►」14px;图区底部居中(level-map.md:104)
|
|
||||||
- [ ] 探针断言 R8(渐隐带与 chip 可见性+几何判据——像素级判据②③,level-map.md:154)
|
|
||||||
|
|
||||||
### T4 指针反转与收口(0.5 工作日)
|
|
||||||
- [ ] `level_gen_params.gd` 头注 :3-4/:69 反转:「取值域与字段契约单点=本文件域校验;概念与设计意图=关卡节点图生成.md v1.5 参数契约节」(非行为改动——grep 判据 R9)
|
|
||||||
- [ ] 全探针最窄回归:ui_struct_probe level_map 段+screen_flow_probe 复跑绿(波内修复只做出红最小单元的最窄确认)
|
|
||||||
- [ ] 产出物落位:`reports/iter<N>-实现报告-<日期>.md`(各卡状态+实机目检总清单+实现决定记录)+ `reports/iter<N>-反哺点-<日期>.md`(同步面所列逐条落点)——轻闸全绿后、合并前写齐
|
|
||||||
|
|
||||||
估时合计:3–4.5 工作日(中值 3.5)。
|
|
||||||
|
|
||||||
## 8. 验证闸(改动—验收对照表)
|
|
||||||
|
|
||||||
| 需求点 | 改动(文件:行/行为) | 验收测试(名称+落点+尾缀) | 层级 | 真实入口 | 判据绑定面 | 能力行 |
|
|
||||||
|---|---|---|---|---|---|---|
|
|
||||||
| R1 浅图整幅居中无裁切+画布入视口件承载(锚 design/gdd/ux/level-map.md:260) | level_map_screen.gd(CenterContainer→viewport 件) | `level_map_viewport_probe.gd:_probe_shallow_no_crop`〔卷轴批 V1〕 | 探针 | 场景探针实例化本屏+open_choices 真实停点 | 画布尺寸≤视口时居中分支 offset 定位、无裁切 | 新增:关卡画面视口跟随 |
|
|
||||||
| R2 视口锚点:停点切换/回图后当前节点居中 x=640±2(锚 design/gdd/ux/level-map.md:101、:269) | level_map_viewport.gd `reanchor`+screen 接线 | `level_map_viewport_probe.gd:_probe_follow_anchor`〔卷轴批 V2〕 | 探针 | 合成推进停点切换经真实屏流程 | 当前节点画布坐标经 `viewport_center_canvas_pos()` 投影=640±2 | 新增:关卡画面视口跟随 |
|
|
||||||
| R3 拖拽平移移动视口(锚 design/gdd/ux/level-map.md:103) | 画布 `_gui_input`(level_map_screen.gd)拖拽态调 `pan_by` | `level_map_viewport_probe.gd:_probe_drag_pan`〔卷轴批 V3〕 | 探针 | `ProbeUiUtil.push_drag_at` 拖拽沿走 `push_input` | `_offset` 位移量=拖拽位移(clamp 前) | 新增:关卡画面视口平移 |
|
|
||||||
| R4 滚轮横滚移动视口(锚 design/gdd/ux/level-map.md:103) | 画布 `_gui_input` wheel 分支调 `pan_by` | `level_map_viewport_probe.gd:_probe_wheel_pan`〔卷轴批 V4〕 | 探针 | `ProbeUiUtil.push_wheel_at` 合成滚轮沿走 `push_input` | `_offset` 位移=滚轮步进映射 | 新增:关卡画面视口平移 |
|
|
||||||
| R5 clamp 边界与首末列可达:不出露屏底空档、拖拽两极首列与末列(含 Boss)入屏(锚 design/gdd/ux/level-map.md:103、:260) | `pan_by` 收敛逻辑+包络两极 | `level_map_viewport_probe.gd:_probe_clamp_bounds`〔卷轴批 V5〕 | 探针 | 极端拖拽沿(超包络、两极到边) | `viewport_center_canvas_pos()` 恒在夹紧域;浅图居中分支;`is_clamped_at_edge()` 翻转;两极时深度 0 与深度 13 列中心入视口 | 新增:关卡画面视口平移 |
|
|
||||||
| R6 拖拽不触发选路提交(锚 design/gdd/ux/level-map.md:103) | 画布 `_gui_input` 阈值判定(provisional 8px) | `level_map_viewport_probe.gd:_probe_drag_no_submit`〔卷轴批 V6〕 | 探针 | 拖拽沿起止于候选节点上方 | `route_chosen` 零发射+屏幕未关 | 新增:关卡画面视口平移 |
|
|
||||||
| R7 平滑滚动与减动效瞬切(锚 design/gdd/ux/level-map.md:102、:188、:227) | `UiKit.motion(0.3)` tween/减动效跳终态 | `level_map_viewport_probe.gd:_probe_smooth_scroll_reduced_motion`〔卷轴批 V7〕 | 探针 | 停点切换+设置面减动效置位 | smooth=true 有 tween 中间帧;减动效开=位置即达 | 新增:关卡画面视口跟随 |
|
|
||||||
| R8 指引件:渐隐带 70px+chip 240×30 呈现(锚 design/gdd/ux/level-map.md:104、:154) | 视口件指引子件 | `level_map_viewport_probe.gd:_probe_guidance_chrome`〔卷轴批 V8〕 | 探针 | 深图 open_choices 真实停点 | 像素级判据②③(level-map.md:154)——可见性+几何 | 新增:关卡画面视口指引 |
|
|
||||||
|
|
||||||
非行为改动行:schema 头注指针反转(level_gen_params.gd:3-4/:69)——判据=全仓无「域并单点=调参表」残留、头注含「参数契约节」指向(锚 design/gdd/systems/冒险循环/关卡节点图生成.md:109);由 §6 文件结构图该行覆盖,T4 落步,实现报告对照表列非行为改动行。
|
|
||||||
锚行核对义务:开工时行号以当版文件为准(本卡锚基于 v2.0/v1.5 抄录)。
|
|
||||||
|
|
||||||
- 测试方式两分法:R1–R8 全走探针自动化(调试注入不适用——本卡零数据面改动,状态经真实停点与真实输入驱动);用户目检项=「深度 13 图拖拽可达首末列、跟随方向感、chip 不碍选路」登记进实现报告实机目检总清单(登记不阻塞)。
|
|
||||||
- 回归措辞:里程碑步(T 段)出口跑一次场景探针族全套;波内修复只做出红最小单元的最窄确认;新增探针先行孤立验证再并入全套。
|
|
||||||
- 测试削弱申报:无删旧断言申报;ui_struct_probe level_map 段既有审计判据不改——承载改造若触其结构断言面,适配性调整须在实现报告申报并保持判据语义。
|
|
||||||
- 独立验收审计:`reports/iter<N>-验收审计-<日期>.md`,由未参与实现的会话执行;本卡验收档=中,审计深度按 test-conventions §8.7 中档执行(对照表逐行全量、判据绑定面抽查、削弱检查逐处、直查例外逐条、最窄复跑以远端 CI 现查读数代证)。
|
|
||||||
|
|
||||||
## 9. 异常分级
|
|
||||||
|
|
||||||
- L1 自救:探针断言红→改后只跑出红探针的最小单元;闸红只跑红件。
|
|
||||||
- L2 记录继续:画布 `_gui_input` 内拖拽态与悬停/选路命中分支次序的调整、渐变/chip 视觉微调(provisional 区间内)、S13 读数波动在只降不升约束内的消化。
|
|
||||||
- L3 停机写报告等用户:触碰 §3 任一 🔴;S13 键上升且无法只降;拆不出内聚单元;机检预算互斥=上游缺陷停卡退回写卡段;拖拽误触选路提交且路由层面消不掉。
|
|
||||||
|
|
||||||
## 10. 落位与可复用性预检
|
|
||||||
|
|
||||||
- **level_map_viewport.gd(新增)**:不复用 `ScrollContainer`——其滚动条 UI、焦点/滚动语义与本屏「纯鼠标、无滚动条、锚点居中跟随」冲突,且平滑滚动与 clamp 语义仍需全自管;承载裁切用 Control `clip_contents`(引擎内建,项目已有 clip 先例)。唯一面:视口 offset 状态只落本件(screen 的 `_layout_cache` 仍管布局、不管视口);全仓 grep 无第二处视口/平移逻辑。分层:呈现层内部子件——构造注入(canvas/anchor_provider/viewport_size 一次交齐,code-conventions §1.6 拆分交接);读核心只读面经 screen 既有出口,零新增核心触点。
|
|
||||||
- **probe_ui_util.gd 增补(复用既有文件)**:`push_drag_at`/`push_wheel_at` 落探针共用面唯一落点——禁另起工具文件散落;`push_click_at`(ui_input_probe :717-733 同式)点击沿同式扩展。
|
|
||||||
- **指引件(渐隐带/chip)**:随视口件承载(同职责:视口呈现行为);不立独立文件——拆出「命不出名字的打包」即凑计数袋。
|
|
||||||
- **level_gen_params.gd 头注反转(复用既有文件)**:注释单行改动,无新增件。
|
|
||||||
|
|
||||||
## 11. 实现规范预算
|
|
||||||
|
|
||||||
- **新增 level_map_viewport.gd 三查**:①接口块公开方法 4(setup/pan_by/viewport_center_canvas_pos/is_clamped_at_edge)≤20 ✓;②成员变量 ≤8(_canvas/_anchor_provider/_viewport_size/_offset/_tween/_drag_active/_drag_accum/_guided_visible)≤15 ✓;③无迁移函数(新件零存量函数迁入——screen 侧只是接线改造,hover/命中逻辑零迁移)。
|
|
||||||
- **存量触面**:level_map_screen.gd——T0 记 S13 键基线;本批改动为承载替换与 reanchor 接线,预期键值持平或只降;达成手段=T4 复跑 S13 对账。
|
|
||||||
- 指标例外:无申报。
|
|
||||||
|
|
||||||
## 12. 代拍板白名单
|
|
||||||
|
|
||||||
1. 画布 `_gui_input` 内拖拽态与悬停/选路命中的事件分支次序(红线=R6 判据不破)。
|
|
||||||
2. 拖拽距离阈值具体值(8px 附近 provisional 区间内定值)。
|
|
||||||
3. 平滑滚动缓动曲线类型(单段缓动家族内选型)。
|
|
||||||
4. 渐隐带渐变 stops 与 chip 深底/描边色值(art-bible §4.1 冻结色板同族取值)。
|
|
||||||
5. 滚轮方向映射(下=向右/前进向)。
|
|
||||||
超清单决定记入实现报告「实现决定记录」节。
|
|
||||||
|
|
||||||
## 13. 待裁点
|
|
||||||
|
|
||||||
零待裁点,开工门=U0(四口子与效果图 2026-11-05 用户已裁决;验收档「中」随批卡确认)。
|
|
||||||
@@ -1,267 +0,0 @@
|
|||||||
# 需求卡片·改写族孤儿机制与退役名清退批(2026-11-05)
|
|
||||||
|
|
||||||
来源:待办清单条目「damage_controller 按序改写族——内容孤儿机制与退役名注释层」(2026-11-04 登记,来源=会话提及)。
|
|
||||||
唯一事实源:`design/gdd/systems/跨局循环/锻造工坊.md` v0.13 §满级特效扩展位(本期已按本批口径订正)+本卡「现状事实」所列代码读数;机制处置与注释口径的裁决记录=2026-11-05 会话,用户裁「只要有问题的都要改」,退役内容名一律清退、零现役注册的改写分支一律摘除。
|
|
||||||
验收档:中(一处玩家可见明细行文案换代+若干不可达分支摘除;不写存档、不改乘区公式与数值表)。
|
|
||||||
估时:2.25–2.75 个工作日(T0 0.25+T1 0.5+T2 0.5+T3 0.5–1+T4 0.25+T5 0.25 加总)。切分预案:T3 注释面若单轮改不完,按文件切成 T3a(core 八件)/T3b(schemas+sim+tests),两张各自收尾,不并进 T1。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1 目标与完成定义
|
|
||||||
|
|
||||||
做完这五件事算完:
|
|
||||||
|
|
||||||
1. 主角先手攻击的四个改写分支摘除——它们零数据表行注册,游戏里从不执行。
|
|
||||||
2. 连带收窄两处引擎词表:`EFFECT_KINDS` 摘 `spike`、`DO_KEYS` 摘 `trade_hit`/`trade_atk`,并同批补负域探针取证。
|
|
||||||
3. `game/` 注释面退役内容名清零(42 行/13 文件),只换名不换职责陈述。
|
|
||||||
4. 三处挂退役件名的玩家可见文案改中性机制文案(其中一处今天可达),一处 sim 死匹配删除。
|
|
||||||
5. 产出物两份写齐(实现报告+反哺点清单),代码域闸全绿,改前改后对拍逐位一致。
|
|
||||||
|
|
||||||
判据总口径:本批除第 4 项文案外全部是非行为改动——零现役注册行=分支不可达=删了也不改变任何一帧输出。这条不靠感觉,T0 用三条 grep 读数坐实。
|
|
||||||
|
|
||||||
## 2 设计事实源
|
|
||||||
|
|
||||||
- 设计线闭合凭据:`design/gdd/systems/跨局循环/锻造工坊.md` v0.13(2026-11-05)§满级特效扩展位——本批订正该节四处陈述,其中重甲反震与长枪先手连击两条候选的代价档由「零新代码」改判「需新代码」,效果类型闭集词数不再抄进文档。
|
|
||||||
- 机制处置裁决:本卡所属待办条目「实况」段所载 2026-11-05 会话裁决。
|
|
||||||
- 代码现状取证:本卡第 3 节全部带 `文件:行号`,无一条凭记忆。
|
|
||||||
|
|
||||||
## 3 现状事实
|
|
||||||
|
|
||||||
### 3.1 四个改写分支零注册(本批要摘的)
|
|
||||||
|
|
||||||
| 分支 | 代码位置 | 触发条件 | 现役注册行 | 退役名注释 |
|
|
||||||
|---|---|---|---|---|
|
|
||||||
| 命中交换 | `game/core/damage_controller.gd:297-302`(命中侧)、`:351-353`(增伤侧) | `kind=modify_ticket` 且载荷带 `trade_hit`/`trade_atk` | 0 行(`game/data/tables/` 全域零命中) | :285-286、:341、:350(矿工重锤) |
|
|
||||||
| 免掷恒折扣 | `:305-309` | `kind=modify_ticket` 且 `mode=armor_rewrite` | 0 行 | :287(专注) |
|
|
||||||
| 满层必中与倍乘 | `:310-313`(必中置位)、`:368-372`(倍乘) | `kind=modify_ticket` 且 `mode=spike` | 0 行 | :288(厚积薄发,行内含 spike)、:342 与 :368 |
|
|
||||||
| 轻甲折扣档改善 | `:320-323` +私有函数 `_discount_shift_up`(`:623`) | `kind=modify_ticket` 且 `mode=discount_shift` | 0 行 | :288、:622(猎弱本能) |
|
|
||||||
|
|
||||||
穿线键 `spike_ready` 出现在 `:282`、`:310`、`:313`、`:325`、`:369` 五处,随分支一起消失。
|
|
||||||
|
|
||||||
克制点数面(`mode=clamp_bonus`)有现役一行注册:`game/data/tables/feats.tres:853-857` 淬毒刃纹(`kind=modify_ticket`/`mode=clamp_bonus`/`delta=2`)——**不摘**,`_ctx_clamp_delta`(`:333-338`)与 `clamp_check` 发射点(`:315`)保持原样。
|
|
||||||
|
|
||||||
### 3.2 两处词表在册
|
|
||||||
|
|
||||||
- `game/core/effect_engine.gd:30` `EFFECT_KINDS` 含 `"spike"`;该常量实数 32 词(本卡现读,摘后 31)。全仓按 `kind == "spike"` 派发效果的代码**不存在**——`spike` 只在词表与注释里在册(另两处:`:30` 词表、`:452` 「任意真族(任一命中即生效):spawn_spell、spike」注释)。
|
|
||||||
- `game/core/effect_engine.gd:82` `DO_KEYS`(现 26 键)含 `"trade_atk"`, `"trade_hit"`;执法点在 `:417`(`if not DO_KEYS.has(String(k))` 出域即拒绝)。摘后 24 键。
|
|
||||||
- `attack_segments` 不属本批:它已随架构审查整改甲案整链退役(`grep -r attack_segments game/` 仅命中 `game/tests/unit/data_config/effect_kind_retired_test.gd:3` 的注释),本批只把它在 GDD 里的错句一并订正(见第 6 节)。
|
|
||||||
|
|
||||||
### 3.3 注释面退役名全仓扫描读数
|
|
||||||
|
|
||||||
名单来源=`design/content-archive/道具退役素材库.md` 两张表的「原名」列,共 41 名;减去表内仍作为现役 `display_name` 出现的 1 名(淬毒刃纹)=40 名。扫 `game/` 全域 `.gd`/`.tres`/`.md` 命中 **53 行/13 文件**,无一条落在 `.tres` 数据表里。
|
|
||||||
|
|
||||||
| 文件 | 注释面行号(本批改) | 字面量行号 | 字面量处置 |
|
|
||||||
|---|---|---|---|
|
|
||||||
| `game/core/damage_controller.gd` | 109、138、285、287、288、328、341、350、394、424、622 | — | — |
|
|
||||||
| `game/core/reward_grant.gd` | 2、130、183、221 | 189、226 | 两处都改中性文案(T4) |
|
|
||||||
| `game/core/settlement/grant_segment.gd` | 127、128、232、240、265、279、283、351、362、373 | 166 | 玩家可见标签改中性(T4) |
|
|
||||||
| `game/core/reward_roller.gd` | 1、41、46、86 | — | — |
|
|
||||||
| `game/core/effect_engine.gd` | 64、65、157、452 | — | 452 随 T1 摘词改写 |
|
|
||||||
| `game/core/battle_orchestrator.gd` | 258、538 | — | — |
|
|
||||||
| `game/core/action_economy.gd` | 82 | — | — |
|
|
||||||
| `game/data/schemas/treasure_item_table.gd` | 20、122 | — | — |
|
|
||||||
| `game/sim/adventure_monte_carlo.gd` | 75 | — | — |
|
|
||||||
| `game/sim/level_autoplay.gd` | 415 | 421 | 死匹配删除(T4);415 随删该处注释 |
|
|
||||||
| `game/tests/unit/core/meta_progression_forge_test.gd` | 677、690 | 694、697、699、700 | 断言串随 T4 文案换代(申报见第 8 节) |
|
|
||||||
| `game/tests/unit/battle_settlement/variant_placement_test.gd` | 239 | — | — |
|
|
||||||
| `game/tests/unit/core/treasure_items_test.gd` | — | 31、33、35 | 不动——StubDB 自造夹具名,不宣称内容现役 |
|
|
||||||
|
|
||||||
字面量合计 11 行:本批动 8 行(三文件的四处文案/死串=`reward_grant:189`/`:226`、`grant_segment:166`、`level_autoplay:421`,加锻造测试四处断言串 `694`/`697`/`699`/`700`),其余 3 行夹具名保留。注释面 42 行全改,另加 `effect_engine.gd:452` 一句随摘词改写=本批改写 43 处。
|
|
||||||
|
|
||||||
### 3.4 玩家可见文案三处
|
|
||||||
|
|
||||||
- `game/core/reward_grant.gd:226`:`mine_hit` 减半路径发射的结算明细行标签——`"惊巢反制——危险格挖掘惩罚减半(%d→%d)" % [...]`,载荷 `"effect_id": "nest_counter"`。`惊巢反制` 与 `nest_counter` 都是退役件名(素材库表一 :18),而这行文案是玩家能看见的,且这条路径今天可达(有现役锻造锋行驱动——`meta_progression_forge_test.gd:694-700` 正在钉它)。
|
|
||||||
- `game/core/reward_grant.gd:189`:`_cell_removal_open` 空集拒绝 reason——`"爆破工兵包:3×3 区域内无可移除危险格(须未揭示且未封印)"`。该通道 `cell_removal` 在册(`game/data/schemas/treasure_item_table.gd:26`、消费点 `reward_grant.gd:160-161`)但零现役数据行(`game/data/` 全域零命中),所以 reason 今天不可达;文案仍挂退役件名。通道本体不进本批(见第 5 节),本批只清文案。
|
|
||||||
- `game/core/settlement/grant_segment.gd:166`:`mine_hit` 订阅中 `kind=open_ticket` 且 `channel="reflect"` 的行开单,明细标签硬编码 `"惊巢反制·反弹"`,归因串 `"attune_nest_counter"`。`"reflect"` 在 `game/data/tables/` 二十一张表逐张 grep 零命中 → 今天不可达,与 `:189` 同类问题(标签挂退役件名)。`reflect` 渠道本体不进本批(见第 5 节),本批只清标签与归因串。
|
|
||||||
|
|
||||||
### 3.5 一处 sim 死匹配
|
|
||||||
|
|
||||||
`game/sim/level_autoplay.gd:421` 用 `String(row.get("display_name", "")).contains("雷区图谱")` 捕高光事件,`:415` 是配套注释。`雷区图谱` 零现役行(`game/data/` 零命中)→ 该条件恒 false。
|
|
||||||
|
|
||||||
### 3.6 既有测试面读数(决定本批要不要改测试)
|
|
||||||
|
|
||||||
- 四个 mode 与两个键在 `game/tests/`、`game/probe/`、`game/sim/` **零命中**(`grep -rn "trade_hit\|trade_atk\|armor_rewrite\|discount_shift\|spike" game/tests/ game/probe/ game/sim/` 空)。摘分支不动任何既有断言。
|
|
||||||
- `armor_roll` 有既有断言:`game/tests/unit/battle_settlement/roll_multiplier_test.gd:125 _smoke_armor_roll()`——它测的是护甲骰与折扣读数,不是订阅消费。所以掷点面 `:293 _armor_roll()` 与发射调用 `:296 _fx_hits("armor_roll", ...)` 都保留(`armor_roll` 在 `effect_engine.gd:13` 事件词表在册),只删 `:305-309` 消费环,`ar_hits` 局部变量随删。
|
|
||||||
|
|
||||||
## 4 设计契约
|
|
||||||
|
|
||||||
- 🔴 **契约 1|零现役注册坐实才许摘**:T0 三条 grep 读数必须全为零——`game/data/tables/` 内 `spike`/`armor_rewrite`/`discount_shift`/`trade_hit`/`trade_atk` 各 0 行、`tree_rules` 面 0 行、`effect_kinds` 面 `cell_removal` 0 行(后者只作记录,本批不摘通道)。任一数非零=该分支可达=停卡 L3 呈报,禁直接摘。
|
|
||||||
- 🔴 **契约 2|注释改写只换名不换职责**:42 行注释逐处保留「这段在做什么、按什么序、为什么这样取」的陈述,把退役件名替换成机制语言。整行删除、成片缩写、或删注释换 gdstyle 行数绿=违规(先例:宿主行数压至 999 时「禁删注释凑行数红线未碰」)。
|
|
||||||
- 🔴 **契约 3|文案换代禁碰数值与发射序**:`:226` 只改标签字符串,`[int(row.power), half]` 取值、`emit_cb.call` 参数位序、`"effect_id"` 载荷键一律不动;`:189` 只改 reason 前缀,`{"ok": false}` 形态不动。
|
|
||||||
- 🔴 **契约 4|词表收窄与负域探针同批**:摘 `EFFECT_KINDS` 的 `spike` 与 `DO_KEYS` 的两键,必须同批落 T2 探针;只摘词不取证=本卡未完成。
|
|
||||||
- 🔴 **契约 5|禁留空壳**:`spike_ready` ctx 键、`ar_hits`/`shift`/`trade_hit` 局部变量、`_discount_shift_up` 函数随分支即删,禁保留空返回、别名或「以后可能用」的成员凑机检文本。
|
|
||||||
- 🔴 **契约 6|实现批禁写文档**:`design/` 整个目录、`待办清单.md`、`体验验证清单.md`、`game/tests/README.md` 一律不写;要改的文档句子全进第 6 节与反哺点清单。
|
|
||||||
- 🔴 **契约 7|零新增数值**:本批不引入任何玩法数值,不改 `.tres` 表值。MC 与 verifier 零跑(无数值改动零跑)。
|
|
||||||
|
|
||||||
## 5 范围边界
|
|
||||||
|
|
||||||
做:3.1 四段分支+穿线键+`_discount_shift_up`;3.2 两处词表摘名;3.3 注释面 43 处;3.4 三处文案;3.5 一处 sim 死匹配;3.6 消费环 `armor_rewrite` 删而发射点留;T2 负域探针;T4 断言串随动。
|
|
||||||
|
|
||||||
不做,去向写明:
|
|
||||||
|
|
||||||
| 不收件面 | 为什么不做 | 去向 |
|
|
||||||
|---|---|---|
|
|
||||||
| `EVENTS` 零订阅词普查(含 `armor_roll` 发射点去留) | 与「改写分支」不同轴,是事件词表整体普查 | 待办清单本批同登条目「效果通道与事件词的零现役普查」 |
|
|
||||||
| `effect_kinds`/渠道零现役清退(`cell_removal`、`mine_hit_halve`、`open_ticket` 的 `channel="reflect"` 行族) | 通道在册、有消费点、只缺数据行——判「删通道」要连同 schema 词、归因标识与拒绝文案整体裁 | 同上条目,与 iter52 孤儿函数清退批同族 |
|
|
||||||
| GDD 其余仍提退役内容名的句子(`systems/冒险循环/奇物.md`、`systems/战斗循环/地图战斗资源.md`、`术语表.md`、`00-游戏概念.md`、`03-内容规模.md`) | 属文档面用语,不属代码批 | 反哺点清单,文档批落文 |
|
|
||||||
| `game/tests/unit/core/treasure_items_test.gd:31/33/35` 三个退役件名夹具 | StubDB 自造行,不宣称该件现役;改名动的是测试面 | 无——保留 |
|
|
||||||
| `attack_segments` 词表补摘 | 已随甲案退役,本批只在 GDD 订正错句 | 无——已完成 |
|
|
||||||
| 结算明细标签是否入表(文案硬编码在 `:226`) | 涉及「呈现文案归属」规范裁决,不属本卡 | 反哺点清单,文档批裁 |
|
|
||||||
|
|
||||||
## 6 关联文档同步面
|
|
||||||
|
|
||||||
| 文档 | 关联点 | 同步义务 |
|
|
||||||
|---|---|---|
|
|
||||||
| `design/gdd/systems/跨局循环/锻造工坊.md` §满级特效扩展位 | 闭集词数句、长枪候选代价档、重甲候选代价档、七条前提句 | **已在本批前置文档段落文**(v0.13);实现批禁再写该文件 |
|
|
||||||
| `design/gdd/systems/跨局循环/锻造工坊.md` 同节 | 重甲反震候选的实现前提:反弹需新开消费点(本批摘 `spike` 后彻底无位) | 设计权威文档,实现批不直改;写入 `reports/<迭代号>-反哺点-<日期>.md`,用户裁后归文档批 |
|
|
||||||
| `design/gdd/systems/战斗循环/增益状态.md`/`伤害与护甲.md` | 若其中叙述「改写族四拍」的句子里挂了退役件名 | 机械面核对;有则列反哺点,无则实现报告记「零命中」 |
|
|
||||||
| `game/tests/README.md` 能力表 | 本批无新增能力、无能力退役;T2 探针挂既有行「加载期违规表拒绝:跨表悬空/计数器前缀/真视窄域/效果类型出域」(:177,代表用例含 `effect_kind_retired_test.gd:_assert_rejected`) | 无改动义务;批末核对表上名字与落地一致 |
|
|
||||||
| `待办清单.md`/`roadmap.md` | 条目状态与迭代行 | 由写卡段与编排段推进,实现批禁写 |
|
|
||||||
|
|
||||||
## 7 任务卡
|
|
||||||
|
|
||||||
### 文件结构图
|
|
||||||
|
|
||||||
| 文件 | 职责 | 改动性质 |
|
|
||||||
|---|---|---|
|
|
||||||
| `game/core/damage_controller.gd` | 主角/敌方伤害结算编排 | 非行为改动(摘不可达分支+注释改写)→ 对照表 R1、R4 |
|
|
||||||
| `game/core/effect_engine.gd` | 效果词表与行校验 | 非行为改动(摘词两枚+注释改写)→ R2、R3、R4 |
|
|
||||||
| `game/tests/unit/data_config/effect_kind_retired_test.gd` | 负域加载探针宿主 | 新增两个探针常量与两次调用(非行为改动的取证面)→ R2、R3 |
|
|
||||||
| `game/core/reward_grant.gd` | 奖励与格面兑付 | 行为改动(一处明细行标签+一处拒绝 reason 文案)→ R5、R6 |
|
|
||||||
| `game/tests/unit/core/meta_progression_forge_test.gd` | 元进度/锻造断言宿主 | 断言串随 R5 换代(申报见第 8 节)→ R5 |
|
|
||||||
| `game/sim/level_autoplay.gd` | autoplay 驱动件 | 非行为改动(删恒 false 匹配+注释)→ R4、R8 |
|
|
||||||
| `game/core/settlement/grant_segment.gd` | 授予段结算编排 | 行为改动(`:166` 明细标签文本)→ R7;注释面 10 行改写 → R4 |
|
|
||||||
| `game/core/reward_roller.gd`、`game/core/battle_orchestrator.gd`、`game/core/action_economy.gd`、`game/data/schemas/treasure_item_table.gd`、`game/sim/adventure_monte_carlo.gd`、`game/tests/unit/battle_settlement/variant_placement_test.gd` | 注释面 | 非行为改动(注释改写)→ R4 |
|
|
||||||
|
|
||||||
零新增文件、零新增函数、零新增数据件;唯一的"新增"是既有套件内的两个探针常量。
|
|
||||||
|
|
||||||
### T0 基线与读数对账(0.25 工作日)
|
|
||||||
|
|
||||||
取用:无。产出:改前基线三件——对拍转储、S13 键读数、契约 1 三条 grep 读数。
|
|
||||||
|
|
||||||
- [ ] 跑契约 1 三条 grep,逐条把命中数写进实现报告 T0 节(期望全 0,除 `feats.tres:854` 的 `clamp_bonus` 一行作对照记录)。
|
|
||||||
- [ ] 读 `tools/gdstyle_baseline.txt` 内 `damage_controller.gd`/`effect_engine.gd`/`reward_grant.gd`/`level_autoplay.gd` 现登记键,抄进实现报告「存量触面」表(第 14 节要求只降不升)。
|
|
||||||
- [ ] 采改前对拍基线:`game/sim/dump_battle.gd` 六组(L{1,2}×S{42,779401,779501},stdout 单流转储,先例=拆件批 T6 同参)。
|
|
||||||
- [ ] 采改前明细行读数:`meta_progression_forge_test.gd:_smoke_tree_rules` 现断言串的完整文本抄进实现报告(T4 换代后的比对基准)。
|
|
||||||
|
|
||||||
### T1 摘四段死分支与穿线键(0.5 工作日)
|
|
||||||
|
|
||||||
取用:T0 的契约 1 读数全零。产出:`_ctx_rewrites` 与 `_hero_attack_ctx` 的收窄返回键集(T2、T4 引用)。
|
|
||||||
|
|
||||||
- [ ] `damage_controller.gd`:删 `:297-302`(命中侧交换)、`:351-353`(增伤侧交换)、`:305-309`(免掷覆盖)、`:310-313` 置位块+`:368-372`(spike 倍乘)、`:320-323`(移档调用)与 `:623` 函数 `_discount_shift_up(discount: int, shift: int) -> int`。
|
|
||||||
- [ ] 同文件:删 `clamp_hits` 收集后残留的 `shift` 局部变量、`ar_hits` 局部变量(发射调用 `:296` 保留但不接收返回值,见 3.6);`spike_ready` 键从 `:282`、`:325` 返回字典与 `:369` 消费处一并去除。
|
|
||||||
- [ ] 收窄后的签名与键集照此,不得自创:
|
|
||||||
- `_ctx_rewrites(t: Dictionary, target: Dictionary, armor: String, matchup: String) -> Dictionary` 返回键集 = `{roll_read, threshold, crit, discount, clamp_hits}`。
|
|
||||||
- `_hero_attack_ctx(t: Dictionary) -> Dictionary` 返回键集 = 现键集去掉 `spike_ready`(`:278-282` 其余键逐字保留)。
|
|
||||||
- `_hero_attack_base_value(t: Dictionary, ctx: Dictionary) -> float` 签名不变,体内删两拍。
|
|
||||||
- [ ] 头注与分节注释随删随改(`:249-254`、`:264-266`、`:285-290`、`:341-342`、`:368`):改写后的四拍叙事只剩「掷点折扣读数 → 克制点数」两拍,注释口径同步收窄(这条与 T3 同判据,禁再挂退役件名)。
|
|
||||||
- [ ] 单元侧适配:`game/tests/unit/battle_settlement/damage_controller_test.gd`、`roll_multiplier_test.gd`、`game/tests/unit/contracts/system_contracts_test.gd` 跑一遍;3.6 已证零命中,若真出红,只改装配不改进判据,并把改动写进实现报告「实现决定记录」。
|
|
||||||
|
|
||||||
### T2 词表收窄与负域探针(0.5 工作日)
|
|
||||||
|
|
||||||
取用:T1 摘除后的 `damage_controller.gd` 键集(探针只需构造表行,不引用控制器内部键)。产出:`effect_kind_retired_test.gd` 两枚新探针常量 `_assert_rejected` 新断言名(R2/R3 引用)。
|
|
||||||
|
|
||||||
- [ ] `effect_engine.gd:30` 摘出 `"spike"`(`EFFECT_KINDS` 实数 32→31);`:82` 摘出 `"trade_atk"`, `"trade_hit"`(`DO_KEYS` 19→17 项,实数以摘后 `grep` 行内计数为准)。
|
|
||||||
- [ ] 同文件 `:452` 组合规则注释改为只列现役:「任意真族(任一命中即生效):`spawn_spell`。」;`:64`/`:65`/`:157` 注释改写并入 T3 判据面。
|
|
||||||
- [ ] `game/tests/unit/data_config/effect_kind_retired_test.gd`:按既有形态新增两枚探针——`PROBE_SPIKE_MODE`(注入 `{"kind": "modify_ticket", "mode": "spike"}` 行的夹具目录)与 `PROBE_TRADE_KEY`(注入带 `trade_hit` 键的 do 字典)。各建一个 `user://` 夹具目录常量,沿用 `_inject(dir, probe)` 与 `_assert_rejected` 既有函数,不新建套件文件。
|
|
||||||
- [ ] 断言名与尾缀:`_assert_rejected` 内新增两条检查——`"词表闭面:kind=spike 出域拒绝"` 与 `"do 键闭面:trade_hit 出域拒绝"`;该套件已在 `game/tests/run_all.gd:195` 负面清单在册(`expect=1`、`negative=true`),本步只加探针,不动在册条目与退出码判据。
|
|
||||||
- [ ] 独立验证先行:只跑该套件(`godot --headless --path game --script res://tests/unit/data_config/effect_kind_retired_test.gd`)出绿,再并入全套。
|
|
||||||
|
|
||||||
### T3 注释面退役名改写(0.5–1 工作日,可切 T3a/T3b)
|
|
||||||
|
|
||||||
取用:3.3 表逐行清单。产出:注释面 grep 零命中读数(对照表 R4)。
|
|
||||||
|
|
||||||
- [ ] 名单唯一来源=`design/content-archive/道具退役素材库.md` 两张表的「原名」列,现场解析;禁把 40 个名字复制成第二份清单文件(第 12 节唯一面)。
|
|
||||||
- [ ] 逐处改写口径=「这段代码做什么、按什么序、取值从哪来」,内容名换成机制名。示例(禁照抄字句,只照抄口径):
|
|
||||||
- `:285` 「第一拍矿工重锤命中交换」→ 「命中判定减成换攻击增伤的交换位(现役零注册,随本批摘除后此句消亡)」——摘除后该注释整段随分支删除,改写只适用于 T1 未摘的 11 个文件行。
|
|
||||||
- `reward_roller.gd:1` 「偏运硬币/board_skew 两路投影」→ 「订阅加权与 board_skew 两路投影」。
|
|
||||||
- `grant_segment.gd:232` 「完美布防=本轮封印批全中」→ 「封印全中倍率=本轮 hit>0 且 miss==0 时」。
|
|
||||||
- [ ] 判据 grep:改写后重跑 3.3 那条扫描,注释面命中数必须为 0;读数贴进实现报告。
|
|
||||||
- [ ] 不碰第 5 节点名保留的三行夹具串。
|
|
||||||
|
|
||||||
### T4 玩家可见文案与死匹配(0.25 工作日)
|
|
||||||
|
|
||||||
取用:T0 采到的改前明细行读数。产出:新标签文本(R5/R6 引用)。
|
|
||||||
|
|
||||||
- [ ] `reward_grant.gd:226` 标签 → `"挖掘惩罚减半(%d→%d)"`;同处归因串 `"effect_id": "nest_counter"` → `"nest_halve"`(依代码规范用语纪律清零退役名;该串全仓仅此一处、不进存档不读表,改动面=本行+测试匹配串随动)。
|
|
||||||
- [ ] 同文件 `:183` 与 `:221` 注释随 T3 口径改写;`:189` reason → `"中立移除:3×3 区域内无可移除危险格(须未揭示且未封印)"`。
|
|
||||||
- [ ] `game/core/settlement/grant_segment.gd:166` 明细标签 `"惊巢反制·反弹"` → `"反弹伤害"`,同处归因串 `"attune_nest_counter"` → `"attune_nest_halve"`;`channel == "reflect"` 判据与开单参数字典逐字不动(契约 3)。
|
|
||||||
- [ ] `meta_progression_forge_test.gd`:`:694` 匹配串、`:697` 标签文案、`:699`/`:700` 期望串四处随动到新标签;判据仍绑 `step_row` 采集的 `display_name`,`nc_hit != ""` 与等值断言的强度不得降低。
|
|
||||||
- [ ] `level_autoplay.gd:421` 恒 false 的 `contains("雷区图谱")` 条件与该分支一并删,`:415` 注释随删。
|
|
||||||
- [ ] 窄测:`meta_progression_forge_test`、`round_flow_skill_pool_test`、`damage_controller_test`、`table_structure_guard_test` 四套跑绿。
|
|
||||||
|
|
||||||
### T5 产出物落位卡(0.25 工作日)
|
|
||||||
|
|
||||||
- [ ] 轻闸全绿后、合并前写齐 `reports/<迭代号>-实现报告-<日期>.md`:各 T 卡状态、T0/T2/T3/T4 四条读数、契约 1 三条 grep、改前改后对拍逐位一致结论、实机目检总清单(本批目检项:结算明细行减半标签一眼可读、无退役件名突兀感——登记不阻塞)、遗留读数义务(零现役通道与零订阅事件词两件,已另登待办条目,见第 5 节)、实现决定记录。
|
|
||||||
- [ ] `reports/<迭代号>-反哺点-<日期>.md`:第 6 节每条都要有落点,含「明细标签是否入表」这条规范裁决点。
|
|
||||||
- [ ] 里程碑步出口跑一次全套闸(`tools/run_all_gates.sh --code`);波内出红只做出红最小单元最窄确认。
|
|
||||||
|
|
||||||
## 8 验证闸(改动—验收对照表)
|
|
||||||
|
|
||||||
| # | 需求点(判据出处行锚) | 改动(文件:行) | 验收测试(名称+落点+尾缀) | 层级 | 真实入口 | 判据绑定面 | 能力行 |
|
|
||||||
|---|---|---|---|---|---|---|---|
|
|
||||||
| R1 | 摘四段不可达改写分支(锚 `design/engineering/code-conventions.md:15`) | `damage_controller.gd:297-302/305-309/310-313/351-353/368-372/320-323/623` | `damage_controller_test.gd:_run_recipe_sequence`;`roll_multiplier_test.gd:_smoke_armor_roll`;`round_flow_skill_pool_test.gd:_smoke_full_battle`+dump_battle 六组逐字节比对 | 单元+集成 | `BattleOrchestrator.begin_battle()` → 主角先手开单兑付全链 | `step_row` 明细行文本与 `outcome` 取值逐位=T0 基线;静态判据=契约 1 三条 grep 零注册+摘后键集 grep 零 `spike_ready`。**观测面局限申报**:零现役注册行使分支不可达,无法从真实入口造出命中;禁人为注入表行取证(全项目禁变异类测试) | 既有:伤害单据编排与回放;既有:伤害公式与掷点乘区;既有:轮内流与结算五段全序 |
|
|
||||||
| R2 | `EFFECT_KINDS` 摘 `spike`(锚 `design/engineering/code-conventions.md:15`) | `effect_engine.gd:30` | `effect_kind_retired_test.gd:_assert_rejected`(新断言「词表闭面:kind=spike 出域拒绝」,尾缀 `expect=1 negative=true`) | 单元(负面,独立进程) | `ConfigDB.load_tables()` → `EffectEngine.validate_trigger_row` | 出域错误载荷含 `effect_kinds 出域` 文案+进程退出码 1 | 既有:加载期违规表拒绝:跨表悬空/计数器前缀/真视窄域/效果类型出域 |
|
|
||||||
| R3 | `DO_KEYS` 摘 `trade_hit`/`trade_atk`(锚 `design/engineering/code-conventions.md:15`) | `effect_engine.gd:82` | `effect_kind_retired_test.gd:_assert_rejected`(新断言「do 键闭面:trade_hit 出域拒绝」) | 单元(负面,独立进程) | `ConfigDB.load_tables()` → `EffectEngine.validate_trigger_row` | 键出域拒绝错误载荷含 `trade_hit`+进程退出码 1 | 既有:加载期违规表拒绝:跨表悬空/计数器前缀/真视窄域/效果类型出域 |
|
|
||||||
| R4 | 注释面退役名清零 13 文件 42 行(锚 `design/engineering/code-conventions.md:26`) | 3.3 表全部注释行号 | 静态判据:3.3 那条扫描命令注释面命中 0,读数贴实现报告;`--code` 域内静态扫描与 S11 段不变红;宿主既有套件逐位不变 | 静态(闸件扫描) | `BattleOrchestrator.begin_battle()` 链上宿主套件(改写面不进运行期) | 逐文件 grep 读数(文件名+行号+命中 0)+宿主套件回归 | 既有:换图系刷新链路与效果词表接线;既有:伤害单据编排与回放 |
|
|
||||||
| R5 | 减半明细行去退役件名(锚 `design/engineering/doc-conventions.md:47`) | `reward_grant.gd:226` | `meta_progression_forge_test.gd:_smoke_tree_rules`(换代断言串,落点 694/697/699/700) | 集成(信号采集) | 锻造锋线满级特效 → `BattleOrchestrator.begin_battle()` → `mine_hit` 减半路径 → `step_row` 信号 | `step_row` 行 `display_name` == 「挖掘惩罚减半(6→3)」,且 `power` 减半数值与发射次数逐字不变;`grep -r nest_counter game/` 零命中 | 既有:天赋树购买与六键合成 |
|
|
||||||
| R6 | 空集拒绝 reason 去退役件名(锚 `design/engineering/test-conventions.md:116`) | `reward_grant.gd:189` | 静态判据:`grep -c 爆破工兵包 game/core/reward_grant.gd` == 0;`table_structure_guard_test.gd` 与 `extended_row_violation_test.gd:_init` 跑绿 | 静态+单元 | `ConfigDB.load_tables()` → `_cell_removal_open` 所在兑付链(零现役行不可达) | grep 零命中读数+通道校验面绿。**观测面局限申报**:`cell_removal` 零现役行,reason 不可达,禁造行取证 | 既有:加载期违规表拒绝:跨表悬空/计数器前缀/真视窄域/效果类型出域 |
|
|
||||||
| R7 | 反弹明细标签去退役件名(锚 `design/engineering/doc-conventions.md:47`) | `grant_segment.gd:166` | 静态判据:`grep -rc "惊巢反制·反弹" game/` == 0 且 `grep -rc "attune_nest_counter" game/` == 0;`round_flow_skill_pool_test.gd:_smoke_full_battle` 跑绿 | 静态+集成 | `BattleOrchestrator.begin_battle()` → `mine_hit` 订阅施加链(`channel="reflect"` 二十一张表零命中,今天不可达) | grep 零命中+发射面零变化回归。**观测面局限申报**:同上,禁造行取证 | 既有:轮内流与结算五段全序 |
|
|
||||||
| R8 | sim 恒 false 匹配删除(锚 `design/engineering/test-conventions.md:116`) | `level_autoplay.gd:415/421` | 静态判据:`game/sim/` 全域 grep `雷区图谱` 零命中;`--code` 域内驱动件相关套件跑绿 | 静态+单元 | `game/sim/level_autoplay.gd` 驱动链(测量面,不进游戏运行) | grep 零命中+套件绿。**观测面局限申报**:恒 false 条件不可达,禁造行取证 | 既有:轮内流与结算五段全序 |
|
|
||||||
|
|
||||||
测试方式两分法:R1/R2/R3/R5 归调试接口与真实入口断言;R6/R7/R8 三处的改动点今天不可达(零现役注册行驱动),一律走静态判据+观测面局限申报,禁造行取证,也不设目检;R5 的文本观感归用户目检——目检项「结算明细减半标签文本可读」写进实现报告总清单,登记不阻塞,不作合回前置。
|
|
||||||
|
|
||||||
闸口径:本批改动含 `game/` 下非 `.md` 行为载体 → 按 `tools/run_all_gates.sh --code` 选档,所选域全绿才合并;卡内不写死闸件名单。
|
|
||||||
|
|
||||||
回归措辞:里程碑步(T 段)出口跑一次全套闸;波内修复只做出红最小单元的最窄确认;新增探针先行孤立验证再并入全套。
|
|
||||||
|
|
||||||
测试削弱申报:唯一允许改的旧断言=`meta_progression_forge_test.gd:694/697/699/700` 四处期望串,理由是 R5 文案换代要求名实相符;断言强度(非空判定+等值判定+不含旧词)一条不降,阈值与扫描面不放宽。除此之外任何断言删除、阈值放宽、扫描面缩小都属未申报改动,独立验收审计判红。
|
|
||||||
|
|
||||||
独立验收审计:入口=合回前由未参与实现的会话或子代理执行,报告落 `reports/<迭代号>-验收审计-<日期>.md`;本档验收档=中,按 test-conventions §8.7 中档梯度核(R1/R2/R3/R5 四条必须逐条核到判据绑定面)。
|
|
||||||
|
|
||||||
## 9 异常分级
|
|
||||||
|
|
||||||
- L1 自救:注释措辞不通、局部变量名残留、grep 命令写法——就地改,不动判据。
|
|
||||||
- L2 记录继续:T1 单元侧适配出现既有断言装配报错(3.6 已预判零命中),按申报范围改装配并记入实现报告「实现决定记录」。
|
|
||||||
- L3 停机呈报并写报告:
|
|
||||||
1. 契约 1 任一条 grep 读数非零(分支可达)=上游事实与卡片互斥,停卡退回写卡段。
|
|
||||||
2. 摘词后加载出现非预期致命(现役行被误判出域)或现役套件出红且原因落在本批摘除面。
|
|
||||||
3. 机检预算与卡片契约互斥(例:收窄后某函数键数低于登记值触发基线红/留空壳才能凑绿)=停卡退回写卡段,禁自造第三条路。
|
|
||||||
4. 按纪律无法干净摘除、必须保留中间壳函数才能过闸=停卡呈报走豁免/还债通道,禁硬拆凑绿。
|
|
||||||
5. R5 断言换代后仍红且原因在数值或发射序(说明文案改动越界)。
|
|
||||||
|
|
||||||
## 10 代拍板白名单
|
|
||||||
|
|
||||||
允许实现期自行拍板:注释改写的具体中文措辞(守契约 2 即可);负面探针常量与夹具目录命名(沿用既有形态);grep/扫描命令写法;是否把 T3 与 T4 并成一次提交;测试文件内局部变量改名;实现报告小节标题措辞。
|
|
||||||
超出白名单=记入实现报告「实现决定记录」,不得静默。
|
|
||||||
|
|
||||||
## 11 待裁点
|
|
||||||
|
|
||||||
零待裁点,开工门=U0。(机制删留与注释口径已由用户在 2026-11-05 会话裁毕;GDD 四处错陈述已在写卡段前置文档段落文 v0.13;「明细标签是否入表」与三件遗留读数不属本卡执行面,已列第 5/6 节去向。)
|
|
||||||
|
|
||||||
## 12 落位与可复用性预检
|
|
||||||
|
|
||||||
- 复用面:本批零新增文件。负域探针复用 `game/tests/unit/data_config/effect_kind_retired_test.gd` 既有 `_inject`/`_assert_rejected` 骨架——它正是「退役词出域即加载致命」的现成载体,新建套件=重复落点。注释改写复用既有文件与函数,无新 helper。
|
|
||||||
- 唯一面:退役内容名清单的唯一来源=`design/content-archive/道具退役素材库.md`,判据脚本现场解析,禁在 `game/` 或 `tools/` 落第二份名单;摘词只改 `effect_engine.gd` 两处常量,`treasure_item_table.gd:20` 的注释属说明面(随 T3 改写),不另立词表。
|
|
||||||
- 分层与交互面:`game/core/damage_controller.gd` 与 `game/core/effect_engine.gd` 的交互仍走既有 `_fx_hits` 查询口与 `validate_trigger_row` 校验口,本批只删消费环、不改接口;`reward_grant.gd` 文案改动不动 `emit_cb` 契约;`game/sim/` 驱动件不回连产品码。Core 零 UI、数值只经 ConfigDB、随机只经 RngService 三条红线本批一律不绕(本批不新增数值与随机消费)。
|
|
||||||
|
|
||||||
## 13 禁为机检文本保留无效成员
|
|
||||||
|
|
||||||
本卡为清退类:禁止为迎合机检消息文本或计数保留/新增任何无效成员、空壳函数、无用别名或 ctx 冗余键——`spike_ready`、`ar_hits`、`shift`、`trade_hit` 局部变量与 `_discount_shift_up` 一律随分支删净。机检键与本卡契约互斥时,实现段停卡呈报,不得自造第三条路。
|
|
||||||
|
|
||||||
## 14 实现规范预算
|
|
||||||
|
|
||||||
本批无新增文件,新件三查不适用;执行的是存量触面一查:
|
|
||||||
|
|
||||||
- `game/core/damage_controller.gd`:T1 摘除使 `_ctx_rewrites` 与 `_hero_attack_base_value` 的分支数、函数长度下降;`_discount_shift_up` 整函数消亡。预期 S13 键只降不升,T0 抄录现登记值、T5 抄录摘后读数两张对照。
|
|
||||||
- `game/core/effect_engine.gd`:两处常量字面量变短,方法数与成员变量数不变。
|
|
||||||
- `game/core/reward_grant.gd`、`game/sim/level_autoplay.gd`:只删文本与一条恒 false 条件,分支数下降或持平。
|
|
||||||
- 指标例外通道:本卡不申报任何例外——若摘除后仍有键超默认,属存量在册键,沿用 `tools/gdstyle_baseline.txt` 现登记,不新增。
|
|
||||||
|
|
||||||
## 15 拆分边界纪律
|
|
||||||
|
|
||||||
本卡是清退类,不产生拆出单元;条款照写以防实现期顺手重组:
|
|
||||||
|
|
||||||
1. 若实现中确需拆出新私有函数或新段件,每个单元必须能写出一句职责陈述与单一变化原因,并逐件写进实现报告;写不出=凑计数袋,回炉。
|
|
||||||
2. 「过阈值」只作发现信号,禁作为本批拆分或收拢的动机——本批唯一动机是零现役注册分支的清退。
|
|
||||||
3. 按纪律无法干净摘除时停卡呈报走豁免/还债通道,禁硬拆凑绿(进第 9 节 L3 第 4 条)。
|
|
||||||
+3
-3
@@ -5,8 +5,8 @@
|
|||||||
## 当前位(只回答「现在该做什么」;三行内随批次换代,禁止在此扩写成状态快照)
|
## 当前位(只回答「现在该做什么」;三行内随批次换代,禁止在此扩写成状态快照)
|
||||||
|
|
||||||
- **阶段**:M3——Alpha 版本的完整实现(2026-10-09 立规:未明令宣布完成前停留 M3,迭代只排 M3 需求,M4 不排期;根目录 stage.txt 为旧阶段开关仅存档)。
|
- **阶段**:M3——Alpha 版本的完整实现(2026-10-09 立规:未明令宣布完成前停留 M3,迭代只排 M3 需求,M4 不排期;根目录 stage.txt 为旧阶段开关仅存档)。
|
||||||
- **迭代位**:迭代 1–52 全部已完成;各迭代收口与批后收尾沿革查 git 提交信息与 `reports/`。
|
- **迭代位**:迭代 1–53 全部已完成;各迭代收口与批后收尾沿革查 git 提交信息与 `reports/`。
|
||||||
- **下一步**:无已编迭代在飞——待编池:改写族孤儿(待处置方向裁决)、二三关棋盘观感(待设计+待美术)、EC8 热重载实装(待用户另立条目);测试面真输入化分期与存量断言逐条精锚(待执行,归下批编排)。
|
- **下一步**:无已编迭代在飞——待编池:效果通道与事件词零现役普查(待写卡)、结算明细文案入表(待文档设计)、二三关棋盘观感(待设计+待美术)、测试面真输入化分期与存量断言逐条精锚(待执行)、QA 覆盖总览面板与自动试玩扩展(待执行);EC8 热重载实装待用户另立条目。
|
||||||
|
|
||||||
## 里程碑时间线
|
## 里程碑时间线
|
||||||
|
|
||||||
@@ -86,7 +86,7 @@
|
|||||||
| 迭代 50 | 已完成(2026-11-03) | 已退役(git 历史可考) | 2026-11-03 | ≈12.875 个工作日〔用户特批 2026-11-03 超 10 个工作日〕 | 已退役(git 历史可考) |
|
| 迭代 50 | 已完成(2026-11-03) | 已退役(git 历史可考) | 2026-11-03 | ≈12.875 个工作日〔用户特批 2026-11-03 超 10 个工作日〕 | 已退役(git 历史可考) |
|
||||||
| 迭代 51 | 已完成(2026-11-04) | 已退役(git 历史可考) | 2026-11-04 | ≈6.625 个工作日 | 已退役(git 历史可考) |
|
| 迭代 51 | 已完成(2026-11-04) | 已退役(git 历史可考) | 2026-11-04 | ≈6.625 个工作日 | 已退役(git 历史可考) |
|
||||||
| 迭代 52 | 已完成(2026-11-05) | 已退役(git 历史可考) | 2026-11-04 | ≈9.275 个工作日 | 已退役(git 历史可考) |
|
| 迭代 52 | 已完成(2026-11-05) | 已退役(git 历史可考) | 2026-11-04 | ≈9.275 个工作日 | 已退役(git 历史可考) |
|
||||||
| 迭代 53 | 待开工 | reports/需求卡片-卷轴视口批-2026-11-05.md<br>reports/需求卡片-改写族孤儿机制与退役名清退批-2026-11-05.md | 2026-11-05 | ≈6.0 个工作日 | — |
|
| 迭代 53 | 已完成(2026-11-06) | 已退役(git 历史可考) | 2026-11-05 | ≈6.0 个工作日 | 已退役(git 历史可考) |
|
||||||
|
|
||||||
- 历史行的「—」= 该列事实不可考:迭代 1~8 早于需求卡片制;编排时点与预计周期不再回溯,细节查 git 提交史。
|
- 历史行的「—」= 该列事实不可考:迭代 1~8 早于需求卡片制;编排时点与预计周期不再回溯,细节查 git 提交史。
|
||||||
- 「已退役(git 历史可考)」= 需求卡片或实现报告曾存在,已按「证据只留最新」退役;已完成迭代的实现报告列只填 reports/ 现存路径或本保留字,不填「—」。
|
- 「已退役(git 历史可考)」= 需求卡片或实现报告曾存在,已按「证据只留最新」退役;已完成迭代的实现报告列只填 reports/ 现存路径或本保留字,不填「—」。
|
||||||
|
|||||||
@@ -132,6 +132,16 @@ def product_funcs():
|
|||||||
return names
|
return names
|
||||||
|
|
||||||
|
|
||||||
|
def probe_funcs():
|
||||||
|
# 真实入口锚面补探针共用面(capability E 规则用):真输入合成沿(probe_ui_util 等探针
|
||||||
|
# 共用件)写进能力行真实入口格后,卡片退役其凭证只能锚代码面——探针件定义与 D 规则
|
||||||
|
# 同口径认锚(仍要求 func 真实存在,不属放宽)。
|
||||||
|
names = set()
|
||||||
|
for p in (REPO / "game" / "probe").rglob("*.gd"):
|
||||||
|
names.update(re.findall(r"^(?:static\s+)?func\s+([A-Za-z_]\w*)\s*\(", read(p), re.M))
|
||||||
|
return names
|
||||||
|
|
||||||
|
|
||||||
def cards_corpus():
|
def cards_corpus():
|
||||||
"""reports/需求卡片*.md 全文拼接(双通道的「卡在」锚面);无卡返回空串。"""
|
"""reports/需求卡片*.md 全文拼接(双通道的「卡在」锚面);无卡返回空串。"""
|
||||||
if not CARDS_DIR.is_dir():
|
if not CARDS_DIR.is_dir():
|
||||||
@@ -266,7 +276,7 @@ def check_entry(no, name, cell, funcs, cards):
|
|||||||
for _, method in tokens:
|
for _, method in tokens:
|
||||||
if method not in funcs and not (cards and method in cards):
|
if method not in funcs and not (cards and method in cards):
|
||||||
red(README.relative_to(REPO), no, "真实入口",
|
red(README.relative_to(REPO), no, "真实入口",
|
||||||
"「%s」方法 %s() 无凭证——产品码与 sim 测量件无定义且需求卡片未载" % (name[:16], method))
|
"「%s」方法 %s() 无凭证——产品码、sim 测量件与探针件均无定义且需求卡片未载" % (name[:16], method))
|
||||||
|
|
||||||
|
|
||||||
def check_coverage(cov_tables, names):
|
def check_coverage(cov_tables, names):
|
||||||
@@ -333,7 +343,7 @@ def main():
|
|||||||
suites = manifest()
|
suites = manifest()
|
||||||
if not suites:
|
if not suites:
|
||||||
selfcheck.append("run_all.gd manifest 零套件")
|
selfcheck.append("run_all.gd manifest 零套件")
|
||||||
funcs = product_funcs()
|
funcs = product_funcs() | probe_funcs()
|
||||||
if not funcs:
|
if not funcs:
|
||||||
selfcheck.append("产品码零 `func`")
|
selfcheck.append("产品码零 `func`")
|
||||||
names, referenced = check_capability_rows(cap_tables, suites, funcs, cards_corpus())
|
names, referenced = check_capability_rows(cap_tables, suites, funcs, cards_corpus())
|
||||||
|
|||||||
@@ -508,3 +508,14 @@
|
|||||||
| 1 | 三关封印格观感 | 环+十字+环外压暗光圈呈形正确、与格底可辨;像素判据已在机检承载,本项为观感复核 |
|
| 1 | 三关封印格观感 | 环+十字+环外压暗光圈呈形正确、与格底可辨;像素判据已在机检承载,本项为观感复核 |
|
||||||
| 2 | 战末金蜡封徽记观感 | 贴图路径未动(零预期变化)——观感确认项 |
|
| 2 | 战末金蜡封徽记观感 | 贴图路径未动(零预期变化)——观感确认项 |
|
||||||
| 3 | 封印格与变异纹带同格观感 | 两层共存可辨、不脏面(零代码触面——观感确认项) |
|
| 3 | 封印格与变异纹带同格观感 | 两层共存可辨、不脏面(零代码触面——观感确认项) |
|
||||||
|
## 52 卷轴视口与结算文案换代目检(迭代 53)
|
||||||
|
|
||||||
|
> 关卡画面视口化(卷轴视口)与结算文案换代(减半标签)后,机检已覆盖行为与像素面(探针 26 断言+golden 两 Shot 逐像素+明细行等值断言),观感面按登记不阻塞立规不拦合并。
|
||||||
|
|
||||||
|
| # | 目检项 | 判据 |
|
||||||
|
|---|---|---|
|
||||||
|
| 1 | 深图卷轴视口实跑观感 | 深度 13+ 图拖拽平滑可达首末列;停点推进跟随方向感自然、当前节点居中锚即时;拖拽不误触选路 |
|
||||||
|
| 2 | 指引件观感 | 深图两侧渐隐带与顶部平移提示 chip 可辨、不碍选路;浅图两件均不出现 |
|
||||||
|
| 3 | 结算明细减半标签 | 「挖掘惩罚减半(6→3)」一眼可读,无退役件名突兀感 |
|
||||||
|
|
||||||
|
- **结论回流**:观感问题归待办清单登记新条目;数值面不在目检现场改数。
|
||||||
@@ -20,14 +20,15 @@
|
|||||||
|
|
||||||
**状态**:待文档设计
|
**状态**:待文档设计
|
||||||
|
|
||||||
#### 超预算图策略升级路径——等比缩放与滚动视口两案待裁(2026-10-24 登记,来源=批次移交)
|
#### 结算明细文案入表——玩家可见明细文案归属改数据表承载(2026-11-06 登记,来源=批次移交)
|
||||||
|
|
||||||
**实况**:2026-11-05 用户裁滚动视口案落地(等比缩放案否决——像素纪律):关卡画面卷轴视口,跟随+拖拽+滚轮、平滑滚动(减动效瞬切)、当前节点居中锚;「图包络 ≤ 屏预算」约束退役,画布随图生长、规模归参数档。设计闭合凭据:design/gdd/ux/level-map.md v2.0(布局决策 5+视口效果图内嵌,2026-11-05 人审通过);design/gdd/systems/冒险循环/关卡节点图生成.md v1.5(参数契约节+图规模无呈现侧上限句)。需求卡片=reports/需求卡片-卷轴视口批-2026-11-05.md(grilling 复核裁决全落,验收档中)。
|
**实况**:迭代 53 反哺点 4 归属裁决在案=文案入数据表行(2026-11-06 用户裁);规范句已落 [战斗结算](design/gdd/systems/战斗循环/战斗结算.md) v1.8 明细流水节(显示名等玩家可见文案=数据面字段,代码读表拼行、禁代码写死文案字串);现行代码硬编码面=结算明细扩展行标签文案(如减半标签,reward_grant.gd:226 一族)。
|
||||||
- 相关文档:关卡节点图参数取值域已归数据 schema 层;schema 头注「域并单点=调参表」指针反转随实现批顺带(卡片随动项);需求卡片 reports/需求卡片-卷轴视口批-2026-11-05.md(grilling 复核裁决全落,验收档中)。
|
|
||||||
|
|
||||||
**改动面**:文档
|
**缺口**:还差表结构设计讨论——承载表与字段形态、基础行文案是否同批入表、读表拼行接线面。
|
||||||
|
|
||||||
**状态**:文档设计已闭合+已写卡+已编迭代 53
|
**改动面**:文档+游戏代码
|
||||||
|
|
||||||
|
**状态**:待文档设计
|
||||||
|
|
||||||
#### UI 贴图重构批——元进度件仍是程序化占位(2026-10-13 登记,来源=审计发现)
|
#### UI 贴图重构批——元进度件仍是程序化占位(2026-10-13 登记,来源=审计发现)
|
||||||
|
|
||||||
@@ -234,14 +235,6 @@
|
|||||||
|
|
||||||
### 文档与结构
|
### 文档与结构
|
||||||
|
|
||||||
#### damage_controller 按序改写族——内容孤儿机制与退役名注释层(2026-11-04 登记,来源=会话提及)
|
|
||||||
|
|
||||||
**实况**:damage_controller.gd 按序改写族通用机制(trade_hit/trade_atk 交换、armor_rewrite 免掷、spike 满层必中与倍乘、discount_shift 轻甲改善——注释叙事 :285-290、改写执行 :291-325、增伤与倍乘 :350-353 与 :368-372)现役内容面仅淬毒刃纹一行 modify_ticket(mode=clamp_bonus,feats.tres:853-857):其余子分支零表行注册(全仓 grep 证)——「框架先行、内容未接」同族债。五拍注释全以旧 27 专长名叙事(矿工重锤/专注/厚积薄发/猎弱本能,道具退役素材库.md:43-47 退役在案);charge_layers 四处已归 EffectPort 蓄力层删键批(实现提交 ace15701)。2026-11-05 会话裁决=孤儿机制与退役名一律清退(口径「只要有问题的都要改」);同轮核出 spike 的 GDD 承接句站不住(候选条写「零新代码——spike 在册」,实为词面在册、全仓零派发点;长枪条同类——attack_segments 已随架构审查甲案退役),据此订正该节四处陈述。全仓扫=40 退役名命中 53 行/13 文件(注释面 42、字面量 11),逐处清单见卡片。关联文档:设计定稿=design/gdd/systems/跨局循环/锻造工坊.md v0.13(2026-11-05);需求卡片=reports/需求卡片-改写族孤儿机制与退役名清退批-2026-11-05.md
|
|
||||||
|
|
||||||
**改动面**:游戏代码
|
|
||||||
|
|
||||||
**状态**:文档设计已闭合+已写卡+已编迭代 53
|
|
||||||
|
|
||||||
#### 效果通道与事件词的零现役普查(2026-11-05 登记,来源=审计发现)
|
#### 效果通道与事件词的零现役普查(2026-11-05 登记,来源=审计发现)
|
||||||
|
|
||||||
**实况**:普查报告 reports/普查-效果通道与事件词零现役-2026-11-06.md——结论=内容层零孤儿、四词表+秘宝表 schema 旧词层全部属预留埋点(词面全保留零清退项;架构原则=词表先行内容后接)。叙述脱节 5 处已按「预留、未设计入表」口径订正(2026-11-06 用户令直改,冒烟 15 项 0 失败三闸全过)。
|
**实况**:普查报告 reports/普查-效果通道与事件词零现役-2026-11-06.md——结论=内容层零孤儿、四词表+秘宝表 schema 旧词层全部属预留埋点(词面全保留零清退项;架构原则=词表先行内容后接)。叙述脱节 5 处已按「预留、未设计入表」口径订正(2026-11-06 用户令直改,冒烟 15 项 0 失败三闸全过)。
|
||||||
@@ -262,8 +255,24 @@
|
|||||||
|
|
||||||
#### QA 覆盖总览面板与自动试玩扩展——自动发现测试验证缺漏(2026-11-05 登记,来源=会话提及)
|
#### QA 覆盖总览面板与自动试玩扩展——自动发现测试验证缺漏(2026-11-05 登记,来源=会话提及)
|
||||||
|
|
||||||
**实况**:方案全文=`D:\code\qa-harness-discussion\QA-Harness讨论结果-中间报告.md`(三批定案,全部三关试点):①探针存量 emit 真输入化(~40 处站点,承接上条)②B 覆盖总览面板+本体枚举器(六源回执明细化+能力清单提取+HTML 双击即开+游戏内容↔测试验证对账)③C 自动试玩扩展(auto_player 扩全动线全功能,异常上报含机器自填归因)。裁决在案勿重提:A 执行覆盖矩阵不做、D 缺口闸不做、变异测试禁入、归因登记不立独立制度。
|
**实况**:方案全文=`D:\code\qa-harness-discussion\QA-Harness讨论结果-中间报告.md`(三批定案,全部三关试点);证据=真实入口缺口在册:能力行「营地七物件命中区点选与分界面可达」残险行 game/tests/README.md:158(emit 直发标「接线验证」、真输入承载待建)+test-conventions §8.3 真实入口判定口径条款(2026-11-05 收窄)。①探针存量 emit 真输入化(~40 处站点,承接上条)②B 覆盖总览面板+本体枚举器(六源回执明细化+能力清单提取+HTML 双击即开+游戏内容↔测试验证对账)③C 自动试玩扩展(auto_player 扩全动线全功能,异常上报含机器自填归因)。裁决在案勿重提:A 执行覆盖矩阵不做、D 缺口闸不做、变异测试禁入、归因登记不立独立制度。
|
||||||
|
|
||||||
**改动面**:游戏代码+工具代码+文档
|
**改动面**:游戏代码+工具代码+文档
|
||||||
|
|
||||||
**状态**:待执行
|
**状态**:待执行
|
||||||
|
|
||||||
|
#### 闸机超时守卫缺陷修复——gate_run_timeout 标志文件恒真(2026-11-06 登记,来源=批次移交)
|
||||||
|
|
||||||
|
**实况**:tools/gate_platform.sh 的 gate_run_timeout 用 mktemp 预建超时标志文件,判据 `[ -f ]` 建时即真、超时态无法与正常完成区分(Windows Git Bash 实测直接调用 4 秒返回 124;远端各闸以工件锚定未受影响)。连带 tools/golden_baseline_refresh.sh 的 guard 子Shell sleep 420 未被 kill 短路(重采集等待 7 分钟症状)。修法=kf 先赋路径+rm -f 后置守卫(probe_gate.sh:97 run_suite 同款正确写法)。证据=tools/gate_platform.sh:37/:48+迭代53实现报告遗留呈报 1(git 历史可考)。
|
||||||
|
|
||||||
|
**改动面**:工具代码
|
||||||
|
|
||||||
|
**状态**:待执行
|
||||||
|
|
||||||
|
#### 关卡视口两 Shot 基线 mac 侧冻结(2026-11-06 登记,来源=批次移交)
|
||||||
|
|
||||||
|
**实况**:golden/windows/ 已锚 lmap_entry/lmap_boss(提交 6394abf7);mac 子目录无该两 Shot——渲染闸对 mac 缺基线记 SKIP 不判红,两平台同盯缺一。义务=Mac 侧跑 tools/golden_baseline_refresh.sh --lmap 冻结 mac 基线并呈报确定性读数。证据=game/tests/golden/README.md 现持清单行与时效判定纪律行+迭代53实现报告遗留 2(git 历史可考)。
|
||||||
|
|
||||||
|
**改动面**:游戏代码
|
||||||
|
|
||||||
|
**状态**:待执行
|
||||||
Reference in new issue
Block a user