23/Documentation
术语表
用通俗语言解释 Collie 的概念,并与其他工具使用的名称对照:会话(session)、空间(space)、标签页(tab)、窗格(pane)、终端(terminal)、持久 agent、harness、crew、lead 等
Collie 所用术语的白话释义。每个词条都很简短,并链接到介绍它的页面。若其他工具对同一事物使用了不同术语,词条会予以说明。
Collie(实例)
一个正在运行的 bridge 进程。它提供一个手机 URL 并监视一个终端,还可以并排显示 durable agent。一台主机可以运行多个实例,每个实例都有自己的端口和状态文件夹(单台主机上运行多个 Collie 实例)。
Session
一次 agent 对话。pane 会显示它,Chat 则从 harness 中读取它(会话)。tmux 和 zellij 也将各自的顶级分组称为 session。Collie 将该分组显示为一个 space。
Space
一组标签页,带有一个文件夹。它是手机上的顶层结构。Herdr 工作区是一个 space,tmux session 是一个 space,zellij session 是一个 space,durable agent 也是一个 space。
Tab
一组 pane。Herdr 标签页是一个 tab,tmux 窗口也是一个 tab(终端)。
Pane
可以在手机上打开的单一对象。在终端中,它是一个带有屏幕的 pane。在 durable agent 中,它是一次对话,并且仅在 Chat 中打开。
Terminal (mux)
Herdr、tmux、zellij、tuios 或 Tern,即容纳你的 shell 和 agent 的程序。其他工具称其为多路复用器(multiplexer)或 mux。你可以通过 COLLIE_MUX(终端)来选择它。
Durable agent
作为独立进程运行并具有独立存储的 agent。它通过 durable wire 挂载到 Collie。你可以使用 Durable SDK 或任何提供该 wire 服务的程序来构建。它会自行布局 space、tab 和 pane。该功能处于实验阶段,可通过 collie durable attach(持久 agent)挂载。session 可以是终端 session,也可以是 durable session。API 和代码中仍将该通道称为 program。
Harness
在 pane 中运行的 agent:Claude Code、Codex、pi、OmO 或 durable agent(手机上的 Claude Code)。
Crew
lead 及其 members。它为多台机器提供一个统一的手机 URL(Crew)。单台机器无需 crew 即可同时显示终端和 durable agent。
Lead
与手机通信的 Collie。它会合并其 members 的列表并转发它们的 pane(Crew)。
Member (peer)
加入 crew 的一个 Collie。这两个词含义相同。"member" 是 crew 中的称呼,而 "peer" 是指与另一个 Collie 并排运行的 Collie(Crew)。
Question card (ask)
durable agent 提出的问题。手机会将其显示为卡片,点击一次即可回答一次。Collie 绝不会替你回答(持久 agent)。
Belt
输入框上方的操作栏。其 harness 区域放置了 harness 自身的按钮(配置)。
Starter
“新建”页面上的一行,用于在持久 agent(来自持久 agent 的启动器)中创建新窗格。
Source
sources.json 用于表示单个持久 agent 条目的词。你只会在该文件名及其字段中看到它。手机端不会显示 "source";手机端显示为 durable agent(挂载 durable agent)。
上限规则
持久 agent 声明其能执行的一项操作:asks、starters、send、steer、abort、rename、close、actions、history 或 reopen。手机端仅为该持久 agent 声明的 cap 绘制控件。推送限制也称为 cap,属于不同的概念(来自 durable agent 的推送)。
Hello
持久 agent 发送给 Collie 的第一项内容:它支持的 wire 版本、其 cap 以及其名称。若持久 agent 的版本与 Collie 自身不符,Collie 将不再读取其后续内容(版本)。crew 链接在组长与成员之间也拥有自己的 hello(Crew)。
Epoch
持久 agent 每次启动时生成的标签。会话中的位置仅在单个 epoch 内有效。当 epoch 发生变化时,Collie 会从头重新读取该会话(持久 agent)。
Receipt
记录手机要求持久 agent 执行的操作:回答、发送、停止或点击启动器。它保存请求 id 与结果,并允许重试回放而不会重复运行。Collie 将 receipt 保存在其状态文件夹中(Collie 保存 durable agent 数据的位置)。
会话
手机端的“持久 agents”页面对持久 session 的称呼。会话列表首先显示等待你处理的内容,然后是其他已打开的内容,最后是已关闭的内容(手机显示的内容)。
持久 agents 部分
仪表板上列出每个持久 agent 的分组,每个 agent 占一行。有待处理问题时它会移至工作区上方;未挂载持久 agent 时它不显示任何内容(手机显示的内容)。
Wire
Collie 与持久 agent 之间通信所用的规则:先是 hello,然后是快照、事件和回答。目前只有一个版本,即版本 1。它通过专用套接字或带有令牌的 https 运行(版本)。