文档目录

入门

概念

系统里有哪些东西,它们怎样连起来。

你面对一个 Agent Desk。Desk 连着你的每台电脑;每台电脑上的 Daemon 替 Desk 启动 Harness 会话、执行 Shell、操作仓库。做什么、怎样流转,由 Git 里的插件决定。

机器上的东西

名字 是什么
Agent Desk(Desk) 你的中心:界面的宿主、引擎、数据库。每个用户一个。它自己不检出任何仓库
Client 接入 Desk 的一台电脑,只属于一个 Desk
Client Daemon(Daemon) Client 上常驻的进程。主动连 Desk,替它在本机启动 Worker、执行 Shell、开控制台、操作仓库、构建界面
Harness 装在 Client 上、会讲 ACP 的 Agent 程序。每个 Harness 有一条定义,写明怎样启动它
Worker 系统启动的一个 Harness 会话。在引擎和界面眼里,所有 Worker 都一样
计算与环境 一个会话的两个「在哪」:Harness 在哪台 Client 上跑,对着哪台 Client 的哪个目录干活。可以不是同一台
Shell 执行 在某个 Client 上非交互地跑一条 PowerShell 或 Bash 命令,拿回结构化结果
控制台 你在界面上开的交互式终端
ail 命令行 Agent 在会话的 shell 里、你在终端里向 Desk 办事的入口

插件

名字 是什么
插件目录 Daemon 启动时指定的目录,这台 Client 上的插件都平铺检出在里面
主仓 全局入口,本地目录或 Git 仓库。登记其余所有插件,放 Journal
官方默认插件 系统自带的一套角色、工作流、Harness 定义、提示词和基础界面。落到插件目录后就是一个普通的 Git 仓库,照自己的需要改
Repo 插件 一个要在里面干活的 Git 仓库。接入只要 Git 链接、名字和描述
角色 一份角色说明,加上它的绑定:在哪台 Client 上启动、用哪个 Harness、哪个模型、多大的思考强度
工作流 一个意图对应的步骤序列:每一步由哪个角色做、有没有评审关口
界面插件 一份 React 界面的源码,构建后由 Desk 分发给浏览器

角色与工作流全局只有一套,不按仓库各写各的。某个仓库要禁用或限定其中几个时,在它的登记里声明。

工作

名字 是什么
Router 你说话的对象,一个常驻的 Worker。只做判断:这件事是什么意图、归哪个 Repo,然后派发
运行 为一个请求把一个工作流走一遍。每一步是一个 Worker;带评审关口的步骤另有一个评审者
报告块 Worker 每轮回复末尾给引擎的一段结构化数据:做到哪了、要不要你回答、多久后叫醒它。引擎只按它流转
工作流组织 一个运行,加上它直接或间接触发的全部运行
Review Report、Presentation Report Worker 推给你的页面:前者要你回答,后者给你看结果
任务与地图 仓库里的任务记录;一件大事由架构师规划成地图,引擎照依赖派出任务
Journal 你的历史:做过什么、交付了什么。主仓里的文件,只有引擎写
看板 引擎给你的一览:哪些运行在等你、在进行、已结束

五条主要的路

  1. 派一件事。 你对 Router 说,Router 用命令行派发,引擎建立运行并启动第一步的 Worker。Worker 干活,一轮结束时在回复末尾带报告块,引擎照它送评审、进下一步或收尾。
  2. 问你。 Worker 推一份 Review Report,你在 Desk 上回答,回答直接排进这个 Worker 的队列,不经 Router。
  3. 直接开会话。 在创建会话页选 Client、文件夹和 Harness,得到一个会话页,直接对话。
  4. 跨端 Shell。 Agent 或你用命令行指定目标 Client 和命令,Desk 核对授权,目标 Daemon 执行,结果原路返回。
  5. 改插件。 改插件里的文件,Daemon 发现变化:角色、工作流下一次用到时生效,界面重新构建后刷新生效。

发给忙着的会话的任何消息都排队,等它这一轮结束再送。