1. 为什么我要把笔记、AI 和代码托管捆在一起用三年前我的知识管理状态是这样的笔记散落在三四个 App 里微信收藏夹塞满了稍后再读的文章浏览器书签栏有上百个链接真正需要某个知识点的时候搜索出来的结果永远不是我要的那一版。后来我陆续把笔记迁到 Obsidian用 WorkBuddy 做 AI 辅助整理再把整个仓库托管到 Gitee 做版本管理和多端同步。这套组合跑了大半年笔记从记了就忘变成了随时能调用我才意识到问题从来不是工具不够多而是工具之间没有形成闭环。Obsidian 解决的是本地优先的笔记存储和双向链接你的所有内容都是纯 Markdown 文件存在自己的硬盘上不依赖任何云服务。WorkBuddy 解决的是AI 辅助的内容加工帮你总结、改写、提取要点、生成索引。Gitee 解决的是版本控制和跨设备同步让笔记像代码一样有提交历史、可以回滚、可以在多台机器之间保持一致。三者各管一段拼起来就是一条完整的采集—加工—存储—同步流水线。这套方案适合谁如果你符合下面任意一条就值得往下看笔记量超过 500 篇、开始出现找不到的情况想让 AI 帮你处理笔记但不想把内容传到不信任的平台有多台设备需要在不同地点访问同一份知识库对数据主权有要求希望内容始终在自己手里。如果你只是偶尔记几条待办那用系统自带备忘录就够了这套组合对你来说太重。我踩过的第一个坑就是顺序搞反了。一开始我先折腾 Gitee 同步结果本地笔记还没整理好同步上去的全是乱码和重复文件回滚了好几次。正确的顺序应该是先把 Obsidian 本地库结构搭好再用 WorkBuddy 做内容加工最后才接 Gitee 做版本管理。这个顺序背后有逻辑——本地结构是地基AI 加工是装修版本管理是物业地基没打好就装修后面全是返工。下面我会按这个顺序把每个环节的选型理由、具体配置、实测中遇到的问题和解决办法都讲清楚。不是那种点这里点那里的流水账教程而是把每一步为什么这么做讲透这样你遇到我没遇到的情况时也能自己判断怎么处理。2. Obsidian 本地库的目录结构决定了后面所有环节的效率2.1 为什么目录结构比插件更重要很多人一上来就装几十个插件结果笔记还是乱。我观察下来问题出在目录结构没有反映你的实际使用场景。Obsidian 的核心优势是双向链接和关系图谱但如果你把所有笔记都堆在一个文件夹里链接再多也找不到东西。目录结构的作用是给笔记一个物理位置链接是逻辑位置两者配合才能快速定位。我的目录结构经过三次大改最终稳定成这个样子KnowledgeBase/ ├── 00-Inbox/ # 临时收集每周清空 ├── 10-Notes/ # 永久笔记按主题分 │ ├── 11-Tech/ │ ├── 12-Product/ │ ├── 13-Reading/ │ └── 14-Life/ ├── 20-Projects/ # 有明确起止时间的项目 ├── 30-Areas/ # 长期维护的领域 ├── 40-Archive/ # 已完成或废弃的内容 ├── 90-Attachments/ # 图片、PDF 等附件 └── 99-Templates/ # 模板文件这个结构参考了 PARA 方法但做了简化。关键设计点有三个Inbox 必须每周清空否则它会变成第二个收藏夹Attachments 单独放因为 Obsidian 默认把附件放在笔记同目录时间长了每个文件夹里都是图片找笔记很痛苦编号前缀是为了让文件夹在侧边栏按固定顺序排列不依赖字母顺序。提示Obsidian 设置里有一项新附件的默认位置改成在下方指定的文件夹中并填入90-Attachments这样粘贴图片时不会污染笔记目录。2.2 必装的四个核心插件和它们的配置逻辑插件不在多在于每个都解决一个具体问题。我长期保留的只有四个其他都是按需临时启用。Dataview是把笔记当数据库查询的插件。比如我想看所有标记了#待整理的笔记或者列出某个项目下所有笔记的修改时间用 Dataview 写一段查询就行。它的价值在于让笔记之间产生动态关联而不是靠手动维护索引页。配置上要注意设置里开启启用 JavaScript 查询否则只能用 DQL 语法功能受限。Templater比 Obsidian 自带的模板功能强在支持变量和脚本。我的日记模板会自动填入日期、星期、当天的天气通过 API还会根据日期生成对应的周数和季度。配置时需要在设置里指定模板文件夹为99-Templates然后在模板文件里用% tp.date.now(YYYY-MM-DD) %这样的语法。Calendar提供日历视图点击日期直接创建当天的日记。配合 Templater 的日记模板每天打开 Obsidian 第一件事就是点日历自动生成当天笔记。这个习惯坚持下来一年就是 365 篇带时间戳的记录。Git插件是后面接 Gitee 的关键。它让你在 Obsidian 界面里直接执行 commit、push、pull不用切到命令行。配置时需要填远程仓库地址、分支名、认证方式。我建议用 SSH 密钥而不是账号密码后面讲 Gitee 配置时会详细说。2.3 笔记命名和链接的实操规范命名规范这件事我试过三种方案纯标题、日期前缀、ID 前缀。最后选了日期前缀 标题格式是20240115-如何配置 Obsidian 同步。理由是日期前缀让文件在系统文件管理器里也按时间排序不依赖 Obsidian标题部分保证可读性两者结合在搜索时既能按时间过滤又能按关键词匹配。链接方面我强制自己遵守一条规则任何提到其他笔记的地方必须用[[ ]]双链不用纯文本。比如写参考之前的 Gitee 配置笔记就写成参考 [[20240110-Gitee SSH 密钥配置]]。这样做的好处是被链接的笔记会自动出现在反向链接面板里时间长了就形成一张知识网络。Obsidian 的关系图谱不是装饰品它是你知识结构的可视化链接越规范图谱越有用。注意Obsidian 的链接默认是最短路径如果两篇笔记标题相同会冲突。建议在设置里把新链接格式改成相对路径虽然链接看起来长一点但不会因为重名而出错。3. WorkBuddy 在知识库里的真实定位不是聊天机器人是内容加工车间3.1 WorkBuddy 和普通 AI 对话工具的区别很多人第一次用 WorkBuddy 会懵这不就是个 AI 对话框吗和网页版有什么区别我用了两个月才想明白WorkBuddy 的核心价值是工作台概念——它不是一个通用聊天窗口而是一个可以挂载技能、连接外部工具、按固定流程处理任务的 AI 工作环境。普通 AI 对话是你问一句它答一句每次都要重新描述背景。WorkBuddy 允许你把常用的处理流程固化成技能比如把这篇笔记总结成三条要点并生成标签、把这段会议记录提取成待办事项、把这篇英文文章翻译并保留专业术语。下次遇到同类任务直接调用技能不用重复描述需求。它和 CodeBuddy 的关系也经常被问。简单说CodeBuddy 偏向代码生成和编程辅助WorkBuddy 偏向通用工作流和内容处理。两者底层能力有重叠但使用场景不同。做知识库管理WorkBuddy 更合适因为你需要的是文本处理、总结、分类不是写代码。3.2 把 WorkBuddy 接入 Obsidian 工作流的三种方式方式一手动复制粘贴。最原始但最可控。在 Obsidian 里选中一段文字复制切到 WorkBuddy粘贴输入指令得到结果再复制回 Obsidian。缺点是切换窗口麻烦优点是每一步你都清楚发生了什么适合对内容准确性要求高的场景。方式二通过 Obsidian 插件调用。社区有插件可以在 Obsidian 内直接调用 AI 接口把选中文本发送出去并插入返回结果。配置时需要填 API 地址和密钥。这种方式效率高但要注意发送的内容会离开本地如果笔记涉及敏感信息要么脱敏后再发要么用方式一。方式三批量处理脚本。用 Python 写脚本读取 Obsidian 库里的 Markdown 文件调用 WorkBuddy 的接口处理再把结果写回文件。适合大批量任务比如把 100 篇旧笔记统一加标签。这种方式需要一定的编程基础但一次写好可以反复用。我日常用得最多的是方式二处理敏感内容时切回方式一。方式三只在季度整理时用一次。3.3 实测有效的三个 WorkBuddy 技能配置技能一笔记摘要生成器。指令模板是阅读以下笔记内容生成一段不超过 100 字的摘要并提取 3-5 个关键词标签标签用 # 开头。输出格式摘要段落然后换行然后标签列表。这个技能我挂在 WorkBuddy 的快捷指令里处理新笔记时一键调用。技能二双向链接建议器。指令是以下是我知识库中的两篇笔记请分析它们之间是否存在关联如果有关联建议在哪些位置添加双向链接并说明理由。这个技能帮我发现了不少之前没注意到的笔记关联尤其是跨领域的。技能三格式规范化。指令是把以下 Markdown 内容按照规范整理标题层级用 ## 和 ###列表用 - 开头代码块标注语言类型删除多余空行保持原意不变。处理从网页复制来的内容特别有用那些内容往往格式混乱。提示WorkBuddy 的技能配置支持变量占位符比如{{selected_text}}表示当前选中的文本。配置时把常用指令存成技能比每次手打指令效率高很多。3.4 用 AI 处理笔记时必须守住的三条底线底线一AI 生成的内容必须人工复核。我遇到过 AI 把笔记里的日期搞错、把专有名词改掉的情况。尤其是技术笔记一个参数写错可能导致后面照着做的人踩坑。我的做法是AI 处理后的内容用不同颜色高亮复核一遍再取消高亮。底线二不要让 AI 直接修改原始笔记。AI 的输出先放到 Inbox 或者一个临时文件里确认无误后再合并到目标笔记。Obsidian 虽然有版本历史但依赖它回滚不如自己控制流程。底线三敏感内容不发送。个人隐私、工作机密、未公开的项目信息这些内容不要发给任何 AI 服务。如果确实需要 AI 辅助处理先手动脱敏把关键信息替换成占位符处理完再替换回来。4. Gitee 托管笔记仓库把知识库当代码一样管理4.1 为什么选 Gitee 而不是其他托管平台选 Gitee 的理由很实际国内访问速度快免费仓库支持私有Git 操作完整。笔记仓库我设成私有因为里面难免有一些个人思考和工作记录。Gitee 的免费账户支持私有仓库容量对纯文本笔记来说完全够用——一万篇 Markdown 笔记也就几百 MB。和 Obsidian 官方的同步服务比Gitee 方案的优势是完全免费且数据可控。官方同步按年收费而且你的笔记存在他们的服务器上。Gitee 方案虽然配置麻烦一点但仓库是你自己的随时可以迁移到其他平台不存在锁定问题。和网盘同步比Git 的优势是有版本历史。网盘同步是覆盖式的你改错了只能找网盘的历史版本而且往往有时限。Git 每次提交都是一个完整快照可以精确回滚到任何一个提交点还能看到每次改了什么。对于长期维护的知识库这个能力很重要。4.2 SSH 密钥配置一次配置长期省事用 HTTPS 方式推拉代码每次都要输账号密码虽然可以缓存但换设备就要重新配。SSH 密钥方式配置一次之后所有操作都免密。具体步骤第一步在本地生成密钥对。打开终端Windows 用 Git Bash执行ssh-keygen -t ed25519 -C your_emailexample.comed25519是目前推荐的算法比 RSA 更短更安全。执行后会问保存路径直接回车用默认路径。然后问要不要设密码如果电脑只有你自己用可以留空直接回车如果多人共用建议设一个。第二步查看公钥内容cat ~/.ssh/id_ed25519.pub复制输出的全部内容从ssh-ed25519开头到邮箱结尾。第三步登录 Gitee进入设置→安全设置→SSH 公钥把复制的内容粘贴进去标题随便起一个能认出设备的名字比如我的笔记本。第四步测试连接ssh -T gitgitee.com看到欢迎信息就说明配置成功了。注意如果你之前配置过其他平台的 SSH 密钥~/.ssh/config文件里可能有冲突的配置。检查一下有没有针对gitee.com的特殊设置没有的话不用管。4.3 仓库初始化和 Obsidian Git 插件的联动配置在 Gitee 上新建一个私有仓库名字比如my-knowledge-base不要勾选初始化仓库因为我们要把本地已有的 Obsidian 库推上去。在本地 Obsidian 库的根目录打开终端执行git init git remote add origin gitgitee.com:你的用户名/my-knowledge-base.git git add . git commit -m 初始化知识库 git push -u origin master如果 Gitee 默认分支是main把最后一行改成git push -u origin main。然后配置 Obsidian Git 插件。在插件设置里远程仓库地址填gitgitee.com:你的用户名/my-knowledge-base.git分支填master或main和仓库一致自动提交间隔我设的是 30 分钟。太短会产生大量无意义的提交记录太长又失去实时性。30 分钟是个平衡点。自动推送开启。提交后自动推送到 Gitee。启动时拉取开启。每次打开 Obsidian 先拉取远程更新避免多设备冲突。配置完成后Obsidian 左侧会出现 Git 面板显示当前修改的文件、提交历史、推拉按钮。日常使用中插件会自动处理大部分操作你只需要在冲突时手动介入。4.4 多设备同步的冲突处理和 .gitignore 配置多设备同步最怕的是冲突。Obsidian Git 插件的策略是启动时拉取定时提交推送。如果两台设备同时修改了同一个文件推送时会报冲突。我的处理流程是先拉取再手动合并最后推送。Obsidian Git 面板里有拉取按钮点击后如果有冲突冲突文件里会出现标记手动编辑保留需要的内容删除标记然后提交推送。.gitignore文件很重要它决定哪些文件不进入版本控制。我的配置.obsidian/workspace.json .obsidian/workspace-mobile.json .obsidian/cache .trash/ .DS_Storeworkspace.json记录的是当前打开的标签页和面板布局每台设备不一样同步过去会导致界面混乱。.trash是 Obsidian 的回收站不需要同步。.DS_Store是 macOS 的系统文件Windows 和 Linux 上没用。提示.obsidian文件夹里的插件配置和主题设置是值得同步的这样换设备后插件和外观自动恢复。但workspace.json要排除原因上面说了。5. 三件套串起来之后的实际工作流长什么样5.1 从信息采集到归档的完整链路我每天的工作流是这样的早上打开 ObsidianGit 插件自动拉取远程更新Calendar 插件显示今天的日期点击创建当天日记。日记模板自动填入日期、星期、以及从 Templater 脚本生成的当日重点任务占位。白天遇到值得记录的内容先扔进00-Inbox格式不限一句话也行一段复制粘贴也行。关键是降低记录门槛不要在这个时候纠结格式和分类。晚上花 15 分钟处理 Inbox。对每条内容判断是永久笔记、项目资料、还是临时信息。永久笔记移到10-Notes对应子目录项目资料移到20-Projects临时信息直接删。移动之前用 WorkBuddy 的摘要技能生成摘要和标签附在笔记末尾。每周日做一次周整理。用 Dataview 查询本周新建的笔记检查有没有遗漏的标签和链接。用 WorkBuddy 的关联建议技能看看新笔记和旧笔记之间有没有可以建立的链接。最后手动触发一次 Git 提交写清楚本周的主要变更。这个流程跑顺之后我每天花在知识管理上的时间不超过 30 分钟但笔记的可用性比之前高了一个量级。5.2 三个真实场景的拆解场景一读到一篇好文章。以前是复制链接到收藏夹然后再也不看。现在是把文章内容复制到 Inbox用 WorkBuddy 提取核心观点和关键论据生成摘要和标签然后归档到13-Reading。如果文章提到了某个我之前记录过的概念手动加一个双向链接。整个过程 5 分钟但这篇文章的核心内容从此可以被搜索到、被链接到。场景二项目进行中产生大量零散记录。项目笔记放在20-Projects/项目名下每天的进展、遇到的问题、决策记录都往里扔。WorkBuddy 定期帮我生成项目周报把零散记录归纳成本周进展遇到的问题下周计划三段。项目结束后整个文件夹移到40-Archive但里面的关键经验会被提取成永久笔记留在10-Notes里。场景三换新电脑。以前换电脑最痛苦的就是迁移各种软件的配置和数据。现在只需要安装 Obsidian安装 Git生成 SSH 密钥并添加到 Gitee克隆仓库安装插件。半小时内所有笔记、插件配置、主题设置全部恢复。这种基础设施即代码的思路用在知识管理上同样有效。5.3 性能和维护笔记多了之后要注意什么笔记超过 2000 篇后Obsidian 的启动速度会变慢搜索也会卡。我的优化经验关闭不用的插件。每个插件都会在启动时加载不用的就关掉需要时再开。我常驻的只有前面说的四个其他都是临时启用。定期重建缓存。Obsidian 设置里有重建缓存选项笔记大量增删后执行一次能解决搜索不到内容的问题。附件压缩。图片是体积大户粘贴前先用工具压缩。我用的是一键压缩脚本把90-Attachments里的图片批量处理体积能减少 60% 以上。Git 仓库瘦身。如果仓库体积超过 1GB可能是历史提交里有大文件。用git gc清理或者用 BFG 工具删除历史中的大文件。不过纯文本笔记很难到这个体积一般不用操心。6. 这套组合的边界在哪里什么情况下不该用6.1 不适合的场景和替代方案这套方案不是万能的。如果你符合以下情况建议换方案团队协作场景。Obsidian Gitee 适合个人知识管理多人同时编辑同一个仓库会频繁冲突。团队协作更适合用 Notion、飞书文档这类支持实时协同的工具。完全不想碰命令行。虽然 Obsidian Git 插件把大部分 Git 操作图形化了但初始配置和冲突处理还是需要命令行。如果你对终端有恐惧可以考虑 Obsidian 官方同步服务虽然收费但省心。笔记量极少。如果你一年记不了 100 篇笔记这套方案的配置成本远大于收益。系统自带备忘录或者一个简单的 Markdown 编辑器就够了。对 AI 处理有严格合规要求。如果工作环境不允许把任何内容发送给外部 AI 服务那 WorkBuddy 这一环就要去掉只用 Obsidian Gitee 的组合。6.2 我踩过的三个印象最深的坑坑一Git 仓库里放了太多二进制文件。一开始我把 PDF、图片、甚至视频都往仓库里塞结果仓库体积迅速膨胀到几个 GB每次克隆都要等很久。后来改成大文件放网盘仓库里只放 Markdown 和少量必要的小图片。如果确实需要版本管理大文件应该用 Git LFS但配置更复杂个人知识库一般用不上。坑二自动提交产生了大量垃圾记录。Obsidian Git 插件默认的自动提交间隔是 5 分钟结果我一天下来产生了几十条提交记录历史面板全是Auto commit字样根本没法看。改成 30 分钟后好多了而且我会在每天结束时手动做一次有意义的提交写清楚当天的主要变更。坑三WorkBuddy 处理后的内容直接覆盖了原文。有一次我让 AI 帮我改写一篇笔记它返回的结果看起来不错我直接覆盖了原文。后来发现它删掉了一段我认为不重要但实际很关键的细节。从那以后AI 的输出一律先放到临时文件对比确认后再合并。6.3 后续可以扩展的方向这套基础组合跑稳之后有几个方向可以继续扩展接入 RAG 做语义搜索。Obsidian 自带的搜索是关键词匹配找不到意思相近但用词不同的内容。可以本地部署一个轻量级的 RAG 系统把笔记向量化实现语义搜索。不过这对硬件有一定要求而且配置复杂适合笔记量很大且对搜索要求高的用户。自动化采集管道。用脚本把微信文章、网页剪藏、RSS 订阅的内容自动抓取并格式化后放入 Inbox。这样连复制粘贴都省了但需要一定的编程能力而且要处理各种网站的格式差异。定期回顾提醒。用 Dataview 查询超过 90 天未修改的笔记定期回顾决定是更新、归档还是删除。知识库不是只进不出的仓库定期清理才能保持活力。这套组合我用了大半年最大的感受是工具的价值不在于功能多强大而在于它们之间能不能形成顺畅的流水线。Obsidian 负责存WorkBuddy 负责加工Gitee 负责同步和版本管理每个环节都做自己最擅长的事组合起来就是一个完整的个人知识管理系统。配置过程确实有点折腾但一次投入换来的是长期的高效和安心。