安装
在 DeepSeek Harness 里通过 dsh-market 安装
dsh plugin --profile web add dshmarket
或使用命令行
dsh plugin --profile web add github:omdsh-dev/sandbox-micro
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络。请先审阅源码,并尽量锁定 commit(github:owner/repo#sha)。
README
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。