dsh-ssh-panel

A small SSH host panel for DeepSeek Harness (DSH): add hosts in Settings (key or password), see the list, and let the agent use them through ssh_list / ssh_exec.

中文 · English

---

English

DSH plugin with two halves:

• Settings → SSH 主机: a panel to add, edit, test and delete SSH hosts. Key or password auth, per-host port/user/note. Secrets stay on the host.
• Agent tools: ssh_list returns the configured hosts (alias, address, user, auth type); ssh_exec runs one command on a host by alias and returns stdout/stderr/exit code.

The panel also carries a Restart DSH button that exits the host process and lets systemd's Restart=always bring it back (about three seconds).

Storage is $DSH_HOME/ssh-hosts.json (0600). Passwords and key passphrases never leave the host process: the JSON API returns only hasPassword / hasPassphrase. No telemetry.

Install

# GitHub
dsh plugin --profile web add github:MARYCOMPLEX/dsh-ssh-panel

# or a local tarball
pnpm pack
dsh plugin --profile web add ./dsh-ssh-panel-0.1.1.tgz

Then restart dsh web once. ssh2 builds an optional native crypto binding; pnpm 12 blocks build scripts by default, so if the install reports ERR_PNPM_IGNORED_BUILDS, add this to $DSH_HOME/profiles/web/pnpm-workspace.yaml and re-run:

allowBuilds:
  ssh2: true
  cpu-features: true

Use

1. Settings (gear) → SSH 主机 → 添加主机: alias (vps), host, port, user, key path or password.
2. Hit 测试 to verify, then 保存.
3. Ask the agent: “去 vps 上看看磁盘” — it calls ssh_list, finds vps, then ssh_exec.

Tools

Tool	Arguments	Returns
ssh_list	—	JSON list of hosts (no secrets)
ssh_exec	host, command, optional timeout_ms	stdout, stderr, exit code; truncated past 256 KiB

Requirements

• DSH 0.2.1-rc.2 (tested), web profile
• Node.js ≥ 22

中文

DSH 插件，两半：

• 设置 → SSH 主机：一个面板，用来添加 / 编辑 / 测试 / 删除 SSH 主机。支持密钥或密码、端口、用户名、备注；密码只留在宿主进程。
• Agent 工具：ssh_list 返回已配置的主机（别名、地址、用户、认证方式），ssh_exec 按别名执行一条命令，返回 stdout / stderr / 退出码。

面板右上角还有一个 「重启 DSH」 按钮：调用后宿主进程退出，由 systemd 的 Restart=always 拉起（约三秒），页面会轮询到恢复后自动刷新。

存储在 $DSH_HOME/ssh-hosts.json（0600）。密码与密钥口令不会离开宿主进程，接口只返回 hasPassword / hasPassphrase。没有遥测。

安装

# 从 GitHub
dsh plugin --profile web add github:MARYCOMPLEX/dsh-ssh-panel

# 或本地 tarball
pnpm pack
dsh plugin --profile web add ./dsh-ssh-panel-0.1.1.tgz

装完重启一次 dsh web。ssh2 会尝试编译可选的 native crypto binding；pnpm 12 默认拦截构建脚本，如果报 ERR_PNPM_IGNORED_BUILDS，在 $DSH_HOME/profiles/web/pnpm-workspace.yaml 里加：

allowBuilds:
  ssh2: true
  cpu-features: true

再重跑安装即可（不编译也能用，ssh2 有纯 JS 回退）。

使用

1. 设置（齿轮）→ SSH 主机 → 添加主机：别名（比如 vps）、地址、端口、用户名、私钥路径或密码。
2. 点 测试 验证，然后 保存。
3. 对 agent 说「去 vps 上看看磁盘」——它会先 ssh_list 找到 vps，再 ssh_exec。

工具

工具	参数	返回
ssh_list	—	主机 JSON 列表（不含密钥）
ssh_exec	host、command，可选 timeout_ms	stdout、stderr、退出码；超过 256 KiB 截断

要求

• DSH 0.2.1-rc.2（已验证），web profile
• Node.js ≥ 22

开发

pnpm install
pnpm pack                     # dsh-ssh-panel-<version>.tgz
dsh plugin --profile web add ./dsh-ssh-panel-<version>.tgz

源码只有四处：lib/index.js（存储 / 路由 / 工具）、lib/client.js（Settings 里的 section）、lib/panel.html（面板 UI）、cordis.patch.yml（bundle 入口）。

License

MIT