用途:当需要构建、发送或更新飞书 IM 交互卡片时使用,例如向某个 open_id、chat_id 或用户发送交互卡片、构建带按钮和分割线的消息卡片、把 JSON 卡片作为 interactive 消息发出、处理按钮回调、更新已发卡片。
主要能力:通过飞书开放接口发送与更新卡片。接口基址为 https://open.feishu.cn/open-apis/im/v1。发送使用 POST /open-apis/im/v1/messages?receive_id_type=open_id 或 ?receive_id_type=chat_id;更新原消息使用 PATCH /open-apis/im/v1/messages/{message_id}。卡片结构含 config、header(title、template)和 elements,常用元素有 div 文本块、hr 分割线、action 按钮区、note 备注区。
使用方式:默认复用 feishu-user-auth 提供的系统 token 能力,优先执行 feishu-auth system-token;若 PATH 无该命令,可执行 ./.agents/skills/feishu-user-auth/bin/feishu-auth.js system-token,全局安装时为 ~/.agents/skills/feishu-user-auth/bin/feishu-auth.js system-token。若返回 JSON,取其中 accessToken 作为 Authorization: Bearer <token>。发送时请求体关键点:msg_type 必须是 interactive,content 必须是字符串化后的 JSON,receive_id_type 需与 receive_id 类型一致。按钮回调事件通常关注 type 为 card.action.trigger,以及 action.value 中的字段。参考模板 references/card-alert.json、references/card-morning-briefing.json、references/card-skill-test.json 仅在任务明确需要现成模板时读取。
限制与注意事项:按钮必须带 value,否则回调难以识别具体动作。需要改状态时优先更新原卡片,避免重复刷屏。危险操作按钮用 danger 类型。发卡片前先确认 receive_id_type 与 receive_id 匹配。若 system-token 返回 JSON,不要整段塞进请求头,只取 accessToken。资料未提供其他平台支持、收费或价格信息。