mirage
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,或自行注册的程序树)作为命令头词。
安装
把 mirage 装进 DeepSeek Harness
这个插件放在一个大仓库的子目录里,`dsh plugin add` 够不到它——它转发给 pnpm,而 pnpm 会把 `#` 后面的内容当成分支或 commit。请先 clone 仓库,再用 DSH 插件面板的 repository 源添加,或者请作者发一个 npm 包。
安装前须知
装 mirage 之前,先看这几条
- 源码在这里: strukto-ai/mirage——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:Apache-2.0。
- 自动识别到:终端执行。授权之前请先读一遍源码。
- 被收录在这里不代表通过了安全审计。插件是带着你 agent 的权限在跑。
AI 锐评
是什么 — mirage 虚拟工作空间让 AI 代理通过 bash 工具操作挂载的资源。
谁该装 — 在使用 bash 工具的 AI 代理开发中,需要同时访问多种后端资源(如 S3、Slack)时适合。 如果仅在本地文件系统上运行且不涉及远程服务,则不适用。
注意 — 没发现明显的坑。存在执行 shell 命令的静态检查提示。沙箱未实测。
锐评 — 不值得装,因为未实测沙箱安全性。
grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。
mirage 是做什么的

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 不一定合适。
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
同一分类
mirage 的同类插件
dsh-user-experience
DietCokewithSugar
帮你发现项目中可能存在的用户体验问题:自动走查 React/TypeScript 源码,定位问题并给出具体优化建议。
我们跑过,装得上