飞书多维表格附件上传

要解决什么问题

在飞书（Lark）多维表格里，附件字段不能直接塞本地路径或 IM 里的 file_key：素材要走 material 上传（parent_type=bitable_file），拿到 file_token 后才能写入记录的附件列。手工调 Open API、分片上传和大文件阈值，很容易在「表/字段/记录」定位上踩坑。

技能如何工作

本技能按固定流水线处理任意你有权限的 Bitable（不写死 app_token、表名或字段）：

1. 取源文件：local 本地路径、url HTTP(S) 下载，或 feishu_message 用消息附件的 file_key 拉取。
2. 上传素材：≤20MB 直传；>20MB 走 5MB 分片的 chunked_upload（prepare → 分片 → finish），得到 file_token。
3. 写回记录：创建或更新记录中的附件字段；append=true 时在现有附件列表后追加，false 则仅保留本次文件。

目标解析支持 ID 优先、名称回退：表用 table_id 或 table_name 列举匹配；字段用 field_id 或 field_name；记录用 record_id、按 lookup 查字段值，或省略两者新建行（allow_create_if_lookup_missing 可控制查无结果时是否创建）。

适用边界与注意点

• 需正确配置 FEISHU_APP_ID / FEISHU_APP_SECRET 及应用对目标多维表格与上传接口的权限；鉴权或上传失败会表现为 auth_error、upload_error。
• Drive/IM 返回的 token 不能直接当 Bitable 附件用，必须经本技能所述 bitable 上传点（详见资料中的 API 说明）。
• 表/字段列举、记录筛选等响应格式若与文档不一致，需在真实租户环境里核对；本地已通过语法与入参校验，但部分 API 行为仍依赖线上验证。