strukto-ai/mirage#dsh
把文件系统与 bash 提供者换成 mirage 虚拟工作区：文件工具与 shell 命令作用于挂载的资源（RAM、S3、Redis、Slack、Gmail、Notion、Postgres）而非宿主磁盘，支持按挂载点设置读/写/执行模式、按命令选择沙箱（进程内 monty、pyodide、quickjs；远程 docker、e2b、daytona），并可在虚拟终端中安装 CLI（git、gh、slack、linear、ntn、gws，或自行注册的程序树）作为命令头词。
安装
这个插件放在一个大仓库的子目录里，`dsh plugin add` 够不到它——它转发给 pnpm，而 pnpm 会把 `#` 后面的内容当成分支或 commit。请先 clone 仓库，再用 DSH 插件面板的 repository 源添加，或者请作者发一个 npm 包。
安装前须知
是什么 — mirage 虚拟工作空间让 AI 代理通过 bash 工具操作挂载的资源。
谁该装 — 在使用 bash 工具的 AI 代理开发中，需要同时访问多种后端资源（如 S3、Slack）时适合。 如果仅在本地文件系统上运行且不涉及远程服务，则不适用。
注意 — 没发现明显的坑。存在执行 shell 命令的静态检查提示。沙箱未实测。
锐评 — 不值得装，因为未实测沙箱安全性。
grok-4.6 写的，只当参考，不当结论。里面说装得上或装不上，是在干净 profile 里真跑过的；其余都是读仓库读出来的。以实际运行为准。
mirage 是一个 DeepSeek Harness 插件，用虚拟工作区替换原有的 filesystem 和 bash provider。它把 RAM、S3、Redis、Slack、Gmail、Notion、Postgres 等资源挂载为路径，文件工具和 shell 命令因此直接作用于这些挂载点，而不是宿主机磁盘。每个挂载点可以设置读、写、执行模式；命令则可路由到进程内的 monty、pyodide、quickjs，或远程的 docker、e2b、daytona。
工作区通过 Workspace({...}) 配置，使用 ws.execute(...) 执行 grep、cp、管道和重定向，也能用 ws.snapshot(...) 保存 tarball。虚拟终端还支持把 git、gh、slack、linear、ntn、gws 或自行注册的程序作为命令头词；CLI 配置可携带 Slack token 等访问凭据。
它适合需要跨云服务、消息系统、数据库和文件统一操作界面的 agent。由于 terminal surface 会触达所有已挂载资源，并可能执行脚本或命令，安装前应按这些资源的权限评估风险。若只需要宿主机已有的 filesystem 和 bash，或运行环境不是 macOS/Linux、无法提供 FUSE 所需支持，mirage 不一定合适。
工作区使用 Workspace({...}) 创建，把路径映射到资源。例如 "/data": RAMResource()、"/s3": S3Resource(S3Config(bucket="my-bucket"))。挂载模式包括 MountMode.EXEC 和 MountMode.WRITE。runtimes=[...] 可选择运行时；MontyRuntime(captures=["python", "python3"]) 会捕获这些命令名。CLI 使用 ws.register_cli(name, implementation, config) 注册，配置示例包含 token。
ws.execute("...") 执行命令，README 示例包含 cp、grep、wc、管道和输出重定向。也可执行挂载资源中的 python3 脚本。CLI 提供 mirage workspace create、mirage execute、mirage provision、mirage workspace snapshot 和 mirage workspace load，示例使用 --workspace_id、--command、--id，快照文件为 .tar。SDK 对应方法是 ws.snapshot("demo.tar")。
README 列出 RAM、Disk、Redis、S3 兼容服务、Gmail、Google Drive、GitHub、Linear、Notion、Trello、Slack、Discord、email、MongoDB、Postgres、LanceDB、Qdrant 和 SSH 等资源。运行时包括进程内的 monty、pyodide、quickjs，以及远程的 docker、e2b、daytona。
Python >=3.11 用于 mirage-ai，Node.js >=20 用于 TypeScript SDK；平台为 macOS 或 Linux。FUSE 挂载需要平台支持。相关 TypeScript 包包括 @struktoai/mirage-node、@struktoai/mirage-browser 和 @struktoai/mirage-agents。
根据项目自己的文档整理，会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README
同一分类
yjh051108
一个仓库三件套：DSH 插件包的运行时注入器（注入、热重载、卸载、开发侧挂区一键转正、路由自愈，外带设置页插件管理：列出、卸载、拖入文件夹内化）、任务感知的思维模式路由 agent 预设（router-standard / router-spec / router-react）、以及分级两级任务协议（commit_star / lock_stage / revise_do / edit_plan / mark_task / redteam_verdict 六个工具，任务状态落盘）。注入器实现直接在库内，安装的是它自己的行为而不是一份依赖清单。
装得上，但要先放行构建脚本
weijiafu14
Pi Host ABI 兼容引擎：装一次之后，npm 上的 Pi 扩展原包经 `dsh plugin add <pi-package>` 直接作为 DSH 原生插件挂载。已在官方 DSH 上端到端验证 pi-mcp-adapter（完整 MCP 管理面：OAuth、resources、prompts、MCP Apps、elicitation、sampling）、@tintinweb/pi-subagents、pi-code、pi-hermes-memory、pi-background-tasks；`pi2dsh inspect` 在安装前报告一个包的兼容情况。
我们跑过，装得上
lire1131
DSH 撤销/回退系统：配置变更自动存档，一键撤销/恢复/回退到任意版本，支持 WebUI 与离线 CLI/GUI 工具（DSH 启动失败也能救）。
我们跑过，装得上
Fishquito7
在 DSH Web 设置中管理技能与 MCP 服务器：技能卡片热启停、工作区作用域、分组、批量迁移与拖拽导入，以及 stdio/HTTP MCP 增删改查、连接测试、密钥脱敏，并附带统一 dsh-panel 命令行。
我们跑过，装得上
kanneiren
可视化 DSH 进程在 Windows 或 WSL 上的网络链路（DNS/TCP/TLS/HTTP 分层探测），检测失效的代理配置，并提供带快照回滚的安全修复。
我们跑过，装得上
