DeepSeek Harness (DSH) 的核心设计理念是插件化，这让开发者可以灵活扩展工具链。Herdr 是一个专为 AI 编码代理设计的终端工作区管理器。要在 DSH 会话中直接控制 Herdr，需要解决如何通过 DSH 的控制平面与 Herdr 的 Unix 域套接字通信的问题。dsh-plugin-herdr 插件提供了这套控制平面能力。
插件定位¶
这是一个 Herdr 控制平面插件，由 sunny0826 维护，遵循 MIT 许可证。它运行在 DSH 之上，通过本地 Herdr 服务器的 Unix 域套接字提供 19 个 herdr_* 工具，支持快照、管理代理、窗格、工作区、布局和通知等操作。
核心功能¶
控制平面工具¶
插件通过 Unix 域套接字暴露 19 个 herdr_* 工具，覆盖 Herdr 的核心操作，包括快照、代理管理、窗格操作、工作区控制、布局调整和通知查看。
会话作用域 UI¶
Herdr 的标签页和侧边栏界面是会话隔离的。在非 Herdr 模式下这些 UI 元素隐藏；在 Herdr 模式下，它们仅显示当前会话的 workspace。
Herdr 模式¶
DSH 支持创建 Herdr 模式会话。这种模式下会获得一个专用的 workspace，该 workspace 会随着会话的创建和销毁而存在和消失。
安装与启用¶
安装前请确保已安装 DSH 并拥有一个配置文件（例如 web），且 Herdr 服务器正在运行。
- 使用 npm 安装：
dsh plugin --profile web add dsh-plugin-herdr
- 从本地目录安装：
dsh plugin --profile web add /path/to/dsh-plugin-herdr
- 从 tarball 安装：
pnpm pack
dsh plugin --profile web add ./dsh-plugin-herdr-*.tgz
- 从 Git 安装：
dsh plugin --profile web add github:sunny0826/dsh-plugin-herdr
安装完成后，重启配置文件以加载工具和 UI。验证安装状态：
dsh plugin --profile web list
卸载¶
如需移除插件：
dsh plugin --profile web remove dsh-plugin-herdr
再次重启配置文件以卸载工具、面板和 Herdr 模式。注意，插件会在 $DSH_HOME/.agent-presets/herdr/ 留下一份预设副本，如有需要请手动删除。
注意事项¶
该插件以当前 DSH 进程的权限运行。在安装或使用前，建议检查源码和许可证。插件通过本地 Unix 域套接字与 Herdr 通信；如果 Herdr 服务器未启动，面板可以尝试从 PATH 启动它。
