Repolode
Ephemeral-AI-Lab

Ephemeral-AI-Lab/layerfs

基于 SQLite 的内容寻址文件系统存储,为 AI 智能体提供可丢弃的工作区和可去重、可持久化的历史检查点。

Star
620
Fork
34
未关闭 Issue
37
最近提交
3小时前

这是什么?

LayerFS 是一个用 Rust 编写的文件系统状态管理项目,面向 AI 智能体。每次会修改文件系统的工具调用都会在独立的临时工作区中执行,保留下来的结果会成为 LayerStack 时间线上的不可变 Commit。内容寻址存储、内容定义分块和写时复制让多个状态共享同一基础数据,只存储各自的差异,因此新状态的存储开销约等于实际改动量。

调用方可以从任意 Layer 或 Commit 零拷贝地派生 Branch,并行运行多个工作区,丢弃失败的尝试,或通过分叉较早的状态进行回滚,还能用 Add 将胜出的 Branch 合并回去。项目提供 Rust SDK、CLI、宿主机物化以及基于 Linux FUSE 的容器工作区。当前 v0.1.6 为开发者预览版,适合本地评估和智能体运行时集成,尚不提供崩溃或断电持久性保证,不建议用于生产存储。

核心功能

  • 01内容寻址存储,相同数据在文件和状态之间复用。
  • 02内容定义分块,使局部修改无需重写整个大文件。
  • 03从任意 Layer 或 Commit 零拷贝派生 Branch,并以写时复制方式生成 Commit。
  • 04通过 Rust SDK 和 CLI 执行工作区命令并提交结果。
  • 05支持基于 Linux FUSE 的容器工作区,也可使用宿主机物化方式。

适用场景

  • 在同一代码库上并行运行大量智能体尝试,而无需复制完整环境。
  • 智能体失败后,将文件系统回滚到较早的检查点。
  • 在隔离的 Branch 中测试环境或依赖变更,确认后再合并。

标签

常见问题

layerfs 是什么?
基于 SQLite 的内容寻址文件系统存储,为 AI 智能体提供可丢弃的工作区和可去重、可持久化的历史检查点。 LayerFS 是一个用 Rust 编写的文件系统状态管理项目,面向 AI 智能体。每次会修改文件系统的工具调用都会在独立的临时工作区中执行,保留下来的结果会成为 LayerStack 时间线上的不可变 Commit。内容寻址存储、内容定义分块和写时复制让多个状态共享同一基础数据,只存储各自的差异,因此新状态的存储开销约等于实际改动量。
layerfs 可以免费使用吗?用的什么许可证?
layerfs 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
layerfs 还在维护吗?
活跃维护中。layerfs 最近一次提交是在 2026年10月18日。
layerfs 适合用来做什么?
在同一代码库上并行运行大量智能体尝试,而无需复制完整环境。 智能体失败后,将文件系统回滚到较早的检查点。 在隔离的 Branch 中测试环境或依赖变更,确认后再合并。
在哪里获取 layerfs?
源代码和安装说明在 GitHub 上:https://github.com/Ephemeral-AI-Lab/layerfs

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目