koishi-plugin-ll-mc 1.0.6 → 1.0.7

package/lib/index.js

@@ -398,6 +398,12 @@ exports.Config = koishi_1.Schema.intersect([
             koishi_1.Schema.object({}),
         ]),
     ]),
+    // --- 群头像手动指定（官机没有群头像，只能手动填） ---
+    koishi_1.Schema.object({
+        groupAvatarMap: koishi_1.Schema.dict(String)
+            .default({})
+            .description('群头像手动指定（键=群ID，官机填群openid，OneBot 填数字群号；值=头像图片URL，或直接填数字QQ群号自动生成头像链接）。官机平台不提供群头像接口，只能手动填才能显示真头像。'),
+    }).description("群头像手动指定"),
 ]);
 const periodMapping = {
     today: { field: "todayPostCount", name: "今日" },
@@ -487,6 +493,8 @@ async function apply(ctx, config) {
         await reloadIconCache();
         await reloadBarBgImgCache();
         await reloadFontCache();
+        // 预热 OneBot 群列表（用于官机群头像按群名匹配）
+        refreshNapCatGuildMap();
         // 执行非破坏性的状态初始化
         await initializeResetStates();
         // 安全地检查并弥补真正错过的重置任务
@@ -1958,31 +1966,84 @@ async function apply(ctx, config) {
                 (channelInfo[channelId]?.channelName || `群聊${channelId}`),
             // 使用 channelId 作为 RankingData 的 userId 和头像源
             userId: channelId,
-            avatar: groupAvatarUrl(channelId),
+            avatar: groupAvatarUrl(channelId, channelInfo[channelId]?.channelName),
             count,
             percentage: calculatePercentage(count, totalCount),
         }));
     }
     /**
-     * 群头像 URL：
-     * - "#"：占位群号
-     * - 数字群号（OneBot/NapCat）：p.qlogo.cn/gh/{群号}
-     * - 官机 openid（32位十六进制）：官方 API 不提供群头像，尝试与成员头像同源的 qqapp 端点；
-     *   若无效，下载失败会走内置默认头像兜底
+     * 群头像 URL 解析链：
+     * 1. 配置手动指定 groupAvatarMap（键=群ID，值=URL 或数字群号）
+     * 2. 数字群号（OneBot/NapCat）→ p.qlogo.cn/gh/{群号}
+     * 3. 官机 openid → 按群名从 NapCat 群列表匹配数字群号（两个机器人在同一群时自动生效）
+     * 4. 官机 qqapp 端点尝试（与成员头像同源，多数情况对群无效）
+     * 5. 默认占位头像（下载失败也会走内置兜底）
      */
-    function groupAvatarUrl(channelId) {
-        if (channelId === "#" || !channelId) {
+    function groupAvatarUrl(channelId, channelName) {
+        if (!channelId || channelId === "#") {
             return `https://p.qlogo.cn/gh/426230045/426230045/100`;
         }
+        // 1. 手动指定
+        const manual = config.groupAvatarMap?.[channelId];
+        if (manual) {
+            return /^\d+$/.test(manual)
+                ? `https://p.qlogo.cn/gh/${manual}/${manual}/100`
+                : manual;
+        }
+        // 2. 数字群号（OneBot）
         if (/^\d+$/.test(channelId)) {
             return `https://p.qlogo.cn/gh/${channelId}/${channelId}/100`;
         }
+        // 3. 官机 openid：按群名匹配 NapCat 数字群号
+        if (channelName) {
+            refreshNapCatGuildMap();
+            const numeric = napCatGuildIdByName.get(channelName);
+            if (numeric) {
+                return `https://p.qlogo.cn/gh/${numeric}/${numeric}/100`;
+            }
+        }
+        // 4. 官机 qqapp 端点尝试
         const qqBot = (ctx.bots || []).find(b => b.platform === "qq" && b.config?.id);
         if (qqBot?.config?.id) {
             return `https://q.qlogo.cn/qqapp/${qqBot.config.id}/${channelId}/640`;
         }
+        // 5. 默认占位
         return `https://p.qlogo.cn/gh/426230045/426230045/100`;
     }
+    // NapCat/OneBot 群列表缓存：群名 -> 数字群号（用于官机群按名匹配头像）
+    const napCatGuildIdByName = new Map();
+    let napCatMapTask = null;
+    function refreshNapCatGuildMap() {
+        if (napCatMapTask) return;
+        napCatMapTask = (async () => {
+            try {
+                const found = [];
+                for (const bot of ctx.bots || []) {
+                    if (bot.platform === "qq") continue;
+                    if (typeof bot.getGuildList !== "function") continue;
+                    const list = await bot.getGuildList();
+                    for (const g of list?.data || []) {
+                        if (g?.name && g?.id) {
+                            found.push([g.name, g.id]);
+                        }
+                    }
+                }
+                if (found.length) {
+                    for (const [name, id] of found) {
+                        napCatGuildIdByName.set(name, id);
+                    }
+                    if (config.verbose) logger.info(`[mc] 已缓存 ${found.length} 个 OneBot 群（用于官机群头像匹配）`);
+                }
+            }
+            catch (e) {
+                logger.warn(`[mc] 获取 OneBot 群列表失败: ${e?.message}`);
+            }
+            finally {
+                // 10 分钟后允许重新刷新
+                setTimeout(() => { napCatMapTask = null; }, 10 * 60 * 1000);
+            }
+        })();
+    }
     // --- 辅助函数：图表生成 ---
     /**
      * 生成图表的静态 CSS 样式。

package/package.json

@@ -1,7 +1,7 @@
 {
     "name":  "koishi-plugin-ll-mc",
     "description":  "消息统计插件（克隆自 message-counter），支持排除指定群聊",
-    "version":  "1.0.6",
+    "version":  "1.0.7",
     "main":  "lib/index.js",
     "typings":  "lib/index.d.ts",
     "files":  [