核心概念

Herdr 是一个终端工作区管理器。它让真实的终端进程持续运行,并在其之上添加结构。

工作区

工作区是最顶层的项目容器。为每个仓库、任务或调查使用一个工作区。

工作区拥有标签页和窗格。它在侧边栏中的状态由内部的智能体汇总而来,让你一眼看出哪个项目需要关注。

标签页

标签页是工作区内的一种布局。用标签页来分隔不同视图,比如 agents、logs、server 或 review。

标签页可以通过 CLI 和 socket API 寻址。

窗格

窗格是一个真实的终端。Herdr 渲染终端输出,把输入传回进程,并在客户端分离后保留窗格。

窗格可以向右或向下分割。它们可以手动重命名、通过 CLI 读取、接收输入,以及被关闭。

鼠标 UI

Herdr 是鼠标原生的。你可以点击窗格、标签页、工作区和智能体,可以拖动分割边框、选择文本、使用右键菜单。下文的所有操作都可以用鼠标完成;按键绑定是可选的一层。

如果你偏好纯键盘操作,或者不想让 Herdr 捕获鼠标输入,可以禁用鼠标捕获:

[ui]
mouse_capture = false

智能体

智能体是 Herdr 在窗格内识别出的进程。Herdr 通过前台进程、屏幕清单和可选的集成来检测智能体。

智能体状态如下:

状态	含义
blocked	智能体需要输入、审批或决策。
working	智能体正在运行。
done	智能体已完成,你还没有查看。
idle	智能体已完成或在等待,并且已被查看过。
unknown	Herdr 无法有把握地判断状态。

会话

会话是一个持久的 Herdr 服务器命名空间。默认的 herdr 命令连接到默认会话。

命名会话是彼此独立的运行时命名空间:

herdr session list
herdr session attach work
herdr session attach side-project

优先使用工作区。当你需要完全独立的窗格、socket 和持久化运行时状态时,才使用命名会话。

客户端与服务器

默认情况下,Herdr 以一个后台服务器加一个或多个已连接客户端的方式运行。

服务器拥有窗格和进程状态。客户端是连接到该服务器的终端 UI。

用 ctrl+b q 分离客户端。服务器和智能体会继续运行。

如果想结束会话并停止其中的窗格,停止服务器:

herdr server stop

模式

Herdr 有终端模式、前缀模式和导航模式。

终端模式把按键发送给聚焦的窗格。前缀模式在按下前缀键后等待一个 Herdr 动作。导航模式是常驻的工作区导航界面。

按下前缀键 (默认 ctrl+b),再按一个动作键,比如 c 新建标签页,w 打开工作区导航。第一次接触前缀键的概念?参见键盘。