触发场景

发卡片 而非纯文字的情况：

需要用户做选择（按钮/下拉/人员选择等）
需要用户填写表单（输入框 + 提交按钮）
需要展示结构化数据（表格、图表、多列布局）
需要确认高风险操作（确认/取消双按钮）
需要提供快速操作入口（按钮组）

纯文字：简单回复、解释说明、无需交互时，无需发卡片。

工具说明

工具	用途	主要参数
`feishu_send_card`	发送卡片消息	`chat_id` / `user_id`，`card`（JSON字符串）
`feishu_send_form`	发送含表单容器的卡片	同上，card 内须含 `form` 组件
`feishu_update_card`	更新已发卡片内容	`token`（回调中获取），`card`（新JSON）

卡片顶层结构

{
  "schema": "2.0",
  "config": { ... },
  "card_link": { "url": "..." },
  "header": { ... },
  "body": { "elements": [ ... ] }
}

config 字段速查

字段	默认值	说明
`streaming_mode`	false	流式更新模式
`enable_forward`	true	是否可转发
`update_multi`	true	共享卡片（JSON 2.0 仅支持 true）
`width_mode`	default(600px)	`compact`(400px) / `fill`(撑满)
`enable_forward_interaction`	false	转发后是否仍可交互
`summary.content`	-	自定义聊天栏预览文案

header 字段速查

字段	说明	枚举/格式
`title.tag`	标题文本类型	`plain_text` / `lark_md`
`title.content`	主标题内容	字符串，最多4行
`subtitle.content`	副标题内容	字符串，最多1行
`template`	标题栏颜色	`blue` `wathet` `turquoise` `green` `yellow` `orange` `red` `carmine` `violet` `purple` `indigo` `grey` `default`
`icon.tag`	图标类型	`standard_icon` / `custom_icon`
`icon.token`	图标库token	如 `chat_outlined`
`text_tag_list[].color`	后缀标签颜色	`neutral` `blue` `turquoise` `lime` `orange` `violet` `indigo` `wathet` `green` `yellow` `red` `purple` `carmine`
`padding`	标题内边距	默认 `12px`

body 字段速查

字段	默认值	说明
`direction`	`vertical`	`vertical` / `horizontal`
`padding`	-	如 `12px 12px`
`horizontal_spacing`	-	`small`(4px) `medium`(8px) `large`(12px) `extra_large`(16px) 或 `Npx`
`horizontal_align`	`left`	`left` / `center` / `right`
`vertical_spacing`	-	同 horizontal_spacing
`vertical_align`	`top`	`top` / `center` / `bottom`
`elements`	[]	组件数组

组件速查

容器组件

column_set（分栏）

tag: column_set，不可内嵌 form 和 table

{
  "tag": "column_set",
  "flex_mode": "none",
  "horizontal_spacing": "8px",
  "background_style": "default",
  "columns": [
    {
      "tag": "column",
      "width": "weighted",
      "weight": 1,
      "vertical_align": "top",
      "elements": []
    }
  ]
}

关键枚举：

flex_mode: none / stretch / flow / bisect / trisect
column.width: auto / weighted / Npx([16,600]px)
background_style: default 或颜色枚举值

form（表单容器）

tag: form，只可放在卡片根节点，不可嵌套表格/表单

{
  "tag": "form",
  "name": "form_1",
  "elements": [
    { "tag": "input", "name": "reason", "required": true },
    {
      "tag": "button",
      "text": { "tag": "plain_text", "content": "提交" },
      "type": "primary_filled",
      "form_action_type": "submit",
      "name": "btn_submit"
    }
  ]
}

表单内交互组件必须有 name 字段（唯一标识）
按钮 form_action_type: submit（提交）/ reset（重置）

feishu-card

Install via CLI (Recommended)

触发场景

工具说明

卡片顶层结构

config 字段速查

header 字段速查

body 字段速查

组件速查

容器组件

column_set（分栏）

form（表单容器）

Metadata