@zhin.js/adapter-qq 5.0.0 → 5.0.2

package/lib/src/outbound-mixed-media.js

@@ -0,0 +1,78 @@
+/**
+ * QQ 群/私聊图文混排（msg_type=7）。
+ * 内联 base64 图无法作为 Markdown 公网 URL，须先上传 file_info 再与文本同条发送。
+ */
+import { randomInt } from "node:crypto";
+import { asOutboundSegments, isTextImageMixedWithInlineMedia, splitReplyPrefix, } from "./outbound-markdown.js";
+import { resolveMediaFile } from "./outbound-media.js";
+function textFromSegment(seg) {
+    if (seg.type !== "text")
+        return "";
+    return seg.data.text ?? seg.data.content ?? "";
+}
+function isRemoteUrl(value) {
+    return /^https?:\/\//i.test(value);
+}
+function extractInlineFileData(source) {
+    if (source.startsWith("base64://"))
+        return source.slice(9);
+    if (/^data:[^/]+\/[^;]+;base64,/i.test(source)) {
+        return source.replace(/^data:[^/]+\/[^;]+;base64,/i, "");
+    }
+    return source;
+}
+export function buildQqImageUploadPayload(imageSeg) {
+    const data = imageSeg.data;
+    const url = typeof data.url === "string" ? data.url : undefined;
+    const file = resolveMediaFile(data);
+    const remote = [url, file].find((item) => item && isRemoteUrl(item));
+    if (remote) {
+        return { file_type: 1, url: remote };
+    }
+    const inline = file ?? url;
+    if (!inline) {
+        throw new Error("QQ 图文混排：图片段缺少 url/file/base64");
+    }
+    return { file_type: 1, file_data: extractInlineFileData(inline) };
+}
+export function buildTextImageMixedBodyText(body) {
+    return body
+        .map((seg) => {
+        if (seg.type === "text")
+            return textFromSegment(seg);
+        if (seg.type === "at")
+            return `<@${String(seg.data.user_id ?? "")}>`;
+        return "";
+    })
+        .join("");
+}
+export function firstImageSegment(body) {
+    return body.find((seg) => seg.type === "image");
+}
+export function shouldSendTextImageMixedMedia(content, mode) {
+    if (mode === false)
+        return false;
+    const { body } = splitReplyPrefix(asOutboundSegments(content));
+    return isTextImageMixedWithInlineMedia(body);
+}
+export function buildMixedMediaMessagePayload(content, fileInfo) {
+    const segments = asOutboundSegments(content);
+    const { prefix, body } = splitReplyPrefix(segments);
+    const payload = {
+        msg_type: 7,
+        content: buildTextImageMixedBodyText(body),
+        media: { file_info: fileInfo },
+        msg_seq: randomInt(1, 1_000_000),
+    };
+    const reply = prefix[prefix.length - 1];
+    if (reply?.type === "reply") {
+        if (typeof reply.data.event_id === "string") {
+            payload.event_id = reply.data.event_id;
+        }
+        else if (reply.data.id != null) {
+            payload.msg_id = String(reply.data.id);
+        }
+    }
+    return payload;
+}
+//# sourceMappingURL=outbound-mixed-media.js.map

package/lib/src/outbound-mixed-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-mixed-media.js","sourceRoot":"","sources":["../../src/outbound-mixed-media.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EACL,kBAAkB,EAClB,+BAA+B,EAC/B,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,SAAS,eAAe,CAAC,GAAmB;IAC1C,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAc;IAC3C,IAAI,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,6BAA6B,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,OAAO,MAAM,CAAC,OAAO,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,QAAwB;IAExB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,IAAI,GAAG,CAAC;IAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,IAAsB;IAChE,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;QACrD,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,CAAC;QACrE,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAsB;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,OAAoB,EACpB,IAAkC;IAElC,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACjC,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,OAAO,+BAA+B,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAWD,MAAM,UAAU,6BAA6B,CAC3C,OAAoB,EACpB,QAAgB;IAEhB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,OAAO,GAA+B;QAC1C,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,2BAA2B,CAAC,IAAI,CAAC;QAC1C,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE;QAC9B,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC;KACjC,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACxC,IAAI,KAAK,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;QACzC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;YACjC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/lib/{platform-permit.js → src/platform-permit.js}

@@ -1,3 +1,6 @@
+/**
+ * QQ 官方频道 platform permit（guild/channel，非 QQ 群 group_*）
+ */
 import { registerPlatformPermitChecker } from 'zhin.js';
 const ADAPTER = 'qq';
 export function platformPermit(perm) {
@@ -5,8 +8,8 @@ export function platformPermit(perm) {
 }
 /** 官方频道工厂工具：映射到 guild 语义，不用 group_* */
 const FACTORY_PERM_MAP = {
-    group_admin: 'guild_admin',
-    group_owner: 'guild_owner',
+    scene_admin: 'guild_admin',
+    scene_owner: 'guild_owner',
 };
 export function qqGuildPermitResolver(logicalPerm) {
     return platformPermit(FACTORY_PERM_MAP[logicalPerm] ?? logicalPerm);

package/lib/src/platform-permit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-permit.js","sourceRoot":"","sources":["../../src/platform-permit.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,6BAA6B,EAAgB,MAAM,SAAS,CAAC;AAEtE,MAAM,OAAO,GAAG,IAAI,CAAC;AAErB,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,YAAY,OAAO,IAAI,IAAI,GAAG,CAAC;AACxC,CAAC;AAED,uCAAuC;AACvC,MAAM,gBAAgB,GAA2B;IAC/C,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;CAC3B,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,OAAO,cAAc,CAAC,gBAAgB,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,KAI/C;IACC,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QAC/C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IACxC,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAChC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,OAAqB;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAoD,CAAC;IAC5E,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEnD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa;YAChB,OAAO,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;QAChD,KAAK,aAAa;YAChB,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;QAC1F,KAAK,cAAc;YACjB,OAAO,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;QACvE,KAAK,iBAAiB;YACpB,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACpH;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,OAAO,6BAA6B,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;AACvE,CAAC"}

package/lib/src/qq-agent-deps.js

@@ -0,0 +1,10 @@
+let _deps = null;
+export function setQqAgentDeps(deps) {
+    _deps = deps;
+}
+export function getQqAgentDeps() {
+    if (!_deps)
+        throw new Error('qq agent deps not initialized');
+    return _deps;
+}
+//# sourceMappingURL=qq-agent-deps.js.map

package/lib/src/qq-agent-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qq-agent-deps.js","sourceRoot":"","sources":["../../src/qq-agent-deps.ts"],"names":[],"mappings":"AAaA,IAAI,KAAK,GAAuB,IAAI,CAAC;AAErC,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,KAAK,GAAG,IAAI,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC7D,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/{qq-bind-api.js → src/qq-bind-api.js}

@@ -71,16 +71,20 @@ export async function createBindTask(env = 'production', timeoutMs = 10_000) {
     }
     return { taskId: res.data.task_id, key };
 }
+export function parsePollBindResultData(data) {
+    return {
+        status: (data?.status ?? BindStatus.NONE),
+        botAppId: String(data?.bot_appid ?? ''),
+        botEncryptSecret: data?.bot_encrypt_secret ?? '',
+        userOpenId: String(data?.user_openid ?? data?.userOpenid ?? data?.openid ?? ''),
+    };
+}
 export async function pollBindResult(taskId, env = 'production', timeoutMs = 10_000) {
     const url = `https://${getQQBotHost(env)}/lite/poll_bind_result`;
     const res = await postJson(url, { task_id: taskId }, timeoutMs);
     if (res.retcode !== 0) {
         throw new Error(res.msg ?? 'poll_bind_result failed');
     }
-    return {
-        status: (res.data?.status ?? BindStatus.NONE),
-        botAppId: String(res.data?.bot_appid ?? ''),
-        botEncryptSecret: res.data?.bot_encrypt_secret ?? '',
-    };
+    return parsePollBindResultData(res.data);
 }
 //# sourceMappingURL=qq-bind-api.js.map

package/lib/src/qq-bind-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qq-bind-api.js","sourceRoot":"","sources":["../../src/qq-bind-api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI5D,MAAM,KAAK,GAA6B;IACtC,UAAU,EAAE,UAAU;IACtB,IAAI,EAAE,eAAe;CACtB,CAAC;AAEF,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,2CAAQ,CAAA;IACR,iDAAW,CAAA;IACX,qDAAa,CAAA;IACb,iDAAW,CAAA;AACb,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED,MAAM,UAAU,YAAY,CAAC,MAAgB,YAAY;IACvD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,MAAM,GAAG,MAAM;IAC7D,OAAO,WAAW,YAAY,CAAC,YAAY,CAAC,wCAAwC,kBAAkB,CAAC,MAAM,CAAC,WAAW,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC;AAC9J,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,eAAuB,EAAE,SAAiB;IACtE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAC1D,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACzF,CAAC;AAQD,KAAK,UAAU,QAAQ,CACrB,GAAW,EACX,IAA6B,EAC7B,SAAiB;IAEjB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,MAAM,EAAE,kBAAkB;aAC3B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAuB,CAAC;IAClD,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAgB,YAAY,EAC5B,SAAS,GAAG,MAAM;IAElB,MAAM,GAAG,GAAG,WAAW,YAAY,CAAC,GAAG,CAAC,wBAAwB,CAAC;IACjE,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAuB,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IAC1E,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,yBAAyB,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC;AAC3C,CAAC;AAUD,MAAM,UAAU,uBAAuB,CAAC,IAO3B;IACX,OAAO;QACL,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,IAAI,UAAU,CAAC,IAAI,CAAe;QACvD,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,IAAI,EAAE,CAAC;QACvC,gBAAgB,EAAE,IAAI,EAAE,kBAAkB,IAAI,EAAE;QAChD,UAAU,EAAE,MAAM,CAChB,IAAI,EAAE,WAAW,IAAI,IAAI,EAAE,UAAU,IAAI,IAAI,EAAE,MAAM,IAAI,EAAE,CAC5D;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,MAAgB,YAAY,EAC5B,SAAS,GAAG,MAAM;IAElB,MAAM,GAAG,GAAG,WAAW,YAAY,CAAC,GAAG,CAAC,wBAAwB,CAAC;IACjE,MAAM,GAAG,GAAG,MAAM,QAAQ,CAOvB,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC,CAAC;IACxC,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,yBAAyB,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/lib/{qq-bind-flow.js → src/qq-bind-flow.js}

@@ -28,7 +28,12 @@ async function pollUntilResult(taskId, key, signal) {
         }
         if (result.status === BindStatus.COMPLETED) {
             const appSecret = decryptSecret(result.botEncryptSecret, key);
-            return { outcome: 'scanned', appId: result.botAppId, appSecret };
+            return {
+                outcome: 'scanned',
+                appId: result.botAppId,
+                appSecret,
+                userOpenId: result.userOpenId,
+            };
         }
         if (result.status === BindStatus.EXPIRED) {
             return { outcome: 'expired' };
@@ -61,7 +66,11 @@ export function startQqBindFlow(callbacks, options = {}) {
             await callbacks.onQrDisplayed?.(connectUrl);
             const pollResult = await pollUntilResult(task.taskId, task.key, signal);
             if (pollResult.outcome === 'scanned') {
-                callbacks.onSuccess([{ appId: pollResult.appId, appSecret: pollResult.appSecret }]);
+                callbacks.onSuccess([{
+                        appId: pollResult.appId,
+                        appSecret: pollResult.appSecret,
+                        userOpenId: pollResult.userOpenId || undefined,
+                    }]);
                 return;
             }
             await callbacks.onQrExpired?.();

package/lib/src/qq-bind-flow.js.map

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

package/lib/src/qq-bind-persist.js

@@ -0,0 +1,52 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { runtimeCwd } from 'zhin.js';
+/** 按 endpoint 名称生成唯一 env 键（如 `QQ_MOCK_QQ_BOT_APPID`） */
+export function buildQqCredentialEnvKeys(endpointName) {
+    const slug = endpointName.replace(/[^a-zA-Z0-9_]/g, '_').toUpperCase();
+    const appidKey = `QQ_${slug}_APPID`;
+    const secretKey = `QQ_${slug}_SECRET`;
+    return {
+        appidKey,
+        secretKey,
+        appidRef: `\${${appidKey}}`,
+        secretRef: `\${${secretKey}}`,
+    };
+}
+function resolveProjectRoot() {
+    const envRoot = process.env.ZHIN_PROJECT_ROOT?.trim();
+    return path.resolve(envRoot || runtimeCwd());
+}
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function upsertEnvLine(content, key, value) {
+    const lineRe = new RegExp(`^${escapeRegExp(key)}\\s*=.*$`, 'm');
+    const newLine = `${key}=${value}`;
+    if (lineRe.test(content)) {
+        return content.replace(lineRe, newLine);
+    }
+    const trimmed = content.replace(/\s*$/, '');
+    if (trimmed.length === 0) {
+        return `${newLine}\n`;
+    }
+    return `${trimmed}\n${newLine}\n`;
+}
+/** 写入或更新 `.env` 中的键值，并同步到当前进程 `process.env` */
+export function persistQqCredentialsToEnv(endpointName, appId, appSecret, projectRoot) {
+    const keys = buildQqCredentialEnvKeys(endpointName);
+    const root = projectRoot ?? resolveProjectRoot();
+    const envPath = path.join(root, '.env');
+    let content = fs.existsSync(envPath) ? fs.readFileSync(envPath, 'utf-8') : '';
+    const entries = {
+        [keys.appidKey]: appId,
+        [keys.secretKey]: appSecret,
+    };
+    for (const [key, value] of Object.entries(entries)) {
+        content = upsertEnvLine(content, key, value);
+        process.env[key] = value;
+    }
+    fs.writeFileSync(envPath, content);
+    return keys;
+}
+//# sourceMappingURL=qq-bind-persist.js.map

package/lib/src/qq-bind-persist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qq-bind-persist.js","sourceRoot":"","sources":["../../src/qq-bind-persist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AASrC,wDAAwD;AACxD,MAAM,UAAU,wBAAwB,CAAC,YAAoB;IAC3D,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACvE,MAAM,QAAQ,GAAG,MAAM,IAAI,QAAQ,CAAC;IACpC,MAAM,SAAS,GAAG,MAAM,IAAI,SAAS,CAAC;IACtC,OAAO;QACL,QAAQ;QACR,SAAS;QACT,QAAQ,EAAE,MAAM,QAAQ,GAAG;QAC3B,SAAS,EAAE,MAAM,SAAS,GAAG;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;IACtD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,UAAU,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,aAAa,CAAC,OAAe,EAAE,GAAW,EAAE,KAAa;IAChE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;IAClC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,OAAO,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,GAAG,OAAO,KAAK,OAAO,IAAI,CAAC;AACpC,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,yBAAyB,CACvC,YAAoB,EACpB,KAAa,EACb,SAAiB,EACjB,WAAoB;IAEpB,MAAM,IAAI,GAAG,wBAAwB,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,WAAW,IAAI,kBAAkB,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE9E,MAAM,OAAO,GAA2B;QACtC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK;QACtB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS;KAC5B,CAAC;IAEF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/{qq-endpoint-manager.js → src/qq-endpoint-manager.js}

@@ -1,5 +1,6 @@
 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',
@@ -11,10 +12,15 @@ const DEFAULT_INTENTS = [
     'AUDIO_ACTION',
     'PUBLIC_GUILD_MESSAGES',
 ];
+function clonePlainConfig(value) {
+    return JSON.parse(JSON.stringify(value));
+}
 function resolveQqEndpointTemplate(root) {
     const configService = root.inject('config');
-    const doc = configService?.getPrimary?.();
-    const existing = doc?.endpoints?.find((e) => e.context === 'qq');
+    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,
@@ -25,7 +31,32 @@ function resolveQqEndpointTemplate(root) {
         };
     }
     const { name: _n, appid: _a, secret: _s, context: _c, ...rest } = existing;
-    return rest;
+    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');
@@ -66,7 +97,7 @@ export class QqEndpointManager {
         return new Promise((resolve, reject) => {
             const stopFlow = startQqBindFlow({
                 onQrDisplayed: async (url) => {
-                    await ctx.onStatusUpdate('请用手机 QQ 扫描下方二维码完成机器人绑定（source=zhin）。', {
+                    await ctx.onStatusUpdate('请用手机 QQ 扫描二维码完成机器人绑定。', {
                         qrcode: url,
                     });
                 },
@@ -75,15 +106,19 @@ export class QqEndpointManager {
                 },
                 onSuccess: async (credentials) => {
                     activeStopFlow = null;
-                    const [{ appId, appSecret }] = credentials;
+                    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: appId,
-                        secret: appSecret,
-                        ...template,
+                        appid: envKeys.appidRef,
+                        secret: envKeys.secretRef,
+                        ...owned,
                     });
                 },
                 onFailure: async (error) => {

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

@@ -0,0 +1 @@
+{"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.map

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"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.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter-qq",
-  "version": "5.0.0",
+  "version": "5.0.2",
   "description": "Zhin.js adapter for QQ Official Bot",
   "type": "module",
   "main": "./lib/index.js",
@@ -34,30 +34,37 @@
     "directory": "plugins/adapters/qq"
   },
   "dependencies": {
-    "qq-official-bot": "^1.2.2"
+    "qq-official-bot": "^1.2.3"
   },
   "devDependencies": {
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "lucide-react": "^1.21.0",
+    "lucide-react": "^1.22.0",
     "typescript": "^6.0.3",
-    "@zhin.js/cli": "1.0.91",
-    "@zhin.js/client": "2.0.3",
-    "@zhin.js/contract": "1.0.1",
-    "@zhin.js/host-api": "2.0.3",
-    "@zhin.js/host-router": "2.0.1",
-    "@zhin.js/logger": "1.0.72",
-    "zhin.js": "4.1.0"
+    "zod": "^4.4.3",
+    "@zhin.js/cli": "1.0.93",
+    "@zhin.js/client": "2.0.5",
+    "@zhin.js/contract": "1.0.3",
+    "@zhin.js/host-api": "2.0.5",
+    "@zhin.js/host-router": "2.0.3",
+    "@zhin.js/logger": "1.0.74",
+    "zhin.js": "4.1.2",
+    "@zhin.js/agent": "1.0.3"
   },
   "peerDependencies": {
-    "@zhin.js/client": "2.0.3",
-    "@zhin.js/host-api": "2.0.3",
-    "@zhin.js/contract": "1.0.1",
-    "@zhin.js/host-router": "2.0.1",
-    "@zhin.js/logger": "1.0.72",
-    "zhin.js": "4.1.0"
+    "zod": "^4.0.0",
+    "@zhin.js/client": "2.0.5",
+    "@zhin.js/host-api": "2.0.5",
+    "@zhin.js/contract": "1.0.3",
+    "@zhin.js/host-router": "2.0.3",
+    "@zhin.js/logger": "1.0.74",
+    "zhin.js": "4.1.2",
+    "@zhin.js/agent": "1.0.3"
   },
   "peerDependenciesMeta": {
+    "@zhin.js/agent": {
+      "optional": true
+    },
     "@zhin.js/client": {
       "optional": true
     },
@@ -66,6 +73,9 @@
     },
     "@zhin.js/host-api": {
       "optional": true
+    },
+    "zod": {
+      "optional": true
     }
   },
   "files": [
@@ -73,7 +83,7 @@
     "lib",
     "client",
     "dist",
-    "skills",
+    "agent",
     "plugin.yml",
     "README.md",
     "node",

package/src/adapter.ts

@@ -1,16 +1,13 @@
 /**
  * QQ 官方适配器
  */
-import {
-  Adapter,
-  Plugin,
-} from "zhin.js";
+import { Adapter, Plugin, QQ_AI_OUTBOUND_EXTENSIONS, type EndpointManager, type OutboundRichSegmentPolicy } from 'zhin.js';
 import type { Router } from "@zhin.js/host-router";
-import type { EndpointManager } from "zhin.js";
+
 import { QQEndpoint } from "./endpoint.js";
 import { QqEndpointManager } from "./qq-endpoint-manager.js";
 import type { QQEndpointConfig, ReceiverMode } from "./types.js";
-import type { OutboundRichSegmentPolicy } from "zhin.js";
+
 
 export class QQAdapter extends Adapter<QQEndpoint<ReceiverMode>> {
   static override readonly capabilities = ['inbound', 'outbound'] as const;
@@ -19,6 +16,13 @@ export class QQAdapter extends Adapter<QQEndpoint<ReceiverMode>> {
     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;
@@ -43,9 +47,9 @@ export class QQAdapter extends Adapter<QQEndpoint<ReceiverMode>> {
     return this.#endpointManager;
   }
 
-  // ── IGroupManagement 标准群管方法 ──────────────────────────────────
+  // ── ISceneManagement 标准群管方法 ──────────────────────────────────
 
-  async kickMember(endpointId: string, sceneId: string, userId: string) {
+  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);
@@ -57,7 +61,7 @@ export class QQAdapter extends Adapter<QQEndpoint<ReceiverMode>> {
     return endpoint.muteMembers(sceneId, [userId], duration);
   }
 
-  async muteAll(endpointId: string, sceneId: string, enable = true) {
+  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);
@@ -69,7 +73,7 @@ export class QQAdapter extends Adapter<QQEndpoint<ReceiverMode>> {
     return endpoint.getGuildMembers(sceneId);
   }
 
-  async getGroupInfo(endpointId: string, sceneId: string) {
+  async getSceneInfo(endpointId: string, sceneId: string) {
     const endpoint = this.endpoints.get(endpointId);
     if (!endpoint) throw new Error(`Endpoint ${endpointId} 不存在`);
     return endpoint.getGuildInfo(sceneId);