@zhin.js/adapter-qq 1.1.0 → 1.1.2

package/CHANGELOG.md

@@ -1,5 +1,101 @@
 # @zhin.js/adapter-qq
 
+## 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.
+- eb3227a: Move Endpoint project-configuration persistence behind the root-owned `EndpointConfigurationStore` resource. The Adapter package now owns only command semantics and no longer imports Node filesystem, path, or YAML APIs; CLI owns canonical YAML and `.env` persistence, while QQ and ICQQ special binding flows use the same injected boundary. Remove the old direct persistence helpers and reject legacy `plugins` arrays instead of promoting them at runtime.
+- 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.
+- 4380cf9: Colocate adapter command definitions and Agent Skill handlers with their owning capabilities, and provide a shared validated platform permission constructor.
+- 018b9b6: Require the canonical expanded QQ endpoint configuration. The QQ protocol no longer reinterprets a nested `endpoints` array, reads credentials or identity directly from `process.env`, or accepts unused standalone webhook `port` and `path` fields. The public endpoint config type is now `QqEndpointConfig`, and each schema entry uses `id` as its identity.
+- 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.
+- df9f76b: Make Endpoint configuration persistence asynchronous and route it through the canonical transactional Root configuration port. Endpoint management now supports both YAML and JSON, materializes a missing Root config safely, serializes concurrent mutations, restores `.env` when the config commit fails, and restarts the development process after environment-file changes.
+- 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
+
+- Updated dependencies [769e67f]
+  - @zhin.js/adapter@1.1.13
+  - @zhin.js/core@1.1.36
+
 ## 1.1.0
 
 ### Minor Changes

package/README.md

@@ -21,7 +21,7 @@ pnpm add @zhin.js/adapter-qq
 
 ## Plugin Runtime
 
-- `@zhin.js/adapter` — 约定式 `adapters/qq.ts`（`defineAdapter`）
+- `@zhin.js/adapter` — 约定式 `adapters/qq/index.ts`（`defineAdapter`）
 - `@zhin.js/core` — `Endpoint.emit(...)` 入站、`outboundMessageToken` 出站
 - `zhin.js` — `plugin.ts`（`definePlugin`）
 - 配置经插件 `schema.json` 落到 `plugins.<instanceKey>`
@@ -38,7 +38,7 @@ pnpm add @zhin.js/adapter-qq
 | **WebSocket（默认）** | `qq-official-bot` 正向连接；无需公网回调 |
 | **host-http** | WebSocket **不需要**；Webhook / middleware 模式需要（经 `httpHostToken`） |
 
-必填字段（`endpoints[i]`）：`name`、`appid`、`secret`。
+必填字段（`endpoints[i]`）：`id`、`appid`、`secret`。
 
 ## 最小配置
 
@@ -48,10 +48,10 @@ plugins:
   qq:
     # mode: websocket   # 默认
     endpoints:
-      - name: my-qq-bot
+      - id: my-qq-bot
         appid: ${QQ_APPID}
         secret: ${QQ_SECRET}
-        # botKind / intents 可由向导写入；`qq.endpoint add` 扫码后会追问公域/私域再写入
+        # botKind / intents 可由向导写入；`qq endpoint add` 扫码后会追问公域/私域再写入
 ```
 
 ### botKind 与 intents
@@ -65,16 +65,16 @@ WebSocket Identify 的 `intents` **必须与开放平台已开通的权限一致
 | `private`（私域） | `GUILD_MESSAGES`（频道全量） | 同上 |
 
 公域机器人订阅 `GUILD_MESSAGES` 会 Identify 失败断连。显式配置 `intents` 时优先于 `botKind`。
-`create-zhin` / `zhin setup` 会询问公/私域并写入；`qq.endpoint add` 扫码成功后在同一会话追问 `public`/`private`（或 `公域`/`私域`），确认后一次性写 `.env` 与 yaml。
+`create-zhin` / `zhin setup` 会询问公/私域并写入；`qq endpoint add` 扫码成功后在同一会话追问 `public`/`private`（或 `公域`/`私域`），确认后一次性写 `.env` 与 yaml。
 
-多账号：一个插件实例挂多个 endpoint（`endpoints` 数组逐项覆盖顶层字段，`name` 必填）：
+多账号：一个插件实例挂多个 endpoint（`endpoints` 数组逐项覆盖顶层字段，`id` 必填）：
 
 ```yaml
 plugins:
   qq:
     mode: websocket
     endpoints:
-      - name: main-bot
+      - id: main-bot
         appid: ${QQ_APPID}
         secret: ${QQ_SECRET}
         botKind: public
@@ -85,7 +85,7 @@ plugins:
           - GUILD_MEMBERS
           - DIRECT_MESSAGE
           - PUBLIC_GUILD_MESSAGES
-      - name: private-bot
+      - id: private-bot
         appid: ${QQ_APPID_2}
         secret: ${QQ_SECRET_2}
         botKind: private
@@ -102,14 +102,14 @@ plugins:
 
 ## Endpoint 管理命令
 
-适配器自带 `qq.endpoint` 命令组（聊天内直接使用，默认无前缀；受 `commandPrefix` 影响）：
+适配器自带 `qq endpoint` 命令组（聊天内直接使用，默认无前缀；受 `commandPrefix` 影响）：
 
 | 命令 | 说明 |
 |------|------|
-| `qq.endpoint add [name]` | 手机 QQ 扫码绑定 → **追问公域/私域** → 一次性写入 `.env` + `plugins.qq.endpoints`（重启生效） |
-| `qq.endpoint cancel` | 取消进行中的扫码绑定或待确认的公域/私域选择 |
-| `qq.endpoint list` | 列出运行中与配置中的 endpoints |
-| `qq.endpoint remove <name>` | 从配置移除 endpoint（`.env` 键保留，可手动清理） |
+| `qq endpoint add [name]` | 手机 QQ 扫码绑定 → **追问公域/私域** → 一次性写入 `.env` + `plugins.qq.endpoints`（重启生效） |
+| `qq endpoint cancel` | 取消进行中的扫码绑定或待确认的公域/私域选择 |
+| `qq endpoint list` | 列出运行中与配置中的 endpoints |
+| `qq endpoint remove <name>` | 从配置移除 endpoint（`.env` 键保留，可手动清理） |
 
 add/cancel/remove 受 `master` 限制：实例配置声明了 `master`（顶层或 `endpoints[i].master`）时仅
 master 可执行；未配置则放行（首个扫码绑定者会写入该 endpoint 的 `master`）。二维码当前以链接文本下发
@@ -119,9 +119,8 @@ master 可执行；未配置则放行（首个扫码绑定者会写入该 endpoi
 
 | 变量 | 说明 |
 |------|------|
-| `QQ_APPID` / `QQ_BOT_APPID` | 应用 AppID |
-| `QQ_SECRET` / `QQ_BOT_SECRET` | 应用 Secret |
-| `QQ_BOT_NAME` | 可选，默认 endpoint 名 |
+| `QQ_APPID` | YAML 示例中 `appid` 引用的应用 AppID |
+| `QQ_SECRET` | YAML 示例中 `secret` 引用的应用 Secret |
 
 ## Webhook / middleware
 
@@ -131,9 +130,9 @@ master 可执行；未配置则放行（首个扫码绑定者会写入该 endpoi
 
 | 类别 | 路径 |
 |------|------|
-| Permit 词汇 | `agent/PERMITS.md` |
-| 平台工具 | `agent/tools/`（频道、角色等） |
-| 技能说明 | `agent/skills/qq.md` |
+| Permit 词汇 | `PERMITS.md` |
+| 平台工具 | `tools/`（频道、角色等） |
+| 技能说明 | `agents/qq/skills/qq/SKILL.md` |
 
 ## 平台 Client 与 QQ API
 

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

@@ -1,13 +1,13 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 /**
- * Convention entry: discover `adapters/qq.ts` → defineAdapter.
+ * Convention entry: discover `adapters/qq/index.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
 import { httpHostToken } from '@zhin.js/host-http';
-import { QqHttpEndpoint, QqWebsocketEndpoint } from "../lib/endpoint.js";
-import { resolveQqConfig, } from "../lib/protocol.js";
-import { qqRuntimeStateToken } from "../lib/qq-runtime-state.js";
-export { QqHttpEndpoint, QqWebsocketEndpoint, } from "../lib/endpoint.js";
+import { QqHttpEndpoint, QqWebsocketEndpoint } from "../../lib/endpoint.js";
+import { resolveQqConfig, } from "../../lib/protocol.js";
+import { qqRuntimeStateToken } from "../../lib/qq-runtime-state.js";
+export { QqHttpEndpoint, QqWebsocketEndpoint, } from "../../lib/endpoint.js";
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
     operations: ['recall'],
@@ -21,7 +21,7 @@ export default defineAdapter({
     },
     create(context) {
         const config = resolveQqConfig(context.config);
-        // 注册到插件运行时状态（qq.endpoint list 的"运行中"数据源）
+        // 注册到插件运行时状态（qq endpoint list 的"运行中"数据源）
         const state = context.use(qqRuntimeStateToken);
         state.endpoints.set(config.id, {
             id: config.id,
@@ -39,7 +39,7 @@ export default defineAdapter({
                 http: context.use(httpHostToken),
                 config,
             });
-        // 运行状态表只增不减：stop 时同步摘除，避免 stop 后 qq.endpoint list 仍显示运行中。
+        // 运行状态表只增不减：stop 时同步摘除，避免 stop 后 qq endpoint list 仍显示运行中。
         const stopEndpoint = endpoint.stop.bind(endpoint);
         endpoint.stop = async () => {
             state.endpoints.delete(config.id);

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

@@ -1,19 +1,19 @@
 /**
- * Convention entry: discover `adapters/qq.ts` → defineAdapter.
+ * Convention entry: discover `adapters/qq/index.ts` → defineAdapter.
  */
 import { defineAdapter } from 'zhin.js/adapter';
 import { httpHostToken } from '@zhin.js/host-http';
-import { QqHttpEndpoint, QqWebsocketEndpoint } from '../src/endpoint.js';
+import { QqHttpEndpoint, QqWebsocketEndpoint } from '../../src/endpoint.js';
 import {
   resolveQqConfig,
-  type QqAdapterConfig,
-} from '../src/protocol.js';
-import { qqRuntimeStateToken } from '../src/qq-runtime-state.js';
+  type QqEndpointConfig,
+} from '../../src/protocol.js';
+import { qqRuntimeStateToken } from '../../src/qq-runtime-state.js';
 
 export {
   QqHttpEndpoint,
   QqWebsocketEndpoint,
-} from '../src/endpoint.js';
+} from '../../src/endpoint.js';
 export type {
   CreateQqBot,
   CreateQqHttpBot,
@@ -21,15 +21,15 @@ export type {
   QqEndpointOptions,
   QqHttpBotTransport,
   QqHttpEndpointOptions,
-} from '../src/endpoint.js';
+} from '../../src/endpoint.js';
 
 declare module '@zhin.js/core' {
   interface AdapterEndpoints {
-    qq: import('../src/endpoint.js').QqWebsocketEndpoint;
+    qq: import('../../src/endpoint.js').QqWebsocketEndpoint;
   }
 }
 
-export default defineAdapter<QqAdapterConfig>({
+export default defineAdapter<QqEndpointConfig>({
   capabilities: ['inbound', 'outbound'],
   operations: ['recall'],
   // 媒体 url 直发，base64/path 由 SDK formatMediaData 物化走 /files 上传；
@@ -42,7 +42,7 @@ export default defineAdapter<QqAdapterConfig>({
   },
   create(context) {
     const config = resolveQqConfig(context.config);
-    // 注册到插件运行时状态（qq.endpoint list 的"运行中"数据源）
+    // 注册到插件运行时状态（qq endpoint list 的"运行中"数据源）
     const state = context.use(qqRuntimeStateToken);
     state.endpoints.set(config.id, {
       id: config.id,
@@ -60,7 +60,7 @@ export default defineAdapter<QqAdapterConfig>({
         http: context.use(httpHostToken),
         config,
       });
-    // 运行状态表只增不减：stop 时同步摘除，避免 stop 后 qq.endpoint list 仍显示运行中。
+    // 运行状态表只增不减：stop 时同步摘除，避免 stop 后 qq endpoint list 仍显示运行中。
     const stopEndpoint = endpoint.stop.bind(endpoint);
     endpoint.stop = async () => {
       state.endpoints.delete(config.id);

package/agents/qq/agent.json

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

package/agents/qq/boundaries.md

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

package/agents/qq/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/qq/skills/qq/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: qq
+platforms: [qq]
+description: QQ 官方机器人频道、角色和成员详情能力。
+keywords: [qq, guild, channel, role, member]
+tags: [adapter, community]
+tools:
+  - list_guilds
+  - list_channels
+  - list_roles
+  - create_role
+  - add_role
+  - remove_role
+  - channel_info
+  - member_detail
+---
+
+# QQ 官方机器人
+
+先用 `list_guilds` 和 `list_channels` 确认频道上下文。角色操作前用 `list_roles` 获取角色 ID；成员操作前用 `member_detail` 确认目标。创建、授予和移除角色属于写操作，应遵守对应 Tool 的审批策略。
+
+当前 Agent Tool 不提供群踢人、禁言或成员列表能力。

package/agents/qq/skills/qq/tools/add_role/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';
+import { platformPermission } from '@zhin.js/permission';
+export default defineAgentTool({
+    description: '给成员添加 QQ 频道角色',
+    inputSchema: z.object({
+        guild_id: z.string().describe('频道 ID'),
+        channel_id: z.string().describe('子频道 ID'),
+        user_id: z.string().describe('用户 ID'),
+        role_id: z.string().describe('角色 ID'),
+    }),
+    adapter: 'qq',
+    tags: ['qq'],
+    permissions: [platformPermission('qq', 'manage_roles')],
+    async execute({ guild_id, channel_id, user_id, role_id }, context) {
+        const client = context.$client;
+        const success = await client.addMemberRole(guild_id, channel_id, user_id, role_id);
+        return { success, message: success ? '已给成员添加角色' : '操作失败' };
+    },
+});

package/{agent/tools/add_role.ts → agents/qq/skills/qq/tools/add_role/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermit } from '../../src/platform-permit.js';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{ guild_id: string; channel_id: string; user_id: string; role_id: string }>({
   description: '给成员添加 QQ 频道角色',
@@ -12,7 +12,7 @@ export default defineAgentTool<{ guild_id: string; channel_id: string; user_id:
   }),
   adapter: 'qq',
   tags: ['qq'],
-  permissions: [platformPermit('manage_roles')],
+  permissions: [platformPermission('qq', 'manage_roles')],
   async execute({ guild_id, channel_id, user_id, role_id  }: { guild_id: string; channel_id: string; user_id: string; role_id: string }, context) {
     const client = context.$client;
     const success = await client.addMemberRole(guild_id, channel_id, user_id, role_id);

package/agents/qq/skills/qq/tools/channel_info/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';
+import { platformPermission } from '@zhin.js/permission';
+export default defineAgentTool({
+    description: '获取 QQ 频道中指定子频道的详细信息',
+    inputSchema: z.object({
+        channel_id: z.string().describe('子频道 ID'),
+    }),
+    adapter: 'qq',
+    tags: ['qq'],
+    permissions: [platformPermission('qq', 'guild_admin')],
+    async execute({ channel_id }, context) {
+        const client = context.$client;
+        return client.getChannelInfo(channel_id);
+    },
+});

package/{agent/tools/channel_info.ts → agents/qq/skills/qq/tools/channel_info/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermit } from '../../src/platform-permit.js';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{ channel_id: string }>({
   description: '获取 QQ 频道中指定子频道的详细信息',
@@ -9,7 +9,7 @@ export default defineAgentTool<{ channel_id: string }>({
   }),
   adapter: 'qq',
   tags: ['qq'],
-  permissions: [platformPermit('guild_admin')],
+  permissions: [platformPermission('qq', 'guild_admin')],
   async execute({ channel_id  }: { channel_id: string }, context) {
     const client = context.$client;
     return client.getChannelInfo(channel_id);

package/agents/qq/skills/qq/tools/create_role/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';
+import { platformPermission } from '@zhin.js/permission';
+export default defineAgentTool({
+    description: '创建 QQ 频道角色',
+    inputSchema: z.object({
+        guild_id: z.string().describe('频道 ID'),
+        name: z.string().describe('角色名称'),
+        color: z.number().optional().describe('颜色（RGB 十进制数值）'),
+    }),
+    adapter: 'qq',
+    tags: ['qq'],
+    permissions: [platformPermission('qq', 'guild_owner')],
+    async execute({ guild_id, name, color }, context) {
+        const client = context.$client;
+        const role = await client.createGuildRole(guild_id, name, color);
+        return { success: !!role, role, message: role ? `角色 "${name}" 创建成功` : '创建失败' };
+    },
+});

package/{agent/tools/create_role.ts → agents/qq/skills/qq/tools/create_role/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermit } from '../../src/platform-permit.js';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{ guild_id: string; name: string; color?: number }>({
   description: '创建 QQ 频道角色',
@@ -11,7 +11,7 @@ export default defineAgentTool<{ guild_id: string; name: string; color?: number
   }),
   adapter: 'qq',
   tags: ['qq'],
-  permissions: [platformPermit('guild_owner')],
+  permissions: [platformPermission('qq', 'guild_owner')],
   async execute({ guild_id, name, color  }: { guild_id: string; name: string; color?: number }, context) {
     const client = context.$client;
     const role = await client.createGuildRole(guild_id, name, color);

package/agents/qq/skills/qq/tools/list_channels/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';
+import { platformPermission } from '@zhin.js/permission';
+export default defineAgentTool({
+    description: '获取 QQ 频道下的子频道列表',
+    inputSchema: z.object({
+        guild_id: z.string().describe('频道 ID'),
+    }),
+    adapter: 'qq',
+    tags: ['qq'],
+    permissions: [platformPermission('qq', 'manage_channels')],
+    async execute({ guild_id }, context) {
+        const client = context.$client;
+        const channels = await client.getChannels(guild_id);
+        return { channels, count: channels.length };
+    },
+});

package/{agent/tools/list_channels.ts → agents/qq/skills/qq/tools/list_channels/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermit } from '../../src/platform-permit.js';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{ guild_id: string }>({
   description: '获取 QQ 频道下的子频道列表',
@@ -9,7 +9,7 @@ export default defineAgentTool<{ guild_id: string }>({
   }),
   adapter: 'qq',
   tags: ['qq'],
-  permissions: [platformPermit('manage_channels')],
+  permissions: [platformPermission('qq', 'manage_channels')],
   async execute({ guild_id  }: { guild_id: string }, context) {
     const client = context.$client;
     const channels = await client.getChannels(guild_id);

package/agents/qq/skills/qq/tools/list_guilds/index.js

@@ -0,0 +1,14 @@
+// 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({}),
+    adapter: 'qq',
+    tags: ['qq'],
+    async execute(_input, context) {
+        const client = context.$client;
+        const guilds = await client.getGuilds();
+        return { guilds, count: guilds.length };
+    },
+});

package/{agent/tools/list_guilds.ts → agents/qq/skills/qq/tools/list_guilds/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<Record<string, never>>({

package/agents/qq/skills/qq/tools/list_roles/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';
+import { platformPermission } from '@zhin.js/permission';
+export default defineAgentTool({
+    description: '获取 QQ 频道角色列表',
+    inputSchema: z.object({
+        guild_id: z.string().describe('频道 ID'),
+    }),
+    adapter: 'qq',
+    tags: ['qq'],
+    permissions: [platformPermission('qq', 'manage_roles')],
+    async execute({ guild_id }, context) {
+        const client = context.$client;
+        const roles = await client.getGuildRoles(guild_id);
+        return { roles, count: roles.length };
+    },
+});

package/{agent/tools/list_roles.ts → agents/qq/skills/qq/tools/list_roles/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermit } from '../../src/platform-permit.js';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{ guild_id: string }>({
   description: '获取 QQ 频道角色列表',
@@ -9,7 +9,7 @@ export default defineAgentTool<{ guild_id: string }>({
   }),
   adapter: 'qq',
   tags: ['qq'],
-  permissions: [platformPermit('manage_roles')],
+  permissions: [platformPermission('qq', 'manage_roles')],
   async execute({ guild_id  }: { guild_id: string }, context) {
     const client = context.$client;
     const roles = await client.getGuildRoles(guild_id);

package/agents/qq/skills/qq/tools/member_detail/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';
+import { platformPermission } from '@zhin.js/permission';
+export default defineAgentTool({
+    description: '获取 QQ 频道中指定成员的详细信息',
+    inputSchema: z.object({
+        guild_id: z.string().describe('频道 ID'),
+        user_id: z.string().describe('用户 ID'),
+    }),
+    adapter: 'qq',
+    tags: ['qq'],
+    permissions: [platformPermission('qq', 'guild_admin')],
+    async execute({ guild_id, user_id }, context) {
+        const client = context.$client;
+        return client.getGuildMember(guild_id, user_id);
+    },
+});

package/{agent/tools/member_detail.ts → agents/qq/skills/qq/tools/member_detail/index.ts}

@@ -1,6 +1,6 @@
-import { defineAgentTool } from '@zhin.js/agent/tools';
+import { defineAgentTool } from '@zhin.js/tool';
 import { z } from 'zod';
-import { platformPermit } from '../../src/platform-permit.js';
+import { platformPermission } from '@zhin.js/permission';
 
 export default defineAgentTool<{ guild_id: string; user_id: string }>({
   description: '获取 QQ 频道中指定成员的详细信息',
@@ -10,7 +10,7 @@ export default defineAgentTool<{ guild_id: string; user_id: string }>({
   }),
   adapter: 'qq',
   tags: ['qq'],
-  permissions: [platformPermit('guild_admin')],
+  permissions: [platformPermission('qq', 'guild_admin')],
   async execute({ guild_id, user_id  }: { guild_id: string; user_id: string }, context) {
     const client = context.$client;
     return client.getGuildMember(guild_id, user_id);

package/agents/qq/skills/qq/tools/remove_role/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';
+import { platformPermission } from '@zhin.js/permission';
+export default defineAgentTool({
+    description: '移除成员的 QQ 频道角色',
+    inputSchema: z.object({
+        guild_id: z.string().describe('频道 ID'),
+        channel_id: z.string().describe('子频道 ID'),
+        user_id: z.string().describe('用户 ID'),
+        role_id: z.string().describe('角色 ID'),
+    }),
+    adapter: 'qq',
+    tags: ['qq'],
+    permissions: [platformPermission('qq', 'manage_roles')],
+    async execute({ guild_id, channel_id, user_id, role_id }, context) {
+        const client = context.$client;
+        const success = await client.removeMemberRole(guild_id, channel_id, user_id, role_id);
+        return { success, message: success ? '已移除成员的角色' : '操作失败' };
+    },
+});