文档目录
使用
安装与升级
把 aiL 装成常驻、配对各台电脑、升级与回滚。
aiL 的二进制尚未公开发布。这一页描述安装和升级的做法,发布后可以照着做。
交付物
每个平台一个可执行文件:ail-windows-x64.exe、ail-linux-x64。安装、升级、回滚的脚本嵌在可执行文件里,经 ail setup 运行,目标机不用另装运行时。要承载 claude、codex、pi 的 Client 另要有 Node:它们的适配器经 npx 启动。
目录
| Windows | Linux | |
|---|---|---|
| 状态目录 | %LOCALAPPDATA%\ail\ |
~/.local/share/ail/ |
| 可执行文件 | <状态目录>\bin\ail.exe,加进用户的 PATH |
<状态目录>/bin/ail,链接到 ~/.local/bin/ail |
| Desk 的数据 | <状态目录>\desk\ |
<状态目录>/desk/ |
| 插件目录 | 装 Daemon 时用 --plugins 指定 |
同左 |
安装
Desk(你选的一台电脑):
ail setup desk --listen 100.64.0.10:8040它把自己放进状态目录、初始化数据、装成常驻并启动。
--listen写私有网络上的地址:Desk 没有登录,不要暴露到公网。每台 Client:在 Desk 的 Config 页签发一个配对码,然后在这台 Client 上运行
ail setup daemon --desk http://100.64.0.10:8040 --code <配对码> --client-id studio-pc --plugins ~/ail/plugins浏览器打开 Desk 的地址,在 Config 页指定主仓放在哪台 Client。
常驻的做法:
| 系统 | 做法 |
|---|---|
| Windows | 任务计划程序,登录时触发,不要管理员权限;非正常退出时自动重新拉起 |
| Linux | systemd 系统单元 ail-desk.service、ail-daemon.service,Restart=always |
一台电脑上要并存第二套时,ail setup 加 --instance <名>:状态目录、服务名都带上这个名字。
升级与回滚
ail setup upgrade <新的可执行文件>
ail setup rollback
ail setup remove
- 升级只换可执行文件,不动状态目录里的数据和插件目录。
- 几台电脑的先后。 先升只跑 Daemon 的电脑,最后升跑 Desk 的那台;回滚反过来。没照这个顺序也连得住:新版 Desk 不向旧版 Daemon 发它不认得的请求。
- 数据库。 结构在 Desk 启动时逐版升级。新版改了结构时,升级前自动备份数据库。回滚发现上一版读不了现在的数据库时不回滚,报错写明备份在哪、换回备份会丢掉什么,由你决定是否加
--restore-backup。 - 升级时正在进行的轮次记为失败,升级后由引擎请 Worker 接着做。
ail setup remove移除常驻,保留状态目录与插件目录。
检查:各台运行 ail status(已连接)和 ail version(同一个版本)。