feat(skill-system): 新增计时debuff机制，支持技能命中敌方附加减益效果

本次提交完整实现了技能对敌附加debuff的完整流程：
1.  新增TimedDebuffSnapshot数据结构，用于透传debuff配置
2.  在SkillConfig和SkillOverrides中新增debuff相关配置项
3.  实现HeroAtkSystem中debuff的判定与施加逻辑
4.  完善后台配置、前端编辑器的debuff配置支持
5.  调整了buff目标判定逻辑，修复了原有默认目标的语义混淆问题
6.  优化了BuffSystem的调试日志，新增了debuff分类标识
7.  批量更新了现有英雄技能的debuff配置示例

put/server/data/heroes.json

@@ -31,10 +31,9 @@
               "lv": 2,
               "s_lv": 2,
               "overrides": {
-                "timed_buff_id": 7012,
-                "buff_value": 30,
-                "buff_chance": 100,
-                "buff_duration": 5
+                "timed_debuff_id": 7007,
+                "debuff_value": -10,
+                "debuff_chance": 100
               },
               "desc": "普通攻击造成 120% 攻击伤害"
             }
@@ -146,7 +145,7 @@
           "cdExpr": null,
           "overrides": {
             "ap": 150,
-            "timed_buff_id": 7002,
+            "timed_debuff_id": 7002,
             "icon": "Stat_AttackSpeed_02"
           },
           "desc": "斩出气刃，对{target}造成攻击力{ap}%伤害，并使目标易伤（受到伤害加深，持续{dur}秒）",
@@ -435,11 +434,11 @@
               "lv": 2,
               "s_lv": 2,
               "overrides": {
-                "timed_buff_id": 7007,
-                "buff_value": 30,
-                "buff_chance": 30
+                "timed_debuff_id": 7007,
+                "debuff_value": 30,
+                "debuff_chance": 30
               },
-              "desc": "普通攻击有{buff_chance}%概率使目标出血（每0.5秒受到{buff_value}点伤害，持续{dur}秒）"
+              "desc": "普通攻击有{debuff_chance}%概率使目标出血（每0.5秒受到{debuff_value}点伤害，持续{dur}秒）"
             }
           ]
         },
@@ -458,20 +457,20 @@
               "s_lv": 2,
               "overrides": {
                 "ap": 250,
-                "timed_buff_id": 7007,
-                "buff_value": 40
+                "timed_debuff_id": 7007,
+                "debuff_value": 40
               },
-              "desc": "高速斩击{target}，造成攻击力{ap}%，并使目标出血（每0.5秒受到{buff_value}点伤害，持续{dur}秒）"
+              "desc": "高速斩击{target}，造成攻击力{ap}%，并使目标出血（每0.5秒受到{debuff_value}点伤害，持续{dur}秒）"
             },
             {
               "lv": 16,
               "s_lv": 3,
               "overrides": {
                 "ap": 350,
-                "timed_buff_id": 7007,
-                "buff_value": 60
+                "timed_debuff_id": 7007,
+                "debuff_value": 60
               },
-              "desc": "高速斩击{target}，造成攻击力{ap}%，附带 50% 概率麻痹，并使目标出血（每0.5秒受到{buff_value}点伤害，持续{dur}秒）"
+              "desc": "高速斩击{target}，造成攻击力{ap}%，附带 50% 概率麻痹，并使目标出血（每0.5秒受到{debuff_value}点伤害，持续{dur}秒）"
             }
           ]
         }
@@ -1479,11 +1478,11 @@
               "lv": 2,
               "s_lv": 2,
               "overrides": {
-                "timed_buff_id": 7005,
-                "buff_value": 30,
-                "buff_chance": 30
+                "timed_debuff_id": 7005,
+                "debuff_value": 30,
+                "debuff_chance": 30
               },
-              "desc": "普通攻击有{buff_chance}%概率使目标中毒（每0.5秒受到{buff_value}点伤害，持续{dur}秒）"
+              "desc": "普通攻击有{debuff_chance}%概率使目标中毒（每0.5秒受到{debuff_value}点伤害，持续{dur}秒）"
             }
           ]
         },
@@ -1494,12 +1493,12 @@
           "cdExpr": null,
           "overrides": {
             "ap": 150,
-            "timed_buff_id": 7005,
-            "buff_value": 30,
-            "buff_chance": 50,
+            "timed_debuff_id": 7005,
+            "debuff_value": 30,
+            "debuff_chance": 50,
             "icon": "4-Apply-Poison"
           },
-          "desc": "毒箭如雨，对{target}造成攻击力{ap}%伤害，{buff_chance}%概率使目标中毒（每0.5秒受到{buff_value}点伤害，持续{dur}秒）",
+          "desc": "毒箭如雨，对{target}造成攻击力{ap}%伤害，{debuff_chance}%概率使目标中毒（每0.5秒受到{debuff_value}点伤害，持续{dur}秒）",
           "lv_entries": [
             {
               "lv": 8,
@@ -1534,11 +1533,11 @@
             "t_num": 3,
             "overrides": {
               "ap": 80,
-              "timed_buff_id": 7005,
-              "buff_value": 40,
-              "buff_chance": 100
+              "timed_debuff_id": 7005,
+              "debuff_value": 40,
+              "debuff_chance": 100
             },
-            "desc": "追加射出蚀骨毒箭，对{target}造成攻击力{ap}%伤害，必定使目标中毒（每0.5秒受到{buff_value}点伤害，持续{dur}秒）"
+            "desc": "追加射出蚀骨毒箭，对{target}造成攻击力{ap}%伤害，必定使目标中毒（每0.5秒受到{debuff_value}点伤害，持续{dur}秒）"
           }
         ]
       },
@@ -1726,10 +1725,10 @@
               "lv": 2,
               "s_lv": 2,
               "overrides": {
-                "timed_buff_id": 7008,
-                "buff_chance": 30
+                "timed_debuff_id": 7008,
+                "debuff_chance": 30
               },
-              "desc": "普通攻击有{buff_chance}%概率使目标破甲（防御降低，持续{dur}秒）"
+              "desc": "普通攻击有{debuff_chance}%概率使目标破甲（防御降低，持续{dur}秒）"
             }
           ]
         },
@@ -1740,7 +1739,7 @@
           "cdExpr": null,
           "overrides": {
             "ap": 150,
-            "timed_buff_id": 7008
+            "timed_debuff_id": 7008
           },
           "desc": "释放碎甲能量波，对{target}造成攻击力{ap}%伤害，并使目标破甲（防御降低，持续{dur}秒）",
           "lv_entries": [
@@ -1775,7 +1774,7 @@
             "t_num": 1,
             "overrides": {
               "ap": 150,
-              "timed_buff_id": 7008
+              "timed_debuff_id": 7008
             },
             "desc": "战斗开始时掷出蚀甲酸瓶，对{target}造成攻击力{ap}%伤害，并必定使其破甲（防御降低，持续{dur}秒）"
           }

put/server/data/heroes.json编辑指引.md

@@ -87,7 +87,7 @@
 ## 6. overrides 白名单与特殊存储格式
 
 可用键（对照 `SkillSet.ts` 的 `SkillOverrides` 接口；编辑器 UI 白名单 `OVERRIDE_KEYS` 是其子集，手动改 JSON 可用全集）：
-`ap, hit_count, hitcd, crt, frz, stun, para, bck, bck_chance, TGroup, buff_type, timed_buff_id, buff_value, buff_duration, buff_chance, buff_target, call_hero, summon_count, is_accel, num, revive_hp, revive_count, proc_skill, icon`
+`ap, hit_count, hitcd, crt, frz, stun, para, bck, bck_chance, TGroup, buff_type, timed_buff_id, buff_value, buff_duration, buff_chance, buff_target, timed_debuff_id, debuff_value, debuff_duration, debuff_chance, call_hero, summon_count, is_accel, num, revive_hp, revive_count, proc_skill, icon`
 
 特殊存储格式（导出时由 server 还原为 TS 枚举表达式）：
 - `TGroup`：JSON 存字符串（如 `"Team"`），导出还原 `TGroup.Team`；`null` 表示不覆写；
@@ -96,27 +96,35 @@
 - `icon`：字符串图标帧名（uicons 图集），非数值；
 - 其余一律直存数值。
 
-引用校验：`timed_buff_id` 必须 ∈ `BuffList`；`proc_skill.s_uuid` / 触发组 key / 召唤类引用必须 ∈ `SkillSet`。
+引用校验：`timed_buff_id` / `timed_debuff_id` 必须 ∈ `BuffList`；`proc_skill.s_uuid` / 触发组 key / 召唤类引用必须 ∈ `SkillSet`。
 
-### 6.1 timed_buff_id（计时 buff 注入）
+### 6.1 timed_buff_id / timed_debuff_id（计时 buff / debuff 注入）
 
-**编辑器 UI**：overrides 添加 `timed_buff_id 计时buff` 行后，值栏为 BuffList 下拉（`id 名称` + 右侧 buff 效果摘要，数据来自 `/api/meta` 的 `BuffList`）；meta 未加载时可手输数字 id（allow-create，保存时自动归一化为数字）。选定 buff id 后编辑器自动补齐 `buff_value` / `buff_chance` / `buff_duration` 三行（已存在不重复），数值预填 BuffList 默认值。
+**语义划分（新规则）**：
+- `timed_buff_id`：**增益语义**。释放/命中时给友方或自身挂 buff；伤害技能缺省挂**施法者自身**（如吸血、攻击后强化），辅助技能缺省挂**友方目标**。可用 `buff_target` 覆写目标。
+- `timed_debuff_id`：**减益语义**。命中敌人后给**被命中者**挂 debuff（目标固定，不可覆写）；仅伤害路径（HeroAtkSystem）结算，DoT 不触发。
+
+**编辑器 UI**：overrides 添加 `timed_buff_id 计时buff` 或 `timed_debuff_id 计时debuff` 行后，值栏为 BuffList 下拉（`id 名称` + 右侧 buff 效果摘要，数据来自 `/api/meta` 的 `BuffList`）；meta 未加载时可手输数字 id（allow-create，保存时自动归一化为数字）。选定 id 后编辑器自动补齐配套三行（buff 补 `buff_value`/`buff_chance`/`buff_duration`，debuff 补 `debuff_value`/`debuff_chance`/`debuff_duration`，已存在不重复），数值预填 BuffList 默认值。
 
 **配套键**（同一 overrides 内按需添加）：
 
 | 键 | 说明 | 缺省 |
 |---|---|---|
-| `buff_value` | 覆写修饰数值（modifiers.value / tick.damage_or_heal，单位同 BuffList） | 回退 BuffList 默认 |
-| `buff_duration` | 覆写持续时间（秒） | 回退 BuffList.duration |
-| `buff_chance` | 触发概率 %（命中时掷骰） | 100（必触发） |
-| `buff_target` | 施加目标：0 被命中者(Hit) / 1 施法者(Self) / 2 全体友方(Ally) / 3 全体敌方(Enemy) | 按主效果推导：伤害→被命中者，辅助→友方 |
+| `buff_value` | 覆写 buff 修饰数值（modifiers.value / tick.damage_or_heal，单位同 BuffList） | 回退 BuffList 默认 |
+| `buff_duration` | 覆写 buff 持续时间（秒） | 回退 BuffList.duration |
+| `buff_chance` | buff 触发概率 %（命中时掷骰） | 100（必触发） |
+| `buff_target` | buff 施加目标：0 被命中者(Hit) / 1 施法者(Self) / 2 全体友方(Ally) / 3 全体敌方(Enemy) | 按主效果推导：伤害→施法者自身，辅助→友方目标 |
+| `debuff_value` | 覆写 debuff 修饰数值 | 回退 BuffList 默认 |
+| `debuff_duration` | 覆写 debuff 持续时间（秒） | 回退 BuffList.duration |
+| `debuff_chance` | debuff 触发概率 %（命中时掷骰） | 100（必触发） |
 
 **生效路径（重要）**：
-- ✅ 友方/辅助技能（TGroup 为 Self/Team/Ally，或 6300/6500 段辅助底座）：走 SCastSystem merged config，overrides 注入完整生效；`buff_target: 3`（Enemy）可把 buff 分流挂到敌方网格，实现对敌 debuff；
-- ✅ 对敌技能的命中附带 debuff：以 SkillSet **底座配置**为准（HeroAtkSystem 按 `SkillSet[s_uuid]` 读取 `timed_buff_id`/`buff_chance` 等），对敌 debuff 写入底座即可起效；
+- ✅ 友方/辅助技能（TGroup 为 Self/Team/Ally，或 6300/6500 段辅助底座）：走 SCastSystem merged config，`timed_buff_id` 注入完整生效；`buff_target: 3`（Enemy）可把 buff 分流挂到敌方网格（如群体减甲）；
+- ✅ 对敌伤害技能的命中附带 debuff：用 `timed_debuff_id`（可写在 SkillSet 底座或 heroSet overrides），HeroAtkSystem 命中结算时挂被命中者；
+- ✅ 对敌伤害技能的命中附带增益（吸血/自强化）：用 `timed_buff_id`，缺省挂施法者自身；
 - 同一 overrides 不要既配 `timed_buff_id` 又依赖永久 `buff_type` 加成：timed 路径生效后永久分支被跳过。
 
-**语义陷阱**：`buff_target` 缺省为被命中者——若想"攻击回血/吸血"，必须显式配 `"buff_target": 1`，否则 buff 挂到被打的敌人身上（如 7010 回血会奶敌人）。
+**语义陷阱**：`timed_buff_id` 在伤害技能上缺省挂**施法者自身**——若想"命中给敌人挂减益"，必须用 `timed_debuff_id`，否则会把减益挂到自己身上。
 
 ### 6.2 proc_skill（命中概率触发主动技能）
 
@@ -166,5 +174,5 @@
 - 普攻用数值 cd 而不给 `cdExpr` → 丢失攻速档位语义（编辑器攻速下拉失效）；
 - 档位 overrides 全量复制基础档 → 浅合并下冗余且后续改基础值不生效；
 - desc 与 overrides 数值脱节 → desc 模板只写 `{ap}` 等占位符，不要硬编码数字；
-- 对敌技能 debuff 写在 overrides → 命中附带判定按 SkillSet 底座读取，应写入底座配置（详见 §6.1）；
-- 想做吸血但漏配 `buff_target:1` → 缺省挂被命中者，回血 buff 会奶敌人。
+- 对敌技能 debuff 误用 `timed_buff_id` → buff 缺省挂施法者自身，会把减益挂到自己身上；应改用 `timed_debuff_id`（详见 §6.1）；
+- 想做吸血但把 buff 写到 `timed_debuff_id` → debuff 目标固定为被命中者，会奶敌人；吸血/自强化请用 `timed_buff_id`（缺省即挂自身）。

put/server/index.js

@@ -257,10 +257,17 @@ function overrideShort(ov, { includeAp = true } = {}) {
     const buffName = cache?.BuffList?.[ov.timed_buff_id]?.name || ''
     const val = ov.buff_value != null ? `${ov.buff_value}` : ''
     const chance = ov.buff_chance != null ? `buff_chance${ov.buff_chance}` : ''
-    // buff_target 非默认（被命中者）时标注目标，便于识别"挂自己/挂敌方"等跨阵营 buff
-    const tgtLabel = ov.buff_target != null && ov.buff_target !== 0 ? `→${BUFF_TARGET_NAMES[ov.buff_target]}` : ''
+    // buff_target 非默认（施法者自身）时标注目标，便于识别"挂敌方/挂队友"等跨阵营 buff
+    const tgtLabel = ov.buff_target != null && ov.buff_target !== 1 ? `→${BUFF_TARGET_NAMES[ov.buff_target]}` : ''
     parts.push(`附加${val}${buffName}${ov.timed_buff_id}${chance}${tgtLabel}`)
   }
+  // timed_debuff_id：命中被攻击者后施加（目标固定，无需标注）
+  if (ov.timed_debuff_id != null) {
+    const debuffName = cache?.BuffList?.[ov.timed_debuff_id]?.name || ''
+    const val = ov.debuff_value != null ? `${ov.debuff_value}` : ''
+    const chance = ov.debuff_chance != null ? `debuff_chance${ov.debuff_chance}` : ''
+    parts.push(`命中附加${val}${debuffName}${ov.timed_debuff_id}${chance}`)
+  }
   // proc_skill：命中后概率触发额外技能，标注被触发技能名/概率/覆写 ap（若有）
   if (ov.proc_skill?.s_uuid != null) {
     const procName = cache?.SkillSet?.[ov.proc_skill.s_uuid]?.name || ''