koishi-plugin-bind-bot 2.2.9 → 2.3.0

package/lib/export-utils.js

@@ -38,6 +38,7 @@ const XLSX = __importStar(require("xlsx"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const bind_status_1 = require("./utils/bind-status");
+const helpers_1 = require("./utils/helpers");
 class GroupExporter {
     logger;
     ctx;
@@ -169,7 +170,7 @@ class GroupExporter {
                 MC_UUID: binding?.mcUuid || '',
                 B站UID: binding?.buidUid || '',
                 B站用户名: binding?.buidUsername || '',
-                舰长等级: binding?.guardLevelText || '',
+                舰长等级: (0, helpers_1.getGuardLevelText)(binding?.guardLevel),
                 粉丝牌名称: binding?.medalName || '',
                 粉丝牌等级: binding?.medalLevel ? binding.medalLevel.toString() : '',
                 荣耀等级: binding?.wealthMedalLevel ? binding.wealthMedalLevel.toString() : '',

package/lib/handlers/binding.handler.js

@@ -4,6 +4,7 @@ exports.BindingHandler = void 0;
 const koishi_1 = require("koishi");
 const base_handler_1 = require("./base.handler");
 const bind_status_1 = require("../utils/bind-status");
+const helpers_1 = require("../utils/helpers");
 /**
  * 交互式绑定命令处理器
  * 处理 "绑定" 命令，引导用户完成 MC 和 B站双重绑定
@@ -25,7 +26,7 @@ class BindingHandler extends base_handler_1.BaseHandler {
         const displayUsername = bind_status_1.BindStatus.getDisplayMcUsername(bind, '未绑定');
         let bindInfo = `${prefix}\n✅ MC账号: ${displayUsername}\n✅ B站账号: ${bind.buidUsername} (UID: ${bind.buidUid})`;
         if (bind.guardLevel > 0) {
-            bindInfo += `\n舰长等级: ${bind.guardLevelText}`;
+            bindInfo += `\n舰长等级: ${(0, helpers_1.getGuardLevelText)(bind.guardLevel)}`;
         }
         if (bind.medalName) {
             bindInfo += `\n粉丝牌: ${bind.medalName} Lv.${bind.medalLevel}`;

package/lib/handlers/buid.handler.js

@@ -8,6 +8,7 @@ const koishi_1 = require("koishi");
 const base_handler_1 = require("./base.handler");
 const axios_1 = __importDefault(require("axios"));
 const bind_status_1 = require("../utils/bind-status");
+const helpers_1 = require("../utils/helpers");
 /**
  * BUID 命令处理器
  * 处理 B站账号相关命令
@@ -78,13 +79,13 @@ class BuidHandler extends base_handler_1.BaseHandler {
             const userInfo = `${target ? `用户 ${bind.qqId} 的` : '您的'}B站账号信息：\nB站UID: ${bind.buidUid}\n用户名: ${bind.buidUsername}`;
             let detailInfo = '';
             if (bind.guardLevel > 0) {
-                detailInfo += `\n舰长等级: ${bind.guardLevelText} (${bind.guardLevel})`;
+                detailInfo += `\n舰长等级: ${(0, helpers_1.getGuardLevelText)(bind.guardLevel)} (${bind.guardLevel})`;
                 if (bind.maxGuardLevel > 0 && bind.maxGuardLevel < bind.guardLevel) {
-                    detailInfo += `\n历史最高: ${bind.maxGuardLevelText} (${bind.maxGuardLevel})`;
+                    detailInfo += `\n历史最高: ${(0, helpers_1.getGuardLevelText)(bind.maxGuardLevel)} (${bind.maxGuardLevel})`;
                 }
             }
             else if (bind.maxGuardLevel > 0) {
-                detailInfo += `\n历史舰长: ${bind.maxGuardLevelText} (${bind.maxGuardLevel})`;
+                detailInfo += `\n历史舰长: ${(0, helpers_1.getGuardLevelText)(bind.maxGuardLevel)} (${bind.maxGuardLevel})`;
             }
             detailInfo += `\n粉丝牌: ${bind.medalName || '无'} Lv.${bind.medalLevel || 0}`;
             detailInfo += `\n荣耀等级: ${bind.wealthMedalLevel || 0}`;
@@ -161,13 +162,13 @@ class BuidHandler extends base_handler_1.BaseHandler {
             // 构建详细信息
             let adminInfo = `B站UID"${bind.buidUid}"绑定信息:\nQQ号: ${bind.qqId}\n用户名: ${bind.buidUsername}`;
             if (bind.guardLevel > 0) {
-                adminInfo += `\n舰长等级: ${bind.guardLevelText} (${bind.guardLevel})`;
+                adminInfo += `\n舰长等级: ${(0, helpers_1.getGuardLevelText)(bind.guardLevel)} (${bind.guardLevel})`;
                 if (bind.maxGuardLevel > 0 && bind.maxGuardLevel < bind.guardLevel) {
-                    adminInfo += `\n历史最高: ${bind.maxGuardLevelText} (${bind.maxGuardLevel})`;
+                    adminInfo += `\n历史最高: ${(0, helpers_1.getGuardLevelText)(bind.maxGuardLevel)} (${bind.maxGuardLevel})`;
                 }
             }
             else if (bind.maxGuardLevel > 0) {
-                adminInfo += `\n历史舰长: ${bind.maxGuardLevelText} (${bind.maxGuardLevel})`;
+                adminInfo += `\n历史舰长: ${(0, helpers_1.getGuardLevelText)(bind.maxGuardLevel)} (${bind.maxGuardLevel})`;
             }
             if (bind.medalName) {
                 adminInfo += `\n粉丝牌: ${bind.medalName} Lv.${bind.medalLevel}`;
@@ -374,9 +375,7 @@ class BuidHandler extends base_handler_1.BaseHandler {
                 buidUid: buidUser.uid,
                 buidUsername: buidUser.username,
                 guardLevel: buidUser.guard_level || 0,
-                guardLevelText: buidUser.guard_level_text || '',
                 maxGuardLevel: buidUser.max_guard_level || 0,
-                maxGuardLevelText: buidUser.max_guard_level_text || '',
                 medalName: buidUser.medal?.name || '',
                 medalLevel: buidUser.medal?.level || 0,
                 wealthMedalLevel: buidUser.wealthMedalLevel || 0,
@@ -431,9 +430,7 @@ class BuidHandler extends base_handler_1.BaseHandler {
             const updateData = {
                 buidUsername: buidUser.username,
                 guardLevel: buidUser.guard_level || 0,
-                guardLevelText: buidUser.guard_level_text || '',
                 maxGuardLevel: buidUser.max_guard_level || 0,
-                maxGuardLevelText: buidUser.max_guard_level_text || '',
                 medalName: buidUser.medal?.name || '',
                 medalLevel: buidUser.medal?.level || 0,
                 wealthMedalLevel: buidUser.wealthMedalLevel || 0,

package/lib/handlers/group-request-review.handler.js

@@ -638,9 +638,7 @@ class GroupRequestReviewHandler extends base_handler_1.BaseHandler {
                 buidUid: zminfoUser.uid,
                 buidUsername: zminfoUser.username,
                 guardLevel: zminfoUser.guard_level || 0,
-                guardLevelText: zminfoUser.guard_level_text || '',
                 maxGuardLevel: zminfoUser.guard_level || 0,
-                maxGuardLevelText: zminfoUser.guard_level_text || '',
                 medalName: zminfoUser.medal?.name || '',
                 medalLevel: zminfoUser.medal?.level || 0,
                 wealthMedalLevel: zminfoUser.wealthMedalLevel || 0,
@@ -659,11 +657,7 @@ class GroupRequestReviewHandler extends base_handler_1.BaseHandler {
                 buidUid: zminfoUser.uid,
                 buidUsername: zminfoUser.username,
                 guardLevel: zminfoUser.guard_level || 0,
-                guardLevelText: zminfoUser.guard_level_text || '',
                 maxGuardLevel: Math.max(bind.maxGuardLevel || 0, zminfoUser.guard_level || 0),
-                maxGuardLevelText: zminfoUser.guard_level > (bind.maxGuardLevel || 0)
-                    ? zminfoUser.guard_level_text
-                    : bind.maxGuardLevelText,
                 medalName: zminfoUser.medal?.name || '',
                 medalLevel: zminfoUser.medal?.level || 0,
                 wealthMedalLevel: zminfoUser.wealthMedalLevel || 0,

package/lib/handlers/mcid.handler.js

@@ -4,6 +4,7 @@ exports.McidCommandHandler = void 0;
 const koishi_1 = require("koishi");
 const base_handler_1 = require("./base.handler");
 const bind_status_1 = require("../utils/bind-status");
+const helpers_1 = require("../utils/helpers");
 class McidCommandHandler extends base_handler_1.BaseHandler {
     /**
      * 注册所有MCID命令
@@ -92,14 +93,14 @@ class McidCommandHandler extends base_handler_1.BaseHandler {
                             if (refreshedBind) {
                                 let buidInfo = `该用户尚未绑定MC账号\n\nB站账号信息：\nB站UID: ${refreshedBind.buidUid}\n用户名: ${refreshedBind.buidUsername}`;
                                 if (refreshedBind.guardLevel > 0) {
-                                    buidInfo += `\n舰长等级: ${refreshedBind.guardLevelText} (${refreshedBind.guardLevel})`;
+                                    buidInfo += `\n舰长等级: ${(0, helpers_1.getGuardLevelText)(refreshedBind.guardLevel)} (${refreshedBind.guardLevel})`;
                                     if (refreshedBind.maxGuardLevel > 0 &&
                                         refreshedBind.maxGuardLevel < refreshedBind.guardLevel) {
-                                        buidInfo += `\n历史最高: ${refreshedBind.maxGuardLevelText} (${refreshedBind.maxGuardLevel})`;
+                                        buidInfo += `\n历史最高: ${(0, helpers_1.getGuardLevelText)(refreshedBind.maxGuardLevel)} (${refreshedBind.maxGuardLevel})`;
                                     }
                                 }
                                 else if (refreshedBind.maxGuardLevel > 0) {
-                                    buidInfo += `\n历史舰长: ${refreshedBind.maxGuardLevelText} (${refreshedBind.maxGuardLevel})`;
+                                    buidInfo += `\n历史舰长: ${(0, helpers_1.getGuardLevelText)(refreshedBind.maxGuardLevel)} (${refreshedBind.maxGuardLevel})`;
                                 }
                                 if (refreshedBind.medalName) {
                                     buidInfo += `\n粉丝牌: ${refreshedBind.medalName} Lv.${refreshedBind.medalLevel}`;
@@ -132,14 +133,14 @@ class McidCommandHandler extends base_handler_1.BaseHandler {
                         if (refreshedBind) {
                             let buidInfo = `您尚未绑定MC账号\n\nB站账号信息：\nB站UID: ${refreshedBind.buidUid}\n用户名: ${refreshedBind.buidUsername}`;
                             if (refreshedBind.guardLevel > 0) {
-                                buidInfo += `\n舰长等级: ${refreshedBind.guardLevelText} (${refreshedBind.guardLevel})`;
+                                buidInfo += `\n舰长等级: ${(0, helpers_1.getGuardLevelText)(refreshedBind.guardLevel)} (${refreshedBind.guardLevel})`;
                                 if (refreshedBind.maxGuardLevel > 0 &&
                                     refreshedBind.maxGuardLevel < refreshedBind.guardLevel) {
-                                    buidInfo += `\n历史最高: ${refreshedBind.maxGuardLevelText} (${refreshedBind.maxGuardLevel})`;
+                                    buidInfo += `\n历史最高: ${(0, helpers_1.getGuardLevelText)(refreshedBind.maxGuardLevel)} (${refreshedBind.maxGuardLevel})`;
                                 }
                             }
                             else if (refreshedBind.maxGuardLevel > 0) {
-                                buidInfo += `\n历史舰长: ${refreshedBind.maxGuardLevelText} (${refreshedBind.maxGuardLevel})`;
+                                buidInfo += `\n历史舰长: ${(0, helpers_1.getGuardLevelText)(refreshedBind.maxGuardLevel)} (${refreshedBind.maxGuardLevel})`;
                             }
                             if (refreshedBind.medalName) {
                                 buidInfo += `\n粉丝牌: ${refreshedBind.medalName} Lv.${refreshedBind.medalLevel}`;
@@ -217,13 +218,13 @@ class McidCommandHandler extends base_handler_1.BaseHandler {
         if (bind.buidUid) {
             buidInfo = `B站账号信息：\nB站UID: ${bind.buidUid}\n用户名: ${bind.buidUsername}`;
             if (bind.guardLevel > 0) {
-                buidInfo += `\n舰长等级: ${bind.guardLevelText} (${bind.guardLevel})`;
+                buidInfo += `\n舰长等级: ${(0, helpers_1.getGuardLevelText)(bind.guardLevel)} (${bind.guardLevel})`;
                 if (bind.maxGuardLevel > 0 && bind.maxGuardLevel < bind.guardLevel) {
-                    buidInfo += `\n历史最高: ${bind.maxGuardLevelText} (${bind.maxGuardLevel})`;
+                    buidInfo += `\n历史最高: ${(0, helpers_1.getGuardLevelText)(bind.maxGuardLevel)} (${bind.maxGuardLevel})`;
                 }
             }
             else if (bind.maxGuardLevel > 0) {
-                buidInfo += `\n历史舰长: ${bind.maxGuardLevelText} (${bind.maxGuardLevel})`;
+                buidInfo += `\n历史舰长: ${(0, helpers_1.getGuardLevelText)(bind.maxGuardLevel)} (${bind.maxGuardLevel})`;
             }
             if (bind.medalName) {
                 buidInfo += `\n粉丝牌: ${bind.medalName} Lv.${bind.medalLevel}`;

package/lib/index.js

@@ -11,6 +11,7 @@ const rate_limiter_1 = require("./utils/rate-limiter");
 const helpers_1 = require("./utils/helpers");
 const error_utils_1 = require("./utils/error-utils");
 const mcidbind_repository_1 = require("./repositories/mcidbind.repository");
+const supabase_client_1 = require("./utils/supabase-client");
 const schedule_mute_repository_1 = require("./repositories/schedule-mute.repository");
 const handlers_1 = require("./handlers");
 const service_container_1 = require("./services/service-container");
@@ -53,6 +54,12 @@ exports.Config = koishi_1.Schema.object({
     forceBindTargetUpUid: koishi_1.Schema.number().description('强制绑定目标UP主UID').default(686127),
     forceBindTargetRoomId: koishi_1.Schema.number().description('强制绑定目标房间号').default(544853),
     forceBindTargetMedalName: koishi_1.Schema.string().description('强制绑定目标粉丝牌名称').default('生态'),
+    supabaseUrl: koishi_1.Schema.string()
+        .description('Supabase项目URL')
+        .default(''),
+    supabaseKey: koishi_1.Schema.string()
+        .description('Supabase API Key (anon/service_role key)')
+        .default(''),
     groupRequestReview: koishi_1.Schema.object({
         enabled: koishi_1.Schema.boolean().description('是否启用入群申请审批功能').default(false),
         targetGroupId: koishi_1.Schema.string()
@@ -109,7 +116,8 @@ function apply(ctx, config) {
     const logger = new koishi_1.Logger('bind-bot');
     const loggerService = new logger_1.LoggerService(logger, config.debugMode);
     // 创建数据仓储实例
-    const mcidbindRepo = new mcidbind_repository_1.MCIDBINDRepository(ctx, loggerService);
+    const supabaseClient = new supabase_client_1.SupabaseClient({ url: config.supabaseUrl, key: config.supabaseKey });
+    const mcidbindRepo = new mcidbind_repository_1.MCIDBINDRepository(supabaseClient, loggerService);
     const scheduleMuteRepo = new schedule_mute_repository_1.ScheduleMuteRepository(ctx, loggerService);
     // 交互型绑定会话管理
     const bindingSessions = new Map();
@@ -583,299 +591,7 @@ function apply(ctx, config) {
             content.body = 'Internal Server Error';
         }
     });
-    // 在数据库中创建MCIDBIND表
-    ctx.model.extend('mcidbind', {
-        qqId: {
-            type: 'string'
-        },
-        mcUsername: {
-            type: 'string',
-            initial: null
-        },
-        mcUuid: {
-            type: 'string',
-            initial: null
-        },
-        lastModified: {
-            type: 'timestamp',
-            initial: null
-        },
-        isAdmin: {
-            type: 'boolean',
-            initial: false
-        },
-        whitelist: {
-            type: 'json',
-            initial: []
-        },
-        tags: {
-            type: 'json',
-            initial: []
-        },
-        // BUID相关字段
-        buidUid: {
-            type: 'string',
-            initial: ''
-        },
-        buidUsername: {
-            type: 'string',
-            initial: ''
-        },
-        guardLevel: {
-            type: 'integer',
-            initial: 0
-        },
-        guardLevelText: {
-            type: 'string',
-            initial: ''
-        },
-        maxGuardLevel: {
-            type: 'integer',
-            initial: 0
-        },
-        maxGuardLevelText: {
-            type: 'string',
-            initial: ''
-        },
-        medalName: {
-            type: 'string',
-            initial: ''
-        },
-        medalLevel: {
-            type: 'integer',
-            initial: 0
-        },
-        wealthMedalLevel: {
-            type: 'integer',
-            initial: 0
-        },
-        lastActiveTime: {
-            type: 'timestamp',
-            initial: null
-        },
-        reminderCount: {
-            type: 'integer',
-            initial: 0
-        },
-        usernameLastChecked: {
-            type: 'timestamp',
-            initial: null
-        },
-        usernameCheckFailCount: {
-            type: 'integer',
-            initial: 0
-        },
-        // 绑定状态标志字段
-        hasMcBind: {
-            type: 'boolean',
-            initial: false
-        },
-        hasBuidBind: {
-            type: 'boolean',
-            initial: false
-        }
-    }, {
-        // 设置主键为qqId
-        primary: 'qqId',
-        // 添加索引
-        unique: [['mcUsername'], ['buidUid']],
-        // 添加isAdmin索引，提高查询效率
-        indexes: [['isAdmin'], ['buidUid']]
-    });
-    // 检查表结构是否包含旧字段
-    const checkTableStructure = async () => {
-        try {
-            // 尝试获取一条记录来检查字段
-            const records = await mcidbindRepo.findAll({ limit: 1 });
-            // 如果没有记录，不需要迁移
-            if (!records || records.length === 0)
-                return false;
-            // 检查记录中是否包含id或userId字段，或缺少whitelist字段
-            const record = records[0];
-            return 'id' in record || 'userId' in record || !('whitelist' in record);
-        }
-        catch (error) {
-            logger.error(`[初始化] 检查表结构失败: ${error.message}`);
-            return false;
-        }
-    };
-    // 添加缺失字段
-    const addMissingFields = async () => {
-        try {
-            // 获取所有记录
-            const records = await mcidbindRepo.findAll();
-            let updatedCount = 0;
-            // 更新每个缺少字段的记录
-            for (const record of records) {
-                let needUpdate = false;
-                const updateData = {};
-                const qqId = record.qqId; // 提前提取 qqId，避免类型推断问题
-                // 检查并添加whitelist字段
-                if (!record.whitelist) {
-                    updateData.whitelist = [];
-                    needUpdate = true;
-                }
-                // 检查并添加tags字段
-                if (!record.tags) {
-                    updateData.tags = [];
-                    needUpdate = true;
-                }
-                // 检查并添加maxGuardLevel字段
-                if (!('maxGuardLevel' in record)) {
-                    updateData.maxGuardLevel = 0;
-                    needUpdate = true;
-                }
-                // 检查并添加maxGuardLevelText字段
-                if (!('maxGuardLevelText' in record)) {
-                    updateData.maxGuardLevelText = '';
-                    needUpdate = true;
-                }
-                // 检查并添加reminderCount字段
-                if (!('reminderCount' in record)) {
-                    updateData.reminderCount = 0;
-                    needUpdate = true;
-                }
-                // 检查并修复hasMcBind字段（数据迁移 + 数据一致性检查）
-                const currentHasMcBind = record.hasMcBind;
-                const mcUsername = record.mcUsername;
-                const hasValidMc = !!(mcUsername && !mcUsername.startsWith('_temp_'));
-                // 情况1：字段不存在，需要添加
-                if (currentHasMcBind === undefined || currentHasMcBind === null) {
-                    updateData.hasMcBind = hasValidMc;
-                    needUpdate = true;
-                    logger.debug(`[数据迁移] 添加hasMcBind字段 QQ(${qqId}): ${hasValidMc}`);
-                }
-                // 情况2：字段存在但值不正确，需要修复
-                else if (currentHasMcBind !== hasValidMc) {
-                    updateData.hasMcBind = hasValidMc;
-                    needUpdate = true;
-                    logger.info(`[数据修复] 修正hasMcBind QQ(${qqId}): ${currentHasMcBind} -> ${hasValidMc}`);
-                }
-                // 清理临时用户名（无论hasMcBind字段是否存在）
-                if (!hasValidMc && mcUsername && mcUsername.startsWith('_temp_')) {
-                    updateData.mcUsername = null;
-                    updateData.mcUuid = null;
-                    updateData.whitelist = [];
-                    needUpdate = true;
-                    logger.info(`[数据清理] 清理QQ(${qqId})的临时用户名: ${mcUsername}`);
-                }
-                // 检查并修复hasBuidBind字段（数据迁移 + 数据一致性检查）
-                const currentHasBuidBind = record.hasBuidBind;
-                const buidUid = record.buidUid;
-                const hasValidBuid = !!(buidUid && buidUid.length > 0);
-                // 情况1：字段不存在，需要添加
-                if (currentHasBuidBind === undefined || currentHasBuidBind === null) {
-                    updateData.hasBuidBind = hasValidBuid;
-                    needUpdate = true;
-                    logger.debug(`[数据迁移] 添加hasBuidBind字段 QQ(${qqId}): ${hasValidBuid}`);
-                }
-                // 情况2：字段存在但值不正确，需要修复
-                else if (currentHasBuidBind !== hasValidBuid) {
-                    updateData.hasBuidBind = hasValidBuid;
-                    needUpdate = true;
-                    logger.info(`[数据修复] 修正hasBuidBind QQ(${qqId}): ${currentHasBuidBind} -> ${hasValidBuid}`);
-                }
-                // 如果需要更新，执行更新操作
-                if (needUpdate) {
-                    await mcidbindRepo.update(qqId, updateData);
-                    updatedCount++;
-                }
-            }
-            if (updatedCount > 0) {
-                logger.info(`[初始化] 成功为${updatedCount}条记录添加缺失字段`);
-            }
-            else {
-                logger.info('[初始化] 所有记录都包含必要字段，无需更新');
-            }
-            return true;
-        }
-        catch (error) {
-            logger.error(`[初始化] 添加缺失字段失败: ${error.message}`);
-            return false;
-        }
-    };
-    // 在插件启动时执行数据迁移（放在函数定义之后）
-    ctx.on('ready', async () => {
-        logger.info('[初始化] 开始数据迁移和一致性检查...');
-        await addMissingFields();
-    });
-    // 重建MCIDBIND表
-    const rebuildMcidBindTable = async () => {
-        try {
-            // 备份现有数据
-            const oldRecords = await mcidbindRepo.findAll();
-            logger.info(`[初始化] 成功备份${oldRecords.length}条记录`);
-            // 创建数据备份（用于恢复）
-            const backupData = JSON.parse(JSON.stringify(oldRecords));
-            try {
-                // 提取有效数据
-                const validRecords = oldRecords
-                    .map(record => {
-                    // 确保qqId存在
-                    if (!record.qqId) {
-                        // 如果没有qqId但有userId，尝试从userId提取
-                        if ('userId' in record && record.userId) {
-                            record.qqId = normalizeQQId(String(record.userId));
-                        }
-                        else {
-                            // 既没有qqId也没有userId，跳过此记录
-                            return null;
-                        }
-                    }
-                    return {
-                        qqId: record.qqId,
-                        mcUsername: record.mcUsername || '',
-                        mcUuid: record.mcUuid || '',
-                        lastModified: record.lastModified || new Date(),
-                        isAdmin: record.isAdmin || false,
-                        whitelist: record.whitelist || [],
-                        tags: record.tags || []
-                    };
-                })
-                    .filter(record => record !== null);
-                // 删除现有表
-                await mcidbindRepo.deleteAll();
-                logger.info('[初始化] 成功删除旧表数据');
-                // 重新创建记录
-                let successCount = 0;
-                let errorCount = 0;
-                for (const record of validRecords) {
-                    try {
-                        await mcidbindRepo.create(record);
-                        successCount++;
-                    }
-                    catch (e) {
-                        errorCount++;
-                        logger.warn(`[初始化] 重建记录失败 (QQ=${record.qqId}): ${e.message}`);
-                    }
-                }
-                logger.info(`[初始化] 成功重建了${successCount}条记录，失败${errorCount}条`);
-                return true;
-            }
-            catch (migrationError) {
-                // 迁移过程出错，尝试恢复
-                logger.error(`[初始化] 表重建过程失败，尝试恢复数据: ${migrationError.message}`);
-                try {
-                    // 清空表以避免重复数据
-                    await mcidbindRepo.deleteAll();
-                    // 恢复原始数据
-                    for (const record of backupData) {
-                        await mcidbindRepo.create(record);
-                    }
-                    logger.info(`[初始化] 成功恢复${backupData.length}条原始记录`);
-                }
-                catch (recoveryError) {
-                    logger.error(`[初始化] 数据恢复失败，可能导致数据丢失: ${recoveryError.message}`);
-                    throw new Error('数据迁移失败且无法恢复');
-                }
-                throw migrationError;
-            }
-        }
-        catch (error) {
-            logger.error(`[初始化] 重建表失败: ${error.message}`);
-            throw error;
-        }
-    };
+    // mcidbind 表已迁移至 Supabase，无需在 Koishi 中注册模型
     // 处理用户ID，去除平台前缀，只保留QQ号
     const normalizeQQId = (userId) => {
         // 处理空值情况

package/lib/repositories/mcidbind.repository.d.ts

@@ -1,117 +1,35 @@
-import { Context } from 'koishi';
 import { LoggerService } from '../utils/logger';
+import { SupabaseClient } from '../utils/supabase-client';
 import type { MCIDBIND } from '../types';
 /**
  * MCIDBIND 数据仓储类
- * 封装所有 MCIDBIND 表的数据库操作
+ * 通过 Supabase REST API 操作 user 表
  */
 export declare class MCIDBINDRepository {
-    private ctx;
+    private supabase;
     private logger;
-    constructor(ctx: Context, logger: LoggerService);
-    /**
-     * 根据 QQ 号查询绑定信息
-     * @param qqId QQ号（已规范化）
-     * @returns 绑定信息或 null
-     */
+    constructor(supabase: SupabaseClient, logger: LoggerService);
     findByQQId(qqId: string): Promise<MCIDBIND | null>;
-    /**
-     * 根据 MC 用户名查询绑定信息（精确匹配）
-     * @param mcUsername MC用户名
-     * @returns 绑定信息或 null
-     */
     findByMCUsername(mcUsername: string): Promise<MCIDBIND | null>;
-    /**
-     * 根据 MC 用户名查询绑定信息（不区分大小写）
-     * @param mcUsername MC用户名
-     * @returns 绑定信息或 null
-     */
     findByUsernameIgnoreCase(mcUsername: string): Promise<MCIDBIND | null>;
-    /**
-     * 根据 MC UUID 查询绑定信息
-     * @param mcUuid MC UUID（可带或不带连字符）
-     * @returns 绑定信息或 null
-     */
     findByUuid(mcUuid: string): Promise<MCIDBIND | null>;
-    /**
-     * 根据 B站 UID 查询绑定信息
-     * @param buidUid B站UID
-     * @returns 绑定信息或 null
-     */
     findByBuidUid(buidUid: string): Promise<MCIDBIND | null>;
-    /**
-     * 获取所有绑定记录
-     * @param options 查询选项
-     * @returns 绑定记录列表
-     */
     findAll(options?: {
         limit?: number;
     }): Promise<MCIDBIND[]>;
-    /**
-     * 根据标签查询绑定记录
-     * @param tag 标签名称
-     * @returns 包含该标签的绑定记录列表
-     */
     findByTag(tag: string): Promise<MCIDBIND[]>;
-    /**
-     * 创建新的绑定记录
-     * @param data 绑定数据
-     * @returns 创建的记录
-     */
     create(data: Partial<MCIDBIND> & {
         qqId: string;
     }): Promise<MCIDBIND>;
-    /**
-     * 更新绑定记录（部分字段）
-     * @param qqId QQ号
-     * @param data 要更新的字段
-     */
     update(qqId: string, data: Partial<MCIDBIND>): Promise<void>;
-    /**
-     * 删除绑定记录
-     * @param qqId QQ号
-     * @returns 删除的记录数
-     */
     delete(qqId: string): Promise<number>;
-    /**
-     * 删除所有绑定记录
-     * @returns 删除的记录数
-     */
     deleteAll(): Promise<number>;
-    /**
-     * 批量创建绑定记录
-     * @param records 绑定记录列表
-     */
     batchCreate(records: Array<Partial<MCIDBIND> & {
         qqId: string;
     }>): Promise<void>;
-    /**
-     * 为用户添加标签
-     * @param qqId QQ号
-     * @param tag 标签名称
-     */
     addTag(qqId: string, tag: string): Promise<void>;
-    /**
-     * 为用户移除标签
-     * @param qqId QQ号
-     * @param tag 标签名称
-     */
     removeTag(qqId: string, tag: string): Promise<void>;
-    /**
-     * 为用户添加白名单服务器
-     * @param qqId QQ号
-     * @param serverId 服务器ID
-     */
     addWhitelist(qqId: string, serverId: string): Promise<void>;
-    /**
-     * 为用户移除白名单服务器
-     * @param qqId QQ号
-     * @param serverId 服务器ID
-     */
     removeWhitelist(qqId: string, serverId: string): Promise<void>;
-    /**
-     * 获取所有管理员
-     * @returns 管理员列表
-     */
     findAllAdmins(): Promise<MCIDBIND[]>;
 }

package/lib/repositories/mcidbind.repository.js

@@ -2,171 +2,143 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MCIDBINDRepository = void 0;
 const helpers_1 = require("../utils/helpers");
+const TABLE = 'user';
+const DATE_FIELDS = ['lastModified', 'usernameLastChecked', 'lastActiveTime'];
+function deserialize(row) {
+    if (!row)
+        return row;
+    for (const field of DATE_FIELDS) {
+        if (row[field] && typeof row[field] === 'string') {
+            row[field] = new Date(row[field]);
+        }
+    }
+    return row;
+}
+function serializeDates(data) {
+    const out = { ...data };
+    for (const field of DATE_FIELDS) {
+        if (out[field] instanceof Date) {
+            out[field] = out[field].toISOString();
+        }
+    }
+    return out;
+}
 /**
  * MCIDBIND 数据仓储类
- * 封装所有 MCIDBIND 表的数据库操作
+ * 通过 Supabase REST API 操作 user 表
  */
 class MCIDBINDRepository {
-    ctx;
+    supabase;
     logger;
-    constructor(ctx, logger) {
-        this.ctx = ctx;
+    constructor(supabase, logger) {
+        this.supabase = supabase;
         this.logger = logger;
     }
-    /**
-     * 根据 QQ 号查询绑定信息
-     * @param qqId QQ号（已规范化）
-     * @returns 绑定信息或 null
-     */
     async findByQQId(qqId) {
         try {
             this.logger.debug('数据库', `查询QQ(${qqId})的绑定信息`);
-            const binds = await this.ctx.database.get('mcidbind', { qqId });
-            return binds.length > 0 ? binds[0] : null;
+            const rows = await this.supabase.get(TABLE, `qqId=eq.${qqId}&limit=1`);
+            return rows.length > 0 ? deserialize(rows[0]) : null;
         }
         catch (error) {
             this.logger.error('数据库', `查询QQ(${qqId})绑定信息失败: ${error.message}`);
             return null;
         }
     }
-    /**
-     * 根据 MC 用户名查询绑定信息（精确匹配）
-     * @param mcUsername MC用户名
-     * @returns 绑定信息或 null
-     */
     async findByMCUsername(mcUsername) {
         try {
             this.logger.debug('数据库', `查询MC用户名(${mcUsername})的绑定信息`);
-            const binds = await this.ctx.database.get('mcidbind', { mcUsername });
-            return binds.length > 0 ? binds[0] : null;
+            const rows = await this.supabase.get(TABLE, `mcUsername=eq.${encodeURIComponent(mcUsername)}&limit=1`);
+            return rows.length > 0 ? deserialize(rows[0]) : null;
         }
         catch (error) {
             this.logger.error('数据库', `查询MC用户名(${mcUsername})绑定信息失败: ${error.message}`);
             return null;
         }
     }
-    /**
-     * 根据 MC 用户名查询绑定信息（不区分大小写）
-     * @param mcUsername MC用户名
-     * @returns 绑定信息或 null
-     */
     async findByUsernameIgnoreCase(mcUsername) {
         try {
             const normalizedInput = (0, helpers_1.normalizeUsername)(mcUsername, this.logger.getRawLogger());
             this.logger.debug('数据库', `查询MC用户名(${mcUsername} -> ${normalizedInput})的绑定信息（不区分大小写）`);
-            // 获取所有绑定记录，然后在应用层过滤（因为 Koishi 数据库不支持不区分大小写查询）
-            const allBinds = await this.ctx.database.get('mcidbind', {});
-            const match = allBinds.find(bind => bind.mcUsername && (0, helpers_1.normalizeUsername)(bind.mcUsername) === normalizedInput);
-            return match || null;
+            const rows = await this.supabase.get(TABLE, `mcUsername=ilike.${encodeURIComponent(mcUsername)}`);
+            const match = rows.find(bind => bind.mcUsername && (0, helpers_1.normalizeUsername)(bind.mcUsername) === normalizedInput);
+            return match ? deserialize(match) : null;
         }
         catch (error) {
             this.logger.error('数据库', `查询MC用户名(${mcUsername})绑定信息失败（不区分大小写）: ${error.message}`);
             return null;
         }
     }
-    /**
-     * 根据 MC UUID 查询绑定信息
-     * @param mcUuid MC UUID（可带或不带连字符）
-     * @returns 绑定信息或 null
-     */
     async findByUuid(mcUuid) {
         try {
-            // 规范化 UUID（移除连字符）
             const cleanUuid = mcUuid.replace(/-/g, '');
             this.logger.debug('数据库', `查询MC UUID(${cleanUuid})的绑定信息`);
-            // 先尝试精确匹配
-            let binds = await this.ctx.database.get('mcidbind', { mcUuid: cleanUuid });
-            if (binds.length > 0)
-                return binds[0];
-            // 尝试带连字符的格式
             const formattedUuid = `${cleanUuid.substring(0, 8)}-${cleanUuid.substring(8, 12)}-${cleanUuid.substring(12, 16)}-${cleanUuid.substring(16, 20)}-${cleanUuid.substring(20)}`;
-            binds = await this.ctx.database.get('mcidbind', { mcUuid: formattedUuid });
-            if (binds.length > 0)
-                return binds[0];
-            // 如果都没有，在应用层过滤（去除连字符后比较）
-            const allBinds = await this.ctx.database.get('mcidbind', {});
-            const match = allBinds.find(bind => bind.mcUuid && bind.mcUuid.replace(/-/g, '') === cleanUuid);
-            return match || null;
+            // 用 or 一次查两种格式
+            const rows = await this.supabase.get(TABLE, `or=(mcUuid.eq.${cleanUuid},mcUuid.eq.${formattedUuid})&limit=1`);
+            if (rows.length > 0)
+                return deserialize(rows[0]);
+            // 兜底：用 ilike 模糊匹配
+            const fallback = await this.supabase.get(TABLE, `mcUuid=ilike.*${cleanUuid}*&limit=1`);
+            if (fallback.length > 0)
+                return deserialize(fallback[0]);
+            return null;
         }
         catch (error) {
             this.logger.error('数据库', `查询MC UUID(${mcUuid})绑定信息失败: ${error.message}`);
             return null;
         }
     }
-    /**
-     * 根据 B站 UID 查询绑定信息
-     * @param buidUid B站UID
-     * @returns 绑定信息或 null
-     */
     async findByBuidUid(buidUid) {
         try {
             this.logger.debug('数据库', `查询B站UID(${buidUid})的绑定信息`);
-            const binds = await this.ctx.database.get('mcidbind', { buidUid });
-            return binds.length > 0 ? binds[0] : null;
+            const rows = await this.supabase.get(TABLE, `buidUid=eq.${buidUid}&limit=1`);
+            return rows.length > 0 ? deserialize(rows[0]) : null;
         }
         catch (error) {
             this.logger.error('数据库', `查询B站UID(${buidUid})绑定信息失败: ${error.message}`);
             return null;
         }
     }
-    /**
-     * 获取所有绑定记录
-     * @param options 查询选项
-     * @returns 绑定记录列表
-     */
     async findAll(options) {
         try {
             this.logger.debug('数据库', `获取所有绑定记录${options?.limit ? ` (limit: ${options.limit})` : ''}`);
-            const records = await this.ctx.database.get('mcidbind', {}, options);
-            return records;
+            const query = options?.limit ? `limit=${options.limit}` : '';
+            const rows = await this.supabase.get(TABLE, query);
+            return rows.map(deserialize);
         }
         catch (error) {
             this.logger.error('数据库', `获取所有绑定记录失败: ${error.message}`);
             return [];
         }
     }
-    /**
-     * 根据标签查询绑定记录
-     * @param tag 标签名称
-     * @returns 包含该标签的绑定记录列表
-     */
     async findByTag(tag) {
         try {
             this.logger.debug('数据库', `查询包含标签"${tag}"的绑定记录`);
-            const allRecords = await this.ctx.database.get('mcidbind', {});
-            return allRecords.filter(record => record.tags && record.tags.includes(tag));
+            const rows = await this.supabase.get(TABLE, `tags=cs.${encodeURIComponent(JSON.stringify([tag]))}`);
+            return rows.map(deserialize);
         }
         catch (error) {
             this.logger.error('数据库', `查询标签"${tag}"的绑定记录失败: ${error.message}`);
             return [];
         }
     }
-    /**
-     * 创建新的绑定记录
-     * @param data 绑定数据
-     * @returns 创建的记录
-     */
     async create(data) {
         try {
             this.logger.debug('数据库', `创建QQ(${data.qqId})的绑定记录`);
-            const created = await this.ctx.database.create('mcidbind', data);
+            const created = await this.supabase.post(TABLE, serializeDates(data));
             this.logger.info('数据库', `成功创建QQ(${data.qqId})的绑定记录`, true);
-            return created;
+            return deserialize(created);
         }
         catch (error) {
             this.logger.error('数据库', `创建QQ(${data.qqId})绑定记录失败: ${error.message}`);
             throw error;
         }
     }
-    /**
-     * 更新绑定记录（部分字段）
-     * @param qqId QQ号
-     * @param data 要更新的字段
-     */
     async update(qqId, data) {
         try {
             this.logger.debug('数据库', `更新QQ(${qqId})的绑定记录`);
-            await this.ctx.database.set('mcidbind', { qqId }, data);
+            await this.supabase.patch(TABLE, `qqId=eq.${qqId}`, serializeDates(data));
             this.logger.info('数据库', `成功更新QQ(${qqId})的绑定记录`, true);
         }
         catch (error) {
@@ -174,49 +146,35 @@ class MCIDBINDRepository {
             throw error;
         }
     }
-    /**
-     * 删除绑定记录
-     * @param qqId QQ号
-     * @returns 删除的记录数
-     */
     async delete(qqId) {
         try {
             this.logger.debug('数据库', `删除QQ(${qqId})的绑定记录`);
-            const result = await this.ctx.database.remove('mcidbind', { qqId });
-            this.logger.info('数据库', `成功删除QQ(${qqId})的绑定记录（删除${result.removed}条）`, true);
-            return result.removed;
+            const removed = await this.supabase.del(TABLE, `qqId=eq.${qqId}`);
+            this.logger.info('数据库', `成功删除QQ(${qqId})的绑定记录（删除${removed}条）`, true);
+            return removed;
         }
         catch (error) {
             this.logger.error('数据库', `删除QQ(${qqId})绑定记录失败: ${error.message}`);
             throw error;
         }
     }
-    /**
-     * 删除所有绑定记录
-     * @returns 删除的记录数
-     */
     async deleteAll() {
         try {
             this.logger.debug('数据库', '删除所有绑定记录');
-            const result = await this.ctx.database.remove('mcidbind', {});
-            this.logger.info('数据库', `成功删除所有绑定记录（删除${result.removed}条）`, true);
-            return result.removed;
+            const removed = await this.supabase.del(TABLE, 'qqId=not.is.null');
+            this.logger.info('数据库', `成功删除所有绑定记录（删除${removed}条）`, true);
+            return removed;
         }
         catch (error) {
             this.logger.error('数据库', `删除所有绑定记录失败: ${error.message}`);
             throw error;
         }
     }
-    /**
-     * 批量创建绑定记录
-     * @param records 绑定记录列表
-     */
     async batchCreate(records) {
         try {
             this.logger.debug('数据库', `批量创建${records.length}条绑定记录`);
-            for (const record of records) {
-                await this.ctx.database.create('mcidbind', record);
-            }
+            const serialized = records.map(r => serializeDates(r));
+            await this.supabase.postMany(TABLE, serialized);
             this.logger.info('数据库', `成功批量创建${records.length}条绑定记录`, true);
         }
         catch (error) {
@@ -224,11 +182,6 @@ class MCIDBINDRepository {
             throw error;
         }
     }
-    /**
-     * 为用户添加标签
-     * @param qqId QQ号
-     * @param tag 标签名称
-     */
     async addTag(qqId, tag) {
         try {
             const bind = await this.findByQQId(qqId);
@@ -247,11 +200,6 @@ class MCIDBINDRepository {
             throw error;
         }
     }
-    /**
-     * 为用户移除标签
-     * @param qqId QQ号
-     * @param tag 标签名称
-     */
     async removeTag(qqId, tag) {
         try {
             const bind = await this.findByQQId(qqId);
@@ -271,11 +219,6 @@ class MCIDBINDRepository {
             throw error;
         }
     }
-    /**
-     * 为用户添加白名单服务器
-     * @param qqId QQ号
-     * @param serverId 服务器ID
-     */
     async addWhitelist(qqId, serverId) {
         try {
             const bind = await this.findByQQId(qqId);
@@ -294,11 +237,6 @@ class MCIDBINDRepository {
             throw error;
         }
     }
-    /**
-     * 为用户移除白名单服务器
-     * @param qqId QQ号
-     * @param serverId 服务器ID
-     */
     async removeWhitelist(qqId, serverId) {
         try {
             const bind = await this.findByQQId(qqId);
@@ -318,15 +256,11 @@ class MCIDBINDRepository {
             throw error;
         }
     }
-    /**
-     * 获取所有管理员
-     * @returns 管理员列表
-     */
     async findAllAdmins() {
         try {
             this.logger.debug('数据库', '获取所有管理员');
-            const allRecords = await this.ctx.database.get('mcidbind', {});
-            return allRecords.filter(record => record.isAdmin);
+            const rows = await this.supabase.get(TABLE, 'isAdmin=eq.true');
+            return rows.map(deserialize);
         }
         catch (error) {
             this.logger.error('数据库', `获取所有管理员失败: ${error.message}`);

package/lib/services/database.service.js

@@ -274,9 +274,7 @@ class DatabaseService {
                 buidUid: buidUser.uid.toString(), // 转换为字符串存储
                 buidUsername: buidUser.username,
                 guardLevel: buidUser.guard_level || 0,
-                guardLevelText: buidUser.guard_level_text || '',
                 maxGuardLevel: buidUser.max_guard_level || 0,
-                maxGuardLevelText: buidUser.max_guard_level_text || '',
                 medalName: buidUser.medal?.name || '',
                 medalLevel: buidUser.medal?.level || 0,
                 wealthMedalLevel: buidUser.wealthMedalLevel || 0,
@@ -334,9 +332,7 @@ class DatabaseService {
             const updateData = {
                 buidUsername: buidUser.username,
                 guardLevel: buidUser.guard_level || 0,
-                guardLevelText: buidUser.guard_level_text || '',
                 maxGuardLevel: buidUser.max_guard_level || 0,
-                maxGuardLevelText: buidUser.max_guard_level_text || '',
                 medalName: buidUser.medal?.name || '',
                 medalLevel: buidUser.medal?.level || 0,
                 wealthMedalLevel: buidUser.wealthMedalLevel || 0,
@@ -386,9 +382,7 @@ class DatabaseService {
                     buidUid: null,
                     buidUsername: null,
                     guardLevel: 0,
-                    guardLevelText: '',
                     maxGuardLevel: 0,
-                    maxGuardLevelText: '',
                     medalName: '',
                     medalLevel: 0,
                     wealthMedalLevel: 0,

package/lib/types/config.d.ts

@@ -53,6 +53,10 @@ export interface Config {
     forceBindTargetRoomId: number;
     /** 强制绑定目标粉丝牌名称 */
     forceBindTargetMedalName: string;
+    /** Supabase项目URL */
+    supabaseUrl: string;
+    /** Supabase API Key */
+    supabaseKey: string;
     /** 入群申请审批功能配置 */
     groupRequestReview?: GroupRequestReviewConfig;
 }

package/lib/types/database.d.ts

@@ -24,9 +24,7 @@
  *   buidUid: '87654321',
  *   buidUsername: 'B站用户名',
  *   guardLevel: 3,
- *   guardLevelText: '舰长',
  *   maxGuardLevel: 3,
- *   maxGuardLevelText: '舰长',
  *   medalName: '粉丝牌',
  *   medalLevel: 20,
  *   wealthMedalLevel: 15,
@@ -60,12 +58,8 @@ export interface MCIDBIND {
     buidUsername: string | null;
     /** 当前舰长等级 (0=无, 1=总督, 2=提督, 3=舰长) */
     guardLevel: number;
-    /** 当前舰长等级文本 (例: '舰长', '提督', '总督') */
-    guardLevelText: string;
     /** 历史最高舰长等级 */
     maxGuardLevel: number;
-    /** 历史最高舰长等级文本 */
-    maxGuardLevelText: string;
     /** 粉丝牌名称 */
     medalName: string;
     /** 粉丝牌等级 */

package/lib/types/update-data.d.ts

@@ -54,9 +54,7 @@ export interface UpdateMcBindData {
  *   buidUid: '87654321',
  *   buidUsername: 'B站用户名',
  *   guardLevel: 3,
- *   guardLevelText: '舰长',
  *   maxGuardLevel: 3,
- *   maxGuardLevelText: '舰长',
  *   medalName: '粉丝牌',
  *   medalLevel: 20,
  *   wealthMedalLevel: 15,
@@ -72,12 +70,8 @@ export interface UpdateBuidBindData {
     buidUsername?: string | null;
     /** 当前舰长等级 */
     guardLevel?: number;
-    /** 当前舰长等级文本 */
-    guardLevelText?: string;
     /** 历史最高舰长等级 */
     maxGuardLevel?: number;
-    /** 历史最高舰长等级文本 */
-    maxGuardLevelText?: string;
     /** 粉丝牌名称 */
     medalName?: string;
     /** 粉丝牌等级 */
@@ -104,7 +98,6 @@ export interface UpdateBuidBindData {
  * {
  *   buidUsername: '新用户名',
  *   guardLevel: 3,
- *   guardLevelText: '舰长',
  *   medalLevel: 21
  * }
  * ```
@@ -114,12 +107,8 @@ export interface UpdateBuidInfoData {
     buidUsername?: string;
     /** 当前舰长等级 */
     guardLevel?: number;
-    /** 当前舰长等级文本 */
-    guardLevelText?: string;
     /** 历史最高舰长等级 */
     maxGuardLevel?: number;
-    /** 历史最高舰长等级文本 */
-    maxGuardLevelText?: string;
     /** 粉丝牌名称 */
     medalName?: string;
     /** 粉丝牌等级 */

package/lib/utils/helpers.d.ts

@@ -89,15 +89,7 @@ export declare function levenshteinDistance(str1: string, str2: string): number;
  * @returns 相似度值（0到1之间，1表示完全相同）
  */
 export declare function calculateSimilarity(str1: string, str2: string): number;
-/**
- * 规范化 Minecraft 用户名（统一小写，用于存储和比较）
- * Minecraft 用户名不区分大小写，但 Mojang 返回的是规范大小写
- * 为避免 "Notch" 和 "notch" 被视为不同用户，统一转小写存储
- *
- * @param username MC 用户名
- * @param logger Koishi Logger实例（用于日志）
- * @returns 规范化后的用户名（小写）
- */
+export declare function getGuardLevelText(level: number): string;
 export declare function normalizeUsername(username: string, logger?: Logger): string;
 /**
  * 比较两个 Minecraft 用户名是否相同（不区分大小写）

package/lib/utils/helpers.js

@@ -11,6 +11,7 @@ exports.escapeRegExp = escapeRegExp;
 exports.cleanUserInput = cleanUserInput;
 exports.levenshteinDistance = levenshteinDistance;
 exports.calculateSimilarity = calculateSimilarity;
+exports.getGuardLevelText = getGuardLevelText;
 exports.normalizeUsername = normalizeUsername;
 exports.isSameUsername = isSameUsername;
 exports.extractBuidUsernameFromNickname = extractBuidUsernameFromNickname;
@@ -369,6 +370,10 @@ function calculateSimilarity(str1, str2) {
  * @param logger Koishi Logger实例（用于日志）
  * @returns 规范化后的用户名（小写）
  */
+const GUARD_LEVEL_TEXT = { 1: '总督', 2: '提督', 3: '舰长' };
+function getGuardLevelText(level) {
+    return GUARD_LEVEL_TEXT[level] || '';
+}
 function normalizeUsername(username, logger) {
     if (!username) {
         logger?.warn('[用户名规范化] 收到空用户名');

package/lib/utils/supabase-client.d.ts

@@ -0,0 +1,14 @@
+export interface SupabaseConfig {
+    url: string;
+    key: string;
+}
+export declare class SupabaseClient {
+    private config;
+    private client;
+    constructor(config: SupabaseConfig);
+    get<T>(table: string, query?: string): Promise<T[]>;
+    post<T>(table: string, body: object | object[]): Promise<T>;
+    postMany<T>(table: string, body: object[]): Promise<T[]>;
+    patch(table: string, query: string, body: object): Promise<void>;
+    del(table: string, query: string): Promise<number>;
+}

package/lib/utils/supabase-client.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SupabaseClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+class SupabaseClient {
+    config;
+    client;
+    constructor(config) {
+        this.config = config;
+        this.client = axios_1.default.create({
+            baseURL: `${config.url}/rest/v1`,
+            headers: {
+                apikey: config.key,
+                Authorization: `Bearer ${config.key}`,
+                'Content-Type': 'application/json',
+                Prefer: 'return=representation',
+            },
+        });
+    }
+    async get(table, query = '') {
+        const url = query ? `/${table}?${query}` : `/${table}`;
+        const { data } = await this.client.get(url);
+        return data;
+    }
+    async post(table, body) {
+        const { data } = await this.client.post(`/${table}`, body);
+        return Array.isArray(data) ? data[0] : data;
+    }
+    async postMany(table, body) {
+        const { data } = await this.client.post(`/${table}`, body);
+        return data;
+    }
+    async patch(table, query, body) {
+        await this.client.patch(`/${table}?${query}`, body);
+    }
+    async del(table, query) {
+        const { data } = await this.client.delete(`/${table}?${query}`);
+        return Array.isArray(data) ? data.length : 0;
+    }
+}
+exports.SupabaseClient = SupabaseClient;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-bind-bot",
   "description": "[WittF自用] BIND-BOT - 账号绑定管理机器人，支持Minecraft账号和B站账号绑定与管理。",
-  "version": "2.2.9",
+  "version": "2.3.0",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [