gruppeadler/blechadler

Blechadler

Blech + Adler = Blechadler | 一个***机器人

镜像概述

Blechadler是一款集成Teamspeak功能的机器人，旨在通过界面提供Teamspeak服务器信息查询、用户互动管理等功能。支持多种命令交互，包括Teamspeak客户端状态显示、提醒设置、随机选择、用户积分（strich）管理等，并可通过Docker容器化部署，简化配置与维护流程。

核心功能与特性

• Teamspeak集成：显示活跃Teamspeak客户端及频道列表
• 多命令支持：直接命令（!前缀）和提及命令（@机器人）两种交互方式
• 提醒功能：设置用户提醒事项
• 随机选择：从提供的选项中随机挑选答案
• 用户积分管理：添加和查询用户"strich"积分
• 可配置性：支持命令别名设置和命令启用/禁用
• 数据持久化：使用SQLite数据库存储提醒等数据

使用场景

• ***服务器中需要集成Teamspeak服务器状态监控
• 社区管理中需要自动化提醒、随机选择成员等功能
• 需要简化Teamspeak客户端状态查询流程的场景
• 小型社区用户互动与积分管理

安装与配置

Docker安装

Docker镜像托管于https://hub.docker.com/r/gruppeadler/blechadler%E3%80%82%E5%BA%94%E7%94%A8%E7%A8%8B%E5%BA%8F%E4%BD%8D%E4%BA%8E%60/usr/src/app/%60%EF%BC%8C%E9%9C%80%E9%80%9A%E8%BF%87%E5%8D%B7%E6%8C%82%E8%BD%BD%E6%88%96%E7%9B%B4%E6%8E%A5%E5%A4%8D%E5%88%B6%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%EF%BC%8C%E5%B9%B6%E6%8C%81%E4%B9%85%E5%8C%96%E6%95%B0%E6%8D%AE%E5%BA%93%E7%9B%AE%E5%BD%95%E3%80%82

docker-compose示例

yaml
version: '3'
services: 
    blechadler:
        image: gruppeadler/blechadler
        volumes:
            - /usr/blechadler/config/auth.json:/usr/src/app/config/auth.json  # 认证配置
            - /usr/blechadler/config/config.json:/usr/src/app/config/config.json  # 应用配置
            - /usr/blechadler/db:/usr/src/app/db  # SQLite数据库持久化

配置文件说明

1. auth.json：需从auth_sample.json复制而来，填写以下信息：

   • ***机器人客户端令牌
   • Teamspeak服务器查询凭据

2. config.json：需确认以下配置项与实际环境匹配：

   • serverip：Teamspeak服务器IP
   • port：Teamspeak端口
   • sid：虚拟服务器ID
   • category：***频道分类
   • noticesTargetChannel：通知目标频道

权限要求

Teamspeak查询账户权限

服务器查询账户需至少具备以下权限：

• b_serverquery_login
• b_serverinstance_version_view
• b_virtualserver_select
• b_virtualserver_notify_register
• b_virtualserver_channel_list
• b_virtualserver_client_list
• i_channel_subscribe_power
• i_channel_needed_subscribe_power

***机器人权限

机器人在指定频道分类中需至少具备以下权限：

• 管理权限（Manage Permissions）
• 读取消息（Read Messages）
• 发送消息（Send Messages）

命令说明

直接命令

所有命令需以指定命令符号（默认!）开头：

• ts：显示所有活跃Teamspeak客户端及频道列表（需在noticesTargetChannel指定的频道中使用）

提及命令

所有命令需紧跟机器人提及（消息以@机器人开头）：

• about：显示机器人版本、描述和名称
• channel：与直接命令ts功能相同
• help：显示所有命令帮助或特定命令帮助
• pick：从提供的选项中随机选择答案
• reminder：提醒用户某事项
• strich：为用户添加"strich"积分
• striche：列出所有用户的"strich"积分
• teamspeak：与直接命令ts功能相同

高级配置

命令别名

可通过编辑command_aliases.json添加命令别名，格式为：{"别名": "目标命令"}，例如{"tsinfo": "ts"}将使tsinfo作为ts命令的别名。

命令启用/禁用

通过修改config.json中的commands数组管理命令启用状态，移除数组中的命令名称即可禁用对应命令（每个命令对应src/commands目录下的一个JavaScript文件）。