dsh-ssh
DSH 的 SSH 远程执行插件：支持 ProxyJump 链、SFTP 文件系统、子进程及基于 ssh2 的 PTY 终端。
AI 分析
核心用途是允许 DSH 代理通过 SSH 远程连接服务器并执行命令、管理文件。适合需要让 Agent 在远程 Linux 服务器或开发机上进行运维、编码任务的用户。
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:UynajGI/dsh-ssh说明文档
阅读完整 README ↗Picker configuration (dsh-ssh/picker)
| Field | Type | Default | Description |
|---|---|---|---|
maxEntries | number | 1000 | Complete-result bound for one listed level (hidden rows count; truncated flags a cut) |
remoteLabel | string | — | Retained field: the client flow no longer uses a pinned entry; remote entries live in the left connection sidebar |
dsh-ssh/picker now serves only the ctx.directoryPicker browse backend
(local directories keep working on Windows hosts; POSIX absolute paths go to
the aggregate SSH connection). The client UI's remote connection list and
remote directory browsing ride the dsh-ssh/web RPC channel instead.
Configuration reference (dsh-ssh/ssh)
| Field | Type | Default | Description |
|---|---|---|---|
host | string | — | Target hostname or address (required) |
port | number | 22 | Target SSH port |
username | string | — | Remote login user (required) |
password | string | — | Password auth |
privateKey | string | — | PEM key content or local identity-file path |
passphrase | string | — | Passphrase for an encrypted key |
agent | string | — | ssh-agent socket path or pageant |
jump | JumpConfig[] | [] | ProxyJump chain; per-hop port/user/auth overrides |
cwd | string | — | Remote working directory (required, absolute POSIX path) |
readyTimeout | number | 45000 | Connection timeout (ms) |
keepaliveInterval | number | 0 | SSH keepalive interval (ms) |
keepaliveCountMax | number | 3 | Keepalive failure threshold |
strictHostKeyChecking | boolean | false | Verify the host key against knownHosts |
knownHosts | string[] | [] | Trusted fingerprints (SHA256:…) or raw base64 public keys |
OpenSSH ~/.ssh/config mapping
| OpenSSH directive | dsh-ssh field |
|---|---|
HostName / Port / User | host / port / username |
IdentityFile / IdentitiesOnly | privateKey (path or PEM) |
PasswordAuthentication | password |
ForwardAgent | agent |
ProxyJump (comma-separated hops) | jump array (per-hop) |
ConnectTimeout | readyTimeout |
ServerAliveInterval / ServerAliveCountMax | keepaliveInterval / keepaliveCountMax |
StrictHostKeyChecking + UserKnownHostsFile | strictHostKeyChecking + knownHosts |
RemoteCommand / RequestTTY | see spawnTerminal (PTY is consumer-requested) |