modbender Feishu Docs Skill
用于管理飞书云文档的 CLI 工具封装 skill。
功能
- get - 读取飞书文档内容（支持 JSON/Markdown/Text 格式）
- get-blocks - 获取文档块结构化数据
- create - 创建新文档（支持从文件导入内容）
- import-file - 将本地文件导入为飞书文档（支持 txt, docx, xlsx, csv, md 等）
- list - 列出文件夹内容
- delete - 删除文档
- update - 更新文档内容（覆盖或追加模式）
环境配置
需要在 .env 文件中配置以下环境变量：
FEISHU_APP_ID=cli_xxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxx
FEISHU_DOMAIN=https://open.feishu.cn
获取应用凭证
- 访问 https://open.feishu.cn/app
- 创建企业自建应用
- 在"凭证与基础信息"中获取 App ID 和 App Secret
- 在"权限管理"中添加以下权限：
docx:document- 查看、编辑、创建文档drive:drive- 查看、删除云空间文件drive:file- 上传文件drive:importTask- 导入文件为文档auth:tenant- 获取租户访问凭证
使用方式
读取文档
# 读取文档内容（JSON 格式）
node scripts/index.js get -d doccxxxxxxxxxxxxxx
# 读取并保存为 Markdown
node scripts/index.js get -d doccxxxxxxxxxxxxxx -o output.md --format markdown
# 获取文档块结构
node scripts/index.js get-blocks -d doccxxxxxxxxxxxxxx -o blocks.json
创建文档
# 创建空文档
node scripts/index.js create -f foldxxxxxxxxxxxxxx -t "我的文档"
# 从文件创建文档（自动转换 Markdown）
node scripts/index.js create -f foldxxxxxxxxxxxxxx -t "我的文档" --file content.md
导入本地文件
# 导入 Markdown 文件为飞书文档
node scripts/index.js import-file -f ./document.md --folder-token foldxxxxxxxxxxxxxx --type docx --ext md
# 导入为表格
node scripts/index.js import-file -f ./data.csv --folder-token foldxxxxxxxxxxxxxx --type sheet --ext csv
列出文件夹
# 列出根目录
node scripts/index.js list
# 列出指定文件夹
node scripts/index.js list --folder-token foldxxxxxxxxxxxxxx
更新文档
# 覆盖文档内容
node scripts/index.js update -d doccxxxxxxxxxxxxxx --file new-content.md
# 追加内容
node scripts/index.js update -d doccxxxxxxxxxxxxxx --content "追加的文本" --append
删除文档
# 删除文档（需要 --force 确认）
node scripts/index.js delete -d doccxxxxxxxxxxxxxx --force
注意事项
- 所有命令都需要先配置
.env文件中的环境变量 - 文档 token 以
docc开头，文件夹 token 以fold开头 - 导入大文件时需要等待转换完成，脚本会自动轮询任务状态
- 创建文档时，文档信息会保存到
doc-{documentId}.json文件中