@zhin.js/adapter-napcat 1.0.1 → 1.1.2

package/{skills/napcat/PERMITS.md → PERMITS.md}

@@ -13,7 +13,7 @@ OneBot `sender.role` 透传：`owner` · `admin` · `member`。
 
 | `platform(napcat,…)` | 含义 |
 |----------------------|------|
-| `group_owner` | 群主 |
-| `group_admin` | 群管理员（含群主） |
+| `scene_owner` | 群主 |
+| `scene_admin` | 群管理员（含群主） |
 
-使用 core 默认 `createGroupRolePlatformChecker`。
+使用 core 默认 `createSceneRolePlatformChecker`。

package/README.md

@@ -1,131 +1,99 @@
 # @zhin.js/adapter-napcat
 
-Zhin.js NapCatQQ 适配器，支持 OneBot11 标准 + go-cqhttp 扩展 + NapCat 独有 API。
+Zhin.js [NapCatQQ](https://github.com/NapNeko/NapCatQQ) 适配器（Plugin Runtime，OneBot 11 + NapCat 扩展）。默认 **正向 WebSocket 客户端**（`connection: ws`）；亦支持 **反向 WS** 与 **HTTP POST 上报**（经 `httpHostToken`）。
 
 ## 功能特性
 
-- 完整 OneBot v11 协议兼容 + go-cqhttp 扩展 + NapCat 独有 API（92+ 接口）
-- **单一适配器**：`context: napcat`，通过 `connection` 选择连接方式
-- **正向 WebSocket**（`connection: ws`）：应用连 NapCat 的 WS
-- **反向 WebSocket**（`connection: wss`）：应用开 WS 服务端，NapCat 连上来
-- **HTTP API + POST 上报**（`connection: http`）：出站 HTTP 调用，入站 webhook
-- Access Token 认证支持（Bearer / HMAC 签名）
-- 自动重连机制（WS）与心跳检测
-- 群聊和私聊消息处理
-- 入站消息去重与 bot 自发消息过滤
-- Typing Indicator（处理中提示：群聊表情回应 / 私聊输入状态）
-- 41 个 AI 工具（群管、戳一戳、表情回应、精华消息、群公告、AI 语音等）
-- Console 管理页面（`/console/napcat`）
-- Agent Prompt 贡献器（deferred 任务自动优选 napcat 工具）
+- OneBot 11 + go-cqhttp 扩展 + NapCat 独有 API
+- 约定式 `defineAdapter` / `definePlugin`（无需 `usePlugin`）
+- **正向 WebSocket**（`connection: ws`）：应用连 NapCat WS
+- `access_token` 鉴权（Bearer + query）
+- 入站经 `Endpoint.emit(...)`（去重 + 自发过滤）；出站 `send({ conversation, payload })`
+- 41 个 AI 工具（`tools/`）
 
 ## 安装
 
 ```bash
-pnpm add @zhin.js/adapter-napcat ws
+pnpm add @zhin.js/adapter-napcat
 ```
 
-反向 WS / HTTP 模式需同时启用 `@zhin.js/host-router`。
+## Plugin Runtime
 
-## 配置
+- `@zhin.js/adapter` — 约定式 `adapters/napcat/index.ts`（`defineAdapter`）
+- `@zhin.js/core` — `Endpoint.emit(...)` 入站、`outboundMessageToken` 出站
+- `zhin.js` — `plugin.ts`（`definePlugin`）
+- 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
 
-所有 Endpoint 使用 **同一 context：`napcat`**，通过 **`connection`** 区分连接方式。
+入站：`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`
 
-### 正向 WebSocket（connection: ws）
+## 前置条件
+
+1. 安装并登录 NapCatQQ，启用一个与 Zhin 配置匹配的 OneBot 11 连接。
+2. 正向 WS 需 Zhin 可达 NapCat；反向 WS/HTTP 上报需 NapCat 可达 Zhin HTTP Host。
+3. 两端配置相同的 `access_token`，不要把未鉴权端口暴露到公网。
+
+## 最小配置
 
 ```yaml
+# zhin.config.yml（Plugin Runtime）
 plugins:
-  - "@zhin.js/adapter-napcat"
-
-endpoints:
-  - context: napcat
+  napcat:
     connection: ws
-    name: my-bot
-    url: "ws://127.0.0.1:3001"
-    access_token: "${NAPCAT_TOKEN}"
     reconnect_interval: 5000
     heartbeat_interval: 30000
+    endpoints:
+      - id: my-bot
+        url: "ws://127.0.0.1:3001"
+        access_token: "${NAPCAT_TOKEN}"
 ```
 
-### 反向 WebSocket（connection: wss）
+AdapterIndex 会把实例级连接默认值合并进每个 endpoint；协议实现只接收一份展开后的
+endpoint 配置，不会从环境变量推断 endpoint id。
 
-```yaml
-plugins:
-  - "@zhin.js/host-router"
-  - "@zhin.js/adapter-napcat"
-
-endpoints:
-  - context: napcat
-    connection: wss
-    name: my-bot
-    path: "/napcat/ws"
-    access_token: "${NAPCAT_TOKEN}"
-    heartbeat_interval: 30000
-```
+根插件 `zhin.plugins`（或项目图）需引用 `@zhin.js/adapter-napcat`（`instanceKey: napcat`）。
 
-### HTTP API + POST 上报（connection: http）
+## 连接方式
 
-```yaml
-plugins:
-  - "@zhin.js/host-router"
-  - "@zhin.js/adapter-napcat"
-
-endpoints:
-  - context: napcat
-    connection: http
-    name: my-bot
-    http_url: "http://127.0.0.1:3000"
-    post_path: "/napcat/post"
-    access_token: "${NAPCAT_TOKEN}"
-    poll_interval: 30000
-```
+| connection | 状态 |
+|------------|------|
+| `ws` | 已实现（推荐） |
+| `wss` | 已实现：反向 WS（httpHostToken） |
+| `http` | 已实现：POST 入站 + `http_url/{action}` 出站 |
 
-### Typing Indicator（处理中提示）
+## 鉴权
 
-```yaml
-endpoints:
-  - context: napcat
-    connection: ws
-    name: my-bot
-    url: "ws://127.0.0.1:3001"
-    typingIndicator:
-      enabled: true
-      defaultEmoji: "128516"
-      privateConfig:
-        type: "message"
-        message: "正在思考中..."
-      groupConfig:
-        type: "reaction"
-        emoji: "128516"
-```
+- **Bearer**：`Authorization: Bearer <access_token>`
+- 正向 WS 在 Upgrade 时附带请求头，并在 URL query 写入 `access_token`
+
+## AI 工具
 
-## NapCat 独有能力
+| 类别 | 路径 |
+|------|------|
+| Permit 词汇 | `PERMITS.md` |
+| 平台工具 | `tools/<name>/index.ts` |
+| 技能说明 | `agents/napcat/skills/napcat-*/SKILL.md`（按消息、群内容、群设置、文件历史、媒体和账号拆分） |
 
-相比标准 OneBot11 适配器，NapCat 额外支持：
+## 迁移说明（Plugin Runtime）
 
-- 戳一戳（群聊 / 私聊）
-- 表情回应（贴表情）
-- 合并 / 单条消息转发
-- 精华消息管理
-- 群公告管理
-- 群文件管理
-- AI 语音 TTS
-- 图片 OCR 文字识别
-- 小程序卡片签名
-- 个人资料 / 头像 / 签名修改
-- 在线状态设置
-- 消息历史查询
-- 英译中翻译
+- **notice / request / meta 侧事件**：经 the unified `Endpoint.emit(...)` ingress 归一后分发到 `handlers`（`notice.receive` / `request.receive` / `system.receive`），请求带 `$approve` / `$reject`。消息仍走 `outboundMessageToken`。
+- **群管工具暂未迁移**：旧 Adapter 经 `createSceneManagementTools` 注册踢人 / 禁言 / 群名片等成套 agent 工具；迁移后 `tools/` 仅覆盖 NapCat 扩展 API，其余群管能力可通过 `callApi`（如 `set_group_kick`、`set_group_ban`）作为逃生舱调用。
+- **平台权限门禁**：`plugin.ts` setup 通过 generation-owned `permissionHostToken` 调用 `host.registerPlatform('napcat', createSceneRolePlatformChecker())`，`scene_admin` / `scene_owner` 依据入站 metadata 中的 sender `role`（owner / admin）判定。
 
-## AI 工具
+## 文档链接
 
-适配器自动注册 41 个 AI 工具（7 个群管理标准工具 + 34 个 NapCat 扩展工具），详见 `skills/napcat/SKILL.md`。
+- [NapCatQQ](https://github.com/NapNeko/NapCatQQ)
+- [适配器概览](https://zhin.js.org/essentials/adapters)
 
-## full-bot L4 参考
+## 故障排查
 
-[`examples/full-bot`](../../../examples/full-bot/) 默认加载本适配器（`endpoints` 段需自行填写 `ONEBOT11_*` 后取消注释）。
+| 现象 | 排查 |
+| --- | --- |
+| WS 连接被拒绝 | 检查 NapCat URL、端口与连接方向 |
+| 401 或握手失败 | 确认两端 token 一致，反向代理保留 Authorization |
+| 重复或自身消息触发 | 检查是否同时启用了多条上报连接 |
+| 请求/通知缺失 | 确认 NapCat 上报 notice/request/meta，并查看 Endpoint 对应分类 |
 
-- 入站 → `ZhinAgent` → 出站走 `Adapter.sendMessage` 统一链路
-- 契约测试：`plugins/adapters/napcat/tests/l4-contract.test.ts` + `integration.test.ts`（adapter-harness）
-- CI：`L4_SKIP_PLATFORM=1` 跳过实机；本地验证不设该变量并可配置 `ONEBOT11_WS_URL`
+## 许可证
 
-详见 [full-bot ACCEPTANCE.md](../../../examples/full-bot/ACCEPTANCE.md)。
+MIT License

package/adapters/napcat/index.js

@@ -0,0 +1,47 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+/**
+ * Convention entry: discover `adapters/napcat/index.ts` → defineAdapter.
+ */
+import { defineAdapter } from 'zhin.js/adapter';
+import { httpHostToken } from '@zhin.js/host-http';
+import { NapCatHttpEndpoint } from "../../lib/http-endpoint.js";
+import { resolveNapCatConfig } from "../../lib/protocol.js";
+import { NapCatWsEndpoint } from "../../lib/ws-endpoint.js";
+import { NapCatWssEndpoint } from "../../lib/wss-endpoint.js";
+import { napcatRuntimeStateToken } from "../../lib/napcat-runtime-state.js";
+export { NapCatHttpEndpoint, } from "../../lib/http-endpoint.js";
+export { NapCatWsEndpoint, } from "../../lib/ws-endpoint.js";
+export { NapCatWssEndpoint, } from "../../lib/wss-endpoint.js";
+export default defineAdapter({
+    capabilities: ['inbound', 'outbound'],
+    operations: ['recall'],
+    // OneBot file 参数原生消费 url / base64:// 媒体，file:// 本地路径由 NapCat 侧读盘；
+    // 无卡片交互面，交互段降级纯文本。
+    segments: {
+        outboundMedia: ['url', 'base64', 'path'],
+        interactive: 'text',
+    },
+    create(context) {
+        const config = resolveNapCatConfig(context.config);
+        // 注册到插件运行时状态（napcat endpoint list 的"运行中"数据源）
+        context.use(napcatRuntimeStateToken).endpoints.set(config.id, {
+            id: config.id,
+            mode: config.connection,
+        });
+        if (config.connection === 'wss') {
+            return new NapCatWssEndpoint({
+                id: context.id,
+                http: context.use(httpHostToken),
+                config,
+            });
+        }
+        if (config.connection === 'http') {
+            return new NapCatHttpEndpoint({
+                id: context.id,
+                http: context.use(httpHostToken),
+                config,
+            });
+        }
+        return new NapCatWsEndpoint({ id: context.id, config });
+    },
+});

package/adapters/napcat/index.ts

@@ -0,0 +1,64 @@
+/**
+ * Convention entry: discover `adapters/napcat/index.ts` → defineAdapter.
+ */
+import { defineAdapter } from 'zhin.js/adapter';
+import { httpHostToken } from '@zhin.js/host-http';
+import { NapCatHttpEndpoint } from '../../src/http-endpoint.js';
+import { resolveNapCatConfig, type NapCatEndpointConfig } from '../../src/protocol.js';
+import { NapCatWsEndpoint } from '../../src/ws-endpoint.js';
+import { NapCatWssEndpoint } from '../../src/wss-endpoint.js';
+import { napcatRuntimeStateToken } from '../../src/napcat-runtime-state.js';
+
+export {
+  NapCatHttpEndpoint,
+  type NapCatHttpEndpointOptions,
+} from '../../src/http-endpoint.js';
+export {
+  NapCatWsEndpoint,
+  type NapCatWsEndpointOptions,
+} from '../../src/ws-endpoint.js';
+export {
+  NapCatWssEndpoint,
+  type NapCatWssEndpointOptions,
+} from '../../src/wss-endpoint.js';
+export type { NapCatWsSocket, NapCatWsCreateOptions } from '../../src/ws-types.js';
+
+declare module '@zhin.js/core' {
+  interface AdapterEndpoints {
+    napcat: import('../../src/ws-endpoint.js').NapCatWsEndpoint;
+  }
+}
+
+export default defineAdapter<NapCatEndpointConfig>({
+  capabilities: ['inbound', 'outbound'],
+  operations: ['recall'],
+  // OneBot file 参数原生消费 url / base64:// 媒体，file:// 本地路径由 NapCat 侧读盘；
+  // 无卡片交互面，交互段降级纯文本。
+  segments: {
+    outboundMedia: ['url', 'base64', 'path'],
+    interactive: 'text',
+  },
+  create(context) {
+    const config = resolveNapCatConfig(context.config);
+    // 注册到插件运行时状态（napcat endpoint list 的"运行中"数据源）
+    context.use(napcatRuntimeStateToken).endpoints.set(config.id, {
+      id: config.id,
+      mode: config.connection,
+    });
+    if (config.connection === 'wss') {
+      return new NapCatWssEndpoint({
+        id: context.id,
+        http: context.use(httpHostToken),
+        config,
+      });
+    }
+    if (config.connection === 'http') {
+      return new NapCatHttpEndpoint({
+        id: context.id,
+        http: context.use(httpHostToken),
+        config,
+      });
+    }
+    return new NapCatWsEndpoint({ id: context.id, config });
+  },
+});

package/agents/napcat/agent.json

@@ -0,0 +1,20 @@
+{
+  "name": "NAPCAT Platform Agent",
+  "version": "1.0.0",
+  "description": "Handles napcat platform-specific operations and progressively loads only the required platform Skill.",
+  "trigger_rules": {
+    "file_patterns": [],
+    "keywords": [
+      "napcat",
+      "adapter:napcat"
+    ]
+  },
+  "entry_points": [
+    "system.md",
+    "boundaries.md",
+    "conventions.md"
+  ],
+  "platforms": [
+    "napcat"
+  ]
+}

package/agents/napcat/boundaries.md

@@ -0,0 +1,3 @@
+# Boundaries
+
+Operate only on the active napcat endpoint and authenticated conversation context. Respect every Tool permission and approval policy. Do not infer identifiers, roles, or authorization from display names.

package/agents/napcat/conventions.md

@@ -0,0 +1,3 @@
+# Conventions
+
+Use stable platform identifiers from the current turn or directory queries. Load one task-specific Skill at a time, and use the unified reply and outbound message path.

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

@@ -0,0 +1,25 @@
+---
+name: napcat-account
+platforms:
+  - napcat
+description: NapCatQQ 账号状态、资料、头像、签名、点赞与好友关系能力。
+keywords:
+  - "napcat"
+  - "账号"
+  - "资料"
+  - "头像"
+  - "签名"
+  - "好友"
+tools:
+  - "send_like"
+  - "get_user_status"
+  - "set_profile"
+  - "set_avatar"
+  - "set_online_status"
+  - "set_signature"
+  - "delete_friend"
+---
+
+# napcat-account
+
+账号资料和好友关系属于高影响状态。先查询目标，修改与删除操作必须遵守审批策略。

package/agents/napcat/skills/napcat-account/tools/delete_friend/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 号'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['删除好友', 'delete friend', '删好友'],
+    permissions: ['platform(napcat,scene_admin)'],
+    async execute({ user_id }, context) {
+        const endpoint = context.$client;
+        await endpoint.deleteFriend(user_id);
+        return { success: true };
+    },
+});

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

@@ -0,0 +1,18 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<{ user_id: number }>({
+  description: '删除好友。',
+  inputSchema: z.object({
+    user_id: z.number().describe('好友 QQ 号'),
+  }),
+  adapter: 'napcat',
+  tags: ['napcat', 'qq'],
+  keywords: ['删除好友', 'delete friend', '删好友'],
+  permissions: ['platform(napcat,scene_admin)'],
+  async execute({ user_id }: { user_id: number }, context) {
+    const endpoint = context.$client;
+      await endpoint.deleteFriend(user_id);
+      return { success: true };
+  },
+});

package/agents/napcat/skills/napcat-account/tools/get_user_status/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({
+        user_id: z.number().describe('目标 QQ 号'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['在线状态', '用户状态', 'online status'],
+    async execute({ user_id }, context) {
+        const endpoint = context.$client;
+        return endpoint.ncGetUserStatus(user_id);
+    },
+});

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

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

package/agents/napcat/skills/napcat-account/tools/send_like/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: '给好友点赞（每人每天最多 10 次）。',
+    inputSchema: z.object({
+        user_id: z.number().describe('目标 QQ 号'),
+        times: z.number().optional().describe('点赞次数（1-10）'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['点赞', 'like', '赞', '好友赞'],
+    async execute({ user_id, times }, context) {
+        const endpoint = context.$client;
+        await endpoint.sendLike(user_id, times || 1);
+        return { success: true, message: `已给 ${user_id} 点赞 ${times || 1} 次` };
+    },
+});

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

@@ -0,0 +1,18 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<{ user_id: number; times?: number }>({
+  description: '给好友点赞（每人每天最多 10 次）。',
+  inputSchema: z.object({
+    user_id: z.number().describe('目标 QQ 号'),
+    times: z.number().optional().describe('点赞次数（1-10）'),
+  }),
+  adapter: 'napcat',
+  tags: ['napcat', 'qq'],
+  keywords: ['点赞', 'like', '赞', '好友赞'],
+  async execute({ user_id, times }: { user_id: number; times?: number }, context) {
+    const endpoint = context.$client;
+      await endpoint.sendLike(user_id, times || 1);
+      return { success: true, message: `已给 ${user_id} 点赞 ${times || 1} 次` };
+  },
+});

package/agents/napcat/skills/napcat-account/tools/set_avatar/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: '修改 QQ 头像。',
+    inputSchema: z.object({
+        file: z.string().describe('图片（URL 或 base64）'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['头像', 'avatar', '设置头像', '换头像'],
+    async execute({ file }, context) {
+        const endpoint = context.$client;
+        await endpoint.setQQAvatar(file);
+        return { success: true };
+    },
+});

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

@@ -0,0 +1,17 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<{ file: string }>({
+  description: '修改 QQ 头像。',
+  inputSchema: z.object({
+    file: z.string().describe('图片（URL 或 base64）'),
+  }),
+  adapter: 'napcat',
+  tags: ['napcat', 'qq'],
+  keywords: ['头像', 'avatar', '设置头像', '换头像'],
+  async execute({ file }: { file: string }, context) {
+    const endpoint = context.$client;
+      await endpoint.setQQAvatar(file);
+      return { success: true };
+  },
+});

package/agents/napcat/skills/napcat-account/tools/set_online_status/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({
+        status: z.number().describe('状态码（11=在线, 21=离开, 31=隐身, 41=忙碌, 50=请勿打扰, 60=Q我吧）'),
+        ext_status: z.number().optional().describe('扩展状态码'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['在线状态', '隐身', '忙碌', 'online', 'status'],
+    async execute({ status, ext_status }, context) {
+        const endpoint = context.$client;
+        await endpoint.setOnlineStatus(status, ext_status || 0);
+        return { success: true };
+    },
+});

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

@@ -0,0 +1,18 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<{ status: number; ext_status?: number }>({
+  description: '设置在线状态（在线、隐身、忙碌等）。',
+  inputSchema: z.object({
+    status: z.number().describe('状态码（11=在线, 21=离开, 31=隐身, 41=忙碌, 50=请勿打扰, 60=Q我吧）'),
+    ext_status: z.number().optional().describe('扩展状态码'),
+  }),
+  adapter: 'napcat',
+  tags: ['napcat', 'qq'],
+  keywords: ['在线状态', '隐身', '忙碌', 'online', 'status'],
+  async execute({ status, ext_status }: { status: number; ext_status?: number }, context) {
+    const endpoint = context.$client;
+      await endpoint.setOnlineStatus(status, ext_status || 0);
+      return { success: true };
+  },
+});

package/agents/napcat/skills/napcat-account/tools/set_profile/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: '修改 QQ 资料（昵称等）。',
+    inputSchema: z.object({
+        nickname: z.string().describe('昵称'),
+        company: z.string().optional().describe('公司（可选）'),
+        email: z.string().optional().describe('邮箱（可选）'),
+        college: z.string().optional().describe('学校（可选）'),
+        personal_note: z.string().optional().describe('个人说明（可选）'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['修改资料', '设置昵称', 'profile', 'set profile'],
+    async execute({ nickname, company, email, college, personal_note }, context) {
+        const endpoint = context.$client;
+        await endpoint.setQQProfile(nickname, company, email, college, personal_note);
+        return { success: true };
+    },
+});

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

@@ -0,0 +1,21 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<{ nickname: string; company?: string; email?: string; college?: string; personal_note?: string }>({
+  description: '修改 QQ 资料（昵称等）。',
+  inputSchema: z.object({
+    nickname: z.string().describe('昵称'),
+    company: z.string().optional().describe('公司（可选）'),
+    email: z.string().optional().describe('邮箱（可选）'),
+    college: z.string().optional().describe('学校（可选）'),
+    personal_note: z.string().optional().describe('个人说明（可选）'),
+  }),
+  adapter: 'napcat',
+  tags: ['napcat', 'qq'],
+  keywords: ['修改资料', '设置昵称', 'profile', 'set profile'],
+  async execute({ nickname, company, email, college, personal_note }: { nickname: string; company?: string; email?: string; college?: string; personal_note?: string }, context) {
+    const endpoint = context.$client;
+      await endpoint.setQQProfile(nickname, company, email, college, personal_note);
+      return { success: true };
+  },
+});

package/agents/napcat/skills/napcat-account/tools/set_signature/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({
+        signature: z.string().describe('签名内容'),
+    }),
+    adapter: 'napcat',
+    tags: ['napcat', 'qq'],
+    keywords: ['签名', '个性签名', 'signature', 'longnick'],
+    async execute({ signature }, context) {
+        const endpoint = context.$client;
+        await endpoint.setSelfLongnick(signature);
+        return { success: true };
+    },
+});

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

@@ -0,0 +1,17 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { z } from 'zod';
+
+export default defineAgentTool<{ signature: string }>({
+  description: '设置个人签名（个性签名）。',
+  inputSchema: z.object({
+    signature: z.string().describe('签名内容'),
+  }),
+  adapter: 'napcat',
+  tags: ['napcat', 'qq'],
+  keywords: ['签名', '个性签名', 'signature', 'longnick'],
+  async execute({ signature }: { signature: string }, context) {
+    const endpoint = context.$client;
+      await endpoint.setSelfLongnick(signature);
+      return { success: true };
+  },
+});