sandbox-micro

English | 中文

失败关闭的 microsandbox microVM 能力 DSH profile 组合包。root package 提供 ctx.microsandbox provider，并以 @deepseek-ai/dsh-sandbox-microsandbox/tool 导出模型可见工具。

仓库结构

package.json              # provider/tool 包和 dsh.bundle 清单
cordis.patch.yml          # dormant provider/tool 行
src/                      # provider、runtime、resolver 和 tool subpath
lib/                      # 生成的安装产物
legacy/                   # 旧 DSH 快照的宿主接线补丁，仅作迁移资料
docs/                     # provider/tool 详细说明
tests/provider/            # provider、resolver、SDK 和 host 测试
tests/tool/                # model tool 和 renderer 测试

单一 root 产物保持 Git/profile 安装自包含，同时保留两个 Cordis entry：

- id: microsandbox
  name: '@deepseek-ai/dsh-sandbox-microsandbox'

- id: tool-microsandbox
  name: '@deepseek-ai/dsh-sandbox-microsandbox/tool'

两个行都默认禁用。启用时 profile 必须显式打开 provider 的 config.enabled: true，并单独打开 tool 行，避免安装组合包就启动 microVM 能力或向模型暴露工具。

能力边界

ctx.microsandbox 是环境连贯的 microVM service，不是 dsh-sandbox 的同世界 provider。它使用固定版本 microsandbox@0.6.7 SDK、包自有 msb 解析、有界功能限定和失败关闭的平台检查，绝不会退化为无约束宿主执行。

工具 entry 提供：

microsandbox_exec  精确 argv 执行和 captured output
microsandbox_fs    guest 文件读、写和目录列表

旧宿主接线补丁保留在 legacy/ 中，供尚未提供 provider/tool catalog 和 composition 接缝的 DSH 快照使用；新的 bundle 层不修改 DSH 宿主源码。

开发

完整 typecheck 需要 sibling checkout：

~/git/deepseek-harness
~/git/sandbox-micro

pnpm install
pnpm run typecheck
pnpm test
pnpm run build

prepare 直接从 src/ 构建 provider、invariant 和 tool entry，因此 Git 安装不需要 sibling project references。pnpm 10 可能要求 profile 允许 prepare 脚本；只应批准固定且可信的 checkout。

已知限制

• Linux 需要可用 /dev/kvm；不支持或未通过限定的 host 保持 unavailable。
• 第一版不纳入 macOS Apple Silicon real-host acceptance。
• Secrets、network policy、snapshots 和 image/volume lifecycle tools 仍是 provider-only 或请求时失败关闭。
• 外部 SDK 和平台二进制固定为 0.6.7，需要对应的 registry package。