dsh-ssh-remote

中文 · Download 0.13.3 · Changelog · Troubleshooting

Open an SSH workspace inside DeepSeek Harness. Browse files and run commands in its native panels, with remote editing, @ references, port forwarding and file transfers. Reuse ~/.ssh/config; no full DSH installation is needed on the server.

Install: copy, install, connect

Already have working DSH and an SSH alias? Start here. Desktop includes its runtime; you do not need to install Node separately.

Desktop / Web

1. Open Plugins → Add plugin in the sidebar and paste the full address below.
2. Choose Install → Enable now. Save your work and fully restart DSH after the first install or an upgrade from 0.11.x; follow the reported outcome for later updates.
3. Choose Add workspace, select your SSH host and folder, then use native Workspace files and New terminal.

https://github.com/CrazyShout/dsh-ssh-remote/releases/download/v0.13.3/dsh-ssh-remote-0.13.3.tgz

No clone, build or manual plugin-directory copying. The installer still downloads runtime dependencies.

Expand Getting started in the official plugin details for connection steps. The UI follows DSH's Chinese/English preference, without another language switch. Existing 0.12.0 users can check for updates directly in plugin details.

Use the full address. The npm package named dsh-ssh-remote belongs to another project. Desktop and Web have separate profiles and need separate installation.

CLI / Web: one install command

dsh plugin --profile web add 'https://github.com/CrazyShout/dsh-ssh-remote/releases/download/v0.13.3/dsh-ssh-remote-0.13.3.tgz'

Restart dsh web afterwards; stop an existing server with Ctrl-C in its terminal first. For Desktop, use the application's own Plugins page.

Fixed Git tag (requires local Git):

dsh plugin --profile web add 'github:CrazyShout/dsh-ssh-remote#v0.13.3'

You can also download the release .tgz and enter its absolute path in Plugins. Verify downloads with SHA256SUMS. Review dependency-script prompts in the official installer, without globally allowing unknown scripts. Version 0.11.0 removed the ssh2 / cpu-features native-build dependencies.

Your everyday workflow

The SSH · host badge opens the unified workbench; blank Sessions show it above the composer. Local Sessions retain their original file and terminal behavior.

Connection dots: green = SSH/helper connected; amber = connecting or limited; hollow gray = disconnected or unknown; red = connection error. Hover or keyboard-focus for the full path and explanation. Green does not certify every remote feature.

New to SSH?

Install DSH using the official instructions, then configure a concrete local OpenSSH alias:

Host devbox
  HostName your-server.example.com
  User your-user

Run ssh devbox, verify the host fingerprint on first login, then exit. The plugin uses non-interactive authentication, so also check:

ssh -o BatchMode=yes devbox true

Follow the three installation steps above and run pwd in a native terminal to verify the remote directory. No model message is needed. The first connection deploys the matching Python helper; host diagnostics are in Settings → Built-in plugins → SSH Remote. Keep custom Port, IdentityFile and ProxyJump settings in OpenSSH, without duplicating them in the plugin.

Requirements and limits

Compatibility coverage: 0.2.0-rc.2 / 0.2.1-rc.2 / 0.2.1-rc.3. See each Release's acceptance record; the plugin does not switch your DSH update channel.

• Editing: complete UTF-8 files, 256 KiB maximum. Save drafts before restarting.
• Transfers: 1 TiB per file/batch; small real samples and simulated boundaries tested, not TB-scale throughput. Restart recovery requires source/destination reauthorization.
• Forwarding: currently validated on macOS / Linux hosts. Windows has no full Desktop/SSH acceptance.
• Skills: project and user .dsh/skills / .agents/skills by default, without following symlinks or automatically running scripts.
• DSH's Finder / local-application actions remain local; use preview and remote editing for SSH files.

See the technical reference for detailed boundaries. Old SFTP/plugin-host configurations have a migration guide. Existing OpenSSH aliases need no migration; upgrades never automatically rewrite SSH configuration.

Update, roll back and remove

In-app updates: open Plugins → dsh-ssh-remote → 检查更新 (Check for updates). Select 更新到… → 确认更新 to install a newer stable release without visiting this repository or copying another link. Automatic checks run every six hours while the page is visible; switch them off on the same page without losing manual checks. A new-version notice appears once and never starts installation by itself.

After a failed check, visible automatic checks resume in about five minutes. Expand troubleshooting for the failed stage and sanitized error code. No proxy switch, certificate bypass or repeated installation is performed.

Package installation uses DSH's official service, including dependency approvals and compatibility checks. Installed and running versions are shown separately. Save drafts and pause transfers first: reloading the SSH plugin may end its terminals and port forwards. It never automatically restarts DSH. If a response is lost, choose 重新确认结果 to reconcile the result instead of automatically reinstalling.

Check for updates also refreshes local installation facts. When the old request is no longer active in this DSH host and the current version has been read again, Dismiss this notice clears only the notice, not an installation. A new update still needs your confirmation. Short diagnostics and the official log path are available in Details; full logs are not stored in browser recovery records.

Source link: / local-directory installs show version information only and must be synchronized with Git; archives never replace them automatically. Version 0.11.2 and earlier need one manual installation of the current release to gain this feature. Releases remain available for manual selection. If DSH refuses to replace a source directly, follow its plugin-page guidance; this feature does not remove the old package first. Web CLI users can still repeat add in the same profile.

Roll back to 0.13.2: install the previous official release in Plugins, or run:

dsh plugin --profile web add 'https://github.com/CrazyShout/dsh-ssh-remote/releases/download/v0.13.2/dsh-ssh-remote-0.13.2.tgz'

Restart when requested; migrated OpenSSH settings remain. Version 0.13.0 and earlier lack this release's control-connection authentication fix. Rollback is for isolated diagnostics, not a security-equivalent long-term alternative.

Disable / remove: use the application's Plugins page. For Web, you can also stop the server and run:

dsh plugin --profile web remove dsh-ssh-remote

Removal does not delete remote projects, local conversations or SSH configuration. Remote workspaces need the plugin to work; reinstalling reuses saved mappings.

Help and development

Troubleshooting · Report an issue · Technical reference · Roadmap · Release procedure · Changelog

Include plugin / DSH versions, Desktop or Web, installation source and the first actual error. Do not include credentials.

MIT License.