
本项目的功能
本项目是一款由社区驱动的 Discord 和 Telegram 桌面服务器管理工具。它为 Windows x64 打包了完整工具包,并在一款以本地运行为优先的应用中提供配置、面向管理的审核、日志记录、权限、模块、导出和社区反馈功能。
仅将其用于你拥有或获授权管理的社区、服务器、频道和凭据。README 描述了一个已激活的软件包,包含本地配置和简洁的安装流程。

要求与运行模式
- Windows 10 或 Windows 11
- PowerShell 5.1 或更高版本
- 在平台连接和初始设置期间需要有效的网络连接
- 无需管理员权限
- Windows x64 桌面环境
安装后,独立工具包设计为在本地运行,无需获取其他组件。Discord 和 Telegram 集成仍需要网络访问权限,以便与这些平台通信。
安装与初始设置
- 打开项目的 PowerShell 快速安装页面。
- 按照安装程序提示,将完整软件包部署到 Windows 桌面。README 将安装程序描述为自包含程序,因此无需单独下载组件。
- 启动已安装的应用,并在启动器旁找到可读的配置文件。
- 使用纯文本编辑器打开配置文件。文件包含注释值和合理的默认值,因此只需修改部署所需的选项。
- 对于 Discord,提供你自己的机器人令牌和应用凭据,然后配置允许访问的服务器、频道、角色和命令行为。
- 对于 Telegram,提供你自己的机器人凭据,并定义机器人可以访问的群组、频道或私人聊天。
- 保存文件并重启机器人,使更改生效。
请妥善保管令牌和其他凭据。切勿将其粘贴到公共频道或提交到共享仓库。如果你认为凭据已经泄露,请立即轮换凭据。
核心配置区域
Discord
- 设置机器人令牌和应用凭据。
- 选择命令前缀,或使用原生斜杠命令。
- 将运行范围限定为选定的服务器和频道。
- 通过角色和权限限制敏感操作。
- 自定义机器人状态文本和活动类型。
Telegram
- 添加 Telegram 机器人应用的凭据。
- 将应接收响应的群组、频道或私人聊天列入允许名单。
- 使用与 Discord 相同的命令集,或仅启用选定命令。
- 调整速率和洪水控制,以遵守平台限制。
共享行为
- 设置按用户和按频道计算的命令冷却时间。
- 选择日志详细程度,从必要输出到详细调试信息。
- 创建基于关键词的轻量级自动响应规则。
- 使用简单的时间间隔定义计划任务。
- 通过功能开关启用或禁用单个模块。
使用命令界面

命令包含内联提示和自动补全功能。输入 /help 可按类别查看可用命令,或使用 /help <command> 请求特定命令的详细信息。
检查运行状态和项目信息
/ping
/stats
/about/ping 用于确认机器人是否响应。/stats 显示运行时间、已加入的服务器、活跃用户和命令使用情况等信息。/about 提供致谢和版本信息。
查看和更改服务器配置
/config view
/config set
/config reset使用 /config view 查看已启用的模块、默认频道和权限级别。使用 /config set 调整前缀、日志频道和功能开关等设置。如果配置实验导致问题,/config reset 会恢复合理的服务器默认设置。
管理模块、日志和权限
/module list
/module enable
/module disable
/logs channel
/permissions check列出可用模块,启用或禁用单个功能,选择用于记录活动日志的频道,并验证哪些成员可以运行特定命令。
备份和恢复设置
/export
/import使用 /export 创建可共享的配置快照,用于备份或迁移。使用 /import 在其他服务器或部署中恢复现有快照。
发送反馈
/feedback使用 /feedback 向维护者发送错误报告或想法。报告问题时,请包括预期行为、实际结果以及相关命令或设置。
实际设置流程

- 安装软件包,并确认启动器可以成功打开。
- 连接已授权的机器人实例后,运行
/ping。 - 使用
/config view和/module list查看当前设置。 - 启用可选模块前,设置日志记录和权限边界。
- 使用
/permissions check验证受信任角色是否可以执行敏感操作。 - 在应用更广泛的权限范围前,先在已授权的服务器或聊天中进行小规模测试。
- 完成稳定设置后,导出配置。
高级提示
一次只更改一项设置
默认设置旨在立即生效。逐步进行更改,编辑配置文件后重启,并在进行重大调整前保留备份。这样可以更容易地找出无效值或模块之间的意外交互。
使用有限的权限范围
将机器人限制在实际需要使用它的服务器、频道、群组和聊天中。将平台范围限制与角色和权限控制结合起来,确保只有受信任成员可以使用敏感操作。
平衡日志记录与隐私
日常运行使用必要的日志记录,排查问题时再临时提高详细程度。审核透明度很重要时,可配置专用的活动日志频道,并避免在日志中暴露凭据或私人信息。
遵守速率限制
对于 Telegram,请谨慎调整速率和洪水控制。在两个平台上都应合理使用冷却时间和计划任务,以减少垃圾信息并保持自动化活动的可预测性。
让更新易于管理
更新以全新的安装包形式发布。新版本发布后,请按照 README 中的说明将最新软件包安装到现有安装目录中,同时先保留配置备份。
故障排除
- 如果应用无法正常启动,请重新运行安装程序,并确认所需的运行时依赖已就绪。
- 如果命令没有响应,请检查配置文件、权限、已启用的模块以及平台范围。
- 如果配置更改产生意外结果,请恢复已知正常的备份,或使用
/config reset重置服务器设置。 - 如果安全软件标记了自动安装程序,请验证软件包来源,并在继续操作前仔细查看警告。任何经授权的安装过程完成后,应立即重新启用正常防护。
- 寻求帮助时,请提供版本号、预期行为、实际行为、相关命令,以及移除机密信息后的安全配置片段。
支持、贡献与许可证
该项目引导用户前往其 Discord 和 Telegram 社区频道,以获取公告、配置帮助、问题报告和功能讨论。README 也欢迎各种贡献,包括错误报告、功能请求、配置示例和拉取请求。
该项目采用 MIT 许可证发布。你可以根据许可证条款使用、修改和分享该项目。软件按“原样”提供,因此在部署前请评估它是否适合你的环境和使用场景。
结语
这款面向 Windows 的工具包提供了一种自包含的方式,用于配置和运行经过授权的 Discord 与 Telegram 机器人实例。安装软件包,添加你自己的凭据,应用有限的权限和范围,使用核心命令进行测试,并导出稳定配置以便备份。文档完善的命令系统和社区支持,让你可以从默认设置开始并逐步扩展。
