跳到正文
dsh-market 浏览插件 GitHub EN

omdsh-dev/sandbox-micro

microsandbox 沙箱支持。

Star 数 ★ 3 分类 安全与权限 收录于 2026-08-13

安装

在 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。

内容来自项目 README(GitHub)↗