mirage

Name: strukto-ai/mirage#dsh
Author: strukto-ai

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，或自行注册的程序树）作为命令头词。

3,467258TypeScriptApache-2.0源码

安装

把 mirage 装进 DeepSeek Harness

GitHub 方式 · GitHub 源码

这个仓库里带了好几个插件，后缀用来指定其中一个。另外从 GitHub 装会执行构建脚本，pnpm 默认拦着，需要把它打印出的 key 加到 profile 的 pnpm-workspace.yaml 的 `allowBuilds` 下面。

安装前须知

装 mirage 之前，先看这几条

源码在这里： strukto-ai/mirage——已进入社区精选库，DSH 自带的插件市场就是从这儿装的。
开源协议：Apache-2.0。
自动识别到：终端执行。授权之前请先读一遍源码。
被收录在这里不代表通过了安全审计。插件是带着你 agent 的权限在跑。

mirage 是做什么的

Mounted resource blocks flow through permission gates into terminal pipelines and local or remote sandboxes.

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

同一分类