飞书导出
把飞书内容导出成本地文件。读文档到 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.mdCLI 默认输出行为不同，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.csvMarkdown 输出会按工作表生成标题和表格。大表格用于阅读场景；需要保留公式/样式请导出 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 批量导出时注意同名素材覆盖风险。
