leemysw/feishu-docx

说明与用途

**项目简介（2‑3 句话）**
leemysw/feishu‑docx 是一款基于 OAuth 2.0 的开源工具，能够在飞书（Feishu/Lark）文档、表格、Bitable 与 Markdown 之间自由导入导出，并提供 CLI、TUI 与 Claude AI Skills 支持，适配 AI Agent 场景。它让企业内部知识库可以以 Markdown 形式存储，从而更易于索引、搜索和在对话式 AI 中使用。

**价值**

• **知识可搜索、可复用**：将飞书文档统一转为结构化的 Markdown，方便向向量数据库或搜索引擎喂入，实现 RAG（Retrieval‑Augmented Generation）与智能客服的知识检索。
• **AI Agent 友好**：导出的 Markdown 保留标题层级、表格、图片等元信息，天然适配 LLM 的上下文加载与提示工程。
• **统一管理**：通过统一的 CLI/TUI，可批量同步、增量更新或回写文档，降低手工维护成本。

**典型接入方式**

1. **OAuth2.0 鉴权**：在飞书开放平台创建应用，获取 app_id、app_secret 并配置回调 URL；使用项目提供的 feishu-auth 命令行完成授权并缓存 token。
2. **CLI 使用**：

   feishu-docx export --type doc --id 1234567890 --out ./docs/project.md
   feishu-docx import --type doc --id 1234567890 --in ./updates/patch.md

支持批量、增量和指定时间范围的同步。

1. **TUI（交互式终端）**：运行 feishu-docx tui 进入图形化列表，可直接勾选文档/表格进行导入导出，适合非技术用户。
2. **Claude Skills / API 调用**：项目提供 feishu_docx_skill.py，可在 Anthropic Claude 中注册为自定义 Skill，实现“读取飞书文档并写入 Markdown” 的自然语言指令。
3. **Python SDK**：在自定义脚本或微服务中 import feishu_docx as fdx，调用 fdx.export_doc(doc_id)、fdx.import_doc(doc_id, markdown) 完成业务流程自动化。

**生产可用性**

• **活跃度**：截至 2026‑06‑29，项目最近一次提交，星标 228，fork 31，Issue/PR 交互活跃，表明社区和维护者仍在持续迭代。
• **技术成熟度**：核心实现基于飞书官方 SDK（Python），已封装错误重试、分页、速率限制等生产必备特性；CLI/TUI 经过多轮用户反馈优化，使用体验稳定。
• **安全合规**：采用 OAuth 2.0 标准授权，所有凭证均在本地加密存储；项目 MIT 许可证，适合企业内部闭源或开源使用。
• **部署成本**：仅需 Python 3.9+ 环境和飞书应用的 API 权限，无额外服务依赖，可在 CI/CD、容器或服务器上即插即用。

综合来看，leemysw/feishu-docx 已具备 **高生产就绪度**，适合作为企业内部知识库的 Markdown 同步层，快速为 RAG、搜索和 AI 助手提供可靠的文档来源。

实际用途

leemysw/feishu-docx helps make internal knowledge searchable and usable by assistants.

• index knowledge bases
• improve search over documents
• ground assistant answers

限制与审查说明

High for an OSS candidate: recent activity, adoption, and ecosystem signals are strong enough for a serious pilot.