DSH虚拟机插件v0.1.0聚焦环境损坏、文件传输、服务访问等高频真实问题，新增快照回滚、文件传输、端口转发等关键能力，进一步补齐虚拟机“真干活”场景下必备的核心功能。
核心内容：
1. 快照回滚功能：支持快照创建、恢复与删除，环境装崩后一键回滚恢复
2. 文件传输与端口转发：实现本地与VM双向文件传输及服务访问
3. 后台任务与生命周期管理：支持长任务后台运行，新增VM启停、重启、状态查询等操作

先说明一件事：在虚拟机插件刚发布时，我们很清楚它还只停留在“能用”的阶段——具备创建、执行和删除这三个基础能力。但当真正把它投入实验环境或项目运行时，用户最常搜索和反馈的问题却很集中：环境安装崩了怎么办？代码怎么快速导入虚拟机？VM里的服务如何在本地访问？长时间任务总是超时，能不能稳定后台运行？

这些问题，其实也是我们自己在开发和测试虚拟机环境时每天都会遇到的。所以这次 dsh-plugin-vm-sandbox 升级到 v0.1.0，重点就是围绕这些高频痛点做增强。下面直接看看这次版本更新具体加入了哪些实用功能。

最核心、最刚需的几项能力，这次基本一次补齐

快照回滚：告别“环境坏了只能删机重建”

以前一旦系统环境装坏，只能删除虚拟机重新创建，不仅耗时，还容易影响实验进度。现在可以在跑实验、装依赖或部署项目前先创建快照，出现问题时一键恢复，体验就像游戏存档回档一样直接高效。

本次新增了四个动作：vm_snapshot 创建快照、vm_snapshot_list 查看快照、vm_restore 恢复快照、vm_snapshot_delete 删除快照。底层直接基于 OrbStack 官方的 orb clone 实现，按需复制，不会无谓占用双倍磁盘空间。

文件传输：代码能传进去，日志也能拉出来

通过 vm_upload 和 vm_download，基于 orb push/pull，支持目录递归传输。本地代码包可以直接上传到 VM 中进行编译和测试，虚拟机里的运行日志、测试结果或构建产物也能快速下载回本地查看，不用再靠复制粘贴反复折腾。

生命周期管理：从创建到删除，中间状态终于补齐

过去只有 create 和 delete，想关机、重启或者查看虚拟机状态都做不到。现在补充了 vm_start、vm_stop、vm_restart、vm_status，虚拟机启动、停止、重启和状态查询都能完整覆盖，日常运维更加顺手。

端口转发：VM 内服务可直接在本地访问

如果在 VM 里启动了 Web 服务、API 服务或者数据库，以前本地调试并不方便。现在新增 vm_port_forward，基于 OrbStack 的 SSH 通道（ssh MACHINE@orb -N -L），可将 VM 端口映射到本地 127.0.0.1，本地浏览器和调试工具即可直接访问，体验与本地服务基本一致。

后台任务：再也不用担心执行超时中断

以前使用 vm_exec 跑编译、训练或批处理任务时，一旦会话断开，任务往往也随之中止。现在提供 vm_job_submit 提交后台任务，vm_job_list、vm_job_status 查看任务进度，vm_job_stop 随时停止任务，vm_job_output 获取完整日志。任务会在 VM 中真正后台持续运行，适合长时间执行场景。

操作审计：出问题时有记录可追溯

vm_audit 会记录谁（sessionId）、什么时候、对哪台虚拟机、执行了什么操作、结果成功还是失败，以及对应错误信息。这样在排查虚拟机故障、权限问题或任务异常时，不再需要靠经验猜测，审计信息一目了然。

共享协作：权限与资源配额更清晰

通过 vm_share，可以把虚拟机共享给其他会话，并区分 exec（执行、文件传输、端口转发、任务操作）和 manage（生命周期、网络、快照管理）两种权限级别。vm_unshare 用于取消共享，vm_policy 用于设置资源配额和回收策略。谁有权限、可使用多少资源、何时自动回收，都能清晰配置。

网络策略：公网、内网、隔离模式可按需设置

vm_network 支持 public_access（是否允许访问公网）和 internal_access（VM 之间是否互通），同时提供 isolated / isolate_network 选项，可遵循 OrbStack 官方隔离方式。在实验环境、测试环境或多机协作环境中，用户可以根据安全需求灵活选择封闭网络或互联网络配置。

自定义资源规格：大项目高配置，小测试更节省

vm_create 现在支持指定 cpus、memory（例如 2G 或 4096MiB）、disk（16G 或 64G）。编译大型项目时可以给足 CPU、内存和磁盘资源，轻量测试时则可以使用小规格虚拟机，提升资源利用率，避免浪费。

初始化脚本：创建虚拟机后自动完成环境安装

vm_create 新增 init_script（Shell 脚本，自动包装成 cloud-init runcmd）和 cloud_init（完整 cloud-config）支持。这样在创建 VM 后，就能自动完成 Python、Node、Docker 等环境初始化，减少重复手工配置步骤，适合批量部署和标准化环境创建。

多机并行执行：一条命令，多台虚拟机同时运行

vm_exec 新增 machines 数组参数，可以同时对多台虚拟机并发执行同一条命令。无论是做集群实验、一致性校验，还是批量运维，都不需要再额外写循环脚本，效率更高。

状态查询更详细：一眼掌握虚拟机全貌

现在 vm_status 返回的信息更加完整，包括 IPv4/IPv6、运行时长、系统负载、内存和磁盘实时使用量、最近的 Shell 执行记录、权限信息、共享情况、快照来源、后台任务列表以及端口转发列表等。一条命令就能快速看清一台虚拟机的整体状态。

过去最让人头疼的几类问题，现在都有了明确对应方案：

· 环境装坏了 → 快照回滚

· 文件传不进去、拉不出来 → upload/download

· 只能创建不能管理 → start/stop/restart/status 全生命周期管理

· 服务无法本地调试 → 端口转发

· 长任务执行超时 → 后台任务管理

· 共享权限混乱 → share/unshare/policy

· 排障缺少操作记录 → audit 全程审计

底层原则：优先使用官方能力，不重复造轮子

这次所有功能都严格建立在 OrbStack 官方能力之上，没有额外做黑盒式封装：

功能 底层

快照/回滚 orb clone

文件传输 orb push/pull

生命周期 orb start/stop/restart/info

端口转发 ssh MACHINE@orb -N -L

资源规格 orb create --cpus/--memory/--disk

初始化 orb create -c cloud-init

网络隔离 orb create --isolated/--isolate-network

这样既能保证稳定性和兼容性，也方便用户结合 OrbStack 官方文档进一步理解底层实现逻辑。

工具总数：27 个，覆盖虚拟机管理全场景

升级后共提供 27 个模型工具，基本覆盖虚拟机创建、管理、传输、调试、共享与审计等主要运维场景：

```

vm_list,vm_create, vm_exec, vm_delete, vm_status,vm_start,vm_stop, vm_restart,vm_snapshot,vm_snapshot_list, vm_restore, vm_snapshot_delete,

vm_upload, vm_download,

vm_port_forward, vm_port_forward_list, vm_port_forward_stop,vm_job_submit, vm_job_list,vm_job_status,vm_job_stop, vm_job_output,vm_audit,vm_share, vm_unshare, vm_policy,vm_network

可靠么？我们做了两层验证

· npm run verify：用于校验所有工具的注册信息、参数 schema 以及语法是否合法。

· npm run smoke：集成冒烟测试，会自动创建临时虚拟机，完整跑通核心流程——创建、文件传输、快照回滚、端口转发、后台任务、网络策略、共享/取消共享、审计、并行执行，全部通过才算验证完成。

目前冒烟测试结果是绿的。

后续还能扩展哪些能力？

v0.1.0 先把虚拟机基础运维能力补齐，后续可继续扩展的方向其实还有很多，比如定时任务、模板市场、资源监控曲线、审计日志导出等，这些都已经在 roadmap 规划中。

欢迎大家下载试用，也非常期待你在 GitHub Issues 中分享自己的使用场景、需求和反馈——我们确实希望把这个虚拟机插件打磨成一款日常高频使用、真正离不开的效率工具。

登录查看剩余 70% 内容