企业官网建设流程全解析

1. 为什么我要折腾这套组合

先说结论：我用Obsidian + WorkBuddy + Gitee这套组合，把自己的知识库从"一堆散落的 Markdown 文件"变成了一个能自动整理、自动打标签、自动同步、还能被 AI 随时调用的第二大脑。整个过程踩了不少坑，也总结出了一些别人不太会讲的细节，今天一次性讲透。

如果你现在的情况是：笔记软件换了好几个，印象笔记、Notion、飞书文档都试过，但总觉得数据不在自己手里，或者笔记越写越多、越写越乱，找东西全靠搜索框硬搜——那这套方案大概率适合你。它解决的核心问题就三个：数据主权（文件全在本地）、智能整理（AI 帮你归类打标签）、多端同步（换电脑、换手机都能接着写）。

Obsidian 本身是个本地优先的 Markdown 笔记工具，所有笔记就是你硬盘上的.md文件，不绑定任何云服务。WorkBuddy 在这里扮演的是"AI 助手"的角色，负责帮你处理笔记内容、生成摘要、打标签、甚至根据你的笔记回答问题。Gitee 则是国内的代码托管平台，用它来做笔记的版本管理和多端同步，比某些网盘靠谱得多，而且免费额度对个人知识库来说完全够用。

这套组合的妙处在于：三个工具各司其职，Obsidian 管编辑和展示，WorkBuddy 管智能处理，Gitee 管同步和备份。任何一个环节出问题，其他两个都不受影响。我实测下来，这套方案稳定运行了大半年，笔记量从几百条涨到上万条，依然流畅。

提示：这套方案对纯小白有一定门槛，主要是 Git 那部分需要理解几个基本概念。但我会把每一步都拆到"照着做就行"的程度，你不需要成为 Git 专家。

2. 三个工具到底怎么分工

2.1 Obsidian：你的本地知识库底座

Obsidian 的核心价值在于"本地优先"和"双链"。本地优先意味着你的笔记就是硬盘上的普通文件，哪天 Obsidian 这个软件不在了，你用任何文本编辑器都能打开。双链则是说，你可以在笔记 A 里写[[笔记B]]，Obsidian 会自动建立双向链接，让你在笔记 B 里也能看到"哪些笔记引用了我"。

这个机制对知识管理来说是革命性的。传统的文件夹分类是"一棵树"，一条笔记只能放在一个文件夹里。但双链是"一张网"，一条笔记可以同时和几十条笔记产生关联。我自己的用法是：文件夹只分大类（比如"技术"、"读书"、"生活"），具体的知识关联全靠双链和标签来组织。

Obsidian 的插件生态也是它的一大优势。社区插件市场里有上千个插件，从日历、看板、思维导图到 AI 对话，几乎你能想到的功能都有。但我的建议是：插件不要装太多，装多了启动慢、冲突多。我自己只保留了不到十个核心插件，后面会具体说。

2.2 WorkBuddy：给知识库装上 AI 大脑

WorkBuddy 在这里的角色是"内容处理器"。你可以把它理解成一个能读懂你笔记的 AI 助手，它能做几件事：根据笔记内容自动生成摘要、提取关键词、打标签、甚至帮你把零散的笔记整理成结构化的文档。

我常用的几个场景：写完一篇技术笔记后，让 WorkBuddy 自动生成一段 100 字左右的摘要，放在笔记开头，以后回顾时一眼就能知道这篇讲了什么。或者把一周的日记丢给它，让它帮我提炼出这周的关键事件和情绪变化。再或者，把几篇相关的笔记喂给它，让它帮我合并成一篇综述。

WorkBuddy 和 Obsidian 的配合方式有两种：一种是通过 Obsidian 的插件直接调用，另一种是把笔记导出后单独处理再导回。我两种都用过，插件方式更方便但受限于插件质量，单独处理更灵活但多一步操作。具体选哪种，看你自己的习惯。

2.3 Gitee：笔记的版本管理和同步中枢

Gitee 是国内的一个代码托管平台，和国外的 GitHub 类似。你可能会问：笔记为什么要用代码托管平台？答案很简单：版本管理。

Git 的版本管理能力是网盘完全比不了的。每次你同步笔记，Git 都会记录下这次改了什么、加了什么、删了什么。如果某天你误删了一篇重要笔记，或者改坏了一段内容，可以精确回滚到任何一个历史版本。网盘只能给你"最近版本"和"历史版本"的粗粒度恢复，Git 能给你每一次提交的完整快照。

而且 Gitee 在国内访问速度快，免费仓库的容量对纯文本笔记来说绰绰有余。我的知识库上万条笔记，纯文本加起来也就几十兆，Git 仓库完全无压力。

注意：Gitee 免费仓库有单个文件大小限制（通常 100MB），但笔记都是纯文本，不可能超。如果你要存图片和附件，建议单独用一个仓库或者用图床。

3. 环境搭建：从零开始的完整流程

3.1 Obsidian 的安装与初始配置

Obsidian 的下载渠道很简单，官网直接下对应系统的安装包就行。Windows、macOS、Linux 都有，移动端也有 iOS 和 Android 版本。安装过程没什么好说的，一路下一步。

安装完成后，第一次打开会让你创建仓库（Vault）。仓库就是一个文件夹，你的所有笔记都存在这个文件夹里。我建议把仓库放在一个你容易找到的位置，比如D:\KnowledgeBase或者~/Documents/KnowledgeBase。不要放在桌面，桌面文件多了容易乱，而且有些系统会同步桌面到云端，可能和 Git 冲突。

创建仓库后，Obsidian 会生成一个.obsidian隐藏文件夹，里面存的是你的配置、插件、主题等信息。这个文件夹也会被 Git 跟踪，所以换电脑时你的所有配置都能同步过去，这点非常爽。

初始配置我建议改几个地方：在设置里把"默认编辑模式"改成"实时预览"，这样你写 Markdown 的时候能直接看到渲染效果；把"附件默认位置"改成"当前文件夹下的 attachments 子文件夹"，这样图片和笔记放在一起，方便管理；开启"自动保存"，默认就是开的，确认一下就行。

3.2 WorkBuddy 的接入方式

WorkBuddy 的接入有两种主流方式，我分别说一下适用场景。

第一种是通过 Obsidian 社区插件。在 Obsidian 设置里找到"第三方插件"，关闭安全模式，然后浏览社区插件，搜索 WorkBuddy 相关的插件。安装后需要在插件设置里填入你的 API Key 或者登录账号。这种方式的优点是直接在 Obsidian 里就能用，选中一段文字右键就能调用 AI 处理。缺点是插件质量参差不齐，有些插件更新不及时，Obsidian 版本升级后可能失效。

第二种是独立使用 WorkBuddy 的客户端或网页版，把 Obsidian 的笔记文件拖进去处理，处理完再放回仓库。这种方式更稳定，功能也更全，但多了一步手动操作。我自己的做法是：日常轻量处理用插件，批量处理或者复杂任务用独立客户端。

WorkBuddy 的核心能力包括：文本摘要、关键词提取、标签生成、内容改写、问答对话。你可以根据笔记的类型选择不同的处理方式。比如技术笔记适合提取关键词和生成摘要，日记适合做情绪分析和事件提取，读书笔记适合做观点提炼和关联推荐。

3.3 Gitee 仓库的创建与 Git 配置

这一步是整套方案里门槛最高的，我尽量说清楚。

首先去 Gitee 注册账号，然后创建一个新仓库。仓库名称随便起，比如my-knowledge-base。关键点：仓库要设为私有，除非你愿意让所有人看到你的笔记。创建时不要勾选"初始化仓库"，因为我们要把本地已有的笔记推上去。

接下来是本地 Git 配置。如果你还没装 Git，先去官网下载安装。安装完成后，打开终端（Windows 用 Git Bash 或者 PowerShell），配置你的用户名和邮箱：

git config --global user.name "你的名字" git config --global user.email "你的邮箱"

然后生成 SSH 密钥，这是用来和 Gitee 通信的凭证：

ssh-keygen -t rsa -b 4096 -C "你的邮箱"

一路回车就行，默认会在~/.ssh/目录下生成id_rsa和id_rsa.pub两个文件。用文本编辑器打开id_rsa.pub，复制里面的全部内容。

回到 Gitee 网页，进入"设置" -> "SSH 公钥"，把刚才复制的内容粘贴进去，起个名字比如"我的电脑"，保存。

验证是否配置成功：

ssh -T git@gitee.com

如果看到"Welcome to Gitee"之类的提示，就说明成功了。

提示：如果你在公司网络或者某些特殊网络环境下 SSH 连不上，可以改用 HTTPS 方式。但 HTTPS 每次推送都要输密码，比较麻烦。建议优先用 SSH。

4. 把 Obsidian 仓库变成 Git 仓库

4.1 初始化本地仓库

打开终端，进入你的 Obsidian 仓库目录：

cd /path/to/your/vault git init

这会在当前目录创建一个.git隐藏文件夹，Git 就开始跟踪这个目录了。

接下来创建一个.gitignore文件，告诉 Git 哪些文件不需要跟踪。Obsidian 仓库里有一些文件是不需要同步的，比如工作区布局文件、缓存文件等。我的.gitignore内容如下：

.obsidian/workspace.json .obsidian/workspace-mobile.json .obsidian/cache .trash/ .DS_Store

workspace.json记录的是你当前打开了哪些笔记、面板怎么排列的，这个文件因设备而异，同步过去反而会导致冲突。.trash是 Obsidian 的回收站，也不需要同步。

然后添加所有文件并提交：

git add . git commit -m "初始化知识库"

4.2 关联远程仓库并推送

在 Gitee 仓库页面找到 SSH 地址，格式类似git@gitee.com:你的用户名/仓库名.git。然后：

git remote add origin git@gitee.com:你的用户名/仓库名.git git branch -M main git push -u origin main

如果一切顺利，刷新 Gitee 页面就能看到你的笔记全部上传上去了。

4.3 多端同步的日常操作

日常使用中，你只需要记住三个命令：

git pull # 开始工作前，先拉取最新内容 git add . # 写完笔记后，添加所有改动 git commit -m "更新笔记" # 提交改动 git push # 推送到 Gitee

我自己的习惯是：每天早上打开电脑先git pull，晚上收工前git add . && git commit -m "今日更新" && git push。这样每天一个提交，历史记录清晰，回滚也方便。

如果你觉得敲命令麻烦，可以用 Obsidian 的 Git 插件。这个插件会在 Obsidian 界面里加一个 Git 面板，点几下按钮就能完成拉取、提交、推送。但我的建议是：先手动用命令操作一段时间，理解每一步在干什么，再用插件提高效率。不然出了问题你都不知道怎么排查。

注意：多端同步最大的坑是"冲突"。如果你在电脑 A 上改了笔记但没推送，又在电脑 B 上改了同一篇笔记并推送了，那电脑 A 再拉取时就会冲突。避免方法是：每次开始工作前先 pull，结束工作后立刻 push。养成这个习惯，基本不会遇到冲突。

5. 让 AI 真正融入你的知识工作流

5.1 自动摘要与标签的批量处理

笔记多了之后，最大的问题是"找不到"和"想不起来"。我的解决方案是：每篇笔记写完，让 WorkBuddy 自动生成摘要和标签，放在笔记的 frontmatter 里。

Obsidian 支持 YAML frontmatter，就是在笔记最开头用---包裹的一段元数据。格式如下：

--- title: 笔记标题 summary: 这是 WorkBuddy 生成的摘要 tags: [标签1, 标签2, 标签3] created: 2024-01-15 ---

有了这些元数据，你就可以用 Obsidian 的 Dataview 插件做各种查询。比如"列出所有标签包含'机器学习'且创建时间在最近一个月的笔记"，或者"按标签统计我的笔记分布"。

批量处理的流程是：把一批笔记导出到一个临时文件夹，用 WorkBuddy 批量生成摘要和标签，然后用脚本把结果写回每篇笔记的 frontmatter。这个脚本用 Python 写很简单，核心就是读文件、调 API、写文件。

5.2 用双链和 AI 构建知识网络

Obsidian 的双链是手动建立的，但 AI 可以帮你发现"应该建立但还没建立"的链接。我的做法是：定期把一批相关笔记喂给 WorkBuddy，让它分析这些笔记之间的关联，推荐应该添加的双链。

比如我写了三篇笔记分别讲"Python 装饰器"、"Python 上下文管理器"和"Python 生成器"，WorkBuddy 会告诉我这三篇都涉及"Python 高级特性"这个主题，建议我创建一个 MOC（Map of Content）笔记来汇总。MOC 是 Obsidian 社区的一个概念，就是"内容地图"，用一篇笔记来组织和链接某个主题下的所有相关笔记。

这种 AI 辅助的知识网络构建，比手动整理效率高太多了。我现在的知识库里已经有几十个 MOC，每个 MOC 下面链接了几十篇笔记，形成了一个层次分明的知识体系。

5.3 基于知识库的问答

这是我觉得最酷的功能：把整个知识库作为上下文，向 WorkBuddy 提问。比如我问"我之前关于时间管理写过什么"，它会检索我的笔记，找到相关内容，然后总结成一段回答。

实现方式有几种：一种是把笔记导出成纯文本，拼接后作为 prompt 发给 WorkBuddy；另一种是用支持 RAG（检索增强生成）的工具，先做向量化索引，再基于相似度检索。前者简单但受限于上下文长度，后者复杂但能处理大规模知识库。

我目前用的是第一种方式的简化版：按主题把笔记分组，每次只把相关主题的笔记发给 WorkBuddy。比如问时间管理的问题，就只发"生活"文件夹下的笔记。这样既控制了上下文长度，又保证了相关性。

6. 常见问题与排查实录

6.1 Git 同步冲突怎么解决

冲突是新手最容易慌的问题。其实没那么可怕，Git 会把冲突的文件标记出来，你打开文件会看到类似这样的内容：

<<<<<<< HEAD 这是你本地的版本 ======= 这是远程的版本 >>>>>>> origin/main

你需要做的就是：决定保留哪个版本，或者手动合并两个版本，然后把<<<<<<<、=======、>>>>>>>这些标记行删掉。保存后git add再git commit就解决了。

预防冲突的最好方法是养成"先 pull 后 push"的习惯。如果冲突频繁发生，可以考虑用 Obsidian 的 Git 插件，它会在启动时自动 pull，关闭时自动 push。

6.2 Obsidian 打不开或者卡顿怎么办

Obsidian 打不开最常见的原因是插件冲突或者配置文件损坏。排查步骤：先尝试在启动时按住Ctrl（Windows）或Cmd（macOS），这会以安全模式启动，不加载任何第三方插件。如果能打开，说明是某个插件的问题，逐个禁用排查。

如果是卡顿，先看笔记数量。Obsidian 处理几千篇笔记没问题，但上万篇加上大量插件可能会卡。优化方法：减少插件数量、关闭不需要的实时预览、把大附件（图片、PDF）移出仓库用链接引用。

6.3 WorkBuddy 处理结果不理想怎么调

AI 处理结果不理想，九成是 prompt 的问题。我的经验是：给 AI 的指令要具体、要有示例。比如不要只说"帮我打标签"，而要说"帮我从这篇笔记中提取 3-5 个标签，标签应该是名词或名词短语，长度不超过 6 个字，参考这些示例：机器学习、时间管理、读书笔记"。

另外，处理长笔记时，分段处理比整篇丢进去效果更好。因为 AI 的注意力是有限的，太长的输入会导致它"忘记"前面的内容。我的做法是把长笔记按段落切分，每段单独处理，最后合并结果。

6.4 Gitee 推送失败怎么办

推送失败最常见的原因是 SSH 密钥没配置好，或者远程仓库地址写错了。排查步骤：先ssh -T git@gitee.com测试连接，如果失败就重新配置密钥。如果连接正常但推送失败，检查git remote -v看远程地址是否正确。

还有一种情况是远程仓库有本地没有的提交（比如你在网页上直接改了文件），这时需要先git pull --rebase把远程改动合并进来，再推送。

7. 我踩过的坑和总结的技巧

第一个坑：不要把.obsidian文件夹整个忽略掉。我一开始觉得配置文件夹没必要同步，结果换电脑后所有插件、主题、快捷键都要重新配一遍，浪费了一下午。正确的做法是只忽略workspace.json这类设备相关的文件，其他配置都同步。

第二个坑：图片和附件不要直接放仓库。我早期把截图直接粘贴到笔记里，Obsidian 会把图片存到仓库的 attachments 文件夹。时间一长，仓库体积暴涨，Git 推送越来越慢。后来我改用图床，笔记里只存图片链接，仓库体积一下子降下来了。

第三个坑：提交信息要写清楚。我一开始都是git commit -m "更新"，结果后来想回滚某个改动时，面对几百条"更新"完全不知道哪条是哪条。现在我的提交信息格式是"日期+主要改动"，比如"2024-01-15 新增 Python 装饰器笔记，更新 MOC"。

第四个坑：WorkBuddy 的 API 调用要加错误处理。批量处理笔记时，偶尔会遇到网络超时或者 API 限流。如果不加错误处理，脚本跑到一半挂了，前面的结果可能丢失。我的做法是每处理一篇笔记就写一次文件，并且记录处理日志，失败了可以从中断处继续。

最后一个技巧：定期做仓库清理。Git 仓库会随着提交次数增加而变大，虽然纯文本增长很慢，但偶尔做一次git gc压缩一下历史记录，能让仓库保持轻量。另外，如果某些笔记确定不要了，用git rm删除而不是直接删文件，这样历史记录里还能找回来。

这套组合我用了大半年，最大的感受是：工具是次要的，习惯才是核心。Obsidian 再好，你不写笔记也没用；AI 再强，你不整理知识库它也帮不了你。我的建议是先用最简单的配置跑起来，养成每天写、每天同步的习惯，然后再逐步引入 AI 处理和自动化。一步一步来，比一上来就追求完美配置要靠谱得多。