Adds complete SSH operations to DSH Web GUI: host management, web terminal, SFTP transfer, local port forwarding tunnels, cluster concurrent execution, and 6 Agent tools. Configuration is centrally stored locally.
ⓘ This plugin is a sub-package of the CAPTAIN1275/dsh-ui-web monorepo — stars and activity count the whole repository.
- Language
- TypeScript
- License
- Apache-2.0
- Branch
- main
Install
$ dsh plugin --profile web add @captain1275/dsh-sshRun the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial
Install via your agent
Install the DeepSeek Harness plugin CAPTAIN1275/dsh-ui-web/packages/dsh-ssh for me: review the repository at https://github.com/CAPTAIN1275/dsh-ui-web first, then run the install command and verify the plugin loads successfully.
Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.
One-Line Positioning
Adds complete remote SSH operations capability to the DSH Web GUI: centrally manage multiple remote hosts from the web (CRUD, search, connection testing, one-click import from ~/.ssh/config), reuse persistent ssh2 connection pools within the host process to execute commands, run Web terminals, transfer SFTP files, open local port forwarding tunnels, and concurrently run the same command across multiple hosts; also provides 6 tools for the Agent, sharing the same host configuration.
Core Features
- Host CRUD, search, connection testing; supports key / password authentication, passphrase-protected keys, multi-level ProxyJump jump hosts (each hop must be an alias already configured in this plugin)
- One-click import from
~/.ssh/config: parses Host / HostName / User / Port / IdentityFile / ProxyJump fields, skips existing aliases (wildcard mode / skips if HostName missing) - Persistent ssh2 connection pool: each host reuses one long connection (no reconnect each time), auto-disconnects after 30 minutes idle, auto-reconnect on disconnect (max 3 times)
- Command execution: single host exec with timeout (default 60s), stdout / stderr separation, 2MB truncation protection per output
- Web terminal (xterm.js + WebSocket PTY, backpressure auto-pause / resume), SFTP file transfer (browser file selection → NDJSON progress stream), local port forwarding tunnel (listens only on 127.0.0.1, access remote DB / intranet services), cluster concurrent execution (default concurrency 8, filterable by alias / env / tag)
- Agent tools
ssh_list/ssh_exec/ssh_upload/ssh_download/ssh_tunnel/ssh_cluster, GUI and Agent share the same host configuration
Technical Implementation
- Language: TypeScript (host half
src/index.ts) + TypeScript + React 18 + CSS Modules (browser halfsrc/client/) - Key Dependencies:
ssh2^1.17.0 (persistent ssh2 connection pool + SFTP),@xterm/xterm^6.0.0 +@xterm/addon-fit^0.11.0 (browser terminal),ws^8.18.0 (WebSocket PTY) - Architecture Pattern: Dual-half cordis bundle.
src/index.tsis the host half (SshEngineconnection pool +/api/dsh-ssh/*routes + 6 Agent tools + system prompt declaration),src/client/index.tsis the browser half (sidebar entry + host management / terminal / transfer / tunnel / cluster panels + locale registration). Bundle declaration inpackages/dsh-ssh/cordis.patch.yml:10-12(inserts idssh), browser side injects 3 official@deepseek-ai/dsh-client-*viadsh.client.inject(client-runtime/client-connection/client-ui-settings) +platform: web. Connection pool default parameters: 30 min idle, 15s handshake timeout, 15s keepalive interval, 2MB output cap, 60s exec default timeout, cluster concurrency 8, SFTP concurrency 8 (src/engine.ts:33-41) - Entry Files:
packages/dsh-ssh/src/index.ts(host apply),packages/dsh-ssh/src/client/index.ts(browser apply); bundle declarationpackages/dsh-ssh/cordis.patch.yml:1-12, browser dependenciespackages/dsh-ssh/package.json:31-39
Use Cases
- Developers who need to manage multiple SSH servers daily (dev/test/prod mixed): want to centrally browse hosts, execute commands, transfer files, open tunnels to access remote DB / intranet services in DSH Web GUI, saving tool switching;
- Developers who want Agents to directly execute remote operations tasks: pre-configure hosts in GUI (manual entry or import from
~/.ssh/config), then Agent can call the same host configuration viassh_list/ssh_exec/ssh_upload/ssh_download/ssh_tunnel/ssh_cluster; - Users with existing
~/.ssh/config: use "Import ssh_config" to one-click sync existing SSH aliases to the plugin, no duplicate host/port/user/identityFile entry needed.
Prerequisites & Compatibility
| Dependency | Min Version | Description |
|---|---|---|
| DSH Host | 0.1.0-rc.6+ | peerDependencies locked to @deepseek-ai/dsh-* ^0.1.0-rc.6 |
| Node.js | ^22.19.0 or >=24.0.0 | package.json engines.node |
| Platform | macOS / Windows / Linux | host half runs Node.js, client half runs browser; ssh2 is pure JS library, no OS restriction |
| Native Modules | None (runtime) | ssh2 needs no native bindings; upload/download uses ssh2's built-in SFTP |
| React | ^18.2.0 | peerDependency, injected by host runtime |
| SSH Server | Any standard OpenSSH | host half acts as ssh2 client, no server version dependency |
Installation
dsh plugin --profile web add github:CAPTAIN1275/dsh-ui-web/packages/dsh-ssh
Configuration Options
This plugin provides 2 toggles in the "SSH" section of the dsh settings panel:
| Config | Type | Description | Default |
|---|---|---|---|
| enabled | toggle | Plugin master switch; when off, does not register /api/dsh-ssh/* routes, does not register Agent tools, does not announce to Agent | true |
| announceToAgent | toggle | Whether to announce this plugin in system prompts (when off, Agent cannot see SSH tools) | true |
There are also some hardcoded constants not exposed to GUI in the engine (src/engine.ts:33-41): 30 min idle timeout, 15s handshake timeout, 15s keepalive interval, 3 keepalive retry limit, 2MB output cap, 60s exec default timeout, cluster default concurrency 8, SFTP concurrency 8; upload single request body cap 4 GiB, WebSocket terminal backpressure 1MB/512KB (src/routes.ts:23-39). Adjusting requires code changes and rebuild.
FAQ
Q: After installation, the SSH entry doesn't appear in the sidebar. What should I do?
A: Restart dsh web. Bundle activation is done once at host startup; refreshing the browser is not enough. After restart, the "SSH" entry appears in the sidebar, and the Agent prompt will automatically include the plugin description (controlled by the announceToAgent toggle).
Q: How are passwords stored? Is it secure?
A: Stored in plaintext at ~/.dsh/dsh-ssh.json, file permission 0600, directory permission 0700, atomic write (tmp + rename). This is the same trust model as ssh-skill storing passwords in ~/.ssh/config comments - since ~/.ssh/config often stores passwords as comments too, this plugin does not add extra encryption. File path and permissions in src/store.ts:18-20, src/store.ts:328-336.
Q: Can others in the LAN access my SSH console?
A: No. All /api/dsh-ssh/* routes only trust local loopback connections (socket address must match IPv4 127/8 / ::1 / IPv4-mapped ::ffff:127/8, plus same-origin Host header check, sec-fetch-site / Origin), LAN neighbors get direct 403. WebSocket terminal upgrade also goes through the same loopback fence; local port forwarding tunnel only listens on 127.0.0.1, never exposed to external network. See src/routes.ts:42-62, src/engine.ts:709.
Q: Can the Agent execute commands on hosts I haven't configured?
A: No. The Agent can only operate on host aliases already configured in GUI or imported from ~/.ssh/config. Tools like ssh_exec / ssh_upload will directly error if the alias is not configured, never fabricate hosts. This agreement is also written in the system prompt "Constraints" section (src/index.ts:58) and README.
Q: Will remote output be sanitized? Like env command?
A: No. stdout/stderr from exec / cluster is returned as-is (no secret replacement), commands like env may bring back remote environment variables with secrets into the conversation history. This is the same semantics as ssh-skill - transmission/execution consumes real remote resources, user confirmation needed before Agent uses.
Q: Can I download whole directories? How about upload?
A: Download only supports single file (select file in the remote browser in the "Transfer" panel, then go through /api/dsh-ssh/download); upload supports local directory recursion (files transferred one by one after walk), whole directory download not implemented. Limitations in src/engine.ts:519-533, README.md:74.
Q: Can I use aliases from ~/.ssh/config for jump hosts?
A: No. Each hop in the ProxyJump chain must be a host alias configured in this plugin (cannot cross-plugin reference ~/.ssh/config aliases); when importing, if a hop is not in this plugin's host table, it will error and skip during creation. Limitation in README.md:76, src/store.ts:240-260.
Q: Will auto-replay replay my commands?
A: Yes. When exec disconnects, it auto-reconnects (max 3 times), command will be resent on new connection; non-idempotent commands (like rm, appending to files) will have side effects, please use idempotent commands first or confirm before executing. See src/engine.ts:212-231, README.md:75.
Getting Started Difficulty
Beginner - one command install, restart dsh web to see SSH entry; hosts can be manually entered in GUI or one-click imported from ~/.ssh/config, no config files or command line needed. However, since it involves remote hosts, keys, and jump hosts, recommended to try 1-2 exec/tunnel commands before batch usage.
Known Issues & Limitations
- Upload remote target path must be absolute path, relative paths are rejected (
src/engine.ts:486-490,README.md:73) - Download only supports single file; upload supports local directory recursion (files transferred one by one after
walk), whole directory download not implemented (README.md:74,src/engine.ts:519-533) execauto-reconnect on disconnect (max 3 times) will resend same command, non-idempotent commands need to pay attention to side effects (src/engine.ts:212-231,README.md:75)- Each hop in ProxyJump chain must be a host alias configured in this plugin, cannot cross-plugin reference
~/.ssh/configaliases (README.md:76) - Resume (断点续传) not yet implemented; single upload request body cap 4 GiB (
src/routes.ts:23-26) - Agent tool transfer paths are the host machine's local paths (same semantics as ssh-skill) -
ssh_upload/ssh_downloaddirectly read/write any local path with host process permissions, not through bash sandbox, please note this permission surface (README.md:30-31,src/index.ts:58) - Host configuration
~/.dsh/dsh-ssh.jsonstores passwords and passphrases in plaintext, file 0600, directory 0700, no encryption (src/store.ts:328-336,README.md:25-26) exec/clusterremote output returned as-is (not sanitized), commands likeenvmay bring back remote environment keys (src/index.ts:58,README.md:32-33)- Local port forwarding tunnel only listens on
127.0.0.1, external network cannot access; this is fence design, not a configurable option (src/engine.ts:709,src/routes.ts:42-62) - Host aliases only allow letters, numbers, dots
., hyphens-, underscores_(first character cannot be separator); non-conforming regex will error and skip during creation/import (src/store.ts:62-68,src/store.ts:296-303) - When config file is corrupted, it is renamed to
.corrupt-<timestamp>backup, then starts with empty table, will not be silently overwritten (src/store.ts:317-325)
基于 zhu1090093659/dsh-web-ui(Apache-2.0)开发的 DeepSeek Harness(DSH)Web UI 插件套件。全套 22 个包已发布到 npm(
@captain1275/*)。
DSH Web UI 全家桶为 DeepSeek Harness 的 Web 界面提供一系列插件与皮肤:极光毛玻璃皮肤、任务看板、 SSH 运维、右侧文件/变更面板、Git 图谱、移动端远程控制、DeepSeek 娘看板娘(养成系)、实时令牌统计, 以及皮肤中心。所有插件既可独立安装,也可通过聚合包一次装齐。
极光 Aurora 皮肤效果(沉浸光感 / 深色 / 浅色)



特性
极光(Aurora)皮肤(支持动态背景)
- 毛玻璃输入框:高斯模糊(backdrop-filter 30px)+ 半透明玻璃底 + 细边框 + 内高光
- 自定义背景:URL / 本地图片 / 动图(GIF/WebP)/ 视频(mp4/webm) / 透明度 / 模糊调节,
深浅两套极光渐变;视频背景支持静音开关、本地文件持久化(存
~/.dsh/skin-aurora-media/,刷新不丢) - 仿Claude Code推理等级滑块:点击模型菜单的「推理等级」弹出 Effort 滑块面板——无极拖动、松手吸附、 WebGL 火焰跟随、OFF/MAX 刻度、Low/Medium/High/Ultracode 状态

- 用户消息气泡毛玻璃:与输入框统一的玻璃质感
DeepSeek 看板娘(养成系)
- 图片资源(社区同人资源,codex-pet-DeepSeek-girl)
- 养成系统:亲密度 4 级成长(幼鲸 / 伙伴 / 挚友 / 深海羁绊)、升级庆祝气泡、进度条、 Token 零食经济、使用时长成长(每 30 分钟 +1)
- 待机随机气泡:空闲时随机说话(live2d 风格文案)
- 摸头 / 喂食 / 改名 / 拖动,召唤按钮(live2d 同款贴边滑出)
Skill 人格设定
- 设置「人格设定」:开关启用/禁用常驻人格,编辑技能名、描述与人格正文
- 一键生效:保存后写入用户级技能
~/.dsh/skills/catgirl-rp/SKILL.md,DSH 技能系统实时加载, 所有新对话自动以该人格回应(含语气、动作表达、互动规则) - 内置猫娘人格:默认提供「小咪」猫娘人格(常驻生效、好感度系统、模式切换指令),可自由改写
- 可临时退出:对话中说「退出角色扮演模式」即切回普通助手,说「进入角色扮演模式」恢复

用量看板
- 彩色统计卡:累计 token、调用次数、缓存命中、估算费用(按 DeepSeek 官方定价)
- 近 14 天趋势:每日 token 消耗柱状图
- 模型分布:各 provider/model 用量环形图 + 图例
- 会话排行:Top 20 会话(标题 / 模型 / 调用数 / token / 费用)
- 自动记录:对话时自动采集 token 用量(会话快照替换语义,不双计),存
~/.dsh/usage.json - 侧边栏入口:彩色柱状按钮打开全屏看板
功能插件
| 插件 | 功能 |
|---|---|
| dsh-task-board | 侧边栏任务看板:多列 kanban、真实执行(驱动 agent 会话)、定时执行(cron) |
| dsh-ssh | SSH 运维:主机管理、远程执行、SFTP 传输、隧道、集群并发、Web 终端 |
| dsh-aionui-panel | 右侧「预览 / 文件 / 变更」面板:文件树、多格式预览、git 操作、文件拖拽 |
| dsh-git-graph | 会话头部 git 分支选择器 + 提交图 |
| dsh-live-stats | 实时 token 估算与生成速度 |
| dsh-full-stats | 完整统计行:覆盖官方统计(不省略)+ 运行状态指示 + 自定义状态文本(含替换官方 Deep diving...) |
| dsh-usage-dashboard | 用量看板:彩色统计卡 / 近 14 天趋势 / 模型分布 / 会话排行 / 费用估算 |
| dsh-web-ui-settings | 设置页「Web UI 插件」配置组 + 「人格设定」+「关于」版权页 |
| dsh-web-ui-all | 聚合包:一键安装全部插件 |
皮肤中心
10 套皮肤(ths / xp / blue-fantasy / dragon-heir / minecraft / miku / trading / whale-song / aurora / skin-center),支持皮肤启用互斥管理与一键切换。
其余皮肤(ths / xp / blue-fantasy / dragon-heir / minecraft / miku / trading / whale-song) 为上游 dsh-web-ui 自带皮肤。
安装
方式一:npm(推荐,已发布)
# 在 DSH profile 目录(~/.dsh/profiles/web)安装聚合包
npm install @captain1275/[email protected]
然后在 profile 的 package.json 里把 @captain1275/dsh-web-ui-all 加入
dsh.profile.bundles:
{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@captain1275/dsh-client-ui-skin-aurora",
"@captain1275/dsh-full-stats",
"@captain1275/dsh-web-ui-all"
]
}
}
}
重启 DSH 即生效。
方式二:从源码(开发)
git clone <your-repo-url> dsh-web-ui
cd dsh-web-ui
pnpm install
pnpm -r build
# 把本地包链接进 profile(junction)
node scripts/link-profile.mjs
开发
- 构建:
pnpm -r build(或pnpm --filter <package> build) - 新增皮肤:参考
packages/skins/aurora(skin.json+src/client+cordis.patch.yml), 然后用node scripts/skin-center-bundles重新生成注册表 - 聚合包 patch:编辑
packages/dsh-web-ui-all/aggregate.yml后node scripts/aggregate.mjs - 皮肤资产同步:
node packages/dsh-skins/build.mjs
目录结构
packages/
├─ dsh-task-board / dsh-ssh / dsh-aionui-panel / dsh-git-graph
├─ dsh-pet / dsh-live-stats / dsh-full-stats
├─ dsh-web-ui-settings / dsh-web-ui-all / dsh-skins
└─ skins/ # 皮肤源码(aurora、miku、ths 等)
scripts/ # 构建 / 注册表 / 链接工具
shared/ # 共享构建预设(tsdown.client.ts)
版权与许可
- 主体代码:zhu1090093659/dsh-web-ui,Apache-2.0
- 增强优化:@captain1275
- DeepSeek 娘精灵图:xpy12367/codex-pet-DeepSeek-girl, 社区同人资源,版权归原作者
- 人形图标:Font Awesome 6.7.2,CC BY 4.0
- 样式参考:live2d-widget(GPL-3.0,仅参考视觉风格,未搬用代码)
- 商标:DeepSeek 及其相关标识均为 DeepSeek 官方资产;本插件为社区开发者独立维护的非官方同人项目, 不代表 DeepSeek 官方立场。
Read the usage guide →
Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.
Listing badge
[](https://deepseek-plugin.org/plugins/CAPTAIN1275/dsh-ui-web/packages/dsh-ssh)Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.