核心用法
Chat Forwarder 是一款专注于消息流转的实用型 Skill,通过调用飞书开放平台 API,实现从指定群组抓取近期聊天记录,并以「合并转发」(Merge Forward)的格式投递至目标用户或会话。
典型应用场景:
- 运营人员将客户群关键对话同步至主管
- 跨部门协作时快速分享历史上下文
- 重要群聊内容的自动化归档与备份
使用方式:
node skills/chat-forwarder/index.js \ --source "oc_xxx" \ --target "ou_xxx" \ --limit 50
参数说明:
--source: 源群聊 ID(oc_开头)--target: 接收方 ID(用户ou_或群聊oc_)--limit: 转发消息数量,默认 20 条,上限 100 条
显著优点
1. 原生体验:采用飞书「合并转发」格式,接收方展开后保留原始消息结构、发送者昵称及时间戳,阅读体验与手动转发一致
2. 零配置依赖:单文件脚本,无需额外服务或数据库,Node.js 环境即可运行
3. 精准控制:支持自定义拉取数量,避免信息过载
4. API 合规:基于官方开放平台接口,不依赖私有协议或浏览器模拟
潜在局限与风险
| 类别 | 说明 |
|------|------|
| **权限依赖** | 需要机器人具备源群聊的读取权限及目标会话的发送权限,权限不足时将失败 |
| **消息可见性** | 仅能获取机器人加入后可见的消息历史,无法拉取更早或机器人未加入时的内容 |
| **隐私合规** | 批量转发可能涉及敏感信息,需确保符合企业内部数据流转规范及用户告知义务 |
| **格式限制** | 复杂消息类型(如投票、日程卡片)可能无法完整保留或呈现异常 |
| **无增量机制** | 每次调用独立执行,无状态记录,重复执行可能产生冗余转发 |
适合人群
- 企业 IT 管理员、群运营人员
- 需自动化消息同步的 RPA 开发者
- 飞书生态内的效率工具搭建者
安全建议
- 严格限制
--source与--target的输入来源,防止被利用为消息泄露通道 - 生产环境建议接入审批流或白名单机制,避免敏感群聊内容被无授权转发
- 定期检查机器人权限范围,遵循最小权限原则