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

package/lib/stats-lib.js

@@ -0,0 +1,173 @@
+import { getStatsModel } from './db-store.js';
+import { resolveSender, todayStr, ts, } from './shared-runtime.js';
+import { buildStatsRankReportData, formatMyStatsText, formatRankText, } from './stats-data.js';
+export function weekStartStr() {
+    const d = new Date();
+    const day = d.getDay() || 7;
+    d.setDate(d.getDate() - day + 1);
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`;
+}
+export function monthStartStr() {
+    const d = new Date();
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-01`;
+}
+const buffer = new Map();
+function bufferKey(userId, groupId, date) {
+    return `${userId}:${groupId}:${date}`;
+}
+export function resolveGroupId(input) {
+    const meta = input.metadata ?? {};
+    const channelType = String(meta.type ?? meta.channelType ?? '');
+    if (channelType === 'group' || channelType === 'guild') {
+        return String(input.target ?? meta.channelId ?? '');
+    }
+    if (input.target && channelType !== 'private') {
+        return String(input.target);
+    }
+    return '';
+}
+export function recordMessage(input, runtime) {
+    const targetBuffer = runtime?.statsBuffer ?? buffer;
+    const { id: userId, name: userName } = resolveSender(input);
+    if (!userId)
+        return;
+    const groupId = resolveGroupId(input);
+    const key = bufferKey(userId, groupId, todayStr());
+    const pending = targetBuffer.get(key);
+    if (pending) {
+        pending.count++;
+        pending.user_name = userName;
+    }
+    else {
+        targetBuffer.set(key, {
+            user_id: userId,
+            user_name: userName,
+            group_id: groupId,
+            date: todayStr(),
+            count: 1,
+        });
+    }
+}
+export async function flushStatsBuffer(runtime) {
+    const targetBuffer = runtime?.statsBuffer ?? buffer;
+    const M = getStatsModel(runtime?.db);
+    if (!M || targetBuffer.size === 0)
+        return;
+    const entries = [...targetBuffer.values()];
+    targetBuffer.clear();
+    for (const entry of entries) {
+        try {
+            const existing = (await M.select().where({
+                user_id: entry.user_id,
+                group_id: entry.group_id,
+                date: entry.date,
+            }));
+            if (existing.length > 0) {
+                await M.update({
+                    count: Number(existing[0].count || 0) + entry.count,
+                    user_name: entry.user_name,
+                    updated_at: ts(),
+                }).where({
+                    user_id: entry.user_id,
+                    group_id: entry.group_id,
+                    date: entry.date,
+                });
+            }
+            else {
+                await M.insert({
+                    user_id: entry.user_id,
+                    user_name: entry.user_name,
+                    group_id: entry.group_id,
+                    date: entry.date,
+                    count: entry.count,
+                    updated_at: ts(),
+                });
+            }
+        }
+        catch {
+            /* single row failure */
+        }
+    }
+}
+export async function queryStats(groupId, fromDate, runtime) {
+    const M = getStatsModel(runtime?.db);
+    if (!M)
+        return new Map();
+    const all = (groupId
+        ? await M.select().where({ group_id: groupId })
+        : await M.select());
+    const result = new Map();
+    for (const row of all) {
+        if (String(row.date) < fromDate)
+            continue;
+        const userId = String(row.user_id);
+        const existing = result.get(userId);
+        if (existing) {
+            existing.count += Number(row.count || 0);
+            if (row.user_name)
+                existing.name = String(row.user_name);
+        }
+        else {
+            result.set(userId, {
+                name: String(row.user_name || row.user_id),
+                count: Number(row.count || 0),
+            });
+        }
+    }
+    return result;
+}
+export async function statsRankText(input, cfg, fromDate, title, runtime) {
+    await flushStatsBuffer(runtime);
+    const groupId = resolveGroupId(input);
+    const stats = await queryStats(groupId, fromDate, runtime);
+    const { id: userId } = resolveSender(input);
+    const data = buildStatsRankReportData(stats, title, cfg.rankSize, userId);
+    return formatRankText(data);
+}
+export async function myStatsText(input, runtime) {
+    await flushStatsBuffer(runtime);
+    const M = getStatsModel(runtime?.db);
+    if (!M)
+        return '统计数据库尚未就绪';
+    const { id: userId, name: userName } = resolveSender(input);
+    if (!userId)
+        return '无法获取用户信息';
+    const groupId = resolveGroupId(input);
+    const rows = (groupId
+        ? await M.select().where({ user_id: userId, group_id: groupId })
+        : await M.select().where({ user_id: userId }));
+    if (rows.length === 0)
+        return '暂无你的消息记录';
+    const today = todayStr();
+    const weekStart = weekStartStr();
+    const monthStart = monthStartStr();
+    let todayCount = 0;
+    let weekCount = 0;
+    let monthCount = 0;
+    let totalCount = 0;
+    for (const row of rows) {
+        const c = Number(row.count || 0);
+        totalCount += c;
+        if (String(row.date) >= monthStart)
+            monthCount += c;
+        if (String(row.date) >= weekStart)
+            weekCount += c;
+        if (row.date === today)
+            todayCount += c;
+    }
+    const data = {
+        userName: userName || '你',
+        scope: groupId ? '本群' : '全局',
+        todayCount,
+        weekCount,
+        monthCount,
+        totalCount,
+        activeDays: rows.length,
+    };
+    return formatMyStatsText(data);
+}
+/** Test helper */
+export function resetStatsBuffer() {
+    buffer.clear();
+}
+//# sourceMappingURL=stats-lib.js.map

package/lib/stats-lib.js.map

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

package/lib/tables.d.ts

@@ -0,0 +1,4 @@
+export declare function defineGroupSuiteTables(db: {
+    define: (name: string, schema: Record<string, unknown>) => void;
+}): void;
+//# sourceMappingURL=tables.d.ts.map

package/lib/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../src/tables.ts"],"names":[],"mappings":"AASA,wBAAgB,sBAAsB,CACpC,EAAE,EAAE;IAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;CAAE,GACtE,IAAI,CAkCN"}

package/lib/tables.js

@@ -0,0 +1,40 @@
+/**
+ * Group-suite table schemas for DatabaseHost / legacy DatabaseFeature.
+ */
+import { CHECKIN_TABLE, TEACH_TABLE, STATS_TABLE, } from './memory-store.js';
+export function defineGroupSuiteTables(db) {
+    db.define(CHECKIN_TABLE, {
+        user_id: { type: 'text', nullable: false },
+        user_name: { type: 'text', default: '' },
+        points: { type: 'integer', default: 0 },
+        total_checkins: { type: 'integer', default: 0 },
+        streak: { type: 'integer', default: 0 },
+        max_streak: { type: 'integer', default: 0 },
+        last_checkin: { type: 'text', default: '' },
+        context_type: { type: 'text', default: 'global' },
+        context_id: { type: 'text', default: '' },
+        created_at: { type: 'text', default: '' },
+        updated_at: { type: 'text', default: '' },
+    });
+    db.define(TEACH_TABLE, {
+        question: { type: 'text', nullable: false },
+        answer: { type: 'text', nullable: false },
+        is_regex: { type: 'integer', default: 0 },
+        context_type: { type: 'text', default: 'global' },
+        context_id: { type: 'text', default: '' },
+        creator_id: { type: 'text', default: '' },
+        creator_name: { type: 'text', default: '' },
+        hit_count: { type: 'integer', default: 0 },
+        created_at: { type: 'text', default: '' },
+        updated_at: { type: 'text', default: '' },
+    });
+    db.define(STATS_TABLE, {
+        user_id: { type: 'text', nullable: false },
+        user_name: { type: 'text', default: '' },
+        group_id: { type: 'text', default: '' },
+        date: { type: 'text', nullable: false },
+        count: { type: 'integer', default: 0 },
+        updated_at: { type: 'text', default: '' },
+    });
+}
+//# sourceMappingURL=tables.js.map

package/lib/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../src/tables.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,MAAM,UAAU,sBAAsB,CACpC,EAAuE;IAEvE,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE;QACvB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC1C,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACxC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QACvC,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QAC/C,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QACvC,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QAC3C,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QAC3C,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE;QACjD,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACzC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACzC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;KAC1C,CAAC,CAAC;IACH,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE;QACrB,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC3C,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QACzC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QACzC,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE;QACjD,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACzC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACzC,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QAC3C,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QAC1C,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACzC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;KAC1C,CAAC,CAAC;IACH,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE;QACrB,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QAC1C,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACxC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QACvC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE;QACvC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QACtC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;KAC1C,CAAC,CAAC;AACL,CAAC"}

package/lib/teach-lib.d.ts

@@ -0,0 +1,22 @@
+import type { GroupSuiteConfig } from './config.js';
+import type { GroupSuiteRuntime } from './runtime-state.js';
+export declare const TEACH_USAGE_HINT = "\u683C\u5F0F\uFF1Ateach \u5173\u952E\u8BCD \u56DE\u7B54\uFF08\u56DE\u7B54\u53EF\u542B\u7A7A\u683C\uFF09\uFF0C\u6216 teach \u95EE\u9898|\u7B54\u6848";
+export declare function parseTeachPair(raw: string): {
+    question: string;
+    answer: string;
+} | null;
+type MessageInput = {
+    sender?: string;
+    target?: string;
+    content?: unknown;
+    metadata?: Readonly<Record<string, unknown>>;
+};
+export declare function teachAdd(input: MessageInput, cfg: GroupSuiteConfig, payload: string, regex?: boolean, runtime?: GroupSuiteRuntime): Promise<string>;
+export declare function teachList(input: MessageInput, cfg: GroupSuiteConfig, page?: number, runtime?: GroupSuiteRuntime): Promise<string>;
+export declare function teachForget(input: MessageInput, questionRaw: string, runtime?: GroupSuiteRuntime): Promise<string>;
+/** Try teach auto-reply; returns reply text or null. */
+export declare function tryTeachReply(input: MessageInput, cfg: GroupSuiteConfig, runtime?: GroupSuiteRuntime): Promise<string | null>;
+/** Test helper */
+export declare function resetTeachCooldown(): void;
+export {};
+//# sourceMappingURL=teach-lib.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"teach-lib.d.ts","sourceRoot":"","sources":["../src/teach-lib.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAOpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAI5D,eAAO,MAAM,gBAAgB,wJACY,CAAC;AAa1C,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAevF;AAkCD,KAAK,YAAY,GAAG;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC9C,CAAC;AAiCF,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,UAAQ,EACb,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAqEjB;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,gBAAgB,EACrB,IAAI,SAAI,EACR,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED,wDAAwD;AACxD,wBAAsB,aAAa,CACjC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,gBAAgB,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6CxB;AAED,kBAAkB;AAClB,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/lib/teach-lib.js

@@ -0,0 +1,233 @@
+import { getTeachModel } from './db-store.js';
+import { resolveContextKey, resolveSender, ts, } from './shared-runtime.js';
+const cooldownMap = new Map();
+export const TEACH_USAGE_HINT = '格式：teach 关键词 回答（回答可含空格），或 teach 问题|答案';
+function isSafeRegex(pattern) {
+    if (pattern.length > 200)
+        return false;
+    if (/(\+|\*|\{)\)?(\+|\*|\{)/.test(pattern))
+        return false;
+    if (/\([^)]*(\+|\*)[^)]*(\+|\*)[^)]*\)[+*]/.test(pattern))
+        return false;
+    const altGroups = pattern.match(/\([^)]*\|[^)]*\)/g) || [];
+    for (const g of altGroups) {
+        if ((g.match(/\|/g) || []).length > 10)
+            return false;
+    }
+    return true;
+}
+export function parseTeachPair(raw) {
+    if (!raw)
+        return null;
+    const pipe = raw.indexOf('|');
+    if (pipe >= 0) {
+        const question = raw.slice(0, pipe).trim();
+        const answer = raw.slice(pipe + 1).trim();
+        if (question && answer)
+            return { question, answer };
+        return null;
+    }
+    const lastSpace = raw.lastIndexOf(' ');
+    if (lastSpace < 0)
+        return null;
+    const question = raw.slice(0, lastSpace).trim();
+    const answer = raw.slice(lastSpace + 1).trim();
+    if (!question || !answer)
+        return null;
+    return { question, answer };
+}
+function processAnswer(answer, sender, match) {
+    let result = answer;
+    result = result.replace(/\{sender\}/g, sender.name || '你');
+    result = result.replace(/\{sender\.id\}/g, sender.id || '');
+    result = result.replace(/\{time\}/g, new Date().toLocaleTimeString('zh-CN'));
+    result = result.replace(/\{date\}/g, new Date().toLocaleDateString('zh-CN'));
+    if (match) {
+        for (let i = 1; i < match.length; i++) {
+            result = result.replace(new RegExp(`\\$${i}`, 'g'), match[i] || '');
+        }
+    }
+    return result;
+}
+function qaWhereKey(row) {
+    return {
+        question: row.question,
+        context_type: row.context_type,
+        context_id: row.context_id,
+        is_regex: row.is_regex ? 1 : 0,
+    };
+}
+async function findMatch(content, ctxType, ctxId, cfg, runtime) {
+    const QA = getTeachModel(runtime?.db);
+    if (!QA)
+        return null;
+    const allItems = (await QA.select());
+    const candidates = allItems.filter((item) => item.context_type === 'global' ||
+        (item.context_type === ctxType && item.context_id === ctxId));
+    for (const item of candidates) {
+        if (!item.is_regex && item.question === content)
+            return item;
+    }
+    if (cfg.teachAllowRegex) {
+        for (const item of candidates) {
+            if (!item.is_regex)
+                continue;
+            try {
+                if (new RegExp(String(item.question), 'i').test(content))
+                    return item;
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return null;
+}
+export async function teachAdd(input, cfg, payload, regex = false, runtime) {
+    const QA = getTeachModel(runtime?.db);
+    if (!QA)
+        return '问答数据库尚未就绪，请稍后重试';
+    if (regex && !cfg.teachAllowRegex)
+        return '管理员已禁用正则问答';
+    const parsed = parseTeachPair(payload.trim());
+    if (!parsed) {
+        return regex
+            ? '格式：teach-regex 正则 回答，或 teach-regex 正则|回答'
+            : TEACH_USAGE_HINT;
+    }
+    const { question, answer } = parsed;
+    if (regex) {
+        try {
+            new RegExp(question, 'i');
+        }
+        catch (e) {
+            return `正则表达式不合法: ${e.message}`;
+        }
+        if (!isSafeRegex(question))
+            return '该正则可能导致性能问题，请简化';
+    }
+    const { type: ctxType, id: ctxId } = resolveContextKey(input);
+    const sender = resolveSender(input);
+    if (ctxType === 'group') {
+        const existing = (await QA.select().where({
+            context_type: ctxType,
+            context_id: ctxId,
+        }));
+        if (existing.length >= cfg.teachMaxPerGroup) {
+            return `该群问答数已达上限 (${cfg.teachMaxPerGroup})`;
+        }
+    }
+    const duplicate = (await QA.select().where({
+        question,
+        context_type: ctxType,
+        context_id: ctxId,
+    }));
+    if (duplicate.length > 0 && !regex) {
+        await QA.update({ answer, updated_at: ts() }).where(qaWhereKey(duplicate[0]));
+        return `已更新问答：「${question}」→「${answer}」`;
+    }
+    await QA.insert({
+        question,
+        answer,
+        is_regex: regex ? 1 : 0,
+        context_type: ctxType,
+        context_id: ctxId,
+        creator_id: sender.id,
+        creator_name: sender.name,
+        hit_count: 0,
+        created_at: ts(),
+        updated_at: ts(),
+    });
+    return regex
+        ? `学会了！匹配 /${question}/ 的消息我会回复「${answer}」`
+        : `学会了！发送「${question}」我会回复「${answer}」`;
+}
+export async function teachList(input, cfg, page = 1, runtime) {
+    const QA = getTeachModel(runtime?.db);
+    if (!QA)
+        return '问答数据库尚未就绪';
+    const safePage = Math.max(1, page);
+    const { type: ctxType, id: ctxId } = resolveContextKey(input);
+    const allItems = (await QA.select().where(ctxType === 'global'
+        ? { context_type: 'global' }
+        : { context_type: ctxType, context_id: ctxId }));
+    if (allItems.length === 0)
+        return '还没有教过任何问答哦～';
+    const totalPages = Math.ceil(allItems.length / cfg.teachPageSize);
+    const pageNum = Math.min(safePage, totalPages);
+    const start = (pageNum - 1) * cfg.teachPageSize;
+    const pageItems = allItems.slice(start, start + cfg.teachPageSize);
+    const lines = pageItems.map((item, i) => {
+        const prefix = item.is_regex ? '[正则]' : '[精确]';
+        const q = item.is_regex ? `/${item.question}/` : item.question;
+        return `${start + i + 1}. ${prefix} ${q} → ${item.answer}`;
+    });
+    const header = ctxType === 'global' ? '全局问答列表' : '本群问答列表';
+    return `${header}\n${lines.join('\n')}\n第 ${pageNum}/${totalPages} 页 · 共 ${allItems.length} 条`;
+}
+export async function teachForget(input, questionRaw, runtime) {
+    const QA = getTeachModel(runtime?.db);
+    if (!QA)
+        return '问答数据库尚未就绪';
+    const question = questionRaw.trim();
+    if (!question)
+        return '请提供要删除的问题';
+    const { type: ctxType, id: ctxId } = resolveContextKey(input);
+    const items = (await QA.select().where({
+        question,
+        context_type: ctxType,
+        context_id: ctxId,
+    }));
+    if (items.length === 0)
+        return `没有找到问题「${question}」`;
+    await QA.delete().where(qaWhereKey(items[0]));
+    return `已忘记「${question}」的回答`;
+}
+/** Try teach auto-reply; returns reply text or null. */
+export async function tryTeachReply(input, cfg, runtime) {
+    const content = typeof input.content === 'string' ? input.content.trim() : '';
+    if (!content)
+        return null;
+    const { type: ctxType, id: ctxId } = resolveContextKey(input);
+    const matched = await findMatch(content, ctxType, ctxId, cfg, runtime);
+    if (!matched)
+        return null;
+    const cooldownKey = `${matched.question}:${ctxType}:${ctxId}:${matched.is_regex ?? 0}`;
+    const cooldowns = runtime?.teachCooldowns ?? cooldownMap;
+    const last = cooldowns.get(cooldownKey);
+    if (last && Date.now() - last < cfg.teachCooldownMs)
+        return null;
+    cooldowns.set(cooldownKey, Date.now());
+    const QA = getTeachModel(runtime?.db);
+    if (QA) {
+        try {
+            await QA.update({
+                hit_count: Number(matched.hit_count || 0) + 1,
+                updated_at: ts(),
+            }).where(qaWhereKey(matched));
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    const sender = resolveSender(input);
+    let answer = String(matched.answer ?? '');
+    if (matched.is_regex) {
+        try {
+            const m = content.match(new RegExp(String(matched.question), 'i'));
+            answer = processAnswer(answer, sender, m || undefined);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    else {
+        answer = processAnswer(answer, sender);
+    }
+    return answer;
+}
+/** Test helper */
+export function resetTeachCooldown() {
+    cooldownMap.clear();
+}
+//# sourceMappingURL=teach-lib.js.map

package/lib/teach-lib.js.map

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

package/middlewares/keyword-reply.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.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.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();
+  },
+});