damozhang/dsh-herdr-bridge

herdr-bridge

一个 dsh 插件，用于将 DeepSeek Harness Web 会话桥接到 Herdr，让 dsh 智能体能够发现、启动、提示并观察在 Herdr 下运行的其他智能体（pi、claude、codex……）——全部在 dsh Web UI 内完成。

dsh-herdr-bridge 演示

要求

- 带有 web 配置文件的 dsh（npx @deepseek-ai/dsh 或本地构建）
- 在同一台机器上运行的 Herdr（herdr CLI 在 PATH 中，套接字位于 ~/.config/herdr/herdr.sock）
- Node.js >= 20

安装

从 GitHub（已发布的源代码）：

dsh plugin --profile web add github:damozhang/dsh-herdr-bridge

从 npm（发布后）：

dsh plugin --profile web add dsh-herdr-bridge

从本地检出（开发）：

dsh plugin --profile web add /path/to/herdr-bridge

然后重启 dsh Web 服务器以加载该 bundle。要更新到更新版本，请使用相同的源再次运行 add（pnpm 会缓存；如果切换源，请先 remove）。对于活跃开发，请链接本地检出——源代码编辑将在下次服务器重启时生效——然后切换回 GitHub 源以验证其他人将安装的内容。

启动 dsh 以使 Herdr 集成正常工作（重要）

Herdr 自带的 skill 在智能体进程不受 Herdr 管理时会拒绝执行操作：它会检查环境中的 HERDR_ENV=1，否则停止。因此，dsh Web 进程必须在设置了 HERDR_ENV=1 的情况下运行，否则即使安装了此插件，dsh 智能体也会拒绝接触 Herdr。

选项 A —— 推荐：在 Herdr 窗格内运行 dsh web

Herdr 会自动向其管理的每个窗格注入 HERDR_ENV=1（以及 HERDR_SOCKET_PATH/HERDR_PANE_ID）。创建一个绑定到你常用工作目录的窗格并运行：

npx @deepseek-ai/dsh web

Web 服务器会继承 Herdr 环境，skill 检查通过，并且服务器自身的输出在该窗格中保持可观察。

选项 B —— 在普通终端中运行并导出环境变量

如果你希望 Web 服务器在 Herdr 之外运行，请先导出这些标记：

export HERDR_ENV=1
export HERDR_SOCKET_PATH="$HOME/.config/herdr/herdr.sock"
npx @deepseek-ai/dsh web

这满足了 skill 检查，但不如在 Herdr 窗格内运行那样“原生”。

验证

打开 dsh Web UI，让智能体执行 herdr_agent_list。如果它返回了实时的 Herdr 智能体（带有窗格 ID），则说明桥接正常工作。如果智能体以 Herdr 环境错误拒绝，则说明服务器启动时未设置 HERDR_ENV=1。

该插件的工具还会在每次调用生成的 herdr CLI 时设置 HERDR_ENV=1 和默认套接字路径，因此工具执行本身具有弹性；进程级变量才是 skill 检查所检查的内容。

工具

| 工具 | 用途 |
|---|---|
| herdr_agent_list | 列出 Herdr 智能体（窗格 ID、状态、cwd）以发现协作目标 |
| herdr_agent_start | 创建一个工作区并启动一个 agent（kind：pi、claude、codex……；可选 model） |
| herdr_agent_prompt | 通过 pane id 向 agent 发送消息，等待完成，返回其输出 |
| herdr_delegate | 一次性操作：启动 agent → 提交任务 → 等待 → 返回输出（可选清理） |
| herdr_pane_run | 在任意 pane 中运行 shell 命令并读取其输出（可选 match-wait） |
| herdr_workspace_close | 关闭工作区以清理其 agent 和 pane |

示例

询问 dsh web agent：

herdr_delegate: review /path/to/code with model opencode-go/deepseek-v4-pro

或组合原语：

herdr_agent_list
herdr_agent_start pi in /path with model opencode-go/deepseek-v4-pro
herdr_agent_prompt  "implement feature X and run the tests"
herdr_workspace_close

开发

pnpm install        # installs devDependencies
pnpm run build      # compile src/ to dist/ — required before committing a source change
dsh plugin --profile web add /abs/path/to/this/repo

dist/ 是有意提交的。 该插件发布的是编译后的 JavaScript：main 指向 dist/index.js，从不指向 src/index.ts，因为 Node 拒绝从 node_modules 下解析到的任何 .ts 文件中剥离类型——而 dsh plugin add 总是安装到 node_modules 中。构建也不能推迟到安装时进行：pnpm 会拒绝一个带有 prepare（或任何构建）脚本的 git 托管包，除非使用者在 pnpm-workspace.yaml 中将其加入允许列表，而这会破坏所有人的 dsh plugin add github:...。提交构建产物正是让全部三种安装来源都能在无需使用者配置的情况下正常工作的原因。

因此：运行 pnpm run build 并将 dist/ 与任何 src/ 变更提交在同一个 commit 中，否则安装者将得到上一次的构建产物。

@deepseek-ai/dsh-tools 是 peerDependency，而不是常规依赖，因此该插件会绑定到宿主 dsh 运行时已加载的那一份副本，而不会将第二份（可能已过时的）副本拉入 profile 中。

Schema 说明：dsh value-schema DSL 比 JSON Schema 更严格——required 位于每个字段上，并且 object schema 必须显式声明 additionalProperties。

许可证

MIT