核心用法
feishu-docs 是一款面向 Claude Code 的飞书云文档管理 Skill，通过封装飞书开放平台 API，实现文档的读取、创建、更新、删除及批量导入导出操作。核心功能覆盖六大场景：
文档读取：支持获取原始 JSON 结构、Markdown 渲染文本或纯文本格式，同时提供 get-blocks 命令获取文档块级结构化数据，便于程序化处理。
文档创建与管理：create 命令可创建空白文档或从本地 Markdown 文件直接生成；update 支持覆盖或追加两种模式；delete 需强制确认防止误操作。
文件导入导出：import-file 是核心差异化能力，支持 txt、docx、xlsx、csv、md 等格式一键导入为飞书文档或电子表格，并内置任务轮询机制处理大文件转换。
目录浏览：list 命令可遍历云空间文件夹结构，支持根目录或指定文件夹 token 查询。
显著优点
1. 原生飞书生态整合：直接调用飞书官方 Open API，数据流转无需第三方中转，兼容飞书文档原生格式（区块、样式、权限）。
2. 多格式互操作：打破飞书与本地工作流的格式壁垒，Markdown 用户可无缝迁移存量文档，CSV/Excel 数据可快速转为在线表格协作。
3. Claude Code 深度集成：设计初衷即为 AI 编程助手场景，支持在对话中直接调用文档操作，适合代码注释同步、技术文档维护、会议纪要整理等自动化任务。
4. MIT 开源许可：代码托管于 GitHub，社区可审计、可 fork，降低供应商锁定风险。
潜在局限
- 企业级权限门槛：需自建飞书应用并申请
docx:document、drive:drive等 5 项权限，个人用户配置流程较复杂。 - Node.js 运行时依赖：要求本地预装 Node 环境，对纯 Python 或容器化环境用户不够友好。
- 导入转换非实时：大文件导入需轮询等待飞书服务端转换，极端场景下可能超时。
- 文档 token 人工管理：
doccxxx和foldxxx标识需用户自行记录，缺乏可视化文件浏览器。
适合人群
- 研发团队：需将技术文档、API 文档与飞书知识库双向同步的开发者。
- 自动化办公场景：希望用 Claude Code 批量处理会议纪要、周报、项目文档的职场用户。
- 数据迁移需求者：从 Notion、Confluence 等工具向飞书迁移的 Markdown/Excel 存量数据持有者。
常规风险
- 凭证泄露风险：
FEISHU_APP_SECRET需写入.env文件，若提交至版本控制或共享环境可能导致企业数据泄露。建议配合.env.example模板与 gitignore 规范使用。 - 误删除不可逆：
delete --force无回收站二次确认，操作前建议先get备份关键文档。 - 权限范围过宽：申请权限包含租户级访问，需评估自建应用的最小权限原则。