@zhin.js/adapter-qq 5.0.2 → 5.0.3

package/lib/src/qq-endpoint-manager.js

@@ -1,159 +0,0 @@
-import { ReceiverMode as QQReceiverMode } from './types.js';
-import { startQqBindFlow } from './qq-bind-flow.js';
-import { persistQqCredentialsToEnv } from './qq-bind-persist.js';
-const DEFAULT_INTENTS = [
-    'GUILDS',
-    'GUILD_MEMBERS',
-    'GUILD_MESSAGE_REACTIONS',
-    'DIRECT_MESSAGE',
-    'GROUP_AND_C2C_EVENT',
-    'INTERACTION',
-    'MESSAGE_AUDIT',
-    'AUDIO_ACTION',
-    'PUBLIC_GUILD_MESSAGES',
-];
-function clonePlainConfig(value) {
-    return JSON.parse(JSON.stringify(value));
-}
-function resolveQqEndpointTemplate(root) {
-    const configService = root.inject('config');
-    const raw = configService?.primaryFile && configService.getRaw
-        ? configService.getRaw(configService.primaryFile)
-        : undefined;
-    const existing = raw?.endpoints?.find((e) => e.context === 'qq');
-    if (!existing) {
-        return {
-            mode: QQReceiverMode.WEBSOCKET,
-            sandbox: false,
-            timeout: 10_000,
-            data_dir: './data',
-            intents: [...DEFAULT_INTENTS],
-        };
-    }
-    const { name: _n, appid: _a, secret: _s, context: _c, ...rest } = existing;
-    return clonePlainConfig(rest);
-}
-function resolveBindOperatorId(userOpenId, ctx) {
-    const fromApi = userOpenId?.trim();
-    if (fromApi)
-        return fromApi;
-    return ctx.message.$sender?.id?.trim() ?? '';
-}
-function applyBindOwnership(template, operatorId) {
-    const { master: _m, aiAccess, ...rest } = template;
-    if (!operatorId) {
-        return rest;
-    }
-    const prior = aiAccess;
-    return {
-        ...rest,
-        master: operatorId,
-        aiAccess: {
-            mode: prior?.mode ?? 'whitelist',
-            users: [operatorId],
-            groups: Array.isArray(prior?.groups) ? [...prior.groups] : [],
-            denyMessage: typeof prior?.denyMessage === 'string'
-                ? prior.denyMessage
-                : '当前用户尚未开放 AI 功能，请联系开启。',
-        },
-    };
-}
-function readQqConfigs(root) {
-    const configService = root.inject('config');
-    if (!configService?.primaryFile || !configService.getRaw)
-        return [];
-    const raw = configService.getRaw(configService.primaryFile);
-    return (raw?.endpoints ?? []).filter((e) => e.context === 'qq');
-}
-/** 全局单例：同一时间只允许一个 QQ 扫码绑定 */
-let activeStopFlow = null;
-export class QqEndpointManager {
-    adapter;
-    constructor(adapter) {
-        this.adapter = adapter;
-    }
-    supportsProvision() {
-        return true;
-    }
-    listEndpoints() {
-        return readQqConfigs(this.adapter.plugin.root);
-    }
-    cancelProvision() {
-        if (!activeStopFlow)
-            return false;
-        activeStopFlow();
-        activeStopFlow = null;
-        return true;
-    }
-    async addEndpoint(ctx) {
-        if (activeStopFlow) {
-            throw new Error('已有进行中的 QQ 机器人绑定，请先 /endpoint cancel');
-        }
-        let endpointName;
-        const nameMatch = ctx.message.$raw?.match(/\/endpoint\s+add\s+qq\s+(\S+)/);
-        if (nameMatch?.[1]) {
-            endpointName = nameMatch[1];
-        }
-        return new Promise((resolve, reject) => {
-            const stopFlow = startQqBindFlow({
-                onQrDisplayed: async (url) => {
-                    await ctx.onStatusUpdate('请用手机 QQ 扫描二维码完成机器人绑定。', {
-                        qrcode: url,
-                    });
-                },
-                onQrExpired: async () => {
-                    await ctx.onStatusUpdate('二维码已过期，正在刷新，请扫描新二维码…');
-                },
-                onSuccess: async (credentials) => {
-                    activeStopFlow = null;
-                    const [{ appId, appSecret, userOpenId }] = credentials;
-                    const name = endpointName?.trim() || appId;
-                    await ctx.onStatusUpdate('凭据绑定成功，正在写入配置…');
-                    const envKeys = persistQqCredentialsToEnv(name, appId, appSecret);
-                    const template = resolveQqEndpointTemplate(ctx.root);
-                    const operatorId = resolveBindOperatorId(userOpenId, ctx);
-                    const owned = applyBindOwnership(template, operatorId);
-                    resolve({
-                        context: 'qq',
-                        name,
-                        appid: envKeys.appidRef,
-                        secret: envKeys.secretRef,
-                        ...owned,
-                    });
-                },
-                onFailure: async (error) => {
-                    activeStopFlow = null;
-                    reject(error);
-                },
-            }, { source: 'zhin' });
-            activeStopFlow = stopFlow;
-        });
-    }
-    async editEndpoint(name, ctx) {
-        const existing = this.listEndpoints().find((e) => e.name === name);
-        if (!existing) {
-            throw new Error(`配置中不存在 qq/${name}`);
-        }
-        await ctx.onStatusUpdate(`QQ 官方机器人暂不支持在线改凭据，请 /endpoint remove qq ${name} 后重新 /endpoint add qq。`);
-        return existing;
-    }
-    async removeEndpoint(name) {
-        return this.listEndpoints().some((e) => e.name === name);
-    }
-    async startEndpoint(name, ctx) {
-        if (!this.listEndpoints().some((e) => e.name === name)) {
-            throw new Error(`配置中不存在 qq/${name}`);
-        }
-        await ctx.onStatusUpdate(`正在连接 qq/${name}…`);
-    }
-    async stopEndpoint(name) {
-        return this.adapter.endpoints.has(name);
-    }
-}
-export function disposeQqEndpointProvision() {
-    if (activeStopFlow) {
-        activeStopFlow();
-        activeStopFlow = null;
-    }
-}
-//# sourceMappingURL=qq-endpoint-manager.js.map

package/lib/src/qq-endpoint-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"qq-endpoint-manager.js","sourceRoot":"","sources":["../../src/qq-endpoint-manager.ts"],"names":[],"mappings":"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"}

package/lib/src/sdk-version.js

@@ -1,19 +0,0 @@
-import { createRequire } from "node:module";
-import adapterPkg from "../package.json" with { type: "json" };
-const require = createRequire(import.meta.url);
-function readDepVersion(dep) {
-    try {
-        return require(`${dep}/package.json`).version;
-    }
-    catch {
-        return "unknown";
-    }
-}
-/** HTTP header name for outbound QQ API requests. */
-export const SDK_VERSION_HEADER = "x-sdk-version";
-/**
- * Composite SDK identity: Zhin adapter + underlying qq-official-endpoint.
- * Example: `zhin-adapter-qq/v2.0.11+qq-official-bot/v1.2.1`
- */
-export const SDK_VERSION = `zhin-adapter-qq/v${adapterPkg.version}+qq-official-bot/v${readDepVersion("qq-official-bot")}`;
-//# sourceMappingURL=sdk-version.js.map

package/lib/src/sdk-version.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sdk-version.js","sourceRoot":"","sources":["../../src/sdk-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,UAAU,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAE/D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,OAAQ,OAAO,CAAC,GAAG,GAAG,eAAe,CAAyB,CAAC,OAAO,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAElD;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,UAAU,CAAC,OAAO,qBAAqB,cAAc,CAAC,iBAAiB,CAAC,EAAE,CAAC"}

package/lib/src/segment-mapper.js

@@ -1,2 +0,0 @@
-export { toCanonicalSegments, fromCanonicalSegments } from 'zhin.js';
-//# sourceMappingURL=segment-mapper.js.map

package/lib/src/segment-mapper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"segment-mapper.js","sourceRoot":"","sources":["../../src/segment-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC"}

package/lib/src/types.js

@@ -1,2 +0,0 @@
-export { ReceiverMode } from "qq-official-bot";
-//# sourceMappingURL=types.js.map

package/lib/src/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/plugin.yml

@@ -1,3 +0,0 @@
-name: adapter-qq
-description: QQ 官方机器人适配器：群管理、频道/子频道管理、角色管理
-version: 1.0.59

package/src/adapter.ts

@@ -1,97 +0,0 @@
-/**
- * QQ 官方适配器
- */
-import { Adapter, Plugin, QQ_AI_OUTBOUND_EXTENSIONS, type EndpointManager, type OutboundRichSegmentPolicy } from 'zhin.js';
-import type { Router } from "@zhin.js/host-router";
-
-import { QQEndpoint } from "./endpoint.js";
-import { QqEndpointManager } from "./qq-endpoint-manager.js";
-import type { QQEndpointConfig, ReceiverMode } from "./types.js";
-
-
-export class QQAdapter extends Adapter<QQEndpoint<ReceiverMode>> {
-  static override readonly capabilities = ['inbound', 'outbound'] as const;
-  static override outboundRichSegmentPolicy: OutboundRichSegmentPolicy = {
-    qrcode: 'image',
-    html: 'image',
-    markdown: 'origin',
-  };
-  static override interactivePolicy = 'native' as const;
-  static override aiOutboundCapabilities = {
-    mentions: true,
-    richSegments: ['qrcode', 'html', 'markdown', 'tts'],
-    interactive: 'native' as const,
-  };
-  static override aiOutboundExtensions = QQ_AI_OUTBOUND_EXTENSIONS;
-
-  #router?: Router;
-  #endpointManager?: QqEndpointManager;
-
-  constructor(plugin: Plugin, router?: Router) {
-    super(plugin, "qq", []);
-    this.#router = router;
-  }
-
-  getRouter(): Router | undefined {
-    return this.#router;
-  }
-
-  createEndpoint(config: QQEndpointConfig<ReceiverMode>): QQEndpoint<ReceiverMode> {
-    return new QQEndpoint(this, config);
-  }
-
-  override getEndpointManager(): EndpointManager {
-    if (!this.#endpointManager) {
-      this.#endpointManager = new QqEndpointManager(this);
-    }
-    return this.#endpointManager;
-  }
-
-  // ── ISceneManagement 标准群管方法 ──────────────────────────────────
-
-  async removeMember(endpointId: string, sceneId: string, userId: string) {
-    const endpoint = this.endpoints.get(endpointId);
-    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-    return endpoint.removeGuildMember(sceneId, userId, false);
-  }
-
-  async muteMember(endpointId: string, sceneId: string, userId: string, duration = 600) {
-    const endpoint = this.endpoints.get(endpointId);
-    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-    return endpoint.muteMembers(sceneId, [userId], duration);
-  }
-
-  async setSceneMuted(endpointId: string, sceneId: string, enable = true) {
-    const endpoint = this.endpoints.get(endpointId);
-    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-    return endpoint.muteAll(sceneId, enable ? 600 : 0);
-  }
-
-  async listMembers(endpointId: string, sceneId: string) {
-    const endpoint = this.endpoints.get(endpointId);
-    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-    return endpoint.getGuildMembers(sceneId);
-  }
-
-  async getSceneInfo(endpointId: string, sceneId: string) {
-    const endpoint = this.endpoints.get(endpointId);
-    if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
-    return endpoint.getGuildInfo(sceneId);
-  }
-
-  // ── 生命周期 ───────────────────────────────────────────────────────
-
-  async start(): Promise<void> {
-    if (!this.#router) {
-      this.#router = (this.plugin.inject as (key: string) => Router | undefined)("router");
-    }
-    (this.plugin.useContext as (key: string, fn: (router: Router) => void) => void)(
-      "router",
-      (router) => {
-        this.#router = router;
-      },
-    );
-    await super.start();
-  }
-
-}

package/src/gateway-config.ts

@@ -1,48 +0,0 @@
-import { formatCompact, type Logger } from '@zhin.js/logger';
-
-import { ReceiverMode, type Bot as QQOfficialBot } from 'qq-official-bot';
-
-import type { QQEndpointConfig } from "./types.js";
-
-/** qq-official-bot 默认 token 接口 */
-export const DEFAULT_ACCESS_TOKEN_URL = "https://bots.qq.com/app/getAppAccessToken";
-/** qq-official-bot 默认 gateway 路径（相对 API baseURL） */
-export const DEFAULT_GATEWAY_URL = "/gateway/bot";
-
-type AuthManagerSession = {
-  authManager: {
-    config: {
-      accessTokenUrl?: string;
-      gatewayUrl?: string;
-    };
-  };
-};
-
-/**
- * 将自定义 gateway / token 地址注入 SDK Auth。
- * SDK 仅在 websocket 模式自动读取配置；middleware / webhook 需在此补丁。
- */
-export function applyCustomAuthEndpoints(
-  endpoint: QQOfficialBot,
-  config: Pick<QQEndpointConfig<ReceiverMode>, "mode" | "accessTokenUrl" | "gatewayUrl">,
-  logger: Logger,
-): void {
-  const { accessTokenUrl, gatewayUrl, mode } = config;
-  if (!accessTokenUrl && !gatewayUrl) return;
-
-  if (mode !== ReceiverMode.WEBSOCKET) {
-    const session = endpoint.sessionManager as unknown as AuthManagerSession;
-    if (accessTokenUrl) session.authManager.config.accessTokenUrl = accessTokenUrl;
-    if (gatewayUrl) session.authManager.config.gatewayUrl = gatewayUrl;
-  }
-
-  logger.debug(formatCompact({
-    op: "qq_gateway",
-    mode,
-    accessTokenUrl: accessTokenUrl ?? DEFAULT_ACCESS_TOKEN_URL,
-    gatewayUrl: gatewayUrl ?? DEFAULT_GATEWAY_URL,
-    note: mode === ReceiverMode.WEBSOCKET
-      ? "websocket 入站使用 gatewayUrl"
-      : "middleware/webhook 仅 accessTokenUrl 生效",
-  }));
-}

package/src/group-at-normalize.ts

@@ -1,75 +0,0 @@
-import { readMentionSegmentTarget, type MessageElement } from 'zhin.js';
-
-function segmentAtId(seg: MessageElement): string {
-  return readMentionSegmentTarget(seg);
-}
-
-function textMentionsEndpoint(text: string, endpointIds: string[]): boolean {
-  for (const id of endpointIds) {
-    const re = new RegExp(`@${id.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`);
-    if (re.test(text)) return true;
-  }
-  return false;
-}
-
-function stripInlineAtEndpoint(text: string, endpointIds: string[]): string {
-  let result = text;
-  for (const id of endpointIds) {
-    if (!id) continue;
-    const re = new RegExp(`^@${id.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`);
-    result = result.replace(re, "");
-  }
-  return result.trimStart();
-}
-
-/**
- * 统一 QQ 群 @ 机器人前缀：
- * - 去掉正文前的 at 段与内联 @，使命令/文本从首段开始匹配
- * - 若曾 @ 机器人，在末尾追加规范 at 段，供 AI @ 触发器识别
- */
-export function normalizeGroupAtPrefix(
-  content: MessageElement[],
-  endpointAtIds: string[],
-  forceAt: boolean,
-): MessageElement[] {
-  const ids = [...new Set(endpointAtIds.map(String).filter(Boolean))];
-  if (!ids.length || !Array.isArray(content)) return content;
-
-  let mentioned = forceAt;
-  const body: MessageElement[] = [];
-
-  for (const seg of content) {
-    if (seg.type === "at" || seg.type === "mention") {
-      const uid = segmentAtId(seg);
-      if (uid && ids.includes(uid)) {
-        mentioned = true;
-        continue;
-      }
-      body.push(seg);
-      continue;
-    }
-    if (seg.type === "text" && seg.data && typeof seg.data === "object") {
-      const raw = String((seg.data as { text?: string }).text ?? "");
-      if (textMentionsEndpoint(raw, ids)) mentioned = true;
-      const stripped = stripInlineAtEndpoint(raw, ids);
-      if (stripped) {
-        body.push({ ...seg, data: { ...(seg.data as object), text: stripped } });
-      }
-      continue;
-    }
-    body.push(seg);
-  }
-
-  while (body.length > 0 && body[0]?.type === "text") {
-    const t = String((body[0].data as { text?: string })?.text ?? "").trim();
-    if (t) break;
-    body.shift();
-  }
-
-  if (mentioned) {
-    const canonicalId = ids[0]!;
-    body.push({ type: "at", data: { qq: canonicalId, id: canonicalId } });
-  }
-
-  return body.length ? body : content;
-}

package/src/inbound-action.ts

@@ -1,87 +0,0 @@
-/**
- * QQ 官方互动事件 → 标准 action 段
- * @see https://bot.q.qq.com/wiki/develop/api-v2/server-inter/message/trans/msg-btn.html
- */
-import type {
-  FriendActionNoticeEvent,
-  GroupActionNoticeEvent,
-  GuildActionNoticeEvent,
-} from 'qq-official-bot';
-import { Message, type MessageSegment, type SendContent } from 'zhin.js';
-
-export type QqActionNoticeEvent =
-  | FriendActionNoticeEvent
-  | GroupActionNoticeEvent
-  | GuildActionNoticeEvent;
-
-export interface FormatQqActionMessageOptions {
-  endpointName: string;
-  send: (content: SendContent) => Promise<string>;
-}
-
-/** `group-{openid}:{msgId}` → 平台 msg_id */
-export function stripQqOutboundMessageId(storedId: string): string {
-  const match = /^(?:private|group|channel|direct)-[^:]+:(.+)$/.exec(storedId);
-  return match ? match[1]! : storedId;
-}
-
-function prependReply(content: SendContent, msgId: string): MessageSegment[] {
-  const items = Array.isArray(content) ? [...content] : [content];
-  items.unshift({ type: 'reply', data: { id: msgId } });
-  return items as MessageSegment[];
-}
-
-function createQqActionReplyHandler(
-  send: (content: SendContent) => Promise<string>,
-) {
-  return async (content: SendContent, quote: boolean | string = false): Promise<string> => {
-    const outbound = typeof quote === 'string'
-      ? prependReply(content, stripQqOutboundMessageId(quote))
-      : content;
-    return await send(outbound);
-  };
-}
-
-export function formatQqActionMessage(
-  event: QqActionNoticeEvent,
-  options: FormatQqActionMessageOptions,
-): ReturnType<typeof Message.from<QqActionNoticeEvent>> {
-  const resolved = event.data?.resolved;
-  const buttonId = String(resolved?.button_id ?? '');
-  const buttonData = resolved?.button_data != null ? String(resolved.button_data) : '';
-  const payload = buttonData || buttonId;
-  const sourceMessageId = resolved?.message_id != null ? String(resolved.message_id) : undefined;
-
-  let channelType: 'private' | 'group' | 'channel' = 'private';
-  let channelId = String(event.operator_id ?? '');
-
-  if (event.notice_type === 'group') {
-    channelType = 'group';
-    channelId = String(event.group_id);
-  } else if (event.notice_type === 'guild') {
-    channelType = 'channel';
-    channelId = String(event.channel_id);
-  }
-
-  const senderId = String(event.operator_id ?? '');
-
-  return Message.from(event, {
-    $id: event.notice_id ?? event.event_id ?? `action:${Date.now()}`,
-    $adapter: 'qq',
-    $endpoint: options.endpointName,
-    $sender: { id: senderId, name: senderId },
-    $channel: { id: channelId, type: channelType },
-    $content: [{
-      type: 'action',
-      data: {
-        id: buttonId,
-        payload,
-        sourceMessageId,
-      },
-    }],
-    $raw: payload,
-    $timestamp: Date.now(),
-    $recall: async () => {},
-    $reply: createQqActionReplyHandler(options.send),
-  });
-}

package/src/inbound-normalize.ts

@@ -1,57 +0,0 @@
-/**
- * QQ 官方 API v2 入站 WebSocket payload 归一化（group_openid → group_id 等）。
- * qq-official-bot 解析层仍按旧字段名取值，未归一化时群 @ 可能解析失败并被 SDK 静默丢弃。
- */
-
-export type QqWsPacket = {
-  d?: Record<string, unknown>;
-  id?: string;
-  t?: string;
-};
-
-const GROUP_MESSAGE_EVENTS = new Set([
-  'GROUP_AT_MESSAGE_CREATE',
-  'GROUP_MESSAGE_CREATE',
-]);
-
-export function normalizeQqInboundWsPayload(event: string, packet: QqWsPacket): void {
-  const d = packet.d;
-  if (!d || typeof d !== 'object') return;
-
-  if (GROUP_MESSAGE_EVENTS.has(event)) {
-    if (!d.group_id && typeof d.group_openid === 'string') {
-      d.group_id = d.group_openid;
-    }
-
-    const author = d.author;
-    if (author && typeof author === 'object') {
-      const a = author as Record<string, unknown>;
-      if (!a.id) {
-        a.id = a.member_openid ?? a.user_openid ?? a.id;
-      }
-      if (!a.username && !a.user_name) {
-        a.username = a.member_openid ?? a.user_openid ?? 'unknown';
-      }
-    }
-
-    if (!Array.isArray(d.mentions) && typeof d.content === 'string') {
-      const mentions: Array<{ id: string }> = [];
-      const re = /<@!?(\d+)>/g;
-      let m: RegExpExecArray | null;
-      while ((m = re.exec(d.content))) {
-        mentions.push({ id: m[1]! });
-      }
-      if (mentions.length) d.mentions = mentions;
-    }
-
-    if (Array.isArray(d.attachments)) {
-      for (const att of d.attachments) {
-        if (att && typeof att === 'object' && (att as Record<string, unknown>).url == null) {
-          (att as Record<string, unknown>).url = '';
-        }
-      }
-    }
-
-    d.__zhin_group_at = event === 'GROUP_AT_MESSAGE_CREATE';
-  }
-}

package/src/mention-enrich.ts

@@ -1,71 +0,0 @@
-import type { Segment } from 'zhin.js';
-import type { QQAdapter } from './adapter.js';
-
-type MentionWire = {
-  id?: string;
-  member_openid?: string;
-  username?: string;
-  nickname?: string;
-};
-
-type QQEndpointLike = {
-  $id: string;
-  $platformUserId?: string;
-  $config: { name?: string; appid?: string; nickname?: string };
-};
-
-function mentionWireId(row: MentionWire): string {
-  return String(row.id ?? row.member_openid ?? '').trim();
-}
-
-function mentionWireName(row: MentionWire): string | undefined {
-  const name = row.username ?? row.nickname;
-  return typeof name === 'string' && name.trim() ? name.trim() : undefined;
-}
-
-function endpointLookupIds(endpoint: QQEndpointLike): string[] {
-  const cfg = endpoint.$config;
-  return [
-    endpoint.$platformUserId,
-    cfg.appid,
-    cfg.name,
-    endpoint.$id,
-  ].filter((id): id is string => Boolean(id)).map(String);
-}
-
-function resolveEndpointDisplayName(endpoint: QQEndpointLike): string | undefined {
-  const cfg = endpoint.$config;
-  return cfg.nickname?.trim() || cfg.name?.trim() || endpoint.$id;
-}
-
-/** 为 canonical mention 段补齐展示名（平台 payload / endpoint 配置）。 */
-export function enrichCanonicalMentionNames(
-  segments: Segment[],
-  adapter: QQAdapter,
-  wireMentions?: MentionWire[],
-): Segment[] {
-  const nameById = new Map<string, string>();
-  for (const row of wireMentions ?? []) {
-    const id = mentionWireId(row);
-    const name = mentionWireName(row);
-    if (id && name) nameById.set(id, name);
-  }
-
-  for (const endpoint of adapter.endpoints.values()) {
-    const display = resolveEndpointDisplayName(endpoint);
-    if (!display) continue;
-    for (const id of endpointLookupIds(endpoint)) {
-      if (!nameById.has(id)) nameById.set(id, display);
-    }
-  }
-
-  return segments.map((seg) => {
-    if (seg.type !== 'mention') return seg;
-    const data = seg.data as { target?: string; name?: string };
-    const target = String(data.target ?? '').trim();
-    if (!target || data.name) return seg;
-    const name = nameById.get(target);
-    if (!name) return seg;
-    return { ...seg, data: { target, name } };
-  });
-}