Sutera-Diffusus/dsh-sandbox-tester

Name: Sutera-Diffusus/dsh-sandbox-tester
Author: Sutera-Diffusus

Plugin插件 Native原生 ⭐ 5 MIT Approval & Security审批与安全

DSH沙盒测试器：DeepSeek Harness的进程隔离测试环境

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

dsh-sandbox-tester is a native plugin built exclusively for DeepSeek Harness (DSH), designed to provide process-level isolated testing environments for DSH plugin and patch developers. It addresses a core pain point of native DSH development: all plugins run in the same host process, so a single bad line of code or infinite loop can crash the entire DSH app, potentially leading to data loss. This plugin only supports Windows 10 and 11, requires Node.js 18 or newer, and works with DSH version 0.1.0-rc.6 or newer compatible builds.

The tool is intended for developers who build custom plugins or patches for DSH, and it follows a clear separation between the orchestration plane running on the main DSH instance and the execution plane running inside the isolated sandbox. To use it, you first create a new sandbox, which copies a trimmed (or full) DSH instance, assigns an unused port starting from 3182, and sets up an independent data directory. You then inject your plugin or patch into the sandbox, run it to test for crashes or bugs, and only merge changes back to the main DSH instance after passing all mandatory gate checks.

Installation is done via a PowerShell script that you run with Node.js, pointing to your existing DSH installation directory. The script is idempotent, so running it multiple times will not cause issues, and after installation completes you just need to restart DSH to activate the plugin. The plugin is released under the permissive MIT license, does not include any telemetry or external network calls, and automatically prunes any orphan or idle sandboxes older than 48 hours to save disk space. Each sandbox takes up roughly 270MB of disk space by default.

这是一款专为 DeepSeek Harness (DSH) 打造的原生进程级隔离沙盒测试插件，主要面向在 DSH 上开发、测试插件和补丁的开发者。它解决了 DSH 原生环境下所有插件共享同一宿主进程的问题——原本改坏代码或出现死循环会导致整个 DSH 主进程崩溃，甚至丢失用户数据和聊天记录。本插件仅支持 Windows 10/11 系统，要求 DSH 版本为 0.1.0-rc.6 或同系列版本，Node.js 18 及以上版本才能运行安装脚本。

本插件面向需要在 DSH 中开发、测试自定义插件或补丁的开发者，标准工作流遵循编排与执行分离的设计原则。开发者可先创建一个独立的沙盒实例，沙盒拥有独立的 DSH 程序副本、独立数据目录和自动分配的不冲突端口，待测插件或补丁会被注入到完全隔离的沙盒进程中运行，崩溃或异常不会影响主 DSH 实例。测试验证通过后，可通过强制合回门禁将改动合并回主 DSH 环境。

本插件遵循 MIT 开源许可，不收集用户数据，也没有任何遥测或外部网络请求，仅在本地进行沙盒管理。安装需要通过 PowerShell 执行幂等安装脚本，指定 DSH 安装目录后即可自动完成配置，安装完成后需要重启 DSH 才能生效。每个沙盒默认占用约 270MB 磁盘空间，支持列出、启动、停止、销毁沙盒，自动清理超过 48 小时的闲置沙盒。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-sandbox-tester（Sutera-Diffusus/dsh-sandbox-tester）
仓库：https://github.com/Sutera-Diffusus/dsh-sandbox-tester
本站详情页：https://www.yhbd.top/plugins/sutera-diffusus-dsh-sandbox-tester/
本站登记：类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 5 · 最近提交 2026-08-16 · 主语言 JavaScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意

Only 5 stars - very few users, little community feedback星标只有 5，几乎没人在用，遇到问题缺少社区反馈

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add github:Sutera-Diffusus/dsh-sandbox-tester

把 Sutera-Diffusus/dsh-sandbox-tester 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

13.6 KB · 缓存于 2026-08-23 03:42:31 · 13.6 KB

dsh-sandbox-tester

DSH 沙盒测试器——为 DeepSeek Harness 打造的进程级隔离测试场。

开发者正在面对什么

在 DSH 上开发插件、打补丁、做测试时,你面对的是这样一个现实:所有插件都运行在同一个宿主进程里。改坏一行代码,死循环会卡死整个主进程,未捕获异常会崩掉整个应用;测试脚本一个手滑,误杀进程、误删数据,连聊天记录都可能一起陪葬。然后就是那个熟悉的循环:页面打不开 → 重启 Launcher → 切换间隙报连接失败和 400 → 再重启……改坏一次代码,一晚上就没了。

于是,有了沙盒测试器

把每一次开发/测试改动,先关进一个完全隔离的沙盒实例(独立进程 + 独立数据 + 独立端口)里跑:沙盒里随便崩、随便死循环、随便误操作,最坏的结果也只是沙盒进程自己倒下,本体 3080 全程无恙。改动想回到本体,还必须通过机器强制的合回门禁(目标白名单 + 逐文件语法校验 + bundle 校验 + 备份/回滚清单),带着坏状态偷渡?门都没有。

沙盒里随便作,本体永不翻车。

特性

🧪 进程级隔离沙盒

sandbox_create 从本体程序目录复制出独立沙盒(默认裁剪,fullCopy: true 全量);
沙盒 = 独立程序副本 + 全新 DSH_HOME + 自动分配独立端口(3182 起,冲突自动 +1);
沙盒由 node bin.js web --port <p> 直接拉起,崩溃只死沙盒进程;
实证:沙盒内注入坏补丁/强杀沙盒进程,本体 3080 全程 HTTP 200。

🛠️ 9 个原生工具

工具	用途
`sandbox_list`	列出全部沙盒(状态/端口/年龄/最近报告)
`sandbox_create`	创建沙盒(裁剪或全量复制、指定端口)
`sandbox_inject`	把待测插件/补丁打进沙盒(自动备份 + 回滚清单,路径越界即拒绝)
`sandbox_run`	预检本体 → 拉起沙盒 → 轮询健康 → 可选一键 QA
`sandbox_health`	端口 + HTTP + 关键 bundle 检查,产出报告
`sandbox_stop`	停止沙盒(进程树校验:永不会误伤 3080)
`sandbox_destroy`	销毁沙盒(需 `confirm: true`,目录与注册表全清)
`sandbox_merge`	门禁式合回(见下文)
`sandbox_prune`	清理孤儿/超龄沙盒(默认 48h 标记,dryRun 预览)

🚧 合回门禁(机器强制,不可绕过)

目标白名单(11 个补丁面文件 + 显式新增)→ 逐文件 node --check → bundle 校验 → 备份计划 + 回滚清单 → 默认 dryRun 只校验出报告;真实写入需 DSH_SANDBOX_MERGE_ALLOW=1 且失败即自动回滚。

🌐 一键 QA(真实浏览器)

sandbox_run qa: true 接跑 CDP 9223 驱动的 headless Edge:首页 200、/plugins/dsh-sandbox/client.js 200、设置页真实渲染「测试沙盒」区段、控制台无未捕获异常,产出结构化报告。

⚙️ 设置页管理

DSH 设置 → 测试沙盒:沙盒卡片(状态徽标/报告徽标/端口/年龄/操作按钮)、新建表单、48h 超龄提示、一键清理、合回门禁摘要卡。

架构

设计原则:编排/执行平面分离

dsh-sandbox 遵循编排平面与执行平面分离(orchestration–execution separation)原则:编排平面驻留于本体进程(信任域 T0),只承担调度、校验与生命周期管理;一切不可信的插件与补丁都在执行平面——独立沙盒进程(不可信域 T1)——中运行。两个平面之间唯一的交互通道是受操作系统强制约束的进程边界,不存在任何共享内存或共享数据目录。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 Sutera-Diffusus/dsh-sandbox-tester 的 README.md。在 GitHub 查看原文 →