@zhin.js/plugin-group-suite 3.0.1 → 3.0.3

package/README.md

@@ -1,80 +1,64 @@
 # @zhin.js/plugin-group-suite
 
-群运营一体化插件（**破坏性合并**，替代以下独立包，不再维护）：
+Plugin Runtime 群运营能力包，提供签到积分、消息统计、关键词回复与群问答。所有能力
+由 `commands/`、`middlewares/` 和 `agent/` 约定目录发现，不注册 legacy Plugin 回调。
 
-- `@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 标记废弃（维护者执行）：
+父插件在 `package.json#zhin.plugins` 中声明子插件：
 
-```bash
-npm login   # 或 export NODE_AUTH_TOKEN=...
-node scripts/deprecate-group-legacy-packages.mjs
+```json
+{
+  "package": "@zhin.js/plugin-group-suite",
+  "instanceKey": "group-suite"
+}
 ```
 
-## 配置（扁平 `groupSuite`，多数项有默认值）
+配置位于该实例的层级节点：
 
 ```yaml
 plugins:
-  - "@zhin.js/plugin-group-suite"
-
-# 可选：stats / 群分析 等 html 段自动出图（pnpm add @zhin.js/html-renderer，无需写 plugins 列表）
-
-database:
-  dialect: sqlite
-  filename: ./data/bot.db
-
-inbox:
-  enabled: true   # 群日报需要
-
-# 可整段省略，使用默认值
-groupSuite:
-  noticeAdapters: [icqq]
-  autoAnalysisEnabled: true
-  autoAnalysisCron: "0 9 * * *"
+  group-suite:
+    keywordReply: false
+    basePointsMin: 10
+    basePointsMax: 30
+    streakBonus: 5
+    streakCap: 50
+    rankSize: 10
+    teachMaxPerGroup: 200
+    teachCooldownMs: 3000
+    teachAllowRegex: true
+    teachPageSize: 10
 ```
 
-常用可选字段（单层，无需 `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 | 问答冷却（毫秒） |
+完整约束以 [`schema.json`](./schema.json) 为 SSOT。数据优先写入 Runtime
+`DatabaseHost`；未配置数据库时使用插件实例私有的内存存储，适合测试。
 
-## 统计与群分析出图
+数据库、关键词、教学冷却和消息统计缓冲统一封装为 owner-scoped
+`GroupSuiteRuntime`。commands/middlewares 只通过 Capability Context 解析该资源；因此同一
+进程中的多个实例、HMR 新旧 generation 不会共享可变状态。
 
-`stats`、`mystats`、`群分析` 等命令返回 **`segment.html({ html })`**，由出站链统一处理：
+## 能力
 
-- 安装 **`@zhin.js/html-renderer`**（`pnpm add`，无需 plugins 列表）→ 自动渲染为 PNG 卡片
-- 未安装 → core 从 HTML 自动剥离纯文本（零业务侧 detect）
+| 路径 | 说明 |
+|---|---|
+| `checkin` / `mypoints` / `rank` | 签到、积分与排行 |
+| `stats` / `stats-week` / `stats-rank` / `mystats` | 消息统计 |
+| `teach` / `teach-regex` / `teach-list` / `forget` | 群问答管理 |
+| `keyword-add` / `keyword-list` / `keyword-remove` | 关键词回复管理 |
+| `middlewares/*` | 入站统计、关键词和问答匹配 |
+| `agent/tools/group_announce.ts` | 可选 Agent 群公告工具 |
 
-卡片 HTML 在 `stats-card.ts` / `analysis-card.ts` 中用 **`@zhin.js/satori`** 的 `h()` 与内置组件构建，视觉对齐 test-bot 的 `zt-report-card`。
+本 major 不包含 Adapter side-event 欢迎/撤回、AI 群日报或 HTML 报表。这些旧能力
+需要独立的事件与渲染 Feature，已从 schema 移除，避免出现“可配置但不生效”的字段。
 
-## 命令
+## 验证
 
-| 命令 | 模块 |
-|------|------|
-| `签到` / `checkin` / `mypoints` / `rank` | 签到 |
-| `stats` / `stats-week` / `stats-rank` / `mystats` | 统计 |
-| `群分析` / `分析设置` | 日报 |
-| `teach` / `teach-regex` / `forget` / `teach-list` | 问答（`teach 问题 回答` 或 `teach 问题\|答案`） |
-| `添加关键词` … | 仅 `keywordReply: true` |
+```bash
+pnpm --filter @zhin.js/plugin-group-suite build
+pnpm --filter @zhin.js/plugin-group-suite test
+```

package/agent/tools/group_announce.ts

@@ -0,0 +1,12 @@
+import { defineAgentTool } from '@zhin.js/agent/tools';
+import { z } from 'zod';
+
+export default defineAgentTool<{ message: string }>({
+  description: '向群聊发送公告/通知消息',
+  inputSchema: z.object({ message: z.string().min(1) }),
+  keywords: ['群公告', '通知', 'announce'],
+  async execute({ message }) {
+    if (!message?.trim()) return '公告内容不能为空';
+    return `📢 群公告：\n${message}`;
+  },
+});

package/commands/checkin.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../src/config.js';
+import { doCheckin } from '../src/checkin-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '每日签到获得积分',
+  execute({ config, input, owner, use }) {
+    return doCheckin(input ?? {}, resolveGroupSuiteConfig(config), resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/commands/forget.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import type { GroupSuiteConfig } from '../src/config.js';
+import { teachForget } from '../src/teach-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '忘记问答（删除问答对）',
+  execute({ input, args, owner, use }) {
+    return teachForget(input ?? {}, args.join(' '), resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/commands/keyword-add/[keyword:string].ts

@@ -0,0 +1,15 @@
+import { defineCommand } from '@zhin.js/command';
+import { addKeyword } from '../../src/keyword-store.js';
+import type { GroupSuiteConfig } from '../../src/config.js';
+import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig>({
+  description: '添加关键词自动回复',
+  execute({ params, args, owner, use }) {
+    const keyword = String(params.keyword ?? '');
+    const reply = args.join(' ').trim();
+    if (!keyword || !reply) return '请提供关键词和回复内容';
+    addKeyword(keyword, reply, resolveGroupSuiteRuntime({ owner, use })?.keywords);
+    return `已添加关键词「${keyword}」→「${reply}」`;
+  },
+});

package/commands/keyword-list.ts

@@ -0,0 +1,14 @@
+import { defineCommand } from '@zhin.js/command';
+import { listKeywords } from '../src/keyword-store.js';
+import type { GroupSuiteConfig } from '../src/config.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig>({
+  description: '查看所有关键词回复对',
+  execute({ owner, use }) {
+    const entries = listKeywords(resolveGroupSuiteRuntime({ owner, use })?.keywords);
+    if (entries.length === 0) return '当前没有设置任何关键词';
+    const lines = entries.map(([k, v], i) => `${i + 1}. 「${k}」→「${v}」`);
+    return `关键词列表（共 ${entries.length} 条）：\n${lines.join('\n')}`;
+  },
+});

package/commands/keyword-remove/[keyword:string].ts

@@ -0,0 +1,14 @@
+import { defineCommand } from '@zhin.js/command';
+import { removeKeyword } from '../../src/keyword-store.js';
+import type { GroupSuiteConfig } from '../../src/config.js';
+import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig>({
+  description: '删除关键词自动回复',
+  execute({ params, owner, use }) {
+    const keyword = String(params.keyword ?? '');
+    if (!keyword) return '请提供要删除的关键词';
+    if (!removeKeyword(keyword, resolveGroupSuiteRuntime({ owner, use })?.keywords)) return `关键词「${keyword}」不存在`;
+    return `已删除关键词「${keyword}」`;
+  },
+});

package/commands/mypoints.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import type { GroupSuiteConfig } from '../src/config.js';
+import { myPoints } from '../src/checkin-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '查看个人积分与签到信息',
+  execute({ input, owner, use }) {
+    return myPoints(input ?? {}, resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/commands/mystats.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import type { GroupSuiteConfig } from '../src/config.js';
+import { myStatsText } from '../src/stats-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '查看个人消息统计',
+  execute({ input, owner, use }) {
+    return myStatsText(input ?? {}, resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/commands/rank.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../src/config.js';
+import { pointsRank } from '../src/checkin-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '查看积分排行榜',
+  execute({ config, input, owner, use }) {
+    return pointsRank(input ?? {}, resolveGroupSuiteConfig(config), resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/commands/stats-rank.ts

@@ -0,0 +1,20 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../src/config.js';
+import { monthStartStr, resolveGroupId, statsRankText } from '../src/stats-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '查看本月话唠排行',
+  execute({ config, input, owner, use }) {
+    const groupId = resolveGroupId(input ?? {});
+    const title = groupId ? '本月话唠排行' : '全局话唠排行';
+    return statsRankText(
+      input ?? {},
+      resolveGroupSuiteConfig(config),
+      monthStartStr(),
+      title,
+      resolveGroupSuiteRuntime({ owner, use }),
+    );
+  },
+});

package/commands/stats-week.ts

@@ -0,0 +1,20 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../src/config.js';
+import { resolveGroupId, statsRankText, weekStartStr } from '../src/stats-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '查看本周消息统计',
+  execute({ config, input, owner, use }) {
+    const groupId = resolveGroupId(input ?? {});
+    const title = groupId ? '本周本群消息统计' : '本周全局消息统计';
+    return statsRankText(
+      input ?? {},
+      resolveGroupSuiteConfig(config),
+      weekStartStr(),
+      title,
+      resolveGroupSuiteRuntime({ owner, use }),
+    );
+  },
+});

package/commands/stats.ts

@@ -0,0 +1,21 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../src/config.js';
+import { todayStr } from '../src/shared-runtime.js';
+import { resolveGroupId, statsRankText } from '../src/stats-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '查看今日消息统计',
+  execute({ config, input, owner, use }) {
+    const groupId = resolveGroupId(input ?? {});
+    const title = groupId ? '今日本群消息统计' : '今日全局消息统计';
+    return statsRankText(
+      input ?? {},
+      resolveGroupSuiteConfig(config),
+      todayStr(),
+      title,
+      resolveGroupSuiteRuntime({ owner, use }),
+    );
+  },
+});

package/commands/teach-list/[page:number=1].ts

@@ -0,0 +1,13 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../../src/config.js';
+import { teachList } from '../../src/teach-lib.js';
+import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '查看问答列表',
+  execute({ config, input, params, owner, use }) {
+    const page = Number(params.page ?? 1);
+    return teachList(input ?? {}, resolveGroupSuiteConfig(config), page, resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/commands/teach-regex.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../src/config.js';
+import { teachAdd } from '../src/teach-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '教我正则问答',
+  execute({ config, input, args, owner, use }) {
+    return teachAdd(input ?? {}, resolveGroupSuiteConfig(config), args.join(' '), true, resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/commands/teach.ts

@@ -0,0 +1,12 @@
+import { defineCommand } from '@zhin.js/command';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../src/config.js';
+import { teachAdd } from '../src/teach-lib.js';
+import { resolveGroupSuiteRuntime } from '../src/runtime-state.js';
+
+export default defineCommand<GroupSuiteConfig, string, Message>({
+  description: '教我问答（teach 问题 回答 或 问题|答案）',
+  execute({ config, input, args, owner, use }) {
+    return teachAdd(input ?? {}, resolveGroupSuiteConfig(config), args.join(' '), false, resolveGroupSuiteRuntime({ owner, use }));
+  },
+});

package/lib/checkin-lib.d.ts

@@ -0,0 +1,18 @@
+import type { GroupSuiteConfig } from './config.js';
+import type { GroupSuiteRuntime } from './runtime-state.js';
+export declare function doCheckin(input: {
+    sender?: string;
+    target?: string;
+    metadata?: Readonly<Record<string, unknown>>;
+}, cfg: GroupSuiteConfig, runtime?: GroupSuiteRuntime): Promise<string>;
+export declare function myPoints(input: {
+    sender?: string;
+    target?: string;
+    metadata?: Readonly<Record<string, unknown>>;
+}, runtime?: GroupSuiteRuntime): Promise<string>;
+export declare function pointsRank(input: {
+    sender?: string;
+    target?: string;
+    metadata?: Readonly<Record<string, unknown>>;
+}, cfg: GroupSuiteConfig, runtime?: GroupSuiteRuntime): Promise<string>;
+//# sourceMappingURL=checkin-lib.d.ts.map

package/lib/checkin-lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkin-lib.d.ts","sourceRoot":"","sources":["../src/checkin-lib.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAUpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAsC5D,wBAAsB,SAAS,CAC7B,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,EACzF,GAAG,EAAE,gBAAgB,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAyCjB;AAED,wBAAsB,QAAQ,CAC5B,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,EACzF,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,EACzF,GAAG,EAAE,gBAAgB,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAsBjB"}

package/lib/checkin-lib.js

@@ -0,0 +1,118 @@
+import { getCheckinModel } from './db-store.js';
+import { randomInt, resolveContextKey, resolveSender, todayStr, ts, yesterdayStr, } from './shared-runtime.js';
+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;
+}
+export async function doCheckin(input, cfg, runtime) {
+    const M = getCheckinModel(runtime?.db);
+    if (!M)
+        return '签到数据库尚未就绪，请稍后重试';
+    const { id: userId, name: userName } = resolveSender(input);
+    if (!userId)
+        return '无法获取用户信息';
+    const { type: ctxType, id: ctxId } = resolveContextKey(input);
+    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({
+        user_id: userId,
+        context_type: ctxType,
+        context_id: ctxId,
+    });
+    const lines = [`签到成功！`, `基础积分: +${base}`];
+    if (bonus > 0)
+        lines.push(`连续奖励: +${bonus} (连续${newStreak}天)`);
+    lines.push(`本次获得: +${earned}`, `当前积分: ${newPoints}`);
+    return lines.join('\n');
+}
+export async function myPoints(input, runtime) {
+    const M = getCheckinModel(runtime?.db);
+    if (!M)
+        return '签到数据库尚未就绪';
+    const { id: userId } = resolveSender(input);
+    const { type: ctxType, id: ctxId } = resolveContextKey(input);
+    const rows = (await M.select().where({
+        user_id: userId,
+        context_type: ctxType,
+        context_id: ctxId,
+    }));
+    if (rows.length === 0)
+        return '你还没有签到记录哦，发送「checkin」开始吧！';
+    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');
+}
+export async function pointsRank(input, cfg, runtime) {
+    const M = getCheckinModel(runtime?.db);
+    if (!M)
+        return '签到数据库尚未就绪';
+    const { type: ctxType, id: ctxId } = resolveContextKey(input);
+    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 { id: userId } = resolveSender(input);
+    const myRank = sorted.findIndex((u) => u.user_id === userId);
+    const footer = myRank >= 0 ? `\n你的排名: 第${myRank + 1}名` : '';
+    return `${title}\n${lines.join('\n')}${footer}`;
+}
+//# sourceMappingURL=checkin-lib.js.map

package/lib/checkin-lib.js.map

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

package/lib/config.d.ts

@@ -1,68 +1,15 @@
-import { Schema } from "zhin.js";
-/** 扁平 groupSuite 配置（单层字段，默认值覆盖多数场景） */
-export declare const groupSuiteSchema: Schema<{
-    welcome?: string | undefined;
-    recallNotify?: boolean | undefined;
-    keywordReply?: boolean | undefined;
-    noticeAdapters?: string[] | undefined;
-    basePointsMin?: number | undefined;
-    basePointsMax?: number | undefined;
-    streakBonus?: number | undefined;
-    streakCap?: number | undefined;
-    rankSize?: number | undefined;
-    statsRetentionDays?: number | undefined;
-    analysisDays?: number | undefined;
-    autoAnalysisEnabled?: boolean | undefined;
-    autoAnalysisCron?: string | undefined;
-    analysisGroups?: string[] | undefined;
-    analysisGroupsBlock?: string[] | undefined;
-    analysisMaxMessages?: number | undefined;
-    teachMaxPerGroup?: number | undefined;
-    teachCooldownMs?: number | undefined;
-    teachAllowRegex?: boolean | undefined;
-    teachPageSize?: number | undefined;
-}, {
-    welcome?: string | undefined;
-    recallNotify?: boolean | undefined;
-    keywordReply?: boolean | undefined;
-    noticeAdapters?: string[] | undefined;
-    basePointsMin?: number | undefined;
-    basePointsMax?: number | undefined;
-    streakBonus?: number | undefined;
-    streakCap?: number | undefined;
-    rankSize?: number | undefined;
-    statsRetentionDays?: number | undefined;
-    analysisDays?: number | undefined;
-    autoAnalysisEnabled?: boolean | undefined;
-    autoAnalysisCron?: string | undefined;
-    analysisGroups?: string[] | undefined;
-    analysisGroupsBlock?: string[] | undefined;
-    analysisMaxMessages?: number | undefined;
-    teachMaxPerGroup?: number | undefined;
-    teachCooldownMs?: number | undefined;
-    teachAllowRegex?: boolean | undefined;
-    teachPageSize?: number | undefined;
-}>;
-export type GroupSuiteConfig = {
-    welcome: string;
-    recallNotify: boolean;
+export interface GroupSuiteConfig {
     keywordReply: boolean;
-    noticeAdapters: string[];
     basePointsMin: number;
     basePointsMax: number;
     streakBonus: number;
     streakCap: number;
     rankSize: number;
-    statsRetentionDays: number;
-    analysisDays: number;
-    autoAnalysisEnabled: boolean;
-    autoAnalysisCron: string;
-    analysisGroups: string[];
-    analysisGroupsBlock: string[];
-    analysisMaxMessages: number;
     teachMaxPerGroup: number;
     teachCooldownMs: number;
     teachAllowRegex: boolean;
     teachPageSize: number;
-};
+}
+export declare const DEFAULT_GROUP_SUITE_CONFIG: GroupSuiteConfig;
+export declare function resolveGroupSuiteConfig(raw: Partial<GroupSuiteConfig> | undefined): GroupSuiteConfig;
 //# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,uCAAuC;AACvC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyC3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,0BAA0B,EAAE,gBAWxC,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,GACzC,gBAAgB,CAKlB"}