@zhin.js/plugin-music 1.1.15 → 1.1.17

package/commands/cookie/delete/[source]/index.js

@@ -1,23 +1,24 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t, sourceName, usage } from "../../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { musicRuntimeToken } from "../../../../lib/runtime.js";
-import { SOURCE_DISPLAY_NAME } from "../../../../lib/config.js";
 const VALID_SOURCES = new Set(['qq', 'netease', 'kuwo', 'kugou']);
 export default defineCommand({
-    description: '删除音乐平台凭证',
+    description: '删除音乐平台凭证', descriptionI18n: { en: "Delete music platform credentials" },
     alias: ['删除'],
-    params: { source: { type: 'string', description: '音乐源（qq/netease/kuwo/kugou）' } },
+    params: { source: { type: 'string', description: '音乐源（qq/netease/kuwo/kugou）', descriptionI18n: { en: "Music source (qq / netease / kuwo / kugou)" } } },
     permit: ['role(master)'],
-    async execute({ params, args, use }) {
+    async execute({ params, args, use, locale, formatCommand }) {
         const source = String(params.source ?? '').trim();
         const key = String(args[0] ?? '').trim();
         if (!VALID_SOURCES.has(source)) {
-            return `不支持的音乐源：${source}`;
+            return t(locale, 'unsupported', { source });
         }
         if (!key) {
-            return `格式：cookie delete ${source} <key>`;
+            const command = formatCommand('cookie delete');
+            return usage(locale, command === undefined ? undefined : `${command} ${source} <key>`);
         }
         await use(musicRuntimeToken).credentials.delete(source, key);
-        return `[${SOURCE_DISPLAY_NAME[source]}] 凭证 ${key} 已删除`;
+        return t(locale, 'deleted', { source: sourceName(source, locale), key });
     },
 });

package/commands/cookie/delete/[source]/index.ts

@@ -1,27 +1,28 @@
+import { messages as t, sourceName, usage } from '../../../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { musicRuntimeToken } from '../../../../src/runtime.js';
-import { SOURCE_DISPLAY_NAME } from '../../../../src/config.js';
 import type { MusicSource } from '../../../../src/types.js';
 
 const VALID_SOURCES = new Set<string>(['qq', 'netease', 'kuwo', 'kugou']);
 
 export default defineCommand({
-  description: '删除音乐平台凭证',
+  description: '删除音乐平台凭证', descriptionI18n: { en: "Delete music platform credentials" },
   alias: ['删除'],
-  params: { source: { type: 'string', description: '音乐源（qq/netease/kuwo/kugou）' } },
+  params: { source: { type: 'string', description: '音乐源（qq/netease/kuwo/kugou）', descriptionI18n: { en: "Music source (qq / netease / kuwo / kugou)" } } },
   permit: ['role(master)'],
-  async execute({ params, args, use }) {
+  async execute({ params, args, use, locale, formatCommand }) {
     const source = String(params.source ?? '').trim();
     const key = String(args[0] ?? '').trim();
 
     if (!VALID_SOURCES.has(source)) {
-      return `不支持的音乐源：${source}`;
+      return t(locale, 'unsupported', { source });
     }
     if (!key) {
-      return `格式：cookie delete ${source} <key>`;
+      const command = formatCommand('cookie delete');
+      return usage(locale, command === undefined ? undefined : `${command} ${source} <key>`);
     }
 
     await use(musicRuntimeToken).credentials.delete(source as MusicSource, key);
-    return `[${SOURCE_DISPLAY_NAME[source as MusicSource]}] 凭证 ${key} 已删除`;
+    return t(locale, 'deleted', { source: sourceName(source as MusicSource, locale), key });
   },
 });

package/commands/cookie/get/[source]/index.js

@@ -1,29 +1,30 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t, sourceName, usage } from "../../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { musicRuntimeToken } from "../../../../lib/runtime.js";
-import { SOURCE_DISPLAY_NAME } from "../../../../lib/config.js";
 const VALID_SOURCES = new Set(['qq', 'netease', 'kuwo', 'kugou']);
 export default defineCommand({
-    description: '查看音乐平台凭证（脱敏）',
+    description: '查看音乐平台凭证（脱敏）', descriptionI18n: { en: "View music platform credentials with sensitive values masked" },
     alias: ['查看'],
-    params: { source: { type: 'string', description: '音乐源（qq/netease/kuwo/kugou）' } },
+    params: { source: { type: 'string', description: '音乐源（qq/netease/kuwo/kugou）', descriptionI18n: { en: "Music source (qq / netease / kuwo / kugou)" } } },
     permit: ['role(master)'],
-    async execute({ params, args, use }) {
+    async execute({ params, args, use, locale, formatCommand }) {
         const source = String(params.source ?? '').trim();
         const key = String(args[0] ?? '').trim();
         if (!VALID_SOURCES.has(source)) {
-            return `不支持的音乐源：${source}`;
+            return t(locale, 'unsupported', { source });
         }
         if (!key) {
-            return `格式：cookie get ${source} <key>`;
+            const command = formatCommand('cookie get');
+            return usage(locale, command === undefined ? undefined : `${command} ${source} <key>`);
         }
-        const sourceName = SOURCE_DISPLAY_NAME[source];
+        const label = sourceName(source, locale);
         const value = await use(musicRuntimeToken).credentials.get(source, key);
         if (!value)
-            return `[${sourceName}] 凭证 ${key} 未设置`;
+            return t(locale, 'credentialUnset', { source: label, key });
         const masked = value.length > 10
             ? `${value.slice(0, 4)}****${value.slice(-4)}`
             : '****';
-        return `[${sourceName}] ${key} = ${masked}`;
+        return `[${label}] ${key} = ${masked}`;
     },
 });

package/commands/cookie/get/[source]/index.ts

@@ -1,33 +1,34 @@
+import { messages as t, sourceName, usage } from '../../../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { musicRuntimeToken } from '../../../../src/runtime.js';
-import { SOURCE_DISPLAY_NAME } from '../../../../src/config.js';
 import type { MusicSource } from '../../../../src/types.js';
 
 const VALID_SOURCES = new Set<string>(['qq', 'netease', 'kuwo', 'kugou']);
 
 export default defineCommand({
-  description: '查看音乐平台凭证（脱敏）',
+  description: '查看音乐平台凭证（脱敏）', descriptionI18n: { en: "View music platform credentials with sensitive values masked" },
   alias: ['查看'],
-  params: { source: { type: 'string', description: '音乐源（qq/netease/kuwo/kugou）' } },
+  params: { source: { type: 'string', description: '音乐源（qq/netease/kuwo/kugou）', descriptionI18n: { en: "Music source (qq / netease / kuwo / kugou)" } } },
   permit: ['role(master)'],
-  async execute({ params, args, use }) {
+  async execute({ params, args, use, locale, formatCommand }) {
     const source = String(params.source ?? '').trim();
     const key = String(args[0] ?? '').trim();
 
     if (!VALID_SOURCES.has(source)) {
-      return `不支持的音乐源：${source}`;
+      return t(locale, 'unsupported', { source });
     }
     if (!key) {
-      return `格式：cookie get ${source} <key>`;
+      const command = formatCommand('cookie get');
+      return usage(locale, command === undefined ? undefined : `${command} ${source} <key>`);
     }
 
-    const sourceName = SOURCE_DISPLAY_NAME[source as MusicSource];
+    const label = sourceName(source as MusicSource, locale);
     const value = await use(musicRuntimeToken).credentials.get(source as MusicSource, key);
-    if (!value) return `[${sourceName}] 凭证 ${key} 未设置`;
+    if (!value) return t(locale, 'credentialUnset', { source: label, key });
 
     const masked = value.length > 10
       ? `${value.slice(0, 4)}****${value.slice(-4)}`
       : '****';
-    return `[${sourceName}] ${key} = ${masked}`;
+    return `[${label}] ${key} = ${masked}`;
   },
 });

package/commands/cookie/set/[source]/index.js

@@ -1,23 +1,24 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t, sourceName, usage } from "../../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { musicRuntimeToken } from "../../../../lib/runtime.js";
-import { SOURCE_DISPLAY_NAME } from "../../../../lib/config.js";
 const VALID_SOURCES = new Set(['qq', 'netease', 'kuwo', 'kugou']);
 export default defineCommand({
-    description: '保存音乐平台凭证',
+    description: '保存音乐平台凭证', descriptionI18n: { en: "Save music platform credentials" },
     alias: ['设置'],
-    params: { source: { type: 'string', description: '音乐源（qq/netease/kuwo/kugou）' } },
+    params: { source: { type: 'string', description: '音乐源（qq/netease/kuwo/kugou）', descriptionI18n: { en: "Music source (qq / netease / kuwo / kugou)" } } },
     permit: ['role(master)'],
-    async execute({ params, args, use }) {
+    async execute({ params, args, use, locale, formatCommand }) {
         const source = String(params.source ?? '').trim();
         const [key, ...valueParts] = args.map(String);
         if (!VALID_SOURCES.has(source)) {
-            return `不支持的音乐源：${source}\n支持：${[...VALID_SOURCES].join(', ')}`;
+            return t(locale, 'unsupported', { source }) + '\n' + t(locale, 'sources', { sources: [...VALID_SOURCES].join(', ') });
         }
         if (!key || valueParts.length === 0) {
-            return `格式：cookie set ${source} <key> <value>\n示例：cookie set netease cookie MUSIC_U=xxx`;
+            const command = formatCommand('cookie set');
+            return usage(locale, command === undefined ? undefined : `${command} ${source} <key> <value>`);
         }
         await use(musicRuntimeToken).credentials.set(source, key, valueParts.join(' '));
-        return `[${SOURCE_DISPLAY_NAME[source]}] 凭证 ${key} 已保存`;
+        return t(locale, 'saved', { source: sourceName(source, locale), key });
     },
 });

package/commands/cookie/set/[source]/index.ts

@@ -1,27 +1,28 @@
+import { messages as t, sourceName, usage } from '../../../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { musicRuntimeToken } from '../../../../src/runtime.js';
-import { SOURCE_DISPLAY_NAME } from '../../../../src/config.js';
 import type { MusicSource } from '../../../../src/types.js';
 
 const VALID_SOURCES = new Set<string>(['qq', 'netease', 'kuwo', 'kugou']);
 
 export default defineCommand({
-  description: '保存音乐平台凭证',
+  description: '保存音乐平台凭证', descriptionI18n: { en: "Save music platform credentials" },
   alias: ['设置'],
-  params: { source: { type: 'string', description: '音乐源（qq/netease/kuwo/kugou）' } },
+  params: { source: { type: 'string', description: '音乐源（qq/netease/kuwo/kugou）', descriptionI18n: { en: "Music source (qq / netease / kuwo / kugou)" } } },
   permit: ['role(master)'],
-  async execute({ params, args, use }) {
+  async execute({ params, args, use, locale, formatCommand }) {
     const source = String(params.source ?? '').trim();
     const [key, ...valueParts] = args.map(String);
 
     if (!VALID_SOURCES.has(source)) {
-      return `不支持的音乐源：${source}\n支持：${[...VALID_SOURCES].join(', ')}`;
+      return t(locale, 'unsupported', { source }) + '\n' + t(locale, 'sources', { sources: [...VALID_SOURCES].join(', ') });
     }
     if (!key || valueParts.length === 0) {
-      return `格式：cookie set ${source} <key> <value>\n示例：cookie set netease cookie MUSIC_U=xxx`;
+      const command = formatCommand('cookie set');
+      return usage(locale, command === undefined ? undefined : `${command} ${source} <key> <value>`);
     }
 
     await use(musicRuntimeToken).credentials.set(source as MusicSource, key, valueParts.join(' '));
-    return `[${SOURCE_DISPLAY_NAME[source as MusicSource]}] 凭证 ${key} 已保存`;
+    return t(locale, 'saved', { source: sourceName(source as MusicSource, locale), key });
   },
 });

package/commands/cookie/status/index.js

@@ -1,23 +1,23 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
 import { musicRuntimeToken } from "../../../lib/runtime.js";
-import { SOURCE_DISPLAY_NAME } from "../../../lib/config.js";
+import { messages as t, sourceName } from "../../../lib/i18n.js";
 export default defineCommand({
-    description: '查看各平台凭证配置状态',
+    description: '查看各平台凭证配置状态', descriptionI18n: { en: "View configured music credentials by platform" },
     alias: ['状态'],
     permit: ['role(master)'],
-    async execute({ use }) {
+    async execute({ use, locale }) {
         const allCreds = await use(musicRuntimeToken).credentials.list();
-        const lines = ['--- 音乐凭证状态 ---'];
+        const lines = [t(locale, 'credentials')];
         for (const source of ['qq', 'netease', 'kuwo', 'kugou']) {
-            const name = SOURCE_DISPLAY_NAME[source];
+            const name = sourceName(source, locale);
             const creds = allCreds.filter((c) => c.source === source);
             if (creds.length === 0) {
-                lines.push(`${name}: 未配置`);
+                lines.push(`${name}: ${t(locale, 'unset')}`);
             }
             else {
                 const keys = creds.map((c) => c.key).join(', ');
-                lines.push(`${name}: ${keys} (${creds.length} 项)`);
+                lines.push(`${name}: ${t(locale, 'count', { keys, count: creds.length })}`);
             }
         }
         return lines.join('\n');

package/commands/cookie/status/index.ts

@@ -1,23 +1,23 @@
 import { defineCommand } from 'zhin.js/command';
 import { musicRuntimeToken } from '../../../src/runtime.js';
-import { SOURCE_DISPLAY_NAME } from '../../../src/config.js';
+import { messages as t, sourceName } from '../../../src/i18n.js';
 import type { MusicSource } from '../../../src/types.js';
 
 export default defineCommand({
-  description: '查看各平台凭证配置状态',
+  description: '查看各平台凭证配置状态', descriptionI18n: { en: "View configured music credentials by platform" },
   alias: ['状态'],
   permit: ['role(master)'],
-  async execute({ use }) {
+  async execute({ use, locale }) {
     const allCreds = await use(musicRuntimeToken).credentials.list();
-    const lines: string[] = ['--- 音乐凭证状态 ---'];
+    const lines: string[] = [t(locale, 'credentials')];
     for (const source of ['qq', 'netease', 'kuwo', 'kugou'] as MusicSource[]) {
-      const name = SOURCE_DISPLAY_NAME[source];
+      const name = sourceName(source, locale);
       const creds = allCreds.filter((c) => c.source === source);
       if (creds.length === 0) {
-        lines.push(`${name}: 未配置`);
+        lines.push(`${name}: ${t(locale, 'unset')}`);
       } else {
         const keys = creds.map((c) => c.key).join(', ');
-        lines.push(`${name}: ${keys} (${creds.length} 项)`);
+        lines.push(`${name}: ${t(locale, 'count', { keys, count: creds.length })}`);
       }
     }
     return lines.join('\n');

package/commands/login/[platform]/index.js

@@ -2,58 +2,62 @@
 import { defineCommand } from 'zhin.js/command';
 import { loginSessionKey, } from "../../../lib/login/index.js";
 import { resolveMessageIds } from "../../../lib/session.js";
-import { SOURCE_DISPLAY_NAME } from "../../../lib/config.js";
+import { messages as t, sourceName as displayName } from "../../../lib/i18n.js";
 import { musicRuntimeToken } from "../../../lib/runtime.js";
 const QR_LOGIN_SOURCES = {
     qq: 'qq',
     netease: 'netease',
 };
 export default defineCommand({
-    description: '扫码登录音乐平台获取凭证（master 专用）',
+    description: '扫码登录音乐平台获取凭证（master 专用）', descriptionI18n: { en: "Sign in to a music platform with a QR code (bot master only)" },
     params: {
-        platform: { type: 'string', description: '音乐平台（qq / netease / 取消）' },
+        platform: { type: 'string', description: '音乐平台（qq / netease / 取消）', descriptionI18n: { en: "Music platform (qq / netease) or cancel" } },
     },
     permit: ['role(master)'],
-    async execute({ params, input, use }) {
+    async execute({ params, input, use, locale, formatCommand }) {
         const platform = String(params.platform ?? '').trim();
         const ids = resolveMessageIds(input);
         if (!ids)
-            return '无法识别会话信息，请在群聊或私聊中使用';
-        const key = loginSessionKey(ids.endpointId, ids.conversationId, ids.senderId);
+            return t(locale, 'conversation');
+        const key = loginSessionKey(ids.conversation, ids.senderId);
         const runtime = use(musicRuntimeToken);
-        if (platform === '取消' || platform === 'cancel') {
-            return runtime.logins.cancel(key) ? '已取消登录' : '没有进行中的登录会话';
+        const existing = runtime.logins.get(key);
+        const flowLocale = existing?.locale ?? locale;
+        const cancelInput = flowLocale === 'en' ? 'cancel' : '取消';
+        const command = formatCommand('login');
+        const cancelHint = command === undefined ? '' : t(flowLocale, 'cancelHint', { command: `${command} ${cancelInput}` });
+        if (platform === cancelInput) {
+            return t(flowLocale, runtime.logins.cancel(key) ? 'cancelLogin' : 'noLogin');
         }
         const source = QR_LOGIN_SOURCES[platform];
         if (!source) {
-            return `不支持的平台：${platform || '(空)'}\n支持：qq, netease`;
+            return t(flowLocale, 'platform', { platform });
         }
-        const existing = runtime.logins.get(key);
         if (existing) {
-            return `正在进行 ${SOURCE_DISPLAY_NAME[existing.source]} 登录，请先完成或发送"音乐登录 取消"`;
+            return [t(flowLocale, 'active', { source: displayName(existing.source, flowLocale) }), cancelHint].filter(Boolean).join('\n');
         }
-        const sourceName = SOURCE_DISPLAY_NAME[source];
+        const sourceName = displayName(source, locale);
         let qrResult;
         try {
-            qrResult = await runtime.logins.start(source, key);
+            qrResult = await runtime.logins.start(source, key, locale);
         }
         catch (err) {
-            return `[${sourceName}] 获取二维码失败：${err instanceof Error ? err.message : String(err)}`;
+            return t(locale, 'qrFailed', { source: sourceName, error: err instanceof Error ? err.message : String(err) });
         }
         const replyFn = input?.$reply;
         if (!replyFn)
-            return '无法发送消息';
+            return t(locale, 'noReply');
         await replyFn([
-            `[${sourceName}] 请使用 ${sourceName} App 扫描二维码登录：\n`,
+            t(locale, 'scan', { source: sourceName }) + '\n',
             qrResult.imageSegment,
-            `\n二维码有效期 2 分钟，发送"音乐登录 取消"可中止`,
+            '\n' + [t(locale, 'valid'), cancelHint].filter(Boolean).join('\n'),
         ]);
         const finalResult = await runtime.logins.poll(key, async (result) => {
             if (result.status === 'scanned') {
                 await replyFn(`[${sourceName}] ${result.message}`);
             }
             else if (result.status === 'confirmed') {
-                await replyFn(`[${sourceName}] 登录成功！cookie 已自动保存，现在可以搜索和播放高品质音乐了`);
+                await replyFn(`[${sourceName}] ${t(locale, 'success')}`);
             }
             else if (result.status === 'expired' || result.status === 'error') {
                 await replyFn(`[${sourceName}] ${result.message}`);

package/commands/login/[platform]/index.ts

@@ -5,7 +5,7 @@ import {
   type QrLoginSource,
 } from '../../../src/login/index.js';
 import { resolveMessageIds } from '../../../src/session.js';
-import { SOURCE_DISPLAY_NAME } from '../../../src/config.js';
+import { messages as t, sourceName as displayName } from '../../../src/i18n.js';
 import { musicRuntimeToken } from '../../../src/runtime.js';
 
 const QR_LOGIN_SOURCES: Record<string, QrLoginSource> = {
@@ -14,55 +14,59 @@ const QR_LOGIN_SOURCES: Record<string, QrLoginSource> = {
 };
 
 export default defineCommand<unknown, string, Message>({
-  description: '扫码登录音乐平台获取凭证（master 专用）',
+  description: '扫码登录音乐平台获取凭证（master 专用）', descriptionI18n: { en: "Sign in to a music platform with a QR code (bot master only)" },
   params: {
-    platform: { type: 'string', description: '音乐平台（qq / netease / 取消）' },
+    platform: { type: 'string', description: '音乐平台（qq / netease / 取消）', descriptionI18n: { en: "Music platform (qq / netease) or cancel" } },
   },
   permit: ['role(master)'],
-  async execute({ params, input, use }) {
+  async execute({ params, input, use, locale, formatCommand }) {
     const platform = String(params.platform ?? '').trim();
 
-    const ids = resolveMessageIds(input!);
-    if (!ids) return '无法识别会话信息，请在群聊或私聊中使用';
-    const key = loginSessionKey(ids.endpointId, ids.conversationId, ids.senderId);
+    const ids = resolveMessageIds(input);
+    if (!ids) return t(locale, 'conversation');
+    const key = loginSessionKey(ids.conversation, ids.senderId);
     const runtime = use(musicRuntimeToken);
 
-    if (platform === '取消' || platform === 'cancel') {
-      return runtime.logins.cancel(key) ? '已取消登录' : '没有进行中的登录会话';
+    const existing = runtime.logins.get(key);
+    const flowLocale = existing?.locale ?? locale;
+    const cancelInput = flowLocale === 'en' ? 'cancel' : '取消';
+    const command = formatCommand('login');
+    const cancelHint = command === undefined ? '' : t(flowLocale, 'cancelHint', { command: `${command} ${cancelInput}` });
+    if (platform === cancelInput) {
+      return t(flowLocale, runtime.logins.cancel(key) ? 'cancelLogin' : 'noLogin');
     }
 
     const source = QR_LOGIN_SOURCES[platform];
     if (!source) {
-      return `不支持的平台：${platform || '(空)'}\n支持：qq, netease`;
+      return t(flowLocale, 'platform', { platform });
     }
 
-    const existing = runtime.logins.get(key);
     if (existing) {
-      return `正在进行 ${SOURCE_DISPLAY_NAME[existing.source]} 登录，请先完成或发送"音乐登录 取消"`;
+      return [t(flowLocale, 'active', { source: displayName(existing.source, flowLocale) }), cancelHint].filter(Boolean).join('\n');
     }
 
-    const sourceName = SOURCE_DISPLAY_NAME[source];
+    const sourceName = displayName(source, locale);
     let qrResult;
     try {
-      qrResult = await runtime.logins.start(source, key);
+      qrResult = await runtime.logins.start(source, key, locale);
     } catch (err) {
-      return `[${sourceName}] 获取二维码失败：${err instanceof Error ? err.message : String(err)}`;
+      return t(locale, 'qrFailed', { source: sourceName, error: err instanceof Error ? err.message : String(err) });
     }
 
     const replyFn = input?.$reply;
-    if (!replyFn) return '无法发送消息';
+    if (!replyFn) return t(locale, 'noReply');
 
     await replyFn([
-      `[${sourceName}] 请使用 ${sourceName} App 扫描二维码登录：\n`,
+      t(locale, 'scan', { source: sourceName }) + '\n',
       qrResult.imageSegment,
-      `\n二维码有效期 2 分钟，发送"音乐登录 取消"可中止`,
+      '\n' + [t(locale, 'valid'), cancelHint].filter(Boolean).join('\n'),
     ]);
 
     const finalResult = await runtime.logins.poll(key, async (result) => {
       if (result.status === 'scanned') {
         await replyFn(`[${sourceName}] ${result.message}`);
       } else if (result.status === 'confirmed') {
-        await replyFn(`[${sourceName}] 登录成功！cookie 已自动保存，现在可以搜索和播放高品质音乐了`);
+        await replyFn(`[${sourceName}] ${t(locale, 'success')}`);
       } else if (result.status === 'expired' || result.status === 'error') {
         await replyFn(`[${sourceName}] ${result.message}`);
       }

package/commands//347/202/271/346/255/214/[keyword]/index.js

@@ -1,11 +1,14 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { messages as t, sourceName, usage } from "../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { searchMusic, formatSearchResults } from "../../../lib/music-lib.js";
-import { resolveSourceAlias, SOURCE_DISPLAY_NAME } from "../../../lib/config.js";
+import { resolveSourceAlias } from "../../../lib/config.js";
 import { sessionKey, resolveMessageIds } from "../../../lib/session.js";
 import { musicRuntimeToken } from "../../../lib/runtime.js";
 export default defineCommand({
-    description: '搜索音乐并点歌（支持QQ/网易云/酷我/酷狗）',
+    alias: ['music search'],
+    preferredAliasI18n: { en: 'music search' },
+    description: '搜索音乐并点歌（支持QQ/网易云/酷我/酷狗）', descriptionI18n: { en: "Search for music and play a track (QQ, NetEase, Kuwo and Kugou)" },
     params: { keyword: { type: 'string' } },
     shortcut: {
         'QQ点歌': { keyword: '' },
@@ -14,11 +17,11 @@ export default defineCommand({
         '酷我点歌': { keyword: '' },
         '酷狗点歌': { keyword: '' },
     },
-    async execute({ params, config, input, use }) {
+    async execute({ params, config, input, use, locale, formatCommand }) {
         const rawKeyword = String(params.keyword ?? '').trim();
         if (!rawKeyword) {
-            const sources = Object.values(SOURCE_DISPLAY_NAME).join('/');
-            return `请输入歌曲名称，如：点歌 稻香\n支持音乐源：${sources}`;
+            const sources = ['qq', 'netease', 'kuwo', 'kugou'].map(source => sourceName(source, locale)).join('/');
+            return [t(locale, 'keyword'), usage(locale, formatCommand('点歌') === undefined ? undefined : `${formatCommand('点歌')} <song>`), t(locale, 'sources', { sources })].filter(Boolean).join('\n');
         }
         let source = config?.defaultSource ?? 'qq';
         let keyword = rawKeyword;
@@ -41,23 +44,24 @@ export default defineCommand({
             source = sourceFromKeyword;
             keyword = keyword.slice(keyword.indexOf(' ') + 1).trim();
             if (!keyword)
-                return '请输入歌曲名称';
+                return t(locale, 'keyword');
         }
         const pageSize = config?.pageSize ?? 5;
         const result = await searchMusic(use(musicRuntimeToken), keyword, source, pageSize);
         if (result.total === 0) {
-            return `[${SOURCE_DISPLAY_NAME[source]}] 未找到"${keyword}"相关歌曲`;
+            return t(locale, 'noMatch', { source: sourceName(source, locale), keyword });
         }
         const ids = input ? resolveMessageIds(input) : null;
         if (ids) {
-            const key = sessionKey(ids.endpointId, ids.conversationId, ids.senderId);
+            const key = sessionKey(ids.conversation, ids.senderId);
             use(musicRuntimeToken).sessions.set(key, {
+                locale,
                 results: result.results,
                 source: result.source,
                 keyword,
                 timestamp: Date.now(),
             });
         }
-        return formatSearchResults(result.results, result.source);
+        return formatSearchResults(result.results, result.source, locale);
     },
 });

package/commands//347/202/271/346/255/214/[keyword]/index.ts

@@ -1,7 +1,8 @@
+import { messages as t, sourceName, usage } from '../../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import type { Message } from '@zhin.js/core/runtime';
 import { searchMusic, formatSearchResults } from '../../../src/music-lib.js';
-import { resolveSourceAlias, SOURCE_DISPLAY_NAME } from '../../../src/config.js';
+import { resolveSourceAlias } from '../../../src/config.js';
 import { sessionKey, resolveMessageIds } from '../../../src/session.js';
 import type { MusicSource } from '../../../src/types.js';
 import { musicRuntimeToken } from '../../../src/runtime.js';
@@ -12,7 +13,9 @@ interface MusicConfig {
 }
 
 export default defineCommand<MusicConfig, string, Message>({
-  description: '搜索音乐并点歌（支持QQ/网易云/酷我/酷狗）',
+  alias: ['music search'],
+  preferredAliasI18n: { en: 'music search' },
+  description: '搜索音乐并点歌（支持QQ/网易云/酷我/酷狗）', descriptionI18n: { en: "Search for music and play a track (QQ, NetEase, Kuwo and Kugou)" },
   params: { keyword: { type: 'string' } },
   shortcut: {
     'QQ点歌': { keyword: '' },
@@ -21,11 +24,11 @@ export default defineCommand<MusicConfig, string, Message>({
     '酷我点歌': { keyword: '' },
     '酷狗点歌': { keyword: '' },
   },
-  async execute({ params, config, input, use }) {
+  async execute({ params, config, input, use, locale, formatCommand }) {
     const rawKeyword = String(params.keyword ?? '').trim();
     if (!rawKeyword) {
-      const sources = Object.values(SOURCE_DISPLAY_NAME).join('/');
-      return `请输入歌曲名称，如：点歌 稻香\n支持音乐源：${sources}`;
+      const sources = (['qq', 'netease', 'kuwo', 'kugou'] as const).map(source => sourceName(source, locale)).join('/');
+      return [t(locale, 'keyword'), usage(locale, formatCommand('点歌') === undefined ? undefined : `${formatCommand('点歌')} <song>`), t(locale, 'sources', { sources })].filter(Boolean).join('\n');
     }
 
     let source: MusicSource = (config as MusicConfig | undefined)?.defaultSource ?? 'qq';
@@ -50,19 +53,20 @@ export default defineCommand<MusicConfig, string, Message>({
     if (sourceFromKeyword) {
       source = sourceFromKeyword;
       keyword = keyword.slice(keyword.indexOf(' ') + 1).trim();
-      if (!keyword) return '请输入歌曲名称';
+      if (!keyword) return t(locale, 'keyword');
     }
 
     const pageSize = (config as MusicConfig | undefined)?.pageSize ?? 5;
     const result = await searchMusic(use(musicRuntimeToken), keyword, source, pageSize);
     if (result.total === 0) {
-      return `[${SOURCE_DISPLAY_NAME[source]}] 未找到"${keyword}"相关歌曲`;
+      return t(locale, 'noMatch', { source: sourceName(source, locale), keyword });
     }
 
     const ids = input ? resolveMessageIds(input) : null;
     if (ids) {
-      const key = sessionKey(ids.endpointId, ids.conversationId, ids.senderId);
+      const key = sessionKey(ids.conversation, ids.senderId);
       use(musicRuntimeToken).sessions.set(key, {
+        locale,
         results: result.results,
         source: result.source,
         keyword,
@@ -70,6 +74,6 @@ export default defineCommand<MusicConfig, string, Message>({
       });
     }
 
-    return formatSearchResults(result.results, result.source);
+    return formatSearchResults(result.results, result.source, locale);
   },
 });

package/lib/i18n.d.ts

@@ -0,0 +1,6 @@
+import { type Locale } from 'zhin.js/i18n';
+import type { MusicSource } from './types.js';
+export declare const messages: (locale: Locale | undefined, key: "loginAborted" | "keyword" | "usage" | "sources" | "noResults" | "noMatch" | "results" | "unsupported" | "cancelSelection" | "detailFailed" | "credentials" | "unset" | "count" | "credentialUnset" | "saved" | "deleted" | "conversation" | "cancelLogin" | "noLogin" | "platform" | "active" | "cancelHint" | "qrFailed" | "noReply" | "scan" | "valid" | "success" | "waiting" | "scanned" | "expired" | "confirmed" | "unknown" | "pollFailed" | "pollError" | "timeout" | "neteaseQr" | "emptyResponse" | "cookieFailed", values?: import("zhin.js").MessageValues) => string;
+export declare function sourceName(source: MusicSource, locale?: Locale): string;
+export declare function usage(locale: Locale, command: string | undefined): string;
+//# sourceMappingURL=i18n.d.ts.map

package/lib/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,QAAQ,slBAuCnB,CAAC;AAEH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,GAAE,MAAgB,GAAG,MAAM,CAEhF;AACD,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAEzE"}