使用指南
多个 agent
在控制台里连接多个运行基座、一键切换;配对码怎么来;同一台设备跑多个 agent。
#一个控制台,多个 agent
控制台(手机 App、Linux 与 Windows 的桌面版,或网页版)可以保存多个连接,每个连接对应一个运行基座,也就是一具身体里的一个 agent。手机上点顶栏的名字、网页版点左上角的头像,打开 切换 列表;切换后,界面的称呼与主题色跟着变。
图表加载中…
#连接新的 agent
顶栏名字 → 连接另一个(连接页上也可以展开「连接另一台设备」填地址):
- 填入运行基座的地址。
- 另一台设备:只填它的 IP 或名字(如
192.168.1.8),App 自动用加密连接https://…:7789。那台设备要对局域网开放(Linux 上用--lan,见 部署到其他机器);没有开放时,先把端口转发到手机上,再填127.0.0.1:<端口>。 - 同一台手机上的另一个基座:填
127.0.0.1:<端口>。
- 另一台设备:只填它的 IP 或名字(如
- 用加密连接时,App 会显示那台设备的证书指纹(如
1a2b 3c4d 5e6f 7a8b)。把它和那台设备上的配对通知(或quetzal status)核对一致。之后这个连接只认这张证书。 - 获取配对码:配对码是 8 位字母数字,5 分钟内有效。它和证书指纹一起,出现在那台设备的系统通知里(由身体适配器的
notify发出)。 - 输入配对码 → 配对。App 保存令牌,之后自动重连。用加密连接时,配对码本身不在网络上传输,App 只发送用配对码与证书指纹算出的证明。
两种情况不需要配对码:这台手机上由向导安装的运行基座,安装脚本已经把令牌直接交给了 App;网页控制台连托管它的那台机器上的运行基座,打开就已登录。
配对码输错超过 5 次或过期就会失效,重新获取一个即可。
#同一台设备上的多个 agent
每个运行基座实例有自己的家目录与网关端口。同一台设备上的另一个 agent 通常用另一个端口(例如 7789)。每个 agent 有自己的灵魂仓库与身份 id,身份守卫保证 ta 们的记忆不会混在一起。
#同一个 agent 的多具身体
一个灵魂、多具身体:几具身体通过灵魂仓库共享人格与记忆,各自写自己的日记。详见 灵魂同步 与 灵魂桥。
#移除连接
在切换列表里可以移除一个连接。移除的只是控制台里的这条连接,那个运行基座和 ta 的记忆都还在。