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

package/middlewares/keyword-reply/index.ts

@@ -0,0 +1,37 @@
+import { defineMiddleware } from 'zhin.js/middleware';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../../src/config.js';
+import { matchKeyword } from '../../src/keyword-store.js';
+import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
+
+/**
+ * Keyword auto-reply (enabled via config.keywordReply).
+ * Uses Runtime Message.content / metadata (legacy used $raw / $channel).
+ */
+export default defineMiddleware<Message, GroupSuiteConfig>({
+  target: 'inbound',
+  async handle(context, next) {
+    const config = resolveGroupSuiteConfig(context.config);
+    if (!config.keywordReply) {
+      await next();
+      return;
+    }
+    const meta = context.input.metadata ?? {};
+    const channelType = String(meta.type ?? meta.channelType ?? '');
+    if (channelType === 'private') {
+      await next();
+      return;
+    }
+    const text = typeof context.input.content === 'string' ? context.input.content.trim() : '';
+    if (!text) {
+      await next();
+      return;
+    }
+    const reply = matchKeyword(text, resolveGroupSuiteRuntime(context).keywords);
+    if (reply) {
+      await context.input.$reply(reply);
+      return;
+    }
+    await next();
+  },
+});

package/middlewares/stats-count/index.js

@@ -0,0 +1,20 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineMiddleware } from 'zhin.js/middleware';
+import { recordMessage } from "../../lib/stats-lib.js";
+import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
+/**
+ * Buffer inbound messages into in-memory message_stats (flushed on query).
+ * Skips command messages (legacy used `isActionMessage` to skip interactive
+ * action/command messages; the Runtime pipeline represents commands as
+ * text starting with the dispatcher prefix '/').
+ */
+export default defineMiddleware({
+    target: 'inbound',
+    async handle(context, next) {
+        const content = typeof context.input.content === 'string' ? context.input.content : '';
+        if (!content.startsWith('/')) {
+            recordMessage(context.input, resolveGroupSuiteRuntime(context));
+        }
+        await next();
+    },
+});

package/middlewares/stats-count/index.ts

@@ -0,0 +1,22 @@
+import { defineMiddleware } from 'zhin.js/middleware';
+import type { Message } from '@zhin.js/core/runtime';
+import type { GroupSuiteConfig } from '../../src/config.js';
+import { recordMessage } from '../../src/stats-lib.js';
+import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
+
+/**
+ * Buffer inbound messages into in-memory message_stats (flushed on query).
+ * Skips command messages (legacy used `isActionMessage` to skip interactive
+ * action/command messages; the Runtime pipeline represents commands as
+ * text starting with the dispatcher prefix '/').
+ */
+export default defineMiddleware<Message, GroupSuiteConfig>({
+  target: 'inbound',
+  async handle(context, next) {
+    const content = typeof context.input.content === 'string' ? context.input.content : '';
+    if (!content.startsWith('/')) {
+      recordMessage(context.input, resolveGroupSuiteRuntime(context));
+    }
+    await next();
+  },
+});

package/middlewares/teach-reply/index.js

@@ -0,0 +1,21 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineMiddleware } from 'zhin.js/middleware';
+import { resolveGroupSuiteConfig } from "../../lib/config.js";
+import { tryTeachReply } from "../../lib/teach-lib.js";
+import { resolveGroupSuiteRuntime } from "../../lib/runtime-state.js";
+/**
+ * Teach Q&A auto-reply (exact / optional regex).
+ * Uses Runtime Message.content / metadata.
+ */
+export default defineMiddleware({
+    target: 'inbound',
+    async handle(context, next) {
+        const config = resolveGroupSuiteConfig(context.config);
+        const reply = await tryTeachReply(context.input, config, resolveGroupSuiteRuntime(context));
+        if (reply) {
+            await context.input.$reply(reply);
+            return;
+        }
+        await next();
+    },
+});

package/middlewares/teach-reply/index.ts

@@ -0,0 +1,22 @@
+import { defineMiddleware } from 'zhin.js/middleware';
+import type { Message } from '@zhin.js/core/runtime';
+import { resolveGroupSuiteConfig, type GroupSuiteConfig } from '../../src/config.js';
+import { tryTeachReply } from '../../src/teach-lib.js';
+import { resolveGroupSuiteRuntime } from '../../src/runtime-state.js';
+
+/**
+ * Teach Q&A auto-reply (exact / optional regex).
+ * Uses Runtime Message.content / metadata.
+ */
+export default defineMiddleware<Message, GroupSuiteConfig>({
+  target: 'inbound',
+  async handle(context, next) {
+    const config = resolveGroupSuiteConfig(context.config);
+    const reply = await tryTeachReply(context.input, config, resolveGroupSuiteRuntime(context));
+    if (reply) {
+      await context.input.$reply(reply);
+      return;
+    }
+    await next();
+  },
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhin.js/plugin-group-suite",
-  "version": "1.0.1",
-  "description": "Zhin.js 群运营套件 — 群管、签到、统计、日常分析、问答（合并原 5 个插件）",
+  "version": "1.1.2",
+  "description": "Zhin.js 群运营套件 — slice-2 checkin/teach/stats + keywords (Plugin Runtime, in-memory)",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -14,11 +14,13 @@
     "./package.json": "./package.json"
   },
   "files": [
+    "plugin.js",
+    "schema.json",
+    "commands",
+    "middlewares",
     "src",
     "lib",
     "skills",
-    "tools",
-    "plugin.yml",
     "README.md"
   ],
   "keywords": [
@@ -29,8 +31,7 @@
     "group",
     "checkin",
     "stats",
-    "teach",
-    "welcome"
+    "teach"
   ],
   "author": {
     "name": "lc-cn",
@@ -39,19 +40,31 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@zhin.js/satori": "0.2.13"
+    "@zhin.js/core": "1.1.37",
+    "@zhin.js/satori": "1.1.0",
+    "@zhin.js/tool": "1.1.1",
+    "@zhin.js/skill": "1.1.1"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
-    "zhin.js": "2.0.1",
-    "@zhin.js/plugin-html-renderer": "1.0.1"
+    "vitest": "^4.1.10",
+    "zod": "^4.4.3",
+    "zhin.js": "1.1.2"
   },
   "peerDependencies": {
-    "zhin.js": "2.0.1",
-    "@zhin.js/plugin-html-renderer": "1.0.1"
+    "zod": "^4.0.0",
+    "@zhin.js/command": "^1.1.1",
+    "@zhin.js/middleware": "^1.1.1",
+    "zhin.js": "^1.1.2"
   },
   "peerDependenciesMeta": {
-    "@zhin.js/plugin-html-renderer": {
+    "@zhin.js/command": {
+      "optional": true
+    },
+    "@zhin.js/middleware": {
+      "optional": true
+    },
+    "zod": {
       "optional": true
     }
   },
@@ -64,8 +77,38 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.js",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/command",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/middleware",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/tool",
+        "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/skill",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
+  },
   "scripts": {
-    "build": "tsc --build",
-    "clean": "rimraf lib"
+    "build": "tsc",
+    "clean": "rimraf lib",
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/utils/group-suite/tests"
   }
 }

package/plugin.js

@@ -0,0 +1,38 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { definePlugin, databaseHostToken } from 'zhin.js';
+import { createInMemoryGroupSuiteDb } from "./lib/memory-store.js";
+import { createGroupSuiteRuntime, groupSuiteRuntimeToken } from "./lib/runtime-state.js";
+import { flushStatsBuffer } from "./lib/stats-lib.js";
+import { defineGroupSuiteTables } from "./lib/tables.js";
+/**
+ * Plugin Runtime:
+ * - checkin / teach / stats commands + keyword middleware
+ * - DB: prefer `databaseHostToken`; else in-memory fallback
+ * - Stats buffer: periodic flush every 10s + final flush on dispose
+ */
+export default definePlugin({
+    name: 'group-suite',
+    metadata: {
+        displayName: 'Group Suite',
+    },
+    setup(context) {
+        // host 与 memory 模型表面结构兼容（where 均返回 PromiseLike），可直接互换。
+        const db = (() => {
+            if (context.resources.has(databaseHostToken)) {
+                const host = context.resources.use(databaseHostToken);
+                defineGroupSuiteTables(host);
+                return host;
+            }
+            return createInMemoryGroupSuiteDb();
+        })();
+        const runtime = createGroupSuiteRuntime(db);
+        context.resources.provide(groupSuiteRuntimeToken, runtime);
+        const flushTimer = setInterval(() => {
+            void flushStatsBuffer(runtime);
+        }, 10_000);
+        context.lifecycle.add(async () => {
+            clearInterval(flushTimer);
+            await flushStatsBuffer(runtime);
+        });
+    },
+});

package/schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "keywordReply": { "type": "boolean", "default": false },
+    "basePointsMin": { "type": "number", "default": 10 },
+    "basePointsMax": { "type": "number", "default": 30 },
+    "streakBonus": { "type": "number", "default": 5 },
+    "streakCap": { "type": "number", "default": 50 },
+    "rankSize": { "type": "number", "default": 10 },
+    "teachMaxPerGroup": { "type": "number", "default": 200 },
+    "teachCooldownMs": { "type": "number", "default": 3000 },
+    "teachAllowRegex": { "type": "boolean", "default": true },
+    "teachPageSize": { "type": "number", "default": 10 }
+  }
+}

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

@@ -1,8 +1,8 @@
 ---
 name: group-daily-analysis
 description: >-
-  群日常分析：基于收件箱统计群消息数量、参与人数、活跃时段，
-  支持按群启用/禁用和定时分析报告。通过命令和定时任务运行，无 AI 工具。
+  群日常分析：查询群消息数量、参与人数和成员活跃度，并生成群公告文本。
+  用户询问今日、本周、本月群统计、成员活跃度或需要整理公告时使用。
 keywords:
   - 群分析
   - 日常分析
@@ -14,16 +14,23 @@ tags:
   - analysis
   - stats
   - inbox
-tools: []
+tools:
+  - stats_query
+  - stats_user
+  - group_announce
 ---
 
 # 群日常分析
 
-基于收件箱数据自动分析群活跃度。无 AI 工具可调用。
+基于运行时统计数据分析群活跃度，并在需要时生成统一格式的群公告文本。
 
 ## 能力
 
 - 统计群消息数量、参与人数、活跃时段分布
+- 查询指定成员的今日、本周和累计消息数
+- 生成群公告或通知文本
 - 支持按群启用/禁用分析功能
 - 定时任务自动生成分析报告推送到群内
 - 通过聊天命令管理分析设置
+
+`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}天`;
+    },
+});