@zhin.js/adapter-qq 7.0.2 → 7.0.5

package/src/endpoint.ts

@@ -5,18 +5,19 @@ import type {
   EndpointChannel,
   EndpointInstance,
   EndpointManagement,
+  EndpointSendRequest,
 } from '@zhin.js/adapter';
 import type { MessageGateway } from '@zhin.js/core/runtime';
 import type { HttpHost } from '@zhin.js/host-http';
-import { formatCompact, getLogger } from '@zhin.js/logger';
+import { formatCompact, getAdapterLogger, truncatePreview } from '@zhin.js/logger';
 import type { CapabilityId } from '@zhin.js/plugin-runtime';
 import { formatOutbound } from './outbound.js';
 import { registerQqAgentEndpoint } from './qq-agent-deps.js';
 import {
   formatInboundContent,
-  formatInboundTarget,
   parseCompoundMessageId,
-  parseSendTarget,
+  qqInboundConversation,
+  qqOutboundKind,
   resolveOutboundMessageId,
   senderDisplayName,
   type QqInboundMessage,
@@ -37,8 +38,6 @@ import {
   type QqBotTransport,
 } from './ws.js';
 
-const logger = getLogger('qq');
-
 export type { CreateQqBot, QqBotTransport } from './ws.js';
 export type { CreateQqHttpBot, QqHttpBotTransport } from './webhook.js';
 
@@ -50,6 +49,8 @@ export interface QqEndpointOptions {
 }
 
 export class QqWebsocketEndpoint implements EndpointInstance {
+  readonly #logger!: ReturnType<typeof getAdapterLogger>;
+
   readonly #options: QqEndpointOptions;
   readonly #createBot: CreateQqBot;
   #bot: QqBotTransport | null = null;
@@ -59,32 +60,30 @@ export class QqWebsocketEndpoint implements EndpointInstance {
   readonly management: EndpointManagement = createQqEndpointManagement(this);
 
   constructor(options: QqEndpointOptions) {
+    this.#logger = getAdapterLogger('qq', options.config.id);
     this.#options = options;
     this.#createBot = options.createBot ?? defaultCreateBot;
   }
 
   /** Live endpoint 名（Console/AdapterIndex 展示用，如 bot appid 别名）。 */
   get name(): string {
-    return this.#options.config.name;
+    return this.#options.config.id;
   }
 
   async start(): Promise<void> {
     if (this.#started) return;
     this.#started = true;
     try {
-      this.#unregisterAgent = registerQqAgentEndpoint(this.#options.config.name, this);
+      this.#unregisterAgent = registerQqAgentEndpoint(this.#options.config.id, this);
       this.#bot = this.#createBot(this.#options.config);
       this.#bindBot(this.#bot);
       await this.#bot.start();
-      logger.info(formatCompact({
-        op: 'connect',
-        endpoint: this.#options.config.name,
-        mode: 'websocket',
-        appid: this.#options.config.appid,
-      }));
+      this.#logger.info(
+        `connected (websocket) | appid: ${this.#options.config.appid}`,
+      );
     } catch (error) {
       await this.stop();
-      logger.error('Failed to connect QQ websocket:', error);
+      this.#logger.error('Failed to connect QQ websocket:', error);
       const raw = error instanceof Error ? error.message : String(error);
       throw new Error(
         `QQ WebSocket 连接失败：请检查 appid/secret 是否配对、网关地址（gatewayUrl/accessTokenUrl）是否可达（原始错误：${raw}）`,
@@ -115,38 +114,35 @@ export class QqWebsocketEndpoint implements EndpointInstance {
       this.#bot = null;
     }
     this.#started = false;
-    logger.debug(formatCompact({ op: 'disconnect', endpoint: this.#options.config.name }));
+    this.#logger.debug(formatCompact({ op: 'disconnect' }));
   }
 
-  async send({ target, payload }: { readonly target: string; readonly payload: unknown }): Promise<string> {
+  async send({ conversation, payload }: EndpointSendRequest): Promise<string> {
     const body = formatOutbound(payload);
-    const parsed = parseSendTarget(target);
+    const kind = qqOutboundKind(conversation);
     const bot = this.#requireBot();
     let result: unknown;
-    switch (parsed.kind) {
+    switch (kind) {
       case 'private':
-        result = await bot.sendPrivateMessage(parsed.id, body);
+        result = await bot.sendPrivateMessage(conversation.id, body);
         break;
       case 'group':
-        result = await bot.sendGroupMessage(parsed.id, body);
+        result = await bot.sendGroupMessage(conversation.id, body);
         break;
       case 'channel':
-        result = await bot.sendGuildMessage(parsed.id, body);
+        result = await bot.sendGuildMessage(conversation.id, body);
         break;
       case 'direct':
         if (!bot.sendDirectMessage) throw new Error('QQ direct message not supported by transport');
-        result = await bot.sendDirectMessage(parsed.id, body);
+        result = await bot.sendDirectMessage(conversation.id, body);
         break;
-      default:
-        throw new Error(`unsupported QQ target kind: ${String((parsed as ParsedSendTarget).kind)}`);
     }
-    const messageId = `${parsed.kind}-${parsed.id}:${resolveOutboundMessageId(result)}`;
-    logger.debug(formatCompact({
-      op: 'qq_send',
-      endpoint: this.#options.config.name,
-      target,
-      messageId,
-    }));
+    const messageId = `${kind}-${conversation.id}:${resolveOutboundMessageId(result)}`;
+    this.#logger.info(
+      `send ${kind}:${conversation.id}`
+      + ` | id: ${messageId}`
+      + ` | ${truncatePreview(typeof body === 'string' ? body : String(body), 80)}`,
+    );
     return messageId;
   }
 
@@ -167,9 +163,9 @@ export class QqWebsocketEndpoint implements EndpointInstance {
         await bot.recallDirectMessage?.(channelId, qqMsgId);
         break;
     }
-    logger.debug(formatCompact({
+    this.#logger.debug(formatCompact({
       op: 'qq_recall',
-      endpoint: this.#options.config.name,
+      endpoint: this.#options.config.id,
       kind,
       messageId,
     }));
@@ -178,27 +174,36 @@ export class QqWebsocketEndpoint implements EndpointInstance {
   /** Test / internal: admit a message when open. */
   admit(msg: QqInboundMessage): void {
     if (!this.#open) return;
-    const target = formatInboundTarget(msg);
+    const conversation = qqInboundConversation(String(this.#options.id), msg);
+    const content = formatInboundContent(msg);
+    this.#logger.info(
+      `recv ${conversation.kind}:${conversation.id}`
+      + (msg.authorId ? ` from ${msg.authorId}` : '')
+      + (msg.mentioned ? ' (mentioned)' : '')
+      + ` | ${truncatePreview(content, 80)}`,
+    );
     void this.#options.gateway.receive({
-      adapter: this.#options.id,
-      target,
-      content: formatInboundContent(msg),
+      conversation,
+      message: { conversation, id: msg.id },
+      content,
       ...(msg.segments?.length ? { segments: msg.segments } : {}),
-      sender: senderDisplayName(msg),
-      id: msg.id,
+      sender: {
+        id: msg.authorId,
+        name: senderDisplayName(msg) || undefined,
+        ...(msg.authorRoles?.length ? { roles: msg.authorRoles } : {}),
+      },
+      endpointId: this.#options.config.id,
+      ...(msg.mentioned ? { mentioned: true } : {}),
       metadata: Object.freeze({
-        endpoint: this.#options.config.name,
         channelKind: msg.channelKind,
         userId: msg.authorId,
         guildId: msg.guildId,
         roles: msg.authorRoles,
-        // AT 事件本身即 @ 机器人；新 Runtime 纯文本 content 需经 metadata 传递
-        ...(msg.mentioned ? { mentioned: true } : {}),
       }),
     }).catch((err) => {
-      logger.warn(formatCompact({
+      this.#logger.warn(formatCompact({
         op: 'qq_gateway_receive_failed',
-        target,
+        target: `${conversation.kind}:${conversation.id}`,
         error: err instanceof Error ? err.message : String(err),
       }));
     });
@@ -249,8 +254,6 @@ export class QqWebsocketEndpoint implements EndpointInstance {
   }
 }
 
-type ParsedSendTarget = ReturnType<typeof parseSendTarget>;
-
 export interface QqHttpEndpointOptions {
   readonly id: CapabilityId;
   readonly gateway: MessageGateway;
@@ -261,6 +264,8 @@ export interface QqHttpEndpointOptions {
 
 /** Webhook / middleware inbound via httpHostToken POST (qq-official-bot Middleware receiver). */
 export class QqHttpEndpoint implements EndpointInstance {
+  readonly #logger!: ReturnType<typeof getAdapterLogger>;
+
   readonly #options: QqHttpEndpointOptions;
   readonly #createBot: CreateQqHttpBot;
   #bot: QqHttpBotTransport | null = null;
@@ -271,13 +276,14 @@ export class QqHttpEndpoint implements EndpointInstance {
   readonly management: EndpointManagement = createQqEndpointManagement(this);
 
   constructor(options: QqHttpEndpointOptions) {
+    this.#logger = getAdapterLogger('qq', options.config.id);
     this.#options = options;
     this.#createBot = options.createBot ?? defaultCreateHttpBot;
   }
 
   /** Live endpoint 名（Console/AdapterIndex 展示用）。 */
   get name(): string {
-    return this.#options.config.name;
+    return this.#options.config.id;
   }
 
   async start(): Promise<void> {
@@ -285,22 +291,19 @@ export class QqHttpEndpoint implements EndpointInstance {
     this.#started = true;
     try {
       this.#unregisterAgent = registerQqAgentEndpoint(
-        this.#options.config.name,
+        this.#options.config.id,
         this as unknown as QqWebsocketEndpoint,
       );
       this.#setupRoutes();
       this.#bot = this.#createBot(this.#options.config);
       this.#bindBot(this.#bot);
       await this.#bot.start();
-      logger.info(formatCompact({
-        op: 'connect',
-        endpoint: this.#options.config.name,
-        mode: this.#options.config.mode,
-        path: this.#options.config.webhookPath,
-      }));
+      this.#logger.info(
+        `connected (${this.#options.config.mode}) | path: ${this.#options.config.webhookPath}`,
+      );
     } catch (error) {
       await this.stop();
-      logger.error('Failed to connect QQ HTTP receiver:', error);
+      this.#logger.error('Failed to connect QQ HTTP receiver:', error);
       throw error;
     }
   }
@@ -328,32 +331,36 @@ export class QqHttpEndpoint implements EndpointInstance {
       this.#bot = null;
     }
     this.#started = false;
-    logger.debug(formatCompact({ op: 'disconnect', endpoint: this.#options.config.name }));
+    this.#logger.debug(formatCompact({ op: 'disconnect' }));
   }
 
-  async send({ target, payload }: { readonly target: string; readonly payload: unknown }): Promise<string> {
+  async send({ conversation, payload }: EndpointSendRequest): Promise<string> {
     const body = formatOutbound(payload);
-    const parsed = parseSendTarget(target);
+    const kind = qqOutboundKind(conversation);
     const bot = this.#requireBot();
     let result: unknown;
-    switch (parsed.kind) {
+    switch (kind) {
       case 'private':
-        result = await bot.sendPrivateMessage(parsed.id, body);
+        result = await bot.sendPrivateMessage(conversation.id, body);
         break;
       case 'group':
-        result = await bot.sendGroupMessage(parsed.id, body);
+        result = await bot.sendGroupMessage(conversation.id, body);
         break;
       case 'channel':
-        result = await bot.sendGuildMessage(parsed.id, body);
+        result = await bot.sendGuildMessage(conversation.id, body);
         break;
       case 'direct':
         if (!bot.sendDirectMessage) throw new Error('QQ direct message not supported by transport');
-        result = await bot.sendDirectMessage(parsed.id, body);
+        result = await bot.sendDirectMessage(conversation.id, body);
         break;
-      default:
-        throw new Error(`unsupported QQ target kind: ${String((parsed as ParsedSendTarget).kind)}`);
     }
-    return `${parsed.kind}-${parsed.id}:${resolveOutboundMessageId(result)}`;
+    const messageId = `${kind}-${conversation.id}:${resolveOutboundMessageId(result)}`;
+    this.#logger.info(
+      `send ${kind}:${conversation.id}`
+      + ` | id: ${messageId}`
+      + ` | ${truncatePreview(typeof body === 'string' ? body : String(body), 80)}`,
+    );
+    return messageId;
   }
 
   async recallMessage(messageId: string): Promise<void> {
@@ -373,9 +380,9 @@ export class QqHttpEndpoint implements EndpointInstance {
         await bot.recallDirectMessage?.(channelId, qqMsgId);
         break;
     }
-    logger.debug(formatCompact({
+    this.#logger.debug(formatCompact({
       op: 'qq_recall',
-      endpoint: this.#options.config.name,
+      endpoint: this.#options.config.id,
       kind,
       messageId,
     }));
@@ -383,27 +390,36 @@ export class QqHttpEndpoint implements EndpointInstance {
 
   admit(msg: QqInboundMessage): void {
     if (!this.#open) return;
-    const target = formatInboundTarget(msg);
+    const conversation = qqInboundConversation(String(this.#options.id), msg);
+    const content = formatInboundContent(msg);
+    this.#logger.info(
+      `recv ${conversation.kind}:${conversation.id}`
+      + (msg.authorId ? ` from ${msg.authorId}` : '')
+      + (msg.mentioned ? ' (mentioned)' : '')
+      + ` | ${truncatePreview(content, 80)}`,
+    );
     void this.#options.gateway.receive({
-      adapter: this.#options.id,
-      target,
-      content: formatInboundContent(msg),
+      conversation,
+      message: { conversation, id: msg.id },
+      content,
       ...(msg.segments?.length ? { segments: msg.segments } : {}),
-      sender: senderDisplayName(msg),
-      id: msg.id,
+      sender: {
+        id: msg.authorId,
+        name: senderDisplayName(msg) || undefined,
+        ...(msg.authorRoles?.length ? { roles: msg.authorRoles } : {}),
+      },
+      endpointId: this.#options.config.id,
+      ...(msg.mentioned ? { mentioned: true } : {}),
       metadata: Object.freeze({
-        endpoint: this.#options.config.name,
         channelKind: msg.channelKind,
         userId: msg.authorId,
         guildId: msg.guildId,
         roles: msg.authorRoles,
-        // AT 事件本身即 @ 机器人；新 Runtime 纯文本 content 需经 metadata 传递
-        ...(msg.mentioned ? { mentioned: true } : {}),
       }),
     }).catch((err) => {
-      logger.warn(formatCompact({
+      this.#logger.warn(formatCompact({
         op: 'qq_gateway_receive_failed',
-        target,
+        target: `${conversation.kind}:${conversation.id}`,
         error: err instanceof Error ? err.message : String(err),
       }));
     });

package/src/index.ts

@@ -1,12 +1,9 @@
 export {
   formatInboundContent,
-  formatInboundTarget,
   formatOutboundText,
-  parseSendTarget,
   resolveOutboundMessageId,
   resolveQqConfig,
   senderDisplayName,
-  type ParsedSendTarget,
   type QqAdapterConfig,
   type QqChannelKind,
   type QqInboundMessage,
@@ -16,6 +13,16 @@ export {
   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,
@@ -61,5 +68,4 @@ export {
   normalizeQqGuildSenderForPermit,
   platformPermit,
   qqGuildPermitResolver,
-  registerQqPlatformPermitChecker,
 } from './platform-permit.js';

package/src/platform-permit.ts

@@ -1,7 +1,7 @@
 /**
  * QQ 官方频道 platform permit（guild/channel，非 QQ 群 group_*）
  */
-import { registerPlatformPermitChecker, type Message } from '@zhin.js/core';
+import type { PermissionSubject } from '@zhin.js/permission';
 
 const ADAPTER = 'qq';
 
@@ -36,10 +36,9 @@ export function normalizeQqGuildSenderForPermit(input: {
   return { role: 'member', permissions };
 }
 
-export function checkQqPlatformPermit(perm: string, message: Message<any>): boolean {
-  const sender = message.$sender as { role?: string; permissions?: string[] };
-  const permissions = sender.permissions ?? [];
-  const role = sender.role;
+export function checkQqPlatformPermit(perm: string, subject: PermissionSubject): boolean {
+  const role = subject.sender?.role?.[0];
+  const permissions = subject.sender?.permissions ?? [];
   const has = (t: string) => permissions.includes(t);
 
   switch (perm) {
@@ -55,7 +54,3 @@ export function checkQqPlatformPermit(perm: string, message: Message<any>): bool
       return false;
   }
 }
-
-export function registerQqPlatformPermitChecker(): () => void {
-  return registerPlatformPermitChecker(ADAPTER, checkQqPlatformPermit);
-}

package/src/protocol.ts

@@ -4,19 +4,24 @@
  */
 
 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 name?: string;
+  readonly id?: string;
   readonly appid?: string;
   readonly secret?: string;
   /** Default `websocket`. `webhook` / `middleware` use httpHostToken POST. */
   readonly mode?: 'websocket' | 'webhook' | 'middleware';
   readonly sandbox?: boolean;
+  /** Explicit intents; when omitted, derived from `botKind` (default public). */
   readonly intents?: readonly string[];
+  /** public | private — drives default intents when `intents` omitted. */
+  readonly botKind?: string;
   readonly accessTokenUrl?: string;
   readonly gatewayUrl?: string;
   readonly webhookPath?: string;
@@ -25,12 +30,13 @@ export interface QqAdapterConfig {
   /** Transitional: legacy root `endpoints[]` with `context: qq`. */
   readonly endpoints?: ReadonlyArray<{
     readonly context?: string;
-    readonly name?: 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;
@@ -42,7 +48,7 @@ export interface QqAdapterConfig {
 export interface ResolvedQqWebsocketConfig {
   readonly context: 'qq';
   readonly mode: 'websocket';
-  readonly name: string;
+  readonly id: string;
   readonly appid: string;
   readonly secret: string;
   readonly sandbox: boolean;
@@ -54,7 +60,7 @@ export interface ResolvedQqWebsocketConfig {
 export interface ResolvedQqHttpConfig {
   readonly context: 'qq';
   readonly mode: 'webhook' | 'middleware';
-  readonly name: string;
+  readonly id: string;
   readonly appid: string;
   readonly secret: string;
   readonly webhookPath: string;
@@ -92,11 +98,6 @@ export interface QqWireSegment {
   readonly data?: Record<string, unknown>;
 }
 
-export interface ParsedSendTarget {
-  readonly kind: QqChannelKind;
-  readonly id: string;
-}
-
 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);
@@ -106,8 +107,8 @@ export function resolveQqConfig(config: QqAdapterConfig = {}): ResolvedQqConfig
       'QQ adapter requires appid + secret (plugins.<key>.appid/secret or endpoints with context: qq)',
     );
   }
-  const name = (typeof config.name === 'string' && config.name)
-    || (typeof entry?.name === 'string' && entry.name)
+  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';
@@ -118,7 +119,7 @@ export function resolveQqConfig(config: QqAdapterConfig = {}): ResolvedQqConfig
     return {
       context: 'qq',
       mode,
-      name,
+      id,
       appid,
       secret,
       webhookPath,
@@ -129,34 +130,39 @@ export function resolveQqConfig(config: QqAdapterConfig = {}): ResolvedQqConfig
   return {
     context: 'qq',
     mode: 'websocket',
-    name,
+    id,
     appid,
     secret,
     sandbox: config.sandbox === true || entry?.sandbox === true,
-    intents: config.intents ?? entry?.intents,
+    intents: resolveQqIntents({
+      intents: config.intents ?? entry?.intents,
+      botKind: config.botKind ?? entry?.botKind,
+    }),
     accessTokenUrl: config.accessTokenUrl ?? entry?.accessTokenUrl,
     gatewayUrl: config.gatewayUrl ?? entry?.gatewayUrl,
   };
 }
 
 /**
- * Gateway reply target：`private:uid` / `group:gid` / `channel:cid` / `direct:guildId`.
+ * 入站归一化 → ConversationRef：`direct`（频道私信）映射为 guild 容器内的
+ * private 会话；频道消息的所属 guild 进 `parent`。
  */
-export function formatInboundTarget(msg: QqInboundMessage): string {
-  return `${msg.channelKind}:${msg.channelId}`;
+export function qqInboundConversation(endpointKey: string, msg: QqInboundMessage): ConversationRef {
+  const kind: ConversationKind = msg.channelKind === 'direct' ? 'private' : msg.channelKind;
+  return {
+    endpoint: { id: endpointKey, adapter: endpointKey.split('\0')[0] ?? endpointKey },
+    kind,
+    id: msg.channelId,
+    ...(msg.guildId && (msg.channelKind === 'channel' || msg.channelKind === 'direct')
+      ? { parent: { kind: 'channel' as const, id: msg.guildId } }
+      : {}),
+  };
 }
 
-export function parseSendTarget(target: string): ParsedSendTarget {
-  const sep = target.indexOf(':');
-  if (sep <= 0) {
-    return { kind: 'private', id: target };
-  }
-  const head = target.slice(0, sep);
-  const rest = target.slice(sep + 1);
-  if (head === 'private' || head === 'group' || head === 'channel' || head === 'direct') {
-    return { kind: head, id: rest };
-  }
-  return { kind: 'private', id: target };
+/** 出站：guild 容器内的 private 会话即 QQ `direct`（频道私信）。 */
+export function qqOutboundKind(conversation: ConversationRef): QqChannelKind {
+  if (conversation.kind === 'private' && conversation.parent?.kind === 'channel') return 'direct';
+  return conversation.kind;
 }
 
 export function senderDisplayName(msg: QqInboundMessage): string {

package/src/qq-agent-deps.ts

@@ -25,20 +25,20 @@ export interface QqAgentEndpoint {
 }
 
 export interface QqAgentDeps {
-  getEndpoint: (endpointId: string) => QqAgentEndpoint;
+  getEndpoint: (endpointKey: string) => QqAgentEndpoint;
 }
 
 const endpoints = new Map<string, QqAgentEndpoint>();
 let override: QqAgentDeps | null = null;
 
 export function registerQqAgentEndpoint(
-  endpointId: string,
+  endpointKey: string,
   endpoint: QqAgentEndpoint,
 ): () => void {
-  endpoints.set(endpointId, endpoint);
+  endpoints.set(endpointKey, endpoint);
   return () => {
-    if (endpoints.get(endpointId) === endpoint) {
-      endpoints.delete(endpointId);
+    if (endpoints.get(endpointKey) === endpoint) {
+      endpoints.delete(endpointKey);
     }
   };
 }
@@ -51,9 +51,9 @@ export function setQqAgentDeps(deps: QqAgentDeps | null): void {
 export function getQqAgentDeps(): QqAgentDeps {
   if (override) return override;
   return {
-    getEndpoint(endpointId: string): QqAgentEndpoint {
-      const registered = endpoints.get(endpointId);
-      if (!registered) throw new Error(`Endpoint ${endpointId} 不存在`);
+    getEndpoint(endpointKey: string): QqAgentEndpoint {
+      const registered = endpoints.get(endpointKey);
+      if (!registered) throw new Error(`Endpoint ${endpointKey} 不存在`);
       return registered;
     },
   };

package/src/qq-bind-persist.ts

@@ -14,9 +14,9 @@ export interface QqCredentialEnvKeys {
 }
 
 /** 按 endpoint 名称生成唯一 env 键（如 `QQ_MY_BOT_APPID`） */
-export function buildQqCredentialEnvKeys(endpointName: string): QqCredentialEnvKeys {
-  const appidKey = buildEndpointEnvKey('qq', endpointName, 'appid');
-  const secretKey = buildEndpointEnvKey('qq', endpointName, 'secret');
+export function buildQqCredentialEnvKeys(endpointId: string): QqCredentialEnvKeys {
+  const appidKey = buildEndpointEnvKey('qq', endpointId, 'appid');
+  const secretKey = buildEndpointEnvKey('qq', endpointId, 'secret');
   return {
     appidKey,
     secretKey,
@@ -27,12 +27,12 @@ export function buildQqCredentialEnvKeys(endpointName: string): QqCredentialEnvK
 
 /** 写入或更新 `.env` 中的键值，并同步到当前进程 `process.env` */
 export function persistQqCredentialsToEnv(
-  endpointName: string,
+  endpointId: string,
   appId: string,
   appSecret: string,
   projectRoot?: string,
 ): QqCredentialEnvKeys {
-  const keys = buildQqCredentialEnvKeys(endpointName);
+  const keys = buildQqCredentialEnvKeys(endpointId);
   persistEndpointEnvValues(
     {
       [keys.appidKey]: appId,