koishi-plugin-ll-mc 1.0.2 → 1.0.3

package/lib/index.js

@@ -54,6 +54,7 @@ const logger = new koishi_1.Logger("mc");
 // ===== 官方QQ平台 群名/群昵称 修复补丁 =====
 const nameCache = { channel: new Map(), member: new Map() };
 const NAME_CACHE_TTL = 60 * 60 * 1000; // 缓存 1 小时，避免官方接口限频
+const warnThrottle = new Map(); // key -> lastWarnTime
 function cacheGet(map, key) {
     const item = map.get(key);
     return item && Date.now() - item.t < NAME_CACHE_TTL ? item.v : undefined;
@@ -61,6 +62,15 @@ function cacheGet(map, key) {
 function cacheSet(map, key, value) {
     map.set(key, { v: value, t: Date.now() });
 }
+// 同类警告 10 分钟内只打一次，避免刷屏
+function throttledWarn(key, message) {
+    const now = Date.now();
+    const last = warnThrottle.get(key) || 0;
+    if (now - last < 10 * 60 * 1000)
+        return;
+    warnThrottle.set(key, now);
+    logger.warn(message);
+}
 async function resolveUsername(session, userId) {
     const author = session.author;
     if (author?.nick)
@@ -73,13 +83,15 @@ async function resolveUsername(session, userId) {
         return raw.member.nick;
     if (raw?.author?.username)
         return raw.author.username;
-    // 兜底：调用 getGuildMember（官方 adapter 已实现）
-    const guildId = session.guildId || session.channelId;
+    // 兜底：调用 getGuildMember（仅限群聊；私聊没有群，直接返回 userId）
+    const guildId = session.guildId;
+    if (!guildId || session.isDirect)
+        return userId;
     const key = `${guildId}:${userId}`;
     const cached = cacheGet(nameCache.member, key);
     if (cached)
         return cached;
-    if (guildId && typeof session.bot?.getGuildMember === "function") {
+    if (typeof session.bot?.getGuildMember === "function") {
         try {
             const member = await session.bot.getGuildMember(guildId, userId);
             const name = member?.name || member?.user?.name;
@@ -89,7 +101,7 @@ async function resolveUsername(session, userId) {
             }
         }
         catch (e) {
-            logger.warn(`[mc] 获取成员昵称失败 ${userId}:`, e);
+            throttledWarn(`member:${key}`, `[mc] 获取成员昵称失败 ${userId}: ${e?.message}（若为 11253 应用无接口访问权限，请到 QQ 开放平台申请"获取群成员信息"权限）`);
         }
     }
     return userId;
@@ -98,6 +110,9 @@ async function resolveChannelName(session) {
     if (session.event?.channel?.name)
         return session.event.channel.name; // OneBot 走这里
     const channelId = session.channelId;
+    // 私聊或没有群上下文：不调用群接口（官机 C2C 的 channelId 是用户 openid，不是群）
+    if (session.isDirect || !session.guildId)
+        return channelId;
     const cached = cacheGet(nameCache.channel, channelId);
     if (cached)
         return cached;
@@ -113,8 +128,8 @@ async function resolveChannelName(session) {
         catch { /* 官方QQ对群无效，继续走 getGuild */ }
     }
     // 官方QQ平台：群信息走 getGuild（内部 getGuildInfo 返回群名）
-    const guildId = session.guildId || channelId;
-    if (guildId && typeof bot?.getGuild === "function") {
+    const guildId = session.guildId;
+    if (typeof bot?.getGuild === "function") {
         try {
             const g = await bot.getGuild(guildId);
             if (g?.name) {
@@ -123,7 +138,7 @@ async function resolveChannelName(session) {
             }
         }
         catch (e) {
-            logger.warn(`[mc] 获取群名失败 ${guildId}:`, e);
+            throttledWarn(`guild:${guildId}`, `[mc] 获取群名失败 ${guildId}: ${e?.message}（若为 11253/11255，请到 QQ 开放平台申请"获取群信息"权限，或确认机器人仍在该群）`);
         }
     }
     return channelId;

package/package.json

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