摘要
一句话总结 AgentFS 是一个专为 AI Agents 设计的虚拟文件系统，通过将底层 SQLite 数据库映射为可挂载的文件系统，实现 agent 状态的统一管理、行为审计与便捷迁移。
核心要点
- 基础信息：项目采用 MIT 协议开源，主要使用 Rust 开发，目前由
tursodatabase维护。 - 核心机制：支持通过 Linux FUSE 或 macOS NFS，将底层 SQLite 数据库挂载为标准虚拟文件系统供 agent 使用。
- 多语言 SDK：提供 TypeScript、Python、Rust 版本 SDK，对外暴露
fs、kv、tools三类接口。 - CLI 管理工具：支持初始化、文件查看、时间线追踪（
timeline）、挂载以及实验性沙盒运行。 - 高可审计性：文件操作、工具调用、状态变更均写入 SQLite，可直接 SQL 查询与回溯。
- 便携与可复现：agent 的文件、状态、历史记录打包到单一 SQLite 文件，便于快照、恢复与跨环境迁移。
- 底层规范：提供基于 SQLite 的 AgentFS 规范（SPEC）。
风险与不足
- 项目当前处于 BETA 阶段。
- 官方建议生产环境谨慎使用并确保数据备份。
功能与定位
AgentFS 定位为“agent 运行时文件系统层”。它不是单纯的文件 API 封装，而是把 agent 的运行时状态（文件、键值上下文、工具调用历史）统一到可挂载、可查询、可快照的 SQLite 文件系统抽象中。
典型使用场景
- 给 coding agent 或自动化 agent 提供可隔离、可追溯的运行时工作区。
- 将 agent 执行历史（工具调用与状态变化）用于审计、调试和合规留痕。
- 对 agent 任务过程进行快照与回滚，复现实验或排查问题。
- 在不同机器间迁移 agent 状态，不依赖重型容器镜像。
核心功能
- 挂载能力：支持 Linux FUSE 与 macOS NFS 挂载。
- 三类存储接口：
fs（文件系统）、kv（键值状态）、tools（工具调用轨迹）。 - CLI 工具链：
init、fs ls、fs cat、timeline、mount、run。 - 规范文档：提供
SPEC.md说明底层 SQLite 结构与语义。 - 多语言接入：TypeScript、Python、Rust SDK。
特色与差异点
- 社区正在出现的“数据库即虚拟文件系统供 agent 使用”路线在该项目中有完整实现：SQLite 持久化 + 可挂载虚拟文件系统 + SDK/CLI 一体化。
- 与仅做目录隔离的方案相比，AgentFS 强调“可查询、可审计、可时间快照”。
- 与 Docker sandbox 类工具不是替代关系，README 明确其定位可互补。
使用方式概览
- 安装 AgentFS CLI，初始化 agent 文件系统实例。
- 通过
mount把数据库映射到宿主机路径，让 agent 按常规文件方式读写。 - 在 agent 代码里接入 SDK，统一使用
fs、kv、tools接口。 - 用
timeline或 SQL 查询做行为回溯与问题定位。
限制与注意事项
- BETA 阶段意味着接口与行为仍可能变化。
- 用于生产前应建立备份策略，并验证挂载与权限边界。
- 需根据操作系统选择对应挂载机制（Linux FUSE / macOS NFS）。
链接
- 仓库：https://github.com/tursodatabase/agentfs
- 官网：https://www.agentfs.ai
- User Manual：https://github.com/tursodatabase/agentfs/blob/main/MANUAL.md
- SPEC：https://github.com/tursodatabase/agentfs/blob/main/SPEC.md
- 发布页：https://github.com/tursodatabase/agentfs/releases