Calico BGP 网络模型生产实践
2026/6/26 2:23:39
为什么需要这个插件？
飞书文档协作方便，但深度编辑和知识管理体验远不如 Obsidian。很多知识工作者日常面临两难：
- 只飞书：文档散落各处，缺乏双向链接和图谱，知识难以体系化
- 只 Obsidian：团队协作不便，移动端访问受限，无法与同事共享
- 两边手动搬：改一处要同步两处，迟早会遗漏，最终版本混乱
Feishu Sync的出现，就是为了终结这个困境。
✨ 核心功能一览
🔄 真正的双向同步
不是简单的导入导出，而是增量双向同步：
- 在 Obsidian 新建/编辑的笔记 → 自动上传到飞书知识库
- 在飞书修改的文档 → 自动下载到 Obsidian Vault
- 只同步有变更的文件，不做无用功
支持三种同步方向，按需选择：
| 模式 | 适用场景 |
|---|---|
| 双向同步 | 日常使用，两边改动都能同步 |
| 仅下载（飞书→Obsidian） | 把飞书当内容源，Obsidian 只读 |
| 仅上传（Obsidian→飞书） | 用 Obsidian 写作，飞书做展示 |
⚔️ 智能冲突处理
当同一篇文档在飞书和 Obsidian 都做了修改，插件会自动检测冲突，并提供三种解决策略：
- 飞书优先：以飞书版本为准，覆盖本地
- 本地优先：保留 Obsidian 版本，不上传远端
- 创建冲突副本：两份都保留，本地生成
.conflict副本，由你决定取舍
📋 Frontmatter 元数据追踪
每篇同步的文档会自动注入飞书元数据：
--- |
feishu_node_token: "xxx" |
feishu_obj_token: "xxx" |
feishu_space_id: "xxx" |
feishu_last_modified: "2026-05-17T..." |
feishu_sync_version: 1 |
--- |
无需额外数据库，文件本身即映射关系，透明可控。
🔄 自动更新
基于 Gitee Releases 的插件自动更新机制，启动时自动检查新版本，一键升级，无需手动下载。
🚀 三步完成配置
插件的设置页面采用引导式设计，三步即可上手：
Step 1：安装 lark-cli
lark-cli 是飞书官方命令行工具，插件通过它与飞书交互：
npm install -g @larksuite/cli |
安装后点击「检查」，插件会自动检测是否安装成功。
Step 2：配置凭据并登录
- 前往飞书开放平台创建应用，获取 App ID 和 App Secret
- 在插件设置中填入凭据，点击「配置并登录」
- 浏览器自动弹出授权页面，扫码确认即可
整个 OAuth 设备授权流程内嵌在插件中，无需手动复制 token。
Step 3：选择知识库并同步
填入飞书知识库的 Space ID（从知识库设置页面 URL 中获取），配置同步方向和冲突策略，点击侧边栏同步图标即可开始。
🎯 典型使用场景
场景一：个人知识管理
用 Obsidian 做深度笔记和知识图谱，同时自动同步到飞书知识库，手机上随时查阅。Obsidian 的双向链接、标签体系与飞书的协作能力完美互补。
场景二：团队文档协作
团队在飞书上协作编辑，你用 Obsidian 本地深度整理和加工，修改后自动同步回飞书。既享受 Obsidian 的编辑体验，又不脱离团队工作流。
场景三：文档备份与迁移
将飞书知识库全量同步到 Obsidian Vault，本地保留完整备份。从此不再担心平台数据丢失，随时可以迁移。
🛡️ 技术架构：为什么选择 lark-cli？
Feishu Sync 没有直接调用飞书 REST API，而是基于飞书官方的 lark-cli 命令行工具作为中间层。这个架构选择带来几个关键优势：
- 认证统一管理：OAuth 设备授权流程由 lark-cli 处理，插件无需自行管理 token 刷新
- API 变更无感：飞书 API 升级时只需更新 lark-cli，插件代码无需改动
- 可独立调试：遇到问题可以直接在终端用 lark-cli 命令排查，定位问题更高效
- 官方维护：lark-cli 由飞书官方维护，API 兼容性有保障
💻 跨平台支持
插件特别针对 Windows 环境做了大量兼容处理：
- 自动查找系统 Node.js（支持 fnm、nvm 等版本管理器）
- 解析 npm
.cmd包装器，直接调用 node.exe 运行，绕过编码和 stdin 问题 - 临时文件存放在 Vault 目录内，不写入系统用户目录
macOS 和 Linux 同样支持，通过 login shell 执行确保 PATH 正确。