惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

Y
Y Combinator Blog
有赞技术团队
有赞技术团队
J
Java Code Geeks
H
Hackread – Cybersecurity News, Data Breaches, AI and More
美团技术团队
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
Hugging Face - Blog
Hugging Face - Blog
人人都是产品经理
人人都是产品经理
酷 壳 – CoolShell
酷 壳 – CoolShell
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
C
Check Point Blog
博客园 - 【当耐特】
The GitHub Blog
The GitHub Blog
Recent Announcements
Recent Announcements
The Cloudflare Blog
Microsoft Azure Blog
Microsoft Azure Blog
腾讯CDC
Vercel News
Vercel News
IT之家
IT之家
MyScale Blog
MyScale Blog
博客园_首页
Martin Fowler
Martin Fowler
WordPress大学
WordPress大学
罗磊的独立博客

博客园_首页

Plist 二进制格式 Milvus 和 PGVector,哪个更好? OpenClaw 已过时?在 VS Code 中运行 Hermes Agent! 第30篇文章:一个大三计科生的自白 Manim如何在数学公式中完美显示中文? Docker 部署 RocketMQ 5 并发编程核心概念辨析 C#事务处理最佳实践:别再让“主表存了、明细丢了”的破事发生 CLI 是什么?为什么大厂突然集体卷命令行? 【从0到1构建一个ClaudeAgent】协作-自主Agent UIImageView 设置图片不生效的原因排查 最小二乘问题详解20:无先验约束下的增量式SFM自由网平差 痞子衡嵌入式:大话双核i.MXRT1180之XIP应用里借助MU实现可靠Flash IAP的方法 AI Chat 封装, SemanticKerne.AiProvider.Unified 已发布 Windows下右键编辑js文件无法打开记事本——在注册表中使用环境变量 在后台服务中使用 Scoped 服务,为什么总是报错? H200 安装驱动并使用sglang启动模型 wireshark 抓包Trap上报告警内容 我用 AI 辅助开发了一系列小工具(2):图片压缩工具 [A Primer On MC and CC] 2.1 Memory Consistency 1 - 指令重排序和 SC 模型 Oracle数据库SCN推进技术详解与实践指南 玩转控件:封装个带图片的Label控件 Claude Code 4.7 真正该升级的不是模型,而是你的工作流 前端小白一句话,AI 帮我做了个颜值拉满的桌面媒体播放器。当代码不再是门槛,一句话编程就是现实。 5. WorkBuddy: 小龙虾的灵魂三件套,让你的小龙虾不只是工具 SQLite 分片方案实战:三种分片策略的深度对比 告别简陋 UI!一款基于 Fluent Design 和基于 WinUI 的开源免费、现代化的 Avalonia UI 控件库 关于二进制排列组合枚举的总结 AI开发-python-LangGraph框架(3-27-LangGraph从零实现大模型智能决策工作流) ElasticSearch主分片和副本分片概念详解
用 Obsidian 管理飞书知识库?这个插件让双向同步成为现实
Nil&Null · 2026-05-17 · via 博客园_首页

你是否也在经历这样的痛苦:飞书文档越来越多,想用 Obsidian 整理却只能手动复制粘贴?改了这边忘改那边,版本混乱到怀疑人生?

今天给大家介绍一个开源 Obsidian 插件——Feishu Sync,它能让你的 Obsidian Vault 和飞书知识库真正实现双向同步。


🤔 为什么需要这个插件?

飞书文档协作方便,但深度编辑和知识管理体验远不如 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:配置凭据并登录

  1. 前往飞书开放平台创建应用,获取 App ID 和 App Secret
  2. 在插件设置中填入凭据,点击「配置并登录」
  3. 浏览器自动弹出授权页面,扫码确认即可

整个 OAuth 设备授权流程内嵌在插件中,无需手动复制 token。

Step 3:选择知识库并同步

填入飞书知识库的 Space ID(从知识库设置页面 URL 中获取),配置同步方向和冲突策略,点击侧边栏同步图标即可开始。


🎯 典型使用场景

场景一:个人知识管理

用 Obsidian 做深度笔记和知识图谱,同时自动同步到飞书知识库,手机上随时查阅。Obsidian 的双向链接、标签体系与飞书的协作能力完美互补。

场景二:团队文档协作

团队在飞书上协作编辑,你用 Obsidian 本地深度整理和加工,修改后自动同步回飞书。既享受 Obsidian 的编辑体验,又不脱离团队工作流。

场景三:文档备份与迁移

将飞书知识库全量同步到 Obsidian Vault,本地保留完整备份。从此不再担心平台数据丢失,随时可以迁移。


🛡️ 技术架构:为什么选择 lark-cli?

Feishu Sync 没有直接调用飞书 REST API,而是基于飞书官方的 lark-cli 命令行工具作为中间层。这个架构选择带来几个关键优势:

  1. 认证统一管理:OAuth 设备授权流程由 lark-cli 处理,插件无需自行管理 token 刷新
  2. API 变更无感:飞书 API 升级时只需更新 lark-cli,插件代码无需改动
  3. 可独立调试:遇到问题可以直接在终端用 lark-cli 命令排查,定位问题更高效
  4. 官方维护:lark-cli 由飞书官方维护,API 兼容性有保障

💻 跨平台支持

插件特别针对 Windows 环境做了大量兼容处理:

  • 自动查找系统 Node.js(支持 fnm、nvm 等版本管理器)
  • 解析 npm .cmd 包装器,直接调用 node.exe 运行,绕过编码和 stdin 问题
  • 临时文件存放在 Vault 目录内,不写入系统用户目录

macOS 和 Linux 同样支持,通过 login shell 执行确保 PATH 正确。


📦 安装方式

  1. 前往 Gitee Release 页面下载 main.jsmanifest.jsonstyles.css 三个文件
  2. 在 Obsidian Vault 中创建 .obsidian/plugins/feishu-sync/ 目录
  3. 将三个文件复制到该目录
  4. 重启 Obsidian,在设置中启用 Feishu Sync 插件

Gitee 仓库:https://gitee.com/hongjian_Ai/feishu-sync


🗺️ 后续规划

  • 支持选择性同步(按文件夹/标签过滤)
  • 同步历史记录与回滚
  • 飞书表格/多维表格支持
  • 更多冲突解决策略(可视化 diff 对比)
  • 移动端支持(通过 Obsidian Sync 中转)

🤝 参与贡献

Feishu Sync 是开源项目,欢迎提交 Issue 和 PR:

  • Gitee:https://gitee.com/hongjian_Ai/feishu-sync

如果你也在用 Obsidian + 飞书的组合,不妨试试这个插件,让知识真正流动起来。


image