@zhin.js/plugin-music 5.0.2 → 6.0.0

package/README.md

@@ -286,6 +286,7 @@ export type MusicSource = 'qq' | 'netease' | 'mymusic'
 2. **版权问题**：仅用于搜索和分享链接，不提供下载功能
 3. **网络问题**：部分 API 可能需要稳定的网络连接
 4. **平台兼容**：ICQQ 特定功能仅在 ICQQ 适配器下可用
+5. **AI 工具平台限制**：旧版 `music-search` / `music-share` 工具曾通过 `.platform('icqq')` 限制仅 icqq 平台可用；现行 `defineAgentTool`（`@zhin.js/tool`）不支持 platform 约束，迁移后工具对所有平台可见
 
 ## 🐛 故障排除
 

package/components/share-music.ts

@@ -0,0 +1,29 @@
+import { defineComponent } from '@zhin.js/component';
+import { musicServices } from '../src/sources/index.js';
+import { sourceConfigMap } from '../src/config.js';
+import type { MusicSource } from '../src/types.js';
+
+interface ShareMusicProps {
+  readonly platform: MusicSource;
+  readonly musicId: string;
+}
+
+/**
+ * Async music share card. Adapters that understand `share` segments render the
+ * rich card; others may fall back to text.
+ */
+export default defineComponent<ShareMusicProps>({
+  async render({ platform, musicId }) {
+    const service = musicServices[platform];
+    if (!service) return 'unsupported music source';
+    const detail = await service.getDetail(musicId);
+    const { id: _id, source: _source, ...rest } = detail;
+    return {
+      type: 'share',
+      data: {
+        ...rest,
+        config: sourceConfigMap[platform],
+      },
+    };
+  },
+});

package/lib/index.d.ts

@@ -1,2 +1,5 @@
-export {};
+export { formatDuration, formatMusicInfo, sourceConfigMap } from './config.js';
+export { searchMusic, shareMusicDetail } from './music-lib.js';
+export { musicServices } from './sources/index.js';
+export type { MusicDetail, MusicInfo, MusicSource, MusicSourceConfig } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/lib/index.js

@@ -1,113 +1,4 @@
-import { jsx as _jsx } from "zhin.js/jsx-runtime";
-import { formatCompact, defineComponent, usePlugin, ZhinTool } from 'zhin.js';
-import { musicServices } from "./sources/index.js";
-import { sourceConfigMap } from "./config.js";
-const plugin = usePlugin();
-const { logger, useContext, addComponent } = plugin;
-// 异步组件：分享音乐
-const ShareMusic = defineComponent(async function ShareMusic({ platform, musicId }) {
-    const service = musicServices[platform];
-    if (!service)
-        return 'unsupported music source';
-    const { id, source, ...detail } = await service.getDetail(musicId);
-    return _jsx("share", { ...detail, config: sourceConfigMap[platform] });
-}, 'ShareMusic');
-addComponent(ShareMusic);
-// Suspense 组件 - 用于包装异步组件
-const Suspense = defineComponent(async function Suspense(props, _context) {
-    try {
-        // 如果 children 是一个 Promise（异步组件），等待它
-        if (props.children && typeof props.children === 'object' && 'then' in props.children) {
-            return await props.children;
-        }
-        // 否则直接返回
-        return props.children || '';
-    }
-    catch (error) {
-        logger.error('Suspense error:', error);
-        return props.fallback || '加载失败';
-    }
-}, 'Suspense');
-addComponent(Suspense);
-// ============================================================================
-// 点歌工具 (使用 ZhinTool)
-// ============================================================================
-const searchMusicTool = new ZhinTool('music_search')
-    .desc('搜索音乐并返回结果列表')
-    .tag('music', 'entertainment')
-    .param('keyword', { type: 'string', description: '搜索关键词' }, true)
-    .param('source', {
-    type: 'string',
-    description: '音乐源: qq, netease（默认两者都搜索）',
-    enum: ['qq', 'netease']
-})
-    .param('limit', { type: 'number', description: '返回结果数量（默认 5）' })
-    .execute(async ({ keyword, source, limit = 5 }) => {
-    const keywordStr = keyword;
-    const limitNum = limit;
-    // 确定搜索源
-    const searchSources = source
-        ? [source]
-        : ['qq', 'netease'];
-    logger.debug(formatCompact({ op: 'search', keyword: keywordStr, sources: searchSources.join(',') }));
-    // 并行搜索
-    const searchPromises = searchSources.map(s => musicServices[s].search(keywordStr, limitNum));
-    const searchResults = await Promise.all(searchPromises);
-    const allMusic = searchResults.flat().filter(Boolean);
-    return {
-        success: true,
-        keyword: keywordStr,
-        results: allMusic.map(m => ({
-            id: m.id,
-            title: m.title,
-            source: m.source,
-            url: m.url,
-        })),
-        total: allMusic.length,
-    };
-})
-    .platform('icqq'); // 限制为 icqq 平台
-// 分享音乐工具（直接分享指定音乐）
-const shareMusicTool = new ZhinTool('music_share')
-    .desc('分享指定的音乐')
-    .tag('music', 'entertainment')
-    .param('id', { type: 'string', description: '音乐 ID' }, true)
-    .param('source', {
-    type: 'string',
-    description: '音乐源: qq 或 netease',
-    enum: ['qq', 'netease']
-}, true)
-    .platform('icqq')
-    .execute(async ({ id, source }) => {
-    const service = musicServices[source];
-    if (!service) {
-        return { success: false, error: `不支持的音乐源: ${source}` };
-    }
-    try {
-        const detail = await service.getDetail(id);
-        return {
-            success: true,
-            music: {
-                id: detail.id,
-                title: detail.title,
-                source: detail.source,
-                url: detail.url,
-            }
-        };
-    }
-    catch (error) {
-        return { success: false, error: error instanceof Error ? error.message : String(error) };
-    }
-});
-// 注册工具
-useContext('tool', (toolService) => {
-    if (!toolService)
-        return;
-    const disposers = [
-        toolService.addTool(searchMusicTool, 'music'),
-        toolService.addTool(shareMusicTool, 'music'),
-    ];
-    logger.debug('音乐工具已注册');
-    return () => disposers.forEach(d => d());
-});
+export { formatDuration, formatMusicInfo, sourceConfigMap } from './config.js';
+export { searchMusic, shareMusicDetail } from './music-lib.js';
+export { musicServices } from './sources/index.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/music-lib.d.ts

@@ -0,0 +1,30 @@
+import type { MusicSource } from './types.js';
+export declare function searchMusic(keyword: string, source?: MusicSource, limit?: number): Promise<{
+    success: true;
+    keyword: string;
+    results: Array<{
+        id: string;
+        title: string;
+        source: string;
+        url: string;
+    }>;
+    total: number;
+}>;
+export declare function shareMusicDetail(id: string, source: MusicSource): Promise<{
+    success: false;
+    error: string;
+    music?: undefined;
+} | {
+    success: true;
+    music: {
+        id: string;
+        title: string;
+        source: MusicSource;
+        url: string;
+        image: string;
+        audio: string;
+        duration: number | undefined;
+    };
+    error?: undefined;
+}>;
+//# sourceMappingURL=music-lib.d.ts.map

package/lib/music-lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"music-lib.d.ts","sourceRoot":"","sources":["../src/music-lib.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,EACpB,KAAK,SAAI,GACR,OAAO,CAAC;IACT,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAiBD;AAED,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW;;;;;;;;;;;;;;;;GAyBrE"}

package/lib/music-lib.js

@@ -0,0 +1,45 @@
+import { musicServices } from './sources/index.js';
+export async function searchMusic(keyword, source, limit = 5) {
+    const searchSources = source ? [source] : ['qq', 'netease'];
+    const searchResults = await Promise.all(searchSources.map((s) => musicServices[s].search(keyword, limit)));
+    const allMusic = searchResults.flat().filter(Boolean);
+    return {
+        success: true,
+        keyword,
+        results: allMusic.map((m) => ({
+            id: m.id,
+            title: m.title,
+            source: m.source,
+            url: m.url,
+        })),
+        total: allMusic.length,
+    };
+}
+export async function shareMusicDetail(id, source) {
+    const service = musicServices[source];
+    if (!service) {
+        return { success: false, error: `不支持的音乐源: ${source}` };
+    }
+    try {
+        const detail = await service.getDetail(id);
+        return {
+            success: true,
+            music: {
+                id: detail.id,
+                title: detail.title,
+                source: detail.source,
+                url: detail.url,
+                image: detail.image,
+                audio: detail.audio,
+                duration: detail.duration,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=music-lib.js.map

package/lib/music-lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"music-lib.js","sourceRoot":"","sources":["../src/music-lib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,MAAoB,EACpB,KAAK,GAAG,CAAC;IAOT,MAAM,aAAa,GAAkB,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3E,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CACrC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAClE,CAAC;IACF,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,OAAO,CAAgB,CAAC;IACrE,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO;QACP,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,GAAG,EAAE,CAAC,CAAC,GAAG;SACX,CAAC,CAAC;QACH,KAAK,EAAE,QAAQ,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAU,EAAE,MAAmB;IACpE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAc,EAAE,KAAK,EAAE,YAAY,MAAM,EAAE,EAAE,CAAC;IAClE,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE,IAAa;YACtB,KAAK,EAAE;gBACL,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAc;YACvB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,23 +1,25 @@
 {
   "name": "@zhin.js/plugin-music",
-  "version": "5.0.2",
-  "description": "Music search and sharing plugin for Zhin.js",
+  "version": "6.0.0",
+  "description": "Music search and sharing plugin for Zhin.js (Plugin Runtime)",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
   "exports": {
     ".": {
       "types": "./lib/index.d.ts",
-      "development": "./src/index.tsx",
+      "development": "./src/index.ts",
       "import": "./lib/index.js"
     },
     "./package.json": "./package.json"
   },
   "files": [
+    "plugin.ts",
+    "schema.json",
+    "components",
+    "tools",
     "src",
     "lib",
-    "client",
-    "dist",
     "agent",
     "README.md"
   ],
@@ -38,15 +40,17 @@
     "url": "https://github.com/lc-cn"
   },
   "license": "MIT",
-  "dependencies": {},
+  "dependencies": {
+    "@zhin.js/component": "1.0.2",
+    "@zhin.js/plugin-runtime": "1.1.0",
+    "@zhin.js/tool": "1.0.2"
+  },
   "devDependencies": {
     "typescript": "^6.0.3",
-    "zhin.js": "4.1.2",
-    "@zhin.js/adapter-icqq": "6.0.2"
+    "vitest": "^4.1.10"
   },
   "peerDependencies": {
-    "@zhin.js/adapter-icqq": "6.0.2",
-    "zhin.js": "4.1.2"
+    "@zhin.js/adapter-icqq": "7.0.0"
   },
   "peerDependenciesMeta": {
     "@zhin.js/adapter-icqq": {
@@ -62,8 +66,30 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.ts",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/component",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/tool",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
+  },
   "scripts": {
-    "build": "tsc --build",
-    "clean": "rimraf lib"
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/utils/music/tests"
   }
 }

package/plugin.ts

@@ -0,0 +1,8 @@
+import { definePlugin } from '@zhin.js/plugin-runtime';
+
+export default definePlugin({
+  name: 'music',
+  metadata: {
+    displayName: 'Music',
+  },
+});

package/schema.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {}
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export { formatDuration, formatMusicInfo, sourceConfigMap } from './config.js';
+export { searchMusic, shareMusicDetail } from './music-lib.js';
+export { musicServices } from './sources/index.js';
+export type { MusicDetail, MusicInfo, MusicSource, MusicSourceConfig } from './types.js';

package/src/music-lib.ts

@@ -0,0 +1,57 @@
+import { musicServices } from './sources/index.js';
+import type { MusicInfo, MusicSource } from './types.js';
+
+export async function searchMusic(
+  keyword: string,
+  source?: MusicSource,
+  limit = 5,
+): Promise<{
+  success: true;
+  keyword: string;
+  results: Array<{ id: string; title: string; source: string; url: string }>;
+  total: number;
+}> {
+  const searchSources: MusicSource[] = source ? [source] : ['qq', 'netease'];
+  const searchResults = await Promise.all(
+    searchSources.map((s) => musicServices[s].search(keyword, limit)),
+  );
+  const allMusic = searchResults.flat().filter(Boolean) as MusicInfo[];
+  return {
+    success: true,
+    keyword,
+    results: allMusic.map((m) => ({
+      id: m.id,
+      title: m.title,
+      source: m.source,
+      url: m.url,
+    })),
+    total: allMusic.length,
+  };
+}
+
+export async function shareMusicDetail(id: string, source: MusicSource) {
+  const service = musicServices[source];
+  if (!service) {
+    return { success: false as const, error: `不支持的音乐源: ${source}` };
+  }
+  try {
+    const detail = await service.getDetail(id);
+    return {
+      success: true as const,
+      music: {
+        id: detail.id,
+        title: detail.title,
+        source: detail.source,
+        url: detail.url,
+        image: detail.image,
+        audio: detail.audio,
+        duration: detail.duration,
+      },
+    };
+  } catch (error) {
+    return {
+      success: false as const,
+      error: error instanceof Error ? error.message : String(error),
+    };
+  }
+}

package/tools/music-search.ts

@@ -0,0 +1,23 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { searchMusic } from '../src/music-lib.js';
+import type { MusicSource } from '../src/types.js';
+
+export default defineAgentTool<{
+  keyword: string;
+  source?: MusicSource;
+  limit?: number;
+}>({
+  description: '搜索音乐并返回结果列表',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      keyword: { type: 'string', description: '搜索关键词' },
+      source: { type: 'string', enum: ['qq', 'netease'] },
+      limit: { type: 'number', description: '返回结果数量（默认 5）' },
+    },
+    required: ['keyword'],
+  },
+  approval: 'never',
+  execute: ({ keyword, source, limit }) =>
+    searchMusic(String(keyword), source, typeof limit === 'number' ? limit : 5),
+});

package/tools/music-share.ts

@@ -0,0 +1,20 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { shareMusicDetail } from '../src/music-lib.js';
+import type { MusicSource } from '../src/types.js';
+
+export default defineAgentTool<{
+  id: string;
+  source: MusicSource;
+}>({
+  description: '分享指定的音乐',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      id: { type: 'string', description: '音乐 ID' },
+      source: { type: 'string', enum: ['qq', 'netease'] },
+    },
+    required: ['id', 'source'],
+  },
+  approval: 'never',
+  execute: ({ id, source }) => shareMusicDetail(String(id), source),
+});

package/lib/async-jsx.d.ts

@@ -1,19 +0,0 @@
-import { SendContent } from "zhin.js";
-/**
- * 异步组件包装器
- * 类似 Next.js 的异步组件支持
- */
-export declare function AsyncComponent<P = any>(Component: (props: P) => Promise<SendContent>): (props: P) => SendContent;
-/**
- * 渲染异步内容
- * 检查是否是异步标记，如果是则执行
- */
-export declare function renderAsync(content: any): Promise<SendContent>;
-/**
- * Suspense 组件工厂
- * 用于包装异步组件并提供 fallback
- */
-export declare function createSuspense(fallback?: string): (props: {
-    children: any;
-}) => Promise<SendContent>;
-//# sourceMappingURL=async-jsx.d.ts.map

package/lib/async-jsx.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"async-jsx.d.ts","sourceRoot":"","sources":["../src/async-jsx.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,GAAG,GAAG,EACpC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,GAC5C,CAAC,KAAK,EAAE,CAAC,KAAK,WAAW,CAc3B;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAQpE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAAiB,IACzB,OAAO;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,KAAG,OAAO,CAAC,WAAW,CAAC,CAQ/E"}

package/lib/async-jsx.js

@@ -1,48 +0,0 @@
-// async-jsx.ts - 异步 JSX 增强工具
-/**
- * 异步组件包装器
- * 类似 Next.js 的异步组件支持
- */
-export function AsyncComponent(Component) {
-    // 返回一个同步函数，但内部处理是异步的
-    return (props) => {
-        // 创建一个特殊的标记对象
-        const asyncMarker = {
-            __async: true,
-            component: Component,
-            props,
-            execute: () => Component(props)
-        };
-        // TypeScript 类型断言
-        return asyncMarker;
-    };
-}
-/**
- * 渲染异步内容
- * 检查是否是异步标记，如果是则执行
- */
-export async function renderAsync(content) {
-    if (content && typeof content === 'object' && content.__async) {
-        return await content.execute();
-    }
-    if (content && typeof content.then === 'function') {
-        return await content;
-    }
-    return content;
-}
-/**
- * Suspense 组件工厂
- * 用于包装异步组件并提供 fallback
- */
-export function createSuspense(fallback = '加载中...') {
-    return async function Suspense(props) {
-        try {
-            return await renderAsync(props.children);
-        }
-        catch (error) {
-            console.error('Suspense error:', error);
-            return fallback;
-        }
-    };
-}
-//# sourceMappingURL=async-jsx.js.map

package/lib/async-jsx.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"async-jsx.js","sourceRoot":"","sources":["../src/async-jsx.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAI7B;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,SAA6C;IAE7C,qBAAqB;IACrB,OAAO,CAAC,KAAQ,EAAE,EAAE;QAClB,cAAc;QACd,MAAM,WAAW,GAAG;YAClB,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,SAAS;YACpB,KAAK;YACL,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC;SAChC,CAAC;QAEF,kBAAkB;QAClB,OAAO,WAAiC,CAAC;IAC3C,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAY;IAC5C,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC9D,OAAO,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IACD,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAClD,OAAO,MAAM,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,WAAmB,QAAQ;IACxD,OAAO,KAAK,UAAU,QAAQ,CAAC,KAAwB;QACrD,IAAI,CAAC;YACH,OAAO,MAAM,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;YACxC,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/src/async-jsx.ts

@@ -1,54 +0,0 @@
-// async-jsx.ts - 异步 JSX 增强工具
-
-import { SendContent } from "zhin.js";
-
-/**
- * 异步组件包装器
- * 类似 Next.js 的异步组件支持
- */
-export function AsyncComponent<P = any>(
-  Component: (props: P) => Promise<SendContent>
-): (props: P) => SendContent {
-  // 返回一个同步函数，但内部处理是异步的
-  return (props: P) => {
-    // 创建一个特殊的标记对象
-    const asyncMarker = {
-      __async: true,
-      component: Component,
-      props,
-      execute: () => Component(props)
-    };
-    
-    // TypeScript 类型断言
-    return asyncMarker as any as SendContent;
-  };
-}
-
-/**
- * 渲染异步内容
- * 检查是否是异步标记，如果是则执行
- */
-export async function renderAsync(content: any): Promise<SendContent> {
-  if (content && typeof content === 'object' && content.__async) {
-    return await content.execute();
-  }
-  if (content && typeof content.then === 'function') {
-    return await content;
-  }
-  return content;
-}
-
-/**
- * Suspense 组件工厂
- * 用于包装异步组件并提供 fallback
- */
-export function createSuspense(fallback: string = '加载中...') {
-  return async function Suspense(props: { children: any }): Promise<SendContent> {
-    try {
-      return await renderAsync(props.children);
-    } catch (error) {
-      console.error('Suspense error:', error);
-      return fallback;
-    }
-  };
-}

package/src/index.tsx

@@ -1,130 +0,0 @@
-import { formatCompact, defineComponent, usePlugin, ZhinTool } from 'zhin.js';
-import { musicServices } from "./sources/index.js";
-import { sourceConfigMap } from "./config.js";
-import type { MusicSource } from "./types.js";
-
-const plugin = usePlugin();
-const { logger, useContext, addComponent } = plugin;
-
-// 异步组件：分享音乐
-const ShareMusic = defineComponent(async function ShareMusic({ platform, musicId }: { platform: MusicSource, musicId: string }) {
-  const service = musicServices[platform];
-  if (!service) return 'unsupported music source';
-  const { id, source, ...detail } = await service.getDetail(musicId);
-  return <share {...detail} config={sourceConfigMap[platform]} />
-}, 'ShareMusic')
-addComponent(ShareMusic)
-
-// Suspense 组件 - 用于包装异步组件
-const Suspense = defineComponent(async function Suspense(
-  props: { fallback?: string; children?: any },
-  _context
-) {
-  try {
-    // 如果 children 是一个 Promise（异步组件），等待它
-    if (props.children && typeof props.children === 'object' && 'then' in props.children) {
-      return await props.children;
-    }
-    // 否则直接返回
-    return props.children || '';
-  } catch (error) {
-    logger.error('Suspense error:', error);
-    return props.fallback || '加载失败';
-  }
-}, 'Suspense');
-
-addComponent(Suspense);
-
-// ============================================================================
-// 点歌工具 (使用 ZhinTool)
-// ============================================================================
-
-const searchMusicTool = new ZhinTool('music_search')
-  .desc('搜索音乐并返回结果列表')
-  .tag('music', 'entertainment')
-  .param('keyword', { type: 'string', description: '搜索关键词' }, true)
-  .param('source', { 
-    type: 'string', 
-    description: '音乐源: qq, netease（默认两者都搜索）',
-    enum: ['qq', 'netease']
-  })
-  .param('limit', { type: 'number', description: '返回结果数量（默认 5）' })
-  .execute(async ({ keyword, source, limit = 5 }) => {
-    const keywordStr = keyword as string;
-    const limitNum = limit as number;
-    
-    // 确定搜索源
-    const searchSources: MusicSource[] = source 
-      ? [source as MusicSource] 
-      : ['qq', 'netease'];
-
-    logger.debug(formatCompact( { op: 'search', keyword: keywordStr, sources: searchSources.join(',') }));
-
-    // 并行搜索
-    const searchPromises = searchSources.map(s => 
-      musicServices[s].search(keywordStr, limitNum)
-    );
-
-    const searchResults = await Promise.all(searchPromises);
-    const allMusic = searchResults.flat().filter(Boolean);
-
-    return {
-      success: true,
-      keyword: keywordStr,
-      results: allMusic.map(m => ({
-        id: m.id,
-        title: m.title,
-        source: m.source,
-        url: m.url,
-      })),
-      total: allMusic.length,
-    };
-  })
-  .platform('icqq');  // 限制为 icqq 平台
-
-// 分享音乐工具（直接分享指定音乐）
-const shareMusicTool = new ZhinTool('music_share')
-  .desc('分享指定的音乐')
-  .tag('music', 'entertainment')
-  .param('id', { type: 'string', description: '音乐 ID' }, true)
-  .param('source', { 
-    type: 'string', 
-    description: '音乐源: qq 或 netease',
-    enum: ['qq', 'netease']
-  }, true)
-  .platform('icqq')
-  .execute(async ({ id, source }) => {
-    const service = musicServices[source as MusicSource];
-    if (!service) {
-      return { success: false, error: `不支持的音乐源: ${source}` };
-    }
-    
-    try {
-      const detail = await service.getDetail(id as string);
-      return {
-        success: true,
-        music: {
-          id: detail.id,
-          title: detail.title,
-          source: detail.source,
-          url: detail.url,
-        }
-      };
-    } catch (error) {
-      return { success: false, error: error instanceof Error ? error.message : String(error) };
-    }
-  });
-
-// 注册工具
-useContext('tool', (toolService) => {
-  if (!toolService) return;
-  
-  const disposers = [
-    toolService.addTool(searchMusicTool, 'music'),
-    toolService.addTool(shareMusicTool, 'music'),
-  ];
-  
-  logger.debug('音乐工具已注册');
-  
-  return () => disposers.forEach(d => d());
-});