AGFS：致敬 Plan 9 “万物皆文件”理念的 Agent 文件系统

pingcap 联合创始人兼 cto 黄东旭近日推出了一款名为「agfs」的开源项目。

据项目介绍，AGFS（Aggregated File System / Agent File System）旨在通过“文件系统统一抽象”的方式，整合当前多种主流后端服务。该项目灵感源自 Plan 9 的经典理念——“万物皆文件（Everything is a file）”，希望在 AI Agent 与分布式应用迅猛发展的当下，提供一种简洁而统一的服务访问接口。

黄东旭在项目的 README 中写道：

“万物皆文件”，致敬 Plan9，但以 RESTful API 的形式实现。 本项目最初的目标是探索在分布式环境中协调多个 AI Agent 的通用方法，最终发现 bash + 文件系统的组合竟然是最高效的方案之一，例如这个有趣的 task_loop 示例： https://www.php.cn/link/6a5b91ee50446cfaf1a7ba6267496d16

AGFS 利用虚拟文件系统结构，将诸如对象存储（如 S3）、SQL 数据库、KV 存储、消息队列、流数据处理，甚至 agent 的心跳管理等资源，统一抽象为目录和文件。开发者可以使用熟悉的命令如 ls、cat、cp 等进行操作，并灵活组合不同服务。

AGFS 服务端架构如下所示：

┌───────────────────────────────────────────────────────────────────┐│ AGFS Server ││ ┌─────────────────────────────────────────────────────────────┐ ││ │ RESTful API (/api/v1/*) │ ││ └─────────────────────────────────────────────────────────────┘ ││ ↓ ││ ┌─────────────────────────────────────────────────────────────┐ ││ │ MountableFS │ ││ │ (Plugin Mount Management & Routing) │ ││ └─────────────────────────────────────────────────────────────┘ ││ ↓ ││ ┌────────────────────┴────────────────────┐ ││ ↓ ↓ ↓ ││ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ││ │ MemFS │ │ QueueFS │ │ ProxyFS │ ││ │ /memfs │ │ /queuefs │ │ /proxyfs/* ├────┐ ││ └─────────────┘ └─────────────┘ └─────────────┘ │ ││ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ ││ │ KVFS │ │ StreamFS │ │ S3FS │ │ ││ │ /kvfs │ │ /streamfs │ │ /s3fs/* │ │ ││ └─────────────┘ └─────────────┘ └─────────────┘ │ ││ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ ││ │ SQLFS │ │ ServerInfo │ │ LocalFS │ │ ││ │ /sqlfs │ │/serverinfo │ │ /local │ │ ││ └─────────────┘ └─────────────┘ └─────────────┘ │ ││ │ ││ ┌──────────────────────────────────────────────────────┐ │ ││ │ HTTAGFS - HTTP File Server (:9000) │ │ ││ │ /httagfs-* (serves any AGFS path via HTTP) ├─────┼───┼──→ Browser│ └──────────────────────────────────────────────────────┘ │ │ curl└───────────────────────────────────────────────────────────────┼───┘ │ HTTP Federation (ProxyFS) │ ↓ │ ┌─────────────────────┐ │ │ Remote AGFS Server │ ←──────────────┘ └─────────────────────┘

目前，AGFS 提供了多语言版本（包括 C++、Go、Python、Rust 等），支持跨平台运行的 server 组件，以及一个类 shell 的交互式客户端。用户可通过发布包直接下载，或使用 Docker 快速部署。

• agfs-shell：https://www.php.cn/link/96c38b959c1e40beeb302b9ca2edbfc2
• agfs-server：https://www.php.cn/link/8b77bc4975e1eadeceac40c9ff093f38

AGFS 的核心设计理念是打造一个高度可组合的“通用接口层”，适用于多 agent 协同、任务调度及跨系统集成等多种场景。尽管项目尚处于早期阶段，但其在分布式系统与 AI 工作流中的创新潜力已引起广泛关注。

开源地址：https://www.php.cn/link/41cb1109a21920a38bd0cfff6125fcc9

源码地址：点击下载