1. 为什么我要折腾这套组合先说结论我用了大半年时间把散落在微信收藏、浏览器书签、本地 Markdown、PDF 论文、会议纪要里的东西全部收拢进了一套「Obsidian WorkBuddy Gitee」的体系里。现在我的知识库大概有 1800 多篇笔记日常写作、查资料、复盘项目基本都靠它。这套组合不是什么新鲜玩意但真正把它跑通、跑顺、跑成肌肉记忆的人不多所以我把踩过的坑和最终稳定的方案完整写出来。核心痛点其实就三个笔记散、找不回、不同步。Obsidian 解决的是「本地优先 双向链接」的问题你的笔记就是一堆 Markdown 文件存在自己硬盘上不依赖任何云厂商WorkBuddy 解决的是「AI 介入知识处理」的问题把整理、摘要、问答这些重复劳动交给 AIGitee 解决的是「多设备同步 版本管理」的问题用 Git 仓库当同步中枢比网盘靠谱得多还能看到每一次修改的历史。适合谁来参考三类人最合适。第一类是写作者、研究者、产品经理这类「信息吞吐量大」的人每天要处理大量资料第二类是程序员或者有基础命令行能力的技术人因为 Gitee 同步那部分需要一点 Git 常识第三类是纯粹想摆脱「收藏夹吃灰」状态的普通用户只要你愿意花一个周末把环境搭起来后面就是长期收益。我先把整体架构讲清楚再逐层拆解每个环节的配置细节。你不需要一次全做完可以先把 Obsidian 跑起来再加 AI最后接同步分阶段推进不容易劝退。2. 整体架构设计与选型逻辑2.1 三层结构存储层、智能层、同步层我把这套体系拆成三层来理解这样出问题的时候能快速定位是哪一层的事。存储层是 Obsidian。它的本质是一个「文件夹 Markdown 渲染器 链接引擎」。你的所有笔记就是.md文件放在一个叫 Vault仓库的文件夹里。这个设计的好处是数据永远是你的哪怕明天 Obsidian 倒闭了你用记事本也能打开这些文件。这一点非常重要很多人用云笔记最后被绑架导出格式一塌糊涂Obsidian 从根上避免了这个问题。智能层是 WorkBuddy。它扮演的是「知识库的 AI 助手」角色能读取你的笔记内容做摘要、问答、改写、生成大纲。为什么不用通用的网页版 AI因为通用 AI 不知道你笔记里写了什么每次都要复制粘贴上下文效率极低。WorkBuddy 这类工具的价值在于「贴着你的知识库工作」把 AI 变成你笔记系统的一部分而不是一个外部工具。同步层是 Gitee。用 Git 仓库做同步而不是用网盘或者官方同步服务理由有三个一是版本可追溯每次改动都有 commit 记录误删能找回二是免费Gitee 的私有仓库对个人完全够用三是跨平台一致Windows、Mac、Linux 都能用同一套流程。网盘同步 Markdown 经常出现冲突文件Git 的合并机制虽然偶尔要手动处理但至少不会静默丢数据。2.2 为什么是这三个而不是别的组合市面上类似的方案很多我简单对比一下我考虑过的几个方向。方案优势我放弃的原因纯 Obsidian 官方同步配置最简单官方同步收费且国内访问偶尔不稳Obsidian 网盘同步零学习成本冲突文件多历史版本难追溯Notion 全家桶开箱即用数据在云端离线体验差导出受限Obsidian Git 通用 AI灵活AI 与笔记割裂需要手动喂上下文Obsidian WorkBuddy Gitee本地优先、AI 贴身、版本可控需要一次性配置成本选 WorkBuddy 而不是直接用某个聊天网页核心原因是「上下文自动注入」。你问它「我上周关于 XX 项目的笔记里提到了哪些风险」它能直接去你的 Vault 里检索而不是让你手动贴一堆内容。这个差别在笔记量大了之后是质变。选 Gitee 而不是其他代码托管平台主要是国内访问速度和稳定性考虑私有仓库免费对个人知识库这种小体量完全够用。而且 Gitee 的网页端操作对新手友好不用一上来就啃命令行。2.3 数据流向一次笔记从产生到归档的完整路径我描述一下我日常的一条笔记是怎么流动的你就理解这套体系怎么协作了。早上开会我在 Obsidian 里新建一篇会议纪要用模板快速填好参会人、议题、结论。会后我用 WorkBuddy 让它「把这篇纪要提炼成三条行动项并标注负责人」AI 生成的内容我审核后追加到笔记末尾。中午我在另一台电脑上打开 Obsidian通过 Gitee 拉取最新改动笔记已经在了。晚上我整理资料把几篇相关笔记用双向链接串起来形成一个主题索引页。睡前我执行一次推送所有改动进 Gitee 仓库带 commit 信息。整个过程里Obsidian 负责「写和连」WorkBuddy 负责「理和问」Gitee 负责「存和同步」。三者职责清晰互不干扰任何一层出问题都不影响其他层的数据安全。3. Obsidian 环境搭建与核心配置3.1 下载安装与 Vault 目录规划Obsidian 官网直接下载对应平台安装包Windows 是.exeMac 是.dmgLinux 有 AppImage。安装过程没什么坑一路下一步即可。第一次打开会让你创建 Vault这里有个关键决策Vault 放在哪里。我的建议是放在一个路径短、无中文、无空格的目录下比如D:\KnowledgeBase或者~/Documents/Vault。原因有两个一是 Git 对中文路径和空格的处理偶尔出问题二是路径短在命令行操作时省事。我见过有人把 Vault 放在「我的文档/新建文件夹/知识库」这种深层中文路径下后面配 Git 的时候各种报错排查半天。Vault 内部的目录结构我建议一开始就规划好不要等笔记多了再整理。我的结构是这样的KnowledgeBase/ ├── 00-Inbox/ # 临时收集未整理 ├── 10-Notes/ # 常青笔记长期维护 ├── 20-Projects/ # 项目相关有生命周期 ├── 30-Areas/ # 领域知识持续积累 ├── 40-Archive/ # 归档不再活跃 ├── 90-Templates/ # 模板文件 ├── 99-Attachments/ # 图片、PDF 等附件 └── .obsidian/ # 配置目录不要手动改这个结构参考了 PARA 方法Projects、Areas、Resources、Archives但做了简化。数字前缀是为了让文件夹排序固定不会因为字母顺序乱跳。.obsidian目录是 Obsidian 自己管理的存插件、主题、快捷键配置千万不要手动删或者改否则你的配置全丢。3.2 必装插件清单与配置要点Obsidian 的强大一半靠核心功能一半靠社区插件。我装了大概二十个插件但真正每天都用的是这几个按重要性排序。Dataview是第一个必须装的。它让你用类 SQL 的语法查询笔记比如「列出所有标签为 #待办 且未完成的笔记」。没有它你的笔记就是一堆孤岛有了它笔记之间能自动聚合。配置上没什么特别的装完在设置里开启「Enable JavaScript Queries」就行。Templater是第二个。Obsidian 自带模板功能但 Templater 强太多支持变量、日期计算、脚本。我所有的会议纪要、读书笔记、周报都用它生成。配置时要注意「Template folder location」指向你的90-Templates目录。Calendar和Periodic Notes配合使用做日记和周记。Calendar 在侧边栏显示月历点击某天就打开当天的日记。Periodic Notes 负责自动创建日记文件按日期命名。Excalidraw用来画图。Obsidian 自带的 Canvas 也不错但 Excalidraw 的手绘风格更适合做草图、流程图、思维导图。它生成的图存在笔记里可以双向链接。Advanced Tables让 Markdown 表格编辑不那么痛苦。自动对齐、自动补全、公式计算写表格多的必装。Git插件是后面接 Gitee 的关键。它能在 Obsidian 内部执行 commit 和 push不用切到命令行。配置稍复杂后面单独讲。提示插件不要一次装太多。每装一个都要花时间熟悉装而不用反而拖慢启动速度。我建议先装 Dataview、Templater、Calendar 这三个用顺了再逐步加。3.3 双向链接与标签体系让笔记自己长出来Obsidian 最核心的能力是双向链接。你在笔记 A 里写[[笔记B]]笔记 B 的「反向链接」面板就会自动显示笔记 A。这个机制让知识网络自然生长而不是靠你手动维护目录。我的用法是链接用于「概念关联」标签用于「状态标记」。比如我写一篇关于「缓存策略」的笔记里面会链接到[[Redis]]、[[一致性哈希]]、[[缓存穿透]]这些概念笔记。同时我会给它打上#技术/后端和#状态/已完善两个标签。链接回答「这篇笔记和什么有关」标签回答「这篇笔记处于什么状态」。标签体系一定要提前规划否则后期会乱。我的标签分两类一类是领域标签用斜杠分层比如#技术/前端、#技术/后端、#生活/健康另一类是状态标签比如#状态/草稿、#状态/待补充、#状态/已完善。领域标签控制在三层以内太深了记不住。有个技巧用 Dataview 做一个「待整理」页面自动列出所有#状态/草稿的笔记。这样你每次打开 Obsidian 都能看到哪些笔记需要继续完善不会写完就忘。4. WorkBuddy 接入把 AI 变成知识库的一部分4.1 WorkBuddy 的定位与安装方式WorkBuddy 在这套体系里的角色是「知识库的智能接口」。它不是替代 Obsidian而是增强 Obsidian。你可以在 Obsidian 里选中一段文字让它总结也可以让它基于整个 Vault 回答问题。安装方式取决于你用的版本。桌面版一般提供安装包下载后按向导走即可。安装过程中会要求你配置「工作目录」这里一定要指向你的 Obsidian Vault 根目录否则它读不到你的笔记。配置完成后它会索引你的笔记内容第一次索引可能要几分钟取决于笔记数量。注意索引过程会读取你 Vault 里的所有文本文件。如果你的 Vault 里有敏感信息建议先建一个测试 Vault 试水确认行为符合预期再切到主 Vault。4.2 让 AI 读懂你的笔记索引与上下文策略AI 能不能用好关键在「它能看到什么」。WorkBuddy 这类工具通常有两种模式一种是「全库检索」你提问时它去整个 Vault 里找相关片段另一种是「当前文件」只处理你正在编辑的笔记。我的经验是问事实性问题用全库检索做文本处理用当前文件。比如我问「我之前记录的那个数据库连接超时问题最后怎么解决的」这是全库检索它会找到相关笔记并给出答案。而我选中一段会议纪要让它「提炼行动项」这是当前文件处理不需要它去翻别的笔记。索引策略上有个坑如果你的 Vault 里有大量 PDF 或者图片索引会变慢且效果差。我的做法是把99-Attachments目录排除在索引之外只索引 Markdown 文件。这样索引快检索准。4.3 典型使用场景摘要、问答、改写、生成大纲我日常用 WorkBuddy 最多的四个场景按频率排序。场景一长文摘要。我经常把一篇几千字的文章剪藏进 Obsidian然后让 WorkBuddy 生成三句话摘要和五个要点。这样以后检索的时候先看摘要判断要不要细读效率高很多。场景二知识库问答。这是最有价值的功能。比如我要写一篇关于「消息队列选型」的文章我会问 WorkBuddy「我笔记里关于 Kafka 和 RabbitMQ 的对比有哪些」它会把散落在多篇笔记里的相关内容聚合起来。这比我自己翻笔记快十倍。场景三改写润色。我写初稿往往比较口语化会让 WorkBuddy 帮我改成更正式的书面表达。但要注意AI 改写容易丢失个人风格我一般只让它改语法和逻辑措辞还是自己来。场景四生成大纲。写新文章前我会把相关笔记链接丢给它让它生成一个结构大纲。它给的大纲不一定直接用但能帮我快速理清思路。提示AI 生成的内容一定要审核后再入库。我见过有人直接把 AI 输出粘进笔记结果里面混入了错误信息后面检索时被误导。把 AI 当助手不当权威。4.4 与 Obsidian 的协作边界哪些交给 AI哪些自己来用久了会形成一个判断机械性、重复性、检索性的工作交给 AI判断性、创造性、情感性的工作自己来。具体来说摘要、翻译、格式转换、信息检索、初稿生成这些交给 AI。而观点提炼、经验总结、价值判断、个人感悟这些必须自己写。因为 AI 没有你的经历它写出来的东西是「平均正确但毫无个性」的。我有个习惯AI 生成的内容会用一个特殊标记包起来比如 [AI生成]开头。这样以后回顾时能清楚知道哪些是自己写的哪些是 AI 辅助的。这个习惯在长期维护知识库时特别重要避免自己的思考被 AI 内容稀释。5. Gitee 同步多设备与版本管理5.1 创建仓库与密钥配置先在 Gitee 上创建一个私有仓库名字随意比如knowledge-base。创建时不要勾选「使用 Readme 初始化」因为我们要把本地已有的 Vault 推上去初始化了反而要处理冲突。然后是 SSH 密钥配置这是新手最容易卡住的地方。流程是这样的本地生成密钥对把公钥贴到 Gitee然后测试连接。# 生成密钥一路回车即可密码可以留空 ssh-keygen -t rsa -b 4096 -C your_emailexample.com # 查看公钥内容 cat ~/.ssh/id_rsa.pub把输出的那串以ssh-rsa开头的内容复制粘贴到 Gitee 的「设置 - SSH 公钥」里。然后测试ssh -T gitgitee.com看到欢迎信息就说明配置成功。如果报错八成是公钥没贴对或者网络问题重新检查一遍。注意私钥文件id_rsa绝对不能泄露不要截图发群里不要提交到仓库。公钥id_rsa.pub才是可以公开的。5.2 初始化本地仓库与首次推送在 Vault 根目录下执行cd /path/to/KnowledgeBase git init git remote add origin gitgitee.com:yourname/knowledge-base.git然后创建.gitignore文件排除不需要同步的内容。这一步很关键Obsidian 的工作区文件、缓存文件不应该进仓库否则每次打开都产生改动。# Obsidian 工作区配置每台机器不同不要同步 .obsidian/workspace.json .obsidian/workspace-mobile.json .obsidian/cache # 系统文件 .DS_Store Thumbs.db # 临时文件 *.tmp *.log然后提交并推送git add . git commit -m 初始化知识库 git branch -M main git push -u origin main如果推送时报错说远程有内容说明你创建仓库时初始化了 Readme用git pull --rebase origin main合并一下再推。5.3 多设备同步流程与冲突处理第二台设备上的流程是先装 Obsidian然后git clone仓库到本地再用 Obsidian 打开这个文件夹作为 Vault。之后每次使用前git pull使用后git commit git push。冲突是难免的尤其是两台设备都改了同一篇笔记。Git 的处理方式是标记冲突区域你需要手动选择保留哪部分。我的经验是冲突不可怕可怕的是不处理就提交。看到冲突标记和一定要手动清理否则笔记里会混入这些符号。减少冲突的实用技巧养成「先拉后推」的习惯每次开始工作前先 pull结束工作后立刻 push。不要两台设备同时编辑同一篇笔记如果确实需要用 Obsidian 的「笔记分屏」功能在一台设备上处理。5.4 用 Obsidian Git 插件实现一键同步命令行操作对非技术用户不友好Obsidian Git 插件能把 commit 和 push 变成按钮。安装后在设置里配置Auto pull interval设置成 10 分钟自动拉取远程改动Auto push interval设置成 30 分钟自动推送本地改动Commit message用{{date}}模板自动生成带日期的提交信息配置好后侧边栏会出现 Git 面板显示当前改动文件点一下就能提交推送。我现在的习惯是每天结束工作时手动点一次「Commit and push」比自动推送更可控。提示自动推送虽然方便但如果你的笔记里有半成品内容自动推上去会污染历史。我建议自动拉取开着自动推送关掉手动控制提交时机。6. 常见问题与排查技巧实录6.1 Obsidian 打不开或启动卡顿最常见的原因是插件冲突或者 Vault 太大。排查步骤先按住CtrlMac 是Cmd启动 Obsidian它会以「安全模式」打开禁用所有插件。如果能打开说明是某个插件的问题逐个启用来定位。如果是 Vault 太大导致的卡顿检查99-Attachments目录是不是塞了几百张高清图。Obsidian 渲染图片会占内存建议把大图压缩后再放进去或者用图床外链。6.2 WorkBuddy 读不到笔记内容九成是工作目录配置错了。检查它指向的路径是不是 Vault 根目录而不是某个子文件夹。另外确认笔记文件是.md格式有些从其他软件导入的笔记可能是.txt或者.html需要先转换。如果目录对了还是读不到看看是不是索引还没完成。第一次索引大 Vault 可能要十几分钟耐心等一下。索引完成后可以在设置里看到「已索引文件数」确认数量和你实际笔记数对得上。6.3 Gitee 推送失败与认证报错推送失败最常见的是 SSH 密钥问题。先用ssh -T gitgitee.com测试如果报Permission denied说明密钥没配好。重新生成密钥、重新贴公钥、重新测试三步走一遍。另一个常见原因是仓库地址写错了。用git remote -v查看当前远程地址确认是gitgitee.com:yourname/repo.git格式而不是https://开头。HTTPS 方式每次推送都要输密码SSH 方式配好密钥后免密推荐后者。6.4 多设备同步后笔记错乱这种情况通常是.obsidian目录被同步导致的。不同设备的窗口布局、插件配置不一样如果把这些也同步了打开就会乱。解决办法是在.gitignore里排除.obsidian/workspace.json只同步插件列表和核心配置。如果已经乱了手动删掉本地的.obsidian/workspace.json重启 Obsidian 会重新生成默认布局。6.5 常见问题速查表现象可能原因解决方向Obsidian 启动卡死插件冲突安全模式启动逐个排查插件AI 读不到笔记工作目录错误确认指向 Vault 根目录Git 推送被拒密钥未配置重新生成并粘贴 SSH 公钥同步后布局错乱工作区文件被同步gitignore 排除 workspace.json笔记冲突标记残留未手动处理合并搜索清理冲突附件目录过大高清图未压缩压缩图片或改用外链索引速度慢包含非文本文件排除附件目录只索引 md7. 我踩过的坑和几条实在建议最后分享几条只有真正用过才会知道的经验。第一条不要追求完美体系先用起来。我一开始花了两周设计目录结构、标签体系、模板格式结果一篇笔记没写。后来想通了先随便记记到一百篇再回头整理整理的过程本身就是对知识的二次消化。第二条AI 是加速器不是替代品。WorkBuddy 能帮你省掉大量机械劳动但它写不出你的个人经验。我现在的做法是AI 负责「把话说清楚」我负责「说什么话」。这个分工不能颠倒。第三条Git 提交信息要认真写。很多人 commit 就写个「update」过两个月回头看完全不知道改了什么。我现在的习惯是写清楚「新增 XX 笔记」「修正 XX 错误」「重构 XX 结构」这样历史记录才有价值。第四条定期备份但不要只依赖 Git。Git 仓库本身也可能出问题我每个月会把 Vault 打包压缩存一份到移动硬盘。三重备份本地 Gitee 移动硬盘才睡得踏实。第五条同步频率要匹配你的工作节奏。如果你一天只在一台设备上工作其实不需要频繁同步每天结束推一次就够。如果你像我一样多设备切换那就养成「开工先拉、收工即推」的习惯形成肌肉记忆后就不会忘。这套体系我跑了半年多最大的感受是知识管理的核心不是工具是习惯。Obsidian、WorkBuddy、Gitee 只是把习惯固化的脚手架。工具会变习惯留下来这才是真正属于你的东西。