@zhin.js/plugin-group-suite 0.1.0

package/README.md

@@ -0,0 +1,69 @@
+# @zhin.js/plugin-group-suite
+
+群运营一体化插件（**破坏性合并**，替代以下独立包，不再维护）：
+
+- `@zhin.js/plugin-group-admin`
+- `@zhin.js/plugin-checkin`
+- `@zhin.js/plugin-stats`
+- `@zhin.js/plugin-group-daily-analysis`
+- `@zhin.js/plugin-teach`
+
+## 安装
+
+```bash
+pnpm add @zhin.js/plugin-group-suite
+```
+
+旧包已在 npm 标记废弃（维护者执行）：
+
+```bash
+npm login   # 或 export NODE_AUTH_TOKEN=...
+node scripts/deprecate-group-legacy-packages.mjs
+```
+
+## 配置（扁平 `groupSuite`，多数项有默认值）
+
+```yaml
+plugins:
+  - "@zhin.js/plugin-group-suite"
+
+database:
+  dialect: sqlite
+  filename: ./data/bot.db
+
+inbox:
+  enabled: true   # 群日报需要
+
+# 可整段省略，使用默认值
+groupSuite:
+  noticeAdapters: [icqq]
+  autoAnalysisEnabled: true
+  autoAnalysisCron: "0 9 * * *"
+```
+
+常用可选字段（单层，无需 `admin:` / `checkin:` 等嵌套）：
+
+| 字段 | 默认 | 说明 |
+|------|------|------|
+| `welcome` | 欢迎新成员… | 入群欢迎语 |
+| `recallNotify` | `true` | 撤回提示 |
+| `keywordReply` | `false` | 内置关键词（建议用 teach） |
+| `noticeAdapters` | `[icqq]` | 处理 notice 的适配器 |
+| `basePointsMin` / `basePointsMax` | 10 / 30 | 签到积分 |
+| `rankSize` | 10 | 签到与统计排行人数 |
+| `statsRetentionDays` | 90 | 统计保留天数 |
+| `analysisDays` | 1 | 群分析天数 |
+| `analysisGroups` | `[]` | 日报白名单（空=不限制） |
+| `analysisGroupsBlock` | `[]` | 日报黑名单 |
+| `teachMaxPerGroup` | 200 | 每群问答上限 |
+| `teachCooldownMs` | 3000 | 问答冷却（毫秒） |
+
+## 命令
+
+| 命令 | 模块 |
+|------|------|
+| `签到` / `checkin` / `mypoints` / `rank` | 签到 |
+| `stats` / `stats-week` / `stats-rank` / `mystats` | 统计 |
+| `群分析` / `分析设置` | 日报 |
+| `teach` / `teach-regex` / `forget` / `teach-list` | 问答 |
+| `添加关键词` … | 仅 `keywordReply: true` |

package/lib/admin.d.ts

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

package/lib/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../src/admin.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,MAAM,EAEZ,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAuIzE"}

package/lib/admin.js

@@ -0,0 +1,123 @@
+import { formatCompact, MessageCommand, ZhinTool, } from "zhin.js";
+import { adapterAllowed } from "./shared.js";
+export function registerAdmin(plugin, cfg) {
+    const { addCommand, addMiddleware, addTool, logger } = plugin;
+    const welcomeTemplate = cfg.welcome;
+    const noticeAdapters = cfg.noticeAdapters;
+    plugin.on("notice.receive", async (notice) => {
+        if (!adapterAllowed(noticeAdapters, String(notice.$adapter)))
+            return;
+        if (notice.$type === "group_member_increase") {
+            if (notice.$channel.type !== "group")
+                return;
+            const targetName = notice.$target?.name || notice.$target?.id || "新成员";
+            const welcomeMsg = `🎉 ${targetName}，${welcomeTemplate}`;
+            try {
+                const adapter = plugin.inject(notice.$adapter);
+                if (!adapter?.sendMessage)
+                    return;
+                await adapter.sendMessage({
+                    context: notice.$adapter,
+                    bot: notice.$bot,
+                    content: welcomeMsg,
+                    id: notice.$channel.id,
+                    type: notice.$channel.type,
+                });
+            }
+            catch (e) {
+                logger.warn(formatCompact({
+                    op: "welcome",
+                    ok: false,
+                    error: e instanceof Error ? e.message : String(e),
+                }));
+            }
+            return;
+        }
+        if (cfg.recallNotify && notice.$type === "group_recall") {
+            if (notice.$channel.type !== "group")
+                return;
+            const operatorName = notice.$operator?.name || notice.$operator?.id || "某人";
+            const msg = `⚠️ ${operatorName} 撤回了一条消息`;
+            try {
+                const adapter = plugin.inject(notice.$adapter);
+                if (!adapter?.sendMessage)
+                    return;
+                await adapter.sendMessage({
+                    context: notice.$adapter,
+                    bot: notice.$bot,
+                    content: msg,
+                    id: notice.$channel.id,
+                    type: notice.$channel.type,
+                });
+            }
+            catch (e) {
+                logger.warn(formatCompact({
+                    op: "recall_notice",
+                    ok: false,
+                    error: e instanceof Error ? e.message : String(e),
+                }));
+            }
+        }
+    });
+    if (!cfg.keywordReply)
+        return;
+    const keywords = new Map();
+    addMiddleware(async (message, next) => {
+        if (message.$channel.type !== "group") {
+            await next();
+            return;
+        }
+        const raw = message.$raw?.trim();
+        if (!raw) {
+            await next();
+            return;
+        }
+        for (const [keyword, reply] of keywords) {
+            if (raw.includes(keyword)) {
+                await message.$reply(reply);
+                return;
+            }
+        }
+        await next();
+    });
+    addCommand(new MessageCommand("添加关键词 <keyword:text> <reply:text>")
+        .desc("添加一个关键词自动回复对")
+        .action(async (_message, result) => {
+        const { keyword, reply } = result.params;
+        if (!keyword || !reply)
+            return "请提供关键词和回复内容";
+        keywords.set(keyword, reply);
+        return `已添加关键词「${keyword}」→「${reply}」`;
+    }));
+    addCommand(new MessageCommand("删除关键词 <keyword:text>")
+        .desc("删除一个关键词")
+        .action(async (_message, result) => {
+        const { keyword } = result.params;
+        if (!keyword)
+            return "请提供要删除的关键词";
+        if (!keywords.has(keyword))
+            return `关键词「${keyword}」不存在`;
+        keywords.delete(keyword);
+        return `已删除关键词「${keyword}」`;
+    }));
+    addCommand(new MessageCommand("关键词列表")
+        .desc("查看所有关键词回复对")
+        .action(async () => {
+        if (keywords.size === 0)
+            return "当前没有设置任何关键词";
+        const lines = Array.from(keywords.entries()).map(([k, v], i) => `${i + 1}. 「${k}」→「${v}」`);
+        return `关键词列表（共 ${keywords.size} 条）：\n${lines.join("\n")}`;
+    }));
+    addTool(new ZhinTool("group_announce")
+        .desc("向群聊发送公告/通知消息")
+        .keyword("群公告", "通知", "announce")
+        .param("message", { type: "string", description: "要发送的公告内容" }, true)
+        .execute(async (args) => {
+        const content = args.message;
+        if (!content?.trim())
+            return "公告内容不能为空";
+        return `📢 群公告：\n${content}`;
+    })
+        .toTool());
+}
+//# sourceMappingURL=admin.js.map

package/lib/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../src/admin.ts"],"names":[],"mappings":"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"}

package/lib/analysis.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 群日常分析：从收件箱查询、基础统计、文本报告。
+ * 数据源为 zhin 内置 unified_inbox_message 表（需 inbox.enabled）。
+ *
+ * 话题/金句/用户画像分析逻辑灵感来自：
+ * https://github.com/SXP-Simon/astrbot_plugin_qq_group_daily_analysis
+ */
+export interface InboxMessageRow {
+    id?: number;
+    adapter: string;
+    bot_id: string;
+    channel_id: string;
+    channel_type: string;
+    sender_id: string;
+    sender_name: string | null;
+    content: string;
+    /** 收件箱里可能是字符串，也可能被 ORM/驱动解析成对象 */
+    raw: unknown;
+    created_at: number;
+}
+export interface BasicStats {
+    messageCount: number;
+    participantCount: number;
+    totalChars: number;
+    hourlyDistribution: Record<number, number>;
+    mostActiveHour: number;
+}
+/** 话题摘要（灵感来自 astrbot_plugin_qq_group_daily_analysis） */
+export interface SummaryTopic {
+    topic: string;
+    summary?: string;
+}
+/** 金句（灵感来自 astrbot_plugin_qq_group_daily_analysis） */
+export interface GoldenQuote {
+    content: string;
+    sender: string;
+    reason: string;
+}
+/** 用户称号/画像（灵感来自 astrbot_plugin_qq_group_daily_analysis） */
+export interface UserTitle {
+    name: string;
+    user_id: string;
+    title: string;
+    reason?: string;
+}
+export interface LLMAnalysis {
+    topics: SummaryTopic[];
+    quotes: GoldenQuote[];
+    userTitles: UserTitle[];
+}
+export interface AnalysisResult {
+    stats: BasicStats;
+    textReport: string;
+    llm?: LLMAnalysis;
+}
+/**
+ * 从 content (JSON) 或 raw 提取纯文本，用于统计与 LLM
+ */
+export declare function extractText(row: InboxMessageRow): string;
+/**
+ * 计算基础统计：消息数、人数、总字数、按小时分布、最活跃时段
+ */
+export declare function computeBasicStats(rows: InboxMessageRow[]): BasicStats;
+/**
+ * 生成纯文本报告（不含 LLM 内容）
+ */
+export declare function formatTextReport(stats: BasicStats, options: {
+    channelName?: string;
+    days: number;
+    startDate: string;
+    endDate: string;
+}): string;
+/**
+ * 将 LLM 分析结果追加到文本报告。
+ * 话题/金句/用户画像 设计灵感来自 astrbot_plugin_qq_group_daily_analysis
+ */
+export declare function appendLLMReport(textReport: string, llm: LLMAnalysis): string;
+/**
+ * 从 LLM 返回的文本中解析出 topics / quotes / userTitles。
+ * 约定 LLM 返回 JSON 或类似结构，此处做宽松解析。
+ */
+export declare function parseLLMResponse(raw: string): LLMAnalysis;
+//# sourceMappingURL=analysis.d.ts.map

package/lib/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../src/analysis.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CA2BxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,UAAU,CA+BrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClF,MAAM,CAqBR;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAuB5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAiCzD"}

package/lib/analysis.js

@@ -0,0 +1,167 @@
+/**
+ * 群日常分析：从收件箱查询、基础统计、文本报告。
+ * 数据源为 zhin 内置 unified_inbox_message 表（需 inbox.enabled）。
+ *
+ * 话题/金句/用户画像分析逻辑灵感来自：
+ * https://github.com/SXP-Simon/astrbot_plugin_qq_group_daily_analysis
+ */
+/**
+ * 从 content (JSON) 或 raw 提取纯文本，用于统计与 LLM
+ */
+export function extractText(row) {
+    const raw = row.raw;
+    if (typeof raw === "string") {
+        const t = raw.trim();
+        if (t)
+            return t;
+    }
+    // 非字符串 raw（如 icqq 存的对象）不走 trim，避免报错；改从 content 解析
+    try {
+        const c = row.content;
+        const contentStr = typeof c === "string" ? c : JSON.stringify(c ?? []);
+        const content = JSON.parse(contentStr || "[]");
+        if (typeof content === "string")
+            return content;
+        if (Array.isArray(content)) {
+            return content
+                .map((part) => {
+                if (part?.type === "text") {
+                    return part.data?.text ?? part.text ?? "";
+                }
+                return part?.text ?? "";
+            })
+                .filter(Boolean)
+                .join("");
+        }
+    }
+    catch {
+        // ignore
+    }
+    return "";
+}
+/**
+ * 计算基础统计：消息数、人数、总字数、按小时分布、最活跃时段
+ */
+export function computeBasicStats(rows) {
+    const participantIds = new Set();
+    let totalChars = 0;
+    const hourly = {};
+    for (let h = 0; h < 24; h++)
+        hourly[h] = 0;
+    for (const row of rows) {
+        participantIds.add(row.sender_id);
+        const text = extractText(row);
+        totalChars += text.length;
+        const date = new Date(row.created_at);
+        const h = date.getHours();
+        hourly[h] = (hourly[h] || 0) + 1;
+    }
+    let mostActiveHour = 0;
+    let maxCount = 0;
+    for (let h = 0; h < 24; h++) {
+        if (hourly[h] > maxCount) {
+            maxCount = hourly[h];
+            mostActiveHour = h;
+        }
+    }
+    return {
+        messageCount: rows.length,
+        participantCount: participantIds.size,
+        totalChars,
+        hourlyDistribution: hourly,
+        mostActiveHour,
+    };
+}
+/**
+ * 生成纯文本报告（不含 LLM 内容）
+ */
+export function formatTextReport(stats, options) {
+    const lines = [];
+    const title = options.channelName
+        ? `【${options.channelName}】群日常分析`
+        : "群日常分析";
+    lines.push(`📊 ${title}`);
+    lines.push(`📅 统计区间：${options.startDate} 至 ${options.endDate}（最近 ${options.days} 天）`);
+    lines.push("");
+    lines.push(`💬 消息总数：${stats.messageCount} 条`);
+    lines.push(`👥 参与人数：${stats.participantCount} 人`);
+    lines.push(`📝 总字数：${stats.totalChars} 字`);
+    lines.push(`⏰ 最活跃时段：${stats.mostActiveHour}:00 - ${stats.mostActiveHour + 1}:00`);
+    lines.push("");
+    lines.push("📈 每小时消息分布：");
+    const maxH = Math.max(...Object.values(stats.hourlyDistribution), 1);
+    for (let h = 0; h < 24; h++) {
+        const c = stats.hourlyDistribution[h] || 0;
+        const bar = "█".repeat(Math.round((c / maxH) * 10)) || "░";
+        lines.push(`  ${String(h).padStart(2, "0")}:00 ${bar} ${c}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * 将 LLM 分析结果追加到文本报告。
+ * 话题/金句/用户画像 设计灵感来自 astrbot_plugin_qq_group_daily_analysis
+ */
+export function appendLLMReport(textReport, llm) {
+    const lines = [textReport, ""];
+    if (llm.topics?.length) {
+        lines.push("🔥 热门话题（LLM 提取）：");
+        llm.topics.forEach((t, i) => {
+            lines.push(`  ${i + 1}. ${t.topic}${t.summary ? ` — ${t.summary}` : ""}`);
+        });
+        lines.push("");
+    }
+    if (llm.quotes?.length) {
+        lines.push("💬 金句（LLM 筛选）：");
+        llm.quotes.forEach((q, i) => {
+            lines.push(`  ${i + 1}. 「${q.content}」 — ${q.sender}（${q.reason}）`);
+        });
+        lines.push("");
+    }
+    if (llm.userTitles?.length) {
+        lines.push("👤 用户画像/称号（LLM）：");
+        llm.userTitles.forEach((u, i) => {
+            lines.push(`  ${i + 1}. ${u.name} — ${u.title}${u.reason ? `（${u.reason}）` : ""}`);
+        });
+    }
+    return lines.join("\n");
+}
+/**
+ * 从 LLM 返回的文本中解析出 topics / quotes / userTitles。
+ * 约定 LLM 返回 JSON 或类似结构，此处做宽松解析。
+ */
+export function parseLLMResponse(raw) {
+    const result = { topics: [], quotes: [], userTitles: [] };
+    try {
+        const trimmed = raw.trim();
+        const jsonMatch = trimmed.match(/\{[\s\S]*\}/);
+        if (jsonMatch) {
+            const obj = JSON.parse(jsonMatch[0]);
+            if (Array.isArray(obj.topics)) {
+                result.topics = obj.topics.map((t) => ({
+                    topic: typeof t.topic === "string" ? t.topic : String(t.topic || ""),
+                    summary: typeof t.summary === "string" ? t.summary : undefined,
+                }));
+            }
+            if (Array.isArray(obj.quotes)) {
+                result.quotes = obj.quotes.map((q) => ({
+                    content: String(q.content ?? ""),
+                    sender: String(q.sender ?? ""),
+                    reason: String(q.reason ?? ""),
+                }));
+            }
+            if (Array.isArray(obj.user_titles)) {
+                result.userTitles = obj.user_titles.map((u) => ({
+                    name: String(u.name ?? ""),
+                    user_id: String(u.user_id ?? ""),
+                    title: String(u.title ?? ""),
+                    reason: typeof u.reason === "string" ? u.reason : undefined,
+                }));
+            }
+        }
+    }
+    catch {
+        // ignore parse errors
+    }
+    return result;
+}
+//# sourceMappingURL=analysis.js.map

package/lib/analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.js","sourceRoot":"","sources":["../src/analysis.ts"],"names":[],"mappings":"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"}

package/lib/checkin.d.ts

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

package/lib/checkin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkin.d.ts","sourceRoot":"","sources":["../src/checkin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAmBpD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI,CA0K3E"}

package/lib/checkin.js

@@ -0,0 +1,163 @@
+import { formatCompact, MessageCommand } from "zhin.js";
+import { getDatabase, getMessageContextKey, todayStr, ts } from "./shared.js";
+function yesterdayStr() {
+    const d = new Date();
+    d.setDate(d.getDate() - 1);
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+function randomInt(min, max) {
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+let _db = null;
+function getModel() {
+    return _db?.models?.get("checkin_records") ?? null;
+}
+export function registerCheckin(plugin, cfg) {
+    const { logger, addCommand, useContext } = plugin;
+    useContext("database", (db) => {
+        _db = db;
+        db.define("checkin_records", {
+            user_id: { type: "text", nullable: false },
+            user_name: { type: "text", default: "" },
+            points: { type: "integer", default: 0 },
+            total_checkins: { type: "integer", default: 0 },
+            streak: { type: "integer", default: 0 },
+            max_streak: { type: "integer", default: 0 },
+            last_checkin: { type: "text", default: "" },
+            context_type: { type: "text", default: "global" },
+            context_id: { type: "text", default: "" },
+            created_at: { type: "text", default: "" },
+            updated_at: { type: "text", default: "" },
+        });
+        logger.info(formatCompact({ op: "checkin_model" }));
+    });
+    async function getOrCreateUser(model, userId, userName, ctxType, ctxId) {
+        const rows = (await model.select().where({
+            user_id: userId,
+            context_type: ctxType,
+            context_id: ctxId,
+        }));
+        if (rows.length > 0)
+            return rows[0];
+        await model.insert({
+            user_id: userId,
+            user_name: userName,
+            points: 0,
+            total_checkins: 0,
+            streak: 0,
+            max_streak: 0,
+            last_checkin: "",
+            context_type: ctxType,
+            context_id: ctxId,
+            created_at: ts(),
+            updated_at: ts(),
+        });
+        const created = (await model.select().where({
+            user_id: userId,
+            context_type: ctxType,
+            context_id: ctxId,
+        }));
+        return created[0] ?? null;
+    }
+    addCommand(new MessageCommand("checkin")
+        .desc("签到", "每日签到获得积分")
+        .action(async (message) => {
+        const M = getModel();
+        if (!M)
+            return "签到数据库尚未就绪，请稍后重试";
+        const userId = String(message.$sender?.id || "");
+        const userName = String(message.$sender?.name || "用户");
+        if (!userId)
+            return "无法获取用户信息";
+        const { type: ctxType, id: ctxId } = getMessageContextKey(message);
+        const user = await getOrCreateUser(M, userId, userName, ctxType, ctxId);
+        if (!user)
+            return "签到失败，请重试";
+        const today = todayStr();
+        if (user.last_checkin === today) {
+            return `你今天已经签到过了哦～\n当前积分: ${user.points}\n连续签到: ${user.streak} 天`;
+        }
+        const isConsecutive = user.last_checkin === yesterdayStr();
+        const newStreak = isConsecutive ? Number(user.streak) + 1 : 1;
+        const base = randomInt(cfg.basePointsMin, cfg.basePointsMax);
+        const bonus = Math.min(newStreak * cfg.streakBonus, cfg.streakCap);
+        const earned = base + bonus;
+        const newPoints = Number(user.points || 0) + earned;
+        await M.update({
+            points: newPoints,
+            total_checkins: Number(user.total_checkins || 0) + 1,
+            streak: newStreak,
+            max_streak: Math.max(Number(user.max_streak || 0), newStreak),
+            last_checkin: today,
+            user_name: userName,
+            updated_at: ts(),
+        }).where({ id: user.id });
+        const lines = [`签到成功！`, `基础积分: +${base}`];
+        if (bonus > 0)
+            lines.push(`连续奖励: +${bonus} (连续${newStreak}天)`);
+        lines.push(`本次获得: +${earned}`, `当前积分: ${newPoints}`);
+        return lines.join("\n");
+    }));
+    addCommand(new MessageCommand("mypoints")
+        .desc("我的积分", "查看个人积分与签到信息")
+        .action(async (message) => {
+        const M = getModel();
+        if (!M)
+            return "签到数据库尚未就绪";
+        const userId = String(message.$sender?.id || "");
+        const { type: ctxType, id: ctxId } = getMessageContextKey(message);
+        const rows = (await M.select().where({
+            user_id: userId,
+            context_type: ctxType,
+            context_id: ctxId,
+        }));
+        if (rows.length === 0)
+            return "你还没有签到记录哦，发送「签到」开始吧！";
+        const u = rows[0];
+        const checkedToday = u.last_checkin === todayStr();
+        return [
+            `${u.user_name || "用户"} 的积分信息`,
+            `积分: ${u.points}`,
+            `累计签到: ${u.total_checkins} 天`,
+            `连续签到: ${u.streak} 天`,
+            `最长连续: ${u.max_streak} 天`,
+            checkedToday ? "今日已签到 ✓" : "今日未签到",
+        ].join("\n");
+    }));
+    addCommand(new MessageCommand("rank")
+        .desc("积分排行", "查看积分排行榜")
+        .action(async (message) => {
+        const M = getModel();
+        if (!M)
+            return "签到数据库尚未就绪";
+        const { type: ctxType, id: ctxId } = getMessageContextKey(message);
+        const all = (await M.select().where(ctxType === "global"
+            ? { context_type: "global" }
+            : { context_type: ctxType, context_id: ctxId }));
+        if (all.length === 0)
+            return "还没有人签到过哦～";
+        const sorted = all.sort((a, b) => Number(b.points || 0) - Number(a.points || 0));
+        const top = sorted.slice(0, cfg.rankSize);
+        const medals = ["🥇", "🥈", "🥉"];
+        const lines = top.map((u, i) => {
+            const prefix = i < 3 ? medals[i] : `${i + 1}.`;
+            return `${prefix} ${u.user_name || u.user_id} — ${u.points}分 (${u.total_checkins}天)`;
+        });
+        const title = ctxType === "group" ? "本群积分排行" : "全局积分排行";
+        const userId = String(message.$sender?.id || "");
+        const myRank = sorted.findIndex((u) => u.user_id === userId);
+        const footer = myRank >= 0 ? `\n你的排名: 第${myRank + 1}名` : "";
+        return `${title}\n${lines.join("\n")}${footer}`;
+    }));
+    if (!_db) {
+        const db = getDatabase(plugin);
+        if (db)
+            _db = db;
+    }
+    logger.info(formatCompact({
+        op: "checkin_load",
+        base_min: cfg.basePointsMin,
+        base_max: cfg.basePointsMax,
+    }));
+}
+//# sourceMappingURL=checkin.js.map