koishi-plugin-kkk 1.0.0

package/lib/karin/apps/push.js

@@ -0,0 +1,291 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalIgnore = exports.changeBotID = exports.douyinPushList = exports.bilibiliPushList = exports.setbiliPush = exports.setdyPush = exports.forcePush = exports.bilibiliPush = exports.douyinPush = void 0;
+const node_karin_1 = __importStar(require("../../compat/node-karin.js"));
+const db_1 = require("../module/db");
+const amagiClient_1 = require("../module/utils/amagiClient");
+const Config_1 = require("../module/utils/Config");
+const ErrorHandler_1 = require("../module/utils/ErrorHandler");
+const platform_1 = require("../platform");
+// 包装抖音推送任务
+const handleDouyinPush = (0, ErrorHandler_1.wrapWithErrorHandler)(async () => {
+    await new platform_1.DouYinpush().action();
+    return true;
+}, {
+    businessName: '抖音推送任务'
+});
+// 包装B站推送任务
+const handleBilibiliPush = (0, ErrorHandler_1.wrapWithErrorHandler)(async () => {
+    await new platform_1.Bilibilipush().action();
+    return true;
+}, {
+    businessName: 'B站推送任务'
+});
+// 包装强制推送命令
+const handleForcePush = (0, ErrorHandler_1.wrapWithErrorHandler)(async (e) => {
+    if (e.msg.includes('抖音')) {
+        await new platform_1.DouYinpush().action();
+        return true;
+    }
+    else if (e.msg.includes('B站')) {
+        await new platform_1.Bilibilipush().action();
+        return true;
+    }
+    return true;
+}, {
+    businessName: '强制推送'
+});
+// 包装设置抖音推送命令
+const handleSetDouyinPush = (0, ErrorHandler_1.wrapWithErrorHandler)(async (e) => {
+    const query = e.msg.replace(/^#设置抖音推送/, '').trim();
+    // 检查是否是开启/关闭命令
+    if (query === '开启' || query === '关闭') {
+        const enable = query === '开启';
+        Config_1.Config.Modify('douyin', 'push.switch', enable);
+        await e.reply(`抖音推送已${enable ? '开启' : '关闭'}，${enable ? '需要重启后生效' : '将在下次重启后停止推送'}`);
+        node_karin_1.logger.info(`抖音推送已${enable ? '开启' : '关闭'}`);
+        return true;
+    }
+    // 原有的订阅逻辑
+    const data = await amagiClient_1.douyinFetcher.searchContent({
+        query,
+        type: 'user'
+    });
+    await new platform_1.DouYinpush(e).setting(data.data);
+    return true;
+}, {
+    businessName: '设置抖音推送'
+});
+// 包装设置B站推送命令
+const handleSetBilibiliPush = (0, ErrorHandler_1.wrapWithErrorHandler)(async (e) => {
+    const query = e.msg
+        .replace(/^#设置[bB]站推送/, '')
+        .replace(/^(?:[Uu][Ii][Dd]:)?/, '')
+        .trim();
+    // 检查是否是开启/关闭命令
+    if (query === '开启' || query === '关闭') {
+        const enable = query === '开启';
+        Config_1.Config.Modify('bilibili', 'push.switch', enable);
+        await e.reply(`B站推送已${enable ? '开启' : '关闭'}，${enable ? '需要重启后生效' : '将在下次重启后停止推送'}`);
+        node_karin_1.logger.info(`B站推送已${enable ? '开启' : '关闭'}`);
+        return true;
+    }
+    // 原有的订阅逻辑
+    if (!Config_1.Config.amagi.cookies.bilibili) {
+        await e.reply('\n请先配置B站Cookie', { at: true });
+        return true;
+    }
+    const match = /^(\d+)$/.exec(query);
+    if (match && match[1]) {
+        const data = await amagiClient_1.bilibiliFetcher.fetchUserCard({
+            host_mid: Number(match[1])
+        });
+        await new platform_1.Bilibilipush(e).setting(data.data);
+    }
+    return true;
+}, {
+    businessName: '设置B站推送'
+});
+// 包装推送列表命令
+const handleBilibiliPushList = (0, ErrorHandler_1.wrapWithErrorHandler)(async (e) => {
+    await new platform_1.Bilibilipush(e).renderPushList();
+}, {
+    businessName: 'B站推送列表'
+});
+const handleDouyinPushList = (0, ErrorHandler_1.wrapWithErrorHandler)(async (e) => {
+    await new platform_1.DouYinpush(e).renderPushList();
+}, {
+    businessName: '抖音推送列表'
+});
+// 包装设置机器人ID命令
+const handleChangeBotID = (0, ErrorHandler_1.wrapWithErrorHandler)(async (e) => {
+    const newBotId = e.msg.replace(/^#kkk设置推送机器人/, '');
+    // 更新抖音配置和数据库
+    const newDouyinlist = Config_1.Config.pushlist.douyin.map((item) => {
+        const modifiedGroupIds = item.group_id.map((groupId) => {
+            const [group_id, oldBotId] = groupId.split(':');
+            // 更新数据库中的botId
+            if (oldBotId && oldBotId !== newBotId) {
+                db_1.douyinDB.updateGroupBotId(group_id, oldBotId, newBotId).catch((err) => {
+                    node_karin_1.logger.error(`Failed to update douyin group ${group_id}:`, err);
+                });
+            }
+            return `${group_id}:${newBotId}`;
+        });
+        return {
+            ...item,
+            group_id: modifiedGroupIds
+        };
+    });
+    // 更新B站配置和数据库
+    const newBilibililist = Config_1.Config.pushlist.bilibili.map((item) => {
+        const modifiedGroupIds = item.group_id.map((groupId) => {
+            const [group_id, oldBotId] = groupId.split(':');
+            // 更新数据库中的botId
+            if (oldBotId && oldBotId !== newBotId) {
+                db_1.bilibiliDB.updateGroupBotId(group_id, oldBotId, newBotId).catch((err) => {
+                    node_karin_1.logger.error(`Failed to update bilibili group ${group_id}:`, err);
+                });
+            }
+            return `${group_id}:${newBotId}`;
+        });
+        return {
+            ...item,
+            group_id: modifiedGroupIds
+        };
+    });
+    Config_1.Config.Modify('pushlist', 'douyin', newDouyinlist);
+    Config_1.Config.Modify('pushlist', 'bilibili', newBilibililist);
+    await e.reply('推送机器人已修改为' + newBotId);
+    return true;
+}, {
+    businessName: '设置推送机器人'
+});
+// 包装全局忽略命令
+const handleGlobalIgnore = (0, ErrorHandler_1.wrapWithErrorHandler)(async (e) => {
+    const url = e.msg.replace(/^#kkk推送全局忽略/, '').trim();
+    if (!url) {
+        await e.reply('请提供链接');
+        return true;
+    }
+    // 判断平台
+    const isDouyin = /(douyin|iesdouyin)\.com/.test(url);
+    const isBilibili = /bilibili\.com/.test(url);
+    if (!isDouyin && !isBilibili) {
+        await e.reply('暂不支持该平台链接');
+        return true;
+    }
+    if (isDouyin) {
+        const idData = await (0, platform_1.getDouyinID)(e, url, false);
+        if (!idData.aweme_id) {
+            await e.reply('无法解析该抖音链接');
+            return true;
+        }
+        // 获取作品详情以获取 sec_uid
+        const workInfo = await amagiClient_1.douyinFetcher.parseWork({ aweme_id: idData.aweme_id });
+        const sec_uid = workInfo.data?.aweme_detail?.author?.sec_uid;
+        if (!sec_uid) {
+            await e.reply('无法获取该作品作者信息');
+            return true;
+        }
+        // 检查该作者是否在订阅配置中
+        const subscribedItem = Config_1.Config.pushlist.douyin?.find((item) => item.sec_uid === sec_uid);
+        if (!subscribedItem) {
+            await e.reply('该作品对应的博主未在推送订阅中，跳过');
+            return true;
+        }
+        // 获取所有订阅该作者的群组
+        const groupIds = subscribedItem.group_id.map((g) => g.split(':')[0]);
+        // 将作品缓存写入所有订阅群组
+        for (const groupId of groupIds) {
+            await db_1.douyinDB.addAwemeCache(idData.aweme_id, sec_uid, groupId, 'post');
+        }
+        await e.reply(`已忽略抖音作品 ${idData.aweme_id}，共 ${groupIds.length} 个群组的推送标记为已处理`);
+        node_karin_1.logger.info(`全局忽略抖音作品 ${idData.aweme_id}，博主 sec_uid: ${sec_uid}`);
+        return true;
+    }
+    if (isBilibili) {
+        const idData = await (0, platform_1.getBilibiliID)(url);
+        if (!idData.dynamic_id) {
+            await e.reply('无法解析该B站链接或该链接不是动态链接');
+            return true;
+        }
+        // 获取动态详情以获取 host_mid
+        const dynamicInfo = await amagiClient_1.bilibiliFetcher.fetchDynamicDetail({
+            dynamic_id: idData.dynamic_id
+        });
+        const host_mid = dynamicInfo.data.data.item.modules.module_author.mid;
+        if (!host_mid) {
+            await e.reply('无法获取该动态作者信息');
+            return true;
+        }
+        // 检查该UP主是否在订阅配置中
+        const subscribedItem = Config_1.Config.pushlist.bilibili?.find((item) => item.host_mid === Number(host_mid));
+        if (!subscribedItem) {
+            await e.reply('该动态对应的UP主未在推送订阅中，跳过');
+            return true;
+        }
+        // 获取所有订阅该UP主的群组
+        const groupIds = subscribedItem.group_id.map((g) => g.split(':')[0]);
+        const dynamicType = dynamicInfo.data?.data?.card?.desc?.type ?? 'DYNAMIC_TYPE_WORD';
+        // 将动态缓存写入所有订阅群组
+        for (const groupId of groupIds) {
+            await db_1.bilibiliDB.addDynamicCache(idData.dynamic_id, Number(host_mid), groupId, String(dynamicType));
+        }
+        await e.reply(`已忽略B站动态 ${idData.dynamic_id}，共 ${groupIds.length} 个群组的推送标记为已处理`);
+        node_karin_1.logger.info(`全局忽略B站动态 ${idData.dynamic_id}，UP主 host_mid: ${host_mid}`);
+        return true;
+    }
+    return true;
+}, {
+    businessName: '推送全局忽略'
+});
+// 注册任务和命令
+exports.douyinPush = Config_1.Config.douyin.push.switch && node_karin_1.default.task('抖音推送', Config_1.Config.douyin.push.cron, handleDouyinPush, { log: true, type: 'skip' });
+exports.bilibiliPush = Config_1.Config.bilibili.push.switch && node_karin_1.default.task('B站推送', Config_1.Config.bilibili.push.cron, handleBilibiliPush, { log: true, type: 'skip' });
+exports.forcePush = node_karin_1.default.command(/#(抖音|B站)(全部)?强制推送/, handleForcePush, {
+    name: '𝑪𝒊𝒂𝒍𝒍𝒐～(∠・ω< )⌒★',
+    perm: 'master',
+    event: 'message.group'
+});
+exports.setdyPush = node_karin_1.default.command(/^#设置抖音推送/, handleSetDouyinPush, {
+    name: 'kkk-推送功能-设置',
+    event: 'message.group',
+    perm: Config_1.Config.douyin.push.permission
+});
+exports.setbiliPush = node_karin_1.default.command(/^#设置[bB]站推送/, handleSetBilibiliPush, {
+    name: 'kkk-推送功能-设置',
+    event: 'message.group',
+    perm: Config_1.Config.bilibili.push.permission
+});
+exports.bilibiliPushList = node_karin_1.default.command(/^#?[bB]站推送列表$/, handleBilibiliPushList, {
+    name: 'kkk-推送功能-列表',
+    event: 'message.group'
+});
+exports.douyinPushList = node_karin_1.default.command(/^#?抖音推送列表$/, handleDouyinPushList, {
+    name: 'kkk-推送功能-列表',
+    event: 'message.group'
+});
+exports.changeBotID = node_karin_1.default.command(/^#kkk设置推送机器人/, handleChangeBotID, {
+    name: 'kkk-推送功能-设置',
+    perm: 'master'
+});
+exports.globalIgnore = node_karin_1.default.command(/^#kkk推送全局忽略/, handleGlobalIgnore, {
+    name: 'kkk-推送功能-全局忽略',
+    perm: 'master',
+    event: 'message.group',
+    priority: 1
+});

package/lib/karin/apps/qrlogin.js

@@ -0,0 +1,176 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.qrLogin = void 0;
+const node_os_1 = __importDefault(require("node:os"));
+const node_karin_1 = __importStar(require("../../compat/node-karin.js"));
+const bot_1 = require("../module/utils/bot");
+const Config_1 = require("../module/utils/Config");
+const ErrorHandler_1 = require("../module/utils/ErrorHandler");
+const Render_1 = require("../module/utils/Render");
+/**
+ * 获取本机局域网 IP 地址
+ * 优先返回常见局域网网段的 IP（192.168.x.x, 10.x.x.x, 172.16-31.x.x）
+ */
+function getLocalIP() {
+    const interfaces = node_os_1.default.networkInterfaces();
+    const candidates = [];
+    for (const name of Object.keys(interfaces)) {
+        const netInterface = interfaces[name];
+        if (!netInterface)
+            continue;
+        for (const net of netInterface) {
+            if (net.family === 'IPv4' && !net.internal) {
+                candidates.push(net.address);
+            }
+        }
+    }
+    // 优先选择常见局域网网段
+    const preferredIP = candidates.find((ip) => {
+        // 192.168.x.x
+        if (ip.startsWith('192.168.'))
+            return true;
+        // 10.x.x.x
+        if (ip.startsWith('10.'))
+            return true;
+        // 172.16.x.x - 172.31.x.x
+        if (ip.startsWith('172.')) {
+            const second = parseInt(ip.split('.')[1], 10);
+            if (second >= 16 && second <= 31)
+                return true;
+        }
+        return false;
+    });
+    return preferredIP || candidates[0] || '127.0.0.1';
+}
+/**
+ * 获取公网 IP 地址
+ * 通过多个公共 API 尝试获取
+ */
+async function getPublicIP() {
+    const apis = ['4.ipw.cn', 'https://api.ipify.org', 'https://icanhazip.com', 'https://ifconfig.me/ip', 'https://api.ip.sb/ip'];
+    for (const api of apis) {
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 5000);
+            const response = await fetch(api, { signal: controller.signal });
+            clearTimeout(timeout);
+            if (response.ok) {
+                const ip = (await response.text()).trim();
+                // 验证是否为有效的 IPv4 地址
+                if (/^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(ip)) {
+                    return ip;
+                }
+            }
+        }
+        catch {
+            // 继续尝试下一个 API
+        }
+    }
+    return null;
+}
+/**
+ * 根据配置获取服务器地址
+ */
+async function getHostByConfig() {
+    const addrType = Config_1.Config.app.qrLoginAddrType || 'lan';
+    if (addrType === 'external') {
+        const externalAddr = Config_1.Config.app.qrLoginExternalAddr;
+        if (externalAddr && externalAddr.trim()) {
+            return externalAddr.trim();
+        }
+        // 如果配置了外部地址但未填写，尝试自动获取公网 IP
+        node_karin_1.logger.debug('[APP扫码登录] 未配置外部地址，正在尝试获取公网 IP...');
+        const publicIP = await getPublicIP();
+        if (publicIP) {
+            node_karin_1.logger.debug(`[APP扫码登录] 获取到公网 IP: ${publicIP}`);
+            return publicIP;
+        }
+        node_karin_1.logger.warn('[APP扫码登录] 无法获取公网 IP，回退到局域网 IP');
+        return getLocalIP();
+    }
+    return getLocalIP();
+}
+/**
+ * 生成登录二维码（仅私发给主人）
+ */
+const handleQrLogin = (0, ErrorHandler_1.wrapWithErrorHandler)(async (e) => {
+    const bot = node_karin_1.default.getBot(e.selfId);
+    const userId = e.userId;
+    // 先检查好友关系，避免渲染后无法发送浪费资源
+    if (e.isGroup) {
+        const friendList = await bot?.getFriendList();
+        const isFriend = friendList?.some((f) => f.userId === userId);
+        if (!isFriend) {
+            await e.reply('请先添加 Bot 为好友后再试');
+            return true;
+        }
+    }
+    const port = process.env.HTTP_PORT || '7777';
+    const authKey = process.env.HTTP_AUTH_KEY || '';
+    const host = await getHostByConfig();
+    const protocol = 'http';
+    if (!authKey) {
+        await e.reply('未配置 HTTP_AUTH_KEY 环境变量，无法生成登录二维码');
+        return true;
+    }
+    // 构建二维码数据（JSON 格式，包含服务器信息）
+    const qrData = JSON.stringify({
+        protocol,
+        host,
+        port,
+        authKey
+    });
+    const serverUrl = `${protocol}://${host}:${port}`;
+    // 使用模板系统渲染二维码图片
+    const images = await (0, Render_1.Render)(e, 'other/qrlogin', {
+        share_url: qrData,
+        serverUrl,
+        avatarUrl: await (0, bot_1.resolveTriggerAvatarUrl)(e)
+    });
+    // 私发给触发命令的用户
+    await node_karin_1.default.sendMaster(e.selfId, userId, images);
+    // 如果是群聊触发，提示已私发
+    if (e.isGroup) {
+        await e.reply('登录二维码已私聊发送，请查收~');
+    }
+    return true;
+}, {
+    businessName: 'APP扫码登录'
+});
+exports.qrLogin = node_karin_1.default.command(/^#?(kkk)?登录$/i, handleQrLogin, { perm: 'master', name: 'kkk-APP扫码登录' });

package/lib/karin/apps/statistics.js

@@ -0,0 +1,209 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalStatistics = exports.groupStatistics = void 0;
+const date_fns_1 = require("date-fns");
+const node_karin_1 = __importStar(require("../../compat/node-karin.js"));
+const module_1 = require("../module");
+const db_1 = require("../module/db");
+const avatar_1 = require("../module/utils/avatar");
+const ErrorHandler_1 = require("../module/utils/ErrorHandler");
+const statisticsAggregate_1 = require("../module/utils/statisticsAggregate");
+/** 向 bot 索取头像时用的尺寸档；接口只接受 0/40/100/140 四档 */
+const AVATAR_FETCH_SIZE = 100;
+/**
+ * 向 bot 要头像 URL。
+ *
+ * 适配器拿不到头像是常态（QQBot 有概率取不到群头像），失败或返回空串都统一返回 undefined，
+ * 交给 `resolveAvatar` 回落到现场生成的 dither 头像。
+ * @param get 真正发起请求的闭包
+ */
+const getAvatarUrl = async (get) => {
+    try {
+        return (await get()) || undefined;
+    }
+    catch (error) {
+        node_karin_1.logger.debug('[统计] 获取头像地址失败，将使用生成头像:', error);
+        return undefined;
+    }
+};
+/**
+ * 两个统计命令。
+ *
+ * 这里只负责「取数 → 聚合 → 补 bot 侧信息 → 渲染」，
+ * 具体的行 → 图表数据变换全在 `@/module/utils/statisticsAggregate` 里（纯函数，可单测）。
+ */
+/**
+ * #kkk解析统计 命令
+ * 获取当前群的解析统计数据
+ */
+const handleGroupStatistics = (0, ErrorHandler_1.wrapWithErrorHandler)(async (e) => {
+    // 获取群组ID
+    const groupId = e.isGroup ? e.contact?.peer || '' : '';
+    if (!groupId) {
+        await e.reply('此命令仅支持在群聊中使用');
+        return true;
+    }
+    // 获取群组信息
+    let groupName = '';
+    let groupMemberCount;
+    let groupAvatarUrl;
+    try {
+        const groupInfo = await e.bot.getGroupInfo(groupId);
+        groupName = groupInfo?.groupName || '';
+        groupMemberCount = groupInfo?.memberCount;
+        groupAvatarUrl = groupInfo?.avatar;
+    }
+    catch (error) {
+        node_karin_1.logger.debug('[统计] 获取群组信息失败:', error);
+    }
+    // 群头像：优先问 bot 要（`getGroupAvatarUrl` 比 `groupInfo.avatar` 更可靠，
+    // 部分适配器的群信息里不带头像），拿不到就现场生成一个，保证头部不会空着
+    const groupAvatar = await (0, avatar_1.resolveAvatar)(groupId, await getAvatarUrl(() => e.bot.getGroupAvatarUrl(groupId, AVATAR_FETCH_SIZE)) ?? groupAvatarUrl);
+    // 获取统计数据库实例
+    const statisticsDB = await (0, db_1.getStatisticsDB)();
+    // 逐条取数（node-sqlite3 单连接，顺序执行最稳）
+    const groupStats = await statisticsDB.getGroupStatistics(groupId);
+    const groupHistory = await statisticsDB.getGroupRecentHistory(groupId, statisticsAggregate_1.TREND_DAYS);
+    const hourRows = await statisticsDB.getGroupHourStats(groupId);
+    const workTypeRows = await statisticsDB.getGroupWorkTypeStats(groupId);
+    const activeDays = await statisticsDB.getGroupActiveDays(groupId);
+    const metricRows = await statisticsDB.getGroupMetricStats(groupId);
+    const globalHistory = await statisticsDB.getRecentHistory(statisticsAggregate_1.TREND_DAYS);
+    const groupUniqueUsers = await statisticsDB.getGroupUniqueUsers(groupId);
+    const globalSummary = await statisticsDB.getGlobalSummary();
+    const { topUserRows, ...groupData } = (0, statisticsAggregate_1.aggregateGroup)({
+        groupStats,
+        groupHistory,
+        hourRows,
+        workTypeRows,
+        metricRows,
+        globalHistory,
+        activeDays,
+        uniqueUsers: groupUniqueUsers
+    });
+    // 活跃用户榜要补昵称：群名片优先，取不到回落昵称，再取不到回落用户ID。
+    // 单次 API 失败不能把整张海报带崩，所以逐个兜住。
+    // 昵称和头像一起并行取：十个人串行等十轮太慢，而且单个人失败不该拖垮整张海报
+    const topUsers = await Promise.all(topUserRows.map(async (row) => {
+        const [memberInfo, avatarUrl] = await Promise.all([
+            e.bot.getGroupMemberInfo(groupId, row.key).catch((error) => {
+                node_karin_1.logger.debug(`[统计] 获取群成员 ${row.key} 信息失败:`, error);
+                return undefined;
+            }),
+            getAvatarUrl(() => e.bot.getAvatarUrl(row.key, AVATAR_FETCH_SIZE))
+        ]);
+        return {
+            userId: row.key,
+            name: memberInfo?.card || memberInfo?.nick || row.key,
+            count: row.count,
+            // segments 是聚合层算好的平台构成，补昵称时原样带上
+            segments: row.segments,
+            avatar: await (0, avatar_1.resolveAvatar)(row.key, avatarUrl)
+        };
+    }));
+    // 渲染统计图片
+    const img = await (0, module_1.Render)(e, 'statistics/group', {
+        groupId,
+        groupName,
+        groupMemberCount,
+        groupAvatar,
+        generatedAt: (0, date_fns_1.format)(new Date(), 'yyyy-MM-dd HH:mm'),
+        ...groupData,
+        topUsers,
+        globalTotalGroups: globalSummary.totalGroups,
+        globalTotalParses: globalSummary.totalParses
+    });
+    await e.reply(img);
+    return true;
+}, {
+    businessName: '群组解析统计'
+});
+exports.groupStatistics = node_karin_1.default.command(/^#?kkk解析统计$/, handleGroupStatistics, { name: 'kkk-解析统计' });
+/**
+ * #kkk全局解析统计 命令
+ * 获取整个插件的全局解析统计数据
+ */
+const handleGlobalStatistics = (0, ErrorHandler_1.wrapWithErrorHandler)(async (e) => {
+    // 获取统计数据库实例
+    const statisticsDB = await (0, db_1.getStatisticsDB)();
+    // 逐条取数（node-sqlite3 单连接，顺序执行最稳）
+    const allStats = await statisticsDB.getAllStatistics();
+    const historyData = await statisticsDB.getRecentHistory(statisticsAggregate_1.TREND_DAYS);
+    const historyCompleteFrom = await statisticsDB.getHistoryCompleteFrom();
+    const workTypeRows = await statisticsDB.getGlobalWorkTypeStats();
+    const firstSeen = await statisticsDB.getGroupFirstSeen();
+    const metricRows = await statisticsDB.getGlobalMetricStats();
+    const { topGroupRows, ...globalData } = (0, statisticsAggregate_1.aggregateGlobal)({
+        allStats,
+        historyData,
+        firstSeen,
+        workTypeRows,
+        metricRows,
+        historyCompleteFrom
+    });
+    // 群组排行补群名（同样逐个兜住）
+    const topGroups = await Promise.all(topGroupRows.map(async (row) => {
+        const [groupInfo, avatarUrl] = await Promise.all([
+            e.bot.getGroupInfo(row.groupId).catch((error) => {
+                node_karin_1.logger.debug(`[统计] 获取群组 ${row.groupId} 信息失败:`, error);
+                return undefined;
+            }),
+            getAvatarUrl(() => e.bot.getGroupAvatarUrl(row.groupId, AVATAR_FETCH_SIZE))
+        ]);
+        return {
+            ...row,
+            name: groupInfo?.groupName || row.groupId,
+            avatar: await (0, avatar_1.resolveAvatar)(row.groupId, avatarUrl ?? groupInfo?.avatar)
+        };
+    }));
+    // 统计起始日：所有群里最早的一次记录
+    const statsSince = firstSeen.length > 0 ? firstSeen.map((row) => row.firstSeen.split('T')[0]).sort()[0] : undefined;
+    // 渲染统计图片
+    const img = await (0, module_1.Render)(e, 'statistics/global', {
+        generatedAt: (0, date_fns_1.format)(new Date(), 'yyyy-MM-dd HH:mm'),
+        ...globalData,
+        statsSince,
+        topGroups
+    });
+    await e.reply(img);
+    return true;
+}, {
+    businessName: '全局解析统计'
+});
+exports.globalStatistics = node_karin_1.default.command(/^#?kkk全局解析统计$/, handleGlobalStatistics, {
+    name: 'kkk-全局解析统计',
+    perm: 'master'
+});