koishi-plugin-bind-bot 2.1.8 → 2.2.0

package/lib/utils/bind-status.d.ts

@@ -0,0 +1,111 @@
+import type { MCIDBIND } from '../types';
+/**
+ * 绑定状态辅助工具类
+ *
+ * @remarks
+ * 该类提供统一的绑定状态判断方法，用于替代散落在各处的 `_temp_` 判断逻辑。
+ * 支持新旧机制的向后兼容，优先使用新的 hasMcBind/hasBuidBind 字段。
+ *
+ * @example
+ * ```typescript
+ * // 检查是否有有效的 MC 绑定
+ * if (BindStatus.hasValidMcBind(bind)) {
+ *   console.log('用户已绑定 MC 账号')
+ * }
+ *
+ * // 获取显示用的 MC 用户名
+ * const mcName = BindStatus.getDisplayMcUsername(bind)
+ * console.log(`MC 用户名: ${mcName}`)
+ * ```
+ */
+export declare class BindStatus {
+    /**
+     * 检查是否有有效的 MC 绑定
+     *
+     * @param bind - 绑定记录（可为 null 或 undefined）
+     * @returns true 表示已绑定有效的 MC 账号，false 表示未绑定或为临时状态
+     *
+     * @remarks
+     * 判断逻辑：
+     * 1. 优先使用新字段 `hasMcBind`（如果存在）
+     * 2. 降级到旧逻辑：检查 `mcUsername` 非空且不以 `_temp_` 开头
+     */
+    static hasValidMcBind(bind: MCIDBIND | null | undefined): boolean;
+    /**
+     * 检查是否有有效的 B站 绑定
+     *
+     * @param bind - 绑定记录（可为 null 或 undefined）
+     * @returns true 表示已绑定有效的 B站 账号，false 表示未绑定
+     *
+     * @remarks
+     * 判断逻辑：
+     * 1. 优先使用新字段 `hasBuidBind`（如果存在）
+     * 2. 降级到旧逻辑：检查 `buidUid` 非空
+     */
+    static hasValidBuidBind(bind: MCIDBIND | null | undefined): boolean;
+    /**
+     * 获取显示用的 MC 用户名
+     *
+     * @param bind - 绑定记录（可为 null 或 undefined）
+     * @param fallback - 当无有效绑定时的默认值（默认为 '未绑定'）
+     * @returns MC 用户名或 fallback 值
+     *
+     * @example
+     * ```typescript
+     * const mcName = BindStatus.getDisplayMcUsername(bind, '未设置')
+     * // 结果：'Notch' 或 '未设置'
+     * ```
+     */
+    static getDisplayMcUsername(bind: MCIDBIND | null | undefined, fallback?: string): string;
+    /**
+     * 获取显示用的 B站 用户名
+     *
+     * @param bind - 绑定记录（可为 null 或 undefined）
+     * @param fallback - 当无有效绑定时的默认值（默认为 '未绑定'）
+     * @returns B站 用户名或 fallback 值
+     */
+    static getDisplayBuidUsername(bind: MCIDBIND | null | undefined, fallback?: string): string;
+    /**
+     * 检查是否完成全部绑定（MC + B站）
+     *
+     * @param bind - 绑定记录（可为 null 或 undefined）
+     * @returns true 表示已完成 MC 和 B站 两项绑定
+     *
+     * @example
+     * ```typescript
+     * if (BindStatus.hasCompletedAllBinds(bind)) {
+     *   console.log('用户已完成所有绑定！')
+     * }
+     * ```
+     */
+    static hasCompletedAllBinds(bind: MCIDBIND | null | undefined): boolean;
+    /**
+     * 获取绑定状态摘要信息
+     *
+     * @param bind - 绑定记录（可为 null 或 undefined）
+     * @returns 包含绑定状态详细信息的对象
+     *
+     * @example
+     * ```typescript
+     * const status = BindStatus.getBindingSummary(bind)
+     * console.log(`MC: ${status.mcStatus}, B站: ${status.buidStatus}`)
+     * // 输出: MC: 已绑定(Notch), B站: 已绑定(UID123456)
+     * ```
+     */
+    static getBindingSummary(bind: MCIDBIND | null | undefined): {
+        hasMcBind: boolean;
+        hasBuidBind: boolean;
+        hasCompletedAll: boolean;
+        mcStatus: string;
+        buidStatus: string;
+    };
+    /**
+     * 检查是否为临时绑定状态（仅用于过渡期诊断）
+     *
+     * @param bind - 绑定记录（可为 null 或 undefined）
+     * @returns true 表示使用了临时用户名机制
+     *
+     * @deprecated 该方法仅用于重构过渡期，最终会被移除
+     */
+    static isTempBinding(bind: MCIDBIND | null | undefined): boolean;
+}

package/lib/utils/bind-status.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BindStatus = void 0;
+/**
+ * 绑定状态辅助工具类
+ *
+ * @remarks
+ * 该类提供统一的绑定状态判断方法，用于替代散落在各处的 `_temp_` 判断逻辑。
+ * 支持新旧机制的向后兼容，优先使用新的 hasMcBind/hasBuidBind 字段。
+ *
+ * @example
+ * ```typescript
+ * // 检查是否有有效的 MC 绑定
+ * if (BindStatus.hasValidMcBind(bind)) {
+ *   console.log('用户已绑定 MC 账号')
+ * }
+ *
+ * // 获取显示用的 MC 用户名
+ * const mcName = BindStatus.getDisplayMcUsername(bind)
+ * console.log(`MC 用户名: ${mcName}`)
+ * ```
+ */
+class BindStatus {
+    /**
+     * 检查是否有有效的 MC 绑定
+     *
+     * @param bind - 绑定记录（可为 null 或 undefined）
+     * @returns true 表示已绑定有效的 MC 账号，false 表示未绑定或为临时状态
+     *
+     * @remarks
+     * 判断逻辑：
+     * 1. 优先使用新字段 `hasMcBind`（如果存在）
+     * 2. 降级到旧逻辑：检查 `mcUsername` 非空且不以 `_temp_` 开头
+     */
+    static hasValidMcBind(bind) {
+        if (!bind)
+            return false;
+        // 优先使用新字段
+        if (bind.hasMcBind !== undefined) {
+            return bind.hasMcBind;
+        }
+        // 降级到旧逻辑（向后兼容）
+        return !!(bind.mcUsername && !bind.mcUsername.startsWith('_temp_'));
+    }
+    /**
+     * 检查是否有有效的 B站 绑定
+     *
+     * @param bind - 绑定记录（可为 null 或 undefined）
+     * @returns true 表示已绑定有效的 B站 账号，false 表示未绑定
+     *
+     * @remarks
+     * 判断逻辑：
+     * 1. 优先使用新字段 `hasBuidBind`（如果存在）
+     * 2. 降级到旧逻辑：检查 `buidUid` 非空
+     */
+    static hasValidBuidBind(bind) {
+        if (!bind)
+            return false;
+        // 优先使用新字段
+        if (bind.hasBuidBind !== undefined) {
+            return bind.hasBuidBind;
+        }
+        // 降级到旧逻辑
+        return !!(bind.buidUid && bind.buidUid.length > 0);
+    }
+    /**
+     * 获取显示用的 MC 用户名
+     *
+     * @param bind - 绑定记录（可为 null 或 undefined）
+     * @param fallback - 当无有效绑定时的默认值（默认为 '未绑定'）
+     * @returns MC 用户名或 fallback 值
+     *
+     * @example
+     * ```typescript
+     * const mcName = BindStatus.getDisplayMcUsername(bind, '未设置')
+     * // 结果：'Notch' 或 '未设置'
+     * ```
+     */
+    static getDisplayMcUsername(bind, fallback = '未绑定') {
+        if (!bind || !this.hasValidMcBind(bind)) {
+            return fallback;
+        }
+        return bind.mcUsername || fallback;
+    }
+    /**
+     * 获取显示用的 B站 用户名
+     *
+     * @param bind - 绑定记录（可为 null 或 undefined）
+     * @param fallback - 当无有效绑定时的默认值（默认为 '未绑定'）
+     * @returns B站 用户名或 fallback 值
+     */
+    static getDisplayBuidUsername(bind, fallback = '未绑定') {
+        if (!bind || !this.hasValidBuidBind(bind)) {
+            return fallback;
+        }
+        return bind.buidUsername || fallback;
+    }
+    /**
+     * 检查是否完成全部绑定（MC + B站）
+     *
+     * @param bind - 绑定记录（可为 null 或 undefined）
+     * @returns true 表示已完成 MC 和 B站 两项绑定
+     *
+     * @example
+     * ```typescript
+     * if (BindStatus.hasCompletedAllBinds(bind)) {
+     *   console.log('用户已完成所有绑定！')
+     * }
+     * ```
+     */
+    static hasCompletedAllBinds(bind) {
+        return this.hasValidMcBind(bind) && this.hasValidBuidBind(bind);
+    }
+    /**
+     * 获取绑定状态摘要信息
+     *
+     * @param bind - 绑定记录（可为 null 或 undefined）
+     * @returns 包含绑定状态详细信息的对象
+     *
+     * @example
+     * ```typescript
+     * const status = BindStatus.getBindingSummary(bind)
+     * console.log(`MC: ${status.mcStatus}, B站: ${status.buidStatus}`)
+     * // 输出: MC: 已绑定(Notch), B站: 已绑定(UID123456)
+     * ```
+     */
+    static getBindingSummary(bind) {
+        const hasMcBind = this.hasValidMcBind(bind);
+        const hasBuidBind = this.hasValidBuidBind(bind);
+        return {
+            hasMcBind,
+            hasBuidBind,
+            hasCompletedAll: hasMcBind && hasBuidBind,
+            mcStatus: hasMcBind
+                ? `已绑定(${bind?.mcUsername})`
+                : '未绑定',
+            buidStatus: hasBuidBind
+                ? `已绑定(UID${bind?.buidUid})`
+                : '未绑定'
+        };
+    }
+    /**
+     * 检查是否为临时绑定状态（仅用于过渡期诊断）
+     *
+     * @param bind - 绑定记录（可为 null 或 undefined）
+     * @returns true 表示使用了临时用户名机制
+     *
+     * @deprecated 该方法仅用于重构过渡期，最终会被移除
+     */
+    static isTempBinding(bind) {
+        if (!bind || !bind.mcUsername)
+            return false;
+        return bind.mcUsername.startsWith('_temp_');
+    }
+}
+exports.BindStatus = BindStatus;

package/lib/utils/helpers.js

@@ -376,10 +376,6 @@ function normalizeUsername(username, logger) {
     }
     // 移除首尾空格
     const trimmed = username.trim();
-    // 检查是否为临时用户名，临时用户名不做转换
-    if (trimmed.startsWith('_temp_')) {
-        return trimmed;
-    }
     // 转小写
     const normalized = trimmed.toLowerCase();
     if (normalized !== trimmed) {

package/lib/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utils 模块统一导出
+ */
+export { BindStatus } from './bind-status';
+export * from './helpers';
+export * from './error-utils';
+export * from './message-utils';

package/lib/utils/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Utils 模块统一导出
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BindStatus = void 0;
+// 绑定状态工具类
+var bind_status_1 = require("./bind-status");
+Object.defineProperty(exports, "BindStatus", { enumerable: true, get: function () { return bind_status_1.BindStatus; } });
+// 其他工具函数（按需导出）
+__exportStar(require("./helpers"), exports);
+__exportStar(require("./error-utils"), exports);
+__exportStar(require("./message-utils"), exports);

package/lib/utils/message-utils.js

@@ -162,8 +162,8 @@ class MessageUtils {
             // 如果指定了目标用户ID，使用目标用户ID，否则使用session的用户ID
             const actualUserId = targetUserId || session.userId;
             const normalizedUserId = (0, helpers_1.normalizeQQId)(actualUserId);
-            // 根据MC绑定状态设置不同的格式（临时用户名视为未绑定）
-            const mcInfo = mcUsername && !mcUsername.startsWith('_temp_') ? mcUsername : '未绑定';
+            // 根据MC绑定状态设置不同的格式
+            const mcInfo = mcUsername || '未绑定';
             let currentBuidUsername = buidUsername;
             const newNickname = `${currentBuidUsername}（ID:${mcInfo}）`;
             // 使用指定的群ID，如果没有指定则使用配置的默认群ID

package/package.json

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