1. 为什么我要折腾这套三联组合先说结论我用了大半年时间把 Obsidian、WorkBuddy 和 Gitee 这三样东西串成了一条流水线现在我的个人知识库已经能做到“素材自动归档、AI 辅助整理、多端同步不丢数据”。这套方案不是什么高大上的企业级架构就是一个普通知识工作者能自己动手搭起来的组合拳。Obsidian 负责本地笔记的存储和双链关联WorkBuddy 负责把 AI 能力接进来做摘要、改写、问答Gitee 负责版本管理和多设备同步。三者各司其职互不打架。你可能会问为什么不用 Notion、飞书这类一体化方案原因很简单数据主权。我的笔记文件全部是本地 Markdown哪天某个工具不干了我换个编辑器照样能打开。AI 能力可以换、同步方案可以换但笔记本身永远是纯文本这是我折腾这套组合的底线思维。这套方案适合什么人如果你平时有大量阅读笔记、工作文档、灵感碎片需要管理又不想被某个平台锁死同时希望 AI 能帮你做点整理和提炼的活儿那这套组合值得你花一个周末搭起来。不需要你会写代码但需要你有基本的文件管理意识和一点点折腾精神。接下来我会从整体设计思路、核心组件拆解、实操搭建过程、常见问题排查四个维度把这条流水线完整讲清楚。每个环节我都会说明为什么这么选、怎么配、踩过什么坑。2. 整体设计与选型思路拆解2.1 三个组件各自扮演什么角色很多人一上来就问“用哪个工具最好”这个问题本身就问错了。正确的思路是先想清楚你的知识库需要哪几种能力然后每种能力找一个最合适的工具。我的知识库需要四种核心能力存储与编辑、AI 辅助处理、版本管理与同步、检索与关联。Obsidian 天然覆盖了存储编辑和检索关联这两块它的双链和图谱功能是目前本地笔记工具里做得最成熟的。WorkBuddy 补上了 AI 辅助处理这一环能在 Obsidian 内部直接调用 AI 做摘要、翻译、改写、问答。Gitee 则解决了版本管理和多端同步的问题而且国内访问速度快私有仓库免费。这三个工具的组合逻辑是Obsidian 是主战场WorkBuddy 是外挂大脑Gitee 是保险柜加传送带。你日常所有操作都在 Obsidian 里完成WorkBuddy 在后台提供 AI 能力Gitee 在后台做版本快照和同步。2.2 为什么不用一体化方案我试过 Notion、飞书文档、语雀这些一体化方案它们确实开箱即用但有几个我无法接受的限制。第一数据存在别人服务器上导出格式虽然支持 Markdown但导出后的双链、附件、元数据经常丢失。第二AI 功能受限于平台自己的模型我想换个模型或者自己调提示词基本没有空间。第三一旦平台调整免费额度或者功能策略我的整个知识库就面临迁移成本。本地优先的方案就不一样了。Obsidian 的仓库就是一个文件夹里面全是.md文件和附件文件夹。WorkBuddy 的配置也是本地 JSON 文件。Gitee 仓库里存的就是这个文件夹的 Git 历史。任何一环出问题我都能在十分钟内换掉笔记本身毫发无损。2.3 数据流向与同步策略设计这套组合的数据流向是这样的你在 Obsidian 里创建或编辑笔记WorkBuddy 根据你的指令调用 AI 接口处理内容处理结果写回笔记文件。然后 Gitee 通过 Git 把变更推送到远程仓库其他设备拉取更新。同步策略我采用的是“手动提交 定时推送”的混合模式。为什么不搞全自动实时同步因为 AI 处理过程中会产生大量中间状态如果每次保存都自动提交Git 历史会变得非常混乱。我的做法是日常编辑随时保存但 Git 提交按批次来比如每天下班前提交一次或者完成一个主题的整理后提交一次。提交信息写清楚这次做了什么方便回溯。注意Gitee 免费仓库单文件限制 100MB仓库总容量 5GB。如果你有大量图片或 PDF 附件建议单独用一个仓库管理附件或者把大文件放到对象存储里笔记里只放链接。3. 核心组件拆解与配置要点3.1 Obsidian 仓库结构与基础配置Obsidian 的仓库就是一个普通文件夹但合理的目录结构能让后续的 AI 处理和同步省很多事。我的目录结构是这样的knowledge-base/ ├── 00-Inbox/ # 临时收集箱所有新内容先扔这里 ├── 10-Notes/ # 永久笔记按主题分二级目录 ├── 20-Projects/ # 项目相关文档 ├── 30-Areas/ # 长期关注的领域 ├── 40-Archives/ # 归档内容 ├── 90-Attachments/ # 图片、PDF等附件 ├── 99-Templates/ # 模板文件 └── .obsidian/ # Obsidian配置目录这个结构参考了 PARA 方法但做了简化。核心原则是新内容先进入 Inbox定期整理到 Notes 或 Projects不再活跃的内容移到 Archives。这样做的好处是 AI 处理时有明确的上下文比如你让 WorkBuddy 处理 Inbox 里的内容它就知道这些是待整理的素材。Obsidian 的基础配置里有几个选项必须打开自动保存防止意外丢失、文件恢复保留历史版本、附件默认路径统一放到 90-Attachments。另外建议开启“严格换行”模式这样 Markdown 的换行行为更符合直觉。3.2 WorkBuddy 的安装与 AI 能力接入WorkBuddy 是一个 Obsidian 插件安装方式和其他社区插件一样在 Obsidian 设置里找到“第三方插件”关闭安全模式然后搜索 WorkBuddy 安装。如果搜索不到可以去 GitHub 下载插件包手动放到.obsidian/plugins/目录下。安装完成后核心配置是填入 AI 服务的 API 信息。WorkBuddy 支持多种 AI 服务商你可以根据自己的情况选择。配置项一般包括 API 地址、API Key、模型名称。这里有个关键点模型选择要根据任务类型来定。摘要和改写用轻量模型就够了速度快成本低复杂推理和长文问答再用大模型。WorkBuddy 的核心功能我常用的有三个选中文本后调用 AI 处理、对整个笔记生成摘要、基于当前笔记内容进行问答。这三个功能基本覆盖了知识库日常维护的需求。提示API Key 不要直接写在插件配置里然后同步到 Gitee。建议用环境变量或者单独的本地配置文件并且把该文件加入.gitignore。3.3 Gitee 仓库创建与 Git 集成Gitee 这边需要做三件事创建私有仓库、配置 SSH 密钥、在 Obsidian 里集成 Git 插件。创建仓库时选择私有不要初始化 README因为我们要把本地已有的仓库推上去。创建完成后在本地知识库文件夹里执行git init git remote add origin gitgitee.com:你的用户名/仓库名.git git add . git commit -m 初始化知识库 git push -u origin masterSSH 密钥配置是新手最容易卡住的地方。流程是本地生成密钥对把公钥复制到 Gitee 的 SSH 公钥设置里。生成命令ssh-keygen -t ed25519 -C 你的邮箱生成的公钥在~/.ssh/id_ed25519.pub用文本编辑器打开复制全部内容粘贴到 Gitee 设置里的 SSH 公钥区域。测试连接ssh -T gitgitee.com看到欢迎信息就说明配置成功了。Obsidian 里我用的 Git 插件是 Obsidian Git它能在 Obsidian 内部执行提交、推送、拉取操作不用切换到命令行。配置里设置自动拉取间隔比如每 30 分钟自动推送可以关掉手动控制提交时机。4. 实操搭建全流程4.1 从零开始搭建知识库骨架第一步安装 Obsidian。去官网下载对应系统的安装包安装完成后创建新仓库选择你准备好的文件夹路径。创建完成后先别急着写笔记把目录结构建好。在文件管理器里手动创建那七个文件夹Obsidian 会自动识别。第二步配置 Obsidian 基础选项。进入设置在“文件与链接”里设置附件默认路径为90-Attachments开启“自动更新内部链接”。在“编辑器”里开启“严格换行”和“显示行号”。在“外观”里选一个你看着舒服的主题推荐用默认主题或者 Minimal 主题简洁不干扰。第三步安装必要插件。除了 WorkBuddy 和 Obsidian Git我还推荐装这几个Templater高级模板、Dataview数据查询、QuickAdd快速捕获。插件不在多在于你真正用得上。我见过有人装了三十个插件结果 Obsidian 启动要半分钟这就本末倒置了。4.2 WorkBuddy 的详细配置与提示词调优WorkBuddy 安装后进入插件设置。API 配置部分填入你的服务商信息。如果你用的是兼容 OpenAI 格式的接口一般只需要填 Base URL、API Key 和模型名称。提示词配置是 WorkBuddy 的灵魂。插件自带了一些预设提示词但默认的往往不够贴合个人需求。我建议你根据自己的使用场景自定义几个摘要提示词请用不超过200字总结以下内容的要点保留关键数据和结论输出为无序列表。改写提示词请将以下内容改写为更简洁清晰的表达保持原意不变适合放入个人知识库。问答提示词基于以下笔记内容回答问题如果笔记中没有相关信息请明确说明“笔记中未提及”。这些提示词我调了好几版才稳定下来。关键经验是给 AI 明确的输出格式要求比如“输出为无序列表”“不超过200字”这样结果更可控。另外对于问答类任务一定要加“如果笔记中没有相关信息请明确说明”这句话否则 AI 很容易编造内容。4.3 Gitee 同步的完整操作流程日常同步流程我简化成了三个动作拉取更新每天开始工作前在 Obsidian Git 插件里点一下“Pull”把其他设备的变更拉下来。编辑笔记正常使用 Obsidian 和 WorkBuddy所有变更自动保存到本地文件。提交推送完成一个阶段的工作后打开 Obsidian Git 面板写提交信息点“Commit and Push”。提交信息我有个习惯用[类型] 简要描述的格式。比如[整理] 将Inbox中的AI文章笔记归类到Notes/技术或者[新增] 添加WorkBuddy配置笔记。这样回溯历史时一眼就能看出每次提交做了什么。如果你有多台设备比如家里台式机和公司笔记本流程是一样的。关键是要养成“先拉后推”的习惯避免冲突。万一出现冲突Obsidian Git 会提示你这时候需要手动解决冲突文件。冲突文件里会有和标记手动选择保留哪部分内容删掉标记然后重新提交。注意Obsidian 的.obsidian配置目录里有些文件是设备相关的比如工作区布局。建议在.gitignore里忽略.obsidian/workspace.json和.obsidian/workspace-mobile.json避免不同设备之间互相覆盖布局。4.4 多设备同步的实操记录我目前是三台设备家里 Windows 台式机、公司 MacBook、手机。桌面端用 Obsidian Git 同步手机端用 Obsidian 移动版加 Git 插件iOS 上叫 Working CopyAndroid 上可以用 Termux 或者 Obsidian Git 移动版。手机端的同步体验说实话不如桌面端流畅主要问题是移动端 Git 操作相对麻烦。我的做法是手机上主要做快速捕获把灵感、摘录扔进 Inbox不做复杂编辑。回到桌面端后再统一整理和 AI 处理。三台设备的同步频率我控制在每天两次早上到公司拉一次晚上回家前推一次。周末做一次完整整理包括 AI 摘要、归类、归档。这个节奏用了大半年没有丢过数据也没有出现过严重的同步冲突。5. 常见问题与排查技巧实录5.1 Obsidian 打不开或插件失效怎么办Obsidian 打不开最常见的原因是插件冲突或者配置文件损坏。排查步骤先重命名.obsidian文件夹为.obsidian-backup然后重新打开 Obsidian。如果正常打开说明是配置问题可以逐个恢复插件配置找到罪魁祸首。如果还是打不开可能是 Obsidian 本体问题重装即可笔记文件不受影响。插件失效通常是版本不兼容。Obsidian 更新后有些插件没有及时跟进。解决办法是去插件设置里检查更新或者去 GitHub 看插件的最新 release 是否支持当前 Obsidian 版本。如果暂时不兼容先禁用该插件等更新后再启用。5.2 WorkBuddy 调用 AI 失败的排查思路WorkBuddy 调用失败一般有四种原因API Key 错误、网络不通、模型名称错误、余额不足。排查顺序我建议这样先看错误信息WorkBuddy 会在控制台输出具体错误。如果是 401 错误检查 API Key如果是 404检查 Base URL 和模型名称如果是超时检查网络连接如果是 429说明请求频率过高或者余额不足。我遇到最多的问题是模型名称写错。不同服务商的模型名称格式不一样有的需要加前缀有的不需要。建议先去服务商文档里确认准确的模型名称再填入 WorkBuddy。5.3 Gitee 推送失败与大文件处理Gitee 推送失败最常见的原因是文件超过大小限制。免费仓库单文件限制 100MB如果你不小心把一个大 PDF 或者视频文件放进了仓库推送就会被拒绝。解决办法先把大文件从 Git 历史中移除然后加入.gitignore。移除命令git rm --cached 大文件路径 echo 大文件路径 .gitignore git commit -m 移除大文件并忽略如果大文件已经在历史提交里了需要用git filter-branch或者 BFG 工具清理历史。这个操作比较危险建议先备份整个仓库。另一个常见问题是 SSH 密钥失效。Gitee 的 SSH 密钥有时会因为安全策略调整而失效重新生成并上传公钥即可。5.4 常见问题速查表问题现象可能原因排查方法解决方案Obsidian 启动卡顿插件过多或某个插件异常安全模式启动逐个启用插件禁用不常用插件更新问题插件WorkBuddy 无响应API 配置错误或网络问题查看控制台错误信息检查 Key、URL、模型名、网络Git 推送被拒绝远程有本地没有的提交git status查看状态先 pull 再 push解决冲突同步后笔记内容丢失冲突解决错误或误操作git log查看历史从历史版本恢复git checkout附件在不同设备路径不一致附件路径设置问题检查 Obsidian 附件设置统一使用相对路径开启自动更新AI 生成内容不准确提示词不够明确检查提示词模板增加格式约束和“不知道就说不知道”6. 我踩过的坑和最后分享几个技巧第一个坑过早追求自动化。我一开始想搞全自动同步加自动 AI 处理结果 Git 历史乱成一锅粥AI 处理结果也没人审核。后来改成手动提交加按需 AI 处理反而效率更高。自动化是好东西但要在流程稳定之后再逐步引入。第二个坑API Key 泄露。我有一次不小心把包含 API Key 的配置文件提交到了 Gitee虽然及时发现删除了但那个 Key 已经暴露了。后来我养成了习惯所有敏感配置放在.gitignore里提交前用git status检查一遍。第三个坑过度依赖 AI 摘要。有段时间我让 WorkBuddy 把所有笔记都生成摘要结果摘要质量参差不齐反而增加了整理负担。现在我只有对长文和复杂内容才用 AI 摘要短文和简单笔记直接手动整理。最后分享一个小技巧用 Dataview 做知识库仪表盘。在 Obsidian 里建一个“Dashboard”笔记用 Dataview 查询最近修改的笔记、Inbox 里待处理的内容、某个标签下的所有笔记。这样每天打开 Obsidian 第一眼就能看到知识库的状态知道该处理什么。这套组合我用了大半年最大的感受是工具是为人服务的不要为了折腾工具而折腾。Obsidian 加 WorkBuddy 加 Gitee 这个组合核心价值在于让你用最低的成本拥有一个完全可控的 AI 辅助知识库。你可以根据自己需求增减组件比如把 Gitee 换成其他 Git 服务把 WorkBuddy 换成其他 AI 插件但底层逻辑是一样的本地存储保底AI 能力增强版本管理护航。