如何掌握 Herdr 标签页管理:创建、跳转、重命名、关闭完整指南
【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr
如果你正在寻找一款适合管理多个 AI 编码代理的终端工具,Herdr 值得重点关注。Herdr 是一个终端工作区管理器("the runtime your coding agents live on"),它让真实的终端进程持续运行,并在工作区之上提供标签页(Tab)、窗格(Pane)等结构化管理能力。本文将带你快速学会 Herdr 标签页的四大核心操作:创建、跳转、重命名和关闭——全部支持键盘与命令行两种方式,新手也能几分钟上手。
标签页(Tab)在 Herdr 中的位置
理解标签页之前,先记住三层结构:
| 层级 | 概念 | 用途 |
|---|---|---|
| 工作区 Workspace | 顶层项目容器 | 一个仓库 / 任务一个工作区 |
| 标签页 Tab | 工作区内的布局 | 区分agents、logs、server、review等视图 |
| 窗格 Pane | 一个真实终端 | 可继续左右/上下分屏 |
标签页的本质是"工作区里的一套终端布局",并且可以通过 CLI 和 socket API 直接寻址,这也是 Herdr 自动化能力的基础。详见概念文档 concepts.mdx 与 src/cli/tab.rs。
如何快速创建新标签页
🖱️鼠标党:直接点击标签栏右侧的新建按钮即可,Herdr 天生支持鼠标操作。
⌨️键盘党(前缀键默认ctrl+b):
- 按下
ctrl+b再按c,即prefix+c,新标签页立刻创建; - 新标签页默认不会抢占焦点,需要时加
--focus参数(CLI 场景)即可选中。
🖥️命令行方式(适合脚本与自动化):
herdr tab create [--workspace <workspace_id>] [--cwd PATH] [--label TEXT] [--env KEY=VALUE] [--focus]常用技巧:
--label 日志:创建时就给标签页命名,省去后续重命名;--cwd /path/to/project:让新标签页从指定目录启动;--env KEY=VALUE:为新终端注入环境变量。
命令返回的 JSON 中,.result.tab.tab_id就是新标签页的 ID,后续所有操作都靠它寻址。
标签页之间快速跳转的方法
日常切换标签页,推荐记住这组快捷键:
| 操作 | 快捷键 |
|---|---|
| 下一个标签页 | prefix+n |
| 上一个标签页 | prefix+p |
| 跳到第 1–9 号标签页 | prefix+1…prefix+9 |
标签页较多时,prefix+1到prefix+9是最快的直达方式,相当于浏览器的数字键切页。
也可以通过 CLI 精确跳转到指定标签页:
herdr tab focus <tab_id> herdr tab list [--workspace <workspace_id>]tab list会列出当前工作区的所有标签页及其 ID,是编写自动化脚本时的第一步。完整键位参考 keyboard.mdx,CLI 全量说明见 cli-reference.mdx。
如何重命名标签页让它一目了然
标签页默认以内容命名,跑多了容易分不清。两种重命名方式:
- 键盘:
prefix+shift+t(即ctrl+b后按Shift+T); - 命令行:
herdr tab rename <tab_id> <label>
建议给长期使用的标签页起固定名字,例如agents、logs、review,之后靠prefix+数字直达,效率会明显提升。
如何关闭标签页(附一个重要细节)
- 键盘:
prefix+shift+x(即ctrl+b后按Shift+X); - 命令行:
herdr tab close <tab_id>。
⚠️重要细节:关闭一个工作区的最后一个标签页时,该工作区也会随之关闭(与界面中关闭标签页的行为一致)。如果你的工作区还关联了 worktree 分组且开启了confirm_close,tab close会返回confirmation_required错误而不是直接关闭,防止误删。
自定义标签栏:位置与右侧状态区
标签栏本身也可以配置,配置模型见 src/config/tab_bar.rs:
- 位置:在
[ui]下设置tab_bar_position = "bottom",可把桌面标签栏移到终端窗格下方,默认为顶部; - 右侧状态区:
tab_bar_right支持最多 16 个条目,类型包括放大状态(zoom)、主机名(hostname)、时间(datetime,默认%H:%M)、自定义文本(text)和定时命令(command,默认每 5 秒刷新一次、超时 2 秒); - 分隔符:
tab_bar_right_separator控制条目间的分隔文本,设为空字符串则直接拼接。
标签栏较窄时,状态区会自动让位给标签页本身,不会挤压主要内容。
常见问题
Q:切换终端客户端后标签页还在吗?在。按prefix+q只是分离客户端,服务器和所有标签页、代理继续运行;重新 attach 即可恢复现场。
Q:新标签页为什么没有自动聚焦?这是默认行为(不改变焦点)。创建时加--focus即可让新标签页立即获得焦点。
Q:标签页和分屏窗格是什么关系?一个标签页内包含一个或多个窗格,窗格可继续分屏、移动,甚至通过herdr pane move <pane_id> --new-tab整体搬进新标签页。
小结
| 操作 | 快捷键 | CLI 命令 |
|---|---|---|
| 创建 | prefix+c | herdr tab create |
| 跳转 | prefix+n/prefix+p/prefix+1..9 | herdr tab focus <tab_id> |
| 重命名 | prefix+shift+t | herdr tab rename <tab_id> <label> |
| 关闭 | prefix+shift+x | herdr tab close <tab_id> |
记住这张表,再配合鼠标点击和右键菜单,你已经在 Herdr 中掌握了标签页的完整操作集。下一步建议阅读工作区与持久化文档,把多项目、多代理的日常工作流彻底跑顺。
【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考