rongshu/.agents/skills/lark-doc/references/lark-doc-media-download.md

docs +media-download（下载文档素材/画板缩略图）

前置条件： 先阅读 ../lark-shared/SKILL.md 了解认证、全局参数和安全规则。

下载文档中的图片/文件素材（file_token），或下载画板缩略图（whiteboard_id）。当 --output 不带扩展名时，会根据响应的 Content-Type 自动补全扩展名。

选择规则

• 用户明确说“下载素材”时，使用 docs +media-download
• 用户只是想查看、预览图片或文件素材时，优先使用 docs +media-preview
• 如果目标明确是画板 / whiteboard / 画板缩略图，继续使用 docs +media-download --type whiteboard；+media-preview 不支持画板

命令

# 下载图片/文件素材（默认 type=media）
lark-cli docs +media-download --token "Z1Fjxxxxxxxx" --output ./asset

# 指定输出文件名（带扩展名则不会自动补全）
lark-cli docs +media-download --token "Z1Fjxxxxxxxx" --output ./asset.png

# 下载画板缩略图（whiteboard token）
lark-cli docs +media-download --type whiteboard --token "wbcnxxxxxxxx" --output ./whiteboard

参数

参数	必填	说明
--token <token>	是	资源 token：素材为 file_token，画板为 whiteboard_id
--output <path>	是	本地保存路径；不带扩展名会自动补全
--type <type>	否	media（默认）或 whiteboard

token 从哪里来

• 若你是从文档内容里提取：lark-doc-fetch 返回的 Markdown 里可能包含：
  • 图片：<image token="..." .../>
  • 文件：<file token="..." name="..."/>
  • 画板：<whiteboard token="..."/>

排障

• 如果报错返回的信息包含 HTTP 403，且目标是图片/文件素材，可以改成调用 docs +media-preview 看是否能先预览内容

参考

• lark-doc-fetch — 获取文档内容（用于提取 token）
• lark-doc-media-preview — 预览素材
• lark-shared — 认证和全局参数