dsh-vps-manager

dsh plugin --profile web add dsh-vps-manager

<div align="center">

<img src="assets/logo.png" alt="dsh-vps-manager 标志" width="120">

dsh-vps-manager

在 DSH 中和 SSH 一样无感地使用 VPS，除了精选的部分常用命令之外，使用时还能让对话中的大模型对 VPS 进行操作。

Use your VPS inside DeepSeek Harness as seamlessly as over SSH: curated zero-token commands, plus the AI in the conversation can operate the server.

<p>

<a href="LICENSE"><img src="https://img.shields.io/github/license/AIcivilization/dsh-vps-manager" alt="MIT 许可证"></a>

<a href="https://www.npmjs.com/package/dsh-vps-manager"><img src="https://img.shields.io/npm/v/dsh-vps-manager?color=cb3837&logo=npm" alt="npm 版本"></a>

<img src="https://img.shields.io/badge/DeepSeek%20Harness-%E2%89%A5%200.1.5--rc.2-4176E6" alt="DeepSeek Harness ≥ 0.1.5-rc.2">

<img src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-blue" alt="平台：Windows / macOS / Linux">

<img src="https://img.shields.io/badge/node-%E2%89%A5%2022.13-339933?logo=node.js&logoColor=white" alt="Node.js ≥ 22.13">

<img src="https://img.shields.io/badge/native%20modules-0-brightgreen" alt="无需编译原生模块">

<a href="https://github.com/AIcivilization/dsh-vps-manager/actions/workflows/dsh-compat.yml"><img src="https://github.com/AIcivilization/dsh-vps-manager/actions/workflows/dsh-compat.yml/badge.svg" alt="DSH 兼容性检查"></a>

<a href="https://github.com/AIcivilization/dsh-vps-manager/actions/workflows/platform-e2e.yml"><img src="https://github.com/AIcivilization/dsh-vps-manager/actions/workflows/platform-e2e.yml/badge.svg" alt="跨平台实测"></a>

<img src="https://img.shields.io/github/stars/AIcivilization/dsh-vps-manager?style=social" alt="star">

</p>

<p>

<a href="https://awesome-dsh-plugin.com/p/AIcivilization/dsh-vps-manager/"><img src="https://img.shields.io/badge/Listed_on-awesome--dsh--plugin-1677ff?style=flat-square" alt="已收录于 awesome-dsh-plugin"></a>

<a href="https://dshget.com/plugins/AIcivilization/dsh-vps-manager"><img src="https://img.shields.io/badge/Listed_on-DSH_Get-1677ff?style=flat-square" alt="已收录于 DSH Get"></a>

</p>

简体中文 · [English](README.md)

</div>

---

简介

安装：DSH 插件市场搜索 dsh-vps-manager 一键安装；也可以先完全退出 DSH，在终端执行下面这行（命令行版 dsh web 把 desktop 换成 web，见[安装](#安装)）。装完打开 DSH，到 设置 → VPS 管理 添加机器。

dsh plugin --profile desktop add dsh-vps-manager

在 DeepSeek Harness（DSH）里管理你的 VPS：用命令查看服务器状态（不走模型、不花 token），跟 AI 说一句话让它登上服务器干活，在对话里一页看清服务器状态，要自己动手就打开真终端、传文件，常见软件和系统维护按菜谱完成。

Windows、macOS、Linux 上的 DSH 都能用，DSH Desktop 和命令行版 dsh web 都支持；家里、公司的几台电脑可以同时管同一台服务器。

添加机器时填一次密码，之后一律用 SSH 钥匙登录。所有操作共用同一套执行机制：会改东西的操作跑成远端任务，断线后在服务器上继续；同一台机器上的改动一个接一个执行；改配置文件前自动备份；改防火墙和 SSH 前，先在服务器上设好自动恢复；每次执行都记审计日志。

想把 DSH 本身装到 VPS 上？ 看姊妹项目 dsh-vps：在 VPS 上执行一条命令，装好带登录页、自动 HTTPS 的原版 DSH，从任何地方用浏览器访问，设置、API Key、插件市场都能正常用，DSH 出新版本时在页面上一键升级。两者可以配合：在 VPS 上的 DSH 里装上本插件，就能在对话里直接管理这台服务器。

---

能力一览

能力 · 说明

零 token 命令 · 22 条 /vps- 命令：看状态、装软件、重启并等机器回来，不走模型

VPS 模式 · 对话头部点一下，这个对话就在操作这台服务器；每个对话各自绑定，一个窗口操作服务器、另一个窗口照常写代码

真实连接状态 · 头部方块 灰 没选 · 黄 连接中 · 绿 已连上 · 红 连不上；连不上直接说原因，带「重试」

对话里的终端 · 真终端（xterm.js + ssh -tt），菜单脚本、top、vim 都能用；红黄绿三键结束 / 最小化 / 最大化；最小化、切对话不丢内容，断线自动接回

对话里的状态页 · 一页看清服务器怎么样：先列规则判出的「需注意」（服务失败、磁盘快满、证书快到期、待装安全更新），再是环形图、磁盘、服务、容器、端口、防火墙等；点 让 AI 解读，DSH 的默认模型用几句话说清楚。可以扩展到 DSH 的右侧栏一直开着、边聊边看，看得见时每分钟刷新，还能切换看你的任何一台机器

对话里的文件管理 · 服务器上的「访达」：拖进来上传、右键下载、双击编辑、删了进回收站能还原；覆盖和编辑前自动备份；右键「让 AI 看看这个文件」

AI 操作服务器 · 5 个工具，按风险分级确认：只读自动、改动问你、高危再问；档位可按机器、分组、全局设置

三道保护 · 改文件先备份、校验失败自动还原；改防火墙和 SSH 前设连通性保险；长操作跑成远端任务，断线不中断

按系统写命令 · 体检出系统、包管理器、init、权限、在跑的服务和容器，告诉模型按这台的实际情况写命令

菜谱库 · 29 条可重复执行的菜谱（安装 7 · 配置 6 · 查询 16），AI 做成的事可以一句话存成菜谱

设置页 · 一页表单添加机器（填一次密码，自动放好钥匙，密码不保存）、从 ~/.ssh/config 导入、基础配置、终端设置、卸载

三个平台、两种 DSH · Windows、macOS、Linux；DSH Desktop 与 dsh web。终端连接过 DSH 登录校验、同源检查和插件令牌，默认只许本机打开

几台电脑一起管 · 每台电脑各有钥匙；改动在服务器上排队，写明是哪台电脑在改；回收站、备份、任务记录共用；卸载只撤销自己的钥匙

中文 / English · 界面跟着 DSH 设置里的语言走，切换后立刻变，不用刷新；服务端的提示、/vps- 命令的输出、菜谱名字也跟着变

装起来轻 · 不用原生模块（不编译 node-pty），运行时依赖只有 ws 与 yaml

---

截图

<!-- 插件市场会从 README 里抓图片当展示图：只放真图，不放占位图。静态截图放 assets/screenshots/。 -->

<!-- README 里不能跑脚本，三张截图在同一个图片位置轮流显示；能一张张点着看的版本在项目网页上。 -->

<p align="center"><a href="https://aicivilization.github.io/dsh-vps-manager/#shots"><img src="assets/screenshots/status-tour.webp" alt="三张截图轮流显示：1 设置 → VPS 管理，五台编号的机器；2 对话下方是文件管理，右侧栏常驻 VPS 状态；3 红圈标出常用入口" width="1000"></a></p>

<p align="center">_{三张截图在这里轮流显示（1 → 2 → 3）；点图片到项目网页上一张张点着看。原图：<a href="assets/screenshots/status-1.webp">1</a> · <a href="assets/screenshots/status-2.webp">2</a> · <a href="assets/screenshots/status-3.webp">3</a><br>1 设置 → VPS 管理：编号的机器清单 · 2 对话下方是文件管理，右侧栏常驻「VPS 状态」 · 3 常用入口都在哪}</p>

<p align="center"><img src="assets/demo.gif" alt="演示：装插件 → 添加机器（生成钥匙、把公钥放到服务器）→ 连上 → 设置页" width="1000"></p>

<p align="center">_{从装插件到接上第一台机器的完整过程（演示里的地址、用户名已涂去）}</p>

---

目录

• [三种用法](#三种用法) · [运行要求](#运行要求) · [各平台](#各平台) · [安装](#安装) · [添加机器](#添加机器) · [几台电脑管同一台服务器](#几台电脑管同一台服务器)
• [在对话里选机器](#在对话里选机器) · [对话里的终端](#对话里的终端) · [对话里的文件管理](#对话里的文件管理) · [对话里的状态页](#对话里的状态页) · [命令](#命令) · [跟 AI 说话](#跟-ai-说话)
• [菜谱](#菜谱) · [设置页](#设置页) · [运行机制](#运行机制) · [它防不住什么](#它防不住什么)
• [数据放在哪](#数据放在哪) · [反馈与建议](#反馈与建议) · [仓库内容](#仓库内容) · [开发](#开发)

---

三种用法

· 看信息 · 跟 AI 说话 · 按菜谱安装与维护

怎么用 · /vps-sysinfo 这类命令 · 「给这台装个 nginx，把 a.com 反代到 3000 端口」 · /vps-install <菜谱id> 看计划，/vps-yes 执行

走不走模型 · 不走 · 走 · 不走

花费 · 零 token · 正常消耗 token · 零 token

能做什么 · 固定的只读查询 · SSH 能做的都能做，按风险分级确认 · 29 条可重复执行的菜谱

---

运行要求

• DeepSeek Harness 0.1.5-rc.2 及以上（到 0.2.x），DSH Desktop 和 dsh web 都可以
• Windows、macOS、Linux 任一系统（见下面的[各平台](#各平台)）
• Node.js >= 22.13
• 日常一律用 SSH 钥匙登录。 密码只在添加机器时用一次（把钥匙放上去）；不支持需要输密码的 sudo
• 会改系统的操作要求远端用户是 root 或有免密 sudo；只读查询不需要

各平台

· Windows · macOS · Linux

SSH 客户端 · 系统自带的「OpenSSH 客户端」。Windows 10 / 11 一般已经装好，没有的话到「设置 → 系统 → 可选功能」添加 · 系统自带 · 系统自带；没有就装 openssh-client

连接速度 · Windows 版 OpenSSH 不支持连接复用，每条命令单独连一次，多零点几秒 · 复用一条连接，几十毫秒

…(truncated)