核心用法
本 Skill 提供完整的 Rocket.Chat REST API 封装能力，涵盖三大核心场景：
1. 频道与群组管理
- 创建/归档公共频道（
channels.*）与私有群组（groups.*） - 获取历史消息、成员列表、设置主题
- 支持 DM（
im.*）与线程对话
2. 消息操作
- 发送消息（支持
#channel、@username或roomId三种目标格式） - 编辑、删除、搜索、反应表情（emoji 名无需冒号）
- 置顶/取消置顶消息，查看已置顶内容
3. 用户与集成
- 用户列表查询、信息获取、状态设置
- 创建用户（需管理员权限）
- 自定义表情管理、Webhook 集成与服务器统计
认证方式：Header 传递 X-Auth-Token + X-User-Id，或通过 /login 端点获取令牌。支持速率限制监控（默认 20 req/s）。
显著优点
- 开源可控：相比 Slack/Teams 等闭源方案，数据完全自主托管
- API 覆盖全面：消息、频道、用户、集成、统计等全功能 REST 接口
- 灵活的消息路由：单一套件同时支持频道、私聊、Webhook 三种通信模式
- 无额外依赖：仅需
curl与可选jq，兼容各类 CLI 环境
潜在局限
- 权限敏感：创建用户、归档频道等操作需管理员 Token
- 速率限制：默认 20 req/s，高并发场景需申请调高或实现退避
- 自托管运维成本：需自行维护服务器、数据库与备份
- 表情名称差异：与 Slack 的
:emoji:格式不同，需使用裸名如thumbsup
适合人群
- 使用 Rocket.Chat 作为内部通讯工具的 DevOps/运维团队
- 需要自动化通知、告警集成的开发者
- 偏好开源方案、注重数据主权的企业用户
常规风险
- Token 泄露风险：
RC_TOKEN具备完整 API 权限，需妥善保管环境变量 - 误操作不可逆：删除消息、归档频道无二次确认，脚本需加校验逻辑
- Webhook 暴露：Incoming Webhook URL 泄露可能导致消息 spam
- 版本兼容性：API 行为随 Rocket.Chat 版本变化，生产环境建议锁定版本测试