让 Pi Agent 学会「影分身」：多台机器，一个大脑
我用的 AI 编程助手叫 Pi Agent，跑在终端里。在公司电脑上，它特别顺手。技能装了不少，编码规矩定了一堆，连提示词都攒了几十段。它懂我的项目，懂我的口味。
回家打开另一台电脑，同一个工具，它一脸茫然。技能没了，规矩没了，又变回出厂设置的那个实习生。
那一刻我意识到：我养熟的不是工具，是一份配置。而这份配置只活在公司那台电脑里。
你调教的不是工具，是"大脑"
拿 Pi Agent 来说，它不是装完就完事的死软件。它会"长"：你加一个技能，它多会一件事；你定一条规矩，它多懂一个分寸。日积月累，这台机器上的 agent 长成了只属于你的样子。
技能、规矩、提示词、扩展、设置，这些东西就是 agent 的大脑。
问题是，大脑长在这一台机器里。换个机器，大脑不跟着走。
核心矛盾：越个性化，越难同步
麻烦在于它是个活的、一直在变的东西。
配置如果是死的，复制一份过去就完事。但它不是。这周加个技能，下周改条规矩，两台机器各改各的，很快就长歪了，你都不知道哪台才是"最新版的自己"。
手动同步我试过。每次改完还得记着"这个要拷到另一台"。然后就没有然后了，人不可能每次都记得。
这就像在 A 电脑养了只电子宠物，B 电脑重新养一只，还得手动把两只的状态对齐。养着养着就弃坑。
思路：把配置当代码管
转机是个朴素的念头：程序员怎么管理"一直在变、还得多处同步"的东西？
代码。放进版本仓库，改了就提交，要同步就拉取。这套东西用了几十年。
Pi Agent 的配置凭什么不能这么管？技能是文件，提示词是文件，规矩是文件，设置也是文件。全是文件，全可以进仓库。
思路一通，剩下三个动作。
第一招：给配置安个"家"
把所有配置收进一个版本仓库。这个仓库就是 agent 大脑的本体。我放在私有仓库里，毕竟里面是你的工作习惯和项目细节，没必要公开。
注意，有些东西不能进仓库，比如 API 密钥。我的做法是两层：auth.json、models.json 这类带密钥的文件直接写进 .gitignore，每台机器各留一份本地的；还有一类密钥放环境变量。原则就一条：仓库里不出现明文密钥。
这是我踩过的坑：密钥一旦进了仓库，就等于半公开了，只能作废、重新生成。
第二招：让"活配置"指向仓库
这是最关键、也最容易忽略的一招。
工具真正读取的配置，在你电脑上有个固定位置。默认情况下那是一份独立的副本，你改它，跟仓库没关系。
要让同步生效，得用软链接：把活配置目录直接"指"向仓库。
打个比方。以前每台电脑养各自的宠物（副本），现在改成宠物统一寄养在中央仓库，每台电脑看到的是一个投影。你改投影，本体就变；本体变了，所有投影跟着变。
这一步不做对，后面全白搭。我第一台机器就是复制模式，改了半天配置，仓库纹丝不动，因为我改的是副本，不是本体。
第三招：让同步自己跑
前两步做完，还差一脚：总不能每次改完都手动提交、手动拉取吧，那跟手动复制有什么区别。
所以让它自动。两个时机就够：
对话结束时，自动把本机改动提交、推上去。Pi Agent 启动时，自动把别处的更新拉下来。
就这么两个钩子，配置在机器间自己流动。你在 A 机器教会 agent 一个新技能，B 机器下次启动就会了。不用记，不用拷。
新机器接入：十分钟的事
这套跑通之后，我又补了两件小事，让"影分身"更完整。
第一件，给仓库写了安装脚本和 README。新电脑到手，clone 仓库、跑一下脚本，软链自动建好，密钥交互式填进本地文件，十分钟就能加入同步网络。
第二件更有意思：我在 AGENTS.md（agent 每次启动都会读的全局规矩）里加了一段，告诉 agent 它自己的配置是怎么同步的。共享仓库在哪、哪些文件是软链、同步是自动的、出问题去读 README。以前是人在维护这套机制，现在 agent 自己也知情，改配置的时候它知道自己在改"本体"。
一些掏心窝的提醒
把这套跑顺之后，几个坑想提前告诉你：
软链还是复制，一开始就要选对。复制模式下，自动同步根本感知不到你的改动。我第一台就栽在这，后来把配置备份好、重新软链，才打通。
动活配置前，先备份。软链这步会动你正在用的配置，万一搞砸，有备份就能一键回退。别裸奔。
密钥永远不进仓库。再说一遍，因为真的重要。.gitignore 里第一行就写它。
拉到的更新，可能要重启才生效。工具启动时已经把配置读进内存了，中途拉到的更新，重启或刷新一下才真正用得上。
最后
这套东西跑了一个多月，我没再手动拷过一次配置。上周新到一台电脑，从 clone 到 Pi Agent 恢复记忆，花了不到十分钟。
你的 Pi Agent 也该学会影分身了。
如果觉得有用，点个在看，转发给同样在多台电脑上折腾 AI 的朋友。
有什么调教 agent 的心得，欢迎在评论区聊聊，每一条留言我都会看。