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 都能確保智慧體工作成果的安全儲存和高效訪問。