上传素材到飞书多维表格（获取 file_token）#

与官方 lark-* Skill 的定位#

场景工具上传附件直接写入记录lark-cli base +record-upload-attachment上传文件到云空间lark-cli drive +upload上传素材获取独立 file_token****本 Skill

lark-cli 不覆盖 /drive/v1/medias/ 素材接口，本 Skill 填补该空白。 获取到的 file_token 可用于后续写入多维表格附件字段。

依赖#

• bash, curl, python3, dd — macOS/Linux 均内置
• 飞书 App 凭证（App ID + App Secret）

脚本#

scripts/feishu_upload.sh

用法#

bash

# 参数模式
bash scripts/feishu_upload.sh <文件> --parent-node <APP_TOKEN> \
  --app-id <APP_ID> --app-secret <APP_SECRET>

# 环境变量模式
export FEISHU_PARENT_NODE=<APP_TOKEN>
export FEISHU_APP_ID=<APP_ID>
export FEISHU_APP_SECRET=<APP_SECRET>
bash scripts/feishu_upload.sh <文件>

--parent-type 可选（默认 bitable_file）：图片附件用 bitable_image。

成功后输出 file_token: boxcnrHpsg1QDqXAAAyachabcef

自动选择上传方式#

文件大小上传方式API≤ 20MB直接上传POST /drive/v1/medias/upload_all> 20MB分片上传upload_prepare → upload_part × N → upload_finish

upload_all API 硬限制 20MB，超过必须分片（分片大小 4MB，由服务端返回）。

常见错误#

错误码原因解决1061004无权限确认应用有 bitable:app 权限且对目标表有编辑权限1061044parent_node 不存在检查多维表格 App Token 是否正确1061043文件超限检查文件大小是否符合飞书限制1061005Token 无效检查 App ID / Secret 是否正确