为什么需要这个插件飞书文档协作方便但深度编辑和知识管理体验远不如 Obsidian。很多知识工作者日常面临两难只飞书文档散落各处缺乏双向链接和图谱知识难以体系化只 Obsidian团队协作不便移动端访问受限无法与同事共享两边手动搬改一处要同步两处迟早会遗漏最终版本混乱Feishu Sync的出现就是为了终结这个困境。✨ 核心功能一览 真正的双向同步不是简单的导入导出而是增量双向同步在 Obsidian 新建/编辑的笔记 → 自动上传到飞书知识库在飞书修改的文档 → 自动下载到 Obsidian Vault只同步有变更的文件不做无用功支持三种同步方向按需选择模式适用场景双向同步日常使用两边改动都能同步仅下载飞书→Obsidian把飞书当内容源Obsidian 只读仅上传Obsidian→飞书用 Obsidian 写作飞书做展示⚔️ 智能冲突处理当同一篇文档在飞书和 Obsidian 都做了修改插件会自动检测冲突并提供三种解决策略飞书优先以飞书版本为准覆盖本地本地优先保留 Obsidian 版本不上传远端创建冲突副本两份都保留本地生成.conflict副本由你决定取舍 Frontmatter 元数据追踪每篇同步的文档会自动注入飞书元数据---feishu_node_token: xxxfeishu_obj_token: xxxfeishu_space_id: xxxfeishu_last_modified: 2026-05-17T...feishu_sync_version: 1---无需额外数据库文件本身即映射关系透明可控。 自动更新基于 Gitee Releases 的插件自动更新机制启动时自动检查新版本一键升级无需手动下载。 三步完成配置插件的设置页面采用引导式设计三步即可上手Step 1安装 lark-clilark-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-cliFeishu 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 正确。