飞书导出

把飞书内容导出成本地文件。读文档到 Markdown 也可以用 feishu-cli-read；本技能更偏“落盘/下载素材/导出文件格式”。

路由

输入	命令
`/docx/<id>` 或 document_id	`feishu-cli doc export`
`/wiki/<token>` 或 node_token	`feishu-cli wiki export`
`/sheets/<token>` 或 spreadsheet_token	`feishu-cli sheet export --format markdown`
需要 PDF/Word/Excel 文件	`feishu-cli doc export-file` 或 `feishu-cli drive export`

sheet export 支持直接传 /sheets/<token> URL。wiki export 会根据节点类型导出 docx 或 sheet。

Markdown 导出

# 普通文档
feishu-cli doc export <document_id> --output /tmp/doc.md

# 知识库节点
feishu-cli wiki export <node_token_or_url> --output /tmp/wiki.md

# 普通电子表格
feishu-cli sheet export <spreadsheet_token_or_url> --format markdown -o /tmp/sheet.md

CLI 默认输出行为不同，skill 执行时建议显式传输出路径：

命令	未传输出路径时
`doc export`	打印到 stdout
`wiki export`	保存到 `/tmp/<title>.md`
`sheet export`	保存为 `<spreadsheet_token>.<format>`

doc export 专属参数

feishu-cli doc export <document_id> \
  --output /tmp/doc.md \
  --download-images \
  --assets-dir /tmp/assets \
  --front-matter \
  --highlight \
  --expand-mentions \
  --expand-sheets

参数	说明
`--download-images`	下载图片和画板缩略图并改写 Markdown 引用
`--assets-dir`	素材保存目录
`--front-matter`	添加 YAML front matter
`--highlight`	保留文本颜色/背景色为 HTML span
`--expand-mentions`	展开 @用户为友好名称
`--expand-sheets`	默认 true；把文档内嵌电子表格块展开成 Markdown 表格，false 时保留 `<sheet .../>`

--front-matter、--highlight、--expand-mentions、--expand-sheets 只属于 doc export，不要传给 wiki export。

Sheet Markdown

# 导出所有可见工作表
feishu-cli sheet export <token_or_url> --format markdown -o /tmp/sheet.md

# CSV 必须指定 sheet-id
feishu-cli sheet export <token_or_url> --format csv --sheet-id <sheet_id> -o /tmp/sheet.csv

Markdown 输出会按工作表生成标题和表格。大表格用于阅读场景；需要保留公式/样式请导出 xlsx。

文件格式导出

feishu-cli doc export-file <doc_token> --type pdf -o /tmp/report.pdf
feishu-cli doc export-file <doc_token> --type docx -o /tmp/report.docx
feishu-cli doc export-file <sheet_token> --doc-type sheet --type xlsx -o /tmp/report.xlsx

参数	说明	默认
`--type`	`pdf` / `docx` / `xlsx`	必填
`--doc-type`	`docx` / `sheet` 等源文档类型	`docx`
`-o, --output`	输出路径	`<doc_token>.<type>`

长任务或需要 sub-id/resume 时使用 feishu-cli-drive 的 drive export。

本地文件导入提醒

doc import-file 属于“本地文件导入为云文档”，不属于导出；简单格式如下：

feishu-cli doc import-file report.docx --type docx --name "季度报告"

更推荐的异步导入、大小限制和 resume 能力见 feishu-cli-drive。

验证

导出后检查文件存在且大小大于 0。
Markdown 场景读前 40 行确认标题、表格、图片路径是否合理。
下载素材时确认 assets-dir 下有对应文件；wiki 批量导出时注意同名素材覆盖风险。

feishu-cli-export