如何使用 Shepi for Herdr。

开始使用

Herdr 运行你的 AI 编程智能体（agent）；Shepi 是查看它们的 Mac 窗口。退出 Shepi 不会停止任何东西。

1. 安装 Herdr（免费）：
   curl -fsSL https://herdr.dev/install.sh | sh
2. 下载 Shepi，拖到“应用程序”文件夹并打开。
3. Shepi 会找到 Herdr，启动它，并显示你的工作区和 agent。还没装 Herdr？Shepi 会显示安装命令和“拷贝”按钮，装好后就会连接。

免费试用 14 天，无需账户，无需银行卡。macOS 15 或更高版本，Apple 芯片和 Intel 均可；Herdr 0.9.3 或更高版本。提示：打开“设置” › “通用” › “登录时打开”，这样 Shepi 会启动 Herdr，你的 agent 也会获得你给 Shepi 的 Mac 权限。

窗口

123456

1. 工作区：你的项目，显示分支和各自有几个 agent；有两台或更多机器时，按机器分在各自的标题下。
2. Agent：每台机器上的每个 agent，右侧是它的状态和时长。
3. 你所在工作区的标签页。
4. 窗格：颜色较亮的窗格是你输入内容的去处。
5. 状态栏：谁需要你处理、消息、文件夹及其 Git 状态。
6. 查找；有你错过的内容时，旁边会出现收件箱；有窗格移到后台时，还会出现后台托盘。

颜色只表示一件事：琥珀色是需要你处理，蓝色是工作中，绿色是已完成，灰色是空闲。

按键

你输入的内容会送到窗格。另有两种快捷键是发给 Shepi 的：

• 忘了按键？按 ⌃B 后稍等：会出现一条提示，显示你现在可以按的键，右侧是你自己的宏。
• 所有按键：?，或状态栏右侧的“快捷键”。输入名称，按 Return 即可运行。
• 更喜欢点按？每个工具提示和菜单项都会显示对应的按键。

前缀键属于 Herdr，所以与 Herdr 自己的终端 App 一致。设置 › Herdr 会打开 Herdr 的配置，在那里更改。

边栏

每个工作区显示待推送的提交 ↑ 和待拉取的提交 ↓，是它的窗格所在各项目的合计；每个 agent 显示其开发方的标记、所在位置（它的工作区，以及名称不同时的文件夹：“Herdi test / herdi”）、它的分支和机器、它的状态，状态旁边是它总共工作了多久（把指针停在上面可看到本轮时长等更多信息；需要你处理的 agent 只显示这一项）。

工作区和标签页

工作区是一个项目文件夹；标签页是其中的一种窗格布局。

1. 指向“工作区”标题，点按 + 新建工作区，然后 cd 进入你的项目。
2. 右键点按工作区 › 在此启动 Claude Code：会打开一个新标签页，agent 就在里面。
3. 在你命名之前，标签页会以 agent 的任务命名。

窗格

拆分、调整大小、关闭

缩放

窗格看起来被截断或太小？是另一台设备调整了它的大小。窗格的大小由最后使用它的设备决定，与 Herdr 自己的终端一样：输入、点按或回到窗口，它就又归这台 Mac 了。手机正在显示的窗格会保持手机的尺寸，直到手机离开它。

排列窗格

1. 拖移窗格的标题。它会缩小，让你看到后面的布局。
2. 把它停在另一个窗格上。左、右、上或下三分之一会把它放在旁边；中间则互换两者。药丸形标签会写明结果（“与 tests 互换”、“在 tests 下方”）。
3. 松开即可放下。Esc，或移回它原来的位置，即可取消。

布局属于 Herdr：所有连到它的设备都显示一样的布局。

当 agent 需要你处理时

1. 横幅，当它在你没在看的标签页中时。
2. 查看带你过去。a（attention，意为“注意”）也一样（如果 agent 向你提了问题，a 会先打开它的问题）。
3. agent 变成琥珀色，并显示它想运行的内容。
4. 状态栏会写明。

1. 听到 Herdr 的提示音。在其他 App 中时，Mac 通知会写明任务和 agent、发生了什么、工作了多久，在你有多台机器时还会写明机器；点按通知即可跳到该窗格。
2. 在 agent 自己的终端里回答。
3. 琥珀色消失。agent 完成时，会有一条绿色横幅告诉你，并带“打开”按钮。

收件箱

设置 › 通知 › 通知我：离开时（Shepi 不在前台，或那个标签页没有显示时）、始终或永不。

回答问题

agent 可以向你提出一个真正的问题：说明情况、它看到的几个回答以及每个回答会做什么，并留出地方让你自己写。

1. 每个 agent 的问题，无论来自这台 Mac 还是服务器，都在窗口右上角的同一张卡片中排队，最早的在前。agent 的说明会带格式显示：列表、代码和表格。提问的 agent 会变成琥珀色。
2. 点按一个回答，或自己写回答；可以像在 agent 的窗格里一样，往里面粘贴截屏或文件。卡片从不挡住窗口：这期间可以打开标签页或做别的事，问题会一直等着。在任何窗格中，按 a，再按 1–9；按 ↓ 自己写回答，按 G 先看看那个 agent。
3. 你的回答会直接送回 agent，接着显示下一个问题。× 可关掉一个问题；Esc 带你回到你的窗格。

一个问题 10 分钟没有回答，就会交还给 agent，改由它在终端里提问；这个问题留在收件箱中。可以在“设置” › “Agent”中更改时间。

agent 在 Shepi 中能做什么

Shepi 会在它连接的每台机器上自动为 Claude Code、Codex、Gemini CLI、OpenCode、Cursor、Copilot CLI、Amp、Grok Build 和 Pi 做好设置，让它们不用你说就知道在这里能做什么。开始新的对话（/clear、/new）会让 agent 的计时重新开始；右键点按 agent › 重置时间 可手动重置。Agent 可以：

等待中的交接会在 agent 名称后显示一个时钟；把指针停在上面，或右键点按该 agent，即可查看或取消。它在机器上运行，所以关闭 Shepi 后也会照常进行。在该 agent 的窗格中输入内容，会用你输入的内容取代它。

有些 agent 会请你批准一次 Shepi（Codex 就会）。Shepi 添加的一切都标记为 Shepi 的，在 Shepi 之外不做任何事，也从不触碰你项目里的文件；在“设置” › “Agent”中关闭“在我的机器上保持安装 Shepi 插件”即可全部移除，Shepi 为你的 agent 安装的 Herdr 自带技能在那里也有单独的开关。清除了某个 agent 的设置？“设置” › “Agent” › “重新设置” 会在每台机器上把它们都放回来。

• Claude Code 用的是最新模型？除非用 CLAUDE_CODE_ENABLE_TODO_TOOLS=1 启动，否则它不会维护任务列表。
• 截屏、其他 App：给 Shepi 屏幕录制或辅助功能权限（设置 › 隐私 › Mac 权限）；它窗格中的 agent 也会获得这些权限。

查找和 ⌘E

• 词语顺序不限；首字母也行：fat 能找到 fix-flaky-auth-test。
• 长单词中的拼写错误也能匹配；这类结果会标为“相近”。用“引号”可匹配整个短语。
• 按 Return 前往；在输出结果上，⌘G 跳到下一个匹配。

截屏和文件

1. 拷贝一张截屏（⌃⇧⌘4），或在访达中拷贝文件。
2. 在 agent 的窗格中按 ⌘V，或把文件拖到窗格上。
3. agent 拿到的是路径。在服务器上，Shepi 会先把文件拷贝过去。

一次最多 32 MB，不支持文件夹。Shepi 会在 7 天后删除自己的副本；你的文件永远不会被动。

选择、拷贝、链接

其他机器上的 agent

1. 点按边栏底部的添加机器。
2. 输入你通过 SSH 连接它的方式：you@server，或 ~/.ssh/config 中的主机。
3. Shepi 中会打开一个终端：信任主机，如有询问就输入密码短语，需要时 Herdr 会安装到那里。机器出现在边栏中：一个标题，下面是它的工作区；点按标题即可折叠。每台机器都有自己颜色的标记，你的 Mac 叫 Local（本机），每个 agent 的行都会写明它所在的机器。

出问题的机器会在标题上显示 !；在它下面，展开工作区时会显示原因和“重新连接”。它的 agent 继续运行。

Git 与差异

它从不暂存或提交；这些仍由你或你的 agent 来做。

Worktree

worktree 是在自己分支上的第二份检出，这样两个 agent 不会共用文件。

1. 在仓库的窗格中按 ⇧G；按 Return 采用建议的分支。如果有两个仓库的窗格，在“来自”中选择其中一个。
2. 它会作为一个独立的工作区打开。在那里启动一个 agent。
3. 合并后，窗格会显示“已合并 · 移除 worktree？”；点按“移除”。

宏

一个按键替你输入一串内容，并等待每个菜单出现：切换 agent 的模型、重启服务器。最快的方法：直接问 agent（“给我做一个把你切换到 Sonnet 的按键”）；它会写好宏、测试，并告诉你按键。手动编写：

1. 设置 › 宏 › +。写下步骤：type、press、wait for（等一段文字，或在程序退出后等 the shell）、pause。
2. 给它一个按键，愿意的话，还可以限定它只为某一种 agent 运行。
3. 在窗格中按下它的按键，或从 ⌘F 运行。按 Esc 停止。

如何编写宏里有每一步和示例。

设置

Shepi 使用你的 Mac 的语言：英语、日语或简体中文。如果只想让 Shepi 使用另一种语言，在“设置” › “通用” › “语言”中选择。你的终端、agent 和命令保持原样。

退出后再回来

随时退出 Shepi 或重启 Mac：Herdr 会让你的 agent 继续运行，在服务器上的 agent 在 Mac 睡眠时也照常工作。打开 Shepi，或等断开的连接恢复，你就回到同一台机器、同一个工作区、标签页和窗格，之前缩放的仍是缩放状态；如果其中某个已经不在，Shepi 会打开最近的那个，并告诉你哪些有变化。

关闭仍在工作的内容

关闭一个 agent 仍在工作中的窗格、标签页或工作区时，会先在上面询问：⌘W 关闭，Esc 保留。空闲的 agent 和 shell 会立即关闭。

试用、购买、更新

所有购买均不可退款，所以这 14 天用来做决定：见退款政策。

反馈

1. 帮助 › 发送反馈…，或边栏底部的气泡。
2. 说说发生了什么；有帮助的话粘贴一张截图。
3. 保持诊断日志打开，然后发送。你会得到一个可以引用的报告 ID。

日志从不包含终端内容、名称或路径。也可以写信到 support@shepi.app；技术支持页面有更多内容。

解决办法

所有按键

前缀键是 Herdr 的默认设置（? 显示你的设置）；⌘ 键以及 a、d、⇧B 是 Shepi 的。每个键都有一个帮助记忆的词，写在点号后面：a 代表 attention。