@alemonjs/qq-bot 2.1.34 → 2.1.35

package/README.md

@@ -116,7 +116,7 @@ export default async () => {
 
 ### 流程
 
-1. 启动适配器（默认 WebSocket 模式），终端输出授权二维码与链接，并在**运行目录**保存二维码图片（`qqbot-login-qr.png`，二维码刷新时自动覆盖）；
+1. 启动适配器（默认 WebSocket 模式），通过 CBP 输出授权二维码与链接；二维码图片由 CBP/UI 统一处理；
 2. 使用**手机 QQ**（开放平台上该机器人的管理者账号）扫描二维码（终端直接扫，或打开保存的图片扫），并在页面中确认授权；
 3. 适配器自动轮询授权结果，平台下发的凭证在本地解密（AES-256-GCM，密钥不落盘）；
 4. `app_id` 与 `secret` 自动写入 `alemon.config.yaml` 的 `qq-bot` 节（保留文件中已有的注释与原格式），随后立即连接，无需重启。
@@ -134,7 +134,7 @@ export default async () => {
 | 事项     | 说明                                                                                             |
 | -------- | ------------------------------------------------------------------------------------------------ |
 | 触发条件 | 配置中未填写 `app_id`/`secret`，且未配置 `bots`（WebSocket 模式）                                |
-| 二维码   | 终端出码 + 图片保存到运行目录（`qqbot-login-qr.png`），过期自动刷新（最多 3 次），总超时 10 分钟 |
+| 二维码   | CBP 统一输出，过期自动刷新（最多 3 次），总超时 10 分钟 |
 | 凭证安全 | AppSecret 全程密文传输、本地解密，密钥仅存内存不落盘                                             |
 | 失败处理 | 超时 / 刷新次数用尽 / 授权取消时跳过连接并输出日志，可重启重试或手动配置                         |
 | Webhook  | Webhook 模式（配置 `route`/`port`/`ws`）不触发扫码流程，需自行填写完整配置                       |

package/lib/index.websoket.js

@@ -31,7 +31,7 @@ const bootstrap = async () => {
 	activeRegistry = registry;
 	if (!hasConfiguredCredentials()) {
 		logger.info("[qq-bot] 未检测到 app_id/secret 配置，进入扫码登录流程");
-		const result = await qrLogin({ onQRCode: (qrBuffer, url, _qrImagePath, loginId, refresh) => {
+		const result = await qrLogin({ onQRCode: (qrBuffer, url, loginId, refresh) => {
 			loginStatus = {
 				state: "awaiting_qrcode",
 				type: "qrcode",

package/lib/sdk/qr-auth.d.ts

@@ -35,14 +35,14 @@ type QRLoginOptions = {
   pollInterval?: number;
   /** 注入门户请求（测试用） */
   request?: PortalRequest;
-  /** 二维码生成回调（默认同时终端出码并保存图片到运行目录） */
-  onQRCode?: (qrBuffer: Buffer, url: string, qrImagePath: string | undefined, loginId: string, refresh: number) => void | Promise<void>;
+  /** 二维码生成回调；图片由回调方或 CBP 统一处理，不在适配器运行目录落盘 */
+  onQRCode?: (qrBuffer: Buffer, url: string, loginId: string, refresh: number) => void | Promise<void>;
   /** 状态变化回调 */
   onStatus?: (message: string) => void | Promise<void>;
 };
 /**
  * 扫码登录流程：
- * 创建绑定任务 → 终端出码并保存二维码图片到运行目录 → 轮询授权结果 → 解密 AppSecret。
+ * 创建绑定任务 → 生成二维码并通过回调交给 CBP/UI → 轮询授权结果 → 解密 AppSecret。
  * 成功返回 { appId, clientSecret, userOpenid }；超时/失败/刷新次数用尽返回 null
  */
 declare const qrLogin: (options?: QRLoginOptions) => Promise<QRLoginResult | null>;

package/lib/sdk/qr-auth.js

@@ -2,7 +2,7 @@ import { getConfig, logger } from "alemonjs";
 import axios from "axios";
 import { createDecipheriv, randomBytes } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { dirname } from "node:path";
 import QRCode from "qrcode";
 import YAML from "yaml";
 
@@ -51,7 +51,7 @@ const buildConnectUrl = (taskId) => {
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 /**
 * 扫码登录流程：
-* 创建绑定任务 → 终端出码并保存二维码图片到运行目录 → 轮询授权结果 → 解密 AppSecret。
+* 创建绑定任务 → 生成二维码并通过回调交给 CBP/UI → 轮询授权结果 → 解密 AppSecret。
 * 成功返回 { appId, clientSecret, userOpenid }；超时/失败/刷新次数用尽返回 null
 */
 const qrLogin = async (options = {}) => {
@@ -70,7 +70,6 @@ const qrLogin = async (options = {}) => {
 			return null;
 		}
 		const url = buildConnectUrl(taskId);
-		let qrImagePath = null;
 		let qrBuffer = null;
 		try {
 			qrBuffer = await QRCode.toBuffer(url, {
@@ -78,12 +77,10 @@ const qrLogin = async (options = {}) => {
 				width: 320,
 				margin: 2
 			});
-			qrImagePath = join(process.cwd(), "qqbot-login-qr.png");
-			writeFileSync(qrImagePath, qrBuffer);
 		} catch (err) {
-			logger.warn(`[qq-bot] 二维码图片保存失败：${err?.message ?? err}`);
+			logger.warn(`[qq-bot] 二维码生成失败：${err?.message ?? err}`);
 		}
-		if (qrBuffer && onQRCode) await onQRCode(qrBuffer, url, qrImagePath ?? void 0, taskId, refresh);
+		if (qrBuffer && onQRCode) await onQRCode(qrBuffer, url, taskId, refresh);
 		await onStatus?.("请使用手机 QQ 扫描二维码并确认授权");
 		logger.warn("[qq-bot] 注意：扫码授权完成后平台将重置机器人密钥，旧密钥会立即失效；若该机器人已在其他实例中运行，请更新其配置");
 		while (Date.now() < deadline) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alemonjs/qq-bot",
-  "version": "2.1.34",
+  "version": "2.1.35",
   "description": "QQ官方平台",
   "author": "lemonade",
   "license": "MIT",
@@ -97,5 +97,5 @@
     "type": "git",
     "url": "https://github.com/lemonade-lab/alemonjs.git"
   },
-  "gitHead": "8e6c0d91889ff7926fc7bc58ac8dc664c8f721ea"
-}
+  "gitHead": "c6aa5616afe091a37610dad22fbb2d2618d943b8"
+}

package/LICENSE

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2013-present, Yuxi (Evan) You
-
-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.