Mirage 是一个面向 AI Agent 的虚拟终端，目标是把文件系统、命令行工具和运行时统一起来，为 Agent 提供一致、可沙箱化、跨本地与云端的操作环境。
【用途与定位】 Mirage 将多种数据来源以虚拟文件系统的方式挂载到同一根目录下，让 Agent 通过统一的 POSIX 语义访问不同服务。它同时虚拟化命令行工具和运行时，使 Agent 无需在机器上实际安装相关程序即可驱动服务，并将文件系统、CLI 与运行时绑定为一条虚拟终端命令行。
【主要能力】
- 统一虚拟文件系统：S3、Google Drive、Slack、Gmail、Redis 等服务并排挂载在单一根目录下，后端遵循相同的文件系统语义，Agent 可用 ls、grep、find、jq 等 Unix 工具操作。Agent 可通过 Python 与 TypeScript SDK、mirage CLI，或经 FUSE 与 FSKit 的真实挂载点访问。
- 虚拟命令行工具：git、slack、ntn 等由 Mirage 自身响应，Agent 无需安装对应程序即可驱动服务，且可跨运行时与机器。同一个工具能以不同名称虚拟化为多个实例，各自使用独立的凭据。
- 动态路由运行时：Python、JavaScript 及其他任意命令可被发送到配置好的运行时（进程内、沙箱或远程）。计算与存储解耦，二者可独立变更。可用脚本化运行时路由器决定某一行由哪个运行时处理。
- 虚拟 Shell：将文件系统、CLI 与运行时绑定为一条命令行，管道、重定向、变量、任务与历史记录在三者间均可工作。
- 面向 Agent 的配置档案（Profile）：allow、ask、deny 控制命令与 CLI，hide 与 show 控制文件与文件夹；被隐藏的路径不仅不可读，而且从 Agent 看到的文件系统中完全消失。
- 可脚本化策略引擎：策略脚本可在危险操作执行前禁止它；同一策略栈对每次 VFS 操作和会话写入进行把关，防止文件或环境变量泄露。策略只能限制、不能授予权限。
- 通知机制：外部变更会成为挂载点上的事件流，例如新的 Slack 回复会作为虚拟文件系统中聊天文件的变更浮现，Agent 可据此作出反应，而无需重新扫描目录树。
【使用方式】 官方 README 给出在应用中启动 Mirage 的示例，但未提供完整代码内容，具体启动步骤暂未提供。已知的安装与环境要求为：mirage-ai 包与 mirage CLI 需要 Python ≥ 3.11；TypeScript SDK 需要 Node.js ≥ 20。两个运行时包都会自动引入 @struktoai/mirage-core。凭据与认证可与 AWS Secrets Manager、1Password、Auth0、dotenv 等已有的密钥存储集成，使 Mirage 中的环境变量可直接解析到其中保存的凭据。
【适用场景】 需要让 Agent 跨多个数据源统一访问数据、以脚本化策略控制 Agent 可执行操作与可见范围、并将命令执行路由到不同运行时的场景。
【限制与未提供信息】 项目采用 Apache-2.0 许可。资料未提供具体价格、收费模式、性能数据、限制条目或支持平台列表，这些信息暂未提供。
