Mirage

Mirage， 全称 “A Unified Virtual File System for AI Agents”，是由 strukto-ai 团队开发的面向 AI Agent 的统一虚拟文件系统，于 2026 年 5 月 6 日发布首个公开版本 v0.0.1-alpha.1，采用 Apache 2.0 开源协议。它的核心理念是将所有数据源——包括 S3 存储桶、Google Drive、Gmail、Slack、GitHub、Notion、MongoDB、Redis、SSH 服务器等——全部挂载到同一个虚拟文件树下，让 AI Agent 用熟悉的 Bash 命令统一操作。对 AI 来说，读取 Slack 消息和读取本地文件没有区别，不需要学习任何新的 API 或 SDK，只需做它最擅长的事：写 Bash。cat、grep、head、wc、find、ls、cp、mv 等 Unix 命令在每一个挂载点上都能通用，还支持快照、克隆和回滚，Agent 整个执行环境可打包成 tar 文件迁移到另一台机器直接恢复。

功能特点

Mirage 首批支持的数据源非常全面，涵盖对象存储（S3）、协作文档（Google Drive、Notion）、通信工具（Gmail、Slack）、代码托管（GitHub）、数据库（MongoDB、Redis）、远程服务器（SSH）以及本地内存。每个 Workspace 内置两层缓存：索引缓存避免重复 API 调用，文件缓存实现零网络开销的本地读取。支持快照与克隆，Agent 执行环境可移植。

提供 Python SDK 和 TypeScript SDK，可在 Node.js 服务端、浏览器 Edge Runtime 以及纯运行时环境中使用。CLI 提供一键安装脚本、npm 全局安装、uvx 直接运行、npx 运行四种安装方式。整体设计为嵌入式集成，不要求替换现有 Agent 框架，可无缝嵌入已有系统。

优缺点

优点方面：彻底消除 AI Agent 面对碎片化数据源时的工具学习成本，Bash 是大模型训练数据中最丰富的技能之一，Mirage 让这一优势直接复用；统一文件抽象极大简化了 Agent 的工具调用逻辑，跨服务数据管道（如 grep alert 日志文件后 wc 计数）变得极其自然；两层缓存和快照机制兼顾了性能与可移植性；Apache 2.0 协议完全免费开源，商业友好。

缺点方面：项目仍处于 alpha 阶段（v0.0.1-alpha.1），稳定性和生产级可靠性有待验证；数据源覆盖虽广但仍在快速增长中，冷门企业内部系统可能需要自行开发 Resource 适配器；FUSE 挂载依赖 macOS/Linux 平台，Windows 支持有限；对大模型的 Bash 推理能力有依赖——如果模型在复杂管道或边缘场景下出错，文件系统层面无法自动纠错。

主要应用场景

• 跨数据源数据分析与报表生成：Agent 用一条 grep | wc 管道完成原本需要多个 API 调用才能实现的统计。
• 多平台消息监控与告警：Slack、Gmail、GitHub Issue 统一挂载后，Agent 可像 grep 日志一样检索所有通知。
• AI 辅助运维：SSH 服务器、MongoDB、Redis 挂载为文件系统，运维 Agent 用 ls、cat、find 排查问题。
• 文档知识检索：Notion、Google Drive 变成目录树，Agent 用 grep 做精确字符串搜索，弥补向量检索在精确匹配场景的不足。
• 开发工作流自动化：GitHub 仓库与本地文件系统打通，Agent 用 cp、mv 跨服务复制代码，用 git 命令管理版本。

如何使用

环境要求 Python ≥ 3.12 和 Node.js ≥ 20，macOS 或 Linux。安装方式可选 curl 一键脚本、npm 全局安装、uvx 或 npx。Python 最小示例：from mirage import Workspace，导入所需 Resource（如 S3Resource、SlackResource、GDocsResource、RAMResource），构建 Workspace 挂载路径，然后用 await ws.execute(“cp /s3/report.csv /data/report.csv”) 执行命令，用 await ws.snapshot(“demo.tar”) 创建快照。

TypeScript 用法类似，从 @struktoai/mirage-browser 导入 Workspace 和各 Resource，new Workspace({ ‘/data’: new RAMResource(), ‘/s3’: new S3Resource({ bucket: ‘my-bucket’ }) })，同样用 await ws.execute() 运行 Bash 命令。

收费标准

Mirage 采用 Apache 2.0 开源协议，软件本身完全免费，无任何授权费用。使用成本主要来自底层数据源的 API 调用（如 S3 请求费、Slack API 调用、Google Drive 配额等）以及大模型推理的 Token 费用，这些与 Mirage 无关，取决于你自己的云服务和模型选择。社区版和未来可能的企业版均以开源为基础，不存在软件订阅或按座收费的模式。