一、那晚卡住的第三步

上个月我接了一单,五十块,帮人把一套 AI agent 的记忆同步到另一台电脑。

我在自己机器上做了无数遍:建一个私有仓库,生成一个访问令牌,粘进配置文件,git push,完事。

那晚的顺序是这样的:他注册了 CNB 账号(花了二十分钟,中间问了两遍”实名认证在哪”);建仓库时选成了”密钥仓库”,git 和 API 都读不了,返工;改好之后要生成访问令牌——他打开页面,看到”权限范围”那一堆勾选框,停住了。

最后他说:“我搞不来了,钱你照常收。”

这句话我记了很久。不是因为这单没做成,而是因为它精确地标出了这套方案的死点:它不是难,它是”把一个内部工具的使用成本,转嫁给了不该承担它的人”。

我们做 AI 工具的人有个毛病:在自己的机器上跑通一次,就默认所有人都能跑通。可现实是,一个平时只用微信和 WPS 的人,面对”权限范围:repo-code 读写”这种选项,第一反应不是谨慎,是恐惧——他不知道自己点下去会发生什么。

二、记忆为什么必须离开机器

再往前一步看,问题其实更大。

现在你在任何一个 AI 客户端里积累的”记忆”——你的偏好、你在做的项目、上次定的方案、踩过的坑——全部绑在这台机器上,绑在这个客户端里。

换个客户端,归零。换台电脑,归零。客户端升级、账号封禁、公司换设备,归零。

有些产品做了云端记忆,但那是另一种归零:你看不见它、导不出它、搬不走它。它存在别人的数据库里,以你不认识的格式,按你不了解的规则做摘要——等你需要它准确的时候,它给你一段”总结”。

我想要的其实很简单:

记忆是文本,存在我自己的仓库里,任何客户端都能读,我随时能 git log 看它怎么变的。

三、memshard 是什么

一句话:一份 skill 文本 + 一套 Git 仓库约定。

  • 不是 MCP server(那要装、要配、要开端口)
  • 不是 SaaS(那要看别人的脸色)
  • 不是插件(那是给某一个客户端做的)

它是一段能被任何 AI 读懂的操作说明书:你把这个文件丢给 Claude Code、给 Codex、给 Cursor、给任何自建 agent,它就学会了怎么在你的仓库里读记忆、写记忆。

为什么是 skill 而不是程序?因为 skill 是零安装的。你不需要 npm install,不需要改 settings.json,不需要重启客户端。你只要说一句”这是我的记忆仓库,地址在这里”,剩下的它自己会做。

四、三条铁律,是从事故里长出来的

这套东西不是设计出来的,是被事故逼出来的。我自己踩过最狠的一次:

一个仓库的 origin 同时指向了两个远端。执行 git pull --rebase 之后,rebase 在我的源码上冲突卡死;接着一个 git checkout,把几个被跟踪的文件删了。agent 启动就报错——我用”同步记忆”这个动作,把正在干活的机器搞死了。

所以我给自己定了三条规矩,写进了协议里,AI 必须遵守:

  1. 仓库隔离 —— 记忆仓库和项目仓库永不混用,AI 只能在记忆仓库里执行 git。
  2. 按设备分片、只追加 —— 每台机器只写自己那一个文件,合并就是并集,结构上不可能冲突。
  3. 禁止重写历史 —— rebase、reset --hard、push -f、checkout .、clean -fd 全部禁止。允许 merge,因为它只增不改。

第三条我改过一次。最初写的是”只允许 fast-forward”,写文档的时候发现它自相矛盾:两台机器都提交过之后,ff 必然失败——那就等于每次同步都掉进降级模式。而分片不重叠,merge 在数学上不可能冲突。正解是允许合并、禁止重写。

五、怎么开始(现在只要两步)

1. 在 CNB / GitHub 建一个私有仓库(名字随你)
2. 把 SKILL.md 丢给你的 AI,说:这是我的记忆仓库

它会在仓库里建出这样的结构:

devices/
  win-main-7f3a/facts.md     # 这台机器只写自己这一片
  win-laptop-9c21/facts.md
INDEX.md                     # 唯一索引,只有 primary 能改
profile.md                   # 长期画像

之后每次会话结束,它会往里追加几行事实;每次会话开始,它先读索引,再按需检索。你不需要记住任何命令——你只需要偶尔 git log 看看它写了什么,不满意就改,改错了就回滚。

六、关于隐私,说清楚三件事

  1. 记忆在你自己账号的仓库里。 我们没有服务器,没有数据库,没有后台。(连官网都是这篇静态博客。)
  2. 将来接了 CNB OAuth,走的是设备授权流程。 令牌直接进你的本机,不经过任何第三方服务器——我们连”中转一下”的机会都不给自己留。
  3. 授权范围是可以自己选的。 你可以在授权时只勾”读写我自己建的仓库”,我们也只申请这一项。

七、这件事不赚钱,为什么还做

因为那一单的五十块,本来就不该收得那么难看。

一个东西如果必须”有人教你装”,那它就还不是产品,是一个需要师傅的手艺。我想要的是:你把这个链接发给朋友,他自己就能用起来,中间不需要任何人解释。

如果你也被”记忆绑在机器上”这件事烦过,可以去仓库看看,或者直接把那句话发给你的 AI:

这是我的记忆仓库:https://cnb.cool/<你的名字>/<仓库名>,读一下 SKILL.md,以后按它来。

AI 的记忆应该跟着人走。人换机器,机器不该有脾气。