常驻虚拟机 Kevinwu901113/dsh-computer

dsh-computer

给 DeepSeek Harness（dsh）一台自己的电脑：一台常驻的 Linux 微型虚拟机，带浏览器、实时桌面画面和审批闸门。不需要 Docker。

dsh-computer demo

智能体在自己的虚拟机里执行命令、打开页面；dsh 里的 Computer 面板实时显示它的桌面。（录制时用的是脚本模型。）

- 智能体的每条命令都在虚拟机里执行，绝不碰你的机器。会话的工作区文件夹按同一路径共享进虚拟机。
- 自带浏览器（mcp__vm__browser_ 工具），登录态重启后依然保留。
- dsh 内实时查看：会话标题栏的显示器按钮会在右侧边栏打开 Computer 标签页。你可以观看、点击、输入，也可以接手处理扫码登录或验证码。
- 危险操作先过审批闸门（sudo、rm -rf、curl | sh、git push，以及支付、登录、删除类点击），审批信息附实时画面链接。
- 一直在：dsh 退出后虚拟机继续运行，下次启动 dsh 自动连回同一台机器。
- 轻量：内置 microsandbox 微型虚拟机（Apple 芯片用 Hypervisor.framework，Windows 用 WHP，Linux 用 KVM）；Intel Mac 回退到 Docker。

安装（dsh 桌面版，macOS）

osascript -e 'quit app "DeepSeek Harness"'
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add github:Kevinwu901113/dsh-computer
open -a "DeepSeek Harness"

首次启动会拉取虚拟机镜像（几个 GB）；镜像就绪前，智能体的命令会排队等待。在输入框下方选择 Computer 权限预设。

状态：v0.4.0，已在 dsh 桌面版 0.2.0-rc.2（macOS，Apple 芯片）上验证通过。设计说明与路线图见 docs/DESIGN.md（中文）。MIT 协议。

中文说明

给 DeepSeek Harness（dsh）一台自己的电脑：一台常驻的 Linux 微型虚拟机，带浏览器、实时桌面画面和审批闸门。不需要装 Docker。

- 智能体的 bash 命令在虚拟机里执行，不碰你的系统。
- 智能体的浏览器（mcp__vm__browser_ 工具）在虚拟机里，登录态长期保留。
- 你随时可以打开实时画面观看或接手操作（扫码、验证码）。
- 危险操作（sudo、rm -rf、curl | sh、git push，以及涉及支付、登录、删除的浏览器动作）先弹审批，审批信息附实时画面链接。
- 会话所在的工作区文件夹自动共享进虚拟机，路径不变。
- dsh 退出后虚拟机继续运行；下次启动自动连回同一台。

当前版本 0.4.0，在 dsh 桌面版 0.2.0-rc.2（macOS，Apple 芯片）上验证通过。

一、要求

| 项目 | 要求 |
| 系统 | macOS（Apple 芯片）、Linux（有 /dev/kvm）、Windows（开启 Hypervisor Platform）。Intel Mac 自动改用 Docker |
| 内存 | 虚拟机默认 4GB 上限，空闲约 0.5GB |
| 磁盘 | 约 10GB 空闲（虚拟机镜像） |
| 网络 | 首次启动要从 ghcr.io 下载镜像；插件会自动使用系统代理 |

虚拟机由 microsandbox 运行（libkrun 微型虚拟机，macOS 用 Hypervisor.framework）。它随插件的 npm 依赖一起安装，不需要单独安装。

二、安装

dsh 桌面版（macOS）

桌面版使用名为 desktop 的配置档，要用 App 自带的 dsh 命令安装：

osascript -e 'quit app "DeepSeek Harness"' # 先退出桌面版
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
plugin --profile desktop add github:Kevinwu901113/dsh-computer
open -a "DeepSeek Harness"
重新打开后，输入框下方的权限选择里会出现 Computer 预设。

命令行版

npm i -g @deepseek-ai/dsh@0.2.0-rc.2
dsh plugin --profile web add github:Kevinwu901113/dsh-computer
cd ~/某个项目 && dsh web

第一次启动

插件会自动下载镜像（几 GB）并创建虚拟机。这期间智能体的命令排队等待，不会报错。完成后日志出现：

computer ready — live view: http://127.0.0.1:18080/vnc/index.html?autoconnect=true&resize=scale

三、共享文件夹

- 在某个工作区新建会话并执行命令时，插件自动把这个工作区共享进虚拟机，路径和本机一致。比如 /Users/你/Documents/项目 在虚拟机里也是这个路径。
- 共享新文件夹需要重建虚拟机：停机 → 磁盘快照 → 带新文件夹恢复，大约 20 秒。期间的命令自动排队，虚拟机里的文件、安装的软件和浏览器登录态都保留。
- 不会自动共享：家目录本身、隐藏目录（如 ~/.dsh、~/.ssh）、~/Library、~/Applications，以及家目录以外的位置。在这些位置启动时，命令在虚拟机的 /home/gem 里执行，并共享 ~/dsh-computer/workspace。
- 想固定共享某些文件夹，在设置里写 mounts（见第五节）。显式写出的文件夹不受上面的限制。

四、观看与接管

在 dsh 界面里：会话顶部右侧有一个显示器按钮，点一下就在右侧栏打开「虚拟机」标签页，可以直接点击和输入；再点一下收起。也可以在右侧栏的「+」引导页里选「虚拟机」。虚拟机还没就绪时，标签页会显示等待状态并自动重试。

在浏览器里：

http://127.0.0.1:18080/vnc/index.html?autoconnect=true&resize=scale

看到的就是智能体的电脑桌面，可以直接点击、输入。

五、配置

桌面版拿不到终端环境变量（只能用 launchctl setenv 设置），推荐写设置文件 ~/.dsh/dsh-computer.json，改完重启 dsh：

{
"mounts": ["/Users/你/Projects/a", "/Users/你/Projects/b"],
"memory": "6G",
"cpus": 4
}

| 设置项 / 环境变量 | 默认值 | 作用 |
| mounts / DSH_COMPUTER_MOUNTS | 自动（见第三节） | 固定共享的文件夹；环境变量用 : 分隔（Windows 用 ;） |
| memory / cpus | 4G / 2 | 虚拟机资源上限 |
| DSH_COMPUTER_PORT | 18080 | 虚拟机服务在本机的端口（仅监听 127.0.0.1）；只能用环境变量设置 |
| image / DSH_COMPUTER_IMAGE | ghcr.io/agent-infra/sandbox:latest | 虚拟机镜像 |
| backend / DSH_COMPUTER_BACKEND | auto | microsandbox 或 docker |
| DSH_COMPUTER_GATE | risky | off 不拦截；risky 拦危险命令和敏感浏览器动作；browser 每个浏览器动作都审批 |
| DSH_COMPUTER_PRESET | computer | computer-auto 关闭审批，只建议在虚拟机里没有重要登录态时用 |

六、维护

插件自带的 msb 命令在 dsh 配置目录里（桌面版如下）：

MSB=~/.dsh/profiles/desktop/node_modules/@superradcompany/microsandbox-darwin-arm64/bin/msb
$MSB list # 虚拟机状态 $MSB exec -u gem dsh-computer -- bash # 进入虚拟机 $MSB stop dsh-computer # 停机（下次 dsh 启动自动唤醒） $MSB rm -f dsh-computer # 删除虚拟机；若有快照，下次启动从最近的快照恢复 $MSB snapshot list --group dsh-computer

每次共享新文件夹都会留下一个磁盘快照（~/.microsandbox/snapshots/dsh-computer/）。快照是链式的，后一个依赖前一个，不能单独删除；每次增加约 15–20MB。虚拟机被误删时，插件下次启动会从最新快照恢复。要回收空间只能整体重置：$MSB rm -f dsh-computer 后删除整个快照目录，虚拟机里的状态会一起清空。

七、出问题时

插件把每次虚拟机操作写进 ~/.dsh/dsh-computer.log。把最后 50 行发出来即可：

tail -n 50 ~/.dsh/dsh-computer.log

| 现象 | 处理 |
| 日志里有「本机虚拟化不可用」 | Windows：管理员执行 Enable-WindowsOptionalFeature -Online -FeatureName HypervisorPlatform -All 和 bcdedit /set "{current}" hypervisorlaunchtype auto，然后重启 |
| 镜像下载很慢或失败 | 确认系统代理可用，或用 image 换成能访问的镜像源 |
| 浏览器工具报错，bash 正常 | 等一分钟；插件会自动清理浏览器锁文件并重启浏览器 |
| 智能体命令长时间无输出 | 看日志是否停在 restore 或 pull |

八、已知限制

- Mac 休眠时虚拟机暂停；真正 7×24 常驻需要一直开着的机器。
- 本机端口没有鉴权：127.0.0.1:18080 只对本机开放，但本机其他程序都能访问。不要在虚拟机里登录高价值账号。
- 浏览器登录后约 30–45 秒才把 cookie 写盘，立刻共享新文件夹或重启可能丢失刚完成的登录。
- 共享文件夹以外的虚拟机文件（如 /home/gem），dsh 的文件读写工具看不到，只能通过命令访问。
- 一台 dsh 配一台虚拟机，还没有「每个会话一台」。
- Docker 后端（Intel Mac）不支持自动共享新文件夹，需要在设置里写 mounts，再执行 docker rm -f dsh-computer。
- Windows 只验证到虚拟化检测，桌面版完整流程未验证。

九、开发：界面部分

界面代码在 ui/，必须用 dsh 官方仓库的 tsdown 预设编译。把 ui/ 放进官方仓库的 packages/client/dsh-computer-ui/，执行 pnpm install --filter "dsh-computer..."，然后在该目录运行 npx tsc -p tsconfig.json --noCheck && npx tsdown，把生成的 lib/client.js 复制到本插件的 lib/。虚拟机端口固定读 18080；改了 DSH_COMPUTER_PORT 时，标签页暂时仍连 18080。