✨ feat: 配置系统支持迁移

Author: imsyy

src/stores/migrations/settingMigrations.ts

@@ -0,0 +1,60 @@
+import type { SettingState } from "../setting";
+import { defaultAMLLDbServer } from "@/utils/meta";
+
+/**
+ * 当前设置 Schema 版本号
+ */
+export const CURRENT_SETTING_SCHEMA_VERSION = 1;
+
+/**
+ * 迁移函数类型
+ * 迁移函数只需返回需要更新的字段，系统会自动合并到原有状态
+ */
+export type MigrationFunction = (state: Partial<SettingState>) => Partial<SettingState>;
+
+/**
+ * 迁移脚本映射表
+ * key: 目标版本号
+ * value: 从上一版本迁移到该版本的函数
+ */
+export const settingMigrations: Record<number, MigrationFunction> = {
+  /**
+   * 迁移到版本 1
+   */
+  1: () => {
+    return {
+      schemaVersion: 1,
+      // amllDbServer 同步为新的默认值
+      amllDbServer: defaultAMLLDbServer,
+    };
+  },
+};
+
+/**
+ * 执行迁移
+ * @param state 当前状态
+ * @param fromVersion 当前版本号（如果不存在则为 0）
+ * @param toVersion 目标版本号
+ * @returns 迁移后的状态
+ */
+export const migrateSettingState = (
+  state: Partial<SettingState>,
+  fromVersion: number,
+  toVersion: number,
+): Partial<SettingState> => {
+  let migratedState = { ...state };
+
+  // 按版本顺序执行迁移
+  for (let version = fromVersion + 1; version <= toVersion; version++) {
+    const migration = settingMigrations[version];
+    if (migration) {
+      // 迁移函数返回需要更新的字段，自动合并到原有状态
+      const updates = migration(migratedState);
+      migratedState = { ...migratedState, ...updates };
+    } else {
+      console.warn(`[Setting Migration] 未找到版本 ${version} 的迁移脚本，跳过`);
+    }
+  }
+
+  return migratedState;
+};

src/stores/setting.ts

@@ -3,8 +3,14 @@ import { keywords, regexes } from "@/assets/data/exclude";
 import { SongUnlockServer } from "@/utils/songManager";
 import type { SongLevelType } from "@/types/main";
 import { defaultAMLLDbServer } from "@/utils/meta";
+import {
+  CURRENT_SETTING_SCHEMA_VERSION,
+  migrateSettingState,
+} from "./migrations/settingMigrations";
 
 export interface SettingState {
+  /** Schema 版本号（可选，用于数据迁移） */
+  schemaVersion?: number;
   /** 明暗模式 */
   themeMode: "light" | "dark" | "auto";
   /** 主题类别 */
@@ -243,6 +249,7 @@ export interface SettingState {
 
 export const useSettingStore = defineStore("setting", {
   state: (): SettingState => ({
+    schemaVersion: CURRENT_SETTING_SCHEMA_VERSION,
     themeMode: "auto",
     themeColorType: "default",
     themeCustomColor: "#fe7971",
@@ -371,6 +378,27 @@ export const useSettingStore = defineStore("setting", {
     },
   },
   actions: {
+    /**
+     * 检查并执行数据迁移
+     * 应在应用启动时调用
+     */
+    checkAndMigrate() {
+      const currentVersion = this.schemaVersion ?? 0;
+      const targetVersion = CURRENT_SETTING_SCHEMA_VERSION;
+
+      if (currentVersion !== targetVersion) {
+        console.log(`[Setting Migration] 检测到版本差异: ${currentVersion} -> ${targetVersion}`);
+        // 保存当前完整状态
+        const currentState = { ...this.$state } as Partial<SettingState>;
+        // 执行迁移，保留所有原有字段，只更新需要的字段
+        const migratedState = migrateSettingState(currentState, currentVersion, targetVersion);
+        // 应用迁移后的状态
+        Object.assign(this, migratedState);
+        // 确保版本号已更新
+        this.schemaVersion = targetVersion;
+        console.log(`[Setting Migration] 迁移完成，已更新到版本 ${targetVersion}`);
+      }
+    },
     // 更换明暗模式
     setThemeMode(mode?: "auto" | "light" | "dark") {
       // 若未传入

src/utils/init.ts

@@ -16,6 +16,9 @@ const init = async () => {
   const settingStore = useSettingStore();
   const shortcutStore = useShortcutStore();
 
+  // 检查并执行设置迁移
+  settingStore.checkAndMigrate();
+
   printVersion();
 
   // 用户协议