feishu-card

name feishu-card version 3.0.0 description 飞书交互卡片（schema 2.0）：构建和发送卡片消息，含 @提及、流式思考态、原地更新、按钮/选择器交互。通过 lark-cli --as bot 发送，无需手动管理 token。 metadata {"requires":{"bins":["lark-cli","jq","python3"]}} feishu-card（schema 2.0） 关键规则 所有卡片使用 schema 2.0 ，元素放在 body.elements[] ，不是顶层 elements[] 发送卡片必须 --as bot ， --msg-type interactive ， --content 传 JSON 字符串 卡片内 @人 用 <at id="ou_xxx">姓名</at> （不是 <at user_id> ） JSON 2.0 按钮不再有 action 容器 ，button 直接放进 body.elements ，交互用 behaviors 数组 先发"思考中"卡片拿到 message_id ，Claude 回答后 PATCH 原地更新，避免刷屏 note tag 在 schema 2.0 中已不支持 （报错 200861），备注改用 div + lark_md （ <font color=grey>备注文字</font> ） 构建卡片 JSON 必须用 Python heredoc 或写文件 ，禁止用 $(python3 -c "...") ——内容含反引号或特殊字符时 bash 会报语法错误 顶层结构完整字段 { "schema" : "2.0" , "config" : { "streaming_mode" : false , "enable_forward" : true , "update_multi" : true , "width_mode" : "default" } , "card_link" : { "url" : "https://..." , "pc_url" : "https://..." , "ios_url" : "https://..." , "android_url" : "https://..." } , "header" : { "..." : "..." } , "body" : { "direction" : "vertical" , "padding" : "0px" , "elements" : [ ] } } config 字段 字段 类型 默认 说明 streaming_mode bool false 流式更新态（思考中占位用） enable_forward bool true 允许转发卡片 update_multi bool false JSON 2.0 共享卡片模式（多人同步更新需设 true） width_mode string default（600px） compact （400px）/ fill （全宽响应）/ default Header 字段 { "header" : { "title" : { "tag" : "plain_text" , "content" : "标题" } , "subtitle" : { "tag" : "plain_text" , "content" : "副标题（可选）" } , "template" : "blue" , "icon" : { "tag" : "standard_icon" , "token" : "robot-outlined" , "color" : "blue" } , "text_tag_list" : [ { "tag" : "text_tag" , "text" : { "tag" : "plain_text" , "content" : "New" } , "color" : "blue" } ] } } template 颜色 ： blue / wathet / turquoise / green / yellow / orange / red / carmine / violet / purple / indigo / grey 飞书颜色枚举速查 所有支持颜色枚举的字段（ background_color 、 text_color 、 icon color 等）均使用以下格式， 不能只写基础色名 （如 "blue" 单独使用在某些组件会报错），需带层级后缀： 色系 浅色（背景推荐） 中色 深色（文字推荐） 蓝 blue blue-50 blue-100 blue-200 blue-300 ～ blue-500 blue-600 ～ blue-900 水蓝 wathet wathet-50 wathet-100 wathet-200 wathet-300 ～ wathet-500 wathet-600 ～ wathet-900 青 turquoise turquoise-50 turquoise-100 turquoise-300 ～ turquoise-500 turquoise-600 ～ turquoise-900 绿 green green-50 green-100 green-200 green-300 ～ green-500 green-600 ～ green-900 黄绿 lime lime-50 lime-100 lime-300 ～ lime-500 lime-600 ～ lime-900 黄 yellow yellow-50 yellow-100 yellow-300 ～ yellow-500 yellow-600 ～ yellow-900 橙 orange orange-50 orange-100 orange-300 ～ orange-500 orange-600 ～ orange-900 红 red red-50 red-100 red-300 ～ red-500 red-600 ～ red-900 粉红 carmine carmine-50 carmine-100 carmine-300 ～ carmine-500 carmine-600 ～ carmine-900 紫 purple purple-50 purple-100 purple-300 ～ purple-500 purple-600 ～ purple-900 蓝紫 violet violet-50 violet-100 violet-300 ～ violet-500 violet-600 ～ violet-900 靛 indigo indigo-50 indigo-100 indigo-300 ～ indigo-500 indigo-600 ～ indigo-900 灰 grey grey-00 grey-50 grey-100 grey-300 ～ grey-500 grey-600 ～ grey-1000 白 white bg-white — — 常用浅色背景推荐 （collapsible_panel、column 背景等）： blue-100 wathet-100 green-100 yellow-100 orange-100 red-100 purple-100 carmine-100 turquoise-100 violet-100 indigo-100 lime-100 组件速查表 tag 类型 说明 div 内容 文本块（plain_text / lark_md），支持前缀 icon markdown 内容 纯 Markdown 文本（不支持 @，@用 div+lark_md） img 内容 图片 table 内容 数据表格（最多 5 个/卡片，不可嵌套） hr 布局 分割线 note 布局 ❌ schema 2.0 已废弃，改用 div + lark_md + <font color=grey> column_set 容器 多列布局 collapsible_panel 容器 折叠面板 button 交互 按钮（JSON 2.0 直接放 elements，不用 action 容器） input 交互 文本输入框（须在 form 内使用） select_static 交互 静态下拉选择器 div（文本块） { "tag" : "div" , "text" : { "tag" : "lark_md" , "content" : "**加粗** _斜体_ `代码`" , "text_size" : "normal" , "text_color" : "default" , "text_align" : "left" , "lines" : 3 } , "icon" : { "tag" : "standard_icon" , "token" : "robot-outlined" , "color" : "blue" } } text.tag ： plain_text （纯文本）或 lark_md （Markdown + @） text_size ： heading-0 / heading / normal （默认）/ notation / x-small text_align ： left / center / right img（图片） { "tag" : "img" , "img_key" : "img_xxx" , "alt" : { "tag" : "plain_text" , "content" : "悬停说明" } , "title" : { "tag" : "plain_text" , "content" : "图片标题" } , "scale_type" : "crop_center" , "size" : "medium" , "corner_radius" : "4px" , "preview" : true } scale_type ： crop_center / crop_top / fit_horizontal size ： stretch （全宽）/ large / medium / small / tiny / "300px 200px" （自定义） JSON 2.0 不支持 stretch_without_padding ，全宽效果改用负 margin column_set（多列布局） { "tag" : "column_set" , "flex_mode" : "bisect" , "horizontal_spacing" : "medium" , "background_style" : "default" , "columns" : [ { "tag" : "column" , "width" : "weighted" , "weight" : 1 , "vertical_align" : "top" , "elements" : [ { "tag" : "div" , "text" : { "tag" : "plain_text" , "content" : "左列" } } ] } , { "tag" : "column" , "width" : "weighted" , "weight" : 1 , "elements" : [ { "tag" : "div" , "text" : { "tag" : "plain_text" , "content" : "右列" } } ] } ] } flex_mode ： none （按比例压缩）/ stretch （窄屏纵排）/ flow （自动换行）/ bisect （等宽两列）/ trisect （等宽三列） horizontal_spacing ： small (4px) / medium (8px) / large (12px) / extra_large (16px) column.width ： auto / weighted （配合 weight 1-5）/ "200px" 最大嵌套 5 层，列内不可放 form 容器和 table collapsible_panel（折叠面板） { "tag" : "collapsible_panel" , "expanded" : false , "background_color" : "default" , "header" : { "title" : { "tag" : "plain_text" , "content" : "点击展开" } , "background_color" : "grey" , "icon" : { "tag" : "standard_icon" , "token" : "arrow-down-outlined" } , "icon_expanded_angle" : -180 } , "elements" : [ { "tag" : "div" , "text" : { "tag" : "plain_text" , "content" : "折叠内容" } } ] } table（数据表格） { "tag" : "table" , "page_size" : 5 , "row_height" : "low" , "freeze_first_column" : false , "header_style" : { "text_align" : "left" , "text_size" : "normal" , "background_style" : "grey" , "bold" : true } , "columns" : [ { "name" : "name" , "display_name" : "姓名" , "data_type" : "text" , "width" : "auto" } , { "name" : "status" , "display_name" : "状态" , "data_type" : "options" , "width" : "120px" } ,