@zhin.js/plugin-group-suite 0.1.0

package/lib/stats.js

@@ -0,0 +1,244 @@
+import { formatCompact, MessageCommand } from "zhin.js";
+import { todayStr, ts } from "./shared.js";
+export function weekStartStr() {
+    const d = new Date();
+    const day = d.getDay() || 7;
+    d.setDate(d.getDate() - day + 1);
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+export function monthStartStr() {
+    const d = new Date();
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-01`;
+}
+let _db = null;
+function getModel() {
+    return _db?.models?.get("message_stats") ?? null;
+}
+const buffer = new Map();
+function bufferKey(userId, groupId, date) {
+    return `${userId}:${groupId}:${date}`;
+}
+function getGroupId(message) {
+    if (message.$channel?.type === "group") {
+        return String(message.$channel.id ?? "");
+    }
+    return "";
+}
+async function flushBuffer() {
+    const M = getModel();
+    if (!M || buffer.size === 0)
+        return;
+    const entries = [...buffer.values()];
+    buffer.clear();
+    for (const entry of entries) {
+        try {
+            const existing = await M.select().where({
+                user_id: entry.user_id,
+                group_id: entry.group_id,
+                date: entry.date,
+            });
+            if (existing.length > 0) {
+                await M.update({
+                    count: (existing[0].count || 0) + entry.count,
+                    user_name: entry.user_name,
+                    updated_at: ts(),
+                }).where({ id: existing[0].id });
+            }
+            else {
+                await M.insert({
+                    user_id: entry.user_id,
+                    user_name: entry.user_name,
+                    group_id: entry.group_id,
+                    date: entry.date,
+                    count: entry.count,
+                    updated_at: ts(),
+                });
+            }
+        }
+        catch {
+            /* single row failure */
+        }
+    }
+}
+async function queryStats(groupId, fromDate) {
+    const M = getModel();
+    if (!M)
+        return new Map();
+    const all = groupId
+        ? await M.select().where({ group_id: groupId })
+        : await M.select();
+    const result = new Map();
+    for (const row of all) {
+        if (row.date < fromDate)
+            continue;
+        const existing = result.get(row.user_id);
+        if (existing) {
+            existing.count += row.count || 0;
+            if (row.user_name)
+                existing.name = row.user_name;
+        }
+        else {
+            result.set(row.user_id, {
+                name: row.user_name || row.user_id,
+                count: row.count || 0,
+            });
+        }
+    }
+    return result;
+}
+function formatRank(stats, title, size, myUserId) {
+    const sorted = [...stats.entries()].sort((a, b) => b[1].count - a[1].count);
+    const total = sorted.reduce((s, [, v]) => s + v.count, 0);
+    const top = sorted.slice(0, size);
+    if (top.length === 0)
+        return `${title}\n暂无数据`;
+    const medals = ["🥇", "🥈", "🥉"];
+    const lines = top.map(([, v], i) => {
+        const prefix = i < 3 ? medals[i] : `${i + 1}.`;
+        return `${prefix} ${v.name} — ${v.count}条`;
+    });
+    let footer = `\n共 ${stats.size} 人, ${total} 条消息`;
+    if (myUserId) {
+        const myRank = sorted.findIndex(([uid]) => uid === myUserId);
+        if (myRank >= 0) {
+            footer += ` | 你第${myRank + 1}名 (${sorted[myRank][1].count}条)`;
+        }
+    }
+    return `${title}\n${lines.join("\n")}${footer}`;
+}
+export function registerStats(plugin, cfg) {
+    const { logger, addCommand, addMiddleware, useContext, onDispose } = plugin;
+    useContext("database", (db) => {
+        _db = db;
+        db.define("message_stats", {
+            user_id: { type: "text", nullable: false },
+            user_name: { type: "text", default: "" },
+            group_id: { type: "text", default: "" },
+            date: { type: "text", nullable: false },
+            count: { type: "integer", default: 0 },
+            updated_at: { type: "text", default: "" },
+        });
+        logger.info(formatCompact({ op: "stats_model" }));
+    });
+    const flushTimer = setInterval(flushBuffer, 10_000);
+    onDispose(async () => {
+        clearInterval(flushTimer);
+        await flushBuffer();
+        buffer.clear();
+    });
+    addMiddleware(async (message, next) => {
+        const userId = String(message.$sender?.id || "");
+        if (!userId)
+            return next();
+        const key = bufferKey(userId, getGroupId(message), todayStr());
+        const pending = buffer.get(key);
+        if (pending) {
+            pending.count++;
+            pending.user_name = String(message.$sender?.name || "");
+        }
+        else {
+            buffer.set(key, {
+                user_id: userId,
+                user_name: String(message.$sender?.name || ""),
+                group_id: getGroupId(message),
+                date: todayStr(),
+                count: 1,
+            });
+        }
+        return next();
+    });
+    addCommand(new MessageCommand("stats")
+        .desc("消息统计", "查看今日消息统计")
+        .action(async (message) => {
+        await flushBuffer();
+        const groupId = getGroupId(message);
+        const stats = await queryStats(groupId, todayStr());
+        const title = groupId ? "今日本群消息统计" : "今日全局消息统计";
+        return formatRank(stats, title, cfg.rankSize, String(message.$sender?.id || ""));
+    }));
+    addCommand(new MessageCommand("stats-week")
+        .desc("周消息统计", "查看本周消息统计")
+        .action(async (message) => {
+        await flushBuffer();
+        const groupId = getGroupId(message);
+        const stats = await queryStats(groupId, weekStartStr());
+        const title = groupId ? "本周本群消息统计" : "本周全局消息统计";
+        return formatRank(stats, title, cfg.rankSize, String(message.$sender?.id || ""));
+    }));
+    addCommand(new MessageCommand("stats-rank")
+        .desc("话唠排行", "查看活跃度排行榜")
+        .action(async (message) => {
+        await flushBuffer();
+        const groupId = getGroupId(message);
+        const stats = await queryStats(groupId, monthStartStr());
+        const title = groupId ? "本月话唠排行" : "全局话唠排行";
+        return formatRank(stats, title, cfg.rankSize, String(message.$sender?.id || ""));
+    }));
+    addCommand(new MessageCommand("mystats")
+        .desc("我的统计", "查看个人消息统计")
+        .action(async (message) => {
+        await flushBuffer();
+        const M = getModel();
+        if (!M)
+            return "统计数据库尚未就绪";
+        const userId = String(message.$sender?.id || "");
+        if (!userId)
+            return "无法获取用户信息";
+        const groupId = getGroupId(message);
+        const rows = groupId
+            ? await M.select().where({ user_id: userId, group_id: groupId })
+            : await M.select().where({ user_id: userId });
+        if (rows.length === 0)
+            return "暂无你的消息记录";
+        const today = todayStr();
+        const weekStart = weekStartStr();
+        const monthStart = monthStartStr();
+        let todayCount = 0;
+        let weekCount = 0;
+        let monthCount = 0;
+        let totalCount = 0;
+        for (const row of rows) {
+            const c = row.count || 0;
+            totalCount += c;
+            if (row.date >= monthStart)
+                monthCount += c;
+            if (row.date >= weekStart)
+                weekCount += c;
+            if (row.date === today)
+                todayCount += c;
+        }
+        const scope = groupId ? "本群" : "全局";
+        return [
+            `${message.$sender?.name || "你"} 的${scope}消息统计`,
+            `今日: ${todayCount} 条`,
+            `本周: ${weekCount} 条`,
+            `本月: ${monthCount} 条`,
+            `总计: ${totalCount} 条`,
+            `活跃天数: ${rows.length} 天`,
+        ].join("\n");
+    }));
+    const cleanupTimer = setInterval(async () => {
+        const M = getModel();
+        if (!M)
+            return;
+        try {
+            const cutoff = new Date();
+            cutoff.setDate(cutoff.getDate() - cfg.statsRetentionDays);
+            const cutoffStr = `${cutoff.getFullYear()}-${String(cutoff.getMonth() + 1).padStart(2, "0")}-${String(cutoff.getDate()).padStart(2, "0")}`;
+            const all = await M.select();
+            for (const row of all.filter((r) => r.date < cutoffStr)) {
+                await M.delete().where({ id: row.id });
+            }
+        }
+        catch {
+            /* ignore */
+        }
+    }, 24 * 60 * 60_000);
+    onDispose(() => clearInterval(cleanupTimer));
+    logger.info(formatCompact({
+        op: "stats_load",
+        rank_size: cfg.rankSize,
+        retention_days: cfg.statsRetentionDays,
+    }));
+}
+//# sourceMappingURL=stats.js.map

package/lib/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAe,MAAM,SAAS,CAAC;AAErE,OAAO,EAAwB,QAAQ,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,UAAU,YAAY;IAC1B,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;IACjC,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACnH,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC;AAC9E,CAAC;AAED,IAAI,GAAG,GAAQ,IAAI,CAAC;AAEpB,SAAS,QAAQ;IACf,OAAO,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC;AACnD,CAAC;AAUD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;AAEnD,SAAS,SAAS,CAAC,MAAc,EAAE,OAAe,EAAE,IAAY;IAC9D,OAAO,GAAG,MAAM,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,UAAU,CAAC,OAAsD;IACxE,IAAI,OAAO,CAAC,QAAQ,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,KAAK,UAAU,WAAW;IACxB,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;IACrB,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO;IACpC,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAU,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC;gBAC7C,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC,CAAC;YACH,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,CAAC,MAAM,CAAC;oBACb,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK;oBAC7C,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,UAAU,EAAE,EAAE,EAAE;iBACjB,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,CAAC,MAAM,CAAC;oBACb,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,UAAU,EAAE,EAAE,EAAE;iBACjB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,OAAe,EACf,QAAgB;IAEhB,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;IACrB,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IACzB,MAAM,GAAG,GAAU,OAAO;QACxB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAC/C,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;IACrB,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2C,CAAC;IAClE,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,GAAG,CAAC,IAAI,GAAG,QAAQ;YAAE,SAAS;QAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;YACjC,IAAI,GAAG,CAAC,SAAS;gBAAE,QAAQ,CAAC,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE;gBACtB,IAAI,EAAE,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,OAAO;gBAClC,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;aACtB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CACjB,KAAmD,EACnD,KAAa,EACb,IAAY,EACZ,QAAiB;IAEjB,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAClC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,KAAK,QAAQ,CAAC;IAC9C,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;QAC/C,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,GAAG,CAAC;IAC7C,CAAC,CAAC,CAAC;IACH,IAAI,MAAM,GAAG,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,MAAM,CAAC;IACjD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC;QAC7D,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YAChB,MAAM,IAAI,QAAQ,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;QAChE,CAAC;IACH,CAAC;IACD,OAAO,GAAG,KAAK,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,GAAqB;IACjE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAE5E,UAAU,CAAC,UAAU,EAAE,CAAC,EAAO,EAAE,EAAE;QACjC,GAAG,GAAG,EAAE,CAAC;QACT,EAAE,CAAC,MAAM,CAAC,eAAe,EAAE;YACzB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC1C,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;YACxC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;YACvC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;YACvC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;YACtC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;SAC1C,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACpD,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,aAAa,CAAC,UAAU,CAAC,CAAC;QAC1B,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACpC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;gBACd,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;gBAC9C,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC;gBAC7B,IAAI,EAAE,QAAQ,EAAE;gBAChB,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,UAAU,CACR,IAAI,cAAc,CAAC,OAAO,CAAC;SACxB,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC;SACxB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QAChD,OAAO,UAAU,CACf,KAAK,EACL,KAAK,EACL,GAAG,CAAC,QAAQ,EACZ,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAClC,CAAC;IACJ,CAAC,CAAC,CACL,CAAC;IAEF,UAAU,CACR,IAAI,cAAc,CAAC,YAAY,CAAC;SAC7B,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;SACzB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;QAChD,OAAO,UAAU,CACf,KAAK,EACL,KAAK,EACL,GAAG,CAAC,QAAQ,EACZ,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAClC,CAAC;IACJ,CAAC,CAAC,CACL,CAAC;IAEF,UAAU,CACR,IAAI,cAAc,CAAC,YAAY,CAAC;SAC7B,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC;SACxB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC5C,OAAO,UAAU,CACf,KAAK,EACL,KAAK,EACL,GAAG,CAAC,QAAQ,EACZ,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAClC,CAAC;IACJ,CAAC,CAAC,CACL,CAAC;IAEF,UAAU,CACR,IAAI,cAAc,CAAC,SAAS,CAAC;SAC1B,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC;SACxB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC;YAAE,OAAO,WAAW,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM;YAAE,OAAO,UAAU,CAAC;QAC/B,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,IAAI,GAAU,OAAO;YACzB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;YAChE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,UAAU,CAAC;QACzC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;QACnC,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;YACzB,UAAU,IAAI,CAAC,CAAC;YAChB,IAAI,GAAG,CAAC,IAAI,IAAI,UAAU;gBAAE,UAAU,IAAI,CAAC,CAAC;YAC5C,IAAI,GAAG,CAAC,IAAI,IAAI,SAAS;gBAAE,SAAS,IAAI,CAAC,CAAC;YAC1C,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK;gBAAE,UAAU,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACpC,OAAO;YACL,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,GAAG,KAAK,KAAK,MAAM;YAC/C,OAAO,UAAU,IAAI;YACrB,OAAO,SAAS,IAAI;YACpB,OAAO,UAAU,IAAI;YACrB,OAAO,UAAU,IAAI;YACrB,SAAS,IAAI,CAAC,MAAM,IAAI;SACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAC1C,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC;YAAE,OAAO;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YAC1B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAC1D,MAAM,SAAS,GAAG,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YAC3I,MAAM,GAAG,GAAU,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;YACpC,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC;gBACxD,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;IAErB,SAAS,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;IAE7C,MAAM,CAAC,IAAI,CACT,aAAa,CAAC;QACZ,EAAE,EAAE,YAAY;QAChB,SAAS,EAAE,GAAG,CAAC,QAAQ;QACvB,cAAc,EAAE,GAAG,CAAC,kBAAkB;KACvC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/lib/teach.d.ts

@@ -0,0 +1,4 @@
+import { type Plugin } from "zhin.js";
+import type { GroupSuiteConfig } from "./config.js";
+export declare function registerTeach(plugin: Plugin, cfg: GroupSuiteConfig): void;
+//# sourceMappingURL=teach.d.ts.map

package/lib/teach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teach.d.ts","sourceRoot":"","sources":["../src/teach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAwCpD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAyNzE"}

package/lib/teach.js

@@ -0,0 +1,252 @@
+import { MessageCommand } from "zhin.js";
+import { getMessageContextKey, ts } from "./shared.js";
+const cooldownMap = new Map();
+function isSafeRegex(pattern) {
+    if (pattern.length > 200)
+        return false;
+    if (/(\+|\*|\{)\)?(\+|\*|\{)/.test(pattern))
+        return false;
+    if (/\([^)]*(\+|\*)[^)]*(\+|\*)[^)]*\)[\+\*]/.test(pattern))
+        return false;
+    const altGroups = pattern.match(/\([^)]*\|[^)]*\)/g) || [];
+    for (const g of altGroups) {
+        if ((g.match(/\|/g) || []).length > 10)
+            return false;
+    }
+    return true;
+}
+function processAnswer(answer, message, match) {
+    let result = answer;
+    result = result.replace(/\{sender\}/g, message.$sender?.name || "你");
+    result = result.replace(/\{sender\.id\}/g, message.$sender?.id || "");
+    result = result.replace(/\{time\}/g, new Date().toLocaleTimeString("zh-CN"));
+    result = result.replace(/\{date\}/g, new Date().toLocaleDateString("zh-CN"));
+    if (match) {
+        for (let i = 1; i < match.length; i++) {
+            result = result.replace(new RegExp(`\\$${i}`, "g"), match[i] || "");
+        }
+    }
+    return result;
+}
+let _db = null;
+function getQA() {
+    return _db?.models?.get("teach_qa") ?? null;
+}
+export function registerTeach(plugin, cfg) {
+    const { addCommand, addMiddleware, useContext, onDispose } = plugin;
+    useContext("database", (db) => {
+        _db = db;
+        db.define("teach_qa", {
+            question: { type: "text", nullable: false },
+            answer: { type: "text", nullable: false },
+            is_regex: { type: "integer", default: 0 },
+            context_type: { type: "text", default: "global" },
+            context_id: { type: "text", default: "" },
+            creator_id: { type: "text", default: "" },
+            creator_name: { type: "text", default: "" },
+            hit_count: { type: "integer", default: 0 },
+            created_at: { type: "text", default: "" },
+            updated_at: { type: "text", default: "" },
+        });
+    });
+    const cooldownCleanup = setInterval(() => {
+        const now = Date.now();
+        for (const [key, time] of cooldownMap) {
+            if (now - time > cfg.teachCooldownMs * 2)
+                cooldownMap.delete(key);
+        }
+    }, 60_000);
+    onDispose(() => clearInterval(cooldownCleanup));
+    async function findMatch(content, ctxType, ctxId) {
+        const QA = getQA();
+        if (!QA)
+            return null;
+        const allItems = await QA.select();
+        const candidates = allItems.filter((item) => item.context_type === "global" ||
+            (item.context_type === ctxType && item.context_id === ctxId));
+        for (const item of candidates) {
+            if (!item.is_regex && item.question === content)
+                return item;
+        }
+        if (cfg.teachAllowRegex) {
+            for (const item of candidates) {
+                if (!item.is_regex)
+                    continue;
+                try {
+                    if (new RegExp(item.question, "i").test(content))
+                        return item;
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+        return null;
+    }
+    addMiddleware(async (message, next) => {
+        const content = (message.$raw || "").trim();
+        if (!content)
+            return next();
+        const { type: ctxType, id: ctxId } = getMessageContextKey(message);
+        const matched = await findMatch(content, ctxType, ctxId);
+        if (!matched)
+            return next();
+        const cooldownKey = `${matched.id}:${ctxType}:${ctxId}`;
+        const last = cooldownMap.get(cooldownKey);
+        if (last && Date.now() - last < cfg.teachCooldownMs)
+            return next();
+        cooldownMap.set(cooldownKey, Date.now());
+        const QA = getQA();
+        if (QA) {
+            try {
+                await QA.update({
+                    hit_count: (matched.hit_count || 0) + 1,
+                    updated_at: ts(),
+                }).where({ id: matched.id });
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        let answer = matched.answer;
+        if (matched.is_regex) {
+            try {
+                const m = content.match(new RegExp(matched.question, "i"));
+                answer = processAnswer(answer, message, m || undefined);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        else {
+            answer = processAnswer(answer, message);
+        }
+        await message.$reply(answer);
+    });
+    addCommand(new MessageCommand("teach <question:text> <answer:text>")
+        .desc("教我问答", "教会 Bot 一个新的问答对")
+        .action(async (message, result) => {
+        const QA = getQA();
+        if (!QA)
+            return "问答数据库尚未就绪，请稍后重试";
+        const question = result.params.question?.trim();
+        const answer = result.params.answer?.trim();
+        if (!question || !answer)
+            return "请提供问题和回答";
+        const { type: ctxType, id: ctxId } = getMessageContextKey(message);
+        if (ctxType === "group") {
+            const existing = await QA.select().where({
+                context_type: ctxType,
+                context_id: ctxId,
+            });
+            if (existing.length >= cfg.teachMaxPerGroup) {
+                return `该群问答数已达上限 (${cfg.teachMaxPerGroup})`;
+            }
+        }
+        const duplicate = await QA.select().where({
+            question,
+            context_type: ctxType,
+            context_id: ctxId,
+        });
+        if (duplicate.length > 0) {
+            await QA.update({ answer, updated_at: ts() }).where({
+                id: duplicate[0].id,
+            });
+            return `已更新问答：「${question}」→「${answer}」`;
+        }
+        await QA.insert({
+            question,
+            answer,
+            is_regex: 0,
+            context_type: ctxType,
+            context_id: ctxId,
+            creator_id: message.$sender?.id || "",
+            creator_name: message.$sender?.name || "",
+            hit_count: 0,
+            created_at: ts(),
+            updated_at: ts(),
+        });
+        return `学会了！发送「${question}」我会回复「${answer}」`;
+    }));
+    addCommand(new MessageCommand("teach-regex <pattern:text> <answer:text>")
+        .desc("教我正则问答", "用正则匹配")
+        .action(async (message, result) => {
+        const QA = getQA();
+        if (!QA)
+            return "问答数据库尚未就绪";
+        if (!cfg.teachAllowRegex)
+            return "管理员已禁用正则问答";
+        const pattern = result.params.pattern?.trim();
+        const answer = result.params.answer?.trim();
+        if (!pattern || !answer)
+            return "请提供正则和回答";
+        try {
+            new RegExp(pattern, "i");
+        }
+        catch (e) {
+            return `正则表达式不合法: ${e.message}`;
+        }
+        if (!isSafeRegex(pattern))
+            return "该正则可能导致性能问题，请简化";
+        const { type: ctxType, id: ctxId } = getMessageContextKey(message);
+        await QA.insert({
+            question: pattern,
+            answer,
+            is_regex: 1,
+            context_type: ctxType,
+            context_id: ctxId,
+            creator_id: message.$sender?.id || "",
+            creator_name: message.$sender?.name || "",
+            hit_count: 0,
+            created_at: ts(),
+            updated_at: ts(),
+        });
+        return `学会了！匹配 /${pattern}/ 的消息我会回复「${answer}」`;
+    }));
+    addCommand(new MessageCommand("forget <question:text>")
+        .desc("忘记问答", "删除问答对")
+        .action(async (message, result) => {
+        const QA = getQA();
+        if (!QA)
+            return "问答数据库尚未就绪";
+        const question = result.params.question?.trim();
+        if (!question)
+            return "请提供要删除的问题";
+        const { type: ctxType, id: ctxId } = getMessageContextKey(message);
+        const items = await QA.select().where({
+            question,
+            context_type: ctxType,
+            context_id: ctxId,
+        });
+        if (items.length === 0)
+            return `没有找到问题「${question}」`;
+        await QA.delete().where({ id: items[0].id });
+        return `已忘记「${question}」的回答`;
+    }));
+    addCommand(new MessageCommand("teach-list [page:number]")
+        .desc("问答列表", "查看问答对")
+        .action(async (message, result) => {
+        const QA = getQA();
+        if (!QA)
+            return "问答数据库尚未就绪";
+        const page = Math.max(1, result.params.page || 1);
+        const { type: ctxType, id: ctxId } = getMessageContextKey(message);
+        const allItems = await QA.select().where(ctxType === "global"
+            ? { context_type: "global" }
+            : { context_type: ctxType, context_id: ctxId });
+        if (allItems.length === 0)
+            return "还没有教过任何问答哦～";
+        const totalPages = Math.ceil(allItems.length / cfg.teachPageSize);
+        const safePage = Math.min(page, totalPages);
+        const start = (safePage - 1) * cfg.teachPageSize;
+        const pageItems = allItems.slice(start, start + cfg.teachPageSize);
+        const lines = pageItems.map((item, i) => {
+            const prefix = item.is_regex ? "[正则]" : "[精确]";
+            const q = item.is_regex ? `/${item.question}/` : item.question;
+            return `${start + i + 1}. ${prefix} ${q} → ${item.answer}`;
+        });
+        const header = ctxType === "global" ? "全局问答列表" : "本群问答列表";
+        return `${header}\n${lines.join("\n")}\n第 ${safePage}/${totalPages} 页 · 共 ${allItems.length} 条`;
+    }));
+}
+//# sourceMappingURL=teach.js.map

package/lib/teach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teach.js","sourceRoot":"","sources":["../src/teach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAe,MAAM,SAAS,CAAC;AAEtD,OAAO,EAAE,oBAAoB,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE9C,SAAS,WAAW,CAAC,OAAe;IAClC,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,yCAAyC,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1E,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC;IAC3D,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,EAAE;YAAE,OAAO,KAAK,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CACpB,MAAc,EACd,OAAqD,EACrD,KAAwB;IAExB,IAAI,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,GAAG,CAAC,CAAC;IACrE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7E,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7E,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,IAAI,GAAG,GAAQ,IAAI,CAAC;AAEpB,SAAS,KAAK;IACZ,OAAO,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,GAAqB;IACjE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAEpE,UAAU,CAAC,UAAU,EAAE,CAAC,EAAO,EAAE,EAAE;QACjC,GAAG,GAAG,EAAE,CAAC;QACT,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE;YACpB,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;YAC3C,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;YACzC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;YACzC,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE;YACjD,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;YACzC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;YACzC,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;YAC3C,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;YAC1C,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;YACzC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;SAC1C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC;YACtC,IAAI,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC,eAAe,GAAG,CAAC;gBAAE,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,EAAE,MAAM,CAAC,CAAC;IACX,SAAS,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC;IAEhD,KAAK,UAAU,SAAS,CACtB,OAAe,EACf,OAAe,EACf,KAAa;QAEb,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACrB,MAAM,QAAQ,GAAU,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAChC,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,YAAY,KAAK,QAAQ;YAC9B,CAAC,IAAI,CAAC,YAAY,KAAK,OAAO,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,CAC/D,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO;gBAAE,OAAO,IAAI,CAAC;QAC/D,CAAC;QACD,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;YACxB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ;oBAAE,SAAS;gBAC7B,IAAI,CAAC;oBACH,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;wBAAE,OAAO,IAAI,CAAC;gBAChE,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACpC,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,EAAE,CAAC;QAC5B,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,GAAG,OAAO,CAAC,EAAE,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC1C,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,GAAG,CAAC,eAAe;YAAE,OAAO,IAAI,EAAE,CAAC;QACnE,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACzC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC;oBACd,SAAS,EAAE,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC;oBACvC,UAAU,EAAE,EAAE,EAAE;iBACjB,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;QACD,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC5B,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;gBAC3D,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,SAAS,CAAC,CAAC;YAC1D,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,UAAU,CACR,IAAI,cAAc,CAAC,qCAAqC,CAAC;SACtD,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC;SAC9B,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;QAChC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,EAAE;YAAE,OAAO,iBAAiB,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM;YAAE,OAAO,UAAU,CAAC;QAC5C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACnE,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAU,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC;gBAC9C,YAAY,EAAE,OAAO;gBACrB,UAAU,EAAE,KAAK;aAClB,CAAC,CAAC;YACH,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC,gBAAgB,EAAE,CAAC;gBAC5C,OAAO,cAAc,GAAG,CAAC,gBAAgB,GAAG,CAAC;YAC/C,CAAC;QACH,CAAC;QACD,MAAM,SAAS,GAAU,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC;YAC/C,QAAQ;YACR,YAAY,EAAE,OAAO;YACrB,UAAU,EAAE,KAAK;SAClB,CAAC,CAAC;QACH,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC;gBAClD,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE;aACpB,CAAC,CAAC;YACH,OAAO,UAAU,QAAQ,MAAM,MAAM,GAAG,CAAC;QAC3C,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,CAAC;YACd,QAAQ;YACR,MAAM;YACN,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,OAAO;YACrB,UAAU,EAAE,KAAK;YACjB,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE;YACrC,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE;YACzC,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,EAAE,EAAE;YAChB,UAAU,EAAE,EAAE,EAAE;SACjB,CAAC,CAAC;QACH,OAAO,UAAU,QAAQ,SAAS,MAAM,GAAG,CAAC;IAC9C,CAAC,CAAC,CACL,CAAC;IAEF,UAAU,CACR,IAAI,cAAc,CAAC,0CAA0C,CAAC;SAC3D,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC;SACvB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;QAChC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,eAAe;YAAE,OAAO,YAAY,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;YAAE,OAAO,UAAU,CAAC;QAC3C,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,aAAc,CAAW,CAAC,OAAO,EAAE,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;YAAE,OAAO,iBAAiB,CAAC;QACpD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,EAAE,CAAC,MAAM,CAAC;YACd,QAAQ,EAAE,OAAO;YACjB,MAAM;YACN,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,OAAO;YACrB,UAAU,EAAE,KAAK;YACjB,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE;YACrC,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE;YACzC,SAAS,EAAE,CAAC;YACZ,UAAU,EAAE,EAAE,EAAE;YAChB,UAAU,EAAE,EAAE,EAAE;SACjB,CAAC,CAAC;QACH,OAAO,WAAW,OAAO,aAAa,MAAM,GAAG,CAAC;IAClD,CAAC,CAAC,CACL,CAAC;IAEF,UAAU,CACR,IAAI,cAAc,CAAC,wBAAwB,CAAC;SACzC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;SACrB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;QAChC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,QAAQ;YAAE,OAAO,WAAW,CAAC;QAClC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,KAAK,GAAU,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC;YAC3C,QAAQ;YACR,YAAY,EAAE,OAAO;YACrB,UAAU,EAAE,KAAK;SAClB,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,UAAU,QAAQ,GAAG,CAAC;QACrD,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7C,OAAO,OAAO,QAAQ,MAAM,CAAC;IAC/B,CAAC,CAAC,CACL,CAAC;IAEF,UAAU,CACR,IAAI,cAAc,CAAC,0BAA0B,CAAC;SAC3C,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;SACrB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;QAChC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,EAAE;YAAE,OAAO,WAAW,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QAClD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAU,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAC7C,OAAO,KAAK,QAAQ;YAClB,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE;YAC5B,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CACjD,CAAC;QACF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,aAAa,CAAC;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC;QAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC;QACjD,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;YAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;YAC/D,OAAO,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7D,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1D,OAAO,GAAG,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,QAAQ,IAAI,UAAU,UAAU,QAAQ,CAAC,MAAM,IAAI,CAAC;IAClG,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@zhin.js/plugin-group-suite",
+  "version": "0.1.0",
+  "description": "Zhin.js 群运营套件 — 群管、签到、统计、日常分析、问答（合并原 5 个插件）",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "skills",
+    "tools",
+    "plugin.yml",
+    "README.md"
+  ],
+  "keywords": [
+    "zhin",
+    "zhin.js",
+    "bot",
+    "plugin",
+    "group",
+    "checkin",
+    "stats",
+    "teach",
+    "welcome"
+  ],
+  "author": {
+    "name": "lc-cn",
+    "email": "admin@liucl.cn",
+    "url": "https://github.com/lc-cn"
+  },
+  "license": "MIT",
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "@zhin.js/plugin-html-renderer": "0.0.63",
+    "zhin.js": "1.0.85"
+  },
+  "peerDependencies": {
+    "@zhin.js/plugin-html-renderer": "0.0.63",
+    "zhin.js": "1.0.85"
+  },
+  "peerDependenciesMeta": {
+    "@zhin.js/plugin-html-renderer": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhinjs/zhin.git",
+    "directory": "plugins/utils/group-suite"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rimraf lib"
+  }
+}

package/plugin.yml

@@ -0,0 +1,3 @@
+name: group-suite
+description: 群运营套件（入群欢迎、撤回提示、签到、消息统计、群日报、问答库）
+version: 0.1.0

package/skills/checkin/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: checkin
+description: >-
+  签到积分系统查询能力。当用户想查看自己的积分、签到排行榜、连签天数、
+  或了解签到奖励时使用。日常签到通过聊天命令触发，此技能提供积分查询的 AI 工具。
+  用户说「我的积分」「排行榜」「签到排名」时应触发。
+keywords:
+  - checkin
+  - 签到
+  - sign-in
+  - 积分
+  - points
+  - 排行
+  - rank
+  - 排行榜
+  - 我的积分
+  - 连签
+tags:
+  - checkin
+  - points
+  - gamification
+tools:
+  - checkin_rank
+  - checkin_query
+---
+
+# 签到积分查询技能
+
+## 工具
+
+| 工具 | 用途 | 说明 |
+|------|------|------|
+| `checkin_query` | 查询用户积分 | 当前积分、连签天数等 |
+| `checkin_rank` | 积分排行榜 | 群内积分 Top 排名 |
+
+**Example:**
+```
+用户: 我有多少积分？
+→ checkin_query(user_id=用户ID)
+
+用户: 群里谁积分最多？
+→ checkin_rank(group_id=当前群号)
+```
+
+## 注意
+
+- 日常签到通过聊天命令（`签到`）触发，不是 AI 工具。
+- 连续签到有额外奖励，中断后重新计算。
+- 积分数据依赖数据库，确保数据库服务正常。