文档目录
入门
简介
aiL 是什么、解决什么问题、由哪几部分组成。
aiL 是一套个人 Agent 系统。你只做三件事:提出、决定、验收。其余的活由你自己电脑上的编码 Agent 去做,系统负责派发、流转、评审、合入和记录。
名字和域名来自同一句话:art is Long,出自拉丁谚语 Ars longa, vita brevis。中文里与它相应的是《庄子》的「吾生也有涯,而知也无涯」:生有涯,所以长活不该占着人。
它解决什么
同时用几个编码 Agent、几台电脑干活的人,很快会遇到同一组问题:
- 每个 Agent 一种用法,会话散在各台电脑的终端里,要自己记哪件事在哪。
- 一件事要经过「做、评审、改、合入」,中间每一步都要人来回传话。
- Agent 做完了或者卡住了,没有一个地方能一眼看到。
aiL 把这些收到一处:一个 Agent Desk 连着你的每台电脑,每台电脑上有一个 Daemon 替它启动 Agent 会话。你对 Router 说一句话,系统照工作流把事情做完,只在需要你决定或验收时找你。
由什么组成
每个平台只有一个可执行文件 ail,它有三种用法:
| 用法 | 是什么 |
|---|---|
ail desk |
Agent Desk:界面、引擎和数据库。每个用户一个 |
ail daemon |
Client Daemon:每台电脑一个,主动连向 Desk |
ail <子命令> |
命令行:Agent 在会话里、你在终端里向 Desk 办事的入口 |
Agent 程序称为 Harness。aiL 经 ACP(Agent Client Protocol)启动它们,现在支持五个:claude、codex、dsh、pi、antigravity。在引擎和界面看来,它们启动出来的会话都是同一个 Worker。
做什么、怎样流转,由 Git 里的插件决定:角色、工作流、界面和仓库登记都是文件,改完就生效,不用换可执行文件。
一件事怎样走完
- 你对 Router 说要做什么。Router 只判断这是什么意图、归哪个仓库,然后派发。
- 引擎建立一次运行,在角色绑定的那台电脑上启动 Worker。
- Worker 在自己的 Git worktree 里干活。要你拿主意时,它推一份 Review Report,你在 Desk 上回答。
- 带评审关口的步骤由另一个 Worker 评审。通过后引擎合入改动、归档任务、记一条 Journal。
- 运行结束,带着执行报告留在看板上,等你归档。
每一步的规则见工作流与引擎。
界面
Desk 的界面是一个浏览器里的桌面:
- 看板:每个运行一张卡片,按「需要你、直接沟通、进行中、待归档、已结束」分组。
- 会话页:一个会话一页,像聊天窗口。流式的回复、工具调用记录、续聊,可以附图片。
- 创建会话页:选电脑、选文件夹、选 Harness,直接开一个会话;也可以开 PowerShell 或 Bash 控制台。
- 报告:Worker 推来的评审报告和展示报告,按名字和版本切换。
- Config 页:电脑的配对与授权、主仓、仓库登记、角色与模型的绑定。
窗口窄于 1024 像素时,三栏变成三个可以横滑切换的整页,手机上也能用。
现状
aiL 仍在开发中,二进制和源码尚未公开发布。这里的文档描述它现在的设计和用法。