dsh-ssh

DeepSeek Harness (DSH) 插件：SSH 主机管理 + 远程 Bash 执行。

提供三种形态：

形态	位置	适用
Host 插件（dsh plugin 安装，推荐）	index.mjs / webapi.mjs / client.js	全局挂载，所有 session 的 agent 直接获得工具；web profile 附带 GUI 设置页面
Agent 预设	preset/	每个使用该预设的新 session 自动获得全部 SSH 工具与服务，重启持久
动态 Cordis 插件（会话临时）	plugin/	在任意会话中通过 cordis_define 粘贴加载，进程内有效

截图

Web GUI 设置页面

Agent 使用 ssh_bash

功能

• 📋 主机管理（增删改查） — 持久化到 ~/.dsh/ssh-hosts.json
• 🔧 模型工具：ssh_host_list / ssh_host_add / ssh_host_update / ssh_host_remove / ssh_bash
• 🔌 Cordis 服务 ssh.hosts（预设形态下隔离 realm，每挂载一份），其他插件可 ctx.get('ssh.hosts') 调用
• 🔑 三种认证：agent（BatchMode 免交互）/ key（私钥）/ password（SSH_ASKPASS 机制，无需 sshpass、不申请 pty，可在受限沙箱内运行）

正式安装（dsh plugin，推荐）

# 1. 安装到 web profile（本质是 pnpm add git 依赖）
dsh plugin --profile web add https://github.com/dmz2922990/dsh-ssh.git

# 2. 在 profile 补丁层挂载（~/.dsh/profiles/web/cordis.patch.yml 追加）：
# - insert:
#     - id: dsh-ssh
#       name: dsh-ssh
#     - id: dsh-ssh-web
#       name: dsh-ssh/webapi

# 3. 重启 dsh web，所有 session（任意 preset）的 agent 直接拥有 ssh_bash 等工具，
#    设置中出现「SSH 主机」管理页面（dsh-ssh-web 行提供 /dsh-ssh/api 后端）

仓库根目录的 package.json / index.mjs 使其成为合法的 pnpm git 依赖； 挂载在 host 层，工具对所有 preset 全局可见。

正式安装（Agent 预设）

git clone https://github.com/dmz2922990/dsh-ssh.git ~/.dsh/.agent-presets/ssh

若目录已存在，先删除旧的：rm -rf ~/.dsh/.agent-presets/ssh

然后**新建 session 时选择 preset「SSH Agent」**即可 —— agent 直接拥有上表全部工具，主机配置自动从 ~/.dsh/ssh-hosts.json 读取（agent 无需、也不会直接读该文件）。

预设结构：

ssh/                          # ~/.dsh/.agent-presets/ssh/
├── preset.yml                # 显示名与描述
├── agent.cordis.yml          # 完整组合（standard 副本 + ssh 组行）
└── plugins/
    └── ssh.mjs               # 静态 Cordis 插件（服务 + 工具，无外部依赖）

组合中的关键行（发布 ssh.hosts 服务，须置于 isolate realm）：

- id: ssh
  name: cordis:group
  group: true
  isolate:
    ssh.hosts: true
  config:
    - id: ssh-plugin
      name: ./plugins/ssh.mjs

临时安装（动态插件，单会话）

在 DSH 会话中调用 cordis_define：plugin: {"kind":"new","idPrefix":"ssh"}， code.host 粘贴 plugin/host.js、code.client 粘贴 plugin/client.js（额外附带 GUI 设置页面），再 cordis_run 激活。

远程执行原理

ssh -o StrictHostKeyChecking=accept-new -o ConnectTimeout=15 [-i key] [-p port] user@host -- bash -s

脚本经 stdin 传给远端 bash -s；密码认证走 SSH_ASKPASS + SSH_ASKPASS_REQUIRE=force （辅助脚本 ~/.dsh/.ssh-askpass.sh，权限 700，仅回显环境变量中的密码）。

ssh.hosts 服务 API

const ssh = ctx.get('ssh.hosts')
await ssh.list()                        // 所有主机（不含密码明文）
await ssh.get(ref)                      // ref: id | name | user@host | host
await ssh.add({ id, host, port, user, name, note, auth: { type, keyPath, password }, tags })
await ssh.update(id, patch)             // 部分字段更新；auth 留空字段保持原值
await ssh.remove(id)
await ssh.bash(ref, command, timeoutMs) // { ok, exitCode, stdout, stderr, timedOut, ... }

安全提示

• 密码以明文存储于 ~/.dsh/ssh-hosts.json，建议优先使用密钥认证
• ssh_host_list 等返回值不含密码，只有 hasPassword 布尔值