@zhin.js/adapter-napcat 1.0.1 → 1.1.2

package/agents/napcat/skills/napcat-files-history/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: napcat-files-history
+platforms:
+  - napcat
+description: NapCatQQ 群文件、下载地址和消息历史能力。
+keywords:
+  - "napcat"
+  - "群文件"
+  - "下载"
+  - "消息历史"
+tools:
+  - "upload_group_file"
+  - "get_group_file_url"
+  - "get_group_root_files"
+  - "download_file"
+  - "get_group_msg_history"
+  - "get_friend_msg_history"
+---
+
+# napcat-files-history
+
+文件和历史记录可能包含敏感内容，只读取完成任务所需范围；上传前确认目标群和文件。

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

@@ -0,0 +1,17 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '下载文件到 NapCat 缓存目录，返回本地路径。',
+    inputSchema: z.object({
+        url: z.string().describe('文件 URL'),
+        thread_count: z.number().optional().describe('下载线程数（可选，默认 1）'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['下载', 'download', '下载文件'],
+    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

@@ -0,0 +1,17 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<{ url: string; thread_count?: number }>({
+  description: '下载文件到 NapCat 缓存目录，返回本地路径。',
+  inputSchema: z.object({
+    url: z.string().describe('文件 URL'),
+    thread_count: z.number().optional().describe('下载线程数（可选，默认 1）'),
+  }),
+  adapter: 'napcat',
+  tags: ['napcat', 'qq'],
+  keywords: ['下载', 'download', '下载文件'],
+  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-files-history/tools/get_friend_msg_history/index.js

@@ -0,0 +1,18 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取私聊消息历史记录。',
+    inputSchema: z.object({
+        user_id: z.number().describe('QQ 号'),
+        message_seq: z.number().optional().describe('起始消息序号（可选）'),
+        count: z.number().optional().describe('获取条数（可选）'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['私聊记录', '好友聊天记录', 'friend history'],
+    async execute({ user_id, message_seq, count }, context) {
+        const endpoint = context.$client;
+        return endpoint.getFriendMsgHistory(user_id, message_seq, count);
+    },
+});

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

@@ -0,0 +1,18 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<{ user_id: number; message_seq?: number; count?: number }>({
+  description: '获取私聊消息历史记录。',
+  inputSchema: z.object({
+    user_id: z.number().describe('QQ 号'),
+    message_seq: z.number().optional().describe('起始消息序号（可选）'),
+    count: z.number().optional().describe('获取条数（可选）'),
+  }),
+  adapter: 'napcat',
+  tags: ['napcat', 'qq'],
+  keywords: ['私聊记录', '好友聊天记录', 'friend history'],
+  async execute({ user_id, message_seq, count }: { user_id: number; message_seq?: number; count?: number }, context) {
+    const endpoint = context.$client;
+      return endpoint.getFriendMsgHistory(user_id, message_seq, count);
+  },
+});

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

@@ -0,0 +1,19 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取群文件下载链接。',
+    inputSchema: z.object({
+        group_id: z.number().describe('群号'),
+        file_id: z.string().describe('文件 ID'),
+        busid: z.number().describe('文件类型 ID'),
+    }),
+    adapter: 'napcat',
+    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);
+    },
+});

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

@@ -0,0 +1,19 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<{ group_id: number; 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'),
+  }),
+  adapter: 'napcat',
+  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);
+  },
+});

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

@@ -0,0 +1,19 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取群消息历史记录。',
+    inputSchema: z.object({
+        group_id: z.number().describe('群号'),
+        message_seq: z.number().optional().describe('起始消息序号（可选，不传从最新开始）'),
+        count: z.number().optional().describe('获取条数（可选）'),
+    }),
+    adapter: 'napcat',
+    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);
+    },
+});

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

@@ -0,0 +1,19 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<{ group_id: number; 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('获取条数（可选）'),
+  }),
+  adapter: 'napcat',
+  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);
+  },
+});

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

@@ -0,0 +1,17 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取群根目录文件列表。',
+    inputSchema: z.object({
+        group_id: z.number().describe('群号'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['群文件列表', 'group files'],
+    scopes: ['group'],
+    async execute({ group_id }, context) {
+        const endpoint = context.$client;
+        return endpoint.getGroupRootFiles(group_id);
+    },
+});

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

@@ -0,0 +1,17 @@
+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('群号'),
+  }),
+  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);
+  },
+});

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

@@ -0,0 +1,21 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    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（可选）'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['上传文件', 'upload file', '群文件'],
+    scopes: ['group'],
+    async execute({ group_id, file, name, folder }, context) {
+        const endpoint = context.$client;
+        await endpoint.uploadGroupFile(group_id, file, name, folder);
+        return { success: true };
+    },
+});

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

@@ -0,0 +1,21 @@
+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。',
+  inputSchema: z.object({
+    group_id: z.number().describe('群号'),
+    file: z.string().describe('文件路径或 URL'),
+    name: z.string().describe('文件名'),
+    folder: z.string().optional().describe('目标文件夹 ID（可选）'),
+  }),
+  adapter: 'napcat',
+  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(group_id, file, name, folder);
+      return { success: true };
+  },
+});

package/agents/napcat/skills/napcat-group-content/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: napcat-group-content
+platforms:
+  - napcat
+description: NapCatQQ 群公告与精华消息管理能力。
+keywords:
+  - "napcat"
+  - "群公告"
+  - "精华消息"
+tools:
+  - "set_essence_msg"
+  - "delete_essence_msg"
+  - "get_essence_list"
+  - "send_group_notice"
+  - "get_group_notice"
+  - "del_group_notice"
+---
+
+# napcat-group-content
+
+先读取现有公告或精华列表，再进行创建、删除或变更；删除操作必须复核稳定 ID。

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

@@ -0,0 +1,20 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    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)'],
+    scopes: ['group'],
+    async execute({ group_id, notice_id }, context) {
+        const endpoint = context.$client;
+        await endpoint.deleteGroupNotice(group_id, notice_id);
+        return { success: true };
+    },
+});

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

@@ -0,0 +1,20 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<{ group_id: number; 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)'],
+  scopes: ['group'],
+  async execute({ group_id, notice_id }: { group_id: number; notice_id: string }, context) {
+    const endpoint = context.$client;
+      await endpoint.deleteGroupNotice(group_id, notice_id);
+      return { success: true };
+  },
+});

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

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

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

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

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

@@ -0,0 +1,17 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取群精华消息列表。',
+    inputSchema: z.object({
+        group_id: z.number().describe('群号'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['精华列表', 'essence list'],
+    scopes: ['group'],
+    async execute({ group_id }, context) {
+        const endpoint = context.$client;
+        return endpoint.getEssenceMsgList(group_id);
+    },
+});

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

@@ -0,0 +1,17 @@
+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('群号'),
+  }),
+  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);
+  },
+});

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

@@ -0,0 +1,17 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取群公告列表。',
+    inputSchema: z.object({
+        group_id: z.number().describe('群号'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['群公告', '获取公告', 'get notice'],
+    scopes: ['group'],
+    async execute({ group_id }, context) {
+        const endpoint = context.$client;
+        return endpoint.getGroupNotice(group_id);
+    },
+});

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

@@ -0,0 +1,17 @@
+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('群号'),
+  }),
+  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);
+  },
+});

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

@@ -0,0 +1,21 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '发送群公告。',
+    inputSchema: z.object({
+        group_id: z.number().describe('群号'),
+        content: z.string().describe('公告内容'),
+        image: z.string().optional().describe('图片（URL 或 base64，可选）'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['群公告', 'notice', '公告', '发公告'],
+    permissions: ['platform(napcat,scene_admin)'],
+    scopes: ['group'],
+    async execute({ group_id, content, image }, context) {
+        const endpoint = context.$client;
+        await endpoint.sendGroupNotice(group_id, content, image);
+        return { success: true };
+    },
+});

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

@@ -0,0 +1,21 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<{ group_id: number; content: string; image?: string }>({
+  description: '发送群公告。',
+  inputSchema: z.object({
+    group_id: z.number().describe('群号'),
+    content: z.string().describe('公告内容'),
+    image: z.string().optional().describe('图片（URL 或 base64，可选）'),
+  }),
+  adapter: 'napcat',
+  tags: ['napcat', 'qq'],
+  keywords: ['群公告', 'notice', '公告', '发公告'],
+  permissions: ['platform(napcat,scene_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 };
+  },
+});

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

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

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

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

package/agents/napcat/skills/napcat-group-settings/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: napcat-group-settings
+platforms:
+  - napcat
+description: NapCatQQ 群状态、群头像、头衔与签到设置能力。
+keywords:
+  - "napcat"
+  - "群设置"
+  - "群头像"
+  - "头衔"
+  - "签到"
+  - "禁言"
+tools:
+  - "get_group_shut_list"
+  - "set_group_portrait"
+  - "set_title"
+  - "group_sign"
+  - "get_group_info_ex"
+---
+
+# napcat-group-settings
+
+查询群状态后再修改群设置。头像和头衔变更遵守审批策略，不根据昵称猜测成员。

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

@@ -0,0 +1,17 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '获取群组额外详细信息。',
+    inputSchema: z.object({
+        group_id: z.number().describe('群号'),
+    }),
+    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);
+    },
+});

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

@@ -0,0 +1,17 @@
+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('群号'),
+  }),
+  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);
+  },
+});

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

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

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

@@ -0,0 +1,17 @@
+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('群号'),
+  }),
+  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);
+  },
+});

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

@@ -0,0 +1,18 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+export default defineAgentTool({
+    description: '群签到/群打卡。',
+    inputSchema: z.object({
+        group_id: z.number().describe('群号'),
+    }),
+    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);
+        return { success: true };
+    },
+});