higanworks/slack-cleaner

slack-cleaner镜像说明

镜像概述

slack-cleaner是一款用于批量管理Slack内容的工具，支持按多种条件批量删除消息和文件，可帮助用户高效清理平台内的冗余信息。该镜像基于开源项目构建，提供Docker化部署方式。

核心功能

• 批量删除公共频道、私人组、私信及多人群聊中的消息
• 批量删除文件（支持按类型筛选如代码片段、图片等）
• 按用户、时间范围、内容模式精准筛选目标内容
• 保留固定消息功能，避免误删重要信息
• 日志记录功能，便于操作审计和备份

使用场景

• 清理公共频道的历史冗余消息
• 移除私人组内的过时文件
• 清理机器人发送的批量通知
• 按时间范围归档并删除历史内容
• 整理多人群聊中的无效信息

配置说明

1. 获取Slack API Token

需在Slack平台注册应用并获取权限：

1. 访问Slack Apps创建新应用
2. 进入“OAuth & Permissions”页面，添加对应权限（如channels:history、files:write:user等）
3. 安装应用到目标工作区，复制OAuth Access Token

2. Docker部署示例

单次删除操作

bash
docker run -it --rm higanworks/slack-cleaner --token <你的Token> --message --channel general --user "*" --before 20240101 --perform

（说明：删除general频道2024年1月1日前所有用户的消息）

交互模式使用

bash
docker run -it --rm higanworks/slack-cleaner

进入容器后执行命令：

bash
slack-cleaner --token <你的Token> --file --types images --user johndoe --perform

（说明：删除用户johndoe上传的所有图片文件）

3. 关键参数说明

• --token：Slack API Token（必填）
• --message/--file：指定操作类型（删除消息/文件）
• --channel/--group/--direct：目标频道/私人组/私信
• --user：筛选特定用户内容（*表示所有用户）
• --before/--after：时间范围筛选（格式YYYYMMDD）
• --types：文件类型筛选（如snippets,images）
• --perform：确认执行删除（否则仅预览）
• --keeppinned：保留固定消息
• --log：生成操作日志文件