Sutera-Diffusus/dsh-sandbox-tester

README excerpt

dsh-sandbox-tester DSH 沙盒测试器 ——为 DeepSeek Harness 打造的进程级隔离测试场。 开发者正在面对什么 在 DSH 上开发插件、打补丁、做测试时,你面对的是这样一个现实: 所有插件都运行在同一个宿主进程里 。改坏一行代码,死循环会卡死整个主进程,未捕获异常会崩掉整个应用;测试脚本一个手滑,误杀进程、误删数据,连聊天记录都可能一起陪葬。然后就是那个熟悉的循环:页面打不开 → 重启 Launcher → 切换间隙报连接失败和 400 → 再重启……改坏一次代码,一晚上就没了。 于是,有了沙盒测试器 把每一次开发/测试改动,先关进一个 完全隔离的沙盒实例 (独立进程 + 独立数据 + 独立端口)里跑:沙盒里随便崩、随便死循环、随便误操作,最坏的结果也只是沙盒进程自己倒下, 本体 3080 全程无恙 。改动想回到本体,还必须通过 机器强制的合回门禁 (目标白名单 + 逐文件语法校验 + bundle 校验 + 备份/回滚清单),带着坏状态偷渡?门都没有。 沙盒里随便作,本体永不翻车。 目录 - 特性 - 架构 - 安装要求 - 安装教程 - 使用说明 - 合回门禁 - 数据与隐私 - 项目结构 - 开发与测试 - 故障排查 - License 特性 🧪 进程级隔离沙盒 - sandbox create 从本体程序目录复制出独立沙盒(默认裁剪, fullCopy: true 全量); - 沙盒 = 独立程序副本 + 全新 DSH HOME + 自动分配独立端口(3182 起,冲突自动 +1); - 沙盒由 node bin.js web --port 直接拉起,崩溃只死沙盒进程; - 实证:沙盒内注入坏补丁/强杀沙盒进程,本体 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 →…

Category