大概是上个月我把自己的笔记系统彻底重构了一遍最终定下来的组合是Obsidian WorkBuddy GiteeObsidian 负责沉淀本地笔记WorkBuddy 负责把 AI 接进笔记工作流Gitee 负责同步和版本管理。折腾小半个月后我最大的感受是这三样东西单拎出来都不算稀奇但捏在一起确实能把一个普通人的个人知识库从“一堆 Markdown 文件”升级成“有 AI 参与产出、有版本历史、能随时发布成网页”的完整系统。这篇就完整记录一下我是怎么搭的每一步的原理、坑和最终配置都会写出来给打算自己动手的人一份能直接照着抄的参考。1. 这套组合到底解决什么问题三件工具的职责边界先说清楚一件事个人知识库这个需求市面上成熟的软件并不少印象笔记、语雀、Notion 都很能打。那为什么我还要绕一圈用三个工具去拼因为知识库最大的问题从来不是“存不下来”而是“存下来的东西之后怎么用”。1.1 知识库的“记”和“存”为什么要分开我之前的笔记散落在好几个平台有云端文档、有备忘录、有聊天记录里转存的内容。等到真要找某个想法的时候要么想不起在哪要么想起来了但复制出来是一堆乱格式。把 Obsidian 当主力笔记软件之后我最大的感受是它把“记”这件事彻底简化了所有笔记都是本地 Markdown 文件打开就是一个文件夹不存在平台锁定的问题换工具也只是换个解析器。但 Obsidian 本身不含“AI”也不负责“同步”。它更像一个本地写作空间价值在于让你安心地写而不用想数据放哪、格式兼容不兼容。真正让这些笔记“活”起来的是把 AI 和版本管理分别交给 WorkBuddy 和 Gitee。分开做的好处是每个环节都可以单独升级笔记本体永远是纯文本永远可控。1.2 WorkBuddy 不是又一个聊天窗口而是 AI 工作台最开始我试过直接在 Obsidian 里挂各种 AI 插件效果不太稳定插件更新还容易互相冲突。后来换成 WorkBuddy 作为独立的 AI 工作台体验明显稳定许多。它解决的不是“聊两句”而是把 AI 变成了一个可以反复使用的生产工具你可以在里面管理多个模型的对话把不同场景拆成独立会话甚至让多个模型协作完成一件事——比如让一个模型整理碎片思路生成初稿另一个模型做事实核查和措辞润色。对知识库场景来说WorkBuddy 更重要的是它有一个知识库模块可以把 PDF、网页、Markdown 文件导进去AI 回答问题时能引用这些资料而不是凭空生成。这一步非常关键笔记库的价值在于独特只有 AI 能基于你自己的笔记内容做分析、对比、提炼才真正算“AI 驱动”。1.3 Gitee 当私有云端比网盘强在哪以前我用网盘同步笔记目录同步能力没问题但几乎谈不上“版本管理”。如果某天误删了一个段落或者改坏了一份重要笔记网盘只能找回整份文件的旧版本没法看到每一次修改的差异。Gitee 本质上是一个 Git 仓库托管平台它把同步建立在版本管理之上每一次提交都是一次快照想回退到任何时刻都可以。选 Gitee 而不是其他平台主要是两条理由。其一国内访问速度和稳定性都让人省心push 和 pull 基本是秒级完成不像有些境外平台经常让我干等。其二Gitee 自带 Pages 服务我可以把整理好的知识库一键发布成网页相当于做了个个人站点不需要额外买服务器。三个工具的分工在我这儿很明确Obsidian 是生产车间WorkBuddy 是智囊团Gitee 是档案馆兼展示窗口。2. Obsidian 侧的准备先把库结构搭得像样工欲善其事必先利其器。WorkBuddy 再聪明喂进去的笔记如果是一团乱麻它也提炼不出好东西。所以在接入 AI 之前我花了一天时间把库结构和写作规范定下来。2.1 目录与命名规范越早定后面越省事Obsidian 的“库”就是一个文件夹怎么组织完全看个人习惯。我最终采用的是简化版 PARA 结构四种顶层目录Inbox所有临时想法、随手摘录、未分类内容先进这个篮子。Project有明确目标和截止时间的项目每个项目一个子目录。Area长期负责的领域比如工作、健康、理财持续累积不归档。Archive已经结束或不再活跃的内容冷处理但不删除。这个结构的好处是“入口只有一个出口有好几个”。所有新笔记默认放进 Inbox每周整理一次把能归位的放到对应目录。WorkBuddy 做知识库索引的时候也是按这四类目录分块理解回答问题时能明显感觉到它对“项目类”和“领域类”信息的处理逻辑不一样。命名规范我定得很简单日常笔记用YYYY-MM-DD-简短描述的方式比如2025-06-01-印象笔记迁移复盘项目笔记用项目名做文件夹内部文件按内容命名。这样在文件列表里天然按时间排序回溯某一天写过什么非常方便。2.2 模板、标签和双链怎么用才不乱很多新手上来就给每篇笔记加十几个标签结果标签越用越乱。我的经验是标签只承担两种职责一种表示状态比如#待整理、#常青一种表示主题域比如#AI、#效率工具。数量控制在 10 个以内够用就行。想加标签直接在笔记顶部写tags: [待整理, AI]这样的 YAML 格式Obsidian 会自动识别。双链[[笔记名]]是 Obsidian 的核心能力但同样不要滥用。我只在“这篇笔记确实会引用另一篇的核心观点”时才加链接绝不为了链而链。真正有价值的是反向链接面板写完一篇新笔记Obsidian 会自动告诉我哪些旧笔记提到了它这种“回头看”经常能发现两个原本没关联的主题之间的隐性联系。对 WorkBuddy 来说双链结构也方便它追溯笔记间的上下文关系。模板系统我建议务必配一套。我自己做了三个常用模板每日记录、读书笔记、项目复盘。模板不是死的它只是帮你在空白文档前节省“从零开始想结构”的力气。比如读书笔记模板固定包含“核心观点”“给我的启示”“待行动事项”三块AI 后续帮我整理读书笔记时也知道去哪里找对应内容。2.3 几个值得提前改的设置项Obsidian 默认设置能用但有几个开关我会建议第一时间调整它们直接影响后续和 WorkBuddy、Gitee 的配合新建笔记默认位置设置为Inbox文件夹而不是和当前笔记同目录避免文件散落。附件默认路径设置为附件文件夹图片、PDF 不会和正文混在一堆。关闭“严格换行”选项否则在部分编辑器里换行会变成brMarkdown 源文件会被 Git 记成大量无关差异。启用“自动更新内部链接”移动文件时链接不会断。这些设置全部在“设置 - 文件与链接”里一分钟搞定。3. 接入 WorkBuddy让 AI 真正长在笔记旁边Obsidian 这边准备好之后接下来就是重头戏把 WorkBuddy 接进来。它不是 Obsidian 的插件而是一个独立应用但配合起来更像一个完整的“知识工作台”。3.1 安装、语言与缓存目录的基础配置WorkBuddy 的安装本身没什么特殊之处下载后按向导装完即可。不过不少人会遇到两个新手问题。第一是界面语言。启动后默认可能是英文界面习惯用中文的朋友可以在设置里把语言切换成中文。不同版本菜单位置略有差异大致路径是Settings - General - Language选中文后重启应用就生效。第二是缓存目录。WorkBuddy 在使用过程中会在本地缓存不少模型返回内容、知识库索引之类的数据默认放在系统盘。如果和我一样 C 盘常年吃紧建议把它挪到别的盘。设置项里一般叫缓存目录或数据目录改完后把原目录内容整体搬过去再重启应用。我当时没动这两个配置直接开用直到系统盘飘红才回头处理属于典型的“能用但不舒服”。如果你打算长期用装完就顺手改掉省得后面折腾迁移。3.2 把模型接进来API Key 与多模型切换WorkBuddy 的玩法重点在于“多模型编排”。很多人在网页端翻来覆去用一个模型对话但换了 WorkBuddy 之后可以在同一个工作台里管理多家大模型服务商的 API Key按任务类型选模型。我的配置方式是这样需要一个主模型负责日常问答、总结、头脑风暴选日常对话能力均衡的。再准备一个长文本模型专门处理整库扫描、长文档提炼上下文窗口要足够大。还可以接入一个轻量模型做“初稿生成”速度快、成本低反正后面有主力模型负责精修。在 WorkBuddy 里分别填入各家平台分配的 API Key 之后每个 Key 对应一个模型实例对话窗口顶部可以随时切换。关键时刻还能开多个会话并行跑一个整理最终版一个负责挑毛病最后一个做格式规范化这种多 AI 协作的工作方式比单模型单线程聊天效率高不少。如果你暂时没有 API Key也别卡在这一步。WorkBuddy 内置了一些可试用的会话能力先用它们跑通流程之后再换成自己的 Key整个工作流不需要改动。3.3 AI 参与笔记生产的三个高频场景WorkBuddy 接好之后我是怎么让它真正参与笔记生产的分享三个我每天都会用的场景供你参考。第一个是收件箱清理。Inbox 里攒了一堆零散想法比如“某某工具可以做自动化”“想研究一下本地存储方案”。我隔几天会把这些原始记录一起丢给 WorkBuddy让它按主题归拢、补齐背景、提炼成几篇结构完整的笔记。它生成的初稿通常能用七成我再手动改一改、加一些只有我知道的上下文就完成了归档。第二个是资料问答。遇到工作上的具体问题我先把相关的旧笔记、本地文档导入 WorkBuddy 的知识库模块然后向它提问。它给出的回答会基于这些资料而不是泛泛而谈相当于给过去的自己“发消息”问答案。这比搜索引擎好用因为搜索结果是别人的经验而这里检索的是我踩过的坑。第三个是写作辅助。写公众号、写项目方案之前我会把大纲和已有的笔记片段丢给 WorkBuddy让它先扩写一遍我再删减润色。由于上下文里明确带有我的笔记内容写出来的东西更贴合我的风格和既有观点不是那种一眼假的泛化文案。这三件事做顺之后Obsidian 和 WorkBuddy 之间的“信息闭环”就成立笔记喂给 AIAI 产出的内容再回存到 Obsidian知识库越来越大AI 能引用的素材也越来越多。4. Gitee 仓库与 SSH 认证把同步建立在版本管理上本地知识库搭好了AI 也接进来了接下来必须解决的痛点是这些笔记怎么安全地同步到其他设备我的答案是 Gitee 私有仓库。4.1 为什么要用 Git 而不是同步盘同步盘的逻辑是“改名即同步删错即删云”操作方便但缺少后悔药。Git 的逻辑完全不同每一次 commit 都是一次显式的状态快照你完全清楚自己什么时候改了什么。对个人知识库这种长期积累、越来越值钱的资产来说这种“可回溯性”太重要了。另外Git 的同步是增量式的只传输变化的部分不像网盘每次扫全量。我整个知识库现在有几千个 Markdown 文件Git push 一下几秒钟就完成完全无感。4.2 SSH 密钥生成与配置要往 Gitee 推代码首先要配好 SSH 认证否则每次操作都要输用户名密码既麻烦又容易出问题。配置分三步。第一步在本地生成密钥。如果你已经生成过跳过这一步否则执行ssh-keygen -t ed25519 -C 你的邮箱一路回车即可会在~/.ssh/下生成id_ed25519私钥和id_ed25519.pub公钥。选 ed25519 算法是因为它比传统的 RSA 更安全密钥也更短。第二步把公钥内容复制到 Gitee。查看公钥cat ~/.ssh/id_ed25519.pub复制输出内容登录 Gitee进入设置 - SSH 公钥粘贴并保存。第三步验证连接是否生效ssh -T gitgitee.com看到欢迎信息就说明认证配置成功。之后所有 Git 操作都会走 SSH不需要再输密码。4.3 仓库创建、许可证选择与首次推送在 Gitee 上新建仓库时有几个选项值得注意。仓库名我建议直接用knowledge-base这类一眼明了的名字。私有/公开的选择取决于你打算怎么用如果只是自己多设备同步选私有如果想用 Pages 对外发布那就得选公开。开源许可证这个选项很多人忽略但它其实会影响别人怎么用你的内容。Gitee 提供 MIT、GPL、Apache 等常见许可证。我的选择逻辑是这样的私有仓库不用选许可证因为代码和内容都不对别人开放。公开仓库且只希望别人能看、能引用不希望被二次修改传播那选MIT最省事宽松且无附加义务。如果你希望别人基于你的内容做修改时也必须以相同方式开源那才考虑GPL。我最终在公开的 Pages 仓库上选了 MIT原因很简单我公开知识库是希望分享信息不打算限制别人使用而 MIT 的表达成本最低。仓库创建完成后本地关联并推送git init git remote add origin gitgitee.com:你的用户名/knowledge-base.git git add . git commit -m init knowledge base git branch -M master git push -u origin master第一次 push 之后Obsidian 的整个库就有了一份远端备份。4.4 .gitignore 与提交策略知识库目录里并非所有东西都适合进 Git。 Obsidian 运行时会产生一些本地状态文件例如工作区布局记录这些文件在单人使用场景不太重要也容易在设备间造成无意义冲突。我的做法是创建.gitignore把这类临时状态排除掉核心笔记内容全部纳入版本管理.obsidian/workspace.json .obsidian/cache .trash/提交策略我遵循“少而勤”的原则。每次整理完一批笔记或者在 WorkBuddy 里完成一轮 AI 辅助整理后就提交一次提交信息尽量描述这个时间段做了什么。比如feat: 整理 AI 工具调研笔记或者docs: 补充本季度复盘。这样回头看历史记录能清楚地知道知识库在每个阶段的演进脉络。5. 自动化同步与 Gitee Pages 发布Git 同步理论上手动 push 也行但人是有惰性的今天忘了 push明天数据就有风险。自动化是必须的。5.1 Obsidian Git 插件的自动备份配置Obsidian 有一个非常成熟的社区插件叫 Obsidian Git它把 Git 的常用操作做成了按钮和定时任务。安装启用后我做了两个配置设置自动备份间隔为 15 分钟。插件会在后台自动执行 add、commit、push不需要手动干预。这意味着即使我中途关了电脑已经保存的内容也会在 15 分钟之内被推到远端仓库。自定义提交信息格式为backup: {{date}}。这样每次自动提交都有独立时间戳不用面对一长串毫无区分度的历史信息。需要手动集中操作时我也用插件的命令面板执行“提交并推送”或者干脆用快捷键。实际用了两个星期之后我已经完全忘记手动 push 这回事了知识库却每天都在自动备份。这种“琐事交出去”的感觉比任何效率技巧都来得实在。5.2 Gitee Pages 把知识库变成公开网页Gitee 的 Pages 服务可以把仓库内容发布成一个可访问的网页。想把自己整理好的知识库对外展示的朋友这一步正好用上。我的做法是在公开仓库下创建一个docs目录里面放的是知识库精选内容而不是把整个 Inbox 倒进去。我可以根据内容形态选择是直接用 Markdown 维护文档页还是用静态站点生成器发布Obsidian 的文档和 Gitee Pages 的天然解析能力能适配我当前的工作量。开启 Pages 服务的路径是仓库页面 - 服务 - Gitee Pages选择部署分支和目录后提交。首次开启时平台一般会要求完成实名认证按提示操作就行。部署完成后会生成一个类似用户名.gitee.io/仓库名的访问地址知识库内容就有了一个对外公开的出口。这里有个重要提醒Pages 部署的是仓库里的静态内容所以如果你改了本地笔记必须 push 到仓库后再去 Pages 页面手动触发一次部署或让仓库的自动部署任务生效。刚开始我经常忘记后来就把“push 之后顺手部署一次”固化成了流程的最后一环。5.3 多设备克隆与冲突处理换了新电脑之后同步这件事并不需要从零再搭一遍。装好 Obsidian然后在终端里克隆仓库git clone gitgitee.com:你的用户名/knowledge-base.git克隆完直接用 Obsidian 打开这个文件夹配合 Obsidian Git 插件自动拉取知识库就完整出现在新设备上了。多设备同时编辑时偶尔会出现冲突。Git 的冲突处理其实没有想象中可怕Obsidian Git 插件拉下更新后如果有冲突会在文件里用 HEAD这样的标记标出两处内容手动选择保留哪一段再提交一次即可。我用了这段时间真正需要处理冲突的次数不超过五次而且几乎都是同一篇笔记在电脑和手机上同时改动造成的。养成“改完一篇就随手 commit 一次”的习惯能大幅降低这类冲突的发生概率。6. 实测踩坑清单每个环节最容易翻车的地方最后把这阵子实测中真正踩过、也帮朋友排查过的坑集中列一下按环节分类方便各位复现排查思路。6.1 WorkBuddy 英文界面的坑这个问题出现频率非常高下载安装后打开是全英文很多用户以为要重新下载中文版耽误半天时间。实际上语言选项就在设置的常规区域切成中文重启即可。如果你下载的版本根本没有中文选项优先找设置里是否有语言包或语言文件切换开关而不是盲目重新安装。顺带提醒一个问题WorkBuddy 的知识库导入功能尽量导入 Markdown、PDF 等文本类文件。如果导入的是数据库或奇怪格式的二进制文件它不一定能建立有效索引导致 AI 回答时引不到内容。6.2 Obsidian 社区主题安装失败很多人反映安装社区主题 Anuppuccin 时提示无法安装原因多半是访问主题仓库资源时的网络不畅。这个问题的替代方案很成熟在 Obsidian 的外观设置里先应用一款内置主题再从社区找同类型主题手动安装。手动安装的方法是去主题的发布地址下载theme.css然后放到库目录.obsidian/themes/主题名/下回设置里切换即可不需要把整个插件市场弄通。6.3 Git 推送与仓库权限的小问题push 失败是新手最容易慌的情况。我排查后的经验是先分三类处理提示Permission denied (publickey)说明 SSH 密钥没配对回头重新检查公钥是否复制完整、Gitee 账号是否绑定正确。提示remote: Repository not found多半是仓库地址拼错或者仓库是私有的但当前 SSH 密钥没有访问权限检查一下是否加了正确的协作者。提示failed to push some refs远端已经有本地没有的提交先执行git pull --rebase origin master把远端变更合进来再重新 push。大部分推送问题翻来覆去就是这几类对着症状定位很快。6.4 我调整后的最终工作流经过这些折腾我现在的日常流程固定成了这样白天随手在 Obsidian 里记想法、摘资料全部落在 Inbox。隔一两天把 Inbox 里的原始内容整理一轮丢给 WorkBuddy 让 AI 帮忙生成结构化初稿然后我手工补充个人背景和判断放回对应目录。Obsidian Git 每 15 分钟自动备份一次所有笔记同步到 Gitee 私有仓库。定期挑出值得公开的内容整理进公开仓库的 docs 目录更新 Pages 站点。整个系统看起来环节很多但真正需要我手动介入的只有“整理笔记”和“挑选公开内容”两步其余都是自动化。用下来最大的感受是个人知识库其实不怕起步小就怕没有积累的机制。你用什么样的系统就会慢慢长成什么样的资料库——这套组合让我很放心地往里写东西因为我知道它们会被妥善归档、会被 AI 重新挖掘、也不会因为硬盘损坏或误删而彻底丢失。