mioku-adapter-qq-official 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mioku Lab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# mioku-adapter-qq-official
+
+QQ 开放平台官方机器人适配器(mioku),支持 QQ 群聊、单聊场景,含 Markdown 消息、交互按钮、富媒体发送与按钮回调事件。
+
+## 特性
+
+- **官方通道**:OpenAPI v2 + 官方 WebSocket 网关(op 10/2/1/11/6/7/9,断线自动 Resume 补发)
+- **Token 自动管理**:`access_token` 7200s,提前 2 分钟自动刷新,401 自动重试
+- **Markdown + 按钮**:核心 `segment.markdown()` / `segment.button()` → 官方 msg_type=2,按钮自动 5 个一行组装 keyboard(最多 5×5)
+- **图片双模式**(配置切换):
+  - `markdown`:图片嵌入 markdown 单卡片发送,适合有公网的机器
+  - `media`:图片走 base64 上传独立富媒体消息,无公网要求
+  - markdown 转存/发送失败自动按 media 路径重试;markdown 权限类错误自动降级纯文本
+- **被动回复自动接管**:事件后 5 分钟窗口内的发送自动携带 `msg_id`/`msg_seq`(最多 5 次),插件零感知;互动事件回复走 `event_id`
+- **按钮回调合成消息事件**:`INTERACTION_CREATE`(type=11/12)自动回应并合成为 `sub_type: "callback"` 的普通消息事件(内容为 `button_data`),走现有指令管道;先应答再派发,规避 3 秒超时
+- **群全量消息**:支持 `GROUP_MESSAGE_CREATE`(需在管理端开启「接收所有消息」),`author.member_role` 直接映射 `sender.role`
+- **能力降级约定**:官方不支持的群管/查询类能力按约定返回假完成(动作类,带一次性 warn)或空值(查询类),插件不会崩
+
+## 安装
+
+仓库内 workspace 包,`bun install` 即可安装。
+
+```bash
+bun install
+```
+
+## 配置
+
+适配器配置存在机器人根目录 `package.json` 的 `mioku.adapters` 字段下(JSON):
+
+```json
+{
+  "mioku": {
+    "adapters": {
+      "qq-official": {
+        "instances": [
+          {
+            "appId": "你的AppID",
+            "appSecret": "你的AppSecret"
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+也可以在机器人项目根目录运行 `npx mioku-adapter-qq-official` 交互式写入,或在 WebUI 配置页按 [config.md](./config.md) 声明的字段表单化编辑。
+
+## 平台前置条件
+
+1. [QQ 开放平台](https://q.qq.com) 创建机器人,拿到 `AppID` / `AppSecret`
+2. **IP 白名单**:新机器人默认强制启用,部署机公网 IP 必须加入白名单,否则连不上网关
+3. **群全量消息**:如需接收群里非 @ 消息,在管理端开启「接收所有消息」
+4. **消息 URL 白名单**:消息文本中的链接域名必须报备(需 ICP 备案);markdown 图片由平台转存,一般无需报白
+
+## 能力支持矩阵
+
+| 能力 | 状态 | 说明 |
+|---|---|---|
+| message.send | ✅ | 文本/markdown/图片/语音/视频/文件/按钮 |
+| message.recall | ✅ | 2 分钟内;仅撤回已见过的消息(发送响应或收到的事件) |
+| message.forwardsend | ⚠️ | 合并转发拍平为多条普通消息 |
+| message.get / getforward | ⬜ 返回空 | 官方无对应 API |
+| group.getinfo / getlist | ⚠️ | 仅返回运行期间见过的群(openid),无群名 |
+| group.getmembers / member.* 查询 | ⬜ 返回空 | 官方无对应 API |
+| member.ban / kick / card / admin / title / poke 等管理动作 | ⚠️ 假完成 | 官方无对应 API,调用成功但记一次性 warn |
+| conversation.history | ⬜ 返回空 | 官方无对应 API |
+| friend.* | ⬜/⚠️ | 同上约定 |
+| bot.status | ✅ | |
+
+✅ 完整支持 · ⚠️ 降级实现 · ⬜ 空值降级
+
+## 消息转换规则
+
+官方一次请求只能携带一种内容(`msg_type` 0/2/7 互斥),适配器按以下规则拆分:
+
+- `text` / `at` / `markdown` 段合并进 markdown 文本池;`at` 转官方文本链(`<qqbot-at-user>` / `<qqbot-at-everyone>`)
+- `image`:markdown 模式且有 URL → 嵌入 markdown;否则上传 `/files` 走 msg_type=7 独立发送(图文会拆成多条)
+- `video` / `record` / `file` → 上传后 msg_type=7 独立发送(语音支持 silk/mp3/wav/ogg)
+- `button` 段汇总挂到第一个 markdown 单元;没有 markdown 单元时自动补一条空白 markdown 承载键盘
+- `face` / `json` / `forward` 等无对应物的段丢弃(记 debug);`node` 递归拍平
+- 发送报 `50037`/`50056`/`304036` 等 markdown 权限/格式错误 → 自动降级纯文本重试
+
+## 已知限制
+
+- 所有 id 均为 **openid**,且同一用户在不同 appId 下 openid 不同,请按 bot 维度隔离存储
+- 群里默认只能收到 @机器人 的消息;全量消息需平台侧开关
+- 主动消息有频控(认证 60/qpm,单关系 20/qpm,每群 1000 条/天),超限错误码会翻译进日志
+- 按钮仅能挂在 markdown 消息上;回调按钮的互动应答使用 code 0

package/dist/cli.cjs

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+Object.defineProperty(exports, '__esModule', { value: true });
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let node_fs = require("node:fs");
+node_fs = __toESM(node_fs);
+let node_path = require("node:path");
+node_path = __toESM(node_path);
+let node_url = require("node:url");
+let consola = require("consola");
+consola = __toESM(consola);
+
+//#region src/cli.ts
+const confirm = async (message, options) => await consola.default.prompt(message, {
+	type: "confirm",
+	cancel: "reject",
+	...options
+});
+const input = async (message, options) => {
+	let result;
+	do {
+		result = await consola.default.prompt(message, {
+			type: "text",
+			cancel: "reject",
+			...options
+		});
+		if (options?.required && !result) continue;
+		break;
+	} while (true);
+	return result;
+};
+const select = (message, options) => consola.default.prompt(message, {
+	type: "select",
+	cancel: "reject",
+	options
+});
+const run = async (ctx) => {
+	const log = ctx.logger ?? consola.default;
+	log.info("正在配置 qq-official 适配器(AppID / AppSecret 见开放平台开发设置)");
+	log.info("");
+	const instances = [];
+	let addMore = true;
+	while (addMore) {
+		const appId = await input("AppID", { required: true });
+		const appSecret = await input("AppSecret", { required: true });
+		const sandbox = await confirm("使用沙箱环境？", { initial: false });
+		const imageMode = await select("图片发送方式", [{
+			label: "markdown（单卡片，图片需公网可访问）",
+			value: "markdown"
+		}, {
+			label: "media（图文分离，base64 上传）",
+			value: "media"
+		}]);
+		instances.push({
+			appId,
+			appSecret,
+			sandbox,
+			imageMode
+		});
+		addMore = await confirm("是否继续添加机器人实例？", { initial: false });
+		if (addMore) log.info("");
+	}
+	return { instances };
+};
+const isRunningAsMain = () => {
+	if (!process.argv[1]) return false;
+	try {
+		return require("url").pathToFileURL(__filename).href === (0, node_url.pathToFileURL)(node_fs.default.realpathSync(process.argv[1])).href;
+	} catch {
+		return false;
+	}
+};
+if (isRunningAsMain()) (async () => {
+	const cwd = process.cwd();
+	const pkgPath = node_path.default.join(cwd, "package.json");
+	if (!node_fs.default.existsSync(pkgPath)) {
+		consola.default.error("未找到 package.json，请在机器人项目根目录运行此向导");
+		process.exit(1);
+	}
+	const config = await run({ cwd });
+	const pkg = JSON.parse(node_fs.default.readFileSync(pkgPath, "utf-8"));
+	pkg.mioku = pkg.mioku ?? {};
+	const adapters = pkg.mioku.adapters ?? {};
+	pkg.mioku.adapters = {
+		...adapters,
+		"qq-official": config
+	};
+	node_fs.default.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, "utf-8");
+	consola.default.success("已写入 qq-official 适配器配置");
+})();
+var cli_default = run;
+
+//#endregion
+exports.__toESM = __toESM;
+exports.default = cli_default;
+exports.run = run;
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.cjs","names":["result: string","instances: QQOfficialInstanceInput[]","fs","path"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport consola from \"consola\";\n\nimport type { ConfirmPromptOptions, TextPromptOptions } from \"consola\";\n\ntype ConfirmOpts = Omit<ConfirmPromptOptions, \"type\" | \"required\"> & {\n  required?: boolean;\n};\ntype TextOpts = Omit<TextPromptOptions, \"type\" | \"required\"> & {\n  required?: boolean;\n};\n\nconst confirm = async (\n  message: string,\n  options?: ConfirmOpts,\n): Promise<boolean> =>\n  (await consola.prompt(message, {\n    type: \"confirm\",\n    cancel: \"reject\",\n    ...options,\n  })) as boolean;\n\nconst input = async (message: string, options?: TextOpts): Promise<string> => {\n  let result: string;\n  do {\n    result = (await consola.prompt(message, {\n      type: \"text\",\n      cancel: \"reject\",\n      ...options,\n    })) as string;\n    if (options?.required && !result) continue;\n    break;\n  } while (true);\n  return result;\n};\n\nconst select = <T extends string>(\n  message: string,\n  options: Array<{ label: string; value: T }>,\n): Promise<T> =>\n  consola.prompt(message, {\n    type: \"select\",\n    cancel: \"reject\",\n    options,\n  }) as Promise<T>;\n\nexport interface QQOfficialCliContext {\n  readonly cwd: string;\n  readonly logger?: typeof consola;\n}\n\nexport interface QQOfficialInstanceInput {\n  appId: string;\n  appSecret: string;\n  sandbox: boolean;\n  imageMode: \"markdown\" | \"media\";\n}\n\nexport interface QQOfficialCliConfig {\n  instances: QQOfficialInstanceInput[];\n}\n\nexport const run = async (\n  ctx: QQOfficialCliContext,\n): Promise<QQOfficialCliConfig> => {\n  const log = ctx.logger ?? consola;\n  log.info(\"正在配置 qq-official 适配器(AppID / AppSecret 见开放平台开发设置)\");\n  log.info(\"\");\n\n  const instances: QQOfficialInstanceInput[] = [];\n  let addMore = true;\n  while (addMore) {\n    const appId = await input(\"AppID\", { required: true });\n    const appSecret = await input(\"AppSecret\", { required: true });\n    const sandbox = await confirm(\"使用沙箱环境？\", { initial: false });\n    const imageMode = await select(\"图片发送方式\", [\n      {\n        label: \"markdown（单卡片，图片需公网可访问）\",\n        value: \"markdown\" as const,\n      },\n      { label: \"media（图文分离，base64 上传）\", value: \"media\" as const },\n    ]);\n\n    instances.push({ appId, appSecret, sandbox, imageMode });\n    addMore = await confirm(\"是否继续添加机器人实例？\", { initial: false });\n    if (addMore) log.info(\"\");\n  }\n\n  return { instances };\n};\n\nconst isRunningAsMain = (): boolean => {\n  if (!process.argv[1]) return false;\n  try {\n    return (\n      import.meta.url === pathToFileURL(fs.realpathSync(process.argv[1])).href\n    );\n  } catch {\n    return false;\n  }\n};\n\nif (isRunningAsMain()) {\n  void (async () => {\n    const cwd = process.cwd();\n    const pkgPath = path.join(cwd, \"package.json\");\n    if (!fs.existsSync(pkgPath)) {\n      consola.error(\"未找到 package.json，请在机器人项目根目录运行此向导\");\n      process.exit(1);\n    }\n    const config = await run({ cwd });\n    const pkg = JSON.parse(fs.readFileSync(pkgPath, \"utf-8\")) as {\n      mioku?: Record<string, unknown>;\n    };\n    pkg.mioku = pkg.mioku ?? {};\n    const adapters =\n      (pkg.mioku.adapters as Record<string, unknown> | undefined) ?? {};\n    pkg.mioku.adapters = { ...adapters, \"qq-official\": config };\n    fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\\n`, \"utf-8\");\n    consola.success(\"已写入 qq-official 适配器配置\");\n  })();\n}\n\nexport default run;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeA,MAAM,UAAU,OACd,SACA,YAEC,MAAM,gBAAQ,OAAO,SAAS;CAC7B,MAAM;CACN,QAAQ;CACR,GAAG;CACJ,CAAC;AAEJ,MAAM,QAAQ,OAAO,SAAiB,YAAwC;CAC5E,IAAIA;AACJ,IAAG;AACD,WAAU,MAAM,gBAAQ,OAAO,SAAS;GACtC,MAAM;GACN,QAAQ;GACR,GAAG;GACJ,CAAC;AACF,MAAI,SAAS,YAAY,CAAC,OAAQ;AAClC;UACO;AACT,QAAO;;AAGT,MAAM,UACJ,SACA,YAEA,gBAAQ,OAAO,SAAS;CACtB,MAAM;CACN,QAAQ;CACR;CACD,CAAC;AAkBJ,MAAa,MAAM,OACjB,QACiC;CACjC,MAAM,MAAM,IAAI,UAAU;AAC1B,KAAI,KAAK,oDAAoD;AAC7D,KAAI,KAAK,GAAG;CAEZ,MAAMC,YAAuC,EAAE;CAC/C,IAAI,UAAU;AACd,QAAO,SAAS;EACd,MAAM,QAAQ,MAAM,MAAM,SAAS,EAAE,UAAU,MAAM,CAAC;EACtD,MAAM,YAAY,MAAM,MAAM,aAAa,EAAE,UAAU,MAAM,CAAC;EAC9D,MAAM,UAAU,MAAM,QAAQ,WAAW,EAAE,SAAS,OAAO,CAAC;EAC5D,MAAM,YAAY,MAAM,OAAO,UAAU,CACvC;GACE,OAAO;GACP,OAAO;GACR,EACD;GAAE,OAAO;GAAyB,OAAO;GAAkB,CAC5D,CAAC;AAEF,YAAU,KAAK;GAAE;GAAO;GAAW;GAAS;GAAW,CAAC;AACxD,YAAU,MAAM,QAAQ,gBAAgB,EAAE,SAAS,OAAO,CAAC;AAC3D,MAAI,QAAS,KAAI,KAAK,GAAG;;AAG3B,QAAO,EAAE,WAAW;;AAGtB,MAAM,wBAAiC;AACrC,KAAI,CAAC,QAAQ,KAAK,GAAI,QAAO;AAC7B,KAAI;AACF,uFACoCC,gBAAG,aAAa,QAAQ,KAAK,GAAG,CAAC,CAAC;SAEhE;AACN,SAAO;;;AAIX,IAAI,iBAAiB,CACnB,EAAM,YAAY;CAChB,MAAM,MAAM,QAAQ,KAAK;CACzB,MAAM,UAAUC,kBAAK,KAAK,KAAK,eAAe;AAC9C,KAAI,CAACD,gBAAG,WAAW,QAAQ,EAAE;AAC3B,kBAAQ,MAAM,mCAAmC;AACjD,UAAQ,KAAK,EAAE;;CAEjB,MAAM,SAAS,MAAM,IAAI,EAAE,KAAK,CAAC;CACjC,MAAM,MAAM,KAAK,MAAMA,gBAAG,aAAa,SAAS,QAAQ,CAAC;AAGzD,KAAI,QAAQ,IAAI,SAAS,EAAE;CAC3B,MAAM,WACH,IAAI,MAAM,YAAoD,EAAE;AACnE,KAAI,MAAM,WAAW;EAAE,GAAG;EAAU,eAAe;EAAQ;AAC3D,iBAAG,cAAc,SAAS,GAAG,KAAK,UAAU,KAAK,MAAM,EAAE,CAAC,KAAK,QAAQ;AACvE,iBAAQ,QAAQ,wBAAwB;IACtC;AAGN,kBAAe"}

package/dist/cli.d.cts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import consola from "consola";
+
+//#region src/cli.d.ts
+interface QQOfficialCliContext {
+  readonly cwd: string;
+  readonly logger?: typeof consola;
+}
+interface QQOfficialInstanceInput {
+  appId: string;
+  appSecret: string;
+  sandbox: boolean;
+  imageMode: "markdown" | "media";
+}
+interface QQOfficialCliConfig {
+  instances: QQOfficialInstanceInput[];
+}
+declare const run: (ctx: QQOfficialCliContext) => Promise<QQOfficialCliConfig>;
+//#endregion
+export { QQOfficialCliConfig, QQOfficialCliContext, QQOfficialInstanceInput, run as default, run };
+//# sourceMappingURL=cli.d.cts.map

package/dist/cli.d.mts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import consola from "consola";
+
+//#region src/cli.d.ts
+interface QQOfficialCliContext {
+  readonly cwd: string;
+  readonly logger?: typeof consola;
+}
+interface QQOfficialInstanceInput {
+  appId: string;
+  appSecret: string;
+  sandbox: boolean;
+  imageMode: "markdown" | "media";
+}
+interface QQOfficialCliConfig {
+  instances: QQOfficialInstanceInput[];
+}
+declare const run: (ctx: QQOfficialCliContext) => Promise<QQOfficialCliConfig>;
+//#endregion
+export { QQOfficialCliConfig, QQOfficialCliContext, QQOfficialInstanceInput, run as default, run };
+//# sourceMappingURL=cli.d.mts.map

package/dist/cli.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import consola from "consola";
+
+//#region src/cli.ts
+const confirm = async (message, options) => await consola.prompt(message, {
+	type: "confirm",
+	cancel: "reject",
+	...options
+});
+const input = async (message, options) => {
+	let result;
+	do {
+		result = await consola.prompt(message, {
+			type: "text",
+			cancel: "reject",
+			...options
+		});
+		if (options?.required && !result) continue;
+		break;
+	} while (true);
+	return result;
+};
+const select = (message, options) => consola.prompt(message, {
+	type: "select",
+	cancel: "reject",
+	options
+});
+const run = async (ctx) => {
+	const log = ctx.logger ?? consola;
+	log.info("正在配置 qq-official 适配器(AppID / AppSecret 见开放平台开发设置)");
+	log.info("");
+	const instances = [];
+	let addMore = true;
+	while (addMore) {
+		const appId = await input("AppID", { required: true });
+		const appSecret = await input("AppSecret", { required: true });
+		const sandbox = await confirm("使用沙箱环境？", { initial: false });
+		const imageMode = await select("图片发送方式", [{
+			label: "markdown（单卡片，图片需公网可访问）",
+			value: "markdown"
+		}, {
+			label: "media（图文分离，base64 上传）",
+			value: "media"
+		}]);
+		instances.push({
+			appId,
+			appSecret,
+			sandbox,
+			imageMode
+		});
+		addMore = await confirm("是否继续添加机器人实例？", { initial: false });
+		if (addMore) log.info("");
+	}
+	return { instances };
+};
+const isRunningAsMain = () => {
+	if (!process.argv[1]) return false;
+	try {
+		return import.meta.url === pathToFileURL(fs.realpathSync(process.argv[1])).href;
+	} catch {
+		return false;
+	}
+};
+if (isRunningAsMain()) (async () => {
+	const cwd = process.cwd();
+	const pkgPath = path.join(cwd, "package.json");
+	if (!fs.existsSync(pkgPath)) {
+		consola.error("未找到 package.json，请在机器人项目根目录运行此向导");
+		process.exit(1);
+	}
+	const config = await run({ cwd });
+	const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+	pkg.mioku = pkg.mioku ?? {};
+	const adapters = pkg.mioku.adapters ?? {};
+	pkg.mioku.adapters = {
+		...adapters,
+		"qq-official": config
+	};
+	fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, "utf-8");
+	consola.success("已写入 qq-official 适配器配置");
+})();
+var cli_default = run;
+
+//#endregion
+export { cli_default as default, run };
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":["result: string","instances: QQOfficialInstanceInput[]"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport consola from \"consola\";\n\nimport type { ConfirmPromptOptions, TextPromptOptions } from \"consola\";\n\ntype ConfirmOpts = Omit<ConfirmPromptOptions, \"type\" | \"required\"> & {\n  required?: boolean;\n};\ntype TextOpts = Omit<TextPromptOptions, \"type\" | \"required\"> & {\n  required?: boolean;\n};\n\nconst confirm = async (\n  message: string,\n  options?: ConfirmOpts,\n): Promise<boolean> =>\n  (await consola.prompt(message, {\n    type: \"confirm\",\n    cancel: \"reject\",\n    ...options,\n  })) as boolean;\n\nconst input = async (message: string, options?: TextOpts): Promise<string> => {\n  let result: string;\n  do {\n    result = (await consola.prompt(message, {\n      type: \"text\",\n      cancel: \"reject\",\n      ...options,\n    })) as string;\n    if (options?.required && !result) continue;\n    break;\n  } while (true);\n  return result;\n};\n\nconst select = <T extends string>(\n  message: string,\n  options: Array<{ label: string; value: T }>,\n): Promise<T> =>\n  consola.prompt(message, {\n    type: \"select\",\n    cancel: \"reject\",\n    options,\n  }) as Promise<T>;\n\nexport interface QQOfficialCliContext {\n  readonly cwd: string;\n  readonly logger?: typeof consola;\n}\n\nexport interface QQOfficialInstanceInput {\n  appId: string;\n  appSecret: string;\n  sandbox: boolean;\n  imageMode: \"markdown\" | \"media\";\n}\n\nexport interface QQOfficialCliConfig {\n  instances: QQOfficialInstanceInput[];\n}\n\nexport const run = async (\n  ctx: QQOfficialCliContext,\n): Promise<QQOfficialCliConfig> => {\n  const log = ctx.logger ?? consola;\n  log.info(\"正在配置 qq-official 适配器(AppID / AppSecret 见开放平台开发设置)\");\n  log.info(\"\");\n\n  const instances: QQOfficialInstanceInput[] = [];\n  let addMore = true;\n  while (addMore) {\n    const appId = await input(\"AppID\", { required: true });\n    const appSecret = await input(\"AppSecret\", { required: true });\n    const sandbox = await confirm(\"使用沙箱环境？\", { initial: false });\n    const imageMode = await select(\"图片发送方式\", [\n      {\n        label: \"markdown（单卡片，图片需公网可访问）\",\n        value: \"markdown\" as const,\n      },\n      { label: \"media（图文分离，base64 上传）\", value: \"media\" as const },\n    ]);\n\n    instances.push({ appId, appSecret, sandbox, imageMode });\n    addMore = await confirm(\"是否继续添加机器人实例？\", { initial: false });\n    if (addMore) log.info(\"\");\n  }\n\n  return { instances };\n};\n\nconst isRunningAsMain = (): boolean => {\n  if (!process.argv[1]) return false;\n  try {\n    return (\n      import.meta.url === pathToFileURL(fs.realpathSync(process.argv[1])).href\n    );\n  } catch {\n    return false;\n  }\n};\n\nif (isRunningAsMain()) {\n  void (async () => {\n    const cwd = process.cwd();\n    const pkgPath = path.join(cwd, \"package.json\");\n    if (!fs.existsSync(pkgPath)) {\n      consola.error(\"未找到 package.json，请在机器人项目根目录运行此向导\");\n      process.exit(1);\n    }\n    const config = await run({ cwd });\n    const pkg = JSON.parse(fs.readFileSync(pkgPath, \"utf-8\")) as {\n      mioku?: Record<string, unknown>;\n    };\n    pkg.mioku = pkg.mioku ?? {};\n    const adapters =\n      (pkg.mioku.adapters as Record<string, unknown> | undefined) ?? {};\n    pkg.mioku.adapters = { ...adapters, \"qq-official\": config };\n    fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\\n`, \"utf-8\");\n    consola.success(\"已写入 qq-official 适配器配置\");\n  })();\n}\n\nexport default run;\n"],"mappings":";;;;;;;AAeA,MAAM,UAAU,OACd,SACA,YAEC,MAAM,QAAQ,OAAO,SAAS;CAC7B,MAAM;CACN,QAAQ;CACR,GAAG;CACJ,CAAC;AAEJ,MAAM,QAAQ,OAAO,SAAiB,YAAwC;CAC5E,IAAIA;AACJ,IAAG;AACD,WAAU,MAAM,QAAQ,OAAO,SAAS;GACtC,MAAM;GACN,QAAQ;GACR,GAAG;GACJ,CAAC;AACF,MAAI,SAAS,YAAY,CAAC,OAAQ;AAClC;UACO;AACT,QAAO;;AAGT,MAAM,UACJ,SACA,YAEA,QAAQ,OAAO,SAAS;CACtB,MAAM;CACN,QAAQ;CACR;CACD,CAAC;AAkBJ,MAAa,MAAM,OACjB,QACiC;CACjC,MAAM,MAAM,IAAI,UAAU;AAC1B,KAAI,KAAK,oDAAoD;AAC7D,KAAI,KAAK,GAAG;CAEZ,MAAMC,YAAuC,EAAE;CAC/C,IAAI,UAAU;AACd,QAAO,SAAS;EACd,MAAM,QAAQ,MAAM,MAAM,SAAS,EAAE,UAAU,MAAM,CAAC;EACtD,MAAM,YAAY,MAAM,MAAM,aAAa,EAAE,UAAU,MAAM,CAAC;EAC9D,MAAM,UAAU,MAAM,QAAQ,WAAW,EAAE,SAAS,OAAO,CAAC;EAC5D,MAAM,YAAY,MAAM,OAAO,UAAU,CACvC;GACE,OAAO;GACP,OAAO;GACR,EACD;GAAE,OAAO;GAAyB,OAAO;GAAkB,CAC5D,CAAC;AAEF,YAAU,KAAK;GAAE;GAAO;GAAW;GAAS;GAAW,CAAC;AACxD,YAAU,MAAM,QAAQ,gBAAgB,EAAE,SAAS,OAAO,CAAC;AAC3D,MAAI,QAAS,KAAI,KAAK,GAAG;;AAG3B,QAAO,EAAE,WAAW;;AAGtB,MAAM,wBAAiC;AACrC,KAAI,CAAC,QAAQ,KAAK,GAAI,QAAO;AAC7B,KAAI;AACF,SACE,OAAO,KAAK,QAAQ,cAAc,GAAG,aAAa,QAAQ,KAAK,GAAG,CAAC,CAAC;SAEhE;AACN,SAAO;;;AAIX,IAAI,iBAAiB,CACnB,EAAM,YAAY;CAChB,MAAM,MAAM,QAAQ,KAAK;CACzB,MAAM,UAAU,KAAK,KAAK,KAAK,eAAe;AAC9C,KAAI,CAAC,GAAG,WAAW,QAAQ,EAAE;AAC3B,UAAQ,MAAM,mCAAmC;AACjD,UAAQ,KAAK,EAAE;;CAEjB,MAAM,SAAS,MAAM,IAAI,EAAE,KAAK,CAAC;CACjC,MAAM,MAAM,KAAK,MAAM,GAAG,aAAa,SAAS,QAAQ,CAAC;AAGzD,KAAI,QAAQ,IAAI,SAAS,EAAE;CAC3B,MAAM,WACH,IAAI,MAAM,YAAoD,EAAE;AACnE,KAAI,MAAM,WAAW;EAAE,GAAG;EAAU,eAAe;EAAQ;AAC3D,IAAG,cAAc,SAAS,GAAG,KAAK,UAAU,KAAK,MAAM,EAAE,CAAC,KAAK,QAAQ;AACvE,SAAQ,QAAQ,wBAAwB;IACtC;AAGN,kBAAe"}