koishi-plugin-noah 1.8.2 → 2.0.1

package/lib/core/services/server-service.d.ts

@@ -22,6 +22,14 @@ export declare class ServerService {
      * @returns 该频道绑定的服务器完整信息列表
      */
     getServersByCid(cid: string): Promise<Server[]>;
+    /**
+     * 获取可供选择的服务器列表（合并用户与频道）
+     * 对于 mao 与 official 类型，由于其 URL 固定，仅保留其中一个实例
+     * @param uid - 用户ID
+     * @param cid - 频道ID，可为空
+     * @returns 去重后的服务器列表
+     */
+    getSelectableServers(uid: number, cid?: string | null): Promise<Server[]>;
     /**
      * 根据服务器ID获取服务器信息
      * @param id - 服务器ID

package/lib/drawer/sdvx/index.d.ts

@@ -8,6 +8,11 @@ import { BaseDrawer } from '../BaseDrawer';
 export declare class SDVXDrawer extends BaseDrawer {
     ctx: Context;
     constructor(ctx: Context);
+    /**
+     * Format difficulty level text.
+     * If it's an integer like 17 / 20, keep trailing ".0" (e.g. "17.0").
+     */
+    private formatDifficultyLevel;
     /**
      * 生成SDVX最近成绩图像
      * @param options - 图像生成配置选项

package/lib/games/sdvx/commands/sync.d.ts

@@ -0,0 +1,3 @@
+import { Context, Logger } from 'koishi';
+import { SDVXConfig } from '../../../types/config';
+export declare function sync(ctx: Context, config: SDVXConfig, logger: Logger): void;

package/lib/games/sdvx/database.d.ts

@@ -1,3 +1,15 @@
 import { Context } from 'koishi';
+declare module 'koishi' {
+    interface Tables {
+        sdvx_pin_verified: SdvxPinVerified;
+    }
+}
+export interface SdvxPinVerified {
+    id: number;
+    uid: number;
+    cardId: number;
+    sid: number;
+    pin: string;
+}
 export declare const name = "database";
 export declare function apply(ctx: Context): void;

package/lib/games/sdvx/services/music-service.d.ts

@@ -6,6 +6,8 @@ export declare class MusicService {
     private sdvx_data_url;
     private sdvx_search_url;
     private constructor();
+    private parseDifnum;
+    private normalizeMusicDifnum;
     /**
      * 获取 MusicService 实例
      * @param config - SDVX 配置对象
@@ -32,4 +34,8 @@ export declare class MusicService {
      * @returns 音乐信息数组
      */
     searchMusic(ctx: Context, query: string): Promise<SDVXMusic[]>;
+    extTitleToMid(ctx: Context, titles: string[]): Promise<{
+        title: string;
+        mid: string | null;
+    }[]>;
 }

package/lib/games/sdvx/utils/calculator.d.ts

@@ -1,7 +1,7 @@
 import { SDVXGrade, SDVXClearType } from '../types';
 /**
  * VF 查找表类型
- * Key: `${level}-${grade}-${clearType}-${vf}`
+ * Key: `${levelScaled}-${grade}-${clearType}-${vfInt}`
  * Value: QueryResult（每个组合只保留最小分数）
  */
 type VFLookupTable = Map<string, QueryResult>;

package/lib/games/sdvx/utils/param-parser.d.ts

@@ -15,6 +15,10 @@ export interface QueryParams {
 export declare function parseNumberWithSuffix(str: string): number;
 /**
  * 解析等级范围
+ * 规则：
+ * - 1-16: 只能是整数（用户输入整数时看作 xx.0）
+ * - 17: 可以是 17.0 或 17.5
+ * - 18-20.9: 0.1 步进（18.0, 18.1, ..., 20.9）
  */
 export declare function parseLevelRange(item: string): number[] | null;
 /**

package/lib/games/sdvx/utils/vf.d.ts

@@ -5,6 +5,7 @@ import { SDVXGrade, SDVXClearType, SDVXScore } from '../types';
 export declare const FACTOR_SCALE = 100;
 /**
  * VF 公式中的常量（分数与系数乘积乘以缩放后再取整）。
+ * 为了支持小数等级，level会被乘以10，所以分母也需要乘以10。
  */
 export declare const VOLFORCE_BASE_DENOMINATOR: bigint;
 /**

package/lib/index.cjs

@@ -221,7 +221,6 @@ var AssetService = class {
    */
   async extractAssets(archivePath) {
     const extractPath = (0, import_path.resolve)(this.basePath, "assets");
-    await (0, import_promises.mkdir)(extractPath, { recursive: true });
     this.logger.info(`Extracting assets to ${extractPath}`);
     try {
       if (!import_fs.default.existsSync(archivePath)) {
@@ -232,6 +231,11 @@ var AssetService = class {
       } catch (err) {
         throw new Error(`Archive file is not readable: ${archivePath}`);
       }
+      if (import_fs.default.existsSync(extractPath)) {
+        this.logger.info(`Removing existing assets: ${extractPath}`);
+        import_fs.default.rmSync(extractPath, { recursive: true, force: true });
+      }
+      await (0, import_promises.mkdir)(extractPath, { recursive: true });
       const zip = new import_adm_zip.default(archivePath);
       const zipEntries = zip.getEntries();
       this.logger.info(`Found ${zipEntries.length} files in archive`);
@@ -523,6 +527,32 @@ var ServerService = class {
       rows.map((obj) => obj.sid)
     );
   }
+  /**
+   * 获取可供选择的服务器列表（合并用户与频道）
+   * 对于 mao 与 official 类型，由于其 URL 固定，仅保留其中一个实例
+   * @param uid - 用户ID
+   * @param cid - 频道ID，可为空
+   * @returns 去重后的服务器列表
+   */
+  async getSelectableServers(uid, cid) {
+    const channelServers = cid ? await this.getServersByCid(cid) : [];
+    const userServers = await this.getServersByUid(uid);
+    const merged = [];
+    const seenIds = /* @__PURE__ */ new Set();
+    const seenFixedTypes = /* @__PURE__ */ new Set();
+    for (const server2 of [...channelServers, ...userServers]) {
+      if (seenIds.has(server2.id)) continue;
+      if ((server2.type === "mao" || server2.type === "official") && seenFixedTypes.has(server2.type)) {
+        continue;
+      }
+      if (server2.type === "mao" || server2.type === "official") {
+        seenFixedTypes.add(server2.type);
+      }
+      seenIds.add(server2.id);
+      merged.push(server2);
+    }
+    return merged;
+  }
   /**
    * 根据服务器ID获取服务器信息
    * @param id - 服务器ID
@@ -1002,8 +1032,12 @@ function bind(ctx, config) {
       case "invalid":
         return session.text(".invalid-code");
       case "access":
-        cardCode = await accessToUid(ctx, cardCode);
-        break;
+        try {
+          cardCode = await accessToUid(ctx, cardCode);
+          break;
+        } catch {
+          return session.text(".convert-access-failed");
+        }
       case "konamiid":
         cardCode = konamiIdToUid(cardCode);
         break;
@@ -1234,7 +1268,8 @@ async function showCardMenu(ctx, session, card2, cardService, serverService, use
       case "official":
         break;
     }
-    if (await cardService.getCardByCode(cardCode) != null) return session.text(".duplicate");
+    if (await cardService.getCardByCode(cardCode) != null)
+      return session.text(".menu-1-error-duplicate");
     let defaultServerId = card2.defaultServerId;
     if (cardType === "official") {
       defaultServerId = await ensureOfficialServerForUser(
@@ -1273,9 +1308,7 @@ async function showCardMenu(ctx, session, card2, cardService, serverService, use
     return session.text(".menu-4-success");
   }
   if (selectNum === 5) {
-    const userRes = await serverService.getServersByUid(uid);
-    const channelRes = await serverService.getServersByCid(cid);
-    const res = channelRes.concat(userRes);
+    const res = await serverService.getSelectableServers(uid, cid);
     let serverListMsg = "";
     for (let i = 0; i < res.length; i++) {
       if (res[i].id === userDefaultServerId) {
@@ -2917,10 +2950,10 @@ function apply6(ctx, config) {
 __name(apply6, "apply");
 
 // src/core/locales/en-US.yml
-var en_US_default3 = { _config: { $desc: "Core Module Settings", adminUsers: "**Plugin Admin** User ID (use inspect command to get)", guildNameCards: "**Group Card** Name List", maoServerUrl: "**Mao Server** URL address", official_support_url: "**Official Support** URL address" }, commands: { maintain: { description: "Switch to maintenance mode", messages: { "no-auth": "<p>You don't have permission to use this feature~</p>", start: "<p>Entering maintenance mode</p>", "success-start": "<p>Successfully switched to maintenance mode</p>", stop: "<p>Exiting maintenance mode</p>", "success-stop": "<p>Successfully exited maintenance mode</p>" } }, timeout: "Noah didn't wait for your reply, please try again!", noah: { help: { description: "Show Noah help information", messages: { content: "<p>Guide:</p>\nhttps://docs.logthm.cn/noah" } } }, locale: { description: "Set language", messages: { "no-auth": "<p>Only group admins can use this feature~</p>", "invalid-select": "<p>No such option!</p>", quit: "<p>Quit!</p>", "reset-channel": "<p>Reset successfully!</p>", "reset-user": "<p>Reset successfully!</p>", success: "<p>Set successfully!</p>", "set-channel": "<p>Select the default language for group chats:</p>\n<p>1. 简体中文</p>\n<p>2. English</p>\n<p>q. Quit</p>", "set-user": "<p>Select the language you use:</p>\n<p>1. 中文</p>\n<p>2. English</p>\n<p>q. Quit</p>" } }, bind: { description: "Bind card", messages: { prompt: "<p>Please enter your card number:</p>", "invalid-code": "<p>The card number is incorrect, if you don't remember it, go to the arcade to check it~</p>", name: "<p>Received! Please give this card a name, no spaces allowed:</p>", invalid_name: "<p>No spaces allowed! Please try again o(一︿一+)o</p>", success: "<p>Bound successfully, your card information is as follows:</p>\n<p>[{cardName}]</p>\n<p>{cardCode}</p>" } }, card: { description: "Manage cards", options: { detail: "Show detailed card information" }, messages: { "invalid-code": "<p>The card number is incorrect, if you don't remember it, go to the arcade to check it~</p>", "invalid-select": "<p>No such option!</p>", "lookup-error": "Lookup failed: {message}", "lookup-error-unknown": "Lookup failed: unknown error", "menu-select": "<p>[Card Management]</p>\n{card_list}\n<p>0. Add new card</p>\n<p>Please enter the serial number:</p>", menu: "<p>[{name}]</p>\n<p>1. Set as default card</p>\n<p>2. View or modify card number</p>\n<p>3. Delete the card</p>\n<p>4. Rename the card</p>\n<p>5. Bind the card to a specified server</p>\n<p>0. Return to card selection</p>\n<p>Please enter the serial number:</p>", "menu-has-bound-server": "<p>[{name}]</p>\n<p>Bound server: {defaultServerName}</p>\n<p>1. Set as default card</p>\n<p>2. View or modify card number</p>\n<p>3. Delete the card</p>\n<p>4. Rename the card</p>\n<p>5. Bind the card to a specified server</p>\n<p>0. Return to card selection</p>\n<p>Please enter the serial number:</p>", "menu-1-success": "<p>Set successfully!</p>", "menu-1-error-duplicate": "<p>The selected card is the same as the old default card!</p>", "menu-2-prompt": "<p>Card number: {code}</p>\n<p>Please enter the new card number:</p>\n<p>Enter 0 to return</p>", "menu-2-success": "<p>Modified successfully!</p>", "menu-2-error-invalid-code": "<p>The card number is incorrect, if you don't remember it, go to the arcade to check it~</p>", "menu-3-success": "<p>Deleted successfully!</p>", "menu-4-prompt": "<p>Enter a new name, no spaces allowed:</p>", "menu-4-error-invalid-name": "<p>No spaces allowed! Please try again o(一︿一+)o</p>", "menu-4-success": "<p>Modified successfully!</p>", "menu-5": "{server_list}\n<p>Please enter the serial number:</p>", "menu-5-success": "<p>Set successfully!</p>", "menu-5-error-duplicate": "<p>The selected server is the same as the old default server!</p>" } }, server: { description: "Manage servers", messages: { "no-channel": "<p>Please use this feature in group chats~</p>", "invalid-select": "<p>No such option!</p>", "no-auth": "<p>Only group admins can use this feature~</p>", "admin-menu-select": "<p>[Group server management]</p>\n{server_list}\n<p>0. Add new server</p>\n<p>Please enter the serial number:</p>", "menu-select": "<p>[Server management]</p>\n{server_list}\n<p>0. Add new server</p>\n<p>Please enter the serial number:</p>", menu: "<p>[{name}]</p>\n<p>Type: {type}</p>\n<p>1. Set as default server</p>\n<p>2. View or modify url</p>\n<p>3. Delete the server</p>\n<p>4. Rename the server</p>\n<p>0. Return to server selection</p>\n<p>Please enter the serial number:</p>", "menu-1-success": "<p>Set successfully!</p>", "menu-1-error-duplicate": "<p>The selected server is the same as the old default server!</p>", "menu-2-prompt": "<p>The server's url: {baseUrl}</p>\n<p>Please enter the new server url:</p>\n<p>Enter 0 to return</p>", "menu-2-success": "<p>Modified successfully!</p>", "menu-2-invalid-url": "<p>Invalid URL format! Please enter a valid url address.</p>", "menu-2-too-many-attempts": "<p>Too many attempts. Operation cancelled.</p>", "menu-3-success": "<p>Deleted successfully!</p>", "menu-4-prompt": "<p>Enter a new name, no spaces allowed:</p>", "menu-4-error-invalid-name": "<p>No spaces allowed! Please try again o(一︿一+)o</p>", "menu-4-success": "<p>Modified successfully!</p>", "add-type": "<p>Please select the server type:</p>\n{server_type_list}", "add-url": "<p>Please enter the server url:</p>", "add-invalid-url": "<p>Invalid URL format! Please enter a valid url address.</p>", "add-too-many-attempts": "<p>Too many attempts. Operation cancelled.</p>", "add-name": "<p>Received! Please give the server a name, no spaces allowed:</p>", "add-invalid_name": "<p>No spaces allowed! Please try again o(一︿一+)o</p>", "add-success": "<p>Added successfully, the server information is as follows:</p>\n<p>[{serverName}]</p>\n<p>Type: {serverType}</p>" } } } };
+var en_US_default3 = { _config: { $desc: "Core Module Settings", adminUsers: "**Plugin Admin** User ID (use inspect command to get)", guildNameCards: "**Group Card** Name List", maoServerUrl: "**Mao Server** URL address", official_support_url: "**Official Support** URL address" }, commands: { maintain: { description: "Switch to maintenance mode", messages: { "no-auth": "<p>You don't have permission to use this feature~</p>", start: "<p>Entering maintenance mode</p>", "success-start": "<p>Successfully switched to maintenance mode</p>", stop: "<p>Exiting maintenance mode</p>", "success-stop": "<p>Successfully exited maintenance mode</p>" } }, timeout: "Noah didn't wait for your reply, please try again!", noah: { help: { description: "Show Noah help information", messages: { content: "<p>Guide:</p>\nhttps://docs.logthm.cn/noah" } } }, locale: { description: "Set language", messages: { "no-auth": "<p>Only group admins can use this feature~</p>", "invalid-select": "<p>No such option!</p>", quit: "<p>Quit!</p>", "reset-channel": "<p>Reset successfully!</p>", "reset-user": "<p>Reset successfully!</p>", success: "<p>Set successfully!</p>", "set-channel": "<p>Select the default language for group chats:</p>\n<p>1. 简体中文</p>\n<p>2. English</p>\n<p>q. Quit</p>", "set-user": "<p>Select the language you use:</p>\n<p>1. 中文</p>\n<p>2. English</p>\n<p>q. Quit</p>" } }, bind: { description: "Bind card", messages: { prompt: "<p>Please enter your card number:</p>", "convert-access-failed": "<p>Failed to convert Access Code, please use 16-digit card code instead.</p>", "invalid-code": "<p>The card number is incorrect, if you don't remember it, go to the arcade to check it~</p>", name: "<p>Received! Please give this card a name, no spaces allowed:</p>", invalid_name: "<p>No spaces allowed! Please try again o(一︿一+)o</p>", success: "<p>Bound successfully, your card information is as follows:</p>\n<p>[{cardName}]</p>\n<p>{cardCode}</p>" } }, card: { description: "Manage cards", options: { detail: "Show detailed card information" }, messages: { "invalid-code": "<p>The card number is incorrect, if you don't remember it, go to the arcade to check it~</p>", "invalid-select": "<p>No such option!</p>", "lookup-error": "Lookup failed: {message}", "lookup-error-unknown": "Lookup failed: unknown error", "menu-select": "<p>[Card Management]</p>\n{card_list}\n<p>0. Add new card</p>\n<p>Please enter the serial number:</p>", menu: "<p>[{name}]</p>\n<p>1. Set as default card</p>\n<p>2. View or modify card number</p>\n<p>3. Delete the card</p>\n<p>4. Rename the card</p>\n<p>5. Bind the card to a specified server</p>\n<p>0. Return to card selection</p>\n<p>Please enter the serial number:</p>", "menu-has-bound-server": "<p>[{name}]</p>\n<p>Bound server: {defaultServerName}</p>\n<p>1. Set as default card</p>\n<p>2. View or modify card number</p>\n<p>3. Delete the card</p>\n<p>4. Rename the card</p>\n<p>5. Bind the card to a specified server</p>\n<p>0. Return to card selection</p>\n<p>Please enter the serial number:</p>", "menu-1-success": "<p>Set successfully!</p>", "menu-1-error-duplicate": "<p>The selected card is the same as the old default card!</p>", "menu-2-prompt": "<p>Card number: {code}</p>\n<p>Please enter the new card number:</p>\n<p>Enter 0 to return</p>", "menu-2-success": "<p>Modified successfully!</p>", "menu-2-error-invalid-code": "<p>The card number is incorrect, if you don't remember it, go to the arcade to check it~</p>", "menu-3-success": "<p>Deleted successfully!</p>", "menu-4-prompt": "<p>Enter a new name, no spaces allowed:</p>", "menu-4-error-invalid-name": "<p>No spaces allowed! Please try again o(一︿一+)o</p>", "menu-4-success": "<p>Modified successfully!</p>", "menu-5": "{server_list}\n<p>Please enter the serial number:</p>", "menu-5-success": "<p>Set successfully!</p>", "menu-5-error-duplicate": "<p>The selected server is the same as the old default server!</p>" } }, server: { description: "Manage servers", messages: { "no-channel": "<p>Please use this feature in group chats~</p>", "invalid-select": "<p>No such option!</p>", "no-auth": "<p>Only group admins can use this feature~</p>", "admin-menu-select": "<p>[Group server management]</p>\n{server_list}\n<p>0. Add new server</p>\n<p>Please enter the serial number:</p>", "menu-select": "<p>[Server management]</p>\n{server_list}\n<p>0. Add new server</p>\n<p>Please enter the serial number:</p>", menu: "<p>[{name}]</p>\n<p>Type: {type}</p>\n<p>1. Set as default server</p>\n<p>2. View or modify url</p>\n<p>3. Delete the server</p>\n<p>4. Rename the server</p>\n<p>0. Return to server selection</p>\n<p>Please enter the serial number:</p>", "menu-1-success": "<p>Set successfully!</p>", "menu-1-error-duplicate": "<p>The selected server is the same as the old default server!</p>", "menu-2-prompt": "<p>The server's url: {baseUrl}</p>\n<p>Please enter the new server url:</p>\n<p>Enter 0 to return</p>", "menu-2-success": "<p>Modified successfully!</p>", "menu-2-invalid-url": "<p>Invalid URL format! Please enter a valid url address.</p>", "menu-2-too-many-attempts": "<p>Too many attempts. Operation cancelled.</p>", "menu-3-success": "<p>Deleted successfully!</p>", "menu-4-prompt": "<p>Enter a new name, no spaces allowed:</p>", "menu-4-error-invalid-name": "<p>No spaces allowed! Please try again o(一︿一+)o</p>", "menu-4-success": "<p>Modified successfully!</p>", "add-type": "<p>Please select the server type:</p>\n{server_type_list}", "add-url": "<p>Please enter the server url:</p>", "add-invalid-url": "<p>Invalid URL format! Please enter a valid url address.</p>", "add-too-many-attempts": "<p>Too many attempts. Operation cancelled.</p>", "add-name": "<p>Received! Please give the server a name, no spaces allowed:</p>", "add-invalid_name": "<p>No spaces allowed! Please try again o(一︿一+)o</p>", "add-success": "<p>Added successfully, the server information is as follows:</p>\n<p>[{serverName}]</p>\n<p>Type: {serverType}</p>" } } } };
 
 // src/core/locales/zh-CN.yml
-var zh_CN_default3 = { _config: { $desc: "Core 模块设置", adminUsers: "**插件管理员** 的用户id (使用 inspect 指令获取)", guildNameCards: "**群聊卡片** 的名称列表", maoServerUrl: "**猫网服务器** 的 URL 地址", official_support_url: "**官方支持** 的 URL 地址" }, commands: { maintain: { description: "切换到维护模式", messages: { "no-auth": "<p>你没有权限使用本功能哦~</p>", start: "<p>正在进入维护模式</p>", "success-start": "<p>成功切换到维护模式</p>", stop: "<p>正在退出维护模式</p>", "success-stop": "<p>成功退出维护模式</p>" } }, timeout: "Noah 没等到你的回复，请重试！", noah: { help: { description: "显示 Noah 帮助信息", messages: { content: "<p>使用文档：</p>\nhttps://docs.logthm.cn/noah" } } }, locale: { description: "设置语言", messages: { "no-auth": "<p>只有群管理员能使用本功能哦~</p>", "invalid-select": "<p>没有该选项！</p>", quit: "<p>已退出~</p>", "reset-channel": "<p>重置成功！</p>", "reset-user": "<p>重置成功！</p>", success: "<p>设置成功！</p>", "set-channel": "<p>选择群聊默认使用的语言：</p>\n<p>1. 简体中文</p>\n<p>2. English</p>\n<p>q. 退出</p>", "set-user": "<p>选择你使用的语言：</p>\n<p>1. 简体中文</p>\n<p>2. English</p>\n<p>q. 退出</p>" } }, bind: { description: "绑定卡片", messages: { prompt: "<p>请输入你的卡号：</p>", "invalid-code": "<p>卡号不对哟，不记得的话去机台刷一下吧~</p>", name: "<p>收到！为这张卡取一个名字吧，不要带空格哦：</p>", invalid_name: "<p>名字不要带空格！重来重来 o(一︿一+)o</p>", success: "<p>绑好啦，你的卡片信息如下：</p>\n<p>[{cardName}]</p>\n<p>{cardCode}</p>" } }, card: { description: "管理卡片", options: { detail: "显示卡片详细信息" }, messages: { "invalid-code": "<p>卡号不对哟，不记得的话去机台刷一下吧~</p>", "invalid-select": "<p>没有该选项！</p>", quit: "<p>已退出~</p>", "lookup-error": "查询失败: {message}", "lookup-error-unknown": "查询失败: 未知错误", "menu-select": "<p>[卡片管理]</p>\n{card_list}\n<p>0. 添加新卡片</p>\n<p>q. 退出菜单</p>\n<p>请输入序号：</p>", menu: "<p>[{name}]</p>\n<p>1. 设为默认卡片</p>\n<p>2. 查看或修改卡号</p>\n<p>3. 删除该卡</p>\n<p>4. 重命名该卡片</p>\n<p>5. 将卡片与指定服务器绑定</p>\n<p>0. 返回卡片选择</p>\n<p>q. 退出菜单</p>\n<p>请输入序号：</p>", "menu-has-bound-server": "<p>[{name}]</p>\n<p>已绑定服务器：{defaultServerName}</p>\n<p>1. 设为默认卡片</p>\n<p>2. 查看或修改卡号</p>\n<p>3. 删除该卡</p>\n<p>4. 重命名该卡片</p>\n<p>5. 将卡片与指定服务器绑定</p>\n<p>0. 返回卡片选择</p>\n<p>q. 退出菜单</p>\n<p>请输入序号：</p>", "menu-1-success": "<p>设置成功！</p>", "menu-1-error-duplicate": "<p>选择的卡片与旧的默认卡片相同！</p>", "menu-2-prompt": "<p>卡号：{code}</p>\n<p>请输入新的卡号：</p>\n<p>0. 返回</p>\n<p>q. 退出</p>", "menu-2-success": "<p>修改成功！</p>", "menu-2-error-invalid-code": "<p>卡号不对哟，不记得的话去机台刷一下吧~</p>", "menu-3-success": "<p>已删除！</p>", "menu-4-prompt": "<p>输入一个新名字，不要带空格哦：</p>\n<p>q. 退出</p>", "menu-4-error-invalid-name": "<p>名字不要带空格！重来重来 o(一︿一+)o</p>", "menu-4-success": "<p>修改成功！</p>", "menu-5": "<p>请选择一个服务器：</p>\n{server_list}\n<p>q. 退出</p>", "menu-5-success": "<p>设置成功！</p>", "menu-5-error-duplicate": "<p>选择的服务器与旧的默认服务器相同！</p>" } }, server: { description: "管理服务器", messages: { "no-channel": "<p>请在群聊中使用本功能哦~</p>", "invalid-select": "<p>没有该选项！</p>", "no-auth": "<p>只有群管理员能使用本功能哦~</p>", quit: "<p>已退出~</p>", "admin-menu-select": "<p>[群聊服务器管理]</p>\n{server_list}\n<p>0. 添加新服务器</p>\n<p>q. 退出菜单</p>\n<p>请输入序号：</p>", "menu-select": "<p>[服务器管理]</p>\n{server_list}\n<p>0. 添加新服务器</p>\n<p>q. 退出菜单</p>\n<p>请输入序号：</p>", menu: "<p>[{name}]</p>\n<p>类型：{type}</p>\n<p>1. 设为默认服务器</p>\n<p>2. 查看或修改 url</p>\n<p>3. 删除该服务器</p>\n<p>4. 重命名该服务器</p>\n<p>0. 返回服务器选择</p>\n<p>q. 退出菜单</p>\n<p>请输入序号：</p>", "menu-1-success": "<p>设置成功！</p>", "menu-1-error-duplicate": "<p>选择的服务器与旧的默认服务器相同！</p>", "menu-2-prompt": "<p>该服务器的 url：{baseUrl}</p>\n<p>请输入新的服务器 url：</p>\n<p>0. 返回</p>\n<p>q. 退出</p>", "menu-2-success": "<p>修改成功！</p>", "menu-2-invalid-url": "<p>URL 格式不正确！请输入有效的 url 地址。</p>", "menu-2-too-many-attempts": "<p>尝试次数过多，操作已取消。</p>", "menu-3-success": "<p>已删除！</p>", "menu-4-prompt": "<p>输入一个新名字，不要带空格哦：</p>\n<p>0. 返回</p>\n<p>q. 退出</p>", "menu-4-error-invalid-name": "<p>名字不要带空格！重来重来 o(一︿一+)o</p>", "menu-4-success": "<p>修改成功！</p>", "add-type": "<p>请选择服务器的类型：</p>\n{server_type_list}\n<p>q. 退出</p>", "add-url": "<p>请输入服务器的 url：</p>\n<p>q. 退出</p>", "add-invalid-url": "<p>URL 格式不正确！请输入有效的 url 地址。</p>", "add-too-many-attempts": "<p>尝试次数过多，操作已取消。</p>", "add-name": "<p>收到！为服务器取一个名字吧，不要带空格哦：</p>\n<p>q. 退出</p>", "add-invalid_name": "<p>名字不要带空格！重来重来 o(一︿一+)o</p>", "add-success": "<p>添加成功啦，服务器信息如下：</p>\n<p>[{serverName}]</p>\n<p>类型：{serverType}</p>" } } } };
+var zh_CN_default3 = { _config: { $desc: "Core 模块设置", adminUsers: "**插件管理员** 的用户id (使用 inspect 指令获取)", guildNameCards: "**群聊卡片** 的名称列表", maoServerUrl: "**猫网服务器** 的 URL 地址", official_support_url: "**官方支持** 的 URL 地址" }, commands: { maintain: { description: "切换到维护模式", messages: { "no-auth": "<p>你没有权限使用本功能哦~</p>", start: "<p>正在进入维护模式</p>", "success-start": "<p>成功切换到维护模式</p>", stop: "<p>正在退出维护模式</p>", "success-stop": "<p>成功退出维护模式</p>" } }, timeout: "Noah 没等到你的回复，请重试！", noah: { help: { description: "显示 Noah 帮助信息", messages: { content: "<p>使用文档：</p>\nhttps://docs.logthm.cn/noah" } } }, locale: { description: "设置语言", messages: { "no-auth": "<p>只有群管理员能使用本功能哦~</p>", "invalid-select": "<p>没有该选项！</p>", quit: "<p>已退出~</p>", "reset-channel": "<p>重置成功！</p>", "reset-user": "<p>重置成功！</p>", success: "<p>设置成功！</p>", "set-channel": "<p>选择群聊默认使用的语言：</p>\n<p>1. 简体中文</p>\n<p>2. English</p>\n<p>q. 退出</p>", "set-user": "<p>选择你使用的语言：</p>\n<p>1. 简体中文</p>\n<p>2. English</p>\n<p>q. 退出</p>" } }, bind: { description: "绑定卡片", messages: { prompt: "<p>请输入你的卡号：</p>", "convert-access-failed": "<p>转换 Access Code 失败，请使用 16 位卡号进行绑定。</p>", "invalid-code": "<p>卡号不对哟，不记得的话去机台刷一下吧~</p>", name: "<p>收到！为这张卡取一个名字吧，不要带空格哦：</p>", invalid_name: "<p>名字不要带空格！重来重来 o(一︿一+)o</p>", success: "<p>绑好啦，你的卡片信息如下：</p>\n<p>[{cardName}]</p>\n<p>{cardCode}</p>" } }, card: { description: "管理卡片", options: { detail: "显示卡片详细信息" }, messages: { "invalid-code": "<p>卡号不对哟，不记得的话去机台刷一下吧~</p>", "invalid-select": "<p>没有该选项！</p>", quit: "<p>已退出~</p>", "lookup-error": "查询失败: {message}", "lookup-error-unknown": "查询失败: 未知错误", "menu-select": "<p>[卡片管理]</p>\n{card_list}\n<p>0. 添加新卡片</p>\n<p>q. 退出菜单</p>\n<p>请输入序号：</p>", menu: "<p>[{name}]</p>\n<p>1. 设为默认卡片</p>\n<p>2. 查看或修改卡号</p>\n<p>3. 删除该卡</p>\n<p>4. 重命名该卡片</p>\n<p>5. 将卡片与指定服务器绑定</p>\n<p>0. 返回卡片选择</p>\n<p>q. 退出菜单</p>\n<p>请输入序号：</p>", "menu-has-bound-server": "<p>[{name}]</p>\n<p>已绑定服务器：{defaultServerName}</p>\n<p>1. 设为默认卡片</p>\n<p>2. 查看或修改卡号</p>\n<p>3. 删除该卡</p>\n<p>4. 重命名该卡片</p>\n<p>5. 将卡片与指定服务器绑定</p>\n<p>0. 返回卡片选择</p>\n<p>q. 退出菜单</p>\n<p>请输入序号：</p>", "menu-1-success": "<p>设置成功！</p>", "menu-1-error-duplicate": "<p>选择的卡片与旧的默认卡片相同！</p>", "menu-2-prompt": "<p>卡号：{code}</p>\n<p>请输入新的卡号：</p>\n<p>0. 返回</p>\n<p>q. 退出</p>", "menu-2-success": "<p>修改成功！</p>", "menu-2-error-invalid-code": "<p>卡号不对哟，不记得的话去机台刷一下吧~</p>", "menu-3-success": "<p>已删除！</p>", "menu-4-prompt": "<p>输入一个新名字，不要带空格哦：</p>\n<p>q. 退出</p>", "menu-4-error-invalid-name": "<p>名字不要带空格！重来重来 o(一︿一+)o</p>", "menu-4-success": "<p>修改成功！</p>", "menu-5": "<p>请选择一个服务器：</p>\n{server_list}\n<p>q. 退出</p>", "menu-5-success": "<p>设置成功！</p>", "menu-5-error-duplicate": "<p>选择的服务器与旧的默认服务器相同！</p>" } }, server: { description: "管理服务器", messages: { "no-channel": "<p>请在群聊中使用本功能哦~</p>", "invalid-select": "<p>没有该选项！</p>", "no-auth": "<p>只有群管理员能使用本功能哦~</p>", quit: "<p>已退出~</p>", "admin-menu-select": "<p>[群聊服务器管理]</p>\n{server_list}\n<p>0. 添加新服务器</p>\n<p>q. 退出菜单</p>\n<p>请输入序号：</p>", "menu-select": "<p>[服务器管理]</p>\n{server_list}\n<p>0. 添加新服务器</p>\n<p>q. 退出菜单</p>\n<p>请输入序号：</p>", menu: "<p>[{name}]</p>\n<p>类型：{type}</p>\n<p>1. 设为默认服务器</p>\n<p>2. 查看或修改 url</p>\n<p>3. 删除该服务器</p>\n<p>4. 重命名该服务器</p>\n<p>0. 返回服务器选择</p>\n<p>q. 退出菜单</p>\n<p>请输入序号：</p>", "menu-1-success": "<p>设置成功！</p>", "menu-1-error-duplicate": "<p>选择的服务器与旧的默认服务器相同！</p>", "menu-2-prompt": "<p>该服务器的 url：{baseUrl}</p>\n<p>请输入新的服务器 url：</p>\n<p>0. 返回</p>\n<p>q. 退出</p>", "menu-2-success": "<p>修改成功！</p>", "menu-2-invalid-url": "<p>URL 格式不正确！请输入有效的 url 地址。</p>", "menu-2-too-many-attempts": "<p>尝试次数过多，操作已取消。</p>", "menu-3-success": "<p>已删除！</p>", "menu-4-prompt": "<p>输入一个新名字，不要带空格哦：</p>\n<p>0. 返回</p>\n<p>q. 退出</p>", "menu-4-error-invalid-name": "<p>名字不要带空格！重来重来 o(一︿一+)o</p>", "menu-4-success": "<p>修改成功！</p>", "add-type": "<p>请选择服务器的类型：</p>\n{server_type_list}\n<p>q. 退出</p>", "add-url": "<p>请输入服务器的 url：</p>\n<p>q. 退出</p>", "add-invalid-url": "<p>URL 格式不正确！请输入有效的 url 地址。</p>", "add-too-many-attempts": "<p>尝试次数过多，操作已取消。</p>", "add-name": "<p>收到！为服务器取一个名字吧，不要带空格哦：</p>\n<p>q. 退出</p>", "add-invalid_name": "<p>名字不要带空格！重来重来 o(一︿一+)o</p>", "add-success": "<p>添加成功啦，服务器信息如下：</p>\n<p>[{serverName}]</p>\n<p>类型：{serverType}</p>" } } } };
 
 // src/core/index.ts
 var name7 = "Noah-Core";
@@ -3109,14 +3142,14 @@ var GRADE_FACTOR_SCALES = {
 var CLEAR_FACTOR_SCALES = {
   "S-PUC": 110,
   PUC: 110,
-  UC: 105,
+  UC: 106,
   MC: 104,
   HC: 102,
   NC: 100,
   PLAYED: 50,
   "NO PLAY": 50
 };
-var VOLFORCE_BASE_DENOMINATOR = BigInt(5e5) * BigInt(FACTOR_SCALE) * BigInt(FACTOR_SCALE);
+var VOLFORCE_BASE_DENOMINATOR = BigInt(5e5) * BigInt(FACTOR_SCALE) * BigInt(FACTOR_SCALE) * BigInt(10);
 function calculateVolforce(raw_score) {
   const score = raw_score.music.score;
   const level = raw_score.music.music_diff;
@@ -3139,7 +3172,8 @@ function calculateVolforceIntValue(level, score, grade, clearType) {
 }
 __name(calculateVolforceIntValue, "calculateVolforceIntValue");
 function calculateVolforceInt(level, score, grade, clearType) {
-  const numerator = BigInt(level) * BigInt(score) * BigInt(GRADE_FACTOR_SCALES[grade]) * BigInt(CLEAR_FACTOR_SCALES[clearType]);
+  const levelScaled = Math.round(level * 10);
+  const numerator = BigInt(levelScaled) * BigInt(score) * BigInt(GRADE_FACTOR_SCALES[grade]) * BigInt(CLEAR_FACTOR_SCALES[clearType]);
   return numerator / VOLFORCE_BASE_DENOMINATOR;
 }
 __name(calculateVolforceInt, "calculateVolforceInt");
@@ -3160,6 +3194,27 @@ var SCORE_GRADE_MAP = [
 ];
 var VF_INT_MULTIPLIER = 20;
 var VF_INPUT_PRECISION = 6;
+var LEVEL_SCALE = 10;
+function scaleLevel(level) {
+  return Math.round(level * LEVEL_SCALE);
+}
+__name(scaleLevel, "scaleLevel");
+function unscaleLevel(levelScaled) {
+  return levelScaled / LEVEL_SCALE;
+}
+__name(unscaleLevel, "unscaleLevel");
+function getAllValidLevels() {
+  const levels = [];
+  for (let i = 1; i <= 16; i++) {
+    levels.push(i);
+  }
+  levels.push(17, 17.5);
+  for (let levelScaled = 180; levelScaled <= 209; levelScaled++) {
+    levels.push(unscaleLevel(levelScaled));
+  }
+  return levels;
+}
+__name(getAllValidLevels, "getAllValidLevels");
 function normalizeVfInput(value) {
   return Number(value.toFixed(VF_INPUT_PRECISION));
 }
@@ -3177,7 +3232,8 @@ function floorVfInt(value) {
 }
 __name(floorVfInt, "floorVfInt");
 function getVolforceMultiplier(level, grade, clearType) {
-  return BigInt(level) * BigInt(getGradeFactorScale(grade)) * BigInt(getClearFactorScale(clearType));
+  const levelScaled = Math.round(level * 10);
+  return BigInt(levelScaled) * BigInt(getGradeFactorScale(grade)) * BigInt(getClearFactorScale(clearType));
 }
 __name(getVolforceMultiplier, "getVolforceMultiplier");
 function getMinScoreForVfInt(multiplier, vfInt) {
@@ -3286,8 +3342,9 @@ function getClearTypeRange(clearType) {
 }
 __name(getClearTypeRange, "getClearTypeRange");
 function getLevelRange(level) {
-  if (!level) return Array.from({ length: 20 }, (_, i) => i + 1);
-  return Array.isArray(level) ? level : [level];
+  if (!level) return getAllValidLevels();
+  const raw = Array.isArray(level) ? level : [level];
+  return raw.map((l) => unscaleLevel(scaleLevel(l)));
 }
 __name(getLevelRange, "getLevelRange");
 function generateVFLookupTable() {
@@ -3303,7 +3360,8 @@ function generateVFLookupTable() {
     "PLAYED",
     "NO PLAY"
   ];
-  for (let level = 1; level <= 20; level++) {
+  for (const level of getAllValidLevels()) {
+    const levelScaled = scaleLevel(level);
     for (const grade of allGrades) {
       const gradeMapping = SCORE_GRADE_MAP.find((m) => m.grade === grade);
       if (!gradeMapping) {
@@ -3337,12 +3395,13 @@ function generateVFLookupTable() {
           if (!possibleClearTypes.includes(clearType)) {
             continue;
           }
-          const vf2 = calculateVolforce2(level, score, grade, clearType);
-          const key = `${level}-${grade}-${clearType}-${vf2}`;
+          const vfInt = calculateVolforceIntValue(level, score, grade, clearType);
+          const vf2 = vfInt / VF_INT_MULTIPLIER;
+          const key = `${levelScaled}-${grade}-${clearType}-${vfInt}`;
           const existing = lookupTable.get(key);
           if (!existing || score < existing.score) {
             lookupTable.set(key, {
-              level,
+              level: unscaleLevel(levelScaled),
               score,
               grade,
               clearType,
@@ -3386,13 +3445,14 @@ function generateQueryResults(params) {
   const lookupTable = getVFLookupTable();
   const results = [];
   const levels = getLevelRange(params.level);
+  const levelScaleSet = new Set(levels.map(scaleLevel));
   const clearTypes = getClearTypeRange(params.clearType);
   const grades = getGradeRange(params.grade);
   if (params.vf) {
     const vfValues = getVfRange(params.vf);
     const vfSet = new Set(vfValues);
     for (const result of lookupTable.values()) {
-      if (levels.includes(result.level) && clearTypes.includes(result.clearType) && grades.includes(result.grade) && vfSet.has(result.vf)) {
+      if (levelScaleSet.has(scaleLevel(result.level)) && clearTypes.includes(result.clearType) && grades.includes(result.grade) && vfSet.has(result.vf)) {
         results.push(result);
       }
     }
@@ -3490,7 +3550,7 @@ function generateQueryResults(params) {
     }
   } else {
     for (const result of lookupTable.values()) {
-      if (levels.includes(result.level) && clearTypes.includes(result.clearType) && grades.includes(result.grade)) {
+      if (levelScaleSet.has(scaleLevel(result.level)) && clearTypes.includes(result.clearType) && grades.includes(result.grade)) {
         results.push(result);
       }
     }
@@ -3518,6 +3578,14 @@ var SDVXDrawer = class extends BaseDrawer {
   static {
     __name(this, "SDVXDrawer");
   }
+  /**
+   * Format difficulty level text.
+   * If it's an integer like 17 / 20, keep trailing ".0" (e.g. "17.0").
+   */
+  formatDifficultyLevel(level) {
+    if (!Number.isFinite(level)) return String(level);
+    return Number.isInteger(level) ? level.toFixed(1) : String(level);
+  }
   /**
    * 生成SDVX最近成绩图像
    * @param options - 图像生成配置选项
@@ -3709,7 +3777,7 @@ var SDVXDrawer = class extends BaseDrawer {
     ctx.drawImage(gradeImage, 139, 151);
     const playTypeImage = playTypeImages[options.score.music.clear_type];
     ctx.drawImage(playTypeImage, 139, 178);
-    const levelStr = options.score.music.music_diff.toString();
+    const levelStr = this.formatDifficultyLevel(options.score.music.music_diff);
     ctx.fillStyle = "#0230A5";
     ctx.textBaseline = "alphabetic";
     ctx.textAlign = "left";
@@ -3978,7 +4046,7 @@ var SDVXDrawer = class extends BaseDrawer {
         ctx.font = '24px "Fredoka One"';
         ctx.textAlign = "right";
         ctx.textBaseline = "alphabetic";
-        ctx.fillText(score.music.music_diff.toString(), x + 248, y + 67);
+        ctx.fillText(this.formatDifficultyLevel(score.music.music_diff), x + 248, y + 67);
         ctx.restore();
         const scoreText = score.music.score.toString();
         const scoreStartX = x + 381;
@@ -4414,7 +4482,7 @@ var SDVXDrawer = class extends BaseDrawer {
       const rowHeight = rowHeights.get(level) || baseCellHeight;
       const x = padding;
       const y = levelY + rowHeight / 2;
-      ctx.fillText(level.toString(), x + levelColumnWidth / 2, y);
+      ctx.fillText(this.formatDifficultyLevel(level), x + levelColumnWidth / 2, y);
       levelY += rowHeight;
     }
     ctx.strokeStyle = "#444444";
@@ -4886,20 +4954,72 @@ function parseNumberWithSuffix(str) {
   return num;
 }
 __name(parseNumberWithSuffix, "parseNumberWithSuffix");
+function isValidLevel(level) {
+  if (level < 1 || level > 20.9) {
+    return false;
+  }
+  const integerPart = Math.floor(level);
+  const decimalPart = level - integerPart;
+  if (integerPart >= 1 && integerPart <= 16) {
+    return decimalPart === 0;
+  }
+  if (integerPart === 17) {
+    return decimalPart === 0 || decimalPart === 0.5;
+  }
+  if (integerPart >= 18 && integerPart <= 20) {
+    const tenths = Math.round(decimalPart * 10);
+    return Math.abs(decimalPart * 10 - tenths) < 1e-4 && tenths >= 0 && tenths <= 9;
+  }
+  return false;
+}
+__name(isValidLevel, "isValidLevel");
+function generateValidLevelRange(start, end) {
+  const levels = [];
+  const startInt = Math.floor(start);
+  const endInt = Math.floor(end);
+  const startTenth = Math.round((start - startInt) * 10);
+  const endTenth = Math.round((end - endInt) * 10);
+  for (let intPart = startInt; intPart <= endInt; intPart++) {
+    if (intPart >= 1 && intPart <= 16) {
+      if (intPart === startInt && startTenth > 0 || intPart === endInt && endTenth > 0) {
+        continue;
+      }
+      levels.push(intPart);
+    } else if (intPart === 17) {
+      const currentStartTenth = intPart === startInt ? startTenth : 0;
+      const currentEndTenth = intPart === endInt ? endTenth : 5;
+      if (currentStartTenth <= 0 && currentEndTenth >= 0) {
+        levels.push(17);
+      }
+      if (currentStartTenth <= 5 && currentEndTenth >= 5) {
+        levels.push(17.5);
+      }
+    } else if (intPart >= 18 && intPart <= 20) {
+      const currentStartTenth = intPart === startInt ? startTenth : 0;
+      const currentEndTenth = intPart === endInt ? endTenth : 9;
+      for (let tenth = currentStartTenth; tenth <= currentEndTenth && tenth <= 9; tenth++) {
+        levels.push(intPart + tenth / 10);
+      }
+    }
+  }
+  return levels;
+}
+__name(generateValidLevelRange, "generateValidLevelRange");
 function parseLevelRange(item) {
-  if (/^\d{1,2}-\d{1,2}$/.test(item)) {
-    const [start, end] = item.split("-").map(Number);
-    if (start >= 1 && end <= 20 && start <= end) {
-      const levels = [];
-      for (let i = start; i <= end; i++) {
-        levels.push(i);
+  if (/^\d{1,2}(\.\d)?-\d{1,2}(\.\d)?$/.test(item)) {
+    const [startRaw, endRaw] = item.split("-");
+    const start = parseFloat(startRaw.includes(".") ? startRaw : startRaw + ".0");
+    const end = parseFloat(endRaw.includes(".") ? endRaw : endRaw + ".0");
+    if (start >= 1 && end <= 20.9 && start <= end) {
+      if (!isValidLevel(start) || !isValidLevel(end)) {
+        return null;
       }
-      return levels;
+      return generateValidLevelRange(start, end);
     }
   }
-  if (/^\d{1,2}$/.test(item)) {
-    const level = parseInt(item, 10);
-    if (level >= 1 && level <= 20) {
+  if (/^\d{1,2}(\.\d)?$/.test(item)) {
+    const level = parseFloat(item.includes(".") ? item : item + ".0");
+    if (isValidLevel(level)) {
       return [level];
     }
   }
@@ -5199,6 +5319,8 @@ function getDiffName(diffStr, infVer) {
       break;
     case "maximum":
       return "MXM";
+    case "ultimate":
+      return "ULT";
   }
 }
 __name(getDiffName, "getDiffName");
@@ -5229,6 +5351,8 @@ function getDiffFullName(diffStr, infVer) {
       break;
     case "maximum":
       return "MAXIMUM";
+    case "ultimate":
+      return "ULTIMATE";
   }
 }
 __name(getDiffFullName, "getDiffFullName");
@@ -5253,6 +5377,8 @@ function getDiffStringFromAbbr(diffAbbr) {
       return { diffStr: "infinite", infVer: 6 };
     case "MXM":
       return { diffStr: "maximum", infVer: null };
+    case "ULT":
+      return { diffStr: "ultimate", infVer: null };
     default:
       return null;
   }
@@ -5271,6 +5397,26 @@ var MusicService = class _MusicService {
     this.sdvx_data_url = config.sdvx_data_url;
     this.sdvx_search_url = config.sdvx_search_url;
   }
+  parseDifnum(value) {
+    if (typeof value === "number") {
+      return Number.isFinite(value) ? value : 0;
+    }
+    if (typeof value === "string") {
+      const parsed = Number.parseFloat(value.trim());
+      return Number.isFinite(parsed) ? parsed : 0;
+    }
+    return 0;
+  }
+  normalizeMusicDifnum(music) {
+    if (!music?.difficulty?.length) return music;
+    return {
+      ...music,
+      difficulty: music.difficulty.map((d) => ({
+        ...d,
+        difnum: this.parseDifnum(d.difnum)
+      }))
+    };
+  }
   /**
    * 获取 MusicService 实例
    * @param config - SDVX 配置对象
@@ -5299,7 +5445,11 @@ var MusicService = class _MusicService {
           { ids: numericIds },
           { baseURL: this.sdvx_data_url }
         );
-        results.push(...response);
+        if (Array.isArray(response)) {
+          results.push(
+            ...response.map((m) => this.normalizeMusicDifnum(m))
+          );
+        }
       } catch (error) {
         console.warn("Failed to fetch music data for numeric IDs:", error);
       }
@@ -5312,7 +5462,7 @@ var MusicService = class _MusicService {
           { baseURL: this.sdvx_data_url }
         );
         const converted = this.convertExternalToStandard(response);
-        results.push(...converted);
+        results.push(...converted.map((m) => this.normalizeMusicDifnum(m)));
       } catch (error) {
         console.warn("Failed to fetch music data for string IDs:", error);
       }
@@ -5334,7 +5484,7 @@ var MusicService = class _MusicService {
       inf_ver: data.difficulty[0]?.inf_ver || 0,
       difficulty: data.difficulty.map((diff) => ({
         difstr: diff.difstr,
-        difnum: diff.difnum,
+        difnum: this.parseDifnum(diff.difnum),
         illustrator: diff.ext_illustrator,
         effected_by: diff.ext_effected_by,
         cover_url: diff.cover_url,
@@ -5365,6 +5515,32 @@ var MusicService = class _MusicService {
       return null;
     }
   }
+  async extTitleToMid(ctx, titles) {
+    try {
+      const response = await ctx.http.post(
+        `/external/title-mapping`,
+        { titles },
+        { baseURL: this.sdvx_data_url }
+      );
+      if (!Array.isArray(response)) {
+        return [];
+      }
+      const mapping = new Map(
+        response.map((item) => [
+          item?.title?.toLowerCase(),
+          Number.isInteger(item?.music_id) ? String(item.music_id) : null
+        ])
+      );
+      const mids = [];
+      for (const title of titles) {
+        const mid = mapping.get(title.toLowerCase()) ?? null;
+        mids.push({ title, mid });
+      }
+      return mids;
+    } catch {
+      return [];
+    }
+  }
 };
 
 // src/games/sdvx/commands/chart.ts
@@ -5819,7 +5995,7 @@ var SDVXService2 = class _SDVXService {
   }
   /**
    * Get the difficulty string based on the difficulty type number
-   * @param diffType Difficulty type (0-4)
+   * @param diffType Difficulty type
    * @returns The difficulty string (novice, advanced, exhaust, infinite, maximum)
    */
   getDifficultyString(diffType) {
@@ -5851,6 +6027,38 @@ var SDVXService2 = class _SDVXService {
     }
     return match[1];
   }
+  /**
+   * 验证猫网 PIN 码
+   * @param ctx - Koishi 上下文对象
+   * @param url - 猫网基础 URL
+   * @param cardId - 卡号
+   * @param pin - 四位数字 PIN
+   * @returns 验证是否通过
+   */
+  async verifyPin(ctx, url, cardId, pin) {
+    const baseURL = "https://maomani.cn";
+    const resp = await ctx.http.post(
+      "/api/login/account",
+      {
+        username: cardId,
+        password: pin
+      },
+      { baseURL }
+    );
+    return resp?.errorCode === 200;
+  }
+  async uploadScore(ctx, url, cardId, scorePayload) {
+    const baseURL = "https://maomani.cn";
+    const userName = await this.getUserName(ctx, url, cardId);
+    const resp = await ctx.http.post(
+      `/api/logs/upload?name=${encodeURIComponent(`${userName}`)}&pw=logs`,
+      scorePayload,
+      {
+        baseURL
+      }
+    );
+    return resp === "Logs-573sdvx-json-导入成功";
+  }
   async getAllScore(ctx, url, cardId, config) {
     try {
       const data = await ctx.http.get(`/sdvx/scores?card=${cardId}`, {
@@ -6149,11 +6357,19 @@ var SDVXService3 = class _SDVXService {
       const scoresData = response;
       const stringMusicTitles = [...new Set(scoresData.map((score) => score.title))];
       const musicService = MusicService.getInstance(config);
-      const musicDataList = await musicService.getMusic(ctx, stringMusicTitles);
+      const [musicDataList, titleMidPairs] = await Promise.all([
+        musicService.getMusic(ctx, stringMusicTitles),
+        musicService.extTitleToMid(ctx, stringMusicTitles)
+      ]);
+      const titleMidMap = new Map(
+        titleMidPairs.filter(({ mid }) => !!mid).map(({ title, mid }) => [title.toLowerCase(), mid])
+      );
       const musicDataMap = new Map(musicDataList.map((music) => [music.title_name, music]));
       const sdvxScores = [];
       for (const scoreData of scoresData) {
         const musicData = musicDataMap.get(scoreData.title);
+        const mappedMid = titleMidMap.get(scoreData.title.toLowerCase());
+        const musicId = mappedMid && /^\d+$/.test(mappedMid) ? Number(mappedMid) : scoreData.music_id;
         for (const [diffKey, diffScore] of Object.entries(scoreData.difficulties)) {
           const diffAbbr = diffKey.toUpperCase();
           const diffInfo = getDiffStringFromAbbr(diffAbbr);
@@ -6167,7 +6383,7 @@ var SDVXService3 = class _SDVXService {
           }
           const scoreObj = {
             music: {
-              music_id: scoreData.music_id,
+              music_id: musicId,
               music_diff: difficultyData?.difnum || 0,
               music_diff_name: getDiffName(diffStr, infVer),
               music_diff_full_name: getDiffFullName(diffStr, infVer),
@@ -6317,9 +6533,10 @@ function recent(ctx, config, logger6) {
     const serverService = new ServerService(ctx);
     const userCards = await cardService.getCardsByUid(session.user.id);
     if (userCards.length === 0) return session.text(".card-not-found");
-    const userRes = await serverService.getServersByUid(session.user.id);
-    const channelRes = atGuild ? await serverService.getServersByCid(session.channel.id) : [];
-    const serverRes = channelRes.concat(userRes);
+    const serverRes = await serverService.getSelectableServers(
+      session.user.id,
+      atGuild ? session.channel.id : null
+    );
     if (serverRes.length === 0) return session.text(".server-not-found");
     let cardCode = "";
     if (!options.card) {
@@ -6404,6 +6621,252 @@ function recent(ctx, config, logger6) {
 }
 __name(recent, "recent");
 
+// src/games/sdvx/commands/sync.ts
+function sync(ctx, config, logger6) {
+  ctx.command("sdvx.sync").userFields(["id"]).channelFields(["id"]).action(async ({ session }) => {
+    const serverService = new ServerService(ctx);
+    const cardService = new CardService(ctx);
+    const atGuild = session.guildId != null;
+    if (atGuild) return session.text(".dm-only");
+    const allServers = await serverService.getSelectableServers(
+      session.user.id,
+      atGuild ? session.channel.id : null
+    );
+    const maoServer = allServers.find((server2) => server2.type === "mao");
+    if (!maoServer) {
+      return session.text(".mao-not-found");
+    }
+    const sourceServers = allServers;
+    if (sourceServers.length === 0) {
+      return session.text(".source-server-not-found");
+    }
+    let serverListMsg = "";
+    for (let i = 0; i < sourceServers.length; i++) {
+      serverListMsg += `${i + 1}. ${sourceServers[i].name} (${sourceServers[i].type})
+`;
+    }
+    await session.send(
+      session.text(".source-server-select", { server_list: serverListMsg })
+    );
+    const serverSelect = await session.prompt();
+    if (!serverSelect) return session.text("commands.timeout");
+    if (serverSelect === "q") return session.text(".quit");
+    const serverIndex = Number(serverSelect);
+    if (!Number.isInteger(serverIndex) || serverIndex < 1 || serverIndex > sourceServers.length) {
+      return session.text(".invalid-select");
+    }
+    const sourceServer = sourceServers[serverIndex - 1];
+    const cards = await cardService.getCardsByUid(session.user.id);
+    if (cards.length === 0) return session.text(".card-not-found");
+    const defaultCard = await cardService.getDefaultCardByUid(session.user.id);
+    const defaultCardId = defaultCard ? defaultCard.id : 0;
+    let cardListMsg = "";
+    for (let i = 0; i < cards.length; i++) {
+      if (cards[i].id === defaultCardId) {
+        cardListMsg += `${i + 1}. ${cards[i].name} < 默认卡片
+`;
+      } else {
+        cardListMsg += `${i + 1}. ${cards[i].name}
+`;
+      }
+    }
+    await session.send(session.text(".source-card-select", { card_list: cardListMsg }));
+    const sourceCardSelect = await session.prompt();
+    if (!sourceCardSelect) return session.text("commands.timeout");
+    if (sourceCardSelect === "q") return session.text(".quit");
+    const sourceCardIndex = Number(sourceCardSelect);
+    if (!Number.isInteger(sourceCardIndex) || sourceCardIndex < 1 || sourceCardIndex > cards.length) {
+      return session.text(".invalid-select");
+    }
+    const sourceCard = cards[sourceCardIndex - 1];
+    await session.send(session.text(".target-card-select", { card_list: cardListMsg }));
+    const targetCardSelect = await session.prompt();
+    if (!targetCardSelect) return session.text("commands.timeout");
+    if (targetCardSelect === "q") return session.text(".quit");
+    const targetCardIndex = Number(targetCardSelect);
+    if (!Number.isInteger(targetCardIndex) || targetCardIndex < 1 || targetCardIndex > cards.length) {
+      return session.text(".invalid-select");
+    }
+    const targetCard = cards[targetCardIndex - 1];
+    if (sourceServer.type === "mao" && sourceCard.id === targetCard.id) {
+      return session.text(".same-card-error");
+    }
+    const maxPinAttempts = 3;
+    let pinVerified = false;
+    const serverManager = ServerManager.getInstance();
+    const maoSdvxService = serverManager.getGameService("mao", "sdvx");
+    const maoVerifyUrl = "https://maomani.cn";
+    if (!maoSdvxService || typeof maoSdvxService.verifyPin !== "function") {
+      logger6.warn("Mao SDVX service does not support PIN verification");
+      return session.text(".pin-verify-error");
+    }
+    const existingPin = await ctx.database.get("sdvx_pin_verified", {
+      uid: session.user.id,
+      cardId: targetCard.id,
+      sid: maoServer.id
+    });
+    if (existingPin.length > 0) {
+      const cachedPin = existingPin[0].pin;
+      try {
+        const ok = await maoSdvxService.verifyPin(
+          ctx,
+          maoVerifyUrl,
+          targetCard.code,
+          cachedPin
+        );
+        if (ok) {
+          pinVerified = true;
+        }
+      } catch (error) {
+        logger6.warn(error);
+      }
+    }
+    if (!pinVerified) {
+      for (let attempt = 0; attempt < maxPinAttempts; attempt++) {
+        await session.send(session.text(".pin-prompt"));
+        const pinInput = await session.prompt();
+        if (!pinInput) return session.text("commands.timeout");
+        if (pinInput === "q") return session.text(".quit");
+        if (!/^\d{4}$/.test(pinInput)) {
+          await session.send(session.text(".pin-invalid"));
+          continue;
+        }
+        try {
+          const ok = await maoSdvxService.verifyPin(
+            ctx,
+            maoVerifyUrl,
+            targetCard.code,
+            pinInput
+          );
+          if (ok) {
+            pinVerified = true;
+            await ctx.database.create("sdvx_pin_verified", {
+              uid: session.user.id,
+              cardId: targetCard.id,
+              sid: maoServer.id,
+              pin: pinInput
+            });
+            break;
+          }
+          await session.send(
+            session.text(".pin-verify-failed", {
+              message: ""
+            })
+          );
+        } catch (error) {
+          logger6.warn(error);
+          await session.send(session.text(".pin-verify-error"));
+        }
+      }
+      if (!pinVerified) return session.text(".pin-too-many");
+    }
+    const sourceSdvxService = serverManager.getGameService(
+      sourceServer.type,
+      "sdvx"
+    );
+    if (!sourceSdvxService || typeof sourceSdvxService.getAllScore !== "function") {
+      return session.text(".fetch-error");
+    }
+    let scoreList = [];
+    try {
+      scoreList = await sourceSdvxService.getAllScore(
+        ctx,
+        sourceServer.baseUrl,
+        sourceCard.code,
+        config
+      );
+    } catch (error) {
+      logger6.warn(error);
+      return session.text(".fetch-error");
+    }
+    if (!scoreList || scoreList.length === 0) {
+      return session.text(".no-scores");
+    }
+    const syncPayload = buildSyncPayload(scoreList);
+    await session.send(
+      session.text(".confirm-sync", {
+        score_count: syncPayload.length
+      })
+    );
+    const confirm = await session.prompt();
+    if (!confirm) return session.text("commands.timeout");
+    if (confirm.toLowerCase() !== "y") return session.text(".quit");
+    try {
+      const ok = await maoSdvxService.uploadScore(
+        ctx,
+        maoServer.baseUrl,
+        targetCard.code,
+        syncPayload
+      );
+      if (!ok) {
+        logger6.warn("Mao SDVX uploadScore returned falsy result");
+        return session.text(".sync-failed");
+      }
+    } catch (error) {
+      logger6.warn(error);
+      return session.text(".sync-error");
+    }
+    return session.text(".selected-summary", {
+      source_server_name: sourceServer.name,
+      source_server_type: sourceServer.type,
+      source_card_name: sourceCard.name,
+      target_card_name: targetCard.name,
+      score_count: syncPayload.length
+    });
+  });
+}
+__name(sync, "sync");
+function clearTypeToMark(clearType) {
+  switch (clearType) {
+    case "S-PUC":
+      return "spuc";
+    case "PUC":
+      return "puc";
+    case "UC":
+      return "uc";
+    case "MC":
+      return "mc";
+    case "HC":
+      return "hc";
+    case "NC":
+      return "nc";
+    case "PLAYED":
+      return "played";
+    case "NO PLAY":
+      return "noplay";
+    default:
+      return "noplay";
+  }
+}
+__name(clearTypeToMark, "clearTypeToMark");
+function buildSyncPayload(scoreList) {
+  const payloadMap = /* @__PURE__ */ new Map();
+  for (const score of scoreList) {
+    const musicIdRaw = String(score.music.music_id);
+    if (!/^\d+$/.test(musicIdRaw)) continue;
+    const musicId = musicIdRaw;
+    let diffName = score.music.music_diff_name;
+    if (!diffName) continue;
+    const upperDiff = diffName.toUpperCase();
+    if (["GRV", "HVN", "VVD", "XCD"].includes(upperDiff)) {
+      diffName = "INF";
+    } else {
+      diffName = upperDiff;
+    }
+    if (!payloadMap.has(musicId)) {
+      payloadMap.set(musicId, { music_id: musicId, difficulties: {} });
+    }
+    const entry = payloadMap.get(musicId);
+    entry.difficulties[diffName] = {
+      score: score.music.score,
+      mark: clearTypeToMark(score.music.clear_type),
+      grade: score.music.score_grade
+    };
+  }
+  return Array.from(payloadMap.values());
+}
+__name(buildSyncPayload, "buildSyncPayload");
+
 // src/games/sdvx/commands/vf.ts
 var fs4 = __toESM(require("fs"), 1);
 var import_koishi16 = require("koishi");
@@ -6545,9 +7008,10 @@ function vf(ctx, config, logger6) {
     const serverService = new ServerService(ctx);
     const userCards = await cardService.getCardsByUid(session.user.id);
     if (userCards.length === 0) return session.text(".card-not-found");
-    const userRes = await serverService.getServersByUid(session.user.id);
-    const channelRes = atGuild ? await serverService.getServersByCid(session.channel.id) : [];
-    const serverRes = channelRes.concat(userRes);
+    const serverRes = await serverService.getSelectableServers(
+      session.user.id,
+      atGuild ? session.channel.id : null
+    );
     if (serverRes.length === 0) return session.text(".server-not-found");
     let cardCode = "";
     if (!options.card) {
@@ -6685,6 +7149,7 @@ function apply12(ctx, config) {
   recent(ctx, config, logger5);
   chart(ctx, config, logger5);
   calculate(ctx, config, logger5);
+  sync(ctx, config, logger5);
 }
 __name(apply12, "apply");
 
@@ -6696,6 +7161,19 @@ __export(database_exports3, {
 });
 var name13 = "database";
 function apply13(ctx) {
+  ctx.model.extend(
+    "sdvx_pin_verified",
+    {
+      id: "unsigned",
+      uid: "unsigned",
+      cardId: "unsigned",
+      sid: "unsigned",
+      pin: "string"
+    },
+    {
+      autoInc: true
+    }
+  );
 }
 __name(apply13, "apply");
 
@@ -6711,10 +7189,10 @@ function apply14(ctx) {
 __name(apply14, "apply");
 
 // src/games/sdvx/locales/en-US.yml
-var en_US_default5 = { _config: { $desc: "SDVX Module Settings", default_model: "<p>Default model value (e.g. `2024110700`)</p>", sdvx_data_url: "<p>The URL of the SDVX data service</p>", sdvx_search_url: "<p>The URL of the SDVX search service</p>", official_support_url: "<p>The URL of the SDVX official support service</p>" }, commands: { vf: { description: "Show Noah help information", messages: { "card-not-found": "<p>You haven't bound a card yet, go bind a card first~</p>", "server-not-found": "<p>No available servers, add one yourself~</p>", "no-scores-found": "<p>No scores found, please check your data.</p>", error: "<p>An error occurred(っ °Д °;)っ</p>", drawing: "<p>Noah is drawing {name} [{difstr}], please wait patiently~</p>", "menu-select": "<p>Please select the card you want to use:</p>\n{card_list}\n<p>q. Exit</p>", "invalid-select": "<p>No such option!</p>", quit: "<p>Exited~</p>" } }, sdvx: { recent: { description: "Show recent scores", messages: { "card-not-found": "<p>You haven't bound a card yet, go bind a card first~</p>", "server-not-found": "<p>No available servers, add one yourself~</p>", "no-scores-found": "<p>No scores found, please check your data.</p>", error: "<p>An error occurred(っ °Д °;)っ</p>", drawing: "<p>Noah is drawing, please wait patiently~</p>" } }, chart: { description: "Show SDVX chart", messages: { prompt: "<p>Which song's chart would you like to view?</p>", error: "<p>An error occurred(っ °Д °;)っ</p>", drawing: "<p>Noah is drawing, please wait patiently~</p>", "no-result": "<p>Aww, Noah couldn’t find that song~ try another keyword, okay?</p>" } }, calculate: { description: "Calculate volforce value or score", messages: { "invalid-query": "<p>Invalid query parameters, please check your input~</p>", "no-results": "<p>No results found~</p>", "too-many-results": "<p>Too many results! Found {0} results, please narrow down your query (current limit: 500 results)</p>", drawing: "<p>Noah is drawing, please wait patiently~</p>", error: "<p>An error occurred(っ °Д °;)っ</p>" } } } } };
+var en_US_default5 = { _config: { $desc: "SDVX Module Settings", default_model: "<p>Default model value (e.g. `2024110700`)</p>", sdvx_data_url: "<p>The URL of the SDVX data service</p>", sdvx_search_url: "<p>The URL of the SDVX search service</p>", official_support_url: "<p>The URL of the SDVX official support service</p>" }, commands: { vf: { description: "Show Noah help information", messages: { "card-not-found": "<p>You haven't bound a card yet, go bind a card first~</p>", "server-not-found": "<p>No available servers, add one yourself~</p>", "no-scores-found": "<p>No scores found, please check your data.</p>", error: "<p>An error occurred(っ °Д °;)っ</p>", drawing: "<p>Noah is drawing {name} [{difstr}], please wait patiently~</p>", "menu-select": "<p>Please select the card you want to use:</p>\n{card_list}\n<p>q. Exit</p>", "invalid-select": "<p>No such option!</p>", quit: "<p>Exited~</p>" } }, sdvx: { recent: { description: "Show recent scores", messages: { "card-not-found": "<p>You haven't bound a card yet, go bind a card first~</p>", "server-not-found": "<p>No available servers, add one yourself~</p>", "no-scores-found": "<p>No scores found, please check your data.</p>", error: "<p>An error occurred(っ °Д °;)っ</p>", drawing: "<p>Noah is drawing, please wait patiently~</p>" } }, chart: { description: "Show SDVX chart", messages: { prompt: "<p>Which song's chart would you like to view?</p>", error: "<p>An error occurred(っ °Д °;)っ</p>", drawing: "<p>Noah is drawing, please wait patiently~</p>", "no-result": "<p>Aww, Noah couldn’t find that song~ try another keyword, okay?</p>" } }, calculate: { description: "Calculate volforce value or score", messages: { "invalid-query": "<p>Invalid query parameters, please check your input~</p>", "no-results": "<p>No results found~</p>", "too-many-results": "<p>Too many results! Found {0} results, please narrow down your query (current limit: 500 results)</p>", drawing: "<p>Noah is drawing, please wait patiently~</p>", error: "<p>An error occurred(っ °Д °;)っ</p>" } }, sync: { description: "Sync scores to Mao", messages: { "mao-not-found": "<p>Mao server not found. Please add a Mao server first, then try syncing again.</p>", "source-server-not-found": "<p>No available source servers. Please add a server first.</p>", "source-server-select": "<p>Please choose the source server:</p>\n{server_list}\n<p>q. Exit</p>", "card-not-found": "<p>You haven't bound any card yet. Please bind a card first.</p>", "source-card-select": "<p>Please choose the source card:</p>\n{card_list}\n<p>q. Exit</p>", "target-card-select": "<p>Please choose the target card (sync to Mao):</p>\n{card_list}\n<p>q. Exit</p>", "invalid-select": "<p>No such option!</p>", quit: "<p>Sync cancelled.</p>", "same-card-error": "<p>When the source server is Mao, the source card and target card cannot be the same. Please choose again.</p>", "dm-only": "<p>For security, please use this command in a private chat.</p>", "pin-prompt": "<p>Please enter the Mao PIN (4 digits):</p>\n<p>q. Exit</p>", "pin-invalid": "<p>Invalid PIN format. Please enter 4 digits.</p>", "pin-verify-failed": "<p>PIN verification failed: {message}</p>", "pin-verify-error": "<p>PIN verification error. Please try again later.</p>", "pin-too-many": "<p>Too many PIN attempts. Please try again later.</p>", "fetch-error": "<p>Failed to fetch scores from the source server. Please try again later.</p>", "no-scores": "<p>No scores available for sync.</p>", "confirm-sync": "<p>Found {score_count} scores. Start sync?</p>\n<p>Type y to confirm, any other key to cancel.</p>", "sync-error": "<p>Error occurred during sync(っ °Д °;)っ</p>", "sync-failed": "<p>Sync failed(っ °Д °;)っ</p>", "selected-summary": "<p>Sync completedヾ(≧▽≦*)o</p>\n<p>Source server: {source_server_name} ({source_server_type})</p>\n<p>Source card: {source_card_name}</p>\n<p>Target card: {target_card_name}</p>\n<p>Tracks synced: {score_count}</p>" } } } } };
 
 // src/games/sdvx/locales/zh-CN.yml
-var zh_CN_default5 = { _config: { $desc: "SDVX 模块设置", default_model: "<p>默认的 model 值（如 `2024110700`）</p>", sdvx_data_url: "<p>SDVX 数据服务的 URL</p>", sdvx_search_url: "<p>SDVX 搜索服务的 URL</p>", official_support_url: "<p>SDVX 官方支持服务的 URL</p>" }, commands: { vf: { description: "查询 SDVX VOLFORCE", messages: { "card-not-found": "<p>你还没绑卡，去绑个卡再来吧~</p>", "server-not-found": "<p>没有可用的服务器哦，自己添加一个吧~</p>", "no-scores-found": "<p>没有找到你的分数数据哦~</p>", error: "<p>Noah 遇到了错误(っ °Д °;)っ</p>", drawing: "<p>Noah 正在画啦，请耐心等待~</p>", "menu-select": "<p>请选择你要使用的卡片：</p>\n{card_list}\n<p>q. 退出</p>", "invalid-select": "<p>没有该选项！</p>", quit: "<p>已退出~</p>" } }, sdvx: { recent: { description: "查询最近分数", messages: { "card-not-found": "<p>你还没绑卡，去绑个卡再来吧~</p>", "server-not-found": "<p>没有可用的服务器哦，自己添加一个吧~</p>", "no-scores-found": "<p>没有找到你的分数数据哦~</p>", error: "<p>Noah 遇到了错误(っ °Д °;)っ</p>", drawing: "<p>Noah 正在画啦，请耐心等待~</p>" } }, chart: { description: "查询 SDVX 谱面", messages: { prompt: "<p>要查哪首歌的铺面呢？</p>", error: "<p>Noah 遇到了错误(っ °Д °;)っ</p>", drawing: "<p>Noah 正在绘制 {name} [{difstr}]，请耐心等待~</p>", "no-result": "<p>Noah 没有找到这首歌，换个关键词试试吧~</p>" } }, calculate: { description: "计算 volforce 值或分数", messages: { "invalid-query": "<p>查询参数无效，请检查你的输入~</p>", "no-results": "<p>没有找到符合条件的结果~</p>", "too-many-results": "<p>结果太多啦！共找到 {0} 条结果，请缩小查询范围（当前限制：500 条）</p>", drawing: "<p>Noah 正在画啦，请耐心等待~</p>", error: "<p>Noah 遇到了错误(っ °Д °;)っ</p>" } } } } };
+var zh_CN_default5 = { _config: { $desc: "SDVX 模块设置", default_model: "<p>默认的 model 值（如 `2024110700`）</p>", sdvx_data_url: "<p>SDVX 数据服务的 URL</p>", sdvx_search_url: "<p>SDVX 搜索服务的 URL</p>", official_support_url: "<p>SDVX 官方支持服务的 URL</p>" }, commands: { vf: { description: "查询 SDVX VOLFORCE", messages: { "card-not-found": "<p>你还没绑卡，去绑个卡再来吧~</p>", "server-not-found": "<p>没有可用的服务器哦，自己添加一个吧~</p>", "no-scores-found": "<p>没有找到你的分数数据哦~</p>", error: "<p>Noah 遇到了错误(っ °Д °;)っ</p>", drawing: "<p>Noah 正在画啦，请耐心等待~</p>", "menu-select": "<p>请选择你要使用的卡片：</p>\n{card_list}\n<p>q. 退出</p>", "invalid-select": "<p>没有该选项！</p>", quit: "<p>已退出~</p>" } }, sdvx: { recent: { description: "查询最近分数", messages: { "card-not-found": "<p>你还没绑卡，去绑个卡再来吧~</p>", "server-not-found": "<p>没有可用的服务器哦，自己添加一个吧~</p>", "no-scores-found": "<p>没有找到你的分数数据哦~</p>", error: "<p>Noah 遇到了错误(っ °Д °;)っ</p>", drawing: "<p>Noah 正在画啦，请耐心等待~</p>" } }, chart: { description: "查询 SDVX 谱面", messages: { prompt: "<p>要查哪首歌的铺面呢？</p>", error: "<p>Noah 遇到了错误(っ °Д °;)っ</p>", drawing: "<p>Noah 正在绘制 {name} [{difstr}]，请耐心等待~</p>", "no-result": "<p>Noah 没有找到这首歌，换个关键词试试吧~</p>" } }, calculate: { description: "计算 volforce 值或分数", messages: { "invalid-query": "<p>查询参数无效，请检查你的输入~</p>", "no-results": "<p>没有找到符合条件的结果~</p>", "too-many-results": "<p>结果太多啦！共找到 {0} 条结果，请缩小查询范围（当前限制：500 条）</p>", drawing: "<p>Noah 正在画啦，请耐心等待~</p>", error: "<p>Noah 遇到了错误(っ °Д °;)っ</p>" } }, sync: { description: "同步成绩到猫网", messages: { "mao-not-found": "<p>没有找到猫网服务器，请先添加猫网服务器后再尝试同步。</p>", "source-server-not-found": "<p>没有可作为来源的服务器，请先添加服务器。</p>", "source-server-select": "<p>请选择来源服务器：</p>\n{server_list}\n<p>q. 退出</p>", "card-not-found": "<p>你还没有绑定任何卡片哦~</p>", "source-card-select": "<p>请选择来源卡片：</p>\n{card_list}\n<p>q. 退出</p>", "target-card-select": "<p>请选择目标卡片（同步到猫网）：</p>\n{card_list}\n<p>q. 退出</p>", "invalid-select": "<p>没有该选项！</p>", quit: "<p>已退出同步。</p>", "same-card-error": "<p>来源服务器为猫网时，来源卡片和目标卡片不能相同，请重新选择。</p>", "dm-only": "<p>出于安全考虑，请在私聊中使用该指令。</p>", "pin-prompt": "<p>请输入猫网 PIN 码（4 位数字）：</p>\n<p>q. 退出</p>", "pin-invalid": "<p>PIN 码格式不正确，请输入 4 位数字。</p>", "pin-verify-failed": "<p>PIN 验证失败：{message}</p>", "pin-verify-error": "<p>PIN 验证时出现错误，请稍后重试。</p>", "pin-too-many": "<p>PIN 验证次数过多，请稍后再试。</p>", "fetch-error": "<p>获取来源服务器成绩失败，请稍后再试。</p>", "no-scores": "<p>没有可同步的成绩。</p>", "confirm-sync": "<p>共找到 {score_count} 条成绩，是否开始同步？</p>\n<p>输入 y 确认，其他任意键取消。</p>", "sync-error": "<p>同步过程中出现了错误(っ °Д °;)っ</p>", "sync-failed": "<p>同步失败(っ °Д °;)っ</p>", "selected-summary": "<p>同步完成ヾ(≧▽≦*)o</p>\n<p>来源服务器：{source_server_name} ({source_server_type})</p>\n<p>来源卡片：{source_card_name}</p>\n<p>目标卡片：{target_card_name}</p>\n<p>同步曲目数量：{score_count}</p>" } } } } };
 
 // src/games/sdvx/index.ts
 var name15 = "Noah-SDVX";

package/lib/servers/Mao/services/sdvx-service.d.ts

@@ -9,7 +9,7 @@ export declare class SDVXService implements ISDVXService {
     static getInstance(logger: Logger): SDVXService;
     /**
      * Get the difficulty string based on the difficulty type number
-     * @param diffType Difficulty type (0-4)
+     * @param diffType Difficulty type
      * @returns The difficulty string (novice, advanced, exhaust, infinite, maximum)
      */
     private getDifficultyString;
@@ -21,6 +21,23 @@ export declare class SDVXService implements ISDVXService {
      * @returns The player ID (e.g., "ED*")
      */
     getUserName(ctx: Context, url: string, cardId: string): Promise<string>;
+    /**
+     * 验证猫网 PIN 码
+     * @param ctx - Koishi 上下文对象
+     * @param url - 猫网基础 URL
+     * @param cardId - 卡号
+     * @param pin - 四位数字 PIN
+     * @returns 验证是否通过
+     */
+    verifyPin(ctx: Context, url: string, cardId: string, pin: string): Promise<boolean>;
+    uploadScore(ctx: Context, url: string, cardId: string, scorePayload: {
+        music_id: string;
+        difficulties: Record<string, {
+            score: number;
+            mark: string;
+            grade: string;
+        }>;
+    }[]): Promise<boolean>;
     getAllScore(ctx: Context, url: string, cardId: string, config: SDVXConfig): Promise<SDVXScore[]>;
     getScore(ctx: Context, url: string, cardId: string, musicId: number, config: SDVXConfig): Promise<SDVXScore>;
     getRecentScores(ctx: Context, url: string, cardId: string, config: SDVXConfig, count?: number): Promise<SDVXScore[]>;

package/lib/types/index.d.ts

@@ -62,6 +62,31 @@ export interface SDVXService extends GameService {
      * @returns 玩家 ID
      */
     getUserName(ctx: Context, url: string, cardId: string): Promise<string>;
+    /**
+     * 校验 PIN 码
+     * @param ctx - Koishi 上下文对象
+     * @param url - API 基础 URL
+     * @param cardId - 玩家卡片 ID
+     * @param pin - 四位数字 PIN
+     * @returns 是否验证通过
+     */
+    verifyPin?(ctx: Context, url: string, cardId: string, pin: string): Promise<boolean>;
+    /**
+     * 上传分数数据
+     * @param ctx - Koishi 上下文对象
+     * @param url - API 基础 URL
+     * @param cardId - 玩家卡片 ID
+     * @param scorePayload - 待上传的分数数据
+     * @returns 上传是否成功
+     */
+    uploadScore?(ctx: Context, url: string, cardId: string, scorePayload: {
+        music_id: string;
+        difficulties: Record<string, {
+            score: number;
+            mark: string;
+            grade: string;
+        }>;
+    }[]): Promise<boolean>;
 }
 /**
  * 服务器接口

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "koishi-plugin-noah",
-    "version": "1.8.2",
+    "version": "2.0.1",
     "contributors": [
         "Logthm <logthm@outlook.com>"
     ],
@@ -51,7 +51,7 @@
         "@ltxhhz/koishi-plugin-skia-canvas": "^0.0.8",
         "@types/adm-zip": "^0",
         "@types/xml2js": "^0",
-        "eslint": "^9.39.1",
+        "eslint": "^9.39.2",
         "eslint-config-prettier": "^10.1.8",
         "eslint-import-resolver-typescript": "^3.10.1",
         "eslint-plugin-prettier": "^5.5.4",