文档目录
入门
概念
系统里有哪些东西,它们怎样连起来。
你面对一个 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 | 你的历史:做过什么、交付了什么。主仓里的文件,只有引擎写 |
| 看板 | 引擎给你的一览:哪些运行在等你、在进行、已结束 |
五条主要的路
- 派一件事。 你对 Router 说,Router 用命令行派发,引擎建立运行并启动第一步的 Worker。Worker 干活,一轮结束时在回复末尾带报告块,引擎照它送评审、进下一步或收尾。
- 问你。 Worker 推一份 Review Report,你在 Desk 上回答,回答直接排进这个 Worker 的队列,不经 Router。
- 直接开会话。 在创建会话页选 Client、文件夹和 Harness,得到一个会话页,直接对话。
- 跨端 Shell。 Agent 或你用命令行指定目标 Client 和命令,Desk 核对授权,目标 Daemon 执行,结果原路返回。
- 改插件。 改插件里的文件,Daemon 发现变化:角色、工作流下一次用到时生效,界面重新构建后刷新生效。
发给忙着的会话的任何消息都排队,等它这一轮结束再送。