koishi-plugin-temporaryban 1.0.6 → 1.0.7-beta1

package/lib/commands/index.js

@@ -11,7 +11,7 @@ const info_1 = require("./info");
 function registerCommands(ctx, config, detector, mailer, userRecords, history, whitelistService) {
     (0, admin_1.registerAdminCommands)(ctx, config, mailer);
     (0, dictionary_1.registerDictionaryCommands)(ctx, config, detector);
-    (0, whitelist_1.registerWhitelistCommands)(ctx, config, whitelistService);
+    (0, whitelist_1.registerWhitelistCommands)(ctx, config, whitelistService, detector);
     (0, stats_1.registerStatsCommands)(ctx, config, userRecords);
     (0, check_1.registerCheckCommands)(ctx, config, detector);
     (0, history_1.registerHistoryCommands)(ctx, config, history);

package/lib/commands/info.js

@@ -16,7 +16,7 @@ function registerInfoCommands(ctx, config, whitelistService) {
         const groupConfig = config.groups.find(g => g.groupId === session.guildId);
         if (!groupConfig)
             return session.text('commands.temporaryban.messages.group_not_configured');
-        const whitelistCount = whitelistService.getList(session.guildId).length;
+        const whitelistCount = whitelistService.getWhitelist(session.guildId).length;
         const methods = groupConfig.detectionMethods.join(', ') || 'None';
         const smartVer = groupConfig.smartVerification ? 'ON' : 'OFF';
         return session.text('commands.temporaryban.messages.group_info', [

package/lib/commands/whitelist.d.ts

@@ -1,4 +1,5 @@
 import { Context } from 'koishi';
 import { Config } from '../config';
 import { WhitelistService } from '../services/whitelist';
-export declare function registerWhitelistCommands(ctx: Context, config: Config, whitelistService: WhitelistService): void;
+import { DetectorService } from '../services/detector';
+export declare function registerWhitelistCommands(ctx: Context, config: Config, whitelistService: WhitelistService, detector: DetectorService): void;

package/lib/commands/whitelist.js

@@ -2,9 +2,26 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerWhitelistCommands = registerWhitelistCommands;
 const permission_1 = require("../utils/permission");
-function registerWhitelistCommands(ctx, config, whitelistService) {
+function registerWhitelistCommands(ctx, config, whitelistService, detector) {
     const cmd = ctx.command('temporaryban');
-    // 5. Whitelist Add
+    // 10. Whitelist User List
+    cmd.subcommand('.whitelist.list')
+        .action(async ({ session }) => {
+        if (!session)
+            return;
+        if (!(0, permission_1.checkPermission)(session, config))
+            return session.text('commands.temporaryban.messages.permission_denied');
+        if (!session.guildId)
+            return session.text('commands.temporaryban.messages.group_only');
+        const groupConfig = config.groups.find(g => g.groupId === session.guildId);
+        if (!groupConfig)
+            return session.text('commands.temporaryban.messages.group_not_configured');
+        const items = whitelistService.getWhitelist(session.guildId);
+        if (items.length === 0)
+            return session.text('commands.temporaryban.messages.no_whitelist_users');
+        return session.text('commands.temporaryban.messages.whitelist_users_list', [items.length, items.join(', ')]);
+    });
+    // 5. Whitelist Add User
     cmd.subcommand('.whitelist.add <user:string>')
         .action(async ({ session }, user) => {
         if (!session)
@@ -23,7 +40,7 @@ function registerWhitelistCommands(ctx, config, whitelistService) {
             return session.text('commands.temporaryban.messages.already_whitelisted');
         return session.text('commands.temporaryban.messages.user_added_whitelist', [user]);
     });
-    // 6. Whitelist Remove
+    // 6. Whitelist Remove User
     cmd.subcommand('.whitelist.remove <user:string>')
         .action(async ({ session }, user) => {
         if (!session)
@@ -40,4 +57,59 @@ function registerWhitelistCommands(ctx, config, whitelistService) {
             return session.text('commands.temporaryban.messages.not_in_whitelist');
         return session.text('commands.temporaryban.messages.user_removed_whitelist', [user]);
     });
+    // 7. Whitelist Word Add
+    cmd.subcommand('.whitelist.word.add <word:string>')
+        .action(async ({ session }, word) => {
+        if (!session)
+            return;
+        if (!(0, permission_1.checkPermission)(session, config))
+            return session.text('commands.temporaryban.messages.permission_denied');
+        if (!session.guildId)
+            return session.text('commands.temporaryban.messages.group_only');
+        if (!word)
+            return session.text('commands.temporaryban.messages.specify_word');
+        const groupConfig = config.groups.find(g => g.groupId === session.guildId);
+        if (!groupConfig)
+            return session.text('commands.temporaryban.messages.group_not_configured');
+        const success = await detector.addIgnoredWord(session.guildId, word);
+        if (!success)
+            return session.text('commands.temporaryban.messages.word_exists');
+        return session.text('commands.temporaryban.messages.ignored_word_added', [word]);
+    });
+    // 8. Whitelist Word Remove
+    cmd.subcommand('.whitelist.word.remove <word:string>')
+        .action(async ({ session }, word) => {
+        if (!session)
+            return;
+        if (!(0, permission_1.checkPermission)(session, config))
+            return session.text('commands.temporaryban.messages.permission_denied');
+        if (!session.guildId)
+            return session.text('commands.temporaryban.messages.group_only');
+        if (!word)
+            return session.text('commands.temporaryban.messages.specify_word');
+        const groupConfig = config.groups.find(g => g.groupId === session.guildId);
+        if (!groupConfig)
+            return session.text('commands.temporaryban.messages.group_not_configured');
+        const success = await detector.removeIgnoredWord(session.guildId, word);
+        if (!success)
+            return session.text('commands.temporaryban.messages.word_not_found');
+        return session.text('commands.temporaryban.messages.ignored_word_removed', [word]);
+    });
+    // 9. Whitelist Word List
+    cmd.subcommand('.whitelist.word.list')
+        .action(async ({ session }) => {
+        if (!session)
+            return;
+        if (!(0, permission_1.checkPermission)(session, config))
+            return session.text('commands.temporaryban.messages.permission_denied');
+        if (!session.guildId)
+            return session.text('commands.temporaryban.messages.group_only');
+        const groupConfig = config.groups.find(g => g.groupId === session.guildId);
+        if (!groupConfig)
+            return session.text('commands.temporaryban.messages.group_not_configured');
+        const items = detector.getIgnoredWords(session.guildId);
+        if (items.length === 0)
+            return session.text('commands.temporaryban.messages.no_ignored_words');
+        return session.text('commands.temporaryban.messages.ignored_words_list', [items.length, items.join(', ')]);
+    });
 }

package/lib/config.d.ts

@@ -36,6 +36,7 @@ export interface GroupConfig {
     smartVerification: boolean;
     contextMsgCount: number;
     aiThreshold?: number;
+    showCensoredWord?: boolean;
     localBadWordDict: string;
     whitelist: WhitelistItem[];
     triggerThreshold?: number;
@@ -66,17 +67,24 @@ export interface OpenAIConfig {
 export interface Config {
     debug: boolean;
     adminList: string[];
-    smtp: SmtpConfig;
-    api: ApiConfig;
-    baidu: BaiduConfig;
-    aliyun: AliyunConfig;
-    tencent: TencentConfig;
-    openai: OpenAIConfig;
+    useApi: boolean;
+    useBaidu: boolean;
+    useAliyun: boolean;
+    useTencent: boolean;
+    useOpenAI: boolean;
+    useEmail: boolean;
+    smtp?: SmtpConfig;
+    api?: ApiConfig;
+    baidu?: BaiduConfig;
+    aliyun?: AliyunConfig;
+    tencent?: TencentConfig;
+    openai?: OpenAIConfig;
     defaultMuteMinutes: number;
     defaultTriggerThreshold: number;
     defaultAiThreshold: number;
     defaultCheckProbability: number;
     checkAdmin: boolean;
+    defaultShowCensoredWord: boolean;
     groups: GroupConfig[];
 }
 export declare const Config: Schema<Config>;

package/lib/config.js

@@ -2,74 +2,144 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Config = void 0;
 const koishi_1 = require("koishi");
-exports.Config = koishi_1.Schema.object({
-    debug: koishi_1.Schema.boolean().description('开启全局调试日志。开启后，控制台将输出详细的消息处理流程和错误堆栈，建议仅在排查问题时启用。').default(false),
-    adminList: koishi_1.Schema.array(String).description('全局管理员列表 (OneBot 用户ID)。在此列表中的用户可以使用 `temporaryban.report` 等高级管理指令，拥有最高权限。').role('table'),
-    checkAdmin: koishi_1.Schema.boolean().description('是否检查机器人在群内的管理权限。开启后，如果机器人不是群主或管理员，将不执行违禁词检查。').default(true),
-    defaultMuteMinutes: koishi_1.Schema.number().description('全局默认禁言时长 (分钟)。当群组未配置时使用。').default(10).min(0.1),
-    defaultTriggerThreshold: koishi_1.Schema.number().description('全局默认触发阈值 (次数)。当群组未配置时使用。').default(3).min(1),
-    defaultAiThreshold: koishi_1.Schema.number().description('全局默认 AI 判定阈值 (0.0 - 1.0)。当群组未配置时使用。').default(0.6).min(0).max(1).step(0.1),
-    defaultCheckProbability: koishi_1.Schema.number().description('全局默认检查概率 (0.0 - 1.0)。1.0 表示检查所有消息。当群组未配置时使用。').default(1.0).min(0).max(1).step(0.1),
-    smtp: koishi_1.Schema.object({
-        host: koishi_1.Schema.string().description('SMTP 服务器地址 (例如 smtp.qq.com, smtp.163.com)').default('smtp.example.com'),
-        port: koishi_1.Schema.number().description('SMTP 端口 (SSL通常为465, 非SSL通常为25)').default(465),
-        secure: koishi_1.Schema.boolean().description('启用 SSL/TLS 加密链接。如果端口是465，通常需要开启此项。').default(true),
-        user: koishi_1.Schema.string().description('SMTP 用户名 (通常是您的邮箱地址)').default('user@example.com'),
-        pass: koishi_1.Schema.string().role('secret').description('SMTP 密码或授权码。注意：QQ邮箱/163邮箱等通常需要使用生成的授权码，而非登录密码。').default('password'),
-        senderName: koishi_1.Schema.string().description('邮件发件人显示名称').default('Koishi Bot'),
-        senderEmail: koishi_1.Schema.string().description('邮件发件人地址 (必须与SMTP用户名匹配)').default('bot@example.com'),
-        receivers: koishi_1.Schema.array(String).description('接收违规通知的管理员邮箱列表').role('table'),
-        summaryIntervalDays: koishi_1.Schema.number().description('邮件汇总周期 (天)。设置为 0 时，每条违规都会立即发送邮件；设置为 >0 时 (如 1)，将每隔 N 天发送一次违规汇总报告。').default(1).min(0),
-    }).description('邮件通知设置 (SMTP)'),
-    api: koishi_1.Schema.object({
-        apiUrl: koishi_1.Schema.string().description('在线检测 API 地址 (默认使用 ApiHz 接口)').default('https://cn.apihz.cn/api/zici/mgc.php'),
-        apiId: koishi_1.Schema.string().description('ApiHz 开发者 ID (必填，否则无法使用 API 检测)').default(''),
-        apiKey: koishi_1.Schema.string().role('secret').description('ApiHz 开发者 Key (必填)').default(''),
-    }).description('在线检测设置 (ApiHz)'),
-    openai: koishi_1.Schema.object({
-        apiKey: koishi_1.Schema.string().role('secret').description('OpenAI/SiliconFlow API Key').default(''),
-        baseUrl: koishi_1.Schema.string().description('API Base URL (默认为 SiliconFlow)').default('https://api.siliconflow.cn/v1'),
-        model: koishi_1.Schema.string().description('模型 ID').default('deepseek-ai/DeepSeek-V2.5'),
-    }).description('AI 检测设置 (OpenAI/SiliconFlow)'),
-    baidu: koishi_1.Schema.object({
-        apiKey: koishi_1.Schema.string().description('百度智能云 API Key').default(''),
-        secretKey: koishi_1.Schema.string().role('secret').description('百度智能云 Secret Key').default(''),
-    }).description('百度智能云设置'),
-    aliyun: koishi_1.Schema.object({
-        accessKeyId: koishi_1.Schema.string().description('阿里云 AccessKey ID').default(''),
-        accessKeySecret: koishi_1.Schema.string().role('secret').description('阿里云 AccessKey Secret').default(''),
-        endpoint: koishi_1.Schema.string().description('阿里云内容安全 Endpoint').default('green-cip.cn-shanghai.aliyuncs.com'),
-    }).description('阿里云内容安全设置'),
-    tencent: koishi_1.Schema.object({
-        secretId: koishi_1.Schema.string().description('腾讯云 SecretId').default(''),
-        secretKey: koishi_1.Schema.string().role('secret').description('腾讯云 SecretKey').default(''),
-        region: koishi_1.Schema.string().description('腾讯云地域 (例如 ap-shanghai)').default('ap-shanghai'),
-    }).description('腾讯云内容安全设置'),
-    groups: koishi_1.Schema.array(koishi_1.Schema.object({
-        id: koishi_1.Schema.string().hidden().default(''),
-        groupId: koishi_1.Schema.string().description('群组 ID (群号)。机器人将监控此群内的消息。').required(),
-        enable: koishi_1.Schema.boolean().description('是否启用对该群组的监控。关闭后插件将忽略该群的所有消息。').default(true),
-        detectionMethods: koishi_1.Schema.array(koishi_1.Schema.union([
-            koishi_1.Schema.const('local').description('本地词库 (数据库)'),
-            koishi_1.Schema.const('ai').description('AI 模型检测 (OpenAI/SiliconFlow)'),
-            koishi_1.Schema.const('api').description('在线 API (ApiHz)'),
-            koishi_1.Schema.const('baidu').description('百度智能云'),
-            koishi_1.Schema.const('aliyun').description('阿里云 (内容安全增强版)'),
-            koishi_1.Schema.const('tencent').description('腾讯云 (TMS)'),
-        ])).role('checkbox').description('启用的检测方式 (多选)。若开启多个，只要有任意一个检测到违规即视为违规 (除非开启了智能验证)。').default(['local']),
-        smartVerification: koishi_1.Schema.boolean().description('开启智能验证 (Smart Verification)。开启后，当【本地词库】或【API】检测到违规时，不会立即惩罚，而是将该用户的最近几条聊天记录发送给 AI 进行二次确认。只有 AI 也判定违规时才执行惩罚。需确保【AI 模型检测】已配置 API Key。').default(false),
-        contextMsgCount: koishi_1.Schema.number().description('智能验证时的上下文消息数量。仅在开启智能验证时生效。').default(3).min(1).max(10),
-        aiThreshold: koishi_1.Schema.number().description('AI 违规判定阈值 (0.0 - 1.0)。留空则使用全局默认值。').min(0).max(1).step(0.1),
-        checkProbability: koishi_1.Schema.number().description('消息检查概率 (0.0 - 1.0)。留空则使用全局默认值。').min(0).max(1).step(0.1),
-        localBadWordDict: koishi_1.Schema.string()
-            .description('【初始导入/Legacy】本地违禁词库配置。插件现已使用数据库存储词库。首次启动时，若数据库为空，将自动导入此处的词汇。之后的增删操作请使用指令 `temporaryban.add/remove`，此配置项将不再生效。')
-            .default(''),
-        whitelist: koishi_1.Schema.array(koishi_1.Schema.object({
-            userId: koishi_1.Schema.string().description('用户 ID (QQ号)')
-        })).description('白名单用户列表。列表中的用户触发违禁词时不会受到惩罚。注：群管理员和群主会自动获得白名单豁免，无需在此手动添加。').role('table'),
-        triggerThreshold: koishi_1.Schema.number().description('触发禁言的累计违规次数。留空则使用全局默认值。').min(1),
-        triggerWindowMinutes: koishi_1.Schema.number().description('违规计数的时间窗口 (分钟)。在此时间内累计的违规次数达到阈值即触发禁言。超过此时间窗口后，计数将重置。').default(5).min(0.1),
-        muteMinutes: koishi_1.Schema.number().description('禁言时长 (分钟)。留空则使用全局默认值。').min(0.1),
-        detailedLog: koishi_1.Schema.boolean().description('开启此群组的详细日志。用于调试特定群组的检测逻辑。').default(false),
-    }).description('群组配置')).description('监控群组列表').role('list').default([])
-}).description('违禁词检测插件配置');
+exports.Config = koishi_1.Schema.intersect([
+    koishi_1.Schema.object({
+        debug: koishi_1.Schema.boolean().description('开启全局调试日志。').default(false),
+        adminList: koishi_1.Schema.array(String).description('全局管理员列表 (OneBot 用户ID)。').role('table'),
+        checkAdmin: koishi_1.Schema.boolean().description('是否检查机器人在群内的管理权限。').default(true),
+        defaultMuteMinutes: koishi_1.Schema.number().description('全局默认禁言时长 (分钟)。').default(10).min(0.1),
+        defaultTriggerThreshold: koishi_1.Schema.number().description('全局默认触发阈值 (次数)。').default(3).min(1),
+        defaultAiThreshold: koishi_1.Schema.number().description('全局默认 AI 判定阈值 (0.0 - 1.0)。').default(0.6).min(0).max(1).step(0.1),
+        defaultCheckProbability: koishi_1.Schema.number().description('全局默认检查概率 (0.0 - 1.0)。').default(1.0).min(0).max(1).step(0.1),
+        defaultShowCensoredWord: koishi_1.Schema.boolean().description('全局默认是否在警告中显示触发的违禁词。').default(true),
+    }).description('基础设置'),
+    koishi_1.Schema.intersect([
+        koishi_1.Schema.object({
+            useEmail: koishi_1.Schema.boolean().description('启用邮件通知系统').default(false),
+        }).description('邮件通知开关'),
+        koishi_1.Schema.union([
+            koishi_1.Schema.object({
+                useEmail: koishi_1.Schema.const(true).required(),
+                smtp: koishi_1.Schema.object({
+                    host: koishi_1.Schema.string().description('SMTP 服务器地址').default('smtp.example.com'),
+                    port: koishi_1.Schema.number().description('SMTP 端口').default(465),
+                    secure: koishi_1.Schema.boolean().description('启用 SSL/TLS 加密链接').default(true),
+                    user: koishi_1.Schema.string().description('SMTP 用户名').default('user@example.com'),
+                    pass: koishi_1.Schema.string().role('secret').description('SMTP 密码或授权码').default('password'),
+                    senderName: koishi_1.Schema.string().description('邮件发件人显示名称').default('Koishi Bot'),
+                    senderEmail: koishi_1.Schema.string().description('邮件发件人地址').default('bot@example.com'),
+                    receivers: koishi_1.Schema.array(String).description('接收违规通知的管理员邮箱列表').role('table'),
+                    summaryIntervalDays: koishi_1.Schema.number().description('邮件汇总周期 (天)').default(1).min(0),
+                }).description('邮件通知设置 (SMTP)'),
+            }),
+            koishi_1.Schema.object({}),
+        ]),
+    ]),
+    koishi_1.Schema.intersect([
+        koishi_1.Schema.object({
+            useApi: koishi_1.Schema.boolean().description('启用在线 API 检测 (ApiHz)').default(false),
+        }).description('在线 API 开关'),
+        koishi_1.Schema.union([
+            koishi_1.Schema.object({
+                useApi: koishi_1.Schema.const(true).required(),
+                api: koishi_1.Schema.object({
+                    apiUrl: koishi_1.Schema.string().description('在线检测 API 地址').default('https://cn.apihz.cn/api/zici/mgc.php'),
+                    apiId: koishi_1.Schema.string().description('ApiHz 开发者 ID').default(''),
+                    apiKey: koishi_1.Schema.string().role('secret').description('ApiHz 开发者 Key').default(''),
+                }).description('在线检测设置 (ApiHz)'),
+            }),
+            koishi_1.Schema.object({}),
+        ]),
+    ]),
+    koishi_1.Schema.intersect([
+        koishi_1.Schema.object({
+            useOpenAI: koishi_1.Schema.boolean().description('启用 AI 模型检测 (OpenAI/SiliconFlow)').default(false),
+        }).description('AI 检测开关'),
+        koishi_1.Schema.union([
+            koishi_1.Schema.object({
+                useOpenAI: koishi_1.Schema.const(true).required(),
+                openai: koishi_1.Schema.object({
+                    apiKey: koishi_1.Schema.string().role('secret').description('API Key').default(''),
+                    baseUrl: koishi_1.Schema.string().description('API Base URL').default('https://api.siliconflow.cn/v1'),
+                    model: koishi_1.Schema.string().description('模型 ID').default('deepseek-ai/DeepSeek-V2.5'),
+                }).description('AI 检测设置'),
+            }),
+            koishi_1.Schema.object({}),
+        ]),
+    ]),
+    koishi_1.Schema.intersect([
+        koishi_1.Schema.object({
+            useBaidu: koishi_1.Schema.boolean().description('启用百度智能云检测').default(false),
+        }).description('百度智能云开关'),
+        koishi_1.Schema.union([
+            koishi_1.Schema.object({
+                useBaidu: koishi_1.Schema.const(true).required(),
+                baidu: koishi_1.Schema.object({
+                    apiKey: koishi_1.Schema.string().description('API Key').default(''),
+                    secretKey: koishi_1.Schema.string().role('secret').description('Secret Key').default(''),
+                }).description('百度智能云设置'),
+            }),
+            koishi_1.Schema.object({}),
+        ]),
+    ]),
+    koishi_1.Schema.intersect([
+        koishi_1.Schema.object({
+            useAliyun: koishi_1.Schema.boolean().description('启用阿里云内容安全检测').default(false),
+        }).description('阿里云开关'),
+        koishi_1.Schema.union([
+            koishi_1.Schema.object({
+                useAliyun: koishi_1.Schema.const(true).required(),
+                aliyun: koishi_1.Schema.object({
+                    accessKeyId: koishi_1.Schema.string().description('AccessKey ID').default(''),
+                    accessKeySecret: koishi_1.Schema.string().role('secret').description('AccessKey Secret').default(''),
+                    endpoint: koishi_1.Schema.string().description('Endpoint').default('green-cip.cn-shanghai.aliyuncs.com'),
+                }).description('阿里云设置'),
+            }),
+            koishi_1.Schema.object({}),
+        ]),
+    ]),
+    koishi_1.Schema.intersect([
+        koishi_1.Schema.object({
+            useTencent: koishi_1.Schema.boolean().description('启用腾讯云检测').default(false),
+        }).description('腾讯云开关'),
+        koishi_1.Schema.union([
+            koishi_1.Schema.object({
+                useTencent: koishi_1.Schema.const(true).required(),
+                tencent: koishi_1.Schema.object({
+                    secretId: koishi_1.Schema.string().description('SecretId').default(''),
+                    secretKey: koishi_1.Schema.string().role('secret').description('SecretKey').default(''),
+                    region: koishi_1.Schema.string().description('Region').default('ap-shanghai'),
+                }).description('腾讯云设置'),
+            }),
+            koishi_1.Schema.object({}),
+        ]),
+    ]),
+    koishi_1.Schema.object({
+        groups: koishi_1.Schema.array(koishi_1.Schema.object({
+            id: koishi_1.Schema.string().hidden().default(''),
+            groupId: koishi_1.Schema.string().description('群组 ID (群号)').required(),
+            enable: koishi_1.Schema.boolean().description('是否启用监控').default(true),
+            detectionMethods: koishi_1.Schema.array(koishi_1.Schema.union([
+                koishi_1.Schema.const('local').description('本地词库 (数据库)'),
+                koishi_1.Schema.const('ai').description('AI 模型检测'),
+                koishi_1.Schema.const('api').description('在线 API'),
+                koishi_1.Schema.const('baidu').description('百度智能云'),
+                koishi_1.Schema.const('aliyun').description('阿里云'),
+                koishi_1.Schema.const('tencent').description('腾讯云'),
+            ])).role('checkbox').description('启用的检测方式').default(['local']),
+            smartVerification: koishi_1.Schema.boolean().description('开启智能验证').default(false),
+            contextMsgCount: koishi_1.Schema.number().description('智能验证上下文数量').default(3).min(1).max(10),
+            aiThreshold: koishi_1.Schema.number().description('AI 判定阈值 (留空用默认)').min(0).max(1).step(0.1),
+            checkProbability: koishi_1.Schema.number().description('检查概率 (留空用默认)').min(0).max(1).step(0.1),
+            showCensoredWord: koishi_1.Schema.boolean().description('是否显示触发的违禁词 (留空用默认)'),
+            localBadWordDict: koishi_1.Schema.string().description('【Legacy】本地违禁词库 (初始导入)').default(''),
+            whitelist: koishi_1.Schema.array(koishi_1.Schema.object({
+                userId: koishi_1.Schema.string().description('用户 ID')
+            })).description('白名单用户列表 (管理员自动豁免)').role('table'),
+            triggerThreshold: koishi_1.Schema.number().description('触发禁言阈值 (留空用默认)').min(1),
+            triggerWindowMinutes: koishi_1.Schema.number().description('违规计数窗口 (分钟)').default(5).min(0.1),
+            muteMinutes: koishi_1.Schema.number().description('禁言时长 (分钟, 留空用默认)').min(0.1),
+            detailedLog: koishi_1.Schema.boolean().description('开启详细日志').default(false),
+        }).description('群组配置')).description('监控群组列表').role('list').default([])
+    }).description('群组监控设置')
+]);

package/lib/index.d.ts

@@ -4,11 +4,27 @@ import { WhitelistTable } from './services/whitelist';
 export * from './config';
 export declare const name = "koishi-plugin-temporaryban";
 export declare const inject: string[];
+export interface IgnoredWordTable {
+    id: number;
+    groupId: string;
+    word: string;
+    createdAt: Date;
+}
+export interface ViolationTable {
+    id: number;
+    userId: string;
+    groupId: string;
+    words: string[];
+    content: string;
+    timestamp: Date;
+}
 declare module 'koishi' {
     interface Tables {
         temporaryban_badwords: BadWordTable;
         temporaryban_message_history: MessageHistoryTable;
         temporaryban_whitelist: WhitelistTable;
+        temporaryban_ignored_words: IgnoredWordTable;
+        temporaryban_violations: ViolationTable;
     }
 }
 export interface MessageHistoryTable {

package/lib/index.js

@@ -29,7 +29,7 @@ const en_US_1 = __importDefault(require("./locales/en-US"));
 const commands_1 = require("./commands");
 __exportStar(require("./config"), exports);
 exports.name = 'koishi-plugin-temporaryban';
-exports.inject = ['database'];
+exports.inject = ['database', 'http'];
 const logger = new koishi_1.Logger('temporaryban');
 function apply(ctx, config) {
     // --- Services ---
@@ -68,6 +68,24 @@ function apply(ctx, config) {
     }, {
         autoInc: true,
     });
+    ctx.model.extend('temporaryban_ignored_words', {
+        id: 'unsigned',
+        groupId: 'string',
+        word: 'string',
+        createdAt: 'timestamp',
+    }, {
+        autoInc: true,
+    });
+    ctx.model.extend('temporaryban_violations', {
+        id: 'unsigned',
+        userId: 'string',
+        groupId: 'string',
+        words: 'list',
+        content: 'text',
+        timestamp: 'timestamp',
+    }, {
+        autoInc: true,
+    });
     // --- Lifecycle ---
     ctx.on('ready', async () => {
         logger.info('Plugin initialized.');
@@ -255,24 +273,11 @@ function apply(ctx, config) {
                 logger.error(`[Recall Failed] Group: ${groupId}, Msg: ${messageId}, Error: ${err}`);
             }
         }
-        // 2. Send Censored Text (Modified format)
-        if (result.censoredText) {
-            try {
-                // Format: "您触发了违禁词检测:违禁词:(censored_text)"
-                const warningMsg = session.text('commands.temporaryban.messages.violation_detected', [result.censoredText]);
-                await session.send(koishi_1.h.at(userId) + ' ' + warningMsg);
-            }
-            catch (err) {
-                logger.error(`[Send Failed] Group: ${groupId}, Error: ${err}`);
-            }
-        }
-        // 3. Record Violation (Email Notification Logic Changed)
-        await mailer.recordViolation(userId, groupId, words, session.content);
-        // 4. Track & Punish
+        // 2. Track & Punish Calculation
         const recordKey = `${groupId}-${userId}`;
-        let record = userRecords.get(recordKey);
-        // Use effectiveConfig
+        // 'now' variable is already declared above at line 262
         const triggerWindow = (groupConfig.triggerWindowMinutes ?? 5) * koishi_1.Time.minute;
+        let record = userRecords.get(recordKey);
         if (!record) {
             record = { count: 1, firstTime: now };
             userRecords.set(recordKey, record);
@@ -288,9 +293,35 @@ function apply(ctx, config) {
                 record.count++;
             }
         }
-        logger.info(`[COUNT] [Group: ${groupId}] [User: ${userId}] ${record.count}/${effectiveConfig.triggerThreshold}`);
-        if (record.count >= effectiveConfig.triggerThreshold) {
-            const muteSeconds = Math.floor(effectiveConfig.muteMinutes * 60);
+        const currentCount = record.count;
+        const maxCount = effectiveConfig.triggerThreshold;
+        const remaining = Math.max(0, maxCount - currentCount);
+        const muteMinutes = effectiveConfig.muteMinutes;
+        logger.info(`[COUNT] [Group: ${groupId}] [User: ${userId}] ${currentCount}/${maxCount}`);
+        // 3. Send Warning
+        if (result.censoredText) {
+            try {
+                const showWord = groupConfig.showCensoredWord ?? config.defaultShowCensoredWord ?? true;
+                const wordDisplay = showWord ? result.censoredText : '***';
+                // Format: "You triggered a forbidden word check: {0}\nCurrent violations: {1}/{2}\n{3} more violations will result in a {4} min mute."
+                const warningMsg = session.text('commands.temporaryban.messages.violation_detail', [
+                    wordDisplay,
+                    currentCount,
+                    maxCount,
+                    remaining,
+                    muteMinutes
+                ]);
+                await session.send(koishi_1.h.at(userId) + ' ' + warningMsg);
+            }
+            catch (err) {
+                logger.error(`[Send Failed] Group: ${groupId}, Error: ${err}`);
+            }
+        }
+        // 4. Record Violation (Mail)
+        await mailer.recordViolation(userId, groupId, words, session.content);
+        // 5. Mute Execution
+        if (currentCount >= maxCount) {
+            const muteSeconds = Math.floor(muteMinutes * 60);
             try {
                 if (session.bot.muteGuildMember) {
                     // Ensure parameters are correct: guildId, userId, milliseconds

package/lib/locales/en-US.d.ts

@@ -34,11 +34,25 @@ declare const _default: {
                 history_list: string;
                 cleanup_info: string;
                 group_info: string;
+                violation_detail: string;
+                ignored_word_added: string;
+                ignored_word_removed: string;
+                no_ignored_words: string;
+                ignored_words_list: string;
             };
         };
         'temporaryban.info': {
             description: string;
         };
+        'temporaryban.whitelist.word.add': {
+            description: string;
+        };
+        'temporaryban.whitelist.word.remove': {
+            description: string;
+        };
+        'temporaryban.whitelist.word.list': {
+            description: string;
+        };
         'temporaryban.report': {
             description: string;
         };

package/lib/locales/en-US.js

@@ -35,12 +35,26 @@ exports.default = {
                 no_history: 'No recent history for user {0}.',
                 history_list: 'Recent history for user {0}:\n{1}',
                 cleanup_info: 'Cache cleanup is mainly handled automatically by the system.',
-                group_info: 'Group Info ({0}):\nStatus: {1}\nMethods: {2}\nSmart Verify: {3}\nThreshold: {4}\nMute: {5}min\nWhitelist: {6}'
+                group_info: 'Group Info ({0}):\nStatus: {1}\nMethods: {2}\nSmart Verify: {3}\nThreshold: {4}\nMute: {5}min\nWhitelist: {6}',
+                violation_detail: 'You triggered a forbidden word check: {0}\nCurrent violations: {1}/{2}\n{3} more violations will result in a {4} min mute.',
+                ignored_word_added: 'Added "{0}" to ignored words list.',
+                ignored_word_removed: 'Removed "{0}" from ignored words list.',
+                no_ignored_words: 'No ignored words.',
+                ignored_words_list: 'Ignored words ({0}):\n{1}'
             }
         },
         'temporaryban.info': {
             description: 'View current group configuration'
         },
+        'temporaryban.whitelist.word.add': {
+            description: 'Add ignored word to group'
+        },
+        'temporaryban.whitelist.word.remove': {
+            description: 'Remove ignored word from group'
+        },
+        'temporaryban.whitelist.word.list': {
+            description: 'List ignored words in group'
+        },
         'temporaryban.report': {
             description: 'Manually trigger violation report (Global Admin only)'
         },

package/lib/locales/zh-CN.d.ts

@@ -34,11 +34,27 @@ declare const _default: {
                 history_list: string;
                 cleanup_info: string;
                 group_info: string;
+                violation_detail: string;
+                ignored_word_added: string;
+                ignored_word_removed: string;
+                no_ignored_words: string;
+                ignored_words_list: string;
+                no_whitelist_users: string;
+                whitelist_users_list: string;
             };
         };
         'temporaryban.info': {
             description: string;
         };
+        'temporaryban.whitelist.word.add': {
+            description: string;
+        };
+        'temporaryban.whitelist.word.remove': {
+            description: string;
+        };
+        'temporaryban.whitelist.word.list': {
+            description: string;
+        };
         'temporaryban.report': {
             description: string;
         };

package/lib/locales/zh-CN.js

@@ -35,12 +35,28 @@ exports.default = {
                 no_history: '用户 {0} 没有最近的历史记录。',
                 history_list: '用户 {0} 的最近历史记录:\n{1}',
                 cleanup_info: '缓存清理主要由系统自动进行。',
-                group_info: '群组信息 ({0}):\n状态: {1}\n检测方式: {2}\n智能验证: {3}\n触发阈值: {4}次\n禁言时长: {5}分钟\n白名单人数: {6}'
+                group_info: '群组信息 ({0}):\n状态: {1}\n检测方式: {2}\n智能验证: {3}\n触发阈值: {4}次\n禁言时长: {5}分钟\n白名单人数: {6}',
+                violation_detail: '您触发了违禁词检测:违禁词:({0})\n当前违规次数: {1}/{2}\n再违规 {3} 次将被禁言 {4} 分钟。',
+                ignored_word_added: '已添加 "{0}" 到本群忽略词列表。',
+                ignored_word_removed: '已从本群忽略词列表移除 "{0}"。',
+                no_ignored_words: '没有忽略词。',
+                ignored_words_list: '忽略词 ({0}):\n{1}',
+                no_whitelist_users: '白名单为空。',
+                whitelist_users_list: '白名单用户 ({0}):\n{1}'
             }
         },
         'temporaryban.info': {
             description: '查看当前群组的配置信息'
         },
+        'temporaryban.whitelist.word.add': {
+            description: '添加本群忽略词'
+        },
+        'temporaryban.whitelist.word.remove': {
+            description: '移除本群忽略词'
+        },
+        'temporaryban.whitelist.word.list': {
+            description: '列出本群忽略词'
+        },
         'temporaryban.report': {
             description: '手动触发违规报告（仅限全局管理员）'
         },

package/lib/services/detector.d.ts

@@ -11,6 +11,7 @@ export declare class DetectorService {
     private config;
     private logger;
     private localDictCache;
+    private ignoredWordsCache;
     private history;
     constructor(ctx: Context, config: Config, history: HistoryService);
     private initCache;
@@ -18,6 +19,10 @@ export declare class DetectorService {
     addWord(groupId: string, word: string): Promise<boolean>;
     removeWord(groupId: string, word: string): Promise<boolean>;
     getWords(groupId: string): BadWordItem[];
+    addIgnoredWord(groupId: string, word: string): Promise<boolean>;
+    removeIgnoredWord(groupId: string, word: string): Promise<boolean>;
+    getIgnoredWords(groupId: string): string[];
+    isIgnored(groupId: string, word: string): boolean;
     parseLocalDict(dictStr: string): BadWordItem[];
     reloadGroup(groupId: string): void;
     check(content: string, groupId: string, userId: string, groupConfig: any): Promise<CheckResult>;

package/lib/services/detector.js

@@ -40,6 +40,7 @@ const prompt_1 = require("../utils/prompt");
 class DetectorService {
     constructor(ctx, config, history) {
         this.localDictCache = new Map();
+        this.ignoredWordsCache = new Map(); // groupId -> Set<word>
         this.ctx = ctx;
         this.config = config;
         this.history = history;
@@ -84,7 +85,17 @@ class DetectorService {
             }
         }
         this.localDictCache = map;
+        // 3. Load Ignored Words
+        const allIgnored = await this.ctx.database.get('temporaryban_ignored_words', {});
+        this.ignoredWordsCache.clear();
+        for (const item of allIgnored) {
+            if (!this.ignoredWordsCache.has(item.groupId)) {
+                this.ignoredWordsCache.set(item.groupId, new Set());
+            }
+            this.ignoredWordsCache.get(item.groupId)?.add(item.word);
+        }
         this.logger.info(`Loaded bad words for ${map.size} groups from database.`);
+        this.logger.info(`Loaded ignored words for ${this.ignoredWordsCache.size} groups.`);
     }
     async addWord(groupId, word) {
         const exists = await this.ctx.database.get('temporaryban_badwords', { groupId, word });
@@ -119,6 +130,39 @@ class DetectorService {
     getWords(groupId) {
         return this.localDictCache.get(groupId) || [];
     }
+    async addIgnoredWord(groupId, word) {
+        const exists = await this.ctx.database.get('temporaryban_ignored_words', { groupId, word });
+        if (exists.length > 0)
+            return false;
+        await this.ctx.database.create('temporaryban_ignored_words', {
+            groupId,
+            word,
+            createdAt: new Date()
+        });
+        if (!this.ignoredWordsCache.has(groupId)) {
+            this.ignoredWordsCache.set(groupId, new Set());
+        }
+        this.ignoredWordsCache.get(groupId)?.add(word);
+        return true;
+    }
+    async removeIgnoredWord(groupId, word) {
+        const result = await this.ctx.database.remove('temporaryban_ignored_words', { groupId, word });
+        if (result.matched === 0)
+            return false;
+        if (this.ignoredWordsCache.has(groupId)) {
+            this.ignoredWordsCache.get(groupId)?.delete(word);
+        }
+        return true;
+    }
+    getIgnoredWords(groupId) {
+        return Array.from(this.ignoredWordsCache.get(groupId) || []);
+    }
+    isIgnored(groupId, word) {
+        const ignoredSet = this.ignoredWordsCache.get(groupId);
+        if (!ignoredSet || ignoredSet.size === 0)
+            return false;
+        return ignoredSet.has(word);
+    }
     // Deprecated/Helper for migration only
     parseLocalDict(dictStr) {
         const result = [];
@@ -249,7 +293,7 @@ class DetectorService {
                 const aiRes = await this.checkWithAI(contextPrompt, groupConfig.aiThreshold);
                 if (aiRes.detected) {
                     this.logger.info(`[Smart Verification] Confirmed violation.`);
-                    return aiRes; // Return AI result (usually more accurate/detailed)
+                    initialDetection = aiRes; // Update result with AI confirmation
                 }
                 else {
                     this.logger.info(`[Smart Verification] False positive dismissed by AI.`);
@@ -257,11 +301,23 @@ class DetectorService {
                 }
             }
         }
+        // 3. Ignored Words Filter (Whitelist)
+        if (initialDetection.detected && initialDetection.detectedWords) {
+            const filteredWords = initialDetection.detectedWords.filter(w => !this.isIgnored(groupId, w));
+            if (filteredWords.length === 0) {
+                if (this.config.debug && groupConfig.detailedLog) {
+                    this.logger.debug(`[Check] Ignored: All detected words are in whitelist. (${initialDetection.detectedWords.join(', ')})`);
+                }
+                return { detected: false };
+            }
+            // Update with filtered words
+            initialDetection.detectedWords = filteredWords;
+        }
         return initialDetection;
     }
     // --- OpenAI / SiliconFlow ---
     async checkWithAI(content, threshold = 0.6) {
-        if (!this.config.openai.apiKey) {
+        if (!this.config.openai?.apiKey) {
             this.logger.warn('OpenAI/SiliconFlow API Key is missing.');
             return { detected: false };
         }
@@ -315,7 +371,7 @@ class DetectorService {
     }
     // --- Baidu Cloud ---
     async checkWithBaidu(content) {
-        if (!this.config.baidu.apiKey || !this.config.baidu.secretKey) {
+        if (!this.config.baidu?.apiKey || !this.config.baidu?.secretKey) {
             this.logger.warn('Baidu API Key or Secret Key is missing.');
             return { detected: false };
         }
@@ -358,11 +414,12 @@ class DetectorService {
     }
     // --- Aliyun (Green 2.0 / Enhanced) ---
     async checkWithAliyun(content) {
-        const { accessKeyId, accessKeySecret, endpoint } = this.config.aliyun;
-        if (!accessKeyId || !accessKeySecret) {
+        const aliyunConfig = this.config.aliyun;
+        if (!aliyunConfig?.accessKeyId || !aliyunConfig?.accessKeySecret) {
             this.logger.warn('Aliyun AccessKey ID or Secret is missing.');
             return { detected: false };
         }
+        const { accessKeyId, accessKeySecret, endpoint } = aliyunConfig;
         // RPC Signature Implementation
         try {
             const params = {
@@ -419,11 +476,12 @@ class DetectorService {
     }
     // --- Tencent Cloud (TMS) ---
     async checkWithTencent(content) {
-        const { secretId, secretKey, region } = this.config.tencent;
-        if (!secretId || !secretKey) {
+        const tencentConfig = this.config.tencent;
+        if (!tencentConfig?.secretId || !tencentConfig?.secretKey) {
             this.logger.warn('Tencent SecretId or SecretKey is missing.');
             return { detected: false };
         }
+        const { secretId, secretKey, region } = tencentConfig;
         try {
             const endpoint = 'tms.tencentcloudapi.com';
             const service = 'tms';
@@ -453,6 +511,11 @@ class DetectorService {
             const signature = crypto.createHmac('sha256', kSigning).update(stringToSign).digest('hex');
             // 4. Authorization Header
             const authorization = `${algorithm} Credential=${secretId}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;
+            if (this.config.debug) {
+                this.logger.debug(`[Tencent Request] URL: https://${endpoint}`);
+                this.logger.debug(`[Tencent Request] Payload: ${payloadStr}`);
+                this.logger.debug(`[Tencent Request] Headers: X-TC-Action=${action}, X-TC-Version=${version}, Authorization=${authorization}`);
+            }
             const response = await this.ctx.http.post(`https://${endpoint}`, payload, {
                 headers: {
                     'Authorization': authorization,
@@ -484,7 +547,7 @@ class DetectorService {
         }
     }
     async checkWithApi(content) {
-        if (!this.config.api.apiId || !this.config.api.apiKey) {
+        if (!this.config.api?.apiId || !this.config.api?.apiKey) {
             this.logger.warn('API ID or Key is missing. Skipping API detection.');
             return { detected: false };
         }

package/lib/services/mailer.d.ts

@@ -1,13 +1,10 @@
 import { Context } from 'koishi';
 import { Config } from '../config';
 export declare class MailerService {
+    private ctx;
     private logger;
     private config;
-    private records;
-    private storagePath;
     constructor(ctx: Context, config: Config);
-    private loadRecords;
-    private saveRecords;
     recordViolation(userId: string, groupId: string, words: string[], content: string): Promise<void>;
     private sendImmediate;
     sendSummaryReport(hours: number): Promise<{

package/lib/services/mailer.js

@@ -36,72 +36,47 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MailerService = void 0;
 const koishi_1 = require("koishi");
 const nodemailer = __importStar(require("nodemailer"));
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 class MailerService {
     constructor(ctx, config) {
-        this.records = [];
+        this.ctx = ctx;
         this.config = config;
         this.logger = new koishi_1.Logger('temporaryban:mailer');
-        // Setup storage for persistence (simple JSON file)
-        this.storagePath = path.resolve(ctx.baseDir, 'data', 'temporaryban_records.json');
-        this.loadRecords();
         // Start periodic task if summary interval is set
-        if (this.config.smtp.summaryIntervalDays > 0) {
+        if (this.config.smtp?.summaryIntervalDays && this.config.smtp.summaryIntervalDays > 0) {
             // Check every hour if it's time to send (this is a simplified scheduler)
-            // For production, a more robust scheduler might be needed, but this works for now.
-            // We send reports based on interval from the *last send time* or just accumulate.
-            // Since we don't store "last sent time", we'll just run a check every day? 
-            // Better: use setInterval for the configured days.
             ctx.setInterval(() => {
-                this.sendSummaryReport(this.config.smtp.summaryIntervalDays * 24);
+                if (this.config.smtp) {
+                    this.sendSummaryReport(this.config.smtp.summaryIntervalDays * 24);
+                }
             }, this.config.smtp.summaryIntervalDays * 24 * 60 * 60 * 1000);
         }
     }
-    loadRecords() {
-        try {
-            if (fs.existsSync(this.storagePath)) {
-                const data = fs.readFileSync(this.storagePath, 'utf-8');
-                this.records = JSON.parse(data);
-            }
-        }
-        catch (err) {
-            this.logger.warn(`Failed to load records: ${err}`);
-            this.records = [];
-        }
-    }
-    saveRecords() {
-        try {
-            const dir = path.dirname(this.storagePath);
-            if (!fs.existsSync(dir)) {
-                fs.mkdirSync(dir, { recursive: true });
-            }
-            fs.writeFileSync(this.storagePath, JSON.stringify(this.records, null, 2));
-        }
-        catch (err) {
-            this.logger.error(`Failed to save records: ${err}`);
-        }
-    }
     async recordViolation(userId, groupId, words, content) {
+        if (!this.config.smtp)
+            return;
         // If summary interval is 0, send immediately (legacy mode)
         if (this.config.smtp.summaryIntervalDays === 0) {
             await this.sendImmediate(userId, groupId, words, content);
             return;
         }
-        // Otherwise, record it
-        this.records.push({
-            userId,
-            groupId,
-            words,
-            content,
-            timestamp: Date.now()
-        });
-        this.saveRecords();
-        this.logger.debug(`Violation recorded for user ${userId}. Total pending: ${this.records.length}`);
+        // Otherwise, record it to Database
+        try {
+            await this.ctx.database.create('temporaryban_violations', {
+                userId,
+                groupId,
+                words,
+                content,
+                timestamp: new Date()
+            });
+            this.logger.debug(`Violation recorded for user ${userId}.`);
+        }
+        catch (err) {
+            this.logger.error(`Failed to record violation to DB: ${err}`);
+        }
     }
     // Old method for immediate sending
     async sendImmediate(userId, groupId, words, content) {
-        if (!this.config.smtp.host || this.config.smtp.receivers.length === 0)
+        if (!this.config.smtp?.host || !this.config.smtp?.receivers?.length)
             return;
         const transporter = this.createTransporter();
         const html = `
@@ -150,13 +125,22 @@ class MailerService {
     }
     // New method for summary report
     async sendSummaryReport(hours) {
-        if (!this.config.smtp.host || this.config.smtp.receivers.length === 0) {
+        if (!this.config.smtp?.host || !this.config.smtp?.receivers?.length) {
             return { success: false, error: 'smtp_not_configured' };
         }
-        const now = Date.now();
-        const cutoff = now - hours * 60 * 60 * 1000;
-        // Filter records within the time window
-        const targetRecords = this.records.filter(r => r.timestamp >= cutoff);
+        const now = new Date();
+        const cutoff = new Date(now.getTime() - hours * 60 * 60 * 1000);
+        // Filter records within the time window from Database
+        let targetRecords = [];
+        try {
+            targetRecords = await this.ctx.database.get('temporaryban_violations', {
+                timestamp: { $gte: cutoff }
+            });
+        }
+        catch (err) {
+            this.logger.error(`Failed to fetch violations from DB: ${err}`);
+            return { success: false, error: 'db_error' };
+        }
         if (targetRecords.length === 0) {
             return { success: true, count: 0 };
         }
@@ -164,7 +148,7 @@ class MailerService {
         // Generate HTML Table
         const tableRows = targetRecords.map((r, index) => `
       <tr style="border-bottom: 1px solid #eee; background-color: ${index % 2 === 0 ? '#ffffff' : '#fcfcfc'};">
-        <td style="padding: 12px 8px; color: #666; font-size: 13px;">${new Date(r.timestamp).toLocaleString()}</td>
+        <td style="padding: 12px 8px; color: #666; font-size: 13px;">${r.timestamp.toLocaleString()}</td>
         <td style="padding: 12px 8px; font-weight: 500;">${r.groupId}</td>
         <td style="padding: 12px 8px;">${r.userId}</td>
         <td style="padding: 12px 8px;"><span style="background-color: #ffebee; color: #c62828; padding: 2px 6px; border-radius: 4px; font-size: 12px;">${r.words.join(', ')}</span></td>
@@ -235,16 +219,21 @@ class MailerService {
             return { success: false, error: String(err) };
         }
     }
-    cleanupOldRecords(days) {
-        const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
-        const initialLen = this.records.length;
-        this.records = this.records.filter(r => r.timestamp >= cutoff);
-        if (this.records.length !== initialLen) {
-            this.saveRecords();
-            this.logger.info(`Cleaned up ${initialLen - this.records.length} old records.`);
+    async cleanupOldRecords(days) {
+        const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000);
+        try {
+            await this.ctx.database.remove('temporaryban_violations', {
+                timestamp: { $lt: cutoff }
+            });
+        }
+        catch (err) {
+            this.logger.error(`Failed to cleanup old records: ${err}`);
         }
     }
     createTransporter() {
+        if (!this.config.smtp) {
+            throw new Error('SMTP configuration is missing');
+        }
         return nodemailer.createTransport({
             host: this.config.smtp.host,
             port: this.config.smtp.port,

package/lib/services/whitelist.d.ts

@@ -15,6 +15,7 @@ export declare class WhitelistService {
     init(): Promise<void>;
     add(groupId: string, userId: string): Promise<boolean>;
     remove(groupId: string, userId: string): Promise<boolean>;
+    private syncToConfig;
+    getWhitelist(groupId: string): string[];
     isWhitelisted(groupId: string, userId: string): boolean;
-    getList(groupId: string): string[];
 }

package/lib/services/whitelist.js

@@ -56,6 +56,8 @@ class WhitelistService {
             this.cache.set(groupId, new Set());
         }
         this.cache.get(groupId)?.add(userId);
+        // Sync to Config
+        await this.syncToConfig(groupId, userId, 'add');
         return true;
     }
     async remove(groupId, userId) {
@@ -65,21 +67,39 @@ class WhitelistService {
         if (this.cache.has(groupId)) {
             this.cache.get(groupId)?.delete(userId);
         }
-        // Note: If user is in Config whitelist, they are still effectively whitelisted unless we handle that.
-        // Ideally, we should warn or handle this. But for now, DB removal only affects DB entries.
-        // If the user was in Config, `isWhitelisted` will still return true because of the merge in `init`.
-        // BUT `init` is only called at start. So runtime cache is what matters.
-        // Actually, `init` merges config into cache. If we remove from cache here, it is removed from runtime check.
-        // But on restart, it will come back from Config.
-        // This is a known limitation of mixing Config and DB.
-        // We can just proceed.
+        // Sync to Config
+        await this.syncToConfig(groupId, userId, 'remove');
         return (result.matched || 0) > 0;
     }
-    isWhitelisted(groupId, userId) {
-        return this.cache.get(groupId)?.has(userId) || false;
+    async syncToConfig(groupId, userId, action) {
+        try {
+            const config = this.ctx.scope.config;
+            const groups = config.groups || [];
+            const groupConfig = groups.find((g) => g.groupId === groupId);
+            if (groupConfig) {
+                if (!groupConfig.whitelist)
+                    groupConfig.whitelist = [];
+                if (action === 'add') {
+                    if (!groupConfig.whitelist.some((w) => w.userId === userId)) {
+                        groupConfig.whitelist.push({ userId });
+                    }
+                }
+                else {
+                    groupConfig.whitelist = groupConfig.whitelist.filter((w) => w.userId !== userId);
+                }
+                // Update scope config
+                await this.ctx.scope.update(config);
+            }
+        }
+        catch (err) {
+            this.logger.warn(`Failed to sync whitelist to config: ${err}`);
+        }
     }
-    getList(groupId) {
+    getWhitelist(groupId) {
         return Array.from(this.cache.get(groupId) || []);
     }
+    isWhitelisted(groupId, userId) {
+        return this.cache.get(groupId)?.has(userId) || false;
+    }
 }
 exports.WhitelistService = WhitelistService;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-temporaryban",
-  "version": "1.0.6",
+  "version": "1.0.7-beta1",
   "description": "Koishi 违禁词检测与禁言插件，支持本地词库与在线API检测，违规邮件通知。",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -41,7 +41,8 @@
     },
     "service": {
       "required": [
-        "database"
+        "database",
+        "http"
       ],
       "optional": []
     }