← 返回 Skills 市场
technologyliu

Feishu Doc Batch Export

作者 TechnologyLiu · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
84
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install feishu-doc-batch-export
功能描述
批量导出飞书文档(docx)到本地Markdown格式,支持保留文档格式、图片、链接,支持指定文件夹/文档链接批量导出。触发场景:当用户需要导出飞书文档、批量下载飞书文档、飞书文档转Markdown时使用。
使用说明 (SKILL.md)

飞书文档批量导出技能

核心功能

  1. 支持单个文档导出:输入飞书文档链接,直接导出为Markdown文件
  2. 支持文件夹批量导出:输入飞书文件夹链接,导出文件夹下所有docx文档
  3. 自动保留格式:标题、列表、表格、粗体、斜体、链接格式完全保留
  4. 自动下载图片:文档内图片自动下载到本地assets目录,Markdown内路径自动替换
  5. 错误重试:导出失败自动重试3次,支持导出日志输出

使用方法

基本命令

# 导出单个文档
python scripts/export.py --url \x3C飞书文档链接> --output \x3C本地输出目录>

# 导出文件夹下所有文档
python scripts/export.py --url \x3C飞书文件夹链接> --output \x3C本地输出目录> --recursive

参数说明

  • --url: 飞书文档/文件夹的公开链接或有权限访问的链接
  • --output: 本地导出目录,默认当前目录下的feishu_export文件夹
  • --recursive: 是否递归导出子文件夹内容,默认false
  • --keep-html: 是否同时保留原始HTML文件,默认false

依赖要求

提前配置飞书应用权限:

  1. 飞书自建应用需要开通docx:readonlydrive:readonly权限
  2. 环境变量配置FEISHU_APP_IDFEISHU_APP_SECRET

注意事项

  • 仅支持docx格式的飞书文档,不支持表格、思维笔记、幻灯片等其他格式
  • 导出速度受飞书API限制,每分钟最多导出10个文档
  • 大文档导出时间较长,请耐心等待
安全使用建议
This skill contains code that calls Feishu APIs and requires FEISHU_APP_ID and FEISHU_APP_SECRET (the registry metadata failing to declare these is a red flag). Before installing or running: (1) do not supply production admin credentials — create a dedicated Feishu app with only docx:readonly and drive:readonly and limited scope for testing; (2) verify the code yourself (scripts/export.py is short) or run it in an isolated environment/container; (3) note that folder/recursive export is advertised but not implemented — expect single-document export only; (4) if you will provide app secrets, prefer rotating secrets and revoke the test app after use; (5) ask the publisher to correct registry metadata and SKILL.md to accurately reflect current functionality, and only proceed if you trust the code or have audited it.
功能分析
Type: OpenClaw Skill Name: feishu-doc-batch-export Version: 1.0.0 The skill is a legitimate utility for exporting Feishu (Lark) documents to Markdown format. The core logic in `scripts/export.py` uses official Feishu APIs to fetch document content and images, handling authentication securely via environment variables. While the documentation in `SKILL.md` claims support for folder exports that are not yet implemented in the script, the existing code is functional for single documents and contains no signs of malicious intent, data exfiltration, or harmful instructions.
能力评估
Purpose & Capability
The stated purpose (Feishu doc batch export) is consistent with the included code: scripts/export.py calls the Feishu API to fetch documents and images and convert HTML to Markdown. However the package metadata/registry claims no required environment variables while both SKILL.md and the code require FEISHU_APP_ID and FEISHU_APP_SECRET. Also the README/description advertises folder/batch export and recursive export but the script explicitly prints that folder export is 'under development' — advertised capabilities do not match the implementation.
Instruction Scope
SKILL.md instructs the agent/user to set FEISHU_APP_ID and FEISHU_APP_SECRET and to run python scripts/export.py. The runtime instructions do not ask for unrelated files or secrets beyond the Feishu app creds, and network calls are limited to Feishu endpoints and image URLs. However SKILL.md shows CLI flags (--recursive, folder export) that the implemented main() does not support; that's scope creep/false promise in the instructions.
Install Mechanism
No install spec is provided (instruction-only + included code). Dependencies are minimal and listed in requirements.txt (requests, markdownify). Nothing is downloaded from arbitrary URLs or installed silently — lowest-risk install mechanism, but code will perform network I/O at runtime.
Credentials
The code legitimately requires FEISHU_APP_ID and FEISHU_APP_SECRET to call the Feishu API (proportionate for the claimed functionality). The problem is the registry metadata lists no required environment variables or primary credential, which is inconsistent and risks surprising users into supplying credentials without clear disclosure in the registry entry.
Persistence & Privilege
The skill does not request elevated privileges or permanent/always-on presence. always:false and default autonomous invocation are normal. The skill does not modify other skills or system-wide agent settings.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install feishu-doc-batch-export
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /feishu-doc-batch-export 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release: support batch export Feishu docx documents to Markdown format, retain formatting and images
元数据
Slug feishu-doc-batch-export
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Feishu Doc Batch Export 是什么?

批量导出飞书文档(docx)到本地Markdown格式,支持保留文档格式、图片、链接,支持指定文件夹/文档链接批量导出。触发场景:当用户需要导出飞书文档、批量下载飞书文档、飞书文档转Markdown时使用。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 84 次。

如何安装 Feishu Doc Batch Export?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install feishu-doc-batch-export」即可一键安装,无需额外配置。

Feishu Doc Batch Export 是免费的吗?

是的,Feishu Doc Batch Export 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Feishu Doc Batch Export 支持哪些平台?

Feishu Doc Batch Export 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Feishu Doc Batch Export?

由 TechnologyLiu(@technologyliu)开发并维护,当前版本 v1.0.0。

💬 留言讨论