feishu-cli-export

Name: feishu-cli-export
Author: riba2534

INSTALLATION

npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-export

Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

飞书导出

把飞书内容导出成本地文件。读文档到 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 批量导出时注意同名素材覆盖风险。