让 Pi Agent 学会「影分身」：多台机器，一个大脑

📝

多台机器同步 AI 编程助手配置的方法论：把配置当代码管——git 仓库 + 软链接 + 自动提交/拉取钩子，十分钟接入新机器，彻底告别手动拷贝。

原文作者：进一寸欢喜一寸（微信公众号）｜本文为转载整理

你调教出来的不是工具，是「大脑」

我用的 AI 编程助手叫 Pi Agent，跑在终端里。在公司电脑上，它特别顺手。技能装了不少，编码规矩定了一堆，连提示词都攒了几十段。它懂我的项目，懂我的口味。

回家打开另一台电脑，同一个工具，它一脸茫然。技能没了，规矩没了，又变回出厂设置的那个实习生。

那一刻我意识到：我养熟的不是工具，是一份配置。而这份配置只活在公司那台电脑里。

拿 Pi Agent 来说，它不是装完就完事的死软件。它会「长」：你加一个技能，它多会一件事；你定一条规矩，它多懂一个分寸。日积月累，这台机器上的 agent 长成了只属于你的样子。

技能、规矩、提示词、扩展、设置，这些东西就是 agent 的大脑。

问题是，大脑长在这一台机器里。换个机器，大脑不跟着走。

麻烦在于它是个活的、一直在变的东西。

配置如果是死的，复制一份过去就完事。但它不是。这周加个技能，下周改条规矩，两台机器各改各的，很快就长歪了，你都不知道哪台才是「最新版的自己」。

手动同步我试过。每次改完还得记着「这个要拷到另一台」。然后就没有然后了，人不可能每次都记得。

这就像在 A 电脑养了只电子宠物，B 电脑重新养一只，还得手动把两只的状态对齐。养着养着就弃坑。

转机是个朴素的念头：程序员怎么管理「一直在变、还得多处同步」的东西？

代码。放进版本仓库，改了就提交，要同步就拉取。这套东西用了几十年。

Pi Agent 的配置凭什么不能这么管？技能是文件，提示词是文件，规矩是文件，设置也是文件。全是文件，全可以进仓库。

思路一通，剩下三个动作。

把所有配置收进一个版本仓库。这个仓库就是 agent 大脑的本体。我放在私有仓库里，毕竟里面是你的工作习惯和项目细节，没必要公开。

注意，有些东西不能进仓库，比如 API 密钥。我的做法是两层：auth.json、models.json 这类带密钥的文件直接写进 .gitignore，每台机器各留一份本地的；还有一类密钥放环境变量。原则就一条：仓库里不出现明文密钥。

这是我踩过的坑：密钥一旦进了仓库，就等于半公开了，只能作废、重新生成。

这是最关键、也最容易忽略的一招。

工具真正读取的配置，在你电脑上有个固定位置。默认情况下那是一份独立的副本，你改它，跟仓库没关系。

要让同步生效，得用软链接：把活配置目录直接「指」向仓库。

打个比方。以前每台电脑养各自的宠物（副本），现在改成宠物统一寄养在中央仓库，每台电脑看到的是一个投影。你改投影，本体就变；本体变了，所有投影跟着变。

这一步不做对，后面全白搭。我第一台机器就是复制模式，改了半天配置，仓库纹丝不动，因为我改的是副本，不是本体。

前两步做完，还差一脚：总不能每次改完都手动提交、手动拉取吧，那跟手动复制有什么区别。

所以让它自动。两个时机就够：

就这么两个钩子，配置在机器间自己流动。你在 A 机器教会 agent 一个新技能，B 机器下次启动就会了。不用记，不用拷。

这套跑通之后，我又补了两件小事，让「影分身」更完整。

第一件，给仓库写了安装脚本和 README。新电脑到手，clone 仓库、跑一下脚本，软链自动建好，密钥交互式填进本地文件，十分钟就能加入同步网络。

第二件更有意思：我在 AGENTS.md（agent 每次启动都会读的全局规矩）里加了一段，告诉 agent 它自己的配置是怎么同步的。共享仓库在哪、哪些文件是软链、同步是自动的、出问题去读 README。以前是人在维护这套机制，现在 agent 自己也知情，改配置的时候它知道自己在改「本体」。

把这套跑顺之后，几个坑想提前告诉你：

这套东西跑了一个多月，我没再手动拷过一次配置。上周新到一台电脑，从 clone 到 Pi Agent 恢复记忆，花了不到十分钟。

你的 Pi Agent 也该学会影分身了。