企业官网建设流程全解析

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 git@gitee.com:你的用户名/仓库名.git git add . git commit -m "初始化知识库" git push -u origin master

SSH 密钥配置是新手最容易卡住的地方。流程是：本地生成密钥对，把公钥复制到 Gitee 的 SSH 公钥设置里。生成命令：

ssh-keygen -t ed25519 -C "你的邮箱"

生成的公钥在~/.ssh/id_ed25519.pub，用文本编辑器打开复制全部内容，粘贴到 Gitee 设置里的 SSH 公钥区域。测试连接：

ssh -T git@gitee.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 同步的完整操作流程

日常同步流程我简化成了三个动作：

1. 拉取更新：每天开始工作前，在 Obsidian Git 插件里点一下“Pull”，把其他设备的变更拉下来。
2. 编辑笔记：正常使用 Obsidian 和 WorkBuddy，所有变更自动保存到本地文件。
3. 提交推送：完成一个阶段的工作后，打开 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 Copy，Android 上可以用 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 常见问题速查表

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 能力增强，版本管理护航。