@sfmc-bds/qq-bridge 0.1.1-beta.4 → 0.2.0-beta.5

package/dist/llbot-ws-api.js

@@ -0,0 +1,90 @@
+import { randomBytes } from "node:crypto";
+import { log } from "./log.js";
+const DEFAULT_TIMEOUT_MS = 8e3;
+class LlbotWsApi {
+  sock = null;
+  pending = /* @__PURE__ */ new Map();
+  /** 当前是否有可用的 LLBot reverse-ws 连接 */
+  get connected() {
+    return !!this.sock && this.sock.readyState === 1;
+  }
+  attach(sock) {
+    if (this.sock && this.sock !== sock) {
+      this.rejectAll(new Error("LLBot WebSocket \u88AB\u65B0\u8FDE\u63A5\u66FF\u6362"));
+    }
+    this.sock = sock;
+    log.info("LLBot WS API \u5DF2\u6302\u63A5\uFF08\u53EF\u7528 reverse-ws \u53D1\u6D88\u606F\uFF09");
+  }
+  detach(sock) {
+    if (this.sock !== sock) return;
+    this.sock = null;
+    this.rejectAll(new Error("LLBot WebSocket \u5DF2\u65AD\u5F00"));
+    log.info("LLBot WS API \u5DF2\u5378\u8F7D");
+  }
+  /**
+   * 若帧是 API 回包（有 echo、无 post_type），消费并返回 true。
+   * 事件帧返回 false，交给 dispatcher。
+   */
+  tryHandleResponse(raw) {
+    if (!raw || typeof raw !== "object") return false;
+    const obj = raw;
+    if (obj.post_type != null) return false;
+    const echo = obj.echo;
+    if (echo == null || echo === "") return false;
+    const key = String(echo);
+    const p = this.pending.get(key);
+    if (!p) return false;
+    this.pending.delete(key);
+    clearTimeout(p.timer);
+    p.resolve(obj);
+    return true;
+  }
+  async call(action, params, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    if (!this.connected || !this.sock) {
+      throw new Error("LLBot reverse-ws \u672A\u8FDE\u63A5\uFF0C\u65E0\u6CD5\u8C03\u7528 API");
+    }
+    const echo = `sfmc_${Date.now().toString(36)}_${randomBytes(4).toString("hex")}`;
+    const payload = JSON.stringify({ action, params, echo });
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.pending.delete(echo);
+        reject(new Error(`LLBot WS API \u8D85\u65F6 (${action})`));
+      }, timeoutMs);
+      this.pending.set(echo, { resolve, reject, timer });
+      try {
+        this.sock.send(payload);
+      } catch (e) {
+        this.pending.delete(echo);
+        clearTimeout(timer);
+        reject(e instanceof Error ? e : new Error(String(e)));
+      }
+    });
+  }
+  async sendGroupMsg(groupId, text) {
+    const gid = typeof groupId === "number" ? groupId : parseInt(String(groupId), 10);
+    if (!Number.isFinite(gid)) throw new Error(`\u65E0\u6548 group_id: ${groupId}`);
+    const result = await this.call("send_group_msg", {
+      group_id: gid,
+      message: [{ type: "text", data: { text } }]
+    });
+    const ret = result.retcode ?? (result.status === "ok" ? 0 : -1);
+    if (ret !== 0) {
+      throw new Error(
+        `LLBot send_group_msg retcode=${ret}: ${result.message || result.wording || result.status || "fail"}`
+      );
+    }
+  }
+  rejectAll(err) {
+    for (const [k, p] of this.pending) {
+      clearTimeout(p.timer);
+      p.reject(err);
+      this.pending.delete(k);
+    }
+  }
+}
+const llbotWsApi = new LlbotWsApi();
+export {
+  LlbotWsApi,
+  llbotWsApi
+};
+//# sourceMappingURL=llbot-ws-api.js.map

package/dist/llbot-ws-api.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/llbot-ws-api.ts"],
+  "sourcesContent": ["/**\n * llbot-ws-api.ts \u2014 \u7ECF LLBot reverse-WS \u8C03\u7528 OneBot API\n *\n * \u591A\u6570 LLBot \u90E8\u7F72\u53EA\u5F00 reverse-ws\u3001\u4E0D\u5F00\u6B63\u5411 HTTP(3004)\u3002\n * \u6307\u4EE4\u56DE\u590D\u5E94\u8D70\u5DF2\u8FDE\u63A5\u7684 WebSocket\uFF0C\u800C\u4E0D\u662F\u5047\u5B9A 3004 \u53EF\u8FBE\u3002\n */\n\nimport { randomBytes } from \"node:crypto\";\nimport type { WebSocket } from \"ws\";\nimport { log } from \"./log.js\";\n\nexport type LlbotApiResult = {\n  status?: string;\n  retcode?: number;\n  data?: unknown;\n  message?: string;\n  wording?: string;\n  echo?: string;\n};\n\ntype Pending = {\n  resolve: (v: LlbotApiResult) => void;\n  reject: (e: Error) => void;\n  timer: ReturnType<typeof setTimeout>;\n};\n\nconst DEFAULT_TIMEOUT_MS = 8000;\n\nexport class LlbotWsApi {\n  private sock: WebSocket | null = null;\n  private readonly pending = new Map<string, Pending>();\n\n  /** \u5F53\u524D\u662F\u5426\u6709\u53EF\u7528\u7684 LLBot reverse-ws \u8FDE\u63A5 */\n  get connected(): boolean {\n    return !!this.sock && this.sock.readyState === 1; // OPEN\n  }\n\n  attach(sock: WebSocket): void {\n    if (this.sock && this.sock !== sock) {\n      this.rejectAll(new Error(\"LLBot WebSocket \u88AB\u65B0\u8FDE\u63A5\u66FF\u6362\"));\n    }\n    this.sock = sock;\n    log.info(\"LLBot WS API \u5DF2\u6302\u63A5\uFF08\u53EF\u7528 reverse-ws \u53D1\u6D88\u606F\uFF09\");\n  }\n\n  detach(sock: WebSocket): void {\n    if (this.sock !== sock) return;\n    this.sock = null;\n    this.rejectAll(new Error(\"LLBot WebSocket \u5DF2\u65AD\u5F00\"));\n    log.info(\"LLBot WS API \u5DF2\u5378\u8F7D\");\n  }\n\n  /**\n   * \u82E5\u5E27\u662F API \u56DE\u5305\uFF08\u6709 echo\u3001\u65E0 post_type\uFF09\uFF0C\u6D88\u8D39\u5E76\u8FD4\u56DE true\u3002\n   * \u4E8B\u4EF6\u5E27\u8FD4\u56DE false\uFF0C\u4EA4\u7ED9 dispatcher\u3002\n   */\n  tryHandleResponse(raw: unknown): boolean {\n    if (!raw || typeof raw !== \"object\") return false;\n    const obj = raw as Record<string, unknown>;\n    if (obj.post_type != null) return false;\n    const echo = obj.echo;\n    if (echo == null || echo === \"\") return false;\n    const key = String(echo);\n    const p = this.pending.get(key);\n    if (!p) return false;\n    this.pending.delete(key);\n    clearTimeout(p.timer);\n    p.resolve(obj as LlbotApiResult);\n    return true;\n  }\n\n  async call(action: string, params: Record<string, unknown>, timeoutMs = DEFAULT_TIMEOUT_MS): Promise<LlbotApiResult> {\n    if (!this.connected || !this.sock) {\n      throw new Error(\"LLBot reverse-ws \u672A\u8FDE\u63A5\uFF0C\u65E0\u6CD5\u8C03\u7528 API\");\n    }\n    const echo = `sfmc_${Date.now().toString(36)}_${randomBytes(4).toString(\"hex\")}`;\n    const payload = JSON.stringify({ action, params, echo });\n\n    return new Promise<LlbotApiResult>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        this.pending.delete(echo);\n        reject(new Error(`LLBot WS API \u8D85\u65F6 (${action})`));\n      }, timeoutMs);\n      this.pending.set(echo, { resolve, reject, timer });\n      try {\n        this.sock!.send(payload);\n      } catch (e) {\n        this.pending.delete(echo);\n        clearTimeout(timer);\n        reject(e instanceof Error ? e : new Error(String(e)));\n      }\n    });\n  }\n\n  async sendGroupMsg(groupId: string | number, text: string): Promise<void> {\n    const gid = typeof groupId === \"number\" ? groupId : parseInt(String(groupId), 10);\n    if (!Number.isFinite(gid)) throw new Error(`\u65E0\u6548 group_id: ${groupId}`);\n    const result = await this.call(\"send_group_msg\", {\n      group_id: gid,\n      message: [{ type: \"text\", data: { text } }],\n    });\n    const ret = result.retcode ?? (result.status === \"ok\" ? 0 : -1);\n    if (ret !== 0) {\n      throw new Error(\n        `LLBot send_group_msg retcode=${ret}: ${result.message || result.wording || result.status || \"fail\"}`\n      );\n    }\n  }\n\n  private rejectAll(err: Error): void {\n    for (const [k, p] of this.pending) {\n      clearTimeout(p.timer);\n      p.reject(err);\n      this.pending.delete(k);\n    }\n  }\n}\n\n/** \u8FDB\u7A0B\u5185\u5355\u4F8B\uFF1Aws-server \u6302\u63A5\uFF0Creply-llbot / \u5176\u5B83\u51FA\u53E3\u590D\u7528 */\nexport const llbotWsApi = new LlbotWsApi();\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/llbot-ws-api.test.js

@@ -0,0 +1,32 @@
+import assert from "node:assert/strict";
+import { EventEmitter } from "node:events";
+import test from "node:test";
+import { LlbotWsApi } from "./llbot-ws-api.js";
+class FakeSock extends EventEmitter {
+  readyState = 1;
+  sent = [];
+  send(data) {
+    this.sent.push(data);
+  }
+}
+test("WS send_group_msg \u7B49 echo \u56DE\u5305", async () => {
+  const api = new LlbotWsApi();
+  const sock = new FakeSock();
+  api.attach(sock);
+  const p = api.sendGroupMsg("1058759051", "hello");
+  assert.equal(sock.sent.length, 1);
+  const req = JSON.parse(sock.sent[0]);
+  assert.equal(req.action, "send_group_msg");
+  assert.equal(req.params.group_id, 1058759051);
+  assert.equal(
+    api.tryHandleResponse({ status: "ok", retcode: 0, echo: req.echo, data: {} }),
+    true
+  );
+  await p;
+});
+test("\u4E8B\u4EF6\u5E27\u4E0D\u6D88\u8D39", () => {
+  const api = new LlbotWsApi();
+  assert.equal(api.tryHandleResponse({ post_type: "message", echo: "x" }), false);
+  assert.equal(api.tryHandleResponse({ retcode: 0 }), false);
+});
+//# sourceMappingURL=llbot-ws-api.test.js.map

package/dist/llbot-ws-api.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/llbot-ws-api.test.ts"],
+  "sourcesContent": ["/**\n * llbot-ws-api.test.ts\n */\nimport assert from \"node:assert/strict\";\nimport { EventEmitter } from \"node:events\";\nimport test from \"node:test\";\nimport { LlbotWsApi } from \"./llbot-ws-api.js\";\n\nclass FakeSock extends EventEmitter {\n  readyState = 1;\n  sent: string[] = [];\n  send(data: string): void {\n    this.sent.push(data);\n  }\n}\n\ntest(\"WS send_group_msg \u7B49 echo \u56DE\u5305\", async () => {\n  const api = new LlbotWsApi();\n  const sock = new FakeSock();\n  api.attach(sock as unknown as import(\"ws\").WebSocket);\n\n  const p = api.sendGroupMsg(\"1058759051\", \"hello\");\n  assert.equal(sock.sent.length, 1);\n  const req = JSON.parse(sock.sent[0]!) as { action: string; echo: string; params: { group_id: number } };\n  assert.equal(req.action, \"send_group_msg\");\n  assert.equal(req.params.group_id, 1058759051);\n\n  assert.equal(\n    api.tryHandleResponse({ status: \"ok\", retcode: 0, echo: req.echo, data: {} }),\n    true\n  );\n  await p;\n});\n\ntest(\"\u4E8B\u4EF6\u5E27\u4E0D\u6D88\u8D39\", () => {\n  const api = new LlbotWsApi();\n  assert.equal(api.tryHandleResponse({ post_type: \"message\", echo: \"x\" }), false);\n  assert.equal(api.tryHandleResponse({ retcode: 0 }), false);\n});\n"],
+  "mappings": "AAGA,OAAO,YAAY;AACnB,SAAS,oBAAoB;AAC7B,OAAO,UAAU;AACjB,SAAS,kBAAkB;AAE3B,MAAM,iBAAiB,aAAa;AAAA,EAClC,aAAa;AAAA,EACb,OAAiB,CAAC;AAAA,EAClB,KAAK,MAAoB;AACvB,SAAK,KAAK,KAAK,IAAI;AAAA,EACrB;AACF;AAEA,KAAK,8CAA+B,YAAY;AAC9C,QAAM,MAAM,IAAI,WAAW;AAC3B,QAAM,OAAO,IAAI,SAAS;AAC1B,MAAI,OAAO,IAAyC;AAEpD,QAAM,IAAI,IAAI,aAAa,cAAc,OAAO;AAChD,SAAO,MAAM,KAAK,KAAK,QAAQ,CAAC;AAChC,QAAM,MAAM,KAAK,MAAM,KAAK,KAAK,CAAC,CAAE;AACpC,SAAO,MAAM,IAAI,QAAQ,gBAAgB;AACzC,SAAO,MAAM,IAAI,OAAO,UAAU,UAAU;AAE5C,SAAO;AAAA,IACL,IAAI,kBAAkB,EAAE,QAAQ,MAAM,SAAS,GAAG,MAAM,IAAI,MAAM,MAAM,CAAC,EAAE,CAAC;AAAA,IAC5E;AAAA,EACF;AACA,QAAM;AACR,CAAC;AAED,KAAK,wCAAU,MAAM;AACnB,QAAM,MAAM,IAAI,WAAW;AAC3B,SAAO,MAAM,IAAI,kBAAkB,EAAE,WAAW,WAAW,MAAM,IAAI,CAAC,GAAG,KAAK;AAC9E,SAAO,MAAM,IAAI,kBAAkB,EAAE,SAAS,EAAE,CAAC,GAAG,KAAK;AAC3D,CAAC;",
+  "names": []
+}

package/dist/official/events.js

@@ -0,0 +1,136 @@
+import { stripOfficialAtMention } from "@sfmc-bds/sdk/node/qq-official";
+import { RecentMessageDedup } from "../onebot.js";
+import { tryForward } from "../dbserver.js";
+import { log } from "../log.js";
+function detectOfficialGroupAdmin(msg) {
+  const candidates = [
+    msg.author?.member_role,
+    msg.author?.roles,
+    msg.member?.role,
+    msg.member?.roles
+  ];
+  for (const c of candidates) {
+    if (c == null) continue;
+    if (Array.isArray(c)) {
+      const joined = c.map((x) => String(x).toLowerCase()).join(",");
+      if (/\b(owner|admin|2|3)\b/.test(joined)) return true;
+      continue;
+    }
+    const s = String(c).toLowerCase();
+    if (s === "owner" || s === "admin" || s === "2" || s === "3") return true;
+  }
+  return false;
+}
+function attachmentsPlaceholder(attachments) {
+  if (!Array.isArray(attachments) || attachments.length === 0) return "";
+  const parts = [];
+  for (const att of attachments) {
+    const ct = String(att.content_type ?? "").toLowerCase();
+    const name = String(att.filename ?? "").toLowerCase();
+    if (ct.startsWith("image/") || /\.(png|jpe?g|gif|webp|bmp)$/i.test(name)) {
+      parts.push("[\u56FE\u7247]");
+    } else if (ct.startsWith("video/") || /\.(mp4|mov|avi|mkv)$/i.test(name)) {
+      parts.push("[\u89C6\u9891]");
+    } else if (ct.startsWith("audio/") || /\.(mp3|wav|amr|silk)$/i.test(name)) {
+      parts.push("[\u8BED\u97F3]");
+    } else {
+      parts.push("[\u6587\u4EF6]");
+    }
+  }
+  return parts.join("");
+}
+function extractOfficialText(msg) {
+  const base = stripOfficialAtMention(String(msg.content ?? ""));
+  const suffix = attachmentsPlaceholder(msg.attachments);
+  return `${base}${suffix ? (base ? " " : "") + suffix : ""}`.trim();
+}
+class OfficialAtMessageDispatcher {
+  opts;
+  dedup = new RecentMessageDedup();
+  forward;
+  loggedMissingOpenid = false;
+  constructor(opts) {
+    this.opts = opts;
+    this.forward = opts.forward ?? tryForward;
+  }
+  async handleGroupAtMessage(msg) {
+    if (!msg || typeof msg !== "object") return;
+    if (msg.author?.bot) return;
+    const groupOpenid = String(msg.group_openid ?? "");
+    if (!groupOpenid) {
+      log.warn("\u5B98\u65B9\u4E8B\u4EF6\u7F3A group_openid\uFF0C\u8DF3\u8FC7");
+      return;
+    }
+    if (!this.opts.groupOpenid) {
+      if (!this.loggedMissingOpenid) {
+        log.warn(
+          `qq_group_openid \u672A\u914D\u7F6E\u3002\u6536\u5230\u7FA4 openid=${groupOpenid}\uFF0C\u8BF7\u5199\u5165 configs/qq_config.json \u540E\u91CD\u542F\uFF08\u672C\u6761\u4E0D\u8F6C\u53D1\uFF09`
+        );
+        this.loggedMissingOpenid = true;
+      } else {
+        log.info(`qq_group_openid \u672A\u914D\u7F6E\uFF0C\u4E22\u5F03\u7FA4\u6D88\u606F openid=${groupOpenid}`);
+      }
+      return;
+    }
+    if (groupOpenid !== this.opts.groupOpenid) {
+      log.info(`\u975E\u76EE\u6807\u7FA4 openid=${groupOpenid}\uFF0C\u8DF3\u8FC7`);
+      return;
+    }
+    if (this.dedup.seen(msg.id)) return;
+    const text = extractOfficialText(msg);
+    if (!text) return;
+    const memberId = String(msg.author?.member_openid || msg.author?.id || "unknown");
+    const fromName = String(msg.author?.username || `QQ_${memberId.slice(0, 8)}`);
+    const fromId = `qq_${memberId}`;
+    if (this.opts.commandRouter) {
+      const inbound = {
+        backend: "official",
+        scene: "group",
+        groupId: groupOpenid,
+        userId: memberId,
+        userName: fromName,
+        text,
+        isGroupAdmin: detectOfficialGroupAdmin(msg),
+        ...msg.id ? { msgId: String(msg.id) } : {}
+      };
+      if (await this.opts.commandRouter.handle(inbound)) return;
+    }
+    if (!this.opts.db.channelId) {
+      log.warn("bridge_channel_id \u672A\u914D\u7F6E\uFF0C\u8DF3\u8FC7");
+      return;
+    }
+    await this.forward(this.opts.db, fromId, fromName, text);
+  }
+  /**
+   * 单聊：仅走指令路由（菜单点击落点），不转发 MC。
+   */
+  async handleC2cMessage(msg) {
+    if (!msg || typeof msg !== "object") return;
+    if (msg.author?.bot) return;
+    if (this.dedup.seen(msg.id)) return;
+    const text = extractOfficialText(msg);
+    if (!text) return;
+    const userId = String(msg.author?.user_openid || msg.author?.id || "unknown");
+    const fromName = String(msg.author?.username || `QQ_${userId.slice(0, 8)}`);
+    if (!this.opts.commandRouter) {
+      log.info(`C2C \u65E0\u6307\u4EE4\u8DEF\u7531\uFF0C\u5FFD\u7565 text=${text.slice(0, 40)}`);
+      return;
+    }
+    const inbound = {
+      backend: "official",
+      scene: "c2c",
+      groupId: `c2c:${userId}`,
+      userId,
+      userName: fromName,
+      text,
+      ...msg.id ? { msgId: String(msg.id) } : {}
+    };
+    await this.opts.commandRouter.handle(inbound);
+  }
+}
+export {
+  OfficialAtMessageDispatcher,
+  attachmentsPlaceholder,
+  extractOfficialText
+};
+//# sourceMappingURL=events.js.map

package/dist/official/events.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/official/events.ts"],
+  "sourcesContent": ["/**\n * official/events.ts \u2014 \u5B98\u65B9 GROUP_AT / C2C \u89E3\u6790\u4E0E\u8F6C\u53D1\n */\n\nimport { stripOfficialAtMention } from \"@sfmc-bds/sdk/node/qq-official\";\nimport type { CommandRouter } from \"../commands/index.js\";\nimport { RecentMessageDedup } from \"../onebot.js\";\nimport { tryForward, type DBServerConfig } from \"../dbserver.js\";\nimport { log } from \"../log.js\";\n\nexport type OfficialAttachment = {\n  url?: string;\n  content_type?: string;\n  filename?: string;\n};\n\nexport type OfficialGroupAtMessage = {\n  id?: string;\n  content?: string;\n  group_openid?: string;\n  timestamp?: string;\n  author?: {\n    id?: string;\n    member_openid?: string;\n    username?: string;\n    bot?: boolean;\n    /** \u82E5\u5E73\u53F0\u4E0B\u53D1\u5219\u89E3\u6790\uFF1B\u65E0\u5219\u65E0\u6CD5\u5224\u5B9A\u7FA4\u7BA1 */\n    roles?: unknown;\n    member_role?: unknown;\n  };\n  member?: {\n    roles?: unknown;\n    role?: unknown;\n  };\n  attachments?: OfficialAttachment[];\n};\n\n/** \u4ECE\u5B98\u65B9\u4E8B\u4EF6\u53EF\u9009\u5B57\u6BB5\u63A8\u65AD\u7FA4\u4E3B/\u7FA4\u7BA1\uFF08\u65E0\u53EF\u9760\u5B57\u6BB5\u5219 false\uFF09 */\nfunction detectOfficialGroupAdmin(msg: OfficialGroupAtMessage): boolean {\n  const candidates: unknown[] = [\n    msg.author?.member_role,\n    msg.author?.roles,\n    msg.member?.role,\n    msg.member?.roles,\n  ];\n  for (const c of candidates) {\n    if (c == null) continue;\n    if (Array.isArray(c)) {\n      const joined = c.map((x) => String(x).toLowerCase()).join(\",\");\n      if (/\\b(owner|admin|2|3)\\b/.test(joined)) return true;\n      continue;\n    }\n    const s = String(c).toLowerCase();\n    if (s === \"owner\" || s === \"admin\" || s === \"2\" || s === \"3\") return true;\n  }\n  return false;\n}\n\n/** C2C \u5355\u804A\u4E8B\u4EF6\u4F53 */\nexport type OfficialC2cMessage = {\n  id?: string;\n  content?: string;\n  timestamp?: string;\n  author?: {\n    id?: string;\n    user_openid?: string;\n    username?: string;\n    bot?: boolean;\n  };\n  attachments?: OfficialAttachment[];\n};\n\nexport type OfficialForwardFn = (\n  db: DBServerConfig,\n  fromId: string,\n  fromName: string,\n  content: string\n) => Promise<void>;\n\nexport type OfficialDispatcherOptions = {\n  /** \u5DF2\u914D\u7F6E\u7684\u7FA4 openid\uFF1B\u7A7A = \u53EA\u6253\u65E5\u5FD7\u4E0D\u8F6C\u53D1 */\n  groupOpenid: string;\n  db: DBServerConfig;\n  /** \u53EF\u6CE8\u5165\uFF0C\u9ED8\u8BA4 tryForward\uFF08\u4FBF\u4E8E\u5355\u6D4B\uFF09 */\n  forward?: OfficialForwardFn;\n  /** QQ \u4FA7\u6307\u4EE4\u8DEF\u7531\uFF1B\u547D\u4E2D\u5219\u4E0D\u8F6C\u53D1 MC */\n  commandRouter?: CommandRouter;\n};\n\n/**\n * \u628A attachments \u8F6C\u6210\u4E0E OneBot \u4E00\u81F4\u7684\u5360\u4F4D\u7B26\u540E\u7F00\u3002\n */\nexport function attachmentsPlaceholder(attachments: OfficialAttachment[] | undefined): string {\n  if (!Array.isArray(attachments) || attachments.length === 0) return \"\";\n  const parts: string[] = [];\n  for (const att of attachments) {\n    const ct = String(att.content_type ?? \"\").toLowerCase();\n    const name = String(att.filename ?? \"\").toLowerCase();\n    if (ct.startsWith(\"image/\") || /\\.(png|jpe?g|gif|webp|bmp)$/i.test(name)) {\n      parts.push(\"[\u56FE\u7247]\");\n    } else if (ct.startsWith(\"video/\") || /\\.(mp4|mov|avi|mkv)$/i.test(name)) {\n      parts.push(\"[\u89C6\u9891]\");\n    } else if (ct.startsWith(\"audio/\") || /\\.(mp3|wav|amr|silk)$/i.test(name)) {\n      parts.push(\"[\u8BED\u97F3]\");\n    } else {\n      parts.push(\"[\u6587\u4EF6]\");\n    }\n  }\n  return parts.join(\"\");\n}\n\n/** \u4ECE\u5B98\u65B9\u4E8B\u4EF6\u62BD\u51FA\u7EAF\u6587\u672C\uFF08\u53BB @bot + \u9644\u4EF6\u5360\u4F4D\uFF09 */\nexport function extractOfficialText(msg: {\n  content?: string;\n  attachments?: OfficialAttachment[];\n}): string {\n  const base = stripOfficialAtMention(String(msg.content ?? \"\"));\n  const suffix = attachmentsPlaceholder(msg.attachments);\n  return `${base}${suffix ? (base ? \" \" : \"\") + suffix : \"\"}`.trim();\n}\n\nexport class OfficialAtMessageDispatcher {\n  private readonly opts: OfficialDispatcherOptions;\n  private readonly dedup = new RecentMessageDedup();\n  private readonly forward: OfficialForwardFn;\n  private loggedMissingOpenid = false;\n\n  constructor(opts: OfficialDispatcherOptions) {\n    this.opts = opts;\n    this.forward = opts.forward ?? tryForward;\n  }\n\n  async handleGroupAtMessage(msg: OfficialGroupAtMessage): Promise<void> {\n    if (!msg || typeof msg !== \"object\") return;\n    if (msg.author?.bot) return;\n\n    const groupOpenid = String(msg.group_openid ?? \"\");\n    if (!groupOpenid) {\n      log.warn(\"\u5B98\u65B9\u4E8B\u4EF6\u7F3A group_openid\uFF0C\u8DF3\u8FC7\");\n      return;\n    }\n\n    if (!this.opts.groupOpenid) {\n      if (!this.loggedMissingOpenid) {\n        log.warn(\n          `qq_group_openid \u672A\u914D\u7F6E\u3002\u6536\u5230\u7FA4 openid=${groupOpenid}\uFF0C\u8BF7\u5199\u5165 configs/qq_config.json \u540E\u91CD\u542F\uFF08\u672C\u6761\u4E0D\u8F6C\u53D1\uFF09`\n        );\n        this.loggedMissingOpenid = true;\n      } else {\n        log.info(`qq_group_openid \u672A\u914D\u7F6E\uFF0C\u4E22\u5F03\u7FA4\u6D88\u606F openid=${groupOpenid}`);\n      }\n      return;\n    }\n\n    if (groupOpenid !== this.opts.groupOpenid) {\n      log.info(`\u975E\u76EE\u6807\u7FA4 openid=${groupOpenid}\uFF0C\u8DF3\u8FC7`);\n      return;\n    }\n\n    if (this.dedup.seen(msg.id)) return;\n\n    const text = extractOfficialText(msg);\n    if (!text) return;\n\n    const memberId = String(msg.author?.member_openid || msg.author?.id || \"unknown\");\n    const fromName = String(msg.author?.username || `QQ_${memberId.slice(0, 8)}`);\n    const fromId = `qq_${memberId}`;\n\n    if (this.opts.commandRouter) {\n      const inbound = {\n        backend: \"official\" as const,\n        scene: \"group\" as const,\n        groupId: groupOpenid,\n        userId: memberId,\n        userName: fromName,\n        text,\n        isGroupAdmin: detectOfficialGroupAdmin(msg),\n        ...(msg.id ? { msgId: String(msg.id) } : {}),\n      };\n      if (await this.opts.commandRouter.handle(inbound)) return;\n    }\n\n    if (!this.opts.db.channelId) {\n      log.warn(\"bridge_channel_id \u672A\u914D\u7F6E\uFF0C\u8DF3\u8FC7\");\n      return;\n    }\n\n    await this.forward(this.opts.db, fromId, fromName, text);\n  }\n\n  /**\n   * \u5355\u804A\uFF1A\u4EC5\u8D70\u6307\u4EE4\u8DEF\u7531\uFF08\u83DC\u5355\u70B9\u51FB\u843D\u70B9\uFF09\uFF0C\u4E0D\u8F6C\u53D1 MC\u3002\n   */\n  async handleC2cMessage(msg: OfficialC2cMessage): Promise<void> {\n    if (!msg || typeof msg !== \"object\") return;\n    if (msg.author?.bot) return;\n    if (this.dedup.seen(msg.id)) return;\n\n    const text = extractOfficialText(msg);\n    if (!text) return;\n\n    const userId = String(msg.author?.user_openid || msg.author?.id || \"unknown\");\n    const fromName = String(msg.author?.username || `QQ_${userId.slice(0, 8)}`);\n\n    if (!this.opts.commandRouter) {\n      log.info(`C2C \u65E0\u6307\u4EE4\u8DEF\u7531\uFF0C\u5FFD\u7565 text=${text.slice(0, 40)}`);\n      return;\n    }\n\n    const inbound = {\n      backend: \"official\" as const,\n      scene: \"c2c\" as const,\n      groupId: `c2c:${userId}`,\n      userId,\n      userName: fromName,\n      text,\n      ...(msg.id ? { msgId: String(msg.id) } : {}),\n    };\n    await this.opts.commandRouter.handle(inbound);\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/official/events.test.js

@@ -0,0 +1,123 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import {
+  OfficialAtMessageDispatcher,
+  attachmentsPlaceholder,
+  extractOfficialText
+} from "./events.js";
+test("extractOfficialText \u53BB @ \u5E76\u62FC\u9644\u4EF6\u5360\u4F4D", () => {
+  assert.equal(
+    extractOfficialText({
+      content: "<@!botid> hello",
+      attachments: [{ content_type: "image/png" }]
+    }),
+    "hello [\u56FE\u7247]"
+  );
+});
+test("attachmentsPlaceholder \u6309\u7C7B\u578B\u5206\u7C7B", () => {
+  assert.equal(
+    attachmentsPlaceholder([
+      { content_type: "image/jpeg" },
+      { content_type: "video/mp4" },
+      { filename: "a.mp3" },
+      { filename: "doc.pdf" }
+    ]),
+    "[\u56FE\u7247][\u89C6\u9891][\u8BED\u97F3][\u6587\u4EF6]"
+  );
+});
+test("OfficialAtMessageDispatcher \u8FC7\u6EE4\u4E0E\u8F6C\u53D1\u8F7D\u8377", async () => {
+  const forwarded = [];
+  const forward = async (_db, fromId, fromName, content) => {
+    forwarded.push({ fromId, fromName, content });
+  };
+  const db = { host: "127.0.0.1", port: 3001, channelId: "bridge" };
+  const missingOpenid = new OfficialAtMessageDispatcher({
+    groupOpenid: "",
+    db,
+    forward
+  });
+  await missingOpenid.handleGroupAtMessage({
+    id: "1",
+    group_openid: "G1",
+    content: "hi",
+    author: { member_openid: "M1", username: "U", bot: false }
+  });
+  assert.equal(forwarded.length, 0);
+  const d = new OfficialAtMessageDispatcher({
+    groupOpenid: "G1",
+    db,
+    forward
+  });
+  await d.handleGroupAtMessage({
+    id: "2",
+    group_openid: "G1",
+    content: "bot echo",
+    author: { member_openid: "BOT", bot: true }
+  });
+  assert.equal(forwarded.length, 0);
+  await d.handleGroupAtMessage({
+    id: "3",
+    group_openid: "OTHER",
+    content: "wrong",
+    author: { member_openid: "M2", username: "Bob", bot: false }
+  });
+  assert.equal(forwarded.length, 0);
+  await d.handleGroupAtMessage({
+    id: "4",
+    group_openid: "G1",
+    content: "<@!x> hello world",
+    author: { member_openid: "M3", username: "Alice", bot: false }
+  });
+  assert.equal(forwarded.length, 1);
+  assert.deepEqual(forwarded[0], {
+    fromId: "qq_M3",
+    fromName: "Alice",
+    content: "hello world"
+  });
+  await d.handleGroupAtMessage({
+    id: "4",
+    group_openid: "G1",
+    content: "dup",
+    author: { member_openid: "M3", username: "Alice", bot: false }
+  });
+  assert.equal(forwarded.length, 1);
+});
+test("OfficialAtMessageDispatcher \u6307\u4EE4\u547D\u4E2D\u4E0D\u8F6C\u53D1", async () => {
+  const forwarded = [];
+  const handled = [];
+  const forward = async (_db, _a, _b, content) => {
+    forwarded.push(content);
+  };
+  const commandRouter = {
+    async handle(inbound) {
+      if (inbound.text === "ping" || inbound.text === "/ping") {
+        handled.push(inbound.text);
+        return true;
+      }
+      return false;
+    }
+  };
+  const d = new OfficialAtMessageDispatcher({
+    groupOpenid: "G1",
+    db: { host: "127.0.0.1", port: 3001, channelId: "bridge" },
+    forward,
+    commandRouter
+  });
+  await d.handleGroupAtMessage({
+    id: "c1",
+    group_openid: "G1",
+    content: "<@!x> /ping",
+    author: { member_openid: "M9", username: "Op", bot: false }
+  });
+  assert.deepEqual(handled, ["/ping"]);
+  assert.equal(forwarded.length, 0);
+  await d.handleGroupAtMessage({
+    id: "c2",
+    group_openid: "G1",
+    content: "<@!x> chat",
+    author: { member_openid: "M9", username: "Op", bot: false }
+  });
+  assert.equal(forwarded.length, 1);
+  assert.equal(forwarded[0], "chat");
+});
+//# sourceMappingURL=events.test.js.map

package/dist/official/events.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/official/events.test.ts"],
+  "sourcesContent": ["import assert from \"node:assert/strict\";\nimport test from \"node:test\";\nimport {\n  OfficialAtMessageDispatcher,\n  attachmentsPlaceholder,\n  extractOfficialText,\n} from \"./events.js\";\n\ntest(\"extractOfficialText \u53BB @ \u5E76\u62FC\u9644\u4EF6\u5360\u4F4D\", () => {\n  assert.equal(\n    extractOfficialText({\n      content: \"<@!botid> hello\",\n      attachments: [{ content_type: \"image/png\" }],\n    }),\n    \"hello [\u56FE\u7247]\"\n  );\n});\n\ntest(\"attachmentsPlaceholder \u6309\u7C7B\u578B\u5206\u7C7B\", () => {\n  assert.equal(\n    attachmentsPlaceholder([\n      { content_type: \"image/jpeg\" },\n      { content_type: \"video/mp4\" },\n      { filename: \"a.mp3\" },\n      { filename: \"doc.pdf\" },\n    ]),\n    \"[\u56FE\u7247][\u89C6\u9891][\u8BED\u97F3][\u6587\u4EF6]\"\n  );\n});\n\ntest(\"OfficialAtMessageDispatcher \u8FC7\u6EE4\u4E0E\u8F6C\u53D1\u8F7D\u8377\", async () => {\n  const forwarded: Array<{ fromId: string; fromName: string; content: string }> = [];\n  const forward = async (\n    _db: unknown,\n    fromId: string,\n    fromName: string,\n    content: string\n  ): Promise<void> => {\n    forwarded.push({ fromId, fromName, content });\n  };\n\n  const db = { host: \"127.0.0.1\", port: 3001, channelId: \"bridge\" };\n\n  const missingOpenid = new OfficialAtMessageDispatcher({\n    groupOpenid: \"\",\n    db,\n    forward,\n  });\n  await missingOpenid.handleGroupAtMessage({\n    id: \"1\",\n    group_openid: \"G1\",\n    content: \"hi\",\n    author: { member_openid: \"M1\", username: \"U\", bot: false },\n  });\n  assert.equal(forwarded.length, 0);\n\n  const d = new OfficialAtMessageDispatcher({\n    groupOpenid: \"G1\",\n    db,\n    forward,\n  });\n\n  await d.handleGroupAtMessage({\n    id: \"2\",\n    group_openid: \"G1\",\n    content: \"bot echo\",\n    author: { member_openid: \"BOT\", bot: true },\n  });\n  assert.equal(forwarded.length, 0);\n\n  await d.handleGroupAtMessage({\n    id: \"3\",\n    group_openid: \"OTHER\",\n    content: \"wrong\",\n    author: { member_openid: \"M2\", username: \"Bob\", bot: false },\n  });\n  assert.equal(forwarded.length, 0);\n\n  await d.handleGroupAtMessage({\n    id: \"4\",\n    group_openid: \"G1\",\n    content: \"<@!x> hello world\",\n    author: { member_openid: \"M3\", username: \"Alice\", bot: false },\n  });\n  assert.equal(forwarded.length, 1);\n  assert.deepEqual(forwarded[0], {\n    fromId: \"qq_M3\",\n    fromName: \"Alice\",\n    content: \"hello world\",\n  });\n\n  // \u53BB\u91CD\n  await d.handleGroupAtMessage({\n    id: \"4\",\n    group_openid: \"G1\",\n    content: \"dup\",\n    author: { member_openid: \"M3\", username: \"Alice\", bot: false },\n  });\n  assert.equal(forwarded.length, 1);\n});\n\ntest(\"OfficialAtMessageDispatcher \u6307\u4EE4\u547D\u4E2D\u4E0D\u8F6C\u53D1\", async () => {\n  const forwarded: string[] = [];\n  const handled: string[] = [];\n  const forward = async (_db: unknown, _a: string, _b: string, content: string): Promise<void> => {\n    forwarded.push(content);\n  };\n  const commandRouter = {\n    async handle(inbound: { text: string }): Promise<boolean> {\n      if (inbound.text === \"ping\" || inbound.text === \"/ping\") {\n        handled.push(inbound.text);\n        return true;\n      }\n      return false;\n    },\n  };\n\n  const d = new OfficialAtMessageDispatcher({\n    groupOpenid: \"G1\",\n    db: { host: \"127.0.0.1\", port: 3001, channelId: \"bridge\" },\n    forward,\n    commandRouter: commandRouter as never,\n  });\n\n  await d.handleGroupAtMessage({\n    id: \"c1\",\n    group_openid: \"G1\",\n    content: \"<@!x> /ping\",\n    author: { member_openid: \"M9\", username: \"Op\", bot: false },\n  });\n  assert.deepEqual(handled, [\"/ping\"]);\n  assert.equal(forwarded.length, 0);\n\n  await d.handleGroupAtMessage({\n    id: \"c2\",\n    group_openid: \"G1\",\n    content: \"<@!x> chat\",\n    author: { member_openid: \"M9\", username: \"Op\", bot: false },\n  });\n  assert.equal(forwarded.length, 1);\n  assert.equal(forwarded[0], \"chat\");\n});\n\n"],
+  "mappings": "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",
+  "names": []
+}