@zhin.js/plugin-group-suite 1.1.21 → 1.1.23

package/README.md

@@ -73,6 +73,7 @@ group-suite:
 | `keyword-add <keyword> <reply...>` / `keyword-list` / `keyword-remove <keyword>` | 当前群词库 |
 | `welcomeMessage` | 当前群增加成员时欢迎，默认关闭，只在设置非空文本后发送 |
 | `skills/<name>/tools/<tool>/index.ts` | Skill 激活后披露签到查询、排行、统计和群公告 Tool |
+| `pages/index` + `pluginConsoleRpcToken` | Console「群管套件」页面（`group-suite:read`），展示签到记录数、问答词条数、签到排行榜与关键词问答规则 |
 
 关键词与问答修改命令要求群主、管理员、master 或 trusted；普通成员不能修改。查询命令仍按其
 各自公开 permit 执行。Tool 保持既有审批策略，命令角色判断不能替代 Tool 审批或平台权限。

package/lib/console.d.ts

@@ -0,0 +1,27 @@
+import { type PluginConsoleRpc } from 'zhin.js';
+import { type GroupSuiteRuntime } from './runtime-state.js';
+export declare const GROUP_SUITE_CONSOLE_PAGE = "index";
+export declare const GROUP_SUITE_READ_PERMISSION = "group-suite:read";
+export interface GroupSuiteCheckinLeaderboardRow {
+    readonly userId: string;
+    readonly groupId: string;
+    readonly totalDays: number;
+    readonly streakDays: number;
+    readonly points: number;
+    readonly lastDate: string;
+}
+export interface GroupSuiteKeywordRow {
+    readonly groupId: string;
+    readonly keyword: string;
+    readonly reply: string;
+    readonly creatorId: string;
+}
+export interface GroupSuiteConsoleStatus {
+    readonly checkinCount: number;
+    readonly keywordCount: number;
+    readonly dailyStatsCount: number;
+    readonly topCheckins: readonly GroupSuiteCheckinLeaderboardRow[];
+    readonly keywords: readonly GroupSuiteKeywordRow[];
+}
+export declare function createGroupSuiteConsoleRpc(defaultRuntime?: GroupSuiteRuntime): PluginConsoleRpc;
+//# sourceMappingURL=console.d.ts.map

package/lib/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../src/console.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EAItB,MAAM,SAAS,CAAC;AAQjB,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEpF,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAChD,eAAO,MAAM,2BAA2B,qBAAqB,CAAC;AAE9D,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,SAAS,+BAA+B,EAAE,CAAC;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACpD;AAoGD,wBAAgB,0BAA0B,CACxC,cAAc,CAAC,EAAE,iBAAiB,GACjC,gBAAgB,CAkClB"}

package/lib/console.js

@@ -0,0 +1,130 @@
+import { definePluginConsoleRpc, } from 'zhin.js';
+import { CHECKIN_TABLE, STATS_TABLE, TEACH_TABLE, } from './memory-store.js';
+import { groupSuiteRuntimeToken } from './runtime-state.js';
+export const GROUP_SUITE_CONSOLE_PAGE = 'index';
+export const GROUP_SUITE_READ_PERMISSION = 'group-suite:read';
+function resolveRuntime(call, fallbackRuntime) {
+    const runtimeWithUse = call.runtime;
+    if (typeof runtimeWithUse?.use === 'function') {
+        try {
+            const resolved = runtimeWithUse.use(groupSuiteRuntimeToken);
+            if (resolved)
+                return resolved;
+        }
+        catch {
+            // Fall back to the plugin setup runtime when call.runtime.use is unavailable.
+        }
+    }
+    return fallbackRuntime;
+}
+async function queryModelRows(model) {
+    if (!model || typeof model.select !== 'function')
+        return [];
+    try {
+        const selection = model.select();
+        if (Array.isArray(selection))
+            return selection;
+        if (selection && typeof selection.then === 'function') {
+            const rows = await selection;
+            return Array.isArray(rows) ? rows : [];
+        }
+        if (selection && typeof selection.where === 'function') {
+            const rows = await selection.where({});
+            return Array.isArray(rows) ? rows : [];
+        }
+    }
+    catch {
+        // Handle any database query failure gracefully.
+    }
+    return [];
+}
+async function readTableRows(runtime, tableNames) {
+    const getModel = runtime?.db?.models?.get?.bind(runtime.db.models);
+    if (typeof getModel !== 'function')
+        return [];
+    const collected = [];
+    const visited = new Set();
+    for (const name of tableNames) {
+        let model;
+        try {
+            model = getModel(name);
+        }
+        catch {
+            model = undefined;
+        }
+        if (!model || visited.has(model))
+            continue;
+        visited.add(model);
+        const rows = await queryModelRows(model);
+        if (rows.length > 0)
+            collected.push(...rows);
+    }
+    return collected;
+}
+function mapCheckinRow(row) {
+    return {
+        userId: String(row.userId ?? row.user_id ?? ''),
+        groupId: String(row.groupId ?? row.group_id ?? row.context_id ?? ''),
+        totalDays: Number(row.totalDays ?? row.total_days ?? row.total_checkins ?? 0) || 0,
+        streakDays: Number(row.streakDays ?? row.streak_days ?? row.streak ?? 0) || 0,
+        points: Number(row.points ?? 0) || 0,
+        lastDate: String(row.lastDate ?? row.last_date ?? row.last_checkin ?? ''),
+    };
+}
+function mapKeywordRow(row) {
+    return {
+        groupId: String(row.groupId ?? row.group_id ?? row.context_id ?? ''),
+        keyword: String(row.keyword ?? row.question ?? ''),
+        reply: String(row.reply ?? row.answer ?? ''),
+        creatorId: String(row.creatorId ?? row.creator_id ?? ''),
+    };
+}
+function collectEphemeralKeywords(runtime) {
+    if (!runtime?.keywords)
+        return [];
+    const rows = [];
+    for (const [groupId, entries] of runtime.keywords.entries()) {
+        for (const [keyword, reply] of entries.entries()) {
+            rows.push({
+                groupId,
+                keyword,
+                reply,
+                creatorId: '',
+            });
+        }
+    }
+    return rows;
+}
+export function createGroupSuiteConsoleRpc(defaultRuntime) {
+    return definePluginConsoleRpc({
+        status: {
+            page: GROUP_SUITE_CONSOLE_PAGE,
+            requiredPermissions: [GROUP_SUITE_READ_PERMISSION],
+            async handler(_input, call) {
+                const runtime = resolveRuntime(call, defaultRuntime);
+                const [checkinRows, keywordDbRows, statsRows] = await Promise.all([
+                    readTableRows(runtime, ['group_checkin', CHECKIN_TABLE]),
+                    readTableRows(runtime, ['group_keywords', TEACH_TABLE]),
+                    readTableRows(runtime, ['group_daily_stats', STATS_TABLE]),
+                ]);
+                const mappedCheckins = checkinRows.map(mapCheckinRow);
+                const topCheckins = [...mappedCheckins]
+                    .sort((a, b) => (b.points - a.points) || (b.totalDays - a.totalDays))
+                    .slice(0, 20);
+                const mappedKeywords = [
+                    ...keywordDbRows.map(mapKeywordRow),
+                    ...collectEphemeralKeywords(runtime),
+                ];
+                const keywords = mappedKeywords.slice(0, 50);
+                return {
+                    checkinCount: mappedCheckins.length,
+                    keywordCount: mappedKeywords.length,
+                    dailyStatsCount: statsRows.length,
+                    topCheckins: topCheckins,
+                    keywords: keywords,
+                };
+            },
+        },
+    });
+}
+//# sourceMappingURL=console.js.map

package/lib/console.js.map

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

package/lib/index.d.ts

@@ -7,4 +7,6 @@ export { createGroupSuiteRuntime, groupSuiteRuntimeToken, resolveGroupSuiteRunti
 export type { GroupSuiteRuntime, PendingStatsIncrement } from './runtime-state.js';
 export { parseTeachPair, teachAdd, teachForget, teachList, tryTeachReply, } from './teach-lib.js';
 export { flushStatsBuffer, monthStartStr, myStatsText, queryStats, recordMessage, statsRankText, weekStartStr, } from './stats-lib.js';
+export { createGroupSuiteConsoleRpc, GROUP_SUITE_CONSOLE_PAGE, GROUP_SUITE_READ_PERMISSION, } from './console.js';
+export type { GroupSuiteCheckinLeaderboardRow, GroupSuiteConsoleStatus, GroupSuiteKeywordRow, } from './console.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EACL,cAAc,EACd,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EACL,cAAc,EACd,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,+BAA+B,EAC/B,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,cAAc,CAAC"}

package/lib/index.js

@@ -5,4 +5,5 @@ export { getCheckinModel, getStatsModel, getTeachModel, } from './db-store.js';
 export { createGroupSuiteRuntime, groupSuiteRuntimeToken, resolveGroupSuiteRuntime, } from './runtime-state.js';
 export { parseTeachPair, teachAdd, teachForget, teachList, tryTeachReply, } from './teach-lib.js';
 export { flushStatsBuffer, monthStartStr, myStatsText, queryStats, recordMessage, statsRankText, weekStartStr, } from './stats-lib.js';
+export { createGroupSuiteConsoleRpc, GROUP_SUITE_CONSOLE_PAGE, GROUP_SUITE_READ_PERMISSION, } from './console.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,cAAc,EACd,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,cAAc,EACd,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,cAAc,CAAC"}

package/lib/runtime-state.d.ts

@@ -19,7 +19,8 @@ export interface GroupSuiteRuntime {
     statsFlush?: Promise<void>;
     readonly checkinChains: Map<string, Promise<unknown>>;
 }
-export declare const groupSuiteRuntimeToken: Token<GroupSuiteRuntime>;
+export declare const groupSuiteRuntimeStore: import("zhin.js").PluginStore<GroupSuiteRuntime, unknown>;
+export declare const groupSuiteRuntimeToken: import("zhin.js").PluginStore<GroupSuiteRuntime, unknown>;
 export declare function createGroupSuiteRuntime(db: GroupSuiteMemoryDb): GroupSuiteRuntime;
 export declare function resolveGroupSuiteRuntime(context: {
     readonly owner?: unknown;

package/lib/runtime-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-state.d.ts","sourceRoot":"","sources":["../src/runtime-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,kBAAkB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACzD,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;CACvD;AAED,eAAO,MAAM,sBAAsB,0BAGlC,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,kBAAkB,GAAG,iBAAiB,CAQjF;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CAC5B,GAAG,iBAAiB,CAEpB"}
+{"version":3,"file":"runtime-state.d.ts","sourceRoot":"","sources":["../src/runtime-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,kBAAkB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACzD,gFAAgF;IAChF,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;CACvD;AAED,eAAO,MAAM,sBAAsB,2DAGlC,CAAC;AACF,eAAO,MAAM,sBAAsB,2DAAyB,CAAC;AAE7D,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,kBAAkB,GAAG,iBAAiB,CAQjF;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CAC5B,GAAG,iBAAiB,CAEpB"}

package/lib/runtime-state.js

@@ -1,5 +1,6 @@
-import { createToken } from 'zhin.js';
-export const groupSuiteRuntimeToken = createToken('zhin.group-suite.runtime', 'Owner-scoped Group Suite database and ephemeral state');
+import { definePluginStore } from 'zhin.js';
+export const groupSuiteRuntimeStore = definePluginStore('zhin.group-suite.runtime', 'Owner-scoped Group Suite database and ephemeral state');
+export const groupSuiteRuntimeToken = groupSuiteRuntimeStore;
 export function createGroupSuiteRuntime(db) {
     return {
         db,
@@ -10,6 +11,6 @@ export function createGroupSuiteRuntime(db) {
     };
 }
 export function resolveGroupSuiteRuntime(context) {
-    return context.use(groupSuiteRuntimeToken);
+    return groupSuiteRuntimeStore.use(context);
 }
 //# sourceMappingURL=runtime-state.js.map

package/lib/runtime-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-state.js","sourceRoot":"","sources":["../src/runtime-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,SAAS,CAAC;AAwBlD,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAC/C,0BAA0B,EAC1B,uDAAuD,CACxD,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,EAAsB;IAC5D,OAAO;QACL,EAAE;QACF,QAAQ,EAAE,IAAI,GAAG,EAAE;QACnB,cAAc,EAAE,IAAI,GAAG,EAAE;QACzB,WAAW,EAAE,IAAI,GAAG,EAAE;QACtB,aAAa,EAAE,IAAI,GAAG,EAAE;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAGxC;IACC,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"runtime-state.js","sourceRoot":"","sources":["../src/runtime-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAc,MAAM,SAAS,CAAC;AAwBxD,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CACrD,0BAA0B,EAC1B,uDAAuD,CACxD,CAAC;AACF,MAAM,CAAC,MAAM,sBAAsB,GAAG,sBAAsB,CAAC;AAE7D,MAAM,UAAU,uBAAuB,CAAC,EAAsB;IAC5D,OAAO;QACL,EAAE;QACF,QAAQ,EAAE,IAAI,GAAG,EAAE;QACnB,cAAc,EAAE,IAAI,GAAG,EAAE;QACzB,WAAW,EAAE,IAAI,GAAG,EAAE;QACtB,aAAa,EAAE,IAAI,GAAG,EAAE;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAGxC;IACC,OAAO,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/plugin-group-suite",
-  "version": "1.1.21",
+  "version": "1.1.23",
   "description": "Zhin.js 群运营套件：签到、教学、统计、持久词库与群欢迎",
   "type": "module",
   "main": "./lib/index.js",
@@ -19,6 +19,7 @@
     "middlewares",
     "handlers",
     "schedules",
+    "pages",
     "src",
     "lib",
     "skills",
@@ -41,25 +42,28 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@zhin.js/components": "1.1.10",
-    "@zhin.js/core": "1.1.56",
-    "@zhin.js/jsx": "1.1.10",
-    "@zhin.js/skill": "1.1.13",
-    "@zhin.js/tool": "1.1.15"
+    "@zhin.js/components": "1.1.12",
+    "@zhin.js/console-contract": "1.1.4",
+    "@zhin.js/core": "1.1.58",
+    "@zhin.js/jsx": "1.1.12",
+    "@zhin.js/page": "1.1.16",
+    "@zhin.js/skill": "1.1.15",
+    "@zhin.js/tool": "1.1.17"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "zhin.js": "1.1.21"
+    "zhin.js": "1.1.23"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/command": "^1.1.14",
-    "@zhin.js/middleware": "^1.1.13",
-    "zhin.js": "^1.1.21",
-    "@zhin.js/handler": "^1.1.12",
-    "@zhin.js/schedule-feature": "^1.1.12"
+    "@zhin.js/command": "^1.1.16",
+    "@zhin.js/middleware": "^1.1.15",
+    "@zhin.js/page": "^1.1.16",
+    "zhin.js": "^1.1.23",
+    "@zhin.js/handler": "^1.1.14",
+    "@zhin.js/schedule-feature": "^1.1.14"
   },
   "peerDependenciesMeta": {
     "@zhin.js/command": {
@@ -68,6 +72,9 @@
     "@zhin.js/middleware": {
       "optional": true
     },
+    "@zhin.js/page": {
+      "optional": true
+    },
     "zod": {
       "optional": true
     },
@@ -120,6 +127,10 @@
       {
         "package": "@zhin.js/schedule-feature",
         "api": "^1.0.0"
+      },
+      {
+        "package": "@zhin.js/page",
+        "api": "^1.0.0"
       }
     ],
     "plugins": []

package/pages/index/index.js

@@ -0,0 +1,56 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { definePage, createDeclarativePage } from '@zhin.js/console-contract';
+export const meta = definePage({
+    title: '群管套件',
+    titleI18n: { en: 'Group Suite' },
+    icon: 'Users',
+    order: 54,
+    requiredPermissions: ['group-suite:read'],
+});
+export default createDeclarativePage({
+    title: { zh: '群管套件', en: 'Group Suite' },
+    description: {
+        zh: '群签到积分排行榜与关键词问答规则概览',
+        en: 'Group check-in leaderboard and keyword Q&A rules overview',
+    },
+    stats: [
+        {
+            key: 'checkinCount',
+            label: { zh: '签到记录数', en: 'Check-in Records' },
+            value: 'checkinCount',
+        },
+        {
+            key: 'keywordCount',
+            label: { zh: '问答词条数', en: 'Keyword Rules' },
+            value: 'keywordCount',
+        },
+    ],
+    sections: [
+        {
+            id: 'topCheckins',
+            title: { zh: '签到排行榜', en: 'Check-in Leaderboard' },
+            emptyText: { zh: '暂无签到记录', en: 'No check-in records yet' },
+            items: 'topCheckins',
+            columns: [
+                { key: 'userId', label: { zh: '用户 ID', en: 'User ID' } },
+                { key: 'groupId', label: { zh: '群号 / 范围', en: 'Group ID' } },
+                { key: 'points', label: { zh: '积分', en: 'Points' } },
+                { key: 'totalDays', label: { zh: '累计天数', en: 'Total Days' } },
+                { key: 'streakDays', label: { zh: '连续天数', en: 'Streak Days' } },
+                { key: 'lastDate', label: { zh: '最近签到', en: 'Last Date' } },
+            ],
+        },
+        {
+            id: 'keywords',
+            title: { zh: '关键词问答规则', en: 'Keyword Q&A Rules' },
+            emptyText: { zh: '暂无关键词问答规则', en: 'No keyword rules configured' },
+            items: 'keywords',
+            columns: [
+                { key: 'groupId', label: { zh: '群号 / 范围', en: 'Group ID' } },
+                { key: 'keyword', label: { zh: '关键词', en: 'Keyword' } },
+                { key: 'reply', label: { zh: '回复内容', en: 'Reply' } },
+                { key: 'creatorId', label: { zh: '创建者', en: 'Creator ID' } },
+            ],
+        },
+    ],
+});

package/pages/index/index.ts

@@ -0,0 +1,62 @@
+import { definePage, createDeclarativePage } from '@zhin.js/console-contract';
+import type {
+  GroupSuiteCheckinLeaderboardRow,
+  GroupSuiteConsoleStatus,
+  GroupSuiteKeywordRow,
+} from '../../src/console.js';
+
+export const meta = definePage({
+  title: '群管套件',
+  titleI18n: { en: 'Group Suite' },
+  icon: 'Users',
+  order: 54,
+  requiredPermissions: ['group-suite:read'],
+});
+
+export default createDeclarativePage<GroupSuiteConsoleStatus>({
+  title: { zh: '群管套件', en: 'Group Suite' },
+  description: {
+    zh: '群签到积分排行榜与关键词问答规则概览',
+    en: 'Group check-in leaderboard and keyword Q&A rules overview',
+  },
+  stats: [
+    {
+      key: 'checkinCount',
+      label: { zh: '签到记录数', en: 'Check-in Records' },
+      value: 'checkinCount',
+    },
+    {
+      key: 'keywordCount',
+      label: { zh: '问答词条数', en: 'Keyword Rules' },
+      value: 'keywordCount',
+    },
+  ],
+  sections: [
+    {
+      id: 'topCheckins',
+      title: { zh: '签到排行榜', en: 'Check-in Leaderboard' },
+      emptyText: { zh: '暂无签到记录', en: 'No check-in records yet' },
+      items: 'topCheckins',
+      columns: [
+        { key: 'userId', label: { zh: '用户 ID', en: 'User ID' } },
+        { key: 'groupId', label: { zh: '群号 / 范围', en: 'Group ID' } },
+        { key: 'points', label: { zh: '积分', en: 'Points' } },
+        { key: 'totalDays', label: { zh: '累计天数', en: 'Total Days' } },
+        { key: 'streakDays', label: { zh: '连续天数', en: 'Streak Days' } },
+        { key: 'lastDate', label: { zh: '最近签到', en: 'Last Date' } },
+      ] satisfies readonly { key: keyof GroupSuiteCheckinLeaderboardRow & string; label: { zh: string; en: string } }[],
+    },
+    {
+      id: 'keywords',
+      title: { zh: '关键词问答规则', en: 'Keyword Q&A Rules' },
+      emptyText: { zh: '暂无关键词问答规则', en: 'No keyword rules configured' },
+      items: 'keywords',
+      columns: [
+        { key: 'groupId', label: { zh: '群号 / 范围', en: 'Group ID' } },
+        { key: 'keyword', label: { zh: '关键词', en: 'Keyword' } },
+        { key: 'reply', label: { zh: '回复内容', en: 'Reply' } },
+        { key: 'creatorId', label: { zh: '创建者', en: 'Creator ID' } },
+      ] satisfies readonly { key: keyof GroupSuiteKeywordRow & string; label: { zh: string; en: string } }[],
+    },
+  ],
+});

package/plugin.js

@@ -1,8 +1,9 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
-import { definePlugin, databaseHostToken } from 'zhin.js';
+import { definePlugin, definePluginCapabilityGraph, databaseHostToken, pluginConsoleRpcToken, } from 'zhin.js';
 import { resolveGroupSuiteConfig } from "./lib/config.js";
+import { createGroupSuiteConsoleRpc } from "./lib/console.js";
 import { createInMemoryGroupSuiteDb } from "./lib/memory-store.js";
-import { createGroupSuiteRuntime, groupSuiteRuntimeToken } from "./lib/runtime-state.js";
+import { createGroupSuiteRuntime, groupSuiteRuntimeStore } from "./lib/runtime-state.js";
 import { defineGroupSuiteTables } from "./lib/tables.js";
 /**
  * Plugin Runtime:
@@ -15,6 +16,35 @@ export default definePlugin({
     metadata: {
         displayName: 'Group Suite',
     },
+    capabilityGraph: definePluginCapabilityGraph({
+        provides: [groupSuiteRuntimeStore, pluginConsoleRpcToken],
+        injects: [databaseHostToken],
+        features: {
+            commands: [
+                'checkin',
+                'forget',
+                'keyword-add',
+                'keyword-list',
+                'keyword-remove',
+                'mypoints',
+                'mystats',
+                'rank',
+                'stats',
+                'stats-card',
+                'stats-rank',
+                'stats-week',
+                'teach',
+                'teach-list',
+                'teach-regex',
+            ],
+            handlers: ['welcome'],
+            middlewares: ['keyword-reply', 'stats-count', 'teach-reply'],
+            schedules: ['flush-stats'],
+            skills: ['checkin', 'group-daily-analysis'],
+            tools: ['checkin_query', 'checkin_rank', 'group_announce', 'stats_query', 'stats_user'],
+            pages: ['index'],
+        },
+    }),
     setup(context) {
         // host 与 memory 模型表面结构兼容（where 均返回 PromiseLike），可直接互换。
         const db = (() => {
@@ -32,7 +62,9 @@ export default definePlugin({
                 throw new Error('Persistent keywords require a Database Host; demos may explicitly set ephemeralKeywords: true');
             void context.resources.use(databaseHostToken).state;
         }
-        const runtime = createGroupSuiteRuntime(db);
-        context.resources.provide(groupSuiteRuntimeToken, runtime);
+        const runtime = groupSuiteRuntimeStore.provide(context, createGroupSuiteRuntime(db));
+        return {
+            consoleRpc: createGroupSuiteConsoleRpc(runtime),
+        };
     },
 });

package/src/console.ts

@@ -0,0 +1,178 @@
+import {
+  definePluginConsoleRpc,
+  type PluginConsoleRpc,
+  type PluginConsoleRpcCall,
+  type PluginConsoleRpcJson,
+  type Token,
+} from 'zhin.js';
+import {
+  CHECKIN_TABLE,
+  STATS_TABLE,
+  TEACH_TABLE,
+  type GroupSuiteModel,
+  type GroupSuiteRow,
+} from './memory-store.js';
+import { groupSuiteRuntimeToken, type GroupSuiteRuntime } from './runtime-state.js';
+
+export const GROUP_SUITE_CONSOLE_PAGE = 'index';
+export const GROUP_SUITE_READ_PERMISSION = 'group-suite:read';
+
+export interface GroupSuiteCheckinLeaderboardRow {
+  readonly userId: string;
+  readonly groupId: string;
+  readonly totalDays: number;
+  readonly streakDays: number;
+  readonly points: number;
+  readonly lastDate: string;
+}
+
+export interface GroupSuiteKeywordRow {
+  readonly groupId: string;
+  readonly keyword: string;
+  readonly reply: string;
+  readonly creatorId: string;
+}
+
+export interface GroupSuiteConsoleStatus {
+  readonly checkinCount: number;
+  readonly keywordCount: number;
+  readonly dailyStatsCount: number;
+  readonly topCheckins: readonly GroupSuiteCheckinLeaderboardRow[];
+  readonly keywords: readonly GroupSuiteKeywordRow[];
+}
+
+type RuntimeWithUse = {
+  use?: <T>(token: Token<T>) => T;
+};
+
+function resolveRuntime(
+  call: PluginConsoleRpcCall,
+  fallbackRuntime?: GroupSuiteRuntime,
+): GroupSuiteRuntime | undefined {
+  const runtimeWithUse = call.runtime as RuntimeWithUse | undefined;
+  if (typeof runtimeWithUse?.use === 'function') {
+    try {
+      const resolved = runtimeWithUse.use(groupSuiteRuntimeToken);
+      if (resolved) return resolved;
+    } catch {
+      // Fall back to the plugin setup runtime when call.runtime.use is unavailable.
+    }
+  }
+  return fallbackRuntime;
+}
+
+async function queryModelRows(model: GroupSuiteModel | undefined): Promise<GroupSuiteRow[]> {
+  if (!model || typeof model.select !== 'function') return [];
+  try {
+    const selection = model.select();
+    if (Array.isArray(selection)) return selection as GroupSuiteRow[];
+    if (selection && typeof (selection as PromiseLike<GroupSuiteRow[]>).then === 'function') {
+      const rows = await selection;
+      return Array.isArray(rows) ? rows : [];
+    }
+    if (selection && typeof selection.where === 'function') {
+      const rows = await selection.where({});
+      return Array.isArray(rows) ? rows : [];
+    }
+  } catch {
+    // Handle any database query failure gracefully.
+  }
+  return [];
+}
+
+async function readTableRows(
+  runtime: GroupSuiteRuntime | undefined,
+  tableNames: readonly string[],
+): Promise<GroupSuiteRow[]> {
+  const getModel = runtime?.db?.models?.get?.bind(runtime.db.models);
+  if (typeof getModel !== 'function') return [];
+  const collected: GroupSuiteRow[] = [];
+  const visited = new Set<GroupSuiteModel>();
+  for (const name of tableNames) {
+    let model: GroupSuiteModel | undefined;
+    try {
+      model = getModel(name);
+    } catch {
+      model = undefined;
+    }
+    if (!model || visited.has(model)) continue;
+    visited.add(model);
+    const rows = await queryModelRows(model);
+    if (rows.length > 0) collected.push(...rows);
+  }
+  return collected;
+}
+
+function mapCheckinRow(row: GroupSuiteRow): GroupSuiteCheckinLeaderboardRow {
+  return {
+    userId: String(row.userId ?? row.user_id ?? ''),
+    groupId: String(row.groupId ?? row.group_id ?? row.context_id ?? ''),
+    totalDays: Number(row.totalDays ?? row.total_days ?? row.total_checkins ?? 0) || 0,
+    streakDays: Number(row.streakDays ?? row.streak_days ?? row.streak ?? 0) || 0,
+    points: Number(row.points ?? 0) || 0,
+    lastDate: String(row.lastDate ?? row.last_date ?? row.last_checkin ?? ''),
+  };
+}
+
+function mapKeywordRow(row: GroupSuiteRow): GroupSuiteKeywordRow {
+  return {
+    groupId: String(row.groupId ?? row.group_id ?? row.context_id ?? ''),
+    keyword: String(row.keyword ?? row.question ?? ''),
+    reply: String(row.reply ?? row.answer ?? ''),
+    creatorId: String(row.creatorId ?? row.creator_id ?? ''),
+  };
+}
+
+function collectEphemeralKeywords(runtime: GroupSuiteRuntime | undefined): GroupSuiteKeywordRow[] {
+  if (!runtime?.keywords) return [];
+  const rows: GroupSuiteKeywordRow[] = [];
+  for (const [groupId, entries] of runtime.keywords.entries()) {
+    for (const [keyword, reply] of entries.entries()) {
+      rows.push({
+        groupId,
+        keyword,
+        reply,
+        creatorId: '',
+      });
+    }
+  }
+  return rows;
+}
+
+export function createGroupSuiteConsoleRpc(
+  defaultRuntime?: GroupSuiteRuntime,
+): PluginConsoleRpc {
+  return definePluginConsoleRpc({
+    status: {
+      page: GROUP_SUITE_CONSOLE_PAGE,
+      requiredPermissions: [GROUP_SUITE_READ_PERMISSION],
+      async handler(_input, call): Promise<PluginConsoleRpcJson> {
+        const runtime = resolveRuntime(call, defaultRuntime);
+        const [checkinRows, keywordDbRows, statsRows] = await Promise.all([
+          readTableRows(runtime, ['group_checkin', CHECKIN_TABLE]),
+          readTableRows(runtime, ['group_keywords', TEACH_TABLE]),
+          readTableRows(runtime, ['group_daily_stats', STATS_TABLE]),
+        ]);
+
+        const mappedCheckins = checkinRows.map(mapCheckinRow);
+        const topCheckins = [...mappedCheckins]
+          .sort((a, b) => (b.points - a.points) || (b.totalDays - a.totalDays))
+          .slice(0, 20);
+
+        const mappedKeywords = [
+          ...keywordDbRows.map(mapKeywordRow),
+          ...collectEphemeralKeywords(runtime),
+        ];
+        const keywords = mappedKeywords.slice(0, 50);
+
+        return {
+          checkinCount: mappedCheckins.length,
+          keywordCount: mappedKeywords.length,
+          dailyStatsCount: statsRows.length,
+          topCheckins: topCheckins as unknown as PluginConsoleRpcJson,
+          keywords: keywords as unknown as PluginConsoleRpcJson,
+        };
+      },
+    },
+  });
+}

package/src/index.ts

@@ -38,3 +38,13 @@ export {
   statsRankText,
   weekStartStr,
 } from './stats-lib.js';
+export {
+  createGroupSuiteConsoleRpc,
+  GROUP_SUITE_CONSOLE_PAGE,
+  GROUP_SUITE_READ_PERMISSION,
+} from './console.js';
+export type {
+  GroupSuiteCheckinLeaderboardRow,
+  GroupSuiteConsoleStatus,
+  GroupSuiteKeywordRow,
+} from './console.js';

package/src/runtime-state.ts

@@ -1,4 +1,4 @@
-import { createToken, type Token } from 'zhin.js';
+import { definePluginStore, type Token } from 'zhin.js';
 import type { GroupSuiteMemoryDb } from './memory-store.js';
 
 export interface PendingStatsIncrement {
@@ -22,10 +22,11 @@ export interface GroupSuiteRuntime {
   readonly checkinChains: Map<string, Promise<unknown>>;
 }
 
-export const groupSuiteRuntimeToken = createToken<GroupSuiteRuntime>(
+export const groupSuiteRuntimeStore = definePluginStore<GroupSuiteRuntime>(
   'zhin.group-suite.runtime',
   'Owner-scoped Group Suite database and ephemeral state',
 );
+export const groupSuiteRuntimeToken = groupSuiteRuntimeStore;
 
 export function createGroupSuiteRuntime(db: GroupSuiteMemoryDb): GroupSuiteRuntime {
   return {
@@ -41,5 +42,5 @@ export function resolveGroupSuiteRuntime(context: {
   readonly owner?: unknown;
   use<T>(token: Token<T>): T;
 }): GroupSuiteRuntime {
-  return context.use(groupSuiteRuntimeToken);
+  return groupSuiteRuntimeStore.use(context);
 }