@nestim/koishi-plugin-qq-group-manager 0.1.3

package/lib/commands.d.ts

@@ -0,0 +1,4 @@
+import { Context } from 'koishi';
+import type { Config } from './index';
+import type { QQGroupManagerService } from './service';
+export declare function registerCommands(ctx: Context, service: QQGroupManagerService, config: Config): void;

package/lib/commands.js

@@ -0,0 +1,212 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCommands = registerCommands;
+function styleText(text, config) {
+    if (config.responseStyle !== 'meow')
+        return text;
+    return `喵~ ${text}`;
+}
+function formatAction(result, config, displayTarget) {
+    let text = result.message;
+    if (displayTarget && result.plan?.targetId) {
+        text = text.split(result.plan.targetId).join(displayTarget);
+    }
+    return styleText(text, config);
+}
+function registerCommands(ctx, service, config) {
+    ctx.command(`${config.menuCommand} [keyword:text]`, '查看 Meow 图片菜单')
+        .action(async ({ session }, keyword) => {
+        if (!keyword)
+            service.armMenuPairing(session, 30_000);
+        const result = await service.renderMenu(keyword, session);
+        service.logCommandResult('menu', { ok: true, message: 'menu rendered' }, session, { keyword });
+        return result;
+    });
+    ctx.command(`${config.command}菜单`, `查看 ${config.command} 分类菜单`)
+        .action(async ({ session }) => {
+        const result = await service.renderMenu(`${config.command}菜单`, session);
+        service.logCommandResult('menu-parent-shortcut', { ok: true, message: 'parent menu shortcut rendered' }, session, { parent: config.command });
+        return result;
+    });
+    const root = ctx.command(config.command, 'QQ群管理命令入口');
+    root
+        .subcommand('ping', '检查插件是否可用')
+        .action(async ({ session }) => {
+        const auth = await service.authorizeCommand('ping', session);
+        if (!auth.ok)
+            return auth.userMessage ?? '权限不足或上下文不符合要求。';
+        const result = { ok: true, message: 'qq-group-manager 已加载。' };
+        service.logCommandResult('ping', result, session);
+        return styleText(result.message, config);
+    });
+    root
+        .subcommand('查图', '识图调试：查看本条消息中被识别的图片信息')
+        .action(async ({ session }) => {
+        const auth = await service.authorizeCommand('img-debug', session);
+        if (!auth.ok)
+            return auth.userMessage ?? '权限不足或上下文不符合要求。';
+        const info = service.describeImageMessage(session);
+        const lines = [];
+        lines.push(`图片元素数量: ${info.elementImages.length}`);
+        lines.push(`CQ图片段: ${info.rawCq.length} 个`);
+        lines.push(`可发送链接: ${info.extractableUrls.length} 个`);
+        if (info.extractableUrls.length) {
+            info.extractableUrls.forEach((u, i) => lines.push(`  ${i + 1}. ${u}`));
+        }
+        else if (info.rawCq.length) {
+            lines.push('CQ图片原始片段:');
+            info.rawCq.forEach((c, i) => lines.push(`  ${i + 1}. ${c}`));
+        }
+        else if (info.elementImages.length) {
+            lines.push('图片元素原始字段:');
+            info.elementImages.forEach((im, i) => lines.push(`  ${i + 1}. ${JSON.stringify(im)}`));
+        }
+        else {
+            lines.push('本条消息未检测到图片。请在群内发送一张图片（可同时附加该指令）后重试。');
+        }
+        return styleText('识图诊断：\n' + lines.join('\n'), config);
+    });
+    root
+        .subcommand('plan <groupId:string>', '生成演练动作计划')
+        .option('reason', '-r <reason:string> 计划原因')
+        .action(async ({ session, options }, groupId) => {
+        if (!groupId)
+            return '请提供群号。';
+        const auth = await service.authorizeCommand('plan', session);
+        if (!auth.ok)
+            return auth.userMessage ?? '权限不足或上下文不符合要求。';
+        const result = await service.planDemoAction(groupId, options.reason);
+        service.logCommandResult('plan', result, session, { groupId });
+        return formatAction(result, config);
+    });
+    root
+        .subcommand('kick <target:string>', '踢出群成员')
+        .option('reject', '-r 拒绝再次加群请求')
+        .option('reason', '-m <reason:string> 操作原因')
+        .action(async ({ session, options }, target) => {
+        if (!target)
+            return '请提供目标 QQ 号或 @目标。';
+        const auth = await service.authorizeCommand('kick', session);
+        if (!auth.ok)
+            return auth.userMessage ?? '权限不足或上下文不符合要求。';
+        const result = await service.kick(session, target, options.reject, options.reason);
+        service.logCommandResult('kick', result, session, { target, reject: options.reject });
+        const displayTarget = await service.formatTargetDisplay(session, result.plan?.targetId, target);
+        return formatAction(result, config, displayTarget);
+    });
+    root
+        .subcommand('mute [target:string] [duration:string]', '禁言群成员（@用户或QQ号 + 时长，如 10分钟/1小时/1天）')
+        .option('reason', '-r <reason:string> 操作原因')
+        .action(async ({ session, options }) => {
+        // 参数由 service 从原始消息中智能解析，避免把禁言时长误判为目标 QQ 号
+        const parsed = await service.parseMuteArguments(session);
+        if (!parsed.ok) {
+            service.logCommandResult('mute', { ok: false, message: parsed.message }, session, { target: parsed.targetId });
+            return styleText(parsed.message, config);
+        }
+        const targetId = parsed.targetId;
+        const minutes = parsed.minutes;
+        if (await service.shouldSelfGag(session, targetId)) {
+            const result = await service.selfGag(session, 'mute-self-trigger');
+            service.logCommandResult('self-gag', result, session, { source: 'mute', target: targetId, minutes });
+            const displayTarget = await service.formatTargetDisplay(session, result.plan?.targetId, targetId);
+            return formatAction(result, config, displayTarget);
+        }
+        const auth = await service.authorizeCommand('mute', session);
+        if (!auth.ok) {
+            const punished = await service.punishUnauthorizedMuteAttempt(session, targetId);
+            if (punished) {
+                service.logCommandResult('punish-unauthorized-mute', punished, session, { source: 'mute', target: targetId, minutes });
+                const displayTarget = await service.formatTargetDisplay(session, punished.plan?.targetId, session?.userId);
+                return formatAction(punished, config, displayTarget);
+            }
+            return auth.userMessage ?? '权限不足或上下文不符合要求。';
+        }
+        const result = await service.mute(session, targetId, minutes, options.reason);
+        service.logCommandResult('mute', result, session, { target: targetId, minutes });
+        const displayTarget = await service.formatTargetDisplay(session, result.plan?.targetId, targetId);
+        return formatAction(result, config, displayTarget);
+    });
+    root
+        .subcommand('gag [target:string]', '口球（随机 1~60 分钟禁言）')
+        .alias('口球')
+        .alias('口气')
+        .option('reason', '-r <reason:string> 操作原因')
+        .action(async ({ session, options }, target) => {
+        if (!config.enableSelfGag)
+            return '口球娱乐功能未启用。';
+        if (!session?.userId)
+            return '无法识别当前账号。';
+        if (config.allowedUserIds.includes(session.userId))
+            return '喵~ 白名单用户不参与口球。';
+        const resolvedTarget = target || session.userId;
+        if (await service.shouldSelfGag(session, resolvedTarget)) {
+            const result = await service.selfGag(session, 'gag-trigger');
+            service.logCommandResult('self-gag', result, session, { source: 'gag', target: resolvedTarget });
+            const displayTarget = await service.formatTargetDisplay(session, result.plan?.targetId, resolvedTarget);
+            return formatAction(result, config, displayTarget);
+        }
+        const auth = await service.authorizeCommand('gag', session);
+        if (!auth.ok)
+            return auth.userMessage ?? '权限不足或上下文不符合要求。';
+        const randomMinutes = Math.floor(Math.random() * 60) + 1;
+        const result = await service.mute(session, resolvedTarget, randomMinutes, options.reason ?? 'gag');
+        service.logCommandResult('gag', result, session, { target: resolvedTarget, randomMinutes });
+        const displayTarget = await service.formatTargetDisplay(session, result.plan?.targetId, resolvedTarget);
+        return formatAction(result, config, displayTarget);
+    });
+    root
+        .subcommand('unmute <target:string>', '解除群成员禁言')
+        .option('reason', '-r <reason:string> 操作原因')
+        .action(async ({ session, options }, target) => {
+        if (!target)
+            return '请提供目标 QQ 号或 @目标。';
+        const auth = await service.authorizeCommand('unmute', session);
+        if (!auth.ok)
+            return auth.userMessage ?? '权限不足或上下文不符合要求。';
+        const result = await service.unmute(session, target, options.reason);
+        service.logCommandResult('unmute', result, session, { target });
+        const displayTarget = await service.formatTargetDisplay(session, result.plan?.targetId, target);
+        return formatAction(result, config, displayTarget);
+    });
+    root
+        .subcommand('admin <target:string> [state:string]', '设置或取消群管理员', {
+        dependencies: ['qqgm-admin'],
+        showWarning: false,
+    })
+        .option('reason', '-r <reason:string> 操作原因')
+        .action(async ({ session, options }, target, state) => {
+        if (!target)
+            return '请提供目标 QQ 号或 @目标。';
+        const auth = await service.authorizeCommand('admin', session);
+        if (!auth.ok)
+            return auth.userMessage ?? '权限不足或上下文不符合要求。';
+        const available = await service.canUseAdminCommand(session);
+        if (!available.ok)
+            return available.userMessage ?? '当前场景不可用该子命令。';
+        const normalized = (state ?? 'on').toLowerCase();
+        const enable = !(normalized === 'off' || normalized === '0' || normalized === 'false');
+        const result = await service.setAdmin(session, target, enable, options.reason);
+        service.logCommandResult('admin', result, session, { target, state: normalized });
+        const displayTarget = await service.formatTargetDisplay(session, result.plan?.targetId, target);
+        return formatAction(result, config, displayTarget);
+    });
+    root
+        .subcommand('审核 <code:string> <state:string>', '审核入群申请（同意/拒绝）')
+        .option('reason', '-r <reason:string> 审核理由')
+        .action(async ({ session, options }, code, state) => {
+        if (!code || !state)
+            return '请提供审核编号与状态（同意/拒绝）。';
+        const auth = await service.authorizeCommand('review-join-request', session);
+        if (!auth.ok)
+            return auth.userMessage ?? '权限不足或上下文不符合要求。';
+        const normalized = state.trim().toLowerCase();
+        const approve = ['同意', '通过', '放行', '批准', 'approve', 'pass', 'ok', 'yes'].includes(normalized);
+        const reject = ['拒绝', '驳回', 'deny', 'reject', 'no', 'refuse'].includes(normalized);
+        if (!approve && !reject)
+            return '状态仅支持：同意/拒绝。';
+        const result = await service.reviewJoinRequestDecision(session, code, approve, options.reason);
+        service.logCommandResult('review-join-request', result, session, { code, approve, source: 'command' });
+        return formatAction(result, config);
+    });
+}

package/lib/index.d.ts

@@ -0,0 +1,99 @@
+import { Context, Schema } from 'koishi';
+export declare const name = "qq-group-manager";
+export declare const inject: {
+    optional: string[];
+};
+export interface Config {
+    command: string;
+    menuCommand: string;
+    replaceHelpAsImageMenu: boolean;
+    replaceStatusAsImage: boolean;
+    platformFilter: string[];
+    responseStyle: 'plain' | 'meow';
+    dryRun: boolean;
+    enableSelfGag: boolean;
+    enableUnauthorizedMutePunish: boolean;
+    unauthorizedMuteAttemptThreshold: number;
+    unauthorizedMuteWindowMinutes: number;
+    unauthorizedMutePunishMinMinutes: number;
+    unauthorizedMutePunishMaxMinutes: number;
+    enableAiReply: boolean;
+    aiProvider: 'openai-compatible' | 'gemini';
+    aiApiKey: string;
+    aiBaseUrl: string;
+    aiModel: string;
+    aiAgentName: string;
+    aiSystemPrompt: string;
+    aiActivePersona: string;
+    aiPersonas: AIPersona[];
+    aiReplyMode: 'threshold' | 'random' | 'hybrid';
+    aiMessageThreshold: number;
+    aiRandomReplyProbability: number;
+    aiMinReplyIntervalSeconds: number;
+    aiContextWindow: number;
+    aiTemperature: number;
+    aiMaxOutputTokens: number;
+    aiEnableImageRecognition: boolean;
+    aiImageMaxCount: number;
+    aiIgnoreCommandMessage: boolean;
+    aiEnableDirectMentionTrigger: boolean;
+    aiEnableFollowupAfterMention: boolean;
+    aiFollowupWindowSeconds: number;
+    aiFollowupMaxTurns: number;
+    aiOwnerPlatform: string;
+    aiOwnerUserId: string;
+    aiHomePlatform: string;
+    aiHomeUserId: string;
+    aiInterestMinScore: number;
+    aiInterestContextWindow: number;
+    enableRepeater: boolean;
+    repeaterThreshold: number;
+    repeaterCooldownSeconds: number;
+    repeaterEnableGetMsgRefetch: boolean;
+    enableJoinRequestReview: boolean;
+    joinRequestReviewTtlMinutes: number;
+    bannedWords: string[];
+    blockCardMessage: boolean;
+    blockForwardMessage: boolean;
+    autoDeleteViolation: boolean;
+    sendViolationNotice: boolean;
+    enableAutoMute: boolean;
+    autoMuteViolationThreshold: number;
+    autoMuteMinutes: number;
+    enableAutoKick: boolean;
+    autoKickViolationThreshold: number;
+    autoViolationWindowMinutes: number;
+    enableMemory: boolean;
+    memoryFileName: string;
+    memoryInAi: boolean;
+    groupRules: GroupRule[];
+    allowedUserIds: string[];
+    allowGroupOwner: boolean;
+    allowGroupAdmin: boolean;
+    requireBotOwnerForAdmin: boolean;
+    allowAdminBypassWhitelistMute: boolean;
+    logCommandResult: boolean;
+    logAuthCheck: boolean;
+}
+export interface AIPersona {
+    id: string;
+    selfName: string;
+    prompt: string;
+}
+export interface GroupRule {
+    guildId: string;
+    enableAiReply?: boolean;
+    bannedWords: string[];
+    blockCardMessage: boolean;
+    blockForwardMessage: boolean;
+    autoDeleteViolation: boolean;
+    sendViolationNotice: boolean;
+    autoMuteEnabled?: boolean;
+    autoMuteThreshold?: number;
+    autoMuteMinutes?: number;
+    autoKickEnabled?: boolean;
+    autoKickThreshold?: number;
+    autoViolationWindowMinutes?: number;
+}
+export declare const Config: Schema<Config>;
+export declare function apply(ctx: Context, config: Config): void;

package/lib/index.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = exports.inject = exports.name = void 0;
+exports.apply = apply;
+const koishi_1 = require("koishi");
+const service_1 = require("./service");
+const commands_1 = require("./commands");
+exports.name = 'nestim-qq-group-manager';
+exports.inject = {
+    optional: ['puppeteer'],
+};
+exports.Config = koishi_1.Schema.intersect([
+    koishi_1.Schema.object({
+        command: koishi_1.Schema.string().default('群管').description('管理命令前缀。'),
+        menuCommand: koishi_1.Schema.string().default('菜单').description('图片菜单指令名。'),
+        replaceHelpAsImageMenu: koishi_1.Schema.boolean().default(false).description('是否接管 help 指令并输出图片菜单。'),
+        replaceStatusAsImage: koishi_1.Schema.boolean().default(true).description('是否接管 status 指令并输出 Meow 状态图片。'),
+        platformFilter: koishi_1.Schema.array(String).default(['onebot']).description('允许启用管理功能的平台列表。'),
+        responseStyle: koishi_1.Schema.union([
+            koishi_1.Schema.const('plain').description('普通输出'),
+            koishi_1.Schema.const('meow').description('Meow 风格输出'),
+        ]).role('radio').default('plain').description('群聊中指令返回的文本风格。'),
+        dryRun: koishi_1.Schema.boolean().default(false).description('演练模式：仅输出计划动作，不执行群管理操作。'),
+    }).description('基础设置'),
+    koishi_1.Schema.object({
+        bannedWords: koishi_1.Schema.array(String).role('table').default([]).description('违禁词列表（命中任意词即视为违规）。'),
+        blockCardMessage: koishi_1.Schema.boolean().default(true).description('是否禁止卡片消息（json/xml）。'),
+        blockForwardMessage: koishi_1.Schema.boolean().default(true).description('是否禁止合并转发消息（forward）。'),
+        autoDeleteViolation: koishi_1.Schema.boolean().default(true).description('违规消息是否自动撤回。'),
+        sendViolationNotice: koishi_1.Schema.boolean().default(true).description('处理违规消息后是否在群内发送提示。'),
+        groupRules: koishi_1.Schema.array(koishi_1.Schema.object({
+            guildId: koishi_1.Schema.string().required().description('群号。'),
+            enableAiReply: koishi_1.Schema.boolean().description('该群是否启用 AI 回复（留空则跟随全局设置）。'),
+            bannedWords: koishi_1.Schema.array(String).role('table').default([]).description('该群专属违禁词列表。'),
+            blockCardMessage: koishi_1.Schema.boolean().default(true).description('该群是否禁止卡片消息（json/xml）。'),
+            blockForwardMessage: koishi_1.Schema.boolean().default(true).description('该群是否禁止合并转发消息（forward）。'),
+            autoDeleteViolation: koishi_1.Schema.boolean().default(true).description('该群违规消息是否自动撤回。'),
+            sendViolationNotice: koishi_1.Schema.boolean().default(true).description('该群违规后是否发送群内提示。'),
+            autoMuteEnabled: koishi_1.Schema.boolean().description('该群是否启用自动禁言（留空则跟随全局设置）。'),
+            autoMuteThreshold: koishi_1.Schema.natural().description('该群触发自动禁言的违规次数（留空则跟随全局设置）。'),
+            autoMuteMinutes: koishi_1.Schema.natural().description('该群自动禁言的时长（分钟，留空则跟随全局设置）。'),
+            autoKickEnabled: koishi_1.Schema.boolean().description('该群是否启用自动踢人（留空则跟随全局设置）。'),
+            autoKickThreshold: koishi_1.Schema.natural().description('该群触发自动踢人的违规次数（留空则跟随全局设置）。'),
+            autoViolationWindowMinutes: koishi_1.Schema.natural().description('该群违规计数统计窗口（分钟，留空则跟随全局设置）。'),
+        })).role('table').default([]).description('按群覆盖消息管控策略（未命中群号时使用全局默认）。'),
+    }).description('消息管控'),
+    koishi_1.Schema.object({
+        enableAutoMute: koishi_1.Schema.boolean().default(false).description('启用自动禁言：成员在统计窗口内累计违规达到阈值后自动禁言。'),
+        autoMuteViolationThreshold: koishi_1.Schema.natural().default(3).description('触发自动禁言所需的累计违规次数。'),
+        autoMuteMinutes: koishi_1.Schema.natural().default(10).description('自动禁言的时长（分钟）。'),
+        enableAutoKick: koishi_1.Schema.boolean().default(false).description('启用自动踢人：成员在统计窗口内累计违规达到阈值后自动移出群聊。'),
+        autoKickViolationThreshold: koishi_1.Schema.natural().default(5).description('触发自动踢人所需的累计违规次数。'),
+        autoViolationWindowMinutes: koishi_1.Schema.natural().default(60).description('违规计数统计窗口（分钟）：窗口内连续违规才累计，超时未违规则重新计数。'),
+    }).description('自动管控'),
+    koishi_1.Schema.object({
+        enableMemory: koishi_1.Schema.boolean().default(true).description('启用记忆库：群内发送 [记忆]+内容 保存到 Memory.md，[记忆查询]/[记忆删除] 管理，AI 回复可引用。'),
+        memoryFileName: koishi_1.Schema.string().default('Memory.md').description('记忆库文件名（保存在 Koishi 数据目录，可通过控制台 Explorer 查看/编辑）。'),
+        memoryInAi: koishi_1.Schema.boolean().default(true).description('AI 回复/识图时是否参考记忆库内容。'),
+    }).description('记忆库'),
+    koishi_1.Schema.object({
+        enableSelfGag: koishi_1.Schema.boolean().default(true).description('启用口球娱乐：普通成员对自己使用 mute/gag 时随机 1~60 分钟禁言。'),
+        enableUnauthorizedMutePunish: koishi_1.Schema.boolean().default(true).description('启用违规惩罚：普通成员反复尝试禁言他人时禁言本人。'),
+        unauthorizedMuteAttemptThreshold: koishi_1.Schema.natural().default(2).description('触发惩罚所需的违规禁言次数。'),
+        unauthorizedMuteWindowMinutes: koishi_1.Schema.natural().default(10).description('违规计数统计窗口（分钟）。'),
+        unauthorizedMutePunishMinMinutes: koishi_1.Schema.natural().default(1).description('惩罚禁言最小分钟数。'),
+        unauthorizedMutePunishMaxMinutes: koishi_1.Schema.natural().default(10).description('惩罚禁言最大分钟数。'),
+    }).description('娱乐设置'),
+    koishi_1.Schema.object({
+        enableRepeater: koishi_1.Schema.boolean().default(false).description('启用群聊复读：连续相同消息达到阈值时 bot 复读一次。'),
+        repeaterThreshold: koishi_1.Schema.natural().default(3).description('触发复读所需连续相同消息次数。'),
+        repeaterCooldownSeconds: koishi_1.Schema.natural().default(90).description('同一内容再次允许复读的冷却时间（秒）。'),
+        repeaterEnableGetMsgRefetch: koishi_1.Schema.boolean().default(true).description('复读图片缺少可发送引用时，是否通过 get_msg 回查原消息提取图片引用。'),
+        enableJoinRequestReview: koishi_1.Schema.boolean().default(true).description('收到新的入群申请时，自动在群内发起管理员审核。'),
+        joinRequestReviewTtlMinutes: koishi_1.Schema.natural().default(30).description('入群申请审核编号的有效期（分钟）。'),
+    }).description('群聊互动'),
+    koishi_1.Schema.object({
+        enableAiReply: koishi_1.Schema.boolean().default(false).description('是否启用群聊 AI 自动回复。'),
+        aiProvider: koishi_1.Schema.union([
+            koishi_1.Schema.const('openai-compatible').description('OpenAI 兼容接口（OpenAI/火山引擎/Codex API/Auth 等）'),
+            koishi_1.Schema.const('gemini').description('Gemini 原生接口（Google Generative Language API）'),
+        ]).role('radio').default('openai-compatible').description('AI 服务提供方式。'),
+        aiApiKey: koishi_1.Schema.string().role('secret').default('').description('AI 接口密钥（API Key）。'),
+        aiBaseUrl: koishi_1.Schema.string().default('https://api.openai.com/v1').description('接口基础地址（OpenAI 兼容模式需以 /v1 结尾；Gemini 模式可留默认）。'),
+        aiModel: koishi_1.Schema.string().default('gpt-4o-mini').description('模型名称，如 gpt-4o-mini / doubao-1.5-lite / gemini-2.0-flash。'),
+        aiAgentName: koishi_1.Schema.string().default('MeowBot').description('默认智能体自称。'),
+        aiSystemPrompt: koishi_1.Schema.string().role('textarea').default('你是群聊中的友好机器人，请简洁、自然、符合中文互联网语境地回复。').description('默认系统提示词。'),
+        aiActivePersona: koishi_1.Schema.string().default('').description('启用的人格 ID（为空时使用默认自称与默认提示词）。'),
+        aiPersonas: koishi_1.Schema.array(koishi_1.Schema.object({
+            id: koishi_1.Schema.string().required().description('人格 ID（唯一）。'),
+            selfName: koishi_1.Schema.string().default('').description('该人格的自称（留空则使用默认自称）。'),
+            prompt: koishi_1.Schema.string().role('textarea').default('').description('该人格系统提示词（留空则使用默认提示词）。'),
+        })).role('table').default([]).description('可保存多个人格配置，按 aiActivePersona 切换。'),
+        aiReplyMode: koishi_1.Schema.union([
+            koishi_1.Schema.const('threshold').description('达到消息阈值后回复'),
+            koishi_1.Schema.const('random').description('按概率随机回复'),
+            koishi_1.Schema.const('hybrid').description('阈值与随机同时生效'),
+        ]).role('radio').default('hybrid').description('AI 触发策略。'),
+        aiMessageThreshold: koishi_1.Schema.natural().default(16).description('阈值触发所需累计消息数。'),
+        aiRandomReplyProbability: koishi_1.Schema.percent().default(0.08).description('随机触发概率（每条消息判定一次）。'),
+        aiMinReplyIntervalSeconds: koishi_1.Schema.natural().default(45).description('同一群两次 AI 回复的最短间隔（秒）。'),
+        aiContextWindow: koishi_1.Schema.natural().default(24).description('参与推理的最近消息条数。'),
+        aiTemperature: koishi_1.Schema.number().min(0).max(2).step(0.1).default(0.8).description('生成温度（0~2）。'),
+        aiMaxOutputTokens: koishi_1.Schema.natural().default(240).description('AI 最大输出 token 数。'),
+        aiEnableImageRecognition: koishi_1.Schema.boolean().default(true).description('是否启用图片识别（支持时将图片一并发送给模型）。'),
+        aiImageMaxCount: koishi_1.Schema.natural().default(2).description('每次最多发送给模型的图片数量。'),
+        aiIgnoreCommandMessage: koishi_1.Schema.boolean().default(true).description('忽略看起来像命令的消息，避免干扰正常指令执行。'),
+        aiEnableDirectMentionTrigger: koishi_1.Schema.boolean().default(true).description('消息命中智能体名字时是否忽略阈值直接触发回复。'),
+        aiEnableFollowupAfterMention: koishi_1.Schema.boolean().default(true).description('点名触发后，是否跟随该用户一段时间继续对话。'),
+        aiFollowupWindowSeconds: koishi_1.Schema.natural().default(120).description('点名后跟随该用户的持续时间（秒）。'),
+        aiFollowupMaxTurns: koishi_1.Schema.natural().default(3).description('一次点名会话最多继续回复轮数。'),
+        aiOwnerPlatform: koishi_1.Schema.string().default('onebot').description('主人平台标识（用于识别主人用户，如 onebot）。'),
+        aiOwnerUserId: koishi_1.Schema.string().default('').description('主人平台用户 ID（如 QQ 号，用于记忆主人身份）。'),
+        aiHomePlatform: koishi_1.Schema.string().default('onebot').description('兼容字段：主页平台标识（建议改用 aiOwnerPlatform）。'),
+        aiHomeUserId: koishi_1.Schema.string().default('').description('兼容字段：主页平台用户 ID（建议改用 aiOwnerUserId）。'),
+        aiInterestMinScore: koishi_1.Schema.number().min(0).max(100).step(1).default(82).description('AI 兴趣触发最低分（非点名场景，分值越高越不容易回复）。'),
+        aiInterestContextWindow: koishi_1.Schema.number().min(4).max(16).step(1).default(8).description('非阈值兴趣判定使用的上下文窗口条数。'),
+    }).description('AI 回复'),
+    koishi_1.Schema.object({
+        allowedUserIds: koishi_1.Schema.array(String).role('table').default([]).description('允许直接使用群管理命令的账号 ID 白名单。'),
+        allowGroupOwner: koishi_1.Schema.boolean().default(true).description('是否允许群主使用管理命令。'),
+        allowGroupAdmin: koishi_1.Schema.boolean().default(true).description('是否允许群管理员使用管理命令。'),
+        requireBotOwnerForAdmin: koishi_1.Schema.boolean().default(true).description('仅当 bot 在当前群是群主时开放 admin 子命令。'),
+        allowAdminBypassWhitelistMute: koishi_1.Schema.boolean().default(true).description('白名单目标禁言保护开关：开启后允许群主/管理员对其执行禁言。'),
+    }).description('权限设置'),
+    koishi_1.Schema.object({
+        logCommandResult: koishi_1.Schema.boolean().default(true).description('记录所有群管指令的执行结果到日志。'),
+        logAuthCheck: koishi_1.Schema.boolean().default(true).description('记录白名单/群主/管理员鉴权过程到日志。'),
+    }).description('日志设置'),
+]);
+function apply(ctx, config) {
+    const service = new service_1.QQGroupManagerService(ctx, config);
+    const dispose = ctx.permissions.define('qqgm-admin', {
+        check: async (_data, session) => {
+            const result = await service.canUseAdminCommand(session);
+            return result.ok;
+        },
+    });
+    ctx.on('dispose', () => {
+        dispose();
+    });
+    (0, commands_1.registerCommands)(ctx, service, config);
+    if (config.replaceHelpAsImageMenu) {
+        let help;
+        try {
+            help = ctx.$commander.get('help');
+        }
+        catch {
+            help = null;
+        }
+        if (help) {
+            help.action(async (argv) => {
+                const keyword = typeof argv.args?.[0] === 'string' ? argv.args[0] : '';
+                if (!keyword)
+                    service.armMenuPairing(argv.session, 30_000);
+                return service.renderMenu(keyword, argv.session);
+            }, true);
+        }
+        else {
+            ctx.command('help [keyword:text]', '查看图片菜单（由 qq-group-manager 提供）')
+                .action(async (argv, keyword) => {
+                if (!keyword)
+                    service.armMenuPairing(argv.session, 30_000);
+                return service.renderMenu(keyword, argv.session);
+            });
+        }
+    }
+    if (config.replaceStatusAsImage) {
+        let status;
+        try {
+            status = ctx.$commander.get('status');
+        }
+        catch {
+            status = null;
+        }
+        if (status) {
+            status.action(async (argv) => {
+                return service.renderStatusCard(argv.session);
+            }, true);
+        }
+        else {
+            ctx.command('status', '查看系统状态（由 qq-group-manager 提供）')
+                .action(async (argv) => {
+                return service.renderStatusCard(argv.session);
+            });
+        }
+    }
+}