refactor: 将代码中的card_lv统一替换为rarity

本次提交完成了全项目范围内术语的统一替换,将原本指代卡牌品质/等级的card_lv字段全部重命名为rarity,对齐了设计文档中的命名规范,避免了术语混淆:
1.  更新了所有配置文件、组件类、数据结构中的字段定义
2.  同步修改了注释、文档说明中的相关表述
3.  修正了英雄、技能、装备卡牌的品质显示逻辑
4.  调整了背景颜色切换、属性计算等相关业务逻辑
This commit is contained in:
pan
2026-09-02 16:42:54 +08:00
parent 6620b67103
commit d9bccd7c93
36 changed files with 312 additions and 312 deletions

View File

@@ -154,18 +154,18 @@ export class MissSkillsComp extends CCComp {
}
/**
* 处理使用技能卡事件:提取 uuid 和 card_lv 后调用 addSkill。
* 处理使用技能卡事件:提取 uuid 和 rarity 后调用 addSkill。
* @param event 事件名
* @param args 卡牌数据(含 uuid、card_lv)
* @param args 卡牌数据(含 uuid、rarity)
*/
private onUseSkillCard(event: string, args: any) {
const payload = args ?? event;
// 卡 uuid 仅用于查配置;真正施法用技能 id(payload.skill),缺省时退回 uuid(兼容技能卡直接用技能 id 的场景)
const skillUuid = Number(payload?.skill ?? payload?.uuid ?? 0);
const card_lv = Math.max(1, Math.floor(Number(payload?.card_lv ?? 1)));
const rarity = Math.max(1, Math.floor(Number(payload?.rarity ?? 1)));
if (!skillUuid) return;
// 药水/技能卡的 overrides(含 buff_value)需透传到技能实体
this.addSkill(skillUuid, card_lv, payload?.overrides);
this.addSkill(skillUuid, rarity, payload?.overrides);
}
/**
@@ -215,9 +215,9 @@ export class MissSkillsComp extends CCComp {
* 3. 获取或添加 SkillBoxComp 并初始化。
*
* @param uuid 技能 UUID
* @param card_lv 技能卡等级
* @param rarity 技能卡等级
*/
addSkill(uuid: number, card_lv: number, overrides?: SkillOverrides) {
addSkill(uuid: number, rarity: number, overrides?: SkillOverrides) {
if (!this.skill_box) {
mLogger.error(this.debugMode, "MissSkillsComp", "skill_box prefab not set");
return;
@@ -234,7 +234,7 @@ export class MissSkillsComp extends CCComp {
// 使用 ECS 实体创建技能节点
let sbox = ecs.getEntity<SBox>(SBox);
let pos = new Vec3(this.slots[emptyIndex].x, this.slots[emptyIndex].y, 0);
let node = sbox.load(uuid, card_lv, pos, this.skill_box, overrides);
let node = sbox.load(uuid, rarity, pos, this.skill_box, overrides);
this.slots[emptyIndex].used = true;
this.slots[emptyIndex].node = node;