指南 · 宏
宏：一个按键，一整串操作。
宏会像你一样往你所在的窗格中输入，并在下一步之前等待每个菜单出现。切换 AI 编程智能体（agent）的模型、重启开发服务器、运行同样的三条命令：写一次，以后按一个键就行。
不必自己写：你的 agent 可以写
用你自己的话告诉任意窗格里的 agent。它会创建宏、测试并分配按键，之后也能修改或删除你的任何宏。
做一个把你切换到 Sonnet 的宏
或者：“让重启宏先清屏”“给测试宏分配 ⌥⌘T”“删除我不用的宏”。
宏长什么样
宏就是把你手动做的事写下来：每行一个动作，从上到下运行。这个宏把 Claude Code 切换到另一个模型。每一行及其作用：
type "/model"
输入 /model
press enter
按 Return：模型菜单打开
wait for "Select model"
等到菜单显示“Select model”
press down enter
按一次 ↓，再按 Return 选择
宏就是这样。Shepi 依次执行每一行，在你所在的窗格中，就像你在输入一样。
查阅
运行宏
宏会输入到它开始时聚焦的窗格，无论在这台 Mac 还是另一台机器上，即使你移开也会留在那个窗格。运行期间，状态栏显示“正在运行…”，你输入的内容照常送出，esc 可停止它。完成时不会另行通知：窗格会显示结果。它从不往离线的机器输入。每个宏在编辑器中名称旁边都有一个短 ID，可以复制；即使两个宏同名，agent 也能按 ID 运行。
按键和仅限
- 按键：前缀后的任意键，比如 ⌃B m，或带 ⌘ 的快捷键，比如 ⌥⌘1。Shepi 会拒绝 Herdr、Shepi 或 macOS 已经在用的按键，或其他宏已用的按键。如果 Herdr 之后开始使用某个宏的按键，以 Herdr 为准，宏会提示你另选一个。
- 仅限：把宏限定在一种 agent（比如 Claude Code）或普通 shell 中。在其他窗格中，它的按键什么也不做，只会提示这一点。
宏停止时
| “… 没有出现” | 某个 wait for 超时了：菜单出现得更慢，或者它的文字不一样。手动核对文字；如果只是慢，加上 up to 10 s。 |
| “shell 没有回来” | 某个 wait for the shell 超时了：程序仍在运行，或者在退出前问了什么。看看那个窗格；如果只是退出得慢，加上 up to 15 s。 |
| “已用 Esc 停止” | 你按了 esc。之后什么都没有再输入。 |
| “不在仓库中”、“没有选择任何内容” | 宏用到的某个值在这个窗格中不存在。什么都没有输入；请在有这个值的地方运行。 |
| “… 已离线” | 这台机器未连接；从边栏重新连接它。 |
| “仅限 Claude Code” | 这个宏限定在另一种窗格中运行（仅限）。 |
编辑器中的红色行会说明哪里有问题；所有行都有效之前，什么都不会运行。
在 Herdr 的终端 UI 中也能用
如果你也使用 Herdr 自己的终端 UI，编辑器“更多”部分中的拷贝为 Herdr 配置会把这个宏拷贝为 Herdr 自定义命令。请自己把它粘贴到 Herdr 配置中；Shepi 从不编辑那个文件。