dsh-ssh-shell
DSH 插件：使用密码通过 SSH 连接远程主机——基于持久化 ControlMaster 会话的自然语言工具（connect/exec/close/status），以及一个通过 WebSocket 提供真实 PTY 的浏览器终端面板（右侧浮动）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:framecy/dsh-ssh-shell#22b7a893a3d205483437b1d21523e093d1e2367dSsh Shell 以 dsh-ssh-shell 发布，当前版本为 0.6.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH 插件：用密码直连远程主机的 SSH 终端。一个自然语言工具（connect / exec / close / status）+ 浏览器右侧浮动终端面板，底层是 OpenSSH ControlMaster 常驻会话 + sshpass + node-pty 起的真实 PTY，经 WebSocket 桥到浏览器。
核心目标：不再频繁断连，断了能自己回来。
ssh_remote 一次建立连接，之后每次远程命令都先向用户确认；terminal_send / terminal_read 直接操作面板里那个活的终端，不逐条确认。ControlMaster + ControlPersist=yes —— master 常驻，不闲置回收；ServerAliveInterval=30 + TCPKeepAlive=yes，抗 NAT / 防火墙 / sshd 掐断静默连接；display:none，socket 和 pty 都活着，展开即续。前置条件：已经装好 DSH（DeepSeek Harness），并且有一个能跑的 profile（下面以 web 为例）。
方式一：从 GitHub 安装（推荐）
dsh plugin --profile web add github:framecy/dsh-ssh-shell
装完重启该 profile。仓库根目录的 cordis.patch.yml 会被自动应用，不需要手工编辑配置。
方式二：本地开发（软链接）
改代码即生效，适合调试：
git clone https://github.com/framecy/dsh-ssh-shell.git
ln -s "$PWD/dsh-ssh-shell" ~/.dsh/profiles/web/plugins/dsh-ssh-shell
然后在 profile 的 cordis.patch.yml 里手工挂上这一行。这种本地路径方式必须写相对路径，不能写包名（包名只在 dsh plugin add 装好之后才解析得到）：
- insert:
- id: ssh-shell
name: './plugins/dsh-ssh-shell/lib/index.js'
重启 DSH
插件只在进程启动时加载，改完必须重启：
# 停掉当前的 dsh 进程（Ctrl+C，或 kill 掉对应 pid），然后重新启动
dsh web
重启后浏览器刷新页面（前端 client.js 是页面加载时取的）。
装好后，右侧边缘会出现「终端」竖条（唯一入口，点它即可打开面板，不占会话头部空间）。
| 依赖 | 说明 |
|---|---|
ssh | OpenSSH 客户端，提供 ControlMaster |
sshpass | 非交互密码认证。brew install sshpass（需要 keepalive tap）或 brew install esolv/sshpass/sshpass |
node-pty | 后端起 PTY 用；作为本插件的依赖自动安装，无需手工处理 |
缺 sshpass 时连接会直接失败并给出明确报错。
cordis.patch.yml 提供这些配置项（由插件自身的 bundle patch 声明，profile 级 cordis.patch.yml 可按 id 覆盖）：
| 配置 | 默认 | 说明 |
|---|---|---|
controlDir | "" → ~/.dsh/ssh-shell | ControlMaster socket 存放位置 |
timeoutMs | 30000 | 单条命令默认超时 |
controlPersistSeconds | "" → yes | 留空 = master 常驻直到自己死；填秒数 = 闲置这么久后回收 |
远程命令始终逐条向用户确认（走 DSH 的 approval 通道），没有关闭它的开关——这是刻意的：确认是安全边界，不该被一个配置项悄悄关掉。
桌面版（DeepSeek Harness.app）：桌面版把页面加载在自有协议
dsh-app://app/下， 该 origin 下location.host是"app"、无法用作 WebSocket 主机名。插件对此自动 回落到本地 Host127.0.0.1:19387（桌面版固定端口）。若你的桌面版改了端口， 在页面里设置window.__DSH_SSH_SHELL_WS_HOST__ = "127.0.0.1:<port>"即可覆盖。
对话里（工具）
ssh root@1.2.3.4 -p 22，密码xxx，连上后看一下/var/log里最近的报错
第一次连接不确认；之后每条远程命令都会把确切命令写出来让你确认。长时间任务传 run_in_background: true，用 job_output 增量读。
面板（GUI）
点右侧边缘的「终端」竖条（唯一的入口）。填 root@1.2.3.4 -p 22 + 密码，连接。
凭据只存在当前标签页（sessionStorage），关掉标签页即清除，不会写到磁盘。
pty 归属于 target（user@host:port），不归属任何单个 WebSocket。理由：
type:"close" 或 master 死亡才真正结束；npm install # 首次：装测试所需的依赖
npm test # 等价于 node tests/run_all.mjs
不需要真实 sshd、不需要网络。测试用假的 ssh / sshpass / node-pty 替换进程边界，
让插件的真实逻辑（目标解析、脚本拼装、工作目录探测、pty 生命周期、WebSocket 扇出、
几何钳位）照常运行。
| 文件 | 覆盖 | 断言数 |
|---|---|---|
tests/core_test.mjs | target 解析、shell 引号转义、cwd 探针封帧与提取、ANSI 清洗、ControlPersist 取值、socket 路径长度约束 | 47 |
tests/terminal_test.mjs | 路由注册、未连接时的输入容错、连接失败回报、pty 扇出与重挂载、订阅者隔离 | 19 |
tests/client_test.mjs | 前端可加载性（CJS shim 回归）、单槽位注册、store 订阅契约、连接状态镜像与描边状态色、WebSocket 地址解析、有界重连策略、几何钳位与持久化 | 110 |
SSH 保活选项已用 ssh -G 验证被 OpenSSH 接受。
| 包 | 声明位置 | 原因 |
|---|---|---|
node-pty、ws | dependencies | 本插件自己要用的库，安装时随插件一起装 |
@deepseek-ai/dsh-tools | peerDependencies | 由 DSH 宿主提供，插件不重复打包一份 |
装好插件后运行时不需要手动 npm install——依赖由安装器处理，@deepseek-ai/dsh-tools 则由 DSH 自己的安装树提供。npm install 只在你想跑测试时才需要。
见 CHANGELOG.md。当前 0.6.0。
Apache-2.0 © 2026 framecy