koishi-plugin-blacklist-online 0.1.0 → 0.1.2

package/lib/core.d.ts

@@ -5,7 +5,7 @@ export declare function isUserAdmin(session: Session, config: PluginConfig, user
 export declare function syncBlacklist(ctx: Context, config: PluginConfig): Promise<void>;
 export declare function queueRequest(ctx: Context, type: 'ADD' | 'REMOVE' | 'CANCEL', payload: any): Promise<any>;
 export declare function processOfflineQueue(ctx: Context, config: PluginConfig): Promise<void>;
-export declare function checkAndHandleUser(ctx: Context, config: PluginConfig, session: Session, userId: string): Promise<boolean>;
+export declare function checkAndHandleUser(ctx: Context, config: PluginConfig, session: Session, user_id: string): Promise<boolean>;
 export declare function parseUserId(input: string): string;
 export declare function scanGuild(ctx: Context, config: PluginConfig, bot: any, // 传入具体的 bot 实例
 guildId: string): Promise<{

package/lib/core.js

@@ -68,7 +68,7 @@ async function syncBlacklist(ctx, config) {
             if (data.upserts?.length)
                 await ctx.database.upsert('blacklist_users', data.upserts);
             if (data.deletes?.length)
-                await ctx.database.remove('blacklist_users', { userId: data.deletes });
+                await ctx.database.remove('blacklist_users', { user_id: data.deletes });
         }
         await ctx.database.upsert('blacklist_meta', [{ key: 'sync_revision', value: newRevision }]);
         logger.info('✅ 同步完成');
@@ -146,7 +146,7 @@ async function processOfflineQueue(ctx, config) {
     }
 }
 // --- 5. 用户检查核心 ---
-async function checkAndHandleUser(ctx, config, session, userId) {
+async function checkAndHandleUser(ctx, config, session, user_id) {
     if (!session.guildId)
         return false;
     const guildSettings = await ctx.database.get('blacklist_guild_settings', { guildId: session.guildId });
@@ -155,25 +155,25 @@ async function checkAndHandleUser(ctx, config, session, userId) {
         return false;
     // 1. 本地白名单 (最高优先级)
     const protectedSet = new Set(config.protectedUsers || []);
-    if (protectedSet.has(userId))
+    if (protectedSet.has(user_id))
         return false;
     // 2. 查库
-    const entries = await ctx.database.get('blacklist_users', { userId, disabled: false });
+    const entries = await ctx.database.get('blacklist_users', { user_id, disabled: false });
     if (entries.length === 0)
         return false;
     const entry = entries[0];
     const reason = entry.reason || 'QQ号黑名单';
     // 3. 查管理员
-    if (await isUserAdmin(session, config, userId)) {
-        logger.info(`🛡️ 跳过黑名单管理员 ${userId}`);
+    if (await isUserAdmin(session, config, user_id)) {
+        logger.info(`🛡️ 跳过黑名单管理员 ${user_id}`);
         return false;
     }
-    logger.info(`🎯 [群: ${session.guildId}] 发现黑名单用户: ${userId} - 原因: ${reason}`);
+    logger.info(`🎯 [群: ${session.guildId}] 发现黑名单用户: ${user_id} - 原因: ${reason}`);
     // 获取显示名
-    let displayName = userId;
+    let displayName = user_id;
     try {
-        const member = await session.bot.getGuildMember(session.guildId, userId);
-        displayName = member.nick || member.user?.name || userId;
+        const member = await session.bot.getGuildMember(session.guildId, user_id);
+        displayName = member.nick || member.user?.name || user_id;
     }
     catch {
     }
@@ -182,7 +182,7 @@ async function checkAndHandleUser(ctx, config, session, userId) {
         const tpl = mode === 'notify' ? config.adminNotifyMessage : config.kickNotifyMessage;
         const msg = tpl
             .replace('{user}', displayName)
-            .replace('{userId}', userId)
+            .replace('{userId}', user_id)
             .replace('{reason}', reason)
             .replace('{guild}', session.guildId);
         // 引用回复
@@ -193,9 +193,9 @@ async function checkAndHandleUser(ctx, config, session, userId) {
     if (mode === 'kick' || mode === 'both') {
         for (let i = 0; i < config.retryAttempts; i++) {
             try {
-                await session.bot.kickGuildMember(session.guildId, userId);
+                await session.bot.kickGuildMember(session.guildId, user_id);
                 kicked = true;
-                logger.info(`✅ [群: ${session.guildId}] 成功踢出: ${userId}`);
+                logger.info(`✅ [群: ${session.guildId}] 成功踢出: ${user_id}`);
                 break;
             }
             catch (e) {
@@ -211,9 +211,9 @@ async function checkAndHandleUser(ctx, config, session, userId) {
         if (kicked && config.verifyKickResult) {
             await (0, exports.sleep)(2000);
             try {
-                await session.bot.getGuildMember(session.guildId, userId);
+                await session.bot.getGuildMember(session.guildId, user_id);
                 // 如果还能获取到，说明没踢掉
-                logger.warn(`⚠️ [群: ${session.guildId}] 踢出验证失败，用户仍在群内: ${userId}`);
+                logger.warn(`⚠️ [群: ${session.guildId}] 踢出验证失败，用户仍在群内: ${user_id}`);
             }
             catch {
                 // 获取不到说明踢出成功
@@ -240,7 +240,7 @@ guildId) {
         const members = await bot.getGuildMemberList(guildId);
         // 2. 获取本地黑名单缓存
         const blacklist = await ctx.database.get('blacklist_users', { disabled: false });
-        const blacklistSet = new Set(blacklist.map(b => b.userId));
+        const blacklistSet = new Set(blacklist.map(b => b.user_id));
         // 3. 筛选目标 (内存操作，极快)
         const targets = members.data.filter((m) => {
             if (!m.user?.id)

package/lib/index.d.ts

@@ -2,6 +2,6 @@ import { Context, Schema } from 'koishi';
 import { PluginConfig } from './types';
 export declare const name = "blacklist-online";
 export declare const inject: string[];
-export declare const usage = "\n## \u529F\u80FD\u8BF4\u660E\n\u4E00\u4E2A\u5F3A\u5927\u7684\u3001\u57FA\u4E8E\u6570\u636E\u5E93\u7684\u7FA4\u7EC4\u9ED1\u540D\u5355\u7BA1\u7406\u63D2\u4EF6\u3002\n- **\u6570\u636E\u5E93\u9A71\u52A8**: QQ\u53F7\u9ED1\u540D\u5355\u5B58\u50A8\u5728\u6570\u636E\u5E93\u4E2D\uFF0C\u53EF\u901A\u8FC7\u6307\u4EE4\u52A8\u6001\u589E\u5220\uFF0C\u652F\u6301\u64CD\u4F5C\u8FFD\u6EAF\u3002\n- **\u53D7\u4FDD\u62A4\u540D\u5355**: \u914D\u7F6E\u4E2D\u7684\u7528\u6237\u65E0\u6CD5\u88AB\u62C9\u9ED1\u3002\n- **\u7533\u8BF7/\u5BA1\u6279\u6D41\u7A0B**: \u666E\u901A\u7FA4\u7BA1\u7406\u53EF\u63D0\u4EA4\u62C9\u9ED1\u7533\u8BF7\uFF0C\u7531\u673A\u5668\u4EBA\u7BA1\u7406\u5458\u5BA1\u6279\uFF0C\u6240\u6709\u6D41\u7A0B\u81EA\u52A8\u5316\u901A\u77E5\u3002\n- **\u5206\u7FA4\u7BA1\u7406**: \u53EF\u4E3A\u6BCF\u4E2A\u7FA4\u72EC\u7ACB\u8BBE\u7F6E\u9ED1\u540D\u5355\u5904\u7406\u6A21\u5F0F\u3002\n- **\u6635\u79F0\u9ED1\u540D\u5355**: \u652F\u6301\u914D\u7F6E\u9759\u6001\u7684\u6635\u79F0\u5173\u952E\u8BCD\u9ED1\u540D\u5355\uFF0C\u5E76\u6709\u603B\u5F00\u5173\u63A7\u5236\u3002\n- **\u5165\u7FA4\u626B\u63CF**: \u53EF\u914D\u7F6E\u673A\u5668\u4EBA\u5728\u52A0\u5165\u65B0\u7FA4\u7EC4\u65F6\uFF0C\u81EA\u52A8\u626B\u63CF\u7FA4\u5185\u73B0\u6709\u6210\u5458\u3002\n- **\u5EF6\u8FDF\u68C0\u67E5**: \u65B0\u6210\u5458\u52A0\u5165\u540E\uFF0C\u53EF\u914D\u7F6E\u5EF6\u8FDF\u53CA\u5468\u671F\u6027\u6635\u79F0\u68C0\u67E5\uFF0C\u9632\u6B62\u5176\u4FEE\u6539\u6635\u79F0\u7ED5\u8FC7\u68C0\u6D4B\u3002\n- **\u81EA\u52A8\u62D2\u7EDD**: \u81EA\u52A8\u62D2\u7EDD\u6570\u636E\u5E93\u9ED1\u540D\u5355\u7528\u6237\u7684\u52A0\u7FA4\u7533\u8BF7\u3002\n- **\u624B\u52A8\u626B\u63CF**: \u63D0\u4F9B\u6307\u4EE4\u624B\u52A8\u626B\u63CF\u5F53\u524D\u6216\u5168\u90E8\u7FA4\u7EC4\u3002\n- **\u6743\u9650\u63A7\u5236**: \u6240\u6709\u6307\u4EE4\u5747\u6709\u6743\u9650\u7B49\u7EA7\u63A7\u5236\u3002\n";
+export declare const usage = "\n## \u529F\u80FD\u8BF4\u660E\n\u4E00\u4E2A\u5F3A\u5927\u7684\u3001\u57FA\u4E8E\u6570\u636E\u5E93\u7684\u7FA4\u7EC4\u9ED1\u540D\u5355\u7BA1\u7406\u63D2\u4EF6\u3002\n- **\u53D7\u4FDD\u62A4\u540D\u5355**: \u914D\u7F6E\u4E2D\u7684\u7528\u6237\u65E0\u6CD5\u88AB\u62C9\u9ED1\u3002\n- **\u5206\u7FA4\u7BA1\u7406**: \u53EF\u4E3A\u6BCF\u4E2A\u7FA4\u72EC\u7ACB\u8BBE\u7F6E\u9ED1\u540D\u5355\u5904\u7406\u6A21\u5F0F\u3002\n- **\u5165\u7FA4\u626B\u63CF**: \u53EF\u914D\u7F6E\u673A\u5668\u4EBA\u5728\u52A0\u5165\u65B0\u7FA4\u7EC4\u65F6\uFF0C\u81EA\u52A8\u626B\u63CF\u7FA4\u5185\u73B0\u6709\u6210\u5458\u3002\n- **\u81EA\u52A8\u62D2\u7EDD**: \u81EA\u52A8\u62D2\u7EDD\u6570\u636E\u5E93\u9ED1\u540D\u5355\u7528\u6237\u7684\u52A0\u7FA4\u7533\u8BF7\u3002\n- **\u624B\u52A8\u626B\u63CF**: \u63D0\u4F9B\u6307\u4EE4\u624B\u52A8\u626B\u63CF\u5F53\u524D\u6216\u5168\u90E8\u7FA4\u7EC4\u3002\n- **\u6743\u9650\u63A7\u5236**: \u6240\u6709\u6307\u4EE4\u5747\u6709\u6743\u9650\u7B49\u7EA7\u63A7\u5236\u3002\n";
 export declare const Config: Schema<PluginConfig>;
 export declare function apply(ctx: Context, config: PluginConfig): void;

package/lib/index.js

@@ -10,13 +10,9 @@ exports.inject = ['database', 'http'];
 exports.usage = `
 ## 功能说明
 一个强大的、基于数据库的群组黑名单管理插件。
-- **数据库驱动**: QQ号黑名单存储在数据库中，可通过指令动态增删，支持操作追溯。
 - **受保护名单**: 配置中的用户无法被拉黑。
-- **申请/审批流程**: 普通群管理可提交拉黑申请，由机器人管理员审批，所有流程自动化通知。
 - **分群管理**: 可为每个群独立设置黑名单处理模式。
-- **昵称黑名单**: 支持配置静态的昵称关键词黑名单，并有总开关控制。
 - **入群扫描**: 可配置机器人在加入新群组时，自动扫描群内现有成员。
-- **延迟检查**: 新成员加入后，可配置延迟及周期性昵称检查，防止其修改昵称绕过检测。
 - **自动拒绝**: 自动拒绝数据库黑名单用户的加群申请。
 - **手动扫描**: 提供指令手动扫描当前或全部群组。
 - **权限控制**: 所有指令均有权限等级控制。
@@ -54,8 +50,13 @@ function apply(ctx, config) {
     const logger = ctx.logger('blacklist-online');
     // 1. 扩展数据库
     ctx.model.extend('blacklist_users', {
-        userId: 'string', reason: 'string', disabled: { type: 'boolean', initial: false }, updatedAt: 'timestamp'
-    }, { primary: 'userId' });
+        user_id: 'string',
+        reason: 'string',
+        disabled: { type: 'boolean', initial: false },
+        operator_id: 'string',
+        source_id: 'string',
+        updated_at: 'timestamp'
+    }, { primary: 'user_id' });
     ctx.model.extend('blacklist_request_queue', {
         id: 'string', type: 'string', payload: 'json', createdAt: 'timestamp', retryCount: 'unsigned'
     }, { primary: 'id' });
@@ -94,7 +95,7 @@ function apply(ctx, config) {
         if (config.protectedUsers.includes(session.userId))
             return;
         // 查库
-        const entries = await ctx.database.get('blacklist_users', { userId: session.userId, disabled: false });
+        const entries = await ctx.database.get('blacklist_users', { user_id: session.userId, disabled: false });
         if (entries.length > 0) {
             try {
                 await session.bot.handleGuildRequest(session.messageId, false, config.rejectionMessage);

package/lib/types.d.ts

@@ -16,11 +16,12 @@ export interface PluginConfig {
     autoRejectNotifyMessage: string;
 }
 export interface BlacklistEntry {
-    userId: string;
+    user_id: string;
     reason: string;
-    operatorId?: string;
+    operator_id?: string;
+    source_id?: string;
     disabled: boolean;
-    updatedAt: Date;
+    updated_at: Date;
 }
 export interface OfflineRequest {
     id: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-blacklist-online",
   "description": "自用插件",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [