@zhin.js/adapter-napcat 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -1,5 +1,101 @@
 # @zhin.js/adapter-napcat
 
+## 1.1.2
+
+### Patch Changes
+
+- a9e4a40: Derive Command user routes only from explicit `commands/**/*/index.ts(x)` entry paths instead of prepending the plugin owner. Child plugins can now publish top-level static or dynamic commands, while duplicate routes across owners fail during generation construction. Adapter endpoint commands move to explicit paths such as `commands/qq/endpoint/list/index.ts` and are invoked as `qq endpoint list`.
+- 8740059: Standardize TypeScript capabilities on named module directories such as `commands/foo/index.ts`, `middlewares/audit/index.ts`, `handlers/message-receive/index.ts`, `pages/workroom/index.tsx`, and `mcps/filesystem/index.ts`. Only the fixed `index` entry is discovered; sibling files remain private helpers.
+
+  Command route segments come from directories, while `[name]`, `[[name]]`, `[...name]`, and `[[...name]]` directories declare dynamic parameters. Plugin owners do not enter the route unless their config explicitly sets `commandNamespace`; Endpoint `commandPrefix` remains platform-owned and defaults to an empty string.
+
+  Migrate the built-in adapters, plugins, examples, generators, migration tooling, hot reload classification, Agent authoring surfaces, documentation, and release artifacts to the explicit entry convention.
+
+  Make Tool ownership and progressive disclosure explicit across all four supported locations: plugin-public `tools/`, Agent-private `agents/<name>/tools/`, Skill-private `skills/<name>/tools/`, and Agent-Skill-private `agents/<name>/skills/<name>/tools/`. Move adapter and group-suite operations that require domain instructions into their owning Skills so `load_skill` is the only path that unlocks their schemas.
+
+  Remove the package-root `agent/` convention. Public capabilities now use named package-root directories, schedules use `schedules/<name>/index.ts` or `plugin.ts` injection, MCP connections use `mcps/<name>/index.ts`, Prompt Sections use `prompt-sections/<name>/index.ts`, Agent definitions use `agents/<name>/`, and permission vocabulary is published as `PERMITS.md`.
+
+- 25a845a: Unify Skills on `skills/<name>/SKILL.md`, support Agent-private Skills and nested Skill-private Tools, publish and mount existing plugin Skills, add governed Skill metadata and Turn access filtering, unlock only already-admitted same-owner Tools, and make `on-risk` and `once` approval behavior precise.
+- ddbb92e: Isolate adapter Skills under platform-specific Agents and automatically select the matching platform Agent for IM ingress, preventing unrelated adapter Skills from entering another platform's prompt surface.
+- 40d2c8f: Reduce the default Agent Tool surface by moving process diagnostics into a Skill and splitting broad platform Skills into focused task domains. Restore ICQQ friend and group directory tools with `on-risk` approval and explicit owner, administrator, master, or trusted access.
+- 4380cf9: Colocate adapter command definitions and Agent Skill handlers with their owning capabilities, and provide a shared validated platform permission constructor.
+- e54ab63: Require one canonical expanded NapCat endpoint configuration. The protocol no longer reinterprets nested `endpoints` or reads endpoint identity from `process.env`, and reverse WebSocket connection heartbeat/cleanup now uses the shared endpoint lifecycle.
+- 5c3858e: Make `@zhin.js/im-contract` the explicit zero-dependency owner of transport identities, canonical segments, media guards, conversation facts, stores, and delivery contracts. Platform adapters now read media contracts from that foundation instead of reaching through Core.
+- 33ea736: Use `tools/<name>/index.ts` and `defineAgentTool` from `@zhin.js/tool` as the sole Agent Tool authoring model. Remove the duplicate `@zhin.js/tools` definition, context, bridge, export, and discovery path; migrate plugin manifests, examples, scaffolding, HMR, and prepack compilation to the generation-owned Tool Feature.
+- Updated dependencies [c861789]
+- Updated dependencies [1414ccb]
+- Updated dependencies [743d470]
+- Updated dependencies [62dee52]
+- Updated dependencies [cd54131]
+- Updated dependencies [244e475]
+- Updated dependencies [a9e4a40]
+- Updated dependencies [5855db7]
+- Updated dependencies [ec921d2]
+- Updated dependencies [8740059]
+- Updated dependencies [63d1f7a]
+- Updated dependencies [25a845a]
+- Updated dependencies [103f2c3]
+- Updated dependencies [9110ab8]
+- Updated dependencies [cd2a888]
+- Updated dependencies [eb3227a]
+- Updated dependencies [b853dba]
+- Updated dependencies [e561309]
+- Updated dependencies [d4c6175]
+- Updated dependencies [7a0e1ca]
+- Updated dependencies [103b5d3]
+- Updated dependencies [5a7a7f7]
+- Updated dependencies [b076eae]
+- Updated dependencies [535fed1]
+- Updated dependencies [73a24b7]
+- Updated dependencies [4380cf9]
+- Updated dependencies [2dbbc15]
+- Updated dependencies [1cb1163]
+- Updated dependencies [be3061e]
+- Updated dependencies [75f8332]
+- Updated dependencies [81935e2]
+- Updated dependencies [f9ed01b]
+- Updated dependencies [ac0ab50]
+- Updated dependencies [5140ce1]
+- Updated dependencies [522d75f]
+- Updated dependencies [a7611b3]
+- Updated dependencies [8823044]
+- Updated dependencies [379439b]
+- Updated dependencies [11c9352]
+- Updated dependencies [6b70e46]
+- Updated dependencies [135ac91]
+- Updated dependencies [140cf0f]
+- Updated dependencies [251e4d2]
+- Updated dependencies [203ad34]
+- Updated dependencies [e6c5113]
+- Updated dependencies [e0f6478]
+- Updated dependencies [baef56b]
+- Updated dependencies [698f16f]
+- Updated dependencies [da0a8e3]
+- Updated dependencies [2fd8017]
+- Updated dependencies [5c3858e]
+- Updated dependencies [33ea736]
+- Updated dependencies [507d602]
+- Updated dependencies [df9f76b]
+  - @zhin.js/core@1.1.37
+  - @zhin.js/tool@1.1.1
+  - @zhin.js/host-http@1.1.1
+  - @zhin.js/adapter@1.1.14
+  - @zhin.js/feature-kit@1.1.1
+  - @zhin.js/agent-feature@1.1.1
+  - @zhin.js/skill@1.1.1
+  - @zhin.js/logger@1.1.1
+  - @zhin.js/im-contract@1.1.1
+  - @zhin.js/permission@1.1.1
+
+## 1.1.1
+
+### Patch Changes
+
+- 33b1582: Update vulnerable dependencies and replace unsafe HTML and protocol-text regular expressions with bounded scanners.
+- Updated dependencies [769e67f]
+  - @zhin.js/adapter@1.1.13
+  - @zhin.js/core@1.1.36
+
 ## 1.1.0
 
 ### Minor Changes

package/README.md

@@ -9,7 +9,7 @@ Zhin.js [NapCatQQ](https://github.com/NapNeko/NapCatQQ) 适配器（Plugin Runti
 - **正向 WebSocket**（`connection: ws`）：应用连 NapCat WS
 - `access_token` 鉴权（Bearer + query）
 - 入站经 `Endpoint.emit(...)`（去重 + 自发过滤）；出站 `send({ conversation, payload })`
-- 41 个 AI 工具（`agent/tools/`）
+- 41 个 AI 工具（`tools/`）
 
 ## 安装
 
@@ -19,7 +19,7 @@ pnpm add @zhin.js/adapter-napcat
 
 ## Plugin Runtime
 
-- `@zhin.js/adapter` — 约定式 `adapters/napcat.ts`（`defineAdapter`）
+- `@zhin.js/adapter` — 约定式 `adapters/napcat/index.ts`（`defineAdapter`）
 - `@zhin.js/core` — `Endpoint.emit(...)` 入站、`outboundMessageToken` 出站
 - `zhin.js` — `plugin.ts`（`definePlugin`）
 - 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
@@ -43,11 +43,14 @@ plugins:
     reconnect_interval: 5000
     heartbeat_interval: 30000
     endpoints:
-      - name: my-bot
+      - id: my-bot
         url: "ws://127.0.0.1:3001"
         access_token: "${NAPCAT_TOKEN}"
 ```
 
+AdapterIndex 会把实例级连接默认值合并进每个 endpoint；协议实现只接收一份展开后的
+endpoint 配置，不会从环境变量推断 endpoint id。
+
 根插件 `zhin.plugins`（或项目图）需引用 `@zhin.js/adapter-napcat`（`instanceKey: napcat`）。
 
 ## 连接方式
@@ -67,15 +70,15 @@ plugins:
 
 | 类别 | 路径 |
 |------|------|
-| Permit 词汇 | `agent/PERMITS.md` |
-| 平台工具 | `agent/tools/*.ts` |
-| 技能说明 | `agent/skills/napcat.md` |
+| Permit 词汇 | `PERMITS.md` |
+| 平台工具 | `tools/<name>/index.ts` |
+| 技能说明 | `agents/napcat/skills/napcat-*/SKILL.md`（按消息、群内容、群设置、文件历史、媒体和账号拆分） |
 
 ## 迁移说明（Plugin Runtime）
 
 - **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）判定。
+- **群管工具暂未迁移**：旧 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）判定。
 
 ## 文档链接
 

package/adapters/{napcat.js → napcat/index.js}

@@ -1,17 +1,17 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 /**
- * Convention entry: discover `adapters/napcat.ts` → defineAdapter.
+ * 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";
+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'],
@@ -23,7 +23,7 @@ export default defineAdapter({
     },
     create(context) {
         const config = resolveNapCatConfig(context.config);
-        // 注册到插件运行时状态（napcat.endpoint list 的"运行中"数据源）
+        // 注册到插件运行时状态（napcat endpoint list 的"运行中"数据源）
         context.use(napcatRuntimeStateToken).endpoints.set(config.id, {
             id: config.id,
             mode: config.connection,

package/adapters/{napcat.ts → napcat/index.ts}

@@ -1,35 +1,35 @@
 /**
- * Convention entry: discover `adapters/napcat.ts` → defineAdapter.
+ * 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 NapCatAdapterConfig } 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';
+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';
+} from '../../src/http-endpoint.js';
 export {
   NapCatWsEndpoint,
   type NapCatWsEndpointOptions,
-} from '../src/ws-endpoint.js';
+} from '../../src/ws-endpoint.js';
 export {
   NapCatWssEndpoint,
   type NapCatWssEndpointOptions,
-} from '../src/wss-endpoint.js';
-export type { NapCatWsSocket, NapCatWsCreateOptions } from '../src/ws-types.js';
+} 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;
+    napcat: import('../../src/ws-endpoint.js').NapCatWsEndpoint;
   }
 }
 
-export default defineAdapter<NapCatAdapterConfig>({
+export default defineAdapter<NapCatEndpointConfig>({
   capabilities: ['inbound', 'outbound'],
   operations: ['recall'],
   // OneBot file 参数原生消费 url / base64:// 媒体，file:// 本地路径由 NapCat 侧读盘；
@@ -40,7 +40,7 @@ export default defineAdapter<NapCatAdapterConfig>({
   },
   create(context) {
     const config = resolveNapCatConfig(context.config);
-    // 注册到插件运行时状态（napcat.endpoint list 的"运行中"数据源）
+    // 注册到插件运行时状态（napcat endpoint list 的"运行中"数据源）
     context.use(napcatRuntimeStateToken).endpoints.set(config.id, {
       id: config.id,
       mode: config.connection,

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/{agent/tools/delete_friend.ts → agents/napcat/skills/napcat-account/tools/delete_friend/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<{ user_id: number }>({

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/{agent/tools/get_user_status.ts → agents/napcat/skills/napcat-account/tools/get_user_status/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<{ user_id: number }>({

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/{agent/tools/send_like.ts → agents/napcat/skills/napcat-account/tools/send_like/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<{ user_id: number; times?: number }>({

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/{agent/tools/set_avatar.ts → agents/napcat/skills/napcat-account/tools/set_avatar/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<{ file: string }>({

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/{agent/tools/set_online_status.ts → agents/napcat/skills/napcat-account/tools/set_online_status/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<{ status: number; ext_status?: number }>({

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/{agent/tools/set_profile.ts → agents/napcat/skills/napcat-account/tools/set_profile/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<{ nickname: string; company?: string; email?: string; college?: string; personal_note?: string }>({

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/{agent/tools/set_signature.ts → agents/napcat/skills/napcat-account/tools/set_signature/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<{ signature: string }>({

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/{agent/tools/download_file.ts → agents/napcat/skills/napcat-files-history/tools/download_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<{ url: string; thread_count?: number }>({

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/{agent/tools/get_friend_msg_history.ts → agents/napcat/skills/napcat-files-history/tools/get_friend_msg_history/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<{ user_id: number; message_seq?: number; count?: number }>({

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/{agent/tools/get_group_file_url.ts → agents/napcat/skills/napcat-files-history/tools/get_group_file_url/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_id: string; busid: number }>({

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/{agent/tools/get_group_msg_history.ts → agents/napcat/skills/napcat-files-history/tools/get_group_msg_history/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; message_seq?: number; count?: number }>({