Show HN:为AI智能体打造的持久化文件系统层
SmolFS 是一个专为AI智能体设计的持久化工作区文件系统。它允许智能体在进程停止后保留文件,支持本地开发模式(SQLite)和云卷模式(Redis + S3),并提供CLI和Python/TypeScript SDK,使得跨运行时共享工作区变得简单。
SmolFS 是一款专为AI智能体设计的持久化文件系统层,旨在解决智能体在短暂运行时环境中文件持久化的难题。传统上,AI智能体每次运行时都会创建一个全新的环境,导致之前的工作成果丢失。SmolFS 通过提供可挂载的工作区目录,使得智能体在进程停止后依然能够保留和访问文件,从而实现跨运行时的持久化。
SmolFS 的核心优势在于其简单的生命周期管理。用户可以通过一条命令检查机器状态(doctor)、初始化卷(init)、挂载目录(mount)、刷新数据(flush)以及卸载卷(unmount)。它支持两种模式:本地开发模式(使用 SQLite 存储元数据,本地文件存储对象数据)和云卷模式(使用 Redis 存储元数据,S3 兼容对象存储存储文件内容)。云模式特别适合需要跨机器持久化工作区的场景,例如在分布式环境中共享智能体的工作成果。
为了简化集成,SmolFS 提供了 Python 和 TypeScript 的 SDK,这些 SDK 底层调用相同的 Rust 核心,使得智能体工具可以直接集成而无需调用 CLI。例如,Python SDK 提供了 SmolFS.from_env() 和 ensure_volume() 等接口,方便智能体快速创建和管理持久化工作区。TypeScript SDK 则作为原生 Node.js 绑定,支持 Linux 和 macOS 的 x86_64 及 arm64 架构。
安全性方面,SmolFS 强调显式配置和避免日志记录敏感信息。它要求云存储的凭据通过环境变量提供,而不是硬编码在命令中。同时,它鼓励幂等的挂载/卸载操作,并在配置缺失时明确报错。此外,SmolFS 将智能体工作区数据存储在沙箱生命周期之外,应被视为持久化基础设施,需要相应的安全考量。
总的来说,SmolFS 为AI智能体的文件持久化提供了一种简洁、可靠的解决方案,尤其适合需要跨运行时代理工作区的场景。无论是本地开发测试还是生产环境中的分布式部署,SmolFS 都能确保智能体工作成果的安全保存和高效访问。