基于飞书开放平台的Wiki批量导出工具，支持递归同步与增量更新，实现知识库本地备份与版本管理。
说明：
Lark Suite Wiki 是一款专为飞书（Lark/Feishu）知识库设计的 Python CLI 工具，旨在解决企业Wiki数据本地备份与格式迁移的核心痛点。该工具通过调用飞书开放平台的官方 API，实现了从单文档读取到全量知识库递归导出的完整功能链条。
**核心用法**：用户需在飞书开放平台创建应用并获取 `LARK_APP_ID` 和 `LARK_APP_SECRET`，通过环境变量配置凭证后，即可使用 `sync` 命令进行全量或增量同步。工具支持树形结构展示 (`tree`)、单文档导出 (`export`) 和智能增量同步 (`sync –force`)，自动将飞书文档转换为 Markdown 格式并保留原始目录层级结构，生成带数字前缀的文件夹命名体系。
**显著优点**：首先，**增量同步机制**是最大亮点，通过本地 `.lark-sync-state.json` 文件记录文档修订版本号，仅导出变更内容，大幅提升日常备份效率。其次，**递归子文档处理**能力可自动追踪嵌套链接，确保知识库完整性。第三，**纯本地化存储**设计确保数据隐私，所有内容导出至用户指定目录，无云端上传行为。第四，工具依赖精简，仅使用标准库与 requests，部署轻量。
**潜在缺点与局限**：代码中存在**硬编码 API 凭证**的安全瑕疵（第19-20行），虽优先读取环境变量，但默认值存在泄露风险。部分富文本块（如复杂表格、嵌入组件）可能无法完美转换为 Markdown 格式。对于包含数千页面的超大型 Wiki，全量同步耗时较长且可能触发 API 频率限制。此外，工具要求用户具备一定的飞书开放平台配置能力，上手门槛高于普通 GUI 工具。
**适合目标群体**：主要面向需要定期备份飞书知识库的内容管理员、技术文档工程师、希望将 Wiki 内容迁移至 Git 或静态站点生成器的技术团队，以及需要离线访问知识库的个人用户。特别适合有自动化备份需求的开发团队集成至 CI/CD 流程。
**使用风险**：除硬编码凭证问题外，用户需妥善保管 API 密钥，避免将 `.env` 文件提交至版本控制。同步操作依赖于飞书 API 的稳定性，网络波动可能导致同步中断。由于工具为个人开发者维护（T3来源），长期维护与更新承诺存在不确定性，建议关键业务场景做好替代方案准备。
会员专属
