在 DSH 里，像 SSH 一样用你的 VPS

运行要求

• DSH 版本0.1.5-rc.2 起（在 DSH Desktop 2.0.10 上测试）
• 系统macOS 或 Linux —— 依赖 OpenSSH 的连接复用，Windows 自带的 OpenSSH 不支持
• Node.js≥ 22.13
• 登录方式只支持 SSH 密钥登录，不支持密码登录，也不支持需要输密码的 sudo
• 权限会改系统的操作要求远端用户是 root 或有免密 sudo；只读查询不需要

添加机器：一页表单，四步完成

1. 插件生成一把专用钥匙 ~/.ssh/dsh_vps_ed25519（不动你原有的钥匙）
2. 用你填的密码登录一次，把这把钥匙的公钥放进服务器的 ~/.ssh/authorized_keys（已有就不重复加）
3. 连接配置写入 ~/.ssh/config.d/dsh-vps.conf，在 ~/.ssh/config 最顶部加一行 Include（改之前备份为 ~/.ssh/config.dsh-bak），然后用钥匙连一次、体检一次
4. 显示结果和主机指纹（首次连接时记录，以后指纹变了会拒绝连接，防止有人冒充你的服务器）

密码只用这一次，不保存：它只放进那一次 ssh 子进程的环境变量，经 SSH_ASKPASS 交给 ssh，不写进任何文件、日志或审计记录。服务器只允许密钥登录时，展开表单里的「没有密码？」按提示放公钥即可。

自己敲的命令会附给 AI：插件记下你用 /vps-sh 执行的最近几条命令和输出（令牌、密码、私钥先打码），下次跟 AI 说话时一起附上 —— 所以可以先自己查，再直接问「看看上面为什么报错」。

分级确认

每段脚本执行前判定风险级别，模型自己声明的级别只能往高调，不能往低压。只读：df -h、systemctl status、docker ps；改动：apt-get install、sed -i、写文件；高危：rm -rf、改防火墙、passwd、reboot、杀进程、curl … | sh。

三道保护

• 改文件先备份。先把原文件备份到服务器的 ~/.cache/dsh-vps/backups/，再原子写入（覆盖时权限和属主保持原样），然后运行你给的校验命令（比如 nginx -t），不通过就自动还原。
• 连通性保险。改防火墙、SSH、网络配置之前，先在服务器上设一个定时恢复（默认 120 秒），改完用全新连接测试；连不上就等它到时自动恢复，你不会被锁在门外。
• 长操作不怕断线。会改东西的操作跑成远端任务，断线后在服务器上继续，可以再接回来看日志。取消只是停止等待，不会杀掉任务。

参数用 key=value 传入。想存自己的菜谱：让 AI 做成一件可复用的事后说一句「存成菜谱」，或者自己写 YAML 放进 $DSH_HOME/vps-manager/recipes/；自定义菜谱 id 带 my- 前缀，按不可信内容对待。

• 一个引擎，三个入口：设置页、/vps- 命令、AI 工具都走同一套执行引擎。脚本经 SSH 标准输入送到服务器，先落成文件再执行，远端命令行里不拼任何外部数据。
• 连接复用：同一台机器共用一条 SSH 主连接（OpenSSH ControlMaster），命令和连接检测走复用连接时只要几十毫秒。
• 终端：伪终端由 ssh -tt 在服务器上申请，浏览器经 WebSocket 连到插件；断线后会话保留一段时间（默认 10 分钟），接回时补发断开期间的输出。不需要编译任何原生模块。
• 给模型的说明：进入 VPS 模式时，插件把这台机器的系统、服务、容器和必须遵守的规则附给模型；VPS 模式下模型不能用本机 bash。

数据放在哪

插件不读取私钥内容，密码也从不经过插件。