DSH Plugins
返回列表
🖥️

dsh-pve-vm

客户端 更新于 2026.10.18

在终端中运行以下命令:

dsh plugin install taxah92/dsh-pve-vm

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 dsh plugin install taxah92/dsh-pve-vm,或按插件市场说明从 https://github.com/taxah92/dsh-pve-vm 安装。

插件介绍

大多数「电脑使用」类插件只能操控 Agent 所在的那台机器,因而依赖本机 X11/Wayland、截图与输入注入。dsh-pve-vm 走另一条路:通过一条 SSH 连接,直接驱动 Proxmox VE 节点上虚拟机的控制台。宿主机可以是无头服务器、Wayland 桌面或远在别处的笔记本;虚拟机可以是 Windows、任意 Linux 图形环境,甚至尚未完全启动的系统。

在画面上,console_shot 返回虚拟机屏幕截图(支持区域与缩放以控制 token 成本),鼠标键盘工具在 VM 屏幕坐标下完成移动、点击、拖拽、滚轮、组合键与批量动作链。需要确定性、低成本时,可用 vm_exec、vm_file_read/write、vm_status 等通过 QEMU Guest Agent 跑命令与读写文件,只在 GUI 挡路时才用像素。输入侧针对大写、符号与 Unicode 做了专门处理;剪贴板读写则让文本进出虚拟机不必靠 OCR。Web UI 提供多语言设置卡,右侧「VM screen」面板与 Agent 共用同一条 VNC 会话实时展示画面,仅供观看、不注入输入。

插件在包内自实现 RFB、认证与 PNG 编码,宿主机与 PVE 节点上无需额外安装运行时依赖。适合已在 Proxmox 上跑工作负载、希望让 Harness Agent 远程操作 VM 控制台或 Guest Agent 能力,且能以 root(或可执行 qm)SSH 登录节点的用户。需 DeepSeek Harness ≥ 0.2.0-rc.2、Node.js ≥ 22,并自行在 allowVmids 中放行 VM ID。

使用场景

  • 在 Windows 登录界面或图形界面里完成点击与输入
  • 通过 Guest Agent 在虚拟机内执行命令、读写文件
  • 在 Harness 侧边栏实时观看 Agent 操作的 VM 画面

适合人员

  • 在 Proxmox 上跑 Windows/Linux 工作负载的运维与开发
  • 需要 Agent 操作远程 VM 而非本机桌面的 Harness 用户
  • 能以 SSH 登录 PVE 节点并配置 allowVmids 的管理员