refactor(heroSkill): 重构英雄技能描述生成逻辑
1. 新增完整的文件注释和职责说明 2. 拆分出buildEffectDesc函数生成技能效果描述 3. 替换硬编码的触发名称为模板化的SkillTriggerDesc 4. 支持覆盖技能参数mergeSkillParams 5. 优化三种类型技能的处理流程，输出标准格式描述
This commit is contained in:
panw
@@ -1,44 +1,141 @@
|
||||
import { heroInfo, SkillTriggerName, SkillTriggerType } from "./heroSet";
|
||||
import { FieldSkillSet, SkillSet } from "./SkillSet";
|
||||
/**
|
||||
* @file HeroSkillDesc.ts
|
||||
* @description 英雄技能描述生成器
|
||||
*
|
||||
* 职责：
|
||||
* 将英雄配置（heroInfo）中的特殊触发技能转换为可读的描述文本，
|
||||
* 供 HInfoComp 的 info_node 显示。每行一个技能，用换行符连接。
|
||||
*
|
||||
* 生成格式：
|
||||
* {触发条件} → {技能名} {效果描述}
|
||||
* 例: "受击2次 → 护盾 护盾2次"
|
||||
* 例: "攻击1次 → 攻击强化 全体友方攻击力提升5点，持续1次"
|
||||
* 例: "场上存活 → 攻击加成 英雄攻击力+20%"
|
||||
*
|
||||
* 依赖：
|
||||
* - heroSet → SkillTriggerDesc（触发条件模板）、SkillTriggerType（触发类型枚举）、heroInfo
|
||||
* - SkillSet → SkillSet（技能基础配置）、mergeSkillParams（合并覆盖参数）、SkillKind（技能类型枚举）
|
||||
* - FieldSkillSet（驻场技能配置）
|
||||
*/
|
||||
import { heroInfo, SkillTriggerDesc, SkillTriggerType } from "./heroSet";
|
||||
import { FieldSkillSet, mergeSkillParams, SkillKind, SkillOverrides, SkillSet } from "./SkillSet";
|
||||
|
||||
/**
|
||||
* 需要遍历的触发技能类型列表（不含 Field 和 Revive，这两者结构不同需单独处理）
|
||||
* Field → number[]（驻场技能 uuid 列表）
|
||||
* Revive → { s_uuid, r_num, upr }（单个对象）
|
||||
*/
|
||||
const TRIGGER_KEYS: SkillTriggerType[] = [
|
||||
SkillTriggerType.Call,
|
||||
SkillTriggerType.Dead,
|
||||
SkillTriggerType.FStart,
|
||||
SkillTriggerType.FEnd,
|
||||
SkillTriggerType.Atking,
|
||||
SkillTriggerType.Atked,
|
||||
SkillTriggerType.Call, // 召唤时触发
|
||||
SkillTriggerType.Dead, // 死亡时触发
|
||||
SkillTriggerType.FStart, // 战斗开始时触发
|
||||
SkillTriggerType.FEnd, // 战斗结束时触发
|
||||
SkillTriggerType.Atking, // 攻击后触发
|
||||
SkillTriggerType.Atked, // 受击后触发
|
||||
];
|
||||
|
||||
/**
|
||||
* 根据合并后的技能配置生成效果描述文本
|
||||
*
|
||||
* 按 SkillKind 分类输出：
|
||||
* - Heal → "治疗伙伴{ap}"
|
||||
* - Shield → "护盾{ap}次"（ap 表示可抵挡次数）
|
||||
* - Gold → "金币+{gold}"
|
||||
* - Support → 直接使用技能自身的 info 字段（如"全体友方攻击力提升5点，持续1次"）
|
||||
* - Damage → "伤害{ap}%" + 可选的暴击/冰冻/击退/多段附加描述
|
||||
*
|
||||
* @param skill 经过 mergeSkillParams 合并 overrides 后的完整技能配置
|
||||
* @returns 效果描述字符串，各部分用空格连接
|
||||
*/
|
||||
function buildEffectDesc(skill: ReturnType<typeof mergeSkillParams>): string {
|
||||
const parts: string[] = [];
|
||||
const kind = skill.kind;
|
||||
|
||||
if (kind === SkillKind.Heal) {
|
||||
// 治疗类：ap 为治疗量
|
||||
parts.push(`治疗伙伴${skill.ap}`);
|
||||
} else if (kind === SkillKind.Shield) {
|
||||
// 护盾类：ap 为可抵挡的攻击次数
|
||||
parts.push(`护盾${skill.ap}次`);
|
||||
} else if (kind === SkillKind.Gold) {
|
||||
// 金币类：gold 为获取金币数
|
||||
parts.push(`金币+${skill.gold ?? 0}`);
|
||||
} else if (kind === SkillKind.Support) {
|
||||
// 辅助类（buff）：直接使用技能的 info 描述文案
|
||||
parts.push(String(skill.info));
|
||||
} else if (kind === SkillKind.Damage || kind === undefined) {
|
||||
// 伤害类（含无 kind 的默认技能）：ap 为攻击力百分比
|
||||
parts.push(`伤害${skill.ap}%`);
|
||||
// 多段伤害
|
||||
if (skill.hit_count > 1) parts.push(`${skill.hit_count}段`);
|
||||
// 附加暴击率
|
||||
if (skill.crt) parts.push(`暴击+${skill.crt}%`);
|
||||
// 附加冰冻概率
|
||||
if (skill.frz) parts.push(`冰冻+${skill.frz}%`);
|
||||
// 附加击退概率
|
||||
if (skill.bck) parts.push(`击退+${skill.bck}%`);
|
||||
}
|
||||
|
||||
return parts.join(" ");
|
||||
}
|
||||
|
||||
/**
|
||||
* 将英雄的特殊触发技能配置转换为可读描述文本
|
||||
*
|
||||
* 处理流程：
|
||||
* 1. 遍历 6 种触发类型（call/dead/fstart/fend/atking/atked），从 hero[key] 取出
|
||||
* {s_uuid, t_num, overrides?}[]，通过 s_uuid 查 SkillSet 获取技能基础配置，
|
||||
* 用 mergeSkillParams 合并 overrides 得到实际参数，再拼成一行描述。
|
||||
* 2. 单独处理 field（驻场技能）：从 FieldSkillSet 查找配置，输出光环效果。
|
||||
* 3. 单独处理 revive（复活技能）：结构与上述不同，是单个对象而非数组。
|
||||
*
|
||||
* 输出示例（5006 疾风刺客）：
|
||||
* "攻击1次 → 攻击强化 全体友方攻击力提升5点，持续1次
|
||||
* 死亡时 → 攻击强化 全体友方攻击力提升8点，持续1次"
|
||||
*
|
||||
* @param hero 英雄静态配置（HeroInfo 中的条目）
|
||||
* @returns 多行技能描述文本，每行一个技能，用 \n 分隔
|
||||
*/
|
||||
export function buildSkillDesc(hero: heroInfo): string {
|
||||
const lines: string[] = [];
|
||||
|
||||
// ---- 第一步：处理 6 种标准触发技能（结构均为 {s_uuid, t_num, overrides?}[]） ----
|
||||
for (const key of TRIGGER_KEYS) {
|
||||
const arr = hero[key] as { s_uuid: number; t_num: number }[] | undefined;
|
||||
const arr = hero[key] as { s_uuid: number; t_num: number; overrides?: SkillOverrides }[] | undefined;
|
||||
if (!arr?.length) continue;
|
||||
const triggerName = SkillTriggerName[key] ?? key;
|
||||
// 从 SkillTriggerDesc 取模板，如 "攻击n次"、"受击n次"、"召唤时" 等
|
||||
const tpl = SkillTriggerDesc[key] ?? key;
|
||||
for (const item of arr) {
|
||||
const skill = SkillSet[item.s_uuid];
|
||||
if (!skill) continue;
|
||||
const suffix = item.t_num > 1 ? ` (每${item.t_num}次触发)` : "";
|
||||
lines.push(`${triggerName}: ${skill.name}${suffix}`);
|
||||
// 通过 s_uuid 查找技能基础配置
|
||||
const base = SkillSet[item.s_uuid];
|
||||
if (!base) continue;
|
||||
// 合并 overrides 得到实际技能参数（ap/hit_count/crt/frz/bck 等可能被覆盖）
|
||||
const skill = mergeSkillParams(base, item.overrides);
|
||||
// 将模板中的 "n" 替换为实际触发次数
|
||||
const trigger = tpl.replace("n", String(item.t_num));
|
||||
lines.push(`${trigger} → ${base.name} ${buildEffectDesc(skill)}`);
|
||||
}
|
||||
}
|
||||
|
||||
// ---- 第二步：处理驻场技能（field）—— 结构为 number[]，uuid 指向 FieldSkillSet ----
|
||||
const fieldUuids = hero[SkillTriggerType.Field] as number[] | undefined;
|
||||
if (fieldUuids?.length) {
|
||||
const triggerName = SkillTriggerName[SkillTriggerType.Field] ?? "光环";
|
||||
const tpl = SkillTriggerDesc[SkillTriggerType.Field] ?? "场上存活";
|
||||
for (const uuid of fieldUuids) {
|
||||
const fs = FieldSkillSet[uuid];
|
||||
if (fs) lines.push(`${triggerName}: ${fs.info}`);
|
||||
if (fs) lines.push(`${tpl} → ${fs.name} ${fs.info}`);
|
||||
}
|
||||
}
|
||||
|
||||
// ---- 第三步：处理复活技能（revive）—— 结构为 {s_uuid, r_num, upr} 单个对象 ----
|
||||
const revive = hero[SkillTriggerType.Revive] as { s_uuid: number; r_num: number; upr: number } | undefined;
|
||||
if (revive) {
|
||||
const triggerName = SkillTriggerName[SkillTriggerType.Revive] ?? "复活";
|
||||
const skill = SkillSet[revive.s_uuid];
|
||||
if (skill) lines.push(`${triggerName}: ${skill.name}`);
|
||||
const base = SkillSet[revive.s_uuid];
|
||||
if (base) {
|
||||
const skill = mergeSkillParams(base);
|
||||
const tpl = SkillTriggerDesc[SkillTriggerType.Revive] ?? "复活时";
|
||||
lines.push(`${tpl} : ${base.name} ${buildEffectDesc(skill)}`);
|
||||
}
|
||||
}
|
||||
|
||||
return lines.join("\n");
|
||||
|
||||
Reference in New Issue
Block a user