koishi-plugin-group-analysis-mx 1.0.16 → 1.0.17

package/lib/service/analysis.js

@@ -193,18 +193,18 @@ class AnalysisService extends koishi_1.Service {
                 if (bot.platform === 'onebot') {
                     userGroupInfo = await bot.internal.getGroupMemberInfo(group.guildId, record.userId, true);
                 }
-                else {
+                else if (bot?.getGuildMember) {
                     userGroupInfo = await bot.getGuildMember(group.channelId || group.guildId, record.userId);
                 }
-                if (userGroupInfo == null) {
-                    continue;
-                }
             }
             catch (error) {
-                this.ctx.logger.warn(`获取用户 ${record.userId} 的群组信息失败 (${group.channelId || group.guildId})，可能是未加入该群聊。将跳过此群组的信息获取。`, error);
-                continue;
+                // 官方 QQ 机器人等平台可能没有获取群成员信息的权限，
+                // 不中断画像分析，仅跳过角色信息（roles 保持为空）。
+                this.ctx.logger.debug(`获取用户 ${record.userId} 的群组信息失败 (${group.channelId || group.guildId})，将跳过角色信息: ${error}`);
+            }
+            if (userGroupInfo) {
+                record.roles = (userGroupInfo.roles || []).map((r) => (typeof r === 'string' ? r : r.name || r.id || ''));
             }
-            record.roles = (userGroupInfo.roles || []).map((r) => (typeof r === 'string' ? r : r.name || r.id || ''));
             const history = await this.ctx.group_analysis_message.getHistoricalMessages({
                 guildId: group.guildId,
                 channelId: group.channelId,
@@ -614,13 +614,14 @@ class AnalysisService extends koishi_1.Service {
                 user = await bot.getGuildMember(session.channelId || session.guildId, userId);
             }
             catch (error) {
-                this.ctx.logger.warn(`获取用户 ${userId} 信息失败: ${error}`);
+                // 官方 QQ 机器人等平台可能没有获取群成员信息的权限，回退到本地记录
+                this.ctx.logger.debug(`获取用户 ${userId} 的成员信息失败，将回退到本地记录: ${error}`);
             }
             const cache = await this.ensurePersonaCache(recordId, {
                 platform: session.platform,
                 selfId: session.selfId,
                 userId,
-                username: user?.nick || user?.name || userId
+                username: user?.nick || user?.name || user?.user?.name || userId
             });
             let displayName = cache.record.username;
             const cacheExpired = (0, utils_1.isCacheExpiredByDays)(cache.record.lastAnalysisAt, this.config.personaCacheLifetimeDays);
@@ -648,17 +649,36 @@ class AnalysisService extends koishi_1.Service {
             }
             const profile = cache.parsedPersona;
             if (user) {
-                avatar = user.avatar;
+                // Koishi Universal.GuildMember 结构：{ user: { id, name, avatar }, name, ... }
+                avatar = user.avatar || user.user?.avatar;
                 const resolvedName = user.nick ||
-                    user.name;
+                    user.name ||
+                    user.user?.name;
                 if (resolvedName) {
                     displayName = resolvedName;
                     cache.record.username = resolvedName;
                 }
             }
+            // 平台化头像解析：onebot 走 QQ 号接口，官方 QQ 机器人走 openid 模板
             if (session.platform === 'onebot') {
                 avatar = (0, utils_1.getAvatarUrl)(userId);
             }
+            else if (!avatar) {
+                avatar = (0, utils_1.resolveUserAvatar)(bot, userId);
+            }
+            // 昵称/头像兜底：从数据库已记录的消息中回退用户资料
+            if (!displayName || displayName === userId || !avatar) {
+                const fallback = await this.lookupUserProfileFromMessages(session.platform, session.selfId, userId);
+                if (fallback) {
+                    if ((!displayName || displayName === userId) && fallback.username) {
+                        displayName = fallback.username;
+                        cache.record.username = fallback.username;
+                    }
+                    if (!avatar && fallback.avatarUrl) {
+                        avatar = fallback.avatarUrl;
+                    }
+                }
+            }
             profile.analysisDate = cache.record.lastAnalysisAt.toLocaleString();
             const image = await this.ctx.group_analysis_renderer.renderUserPersona(profile, displayName, avatar, this.config);
             message =
@@ -673,6 +693,27 @@ class AnalysisService extends koishi_1.Service {
         }
         await session.send(message);
     }
+    async lookupUserProfileFromMessages(platform, selfId, userId) {
+        try {
+            const records = await this.ctx.database
+                .select('group_analysis_messages')
+                .where({ platform, selfId, userId })
+                .orderBy(($) => $.timestamp, 'desc')
+                .limit(1)
+                .execute();
+            const latest = records[0];
+            if (!latest)
+                return null;
+            return {
+                username: latest.username || null,
+                avatarUrl: latest.avatarUrl || null
+            };
+        }
+        catch (error) {
+            this.ctx.logger.debug(`从消息记录回退用户资料失败 (${platform}/${userId}): ${error}`);
+            return null;
+        }
+    }
     async analyzeGroupMessages(messages, selfId, target, context) {
         this.ctx.logger.info(`开始分析 ${messages.length} 条消息...`);
         const { userStats, totalChars, totalEmojiCount, allMessagesText } = (0, utils_1.calculateBasicStats)(messages);

package/lib/utils.js

@@ -4,6 +4,7 @@ exports.calculateBasicStats = calculateBasicStats;
 exports.buildPersonaRecordId = buildPersonaRecordId;
 exports.generateTextReport = generateTextReport;
 exports.getAvatarUrl = getAvatarUrl;
+exports.resolveUserAvatar = resolveUserAvatar;
 exports.formatUserStats = formatUserStats;
 exports.formatGoldenQuotes = formatGoldenQuotes;
 exports.formatUserTitles = formatUserTitles;
@@ -154,6 +155,27 @@ function generateTextReport(result) {
 function getAvatarUrl(userId) {
     return `http://q1.qlogo.cn/g?b=qq&nk=${userId}&s=640`;
 }
+/**
+ * 按平台解析用户头像 URL。
+ * - onebot: 使用 QQ 号头像接口（q1.qlogo.cn）
+ * - qq（官方 QQ 机器人）: 使用 openid 头像模板 q.qlogo.cn/qqapp/{appid}/{openid}/640
+ * - 其他平台: 返回 null，由调用方回退到事件头像或默认头像
+ */
+function resolveUserAvatar(bot, userId) {
+    if (!bot || !userId)
+        return null;
+    if (bot.platform === 'onebot') {
+        return getAvatarUrl(userId);
+    }
+    if (bot.platform === 'qq') {
+        const appid = bot.config?.id;
+        if (appid) {
+            return `https://q.qlogo.cn/qqapp/${appid}/${userId}/640`;
+        }
+        return null;
+    }
+    return null;
+}
 function formatUserStats(userStats, skin = 'md3') {
     const renderer = skins_1.skinRegistry.getSafe(skin);
     return renderer.formatUserStats(userStats);

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "koishi-plugin-group-analysis-mx",
     "description": "群聊分析插件 - 生成精美群聊统计报告，支持 AI 话题总结（独立版，不依赖 ChatLuna）",
-    "version": "1.0.16",
+    "version": "1.0.17",
     "main": "lib/index.js",
     "module": "lib/index.mjs",
     "typings": "lib/index.d.ts",