dsh-remote-deck
Remote Deck：DeepSeek Harness 的 SSH 工作区。连接任意数量的机器，浏览远程文件夹，并使用远程文件系统、Shell、搜索、终端和端口转发运行 DSH 会话。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:dsh-plugins-cn/dsh-remote-deck#d7da8a9af74ca680aae5b168ba669128c908f976Remote Deck 以 dsh-remote-deck 发布，当前版本为 1.1.7。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
SSH workspaces for DeepSeek Harness — one window, local and remote conversations side by side.
Remote Deck connects your DSH desktop app to any number of SSH machines and turns a remote folder into an ordinary DSH workspace. Inside that workspace the agent reads, writes, searches, runs commands, opens a terminal and forwards ports on the remote host — while the UI stays the same window you already use.
sshd: SFTP for files, exec channels for commands and search,
a PTY for the terminal, direct-tcpip for port forwarding.| Console | Quick panel |
|---|---|
| Console | Quick panel |
| Session identity | Add a machine |
|---|---|
| Session identity | Add a machine |
| New workspace | Terminal and ports |
|---|---|
| New workspace | Terminal and ports |
Screenshots are rendered from the sanitized design mockups in docs/design/v2/. Host names,
addresses and paths are demo data (dev-box, 203.0.113.10, /srv/demo-app).
| Area | What you get |
|---|---|
| Connections | Multiple hosts, key or password auth, ~/.ssh/config import, connection test with OS/latency, per-host auto-connect (off by default; toggle in the dialog, quick panel or console), keepalive and backoff reconnect |
| Workspaces | Browse remote folders with breadcrumbs, filters and keyboard navigation; add one as a DSH workspace; custom sidebar name; remove locally without touching the remote directory |
| Sessions | Remote sessions get a header pill, a colour-coded sidebar badge and a hover line; local sessions are unchanged |
| Console | Machine rail, host overview, stats, workspace cards, recent sessions, search, and a remote file browser with download / save-to-local / reveal |
| Terminal | Remote PTY in a full xterm.js terminal: colours, cursor, full-screen programs, paste and replay buffer |
| Ports | Automatic discovery of remote listening ports, one-click forwarding, persistence and restore on reconnect |
| Theme | Light and dark, driven by DSH theme tokens |
From the plugin market (after listing) or npm:
dsh plugin add dsh-remote-deck
From GitHub:
dsh plugin add git+https://github.com/dsh-plugins-cn/dsh-remote-deck.git
In mainland China, use the GitHub proxy:
dsh plugin add "git+https://ghproxy.laiyouxi.com/https://github.com/dsh-plugins-cn/dsh-remote-deck.git"
From a checkout:
git clone https://github.com/dsh-plugins-cn/dsh-remote-deck.git
cd dsh-remote-deck
powershell -ExecutionPolicy Bypass -File .\install.ps1 -Profile desktop
Restart DSH (or press Ctrl+R) after installing; the SSH chip appears at the bottom of the
sidebar and 远程开发 appears in the sidebar navigation.
The plugin has no npm dependencies: ssh2 and its small dependency tree are vendored under
vendor/node_modules, and the terminal assets under vendor/xterm. Installation therefore never
runs package build scripts.
dsh-remote-sshRemote Deck is the successor of dsh-remote-ssh.
On first load it copies connections from <DSH_HOME>/remote-ssh and reuses existing workspace
stubs in place, so workspaces and sessions keep their place in the sidebar.
The old plugin keeps working until you remove it. Use one profile at a time: both plugins patch
ctx.fs, so only one of them should be enabled in a profile.
Cut over in one command (backs up package.json first and keeps the old plugin files for
rollback):
.\install.ps1 -Profile desktop -RemoveOld
Roll back at any time:
.\install.ps1 -Rollback # restores package.json.bak-before-deck
Data stays in <DSH_HOME>/remote-deck and survives plugin reinstalls.
┌────────────────────────────── DSH desktop ──────────────────────────────┐
│ conversation · sidebar · Remote Deck console │
│ │ ctx.fs / ctx.shell / ripgrep / tools │
│ ▼ │
│ host half: connection pool, workspace stubs, loopback API │
└────────┬────────────────────────────────────────────────────────────────┘
│ SSH (ssh2): exec channels · SFTP · PTY · port forwarding
▼
remote host: sshd only (Linux / macOS)
A remote workspace is a marked stub directory under <DSH_HOME>/remote-deck/workspaces; the
marker records the connection id and the remote POSIX path. Every path under a marked workspace
resolves through SFTP; commands run through an exec channel with the remote cwd; ripgrep moves to
the host; the terminal is one PTY channel; forwarding is one local listener per port.
connections.json.sshd on the remote host; Linux or macOS; remote shell bash.~/.ssh/config import covers Host/HostName/Port/User/IdentityFile/ProxyJump; proxy commands and
host-key pinning are not wired into the connection dialogs yet.ss or netstat is required for automatic port discovery; manual forwarding still works.npm run check # syntax + manifest
npm test # parser unit tests
npm run pack:dry # inspect the published file list
Design mockups and their sanitized renders live in docs/design/v2/; acceptance runs are
recorded in the CHANGELOG. The version plan is in ROADMAP.md, release steps in
PUBLISH.md, and the iteration runbook in docs/MAINTENANCE.md.
MIT