飞书消息发送技能 通过 feishu-cli 发送飞书消息，支持多种消息类型和丰富的消息管理操作。 核心概念 消息架构 飞书消息 API 的 content 字段是一个 JSON 字符串 （不是 JSON 对象）。CLI 提供三种输入方式： 输入方式 参数 适用场景 快捷文本 --text "内容" 纯文本消息，最简单 内联 JSON --content '{"key":"val"}' 或 -c 简单 JSON，一行搞定 JSON 文件 --content-file file.json 复杂消息（卡片、富文本等） 优先级 ： --text

--content

--content-file （同时指定时前者优先） 接收者类型 --receive-id-type 说明 示例 email 邮箱地址 user@example.com open_id Open ID ou_xxx user_id User ID xxx union_id Union ID on_xxx chat_id 群聊 ID oc_xxx 消息类型选择 决策树（Claude 未指定类型时自动选择） 默认优先使用 interactive （卡片消息） ，样式美观、内容丰富、支持颜色/多列/按钮等。 用户需求 ├─ 【默认】通知/报告/告警/任何有信息量的消息 → interactive（卡片） ├─ 发送已上传的图片/文件/音视频 → image/file/audio/media ├─ 分享群聊或用户名片 → share_chat/share_user ├─ 会话分割线（仅 p2p） → system └─ 仅以下场景才用 text/post： ├─ 用户明确要求发纯文本 → text └─ 用户明确要求发富文本 → post 为什么优先卡片 ：text 不支持任何格式渲染，post 样式有限，卡片支持彩色 header、多列 fields、按钮、分割线、备注等，视觉效果远优于其他类型。 消息类型一览 类型 说明 content 格式 大小限制 text 纯文本 {"text":"内容"} 150 KB post 富文本 {"zh_cn":{"title":"","content":[[...]]}} 150 KB image 图片 {"image_key":"img_xxx"} — file 文件 {"file_key":"file_v2_xxx"} — audio 语音 {"file_key":"file_v2_xxx"} — media 视频 {"file_key":"...","image_key":"..."} — sticker 表情包 {"file_key":"file_v2_xxx"} 仅转发 interactive 卡片 Card JSON / template_id / card_id 30 KB share_chat 群名片 {"chat_id":"oc_xxx"} — share_user 个人名片 {"user_id":"ou_xxx"} — system 系统分割线 {"type":"divider",...} 仅 p2p 发送命令 基础格式 feishu-cli msg send \ --receive-id-type < type

\ --receive-id < id

\ [ --msg-type < msg_type

] \ [ --text "" | --content '' | --content-file < file.json

] text 类型

最简形式（默认 msg-type 为 text）

feishu-cli msg send \ --receive-id-type email \ --receive-id user@example.com \ --text "你好，这是一条测试消息" text 类型支持的内联语法： @ 用户： Tom @ 所有人： 注意 ：text 类型 不支持 富文本样式（加粗、斜体、下划线、删除线、超链接等均不会渲染）。如需格式排版，请使用 post 类型。 post 类型（富文本） 推荐使用 md 标签承载 Markdown，一个 md 标签独占一个段落： cat

/tmp/msg.json << 'EOF' { "zh_cn": { "title": "项目进展通知", "content": [ [{"tag": "md", "text": "本周进展\n- 完成功能 A 开发\n- 修复 3 个 Bug\n- 查看详情"}], [{"tag": "md", "text": "下周计划\n1. 功能 B 开发\n2. 性能优化"}] ] } } EOF feishu-cli msg send \ --receive-id-type email \ --receive-id user@example.com \ --msg-type post \ --content-file /tmp/msg.json post 支持的 tag 类型： tag 说明 主要属性 text 文本 text, style（bold/italic/underline/lineThrough） a 超链接 text, href at @用户 user_id, user_name img 图片 image_key, width, height media 视频 file_key, image_key emotion 表情 emoji_type hr 分割线 — code_block 代码块 language, text md Markdown text（独占段落，推荐使用） interactive 类型（卡片消息） 卡片消息有三种发送方式： 方式一：完整 Card JSON（推荐，最灵活） cat

/tmp/card.json << 'EOF' { "header": { "template": "blue", "title": {"tag": "plain_text", "content": "任务完成通知"} }, "elements": [ {"tag": "markdown", "content": "项目: feishu-cli\n状态: 已完成\n负责人: "}, {"tag": "hr"}, {"tag": "note", "elements": [{"tag": "plain_text", "content": "由 CI/CD 自动发送"}]} ] } EOF feishu-cli msg send \ --receive-id-type email \ --receive-id user@example.com \ --msg-type interactive \ --content-file /tmp/card.json 方式二：template_id cat

/tmp/card.json << 'EOF' { "type": "template", "data": { "template_id": "AAqk1xxxxxx", "template_variable": {"name": "张三", "status": "已完成"} } } EOF feishu-cli msg send \ --receive-id-type email \ --receive-id user@example.com \ --msg-type interactive \ --content-file /tmp/card.json 方式三：card_id feishu-cli msg send \ --receive-id-type email \ --receive-id user@example.com \ --msg-type interactive \ --content '{"type":"card","data":{"card_id":"7371713483664506900"}}' Card JSON 结构（v1 vs v2） v1 格式（推荐，兼容性好） ： { "header" : { "template" : "blue" , "title" : { "tag" : "plain_text" , "content" : "标题" } } , "elements" : [ ... ] } v2 格式（更多组件） ： { "schema" : "2.0" , "header" : { "template" : "blue" , "title" : { "tag" : "plain_text" , "content" : "标题" } } , "body" : { "direction" : "vertical" , "elements" : [ ... ] } } v2 额外支持：table（表格）、chart（图表）、form_container（表单）、column_set（多列布局）等高级组件。对于简单通知，v1 足够；需要复杂布局时用 v2。 header 颜色模板 颜色值 色系 推荐场景 blue 蓝色 通用通知、信息 wathet 浅蓝 轻量提示 turquoise 青色 进行中状态 green 绿色 成功、完成 yellow 黄色 注意、提醒 orange 橙色 警告 red 红色 错误、紧急 carmine 深红 严重告警 violet 紫罗兰 特殊标记 purple 紫色 自定义分类 indigo 靛蓝 深色主题 grey 灰色 已处理、归档 语义化推荐 ：绿=成功 / 蓝=通知 / 橙=警告 / 红=错误 / 灰=已处理 常用组件速查 内容组件 ： 组件 tag 说明 Markdown markdown 支持 lark_md 语法，最常用 分割线 hr 水平分割线 备注 note 底部灰色小字备注 图片 img 图片展示 布局组件 ： 组件 tag 说明 文本+附加 div 文本块，可含 fields（多列）和 extra（右侧附加） 多列布局 column_set （v2） 横向分栏布局 交互组件 ： 组件 tag 说明 按钮 button default/primary/danger 三种类型 下拉选择 select_static 静态下拉菜单 日期选择 date_picker 日期选择器 折叠菜单 overflow 更多操作菜单 卡片 Markdown 语法（lark_md） 卡片内 markdown 组件使用 lark_md 语法，与标准 Markdown 有差异：

支持的语法 ** 加粗 ** * 斜体 * ~~ 删除线 ~~ 链接 行内代码 ! 图片

特有语法 < font color = ' green '

绿色文字 </ font

< font color = ' red '

红色文字 </ font

< font color = ' grey '

灰色文字 </ font

< at id = ou_xxx

</ at

< at id = all

</ at

注意 ：lark_md 的 仅支持 green/red/grey 三种颜色。 常用卡片模板 模板 1：简单通知卡片 { "header" : { "template" : "blue" , "title" : { "tag" : "plain_text" , "content" : "通知标题" } } , "elements" : [ { "tag" : "markdown" , "content" : "通知内容，支持 加粗 和 链接" } , { "tag" : "note" , "elements" : [ { "tag" : "plain_text" , "content" : "来自自动化工具" } ] } ] } 模板 2：告警卡片（多列 + 按钮） { "header" : { "template" : "red" , "title" : { "tag" : "plain_text" , "content" : "告警通知" } } , "elements" : [ { "tag" : "div" , "fields" : [ { "is_short" : true , "text" : { "tag" : "lark_md" , "content" : "服务\napi-gateway" } } , { "is_short" : true , "text" : { "tag" : "lark_md" , "content" : "级别\nP0" } } , { "is_short" : true , "text" : { "tag" : "lark_md" , "content" : "时间\n2024-01-01 10:00" } } , { "is_short" : true , "text" : { "tag" : "lark_md" , "content" : "影响\n用户无法登录" } } ] } , { "tag" : "hr" } , { "tag" : "action" , "actions" : [ { "tag" : "button" , "text" : { "tag" : "plain_text" , "content" : "查看详情" } , "type" : "primary" , "url" : "https://example.com/alert/123" } , { "tag" : "button" , "text" : { "tag" : "plain_text" , "content" : "忽略" } , "type" : "default" } ] } ] } 模板 3：进度报告卡片 { "header" : { "template" : "green" , "title" : { "tag" : "plain_text" , "content" : "构建报告" } } , "elements" : [ { "tag" : "markdown" , "content" : "项目: feishu-cli\n分支: main\n提交: abc1234" } , { "tag" : "hr" } , { "tag" : "markdown" , "content" : "Tests: 42/42 passed\nBuild: Success\nDuration: 3m 25s" } , { "tag" : "hr" } , { "tag" : "action" , "actions" : [ { "tag" : "button" , "text" : { "tag" : "plain_text" , "content" : "查看日志" } , "type" : "default" , "url" : "https://ci.example.com/build/123" } ] } , { "tag" : "note" , "elements" : [ { "tag" : "plain_text" , "content" : "CI/CD Pipeline #123" } ] } ] } 模板 4：文档操作通知 { "header" : { "template" : "turquoise" , "title" : { "tag" : "plain_text" , "content" : "文档操作通知" } } , "elements" : [ { "tag" : "div" , "fields" : [ { "is_short" : true , "text" : { "tag" : "lark_md" , "content" : "操作类型\n创建文档" } } , { "is_short" : true , "text" : { "tag" : "lark_md" , "content" : "状态\n成功" } } ] } , { "tag" : "markdown" , "content" : "文档标题: 周报 2024-W01\n文档链接: 点击查看" } , { "tag" : "note" , "elements" : [ { "tag" : "plain_text" , "content" : "由 feishu-cli 自动创建" } ] } ] } 模板 5：审批确认卡片（多按钮） { "header" : { "template" : "orange" , "title" : { "tag" : "plain_text" , "content" : "审批请求" } } , "elements" : [ { "tag" : "markdown" , "content" : "申请人: 张三\n申请类型: 服务器扩容\n说明: 线上流量增长，需要增加 2 台服务器" } , { "tag" : "hr" } , { "tag" : "action" , "actions" : [ { "tag" : "button" , "text" : { "tag" : "plain_text" , "content" : "批准" } , "type" : "primary" } , { "tag" : "button" , "text" : { "tag" : "plain_text" , "content" : "拒绝" } , "type" : "danger" } , { "tag" : "button" , "text" : { "tag" : "plain_text" , "content" : "查看详情" } , "type" : "default" , "url" : "https://example.com/approval/456" } ] } ] } 回复消息 回复指定消息，支持与 msg send 相同的消息类型和输入方式。