Skip to content

dsh-plugin-ssh-console

Verified

dsh-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

npm Test

给 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 的输出顺序是乱的,先排序再限制条数,不会因为截断把后面几张卡的进程整片丢掉。
  • 文件:只读浏览。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

认证

  1. 默认:~/.ssh 下的私钥(id_ed25519 / id_rsa / id_ecdsa),或 ssh-agent(Windows 命名管道 \\.\pipe\openssh-ssh-agent)。
  2. 密码:界面上那个可选输入框。密码只存在 Harness 宿主进程内存里,不写盘、不进 config、不进日志,断开即丢。
  3. 私钥由宿主进程读取,浏览器永远拿不到密钥内容。

在界面上管理服务器

服务器列表就是你的 ~/.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 对 desktop profile 做了排他保护),请走上面的「设置 → 插件」。

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 就会:

  1. 校验仓库里的 client.xterm.js 就是当前源码的构建产物;
  2. 再跑一遍 npm test;
  3. npm publish --provenance;
  4. 用该标签创建 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 面板里的键盘输入手感(需要浏览器控制权)。