koishi-plugin-bind-bot 2.0.0 → 2.0.3

package/lib/utils/error-utils.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * 错误处理工具函数集合
+ * 提供统一的错误信息格式化和分类功能
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFriendlyErrorMessage = getFriendlyErrorMessage;
+exports.getUserFacingErrorMessage = getUserFacingErrorMessage;
+exports.isWarningError = isWarningError;
+exports.isCriticalError = isCriticalError;
+/**
+ * 获取用户友好的错误信息
+ * 将技术性错误转换为用户可理解的提示
+ * @param error 错误对象或错误消息字符串
+ * @returns 格式化后的用户友好错误信息
+ */
+function getFriendlyErrorMessage(error) {
+    const errorMsg = error instanceof Error ? error.message : error;
+    // 拆分错误信息
+    const userError = getUserFacingErrorMessage(errorMsg);
+    // 将警告级别错误标记出来
+    if (isWarningError(userError)) {
+        return `⚠️ ${userError}`;
+    }
+    // 将严重错误标记出来
+    if (isCriticalError(userError)) {
+        return `❌ ${userError}`;
+    }
+    return userError;
+}
+/**
+ * 提取用户友好的错误信息
+ * 根据错误消息内容返回对应的用户提示
+ * @param errorMsg 原始错误消息
+ * @returns 用户可理解的错误提示
+ */
+function getUserFacingErrorMessage(errorMsg) {
+    // Mojang API相关错误
+    if (errorMsg.includes('ECONNABORTED') || errorMsg.includes('timeout')) {
+        return '无法连接到Mojang服务器，请稍后再试';
+    }
+    if (errorMsg.includes('404')) {
+        return '该Minecraft用户名不存在';
+    }
+    if (errorMsg.includes('network') || errorMsg.includes('connect')) {
+        return '网络连接异常，请稍后再试';
+    }
+    // 数据库相关错误
+    if (errorMsg.includes('unique') || errorMsg.includes('duplicate')) {
+        return '该Minecraft用户名已被其他用户绑定';
+    }
+    // RCON相关错误
+    if (errorMsg.includes('RCON') || errorMsg.includes('服务器')) {
+        if (errorMsg.includes('authentication') || errorMsg.includes('auth') || errorMsg.includes('认证')) {
+            return 'RCON认证失败，服务器拒绝访问，请联系管理员检查密码';
+        }
+        if (errorMsg.includes('ECONNREFUSED') || errorMsg.includes('ETIMEDOUT') || errorMsg.includes('无法连接')) {
+            return '无法连接到游戏服务器，请确认服务器是否在线或联系管理员';
+        }
+        if (errorMsg.includes('command') || errorMsg.includes('执行命令')) {
+            return '服务器命令执行失败，请稍后再试';
+        }
+        return '与游戏服务器通信失败，请稍后再试';
+    }
+    // 用户名相关错误
+    if (errorMsg.includes('用户名') || errorMsg.includes('username')) {
+        if (errorMsg.includes('不存在')) {
+            return '该Minecraft用户名不存在，请检查拼写';
+        }
+        if (errorMsg.includes('已被')) {
+            return '该Minecraft用户名已被其他用户绑定，请使用其他用户名';
+        }
+        if (errorMsg.includes('格式')) {
+            return 'Minecraft用户名格式不正确，应为3-16位字母、数字和下划线';
+        }
+        return '用户名验证失败，请检查用户名并重试';
+    }
+    // 默认错误信息
+    return '操作失败，请稍后再试';
+}
+/**
+ * 判断是否为警告级别错误（用户可能输入有误）
+ * @param errorMsg 错误消息
+ * @returns 是否为警告级别错误
+ */
+function isWarningError(errorMsg) {
+    const warningPatterns = [
+        '用户名不存在',
+        '格式不正确',
+        '已被其他用户绑定',
+        '已在白名单中',
+        '不在白名单中',
+        '未绑定MC账号',
+        '冷却期内'
+    ];
+    return warningPatterns.some(pattern => errorMsg.includes(pattern));
+}
+/**
+ * 判断是否为严重错误（系统问题）
+ * @param errorMsg 错误消息
+ * @returns 是否为严重错误
+ */
+function isCriticalError(errorMsg) {
+    const criticalPatterns = [
+        '无法连接',
+        'RCON认证失败',
+        '服务器通信失败',
+        '数据库操作出错'
+    ];
+    return criticalPatterns.some(pattern => errorMsg.includes(pattern));
+}

package/lib/utils/helpers.d.ts

@@ -74,3 +74,36 @@ export declare function escapeRegExp(string: string): string;
  * @returns 清理后的输入内容
  */
 export declare function cleanUserInput(content: string, session: Session, botNickname: string, logger?: Logger): string;
+/**
+ * 计算两个字符串之间的Levenshtein距离
+ * Levenshtein距离是指将一个字符串转换成另一个字符串所需的最少编辑操作次数
+ * @param str1 第一个字符串
+ * @param str2 第二个字符串
+ * @returns 两个字符串之间的编辑距离
+ */
+export declare function levenshteinDistance(str1: string, str2: string): number;
+/**
+ * 计算两个字符串的相似度（基于Levenshtein距离）
+ * @param str1 第一个字符串
+ * @param str2 第二个字符串
+ * @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 normalizeUsername(username: string, logger?: Logger): string;
+/**
+ * 比较两个 Minecraft 用户名是否相同（不区分大小写）
+ *
+ * @param username1 第一个用户名
+ * @param username2 第二个用户名
+ * @returns 是否相同
+ */
+export declare function isSameUsername(username1: string, username2: string): boolean;

package/lib/utils/helpers.js

@@ -9,6 +9,10 @@ exports.getStarlightSkinUrl = getStarlightSkinUrl;
 exports.checkIrrelevantInput = checkIrrelevantInput;
 exports.escapeRegExp = escapeRegExp;
 exports.cleanUserInput = cleanUserInput;
+exports.levenshteinDistance = levenshteinDistance;
+exports.calculateSimilarity = calculateSimilarity;
+exports.normalizeUsername = normalizeUsername;
+exports.isSameUsername = isSameUsername;
 /**
  * 通用工具函数集合
  */
@@ -273,3 +277,86 @@ function cleanUserInput(content, session, botNickname, logger) {
     }
     return cleanedContent;
 }
+/**
+ * 计算两个字符串之间的Levenshtein距离
+ * Levenshtein距离是指将一个字符串转换成另一个字符串所需的最少编辑操作次数
+ * @param str1 第一个字符串
+ * @param str2 第二个字符串
+ * @returns 两个字符串之间的编辑距离
+ */
+function levenshteinDistance(str1, str2) {
+    const matrix = [];
+    // 初始化第一列
+    for (let i = 0; i <= str2.length; i++) {
+        matrix[i] = [i];
+    }
+    // 初始化第一行
+    for (let j = 0; j <= str1.length; j++) {
+        matrix[0][j] = j;
+    }
+    // 填充矩阵
+    for (let i = 1; i <= str2.length; i++) {
+        for (let j = 1; j <= str1.length; j++) {
+            if (str2.charAt(i - 1) === str1.charAt(j - 1)) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // 替换
+                matrix[i][j - 1] + 1, // 插入
+                matrix[i - 1][j] + 1 // 删除
+                );
+            }
+        }
+    }
+    return matrix[str2.length][str1.length];
+}
+/**
+ * 计算两个字符串的相似度（基于Levenshtein距离）
+ * @param str1 第一个字符串
+ * @param str2 第二个字符串
+ * @returns 相似度值（0到1之间，1表示完全相同）
+ */
+function calculateSimilarity(str1, str2) {
+    const distance = levenshteinDistance(str1, str2);
+    const maxLength = Math.max(str1.length, str2.length);
+    return 1 - distance / maxLength;
+}
+/**
+ * 规范化 Minecraft 用户名（统一小写，用于存储和比较）
+ * Minecraft 用户名不区分大小写，但 Mojang 返回的是规范大小写
+ * 为避免 "Notch" 和 "notch" 被视为不同用户，统一转小写存储
+ *
+ * @param username MC 用户名
+ * @param logger Koishi Logger实例（用于日志）
+ * @returns 规范化后的用户名（小写）
+ */
+function normalizeUsername(username, logger) {
+    if (!username) {
+        logger?.warn(`[用户名规范化] 收到空用户名`);
+        return '';
+    }
+    // 移除首尾空格
+    const trimmed = username.trim();
+    // 检查是否为临时用户名，临时用户名不做转换
+    if (trimmed.startsWith('_temp_')) {
+        return trimmed;
+    }
+    // 转小写
+    const normalized = trimmed.toLowerCase();
+    if (normalized !== trimmed) {
+        logger?.debug(`[用户名规范化] "${trimmed}" -> "${normalized}"`);
+    }
+    return normalized;
+}
+/**
+ * 比较两个 Minecraft 用户名是否相同（不区分大小写）
+ *
+ * @param username1 第一个用户名
+ * @param username2 第二个用户名
+ * @returns 是否相同
+ */
+function isSameUsername(username1, username2) {
+    if (!username1 || !username2)
+        return false;
+    return normalizeUsername(username1) === normalizeUsername(username2);
+}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "koishi-plugin-bind-bot",
   "description": "[WittF自用] BIND-BOT - 账号绑定管理机器人，支持Minecraft账号和B站账号绑定与管理。",
-  "version": "2.0.0",
+  "version": "2.0.3",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [
     "lib"
   ],
-  "license": "MIT",
+  "license": "CC-BY-NC-SA-4.0",
   "scripts": {
     "build": "tsc"
   },