核心用法
本技能通过 curl 命令调用 Rocket.Chat REST API（/api/v1/*），实现对自托管 Rocket.Chat 实例的全面操作。使用前需配置三个环境变量：ROCKETCHAT_URL（服务器地址）、ROCKETCHAT_AUTH_TOKEN 和 ROCKETCHAT_USER_ID（认证凭据）。
主要功能模块
消息操作：发送（chat.postMessage/chat.sendMessage）、读取（channels.messages）、编辑（chat.update）、删除（chat.delete）消息；支持搜索历史消息（chat.search）。
互动功能：添加/移除表情反应（chat.react），固定/取消固定消息（chat.pinMessage/chat.unPinMessage）。
频道管理：创建、归档频道，设置主题，列出频道成员（channels.*、groups.*、im.* 分别对应公开频道、私有群组和私信）。
用户信息：查询用户详情（users.info），支持通过 userId 或 username 查找。
自定义表情：列出服务器自定义表情（emoji-custom.list）。
使用特点
- 支持三种房间类型：公开频道（channels）、私有群组（groups）、私信（im/DM）
- 消息标识为字母数字 ID（非时间戳），需保存复用
- 表情名称无需冒号（如
thumbsup、white_check_mark） - 固定消息查询需 URL 编码 JSON 参数
显著优点
1. 功能覆盖全面：涵盖消息生命周期全管理、频道治理、用户查询等核心协作场景
2. 标准化 API：基于官方 REST API，文档完善（developer.rocket.chat）
3. 灵活认证：支持个人访问令牌模式，无需密码即可长期授权
4. 自托管友好：专为私有化部署设计，数据完全自主可控
5. 细粒度操作：支持消息编辑、反应、固定等精细化协作功能
潜在缺点与局限性
1. 环境依赖严格：必须预先配置三项环境变量，缺乏交互式认证流程
2. 令牌安全风险：ROCKETCHAT_AUTH_TOKEN 泄露即获得完整 API 权限，需严格保管
3. 无内置速率限制保护：高频调用可能触发服务器限流
4. curl 依赖：依赖系统 curl 二进制，Windows 环境可能需额外配置
5. 版本差异：不同 Rocket.Chat 版本 API 存在差异，部分端点可能不可用
适合人群
- 使用自托管 Rocket.Chat 的团队管理员和开发者
- 需要自动化频道管理、消息归档的工作流场景
- 构建内部机器人或通知系统的集成开发者
- 偏好命令行/API 操作的高级用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 凭证泄露 | 环境变量中的 TOKEN 若被窃取，攻击者可完全控制账户 |
| 权限过度 | 令牌通常拥有广泛权限，误操作可能导致批量消息删除/频道变更 |
| 数据暴露 | 搜索、列出成员等操作可能意外暴露敏感对话信息 |
| 服务器负载 | 大量消息查询或频道枚举可能影响实例性能 |