飞书即时消息
加载工作流后,将其中 references/、scripts/、templates/、examples/ 相对路径按该
workflow.md 所在目录解析;执行脚本时使用解析后的实际路径,不要依赖当前 shell 目录。
路由
| 意图 | 读取文件 |
|---|---|
| 发送、回复、转发、加急、flag、资源下载 | references/workflows/msg/workflow.md |
| 历史消息、详情、Reaction、Pin、撤回、群和成员 | references/workflows/chat/workflow.md |
| 设计和生成 V2 interactive 卡片 JSON | references/workflows/card/workflow.md |
| 订阅和消费实时事件 | references/workflows/event/workflow.md |
发送交互卡片时先读取 card 构造 JSON,再读取 msg 发送。搜索历史消息关键词时读取
../feishu-cli-platform/references/workflows/search/workflow.md。
执行规则
- 发送前确认接收者类型和 ID;不要把 email、open_id、chat_id 混用。
- 群发、加急和删除消息有外部影响,先展示目标和数量。
msg send与msg reply共用内容快捷参数;本地图片、文件、Opus 音频、MP4 视频会先上传, 任一文件缺失、格式非法或上传失败都会阻止提交消息。--upload-images同时适用于两条命令。- 进入既有话题必须使用
msg reply <om_xxx>;omt_xxx仅用于话题查询/转发,不能作为msg send的接收者。普通消息群开启新话题时才加--reply-in-thread。 - 发送与回复重试都使用同一
--idempotency-key;媒体上传可能重做,但服务端幂等键防止 可见消息重复。只有命令返回非空message_id才判定成功。 - 外部群 232033 的排错读取
references/workflows/chat/references/external-chat.md。 - 卡片草稿与发送候选分开校验;发送前必须运行 card workflow 的
lint_card.py --strict,不得发送含占位符、示例 ID、假链接或未接通回调按钮的卡片。 - 用户点名卡片风格时使用 card workflow 内置的 19 个预设;使用本地头图或图标素材时,
lint 与实际的
msg send/msg reply都传--upload-images,不要固化跨租户img_key。