01 / SESSION

会话

后台服务器持续持有真实终端进程。

02 / WORKSPACE

工作区

当前项目：kane_echoes

03 / TAB

标签页

当前标识：w1:t1

04 / PANE

窗格

当前标识：w1:p1

05 / AGENT

智能体

OMP 已被 Herdr 识别。

06 / DETACH

分离

客户端离开，后台进程继续运行。

THE RUNTIME FIELD MANUAL

让智能体持续运行
随时回来接管

一份基于当前机器实测状态制作的中文操作手册。理解 Herdr 的五层结构，掌握分屏、智能体检测、分离、重连与安全停止。

Herdr 0.8.0 stable server running OMP detected

开始 60 秒演练先看心智模型

当前验收快照 workspace w1 / tab w1:t1

w1:t1 +

pane w1:p1 / OMP

› current task

Understand and set up Herdr

agent detected · integration current (v8)

cwd /Users/kanehua/project/kane_echoes

runtime

server running

client 0.8.0

protocol 19

compatible yes

01 / CONCEPT MODEL

先建立正确的五层结构

Herdr 把后台运行能力、项目组织、终端布局与智能体状态分开管理。按层理解，之后所有鼠标与 CLI 操作都会变得直接。

Session
Workspace
Tab
Pane
Agent

Sessiondefault session

默认会话

background server

Workspacekane_echoes · w1

kane_echoes

w1

Tabw1:t1

当前标签页

w1:t1

Panew1:p1

当前窗格

w1:p1

Agentrecognized process

OMP

idle

02 / FIRST RUN

六步掌握日常操作

左侧是步骤索引，右侧会随滚动切换真实操作场景。也可以直接单击任一步骤。

STEP 01

从鼠标开始

Herdr 的整个界面都可以直接点击。新用户无需先记快捷键。

CLICK聚焦单击工作区、标签页、窗格或智能体。

RIGHT CLICK打开操作菜单创建、分屏、重命名或关闭。

DRAG BORDER调整大小拖动分隔线改变窗格比例。

DRAG TEXT复制文本拖动选择终端文本即可复制。

STEP 02

把 prefix 当作顺序，而不是组合键

Ctrl+B松开 →操作键

快捷键帮助prefix+?

新建标签页prefix+c

向右分屏prefix+v

向下分屏prefix+-

窗格移动prefix+h/j/k/l

分离客户端prefix+q

以 prefix+? 显示的当前绑定为准。向下分屏时，最后按下的是 - 键。

STEP 03

在新窗格中启动 OMP

在空闲 shell 窗格中正常运行 OMP。Herdr 会自动识别进程，并在侧边栏显示生命周期状态。

new paneshell ready

omp

Herdr detects: omp

integration current (v8)

当前进程早于集成安装而启动；此后新启动的 OMP 进程将加载集成。

STEP 04

分离客户端，后台继续运行

Ctrl+B松开 →q

CLIENT已分离

HERDR SERVER仍在运行

PANES进程继续

在 Herdr 外部的普通终端重连default session

herdr

不要在当前 Herdr 窗格中运行不带参数的 herdr；嵌套启动会被阻止。

STEP 05

明确破坏性停止边界

分离只关闭客户端连接。下面的命令会停止服务器，并终止其窗格进程。

危险命令terminates pane processes

herdr server stop

布局之后可以恢复，受支持的智能体对话也可能恢复；普通命令、开发服务器与其他任意进程已经终止。

03 / SAFETY BOUNDARY

分离与停止，后果完全不同

这是 Herdr 最重要的操作边界。先判断你是要“离开界面”，还是要“终止所有运行内容”。

Detach / safe exit

`prefix+q`

客户端离开。后台服务器、窗格、智能体、开发服务器与测试进程继续运行。

Herdr serverrunning

Pane processesrunning

Agent sessionlive

Server stop / destructive

`herdr server stop`

服务器停止，窗格中的原始进程消失。布局与部分智能体会话可恢复，但任意运行命令不会继续。

Herdr serverstopped

Pane processesterminated

Arbitrary commandsgone

04 / 60 SECOND DRILL

完成一次最小闭环

逐项勾选。这个演练覆盖帮助、分屏、命令、窗格切换、分离与重新连接。

打开快捷键帮助prefix+?
创建右侧分屏prefix+v
在新窗格确认目录pwd
用鼠标切换窗格click pane
分离并从普通终端重连prefix+q → herdr

05 / DIAGNOSTICS

四类证据，定位大多数问题

命令均来自 Herdr 官方指南与当前安装版本。先检查状态，再读取解释；不要猜测快捷键、检测规则或恢复行为。

Runtime

客户端与服务器

确认版本、协议、socket 与兼容性。

herdr status

Agents

智能体检测

查看 Herdr 当前识别到的智能体与状态。

herdr agent list

Integrations

集成版本

当前 OMP 集成为 current (v8)。

herdr integration status

Explain

为什么被判定为这个状态

agent explain 会给出检测依据、回退原因与阻塞信号。目标必须是唯一智能体名称或承载智能体的窗格 ID。

herdr agent explain <target> --json

Config

查看与重载配置

当前没有自定义配置文件，默认配置正在生效。

herdr --default-config

herdr server reload-config

Logs & Paths

默认会话日志与配置位置

~/.config/herdr/herdr.log
~/.config/herdr/herdr-client.log
~/.config/herdr/herdr-server.log
~/.config/herdr/config.toml