★ FEATURED ARTICLE 这两年我试过不少笔记方案Notion、语雀、飞书、思源笔记还有各种自带 AI 的在线文档都用过一阵子。折腾到最后真正留在日常主力位置的反而是一套看起来最“传统”的组合Obsidian 负责管理本地 MarkdownWorkBuddy 这类 AI 工作台负责生成、归纳和问答Gitee 负责版本备份和页面发布。没有花哨的云端绑定数据文件就在自己硬盘里AI 能力却一点不少版本历史、多设备同步、静态站点发布也都能覆盖。这套方案的核心价值是把“笔记”从单纯的记录升级成“可被 AI 调用的个人数据库”。Obsidian 提供双向链接和本地 Markdown 文件WorkBuddy 可以像读文件一样读取这些笔记来完成总结、改写、检索和问答Gitee 则给所有产出加上了一层 Git 级别的安全网。如果你正在用 Obsidian却觉得整理笔记越来越吃力或者你用 AI 对话工具但总觉得聊天记录和实际笔记是两张皮又或者你想把知识库做成对外可访问的站点这篇把完整流程和踩过的坑一次讲清楚。1. 为什么是“Obsidian WorkBuddy Gitee”这个组合1.1 在确定这套组合之前我先后踩过的坑最早我用的是纯在线笔记。优点是打开网页就能写团队协作也方便但问题同样明显笔记一旦多了整理和迁移就特别痛苦。每个平台都有自己的块结构和数据库语法导出成 Markdown 后会多出大量不规则片段换个工具等于重新整理一遍。更麻烦的是在线笔记的 AI 能力通常是平台自己封装好的只能在其界面里用无法和本地文件深度联动。后来我试过 Obsidian 加 Git 的组合数据本地化的问题解决了版本管理也有了但整理工作还是要靠人肉完成。一篇笔记存进来了标签要不要加、放到哪个目录、是否和旧笔记重复这些都得自己判断。时间一长Inbox 里堆了一大堆“待整理”文件越囤越不想碰。再后来我把 AI 对话工具接进来用聊天窗口帮我总结、出标题、写摘要。但 AI 不知道我笔记库里的内容每次都要复制粘贴上下文粘贴的规模稍大模型就开始丢信息。对话是一段一段的很难沉淀成结构化的笔记。这个阶段给我的最大感受是工具之间必须能直接传递文件AI 才能变成一个真正的工作环节而不是另一个孤岛。1.2 三联组合里各自的定位这套方案的分工很明确Obsidian 是存储与组织中枢。所有笔记以 Markdown 文件形式存放在本地目录支持 Wiki 链接、标签、Dataview 查询和模板系统。Obsidian 的价值在于把笔记变成了“文件系统”任何能读写 Markdown 的工具都可以参与进来。WorkBuddy 是 AI 处理引擎。它可以读取指定目录下的 Markdown 文件也能把处理结果写回文件。比如自动为笔记补全标签、生成摘要、拆解长文、按提示词重写整篇内容。你可以把它理解为一只“看得见文件”的 AI 手能代替人完成重复的整理加工。Gitee 是版本控制与发布通道。每次提交都能留下可追踪的历史版本误删、误改都能恢复多台设备通过 Git 同步公共仓库配合 Gitee Pages 还能把笔记发布成静态网页。这三者不是互相替代的关系。Obsidian 管“怎么存”WorkBuddy 管“怎么加工”Gitee 管“怎么备份和分发”刚好把个人知识库最需要的三件事全覆盖了。1.3 这套方案适合谁又劝退谁先说适合人群。需要大量阅读文献并整理摘要的科研人员写长文前需要素材库的内容创作者日常和大量 Markdown 打交道的程序员还有对数据隐私比较敏感、希望所有文件都掌握在自己手里的用户都很适合这套组合。但如果你完全不想碰命令行看到 Git 提示就头大那这套方案的门槛会比较高。另外如果团队需要多人同时在线协作、实时看到对方光标位置Obsidian 生态虽然也有同步方案但体验还是不如在线协作文档。这种人我更建议继续用飞书或语雀没必要为了“本地优先”硬迁移。2. 环境准备与基础配置2.1 搭建 Obsidian 笔记库第一次安装 Obsidian 时最关键的是想清楚笔记库放在哪。我建议单独建一个目录比如 Windows 上用D:\KnowledgemacOS/Linux 上用~/Documents/Knowledge不要和系统文档混在一起。后续 Git 初始化和 WorkBuddy 的路径配置都会用到这个目录。笔记库的目录结构直接决定后面 AI 整理时的效率。我的结构是00 Inbox/临时笔记、灵感、剪藏内容先扔进来再说。10 Projects/进行中的项目笔记按项目分子目录。20 Areas/长期维护的领域笔记比如“健康管理”“阅读方法”。30 Resources/资料、书摘、文献笔记。90 Archive/过期项目、归档内容。_templates/Templater 使用的模板文件。_attachments/图片附件统一存放。不要一上来就建几十个文件夹。Obsidian 真正强大的是链接和标签目录只需要一个粗粒度的骨架分类工作交给 AI 更高效。装好 Obsidian 后我建议立刻安装这几个社区插件Dataview把笔记变成可查询数据、Templater模板自动化、Recent Files快速找回、Excalidraw画图。这些都直接在“设置 - 第三方插件 - 浏览”里搜索安装。插件目录会生成在.obsidian/plugins/下注意不要手动改动除非你已经清楚文件结构。2.2 安装并启用 WorkBuddyWorkBuddy 的接入方式取决于你用的是独立客户端还是 Obsidian 插件。我现在的环境是WorkBuddy 独立客户端负责模型调用和技能编排Obsidian 负责最终内容展示。两者通过本地文件路径联动互不干扰。如果你是第一次用先完成基础配置下载并安装 WorkBuddy选择“本地模式”或“云模式”。本地模式需要配置一个模型地址可以是本地 Ollama 启动的模型也可以是任何兼容 OpenAI 接口的 API 服务。在 WorkBuddy 的设置里添加你的笔记库根目录比如D:\Knowledge赋予其读取和写入 Markdown 文件的权限。这一步务必确认路径指向 Obsidian 的 Vault 根目录而不是文件夹里的某个分类。创建一个最简单的技能Skill让 WorkBuddy 能按固定指令处理文件。我的第一个技能长这样技能名称笔记摘要 输入一个 Markdown 文件路径 执行读取该文件提炼核心观点生成摘要追加到文件底部“## AI 摘要”区域 输出只返回处理完成的文件名这个技能看起来简单但它验证了整个人机协同的链路是否通畅Obsidian 里产生文件WorkBuddy 读取并写入回到 Obsidian 中看到结果。链路通了后面要做多复杂的整理都只是提示词问题。2.3 Gitee 仓库创建与本地 Git 配置在 Gitee 上注册后点击“新建仓库”仓库名建议和本地笔记库同名比如Knowledge。如果只是自己用直接选“私有”省得后面误公开。不需要勾选“初始化仓库”会用命令行推送的话完全没必要。接下来是本机 Git 配置。以 Windows 为例最省心的顺序是git config --global user.name 你的名字 git config --global user.email 你的邮箱 ssh-keygen -t ed25519 -C 你的邮箱执行ssh-keygen时一路回车即可。然后打开生成好的公钥文件比如C:\Users\你的用户名\.ssh\id_ed25519.pub复制全部内容到 Gitee 的“设置 - 安全设置 - SSH 公钥”里粘贴保存。验证密钥是否配置成功执行ssh -T gitgitee.com第一次连接会提示确认主机指纹输入yes回车。看到欢迎信息就说明 SSH 通了。接着在笔记库目录下初始化并绑定远程仓库cd /d D:\Knowledge git init git add . git commit -m init knowledge base git remote add origin gitgitee.com:你的用户名/Knowledge.git git push -u origin master这里有个小坑现在 Gitee 新建仓库默认分支名是master但某些初始化工具或模板可能生成main。如果推送时提示分支不匹配执行git branch -m main或git push -u origin main按你本地实际分支名来。3. 把 WorkBuddy 嵌进知识管理流程3.1 AI 摘要、标签建议与反向链接WorkBuddy 接入以后第一件值得做的事是让 AI 自动整理 Inbox。我的流程是先把一篇灵感笔记扔进00 Inbox/然后让 WorkBuddy 执行“整理笔记”技能。这个技能会读取文件完成三件事提取主题生成标签、在笔记开头插入 YAML frontmatter、给出建议关联的已有笔记。实际操作中技能里的提示词可以参考下面这个结构你是一个知识管理助手。请完成以下任务 1. 读取文件内容判断主题领域给出 3 到 5 个标签。 2. 在文件头部生成 YAML 格式元数据包含 title、topic、tags、date。 3. 扫描目录下其他 Markdown 文件列出可能相关的 3 篇笔记作为建议链接。执行完后Obsidian 里刷新一下笔记就有了结构化的元数据。我特别注重第三点因为“自动推荐关联笔记”相当于 AI 把我手动的双链补全了。刚开始还会误链几篇无关笔记但随着笔记库变大AI 的关联准确率会明显提高因为可供参考的上下文变多了。3.2 知识问答与语义检索Obsidian 自带的搜索只能做关键词匹配Dataview 能做更精细的筛选但遇到“我上周写过一篇关于缓存穿透和击穿区别的笔记里面提到了一些设计方案”这种模糊查询人工找起来非常费劲。WorkBuddy 这时候的作用是语义检索。因为它能看到整个笔记库的文件结构也理解自然语言你可以直接问它找出所有提到“缓存穿透”“缓存击穿”的笔记对比两者的解决方案输出一份 600 字的总结并列出每条观点对应的笔记文件名。这个问题的背后是 AI 读取了相关文件后生成的临时总结。它不是搜索文件的文件名而是理解内容后给出答案体验上比“把聊天记录翻半天”舒服太多。有两点要注意。第一语义检索的准确度依赖模型能力小参数本地模型做简单摘录还行做跨多篇笔记的综合对比会力不从心。我现在的做法是日常简单整理用本地小模型涉及重要结论和跨笔记对比时切到效果更好的在线 API。第二笔记文件越多单次读取越慢建议在 WorkBuddy 技能里限制搜索范围比如只搜索10 Projects和30 Resources两个目录别让 AI 每次扫描全库。3.3 写作辅助从笔记到长文这套组合对写作者尤其友好。以前我从素材到成文的路径是找素材复制到文档手工组织段落反复修改。现在路径变成了在 Obsidian 里收集素材每篇素材至少包含关键引用和原始链接。让 WorkBuddy 按主题把相关素材合并成一份“资料汇总”带目录和每部分摘要。我基于汇总写初稿其实就是把 AI 给出的结构按自己的语气填肉。初稿完成后再用 WorkBuddy 做一次“精简冗余、补充细节”的校对。比如我写过一篇关于知识库工具选型的文章当时对 WorkBuddy 用的提示词是根据提供的三篇资料总结出观点 1. 知识库工具的核心痛点是什么。 2. 不同工具分类及适用场景。 3. 给出推荐组合和理由。 要求不要堆砌形容词用直接陈述的语序每段开头先给出结论。最后生成的内容我拿来做初稿骨架再往段落里补充例子和自己的实测数据成文速度比过去快了一倍还不止。这里我的体会是别指望 AI 一次性写出成品。它最擅长的是“把材料变成初稿结构”最终的风格、语气、案例验证还是要人来做。3.4 自动化工作流配置当整理动作变成固定流程后手动去点技能按钮又会变成新的负担。Obsidian 的 Templater 和 QuickAdd 插件可以帮上忙WorkBuddy 自己的模板也能实现一定程度的自动化。我现在的方法是QuickAdd 捕获新笔记的时候自动触发 WorkBuddy 的“整理笔记”技能。新笔记添加后等待几秒再回到笔记文件里标签、摘要、元数据都已经自动生成。如果 AI 处理失败笔记会保留原始状态也不影响正常记录。定时自动化也可以考虑。每天固定时间让 WorkBuddy 扫描00 Inbox/凡是超过三天未整理的笔记自动按主题分类移动到对应目录并生成整理报告。这个功能在独立客户端里实现更稳定插件环境可能受限于 Obsidian 的运行周期。我给一个实用建议自动化流程一定要设计“跳过条件”比如没有新文件的目录就不执行避免每次无聊地重复劳动。4. 用 Gitee 完成备份、同步与发布4.1 首次推送与日常推送环境配置完成后每次修改笔记就进入一个最简单的循环git add . git commit -m daily update: 添加RAG学习笔记更新AI工具对比 git push提交信息我习惯写成“动作内容概要”比如“daily update: 整理Inbox归档项目A”。这个习惯在回溯时非常有用。Gitee 的仓库页面会像代码项目一样列出每次提交点进去能看到本次修改了哪些笔记。遇到内容被误改可以用 Git 历史找回旧版本。我还会写一个简单脚本减少手敲命令比如sync.sh内容就是三行 git 命令再加一句成功后提示。Windows 用户可以用.bat文件效果一样。不要为了省事把所有压缩包、图片缓存文件都提交进仓库后面会说 .gitignore 怎么配置。4.2 多设备同步策略如果你有两台电脑最常见的需求是“家里写的笔记到公司也能看到”。用 Git 做同步是可行的策略很简单所有设备都 clone 同一个仓库工作时先pull结束前push。git clone gitgitee.com:你的用户名/Knowledge.git cd Knowledge git pull # ... 编辑笔记 ... git add . git commit -m update git push这套思路听起来顺实际用起来有坑。如果一台设备忘了 pull 直接 push或者两台设备同时改了同一篇笔记会出现冲突。Git 处理 Markdown 文本冲突还算友好会生成带标记的冲突文件手动保留正确内容再 commit 即可。我建议同步节奏固定下来比如“早晚各同步一次”比连续几小时高强度使用后一次同步更安全。需要更自动化同步的话可以配一个本地的同步盘。但我不建议同时用两个同步方案比如 Git 加坚果云同时开启很容易制造出一堆冲突副本。选一个常用的另一个作为冷备份。4.3 用 Gitee Pages 发布个人知识库把笔记变成公开页面是我从单纯“记录”转向“知识分享”的关键一步。Gitee Pages 是为仓库提供的静态站点托管服务你可以在 Pages 部署页面进行启动选择要部署的分支和目录。因为 Obsidian 的笔记并不是直接可用的网页需要一个中间步骤。我的选择是使用 Obsidian 插件 ——Digital Garden它可以把 Markdown 笔记导出为静态网页结构并保持双向链接。导出后的文件推送到 Gitee 仓库的pages分支然后在 Gitee Pages 服务里选择该分支并启动。启动后你会得到一个如https://你的用户名.gitee.io/Knowledge的地址。实际操作时Digital Garden插件需要设置 a笔记发布白名单只把自己想公开的笔记标记为发布b导出的目标目录一般建议放在一个独立的docs文件夹以区分笔记源文件。推送到 Pages 分支前检查.gitignore避免把本地私人笔记一并上传。还需要提醒一点Gitee Pages 对服务使用有平台规则。你的内容如果涉及版权争议或不合规内容很可能被服务方下架。所以我只发布自己的原创笔记和整理过的公开资料私人日记、内部项目资料一律留在私有仓库。4.4 权限与隐私注意事项隐私意识是从我刚开始用这套方案时就建立的。默认所有仓库建为私有只有极少数明确想公开的内容才单独开公开仓库。不要在笔记正文中写任何密钥、令牌、密码。WorkBuddy 调用在线 API 时会把笔记内容发送给模型服务商这一点必须清楚。我的原则是涉及隐私的日记和财务笔记单独建一个离线 Obsidian 仓库不接入 AI 工具。接入 AI 处理的仓库只放适合被模型读取的内容。配置信息放在.env文件里并在.gitignore中排除。.gitignore至少要包含这几项.obsidian/workspace.json .obsidian/cache .trash/ .env node_modules/workspace.json记录的是窗口布局每台设备可能不同没必要跟着同步。.obsidian/下其他配置如community-plugins.json建议保留这样新设备 clone 后插件列表自动恢复。5. 实操过程与核心环节实现5.1 一个完整的搭建示例假设我现在从零开始把整套流程走一遍。目标本地D:\Knowledge作为 Obsidian 笔记库通过 Gitee 私有仓库备份WorkBuddy 提供 AI 整理能力。第一步创建目录结构mkdir D:\Knowledge cd D:\Knowledge mkdir 00 Inbox 10 Projects 20 Areas 30 Resources 90 Archive _templates _attachments第二步用 Obsidian 打开D:\Knowledge作为 Vault。首次打开会提示是否信任作者选择信任。进入后设置中开启“自动更新内部链接”和“检测所有文件类型扩展”这样后续移动文件时链接不会断。第三步安装必要插件。这一步不追求数量先把 Templater 和 Dataview 配上。Templater 设置里指定模板文件夹为_templates新建笔记时就套用 YAML 模板。第四步配置 WorkBuddy 的本地目录读取权限。这里我建议先把目录设为“只读写回”避免 AI 误删文件。WorkBuddy 的技能编辑器里每一个技能都可以单独设定可操作的目录范围不要给全局权限。第五步初始化 Git 并推送到 Gitee。执行第 2 节里的 git 命令注意最后git push -u origin master。推送成功后在 Gitee 仓库页面能看到本地笔记文件全部上传。5.2 配置细节与参数说明几个容易卡住的细节值得单独说一下。SSH 端口问题。Gitee 的 SSH 默认走 22 端口如果你在特殊网络环境下 22 端口不通可以用ssh -T -p 443 gitssh.gitee.com测试。这个用法在官方文档有说明我不多强调知道有这个选择即可。远程仓库地址写法。在git remote add origin那步地址有两种写法git remote add origin gitgitee.com:用户名/仓库名.git或git remote add origin https://gitee.com/用户名/仓库名.gitSSH 方式免密更安全HTTPS 方式每次推送需要输账号密码。绝不要用http://gitee.com的地址除非你清楚自己在做什么。分支名不统一。Gitee 新建仓库默认分支是master但有些模板或之前推送过的仓库可能默认main。执行git branch看本地分支用git remote show origin看远程头部分支两边名字不一致时改成本地git branch -m main即可。Obsidian 中中文路径和空格。Windows 下路径含空格没问题但某些旧版 Git 对中文路径显示会有转义。设置git config core.quotepath false可以让中文文件名正常显示否则提交历史里会看到一堆转义码。5.3 与 WorkBuddy 联调从草稿到结构化笔记我想用一个实战例子演示整个联调的价值。假设我刚刚在00 Inbox/里新建了一个文件AI笔记草稿.md内容是零散想到的几条知识库工具需要双向链接。AI 整理标签很重要。Gitee 可以备份。多设备同步要不要用坚果云Obsidian 插件很多但不要装太多。让 WorkBuddy 执行“结构化整理”技能提示词如下读取 D:\Knowledge\00 Inbox\AI笔记草稿.md 执行步骤 1. 识别这段草稿涉及的三个主题。 2. 按主题重排草稿输出为五个段落背景、痛点、推荐组合、同步策略、注意事项。 3. 为每个段落生成小标题。 4. 在文件顶部生成 YAMLtitle, tags, date。 5. 把内容写回原文件保留原始草稿到文件末尾“原始素材区”。执行后AI笔记草稿.md变成了有标题、有结构化段落、有元数据的正式笔记。我回到 Obsidian 里看到结果再手动调整语气、补充一两个自己的实测数据一篇可用的笔记就完成了。这个流程从一开始到最终可发布状态花费的时间不到五分钟。这个例子的关键点在于WorkBuddy 的“写回”能力让 AI 变成了文档编辑器的一部分而不是聊天窗口的另一个输出端。所有中间成果都沉淀在文件系统里Obsidian 的链接、标签和查询能继续在这些产出上工作。6. 常见问题与排查技巧实录6.1 Obsidian 打不开或插件失效Obsidian 偶尔会遇到启动后一直转圈、插件全部消失的情况。我遇到最多的是因为第三方插件和版本不兼容。处理方法右键 Obsidian 快捷方式选择“以管理员身份运行”往往没用正确做法是找到笔记库目录下的.obsidian/plugins临时把出问题的插件文件夹移出去启动后再放回来。如果是整个界面都起不来的“打不开”状态检查是不是笔记库路径发生变化。比如换了电脑原来笔记库在 C 盘现在移到 D 盘Obsidian 还是按旧路径索引就容易白屏。重新打开 Obsidian选择“打开其他仓库”重新指向新路径即可。6.2 Git 推送报错与密钥配置问题推送时报Permission denied (publickey)九成是 SSH 密钥没配对。按下面顺序排查现象可能原因处理方式ssh -T gitgitee.com提示权限拒绝公钥未添加或私钥路径不对重新检查id_ed25519.pub是否已粘贴到 GiteeHTTPS 推送每次都提示密码使用 HTTPS 地址且未配置凭据管理器改用 SSH 地址或配置 Windows 凭据管理器推送正常但中文文件名乱码Git 默认转义中文执行git config core.quotepath false推送提示“远程仓库不是空的”远端已有文件本地历史不一致确认本地有备份后git pull origin master --allow-unrelated-histories如果是第一次推送远端仓库被初始化为空提交和本地历史没有共同祖先直接用--allow-unrelated-histories合并一次即可。6.3 WorkBuddy 请求失败或响应异常WorkBuddy 调用模型 API 的时候最常见的问题是请求超时。长文本读取加上大模型推理单次请求超过一分钟很正常。我通常会把技能里的输入限制到合适长度比如只读取指定区域而不是每次把整个文件都能塞给模型。另外要留意上下文窗口。我用的模型如果配置窗口是 32K读一篇 2 万字的笔记再让它整篇总结很可能直接报错。这时候解法是分段处理先让 WorkBuddy 按章节读取每一段生成小摘要最后合并。如果响应内容出现重复、跟指令不符先检查提示词是否给出明确输出格式。我自己的经验是“分步骤限定输出格式”比“自由发挥”可靠得多。6.4 多设备数据冲突多设备同步时出现冲突文件你的文件名 用户名 电脑名.md这其实是 Git 在提醒你同一处内容被两处修改了。处理冲突不需要慌。打开冲突文件找到到标记的区域保留想要的内容删掉其余部分然后 commit 一次。我的预防方法有两个。第一养成“pull 早于 push”的习惯修改前先拉取远程最新状态。第二尽量避免在多个设备上同时处理同一篇笔记。笔记多了以后我按照“项目目录”做分工比如这台设备专注写10 Projects/A另一台只处理20 Areas冲突概率很低。7. 进阶玩法与个人经验7.1 结合飞书等工具如果你日常办公在飞书里可以让这套本地知识库和飞书互相同步。一个稳妥的做法是在飞书文档里用“导出 Markdown”功能把文档导出后放进00 Inbox/再让 WorkBuddy 做一次结构化整理最后进入 Obsidian 知识库。反向的推送把 Obsidian 里整理好的笔记通过飞书开放平台的 Webhook 发送到指定群或知识库里。这种“中央知识库在本地外围工具有入口”的模式比把笔记全锁在一个云平台里灵活得多。我公司里的项目总结很多就是从 WorkBuddy 整理、Obsidian 成稿再通过飞书机器人同步给团队的。7.2 知识库模板与结构设计经过半年多使用我的模板已经稳定成一套固定格式。每篇笔记开头是 YAML 元数据包括title、topic、tags、date、status和source。正文分成“背景”“核心观点”“材料/延伸”“行动项”四个粗粒度区块。这样的好处是Dataview 查询可以按status过滤待办笔记也可以按topic快速生成某个领域的索引页。一个特别有用的小技巧建立一个MOCMap of Content笔记比如20 Areas/知识管理/MOC.md在里面用 Dataview 列出该领域下所有笔记和标签。这相当于自动生成一个“人工目录”比纯目录树直观。7.3 后续扩展公开分享、团队协作如果想把知识库变成公开的站点除了 Digital Garden还可以用mkdocs或vuepress。原理一样把 Obsidian 的 Markdown 文件转换为静态站点推送到一个独立的分支Gitee Pages 渲染发布。和团队协作时Gitee 天然支持分支和 Issue成员可以通过 Pull Request 提交笔记修改review 后合并。这套机制的稳定性和代码开发完全一致。我个人目前的规划是把公开笔记和私有笔记分库管理公开库走 Gitee Pages 自动发布私有库只做本地加密备份。等知识库内容再积累几个月会考虑把 AI 整理技能扩充到语音笔记和网页剪藏两个入口。最后分享一个小经验这套组合真正改变我的地方不是某一个工具多强大而是“AI 可以随时读取并修改我的笔记文件”带来的连锁效应。一旦笔记变成 AI 能直接处理的结构化文件标签、双链、摘要、检索这些原本需要大量意志力才能坚持的动作都可以被自动化执行。你只需要保持一个习惯把想法随手丢进 Inbox剩下的整理交给 WorkBuddy用 Gitee 兜底。按这个节奏用上一个月你会发现自己对知识库的态度慢慢从“负担”变成了“复利”。
阅读完成 · 觉得有帮助？
