把笔记交还给 git：这个 2 星知识库有点意思

作者

最近在翻自托管知识库的东西，翻到一个刚冒头的小项目，叫 Atlas Mind。说它小，是真小——GitHub 上才 2 个 star，作者六月底才推到 1.0.0 门口。但理念我挺吃：它把你的笔记当成一堆普通 Markdown 文件，塞进你自己的 git 仓库，然后用一个纯 Python 标准库写的引擎去读它、渲染它、顺便给你的 AI 当外部记忆。

我手里有台 NAS，常年跑着各种自托管服务，笔记这类东西总是最尴尬的——放商业笔记软件里，数据在别人服务器上；自己折腾个 Wiki，又得配数据库、配后端，维护成本劝退。Atlas Mind 的卖点正好戳在这：无数据库、无第三方网络调用、引擎和内容彻底分离。内容是你 git 仓库里的纯文本，引擎是你能一行行读的代码。哪天不想用了，git clone 走人，一个字不丢。

atlas-viewer.jpg

它到底是个什么

Atlas Mind 自称是”self-hostable wiki / knowledge base engine”，外加”你跟 AI 共享的外置大脑”。技术上几个点值得说：

  • git-native：每篇文档就是仓库里一个文件，每次改动都是一次 commit。这意味着你天然有版本历史——它能做 diff、能回到任意旧版本、能看 blame，全靠 git 本身。
  • 纯标准库：整个服务端是 Python 标准库写的 HTTP server，不依赖 Flask、不依赖数据库，前端库和字体都 vendored 进包里。一个 atlas serve ~/my-mind 就起，默认监听 127.0.0.1:8765。
  • AI-native 的真实含义：它暴露一个 MCP endpoint，给了 24 个工具，分六组——读、写、图谱、时间旅行、活动、收件箱。你的 AI 助手（任何支持 MCP 的）可以直接读你的笔记、写新文档、甚至把待整理的东西塞进你的 inbox 等你 triage。

这里”时间旅行”那组工具是我觉得最实用的：doc_history、doc_diff、doc_revert 之类，本质上是把 git 的能力包了一层好用的接口。写错了？回滚。想知道这周改了啥？changelog 一目了然。对常年 hand-write 文档的人来说，这比大多数笔记软件的”历史记录”靠谱得多。

atlas-home.jpg

我为什么留意它

不是因为它完善——2 个 star 的项目谈完善是笑话。是它把”AI 记忆”这件事想得比较清楚。现在大家都在给 AI 接长期记忆，但大部分方案要么把你的聊天记录喂给某个云服务，要么搞一套私有向量库锁死格式。Atlas Mind 的路线是：你的知识本来就是文件，AI 通过开放协议来读你，而不是把你的脑子拽进它自己的格式里。

它还顺手做了些自托管该有的东西：云模式支持账号登录、TOTP 双因素、按文档的访问控制、HMAC 签名的公开分享链接（可设过期）。部署也轻，atlas deploy --target compose|systemd|fly 一条命令出配置。对个人在 NAS 上挂一个只读知识库给家人或自己外网看，够用了。

atlas-demo.jpg

怎么跑起来

环境要求就两条：Python ≥ 3.11，以及内容目录是个 git 仓库。装的过程很省心：

pip install atlas-mind        # 或 uv tool install atlas-mind
atlas init ~/my-mind          # 脚手架：atlas.toml + 示例文档 + git init
atlas serve ~/my-mind         # 构建（必要时）+ 起服务

init 不会覆盖已有文件，进非空目录会拒绝，除非你加 --force。想纯静态导出不服务，用 atlas build ~/my-mind --offline，会出一个能从 file:// 打开的离线包，还能装成 PWA。这点对想把手册打包带走的人很友好。

接 AI 的话，本地就能 mint 一个 MCP token：

atlas token create ~/my-mind --label claude
# 打印出 MCP URL：https://<your-atlas>/mcp/<token>

把它指给你的助手，AI 就能按那 24 个工具读写你的知识库。init 还会顺手生成 AGENTS.md 和 content/agents/、content/ai-sessions/，让 AI 知道你这套笔记的规矩。

atlas-github.jpg

坑在哪

老实说，目前阶段坑不少，列几个我观察到的：

  • 太新太冷：2 个 star、单个作者、六月最后一次 commit（写这篇时是这个情况）。意味着 bug 可能没人帮你踩，文档也可能跟不上。生产环境当主力笔记？再等等。
  • 单实例单 mind：明确说了不是多租户 SaaS，一个实例服务一个知识库。你要多套隔离的知识库，就得跑多个实例，或者用它的云模式账号体系。
  • 不是协作编辑器：它不追求实时多人同编辑，也不做插件市场。如果你要的是 Notion 那种团队实时协同，它从设计上就不在那个赛道。
  • AGPL-3.0：协议比较硬。自己用没问题，但要是想改了挂出去提供服务，得注意合规义务（公开改动）。
  • 默认无鉴权：serve 默认 auth 关着，监听本地回环还好，一旦你映射出去忘了开云模式登录，就是裸奔。部署时记得处理。

值不值得试

我的判断：它适合已经在用 git 管文档、又想给本地 AI 一个干净外部记忆层的人。它的核心不是”又一个笔记 App”，而是把”笔记即文件、引擎可替换、AI 通过协议访问”这件事做得相当彻底。对在 NAS 上折腾自托管、又不想被商业笔记绑架的人来说，方向是对的。

现阶段我把它当玩具和灵感来源，没敢替掉主力。但 2 个 star 不代表没东西——有时候好想法就是从小角落先长出来的。等它 star 过千、commit 稳定了，我大概率会认真挪过去。在那之前，先盯着。

发表评论