koishi-plugin-bind-bot 2.0.0

package/lib/types/common.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 通用类型定义
+ * 包含缓存、会话、天选开奖等公共接口
+ */
+/**
+ * 头像缓存接口
+ */
+export interface AvatarCache {
+    url: string;
+    timestamp: number;
+}
+/**
+ * 交互式绑定会话接口
+ * 从 utils/session-manager.ts 重新导出
+ */
+export type { BindingSession } from '../utils/session-manager';
+/**
+ * 天选开奖 - 中奖用户接口
+ */
+export interface LotteryWinner {
+    uid: number;
+    username: string;
+    medal_level: number;
+}
+/**
+ * 天选开奖 - 开奖结果接口
+ */
+export interface LotteryResult {
+    type: string;
+    lottery_id: string;
+    room_id: number;
+    reward_name: string;
+    reward_num: number;
+    message: string;
+    winners_count: number;
+    winners: LotteryWinner[];
+    timestamp: number;
+    host_uid: number;
+    host_username: string;
+}

package/lib/types/common.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 通用类型定义
+ * 包含缓存、会话、天选开奖等公共接口
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/config.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 配置相关类型定义
+ * 包含插件配置接口和服务器配置接口
+ */
+/**
+ * 插件配置接口
+ */
+export interface Config {
+    cooldownDays: number;
+    masterId: string;
+    servers: ServerConfig[];
+    allowTextPrefix: boolean;
+    botNickname: string;
+    autoRecallTime: number;
+    recallUserMessage: boolean;
+    debugMode: boolean;
+    showAvatar: boolean;
+    showMcSkin: boolean;
+    zminfoApiUrl: string;
+    enableLotteryBroadcast: boolean;
+    autoNicknameGroupId: string;
+    forceBindSessdata: string;
+    forceBindTargetUpUid: number;
+    forceBindTargetRoomId: number;
+    forceBindTargetMedalName: string;
+}
+/**
+ * 服务器配置接口
+ */
+export interface ServerConfig {
+    id: string;
+    name: string;
+    rconAddress: string;
+    rconPassword: string;
+    addCommand: string;
+    removeCommand: string;
+    idType: 'username' | 'uuid';
+    allowSelfApply: boolean;
+    acceptEmptyResponse?: boolean;
+    displayAddress?: string;
+    description?: string;
+    enabled?: boolean;
+}
+/**
+ * 强制绑定配置接口
+ * 从 force-bind-utils.ts 迁移
+ */
+export interface ForceBindConfig {
+    SESSDATA: string;
+    zminfoApiUrl: string;
+    targetUpUid: number;
+    targetRoomId: number;
+    targetMedalName: string;
+    debugMode: boolean;
+}

package/lib/types/config.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 配置相关类型定义
+ * 包含插件配置接口和服务器配置接口
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/database.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 数据库表结构类型定义
+ * 包含 MCIDBIND 表和 SCHEDULE_MUTE_TASKS 表
+ */
+/**
+ * MCIDBIND表结构 - MC和B站账号绑定主表
+ */
+export interface MCIDBIND {
+    qqId: string;
+    mcUsername: string;
+    mcUuid: string;
+    lastModified: Date;
+    isAdmin: boolean;
+    whitelist: string[];
+    tags: string[];
+    buidUid: string;
+    buidUsername: string;
+    guardLevel: number;
+    guardLevelText: string;
+    maxGuardLevel: number;
+    maxGuardLevelText: string;
+    medalName: string;
+    medalLevel: number;
+    wealthMedalLevel: number;
+    lastActiveTime: Date;
+    reminderCount: number;
+}
+/**
+ * SCHEDULE_MUTE_TASKS表结构 - 定时禁言任务配置
+ */
+export interface SCHEDULE_MUTE_TASKS {
+    id: number;
+    groupId: string;
+    startTime: string;
+    endTime: string;
+    enabled: boolean;
+    setterId: string;
+}
+/**
+ * Koishi模块扩展 - 声明数据库表
+ */
+declare module 'koishi' {
+    interface Tables {
+        mcidbind: MCIDBIND;
+        schedule_mute_tasks: SCHEDULE_MUTE_TASKS;
+    }
+}

package/lib/types/database.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 数据库表结构类型定义
+ * 包含 MCIDBIND 表和 SCHEDULE_MUTE_TASKS 表
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 类型定义统一导出
+ * 所有其他模块应从此处导入类型
+ */
+export * from './config';
+export * from './database';
+export * from './api';
+export * from './common';

package/lib/types/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * 类型定义统一导出
+ * 所有其他模块应从此处导入类型
+ */
+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 });
+// 配置相关类型
+__exportStar(require("./config"), exports);
+// 数据库表结构类型
+__exportStar(require("./database"), exports);
+// 外部API响应类型
+__exportStar(require("./api"), exports);
+// 通用类型
+__exportStar(require("./common"), exports);

package/lib/utils/helpers.d.ts

@@ -0,0 +1,76 @@
+import { Logger, Session } from 'koishi';
+/**
+ * 通用工具函数集合
+ */
+/**
+ * 规范化QQ号格式
+ * 支持处理：
+ * - platform:123456 格式
+ * - <at id="123456"/> 格式
+ * - @用户 格式
+ * - 纯数字格式
+ *
+ * @param userId 用户ID（可能包含平台前缀或特殊格式）
+ * @param logger Koishi Logger实例（用于警告日志）
+ * @returns 纯QQ号字符串，失败返回空字符串
+ */
+export declare function normalizeQQId(userId: string, logger?: Logger): string;
+/**
+ * 格式化命令提示（添加机器人昵称前缀）
+ * @param cmd 命令字符串
+ * @param allowTextPrefix 是否允许文本前缀
+ * @param botNickname 机器人昵称
+ * @returns 格式化后的命令字符串
+ */
+export declare function formatCommand(cmd: string, allowTextPrefix: boolean, botNickname: string): string;
+/**
+ * 格式化UUID（添加连字符，使其符合标准格式）
+ * @param uuid 不带连字符的UUID字符串
+ * @param logger Koishi Logger实例（用于警告日志）
+ * @returns 标准格式的UUID
+ */
+export declare function formatUuid(uuid: string, logger?: Logger): string;
+/**
+ * 检查冷却时间是否已过
+ * @param lastModified 上次修改时间
+ * @param cooldownDays 冷却天数
+ * @param multiplier 倍数（用于B站UID冷却时间）
+ * @returns 是否已过冷却期
+ */
+export declare function checkCooldown(lastModified: Date | null, cooldownDays: number, multiplier?: number): boolean;
+/**
+ * 获取Crafatar头像URL
+ * @param uuid MC用户的UUID
+ * @param logger Koishi Logger实例（用于日志）
+ * @returns 头像URL或null
+ */
+export declare function getCrafatarUrl(uuid: string, logger?: Logger): string | null;
+/**
+ * 获取Starlight皮肤渲染URL（随机姿势）
+ * @param username MC用户名
+ * @param logger Koishi Logger实例（用于日志）
+ * @returns 皮肤渲染URL或null
+ */
+export declare function getStarlightSkinUrl(username: string, logger?: Logger): string | null;
+/**
+ * 检查绑定会话中的输入是否为无关内容
+ * @param state 当前会话状态
+ * @param content 用户输入内容
+ * @returns 是否为无关输入
+ */
+export declare function checkIrrelevantInput(state: 'waiting_mc_username' | 'waiting_buid', content: string): boolean;
+/**
+ * 转义正则表达式特殊字符
+ * @param string 需要转义的字符串
+ * @returns 转义后的字符串
+ */
+export declare function escapeRegExp(string: string): string;
+/**
+ * 清理用户输入中的@Bot前缀
+ * @param content 用户输入内容
+ * @param session Koishi Session对象
+ * @param botNickname 机器人昵称配置
+ * @param logger Koishi Logger实例（用于日志）
+ * @returns 清理后的输入内容
+ */
+export declare function cleanUserInput(content: string, session: Session, botNickname: string, logger?: Logger): string;

package/lib/utils/helpers.js

@@ -0,0 +1,275 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeQQId = normalizeQQId;
+exports.formatCommand = formatCommand;
+exports.formatUuid = formatUuid;
+exports.checkCooldown = checkCooldown;
+exports.getCrafatarUrl = getCrafatarUrl;
+exports.getStarlightSkinUrl = getStarlightSkinUrl;
+exports.checkIrrelevantInput = checkIrrelevantInput;
+exports.escapeRegExp = escapeRegExp;
+exports.cleanUserInput = cleanUserInput;
+/**
+ * 通用工具函数集合
+ */
+/**
+ * 规范化QQ号格式
+ * 支持处理：
+ * - platform:123456 格式
+ * - <at id="123456"/> 格式
+ * - @用户 格式
+ * - 纯数字格式
+ *
+ * @param userId 用户ID（可能包含平台前缀或特殊格式）
+ * @param logger Koishi Logger实例（用于警告日志）
+ * @returns 纯QQ号字符串，失败返回空字符串
+ */
+function normalizeQQId(userId, logger) {
+    // 处理空值情况
+    if (!userId) {
+        logger?.warn(`[用户ID] 收到空用户ID`);
+        return '';
+    }
+    let extractedId = '';
+    // 检查是否是手动输入的@符号（错误用法）
+    if (userId.startsWith('@') && !userId.match(/<at\s+id="[^"]+"\s*\/>/)) {
+        logger?.warn(`[用户ID] 检测到手动输入的@符号"${userId}"，应使用真正的@功能`);
+        return ''; // 返回空字符串表示无效
+    }
+    // 处理 <at id="..."/> 格式的@用户字符串
+    const atMatch = userId.match(/<at id="(\d+)"\s*\/>/);
+    if (atMatch) {
+        extractedId = atMatch[1];
+    }
+    else {
+        // 如果包含冒号，说明有平台前缀(如 onebot:123456)
+        const colonIndex = userId.indexOf(':');
+        if (colonIndex !== -1) {
+            extractedId = userId.substring(colonIndex + 1);
+        }
+        else {
+            extractedId = userId;
+        }
+    }
+    // 验证提取的ID是否为纯数字QQ号
+    if (!/^\d+$/.test(extractedId)) {
+        logger?.warn(`[用户ID] 提取的ID"${extractedId}"不是有效的QQ号(必须为纯数字)，来源: ${userId}`);
+        return ''; // 返回空字符串表示无效
+    }
+    // 检查QQ号长度是否合理(QQ号通常为5-12位数字)
+    if (extractedId.length < 5 || extractedId.length > 12) {
+        logger?.warn(`[用户ID] QQ号"${extractedId}"长度异常(${extractedId.length}位)，有效范围为5-12位`);
+        return '';
+    }
+    return extractedId;
+}
+/**
+ * 格式化命令提示（添加机器人昵称前缀）
+ * @param cmd 命令字符串
+ * @param allowTextPrefix 是否允许文本前缀
+ * @param botNickname 机器人昵称
+ * @returns 格式化后的命令字符串
+ */
+function formatCommand(cmd, allowTextPrefix, botNickname) {
+    if (allowTextPrefix && botNickname) {
+        // 检查botNickname是否已经包含@符号，避免重复添加
+        const nickname = botNickname.startsWith('@') ? botNickname : `@${botNickname}`;
+        return `${nickname} ${cmd}`;
+    }
+    return cmd;
+}
+/**
+ * 格式化UUID（添加连字符，使其符合标准格式）
+ * @param uuid 不带连字符的UUID字符串
+ * @param logger Koishi Logger实例（用于警告日志）
+ * @returns 标准格式的UUID
+ */
+function formatUuid(uuid, logger) {
+    if (!uuid)
+        return '未知';
+    if (uuid.includes('-'))
+        return uuid; // 已经是带连字符的格式
+    // 确保UUID长度正确
+    if (uuid.length !== 32) {
+        logger?.warn(`[UUID] UUID "${uuid}" 长度异常，无法格式化`);
+        return uuid;
+    }
+    return `${uuid.substring(0, 8)}-${uuid.substring(8, 12)}-${uuid.substring(12, 16)}-${uuid.substring(16, 20)}-${uuid.substring(20)}`;
+}
+/**
+ * 检查冷却时间是否已过
+ * @param lastModified 上次修改时间
+ * @param cooldownDays 冷却天数
+ * @param multiplier 倍数（用于B站UID冷却时间）
+ * @returns 是否已过冷却期
+ */
+function checkCooldown(lastModified, cooldownDays, multiplier = 1) {
+    if (!lastModified)
+        return true;
+    const now = new Date();
+    const diffTime = now.getTime() - lastModified.getTime();
+    // 使用Math.floor确保冷却时间精确
+    const diffDays = Math.floor(diffTime / (1000 * 60 * 60 * 24));
+    return diffDays >= cooldownDays * multiplier;
+}
+/**
+ * 获取Crafatar头像URL
+ * @param uuid MC用户的UUID
+ * @param logger Koishi Logger实例（用于日志）
+ * @returns 头像URL或null
+ */
+function getCrafatarUrl(uuid, logger) {
+    if (!uuid)
+        return null;
+    // 检查UUID格式 (不带连字符应为32位，带连字符应为36位)
+    const uuidRegex = /^[0-9a-f]{32}$|^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    if (!uuidRegex.test(uuid)) {
+        logger?.warn(`[MC头图] UUID "${uuid}" 格式无效，无法生成头图URL`);
+        return null;
+    }
+    // 移除任何连字符，Crafatar接受不带连字符的UUID
+    const cleanUuid = uuid.replace(/-/g, '');
+    // 直接生成URL
+    const url = `https://crafatar.com/avatars/${cleanUuid}`;
+    logger?.debug(`[MC头图] 为UUID "${cleanUuid}" 生成头图URL`);
+    return url;
+}
+/**
+ * 获取Starlight皮肤渲染URL（随机姿势）
+ * @param username MC用户名
+ * @param logger Koishi Logger实例（用于日志）
+ * @returns 皮肤渲染URL或null
+ */
+function getStarlightSkinUrl(username, logger) {
+    if (!username)
+        return null;
+    // 可用的动作列表 (共16种)
+    const poses = [
+        'default', // 默认站立
+        'marching', // 行军
+        'walking', // 行走
+        'crouching', // 下蹲
+        'crossed', // 交叉手臂
+        'crisscross', // 交叉腿
+        'cheering', // 欢呼
+        'relaxing', // 放松
+        'trudging', // 艰难行走
+        'cowering', // 退缩
+        'pointing', // 指向
+        'lunging', // 前冲
+        'dungeons', // 地下城风格
+        'facepalm', // 捂脸
+        'mojavatar', // Mojave姿态
+        'head', // 头部特写
+    ];
+    // 随机选择一个动作
+    const randomPose = poses[Math.floor(Math.random() * poses.length)];
+    // 视图类型（full为全身图）
+    const viewType = 'full';
+    // 生成URL
+    const url = `https://starlightskins.lunareclipse.studio/render/${randomPose}/${username}/${viewType}`;
+    logger?.debug(`[Starlight皮肤] 为用户名"${username}"生成动作"${randomPose}"的渲染URL`);
+    return url;
+}
+/**
+ * 检查绑定会话中的输入是否为无关内容
+ * @param state 当前会话状态
+ * @param content 用户输入内容
+ * @returns 是否为无关输入
+ */
+function checkIrrelevantInput(state, content) {
+    if (!content)
+        return false;
+    // 常见的聊天用语或明显无关的内容
+    const chatKeywords = ['你好', 'hello', 'hi', '在吗', '在不在', '怎么样', '什么', '为什么', '好的', '谢谢', '哈哈', '呵呵', '早上好', '晚上好', '晚安', '再见', '拜拜', '666', '牛', '厉害', '真的吗', '不是吧', '哇', '哦', '嗯', '好吧', '行', '可以', '没事', '没问题', '没关系'];
+    const lowercaseContent = content.toLowerCase();
+    // 检查是否包含明显的聊天用语
+    if (chatKeywords.some(keyword => lowercaseContent.includes(keyword))) {
+        return true;
+    }
+    // 检查是否为明显的聊天模式（多个连续的标点符号、表情等）
+    if (/[！？。，；：""''（）【】〈〉《》「」『』〔〕〖〗〘〙〚〛]{2,}/.test(content) ||
+        /[!?.,;:"'()[\]<>{}]{3,}/.test(content)) {
+        return true;
+    }
+    if (state === 'waiting_mc_username') {
+        // 先排除跳过命令，这些是有效输入
+        if (content === '跳过' || content === 'skip') {
+            return false;
+        }
+        // MC用户名检查
+        // 长度明显不符合MC用户名规范（3-16位）
+        if (content.length < 2 || content.length > 20) {
+            return true;
+        }
+        // 包含中文或其他明显不是MC用户名的字符
+        if (/[\u4e00-\u9fa5]/.test(content) || content.includes(' ') || content.includes('@')) {
+            return true;
+        }
+        // 如果是明显的指令格式
+        if (content.startsWith('.') || content.startsWith('/') || content.startsWith('mcid') || content.startsWith('buid')) {
+            return true;
+        }
+    }
+    else if (state === 'waiting_buid') {
+        // B站UID检查
+        // 移除UID:前缀后检查
+        let actualContent = content;
+        if (content.toLowerCase().startsWith('uid:')) {
+            actualContent = content.substring(4);
+        }
+        // 如果不是纯数字且不是跳过命令
+        if (!/^\d+$/.test(actualContent) && content !== '跳过' && content !== 'skip') {
+            // 检查是否明显是聊天内容（包含字母、中文、空格等）
+            if (/[a-zA-Z\u4e00-\u9fa5\s]/.test(content) && !content.toLowerCase().startsWith('uid:')) {
+                return true;
+            }
+            // 如果是明显的指令格式
+            if (content.startsWith('.') || content.startsWith('/') || content.startsWith('mcid') || content.startsWith('buid')) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * 转义正则表达式特殊字符
+ * @param string 需要转义的字符串
+ * @returns 转义后的字符串
+ */
+function escapeRegExp(string) {
+    return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * 清理用户输入中的@Bot前缀
+ * @param content 用户输入内容
+ * @param session Koishi Session对象
+ * @param botNickname 机器人昵称配置
+ * @param logger Koishi Logger实例（用于日志）
+ * @returns 清理后的输入内容
+ */
+function cleanUserInput(content, session, botNickname, logger) {
+    if (!content)
+        return content;
+    // 获取机器人的用户ID
+    const botUserId = session.bot.userId;
+    // 匹配各种@Bot的格式
+    const atPatterns = [
+        // <at id="botUserId"/> 格式
+        new RegExp(`^<at id="${escapeRegExp(botUserId)}"/>\\s*`, 'i'),
+        // @Bot昵称 格式（如果配置了botNickname）
+        botNickname ? new RegExp(`^@${escapeRegExp(botNickname)}\\s+`, 'i') : null,
+        // @botUserId 格式
+        new RegExp(`^@${escapeRegExp(botUserId)}\\s+`, 'i'),
+    ].filter(Boolean);
+    let cleanedContent = content.trim();
+    // 尝试匹配并移除@Bot前缀
+    for (const pattern of atPatterns) {
+        if (pattern.test(cleanedContent)) {
+            cleanedContent = cleanedContent.replace(pattern, '').trim();
+            logger?.debug(`[交互绑定] 清理用户输入，原始: "${content}" -> 清理后: "${cleanedContent}"`);
+            break;
+        }
+    }
+    return cleanedContent;
+}

package/lib/utils/logger.d.ts

@@ -0,0 +1,75 @@
+import { Logger } from 'koishi';
+/**
+ * 统一的日志服务类
+ * 提供一致的日志接口，支持上下文标签和调试模式
+ */
+export declare class LoggerService {
+    private logger;
+    private debugMode;
+    private defaultContext;
+    /**
+     * 创建日志服务实例
+     * @param logger Koishi Logger 实例
+     * @param debugMode 是否启用调试模式
+     * @param defaultContext 默认上下文标签（可选）
+     */
+    constructor(logger: Logger, debugMode?: boolean, defaultContext?: string);
+    /**
+     * 设置调试模式
+     */
+    setDebugMode(enabled: boolean): void;
+    /**
+     * 获取当前调试模式状态
+     */
+    getDebugMode(): boolean;
+    /**
+     * 输出调试日志（仅在 debugMode 为 true 时输出）
+     * @param context 上下文标签
+     * @param message 日志消息
+     */
+    debug(context: string, message: string): void;
+    /**
+     * 输出信息日志
+     * @param context 上下文标签
+     * @param message 日志消息
+     * @param forceOutput 强制输出（忽略 debugMode 限制）
+     */
+    info(context: string, message: string, forceOutput?: boolean): void;
+    /**
+     * 输出警告日志（总是输出）
+     * @param context 上下文标签
+     * @param message 日志消息
+     */
+    warn(context: string, message: string): void;
+    /**
+     * 输出错误日志（总是输出）
+     * @param context 上下文标签
+     * @param message 错误消息
+     * @param error 错误对象或错误字符串（可选）
+     */
+    error(context: string, message: string, error?: Error | string): void;
+    /**
+     * 记录用户操作日志（带用户ID和操作结果）
+     * @param operation 操作名称（如 "MC账号绑定"）
+     * @param userId 用户ID（QQ号）
+     * @param success 操作是否成功
+     * @param details 额外详情（可选）
+     */
+    logOperation(operation: string, userId: string, success: boolean, details?: string): void;
+    /**
+     * 规范化QQ号格式（移除platform前缀）
+     * @param userId 用户ID（可能包含 platform: 前缀）
+     * @returns 纯QQ号字符串
+     */
+    private normalizeQQId;
+    /**
+     * 创建子日志服务（带固定上下文）
+     * @param context 固定的上下文标签
+     * @returns 新的 LoggerService 实例
+     */
+    createChild(context: string): LoggerService;
+    /**
+     * 获取原始的 Koishi Logger 实例（用于特殊情况）
+     */
+    getRawLogger(): Logger;
+}