@namewta/dsh-plugin-herdr

English | 简体中文

DeepSeek Harness (DSH) 的 Herdr 控制面插件：在 DSH 会话中直接观察与驱动 Herdr——面向 AI 编码代理的终端工作区管理器。

功能

• 控制面 — 通过 Herdr Unix-domain socket 提供 19 个 herdr_* 工具（snapshot、agents、panes、workspaces、layout、notifications）
• 会话级 UI — Herdr Tab 与侧边面板仅展示当前会话的 workspace；非 Herdr 模式下自动隐藏
• Herdr 模式 — 以 Herdr 模式创建会话，自动获得与会话同生命周期的专属 workspace

环境要求

• DeepSeek Harness 0.2.1-alpha.1（npm i -g @deepseek-ai/[email protected]），不支持更早的 DSH 版本
• Node.js >= 24，以及运行中的 Herdr server

安装

前置条件：一个 DSH profile（如 web）和运行中的 Herdr server。插件通过本机 Herdr socket 通信；面板可按需从 PATH 拉起 server。

# 本地目录
dsh plugin --profile web add /path/to/dsh-plugin-herdr

# tarball（pnpm pack 产物）
pnpm pack
dsh plugin --profile web add ./namewta-dsh-plugin-herdr-*.tgz

# git
dsh plugin --profile web add github:NAMEWTA/dsh-plugin-herdr

安装后重启 profile。用 dsh plugin --profile web list 验证。

卸载

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

重启 profile 即可卸载工具、面板与 Herdr 模式。预设副本残留在 $DSH_HOME/.agent-presets/herdr/，按需手动删除。

开发

pnpm install
pnpm build        # tsdown（node 入口 + web client bundle）
pnpm quality      # 构建 + typecheck + gen-types 漂移检查 + 单测
pnpm test         # 单测（node --test）
pnpm test:integration  # 对接真实 herdr server；不可用时 SKIP
pnpm gen:types    # 从 herdr schema fixture 重新生成协议类型

许可证

MIT © 2026 NAMEWTA。部分代码最初由 sunny0826 编写（MIT），详见 LICENSE。