前言

一直想给自己搭一个像样的个人知识库。之前笔记散落在各种地方：微信收藏、浏览器书签、随手建的 txt、还有一堆下载下来就再也没打开过的文档。想找的时候永远找不到，属于典型的”收藏即吃灰”。

趁着这两天有空，索性从零折腾一套：本地起步、方便迁移、能白嫖 AI、还能多设备同步。目标很朴素——以后想找的东西，得能找得到。

这篇就把整个过程记录一下，方便自己以后回顾，也给有同样需求的朋友做个参考。

技术选型

先说结论，最终方案是：

Obsidian（本地笔记） + Git（版本同步） + 国产大模型（AI 辅助整理）

选型的考虑：

• Obsidian：纯本地 Markdown 文件，数据在自己手里，不绑定任何云服务，随时可迁移。双向链接和图谱是加分项。
• Git 同步：不想为了同步单独付费买官方 Sync，正好自己会用 Git，用仓库托管既能版本管理又能多设备同步，一举两得。
• AI 辅助：现在整理笔记如果全靠手动，太累了。接一个大模型进来，让它帮忙提炼摘要、打标签、做分类建议。

对我来说，这套组合的最大好处是 零订阅成本 + 数据自主可控。

安装 Obsidian

这步没什么好说的，官网下载安装包，装到自己指定的目录即可。装完新建一个 Vault（笔记库），我把它放在了一个专门的目录里，后面所有笔记都在这个文件夹下。

配置 Git 同步（踩坑重点）

Obsidian 本身不带同步，社区有个很成熟的插件 Obsidian Git，可以做到定时自动 commit + push，非常省心。

坑一：插件市场慢，GitHub 连不上

第一个坑就来了。装插件的时候搜索半天转圈，而且很多资源走的是 GitHub，直连基本没戏（这个大家都懂）。

解决办法两个：

1. 插件手动安装：从仓库下载插件的三个文件（main.js、manifest.json、styles.css），直接丢进 Vault 的 .obsidian/plugins/插件名/ 目录，重启 Obsidian 就能识别。
2. GitHub 资源走镜像：直连不行就用公共镜像加速（比如 gh-proxy.com 这类前缀代理），下载成功率高很多。

小技巧：下载的时候记得看一下 HTTP 状态码和文件大小，别下了个几 KB 的错误页面还以为成功了。我就吃过这个亏——命令把错误输出吞掉了，结果下了个空文件还一脸懵。

坑二：远程仓库选哪个

既然 GitHub 直连不稳定，远程仓库我就直接选了国内的 Git 托管平台，建了个私有仓库专门存笔记。配好 SSH 公钥之后，git push 一路畅通，比折腾 GitHub 代理省心多了。

配置流程大致是：

# 在 Vault 目录初始化
git init
git remote add origin <你的私有仓库地址>

# 配好换行符，避免 Windows 下一堆 CRLF 警告
git config core.autocrlf true

# 首次提交
git add -A
git commit -m "init: 知识库初始化"
git push -u origin main

然后在 Obsidian Git 插件里打开自动备份，设置每隔几分钟自动 commit、拉取，之后就完全不用管了，写完笔记它自己同步。

敏感信息别进仓库

这里有个容易忽略的点：插件的配置文件里可能存了 API Key 等敏感信息，千万别一股脑提交上去。我在 .gitignore 里排除了这些：

.obsidian/workspace.json
.obsidian/plugins/*/data.json
.trash/

其中 plugins/*/data.json 就是关键——AI 插件的配置（含 Key）都在里面，排除掉就不会同步到远程仓库。

接入 AI 辅助

笔记工具接 AI，我用的是社区里口碑不错的 Copilot for Obsidian 插件。它支持自定义 OpenAI 兼容接口，所以可以接各种大模型。

我直接接了一个国产大模型（就是平时对话在用的那个），填好接口地址和 Key、勾上支持工具调用/图片/推理这些选项，测试对话正常，搞定。

接完之后的体验是：

• 写完一篇笔记，选中正文让它生成摘要、补充标签
• 读书笔记让它帮忙提炼核心观点和行动项
• 一堆零散资料丢给它，让它建议归到哪个分类

不过这里也要泼盆冷水：Copilot for Obsidian 只能生成文本，不能直接操作文件系统（这是插件架构决定的）。也就是说，它给你整理好内容，你还得手动复制粘贴、手动建文件、手动归档。想要”AI 直接读写笔记文件”的全自动体验，得靠别的工具或脚本。

笔记怎么组织：PARA + MOC

工具搭好只是第一步，怎么组织才是知识库能不能用起来的关键。我用的是目前比较主流的一套方法论组合：

PARA —— 按”可执行性”给笔记分四类：

• Projects（项目）：有明确目标和截止时间的事
• Areas（领域）：需要长期维护的责任领域
• Resources（资源）：将来可能用到的参考资料
• Archives（归档）：已完成/不活跃的内容

在这个基础上我加了自己的文件夹（工作、生活），最终目录大致长这样：

00-Inbox/        # 收件箱，来不及分类的先扔这
01-Projects/     # 项目
02-Work/         # 工作相关
03-Life/         # 生活相关
04-Resources/    # 参考资料
05-Archives/     # 归档
06-MOC/          # 索引笔记（Map of Content）
99-Templates/    # 模板

MOC（Map of Content，内容地图） —— 简单说就是”目录笔记”。不靠文件夹硬分类，而是建一篇索引笔记，用双向链接把相关笔记串起来。比如建一篇《求职复习》的 MOC，把所有面试、复习相关的笔记都链进去，查找的时候从这一篇入口就能进去。

一个重要的认知纠正：Inbox 不会自动分类。它只是暂存区，需要你定期（比如每周）手动把里面的东西整理到对应文件夹。指望”扔进去就自动归位”是不现实的，除非上专门的自动化插件或脚本。

一个实战小例子

方法论说再多不如实操一次。我把本地一批零散的 Markdown 资料整理进了知识库，走了一套后来固定下来的模式：

1. 原始文档归档：把原始文件复制进 Vault 的资源目录，跟着 Git 一起同步（不依赖外部路径，换电脑也不丢）
2. 汇总笔记：把散落在多个文档里的相同内容，按主题重新归类去重，整合成一篇结构化的速查笔记
3. 内部链接互引：汇总笔记里用 [[双链]] 指向原始文档，速查和溯源两不误

这里踩了个小坑值得记一下：一开始我图省事，汇总笔记里用 file:/// 外链指向 Vault 外的原始文件。看着能用，但这种外链依赖绝对路径，换台电脑或挪个位置就全失效了。后来老老实实把原始文档也复制进 Vault、改成内部双链，才算真正”归档”——数据都在一个库里，跟着 Git 走，迁移零负担。

总结

折腾一整天，最后沉淀下来的其实就几句话：

• 数据自主：纯本地 Markdown + 自己的 Git 私有仓库，不看任何云服务脸色
• 成本为零：同步靠 Git、AI 白嫖国产模型，一分钱订阅费没花
• 方法比工具重要：PARA 管分类、MOC 管索引、模板管格式，工具再好没方法也是一堆乱文件
• AI 是助手不是保姆：它能帮你提炼、建议，但归档、整理的最终决策还得自己来

知识库这东西，搭起来只是开始，能不能坚持用、坚持整理才是关键。先给自己立个 flag，每周清一次 Inbox。

下次有新的折腾再来更新。