什么是Feishu Doc Sync
飞书文档同步工具（Feishu Doc Sync）是一款专为高效管理飞书文档内容而设计的自动化操作工具，核心功能覆盖文档的创建、读取、更新与结构化数据同步。该工具通过统一的 `feishu_doc` 接口支持多种文档操作模式，包括全文替换、增量追加、精准插入等，并能处理富文本格式如标题、列表、代码块、链接及内嵌表格。特别适用于需要将本地 Markdown 文件或结构化数据批量同步至飞书文档的场景，同时支持图片和附件上传，确保内容与样式完整保留。其底层采用三阶段差异比对算法（UPDATE→DELETE→INSERT），在保证一致性的前提下优化同步效率，避免因频繁全量写入导致的性能损耗。
核心功能特点
- 支持文档的创建、读取、全文替换、增量追加和指定位置插入内容，兼容 Markdown 语法与表格结构
- 提供表格专用操作：新建带表头的表格、单元格批量写入、行列增删及合并，支持列宽自适应算法
- 内置三阶段 diff 同步策略，自动判断变更比例并选择最优同步方式（增量或全量）
- 可上传本地或网络图片/文件，支持基于像素尺寸的智能缩放与精准定位插入
- 严格遵循飞书 API 规范，确保权限控制（需传入 owner_open_id 实现用户自动授权）
适用场景
该工具主要面向需要长期维护知识库、项目文档或团队协作内容的开发者与运营人员。例如，在 CI/CD 流程中，可将构建日志、测试报告通过 Markdown 表格形式自动同步到飞书文档，替代手动粘贴；对于技术团队而言，每次代码提交后可触发脚本将变更摘要插入指定文档位置，形成可追溯的更新记录。当处理大量重复性内容（如周报模板、会议纪要）时，利用其增量同步机制可显著减少 API 调用次数，提升执行效率。此外，若需将 Excel 数据迁移为飞书表格并保持格式（如高亮表头），可通过 create_table_with_values 结合 header_row 参数一步完成，避免逐格编辑。尤其适合那些依赖版本控制系统（Git）且希望实现‘本地编辑—自动推送—云端展示’闭环的工作流。