@karinjs/adapter-qqbot 3.3.0 → 3.3.1

package/dist/index.d.ts

@@ -2291,6 +2291,10 @@ declare class AdapterQQBot extends AdapterBase implements AdapterType {
   }>;
   /**
    * 获取头像 url
+   *
+   * 第三方头像 CDN 的模式是 `qqapp/{appId}/{openid}/{size}`，只有拼用户 openid 才有效；
+   * 机器人自身没有可用的 openid（selfId 就是 appId，拼出 appId/appid 只会得到默认头像），
+   * 因此目标是自己时改走官方 `GET /users/@me` 返回的 avatar 字段，取值与缓存见 self-avatar。
    */
   getAvatarUrl(_userId: string, _size?: 0 | 40 | 100 | 140): Promise<string>;
   /**

package/dist/index.js

@@ -3457,6 +3457,34 @@ const getAdapterConfig = (bot) => {
 	return cfg;
 };
 
+//#endregion
+//#region src/core/adapter/self-avatar.ts
+/**
+* 机器人自身头像的在途请求存储。
+*
+* 机器人没有可拼进 qlogo CDN 的自身 openid（selfId 就是 appId），只能走官方
+* `GET /users/@me` 取 avatar。在途请求挂在 WeakMap 而不是实例字段上，保持
+* AdapterQQBot 只包含 AdapterType 约束的成员；bot 重建后旧实例随之释放。
+*/
+const pending = /* @__PURE__ */ new WeakMap();
+/**
+* 获取机器人自身的真实头像，并发调用只请求一次，失败后释放以便下次重试。
+* @param bot 适配器实例。
+* @returns `/users/@me` 的 avatar，拉取失败时退回 qlogo 拼接模式（默认头像）。
+*/
+const selfAvatarUrl = (bot) => {
+	const existed = pending.get(bot);
+	if (existed) return existed;
+	const fallback = `https://thirdqq.qlogo.cn/qqapp/${bot.cfg.appId}/${bot.selfId}/0`;
+	const task = bot.super.meta.getMe().then((me) => me.avatar || fallback).catch((err) => {
+		bot.logger("warn", `[getAvatarUrl] 获取机器人自身头像失败，退回默认拼接: ${err instanceof Error ? err.message : err}`);
+		pending.delete(bot);
+		return fallback;
+	});
+	pending.set(bot, task);
+	return task;
+};
+
 //#endregion
 //#region src/core/adapter/base.ts
 /**
@@ -3683,8 +3711,13 @@ var AdapterQQBot = class extends AdapterBase {
 	}
 	/**
 	* 获取头像 url
+	*
+	* 第三方头像 CDN 的模式是 `qqapp/{appId}/{openid}/{size}`，只有拼用户 openid 才有效；
+	* 机器人自身没有可用的 openid（selfId 就是 appId，拼出 appId/appid 只会得到默认头像），
+	* 因此目标是自己时改走官方 `GET /users/@me` 返回的 avatar 字段，取值与缓存见 self-avatar。
 	*/
 	async getAvatarUrl(_userId, _size = 0) {
+		if (_userId && (_userId === this.selfId || _userId === this.selfSubId("id"))) return selfAvatarUrl(this);
 		return `https://thirdqq.qlogo.cn/qqapp/${this.cfg.appId}/${_userId}/${_size}`;
 	}
 	/**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karinjs/adapter-qqbot",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "description": "karin adapter for QQ Official Bot (2.0)",
   "homepage": "https://github.com/KarinJS/karin-plugin-adapter-qqbot",
   "bugs": {