@zhin.js/adapter-napcat 1.1.0 → 1.1.2

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/{agent/tools/get_group_root_files.ts → agents/napcat/skills/napcat-files-history/tools/get_group_root_files/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ group_id: number }>({

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/{agent/tools/upload_group_file.ts → agents/napcat/skills/napcat-files-history/tools/upload_group_file/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ group_id: number; file: string; name: string; folder?: string }>({

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/{agent/tools/del_group_notice.ts → agents/napcat/skills/napcat-group-content/tools/del_group_notice/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ group_id: number; notice_id: string }>({

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/{agent/tools/delete_essence_msg.ts → agents/napcat/skills/napcat-group-content/tools/delete_essence_msg/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ message_id: number }>({

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/{agent/tools/get_essence_list.ts → agents/napcat/skills/napcat-group-content/tools/get_essence_list/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ group_id: number }>({

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/{agent/tools/get_group_notice.ts → agents/napcat/skills/napcat-group-content/tools/get_group_notice/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ group_id: number }>({

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/{agent/tools/send_group_notice.ts → agents/napcat/skills/napcat-group-content/tools/send_group_notice/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ group_id: number; content: string; image?: string }>({

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/{agent/tools/set_essence_msg.ts → agents/napcat/skills/napcat-group-content/tools/set_essence_msg/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ message_id: number }>({

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/{agent/tools/get_group_info_ex.ts → agents/napcat/skills/napcat-group-settings/tools/get_group_info_ex/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ group_id: number }>({

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/{agent/tools/get_group_shut_list.ts → agents/napcat/skills/napcat-group-settings/tools/get_group_shut_list/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ group_id: number }>({

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 };
+    },
+});

package/{agent/tools/group_sign.ts → agents/napcat/skills/napcat-group-settings/tools/group_sign/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ group_id: number }>({

package/agents/napcat/skills/napcat-group-settings/tools/set_group_portrait/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: '设置群头像。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)'],
+    scopes: ['group'],
+    async execute({ group_id, file }, context) {
+        const endpoint = context.$client;
+        await endpoint.setGroupPortrait(group_id, file);
+        return { success: true };
+    },
+});

package/{agent/tools/set_group_portrait.ts → agents/napcat/skills/napcat-group-settings/tools/set_group_portrait/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ group_id: number; file: string }>({

package/agents/napcat/skills/napcat-group-settings/tools/set_title/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('群号'),
+        user_id: z.number().describe('目标成员 QQ 号'),
+        title: z.string().describe('头衔文字'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['头衔', 'title', '专属头衔', '设置头衔'],
+    permissions: ['platform(napcat,scene_owner)'],
+    scopes: ['group'],
+    async execute({ group_id, user_id, title }, context) {
+        const endpoint = context.$client;
+        await endpoint.setTitle(group_id, user_id, title);
+        return { success: true, message: `已设置 ${user_id} 头衔为 "${title}"` };
+    },
+});

package/{agent/tools/set_title.ts → agents/napcat/skills/napcat-group-settings/tools/set_title/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ group_id: number; user_id: number; title: string }>({

package/agents/napcat/skills/napcat-media/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: napcat-media
+platforms:
+  - napcat
+description: NapCatQQ TTS、OCR、小程序卡片与翻译能力。
+keywords:
+  - "napcat"
+  - "tts"
+  - "ocr"
+  - "语音"
+  - "翻译"
+  - "小程序"
+tools:
+  - "ai_tts"
+  - "get_ai_characters"
+  - "ocr_image"
+  - "get_mini_app_ark"
+  - "translate"
+---
+
+# napcat-media
+
+按媒体任务选择单个工具。生成语音前先确定角色；OCR 与翻译结果保留不确定性。

package/agents/napcat/skills/napcat-media/tools/ai_tts/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: 'AI 文字转语音，在群聊中发送 AI 语音消息。',
+    inputSchema: z.object({
+        group_id: z.number().describe('群号'),
+        character: z.string().describe('AI 语音角色 ID（可先用 napcat_get_ai_characters 查询）'),
+        text: z.string().describe('要转为语音的文字'),
+    }),
+    adapter: 'napcat',
+    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);
+    },
+});

package/{agent/tools/ai_tts.ts → agents/napcat/skills/napcat-media/tools/ai_tts/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ group_id: number; character: string; text: string }>({

package/agents/napcat/skills/napcat-media/tools/get_ai_characters/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: '获取 AI 语音角色列表，用于 napcat_ai_tts 的 character 参数。',
+    inputSchema: z.object({
+        group_id: z.number().describe('群号'),
+    }),
+    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);
+    },
+});

package/{agent/tools/get_ai_characters.ts → agents/napcat/skills/napcat-media/tools/get_ai_characters/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ group_id: number }>({

package/agents/napcat/skills/napcat-media/tools/get_mini_app_ark/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: '签名小程序卡片（如 B 站分享卡片等）。',
+    inputSchema: z.object({
+        type: z.string().describe('卡片类型'),
+        title: z.string().describe('标题'),
+        desc: z.string().describe('描述'),
+        pic_url: z.string().describe('图片 URL'),
+        jump_url: z.string().describe('跳转 URL'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['小程序', 'mini app', '卡片', 'ark'],
+    async execute({ type, title, desc, pic_url, jump_url }, context) {
+        const endpoint = context.$client;
+        return endpoint.getMiniAppArk(type, title, desc, pic_url, jump_url);
+    },
+});

package/{agent/tools/get_mini_app_ark.ts → agents/napcat/skills/napcat-media/tools/get_mini_app_ark/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ type: string; title: string; desc: string; pic_url: string; jump_url: string }>({

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

@@ -0,0 +1,16 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+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）'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['OCR', '文字识别', '图片识别', 'ocr'],
+    async execute({ image }, context) {
+        const endpoint = context.$client;
+        return endpoint.ocrImage(image);
+    },
+});

package/{agent/tools/ocr_image.ts → agents/napcat/skills/napcat-media/tools/ocr_image/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ image: string }>({

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

@@ -0,0 +1,16 @@
+// 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({
+        text: z.string().describe('要翻译的英文文本'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['翻译', 'translate', '英译中'],
+    async execute({ text }, context) {
+        const endpoint = context.$client;
+        return endpoint.translateEn2Zh(text);
+    },
+});

package/{agent/tools/translate.ts → agents/napcat/skills/napcat-media/tools/translate/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ text: string }>({

package/agents/napcat/skills/napcat-messaging/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: napcat-messaging
+platforms:
+  - napcat
+description: NapCatQQ 戳一戳、reaction、转发和已读操作。
+keywords:
+  - "napcat"
+  - "消息"
+  - "reaction"
+  - "转发"
+  - "已读"
+tools:
+  - "send_poke"
+  - "set_emoji_reaction"
+  - "send_forward_msg"
+  - "forward_single_msg"
+  - "mark_msg_as_read"
+---
+
+# napcat-messaging
+
+消息互动只使用当前会话中的稳定消息 ID 和目标 ID，写操作遵守审批策略。

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

@@ -0,0 +1,22 @@
+// 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({
+        target_type: z.enum(['friend', 'group']).describe('friend 或 group'),
+        target_id: z.number().describe('目标好友 QQ 号或群号'),
+        message_id: z.number().describe('要转发的消息 ID'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['转发', 'forward', '单条转发'],
+    async execute({ target_type, target_id, message_id }, context) {
+        const endpoint = context.$client;
+        if (target_type === 'friend')
+            await endpoint.forwardFriendSingleMsg(target_id, message_id);
+        else
+            await endpoint.forwardGroupSingleMsg(target_id, message_id);
+        return { success: true };
+    },
+});

package/{agent/tools/forward_single_msg.ts → agents/napcat/skills/napcat-messaging/tools/forward_single_msg/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{

package/agents/napcat/skills/napcat-messaging/tools/mark_msg_as_read/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({
+        message_id: z.number().describe('消息 ID'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['已读', 'mark read', '标记已读'],
+    async execute({ message_id }, context) {
+        const endpoint = context.$client;
+        await endpoint.markMsgAsRead(message_id);
+        return { success: true };
+    },
+});

package/{agent/tools/mark_msg_as_read.ts → agents/napcat/skills/napcat-messaging/tools/mark_msg_as_read/index.ts}

@@ -1,4 +1,4 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
 
 export default defineAgentTool<{ message_id: number }>({