DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-vm-sandbox

x

dsh-vm-sandbox

Discovered

A plugin for running sandboxes with libkrun, for use with dsh

Machine translated

krun VM sandbox — DeepSeek Harness 的 libkrun microVM 沙盒插件

把 DSH(DeepSeek Harness)的 sandbox 接缝替换为 libkrun microVM 后端:受限命令在 独立内核的轻量 VM 内执行,工作区以同绝对路径双向共享,系统级副作用持久化在 "工作区数据层"(ext4 稀疏盘,guest 内 overlay upper),镜像层只读可复用。

完整设计、实测记录与验证清单见 krun-vm-sandbox-design.md (附录 C = 实测记录;附录 D = 验证 TODO)。

能力一览(2026-11-15)

  • Sandbox 接缝:confine 落 VM、fail-closed、EROFS 拒绝方言 + 官方拒绝标记/升级提示 (agent exec2 帧协议做 stdout/stderr 分离——官方拒绝分类只查 stderr)
  • 空闲回收:idleStopMs + agent stat 活跃连接探测(run_in_background 长驻子进程与 端口转发连接免回收)
  • /vm 人类命令:/vm status、/vm stop [all|<key>|ro|rw]、/vm reset confirm(两段式确认)
  • 镜像管理:URL / tarball / 目录 / 容器导出导入到 <dataDir>/images/<id>/, manifest + registry.json 工作区绑定(boot 解析顺序 = 绑定 → imageRootfs)、 删除保护、Alpine 自动免 root 装包;管理页"镜像 / 工作区绑定"两卡 + 内置已测预设(alpine-minirootfs 3.22、ubuntu-base 24.04)
  • 侧栏终端:GUI"新建终端"shell 选择器里的 krun 项(plugin/bin/krun 桥, OSC 7777 resize 直达 guest PTY,会话未运行自动引导)
  • 网络档按工作区:全局默认 + 工作区绑定覆盖(tsi/none,管理页选择器/workspaces/network API), 档位变化自动停旧启新;portMap: ["host:guest"] = vsock 应用层转发(宿主绑 127.0.0.1), none 档下即"零占用 + 只暴露指定端口"组合
  • qcow2 数据层:dataDiskFormat: 'qcow2'(qemu-img 建盘,guest 内首启格式化)
  • 诊断 skill:diagnose-krun-vm-sandbox(全局 skill,排障路径 + 常见失败表)
  • 会话守护进程:serve(默认开启,daemon: false 回退直 spawn)——跨进程共享会话 (同 dataDir 的 live/headless 共用一 VM)、配置指纹漂移防线、boot 子进程监督、PDEATHSIG 孤儿回收
  • 管理页:Settings → "VM sandbox"(环境体检 / 运行会话 / 镜像 / 工作区绑定)+ composer 状态芯片

布局

路径内容
krun-vm-sandbox-design.md设计文档(§1-14 设计;附录 A-D 接口/事实/实测/TODO)
backend/krun-backend/宿主侧 Rust:probe / boot(每会话一 VM 子进程,PDEATHSIG 绑父)/ exec(agent 客户端,exec2 帧解包)/ serve(会话守护进程:注册表/监督/gc/端口转发监听,协议见 serve.rs)
backend/guest/dsh-vm-agent/guest 内代理(musl static-pie):vsock:42 上的 exec(fork/execve + env 透传)、exec2(stdout/stderr/退出码帧分离)、term(PTY + OSC 7777 resize)、vsock 端口转发中继、stat(活跃连接);全 fd CLOEXEC
backend/vendor/libkrun/git submodule:containers/libkrun stable-1.19.x,锁定 1.19.8 发布点(c4d283c2);path 依赖 src/libkrun,可打补丁
plugin/@local/dsh-krun-vm 插件:index.js(SandboxProvider + /vm 命令 + 镜像管理路由 + 端口转发监听 + 空闲回收)、diagnose-skill.js(诊断 skill)、terminal-backend.js(persistent-shell 组内注册器)、client.js(设置页四卡 + 预设清单 + 状态芯片)、guest/setup.sh(guest 内三层编排 + 首启格式化)、bin/krun(侧栏终端桥)、bin/krun-backend、guest/dsh-vm-agent{-aarch64,}(构建产物,已忽略)
m0/可行性尖峰:FFI 探针 / 引导冒烟(koffi 路线已弃用的实证)
harness/接线工件:krun-overlay.yml(dsh --patch 用)、krun-preset-override.yml(三预设覆写生成物)、krun-overlay-headless-*.yml(headless 验证 overlay)
scripts/build.sh构建并部署二进制到 plugin/(x86_64 + best-effort aarch64 agent)

构建

依赖:rustup(含 x86_64-unknown-linux-musl target)、libclang(bindgen)、 运行时需要 libkrunfw.so.5(系统安装,或放到 <dataDir>/tools/lib;见下"运行时依赖")。

scripts/build.sh

接线(live profile)

~/.dsh/profiles/web/cordis.patch.yml:

  1. disable base bundle 的 sandbox 行 + insert sandbox-vm(provider 替换,network: none)
  2. preset-minimal / preset-standard / preset-ptc 三预设覆写(persistent-shell 组内 注册 krun 终端后端;cordis/创造模式未动)。preset 为快照,dsh 更新后用 harness/krun-preset-override.yml 头部的生成方式重新生成。

验证:dsh --profile web --dump-config;激活冒烟: dsh headless --patch harness/krun-overlay-headless-test.yml "..."(不占 3080、不动 live 会话; 绝对路径加载插件 + headless 默认模型路由)。

注意:插件代码更新后,live web 实例需重启 dsh(或插件重载)才会加载新代码; 已运行会话的 VM 由 provider disposer 停止,数据层天然落盘恢复。

运行时依赖(全部按「环境变量 → 系统 → PATH → <dataDir> 捆绑」发现,不依赖任何用户目录)

  • /dev/kvm 可写(KVM API v12 实测通过)
  • libkrunfw.so.5:系统包,或放 libkrunfw*.tgz 到 <dataDir>/tools/(激活期自动解包到 tools/lib),或 POST /api/krun/tools {"path": "<tgz>"} 显式安装
  • e2fsprogs(mkfs.ext4/mke2fs):发行版默认自带;无则可放提取版到 <dataDir>/tools/e2fsprogs(注入 KRUN_E2FSPROGS_DIR)或设 KRUN_MKE2FS
  • qemu-img(仅 dataDiskFormat: qcow2):主机 qemu-utils,或 KRUN_QEMU_IMG
  • guest 镜像:无需预置——首次使用自动自举 Alpine minirootfs 到 <dataDir>/images/; 也可管理页/API 导入,或把遗留 rootfs 目录配到 imageRootfs(首次使用自动迁入 dataDir)
  • 运行期资产目录:默认 ~/.dsh/storages/krun-vm(DSH_HOME 被尊重),含 images/ workspaces/ tools/ logs/ run/ registry.json;旧默认 ~/.dsh-krun 首次激活自动迁入

Comments

Loading…

Similar plugins

dsh-quarantine

by Thanjinx

dsh插件,增加一个隔离区,完全独立于所有插件,适合做实验

Manifest valid

★ 0

MIT

JavaScript

Nov 6, 2026

dsh plugin --profile web add dsh-quarantine

by JiamingZang

dsh插件,将dsh的LLM请求路由到本机Qoder CLI,可使用Qoder credits与模型。

Manifest valid

★ 4

MIT

TypeScript

Oct 2, 2026

dsh plugin --profile web add @jiamingzang/dsh-llm-qoder

by Ye-nile

用 dsh 做的一个提示待办与自动总结的小插件

Manifest valid

★ 0

MIT

JavaScript

Nov 16, 2026

dsh plugin --profile web add dsh-to-do-marks

by PlusQi

个人 DeepSeek Harness (DSH) 插件集

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 0

MIT

JavaScript

Sep 10, 2026

dsh plugin --profile web add dsh-plugins

by hddwbd

deepseek Harness 模型代理插件

Manifest valid

★ 0

JavaScript

Aug 17, 2026

dsh plugin --profile web add dsh-plugin-llm-proxy

by lionwill

DSH上下文压缩插件

Manifest valid

★ 0

MIT

TypeScript

Sep 16, 2026

dsh plugin --profile web add dsh-compactor