dsh-plugin-ssh-console
Verifieddsh-plugin-ssh-console · v1.0.3 · MIT · Web UI
Read-only SSH file browser, nvitop-style CPU/GPU monitor and a real multi-pane PTY terminal for DeepSeek Harness, as a dedicated main panel.
Install
dsh plugin add dsh-plugin-ssh-console Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Readme
dsh-plugin-ssh-console
给 DeepSeek Harness 补一个「SSH 控制台」面板:连上远程服务器,只读看目录、像 nvitop 那样盯 CPU/GPU、并开一个真正的交互式终端。
侧边栏新增一个图标(和「插件」「自动化」并排),点开是主区域整页。对话记录不受影响,点回对话就回去了。
多台服务器是一排标签:点哪个标签,下面四个页签(概览/进程/文件/终端)就只显示那一台。同一时刻只采样当前这一台。
┌ SSH 控制台 ● 2 台已连接 ┐
│ ● A100服务器 × │ ● 3号服务器 × │ [+ 连接其他] │ ← 服务器标签
├ 概览 │ 进程 │ 文件 │ 终端 ──────────────────────────────┤ ← 页签
│ A100服务器 Linux 6.8.0 · [email protected]:10007 · 3m │
│ CPU 99.5% ▓▓▓▓ 内存 884G/2.0T ▓▓▓ 负载 2164 磁盘 38% │
│ #0 A100 100% 58°C ▓▓▓▓ 27G/80G ▓▓ 13 进程 │
│ #1 A100 95% 38°C … │
└───────────────────────────────────────────────────────────┘
功能
- 多台并存,一次看一台:可以同时保持多条连接(顶部标签条),点标签切换,四个页签都跟着当前标签走。每台独立连接、独立 CPU 基线;只有当前这台在轮询采样,其余不产生 SSH 往返。
- 标签上显示的是你给这台起的别名(也就是
~/.ssh/config里的Host),不是远端的机器名——建的时候叫A100,标签就写A100,而不是user-H3C-UniServer-R5300-G6。 - 远端机器名跟在别名后面一行淡字,只在它没有重复别名时才出现,用来区分两个同名条目;完整地址在鼠标悬停的提示里。
- 标签上显示的是你给这台起的别名(也就是
- 概览:每 2 秒采样当前主机。CPU(
/proc/stat两次差分算真实占用)、内存、负载、磁盘,以及每卡 GPU 的两条独立指标条——利用率一条、显存一条,各自贴在各自的数字下面。- 磁盘卡把每个真实文件系统都列出来,一个挂载点一行、一行一根条,按使用率从满到空排。没有"标题取哪个"这一说——三台实测机器的关键盘各不相同(两台是
/home,一台是/),任何"挑一个代表"的规则都会在另一台上说谎。卡片独占一整行、挂载点横向铺开,所以不会把旁边三张单数字卡拉高。tmpfs/overlay/squashfs和 snap 的/dev/loop*(只读镜像,永远 100%)都被过滤掉,带空格的挂载点照常解析。
- 磁盘卡把每个真实文件系统都列出来,一个挂载点一行、一行一根条,按使用率从满到空排。没有"标题取哪个"这一说——三台实测机器的关键盘各不相同(两台是
- 进程:两张表,都是真实数据而不是摘要。
- GPU 进程:按卡分组,每张卡一个标题行(
#3 5 进程 · 63.8 GiB),下面列GPU# / PID / 用户 / 显存 / 命令。把nvidia-smi的裸 pid 通过/proc反查成「谁在跑、跑什么」。 - Top 进程:
PID / 用户 / CPU% / 内存% / 常驻内存 / 线程数 / 运行时长 / 状态 / 完整命令行。 - 两张表的命令行都是完整显示,长命令自动换行,不省略、不截断(截断会丢掉解释器路径和脚本名,只剩下参数)。
- GPU 进程一条都不少:
nvidia-smi的输出顺序是乱的,先排序再限制条数,不会因为截断把后面几张卡的进程整片丢掉。
- GPU 进程:按卡分组,每张卡一个标题行(
- 文件:只读浏览。
cd+stat列目录,点目录进入,点文本文件看开头预览(最多 256 KiB)。远端只执行cd/stat/head -c,不写、不删、不上传下载。 - 连接其他服务器:已连状态下点右上角按钮弹出对话框(Esc / 点遮罩可关),不再把下面的页签往下挤。只有在还没连任何服务器时,连接表单才占据页面本身。
- 终端:真正的远端 PTY(
ssh2的shell()通道 + 内置 xterm.js 渲染)。提示符、颜色、行编辑、Tab 补全、Ctrl-C、vim/htop/top全屏程序都能正常用;面板缩放会同步stty size。- 点开「终端」页签自动连上,不需要再点一次按钮。
- 同一台服务器可开多个终端(上限 6 个)。每个都是独立登录:各自的
cd、环境变量、滚动缓冲、窗口尺寸互不影响。顶部标签条列出全部终端,点一下切到哪个窗格;+ 新建再开一个。 - 分屏:
◫左右分屏、⬒上下分屏,两格各跑一个终端;取消分屏只收起布局,终端不关。「关闭终端」才真正结束。 - 会话保留:切页签、切服务器、切分屏、甚至关掉面板再打开,回来的还是同一个 shell——
cd的目录、导出的环境变量、跑着的命令都还在;重新打开面板时会向宿主查询仍在的终端并接回去。 - 搜索回滚内容:
Ctrl+F在窗格右上角打开搜索条,Enter/Shift+Enter前后跳,Esc关闭。搜的是本机已经收到的回滚缓冲(最多 5000 行),不走远端、断网也能搜。命中项会高亮:所有匹配一层淡琥珀,当前选中的那层更重并带描边。颜色只能取#RRGGBB[AA]字面量——装饰 API 自己解析字符串、走不了 CSS 变量,所以取的是主题里的--dsw-alias-state-warn-primary再按比例加 alpha;没有用--dsw-alias-brand-primary,那个 token 是中性色(浅色主题下是近黑,深色下是近白),盖上去只会把正在找的字压成和背景一个亮度。匹配数量自己数——xterm 自带的计数是「装饰条数」,到 1000 就截断,报 3/1000 而实际是 3/4821。 - 参考了 Pebrel 那种「真终端 + SSH」的形态——它是整套 Rust/GPUI 应用(自身渲染器、分屏、SFTP),不能嵌进网页,所以这里只取它最关键的形态:真 PTY + 分屏,而不是把命令当文本跑。
- 分屏的代价(实测):900px 宽的面板左右分屏后每格约 55 列,上下分屏约 116×9 行。行数少于 10 时
htop之类会显得挤,建议宽屏再分。
服务器清单
自动读 ~/.ssh/config,无需配置就能看到你已声明的 Host。也可以在 cordis.patch.yml 里追加:
- id: ssh-console
name: 'dsh-plugin-ssh-console'
config:
refreshMs: 2000
execTimeoutMs: 60000
includeSshConfig: true
servers:
- label: 实验室 B 机
host: 10.0.0.21
port: 22
user: yz
identityFile: ~/.ssh/id_rsa_lab
认证
- 默认:
~/.ssh下的私钥(id_ed25519/id_rsa/id_ecdsa),或 ssh-agent(Windows 命名管道\\.\pipe\openssh-ssh-agent)。 - 密码:界面上那个可选输入框。密码只存在 Harness 宿主进程内存里,不写盘、不进 config、不进日志,断开即丢。
- 私钥由宿主进程读取,浏览器永远拿不到密钥内容。
在界面上管理服务器
服务器列表就是你的 ~/.ssh/config。连接表单里选中一台,字段就填上它的值,直接改就是编辑;点「新建」清空表单填一台新的。点「连接」会先写回文件再连,也可以单独点「保存」。
| 表单 | 配置键 |
|---|---|
| 别名 | Host |
| 主机 / IP | HostName |
| 端口 | Port(总是写,不省略) |
| 用户名 | User |
| 密钥文件 | IdentityFile(可选) |
「总是写 Port」是因为 ssh 对每个参数取第一个匹配到的值:如果文件里有个靠前的 Host * 设了 Port,省略自己那一行就会被它继承,而不是 22。显式写出来才没有歧义。
写入是逐行的外科手术,不是整份重写:
- 只替换属于上面五个键的行,其余行逐字节原样保留
- 注释、空行、
Host *默认块、以及插件不认识的指令(例如HostKeyAlgorithms +ssh-rsa)都不动 - 新建的块插在
Host *之前——同样的「第一个匹配值」规则,放在默认块之后会被默认值悄悄覆盖 - 写入走临时文件 + 原子重命名;写之前会重新解析一遍结果,确认描述的确实是想要的那台,否则拒绝写入
几条刻意的拒绝:
- 别名不能有空格,也不能含
*?!。Host a b在 ssh 里是两个 pattern,*/?是匹配语法——放进去会静默改变这一节的作用范围。 - 文件里出现
Match时拒绝编辑(它会改变周围块的语义,改错是无声的)。 - 不想让面板改这个文件:配置
allowConfigEdit: false,列表变只读。 - 想让它操作另一个文件:配置
sshConfigFile: ~/.ssh/config-dsh。
没有备份。写坏了不会自动回滚——错误信息里会给出完整路径,自己去改。 编辑一台正在连接的服务器会先断开它,它上面的终端也随之关闭(PTY 靠那条连接传字节,不能脱离连接存活)。
主机密钥校验
连接前先做一次不带任何凭据的握手,只取主机密钥,然后按 ~/.ssh/known_hosts 分四种情况处理(格式与 OpenSSH 完全一致,含 [host]:port、HashKnownHosts 的 |1|salt|hash、通配符与 @revoked):
| 状态 | 行为 |
|---|---|
| 已记录且一致 | 直接连接 |
| 未记录 | 弹出指纹确认框,确认前不发凭据;确认后按 OpenSSH 格式追加进 known_hosts |
| 与记录不一致 | 直接拒绝。这是中间人的特征,不是「新主机」,没有「信任」按钮 |
标记为 @revoked |
直接拒绝 |
指纹用 SHA256: + base64(与 ssh-keygen -lf 输出逐字一致),并且在界面里可选中复制。
想换用别的 known_hosts 文件(例如跟 OpenSSH 隔离):
knownHostsFile: ~/.ssh/known_hosts_dsh
安全边界
| 面 | 边界 |
|---|---|
| 主机密钥 | 连接前校验,不匹配即拒绝;未记录时先确认再发凭据 |
| 目录浏览 | 只读。优先走 SFTP readdir,无需远端任何工具;退化路径只跑 cd / stat / head -c |
| 文件预览 | 只读,只取开头一小段 |
| 终端 | 自由执行,等同你本人 ssh 登录(刻意如此,否则跑不了训练和改文件) |
| 密码 | 仅内存,断开即丢 |
| 连接 | 每台服务器一条常驻连接,可同时连多台;断开某一台只影响那一台 |
| 终端回滚 | 宿主侧最多保留 512 KiB,超出丢最旧的,客户端会收到重置标记 |
已知限制
- 目录浏览优先用 SFTP,因此在 macOS/BSD 上也能正常列出(早期版本要求 GNU
stat,这类服务器会直接报错)。只有在服务器没启用 SFTP 子系统时才回退到 shell,那条路径仍需要 GNU coreutils。 - GPU 依赖
nvidia-smi;没有 NVIDIA 卡时概览显示「未检测到 NVIDIA GPU」,其余指标照常。 - CPU 百分比需要两次采样;刚连上的首帧已预置基线,通常直接有值。
- 终端输出是短轮询(约 120 ms 一次)而不是流式推送,所以按键回显有约一个轮询间隔的延迟;可正常用于全屏程序,但不如本地终端跟手。
- 不提供 SFTP 上传/下载、跳板机、端口转发。
安装
桌面端(DeepSeek Harness App)
设置 → 插件 → 添加插件,输入包名:
dsh-plugin-ssh-console
也可以直接填版本 [email protected]。
装完完全退出 App 再打开(Host 半与客户端 chunk 都变了,HMR 不重载插件 JS)。
⚠️ 桌面端的 profile 不能走 CLI 安装(DSH 对
desktopprofile 做了排他保护),请走上面的「设置 → 插件」。
Web / CLI profile
dsh plugin --profile <profile> add dsh-plugin-ssh-console
也可以直接从 GitHub 装(会锁定到具体 commit):
dsh plugin --profile <profile> add github:Heaven-y/dsh-plugin-ssh-console
开发
npm ci # 装依赖(含构建 client.xterm.js 所需的 @xterm/*)
npm run build # 重新生成 client.xterm.js(内嵌的 xterm 渲染器)
npm test # 三套测试:Host 真机 / Client 结构 / 分屏状态机
也可以单独跑:
node test/host.test.mjs # Host 半:真机 33 项(连不上就跳过网络部分)
node test/client.test.mjs # Client 半:结构 22 项
node test/panes.test.mjs # 分屏状态机:4 项
client.xterm.js 是生成文件但提交进仓库——这样包不需要构建步骤就能用。CI 会重新构建并逐字节比对,提交的不是最新构建就直接失败。内嵌的 @xterm/xterm 与 @xterm/addon-fit 均为 MIT,见 THIRD-PARTY-NOTICES.md。
发布
发版由人决定。 改完代码先问一句要不要发,不要自己顺手发。详见 RELEASING.md。
发版只有一条命令,前提是工作区干净且在 main 上:
npm run release patch # 或 minor / major / 1.2.3
npm run release minor --dry-run # 只看会做什么,不打标签
它会先跑完三套测试,再 npm version 同时改版本号、提交、打 v* 标签,然后推送。标签一推,.github/workflows/publish.yml 就会:
- 校验仓库里的
client.xterm.js就是当前源码的构建产物; - 再跑一遍
npm test; npm publish --provenance;- 用该标签创建 GitHub Release。
所以「发版 = 推一个标签」,没有第二步会忘,也没有凭据落在本地。
普通提交不会发版:push 到 main 只触发 test.yml 跑测试,publish.yml 只认 v* 标签。
鉴权用哪条路:
| 场景 | 做法 |
|---|---|
| 首次发布(包还不存在) | 必须用 token:仓库 Secrets 里加 NPM_TOKEN |
| 之后(推荐) | 在 npmjs.com 把本仓库配成该包的 Trusted Publisher,然后删掉 NPM_TOKEN secret |
token 删掉后 workflow 会自动回落到 OIDC;它那条 npm config delete 就是为这个切换准备的。走 OIDC 时仓库里没有任何 npm 凭据可以泄漏或轮换。
验证状态
- Host 半 33 项真机测试:目录清单(走 SFTP)、
~展开、缺目录与普通文件都报错、..归一化、CPU/GPU/内存采样、进程行的 rss/线程/时长字段、GPU 进程归属(uid → 命令)、56 条 GPU 进程一条不少且按卡分组、命令退出码、文件预览、超时中断、PTY 的 ANSI/真/dev/pts/窗格尺寸、resize 同步、全屏程序可跑、重开终端复用同一个 shell、同一条连接上两个独立 PTY(t1在/tmp、t2在/var,环境与尺寸互不影响)、未指定 termId 时明确拒绝而不是瞎猜、关一个不影响另一个、关全部后拒绝写入、双机并行、断开清理、未知主机密钥必须先确认、改了密钥直接拒绝、不同密钥类型不算冲突、磁盘表按df -P -h全量解析(伪文件系统与 snap 的/dev/loop*过滤、带空格的挂载点、满度优先排序,并用三台真机的输出逐条核对)。实测[email protected]:10007(5×A100)与[email protected]:26518。 - Client 半 22 项结构测试:工厂导出、内嵌 chunk 注册与导出面、17 个 descriptor 与 Host 签名逐字对齐、侧边栏与主面板同 id、中英词典对称、样式仅用主题 token、缺少 Remote 载体时明确失败、概览/进程页只渲染当前选中的那台、每张 GPU 卡两根条各自跟自己的指标、连接表单是弹窗、命令行完整不截断、终端自动打开、可新建/分屏/取消分屏且切页不销毁、一个窗格只挂一个 xterm 实例(并发 open 不再叠画布、不重复发送按键)、
Ctrl+F搜索走本地缓冲、命中高亮、关闭时归还焦点并清掉残留选区、装饰颜色是字面量而不是 token(否则 addon 解析不出颜色、什么都不画)、标签页优先显示别名(远端 hostname 只在不重复时才补在后面)、底部三个操作按钮同一尺寸,危险操作用颜色区分而不是缩小、文件工具栏六个图标同一套几何(同 viewBox、同描边、同 14px,不再用字形)、磁盘卡每个挂载点一行一根条、没有单一标题,且横跨整行不让相邻卡片被拉高。 - 已用无头 Chrome 实测:
- GPU 进程表用真机数据整表渲染:55 条进程、5 个分组标题全部出现,命令格 0 个被裁切,表格与页面零横向溢出。
- 另塞入真实的 224 字符训练命令,在 900 / 1420px 下命令格
clippedX/Y全为false,长命令换到 3 行完整显示。 - GPU 卡在 680 / 820 / 1000 / 1420px 四种宽度下零文字截断、零横向溢出;故意塞进 50 字长卡名,验证是换行而不是省略号。
- 八根指标条读回 DOM 量宽度:
#1利用率 100% → 209px、显存 68.2% → 142.6px(轨道 209px),与数字全部吻合(误差 < 0.5%)。浅色与深色两套令牌都渲过。 - 真 xterm 在 820px 面板里算出 106 列 × 38 行、容器有实际尺寸(514px 高),不会因为容器塌陷把 PTY 缩到最小。
- 分屏布局实测(900×620 面板):左右分屏每格 55 列 × 24 行(416×316px)、上下分屏每格 116 列 × 9 行(842×143px),两格都能正常显示提示符。
- 终端搜索实测:在 5030 行回滚里搜
hit,计数 3/3 且顺序与屏幕一致,前后跳都对;一条横跨换行边界的长行里的匹配也能找到(逐行数会漏);不存在的词返回「无匹配」。全量 5030 行扫一次 0.5 ms,所以每次按键都重新计数也不会卡。 - 搜索高亮实测(无头 Chrome,跑的是
client.js里真正会发出去的那三个函数):浅色与深色两套主题下,所有命中显示淡琥珀、当前项显示深琥珀加描边,字形仍然可读。同一张图里对照了被否掉的方案——用--dsw-alias-brand-primary(中性色)当高亮,深色主题下命中的ERROR被近白色糊白、几乎看不见,这就是为什么最终没走那个 token。 - 标签页与按钮尺寸实测(无头 Chrome,喂的是
client.js里那份样式表原文):带别名的标签在浅/深两套主题下都完整显示别名 + 机器名,最长的一台(user-H3C-UniServer-R5300-G6,161px)没有触发省略号——168px 这个上限就是这么量出来的,不是拍的;底部三个操作按钮实测同为 32px 高、13px 字。 - 文件工具栏图标实测(无头 Chrome,图标由
client.js里的组件直接执行后渲染):六个图标在 28×28 按钮里各边留白都是 7.0px,误差为零。改动前这里用的是字形← → ↑ ✎ ⟳ ~,实测墨迹分别是 13×5、13×5、6×12、11×11、12×9、8×2 像素,光学中心彼此相差 1.5px——它们来自互不相关的 Unicode 区块,任何统一基线或内边距都没法让它们对齐。 - 磁盘卡实测(无头 Chrome,喂的是三台真机的
df -P -h输出):680 / 820 / 1000 / 1420px 四种宽度下,3~4 个挂载点全部渲染、挂载点名 0 个被省略号截断、页面 0 横向溢出,每根条的宽度与它自己那一行的百分比吻合(如 100% → 210px、93% → 195px、6% → 13px)。布局是量出来才定的:塞进 180px 卡片格时卡片高 226px,把旁边三张单数字卡从 101px 拉到 226px、每张留下 125px 空白;改成横跨整行 + 挂载点多列后卡片降到 85px,相邻卡片保持 101px。
- 未验证:真实 Harness 面板里的键盘输入手感(需要浏览器控制权)。