koishi-plugin-noah 1.6.2 → 1.7.1

package/lib/core/utils/card.d.ts

@@ -14,16 +14,16 @@ export declare function uidToKonamiId(uid: string): string;
  */
 export declare function konamiIdToUid(konamiId: string): string;
 /**
- * 判断给定的字符串是 UID、KONAMI ID 还是非法字符串
+ * 判断给定的字符串是 UID、KONAMI ID、Official ID 还是非法字符串
  * @param ctx - Koishi Context 对象
  * @param input - 待判断的字符串
- * @returns "uid" 表示 e-Amusement UID, "konamiid" 表示 KONAMI ID, "invalid" 表示非法字符串
+ * @returns "uid" 表示 e-Amusement UID, "konamiid" 表示 KONAMI ID, "access" 表示 Access Code, "official" 表示 Official Server ID (SV-xxxx-xxxx), "invalid" 表示非法字符串
  */
-export declare function classifyCardId(ctx: Context, input: string): 'uid' | 'konamiid' | 'access' | 'invalid';
+export declare function classifyCardId(ctx: Context, input: string): 'uid' | 'konamiid' | 'access' | 'official' | 'invalid';
 /**
  * 处理用户输入的卡号
  * @param input - 用户输入的卡号
- * @returns 删去空格的全大写字符串，并转换特殊字符(I→1, O/Q→0, V→U)
+ * @returns 删去空格的全大写字符串，并转换特殊字符(I→1, O/Q→0, V→U)，但SV卡号不做替换
  */
 export declare function processInputCardCode(input: string): string;
 /**

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

@@ -13,12 +13,18 @@ export declare class MusicService {
      */
     static getInstance(config: SDVXConfig): MusicService;
     /**
-     * 获取音乐信息
+     * 获取音乐信息（支持数字和字符串 ID）
      * @param ctx - Koishi 上下文对象
-     * @param musicIds - 音乐 ID 数组
+     * @param musicIds - 音乐 ID 数组（数字或字符串）
      * @returns 音乐信息数组
      */
-    getMusic(ctx: Context, musicIds: number[]): Promise<SDVXMusic[]>;
+    getMusic(ctx: Context, musicIds: (number | string)[]): Promise<SDVXMusic[]>;
+    /**
+     * 转换外部音乐数据到标准格式
+     * @param externalData - 外部音乐数据数组
+     * @returns 标准格式音乐数据数组
+     */
+    private convertExternalToStandard;
     /**
      * 根据曲名查询歌曲
      * @param ctx - Koishi 上下文对象

package/lib/games/sdvx/types/index.d.ts

@@ -8,7 +8,7 @@ export interface SDVXProfile {
  */
 export interface SDVXScore {
     music: {
-        music_id: number;
+        music_id: number | string;
         music_diff: number;
         music_diff_name: string;
         music_diff_full_name: string;
@@ -42,20 +42,20 @@ export type SDVXClearType = 'S-PUC' | 'PUC' | 'UC' | 'MC' | 'HC' | 'NC' | 'PLAYE
 export interface SDVXMusicDifficulty {
     difstr: string;
     difnum: number;
-    raw_illustrator: string;
-    illustrator: string;
-    raw_effected_by: string;
-    effected_by: string;
-    price: number;
-    limited: number;
-    jacket_print: number;
-    jacket_mask: number;
-    max_exscore: number;
-    max_chain: number;
-    chip_count: number;
-    hold_count: number;
-    tsumami_count: number;
-    radar: {
+    raw_illustrator?: string;
+    illustrator?: string;
+    raw_effected_by?: string;
+    effected_by?: string;
+    price?: number;
+    limited?: number;
+    jacket_print?: number;
+    jacket_mask?: number;
+    max_exscore?: number;
+    max_chain?: number;
+    chip_count?: number;
+    hold_count?: number;
+    tsumami_count?: number;
+    radar?: {
         notes: number;
         peak: number;
         tsumami: number;
@@ -63,38 +63,40 @@ export interface SDVXMusicDifficulty {
         hand_trip: number;
         one_hand: number;
     };
-    big_cover_url: string;
+    big_cover_url?: string;
     cover_url: string;
-    chart_url: string;
-    mirror_chart_url: string;
+    chart_url?: string;
+    mirror_chart_url?: string;
+    inf_ver?: number;
 }
 /**
  * SDVX 音乐数据接口
  */
 export interface SDVXMusic {
-    id: number;
-    label: string;
-    raw_title_name: string;
+    id: number | string;
+    label?: string;
+    raw_title_name?: string;
     title_name: string;
-    main_title_name: string;
-    sub_title_name: string;
-    title_yomigana: string;
-    title_romaji: string;
-    raw_artist_name: string;
+    main_title_name?: string;
+    sub_title_name?: string;
+    title_yomigana?: string;
+    title_romaji?: string;
+    raw_artist_name?: string;
     artist_name: string;
-    artist_yomigana: string;
-    artist_romaji: string;
-    ascii: string;
-    bpm_max: string;
-    bpm_min: string;
-    distribution_date: string;
-    volume: number;
-    bg_no: number;
-    genre: number;
-    genre_name: string;
-    is_fixed: number;
-    version: number;
-    demo_pri: number;
-    inf_ver: number;
+    artist_yomigana?: string;
+    artist_romaji?: string;
+    ascii?: string;
+    bpm_max?: string;
+    bpm_min?: string;
+    distribution_date?: string;
+    volume?: number;
+    bg_no?: number;
+    genre?: number;
+    genre_name?: string;
+    is_fixed?: number;
+    version?: number;
+    demo_pri?: number;
+    inf_ver?: number;
     difficulty: SDVXMusicDifficulty[];
+    source_url?: string;
 }

package/lib/index.cjs

@@ -676,6 +676,10 @@ function konamiIdToUid(konamiId) {
 }
 __name(konamiIdToUid, "konamiIdToUid");
 function classifyCardId(ctx, input) {
+  const officialRegex = /^SV-\d{4}-\d{4}$/i;
+  if (officialRegex.test(input)) {
+    return "official";
+  }
   if (input.length === 20) {
     try {
       accessToUid(ctx, input);
@@ -709,7 +713,11 @@ function classifyCardId(ctx, input) {
 }
 __name(classifyCardId, "classifyCardId");
 function processInputCardCode(input) {
-  return input.replaceAll(" ", "").toUpperCase().replace(/[IOQV]/gi, (match) => {
+  const trimmed = input.replaceAll(" ", "").toUpperCase();
+  if (/^SV-\d{4}-\d{4}$/i.test(trimmed)) {
+    return trimmed;
+  }
+  return trimmed.replace(/[IOQV]/gi, (match) => {
     switch (match.toUpperCase()) {
       case "I":
         return "1";
@@ -798,7 +806,8 @@ function bind(ctx, config) {
       if (!cardCode) return session.text("commands.timeout");
     }
     cardCode = processInputCardCode(cardCode);
-    switch (classifyCardId(ctx, cardCode)) {
+    const cardType = classifyCardId(ctx, cardCode);
+    switch (cardType) {
       case "invalid":
         return session.text(".invalid-code");
       case "access":
@@ -807,6 +816,8 @@ function bind(ctx, config) {
       case "konamiid":
         cardCode = konamiIdToUid(cardCode);
         break;
+      case "official":
+        break;
     }
     if (await cardService.getCardByCode(cardCode) != null)
       return session.text(".duplicate");
@@ -1136,7 +1147,8 @@ async function showCardMenu(ctx, session, card2, cardService, serverService, use
       );
     if (cardCode === "q") return session.text(".quit");
     cardCode = processInputCardCode(cardCode);
-    switch (classifyCardId(ctx, cardCode)) {
+    const cardType = classifyCardId(ctx, cardCode);
+    switch (cardType) {
       case "invalid":
         return session.text(".menu-2-error-invalid-code");
       case "access":
@@ -1144,6 +1156,9 @@ async function showCardMenu(ctx, session, card2, cardService, serverService, use
         break;
       case "konamiid":
         cardCode = konamiIdToUid(cardCode);
+        break;
+      case "official":
+        break;
     }
     if (await cardService.getCardByCode(cardCode) != null) return session.text(".duplicate");
     await cardService.updateCard(card2.id, { code: cardCode });
@@ -1314,7 +1329,7 @@ __name(maintain, "maintain");
 var import_koishi3 = require("koishi");
 
 // src/types/index.ts
-var serverValues = ["asphyxia", "mao"];
+var serverValues = ["asphyxia", "mao", "official"];
 
 // src/core/commands/server.ts
 function normalizeUrl(url) {
@@ -1613,6 +1628,8 @@ async function addServer(ctx, session, serverService, userService, from, uid, us
   let url;
   if (serverType === "mao") {
     url = ctx.config.maoServerUrl;
+  } else if (serverType === "official") {
+    url = ctx.config.sdvx.official_support_url;
   } else {
     let attempts = 0;
     const maxAttempts = 3;
@@ -1923,10 +1940,10 @@ function apply4(ctx, config) {
 __name(apply4, "apply");
 
 // src/core/locales/en-US.yml
-var en_US_default2 = { _config: { $desc: "Core Module Settings", adminUsers: "**Plugin Admin** User ID (use inspect command to get)", guildNameCards: "**Group Card** Name List" }, 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>\n<a>https://docs.logthm.cn/noah</a>" } } }, 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>", duplicate: "<p>This card has already been bound （︶^︶）</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_default2 = { _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>\n<a>https://docs.logthm.cn/noah</a>" } } }, 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>", duplicate: "<p>This card has already been bound （︶^︶）</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_default2 = { _config: { $desc: "Core 模块设置", adminUsers: "**插件管理员** 的用户id (使用 inspect 指令获取)", guildNameCards: "**群聊卡片** 的名称列表" }, 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>\n<a>https://docs.logthm.cn/noah</a>" } } }, 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>", duplicate: "<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_default2 = { _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>\n<a>https://docs.logthm.cn/noah</a>" } } }, 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>", duplicate: "<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 name5 = "Noah-Core";
@@ -3377,7 +3394,7 @@ __export(sdvx_exports, {
   logger: () => logger4,
   name: () => name13
 });
-var import_koishi15 = require("koishi");
+var import_koishi16 = require("koishi");
 
 // src/games/sdvx/command.ts
 var command_exports2 = {};
@@ -4100,23 +4117,64 @@ var MusicService = class _MusicService {
     return _MusicService.instance;
   }
   /**
-   * 获取音乐信息
+   * 获取音乐信息（支持数字和字符串 ID）
    * @param ctx - Koishi 上下文对象
-   * @param musicIds - 音乐 ID 数组
+   * @param musicIds - 音乐 ID 数组（数字或字符串）
    * @returns 音乐信息数组
    */
   async getMusic(ctx, musicIds) {
-    const response = await ctx.http.post(
-      `/music`,
-      {
-        ids: musicIds
-      },
-      {
-        baseURL: this.sdvx_data_url
+    const numericIds = musicIds.filter((id) => typeof id === "number");
+    const stringTitles = musicIds.filter((id) => typeof id === "string");
+    const results = [];
+    if (numericIds.length > 0) {
+      try {
+        const response = await ctx.http.post(
+          `/music`,
+          { ids: numericIds },
+          { baseURL: this.sdvx_data_url }
+        );
+        results.push(...response);
+      } catch (error) {
+        console.warn("Failed to fetch music data for numeric IDs:", error);
       }
-    );
-    const musicInfo = await response;
-    return musicInfo;
+    }
+    if (stringTitles.length > 0) {
+      try {
+        const response = await ctx.http.post(
+          `/external/music`,
+          { titles: stringTitles },
+          { baseURL: this.sdvx_data_url }
+        );
+        const converted = this.convertExternalToStandard(response);
+        results.push(...converted);
+      } catch (error) {
+        console.warn("Failed to fetch music data for string IDs:", error);
+      }
+    }
+    return results;
+  }
+  /**
+   * 转换外部音乐数据到标准格式
+   * @param externalData - 外部音乐数据数组
+   * @returns 标准格式音乐数据数组
+   */
+  convertExternalToStandard(externalData) {
+    return externalData.map((data) => ({
+      id: data.slug,
+      title_name: data.ext_title_name,
+      artist_name: data.ext_artist_name,
+      genre: data.genre,
+      genre_name: data.genre_name,
+      inf_ver: data.difficulty[0]?.inf_ver || 0,
+      difficulty: data.difficulty.map((diff) => ({
+        difstr: diff.difstr,
+        difnum: diff.difnum,
+        illustrator: diff.ext_illustrator,
+        effected_by: diff.ext_effected_by,
+        cover_url: diff.cover_url,
+        inf_ver: diff.inf_ver
+      }))
+    }));
   }
   /**
    * 根据曲名查询歌曲
@@ -4348,7 +4406,7 @@ function chart(ctx, config, logger5) {
 __name(chart, "chart");
 
 // src/games/sdvx/commands/recent.ts
-var import_koishi13 = require("koishi");
+var import_koishi14 = require("koishi");
 
 // src/servers/index.ts
 var servers_exports = {};
@@ -4866,6 +4924,156 @@ var Mao = class {
   }
 };
 
+// src/servers/Official/index.ts
+var import_koishi13 = require("koishi");
+
+// src/servers/Official/services/sdvx-service.ts
+var SDVXService3 = class _SDVXService {
+  static {
+    __name(this, "SDVXService");
+  }
+  static instance;
+  logger;
+  constructor(logger5) {
+    this.logger = logger5;
+  }
+  static getInstance(logger5) {
+    if (!_SDVXService.instance) {
+      _SDVXService.instance = new _SDVXService(logger5);
+    }
+    return _SDVXService.instance;
+  }
+  /**
+   * 映射难度缩写到完整名称
+   */
+  getDifficultyString(diffShort) {
+    const diffMap = {
+      NOV: "novice",
+      ADV: "advanced",
+      EXH: "exhaust",
+      INF: "infinite",
+      MXM: "maximum"
+    };
+    return diffMap[diffShort.toUpperCase()] || diffShort.toLowerCase();
+  }
+  /**
+   * 映射 mark 到 SDVXClearType
+   */
+  mapClearType(mark) {
+    const markMap = {
+      "s-puc": "S-PUC",
+      spuc: "S-PUC",
+      puc: "PUC",
+      uc: "UC",
+      mc: "MC",
+      hc: "HC",
+      nc: "NC",
+      none: "PLAYED"
+    };
+    return markMap[mark.toLowerCase()] || "PLAYED";
+  }
+  /**
+   * Get the user name/ID from the server response
+   * @param ctx Context object
+   * @param url Base Official Support URL for the API
+   * @param player_id Player ID of the player (SV-xxxx-xxxx format)
+   * @returns The player name
+   */
+  async getUserName(ctx, url, player_id) {
+    const response = await ctx.http.get(`/api/sdvx/profile?id=${player_id}`, {
+      baseURL: url,
+      responseType: "json"
+    });
+    return response.player_name || player_id;
+  }
+  async getAllScore(ctx, url, player_id, config) {
+    try {
+      const response = await ctx.http.get(`/api/sdvx/scores?id=${player_id}`, {
+        baseURL: url,
+        responseType: "json"
+      });
+      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 musicDataMap = new Map(musicDataList.map((music) => [music.title_name, music]));
+      const sdvxScores = [];
+      for (const scoreData of scoresData) {
+        const musicData = musicDataMap.get(scoreData.title);
+        const infVer = musicData?.inf_ver || 0;
+        for (const [diffKey, diffScore] of Object.entries(scoreData.difficulties)) {
+          const diffStr = this.getDifficultyString(diffKey);
+          let difficultyData = null;
+          if (musicData && musicData.difficulty) {
+            difficultyData = musicData.difficulty.find(
+              (d) => d.difstr.toLowerCase() === diffStr.toLowerCase()
+            ) || null;
+          }
+          const scoreObj = {
+            music: {
+              music_id: scoreData.music_id,
+              music_diff: difficultyData?.difnum || 0,
+              music_diff_name: getDiffName(diffStr, infVer),
+              music_diff_full_name: getDiffFullName(diffStr, infVer),
+              score: diffScore.score,
+              exscore: 0,
+              // Official 服务器不提供
+              clear_type: this.mapClearType(diffScore.mark),
+              score_grade: diffScore.grade,
+              btn_rate: "0",
+              long_rate: "0",
+              vol_rate: "0"
+            },
+            extra: {
+              volforce: 0,
+              play_count: 0,
+              update_at: ""
+            },
+            music_data: musicData || null,
+            difficulty_data: difficultyData || null
+          };
+          scoreObj.extra.volforce = calculateVolforce(scoreObj);
+          sdvxScores.push(scoreObj);
+        }
+      }
+      return sdvxScores;
+    } catch (error) {
+      if (error.response?.status === 404) {
+        return [];
+      }
+      throw error;
+    }
+  }
+  async getScore(ctx, url, player_id, musicId, config) {
+    const allScores = await this.getAllScore(ctx, url, player_id, config);
+    const score = allScores.find((s) => s.music.music_id === musicId);
+    if (!score) {
+      throw new Error(`Score not found for music ID: ${musicId}`);
+    }
+    return score;
+  }
+  async getRecentScores(ctx, url, player_id, config, count = 1) {
+    return [];
+  }
+};
+
+// src/servers/Official/index.ts
+var Official = class {
+  static {
+    __name(this, "Official");
+  }
+  name = "official";
+  supportedGames = ["sdvx"];
+  gameServices = {};
+  logger = new import_koishi13.Logger("Noah-Official");
+  /**
+   * 初始化SDVX游戏服务实例
+   */
+  constructor() {
+    this.gameServices["sdvx"] = SDVXService3.getInstance(this.logger);
+  }
+};
+
 // src/servers/ServerFactory.ts
 var ServerFactory = class {
   static {
@@ -4888,6 +5096,9 @@ var ServerFactory = class {
         case "mao":
           serverInstance = new Mao();
           break;
+        case "official":
+          serverInstance = new Official();
+          break;
         default:
           throw new Error(`Unsupported server type: ${serverType}`);
       }
@@ -4969,7 +5180,7 @@ function recent(ctx, config, logger5) {
           cardListMsg += `<p>${i + 1}. ${userCards[i].name}</p>`;
         }
       }
-      const msg = import_koishi13.h.unescape(session.text(".menu-select", { card_list: cardListMsg })).replace("< 默认卡片", "&lt; 默认卡片");
+      const msg = import_koishi14.h.unescape(session.text(".menu-select", { card_list: cardListMsg })).replace("< 默认卡片", "&lt; 默认卡片");
       await session.send(msg);
       const select = await session.prompt();
       if (!select) return session.text("commands.timeout");
@@ -5026,9 +5237,9 @@ function recent(ctx, config, logger5) {
         }
       );
       if (options.lossless) {
-        return import_koishi13.h.image(imageBuffer, "image/png");
+        return import_koishi14.h.image(imageBuffer, "image/png");
       }
-      return import_koishi13.h.image(imageBuffer, "image/jpg");
+      return import_koishi14.h.image(imageBuffer, "image/jpg");
     } catch (error) {
       logger5.warn(error);
       return session.text(".error");
@@ -5039,7 +5250,7 @@ __name(recent, "recent");
 
 // src/games/sdvx/commands/vf.ts
 var fs4 = __toESM(require("fs"), 1);
-var import_koishi14 = require("koishi");
+var import_koishi15 = require("koishi");
 
 // src/games/sdvx/services/score-service.ts
 var ScoreService = class _ScoreService {
@@ -5197,7 +5408,7 @@ function vf(ctx, config, logger5) {
           cardListMsg += `<p>${i + 1}. ${userCards[i].name}</p>`;
         }
       }
-      const msg = import_koishi14.h.unescape(session.text(".menu-select", { card_list: cardListMsg })).replace("< 默认卡片", "&lt; 默认卡片");
+      const msg = import_koishi15.h.unescape(session.text(".menu-select", { card_list: cardListMsg })).replace("< 默认卡片", "&lt; 默认卡片");
       await session.send(msg);
       const select = await session.prompt();
       if (!select) return session.text("commands.timeout");
@@ -5260,14 +5471,13 @@ function vf(ctx, config, logger5) {
         }
       );
       if (options.lossless) {
-        session.send(import_koishi14.h.file(imageBuffer, "image/png"));
+        session.send(import_koishi15.h.file(imageBuffer, "image/png"));
       } else {
-        session.send(import_koishi14.h.image(imageBuffer, "image/jpg"));
+        session.send(import_koishi15.h.image(imageBuffer, "image/jpg"));
       }
       const sortedScores = [...best50ScoreList].sort((a, b) => b.extra.volforce - a.extra.volforce).slice(0, 50);
       const total = sortedScores.reduce((sum, score) => sum + score.extra.volforce, 0);
       const totalVolforce = Math.round(total / 50 * 1e3) / 1e3;
-      console.log(totalVolforce);
       if (totalVolforce >= 20) {
         try {
           await new Promise((resolve3) => setTimeout(resolve3, 2e3));
@@ -5281,11 +5491,11 @@ function vf(ctx, config, logger5) {
           );
           if (fs4.existsSync(audioPath)) {
             const audioBuffer = fs4.readFileSync(audioPath);
-            session.send(import_koishi14.h.audio(audioBuffer, "audio/mpeg"));
+            session.send(import_koishi15.h.audio(audioBuffer, "audio/mpeg"));
           }
           if (fs4.existsSync(imagePath)) {
             const imageBuffer2 = fs4.readFileSync(imagePath);
-            session.send(import_koishi14.h.image(imageBuffer2, "image/png"));
+            session.send(import_koishi15.h.image(imageBuffer2, "image/png"));
           }
         } catch (error) {
           logger5.warn(`Failed to send celebration files: ${error.message}`);
@@ -5334,15 +5544,15 @@ function apply12(ctx) {
 __name(apply12, "apply");
 
 // src/games/sdvx/locales/en-US.yml
-var en_US_default4 = { _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>" }, 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_default4 = { _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>" } } } } };
 
 // src/games/sdvx/locales/zh-CN.yml
-var zh_CN_default4 = { _config: { $desc: "SDVX 模块设置", default_model: "<p>默认的 model 值（如 `2024110700`）</p>", sdvx_data_url: "<p>SDVX 数据服务的 URL</p>", sdvx_search_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_default4 = { _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>" } } } } };
 
 // src/games/sdvx/index.ts
 var name13 = "Noah-SDVX";
 var inject2 = ["database"];
-var logger4 = new import_koishi15.Logger("Noah-SDVX");
+var logger4 = new import_koishi16.Logger("Noah-SDVX");
 async function apply13(ctx, config) {
   ;
   [
@@ -5356,48 +5566,49 @@ async function apply13(ctx, config) {
 __name(apply13, "apply");
 
 // src/config.ts
-var import_koishi21 = require("koishi");
+var import_koishi22 = require("koishi");
 
 // src/asset/config.ts
-var import_koishi16 = require("koishi");
-var assetConfig = import_koishi16.Schema.object({
-  data_path: import_koishi16.Schema.string().default("noah_assets"),
-  auto_update: import_koishi16.Schema.boolean().default(true),
-  update_url: import_koishi16.Schema.string().default("https://github.com/logthm/noah/releases/latest/download/"),
-  update_interval: import_koishi16.Schema.number().default(24 * 60 * 60 * 1e3),
+var import_koishi17 = require("koishi");
+var assetConfig = import_koishi17.Schema.object({
+  data_path: import_koishi17.Schema.string().default("noah_assets"),
+  auto_update: import_koishi17.Schema.boolean().default(true),
+  update_url: import_koishi17.Schema.string().default("https://github.com/logthm/noah/releases/latest/download/"),
+  update_interval: import_koishi17.Schema.number().default(24 * 60 * 60 * 1e3),
   // 24 hours in milliseconds
-  github_token: import_koishi16.Schema.string().description("GitHub token for accessing private repositories").role("secret")
+  github_token: import_koishi17.Schema.string().description("GitHub token for accessing private repositories").role("secret")
 }).i18n({
   "en-US": en_US_default._config,
   "zh-CN": zh_CN_default._config
 });
 
 // src/core/config.ts
-var import_koishi17 = require("koishi");
-var coreConfig = import_koishi17.Schema.object({
-  adminUsers: import_koishi17.Schema.array(String).role("table"),
-  guildNameCards: import_koishi17.Schema.array(String).role("table").default(["Noah  |  /help 获取食用指南"]),
-  maoServerUrl: import_koishi17.Schema.string().default("http://maomani.cn:573")
+var import_koishi18 = require("koishi");
+var coreConfig = import_koishi18.Schema.object({
+  adminUsers: import_koishi18.Schema.array(String).role("table"),
+  guildNameCards: import_koishi18.Schema.array(String).role("table").default(["Noah  |  /help 获取食用指南"]),
+  maoServerUrl: import_koishi18.Schema.string().default("http://maomani.cn:573"),
+  official_support_url: import_koishi18.Schema.string().default("https://noah.logthm.com")
 }).i18n({
   "en-US": en_US_default2._config,
   "zh-CN": zh_CN_default2._config
 });
 
 // src/fun/poke/config.ts
-var import_koishi18 = require("koishi");
-var pokeConfig = import_koishi18.Schema.object({
-  interval: import_koishi18.Schema.number().default(1e3).step(100),
-  warning: import_koishi18.Schema.boolean().default(false),
-  prompt: import_koishi18.Schema.array(
-    import_koishi18.Schema.object({
-      content: import_koishi18.Schema.string().required(),
-      weight: import_koishi18.Schema.number().min(0).max(100).default(50)
+var import_koishi19 = require("koishi");
+var pokeConfig = import_koishi19.Schema.object({
+  interval: import_koishi19.Schema.number().default(1e3).step(100),
+  warning: import_koishi19.Schema.boolean().default(false),
+  prompt: import_koishi19.Schema.array(
+    import_koishi19.Schema.object({
+      content: import_koishi19.Schema.string().required(),
+      weight: import_koishi19.Schema.number().min(0).max(100).default(50)
     })
   ).role("table"),
-  messages: import_koishi18.Schema.array(
-    import_koishi18.Schema.object({
-      content: import_koishi18.Schema.string().required(),
-      weight: import_koishi18.Schema.number().min(0).max(100).default(50)
+  messages: import_koishi19.Schema.array(
+    import_koishi19.Schema.object({
+      content: import_koishi19.Schema.string().required(),
+      weight: import_koishi19.Schema.number().min(0).max(100).default(50)
     })
   ).role("table")
 }).i18n({
@@ -5406,7 +5617,7 @@ var pokeConfig = import_koishi18.Schema.object({
 });
 
 // src/games/general/config.ts
-var import_koishi19 = require("koishi");
+var import_koishi20 = require("koishi");
 
 // src/games/general/locales/en-US.yml
 var en_US_default5 = { _config: { $desc: "General Module Settings", barcode_api_url: "<p>The URL of the barcode API</p>" } };
@@ -5415,26 +5626,27 @@ var en_US_default5 = { _config: { $desc: "General Module Settings", barcode_api_
 var zh_CN_default5 = { _config: { $desc: "通用工具模块设置", barcode_api_url: "<p>条形码 API 地址</p>" } };
 
 // src/games/general/config.ts
-var generalConfig = import_koishi19.Schema.object({
-  barcode_api_url: import_koishi19.Schema.string().required()
+var generalConfig = import_koishi20.Schema.object({
+  barcode_api_url: import_koishi20.Schema.string().required()
 }).i18n({
   "en-US": en_US_default5._config,
   "zh-CN": zh_CN_default5._config
 });
 
 // src/games/sdvx/config.ts
-var import_koishi20 = require("koishi");
-var sdvxConfig = import_koishi20.Schema.object({
-  default_model: import_koishi20.Schema.string().default("2024110700"),
-  sdvx_data_url: import_koishi20.Schema.string().required(),
-  sdvx_search_url: import_koishi20.Schema.string().required()
+var import_koishi21 = require("koishi");
+var sdvxConfig = import_koishi21.Schema.object({
+  default_model: import_koishi21.Schema.string().default("2025100700"),
+  sdvx_data_url: import_koishi21.Schema.string().required(),
+  sdvx_search_url: import_koishi21.Schema.string().required(),
+  official_support_url: import_koishi21.Schema.string().required()
 }).i18n({
   "en-US": en_US_default4._config,
   "zh-CN": zh_CN_default4._config
 });
 
 // src/config.ts
-var Config = import_koishi21.Schema.object({
+var Config = import_koishi22.Schema.object({
   core: coreConfig,
   sdvx: sdvxConfig,
   poke: pokeConfig,

package/lib/servers/Official/index.d.ts

@@ -0,0 +1,14 @@
+import { Logger } from 'koishi';
+import { IServer, TGame, TServer, GameService } from '../../types';
+export declare class Official implements IServer {
+    name: TServer;
+    supportedGames: TGame[];
+    gameServices: {
+        [key in TGame]?: GameService;
+    };
+    logger: Logger;
+    /**
+     * 初始化SDVX游戏服务实例
+     */
+    constructor();
+}

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

@@ -0,0 +1,29 @@
+import { Context, Logger } from 'koishi';
+import { SDVXScore } from '../../../games/sdvx/types';
+import { SDVXService as ISDVXService } from '../../../types';
+import { SDVXConfig } from '../../../types/config';
+export declare class SDVXService implements ISDVXService {
+    private static instance;
+    logger: Logger;
+    private constructor();
+    static getInstance(logger: Logger): SDVXService;
+    /**
+     * 映射难度缩写到完整名称
+     */
+    private getDifficultyString;
+    /**
+     * 映射 mark 到 SDVXClearType
+     */
+    private mapClearType;
+    /**
+     * Get the user name/ID from the server response
+     * @param ctx Context object
+     * @param url Base Official Support URL for the API
+     * @param player_id Player ID of the player (SV-xxxx-xxxx format)
+     * @returns The player name
+     */
+    getUserName(ctx: Context, url: string, player_id: string): Promise<string>;
+    getAllScore(ctx: Context, url: string, player_id: string, config: SDVXConfig): Promise<SDVXScore[]>;
+    getScore(ctx: Context, url: string, player_id: string, musicId: number, config: SDVXConfig): Promise<SDVXScore>;
+    getRecentScores(ctx: Context, url: string, player_id: string, config: SDVXConfig, count?: number): Promise<SDVXScore[]>;
+}

package/lib/types/config.d.ts

@@ -16,6 +16,8 @@ export interface CoreConfig extends BaseConfig {
     guildNameCards?: string[];
     /** 猫网服务器 URL */
     maoServerUrl?: string;
+    /** Official Support URL */
+    official_support_url?: string;
 }
 /**
  * SDVX 游戏配置接口
@@ -28,6 +30,8 @@ export interface SDVXConfig extends BaseConfig {
     sdvx_data_url: string;
     /** SDVX 搜索 URL */
     sdvx_search_url: string;
+    /** Official Support URL */
+    official_support_url: string;
 }
 /**
  * 戳一戳功能配置接口

package/lib/types/index.d.ts

@@ -2,7 +2,7 @@ import { Context, Logger } from 'koishi';
 import { SDVXScore } from '../games/sdvx/types';
 import { SDVXConfig } from './config';
 /** 服务器类型 */
-export type TServer = 'asphyxia' | 'mao';
+export type TServer = 'asphyxia' | 'mao' | 'official';
 /** 服务器类型可选值列表 */
 export declare const serverValues: TServer[];
 /** 游戏类型 */
@@ -23,10 +23,10 @@ export interface GameService {
  */
 export interface SDVXService extends GameService {
     /**
-     * 获取指定卡牌的所有分数记录
+     * 获取指定卡片的所有分数记录
      * @param ctx - Koishi 上下文对象
      * @param url - SDVX 服务的基础 URL
-     * @param cardId - 玩家卡牌 ID
+     * @param cardId - 玩家卡片 ID
      * @param config - SDVX 配置设置
      * @returns Promise 解析为 SDVX 分数记录数组
      * @throws 当获取操作失败时抛出错误
@@ -36,7 +36,7 @@ export interface SDVXService extends GameService {
      * 获取指定音乐 ID 的分数记录
      * @param ctx - Koishi 上下文对象
      * @param url - SDVX 服务的基础 URL
-     * @param cardId - 玩家卡牌 ID
+     * @param cardId - 玩家卡片 ID
      * @param musicId - 音乐曲目 ID
      * @param config - SDVX 配置设置
      * @returns Promise 解析为单个 SDVX 分数记录
@@ -44,10 +44,10 @@ export interface SDVXService extends GameService {
      */
     getScore(ctx: Context, url: string, cardId: string, musicId: number, config: SDVXConfig): Promise<SDVXScore>;
     /**
-     * 获取卡牌的最近分数记录
+     * 获取卡片的最近分数记录
      * @param ctx - Koishi 上下文对象
      * @param url - SDVX 服务的基础 URL
-     * @param cardId - 玩家卡牌 ID
+     * @param cardId - 玩家卡片 ID
      * @param config - SDVX 配置设置（可选）
      * @param count - 要获取的最近分数记录数量（可选，默认为 1）
      * @returns Promise 解析为最近 SDVX 分数记录数组
@@ -58,7 +58,7 @@ export interface SDVXService extends GameService {
      * 从服务器响应中获取用户名/ID
      * @param ctx - Koishi 上下文对象
      * @param url - API 的基础 URL
-     * @param cardId - 玩家卡牌 ID
+     * @param cardId - 玩家卡片 ID
      * @returns 玩家 ID
      */
     getUserName(ctx: Context, url: string, cardId: string): Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "koishi-plugin-noah",
-    "version": "1.6.2",
+    "version": "1.7.1",
     "contributors": [
         "Logthm <logthm@outlook.com>"
     ],