{"skill":{"slug":"feishu-docs-v2","displayName":"Feishu Docs","summary":"飞书文档管理工具，支持读取、创建、更新、删除飞书文档，导入本地文件为飞书文档，以及列出文件夹内容。用于在 Claude Code 中管理飞书云文档。","description":"---\nname: feishu-docs\ndescription: 飞书文档管理工具，支持读取、创建、更新、删除飞书文档，导入本地文件为飞书文档，以及列出文件夹内容。用于在 Claude Code 中管理飞书云文档。\nlicense: MIT\nmetadata:\n  author: feishu-docs\n  version: \"1.0.0\"\n  openclaw:\n     requires:\n        env:\n           - FEISHU_APP_ID\n           - FEISHU_APP_SECRET\n        bins:\n           - node\n     homepage: https://github.com/upupc/feishu-docs\n---\n\n# Feishu Docs Skill\n\n用于管理飞书云文档的 CLI 工具封装 skill。\n\n## 功能\n\n- **get** - 读取飞书文档内容（支持 JSON/Markdown/Text 格式）\n- **get-blocks** - 获取文档块结构化数据\n- **create** - 创建新文档（支持从文件导入内容）\n- **import-file** - 将本地文件导入为飞书文档（支持 txt, docx, xlsx, csv, md 等）\n- **list** - 列出文件夹内容\n- **delete** - 删除文档\n- **update** - 更新文档内容（覆盖或追加模式）\n\n## 环境配置\n\n需要在 `.env` 文件中配置以下环境变量：\n\n```\nFEISHU_APP_ID=cli_xxxxxxxxxx\nFEISHU_APP_SECRET=xxxxxxxxxx\nFEISHU_DOMAIN=https://open.feishu.cn\n```\n\n### 获取应用凭证\n\n1. 访问 https://open.feishu.cn/app\n2. 创建企业自建应用\n3. 在\"凭证与基础信息\"中获取 App ID 和 App Secret\n4. 在\"权限管理\"中添加以下权限：\n   - `docx:document` - 查看、编辑、创建文档\n   - `drive:drive` - 查看、删除云空间文件\n   - `drive:file` - 上传文件\n   - `drive:importTask` - 导入文件为文档\n   - `auth:tenant` - 获取租户访问凭证\n\n## 使用方式\n\n### 读取文档\n\n```bash\n# 读取文档内容（JSON 格式）\nnode scripts/index.js get -d doccxxxxxxxxxxxxxx\n\n# 读取并保存为 Markdown\nnode scripts/index.js get -d doccxxxxxxxxxxxxxx -o output.md --format markdown\n\n# 获取文档块结构\nnode scripts/index.js get-blocks -d doccxxxxxxxxxxxxxx -o blocks.json\n```\n\n### 创建文档\n\n```bash\n# 创建空文档\nnode scripts/index.js create -f foldxxxxxxxxxxxxxx -t \"我的文档\"\n\n# 从文件创建文档（自动转换 Markdown）\nnode scripts/index.js create -f foldxxxxxxxxxxxxxx -t \"我的文档\" --file content.md\n```\n\n### 导入本地文件\n\n```bash\n# 导入 Markdown 文件为飞书文档\nnode scripts/index.js import-file -f ./document.md --folder-token foldxxxxxxxxxxxxxx --type docx --ext md\n\n# 导入为表格\nnode scripts/index.js import-file -f ./data.csv --folder-token foldxxxxxxxxxxxxxx --type sheet --ext csv\n```\n\n### 列出文件夹\n\n```bash\n# 列出根目录\nnode scripts/index.js list\n\n# 列出指定文件夹\nnode scripts/index.js list --folder-token foldxxxxxxxxxxxxxx\n```\n\n### 更新文档\n\n```bash\n# 覆盖文档内容\nnode scripts/index.js update -d doccxxxxxxxxxxxxxx --file new-content.md\n\n# 追加内容\nnode scripts/index.js update -d doccxxxxxxxxxxxxxx --content \"追加的文本\" --append\n```\n\n### 删除文档\n\n```bash\n# 删除文档（需要 --force 确认）\nnode scripts/index.js delete -d doccxxxxxxxxxxxxxx --force\n```\n\n## 注意事项\n\n1. 所有命令都需要先配置 `.env` 文件中的环境变量\n2. 文档 token 以 `docc` 开头，文件夹 token 以 `fold` 开头\n3. 导入大文件时需要等待转换完成，脚本会自动轮询任务状态\n4. 创建文档时，文档信息会保存到 `doc-{documentId}.json` 文件中\n","tags":{"latest":"0.1.3"},"stats":{"comments":0,"downloads":1761,"installsAllTime":66,"installsCurrent":6,"stars":3,"versions":4},"createdAt":1770823905893,"updatedAt":1778487899210},"latestVersion":{"version":"0.1.3","createdAt":1771334939722,"changelog":"Version 0.1.3\n\n- No changes detected in the current release.\n- All features, documentation, and configuration instructions remain the same as the previous version.","license":null},"metadata":{"setup":[{"key":"FEISHU_APP_ID","required":true},{"key":"FEISHU_APP_SECRET","required":true}],"os":null,"systems":null},"owner":{"handle":"upupc","userId":"s17439q4cqy7w4mepf1htey0z983pwrr","displayName":"upupc","image":"https://avatars.githubusercontent.com/u/12829489?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779971038823}}