前言¶

在 DeepSeek Harness（DSH）里做带终端、带工作区的智能体会话时，往往需要一套「控制面」：能看 Herdr 是否在跑、能否连上控制 socket、能否从 Web 侧拉起会话。上游 NAMEWTA/dsh-plugin-herdr（npm @namewta/dsh-plugin-herdr）已经提供 19 个 herdr_* 工具、Web 仪表盘和 Herdr 会话预设；在原生 Windows 主机上，传输方式、进程探测和安装指引与 Linux/macOS 并不相同。capxh73/dsh-plugin-herdr-win 是在上游 0.0.3 基线上的 Windows 适配 fork，面向在同一台 Windows x64/arm64 上同时跑 DSH 与 Herdr 的场景。

这是什么¶

Herdr control-plane plugin for DeepSeek Harness：观察并驱动 Herdr，包含 herdr_* 工具、会话预设与 Web 面板。维护者 capxh73 在 contributors 中标注为 native Windows adaptation；仓库 MIT 许可，保留上游版权。SkillHub 分类为「客户端」。

与上游的主要差异（见 README 与 COMPATIBILITY.md）：named-pipe 传输、基于 tasklist 的进程探测、Windows 环境变量白名单、PowerShell/CMD 安装指引，以及平台中性的工具/技能文案。fork 仅发布编译产物（lib/），完整构建流水线在上游仓库。

环境与版本¶

插件 0.0.3 要求 Node 24+，DSH 为 0.2.0-rc.2、0.2.1-alpha.1、0.2.1-alpha.2 或 0.2.1-rc.3。DSH 插件安装器还要求 pnpm 在 PATH 中。Herdr 与插件须在同一主机运行；原生 Windows 通过 Herdr 的 named-pipe 控制 socket 支持，WSL 在两侧同发行版内仍可用。基线为 Herdr 0.9.0 / protocol 22；文档记载曾在 Herdr 0.9.3 / protocol 22 上于真实 Windows 与 WSL 相邻环境验证。

Herdr 0.9.0 / protocol 22 与官方安装器可能装到更新版本时，面板会警告而非宣称完全兼容。

核心功能¶

• 19 个 herdr_* 工具：在 DSH 会话中观察、驱动 Herdr（具体工具名以插件 manifest 为准）。
• Web 仪表盘：DSH Web 侧栏 Herdr 入口；可为对话选择 Herdr mode 专用工作区。
• 安装与环境面板：Herdr → Installation & settings，或 Settings → Built-in plugins → Herdr environment。可执行文件缺失时自动打开安装指引；会话服务器横幅也可进入同一面板。
• 连接与检查：Check environment / test connection 检查的是 DSH Host（非浏览器所在 OS）：平台/架构、Herdr 可执行文件与版本、npm/pnpm、配置的 socket 与终端能力。检查不安装软件、不启动终端、不改配置。
• 只读连接项：运行中可见 terminalSession.binPath / HERDR_BIN_PATH、socketPath / HERDR_SOCKET_PATH、session / HERDR_SESSION；修改需改插件配置或启动环境并重启 DSH。

Windows Host 上面板展示官方 PowerShell 安装器及 cmd.exe 回退，以及 npm 与 PATH 步骤；Linux/macOS 仍显示上游安装方式。面板不会自动安装、停止、升级或替换已在运行的软件；可从 PATH 启动 Herdr 二进制（含 ~/.local/bin 等发现逻辑）。

安装 DSH 与 pnpm¶

资料中 pinned 的可复现默认下载版本如下（2026-10-11 时 npm latest/next 为 0.2.0-rc.2，alpha 为 0.2.1-alpha.2；npx @deepseek-ai/dsh web 不一定等于 GitHub 最新预发布）：

npm install --global pnpm@10.28.2
npm install --global @deepseek-ai/dsh@0.2.0-rc.2
# 或显式使用 alpha：
# npm install --global @deepseek-ai/dsh@0.2.1-alpha.2
dsh --version
pnpm --version

安装预构建插件¶

从 GitHub Releases 下载 namewta-dsh-plugin-herdr-0.0.3.tgz 与 SHA256SUMS（上游 CI 通过后发布；同名包也可在成功 ci 运行的 herdr-plugin-package artifact 中获取）。不要直接把未构建的 Git 检出当作插件安装（无 lib/）；GitHub 源码归档也不是预构建 tarball。npm 发布与上述 tarball 流程分离，registry 的 latest 可能仍指向较旧插件版本。

# 在包含 tgz 与校验文件的目录执行
sha256sum --check SHA256SUMS
dsh plugin --profile web add /absolute/path/namewta-dsh-plugin-herdr-0.0.3.tgz
dsh plugin --profile web list
dsh web

安装或替换包后，若 Web profile 已在运行需重启。也可在 DSH 插件安装 UI 中选择同一 tarball。打开侧栏 Herdr 查看仪表盘；Herdr 本体须已安装并在需要时运行。

卸载同一 profile 中的包：

dsh plugin --profile web remove @namewta/dsh-plugin-herdr

重启 profile 以卸载工具、面板与运行时注册的预设。

典型用法¶

1. 在 Host 上按面板所示安装 Herdr（Windows 用 PowerShell/CMD 指引；命令复制到 Host 终端，勿按浏览器 OS 选错脚本）。
2. 在 Installation & settings 中 Check environment / test connection，确认 socket、会话与二进制路径。
3. 若需启动服务，在面板中 Start（仅针对预期实例；插件不会停止或替换已有服务器）。
4. 在 DSH Web 中选 Herdr mode 开启专用工作区，通过 herdr_* 工具与会话驱动任务。

浏览器在 Windows、Host 在 Linux 时，安装命令必须以 Host 系统为准。

适用场景与注意¶

• 适合：在原生 Windows（或文档所述 WSL 同 distro 布局）上跑 DSH Web profile，并希望通过统一面板管理 Herdr 连接与会话预设的开发者。
• 不适合期望：安装插件即自动装好 Herdr 或常驻服务——插件只提供控制面与管理 UI；0.0.3 起才有完整管理屏，通过包名从 npm 解析可能得到更旧的 0.0.2。
• 权限与安全：插件随当前 DSH 进程权限运行；安装前应阅读 capxh73/dsh-plugin-herdr-win 源码与 LICENSE。故障排查勿清空 profile、凭证或工作区；勿分享 API key、认证 URL 或完整环境 dump。
• 生态：DSH 采用「一切皆插件」思路；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系。

故障排查要点¶

• 找不到可执行文件：按面板显示的 Host 系统执行命令；若显式 HERDR_BIN_PATH 无效，需修正 override，而非再装一个会被 override 隐藏的二进制。
• 已安装但未连接：核对 socket 与 session；Start 仅用于预期服务器。
• 检查/启动失败：根据 Host 返回的本地化错误修正路径或权限后重试。

仍失败时，记录完整错误、Host OS、DSH/插件/Herdr 版本及失败操作后再提 issue。

结尾¶

capxh73/dsh-plugin-herdr-win 把上游 Herdr 控制面插件落到原生 Windows：named-pipe、tasklist 探测与 PowerShell/CMD 安装路径与 DSH Web 侧栏、环境检查面板一致。目录与仓库：

• https://www.skillhub.cn/plugins/capxh73/dsh-plugin-herdr-win
• https://github.com/capxh73/dsh-plugin-herdr-win