Discord Purge Bot 是一个专为 Discord 服务器设计的自动化消息清理工具，通过调用官方机器人令牌和 Discord HTTP API 实现安全可控的消息删除操作。该工具严格遵循安全准则，拒绝使用用户账户令牌或自托管行为，确保所有操作均在合规范围内进行。其核心设计围绕‘预览-确认-执行’的工作流展开，要求用户在真正删除前必须运行预览脚本以评估影响范围，并输入特定确认码才能启动删除流程，从而有效防止误操作。此外，工具保留完整的日志记录和 JSON 格式的操作摘要，便于审计与追溯。整个系统适用于需要定期清理频道历史、移除敏感信息或管理大量冗余消息的场景，尤其适合社区管理员、技术支持团队或内容审核人员使用。
核心功能特点
- 基于官方机器人令牌调用 Discord API，支持安全的批量消息清理操作
- 强制预览机制：所有删除操作前需先运行预览脚本，生成影响统计与确认码
- 支持多维度过滤：可按作者 ID、关键词、正则表达式、时间范围等条件筛选目标消息
- 自动处理 Discord 的 14 天消息删除限制，对超期消息采用单条删除回退策略
- 提供完整的操作日志与结构化输出（JSON），满足审计与安全审查需求
- 内置代理支持与环境变量配置，可在复杂网络环境下稳定运行
适用场景
Discord Purge Bot 主要面向需要长期维护大型 Discord 服务器的组织或个人管理者，典型应用场景包括技术社区中清理错误日志堆积、客服频道移除重复咨询记录、以及活动结束后归档或清除临时公告。例如，当一个开发团队在调试频道中产生大量报错信息后，管理员可使用 `–contains “error” –after “2026-03-01T00:00:00Z”` 参数快速定位并清理特定时间段内的错误消息，避免信息过载。另一个常见场景是客服团队在处理工单时，若某位用户频繁发送重复问题，可通过指定 `author-id` 实现精准清理，同时保留其他用户的正常交流。对于需要彻底重建频道结构的情况，如迁移讨论区或重置测试环境，`purge-nuke.mjs` 脚本可一键创建新频道并选择性删除旧频道，极大提升运维效率。该工具尤其适合那些重视数据合规性与操作可追溯性的组织，因其每一步操作均留下清晰记录，便于后续复盘或应对平台审查。