@zhin.js/adapter-qq 1.1.0 → 1.1.3

package/middlewares/{bot-kind-reply.js → bot-kind-reply/index.js}

@@ -1,8 +1,9 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineMiddleware } from 'zhin.js/middleware';
-import { completeQqPendingBotKind, } from "../lib/qq-endpoint-commands.js";
-import { parseQqBotKindAnswer, qqCommandSessionKey, QQ_BOT_KIND_PROMPT, } from "../lib/qq-bot-kind-prompt.js";
-import { qqRuntimeStateToken } from "../lib/qq-runtime-state.js";
+import { endpointConfigurationStoreToken } from 'zhin.js/adapter';
+import { completeQqPendingBotKind, } from '../../commands/qq/endpoint/definition.js';
+import { parseQqBotKindAnswer, qqCommandSessionKey, QQ_BOT_KIND_PROMPT, } from "../../lib/qq-bot-kind-prompt.js";
+import { qqRuntimeStateToken } from "../../lib/qq-runtime-state.js";
 /**
  * 扫码绑定成功后，在同一会话收取 public/private（或 公域/私域）回复并写入 intents。
  * 非待确认会话、或内容无法识别为 botKind 时放行后续中间件/命令。
@@ -24,8 +25,8 @@ export default defineMiddleware({
             return;
         }
         const raw = String(context.input.content ?? '').trim();
-        // 让 qq.endpoint cancel 等命令继续走命令链
-        if (raw.toLowerCase().startsWith('qq.endpoint')) {
+        // 让 qq endpoint cancel 等命令继续走命令链
+        if (raw.toLowerCase().startsWith('qq endpoint')) {
             await next();
             return;
         }
@@ -35,7 +36,7 @@ export default defineMiddleware({
             return;
         }
         try {
-            const text = completeQqPendingBotKind(pending, botKind);
+            const text = await completeQqPendingBotKind(pending, botKind, context.use(endpointConfigurationStoreToken));
             state.pendingBotKind = null;
             await context.input.$reply?.(text);
         }

package/middlewares/{bot-kind-reply.ts → bot-kind-reply/index.ts}

@@ -1,14 +1,15 @@
 import { defineMiddleware } from 'zhin.js/middleware';
 import type { CommandMessage } from 'zhin.js/command';
+import { endpointConfigurationStoreToken } from 'zhin.js/adapter';
 import {
   completeQqPendingBotKind,
-} from '../src/qq-endpoint-commands.js';
+} from '../../commands/qq/endpoint/definition.js';
 import {
   parseQqBotKindAnswer,
   qqCommandSessionKey,
   QQ_BOT_KIND_PROMPT,
-} from '../src/qq-bot-kind-prompt.js';
-import { qqRuntimeStateToken } from '../src/qq-runtime-state.js';
+} from '../../src/qq-bot-kind-prompt.js';
+import { qqRuntimeStateToken } from '../../src/qq-runtime-state.js';
 
 /**
  * 扫码绑定成功后，在同一会话收取 public/private（或 公域/私域）回复并写入 intents。
@@ -33,8 +34,8 @@ export default defineMiddleware<CommandMessage>({
     }
 
     const raw = String(context.input.content ?? '').trim();
-    // 让 qq.endpoint cancel 等命令继续走命令链
-    if (raw.toLowerCase().startsWith('qq.endpoint')) {
+    // 让 qq endpoint cancel 等命令继续走命令链
+    if (raw.toLowerCase().startsWith('qq endpoint')) {
       await next();
       return;
     }
@@ -48,7 +49,11 @@ export default defineMiddleware<CommandMessage>({
     }
 
     try {
-      const text = completeQqPendingBotKind(pending, botKind);
+      const text = await completeQqPendingBotKind(
+        pending,
+        botKind,
+        context.use(endpointConfigurationStoreToken),
+      );
       state.pendingBotKind = null;
       await context.input.$reply?.(text);
     } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-qq",
-  "version": "1.1.0",
+  "version": "1.1.3",
   "description": "Zhin.js QQ Official adapter for Plugin Runtime (WebSocket gateway)",
   "type": "module",
   "main": "./lib/index.js",
@@ -35,27 +35,26 @@
   },
   "dependencies": {
     "qq-official-bot": "^1.3.0",
-    "@zhin.js/adapter": "1.1.12",
-    "@zhin.js/core": "1.1.35",
-    "@zhin.js/feature-kit": "1.1.0",
-    "@zhin.js/host-http": "1.1.0",
-    "@zhin.js/im-contract": "1.1.0",
-    "@zhin.js/logger": "1.1.0",
-    "@zhin.js/permission": "1.1.0"
+    "@zhin.js/adapter": "1.1.15",
+    "@zhin.js/agent-feature": "1.1.2",
+    "@zhin.js/core": "1.1.38",
+    "@zhin.js/feature-kit": "1.1.2",
+    "@zhin.js/host-http": "1.1.2",
+    "@zhin.js/im-contract": "1.1.2",
+    "@zhin.js/logger": "1.1.1",
+    "@zhin.js/permission": "1.1.2",
+    "@zhin.js/skill": "1.1.2",
+    "@zhin.js/tool": "1.1.2"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/adapter": "^1.1.12",
-    "@zhin.js/agent": "^1.1.23",
-    "@zhin.js/command": "^1.1.0",
-    "@zhin.js/core": "^1.1.35",
-    "@zhin.js/middleware": "^1.1.0",
-    "zhin.js": "^1.1.0"
+    "@zhin.js/adapter": "^1.1.15",
+    "@zhin.js/command": "^1.1.2",
+    "@zhin.js/core": "^1.1.38",
+    "@zhin.js/middleware": "^1.1.2",
+    "zhin.js": "^1.1.3"
   },
   "peerDependenciesMeta": {
-    "@zhin.js/agent": {
-      "optional": true
-    },
     "@zhin.js/command": {
       "optional": true
     },
@@ -74,9 +73,8 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.1.23",
-    "@zhin.js/host-http": "1.1.0",
-    "zhin.js": "1.1.0"
+    "@zhin.js/host-http": "1.1.2",
+    "zhin.js": "1.1.3"
   },
   "files": [
     "adapters",
@@ -86,9 +84,11 @@
     "schema.json",
     "src",
     "lib",
-    "agent",
+    "tools",
+    "agents",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "PERMITS.md"
   ],
   "publishConfig": {
     "access": "public",
@@ -115,6 +115,18 @@
       {
         "package": "@zhin.js/middleware",
         "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/tool",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/skill",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/agent-feature",
+        "api": "^1.0.0"
       }
     ],
     "plugins": []

package/schema.json

@@ -62,20 +62,13 @@
       "default": "/qq/webhook",
       "description": "POST path on httpHostToken for webhook/middleware modes."
     },
-    "port": {
-      "type": "number",
-      "description": "Legacy standalone webhook port (unused with httpHostToken)."
-    },
-    "path": {
-      "type": "string",
-      "description": "Legacy standalone webhook path (unused with httpHostToken)."
-    },
     "endpoints": {
       "type": "array",
-      "description": "多账号：一个插件实例挂多个 endpoint。每项与顶层字段同构（id 必填，其余覆盖顶层）",
+      "minItems": 1,
+      "description": "多账号：每项定义一个 endpoint，id/appid/secret 必填，其余字段覆盖实例默认值",
       "items": {
         "type": "object",
-        "additionalProperties": true,
+        "additionalProperties": false,
         "properties": {
           "appid": {
             "type": "string",
@@ -85,6 +78,17 @@
             "type": "string",
             "description": "QQ official bot secret"
           },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "websocket",
+              "webhook",
+              "middleware"
+            ]
+          },
+          "sandbox": {
+            "type": "boolean"
+          },
           "master": {
             "type": [
               "string",
@@ -118,6 +122,18 @@
             },
             "description": "覆盖顶层 intents"
           },
+          "accessTokenUrl": {
+            "type": "string"
+          },
+          "gatewayUrl": {
+            "type": "string"
+          },
+          "webhookPath": {
+            "type": "string"
+          },
+          "commandPrefix": {
+            "type": "string"
+          },
           "id": {
             "type": "string",
             "description": "QQ bot name"

package/src/index.ts

@@ -4,7 +4,7 @@ export {
   resolveOutboundMessageId,
   resolveQqConfig,
   senderDisplayName,
-  type QqAdapterConfig,
+  type QqEndpointConfig,
   type QqChannelKind,
   type QqInboundMessage,
   type QqWireSegment,

package/src/outbound.ts

@@ -13,7 +13,7 @@
  * 不可映射的段一律降级为文本并 warn（保持既有 fallback 行为）。
  */
 import { formatCompact, getLogger } from '@zhin.js/logger';
-import { isMediaRef } from '@zhin.js/core';
+import { isMediaRef } from '@zhin.js/im-contract';
 import type { QqWireSegment } from './protocol.js';
 
 const logger = getLogger('qq');

package/src/protocol.ts

@@ -1,20 +1,16 @@
-/**
- * QQ Official Bot protocol helpers — no legacy Adapter/Endpoint / segment-mapper.
- * Canonicalization is owned by gateway/core before endpoint.send.
- */
+/** QQ Official Bot protocol helpers. Canonicalization is owned by Core. */
 
-import { pickCredential } from 'zhin.js/adapter';
 import type { ConversationKind, ConversationRef } from '@zhin.js/im-contract';
 import { formatCompact, getLogger } from '@zhin.js/logger';
 import { resolveQqIntents } from './qq-intents.js';
 
 const logger = getLogger('qq');
 
-/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
-export interface QqAdapterConfig {
-  readonly id?: string;
-  readonly appid?: string;
-  readonly secret?: string;
+/** One endpoint config after AdapterIndex expands `plugins.<instanceKey>.endpoints`. */
+export interface QqEndpointConfig {
+  readonly id: string;
+  readonly appid: string;
+  readonly secret: string;
   /** Default `websocket`. `webhook` / `middleware` use httpHostToken POST. */
   readonly mode?: 'websocket' | 'webhook' | 'middleware';
   readonly sandbox?: boolean;
@@ -25,24 +21,6 @@ export interface QqAdapterConfig {
   readonly accessTokenUrl?: string;
   readonly gatewayUrl?: string;
   readonly webhookPath?: string;
-  readonly port?: number;
-  readonly path?: string;
-  /** Transitional: legacy root `endpoints[]` with `context: qq`. */
-  readonly endpoints?: ReadonlyArray<{
-    readonly context?: string;
-    readonly id?: string;
-    readonly appid?: string;
-    readonly secret?: string;
-    readonly mode?: 'websocket' | 'webhook' | 'middleware';
-    readonly sandbox?: boolean;
-    readonly intents?: readonly string[];
-    readonly botKind?: string;
-    readonly accessTokenUrl?: string;
-    readonly gatewayUrl?: string;
-    readonly webhookPath?: string;
-    readonly port?: number;
-    readonly path?: string;
-  }>;
 }
 
 export interface ResolvedQqWebsocketConfig {
@@ -98,23 +76,14 @@ export interface QqWireSegment {
   readonly data?: Record<string, unknown>;
 }
 
-export function resolveQqConfig(config: QqAdapterConfig = {}): ResolvedQqConfig {
-  const entry = config.endpoints?.find((item) => item.context === 'qq' || !item.context);
-  const appid = pickCredential(config.appid, entry?.appid, process.env.QQ_APPID, process.env.QQ_BOT_APPID);
-  const secret = pickCredential(config.secret, entry?.secret, process.env.QQ_SECRET, process.env.QQ_BOT_SECRET);
-  if (!appid || !secret) {
-    throw new TypeError(
-      'QQ adapter requires appid + secret (plugins.<key>.appid/secret or endpoints with context: qq)',
-    );
-  }
-  const id = (typeof config.id === 'string' && config.id)
-    || (typeof entry?.id === 'string' && entry.id)
-    || process.env.QQ_BOT_NAME
-    || 'qq-bot';
-  const mode = config.mode ?? entry?.mode ?? 'websocket';
+export function resolveQqConfig(config: QqEndpointConfig): ResolvedQqConfig {
+  const id = requiredEndpointField(config.id, 'id');
+  const appid = requiredEndpointField(config.appid, 'appid');
+  const secret = requiredEndpointField(config.secret, 'secret');
+  const mode = config.mode ?? 'websocket';
 
   if (mode === 'webhook' || mode === 'middleware') {
-    const webhookPathRaw = config.webhookPath ?? entry?.webhookPath ?? '/qq/webhook';
+    const webhookPathRaw = config.webhookPath ?? '/qq/webhook';
     const webhookPath = webhookPathRaw.startsWith('/') ? webhookPathRaw : `/${webhookPathRaw}`;
     return {
       context: 'qq',
@@ -123,7 +92,7 @@ export function resolveQqConfig(config: QqAdapterConfig = {}): ResolvedQqConfig
       appid,
       secret,
       webhookPath,
-      sandbox: config.sandbox === true || entry?.sandbox === true,
+      sandbox: config.sandbox === true,
     };
   }
 
@@ -133,16 +102,23 @@ export function resolveQqConfig(config: QqAdapterConfig = {}): ResolvedQqConfig
     id,
     appid,
     secret,
-    sandbox: config.sandbox === true || entry?.sandbox === true,
+    sandbox: config.sandbox === true,
     intents: resolveQqIntents({
-      intents: config.intents ?? entry?.intents,
-      botKind: config.botKind ?? entry?.botKind,
+      intents: config.intents,
+      botKind: config.botKind,
     }),
-    accessTokenUrl: config.accessTokenUrl ?? entry?.accessTokenUrl,
-    gatewayUrl: config.gatewayUrl ?? entry?.gatewayUrl,
+    accessTokenUrl: config.accessTokenUrl,
+    gatewayUrl: config.gatewayUrl,
   };
 }
 
+function requiredEndpointField(value: unknown, field: 'id' | 'appid' | 'secret'): string {
+  if (typeof value !== 'string' || !value.trim()) {
+    throw new TypeError(`QQ endpoint requires a non-empty ${field}`);
+  }
+  return value.trim();
+}
+
 /**
  * 入站归一化 → ConversationRef：`direct`（频道私信）映射为 guild 容器内的
  * private 会话；频道消息的所属 guild 进 `parent`。

package/src/qq-bot-kind-prompt.ts

@@ -44,4 +44,4 @@ export function parseQqBotKindAnswer(raw: unknown): QqBotKind | undefined {
 
 export const QQ_BOT_KIND_PROMPT =
   '请回复 public（公域）或 private（私域），确认后一次性写入 .env 与配置。\n'
-  + '也可发 qq.endpoint cancel 取消。';
+  + '也可发 qq endpoint cancel 取消。';

package/src/ws.ts

@@ -8,7 +8,7 @@ import {
   type ApproveJoinRequestOptions,
   type Sendable,
 } from 'qq-official-bot';
-import type { MediaRef, Segment } from '@zhin.js/core';
+import type { MediaRef, Segment } from '@zhin.js/im-contract';
 import type { QqOutboundMessage } from './outbound.js';
 import type { QqChannelKind, QqInboundMessage, ResolvedQqWebsocketConfig } from './protocol.js';
 

package/agent/skills/qq.md

@@ -1,97 +0,0 @@
----
-name: qq
-platforms:
-  - qq
-description: >-
-  QQ 官方机器人管理能力。当用户在 QQ 官方机器人（非 OneBot/NapCat）中请求群管（踢人、
-  禁言、全员禁言）、频道/子频道管理、角色管理（创建/添加/移除角色）、
-  或查询成员详情时使用。即使用户没有明确提到 QQ 官方机器人，只要 Endpoint 平台是 qq
-  （官方 API）且涉及上述操作，就应触发。仅有昵称时先 list_members 查 user_id。
-keywords:
-  - qq
-  - QQ
-  - adapter:qq
-  - 群管理
-  - 频道
-  - 子频道
-  - 角色
-  - 官方机器人
-  - list_members
-tags:
-  - group
-  - management
-  - im
-tools:
-  - qq_list_guilds
-  - qq_list_channels
-  - qq_list_roles
-  - qq_create_role
-  - qq_add_role
-  - qq_remove_role
-  - qq_channel_info
-  - qq_member_detail
-  - qq_kick_member
-  - qq_mute_member
-  - qq_mute_all
-  - qq_list_members
-  - qq_get_group_info
----
-
-# QQ 官方机器人管理技能
-
-QQ 官方机器人 API 同时支持「群聊」和「频道」两种场景，频道有 Guild/Channel 二级结构。
-
-## 核心原则
-
-### 群 vs 频道
-
-QQ 官方机器人有两个独立的体系：
-- **群聊**（Group）：传统 QQ 群，用 `group_id` 标识
-- **频道**（Guild + Channel）：类似 Discord，Guild 是大频道，Channel 是子频道
-
-操作前确认用户说的是「群」还是「频道」。
-
-### 频道导航链
-
-频道操作需要逐级获取 ID：
-```
-qq_list_guilds → 获取 guild_id
-qq_list_channels(guild_id) → 获取 channel_id
-qq_channel_info(channel_id) → 子频道详情
-```
-
-## 工具分类
-
-### 群聊管理
-
-| 工具 | 用途 | 说明 |
-|------|------|------|
-| `qq_kick_member` | 踢出成员 | — |
-| `qq_mute_member` | 禁言 | — |
-| `qq_mute_all` | 全员禁言/解除 | — |
-| `qq_list_members` | 成员列表 | — |
-| `qq_get_group_info` | 群信息 | — |
-
-### 频道管理
-
-| 工具 | 用途 | 说明 |
-|------|------|------|
-| `qq_list_guilds` | 频道列表 | 获取所有 Guild |
-| `qq_list_channels` | 子频道列表 | 获取 Guild 下的 Channel |
-| `qq_channel_info` | 子频道详情 | — |
-| `qq_member_detail` | 成员详情 | — |
-
-### 角色管理
-
-| 工具 | 用途 | 说明 |
-|------|------|------|
-| `qq_create_role` | 创建角色 | — |
-| `qq_add_role` | 授予角色 | 需 role_id |
-| `qq_remove_role` | 移除角色 | 需 role_id |
-| `qq_list_roles` | 角色列表 | 获取所有角色及 ID |
-
-## 易错点
-
-1. **频道操作需要 guild_id + channel_id 二级 ID**，不能只用一个。先 `list_guilds` 再 `list_channels`。
-2. **角色操作需要 role_id**，先 `qq_list_roles` 查询。
-3. **此适配器是 QQ 官方 API**，功能受限于官方开放的接口，不如 NapCat/ICQQ 灵活。

package/commands/endpoint/add/[[id]].ts

@@ -1,3 +0,0 @@
-import { qqEndpointCommands } from '../../../src/qq-endpoint-commands.js';
-
-export default qqEndpointCommands.add;

package/commands/endpoint/list.ts

@@ -1,3 +0,0 @@
-import { qqEndpointCommands } from '../../src/qq-endpoint-commands.js';
-
-export default qqEndpointCommands.list;

package/commands/endpoint/remove/[id].ts

@@ -1,3 +0,0 @@
-import { qqEndpointCommands } from '../../../src/qq-endpoint-commands.js';
-
-export default qqEndpointCommands.remove;

package/lib/qq-bind-persist.d.ts

@@ -1,12 +0,0 @@
-import { resolveProjectRoot } from 'zhin.js/adapter';
-export { resolveProjectRoot };
-export interface QqCredentialEnvKeys {
-    appidKey: string;
-    secretKey: string;
-    appidRef: string;
-    secretRef: string;
-}
-/** 按 endpoint 名称生成唯一 env 键（如 `QQ_MY_BOT_APPID`） */
-export declare function buildQqCredentialEnvKeys(endpointId: string): QqCredentialEnvKeys;
-/** 写入或更新 `.env` 中的键值，并同步到当前进程 `process.env` */
-export declare function persistQqCredentialsToEnv(endpointId: string, appId: string, appSecret: string, projectRoot?: string): QqCredentialEnvKeys;

package/lib/qq-bind-persist.js

@@ -1,22 +0,0 @@
-import { buildEndpointEnvKey, persistEndpointEnvValues, resolveProjectRoot, } from 'zhin.js/adapter';
-export { resolveProjectRoot };
-/** 按 endpoint 名称生成唯一 env 键（如 `QQ_MY_BOT_APPID`） */
-export function buildQqCredentialEnvKeys(endpointId) {
-    const appidKey = buildEndpointEnvKey('qq', endpointId, 'appid');
-    const secretKey = buildEndpointEnvKey('qq', endpointId, 'secret');
-    return {
-        appidKey,
-        secretKey,
-        appidRef: `\${${appidKey}}`,
-        secretRef: `\${${secretKey}}`,
-    };
-}
-/** 写入或更新 `.env` 中的键值，并同步到当前进程 `process.env` */
-export function persistQqCredentialsToEnv(endpointId, appId, appSecret, projectRoot) {
-    const keys = buildQqCredentialEnvKeys(endpointId);
-    persistEndpointEnvValues({
-        [keys.appidKey]: appId,
-        [keys.secretKey]: appSecret,
-    }, projectRoot);
-    return keys;
-}

package/lib/qq-endpoint-commands.d.ts

@@ -1,45 +0,0 @@
-/**
- * `qq.endpoint` 命令的业务逻辑（与命令定义文件分离，便于测试）。
- * 通用部分（权限 / list / remove / 配置写回 / .env 持久化）已迁移到
- * @zhin.js/adapter 的 createEndpointCommands 套件；本文件保留 QQ 特化的
- * 扫码绑定 add 流程（经套件 bindFlow 钩子接入）与 cancel，并导出
- * qqEndpointCommands 供 commands/endpoint/ 下的命令文件默认导出。
- */
-import { type EndpointCommandReply } from 'zhin.js/adapter';
-import { type QqBotKind } from './qq-intents.js';
-import { type QqPendingBotKind, type QqRuntimeState } from './qq-runtime-state.js';
-export type QqCommandReply = EndpointCommandReply;
-/**
- * endpoint 管理命令的操作者校验：实例配置声明了 master（顶层或任一端点项）时
- * 仅 master 可执行 add/cancel/remove；未配置则放行（首个扫码绑定者即为 owner，
- * legacy applyBindOwnership 会把 operator 写为新端点的 master）。
- */
-export declare function isQqEndpointOperator(config: unknown, input: unknown): boolean;
-export declare const QQ_ENDPOINT_FORBIDDEN: string;
-/**
- * 从命令 input（Runtime Message）提取 $reply；非消息来源（如 Host API 调用）降级为 no-op。
- */
-export declare function extractQqCommandReply(input: unknown): QqCommandReply;
-/** `qq.endpoint list`：运行中的 endpoints（本 generation adapter create 注册）+ 配置里的 endpoints */
-export declare function runQqEndpointList(state: QqRuntimeState, projectRoot?: string): string;
-/**
- * 完成 pending 的公域/私域选择：一次性写 .env + yaml。
- * @returns 成功文案；调用方负责清 pending。
- */
-export declare function completeQqPendingBotKind(pending: QqPendingBotKind, botKind: QqBotKind, projectRoot?: string): string;
-/**
- * `qq.endpoint add [id]`：启动扫码绑定流程。
- * 返回的 Promise 在二维码链接就绪（或前置失败）时 resolve 为首条回复；
- * 后续状态（已扫码 / 成功 / 失败 / 过期刷新）通过 reply 推回当前会话。
- * 扫码成功后凭据暂存内存并询问公域/私域；确认后一次性写 .env + yaml。
- */
-export declare function runQqEndpointAdd(state: QqRuntimeState, id: string | undefined, reply: QqCommandReply, projectRoot?: string, input?: unknown): Promise<string>;
-/** `qq.endpoint cancel`：中止进行中的绑定或待选 botKind */
-export declare function runQqEndpointCancel(state: QqRuntimeState): string;
-/** `qq.endpoint remove <id>`：从 zhin.config.yml 移除对应 endpoints 项 */
-export declare function runQqEndpointRemove(_state: QqRuntimeState, id: string, projectRoot?: string): string;
-/**
- * 通用套件生成的 QQ endpoint 命令（add 经 bindFlow 钩子走扫码绑定）。
- * commands/endpoint/ 下的 list / add / remove 直接默认导出这三项；cancel 为 QQ 特化，单独定义。
- */
-export declare const qqEndpointCommands: import("@zhin.js/adapter").EndpointCommands<Readonly<import("@zhin.js/command").CommandDefinition<unknown, unknown, import("@zhin.js/command").CommandMessage, string | undefined>>>;

package/lib/qq-endpoint-config.d.ts

@@ -1,17 +0,0 @@
-export interface QqEndpointConfigEntry {
-    id: string;
-    appid: string;
-    secret: string;
-    [key: string]: unknown;
-}
-/** 定位项目配置文件：ZHIN_CONFIG 指定优先，否则发现 zhin.config.yml/.yaml，都没有则默认新建 zhin.config.yml */
-export declare function findQqConfigFile(projectRoot?: string): string;
-/** 读取 plugins.qq.endpoints（plain JS）；plugins/qq 缺失或形态不符时返回 [] */
-export declare function listQqEndpointEntries(projectRoot?: string): QqEndpointConfigEntry[];
-/** 追加 endpoint 到 plugins.qq.endpoints；id 已存在时报错 */
-export declare function addQqEndpointToConfig(entry: QqEndpointConfigEntry, projectRoot?: string): string;
-/** 按 id 移除 plugins.qq.endpoints 项；不存在返回 false */
-export declare function removeQqEndpointFromConfig(id: string, projectRoot?: string): {
-    removed: boolean;
-    filePath: string;
-};

package/lib/qq-endpoint-config.js

@@ -1,22 +0,0 @@
-/**
- * zhin.config.yml 中 plugins.qq.endpoints 的读写（Plugin Runtime 版）。
- * 实现已泛化到 @zhin.js/adapter 的 endpoint-commands 套件（Document 节点级保留注释）；
- * 本文件仅保留 QQ 专用签名以兼容既有调用与测试。
- */
-import { addEndpointToConfig, findEndpointConfigFile, listConfiguredEndpoints, removeEndpointFromConfig, } from 'zhin.js/adapter';
-/** 定位项目配置文件：ZHIN_CONFIG 指定优先，否则发现 zhin.config.yml/.yaml，都没有则默认新建 zhin.config.yml */
-export function findQqConfigFile(projectRoot) {
-    return findEndpointConfigFile('qq', projectRoot);
-}
-/** 读取 plugins.qq.endpoints（plain JS）；plugins/qq 缺失或形态不符时返回 [] */
-export function listQqEndpointEntries(projectRoot) {
-    return listConfiguredEndpoints('qq', projectRoot);
-}
-/** 追加 endpoint 到 plugins.qq.endpoints；id 已存在时报错 */
-export function addQqEndpointToConfig(entry, projectRoot) {
-    return addEndpointToConfig('qq', entry, projectRoot);
-}
-/** 按 id 移除 plugins.qq.endpoints 项；不存在返回 false */
-export function removeQqEndpointFromConfig(id, projectRoot) {
-    return removeEndpointFromConfig('qq', id, projectRoot);
-}