BIND-BOT (koishi-plugin-bind-bot) 指令使用说明

BIND-BOT - 账号绑定管理机器人，支持 Minecraft 账号和 B站账号绑定与管理。

普通用户命令

Minecraft账号相关

• 绑定 交互式绑定流程（引导式绑定MC账号和B站账号）
• mcid bind <用户名> 绑定Minecraft账号
• mcid query 查询自己绑定的Minecraft账号
• mcid change <用户名> 修改绑定的Minecraft账号
• mcid unbind 解绑Minecraft账号
• mcid whitelist servers 列出所有可用的Minecraft服务器
• mcid whitelist add <服务器名称或ID> 申请添加服务器白名单（需服务器允许自助申请）

B站账号相关

• buid bind <B站UID> 绑定B站UID（支持UID、URL等多种格式）
• buid bind <B站UID> -f 强制绑定B站UID（使用API直接获取数据，检查目标粉丝牌）
• buid query 查询自己绑定的B站账号信息

管理员命令

绑定流程管理

• 绑定 <目标用户> 为指定用户启动交互式绑定流程（支持QQ号和@用户）

Minecraft账号管理

• mcid bind <用户名> [目标用户] 为指定用户绑定Minecraft账号（支持QQ号和@用户）
• mcid query [目标用户] 查询指定用户绑定的Minecraft账号（支持QQ号和@用户）
• mcid finduser <用户名> 通过Minecraft用户名查询绑定的QQ账号
• mcid change <用户名> [目标用户] 修改指定用户绑定的Minecraft账号（支持QQ号和@用户）
• mcid unbind [目标用户] 为指定用户解绑Minecraft账号（支持QQ号和@用户）
• mcid stats 查看绑定信息统计

B站账号管理

• buid bind <B站UID> [目标用户] 为指定用户绑定B站UID（支持UID、URL等多种格式）
• buid bind <B站UID> [目标用户] -f 为指定用户强制绑定B站UID（支持UID、URL等多种格式）
• buid query [目标用户] 查询指定用户的B站账号信息（支持QQ号和@用户）
• buid finduser <B站UID> 通过B站UID查询绑定的QQ账号（支持UID、URL等多种格式）

白名单管理

• mcid whitelist add <服务器名称或ID> [目标用户...] 为指定用户添加服务器白名单（支持批量，支持QQ号和@用户）
• mcid whitelist add <服务器名称或ID> <标签名> 为有指定标签的所有用户添加白名单（优先检查标签名）
• mcid whitelist remove <服务器名称或ID> [目标用户...] 为指定用户移除服务器白名单（支持批量，支持QQ号和@用户）
• mcid whitelist remove <服务器名称或ID> <标签名> 为有指定标签的所有用户移除白名单（优先检查标签名）
• mcid whitelist addall <服务器名称或ID> 将所有已绑定MC账号的用户添加到指定服务器白名单

标签管理

• mcid tag add <标签名> <目标用户...> 为用户添加标签（支持批量，支持QQ号和@用户）
• mcid tag remove <标签名> <目标用户...> 移除用户标签（支持批量，支持QQ号和@用户）
• mcid tag list [目标用户] 查看用户的所有标签或查看所有标签统计（支持QQ号和@用户）
• mcid tag find <标签名> 查找有指定标签的所有用户
• mcid tag rename <旧标签名> <新标签名> 重命名标签（管理员权限）

主人命令

权限管理

• mcid admin <目标用户> 将用户设为管理员（支持QQ号和@用户）
• mcid unadmin <目标用户> 撤销用户的管理员权限（支持QQ号和@用户）
• mcid adminlist 列出所有管理员

系统管理

• mcid whitelist reset <服务器ID> 重置指定服务器的所有白名单数据库记录（可清理配置中已删除的服务器ID）
• mcid whitelist resetall 清理所有未在服务器配置列表中的白名单ID
• mcid tag deleteall <标签名> 删除所有用户的指定标签
• mcid fixnicknames [群号] 批量检查并修复指定群或当前群的用户群昵称格式
• mcid clearreminder [目标用户] 清除用户的随机提醒冷却时间和提醒次数
• mcid export <群号> 导出指定群的成员列表和绑定信息为Excel文件（仅私聊可用）

B站UID绑定功能说明

功能特性

• 数据验证：自动验证B站UID的有效性，通过ZMINFO API获取用户详细信息
• 信息展示：显示B站用户名、舰长等级、粉丝牌信息、荣耀等级、最后活跃时间等
• 集成显示：在使用 mcid query 查询MC账号时，同时显示B站相关信息
• 冷却时间：B站UID绑定的冷却时间为MC账号绑定的3倍（默认45天）
• 唯一性保证：每个B站UID只能被一个QQ号绑定，每个QQ号可同时绑定MC账号和B站UID

使用示例

# 绑定B站UID
buid bind 123456789

# 查询自己的B站信息
buid query

# 管理员为他人绑定B站UID（支持QQ号）
buid bind 123456789 123456
buid bind 123456789 @用户

# 管理员通过B站UID查找绑定的QQ号
buid finduser 123456789

# 查询MC账号信息（同时显示B站信息）
mcid query

随机提醒功能说明

功能特性

• 智能检测：随机检测正在发言用户的绑定状态和群昵称格式
• 三种场景：
  • 完全未绑定账号的用户：提醒绑定MC和B站账号
  • 仅绑定B站的用户：自动修复群昵称并提醒绑定MC账号
  • 群昵称格式错误的用户：自动修复为规范格式并提醒保持
• 触发概率：普通用户3%，管理员1%，避免过度打扰
• 冷却机制：24小时冷却期，同一用户不会重复收到提醒
• 提醒升级：前三次显示为"提醒"，第四次及以后升级为"警告"
• 群昵称规范：B站名称（ID:MC用户名） 或 B站名称（ID:未绑定）

管理员工具

• 使用 mcid fixnicknames 批量修复所有用户的群昵称
• 使用 mcid clearreminder [目标用户] 清除提醒冷却和次数

标签功能说明

标签功能允许管理员对用户进行分组管理，便于批量操作：

• 标签名称只能包含中文、字母、数字、下划线和连字符
• 标签功能仅限管理员使用
• 用户不需要绑定MC账号也可以拥有标签
• 在白名单命令中，优先检查标签名，如果存在该标签则按标签处理，否则按QQ号处理

标签使用示例

# 为多个用户添加"VIP"标签（支持QQ号）
mcid tag add VIP 123456 234567 @用户3

# 查看有"VIP"标签的所有用户
mcid tag find VIP

# 为所有有"VIP"标签的用户添加服务器白名单（优先匹配标签名）
mcid whitelist add 生存服 VIP

# 如果没有"123456"这个标签，则按QQ号处理
mcid whitelist add 生存服 123456

# 移除所有有"VIP"标签的用户的服务器白名单
mcid whitelist remove 生存服 VIP

B站UID格式支持

系统支持多种B站UID输入格式，使用户更方便地进行绑定：

支持的格式

1. 纯数字格式：123456789
2. UID前缀格式：UID:123456789
3. 个人空间链接：
   • https://space.bilibili.com/123456789
   • http://space.bilibili.com/123456789
   • https://space.bilibili.com/123456789?spm_id_from=333.999.0.0
   • https://space.bilibili.com/123456789/dynamic

使用示例

# 使用纯数字
buid bind 1385838290

# 使用UID前缀
buid bind UID:1385838290

# 使用完整空间链接
buid bind https://space.bilibili.com/1385838290?spm_id_from=..0.0

# 强制绑定模式也支持URL
buid bind https://space.bilibili.com/1385838290 -f

# 管理员为他人绑定
buid bind https://space.bilibili.com/1385838290 @用户

自动解析功能

• 系统会自动识别输入格式并提取UID
• 自动删除URL前缀 https://space.bilibili.com/
• 自动删除URL参数 ?spm_id_from=...
• 自动删除路径后缀 /dynamic 等
• 提取出的UID必须为纯数字才能通过验证

强制绑定功能说明

强制绑定功能（-f参数）完全依赖B站API获取用户信息和粉丝牌数据，不依赖ZMINFO数据库。

功能特点

1. 纯API模式: 主要使用B站Live API获取用户信息，ZMINFO仅作为备选
2. 必须登录: 要求有效的B站Cookie，未登录状态将直接报错
3. 目标粉丝牌检测: 自动检查用户是否拥有指定UP主的目标粉丝牌
4. 用户名获取: 直接从B站API获取真实用户名，无效UID将报错
5. 详细反馈: 提供目标粉丝牌的详细信息（等级、佩戴状态等）

配置要求

使用强制绑定功能需要配置以下参数：

• forceBindSessdata: B站Cookie信息，用于API认证（支持以下格式）：
  • 完整Cookie: buvid3=xxx; SESSDATA=xxx; bili_jct=xxx; DedeUserID=xxx; ...
  • 单独SESSDATA值: 5fdf9765%2C1768271824%2C9cd59%2A71CjDx...
  • SESSDATA格式: SESSDATA=5fdf9765%2C1768271824%2C9cd59%2A71CjDx...
• forceBindTargetUpUid: 目标UP主UID（默认：686127）
• forceBindTargetRoomId: 目标房间号（默认：544853）
• forceBindTargetMedalName: 目标粉丝牌名称（默认：生态）

使用示例

# 普通用户强制绑定
buid bind 123456789 -f

# 管理员为他人强制绑定
buid bind 123456789 @用户 -f

响应示例

找到目标粉丝牌时：

✅ 强制绑定成功！
B站UID: 123456789
用户名: 测试用户

🎯 目标粉丝牌: 生态 LV.15 (舰长) 【已佩戴】

未找到目标粉丝牌时：

✅ 强制绑定成功！
B站UID: 123456789
用户名: 测试用户

未找到目标粉丝牌"生态"（UP主UID: 686127）

UID不存在或Cookie无效时：

❌ 强制绑定失败: 无法获取用户 123456789 的信息，请确认UID是否正确

❌ 强制绑定失败: B站登录状态异常，无法进行强制绑定，请检查Cookie配置

配置项说明

| 配置项 | 类型 | 默认值 | 说明 | |-------|-----|-------|------| | cooldownDays | number | 15 | 修改绑定的冷却时间(天)，B站UID绑定为此值的3倍 | | masterId | string | '' | 主人QQ号，拥有管理员管理权限 | | allowTextPrefix | boolean | false | 是否允许通过文本前缀触发指令 | | botNickname | string | '' | 机器人昵称，用于文本前缀匹配 | | autoRecallTime | number | 0 | 消息自动撤回时间(秒)，同时控制机器人和用户消息，0表示不自动撤回 | | recallUserMessage | boolean | false | 是否撤回用户发送的指令消息（仅群聊消息） | | debugMode | boolean | false | 调试模式，启用详细日志输出 | | showAvatar | boolean | false | 是否显示头像图片（MC用头图，B站用头像） | | showMcSkin | boolean | false | 是否使用MC皮肤渲染图（需要先开启showAvatar） | | zminfoApiUrl | string | 'http://zminfo-api.wittf.ink' | ZMINFO API地址，用于获取B站用户信息 | | autoNicknameGroupId | string | '123456789' | 自动群昵称设置目标群ID，交互式绑定完成后自动设置群昵称 | | forceBindSessdata | string | '' | B站Cookie信息，用于强制绑定时获取粉丝牌信息（支持完整Cookie或单独SESSDATA） | | forceBindTargetUpUid | number | 686127 | 强制绑定目标UP主UID | | forceBindTargetRoomId | number | 544853 | 强制绑定目标房间号 | | forceBindTargetMedalName | string | '生态' | 强制绑定目标粉丝牌名称 | | servers | array | [] | Minecraft服务器配置列表 |

服务器配置项

| 配置项 | 类型 | 默认值 | 说明 | |-------|-----|-------|------| | id | string | (必填) | 服务器唯一ID | | name | string | (必填) | 服务器名称 | | enabled | boolean | true | 服务器是否启用，停用后不会显示在列表中 | | displayAddress | string | '' | 服务器展示地址 | | description | string | '' | 服务器说明信息 | | rconAddress | string | (必填) | RCON地址，格式为IP:端口 | | rconPassword | string | '' | RCON密码 | | addCommand | string | 'whitelist add ${MCID}' | 添加白名单命令模板 | | removeCommand | string | 'whitelist remove ${MCID}' | 移除白名单命令模板 | | idType | string | 'username' | 白名单添加时使用的ID类型(username或uuid) | | allowSelfApply | boolean | false | 是否允许用户自行申请白名单 | | acceptEmptyResponse | boolean | false | 是否将命令的空响应视为成功 |

版本历史

详细的版本更新记录请查看 CHANGELOG.md 文件。