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

@@ -158,7 +158,7 @@ export class CHeroComp extends CCComp {
nodeUuid: this.node?.uuid,
uuid: data?.uuid ?? null,
name: data?.name ?? null,
card_lv: data?.card_lv ?? null,
rarity: data?.rarity ?? null,
cost: data?.cost ?? null,
nodeActiveBefore: this.node?.active
});
@@ -267,7 +267,7 @@ export class CHeroComp extends CCComp {
this.level_label.string = heroLv > 1 ? `Lv.${heroLv}` : "";
}
// 背景:按 card_lv 激活对应颜色子节点(1→green 2→blue 3→purple 4→red 5→yellow)
// 背景:按 rarity 激活对应颜色子节点(1→green 2→blue 3→purple 4→red 5→yellow)
this.updateBgNode();
// 描述富文本:展示英雄当前局外等级的能力(buildHeroSkillDesc 文本一)
@@ -301,13 +301,13 @@ export class CHeroComp extends CCComp {
}
/**
* 根据 card_lv 切换 bg_node 下的颜色子节点显示。
* 根据 rarity 切换 bg_node 下的颜色子节点显示。
* 等级与颜色对应关系:
* card_lv 1 → green
* card_lv 2 → blue
* card_lv 3 → purple
* card_lv 4 → red
* card_lv 5 → yellow
* rarity 1 → green
* rarity 2 → blue
* rarity 3 → purple
* rarity 4 → red
* rarity 5 → yellow
*/
private updateBgNode() {
if (!this.bg_node || !this.cardData) return;
@@ -318,7 +318,7 @@ export class CHeroComp extends CCComp {
4: "red",
5: "yellow",
};
const targetColor = lvToColor[this.cardData.card_lv ?? 1];
const targetColor = lvToColor[this.cardData.rarity ?? 1];
this.bg_node.children.forEach(child => {
child.active = (child.name === targetColor);
});
@@ -542,7 +542,7 @@ export class CHeroComp extends CCComp {
reason: "",
uuid: this.cardData.uuid,
hero_lv: smc.getHeroOuterLv(this.cardData.uuid),
card_lv: this.cardData.base_card_lv ?? this.cardData.card_lv ?? 1
rarity: this.cardData.base_rarity ?? this.cardData.rarity ?? 1
};
oops.message.dispatchEvent(GameEvent.UseHeroCard, guard);
if (guard.cancel) return;