@zhin.js/adapter-napcat 1.1.25 → 1.1.27

package/agents/napcat/skills/napcat-group-files-history/tools/get_group_root_files/index.ts

@@ -1,17 +1,15 @@
+import { currentGroup } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ group_id: number }>({
-  description: '获取群根目录文件列表。',
-  inputSchema: z.object({
-    group_id: z.number().describe('群号'),
-  }),
+export default defineAgentTool<Record<string, never>>({
+  description: '获取当前群的根目录文件列表。',
+  inputSchema: z.object({}),
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['群文件列表', 'group files'],
   scopes: ['group'],
-  async execute({ group_id }: { group_id: number }, context) {
-    const endpoint = context.$client;
-      return endpoint.getGroupRootFiles(group_id);
+  async execute(_input, context) {
+    return context.$client.getGroupRootFiles(currentGroup(context));
   },
 });

package/agents/napcat/skills/napcat-group-files-history/tools/upload_group_file/index.js

@@ -1,10 +1,10 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { currentGroup } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '上传文件到群。file 为本地路径或 URL。',
+    description: '上传文件到当前群。file 为宿主机本地路径或 URL（读取宿主文件，仅全局主人可用）。',
     inputSchema: z.object({
-        group_id: z.number().describe('群号'),
         file: z.string().describe('文件路径或 URL'),
         name: z.string().describe('文件名'),
         folder: z.string().optional().describe('目标文件夹 ID（可选）'),
@@ -13,9 +13,10 @@ export default defineAgentTool({
     tags: ['napcat', 'qq'],
     keywords: ['上传文件', 'upload file', '群文件'],
     scopes: ['group'],
-    async execute({ group_id, file, name, folder }, context) {
-        const endpoint = context.$client;
-        await endpoint.uploadGroupFile({ groupId: group_id, file, name, folder });
+    // `file` may be a path on the host: reading host files is a host-global capability (ADR 0056 §2).
+    permissions: ['owner@global'],
+    async execute({ file, name, folder }, context) {
+        await context.$client.uploadGroupFile({ groupId: currentGroup(context), file, name, folder });
         return { success: true };
     },
 });

package/agents/napcat/skills/napcat-group-files-history/tools/upload_group_file/index.ts

@@ -1,10 +1,10 @@
+import { currentGroup } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ group_id: number; file: string; name: string; folder?: string }>({
-  description: '上传文件到群。file 为本地路径或 URL。',
+export default defineAgentTool<{ file: string; name: string; folder?: string }>({
+  description: '上传文件到当前群。file 为宿主机本地路径或 URL（读取宿主文件，仅全局主人可用）。',
   inputSchema: z.object({
-    group_id: z.number().describe('群号'),
     file: z.string().describe('文件路径或 URL'),
     name: z.string().describe('文件名'),
     folder: z.string().optional().describe('目标文件夹 ID（可选）'),
@@ -13,9 +13,10 @@ export default defineAgentTool<{ group_id: number; file: string; name: string; f
   tags: ['napcat', 'qq'],
   keywords: ['上传文件', 'upload file', '群文件'],
   scopes: ['group'],
-  async execute({ group_id, file, name, folder }: { group_id: number; file: string; name: string; folder?: string }, context) {
-    const endpoint = context.$client;
-      await endpoint.uploadGroupFile({ groupId: group_id, file, name, folder });
-      return { success: true };
+  // `file` may be a path on the host: reading host files is a host-global capability (ADR 0056 §2).
+  permissions: ['owner@global'],
+  async execute({ file, name, folder }, context) {
+    await context.$client.uploadGroupFile({ groupId: currentGroup(context), file, name, folder });
+    return { success: true };
   },
 });

package/agents/napcat/skills/napcat-group-media/tools/ai_tts/index.js

@@ -1,10 +1,10 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { currentGroup } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: 'AI 文字转语音，在群聊中发送 AI 语音消息。',
+    description: 'AI 文字转语音，在当前群发送 AI 语音消息。',
     inputSchema: z.object({
-        group_id: z.number().describe('群号'),
         character: z.string().describe('AI 语音角色 ID（可先用 napcat_get_ai_characters 查询）'),
         text: z.string().describe('要转为语音的文字'),
     }),
@@ -12,8 +12,7 @@ export default defineAgentTool({
     tags: ['napcat', 'qq'],
     keywords: ['AI语音', 'TTS', '文字转语音', 'ai record'],
     scopes: ['group'],
-    async execute({ group_id, character, text }, context) {
-        const endpoint = context.$client;
-        return endpoint.sendGroupAiRecord(group_id, character, text);
+    async execute({ character, text }, context) {
+        return context.$client.sendGroupAiRecord(currentGroup(context), character, text);
     },
 });

package/agents/napcat/skills/napcat-group-media/tools/ai_tts/index.ts

@@ -1,10 +1,10 @@
+import { currentGroup } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ group_id: number; character: string; text: string }>({
-  description: 'AI 文字转语音，在群聊中发送 AI 语音消息。',
+export default defineAgentTool<{ character: string; text: string }>({
+  description: 'AI 文字转语音，在当前群发送 AI 语音消息。',
   inputSchema: z.object({
-    group_id: z.number().describe('群号'),
     character: z.string().describe('AI 语音角色 ID（可先用 napcat_get_ai_characters 查询）'),
     text: z.string().describe('要转为语音的文字'),
   }),
@@ -12,8 +12,7 @@ export default defineAgentTool<{ group_id: number; character: string; text: stri
   tags: ['napcat', 'qq'],
   keywords: ['AI语音', 'TTS', '文字转语音', 'ai record'],
   scopes: ['group'],
-  async execute({ group_id, character, text }: { group_id: number; character: string; text: string }, context) {
-    const endpoint = context.$client;
-      return endpoint.sendGroupAiRecord(group_id, character, text);
+  async execute({ character, text }, context) {
+    return context.$client.sendGroupAiRecord(currentGroup(context), character, text);
   },
 });

package/agents/napcat/skills/napcat-group-media/tools/get_ai_characters/index.js

@@ -1,17 +1,15 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { currentGroup } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '获取 AI 语音角色列表，用于 napcat_ai_tts 的 character 参数。',
-    inputSchema: z.object({
-        group_id: z.number().describe('群号'),
-    }),
+    description: '获取当前群可用的 AI 语音角色列表，用于 napcat_ai_tts 的 character 参数。',
+    inputSchema: z.object({}),
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['AI角色', 'ai characters', '语音角色'],
     scopes: ['group'],
-    async execute({ group_id }, context) {
-        const endpoint = context.$client;
-        return endpoint.getAiCharacters(group_id);
+    async execute(_input, context) {
+        return context.$client.getAiCharacters(currentGroup(context));
     },
 });

package/agents/napcat/skills/napcat-group-media/tools/get_ai_characters/index.ts

@@ -1,17 +1,15 @@
+import { currentGroup } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ group_id: number }>({
-  description: '获取 AI 语音角色列表，用于 napcat_ai_tts 的 character 参数。',
-  inputSchema: z.object({
-    group_id: z.number().describe('群号'),
-  }),
+export default defineAgentTool<Record<string, never>>({
+  description: '获取当前群可用的 AI 语音角色列表，用于 napcat_ai_tts 的 character 参数。',
+  inputSchema: z.object({}),
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['AI角色', 'ai characters', '语音角色'],
   scopes: ['group'],
-  async execute({ group_id }: { group_id: number }, context) {
-    const endpoint = context.$client;
-      return endpoint.getAiCharacters(group_id);
+  async execute(_input, context) {
+    return context.$client.getAiCharacters(currentGroup(context));
   },
 });

package/agents/napcat/skills/napcat-group-settings/tools/get_group_info_ex/index.js

@@ -1,17 +1,15 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { currentGroup } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '获取群组额外详细信息。',
-    inputSchema: z.object({
-        group_id: z.number().describe('群号'),
-    }),
+    description: '获取当前群的额外详细信息。',
+    inputSchema: z.object({}),
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['群详情', '群额外信息', 'group info ex'],
     scopes: ['group'],
-    async execute({ group_id }, context) {
-        const endpoint = context.$client;
-        return endpoint.getGroupInfoEx(group_id);
+    async execute(_input, context) {
+        return context.$client.getGroupInfoEx(currentGroup(context));
     },
 });

package/agents/napcat/skills/napcat-group-settings/tools/get_group_info_ex/index.ts

@@ -1,17 +1,15 @@
+import { currentGroup } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ group_id: number }>({
-  description: '获取群组额外详细信息。',
-  inputSchema: z.object({
-    group_id: z.number().describe('群号'),
-  }),
+export default defineAgentTool<Record<string, never>>({
+  description: '获取当前群的额外详细信息。',
+  inputSchema: z.object({}),
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['群详情', '群额外信息', 'group info ex'],
   scopes: ['group'],
-  async execute({ group_id }: { group_id: number }, context) {
-    const endpoint = context.$client;
-      return endpoint.getGroupInfoEx(group_id);
+  async execute(_input, context) {
+    return context.$client.getGroupInfoEx(currentGroup(context));
   },
 });

package/agents/napcat/skills/napcat-group-settings/tools/get_group_shut_list/index.js

@@ -1,17 +1,15 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { currentGroup } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '获取群禁言列表。',
-    inputSchema: z.object({
-        group_id: z.number().describe('群号'),
-    }),
+    description: '获取当前群的禁言列表。',
+    inputSchema: z.object({}),
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['禁言列表', 'shut list', '被禁言'],
     scopes: ['group'],
-    async execute({ group_id }, context) {
-        const endpoint = context.$client;
-        return endpoint.getGroupShutList(group_id);
+    async execute(_input, context) {
+        return context.$client.getGroupShutList(currentGroup(context));
     },
 });

package/agents/napcat/skills/napcat-group-settings/tools/get_group_shut_list/index.ts

@@ -1,17 +1,15 @@
+import { currentGroup } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ group_id: number }>({
-  description: '获取群禁言列表。',
-  inputSchema: z.object({
-    group_id: z.number().describe('群号'),
-  }),
+export default defineAgentTool<Record<string, never>>({
+  description: '获取当前群的禁言列表。',
+  inputSchema: z.object({}),
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['禁言列表', 'shut list', '被禁言'],
   scopes: ['group'],
-  async execute({ group_id }: { group_id: number }, context) {
-    const endpoint = context.$client;
-      return endpoint.getGroupShutList(group_id);
+  async execute(_input, context) {
+    return context.$client.getGroupShutList(currentGroup(context));
   },
 });

package/agents/napcat/skills/napcat-group-settings/tools/group_sign/index.js

@@ -1,18 +1,16 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { currentGroup } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '群签到/群打卡。',
-    inputSchema: z.object({
-        group_id: z.number().describe('群号'),
-    }),
+    description: '在当前群签到/打卡。',
+    inputSchema: z.object({}),
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['签到', '打卡', 'sign', 'check in'],
     scopes: ['group'],
-    async execute({ group_id }, context) {
-        const endpoint = context.$client;
-        await endpoint.sendGroupSign(group_id);
+    async execute(_input, context) {
+        await context.$client.sendGroupSign(currentGroup(context));
         return { success: true };
     },
 });

package/agents/napcat/skills/napcat-group-settings/tools/group_sign/index.ts

@@ -1,18 +1,16 @@
+import { currentGroup } from "../../../../conversation.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ group_id: number }>({
-  description: '群签到/群打卡。',
-  inputSchema: z.object({
-    group_id: z.number().describe('群号'),
-  }),
+export default defineAgentTool<Record<string, never>>({
+  description: '在当前群签到/打卡。',
+  inputSchema: z.object({}),
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['签到', '打卡', 'sign', 'check in'],
   scopes: ['group'],
-  async execute({ group_id }: { group_id: number }, context) {
-    const endpoint = context.$client;
-      await endpoint.sendGroupSign(group_id);
-      return { success: true };
+  async execute(_input, context) {
+    await context.$client.sendGroupSign(currentGroup(context));
+    return { success: true };
   },
 });

package/agents/napcat/skills/napcat-group-settings/tools/set_group_portrait/index.js

@@ -1,20 +1,21 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { currentGroup } from '../../../../conversation.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '设置群头像。file 为图片 URL 或 base64。',
+    description: '设置当前群的群头像。file 为图片 URL、base64 或宿主本地路径（读取宿主文件，仅全局主人可用）。',
     inputSchema: z.object({
-        group_id: z.number().describe('群号'),
         file: z.string().describe('图片（URL 或 base64）'),
     }),
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['群头像', 'group portrait', '设置群头像'],
-    permissions: ['platform(napcat,scene_admin)'],
+    // `file` may be a host path (OneBot reads `file://`): reading host files is host-global (ADR 0056 §2).
+    permissions: ['owner@global', 'bot:admin'],
     scopes: ['group'],
-    async execute({ group_id, file }, context) {
+    async execute({ file }, context) {
         const endpoint = context.$client;
-        await endpoint.setGroupPortrait(group_id, file);
+        await endpoint.setGroupPortrait(currentGroup(context), file);
         return { success: true };
     },
 });

package/agents/napcat/skills/napcat-group-settings/tools/set_group_portrait/index.ts

@@ -1,20 +1,21 @@
+import { currentGroup } from '../../../../conversation.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ group_id: number; file: string }>({
-  description: '设置群头像。file 为图片 URL 或 base64。',
+export default defineAgentTool<{ file: string }>({
+  description: '设置当前群的群头像。file 为图片 URL、base64 或宿主本地路径（读取宿主文件，仅全局主人可用）。',
   inputSchema: z.object({
-    group_id: z.number().describe('群号'),
     file: z.string().describe('图片（URL 或 base64）'),
   }),
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['群头像', 'group portrait', '设置群头像'],
-  permissions: ['platform(napcat,scene_admin)'],
+  // `file` may be a host path (OneBot reads `file://`): reading host files is host-global (ADR 0056 §2).
+  permissions: ['owner@global', 'bot:admin'],
   scopes: ['group'],
-  async execute({ group_id, file }: { group_id: number; file: string }, context) {
+  async execute({ file }, context) {
     const endpoint = context.$client;
-      await endpoint.setGroupPortrait(group_id, file);
+      await endpoint.setGroupPortrait(currentGroup(context), file);
       return { success: true };
   },
 });

package/agents/napcat/skills/napcat-group-settings/tools/set_title/index.js

@@ -1,22 +1,22 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { messages as t } from "../../../../messages.js";
+import { currentGroup } from '../../../../conversation.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '设置群成员专属头衔。需要群主权限。',
+    description: '设置当前群成员的专属头衔。需要群主权限。',
     inputSchema: z.object({
-        group_id: z.number().describe('群号'),
         user_id: z.number().describe('目标成员 QQ 号'),
         title: z.string().describe('头衔文字'),
     }),
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['头衔', 'title', '专属头衔', '设置头衔'],
-    permissions: ['platform(napcat,scene_owner)'],
+    permissions: ['platform:owner', 'bot:owner'],
     scopes: ['group'],
-    async execute({ group_id, user_id, title }, context) {
+    async execute({ user_id, title }, context) {
         const endpoint = context.$client;
-        await endpoint.setTitle({ groupId: group_id, userId: user_id, title });
+        await endpoint.setTitle({ groupId: currentGroup(context), userId: user_id, title });
         return { success: true, message: t(context.locale, 'memberTitleSet', { p0: user_id, p1: title }) };
     },
 });

package/agents/napcat/skills/napcat-group-settings/tools/set_title/index.ts

@@ -1,22 +1,22 @@
 import { messages as t } from "../../../../messages.js";
+import { currentGroup } from '../../../../conversation.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ group_id: number; user_id: number; title: string }>({
-  description: '设置群成员专属头衔。需要群主权限。',
+export default defineAgentTool<{ user_id: number; title: string }>({
+  description: '设置当前群成员的专属头衔。需要群主权限。',
   inputSchema: z.object({
-    group_id: z.number().describe('群号'),
     user_id: z.number().describe('目标成员 QQ 号'),
     title: z.string().describe('头衔文字'),
   }),
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['头衔', 'title', '专属头衔', '设置头衔'],
-  permissions: ['platform(napcat,scene_owner)'],
+  permissions: ['platform:owner', 'bot:owner'],
   scopes: ['group'],
-  async execute({ group_id, user_id, title }: { group_id: number; user_id: number; title: string }, context) {
+  async execute({ user_id, title }, context) {
     const endpoint = context.$client;
-      await endpoint.setTitle({ groupId: group_id, userId: user_id, title });
+      await endpoint.setTitle({ groupId: currentGroup(context), userId: user_id, title });
       return { success: true, message: t(context.locale, 'memberTitleSet', { p0: user_id, p1: title }) };
   },
 });

package/agents/napcat/skills/napcat-media/tools/ocr_image/index.js

@@ -1,16 +1,17 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { requireRemoteMedia } from "../../../../media.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
     description: '图片 OCR 文字识别。',
     inputSchema: z.object({
-        image: z.string().describe('图片 file 参数（收到消息中的 file 字段或 URL）'),
+        image: z.string().describe('图片 file 参数（收到消息中的 file 字段、http(s) 链接或 base64://；不接受本机路径）'),
     }),
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['OCR', '文字识别', '图片识别', 'ocr'],
     async execute({ image }, context) {
-        const endpoint = context.$client;
-        return endpoint.ocrImage(image);
+        requireRemoteMedia(context, image, 'image');
+        return context.$client.ocrImage(image);
     },
 });

package/agents/napcat/skills/napcat-media/tools/ocr_image/index.ts

@@ -1,16 +1,17 @@
+import { requireRemoteMedia } from "../../../../media.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ image: string }>({
   description: '图片 OCR 文字识别。',
   inputSchema: z.object({
-    image: z.string().describe('图片 file 参数（收到消息中的 file 字段或 URL）'),
+    image: z.string().describe('图片 file 参数（收到消息中的 file 字段、http(s) 链接或 base64://；不接受本机路径）'),
   }),
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['OCR', '文字识别', '图片识别', 'ocr'],
-  async execute({ image }: { image: string }, context) {
-    const endpoint = context.$client;
-      return endpoint.ocrImage(image);
+  async execute({ image }, context) {
+    requireRemoteMedia(context, image, 'image');
+    return context.$client.ocrImage(image);
   },
 });

package/agents/napcat/skills/napcat-messaging/tools/forward_single_msg/index.js

@@ -2,7 +2,7 @@
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '转发单条消息到指定好友或群。',
+    description: '转发单条消息到指定好友或群（可跨会话，仅全局主人可用）。',
     inputSchema: z.object({
         target_type: z.enum(['friend', 'group']).describe('friend 或 group'),
         target_id: z.number().describe('目标好友 QQ 号或群号'),
@@ -11,6 +11,8 @@ export default defineAgentTool({
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['转发', 'forward', '单条转发'],
+    // Reads any message of the account and sends it to any friend / group: a cross-conversation capability.
+    permissions: ['owner@global'],
     async execute({ target_type, target_id, message_id }, context) {
         const endpoint = context.$client;
         if (target_type === 'friend')

package/agents/napcat/skills/napcat-messaging/tools/forward_single_msg/index.ts

@@ -6,7 +6,7 @@ export default defineAgentTool<{
   target_id: number;
   message_id: number;
 }>({
-  description: '转发单条消息到指定好友或群。',
+  description: '转发单条消息到指定好友或群（可跨会话，仅全局主人可用）。',
   inputSchema: z.object({
     target_type: z.enum(['friend', 'group']).describe('friend 或 group'),
     target_id: z.number().describe('目标好友 QQ 号或群号'),
@@ -15,6 +15,8 @@ export default defineAgentTool<{
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['转发', 'forward', '单条转发'],
+  // Reads any message of the account and sends it to any friend / group: a cross-conversation capability.
+  permissions: ['owner@global'],
   async execute({ target_type, target_id, message_id }: {
     target_type: 'friend' | 'group';
     target_id: number;

package/agents/napcat/skills/napcat-messaging/tools/send_forward_msg/index.js

@@ -1,19 +1,25 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { sendToCurrentConversation } from "../../../../conversation.js";
+import { requireSafeForwardNodes } from "../../../../media.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '发送合并转发消息（群聊或私聊）。messages 为转发节点数组。',
+    description: '在当前会话发送合并转发消息。messages 为转发节点数组；引用已有消息的节点（data.id）只能引用当前会话的消息，节点内的图片等媒体只能是 http(s) 链接或 base64://。',
     inputSchema: z.object({
-        message_type: z.enum(['private', 'group']).describe('private 或 group'),
-        id: z.number().describe('群号或 QQ 号'),
         messages: z.string().describe('转发节点 JSON（node 数组）'),
     }),
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['合并转发', 'forward', '转发消息'],
-    async execute({ message_type, id, messages }, context) {
-        const endpoint = context.$client;
+    async execute({ messages }, context) {
         const nodes = typeof messages === 'string' ? JSON.parse(messages) : messages;
-        return endpoint.sendForwardMsg(message_type, id, nodes);
+        if (!Array.isArray(nodes) || !nodes.length)
+            throw new Error('messages must be a non-empty JSON array of forward nodes');
+        await requireSafeForwardNodes(context, nodes);
+        // `napcat:node` is the NapCat adapter's namespaced outbound segment (one OneBot `node` each).
+        return sendToCurrentConversation(context, nodes.map((node) => ({
+            type: 'napcat:node',
+            data: { ...(node?.data ?? {}) },
+        })));
     },
 });

package/agents/napcat/skills/napcat-messaging/tools/send_forward_msg/index.ts

@@ -1,27 +1,24 @@
+import { sendToCurrentConversation } from "../../../../conversation.js";
+import { requireSafeForwardNodes } from "../../../../media.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{
-  message_type: 'private' | 'group';
-  id: number;
-  messages: string;
-}>({
-  description: '发送合并转发消息（群聊或私聊）。messages 为转发节点数组。',
+export default defineAgentTool<{ messages: string }>({
+  description: '在当前会话发送合并转发消息。messages 为转发节点数组；引用已有消息的节点（data.id）只能引用当前会话的消息，节点内的图片等媒体只能是 http(s) 链接或 base64://。',
   inputSchema: z.object({
-    message_type: z.enum(['private', 'group']).describe('private 或 group'),
-    id: z.number().describe('群号或 QQ 号'),
     messages: z.string().describe('转发节点 JSON（node 数组）'),
   }),
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['合并转发', 'forward', '转发消息'],
-  async execute({ message_type, id, messages }: {
-    message_type: 'private' | 'group';
-    id: number;
-    messages: string;
-  }, context) {
-    const endpoint = context.$client;
-    const nodes = typeof messages === 'string' ? JSON.parse(messages) : messages;
-    return endpoint.sendForwardMsg(message_type, id, nodes);
+  async execute({ messages }, context) {
+    const nodes: unknown = typeof messages === 'string' ? JSON.parse(messages) : messages;
+    if (!Array.isArray(nodes) || !nodes.length) throw new Error('messages must be a non-empty JSON array of forward nodes');
+    await requireSafeForwardNodes(context, nodes);
+    // `napcat:node` is the NapCat adapter's namespaced outbound segment (one OneBot `node` each).
+    return sendToCurrentConversation(context, nodes.map((node) => ({
+      type: 'napcat:node',
+      data: { ...((node as { data?: Record<string, unknown> } | null)?.data ?? {}) },
+    })));
   },
 });