@zhin.js/adapter-napcat 1.1.26 → 1.1.28

package/agents/napcat/messages.js

@@ -1,6 +1,34 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { createMessages } from 'zhin.js/i18n';
 export const messages = createMessages({
+    "messageOutsideGroup": {
+        "zh-CN": "该消息不在当前群中",
+        "en": "The message is not in the current group"
+    },
+    "conversationRequired": {
+        "zh-CN": "此操作仅支持当前 QQ 群或私聊",
+        "en": "This operation requires the current QQ group or private chat"
+    },
+    "privateRequired": {
+        "zh-CN": "此操作仅支持当前私聊",
+        "en": "This operation requires the current private chat"
+    },
+    "messageOutsideConversation": {
+        "zh-CN": "该消息不在当前会话中",
+        "en": "The message is not in the current conversation"
+    },
+    "hostMediaRefused": {
+        "zh-CN": "{p0} 只能是 http(s) 链接、base64:// 数据或平台文件标识，不能是本机路径",
+        "en": "{p0} must be an http(s) URL, base64:// data or a platform file token, not a local path"
+    },
+    "forwardTooDeep": {
+        "zh-CN": "合并转发嵌套过深",
+        "en": "The merged forward is nested too deeply"
+    },
+    "groupRequired": {
+        "zh-CN": "此操作仅支持当前 QQ 群",
+        "en": "This operation requires the current QQ group"
+    },
     "likesSent": {
         "zh-CN": "已给 {p0} 点赞 {p1} 次",
         "en": "Sent {p1} likes to {p0}"
@@ -9,6 +37,10 @@ export const messages = createMessages({
         "zh-CN": "已设置 {p0} 头衔为 \"{p1}\"",
         "en": "Title for {p0} set to \"{p1}\""
     },
+    "pokeTargetRequired": {
+        "zh-CN": "群聊中请指定要戳的成员",
+        "en": "Name the group member to poke"
+    },
     "userPoked": {
         "zh-CN": "已戳 {p0}",
         "en": "Poked {p0}"

package/agents/napcat/messages.ts

@@ -1,6 +1,34 @@
 import { createMessages } from 'zhin.js/i18n';
 
 export const messages = createMessages({
+  "messageOutsideGroup": {
+    "zh-CN": "该消息不在当前群中",
+    "en": "The message is not in the current group"
+  },
+  "conversationRequired": {
+    "zh-CN": "此操作仅支持当前 QQ 群或私聊",
+    "en": "This operation requires the current QQ group or private chat"
+  },
+  "privateRequired": {
+    "zh-CN": "此操作仅支持当前私聊",
+    "en": "This operation requires the current private chat"
+  },
+  "messageOutsideConversation": {
+    "zh-CN": "该消息不在当前会话中",
+    "en": "The message is not in the current conversation"
+  },
+  "hostMediaRefused": {
+    "zh-CN": "{p0} 只能是 http(s) 链接、base64:// 数据或平台文件标识，不能是本机路径",
+    "en": "{p0} must be an http(s) URL, base64:// data or a platform file token, not a local path"
+  },
+  "forwardTooDeep": {
+    "zh-CN": "合并转发嵌套过深",
+    "en": "The merged forward is nested too deeply"
+  },
+  "groupRequired": {
+    "zh-CN": "此操作仅支持当前 QQ 群",
+    "en": "This operation requires the current QQ group"
+  },
   "likesSent": {
     "zh-CN": "已给 {p0} 点赞 {p1} 次",
     "en": "Sent {p1} likes to {p0}"
@@ -9,6 +37,10 @@ export const messages = createMessages({
     "zh-CN": "已设置 {p0} 头衔为 \"{p1}\"",
     "en": "Title for {p0} set to \"{p1}\""
   },
+  "pokeTargetRequired": {
+    "zh-CN": "群聊中请指定要戳的成员",
+    "en": "Name the group member to poke"
+  },
   "userPoked": {
     "zh-CN": "已戳 {p0}",
     "en": "Poked {p0}"

package/agents/napcat/skills/napcat-account/tools/delete_friend/index.js

@@ -9,7 +9,7 @@ export default defineAgentTool({
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['删除好友', 'delete friend', '删好友'],
-    permissions: ['platform(napcat,scene_admin)'],
+    permissions: ['owner@endpoint'],
     async execute({ user_id }, context) {
         const endpoint = context.$client;
         await endpoint.deleteFriend(user_id);

package/agents/napcat/skills/napcat-account/tools/delete_friend/index.ts

@@ -9,7 +9,7 @@ export default defineAgentTool<{ user_id: number }>({
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['删除好友', 'delete friend', '删好友'],
-  permissions: ['platform(napcat,scene_admin)'],
+  permissions: ['owner@endpoint'],
   async execute({ user_id }: { user_id: number }, context) {
     const endpoint = context.$client;
       await endpoint.deleteFriend(user_id);

package/agents/napcat/skills/napcat-account/tools/set_avatar/index.js

@@ -2,13 +2,15 @@
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '修改 QQ 头像。',
+    description: '修改机器人账号的 QQ 头像（仅全局主人可用）。',
     inputSchema: z.object({
         file: z.string().describe('图片（URL 或 base64）'),
     }),
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['头像', 'avatar', '设置头像', '换头像'],
+    // `file` may be a host path (OneBot reads `file://`), and the avatar is the Bot account's identity.
+    permissions: ['owner@global'],
     async execute({ file }, context) {
         const endpoint = context.$client;
         await endpoint.setQQAvatar(file);

package/agents/napcat/skills/napcat-account/tools/set_avatar/index.ts

@@ -2,13 +2,15 @@ import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ file: string }>({
-  description: '修改 QQ 头像。',
+  description: '修改机器人账号的 QQ 头像（仅全局主人可用）。',
   inputSchema: z.object({
     file: z.string().describe('图片（URL 或 base64）'),
   }),
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['头像', 'avatar', '设置头像', '换头像'],
+  // `file` may be a host path (OneBot reads `file://`), and the avatar is the Bot account's identity.
+  permissions: ['owner@global'],
   async execute({ file }: { file: string }, context) {
     const endpoint = context.$client;
       await endpoint.setQQAvatar(file);

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

@@ -2,7 +2,7 @@
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '下载文件到 NapCat 缓存目录，返回本地路径。',
+    description: '下载文件到 NapCat 缓存目录，返回本地路径（写入宿主文件、由宿主发起网络请求，仅全局主人可用）。',
     inputSchema: z.object({
         url: z.string().describe('文件 URL'),
         thread_count: z.number().optional().describe('下载线程数（可选，默认 1）'),
@@ -10,6 +10,8 @@ export default defineAgentTool({
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['下载', 'download', '下载文件'],
+    // Fetches any URL from the host network and writes the host file system: host-global (ADR 0056 §2).
+    permissions: ['owner@global'],
     async execute({ url, thread_count }, context) {
         const endpoint = context.$client;
         return endpoint.downloadFile(url, thread_count || 1);

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

@@ -2,7 +2,7 @@ import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ url: string; thread_count?: number }>({
-  description: '下载文件到 NapCat 缓存目录，返回本地路径。',
+  description: '下载文件到 NapCat 缓存目录，返回本地路径（写入宿主文件、由宿主发起网络请求，仅全局主人可用）。',
   inputSchema: z.object({
     url: z.string().describe('文件 URL'),
     thread_count: z.number().optional().describe('下载线程数（可选，默认 1）'),
@@ -10,6 +10,8 @@ export default defineAgentTool<{ url: string; thread_count?: number }>({
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['下载', 'download', '下载文件'],
+  // Fetches any URL from the host network and writes the host file system: host-global (ADR 0056 §2).
+  permissions: ['owner@global'],
   async execute({ url, thread_count }: { url: string; thread_count?: number }, context) {
     const endpoint = context.$client;
       return endpoint.downloadFile(url, thread_count || 1);

package/agents/napcat/skills/napcat-group-content/tools/del_group_notice/index.js

@@ -1,20 +1,20 @@
 // 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: '删除群公告。',
+    description: '删除当前群的群公告。',
     inputSchema: z.object({
-        group_id: z.number().describe('群号'),
         notice_id: z.string().describe('公告 ID'),
     }),
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['删除公告', 'delete notice'],
-    permissions: ['platform(napcat,scene_admin)'],
+    permissions: ['platform:admin', 'bot:admin'],
     scopes: ['group'],
-    async execute({ group_id, notice_id }, context) {
+    async execute({ notice_id }, context) {
         const endpoint = context.$client;
-        await endpoint.deleteGroupNotice(group_id, notice_id);
+        await endpoint.deleteGroupNotice(currentGroup(context), notice_id);
         return { success: true };
     },
 });

package/agents/napcat/skills/napcat-group-content/tools/del_group_notice/index.ts

@@ -1,20 +1,20 @@
+import { currentGroup } from '../../../../conversation.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ group_id: number; notice_id: string }>({
-  description: '删除群公告。',
+export default defineAgentTool<{ notice_id: string }>({
+  description: '删除当前群的群公告。',
   inputSchema: z.object({
-    group_id: z.number().describe('群号'),
     notice_id: z.string().describe('公告 ID'),
   }),
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['删除公告', 'delete notice'],
-  permissions: ['platform(napcat,scene_admin)'],
+  permissions: ['platform:admin', 'bot:admin'],
   scopes: ['group'],
-  async execute({ group_id, notice_id }: { group_id: number; notice_id: string }, context) {
+  async execute({ notice_id }, context) {
     const endpoint = context.$client;
-      await endpoint.deleteGroupNotice(group_id, notice_id);
+      await endpoint.deleteGroupNotice(currentGroup(context), notice_id);
       return { success: true };
   },
 });

package/agents/napcat/skills/napcat-group-content/tools/delete_essence_msg/index.js

@@ -1,18 +1,20 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { currentGroup, requireMessageInGroup } from '../../../../conversation.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '移除群精华消息。',
+    description: '移除当前群中的精华消息。',
     inputSchema: z.object({
-        message_id: z.number().describe('消息 ID'),
+        message_id: z.number().describe('当前群中的消息 ID'),
     }),
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['取消精华', '移除精华', 'delete essence'],
-    permissions: ['platform(napcat,scene_admin)'],
+    permissions: ['platform:admin', 'bot:admin'],
     scopes: ['group'],
     async execute({ message_id }, context) {
         const endpoint = context.$client;
+        await requireMessageInGroup(context, currentGroup(context), message_id);
         await endpoint.deleteEssenceMsg(message_id);
         return { success: true };
     },

package/agents/napcat/skills/napcat-group-content/tools/delete_essence_msg/index.ts

@@ -1,18 +1,20 @@
+import { currentGroup, requireMessageInGroup } from '../../../../conversation.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ message_id: number }>({
-  description: '移除群精华消息。',
+  description: '移除当前群中的精华消息。',
   inputSchema: z.object({
-    message_id: z.number().describe('消息 ID'),
+    message_id: z.number().describe('当前群中的消息 ID'),
   }),
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['取消精华', '移除精华', 'delete essence'],
-  permissions: ['platform(napcat,scene_admin)'],
+  permissions: ['platform:admin', 'bot:admin'],
   scopes: ['group'],
-  async execute({ message_id }: { message_id: number }, context) {
+  async execute({ message_id }, context) {
     const endpoint = context.$client;
+    await requireMessageInGroup(context, currentGroup(context), message_id);
       await endpoint.deleteEssenceMsg(message_id);
       return { success: true };
   },

package/agents/napcat/skills/napcat-group-content/tools/get_essence_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: ['精华列表', 'essence list'],
     scopes: ['group'],
-    async execute({ group_id }, context) {
-        const endpoint = context.$client;
-        return endpoint.getEssenceMsgList(group_id);
+    async execute(_input, context) {
+        return context.$client.getEssenceMsgList(currentGroup(context));
     },
 });

package/agents/napcat/skills/napcat-group-content/tools/get_essence_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: ['精华列表', 'essence list'],
   scopes: ['group'],
-  async execute({ group_id }: { group_id: number }, context) {
-    const endpoint = context.$client;
-      return endpoint.getEssenceMsgList(group_id);
+  async execute(_input, context) {
+    return context.$client.getEssenceMsgList(currentGroup(context));
   },
 });

package/agents/napcat/skills/napcat-group-content/tools/get_group_notice/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: ['群公告', '获取公告', 'get notice'],
     scopes: ['group'],
-    async execute({ group_id }, context) {
-        const endpoint = context.$client;
-        return endpoint.getGroupNotice(group_id);
+    async execute(_input, context) {
+        return context.$client.getGroupNotice(currentGroup(context));
     },
 });

package/agents/napcat/skills/napcat-group-content/tools/get_group_notice/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: ['群公告', '获取公告', 'get notice'],
   scopes: ['group'],
-  async execute({ group_id }: { group_id: number }, context) {
-    const endpoint = context.$client;
-      return endpoint.getGroupNotice(group_id);
+  async execute(_input, context) {
+    return context.$client.getGroupNotice(currentGroup(context));
   },
 });

package/agents/napcat/skills/napcat-group-content/tools/send_group_notice/index.js

@@ -1,21 +1,23 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { currentGroup } from '../../../../conversation.js';
+import { requireRemoteMedia } from "../../../../media.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '发送群公告。',
+    description: '在当前群发送群公告。',
     inputSchema: z.object({
-        group_id: z.number().describe('群号'),
         content: z.string().describe('公告内容'),
-        image: z.string().optional().describe('图片（URL 或 base64，可选）'),
+        image: z.string().optional().describe('图片（http(s) 链接或 base64://，可选；不接受本机路径）'),
     }),
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['群公告', 'notice', '公告', '发公告'],
-    permissions: ['platform(napcat,scene_admin)'],
+    permissions: ['platform:admin', 'bot:admin'],
     scopes: ['group'],
-    async execute({ group_id, content, image }, context) {
-        const endpoint = context.$client;
-        await endpoint.sendGroupNotice(group_id, content, image);
+    async execute({ content, image }, context) {
+        if (image)
+            requireRemoteMedia(context, image, 'image');
+        await context.$client.sendGroupNotice(currentGroup(context), content, image);
         return { success: true };
     },
 });

package/agents/napcat/skills/napcat-group-content/tools/send_group_notice/index.ts

@@ -1,21 +1,22 @@
+import { currentGroup } from '../../../../conversation.js';
+import { requireRemoteMedia } from "../../../../media.js";
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
-export default defineAgentTool<{ group_id: number; content: string; image?: string }>({
-  description: '发送群公告。',
+export default defineAgentTool<{ content: string; image?: string }>({
+  description: '在当前群发送群公告。',
   inputSchema: z.object({
-    group_id: z.number().describe('群号'),
     content: z.string().describe('公告内容'),
-    image: z.string().optional().describe('图片（URL 或 base64，可选）'),
+    image: z.string().optional().describe('图片（http(s) 链接或 base64://，可选；不接受本机路径）'),
   }),
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['群公告', 'notice', '公告', '发公告'],
-  permissions: ['platform(napcat,scene_admin)'],
+  permissions: ['platform:admin', 'bot:admin'],
   scopes: ['group'],
-  async execute({ group_id, content, image }: { group_id: number; content: string; image?: string }, context) {
-    const endpoint = context.$client;
-      await endpoint.sendGroupNotice(group_id, content, image);
-      return { success: true };
+  async execute({ content, image }, context) {
+    if (image) requireRemoteMedia(context, image, 'image');
+    await context.$client.sendGroupNotice(currentGroup(context), content, image);
+    return { success: true };
   },
 });

package/agents/napcat/skills/napcat-group-content/tools/set_essence_msg/index.js

@@ -1,18 +1,20 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { currentGroup, requireMessageInGroup } from '../../../../conversation.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 export default defineAgentTool({
-    description: '设置群精华消息。',
+    description: '把当前群中的消息设为精华。',
     inputSchema: z.object({
-        message_id: z.number().describe('消息 ID'),
+        message_id: z.number().describe('当前群中的消息 ID'),
     }),
     adapter: 'napcat',
     tags: ['napcat', 'qq'],
     keywords: ['精华', 'essence', '设精', '加精'],
-    permissions: ['platform(napcat,scene_admin)'],
+    permissions: ['platform:admin', 'bot:admin'],
     scopes: ['group'],
     async execute({ message_id }, context) {
         const endpoint = context.$client;
+        await requireMessageInGroup(context, currentGroup(context), message_id);
         await endpoint.setEssenceMsg(message_id);
         return { success: true };
     },

package/agents/napcat/skills/napcat-group-content/tools/set_essence_msg/index.ts

@@ -1,18 +1,20 @@
+import { currentGroup, requireMessageInGroup } from '../../../../conversation.js';
 import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ message_id: number }>({
-  description: '设置群精华消息。',
+  description: '把当前群中的消息设为精华。',
   inputSchema: z.object({
-    message_id: z.number().describe('消息 ID'),
+    message_id: z.number().describe('当前群中的消息 ID'),
   }),
   adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['精华', 'essence', '设精', '加精'],
-  permissions: ['platform(napcat,scene_admin)'],
+  permissions: ['platform:admin', 'bot:admin'],
   scopes: ['group'],
-  async execute({ message_id }: { message_id: number }, context) {
+  async execute({ message_id }, context) {
     const endpoint = context.$client;
+    await requireMessageInGroup(context, currentGroup(context), message_id);
       await endpoint.setEssenceMsg(message_id);
       return { success: true };
   },

package/agents/napcat/skills/napcat-group-files-history/tools/get_group_file_url/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: '获取群文件下载链接。',
+    description: '获取当前群的群文件下载链接。',
     inputSchema: z.object({
-        group_id: z.number().describe('群号'),
         file_id: z.string().describe('文件 ID'),
         busid: z.number().describe('文件类型 ID'),
     }),
@@ -12,8 +12,7 @@ export default defineAgentTool({
     tags: ['napcat', 'qq'],
     keywords: ['文件链接', 'file url', '下载文件'],
     scopes: ['group'],
-    async execute({ group_id, file_id, busid }, context) {
-        const endpoint = context.$client;
-        return endpoint.getGroupFileUrl(group_id, file_id, busid);
+    async execute({ file_id, busid }, context) {
+        return context.$client.getGroupFileUrl(currentGroup(context), file_id, busid);
     },
 });

package/agents/napcat/skills/napcat-group-files-history/tools/get_group_file_url/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_id: string; busid: number }>({
-  description: '获取群文件下载链接。',
+export default defineAgentTool<{ file_id: string; busid: number }>({
+  description: '获取当前群的群文件下载链接。',
   inputSchema: z.object({
-    group_id: z.number().describe('群号'),
     file_id: z.string().describe('文件 ID'),
     busid: z.number().describe('文件类型 ID'),
   }),
@@ -12,8 +12,7 @@ export default defineAgentTool<{ group_id: number; file_id: string; busid: numbe
   tags: ['napcat', 'qq'],
   keywords: ['文件链接', 'file url', '下载文件'],
   scopes: ['group'],
-  async execute({ group_id, file_id, busid }: { group_id: number; file_id: string; busid: number }, context) {
-    const endpoint = context.$client;
-      return endpoint.getGroupFileUrl(group_id, file_id, busid);
+  async execute({ file_id, busid }, context) {
+    return context.$client.getGroupFileUrl(currentGroup(context), file_id, busid);
   },
 });

package/agents/napcat/skills/napcat-group-files-history/tools/get_group_msg_history/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: '获取群消息历史记录。',
+    description: '获取当前群的消息历史记录。',
     inputSchema: z.object({
-        group_id: z.number().describe('群号'),
         message_seq: z.number().optional().describe('起始消息序号（可选，不传从最新开始）'),
         count: z.number().optional().describe('获取条数（可选）'),
     }),
@@ -12,8 +12,7 @@ export default defineAgentTool({
     tags: ['napcat', 'qq'],
     keywords: ['群消息历史', '聊天记录', 'message history'],
     scopes: ['group'],
-    async execute({ group_id, message_seq, count }, context) {
-        const endpoint = context.$client;
-        return endpoint.getGroupMsgHistory(group_id, message_seq, count);
+    async execute({ message_seq, count }, context) {
+        return context.$client.getGroupMsgHistory(currentGroup(context), message_seq, count);
     },
 });

package/agents/napcat/skills/napcat-group-files-history/tools/get_group_msg_history/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; message_seq?: number; count?: number }>({
-  description: '获取群消息历史记录。',
+export default defineAgentTool<{ message_seq?: number; count?: number }>({
+  description: '获取当前群的消息历史记录。',
   inputSchema: z.object({
-    group_id: z.number().describe('群号'),
     message_seq: z.number().optional().describe('起始消息序号（可选，不传从最新开始）'),
     count: z.number().optional().describe('获取条数（可选）'),
   }),
@@ -12,8 +12,7 @@ export default defineAgentTool<{ group_id: number; message_seq?: number; count?:
   tags: ['napcat', 'qq'],
   keywords: ['群消息历史', '聊天记录', 'message history'],
   scopes: ['group'],
-  async execute({ group_id, message_seq, count }: { group_id: number; message_seq?: number; count?: number }, context) {
-    const endpoint = context.$client;
-      return endpoint.getGroupMsgHistory(group_id, message_seq, count);
+  async execute({ message_seq, count }, context) {
+    return context.$client.getGroupMsgHistory(currentGroup(context), message_seq, count);
   },
 });

package/agents/napcat/skills/napcat-group-files-history/tools/get_group_root_files/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 files'],
     scopes: ['group'],
-    async execute({ group_id }, context) {
-        const endpoint = context.$client;
-        return endpoint.getGroupRootFiles(group_id);
+    async execute(_input, context) {
+        return context.$client.getGroupRootFiles(currentGroup(context));
     },
 });