dsh-plugin-vm-sandbox

DeepSeek Harness 的虚拟机沙箱（Web 部署级插件）。

在会话视图环中新增「虚拟机」页签，为每个会话提供 OrbStack 沙箱虚拟机（debian/alpine，同一会话必要时可多台）。状态持久化在 ~/.dsh/vm-sandbox/state.json。

功能（v0.2.0）

Web UI

• 「虚拟机」页签内新增子页签：虚拟机 / 快照 / 任务 / 审计 / 网络·共享
• 快照：列表、创建、恢复、删除
• 后台任务：状态、日志尾部查看
• 审计：操作记录列表（按时间/机器/操作过滤）
• 网络/共享：查看策略、模板、定时任务、服务发现

模型工具

• 快照与回滚：vm_snapshot / vm_snapshot_list / vm_restore / vm_snapshot_delete
• 文件传输：vm_upload / vm_download
• 生命周期：vm_start / vm_stop / vm_restart / vm_status
• 端口转发：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_job_log(轮转/归档)
• 审计：vm_audit（UI 支持 CSV/JSON 导出）
• 共享协作：vm_share / vm_unshare / vm_policy
• 网络策略：vm_network（含 allowlist）
• 自定义资源：vm_create(cpus/memory/disk)
• 模板/初始化：vm_create(template/init_script/cloud_init)
• 多机并行：vm_exec(machines/groups/strategy)
• 状态增强：vm_status
• 定时任务：vm_cron
• 模板库：vm_template
• 热调整资源：vm_resize
• 导入导出：vm_export / vm_import
• 指标历史：vm_metrics
• 服务发现：vm_service_discover / vm_service_register

P1 自动运维

• vm_cron：VM 内定时任务（5 字段 cron 表达式，启停、下次运行时间）
• vm_policy 增加 snapshot_interval_hours / snapshot_retention：自动快照 + 保留策略

P2 模板与规格

• 内置模板：python / node / docker / cuda；支持本地 JSON/YAML 或 GitHub raw URL
• vm_resize：基于 orb config set 运行时调整 CPU/内存/磁盘
• vm_export / vm_import：基于 orb export / orb import 的镜像导入导出

P3 可观测性与编排

• vm_metrics：每 30 秒采样 CPU/内存/磁盘，保留 1440 点，UI 可查询
• vm_exec 新增 groups、strategy(fail-fast/continue)
• vm_network 新增 allowlist（IP/CIDR/域名白名单）
• vm_service_discover / vm_service_register：VM 间服务发现

验证

# 静态/结构验证
npm run verify

# 快速冒烟
VMSB_SMOKE_SESSION=<当前会话ID> npm run smoke

# 全量 E2E：所有工具模块 + 真实 OrbStack 虚拟机
VMSB_SMOKE_SESSION=<当前会话ID> npm run e2e

# UI 路由层：所有 /vmsb-api 端点
VMSB_SMOKE_SESSION=<当前会话ID> npm run ui-test

兼容性

• DeepSeek Harness web profile
• 需要 @deepseek-ai/dsh-client-runtime 与 @deepseek-ai/dsh-client-ui-conversation
• 宿主机安装并运行 OrbStack，orb 位于 /usr/local/bin/orb

License

This project is licensed under the Apache License 2.0. See the full license at https://www.apache.org/licenses/LICENSE-2.0.