先说结论这套组合我已经跑了快八个月笔记从最初的三百多篇涨到现在的两千多篇全靠 Obsidian 管内容、WorkBuddy 做 AI 处理、Gitee 当同步中枢。期间踩过的坑不少但整体体验非常稳。这篇文章把我完整的搭建思路、实操步骤和排查经验全部摊开照着做你也能有一套属于自己的 AI 驱动知识库。很多人在做个人知识库时有个误区以为装个笔记软件、建几个文件夹就算完事。真用起来才发现笔记越记越多检索靠翻整理靠拖跨设备靠 U 盘。这些问题我都遇到过。当时试过 Notion、语雀、飞书各有各的好但都是在线优先的模式数据不在自己手里而且一旦断网整个知识库变成只读。Obsidian 不一样它是本地优先的 Markdown 仓库所有内容都是纯文本文件不锁格式、不锁数据。这一条就决定了它适合作为知识库的地基。但 Obsidian 只有地基还不够。它本身不带 AI 能力虽然社区插件很多但要自己一个个去试、去配效率很低。我的做法是引入 WorkBuddy一个能直接读取本地文件、调用大模型做文本处理的工作型 AI 助手。它能帮我把随手记的零散想法整理成结构化笔记能对几百篇旧笔记做批量摘要还能在我写东西的时候做问答式检索。说白一点Obsidian 解决知识放在哪、怎么连接WorkBuddy 解决知识怎么用、怎么加工。最后一个问题是多设备同步。Obsidian 官方 Sync 要付费第三方同步盘又担心隐私。我的方案是用 Gitee 当 Git 远端仓库。Gitee 在国内访问快免费私有仓库足够个人用加上 Obsidian Git 插件实现自动提交、自动推送相当于给知识库装了一套带版本历史的备份系统。哪怕某天笔记本硬盘坏了照样能从仓库里把全部笔记捞回来。这套组合适合谁如果你经常写东西、做研究、做项目复盘或者跟我一样有几百上千篇碎片笔记需要整理又希望内容能随时跨电脑调用那这篇文章值得从头到尾看一遍。哪怕你刚接触 Obsidian按下面的步骤走也能在两小时内把整套环境跑起来。1. 工具选型背后的逻辑为什么是这三件套先说 Obsidian。这个工具最核心的一点就是本地纯文本存储每一条笔记就是一个 .md 文件。你完全可以想象成自己的知识库是一整个文件夹里面的文件用纯文本写任何编辑器都能打开。这意味着两点一是数据永久可控不像某些云笔记平台说停服就停服说和谐就和谐二是 AI 处理起来极其方便大模型读纯文本不需要什么复杂解析直接把文件内容喂进去就行。相比之下如果笔记存在某个 App 的私有数据库里AI 想读取就要依赖各种封闭接口麻烦得多。WorkBuddy 的定位我用了大半年越来越觉得它像个知识加工厂。它不是简单的聊天机器人而是能作为一个本地 AI 工作台运行给我提供三个核心能力文件读写、批量任务处理、多模型调度。说得直白一点我可以让它把某篇会议记录的要点提炼出来把最近一周的新笔记生成一份摘要清单它真的去读那些文件然后返回结构化结果。这跟那种把文字粘贴进网页对话框里的用法完全是两个层次。用 Obsidian 搭配 WorkBuddy知识点不再躺在文件夹里睡觉而是随时能被唤醒、被调度。Gitee 在这里的角色容易被低估实际上它承担了可靠性这个底线。我的知识库大概几百 MB 级别几百字节的笔记文件为主放到 Git 仓库里做版本管理非常合适。Gitee 的免费私有仓库提供不限制空间的 Git 仓库纯文本几百 MB 完全扛得住而且在国内的访问速度比国外那几个托管平台稳太多。更重要的是Git 的机制天然适合笔记场景每次修改都是一次提交历史版本随时可以回滚。比如某天你批量改格式把一批笔记弄乱了一条 revert 命令就能回到改之前的状态这个安全感是 U 盘同步给不了的。另外还要说一个选型细节为什么不用 Obsidian 官方同步。官方的端到端加密确实做得好但要付费而且它只解决同步这一个问题不解决版本管理和备份的颗粒度问题。而 Git 方案在这三个维度上全部覆盖零成本唯一的代价是需要你稍微懂一点 Git 基础命令。说实话个人知识库这种场景只需要 pull、push、commit 三个命令就能玩得转门槛真没想象中高。2. 动手前的规划目录结构、命名规范和边界很多人搭知识库最大的败笔就是一上来就建了十几个文件夹禁区、项目、灵感、日报、读书笔记、备忘录……分类分得极其精细结果用了两个星期就坚持不下去了。因为人的工作流是动态的今天你以为行业动态和竞品分析是两类过两个月发现它们根本是同一件事。我的经验是目录结构一开始要极简甚至可以只有两三个顶层文件夹让结构随着时间自然长出来而不是预先设计一个庞大的树。具体到我的库顶层只有三个docs、inbox、archive。docs放正式成型的笔记按主题分子目录inbox是收集箱任何零散想法、剪藏内容、临时记录都往这里扔每天清理一次archive放已经失效或用不上的内容不删除只归档。这套源自 GTD 的收集箱—处理—归档流程放在笔记库里特别好用。WorkBuddy 的日常任务之一就是帮我清理 inbox把一条条零散文字整理成结构化的正式笔记它的存在让我不用太强迫自己当时就写规范。命名规范也要提前定好。我用了两种体系一种是常规的YYYY-MM-DD-主题.md适合日志、会议记录、临时想法另一种是语义化命名比如MOC-数据分析.mdMOC即 Map of Content是 Obsidian 社区常见的内容索引页。MOC 相当于是知识库的目录页里面用链接把相关笔记串起来这个功能配合 WorkBuddy 生成内容地图效果拔群。比如我有一个MOC-个人效能.md它会列出所有跟时间管理、效率工具有关的笔记链接我每次写相关东西都从这张图进去不用满库乱翻。标签体系同样重要但不要贪多。我全部的标签不超过十五个比如#待整理、#AI、#项目A、#灵感、#复盘。标签只负责横向分类因为它不改变文件位置也不参与目录结构。真正决定笔记归属的是它放在哪个文件夹、链接到哪些其他笔记。WorkBuddy 在批量处理时也是认这两套规则它读文件名和文件夹路径理解标签然后做归类建议。如果一开始就把标签搞得像数据字典一样复杂AI 也会被你搞糊涂。还有一条边界一定要划清楚知识库里放什么、不放什么。我的原则是知识库只放可复用的、结构化思考后有价值的内容不放原始素材。比如一篇 PDF 论文我不会整体丢进库而是用 WorkBuddy 提炼出摘要、关键观点、可引用的段落存成一篇精炼的读书笔记。原始 PDF 留在外部硬盘。这样做有两个好处一是库里全是高密度信息AI 检索效率高二是 Gitee 仓库体积小同步速度快。知识库最终长成什么样子不是看它装了多少 G 的文件而是看它有没有形成一张内容之间相互引用的网。3. 完整搭建流程三件套从零到能跑3.1 Obsidian 安装与核心配置Obsidian 的安装没什么好说的官网下载对应平台的安装包即可。值得花心思的是首次配置。第一次打开一个空库界面简陋得像记事本但不要慌这是正常的。我建议新库先做三件事设置文件与链接里的新链接格式为相对路径打开核心插件里的模板、标签视图和出链视图在仓库根目录建一个Templates文件夹存几个常用模板。这些操作五分钟就能完成但直接影响后续使用体验。模板我准备了两套一套是日常记录包含日期、天气、今日聚焦、发生了什么、想法、明日待办另一套是主题笔记包含标题、标签、创建时间、相关笔记、核心内容、行动项。写模板的时候要用前端元数据格式也就是在笔记顶部用---包裹的 YAML 区块把 tags、created 这些字段填上。这个格式 AI 解析起来非常友好WorkBuddy 专门能读 YAML 里的信息来识别笔记类型。插件方面最先要装的是社区插件Obsidian Git。安装步骤我后面单独讲这里先说核心插件的启用。在设置里找到核心插件把模板、标签、图谱视图、命令面板都打开。图谱视图特别提一句它可以把所有笔记的链接关系渲染成一张网络图看起来很有科技感但实际作用在于能直观地发现孤立笔记也就是那些没有链接进任何主题的零散内容。我用 WorkBuddy 每周扫一次孤立笔记它列出清单我决定是归档还是链接知识库的网就越织越密。3.2 Gitee 仓库创建与 SSH 密钥配置同步中枢得先建好。注册 Gitee 账号后在右上角新建仓库输入仓库名比如my-brain注意两点仓库类型选私有开源许可证那块先不用选等以后确定要公开代码再补。初始化仓库那里不勾选任何文件保持空仓库状态。这样本地推送时不会遇到跟 README 冲突的问题。SSH 密钥是 Git 协议安全认证的关键。本地终端里执行ssh-keygen -t rsa -b 4096 -C 你的邮箱example.com一路回车生成密钥对。然后查看公钥cat ~/.ssh/id_rsa.pub把输出的整行内容复制到 Gitee 个人设置里的SSH 公钥页粘贴标题随意填写。这一步相当于告诉 Gitee这台电脑是我的请信任它。生成密钥不需要密码短语但如果你的电脑环境比较暴露也可以加Linux 和 Mac 上会通过 keychain 管理Windows 上略微麻烦个人使用我觉得不加密钥短语更顺手。验证是否配置成功执行ssh -T gitgitee.com如果返回一段欢迎语并带上你的用户名说明认证通过了。这里有个细节初次连接时终端会询问是否确认主机指纹输入 yes 回车即可。3.3 本地 Git 仓库初始化与 Obsidian Git 插件配置现在把知识库变成 Git 仓库。在 Obsidian 库根目录打开终端Mac 和 Linux 可以直接在访达/文件管理器里右键打开终端Windows 需要在文件夹地址栏输入 cmd然后执行git init git add . git commit -m first commit git remote add origin gitgitee.com:你的用户名/my-brain.git git push -u origin master完成这四步你的笔记已经全部推到 Gitee 私有仓库了。注意 Windows 上默认分支名可能叫 main而 Gitee 新建仓库默认是 master如果 push 时不匹配可以执行git branch -M master强制改名。真正省事的是装 Obsidian Git 插件。打开 Obsidian 的设置进入第三方插件→关闭安全模式→浏览搜索 Git安装并启用。进入插件设置有几个关键项必须改自动备份间隔设为 10 或 15 分钟也就是每十五分钟自动 commit 并 push自动拉取开关打开这样多设备之间能自动拉取远端更新。这里要特别提醒插件依赖系统自带的 Git 程序Windows 上如果没装 Git for Windows插件会一直报找不到 git。提前装好并加到 PATH 环境变量能少踩一个坑。Git 插件在推送方式上有两种选择HTTPS 和 SSH。我强烈建议选 SSH因为 HTTPS 每次推送都可能要输入账号密码虽然可以配置凭据存储但总归是多一道动作。SSH 一旦配好推送过程全自动完全无感。我在插件设置里只填了 SSH 密钥路径推送身份那里选 ssh-agent 或直接指定密钥文件即可。实测连续跑八九个月除了换电脑重配过一次密钥其余时间没有一次需要手动干预。3.4 WorkBuddy 接入知识库模型配置与权限边界WorkBuddy 的安装我不过多赘述重点是让它接入知识库的姿势要正确。一般这类 AI 工作台有全局文件访问权限你要做的第一件事是限制它的工作目录只允许它访问 Obsidian 库的根目录。不要在系统层面给它全盘权限否则 AI 在处理任务时可能会读到不该读的系统文件既不安全也容易让它分心。模型配置上我会同时配置两到三个模型一个擅长中文总结、上下文窗口大的模型用于处理长文档一个擅长逻辑推理的模型用于问答和拆解问题外加一个快速便宜的模型用于日常简单任务。WorkBuddy 在多模型调度上做得比较顺手可以在任务描述里直接指定用哪个模型。比如我让它做每周回顾时要求用长上下文模型让它给我一句灵感启发时就用快速模型token 花销能省不少。然后是任务设计的思路。WorkBuddy 里我预设了一批技能其实就是可复用的提示词模板加参数配置。最常用的三个summarize-file读取指定路径文件并输出带层级结构的中文摘要weekly-review扫描过去七天新增或修改的笔记按主题汇总成一份周报find-isolated-notes扫描全库图谱信息找出没有任何入链出链的孤立笔记。这几个技能文本文件存放在 WorkBuddy 的 skills 目录我可以随时调整提示词微调后立刻生效。如果你用的版本没有技能这个概念直接用普通对话加固定提示词也行核心逻辑是相同的。4. 日常使用流AI 怎么实打实帮你干活4.1 零散笔记→结构化笔记的批处理我自己每天有大量碎片产出随手记的想法、跟人聊完的要点、看书时画出的句子。这些东西最初都落在 inbox 文件夹一条一文件格式乱七八糟。过去我每周花一个下午去手动整理又累又容易漏。现在这个工作直接交给 WorkBuddy。具体操作很简单我给 WorkBuddy 下指令扫描 inbox 文件夹中创建时间超过三天的全部文件对每个文件提炼要点保留可用信息重写为简洁完整的主题笔记去掉口语和重复内容在标题末尾加上-已整理后缀完成后把清单列给我。它执行时直接把原文件内容读入上下文分步处理每个文件生成一个新笔记放到 docs 对应主题目录下。我只需最后扫一眼清单确认哪些整理得好、哪些需要手动补充。重点在于你要在任务里明确提炼而不是润色AI 的倾向是把你写的流水账改得看起来更通顺但会丢掉关键细节。加上保留所有具体数字、人名、时间、地点这句话整理质量会显著提升。4.2 用问答模式挖旧笔记知识库越到后期越不怕记不下而怕找不到。几百篇笔记躺在硬盘里你记得自己写过某件事但就是想不起关键字。传统做法是全文检索Obsidian 自带的搜索其实不差但它的搜索是关键词匹配搜不到意思相近但说法不同的内容。AI 问答解决了这个问题。我的用法是把 WorkBuddy 当成一个懂你这堆笔记的顾问。我直接问它我去年讨论过关于知识管理工具的选型当时对比了哪些方案各自的优缺点是什么它会自己去全库检索相关笔记找到依据后回答。跟搜索引擎式的返回一堆链接不同它给的是综合后的答案还会标注信息来源是哪些文件。这事用传统搜索几乎做不到因为答案分散在七八篇笔记里之间没有共同关键词。这也是我强调笔记之间要建立链接的原因链接越密AI 检索的线索越多回答质量越高。4.3 写作场景AI 初稿 人工改稿知识库最终要产出。不管是写技术方案、项目复盘还是博客文章我的流程是三段式喂素材、出框架、成初稿。先把相关笔记链接发给 WorkBuddy让它提炼出核心观点清单再让它基于清单生成文章大纲最后让我基于大纲分段写作。第三步是核心很多人卡在让 AI 直接写完整文章结果返回的内容又空又泛。正确的做法是让 AI 只做结构设计和素材整合具体文字由你自己来你把 AI 的大纲和素材拼成稿不仅快而且保留了个人的表达风格。另外一个小技巧是给 WorkBuddy 预设读者角色。我会在任务描述里加上读者是有一线经验的工程师不需要解释基础概念避免空话套话。这个预设极其管用它能从源头避免 AI 写出那种随着技术的不断发展的垃圾开头。同样的知识库内容你只要改一个读者角色产出质量天差地别。4.4 多 AI 协作的实践WorkBuddy 支持多模型同时参与同一任务这个特性我开始没在意后来用顺手了发现真香。比如做一篇深度研究型笔记我会让一个模型负责从笔记库里找线索另一个负责对线索做矛盾检查第三个负责写综述。它们不是轮流发言而是各领一段任务最后汇总。你可以理解成开一个虚拟会议有人做调研有人做审稿有人做总结。这种多 AI 协作模式下WorkBuddy 的作用更像总调度台。我只需要用一个自然语言任务描述把整体目标写清楚它自己拆解、分配、合并。用下来最明显的提升是单一模型容易带有自己的思维惯性看完 A 的证据就倾向结论 A多模型交叉验证之后结论要稳健得多尤其在做方案对比、技术选型这类需要多角度权衡的任务时效果特别明显。5. 同步与版本管理Gitee 的正确打开方式5.1 提交节奏与提交信息规范Obsidian Git 插件的自动备份是兜底方案但我不会完全依赖它。重要节点我会手动 commit比如整理完一批旧笔记、写完一篇大稿子。这就要聊到提交信息怎么写。Git 提交信息相当于知识库的操作日记写得清楚回滚时才知道去哪找。我的格式很简单类型: 简述比如docs: 新增数据分析主题笔记七篇、refactor: inbox 清理并转入 docs、meta: 更新模板 MOC。这个习惯是从代码工程里带过来的放在笔记场景同样成立。每次手动 commit 之前我会顺便看一眼这次改动了什么文件用git status确认没有误伤。Obsidian Git 插件在自动模式下生成的提交信息是时间戳比如autosave 2025-01-08 14:32能用来定位时间线但可读性差所以重要提交还是手动来。自动备份的间隔也不是越短越好。设成 5 分钟会频繁触发 commit一是 Git 仓库里版本碎片太多二是插件频繁读写可能会导致笔记软件偶尔卡顿。我最终固定在 15 分钟已经够安全了。最坏情况丢失 15 分钟内的修改这完全可接受因为重要产出都会手动 commit。5.2 冲突处理多设备编辑同一篇笔记多设备同步最怕的就是两边同时改了同一篇笔记。Obsidian Git 插件在拉取远端更新时如果本地也有未推送的修改就会产生冲突。Git 的做法是生成冲突标记文件把两边的版本都保留下来用、、分隔。处理冲突听起来吓人但实际遇到概率极低我大半年就碰上过两次。一次是家里电脑和公司电脑同时改了同一个 MOC 文件另一次是整理模板时笔记本和手机端同时操作。处理方式也很简单直接在 Obsidian 里打开冲突文件看到标记分隔的两段内容把想要的保留、不想要的删掉然后 commit 一次。从根源上减少冲突的办法只有一个养成离开电脑前先把插件同步按钮点一下的习惯。Obsidian Git 插件在命令面板里有个Changes: Push命令手动触发一次推送保证本地没有滞留修改冲突概率几乎降为零。5.3 仓库权限与开源许可证怎么选如果你的知识库是纯私人内容Gitee 私有仓库已经完全满足需求。私有仓库不涉及任何许可证问题只要你自己保管好账号和密钥就行。但如果你想把一部分笔记开源比如整理成教程或工具模板库那就要考虑许可证了。Gitee 创建仓库时提供的许可证选项里最常用的几个MIT、Apache 2.0、GPL 3.0。个人笔记类内容我推荐 MIT一句话概括MIT 许可意味着别人可以自由使用、修改、分发你的内容甚至商业化只需要保留原始的版权声明。如果你的知识库里包含代码片段希望别人使用时也保持开源那 GPL 更适合。如果完全不想让别人闭源使用就选 Apache 2.0它还附带了一些专利保护条款。我个人建议普通知识分享一律 MIT简单、友好、没有额外义务。千万别选错把笔记放在一个 LICENSE 完全不适合的许可证下将来会麻烦。5.4 移动端同步方案移动端补全了知识库的最后一公里。Obsidian 官方 App 在 iOS 和 Android 上都是免费的但不能直接拉取远程 Git 仓库需要借助第三方 Git 客户端。Android 端方案简单一些装一个 Termux终端模拟器在里面装 Git 和 OpenSSH把密钥配置进去然后手动跑git pull。配合 Obsidian 那边的插件只要手机端先把改动提交到本地再拉取就能完成双向同步。iOS 端麻烦不少主流方案是 Working Copy一款不错的 Git 客户端免费版能管理少量仓库要点是先在文件 App 里把 Obsidian 的库文件夹共享出去再在 Working Copy 里 clone 仓库到同一个目录。这个流程第一次配要花点耐心但配好之后日常操作就变成了在 Obsidian 里写完笔记去 Working Copy 点一下 pull/push。作为备选我建议你在手机上只做记录不做整理。手机端屏幕太小不适合大量编辑我会在手机上一个叫inbox-移动的文件夹里随手记回到电脑端再让 WorkBuddy 统一整理入库。既避免了同步的高频操作又保持了知识库的整洁度。6. 常见问题与排查实录6.1 Obsidian Git 插件一直报错Git 未找到Windows 上最容易踩的坑。原因就是系统没装 Git 或装了但没写到 PATH 环境变量。排查思路先在终端里执行git --version如果报不是内部或外部命令说明需要官网下载安装 Windows 版 Git。安装时有个选项使用 Git 和可选的 Unix 工具勾上装完重启 Obsidian让插件重新读取环境变量。Mac 上一般自带了 Git但如果报错多半是首次安装 Xcode Command Line Tools执行xcode-select --install等系统弹窗安装完即可。还有一个隐藏坑插件配置里指定了 SSH 密钥路径但路径写的是~/开头Windows 上不认这个写法。要写绝对路径比如C:\Users\你的用户名\.ssh\id_ed25519。配置完务必重启 Obsidian 再测试有些参数在插件里不会热生效。6.2 提交了笔记但 Gitee 上没看到更新这个现象通常是提交到本地了但没推到远端。自动模式下插件分为 commit 和 push 两步如果网络不稳定或认证失败commit 成功而 push 失败本地 Git 仓库有改动远端却没有。排查步骤查看插件日志设置里能打开日志面板看 push 失败的具体报错。常见原因包括SSH 密钥失效、Gitee 仓库被设置成只读、账号在 Gitee 上有异地登录被风控拦截。解决后进入命令面板执行Changes: Push手动推送一次即可。我建议每周抽一分钟做一次远端核对到 Gitee 网页仓库页面点击提交记录确认最近一条提交是不是今天或昨天的能直观发现静默失败的问题。6.3 WorkBuddy 回答内容与笔记库严重不符AI 在检索知识库时出现幻觉引用了一些库中不存在的记忆这个问题我也遇到过。原因往往不是 AI 不行而是知识库的索引没有更新。许多 AI 工作台会为文件建立索引缓存新增的笔记没有被及时纳入检索范围。解决方法在任务开始前让 WorkBuddy 重新扫描并索引知识库目录如果平台支持嵌入模型确认向量库刷新完成。如果重新索引后还是答非所问问题大概率出在笔记质量上。一堆互不相干的碎片笔记AI 也很难综合出像样的答案。这时候别怪 AI回过头把笔记整理得结构化一些加上清晰的标题和标签AI 的表现会立刻提升。我的经验是笔记质量跟 AI 输出质量几乎成正比把知识库喂得越干净AI 越聪明。6.4 仓库体积预警与瘦身方案虽然纯文本笔记库增长很慢但总有一些东西会让仓库膨胀插入的截图、PDF 附件、录音文件。Obsidian 会把附件存放在指定附件文件夹里默认assets如果一张截图两三 MB每天放十张一个月就是几百 MBGitee 免费仓库单文件限制 100MB总体体积虽然不限但仓库大了之后每次 push 都变慢。我的处理思路是附件分流大的二进制文件一律不放进 Git 仓库而是放到本地另一个目录或 NAS 上笔记里只留链接。在.gitignore文件里添加assets/大附件/让 Git 自动忽略这些目录。这样仓库始终保持在纯文本状态同步速度几乎等同瞬时。不过要注意忽略后这些附件就失去了 Git 版本保护重要附件需要另做备份计划。如果仓库已经很大可以用 Git 的历史改写功能来瘦身。典型做法是清理 git 历史中的大文件git filter-branch --force --index-filter git rm --cached --ignore-unmatch 你的大文件名.md --prune-empty -- --all跑完后再清理本地引用rm -rf .git/refs/original/ git reflog expire --expirenow --all git gc --prunenow --aggressive最后强推一次远程历史git push -f --all。字体加粗提示这个操作会重写历史多设备其他终端需要重新克隆或在本地重置到最新分支操作前务必先完整备份仓库目录。7. 进阶让这套组合长期更香关于这套组合我最后再分享两个心得。第一知识库不是建完就完的工程它更像一盆需要持续养护的植物。我最看重的指标不是我记了多少条而是我上周整理的笔记有多少在后来被重新引用过。一个链接和引用率不断上升的知识库才是真正在积累知识资本。第二AI 处理知识库的能力提高很快但你不能把整件事全丢给它。我给自己定的原则是AI 负责加工我负责判断。WorkBuddy 给我一份整理好的周报我会快速扫描一遍把明显错误的、缺少上下文的内容挑出来修正。人机协作的边界划得越清楚这套系统用得越久。如果你正准备开始我只有一个建议先搭一个最小可用的闭环。不用一步到位配好所有插件和自动化先在 Obsidian 里随便记三篇笔记用 WorkBuddy 做一次摘要用 Gitee 推一次仓库。跑通这些最基础的动作后面的每一步都会变得很顺。等这套闭环稳定运转你再逐步加模板、加技能、加多端同步路会越走越宽。