From 34dde3b3b900844ab009b557456f6a8e204d20e7 Mon Sep 17 00:00:00 2001
From: BTMuli <bt-muli@outlook.com>
Date: Wed, 1 Apr 2026 21:12:11 +0800
Subject: [PATCH] =?UTF-8?q?=F0=9F=8F=B7=EF=B8=8F=20=E5=8D=B1=E6=88=98&?=
 =?UTF-8?q?=E5=89=A7=E8=AF=97=E9=9A=BE=E5=BA=A6=E7=B1=BB=E5=9E=8B=E5=AE=9A?=
 =?UTF-8?q?=E4=B9=89=E8=B0=83=E6=95=B4=E4=B8=BA=E6=9E=9A=E4=B8=BE=E7=B1=BB?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/pageHome/ph-pos-user.vue       |  3 +-
 src/components/userChallenge/tuc-overview.vue |  4 +-
 src/components/userCombat/tuc-overview.vue    | 31 ++-----
 src/enum/game.ts                              | 87 +++++++++++++++++++
 src/plugins/Sqlite/utils/transUserRecord.ts   | 34 +-------
 src/types/Game/ActCalendar.d.ts               | 10 +--
 src/types/Game/Challenge.d.ts                 | 34 +++++++-
 src/types/Game/Combat.d.ts                    | 30 ++++++-
 src/types/Game/Record.d.ts                    |  8 +-
 9 files changed, 171 insertions(+), 70 deletions(-)

diff --git a/src/components/pageHome/ph-pos-user.vue b/src/components/pageHome/ph-pos-user.vue
index b0a47d8f..7a19375c 100644
--- a/src/components/pageHome/ph-pos-user.vue
+++ b/src/components/pageHome/ph-pos-user.vue
@@ -21,7 +21,7 @@
               <span>{{ props.pos.hard_challenge_detail.second }}s</span>
               <img
                 :src="`/icon/challenge/UI_LeyLineChallenge_Medal_${props.pos.hard_challenge_detail.difficulty}.webp`"
-                :title="getHardChallengeDesc(props.pos.hard_challenge_detail.difficulty)"
+                :title="gameEnum.challenge.diffDesc(props.pos.hard_challenge_detail.difficulty)"
                 alt="medal"
               />
               <div
@@ -114,7 +114,6 @@
 </template>
 <script lang="ts" setup>
 import gameEnum from "@enum/game.js";
-import { getHardChallengeDesc } from "@Sql/utils/transUserRecord.js";
 import { generateShareImg } from "@utils/TGShare.js";
 import { parseHtmlText, stamp2LastTime, timestampToDate } from "@utils/toolFunc.js";
 import { computed, onMounted, onUnmounted, ref, useTemplateRef } from "vue";
diff --git a/src/components/userChallenge/tuc-overview.vue b/src/components/userChallenge/tuc-overview.vue
index 8be8f22b..705b263b 100644
--- a/src/components/userChallenge/tuc-overview.vue
+++ b/src/components/userChallenge/tuc-overview.vue
@@ -7,7 +7,7 @@
         <span>最佳记录</span>
         <span>{{ props.data.best.second }}s</span>
         <img
-          :title="getHardChallengeDesc(props.data.best.difficulty)"
+          :title="gameEnum.challenge.diffDesc(props.data.best.difficulty)"
           :src="`/icon/challenge/UI_LeyLineChallenge_Medal_${props.data.best.difficulty}.webp`"
           alt="medal"
         />
@@ -21,7 +21,7 @@
   </div>
 </template>
 <script lang="ts" setup>
-import { getHardChallengeDesc } from "@Sql/utils/transUserRecord.js";
+import gameEnum from "@enum/game.js";
 
 import TucChallengeItem from "./tuc-challenge-item.vue";
 
diff --git a/src/components/userCombat/tuc-overview.vue b/src/components/userCombat/tuc-overview.vue
index b54ed86c..d52fa917 100644
--- a/src/components/userCombat/tuc-overview.vue
+++ b/src/components/userCombat/tuc-overview.vue
@@ -5,7 +5,7 @@
       <TucTile :val="getBestVal()" title="最佳记录" />
       <TucTile :val="props.data.coin_num" title="消耗幻剧之花" />
       <TucTile :val="getTime()" title="总耗时" />
-      <TucTile :title="getRoundTitle()" :val="getRoundVal()" />
+      <TucTile :title="gameEnum.combat.diffDesc(props.data.difficulty_id)" :val="getRoundVal()" />
     </div>
     <div class="tuco-line2">
       <TucFight :data="props.fights.max_defeat_avatar" label="击败最多敌人" />
@@ -21,6 +21,8 @@
   </div>
 </template>
 <script lang="ts" setup>
+import gameEnum from "@enum/game.js";
+
 import TucFight from "./tuc-fight.vue";
 import TucTile from "./tuc-tile.vue";
 
@@ -28,32 +30,17 @@ type TucOverviewProps = { data: TGApp.Game.Combat.Stat; fights: TGApp.Game.Comba
 
 const props = defineProps<TucOverviewProps>();
 
-function getRoundTitle(): string {
-  switch (props.data.difficulty_id) {
-    case 0:
-      return "未选择";
-    case 1:
-      return "轻简模式";
-    case 2:
-      return "普通模式";
-    case 3:
-      return "困难模式";
-    case 4:
-      return "卓越模式";
-    case 5:
-      return "月谕模式";
-    default:
-      return `未知模式${props.data.difficulty_id}`;
-  }
-}
-
 function getBestVal(): string {
-  if (props.data.difficulty_id < 5) return `第${props.data.max_round_id}幕`;
+  if (props.data.difficulty_id < gameEnum.combat.diff.TAROT) {
+    return `第${props.data.max_round_id}幕`;
+  }
   return `第${props.data.max_round_id}幕·圣牌${props.data.tarot_finished_cnt}`;
 }
 
 function getRoundVal(): string {
-  if (props.data.difficulty_id < 5) return `第${props.data.max_round_id}幕`;
+  if (props.data.difficulty_id < gameEnum.combat.diff.TAROT) {
+    return `第${props.data.max_round_id}幕`;
+  }
   return `${props.data.tarot_finished_cnt + props.data.max_round_id}`;
 }
 
diff --git a/src/enum/game.ts b/src/enum/game.ts
index 7f06f265..d1f345e7 100644
--- a/src/enum/game.ts
+++ b/src/enum/game.ts
@@ -164,6 +164,87 @@ function getCombatAvatarTypeDesc(avatarType: TGApp.Game.Combat.AvatarTypeEnum):
   }
 }
 
+/**
+ * 剧诗难度类型枚举
+ * @since Beta v0.9.9
+ * @see TGApp.Game.Combat.DiffEnum
+ */
+const CombatDiffEnum: typeof TGApp.Game.Combat.Difficulty = {
+  NONE: 0,
+  EASY: 1,
+  NORMAL: 2,
+  HARD: 3,
+  MASTER: 4,
+  TAROT: 5,
+};
+
+/**
+ * 获取剧诗难度描述
+ * @since Beta v0.9.9
+ * @param difficultyId - 剧诗难度等级
+ * @returns 剧诗难度描述
+ */
+function getCombatDiffDesc(difficultyId: TGApp.Game.Combat.DiffEnum): string {
+  switch (difficultyId) {
+    case CombatDiffEnum.NONE:
+      return "未选择";
+    case CombatDiffEnum.EASY:
+      return "轻简模式";
+    case CombatDiffEnum.NORMAL:
+      return "普通模式";
+    case CombatDiffEnum.HARD:
+      return "困难模式";
+    case CombatDiffEnum.MASTER:
+      return "卓越模式";
+    case CombatDiffEnum.TAROT:
+      return "月谕模式";
+    default:
+      return `未知模式${difficultyId}`;
+  }
+}
+
+/**
+ * 幽境危战难度类型枚举
+ * @since Beta v0.9.9
+ * @see TGApp.Game.Challenge.DiffEnum
+ */
+const ChallengeDiffEnum: typeof TGApp.Game.Challenge.Difficulty = {
+  NONE: 0,
+  NORMAL: 1,
+  ADVANCED: 2,
+  HARD: 3,
+  DANGEROUS: 4,
+  FEARLESS: 5,
+  DESPERATE: 6,
+};
+
+/**
+ * 获取幽境危战难度描述
+ * @since Beta v0.9.9
+ * @param difficulty - 幽境危战难度
+ * @returns 幽境危战难度描述
+ */
+function getChallengeDiffDesc(difficulty: TGApp.Game.Challenge.DiffEnum): string {
+  switch (difficulty) {
+    case ChallengeDiffEnum.NONE:
+      return "未挑战";
+    case ChallengeDiffEnum.NORMAL:
+      return "普通";
+    case ChallengeDiffEnum.ADVANCED:
+      return "进阶";
+    case ChallengeDiffEnum.HARD:
+      return "困难";
+    case ChallengeDiffEnum.DANGEROUS:
+      return "险恶";
+    case ChallengeDiffEnum.FEARLESS:
+      return "无畏";
+    case ChallengeDiffEnum.DESPERATE:
+      return "绝境";
+    default:
+      return `难度${difficulty}`;
+  }
+}
+
 /**
  * 绘想游迹状态枚举
  * @since Beta v0.9.6
@@ -191,6 +272,12 @@ const gameEnum = {
     charMasterStat: CombatCharMasterStatEnum,
     avatarType: CombatAvatarTypeEnum,
     avatarTypeDesc: getCombatAvatarTypeDesc,
+    diff: CombatDiffEnum,
+    diffDesc: getCombatDiffDesc,
+  },
+  challenge: {
+    diff: ChallengeDiffEnum,
+    diffDesc: getChallengeDiffDesc,
   },
 };
 
diff --git a/src/plugins/Sqlite/utils/transUserRecord.ts b/src/plugins/Sqlite/utils/transUserRecord.ts
index 3eaee630..0a79f472 100644
--- a/src/plugins/Sqlite/utils/transUserRecord.ts
+++ b/src/plugins/Sqlite/utils/transUserRecord.ts
@@ -1,8 +1,9 @@
 /**
  * 原神战绩数据转换
- * @since Beta v0.9.1
+ * @since Beta v0.9.9
  */
 
+import gameEnum from "@enum/game.js";
 import { getZhElement } from "@utils/toolFunc.js";
 
 /**
@@ -61,36 +62,9 @@ function transAvatar(data: TGApp.Game.Record.Avatar): TGApp.Sqlite.Record.Avatar
   };
 }
 
-/**
- * 获取幽境危战难度描述
- * @since Beta v0.9.0
- * @param difficulty - 幽境危战难度
- * @returns 幽境危战难度描述
- */
-export function getHardChallengeDesc(difficulty: number): string {
-  switch (difficulty) {
-    case 0:
-      return "未挑战";
-    case 1:
-      return "普通";
-    case 2:
-      return "进阶";
-    case 3:
-      return "困难";
-    case 4:
-      return "险恶";
-    case 5:
-      return "无畏";
-    case 6:
-      return "绝境";
-    default:
-      return `难度${difficulty}`;
-  }
-}
-
 /**
  * 转换统计信息
- * @since Beta v0.8.1
+ * @since Beta v0.9.9
  * @param data - 统计信息
  * @returns 转换后的统计信息
  */
@@ -112,7 +86,7 @@ function transStat(data: TGApp.Game.Record.Stats): TGApp.Sqlite.Record.Stats {
     sprialAbyss: data.spiral_abyss,
     combatRole: data.role_combat.is_unlock ? `第 ${data.role_combat.max_round_id} 幕` : "未解锁",
     hardChallenge: data.hard_challenge.is_unlock
-      ? `${data.hard_challenge.name}-${getHardChallengeDesc(data.hard_challenge.difficulty)}`
+      ? `${data.hard_challenge.name}-${gameEnum.challenge.diffDesc(data.hard_challenge.difficulty)}`
       : "未解锁",
     luxuriousChest: data.luxurious_chest_number,
     preciousChest: data.precious_chest_number,
diff --git a/src/types/Game/ActCalendar.d.ts b/src/types/Game/ActCalendar.d.ts
index 7967cefd..6869b1b8 100644
--- a/src/types/Game/ActCalendar.d.ts
+++ b/src/types/Game/ActCalendar.d.ts
@@ -1,6 +1,6 @@
 /**
  * 游戏-活动日历相关类型定义文件
- * @since Beta v0.8.3
+ * @since Beta v0.9.9
  */
 
 declare namespace TGApp.Game.ActCalendar {
@@ -221,13 +221,13 @@ declare namespace TGApp.Game.ActCalendar {
 
   /**
    * 幽境危战活动详情
-   * @since Beta v0.8.0
+   * @since Beta v0.9.9
    */
   type ActHardChallenge = {
     /** 是否解锁 */
     is_unlock: boolean;
     /** 当前难度 */
-    difficulty: number;
+    difficulty: TGApp.Game.Challenge.DiffEnum;
     /** 挑战耗时(秒) */
     second: number;
     /** 活动图标 */
@@ -260,11 +260,11 @@ declare namespace TGApp.Game.ActCalendar {
 
   /**
    * 真境剧诗活动详情
-   * @since Beta v0.8.3
+   * @since Beta v0.9.9
    */
   type ActRoleCombat = {
     /** 难度id */
-    difficulty_id: number;
+    difficulty_id: TGApp.Game.Combat.DiffEnum;
     /** 是否有数据 */
     has_data: boolean;
     /** 是否解锁 */
diff --git a/src/types/Game/Challenge.d.ts b/src/types/Game/Challenge.d.ts
index 3857fa40..92aa1dcf 100644
--- a/src/types/Game/Challenge.d.ts
+++ b/src/types/Game/Challenge.d.ts
@@ -1,9 +1,37 @@
 /**
  * 幽境危战
- * @since Beta v0.8.0
+ * @since Beta v0.9.9
  */
 
 declare namespace TGApp.Game.Challenge {
+  /**
+   * 幽境危战难度
+   * @since Beta v0.9.9
+   * @see TGApp.Game.Challenge.DiffEnum
+   */
+  const Difficulty = <const>{
+    /** 未挑战 */
+    NONE: 0,
+    /** 普通 */
+    NORMAL: 1,
+    /** 进阶 */
+    ADVANCED: 2,
+    /** 困难 */
+    HARD: 3,
+    /** 险恶 */
+    DANGEROUS: 4,
+    /** 无畏 */
+    FEARLESS: 5,
+    /** 绝境 */
+    DESPERATE: 6,
+  };
+
+  /**
+   * 幽境危战难度枚举
+   * @since Beta v0.9.9
+   */
+  type DiffEnum = (typeof Difficulty)[keyof typeof Difficulty];
+
   /**
    * 赋光之人列表返回响应
    * @since Beta v0.8.0
@@ -120,11 +148,11 @@ declare namespace TGApp.Game.Challenge {
 
   /**
    * 最佳数据
-   * @since Beta v0.8.0
+   * @since Beta v0.9.9
    */
   type ChallengeBest = {
     /** 难度 */
-    difficulty: number;
+    difficulty: DiffEnum;
     /** 耗时（秒） */
     second: number;
     /** 图标 */
diff --git a/src/types/Game/Combat.d.ts b/src/types/Game/Combat.d.ts
index 4a56afe4..be051046 100644
--- a/src/types/Game/Combat.d.ts
+++ b/src/types/Game/Combat.d.ts
@@ -42,6 +42,32 @@ declare namespace TGApp.Game.Combat {
     is_unlock: boolean;
   };
 
+  /**
+   * 剧诗难度等级
+   * @since Beta v0.9.9
+   * @see TGApp.Game.Combat.DiffEnum
+   */
+  const Difficulty = <const>{
+    /** 未选择 */
+    NONE: 0,
+    /** 轻简模式 */
+    EASY: 1,
+    /** 普通模式 */
+    NORMAL: 2,
+    /** 困难模式 */
+    HARD: 3,
+    /** 卓越模式 */
+    MASTER: 4,
+    /** 月谕模式 */
+    TAROT: 5,
+  };
+
+  /**
+   * 剧诗难度等级枚举
+   * @since Beta v0.9.9
+   */
+  type DiffEnum = (typeof Difficulty)[keyof typeof Difficulty];
+
   /**
    * 角色类型
    * @since Beta v0.9.9
@@ -148,11 +174,11 @@ declare namespace TGApp.Game.Combat {
 
   /**
    * 状态
-   * @since Beta v0.8.3
+   * @since Beta v0.9.9
    */
   type Stat = {
     /** 难度等级 */
-    difficulty_id: number;
+    difficulty_id: DiffEnum;
     /** 最大层数 */
     max_round_id: number;
     /** 纹章数 */
diff --git a/src/types/Game/Record.d.ts b/src/types/Game/Record.d.ts
index 16feb55e..34ed0bda 100644
--- a/src/types/Game/Record.d.ts
+++ b/src/types/Game/Record.d.ts
@@ -1,8 +1,8 @@
 /**
  * 原神战绩相关类型定义文件
- *
- * @since Beta v0.8.1
+ * @since Beta v0.9.9
  */
+
 declare namespace TGApp.Game.Record {
   /**
    * 原神战绩数据返回响应
@@ -151,13 +151,13 @@ declare namespace TGApp.Game.Record {
 
   /**
    * 幽境危战挑战数据类型
-   * @since Beta v0.8.0
+   * @since Beta v0.9.9
    */
   type ChallengeStats = {
     /** 是否解锁 */
     is_unlock: boolean;
     /** 挑战难度 */
-    difficulty: number;
+    difficulty: TGApp.Game.Challenge.DiffEnum;
     /** 是否有数据 */
     has_data: boolean;
     /** 挑战名称 */