@zhin.js/adapter-qq 1.1.0 → 1.1.3

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 ? '已移除成员的角色' : '操作失败' };
+    },
+});

package/{agent/tools/remove_role.ts → agents/qq/skills/qq/tools/remove_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.removeMemberRole(guild_id, channel_id, user_id, role_id);

package/agents/qq/system.md

@@ -0,0 +1,3 @@
+# QQ Platform Agent
+
+You are the qq platform specialist. Interpret requests in the current qq conversation and load only the narrowest private Skill needed for the task.

package/commands/{endpoint/add/[[id]].js → qq/endpoint/add/[[id]]/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { qqEndpointCommands } from "../../../lib/qq-endpoint-commands.js";
+import { qqEndpointCommands } from '../../definition.js';
 export default qqEndpointCommands.add;

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

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

package/commands/{endpoint/cancel.js → qq/endpoint/cancel/index.js}

@@ -1,7 +1,6 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { defineCommand } from 'zhin.js/command';
-import { isQqEndpointOperator, QQ_ENDPOINT_FORBIDDEN, runQqEndpointCancel, } from "../../lib/qq-endpoint-commands.js";
-import { qqRuntimeStateToken } from "../../lib/qq-runtime-state.js";
+import { isQqEndpointOperator, QQ_ENDPOINT_FORBIDDEN, qqRuntimeStateToken, runQqEndpointCancel, } from '../definition.js';
 export default defineCommand({
     description: '取消进行中的 QQ 扫码绑定或公域/私域选择',
     execute({ config, input, use }) {

package/commands/{endpoint/cancel.ts → qq/endpoint/cancel/index.ts}

@@ -2,9 +2,9 @@ import { defineCommand } from 'zhin.js/command';
 import {
   isQqEndpointOperator,
   QQ_ENDPOINT_FORBIDDEN,
+  qqRuntimeStateToken,
   runQqEndpointCancel,
-} from '../../src/qq-endpoint-commands.js';
-import { qqRuntimeStateToken } from '../../src/qq-runtime-state.js';
+} from '../definition.js';
 
 export default defineCommand({
   description: '取消进行中的 QQ 扫码绑定或公域/私域选择',

package/{lib/qq-endpoint-commands.js → commands/qq/endpoint/definition.js}

@@ -1,18 +1,18 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
 /**
- * `qq.endpoint` 命令的业务逻辑（与命令定义文件分离，便于测试）。
+ * `qq endpoint` 命令的业务逻辑（与命令定义文件分离，便于测试）。
  * 通用部分（权限 / list / remove / 配置写回 / .env 持久化）已迁移到
  * @zhin.js/adapter 的 createEndpointCommands 套件；本文件保留 QQ 特化的
  * 扫码绑定 add 流程（经套件 bindFlow 钩子接入）与 cancel，并导出
- * qqEndpointCommands 供 commands/endpoint/ 下的命令文件默认导出。
+ * qqEndpointCommands 供 commands/qq/endpoint/ 下的命令文件默认导出。
  */
-import { createEndpointCommands, endpointCommandForbidden, extractEndpointCommandReply, formatEndpointList, isEndpointOperator, removeEndpointById, } from 'zhin.js/adapter';
+import { buildEndpointEnvKey, createEndpointCommands, endpointCommandForbidden, endpointConfigurationStoreToken, extractEndpointCommandReply, formatEndpointList, isEndpointOperator, removeEndpointById, } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { QQ_BOT_KIND_PROMPT, qqCommandSessionKey } from './qq-bot-kind-prompt.js';
-import { startQqBindFlow } from './qq-bind-flow.js';
-import { persistQqCredentialsToEnv } from './qq-bind-persist.js';
-import { addQqEndpointToConfig, listQqEndpointEntries } from './qq-endpoint-config.js';
-import { defaultQqEndpointIntentFields } from './qq-intents.js';
-import { qqRuntimeStateToken, } from './qq-runtime-state.js';
+import { QQ_BOT_KIND_PROMPT, qqCommandSessionKey } from "../../../lib/qq-bot-kind-prompt.js";
+import { startQqBindFlow } from "../../../lib/qq-bind-flow.js";
+import { defaultQqEndpointIntentFields } from "../../../lib/qq-intents.js";
+import { qqRuntimeStateToken, } from "../../../lib/qq-runtime-state.js";
+export { qqRuntimeStateToken };
 /**
  * endpoint 管理命令的操作者校验：实例配置声明了 master（顶层或任一端点项）时
  * 仅 master 可执行 add/cancel/remove；未配置则放行（首个扫码绑定者即为 owner，
@@ -30,17 +30,17 @@ export function extractQqCommandReply(input) {
 }
 function busyFooter(state) {
     if (state.bindFlow)
-        return '⚠️ 有进行中的扫码绑定，可用 qq.endpoint cancel 取消';
+        return '⚠️ 有进行中的扫码绑定，可用 qq endpoint cancel 取消';
     if (state.pendingBotKind) {
-        return `⚠️ endpoint「${state.pendingBotKind.endpointId}」等待公域/私域选择，回复 public/private 或 qq.endpoint cancel`;
+        return `⚠️ endpoint「${state.pendingBotKind.endpointId}」等待公域/私域选择，回复 public/private 或 qq endpoint cancel`;
     }
     return undefined;
 }
-/** `qq.endpoint list`：运行中的 endpoints（本 generation adapter create 注册）+ 配置里的 endpoints */
-export function runQqEndpointList(state, projectRoot) {
+/** `qq endpoint list`：运行中的 endpoints（本 generation adapter create 注册）+ 配置里的 endpoints */
+export async function runQqEndpointList(state, store) {
     return formatEndpointList(qqEndpointListSpec, {
         running: state.endpoints.values(),
-        configured: listQqEndpointEntries(projectRoot),
+        configured: await store.list('qq'),
         footer: busyFooter(state),
     });
 }
@@ -49,16 +49,24 @@ const qqEndpointListSpec = {
     adapterDisplayName: 'QQ',
     describeEntry: (entry) => `appid: ${String(entry.appid)}`,
 };
-function writeEndpointWithBotKind(pending, botKind, projectRoot) {
-    const envKeys = persistQqCredentialsToEnv(pending.endpointId, pending.appId, pending.appSecret, projectRoot);
+async function writeEndpointWithBotKind(pending, botKind, store) {
+    const appidKey = buildEndpointEnvKey('qq', pending.endpointId, 'appid');
+    const secretKey = buildEndpointEnvKey('qq', pending.endpointId, 'secret');
     const intentFields = defaultQqEndpointIntentFields(botKind);
-    const filePath = addQqEndpointToConfig({
-        id: pending.endpointId,
-        appid: envKeys.appidRef,
-        secret: envKeys.secretRef,
-        botKind: intentFields.botKind,
-        intents: [...intentFields.intents],
-    }, projectRoot);
+    const { filePath } = await store.add({
+        adapterKey: 'qq',
+        entry: {
+            id: pending.endpointId,
+            appid: `\${${appidKey}}`,
+            secret: `\${${secretKey}}`,
+            botKind: intentFields.botKind,
+            intents: [...intentFields.intents],
+        },
+        environment: {
+            [appidKey]: pending.appId,
+            [secretKey]: pending.appSecret,
+        },
+    });
     return (`✅ 已按 botKind=${intentFields.botKind} 将 endpoint「${pending.endpointId}」写入 .env 与 ${filePath}。\n` +
         `intents: ${intentFields.intents.join(', ')}。\n` +
         '⚠️ 需重启 zhin 后新 endpoint 才会生效。');
@@ -67,18 +75,18 @@ function writeEndpointWithBotKind(pending, botKind, projectRoot) {
  * 完成 pending 的公域/私域选择：一次性写 .env + yaml。
  * @returns 成功文案；调用方负责清 pending。
  */
-export function completeQqPendingBotKind(pending, botKind, projectRoot) {
-    return writeEndpointWithBotKind(pending, botKind, projectRoot);
+export async function completeQqPendingBotKind(pending, botKind, store) {
+    return await writeEndpointWithBotKind(pending, botKind, store);
 }
 /**
- * `qq.endpoint add [id]`：启动扫码绑定流程。
+ * `qq endpoint add [id]`：启动扫码绑定流程。
  * 返回的 Promise 在二维码链接就绪（或前置失败）时 resolve 为首条回复；
  * 后续状态（已扫码 / 成功 / 失败 / 过期刷新）通过 reply 推回当前会话。
  * 扫码成功后凭据暂存内存并询问公域/私域；确认后一次性写 .env + yaml。
  */
-export function runQqEndpointAdd(state, id, reply, projectRoot, input) {
+export function runQqEndpointAdd(state, id, reply, store, input) {
     if (state.bindFlow || state.pendingBotKind) {
-        return Promise.resolve('已有进行中的 QQ 机器人绑定或待确认的公域/私域选择，请先发送 qq.endpoint cancel 取消后再试');
+        return Promise.resolve('已有进行中的 QQ 机器人绑定或待确认的公域/私域选择，请先发送 qq endpoint cancel 取消后再试');
     }
     const endpointId = id?.trim() || undefined;
     const sessionKey = qqCommandSessionKey(input);
@@ -115,12 +123,12 @@ export function runQqEndpointAdd(state, id, reply, projectRoot, input) {
                     const finalName = endpointId ?? appId;
                     // 无会话上下文（Host 等）时无法追问，直接按公域一次性写入
                     if (!sessionKey) {
-                        settle(writeEndpointWithBotKind({
+                        settle(await writeEndpointWithBotKind({
                             endpointId: finalName,
                             appId,
                             appSecret,
                             sessionKey: '',
-                        }, 'public', projectRoot) +
+                        }, 'public', store) +
                             '\n（当前会话无法交互选择公/私域；私域请手动改配置。）');
                         return;
                     }
@@ -145,7 +153,7 @@ export function runQqEndpointAdd(state, id, reply, projectRoot, input) {
         state.bindFlow = { id: endpointId, stop };
     });
 }
-/** `qq.endpoint cancel`：中止进行中的绑定或待选 botKind */
+/** `qq endpoint cancel`：中止进行中的绑定或待选 botKind */
 export function runQqEndpointCancel(state) {
     if (state.bindFlow) {
         state.bindFlow.stop();
@@ -159,13 +167,13 @@ export function runQqEndpointCancel(state) {
     }
     return '当前没有进行中的 QQ 绑定流程';
 }
-/** `qq.endpoint remove <id>`：从 zhin.config.yml 移除对应 endpoints 项 */
-export function runQqEndpointRemove(_state, id, projectRoot) {
-    return removeEndpointById(qqEndpointListSpec, id, projectRoot);
+/** `qq endpoint remove <id>`：从 zhin.config.yml 移除对应 endpoints 项 */
+export async function runQqEndpointRemove(_state, id, store) {
+    return await removeEndpointById(qqEndpointListSpec, id, store);
 }
 /**
  * 通用套件生成的 QQ endpoint 命令（add 经 bindFlow 钩子走扫码绑定）。
- * commands/endpoint/ 下的 list / add / remove 直接默认导出这三项；cancel 为 QQ 特化，单独定义。
+ * commands/qq/endpoint/ 下的 list / add / remove 直接默认导出这三项；cancel 为 QQ 特化，单独定义。
  */
 export const qqEndpointCommands = createEndpointCommands({
     ...qqEndpointListSpec,
@@ -176,5 +184,5 @@ export const qqEndpointCommands = createEndpointCommands({
     running: (use) => use(qqRuntimeStateToken).endpoints.values(),
     listFooter: (use) => busyFooter(use(qqRuntimeStateToken)),
     addDescription: '手机 QQ 扫码绑定机器人：确认公域/私域后一次性写入 .env 与 zhin.config.yml（重启生效）',
-    bindFlow: ({ id, reply, input, use }) => runQqEndpointAdd(use(qqRuntimeStateToken), id, reply, undefined, input),
+    bindFlow: ({ id, reply, input, use }) => runQqEndpointAdd(use(qqRuntimeStateToken), id, reply, use(endpointConfigurationStoreToken), input),
 }, defineCommand);

package/{src/qq-endpoint-commands.ts → commands/qq/endpoint/definition.ts}

@@ -1,31 +1,34 @@
 /**
- * `qq.endpoint` 命令的业务逻辑（与命令定义文件分离，便于测试）。
+ * `qq endpoint` 命令的业务逻辑（与命令定义文件分离，便于测试）。
  * 通用部分（权限 / list / remove / 配置写回 / .env 持久化）已迁移到
  * @zhin.js/adapter 的 createEndpointCommands 套件；本文件保留 QQ 特化的
  * 扫码绑定 add 流程（经套件 bindFlow 钩子接入）与 cancel，并导出
- * qqEndpointCommands 供 commands/endpoint/ 下的命令文件默认导出。
+ * qqEndpointCommands 供 commands/qq/endpoint/ 下的命令文件默认导出。
  */
 import {
+  buildEndpointEnvKey,
   createEndpointCommands,
   endpointCommandForbidden,
+  endpointConfigurationStoreToken,
   extractEndpointCommandReply,
   formatEndpointList,
   isEndpointOperator,
   removeEndpointById,
   type ConfiguredEndpointEntry,
   type EndpointCommandReply,
+  type EndpointConfigurationStore,
 } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { QQ_BOT_KIND_PROMPT, qqCommandSessionKey } from './qq-bot-kind-prompt.js';
-import { startQqBindFlow } from './qq-bind-flow.js';
-import { persistQqCredentialsToEnv } from './qq-bind-persist.js';
-import { addQqEndpointToConfig, listQqEndpointEntries } from './qq-endpoint-config.js';
-import { defaultQqEndpointIntentFields, type QqBotKind } from './qq-intents.js';
+import { QQ_BOT_KIND_PROMPT, qqCommandSessionKey } from '../../../src/qq-bot-kind-prompt.js';
+import { startQqBindFlow } from '../../../src/qq-bind-flow.js';
+import { defaultQqEndpointIntentFields, type QqBotKind } from '../../../src/qq-intents.js';
 import {
   qqRuntimeStateToken,
   type QqPendingBotKind,
   type QqRuntimeState,
-} from './qq-runtime-state.js';
+} from '../../../src/qq-runtime-state.js';
+
+export { qqRuntimeStateToken };
 
 export type QqCommandReply = EndpointCommandReply;
 
@@ -48,18 +51,21 @@ export function extractQqCommandReply(input: unknown): QqCommandReply {
 }
 
 function busyFooter(state: QqRuntimeState): string | undefined {
-  if (state.bindFlow) return '⚠️ 有进行中的扫码绑定，可用 qq.endpoint cancel 取消';
+  if (state.bindFlow) return '⚠️ 有进行中的扫码绑定，可用 qq endpoint cancel 取消';
   if (state.pendingBotKind) {
-    return `⚠️ endpoint「${state.pendingBotKind.endpointId}」等待公域/私域选择，回复 public/private 或 qq.endpoint cancel`;
+    return `⚠️ endpoint「${state.pendingBotKind.endpointId}」等待公域/私域选择，回复 public/private 或 qq endpoint cancel`;
   }
   return undefined;
 }
 
-/** `qq.endpoint list`：运行中的 endpoints（本 generation adapter create 注册）+ 配置里的 endpoints */
-export function runQqEndpointList(state: QqRuntimeState, projectRoot?: string): string {
+/** `qq endpoint list`：运行中的 endpoints（本 generation adapter create 注册）+ 配置里的 endpoints */
+export async function runQqEndpointList(
+  state: QqRuntimeState,
+  store: EndpointConfigurationStore,
+): Promise<string> {
   return formatEndpointList(qqEndpointListSpec, {
     running: state.endpoints.values(),
-    configured: listQqEndpointEntries(projectRoot),
+    configured: await store.list('qq'),
     footer: busyFooter(state),
   });
 }
@@ -70,28 +76,28 @@ const qqEndpointListSpec = {
   describeEntry: (entry: ConfiguredEndpointEntry) => `appid: ${String(entry.appid)}`,
 } as const;
 
-function writeEndpointWithBotKind(
+async function writeEndpointWithBotKind(
   pending: QqPendingBotKind,
   botKind: QqBotKind,
-  projectRoot?: string,
-): string {
-  const envKeys = persistQqCredentialsToEnv(
-    pending.endpointId,
-    pending.appId,
-    pending.appSecret,
-    projectRoot,
-  );
+  store: EndpointConfigurationStore,
+): Promise<string> {
+  const appidKey = buildEndpointEnvKey('qq', pending.endpointId, 'appid');
+  const secretKey = buildEndpointEnvKey('qq', pending.endpointId, 'secret');
   const intentFields = defaultQqEndpointIntentFields(botKind);
-  const filePath = addQqEndpointToConfig(
-    {
+  const { filePath } = await store.add({
+    adapterKey: 'qq',
+    entry: {
       id: pending.endpointId,
-      appid: envKeys.appidRef,
-      secret: envKeys.secretRef,
+      appid: `\${${appidKey}}`,
+      secret: `\${${secretKey}}`,
       botKind: intentFields.botKind,
       intents: [...intentFields.intents],
     },
-    projectRoot,
-  );
+    environment: {
+      [appidKey]: pending.appId,
+      [secretKey]: pending.appSecret,
+    },
+  });
   return (
     `✅ 已按 botKind=${intentFields.botKind} 将 endpoint「${pending.endpointId}」写入 .env 与 ${filePath}。\n` +
     `intents: ${intentFields.intents.join(', ')}。\n` +
@@ -103,16 +109,16 @@ function writeEndpointWithBotKind(
  * 完成 pending 的公域/私域选择：一次性写 .env + yaml。
  * @returns 成功文案；调用方负责清 pending。
  */
-export function completeQqPendingBotKind(
+export async function completeQqPendingBotKind(
   pending: QqPendingBotKind,
   botKind: QqBotKind,
-  projectRoot?: string,
-): string {
-  return writeEndpointWithBotKind(pending, botKind, projectRoot);
+  store: EndpointConfigurationStore,
+): Promise<string> {
+  return await writeEndpointWithBotKind(pending, botKind, store);
 }
 
 /**
- * `qq.endpoint add [id]`：启动扫码绑定流程。
+ * `qq endpoint add [id]`：启动扫码绑定流程。
  * 返回的 Promise 在二维码链接就绪（或前置失败）时 resolve 为首条回复；
  * 后续状态（已扫码 / 成功 / 失败 / 过期刷新）通过 reply 推回当前会话。
  * 扫码成功后凭据暂存内存并询问公域/私域；确认后一次性写 .env + yaml。
@@ -121,12 +127,12 @@ export function runQqEndpointAdd(
   state: QqRuntimeState,
   id: string | undefined,
   reply: QqCommandReply,
-  projectRoot?: string,
+  store: EndpointConfigurationStore,
   input?: unknown,
 ): Promise<string> {
   if (state.bindFlow || state.pendingBotKind) {
     return Promise.resolve(
-      '已有进行中的 QQ 机器人绑定或待确认的公域/私域选择，请先发送 qq.endpoint cancel 取消后再试',
+      '已有进行中的 QQ 机器人绑定或待确认的公域/私域选择，请先发送 qq endpoint cancel 取消后再试',
     );
   }
   const endpointId = id?.trim() || undefined;
@@ -168,7 +174,7 @@ export function runQqEndpointAdd(
             // 无会话上下文（Host 等）时无法追问，直接按公域一次性写入
             if (!sessionKey) {
               settle(
-                writeEndpointWithBotKind(
+                await writeEndpointWithBotKind(
                   {
                     endpointId: finalName,
                     appId,
@@ -176,7 +182,7 @@ export function runQqEndpointAdd(
                     sessionKey: '',
                   },
                   'public',
-                  projectRoot,
+                  store,
                 ) +
                 '\n（当前会话无法交互选择公/私域；私域请手动改配置。）',
               );
@@ -208,7 +214,7 @@ export function runQqEndpointAdd(
   });
 }
 
-/** `qq.endpoint cancel`：中止进行中的绑定或待选 botKind */
+/** `qq endpoint cancel`：中止进行中的绑定或待选 botKind */
 export function runQqEndpointCancel(state: QqRuntimeState): string {
   if (state.bindFlow) {
     state.bindFlow.stop();
@@ -223,18 +229,18 @@ export function runQqEndpointCancel(state: QqRuntimeState): string {
   return '当前没有进行中的 QQ 绑定流程';
 }
 
-/** `qq.endpoint remove <id>`：从 zhin.config.yml 移除对应 endpoints 项 */
-export function runQqEndpointRemove(
+/** `qq endpoint remove <id>`：从 zhin.config.yml 移除对应 endpoints 项 */
+export async function runQqEndpointRemove(
   _state: QqRuntimeState,
   id: string,
-  projectRoot?: string,
-): string {
-  return removeEndpointById(qqEndpointListSpec, id, projectRoot);
+  store: EndpointConfigurationStore,
+): Promise<string> {
+  return await removeEndpointById(qqEndpointListSpec, id, store);
 }
 
 /**
  * 通用套件生成的 QQ endpoint 命令（add 经 bindFlow 钩子走扫码绑定）。
- * commands/endpoint/ 下的 list / add / remove 直接默认导出这三项；cancel 为 QQ 特化，单独定义。
+ * commands/qq/endpoint/ 下的 list / add / remove 直接默认导出这三项；cancel 为 QQ 特化，单独定义。
  */
 export const qqEndpointCommands = createEndpointCommands({
   ...qqEndpointListSpec,
@@ -247,5 +253,11 @@ export const qqEndpointCommands = createEndpointCommands({
   addDescription:
     '手机 QQ 扫码绑定机器人：确认公域/私域后一次性写入 .env 与 zhin.config.yml（重启生效）',
   bindFlow: ({ id, reply, input, use }) =>
-    runQqEndpointAdd(use(qqRuntimeStateToken), id, reply, undefined, input),
+    runQqEndpointAdd(
+      use(qqRuntimeStateToken),
+      id,
+      reply,
+      use(endpointConfigurationStoreToken),
+      input,
+    ),
 }, defineCommand);

package/commands/{endpoint/list.js → qq/endpoint/list/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { qqEndpointCommands } from "../../lib/qq-endpoint-commands.js";
+import { qqEndpointCommands } from '../definition.js';
 export default qqEndpointCommands.list;

package/commands/qq/endpoint/list/index.ts

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

package/commands/{endpoint/remove/[id].js → qq/endpoint/remove/[id]/index.js}

@@ -1,3 +1,3 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { qqEndpointCommands } from "../../../lib/qq-endpoint-commands.js";
+import { qqEndpointCommands } from '../../definition.js';
 export default qqEndpointCommands.remove;

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

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

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-export { formatInboundContent, formatOutboundText, resolveOutboundMessageId, resolveQqConfig, senderDisplayName, type QqAdapterConfig, type QqChannelKind, type QqInboundMessage, type QqWireSegment, type ResolvedQqConfig, type ResolvedQqHttpConfig, type ResolvedQqWebsocketConfig, } from './protocol.js';
+export { formatInboundContent, formatOutboundText, resolveOutboundMessageId, resolveQqConfig, senderDisplayName, type QqEndpointConfig, type QqChannelKind, type QqInboundMessage, type QqWireSegment, type ResolvedQqConfig, type ResolvedQqHttpConfig, type ResolvedQqWebsocketConfig, } from './protocol.js';
 export { DEFAULT_QQ_BOT_KIND, QQ_INTENTS_BY_KIND, defaultQqEndpointIntentFields, parseQqBotKind, resolveQqIntents, type QqBotKind, type QqIntent, } from './qq-intents.js';
 export { formatOutbound, resolveMediaFile, type QqOutboundElem, type QqOutboundMessage, } from './outbound.js';
 export { QqHttpEndpoint, QqWebsocketEndpoint, type CreateQqBot, type CreateQqHttpBot, type QqBotTransport, type QqOfficialApi, type QqEndpointOptions, type QqHttpBotTransport, type QqHttpEndpointOptions, } from './endpoint.js';

package/lib/outbound.js

@@ -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';
 const logger = getLogger('qq');
 /**
  * 解析 image/audio/video/file 段的投递源（canonical MediaRef 唯一来源）：

package/lib/protocol.d.ts

@@ -1,13 +1,10 @@
-/**
- * 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 type { ConversationRef } from '@zhin.js/im-contract';
-/** 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;
@@ -18,24 +15,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 {
     readonly context: 'qq';
@@ -84,7 +63,7 @@ export interface QqWireSegment {
     readonly type: string;
     readonly data?: Record<string, unknown>;
 }
-export declare function resolveQqConfig(config?: QqAdapterConfig): ResolvedQqConfig;
+export declare function resolveQqConfig(config: QqEndpointConfig): ResolvedQqConfig;
 /**
  * 入站归一化 → ConversationRef：`direct`（频道私信）映射为 guild 容器内的
  * private 会话；频道消息的所属 guild 进 `parent`。

package/lib/protocol.js

@@ -1,25 +1,14 @@
-/**
- * QQ Official Bot protocol helpers — no legacy Adapter/Endpoint / segment-mapper.
- * Canonicalization is owned by gateway/core before endpoint.send.
- */
-import { pickCredential } from 'zhin.js/adapter';
+/** QQ Official Bot protocol helpers. Canonicalization is owned by Core. */
 import { formatCompact, getLogger } from '@zhin.js/logger';
 import { resolveQqIntents } from './qq-intents.js';
 const logger = getLogger('qq');
-export function resolveQqConfig(config = {}) {
-    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) {
+    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',
@@ -28,7 +17,7 @@ export function resolveQqConfig(config = {}) {
             appid,
             secret,
             webhookPath,
-            sandbox: config.sandbox === true || entry?.sandbox === true,
+            sandbox: config.sandbox === true,
         };
     }
     return {
@@ -37,15 +26,21 @@ export function resolveQqConfig(config = {}) {
         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, field) {
+    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/lib/qq-bot-kind-prompt.js

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