@zhin.js/plugin-group-suite 1.1.0 → 1.1.2

package/plugin.js

@@ -1,6 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
 import { definePlugin, databaseHostToken } from 'zhin.js';
-import { registerGroupSuiteDb } from "./lib/db-store.js";
 import { createInMemoryGroupSuiteDb } from "./lib/memory-store.js";
 import { createGroupSuiteRuntime, groupSuiteRuntimeToken } from "./lib/runtime-state.js";
 import { flushStatsBuffer } from "./lib/stats-lib.js";
@@ -28,7 +27,6 @@ export default definePlugin({
         })();
         const runtime = createGroupSuiteRuntime(db);
         context.resources.provide(groupSuiteRuntimeToken, runtime);
-        context.lifecycle.add(registerGroupSuiteDb(db));
         const flushTimer = setInterval(() => {
             void flushStatsBuffer(runtime);
         }, 10_000);

package/skills/checkin/tools/checkin_query/index.js

@@ -0,0 +1,42 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { getCheckinModel } from "../../../../lib/db-store.js";
+import { groupSuiteRuntimeToken } from "../../../../lib/runtime-state.js";
+import { todayStr } from "../../../../lib/shared-runtime.js";
+export default defineAgentTool({
+    description: '查询用户的签到积分，或汇总当前范围的签到数据',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            user_id: { type: 'string', description: '用户 ID；省略时返回汇总' },
+            group_id: { type: 'string', description: '群 ID；省略时使用当前 IM 会话' },
+        },
+    },
+    requiresApproval: 'never',
+    async execute({ user_id: userId, group_id: requestedGroupId }, context) {
+        const runtime = context.use(groupSuiteRuntimeToken);
+        const model = getCheckinModel(runtime.db);
+        if (!model)
+            return '签到数据库尚未就绪';
+        const groupId = requestedGroupId ?? currentGroupId(context.origin);
+        const query = {
+            ...(userId ? { user_id: userId } : {}),
+            ...(groupId ? { context_type: 'group', context_id: groupId } : {}),
+        };
+        const rows = Object.keys(query).length > 0
+            ? await model.select().where(query)
+            : await model.select();
+        if (userId) {
+            if (rows.length === 0)
+                return `用户 ${userId} 没有签到记录`;
+            const user = rows[0];
+            return `${String(user.user_name ?? userId)}: 积分=${Number(user.points ?? 0)}, 累计=${Number(user.total_checkins ?? 0)}天, 连续=${Number(user.streak ?? 0)}天, 最长=${Number(user.max_streak ?? 0)}天, 上次=${String(user.last_checkin ?? '')}`;
+        }
+        const totalPoints = rows.reduce((sum, user) => sum + Number(user.points ?? 0), 0);
+        const todayCount = rows.filter((user) => user.last_checkin === todayStr()).length;
+        return `签到系统统计\n总用户: ${rows.length}\n总积分: ${totalPoints}\n今日签到: ${todayCount}人`;
+    },
+});
+function currentGroupId(origin) {
+    return origin.kind === 'im' && origin.scope !== 'private' ? origin.sceneId : '';
+}

package/skills/checkin/tools/checkin_query/index.ts

@@ -0,0 +1,41 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { getCheckinModel } from '../../../../src/db-store.js';
+import { groupSuiteRuntimeToken } from '../../../../src/runtime-state.js';
+import { todayStr } from '../../../../src/shared-runtime.js';
+
+export default defineAgentTool<{ user_id?: string; group_id?: string }>({
+  description: '查询用户的签到积分，或汇总当前范围的签到数据',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      user_id: { type: 'string', description: '用户 ID；省略时返回汇总' },
+      group_id: { type: 'string', description: '群 ID；省略时使用当前 IM 会话' },
+    },
+  },
+  requiresApproval: 'never',
+  async execute({ user_id: userId, group_id: requestedGroupId }, context) {
+    const runtime = context.use(groupSuiteRuntimeToken);
+    const model = getCheckinModel(runtime.db);
+    if (!model) return '签到数据库尚未就绪';
+    const groupId = requestedGroupId ?? currentGroupId(context.origin);
+    const query = {
+      ...(userId ? { user_id: userId } : {}),
+      ...(groupId ? { context_type: 'group', context_id: groupId } : {}),
+    };
+    const rows = Object.keys(query).length > 0
+      ? await model.select().where(query)
+      : await model.select();
+    if (userId) {
+      if (rows.length === 0) return `用户 ${userId} 没有签到记录`;
+      const user = rows[0]!;
+      return `${String(user.user_name ?? userId)}: 积分=${Number(user.points ?? 0)}, 累计=${Number(user.total_checkins ?? 0)}天, 连续=${Number(user.streak ?? 0)}天, 最长=${Number(user.max_streak ?? 0)}天, 上次=${String(user.last_checkin ?? '')}`;
+    }
+    const totalPoints = rows.reduce((sum, user) => sum + Number(user.points ?? 0), 0);
+    const todayCount = rows.filter((user) => user.last_checkin === todayStr()).length;
+    return `签到系统统计\n总用户: ${rows.length}\n总积分: ${totalPoints}\n今日签到: ${todayCount}人`;
+  },
+});
+
+function currentGroupId(origin: import('@zhin.js/tool').ToolInvocationOrigin): string {
+  return origin.kind === 'im' && origin.scope !== 'private' ? origin.sceneId : '';
+}

package/skills/checkin/tools/checkin_rank/index.js

@@ -0,0 +1,34 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { getCheckinModel } from "../../../../lib/db-store.js";
+import { groupSuiteRuntimeToken } from "../../../../lib/runtime-state.js";
+export default defineAgentTool({
+    description: '查询当前群或指定群的签到积分排行榜',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            limit: { type: 'number', description: '返回数量，默认 10，最多 50' },
+            group_id: { type: 'string', description: '群 ID；省略时使用当前 IM 会话' },
+        },
+    },
+    requiresApproval: 'never',
+    async execute({ limit, group_id: requestedGroupId }, context) {
+        const model = getCheckinModel(context.use(groupSuiteRuntimeToken).db);
+        if (!model)
+            return '签到数据库尚未就绪';
+        const groupId = requestedGroupId
+            ?? (context.origin.kind === 'im' && context.origin.scope !== 'private'
+                ? context.origin.sceneId
+                : '');
+        const rows = groupId
+            ? await model.select().where({ context_type: 'group', context_id: groupId })
+            : await model.select();
+        const count = Math.min(Math.max(Number(limit) || 10, 1), 50);
+        const ranked = [...rows]
+            .sort((left, right) => Number(right.points ?? 0) - Number(left.points ?? 0))
+            .slice(0, count);
+        if (ranked.length === 0)
+            return '暂无排行数据';
+        return ranked.map((user, index) => `${index + 1}. ${String(user.user_name ?? user.user_id)} — ${Number(user.points ?? 0)}分 (连续${Number(user.streak ?? 0)}天)`).join('\n');
+    },
+});

package/skills/checkin/tools/checkin_rank/index.ts

@@ -0,0 +1,34 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { getCheckinModel } from '../../../../src/db-store.js';
+import { groupSuiteRuntimeToken } from '../../../../src/runtime-state.js';
+
+export default defineAgentTool<{ limit?: number; group_id?: string }>({
+  description: '查询当前群或指定群的签到积分排行榜',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      limit: { type: 'number', description: '返回数量，默认 10，最多 50' },
+      group_id: { type: 'string', description: '群 ID；省略时使用当前 IM 会话' },
+    },
+  },
+  requiresApproval: 'never',
+  async execute({ limit, group_id: requestedGroupId }, context) {
+    const model = getCheckinModel(context.use(groupSuiteRuntimeToken).db);
+    if (!model) return '签到数据库尚未就绪';
+    const groupId = requestedGroupId
+      ?? (context.origin.kind === 'im' && context.origin.scope !== 'private'
+        ? context.origin.sceneId
+        : '');
+    const rows = groupId
+      ? await model.select().where({ context_type: 'group', context_id: groupId })
+      : await model.select();
+    const count = Math.min(Math.max(Number(limit) || 10, 1), 50);
+    const ranked = [...rows]
+      .sort((left, right) => Number(right.points ?? 0) - Number(left.points ?? 0))
+      .slice(0, count);
+    if (ranked.length === 0) return '暂无排行数据';
+    return ranked.map((user, index) =>
+      `${index + 1}. ${String(user.user_name ?? user.user_id)} — ${Number(user.points ?? 0)}分 (连续${Number(user.streak ?? 0)}天)`,
+    ).join('\n');
+  },
+});

package/skills/group-daily-analysis/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: group-daily-analysis
+description: >-
+  群日常分析：查询群消息数量、参与人数和成员活跃度，并生成群公告文本。
+  用户询问今日、本周、本月群统计、成员活跃度或需要整理公告时使用。
+keywords:
+  - 群分析
+  - 日常分析
+  - 群统计
+  - 活跃
+  - 报告
+tags:
+  - group
+  - analysis
+  - stats
+  - inbox
+tools:
+  - stats_query
+  - stats_user
+  - group_announce
+---
+
+# 群日常分析
+
+基于运行时统计数据分析群活跃度，并在需要时生成统一格式的群公告文本。
+
+## 能力
+
+- 统计群消息数量、参与人数、活跃时段分布
+- 查询指定成员的今日、本周和累计消息数
+- 生成群公告或通知文本
+- 支持按群启用/禁用分析功能
+- 定时任务自动生成分析报告推送到群内
+- 通过聊天命令管理分析设置
+
+`group_announce` 只生成文本，不直接发送消息；发送仍走统一消息链路。

package/skills/group-daily-analysis/tools/group_announce/index.js

@@ -0,0 +1,14 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+export default defineAgentTool({
+    description: '生成群聊公告或通知消息',
+    inputSchema: {
+        type: 'object',
+        properties: { message: { type: 'string', description: '公告内容' } },
+        required: ['message'],
+    },
+    requiresApproval: 'never',
+    execute({ message }) {
+        return `📢 群公告：\n${message}`;
+    },
+});

package/skills/group-daily-analysis/tools/group_announce/index.ts

@@ -0,0 +1,14 @@
+import { defineAgentTool } from '@zhin.js/tool';
+
+export default defineAgentTool<{ message: string }>({
+  description: '生成群聊公告或通知消息',
+  inputSchema: {
+    type: 'object',
+    properties: { message: { type: 'string', description: '公告内容' } },
+    required: ['message'],
+  },
+  requiresApproval: 'never',
+  execute({ message }) {
+    return `📢 群公告：\n${message}`;
+  },
+});

package/skills/group-daily-analysis/tools/stats_query/index.js

@@ -0,0 +1,35 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { groupSuiteRuntimeToken } from "../../../../lib/runtime-state.js";
+import { flushStatsBuffer, monthStartStr, queryStats, weekStartStr } from "../../../../lib/stats-lib.js";
+import { todayStr } from "../../../../lib/shared-runtime.js";
+export default defineAgentTool({
+    description: '查询当前群或指定群的消息统计',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            group_id: { type: 'string', description: '群 ID；省略时使用当前 IM 会话' },
+            period: { type: 'string', enum: ['today', 'week', 'month'], description: '统计时段' },
+        },
+    },
+    requiresApproval: 'never',
+    async execute({ group_id: requestedGroupId, period = 'today' }, context) {
+        const runtime = context.use(groupSuiteRuntimeToken);
+        await flushStatsBuffer(runtime);
+        const groupId = requestedGroupId
+            ?? (context.origin.kind === 'im' && context.origin.scope !== 'private'
+                ? context.origin.sceneId
+                : '');
+        const fromDate = period === 'week'
+            ? weekStartStr()
+            : period === 'month' ? monthStartStr() : todayStr();
+        const stats = await queryStats(groupId, fromDate, runtime);
+        if (stats.size === 0)
+            return `${period} 暂无消息统计数据`;
+        const ranked = [...stats.values()].sort((left, right) => right.count - left.count);
+        const total = ranked.reduce((sum, item) => sum + item.count, 0);
+        const lines = ranked.slice(0, 10)
+            .map((item, index) => `${index + 1}. ${item.name} — ${item.count}条`);
+        return `消息统计 (${period})\n总消息: ${total}条, 活跃用户: ${stats.size}人\n${lines.join('\n')}`;
+    },
+});

package/skills/group-daily-analysis/tools/stats_query/index.ts

@@ -0,0 +1,36 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { groupSuiteRuntimeToken } from '../../../../src/runtime-state.js';
+import { flushStatsBuffer, monthStartStr, queryStats, weekStartStr } from '../../../../src/stats-lib.js';
+import { todayStr } from '../../../../src/shared-runtime.js';
+
+type Period = 'today' | 'week' | 'month';
+
+export default defineAgentTool<{ group_id?: string; period?: Period }>({
+  description: '查询当前群或指定群的消息统计',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      group_id: { type: 'string', description: '群 ID；省略时使用当前 IM 会话' },
+      period: { type: 'string', enum: ['today', 'week', 'month'], description: '统计时段' },
+    },
+  },
+  requiresApproval: 'never',
+  async execute({ group_id: requestedGroupId, period = 'today' }, context) {
+    const runtime = context.use(groupSuiteRuntimeToken);
+    await flushStatsBuffer(runtime);
+    const groupId = requestedGroupId
+      ?? (context.origin.kind === 'im' && context.origin.scope !== 'private'
+        ? context.origin.sceneId
+        : '');
+    const fromDate = period === 'week'
+      ? weekStartStr()
+      : period === 'month' ? monthStartStr() : todayStr();
+    const stats = await queryStats(groupId, fromDate, runtime);
+    if (stats.size === 0) return `${period} 暂无消息统计数据`;
+    const ranked = [...stats.values()].sort((left, right) => right.count - left.count);
+    const total = ranked.reduce((sum, item) => sum + item.count, 0);
+    const lines = ranked.slice(0, 10)
+      .map((item, index) => `${index + 1}. ${item.name} — ${item.count}条`);
+    return `消息统计 (${period})\n总消息: ${total}条, 活跃用户: ${stats.size}人\n${lines.join('\n')}`;
+  },
+});

package/skills/group-daily-analysis/tools/stats_user/index.js

@@ -0,0 +1,50 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineAgentTool } from '@zhin.js/tool';
+import { getStatsModel } from "../../../../lib/db-store.js";
+import { groupSuiteRuntimeToken } from "../../../../lib/runtime-state.js";
+import { todayStr } from "../../../../lib/shared-runtime.js";
+import { flushStatsBuffer, weekStartStr } from "../../../../lib/stats-lib.js";
+export default defineAgentTool({
+    description: '查询指定用户在当前群或指定群的消息统计',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            user_id: { type: 'string', description: '用户 ID' },
+            group_id: { type: 'string', description: '群 ID；省略时使用当前 IM 会话' },
+        },
+        required: ['user_id'],
+    },
+    requiresApproval: 'never',
+    async execute({ user_id: userId, group_id: requestedGroupId }, context) {
+        const runtime = context.use(groupSuiteRuntimeToken);
+        await flushStatsBuffer(runtime);
+        const model = getStatsModel(runtime.db);
+        if (!model)
+            return '统计数据库尚未就绪';
+        const groupId = requestedGroupId
+            ?? (context.origin.kind === 'im' && context.origin.scope !== 'private'
+                ? context.origin.sceneId
+                : '');
+        const rows = await model.select().where({
+            user_id: userId,
+            ...(groupId ? { group_id: groupId } : {}),
+        });
+        if (rows.length === 0)
+            return `用户 ${userId} 暂无消息记录`;
+        const today = todayStr();
+        const weekStart = weekStartStr();
+        let todayCount = 0;
+        let weekCount = 0;
+        let totalCount = 0;
+        for (const row of rows) {
+            const count = Number(row.count ?? 0);
+            totalCount += count;
+            if (String(row.date) >= weekStart)
+                weekCount += count;
+            if (row.date === today)
+                todayCount += count;
+        }
+        const name = String(rows[0].user_name ?? userId);
+        return `${name} 的统计\n今日: ${todayCount}条\n本周: ${weekCount}条\n总计: ${totalCount}条\n活跃天数: ${rows.length}天`;
+    },
+});

package/skills/group-daily-analysis/tools/stats_user/index.ts

@@ -0,0 +1,46 @@
+import { defineAgentTool } from '@zhin.js/tool';
+import { getStatsModel } from '../../../../src/db-store.js';
+import { groupSuiteRuntimeToken } from '../../../../src/runtime-state.js';
+import { todayStr } from '../../../../src/shared-runtime.js';
+import { flushStatsBuffer, weekStartStr } from '../../../../src/stats-lib.js';
+
+export default defineAgentTool<{ user_id: string; group_id?: string }>({
+  description: '查询指定用户在当前群或指定群的消息统计',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      user_id: { type: 'string', description: '用户 ID' },
+      group_id: { type: 'string', description: '群 ID；省略时使用当前 IM 会话' },
+    },
+    required: ['user_id'],
+  },
+  requiresApproval: 'never',
+  async execute({ user_id: userId, group_id: requestedGroupId }, context) {
+    const runtime = context.use(groupSuiteRuntimeToken);
+    await flushStatsBuffer(runtime);
+    const model = getStatsModel(runtime.db);
+    if (!model) return '统计数据库尚未就绪';
+    const groupId = requestedGroupId
+      ?? (context.origin.kind === 'im' && context.origin.scope !== 'private'
+        ? context.origin.sceneId
+        : '');
+    const rows = await model.select().where({
+      user_id: userId,
+      ...(groupId ? { group_id: groupId } : {}),
+    });
+    if (rows.length === 0) return `用户 ${userId} 暂无消息记录`;
+    const today = todayStr();
+    const weekStart = weekStartStr();
+    let todayCount = 0;
+    let weekCount = 0;
+    let totalCount = 0;
+    for (const row of rows) {
+      const count = Number(row.count ?? 0);
+      totalCount += count;
+      if (String(row.date) >= weekStart) weekCount += count;
+      if (row.date === today) todayCount += count;
+    }
+    const name = String(rows[0]!.user_name ?? userId);
+    return `${name} 的统计\n今日: ${todayCount}条\n本周: ${weekCount}条\n总计: ${totalCount}条\n活跃天数: ${rows.length}天`;
+  },
+});

package/src/checkin-lib.ts

@@ -50,30 +50,32 @@ async function getOrCreateUser(
  * 同一 user_id+context 的签到串行化（per-user promise 链），
  * 避免 check-then-act 竞态导致连发两条都签到成功。
  */
-const checkinChains = new Map<string, Promise<unknown>>();
-
-function serializedCheckin<T>(key: string, task: () => Promise<T>): Promise<T> {
-  const prev = checkinChains.get(key) ?? Promise.resolve();
+function serializedCheckin<T>(
+  chains: Map<string, Promise<unknown>>,
+  key: string,
+  task: () => Promise<T>,
+): Promise<T> {
+  const prev = chains.get(key) ?? Promise.resolve();
   const next = prev.then(task, task);
-  checkinChains.set(key, next);
+  chains.set(key, next);
   return next.finally(() => {
-    if (checkinChains.get(key) === next) checkinChains.delete(key);
+    if (chains.get(key) === next) chains.delete(key);
   });
 }
 
 export async function doCheckin(
   input: { sender?: { readonly id: string; readonly name?: string }; target?: string; metadata?: Readonly<Record<string, unknown>> },
   cfg: GroupSuiteConfig,
-  runtime?: GroupSuiteRuntime,
+  runtime: GroupSuiteRuntime,
 ): Promise<string> {
-  const M = getCheckinModel(runtime?.db);
+  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);
-  return serializedCheckin(`${userId}:${ctxType}:${ctxId}`, async () => {
+  return serializedCheckin(runtime.checkinChains, `${userId}:${ctxType}:${ctxId}`, async () => {
     const user = await getOrCreateUser(M, userId, userName, ctxType, ctxId);
     if (!user) return '签到失败，请重试';
 
@@ -112,9 +114,9 @@ export async function doCheckin(
 
 export async function myPoints(
   input: { sender?: { readonly id: string; readonly name?: string }; target?: string; metadata?: Readonly<Record<string, unknown>> },
-  runtime?: GroupSuiteRuntime,
+  runtime: GroupSuiteRuntime,
 ): Promise<string> {
-  const M = getCheckinModel(runtime?.db);
+  const M = getCheckinModel(runtime.db);
   if (!M) return '签到数据库尚未就绪';
   const { id: userId } = resolveSender(input);
   const { type: ctxType, id: ctxId } = resolveContextKey(input);
@@ -139,9 +141,9 @@ export async function myPoints(
 export async function pointsRank(
   input: { sender?: { readonly id: string; readonly name?: string }; target?: string; metadata?: Readonly<Record<string, unknown>> },
   cfg: GroupSuiteConfig,
-  runtime?: GroupSuiteRuntime,
+  runtime: GroupSuiteRuntime,
 ): Promise<string> {
-  const M = getCheckinModel(runtime?.db);
+  const M = getCheckinModel(runtime.db);
   if (!M) return '签到数据库尚未就绪';
   const { type: ctxType, id: ctxId } = resolveContextKey(input);
   const all = (await M.select().where(

package/src/db-store.ts

@@ -1,51 +1,19 @@
 import {
   CHECKIN_TABLE,
-  createInMemoryGroupSuiteDb,
   STATS_TABLE,
   TEACH_TABLE,
   type GroupSuiteMemoryDb,
   type GroupSuiteModel,
 } from './memory-store.js';
 
-let _db: GroupSuiteMemoryDb | null = null;
-const registrations: Array<{ readonly value: GroupSuiteMemoryDb }> = [];
-
-/** Ensure an in-memory store when Runtime DatabaseFeature Resource is not wired yet. */
-export function ensureGroupSuiteMemoryDb(): GroupSuiteMemoryDb {
-  if (!_db) _db = createInMemoryGroupSuiteDb();
-  return _db;
-}
-
-export function getGroupSuiteDb(): GroupSuiteMemoryDb | null {
-  return registrations[registrations.length - 1]?.value ?? ensureGroupSuiteMemoryDb();
-}
-
-export function setGroupSuiteDb(db: GroupSuiteMemoryDb | null): void {
-  _db = db;
-}
-
-export function registerGroupSuiteDb(db: GroupSuiteMemoryDb): () => void {
-  const registration = Object.freeze({ value: db });
-  registrations.push(registration);
-  return () => {
-    const index = registrations.lastIndexOf(registration);
-    if (index >= 0) registrations.splice(index, 1);
-  };
-}
-
-/** Test helper: clear module store. */
-export function resetGroupSuiteDb(): void {
-  _db = null;
-}
-
-export function getCheckinModel(db = getGroupSuiteDb()): GroupSuiteModel | null {
-  return db?.models.get(CHECKIN_TABLE) ?? null;
+export function getCheckinModel(db: GroupSuiteMemoryDb): GroupSuiteModel | undefined {
+  return db.models.get(CHECKIN_TABLE);
 }
 
-export function getTeachModel(db = getGroupSuiteDb()): GroupSuiteModel | null {
-  return db?.models.get(TEACH_TABLE) ?? null;
+export function getTeachModel(db: GroupSuiteMemoryDb): GroupSuiteModel | undefined {
+  return db.models.get(TEACH_TABLE);
 }
 
-export function getStatsModel(db = getGroupSuiteDb()): GroupSuiteModel | null {
-  return db?.models.get(STATS_TABLE) ?? null;
+export function getStatsModel(db: GroupSuiteMemoryDb): GroupSuiteModel | undefined {
+  return db.models.get(STATS_TABLE);
 }

package/src/index.ts

@@ -9,17 +9,11 @@ export {
   listKeywords,
   matchKeyword,
   removeKeyword,
-  resetKeywords,
 } from './keyword-store.js';
 export {
-  ensureGroupSuiteMemoryDb,
   getCheckinModel,
-  getGroupSuiteDb,
   getStatsModel,
   getTeachModel,
-  resetGroupSuiteDb,
-  registerGroupSuiteDb,
-  setGroupSuiteDb,
 } from './db-store.js';
 export {
   createGroupSuiteRuntime,
@@ -29,7 +23,6 @@ export {
 export type { GroupSuiteRuntime, PendingStatsIncrement } from './runtime-state.js';
 export {
   parseTeachPair,
-  resetTeachCooldown,
   teachAdd,
   teachForget,
   teachList,
@@ -41,7 +34,6 @@ export {
   myStatsText,
   queryStats,
   recordMessage,
-  resetStatsBuffer,
   statsRankText,
   weekStartStr,
 } from './stats-lib.js';

package/src/keyword-store.ts

@@ -1,24 +1,18 @@
-const keywords = new Map<string, string>();
-
-export function addKeyword(keyword: string, reply: string, store = keywords): void {
+export function addKeyword(keyword: string, reply: string, store: Map<string, string>): void {
   store.set(keyword, reply);
 }
 
-export function removeKeyword(keyword: string, store = keywords): boolean {
+export function removeKeyword(keyword: string, store: Map<string, string>): boolean {
   return store.delete(keyword);
 }
 
-export function listKeywords(store = keywords): Array<[string, string]> {
+export function listKeywords(store: Map<string, string>): Array<[string, string]> {
   return Array.from(store.entries());
 }
 
-export function matchKeyword(text: string, store = keywords): string | null {
+export function matchKeyword(text: string, store: Map<string, string>): string | null {
   for (const [keyword, reply] of store) {
     if (text.includes(keyword)) return reply;
   }
   return null;
 }
-
-export function resetKeywords(): void {
-  keywords.clear();
-}

package/src/memory-store.ts

@@ -1,5 +1,5 @@
 /**
- * In-memory group-suite models (slice-2) until Plugin Runtime DatabaseFeature Resource lands.
+ * In-memory group-suite models used when no DatabaseHost is available.
  *
  * 模型表面与 `@zhin.js/plugin-runtime` 的 DatabaseHostModel 结构兼容
  * （where 返回 PromiseLike，host 侧是链式 Selection），

package/src/runtime-state.ts

@@ -15,6 +15,7 @@ export interface GroupSuiteRuntime {
   readonly keywords: Map<string, string>;
   readonly teachCooldowns: Map<string, number>;
   readonly statsBuffer: Map<string, PendingStatsIncrement>;
+  readonly checkinChains: Map<string, Promise<unknown>>;
 }
 
 export const groupSuiteRuntimeToken = createToken<GroupSuiteRuntime>(
@@ -28,17 +29,13 @@ export function createGroupSuiteRuntime(db: GroupSuiteMemoryDb): GroupSuiteRunti
     keywords: new Map(),
     teachCooldowns: new Map(),
     statsBuffer: new Map(),
+    checkinChains: new Map(),
   };
 }
 
 export function resolveGroupSuiteRuntime(context: {
-  owner?: { id?: unknown };
+  readonly owner?: unknown;
   use<T>(token: Token<T>): T;
-}): GroupSuiteRuntime | undefined {
-  try {
-    return context.use(groupSuiteRuntimeToken);
-  } catch (error) {
-    if (context.owner?.id) throw error;
-    return undefined;
-  }
+}): GroupSuiteRuntime {
+  return context.use(groupSuiteRuntimeToken);
 }