返回更新记录
v0.7.7

飞书同步更可靠了 (v0.7.7)

稳定文档增量同步、安全增量游标、强制重同步与删除策略上线,大型协作空间的同步不再丢内容、不删错。

飞书来源同步健壮性

v0.7.4 让知识库接入了飞书,这一版把它打磨成可以在真实协作空间里长期运行的同步:内容变化按文档身份稳定增量更新,中断不会删错数据,超大文档和删除都按策略处理。

增量同步,而不是全量重跑

同步重写为基于稳定 Document 身份的增量流程:

  • 同一飞书文档在多次同步间复用身份,内容哈希未变就跳过,不再重复创建 revision。
  • 删除由快照完整性把关:只有完整列举成功的快照才会执行删除并推进游标,部分列举(限流、分页失败)保留已有数据,不丢内容。
  • 游标基于文档 EditTime 的成功前缀计算,确保同步进度不会越过尚未处理完成的节点。

强制重同步

需要重新拉取整个知识库时,可以通过 force 同步绕过增量判断:force 意图会与已有同步请求合并并复用任务,不会重复入队;任务运行期间再次标记 force,会在当前任务结束后自动接续一次,不会丢失请求。

删除策略与对象清理

删除飞书文档时可以按知识库配置选择保留或移除:

  • 移除策略会把原始对象、解析产物与图片资产分批异步删除,已删除的 Job 重复执行直接跳过。
  • 保留策略下文档被检索和统计排除,但不会删除底层对象。
  • folder 按外部 ID 级联清理,空目录在同一轮同步内回收,不再需要多次同步才能清空。

边界与稳定

  • 文档内容超过上限(默认 50 MiB)时,新文档不落库、已有文档保留旧版本,同步不会因为单个超大文档中断。
  • 同步任务终态推进幂等,asynq 重试已终结任务不会重复执行同步或创建重复后续任务。
  • MCP 的 knowledge_search 工具标注为只读、无副作用,客户端可以更放心地调用;API Key 表单补全 knowledge_bases 读取权限,scope 前后端契约对齐。