@zhin.js/adapter-napcat 7.0.0 → 7.0.1

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @zhin.js/adapter-napcat
 
+## 7.0.1
+
+### Patch Changes
+
+- 1fc78bc: Unify native platform Client access behind the literal `adapter` discriminant. Handlers infer both native events and Clients, while command, inbound/outbound middleware, and both Agent tool authoring surfaces expose the exact operation-scoped Client through a lazy `$client` getter. Definitions without `adapter` keep `$client` typed as `unknown`, and runtime dispatch rejects adapter mismatches before resolving the Client. Bundled platform tools now use this single path instead of model-provided endpoint ids and adapter-specific dependency wrappers. Every adapter registers one Client/EventMap contract, and protocol adapters including NapCat, Milky, OneBot and Satori now produce transport-independent Client objects rather than letting Endpoint instances impersonate Clients.
+- Updated dependencies [e9c6a73]
+- Updated dependencies [4e8117c]
+- Updated dependencies [902fa35]
+- Updated dependencies [54bfd6b]
+- Updated dependencies [12025ee]
+- Updated dependencies [09b14d6]
+- Updated dependencies [1fc78bc]
+  - @zhin.js/agent@1.1.16
+  - @zhin.js/adapter@1.2.1
+  - @zhin.js/core@1.5.14
+  - @zhin.js/host-http@1.0.13
+  - @zhin.js/command@1.0.16
+  - @zhin.js/logger@1.0.77
+  - zhin.js@6.0.14
+  - @zhin.js/feature-kit@1.0.13
+  - @zhin.js/permission@1.0.4
+
 ## 7.0.0
 
 ### Patch Changes

package/README.md

@@ -8,7 +8,7 @@ Zhin.js [NapCatQQ](https://github.com/NapNeko/NapCatQQ) 适配器（Plugin Runti
 - 约定式 `defineAdapter` / `definePlugin`（无需 `usePlugin`）
 - **正向 WebSocket**（`connection: ws`）：应用连 NapCat WS
 - `access_token` 鉴权（Bearer + query）
-- 入站经 `messageGatewayToken`（去重 + 自发过滤）；出站 `send({ conversation, payload })`
+- 入站经 `Endpoint.emit(...)`（去重 + 自发过滤）；出站 `send({ conversation, payload })`
 - 41 个 AI 工具（`agent/tools/`）
 
 ## 安装
@@ -20,13 +20,19 @@ pnpm add @zhin.js/adapter-napcat
 ## Plugin Runtime
 
 - `@zhin.js/adapter` — 约定式 `adapters/napcat.ts`（`defineAdapter`）
-- `@zhin.js/core` — `messageGatewayToken` 入站/出站
+- `@zhin.js/core` — `Endpoint.emit(...)` 入站、`outboundMessageToken` 出站
 - `zhin.js` — `plugin.ts`（`definePlugin`）
 - 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
 
 入站：`gateway.receive({ conversation, message: { conversation, id }, content, sender, metadata })`（`conversation` 为 ConversationRef：私聊 `kind: 'private'`、群聊 `kind: 'group'`，临时会话群容器进 `parent`）  
 出站：`send({ conversation, payload })` → WS `send_private_msg` / `send_group_msg`
 
+## 前置条件
+
+1. 安装并登录 NapCatQQ，启用一个与 Zhin 配置匹配的 OneBot 11 连接。
+2. 正向 WS 需 Zhin 可达 NapCat；反向 WS/HTTP 上报需 NapCat 可达 Zhin HTTP Host。
+3. 两端配置相同的 `access_token`，不要把未鉴权端口暴露到公网。
+
 ## 最小配置
 
 ```yaml
@@ -67,7 +73,7 @@ plugins:
 
 ## 迁移说明（Plugin Runtime）
 
-- **notice / request / meta 侧事件**：经 `sideEventGatewayToken` 归一后分发到 `handlers`（`notice.receive` / `request.receive` / `system.receive`），请求带 `$approve` / `$reject`。消息仍走 `messageGatewayToken`。
+- **notice / request / meta 侧事件**：经 the unified `Endpoint.emit(...)` ingress 归一后分发到 `handlers`（`notice.receive` / `request.receive` / `system.receive`），请求带 `$approve` / `$reject`。消息仍走 `outboundMessageToken`。
 - **群管工具暂未迁移**：旧 Adapter 经 `createSceneManagementTools` 注册踢人 / 禁言 / 群名片等成套 agent 工具；迁移后 `agent/tools/` 仅覆盖 NapCat 扩展 API，其余群管能力可通过 `callApi`（如 `set_group_kick`、`set_group_ban`）作为逃生舱调用。
 - **平台权限门禁**：`plugin.ts` setup 已注册 `registerDefaultScenePlatformPermitChecker('napcat')`，`scene_admin` / `scene_owner` 依据入站 metadata 中的 sender `role`（owner / admin）判定。
 
@@ -76,6 +82,15 @@ plugins:
 - [NapCatQQ](https://github.com/NapNeko/NapCatQQ)
 - [适配器概览](https://zhin.js.org/essentials/adapters)
 
+## 故障排查
+
+| 现象 | 排查 |
+| --- | --- |
+| WS 连接被拒绝 | 检查 NapCat URL、端口与连接方向 |
+| 401 或握手失败 | 确认两端 token 一致，反向代理保留 Authorization |
+| 重复或自身消息触发 | 检查是否同时启用了多条上报连接 |
+| 请求/通知缺失 | 确认 NapCat 上报 notice/request/meta，并查看 Endpoint 对应分类 |
+
 ## 许可证
 
 MIT License

package/adapters/napcat.js

@@ -3,7 +3,6 @@
  * Convention entry: discover `adapters/napcat.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { messageGatewayToken, sideEventGatewayToken } from '@zhin.js/core/runtime';
 import { httpHostToken } from '@zhin.js/host-http';
 import { NapCatHttpEndpoint } from "../lib/http-endpoint.js";
 import { resolveNapCatConfig } from "../lib/protocol.js";
@@ -24,8 +23,6 @@ export default defineAdapter({
     },
     create(context) {
         const config = resolveNapCatConfig(context.config);
-        const gateway = context.use(messageGatewayToken);
-        const sideEvents = context.use(sideEventGatewayToken);
         // 注册到插件运行时状态（napcat.endpoint list 的"运行中"数据源）
         context.use(napcatRuntimeStateToken).endpoints.set(config.id, {
             id: config.id,
@@ -34,8 +31,6 @@ export default defineAdapter({
         if (config.connection === 'wss') {
             return new NapCatWssEndpoint({
                 id: context.id,
-                gateway,
-                sideEvents,
                 http: context.use(httpHostToken),
                 config,
             });
@@ -43,12 +38,10 @@ export default defineAdapter({
         if (config.connection === 'http') {
             return new NapCatHttpEndpoint({
                 id: context.id,
-                gateway,
-                sideEvents,
                 http: context.use(httpHostToken),
                 config,
             });
         }
-        return new NapCatWsEndpoint({ id: context.id, gateway, sideEvents, config });
+        return new NapCatWsEndpoint({ id: context.id, config });
     },
 });

package/adapters/napcat.ts

@@ -2,7 +2,6 @@
  * Convention entry: discover `adapters/napcat.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { messageGatewayToken, sideEventGatewayToken } from '@zhin.js/core/runtime';
 import { httpHostToken } from '@zhin.js/host-http';
 import { NapCatHttpEndpoint } from '../src/http-endpoint.js';
 import { resolveNapCatConfig, type NapCatAdapterConfig } from '../src/protocol.js';
@@ -41,8 +40,6 @@ export default defineAdapter<NapCatAdapterConfig>({
   },
   create(context) {
     const config = resolveNapCatConfig(context.config);
-    const gateway = context.use(messageGatewayToken);
-    const sideEvents = context.use(sideEventGatewayToken);
     // 注册到插件运行时状态（napcat.endpoint list 的"运行中"数据源）
     context.use(napcatRuntimeStateToken).endpoints.set(config.id, {
       id: config.id,
@@ -51,8 +48,6 @@ export default defineAdapter<NapCatAdapterConfig>({
     if (config.connection === 'wss') {
       return new NapCatWssEndpoint({
         id: context.id,
-        gateway,
-        sideEvents,
         http: context.use(httpHostToken),
         config,
       });
@@ -60,12 +55,10 @@ export default defineAdapter<NapCatAdapterConfig>({
     if (config.connection === 'http') {
       return new NapCatHttpEndpoint({
         id: context.id,
-        gateway,
-        sideEvents,
         http: context.use(httpHostToken),
         config,
       });
     }
-    return new NapCatWsEndpoint({ id: context.id, gateway, sideEvents, config });
+    return new NapCatWsEndpoint({ id: context.id, config });
   },
 });

package/agent/tools/ai_tts.ts

@@ -1,21 +1,19 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number; character: string; text: string }>({
+export default defineAgentTool<{ group_id: number; character: string; text: string }>({
   description: 'AI 文字转语音，在群聊中发送 AI 语音消息。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
     character: z.string().describe('AI 语音角色 ID（可先用 napcat_get_ai_characters 查询）'),
     text: z.string().describe('要转为语音的文字'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['AI语音', 'TTS', '文字转语音', 'ai record'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id, character, text }: { endpoint_id: string; group_id: number; character: string; text: string }) {
-    const endpoint = getEndpoint(endpoint_id);
+  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);
   },
 });

package/agent/tools/del_group_notice.ts

@@ -1,21 +1,19 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number; notice_id: string }>({
+export default defineAgentTool<{ group_id: number; notice_id: string }>({
   description: '删除群公告。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
     notice_id: z.string().describe('公告 ID'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['删除公告', 'delete notice'],
   permissions: ['platform(napcat,scene_admin)'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id, notice_id }: { endpoint_id: string; group_id: number; notice_id: string }) {
-    const endpoint = getEndpoint(endpoint_id);
+  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/agent/tools/delete_essence_msg.ts

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

package/agent/tools/delete_friend.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; user_id: number }>({
+export default defineAgentTool<{ user_id: number }>({
   description: '删除好友。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     user_id: z.number().describe('好友 QQ 号'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['删除好友', 'delete friend', '删好友'],
   permissions: ['platform(napcat,scene_admin)'],
-  async execute({ endpoint_id, user_id }: { endpoint_id: string; user_id: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ user_id }: { user_id: number }, context) {
+    const endpoint = context.$client;
       await endpoint.deleteFriend(user_id);
       return { success: true };
   },

package/agent/tools/download_file.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; url: string; thread_count?: number }>({
+export default defineAgentTool<{ url: string; thread_count?: number }>({
   description: '下载文件到 NapCat 缓存目录，返回本地路径。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     url: z.string().describe('文件 URL'),
     thread_count: z.number().optional().describe('下载线程数（可选，默认 1）'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['下载', 'download', '下载文件'],
-  async execute({ endpoint_id, url, thread_count }: { endpoint_id: string; url: string; thread_count?: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ url, thread_count }: { url: string; thread_count?: number }, context) {
+    const endpoint = context.$client;
       return endpoint.downloadFile(url, thread_count || 1);
   },
 });

package/agent/tools/forward_single_msg.ts

@@ -1,30 +1,26 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
 export default defineAgentTool<{
-  endpoint_id: string;
   target_type: 'friend' | 'group';
   target_id: number;
   message_id: number;
 }>({
   description: '转发单条消息到指定好友或群。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     target_type: z.enum(['friend', 'group']).describe('friend 或 group'),
     target_id: z.number().describe('目标好友 QQ 号或群号'),
     message_id: z.number().describe('要转发的消息 ID'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['转发', 'forward', '单条转发'],
-  async execute({ endpoint_id, target_type, target_id, message_id }: {
-    endpoint_id: string;
+  async execute({ target_type, target_id, message_id }: {
     target_type: 'friend' | 'group';
     target_id: number;
     message_id: number;
-  }) {
-    const endpoint = getEndpoint(endpoint_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/get_ai_characters.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
+export default defineAgentTool<{ group_id: number }>({
   description: '获取 AI 语音角色列表，用于 napcat_ai_tts 的 character 参数。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['AI角色', 'ai characters', '语音角色'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id }: { endpoint_id: string; group_id: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ group_id }: { group_id: number }, context) {
+    const endpoint = context.$client;
       return endpoint.getAiCharacters(group_id);
   },
 });

package/agent/tools/get_essence_list.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
+export default defineAgentTool<{ group_id: number }>({
   description: '获取群精华消息列表。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['精华列表', 'essence list'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id }: { endpoint_id: string; group_id: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ group_id }: { group_id: number }, context) {
+    const endpoint = context.$client;
       return endpoint.getEssenceMsgList(group_id);
   },
 });

package/agent/tools/get_friend_msg_history.ts

@@ -1,20 +1,18 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; user_id: number; message_seq?: number; count?: number }>({
+export default defineAgentTool<{ user_id: number; message_seq?: number; count?: number }>({
   description: '获取私聊消息历史记录。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     user_id: z.number().describe('QQ 号'),
     message_seq: z.number().optional().describe('起始消息序号（可选）'),
     count: z.number().optional().describe('获取条数（可选）'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['私聊记录', '好友聊天记录', 'friend history'],
-  async execute({ endpoint_id, user_id, message_seq, count }: { endpoint_id: string; user_id: number; message_seq?: number; count?: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  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/agent/tools/get_group_file_url.ts

@@ -1,21 +1,19 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number; file_id: string; busid: number }>({
+export default defineAgentTool<{ group_id: number; file_id: string; busid: number }>({
   description: '获取群文件下载链接。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
     file_id: z.string().describe('文件 ID'),
     busid: z.number().describe('文件类型 ID'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['文件链接', 'file url', '下载文件'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id, file_id, busid }: { endpoint_id: string; group_id: number; file_id: string; busid: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  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/agent/tools/get_group_info_ex.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
+export default defineAgentTool<{ group_id: number }>({
   description: '获取群组额外详细信息。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['群详情', '群额外信息', 'group info ex'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id }: { endpoint_id: string; group_id: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ group_id }: { group_id: number }, context) {
+    const endpoint = context.$client;
       return endpoint.getGroupInfoEx(group_id);
   },
 });

package/agent/tools/get_group_msg_history.ts

@@ -1,21 +1,19 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number; message_seq?: number; count?: number }>({
+export default defineAgentTool<{ group_id: number; message_seq?: number; count?: number }>({
   description: '获取群消息历史记录。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
     message_seq: z.number().optional().describe('起始消息序号（可选，不传从最新开始）'),
     count: z.number().optional().describe('获取条数（可选）'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['群消息历史', '聊天记录', 'message history'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id, message_seq, count }: { endpoint_id: string; group_id: number; message_seq?: number; count?: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  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/agent/tools/get_group_notice.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
+export default defineAgentTool<{ group_id: number }>({
   description: '获取群公告列表。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['群公告', '获取公告', 'get notice'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id }: { endpoint_id: string; group_id: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ group_id }: { group_id: number }, context) {
+    const endpoint = context.$client;
       return endpoint.getGroupNotice(group_id);
   },
 });

package/agent/tools/get_group_root_files.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
+export default defineAgentTool<{ group_id: number }>({
   description: '获取群根目录文件列表。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['群文件列表', 'group files'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id }: { endpoint_id: string; group_id: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ group_id }: { group_id: number }, context) {
+    const endpoint = context.$client;
       return endpoint.getGroupRootFiles(group_id);
   },
 });

package/agent/tools/get_group_shut_list.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
+export default defineAgentTool<{ group_id: number }>({
   description: '获取群禁言列表。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['禁言列表', 'shut list', '被禁言'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id }: { endpoint_id: string; group_id: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ group_id }: { group_id: number }, context) {
+    const endpoint = context.$client;
       return endpoint.getGroupShutList(group_id);
   },
 });

package/agent/tools/get_mini_app_ark.ts

@@ -1,22 +1,20 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; type: string; title: string; desc: string; pic_url: string; jump_url: string }>({
+export default defineAgentTool<{ type: string; title: string; desc: string; pic_url: string; jump_url: string }>({
   description: '签名小程序卡片（如 B 站分享卡片等）。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     type: z.string().describe('卡片类型'),
     title: z.string().describe('标题'),
     desc: z.string().describe('描述'),
     pic_url: z.string().describe('图片 URL'),
     jump_url: z.string().describe('跳转 URL'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['小程序', 'mini app', '卡片', 'ark'],
-  async execute({ endpoint_id, type, title, desc, pic_url, jump_url }: { endpoint_id: string; type: string; title: string; desc: string; pic_url: string; jump_url: string }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ type, title, desc, pic_url, jump_url }: { type: string; title: string; desc: string; pic_url: string; jump_url: string }, context) {
+    const endpoint = context.$client;
       return endpoint.getMiniAppArk(type, title, desc, pic_url, jump_url);
   },
 });

package/agent/tools/get_user_status.ts

@@ -1,18 +1,16 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; user_id: number }>({
+export default defineAgentTool<{ user_id: number }>({
   description: '获取用户在线状态。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     user_id: z.number().describe('目标 QQ 号'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['在线状态', '用户状态', 'online status'],
-  async execute({ endpoint_id, user_id }: { endpoint_id: string; user_id: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ user_id }: { user_id: number }, context) {
+    const endpoint = context.$client;
       return endpoint.ncGetUserStatus(user_id);
   },
 });

package/agent/tools/group_sign.ts

@@ -1,19 +1,17 @@
 import { defineAgentTool } from '@zhin.js/agent/tools';
 import { z } from 'zod';
-import { getEndpoint } from '../../src/napcat-agent-deps.js';
 
-export default defineAgentTool<{ endpoint_id: string; group_id: number }>({
+export default defineAgentTool<{ group_id: number }>({
   description: '群签到/群打卡。',
   inputSchema: z.object({
-    endpoint_id: z.string().describe('Endpoint 名称'),
     group_id: z.number().describe('群号'),
   }),
-  platforms: ['napcat'],
+  adapter: 'napcat',
   tags: ['napcat', 'qq'],
   keywords: ['签到', '打卡', 'sign', 'check in'],
   scopes: ['group'],
-  async execute({ endpoint_id, group_id }: { endpoint_id: string; group_id: number }) {
-    const endpoint = getEndpoint(endpoint_id);
+  async execute({ group_id }: { group_id: number }, context) {
+    const endpoint = context.$client;
       await endpoint.sendGroupSign(group_id);
       return { success: true };
   },