最初让我注意到这套组合其实是被笔记同步折腾烦了。手上的知识库零散分布在本地文件夹、各种云笔记工具和聊天记录里想查一个技术方案得来回切换好几个应用更别提让AI帮忙归纳整理了——数据源散成一地AI再强也等于没有眼睛。后来我试着把Obsidian、WorkBuddy和Gitee组到一起用一套免费、可控、AI可读的链路把个人知识库真正做成了“能自己生长”的体系。这篇内容就围绕这套三联组合的搭建思路和实际操作展开适合正在搭建个人知识库、想用AI提效同时又不希望把笔记和代码托管给单一云厂商的读者参考。先说结论这套组合里Obsidian负责知识的本地承载和富链接组织Gitee负责跨设备同步与版本管理WorkBuddy则作为AI工作台把能力和上下文接入笔记目录。三者都不需要付费订阅数据主权在自己手里AI能力的接入方式是插件级而非平台绑定。跟着下面的步骤走你也能在半天内搭完整个体系。1. 这笔组合账是怎么算的本地优先、免费可控、AI加持的取舍逻辑很多人搭建个人知识库的第一步是选工具但我觉得更关键的是先想清楚一个问题你的知识库到底需要什么样的底层逻辑我见过的方案大致有四种各有各的痛处。第一种是纯本地笔记软件。数据安全没问题但跨设备同步要么靠网盘、要么靠U盘每次换电脑都得手动搬运版本混乱是常态。第二种是商业云笔记。同步是省心了但知识库这种长期积累的数据全部托管在别人服务器上哪天服务调整、条款变更或者账号异常数据拿不拿得回来都得打个问号。第三种是自建NAS配合WebDAV这套方案在数据主权上最彻底可是对网络环境和硬件要求高整套下来成本并不低普通用户很难复刻。第四种就是我这篇文章要讲的本地Markdown笔记加代码托管平台加AI工作台。选择这个方案的核心逻辑其实就三句话内容是本地文件同步走Git协议AI以工作台形式横向接入。本地文件这点怎么强调都不过分。Obsidian的笔记就是一个普通文件夹里的Markdown文件没有私有格式锁死的风险。哪怕有一天你不打算用Obsidian了拿任何文本编辑器打开这些文件内容都还在双向链接的语法也足够通用。Gitee在这里替代的是网盘的角色通过Git仓库做版本管理同步每一条笔记的改动记录。和普通网盘同步相比Git能让你回滚到任意历史版本还能同时在电脑端和移动端维护同一套笔记。WorkBuddy的定位则是AI工作台不是固定在某个编辑器里的插件。它本身能管理多个智能体任务支持编写Skill技能来告诉AI该以什么身份、什么流程去处理工作。放到这套知识库体系里它可以读取Obsidian的笔记目录作为上下文把整理、归纳、问答这类动作沉淀成固定的技能调用。这个组合最打动我的一点是成本结构。Gitee私有仓库对个人用户免费Obsidian对个人使用免费WorkBuddy提供了免费使用额度整套方案没有订阅压力。与此同时数据随时可导出、可迁移AI能力也只是附加在工作流之上不会绑架你的数据格式。这也是我一直坚持推荐这套组合的原因——工具可以被替换数据永远属于自己。2. 三个角色一次说清Obsidian管笔记、Gitee管同步、WorkBuddy管AI干活在进入具体配置之前有必要把三个工具的职责边界划清楚。很多人搭建这类体系时容易犯一个错误希望一个工具干完所有事结果配置得四不像最后哪个功能都用不顺。我按下面的分工来用这套组合实测下来边界感非常清晰。2.1 Obsidian知识库的内容容器和联想引擎Obsidian处理的是知识库里最核心的资产——内容本身。它基于本地Markdown文件工作你写下的每一篇笔记都是一个独立文件加标签、双链、关系图谱这些能力都用纯文本语法实现。对于个人知识库来说我强烈建议把Obsidian的库路径直接设定为本地的一个专属文件夹后续所有Git操作都以这个文件夹为工作目录。用得最勤的几个能力包括双链[[笔记名]]用来在笔记之间建立语义联系标签#标签名用来做维度归类而Dataview插件的查询语法可以按标签、路径、属性自动汇总笔记列表。这属于把笔记做成数据库而不只是静态文档。2.2 Gitee知识库的远程托管和版本安全网Gitee在这个体系里承担的是“远端仓库”角色。每个笔记文件都是仓库里的文件每次提交都相当于打了一个快照。它的价值体现在两个场景一是换设备时能把整个库拉下来二是一旦误删误改可以查看历史记录并还原。私有仓库的重点注意项是权限设置。个人知识库的私密性要求比较高仓库必须设为私有并且只授权自己的账号。主分支建议用master或main都行但要固定不要频繁切换。配置好SSH密钥后推送拉取不需要反复输密码配合Obsidian的Git插件实现全自动同步这部分后面详细讲。2.3 WorkBuddyAI工作台和知识处理流水线WorkBuddy的角色定位是AI智能体工作台英文全称是WorkBuddy经常和它一起被提及的CodeBuddy是专门针对写代码场景的工具两者可以理解为“办公自动化”和“编码自动化”的两种侧重。在这套知识库体系里WorkBuddy的价值在两个方面。第一是自然语言入口。直接和它对话问“帮我整理今天收集的5篇技术文章的核心观点”它能理解任务意图按结构输出整理结果。第二是Skill机制。你可以把固定的知识处理流程写成技能描述比如“技术文章精读助手输入原文输出摘要、核心观点、个人思考、关联笔记建议”后续直接在对话里调用这个SkillAI就会按固定格式干活不会每次输出风格漂移。再加上Obsidian社区里已经有WorkBuddy相关的接入插件可以把工作台能力挂到Obsidian侧边栏在笔记界面直接唤起AI读取当前笔记作为上下文。这使得“写作、整理、AI辅助”可以在同一个界面内完成不需要反复切换应用。3. 开荒第一步Gitee远端仓库与本地Git环境的初始化这套体系的地基是仓库。仓库没建好后面的一切同步和AI接入都无从谈起。我在这里把从零到一的过程完整走一遍包括我自己当时踩过的几个坑。3.1 在Gitee上创建一个私有仓库注册并登录Gitee账号以后进入右上角的“新建仓库”页面。几个关键配置项这样填仓库名建议直接叫personal-knowledge-base简单明了。路径会自动关联仓库名不用手动改。开源许可证个人知识库建议选“无”并明确把仓库设为私有。公开仓库意味着你的笔记内容会被全世界看到。初始化仓库建议勾选“使用Readme文件初始化”这样克隆时不会遇到空仓库的边界问题。Gitignore模板如果库里包含大量缓存文件可以酌情选择对应模板。不过Obsidian库里通常只有.obsidian配置目录和.md文件我后来是自己在.gitignore里维护的。创建完成后仓库页面会给出两种远程地址HTTPS方式和SSH方式。SSH方式需要公钥配置下面的小节单独讲。3.2 本地Git环境与SSH密钥配置本地需要确保已安装Git。Windows用户可以到Git官网下载安装包一路默认项即可macOS用户通常自带Git也可以通过Homebrew安装最新版本。装完打开终端验证git --version能输出版本号就说明环境可用。接下来配置用户名和邮箱Git提交记录里需要这两个信息后续在Gitee后台的提交动态里也会显示git config --global user.name 你的用户名 git config --global user.email 你的邮箱我比较推荐用SSH协议来做后续的推拉原因是一次配置、长期免密而且比HTTPS更稳定。生成密钥的命令ssh-keygen -t rsa -b 4096 -C 你的邮箱一路回车即可默认会在~/.ssh/下生成id_rsa和id_rsa.pub两个文件。查看公钥内容cat ~/.ssh/id_rsa.pub复制出来的整段文本粘贴到Gitee个人设置的“SSH密钥”页面里标题随意保存后本地和Gitee就已经建立起可信连接。验证命令ssh -T gitgitee.com首次执行会出现是否确认连接的提示输入yes回车即可。提示欢迎信息和你的用户名说明密钥配置成功。3.3 把远端仓库克隆到本地在准备作为知识库根目录的位置打开终端执行git clone gitgitee.com:你的用户名/personal-knowledge-base.git注意把仓库地址换成你自己仓库页面里的SSH地址。克隆成功后本地就出现一个同名文件夹Obsidian直接以这个文件夹作为库目录打开即可。我当时在这步遇到过一个问题克隆下来的仓库里只有一个Readme文件而Obsidian打开这个目录时会自动生成.obsidian配置文件夹。这些配置会不断变化如果不对它做处理每次启动Obsidian都会产生一堆Git改动记录推送时非常吵闹。解决方法是维护一份合理的.gitignore.obsidian/workspace.json .obsidian/workspace-mobile.json .trash/ .DS_Store核心思路是忽略工作区状态文件窗口布局、打开的标签页等但保留.obsidian下的插件与配置目录。因为插件列表和快捷键设置这类东西是需要同步的下次换设备拉下来就能用而工作区状态属于临时信息没必要同步。4. Obsidian端配置Git仓库接管笔记的自动化与双端同步机制地基打好了接下来把Obsidian和Git的联动做成“无人值守”的状态。理想的使用体验是写完笔记合上电脑改动自动提交推送打开手机最新内容已经在库里等着。这套机制的核心是Obsidian的Git插件以及配套的移动端方案。4.1 安装并配置Obsidian Git插件打开Obsidian的设置进入“第三方插件”——“关闭安全模式”——“浏览”在社区插件市场搜索Obsidian Git并安装。安装完启用后到插件设置面板里重点配置以下几项Auto backup interval (minutes)自动提交间隔默认是10分钟我习惯设成20或30分钟避免频繁弹提交记录。Auto pull interval (minutes)自动拉取间隔默认是15分钟这个要设成和自动提交差不多的周期两边节奏一致才不容易冲突。Commit message默认是vault backup: {{date}}这个格式够用可以保留。Pull updates on startup启动时自动拉取建议打开。Push on backup每次自动提交后自动推送建议打开。配置完成后Obsidian几乎变成一个全自动的Git客户端。每次笔记发生变化后台会按设定周期执行add -A commit push启动时也会主动拉取最新改动。对于长期维护的知识库来说这套机制让版本管理彻底隐形你的注意力只需要放在内容上。4.2 移动端同步方案直接用Git拉取推送现在专门说一下手机上怎么维护同一套知识库。Obsidian官方有移动端AppiOS和Android都支持但有两大门槛一是如何打开本地Git仓库里的文件夹二是在手机上完成提交。iOS端的方案我推荐Working Copy这款App。它是一个完整的Git客户端免费版本支持克隆私有仓库和执行基础的提交、推送操作。流程是先在Gitee上给仓库添加一个只读或读写SSH密钥把手机生成的公钥加到Gitee账号里然后到Working Copy里克隆仓库克隆完成后通过系统的“打开方式”把它导入Obsidian App。在Obsidian里编辑笔记再回到Working Copy查看改动、提交、推送。Android端的方案是MGit或Termux。MGit有图形界面支持克隆、提交、推送Termux则是在手机上跑完整Git命令自由度更高。不管用哪一款移动端的操作逻辑都是写笔记——切到Git工具——提交推送。有一个细节值得强调这里用的是“同步”而不是“云存储”的概念。很多云盘类工具是实时上传而Git同步是按提交快照进行手机上产生的每一条编辑记录都会在仓库历史里留下痕迹完全可追溯。代价是需要手动多点一次提交但对知识库这种低频修改场景来说反而更安全——不可能因为误触上传一个损坏文件到全端。4.3 首次同步的关键操作顺序新设备上配置这套流程最容易出错的地方是“先打开Obsidian再克隆仓库”。正确的顺序是在移动端Git工具里先完成克隆。再把本地仓库文件夹导入Obsidian作为库路径。最后打开Obsidian设置里的Git插件看到“当前分支”和“最近提交”信息就说明同步链路正常。如果反过来了Obsidian会在空目录里生成全新库结构未来推送时就会出现大面积的删除与重建Gitee仓库历史也会被污染得厉害。我第一次在手机上操作时就是踩了这个顺序的坑好在本地仓库有完整历史可以恢复否则几百篇笔记的改动记录就全乱了。5. WorkBuddy工作台搭建AI入口与Obsidian之间的两条路WorkBuddy在我这套知识库体系里扮演的是“AI大脑”的角色。搭建过程中我实验下来目前有两条可落地的接入路径一条是官方工作台模式侧重智能体和技能的编排另一条是通过Obsidian社区插件直接唤起AI对话侧重“当前笔记”的上下文注入。两条路各有适用场景我都详细展开。5.1 WorkBuddy基础安装与工作台概念WorkBuddy本身是一个独立应用需要到官方渠道下载安装包。安装完成后首次启动会引导你创建或登录账号并选择使用场景。进入主界面后重点关注两个模块智能体Agent和技能Skill。智能体解决的是“让AI以什么身份做什么事”的问题。你可以创建一个叫“文献阅读助手”的智能体告诉它你的阅读偏好、输出格式、术语风格之后每次调用都保持统一的处理方式。技能解决的是“把固定流程变成一键调用”的问题。比如一个“周报生成”技能会按设定好的模板把本周笔记、任务进度、数据变化组合成周报文档不需要每次重新描述需求。WorkBuddy的Skill可以理解为一个“可复用的提示词工作流”它比单纯写Prompt更有价值的地方在于你可以把多个步骤串起来让AI先摘要、后归纳、再关联知识库已有标签一气呵成。我个人强烈建议尽早开始沉淀自己的Skill库这是把工具优势真正转化为效率优势的关键一步。5.2 通过Obsidian插件唤起AI把当前笔记变成上下文第二条路更重要。单纯从工作台使用AI它看不到你的知识库内容每次都要手动复制粘贴笔记内容再提问效率折损很大。接入Obsidian插件后AI可以直接读取当前正在编辑的笔记结合库内双链关系做回答这才是“AI驱动知识库”的完整形态。安装方式是到Obsidian第三方插件市场搜索“WorkBuddy”或相关接入插件安装后配置API访问信息。配置完成后Obsidian编辑器右侧会出现一个WorkBuddy面板里面可以输入问题、选择智能体、调用技能。面板下方会实时显示当前笔记的上下文信息AI的回答会基于这份上下文展开。我平时最常用的三个场景读完一篇技术文章后把链接和摘录贴在笔记里然后让AI“基于当前笔记提炼核心观点并推荐3个相关联的已有笔记”。写项目复盘时让AI“按照当前标题结构补充遗漏的维度”。知识库整体盘点时让AI输出“最近30天新增笔记的标签分布和主题聚类”。这些场景的共同点是AI的输入不再是孤立的提问而是整库的知识背景。这也是这套组合和单纯“用网页版AI聊天”最大的区别——AI回答的质量直接受益于你的知识库沉淀内容。5.3 Skill编写示例个人知识库场景下的实战技能写一个具体的Skill作为示例。在WorkBuddy的技能管理页面新建技能填入以下内容技能名称读书笔记精读整理 技能描述输入任意书籍或文章的原文摘录输出结构化读书笔记。 处理流程 1. 提取核心观点用3-5句话概括原文主旨。 2. 提炼关键概念列出文中的核心术语并各附一句通俗解释。 3. 记录个人思考基于知识库已有笔记补充相关案例或联想。 4. 生成关联建议推荐2-3条知识库内可能相关的笔记标题用于双链连接。 输出格式Markdown含小标题和列表。保存后后续在对话中调用这个SkillAI会严格按照这个流程处理内容。你可以把“会议纪要生成”“周报汇总”“学习路线规划”等高频需求都做成类似的技能。有了固定的技能库你的AI工作台就不再是“聊天工具”而是一条按标准流程运行的知识处理流水线。6. 实测踩坑清单从Git冲突到Skill目录失效的排错手记整套体系建立起来之后真正考验人的是日常使用中出现的各种小毛病。我把自己实际踩过的坑和排查过程记录下来按照“现象、原因、解决”的思路整理成清单希望你能少走这些弯路。6.1 多设备同时编辑导致的Git冲突现象笔记本和手机上同时打开了同一篇笔记两边都做了修改推送时报错Updates were rejected或冲突标记 HEAD。原因Git的工作机制决定了它会在提交时做三方合并。两边同时修改了同一个文件同一行Git无法自动判断谁的内容应该保留只能要求人工介入。排查过程首先看报错信息里的分支分叉提示基本可以锁定是某个文件产生了两个版本的提交。用命令查看冲突文件git status在冲突文件名下方Obsidian Git插件会在笔记中直接写入冲突标记。你需要在编辑器中找到 HEAD、、之间的内容手动选择保留哪一边然后删除标记再执行提交推送。我现在的规避习惯是手机端主要做“快速补录”一次性写下要点就提交电脑端做“深度编辑”不和其他设备叠加编辑同一篇笔记。如果同步间隔短冲突概率会降低很多。6.2 工作区文件变动导致提交内容噪音很大现象每次打开ObsidianGit插件的自动提交里全是.obsidian/workspace.json这类配置文件的变更真正想找的笔记改动却淹没在大量噪声里。原因.obsidian目录里保存的不仅是插件配置还有窗口布局、打开标签页、光标位置等临时状态。这些内容每次使用都会变化但不属于知识积累推送了也没有跨设备价值。解决在.gitignore里按前面讲的方式忽略掉workspace相关文件。只保留插件主要配置同步。注意.obsidian目录下还有其他关键配置列表如下文件/目录建议原因.obsidian/app.json同步核心应用配置.obsidian/community-plugins.json同步插件启停状态.obsidian/plugins/同步插件本体与配置.obsidian/workspace.json忽略临时窗口状态.obsidian/workspace-mobile.json忽略移动端临时状态.trash/忽略回收站临时文件6.3 WorkBuddy技能调用后输出不稳定的问题现象同一个Skill第一次调用输出格式完全符合预期第二次调用却在开头多了一段AI自我解释格式也乱了。原因Skill的作用是给AI提供“工作流约束”但大模型对指令的遵循程度天然存在波动。技能描述写得越明确输出越稳定如果技能描述里只有目标、没有步骤和输出格式约束AI就会自由发挥。解决把技能的“处理流程”和“输出格式”写成强制性要求而不是建议性描述。可以加入“严格按照以下步骤执行不要额外解释直接输出最终结果”这类约束。如果仍然不稳定可以给技能设置更完善的角色先导词把它塑造成一个高度专业、习惯直接给结论的助手。经过这两轮调整我目前技能调用的稳定率已经相当高。6.4 Gitee的仓库大文件与提交体积控制现象往知识库里放了几张截图和PDF附件后仓库体积迅速膨胀推送速度明显变慢甚至可能触发Gitee的仓库容量提示。原因Git本身擅长管理文本文件对二进制文件图片、PDF的处理效率不高每次提交二进制文件的全部内容都会进入历史记录仓库越滚越大。解决思路有两个方向一是知识的沉淀尽量以可检索的文本为主图片作为辅助证据存入附件目录并控制数量二是确实需要长期保存的大型附件单独维护一个云盘或对象存储目录不在Git仓库里跟踪。把Markdown笔记和二进制附件分离是我目前最认可的做法。6.5 手机端Obsidian识别不到仓库目录现象移动端Git工具已经克隆了仓库但在Obsidian里选择“打开库文件夹”时却看不到这个目录。原因iOS的文件隔离机制导致不同App之间的目录互访受限。Git工具下载的仓库文件默认存储在自己App的沙盒里Obsidian默认看不到这个路径。解决在iOS的“文件”App中手动把仓库文件夹移动到Obsidian能访问的目录例如“我的iPhone”下的某个目录或者通过系统分享菜单选择“拷贝到Obsidian”。目录移动完成后再用Obsidian打开该路径。Android端则要确认存储权限开启并且仓库目录不能被放在带有特殊字符的路径里。7. 把这套体系再往前推一步知识库的活性来自持续喂养搭建完工具链只是第一步真正让知识库发挥价值的是持续喂养和定期复盘。我自己的体会是AI的上下文能力和你的知识库质量呈正相关——库里的笔记越有序、越有连接AI给出的回答就越有深度。所以工具配置稳定之后真正需要长期投入的是内容习惯。现在我的日常流程是每天随手记录——Obsidian里零散思路、摘录、临时问题每周用WorkBuddy做一次集中整理——调用“笔记精读”“主题聚类”这类技能把零散内容结构化、打标签、补双链每月做一次整体复盘——从Git提交历史看知识库的成长曲线从标签分布看关注方向是否偏移。这套节奏坚持两三个月后知识库会呈现出比较理想的“可生长状态”新笔记进来能自动关联到旧笔记AI问答能直接引用库内已有沉淀。这也是我忍不住要把这套组合分享出来的原因。Obsidian、WorkBuddy、Gitee所代表的三层能力——内容、大脑、版本安全——分开看都是普通工具但组合起来就是一个数据自主、跨端可用、带AI辅助的知识管理闭环。如果你正被笔记分散和AI割裂的问题困扰照着这套体系搭一次大概率也会体验到“知识库终于由自己掌控”的踏实感。