Mirage 

在构建 AI 代理（Agent）时，开发者常面临一个巨大挑战：如何让模型高效地操作分散在不同平台的数据？每个服务（如 S3、Google Drive、Slack、GitHub）都有独立的 SDK、API 和认证逻辑，导致 Agent 需要学习大量特定词汇，且容易因上下文窗口限制而迷失。

Mirage 是一个为 AI Agent 设计的统一虚拟文件系统，通过 FUSE（用户空间文件系统）技术，将数十种云服务、数据库和协作工具“挂载”到同一个目录树下。对于 Agent 而言，世界不再由无数个 API 组成，而是一个简单的、标准的 Unix 文件系统。

核心亮点：万物皆文件，Bash 即万能钥匙

1. 一个文件系统，所有后端

Mirage 将异构数据源抽象为统一的文件语义：

• 云存储：S3, R2, GCS, Supabase 等变为目录。
• 协作工具：Slack 频道、Gmail 邮件、Notion 页面、GitHub 仓库变为文件或文件夹。
• 数据库：Redis, MongoDB 键值对变为可读写文件。
• 本地资源：RAM, 磁盘, SSH 远程主机无缝集成。

示例：
ls /slack/general/ 列出频道消息；
cat /gmail/inbox/latest.eml 阅读最新邮件；
cp /local/report.pdf /s3/backups/ 上传文件。

2. 复用 LLM 最熟悉的 Bash 词汇

• 零学习成本：LLM 在训练过程中接触过海量的 Linux 命令和 Shell 脚本。Mirage 让 Agent 直接使用 ls, cat, grep, cp, mv, pipe (|) 等标准工具操作所有服务。
• 自然组合：管道操作跨服务变得极其直观。例如：grep "error" /logs/app.log | slack send /channel/dev-alerts。

3. 便携式工作区与版本控制

• 快照与克隆：整个虚拟文件系统状态可以快照、版本化和克隆。
• 无缝迁移：Agent 的运行环境可以在不同机器间移动，无需重新配置 SDK 或认证，保持状态一致。

4. 深度集成主流框架

• SDK 支持：提供 Python (mirage-ai) 和 TypeScript (@struktoai/mirage-node/browser) SDK，可嵌入 FastAPI、Express 或浏览器应用中。
• Agent 兼容：完美适配 OpenAI Agents SDK, LangChain, Pydantic AI, OpenHands, 以及 Claude Code 和 Codex 等编码代理。

快速开始

1. 安装 CLI

通过 curl 安装（推荐）：

curl -fsSL https://strukto.ai/mirage/install.sh | sh

或通过包管理器：

# Python (uv)
uvx mirage-ai

# Node.js
npx @struktoai/mirage-cli
npm install -g @struktoai/mirage-cli

2. 配置与挂载

启动 Mirage 守护进程，并配置你的服务凭证（如 AWS Key, Slack Token 等）。Mirage 会自动将这些服务挂载到虚拟根目录下。

mirage mount s3 --bucket my-bucket --path /cloud/s3
mirage mount slack --token xoxb-... --path /chat/slack

3. 让 Agent 操作

在 Claude Code 或其他支持 Bash 的 Agent 中，直接执行命令：

# 查看 Slack 最新消息
cat /chat/slack/general/latest.txt

# 备份本地文件到 S3
cp ./project.zip /cloud/s3/backups/project-$(date +%F).zip

# 搜索 Gmail 中的发票并保存到本地
grep -r "invoice" /mail/gmail/inbox/ > ./invoices.txt

为什么选择 Mirage？

系统要求

• Python: ≥ 3.12
• Node.js: ≥ 20
• 操作系统: macOS 或 Linux（基于 FUSE 支持）