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

package/src/stats-lib.ts

@@ -25,8 +25,6 @@ export function monthStartStr(): string {
   return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-01`;
 }
 
-const buffer = new Map<string, PendingStatsIncrement>();
-
 function bufferKey(userId: string, groupId: string, date: string): string {
   return `${userId}:${groupId}:${date}`;
 }
@@ -50,8 +48,8 @@ export function recordMessage(input: {
   sender?: { readonly id: string; readonly name?: string };
   conversation?: { readonly kind?: string; readonly id?: string };
   metadata?: Readonly<Record<string, unknown>>;
-}, runtime?: GroupSuiteRuntime): void {
-  const targetBuffer = runtime?.statsBuffer ?? buffer;
+}, runtime: GroupSuiteRuntime): void {
+  const targetBuffer = runtime.statsBuffer;
   const { id: userId, name: userName } = resolveSender(input);
   if (!userId) return;
   const groupId = resolveGroupId(input);
@@ -71,9 +69,9 @@ export function recordMessage(input: {
   }
 }
 
-export async function flushStatsBuffer(runtime?: GroupSuiteRuntime): Promise<void> {
-  const targetBuffer = runtime?.statsBuffer ?? buffer;
-  const M = getStatsModel(runtime?.db);
+export async function flushStatsBuffer(runtime: GroupSuiteRuntime): Promise<void> {
+  const targetBuffer = runtime.statsBuffer;
+  const M = getStatsModel(runtime.db);
   if (!M || targetBuffer.size === 0) return;
   for (const [key, entry] of [...targetBuffer.entries()]) {
     // 快照本次要落库的计数；flush 期间新累计的部分留在缓冲
@@ -116,9 +114,9 @@ export async function flushStatsBuffer(runtime?: GroupSuiteRuntime): Promise<voi
 export async function queryStats(
   groupId: string,
   fromDate: string,
-  runtime?: GroupSuiteRuntime,
+  runtime: GroupSuiteRuntime,
 ): Promise<Map<string, { name: string; count: number }>> {
-  const M = getStatsModel(runtime?.db);
+  const M = getStatsModel(runtime.db);
   if (!M) return new Map();
   const all = (groupId
     ? await M.select().where({ group_id: groupId })
@@ -152,7 +150,7 @@ export async function statsRankText(
   cfg: GroupSuiteConfig,
   fromDate: string,
   title: string,
-  runtime?: GroupSuiteRuntime,
+  runtime: GroupSuiteRuntime,
 ): Promise<string> {
   await flushStatsBuffer(runtime);
   const groupId = resolveGroupId(input);
@@ -162,9 +160,9 @@ export async function statsRankText(
   return formatRankText(data);
 }
 
-export async function myStatsText(input: MessageInput, runtime?: GroupSuiteRuntime): Promise<string> {
+export async function myStatsText(input: MessageInput, runtime: GroupSuiteRuntime): Promise<string> {
   await flushStatsBuffer(runtime);
-  const M = getStatsModel(runtime?.db);
+  const M = getStatsModel(runtime.db);
   if (!M) return '统计数据库尚未就绪';
   const { id: userId, name: userName } = resolveSender(input);
   if (!userId) return '无法获取用户信息';
@@ -198,8 +196,3 @@ export async function myStatsText(input: MessageInput, runtime?: GroupSuiteRunti
   };
   return formatMyStatsText(data);
 }
-
-/** Test helper */
-export function resetStatsBuffer(): void {
-  buffer.clear();
-}

package/src/tables.ts

@@ -1,5 +1,5 @@
 /**
- * Group-suite table schemas for DatabaseHost / legacy DatabaseFeature.
+ * Group-suite table schemas for DatabaseHost.
  */
 import {
   CHECKIN_TABLE,

package/src/teach-lib.ts

@@ -7,8 +7,6 @@ import {
 } from './shared-runtime.js';
 import type { GroupSuiteRuntime } from './runtime-state.js';
 
-const cooldownMap = new Map<string, number>();
-
 export const TEACH_USAGE_HINT =
   '格式：teach 关键词 回答（回答可含空格），或 teach 问题|答案';
 
@@ -84,9 +82,9 @@ async function findMatch(
   ctxType: string,
   ctxId: string,
   cfg: GroupSuiteConfig,
-  runtime?: GroupSuiteRuntime,
+  runtime: GroupSuiteRuntime,
 ): Promise<Record<string, unknown> | null> {
-  const QA = getTeachModel(runtime?.db);
+  const QA = getTeachModel(runtime.db);
   if (!QA) return null;
   const allItems = (await QA.select()) as Record<string, unknown>[];
   const candidates = allItems.filter(
@@ -115,9 +113,9 @@ export async function teachAdd(
   cfg: GroupSuiteConfig,
   payload: string,
   regex = false,
-  runtime?: GroupSuiteRuntime,
+  runtime: GroupSuiteRuntime,
 ): Promise<string> {
-  const QA = getTeachModel(runtime?.db);
+  const QA = getTeachModel(runtime.db);
   if (!QA) return '问答数据库尚未就绪，请稍后重试';
   if (regex && !cfg.teachAllowRegex) return '管理员已禁用正则问答';
 
@@ -191,9 +189,9 @@ export async function teachList(
   input: MessageInput,
   cfg: GroupSuiteConfig,
   page = 1,
-  runtime?: GroupSuiteRuntime,
+  runtime: GroupSuiteRuntime,
 ): Promise<string> {
-  const QA = getTeachModel(runtime?.db);
+  const QA = getTeachModel(runtime.db);
   if (!QA) return '问答数据库尚未就绪';
   const safePage = Math.max(1, page);
   const { type: ctxType, id: ctxId } = resolveContextKey(input);
@@ -219,9 +217,9 @@ export async function teachList(
 export async function teachForget(
   input: MessageInput,
   questionRaw: string,
-  runtime?: GroupSuiteRuntime,
+  runtime: GroupSuiteRuntime,
 ): Promise<string> {
-  const QA = getTeachModel(runtime?.db);
+  const QA = getTeachModel(runtime.db);
   if (!QA) return '问答数据库尚未就绪';
   const question = questionRaw.trim();
   if (!question) return '请提供要删除的问题';
@@ -247,7 +245,7 @@ export async function teachForget(
 export async function tryTeachReply(
   input: MessageInput,
   cfg: GroupSuiteConfig,
-  runtime?: GroupSuiteRuntime,
+  runtime: GroupSuiteRuntime,
 ): Promise<string | null> {
   const content = typeof input.content === 'string' ? input.content.trim() : '';
   if (!content) return null;
@@ -256,12 +254,12 @@ export async function tryTeachReply(
   if (!matched) return null;
 
   const cooldownKey = `${matched.question}:${ctxType}:${ctxId}:${matched.is_regex ?? 0}`;
-  const cooldowns = runtime?.teachCooldowns ?? cooldownMap;
+  const cooldowns = runtime.teachCooldowns;
   const last = cooldowns.get(cooldownKey);
   if (last && Date.now() - last < cfg.teachCooldownMs) return null;
   cooldowns.set(cooldownKey, Date.now());
 
-  const QA = getTeachModel(runtime?.db);
+  const QA = getTeachModel(runtime.db);
   if (QA) {
     try {
       await QA.update({
@@ -294,8 +292,3 @@ export async function tryTeachReply(
   }
   return answer;
 }
-
-/** Test helper */
-export function resetTeachCooldown(): void {
-  cooldownMap.clear();
-}

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

@@ -1,29 +0,0 @@
----
-name: group-daily-analysis
-description: >-
-  群日常分析：基于收件箱统计群消息数量、参与人数、活跃时段，
-  支持按群启用/禁用和定时分析报告。通过命令和定时任务运行，无 AI 工具。
-keywords:
-  - 群分析
-  - 日常分析
-  - 群统计
-  - 活跃
-  - 报告
-tags:
-  - group
-  - analysis
-  - stats
-  - inbox
-tools: []
----
-
-# 群日常分析
-
-基于收件箱数据自动分析群活跃度。无 AI 工具可调用。
-
-## 能力
-
-- 统计群消息数量、参与人数、活跃时段分布
-- 支持按群启用/禁用分析功能
-- 定时任务自动生成分析报告推送到群内
-- 通过聊天命令管理分析设置

package/agent/tools/group_announce.ts

@@ -1,12 +0,0 @@
-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/tools/checkin-query/checkin-query.tool.md

@@ -1,11 +0,0 @@
----
-name: checkin_query
-description: 查询用户的签到积分信息
-parameters:
-  user_id:
-    type: string
-    description: 用户ID（可选，不填则返回统计摘要）
-tags: [签到, 积分, 查询]
-keywords: [签到, 积分, 查询积分]
-handler: ./handler.ts
----

package/tools/checkin-query/handler.js

@@ -1,22 +0,0 @@
-// Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { getCheckinModel } from "../../lib/db-store.js";
-import { todayStr } from "../../lib/shared-runtime.js";
-export default async function (args) {
-    const M = getCheckinModel();
-    if (!M)
-        return '签到数据库尚未就绪';
-    const userId = args.user_id;
-    if (userId) {
-        const rows = await M.select().where({ user_id: userId });
-        if (rows.length === 0)
-            return `用户 ${userId} 没有签到记录`;
-        const u = rows[0];
-        return `${u.user_name}: 积分=${u.points}, 累计=${u.total_checkins}天, 连续=${u.streak}天, 最长=${u.max_streak}天, 上次=${u.last_checkin}`;
-    }
-    const all = await M.select();
-    const totalUsers = all.length;
-    const totalPoints = all.reduce((s, u) => s + (u.points || 0), 0);
-    const today = todayStr();
-    const todayCount = all.filter((u) => u.last_checkin === today).length;
-    return `签到系统统计\n总用户: ${totalUsers}\n总积分: ${totalPoints}\n今日签到: ${todayCount}人`;
-}

package/tools/checkin-query/handler.ts

@@ -1,22 +0,0 @@
-import { getCheckinModel } from '../../src/db-store.js';
-import { todayStr } from '../../src/shared-runtime.js';
-
-export default async function (args: { user_id?: string }) {
-  const M = getCheckinModel();
-  if (!M) return '签到数据库尚未就绪';
-
-  const userId = args.user_id;
-  if (userId) {
-    const rows: any[] = await M.select().where({ user_id: userId });
-    if (rows.length === 0) return `用户 ${userId} 没有签到记录`;
-    const u = rows[0];
-    return `${u.user_name}: 积分=${u.points}, 累计=${u.total_checkins}天, 连续=${u.streak}天, 最长=${u.max_streak}天, 上次=${u.last_checkin}`;
-  }
-
-  const all: any[] = await M.select();
-  const totalUsers = all.length;
-  const totalPoints = all.reduce((s: number, u: any) => s + (u.points || 0), 0);
-  const today = todayStr();
-  const todayCount = all.filter((u: any) => u.last_checkin === today).length;
-  return `签到系统统计\n总用户: ${totalUsers}\n总积分: ${totalPoints}\n今日签到: ${todayCount}人`;
-}

package/tools/checkin-rank/checkin-rank.tool.md

@@ -1,11 +0,0 @@
----
-name: checkin_rank
-description: 获取积分排行榜数据
-parameters:
-  limit:
-    type: number
-    description: 返回前 N 名（默认10）
-tags: [签到, 排行]
-keywords: [排行, 积分排行, 签到排行]
-handler: ./handler.ts
----

package/tools/checkin-rank/handler.js

@@ -1,15 +0,0 @@
-// Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { getCheckinModel } from "../../lib/db-store.js";
-export default async function (args) {
-    const M = getCheckinModel();
-    if (!M)
-        return '签到数据库尚未就绪';
-    const limit = Math.min(Math.max(Number(args.limit) || 10, 1), 50);
-    const all = await M.select();
-    const sorted = all.sort((a, b) => (b.points || 0) - (a.points || 0)).slice(0, limit);
-    if (sorted.length === 0)
-        return '暂无排行数据';
-    return sorted
-        .map((u, i) => `${i + 1}. ${u.user_name || u.user_id} — ${u.points}分 (连续${u.streak}天)`)
-        .join('\n');
-}

package/tools/checkin-rank/handler.ts

@@ -1,16 +0,0 @@
-import { getCheckinModel } from '../../src/db-store.js';
-
-export default async function (args: { limit?: number }) {
-  const M = getCheckinModel();
-  if (!M) return '签到数据库尚未就绪';
-
-  const limit = Math.min(Math.max(Number(args.limit) || 10, 1), 50);
-  const all: any[] = await M.select();
-  const sorted = all.sort((a: any, b: any) => (b.points || 0) - (a.points || 0)).slice(0, limit);
-
-  if (sorted.length === 0) return '暂无排行数据';
-
-  return sorted
-    .map((u: any, i: number) => `${i + 1}. ${u.user_name || u.user_id} — ${u.points}分 (连续${u.streak}天)`)
-    .join('\n');
-}

package/tools/stats-query/handler.js

@@ -1,28 +0,0 @@
-// Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { flushStatsBuffer, queryStats, weekStartStr, monthStartStr, } from "../../lib/stats-lib.js";
-import { todayStr } from "../../lib/shared-runtime.js";
-export default async function (args) {
-    await flushStatsBuffer();
-    const groupId = args.group_id || '';
-    const period = args.period || 'today';
-    let fromDate;
-    switch (period) {
-        case 'week':
-            fromDate = weekStartStr();
-            break;
-        case 'month':
-            fromDate = monthStartStr();
-            break;
-        default:
-            fromDate = todayStr();
-            break;
-    }
-    const stats = await queryStats(groupId, fromDate);
-    if (stats.size === 0)
-        return `${period} 暂无消息统计数据`;
-    const sorted = [...stats.entries()].sort((a, b) => b[1].count - a[1].count);
-    const total = sorted.reduce((s, [, v]) => s + v.count, 0);
-    const top10 = sorted.slice(0, 10);
-    const lines = top10.map(([, v], i) => `${i + 1}. ${v.name} — ${v.count}条`);
-    return `消息统计 (${period})\n总消息: ${total}条, 活跃用户: ${stats.size}人\n${lines.join('\n')}`;
-}

package/tools/stats-query/handler.ts

@@ -1,31 +0,0 @@
-import {
-  flushStatsBuffer,
-  queryStats,
-  weekStartStr,
-  monthStartStr,
-} from '../../src/stats-lib.js';
-import { todayStr } from '../../src/shared-runtime.js';
-
-export default async function (args: { group_id?: string; period?: string }) {
-  await flushStatsBuffer();
-  const groupId = args.group_id || '';
-  const period = args.period || 'today';
-
-  let fromDate: string;
-  switch (period) {
-    case 'week': fromDate = weekStartStr(); break;
-    case 'month': fromDate = monthStartStr(); break;
-    default: fromDate = todayStr(); break;
-  }
-
-  const stats = await queryStats(groupId, fromDate);
-  if (stats.size === 0) return `${period} 暂无消息统计数据`;
-
-  const sorted = [...stats.entries()].sort((a, b) => b[1].count - a[1].count);
-  const total = sorted.reduce((s, [, v]) => s + v.count, 0);
-
-  const top10 = sorted.slice(0, 10);
-  const lines = top10.map(([, v], i) => `${i + 1}. ${v.name} — ${v.count}条`);
-
-  return `消息统计 (${period})\n总消息: ${total}条, 活跃用户: ${stats.size}人\n${lines.join('\n')}`;
-}

package/tools/stats-query/stats-query.tool.md

@@ -1,16 +0,0 @@
----
-name: stats_query
-description: 查询消息统计数据
-parameters:
-  group_id:
-    type: string
-    description: 群ID（可选，不填查全局）
-  period:
-    type: string
-    description: "时段: today/week/month（默认today）"
-    enum: [today, week, month]
-    default: today
-tags: [统计, 消息]
-keywords: [统计, 消息统计, 消息量]
-handler: ./handler.ts
----

package/tools/stats-user/handler.js

@@ -1,29 +0,0 @@
-// Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { flushStatsBuffer, weekStartStr } from "../../lib/stats-lib.js";
-import { getStatsModel } from "../../lib/db-store.js";
-import { todayStr } from "../../lib/shared-runtime.js";
-export default async function (args) {
-    await flushStatsBuffer();
-    const M = getStatsModel();
-    if (!M)
-        return '统计数据库尚未就绪';
-    const userId = args.user_id;
-    if (!userId)
-        return '请提供用户ID';
-    const rows = await M.select().where({ user_id: userId });
-    if (rows.length === 0)
-        return `用户 ${userId} 暂无消息记录`;
-    const today = todayStr();
-    const weekStart = weekStartStr();
-    let todayCount = 0, weekCount = 0, totalCount = 0;
-    for (const row of rows) {
-        const c = row.count || 0;
-        totalCount += c;
-        if (row.date >= weekStart)
-            weekCount += c;
-        if (row.date === today)
-            todayCount += c;
-    }
-    const name = rows[0].user_name || userId;
-    return `${name} 的统计\n今日: ${todayCount}条\n本周: ${weekCount}条\n总计: ${totalCount}条\n活跃天数: ${rows.length}天`;
-}

package/tools/stats-user/handler.ts

@@ -1,29 +0,0 @@
-import { flushStatsBuffer, weekStartStr } from '../../src/stats-lib.js';
-import { getStatsModel } from '../../src/db-store.js';
-import { todayStr } from '../../src/shared-runtime.js';
-
-export default async function (args: { user_id: string }) {
-  await flushStatsBuffer();
-  const M = getStatsModel();
-  if (!M) return '统计数据库尚未就绪';
-
-  const userId = args.user_id;
-  if (!userId) return '请提供用户ID';
-
-  const rows: any[] = await M.select().where({ user_id: userId });
-  if (rows.length === 0) return `用户 ${userId} 暂无消息记录`;
-
-  const today = todayStr();
-  const weekStart = weekStartStr();
-  let todayCount = 0, weekCount = 0, totalCount = 0;
-
-  for (const row of rows) {
-    const c = row.count || 0;
-    totalCount += c;
-    if (row.date >= weekStart) weekCount += c;
-    if (row.date === today) todayCount += c;
-  }
-
-  const name = rows[0].user_name || userId;
-  return `${name} 的统计\n今日: ${todayCount}条\n本周: ${weekCount}条\n总计: ${totalCount}条\n活跃天数: ${rows.length}天`;
-}

package/tools/stats-user/stats-user.tool.md

@@ -1,12 +0,0 @@
----
-name: stats_user
-description: 查询指定用户的消息统计
-parameters:
-  user_id:
-    type: string
-    description: 用户ID
-    required: true
-tags: [统计, 用户]
-keywords: [用户统计, 消息统计, 个人统计]
-handler: ./handler.ts
----