合并(EffectPort蓄力层删键批·写卡收口·用户裁决成立): 需求卡片v1.1(grilling四裁落稿:注释只清charge_layers关联语义/改写族孤儿另立待办/编排凑批/程序纠错在案)+待办两条目(charge_layers条回写v1.1与四裁记录·改写族孤儿新立待文档设计); 收口程序=冻结→件核→并master(70424e0d)→主区合回→删区,成立裁决后执行; pipeline_gate PASS

2026-11-04 02:22:16 +08:00
commit 0e26168ac8
@@ -1,8 +1,8 @@
 # 需求卡片：EffectPort 蓄力层删键批

 > 来源：待办清单「EffectPort biz_fact 键 charge_layers——无属主数据游离出领域实体的处置」（2026-11-02 登记，来源=审计发现；需求性工程条目，证据指认在条目实况）。**唯一事实源：该条目实况所引证据链＋本卡「现状事实」节代码级考证（2026-11-04 全部实查复核）。**
-> 裁决沿革：删除方向 2026-11-02 用户裁（总判据「机制数据一律长在所属封装实体的内部属性（表行字段）里，全局常量与无主账本清零」）；2026-11-04 本会话全仓考证确认死代码（零内容消费面）后用户发令删除。
-> 版本：v1.0（2026-11-04）
+> 裁决沿革：删除方向 2026-11-02 用户裁（总判据「机制数据一律长在所属封装实体的内部属性（表行字段）里，全局常量与无主账本清零」）；2026-11-04 本会话全仓考证确认死代码（零内容消费面）后用户发令删除；2026-11-04 grilling 复核四裁（注释口径甲＝只清 charge_layers 关联语义／改写族孤儿另立待办／req-card 落盘时点条款落技能／编排意向凑批）。
+> 版本：v1.1（2026-11-04）

 ## 1. 目标与完成定义

@@ -67,6 +67,7 @@
 - `test_charge_layers_consumed_same_round` 函数**不改名**——它是 swap_charge_layers（蓄力周转）测试，函数名属该计数器域；且 README:126 能力行代表用例名锚定此名，实现批禁写 README。
 - 蓄力周转、敌方蓄力、RAP/转存率任何面（契约 1–3）。
 - 蓄力周转测试面牵连核对结论：`refresh_feats_test` V8 组全部经效果引擎计数器域运行，不触 `action_economy.charge_layers`（全仓 grep 已证）——零牵连，无需同批改动。
+- **改写族内容孤儿机制**（grilling 2026-11-04 新发现，另立待办）：damage_controller.gd 按序改写族通用机制的 spike/armor_rewrite/discount_shift/trade_* 子分支零内容注册（全仓唯一 modify_ticket 在役行=淬毒刃纹 clamp_bonus，feats.tres:854）＋五拍注释退役名叙事层（矿工重锤/专注/猎弱本能）——不持数据键、非本卡对象，已立待办清单专条，处置方向归其自己的设计讨论。
 **明示不收件的去向**：无——单链清退一次做完，无拆尾。

 ## 6. 关联文档同步面
@@ -112,7 +113,7 @@

 ### T1 注释清尾与零残留核验（≈0.25 工作日）

- [ ] `damage_controller.gd:271/338/352/433`：四处退役专长名注释删或改写为现状口径（禁残留整备军备/铁壁/厚积薄发/charge_layers 字样；:433 行剩余的 shield 订阅面注释主体保留，只删按层缩放句）
+- [ ] `damage_controller.gd` 四处只清 charge_layers 关联语义、改机制语言，五拍块其余退役名（矿工重锤/专注/猎弱本能——grilling Q1 甲裁）不动：:271 第三拍句删「when charge_layers≥3 在 dispatch 判定——满层持续状态口径」分句与「厚积薄发」点名，spike_ready 机制行为描述保留；:338 删「整备军备」点名，句改「attack_bonus per 计数器层值」机制口径；:352 删「厚积薄发」点名，改「modify_ticket mode=spike 满层口径」；:433 删「铁壁整备」点名，shield 订阅面机制描述保留（禁残留整备军备/铁壁/厚积薄发/charge_layers 字样）
 - [ ] `effect_port_test.gd:16/57/103`：三处误标注释改写——:16 改「蓄力周转计数器（feats.tres swap_charge_layers 行）」、:57/:103 删「整备军备/铁壁」字样改现状描述
 - [ ] 零残留判据：`grep -rn "charge_layers\|charge_full\|CHARGE_LAYER\|蓄力层\|转蓄力\|厚积薄发\|铁壁\|整备军备" game/ --include="*.gd" --include="*.tres"` 除 `swap_charge_layers` 域（`refresh_feats_test.gd` 函数名 `test_charge_layers_consumed_same_round` 与 `feats.tres` swap 行）外零命中
 - [ ] S13 核对：`action_economy.gd` 类变量数较登记值只降不升（删 `_charge_layers` 后预期 10→9）；其余触面同判据
@@ -273,12 +273,24 @@

 #### EffectPort biz_fact 键 charge_layers——无属主数据游离出领域实体的处置（2026-11-02 登记，来源=审计发现）

-**实况**：证据＝reports/审计-全库架构审查-2026-10-29.md §3.1 B 类第 2 行＋`game/core/effect_port.gd:4`（biz_fact 闭面五键）＋`game/core/action_economy.gd:14/37/203`（裸账本与唯一写点）。2026-11-02 架构审查逐键核闭面：其余四键各有领域实体持有数据，唯 charge_layers 背后是无主账本（全仓零订阅注册、零表行消费）；用户裁决＝删除方向，总判据「机制数据一律长在所属封装实体的内部属性（表行字段）里，全局常量与无主账本清零」。需求卡片 reports/需求卡片-EffectPort蓄力层删键批-2026-11-04.md（v1.0——处置范围、残留面考证与断言换代申报全载卡内）。
+**实况**：证据＝reports/审计-全库架构审查-2026-10-29.md §3.1 B 类第 2 行＋`game/core/effect_port.gd:4`（biz_fact 闭面五键）＋`game/core/action_economy.gd:14/37/203`（裸账本与唯一写点）。2026-11-02 架构审查逐键核闭面：其余四键各有领域实体持有数据，唯 charge_layers 背后是无主账本（全仓零订阅注册、零表行消费）；用户裁决＝删除方向，总判据「机制数据一律长在所属封装实体的内部属性（表行字段）里，全局常量与无主账本清零」。需求卡片 reports/需求卡片-EffectPort蓄力层删键批-2026-11-04.md（v1.1——处置范围、残留面 15 处考证、断言换代申报与 grilling 四裁点落稿全载卡内）。
+
+**2026-11-04 grilling 四裁（实现面按推荐案）**：①注释只清 charge_layers 关联语义（四处去退役名留机制描述），五拍其余退役名不动；②改写族孤儿另立条目（见下）；③req-card 落「卡片落盘时点」条款；④编排凑批。纠错记录：v1.0 曾成文未复核态被误收口合回（错误在案）；v1.1 新 worktree 落笔、成立裁决后才合回。

 **改动面**：游戏代码

 **状态**：已写卡

+#### damage_controller 按序改写族——内容孤儿机制与退役名注释层（2026-11-04 登记，来源=会话提及）
+
+**实况**：damage_controller.gd 按序改写族通用机制（trade_hit/trade_atk 交换、armor_rewrite 免掷、spike 满层必中与倍乘、discount_shift 轻甲改善——注释叙事 ：266-273、改写执行 ：283-309、spike 倍乘 ：350-353）现役内容面仅淬毒刃纹一行 modify_ticket（mode=clamp_bonus，feats.tres:854）：其余子分支零表行注册（全仓 grep 证，含天赋树 tree_rules 面零 spike）——「框架先行、内容未接」同族债，与 charge_layers 同形态但不持数据键。五拍注释全部以旧 27 专长名叙事（矿工重锤/专注/厚积薄发/猎弱本能，道具退役素材库.md:43-47 退役在案）；其中 charge_layers 关联四处已归 EffectPort 蓄力层删键批卡处理，其余退役名注释不在该卡范围。证据：reports/需求卡片-EffectPort蓄力层删键批-2026-11-04.md 范围边界节（2026-11-04 grilling 复核发现）。
+
+**缺口**：还差处置方向裁决——删孤儿分支（零内容面随批清退）vs 留机制待内容（专长池扩充时接），裁后写卡；注释叙事层是否随处置批一并改机制语言同裁。
+
+**改动面**：游戏代码
+
+**状态**：待文档设计
+
 #### ci_watch 中间态误写终局红回执（2026-11-04 登记，来源=批次移交）

 **实况**：2026-11-04 run 37（commit 536dc072）实证——ci-status.json 于 16:59:55 写入 verdict=red（note=远端CI state=failure, run 37），而该 run 实际 17:03:10 才以「Job succeeded」落定，现查 Gitea API 组合状态＝success、run conclusion＝success；回执与真值相反，下游按「红未修不开新批」被误阻塞（验收档与条目限长批开工时人工查 API 解封）。证据＝job 日志结尾「Job succeeded」（Gitea API actions/jobs/38/logs）＋commits/536dc072/status 现查 success。修复方向＝轮询只认 run conclusion 落定后的终局态（pending／中间态不写盘继续等）。