Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

LayerFS

临时工作区,持久共享历史。

LayerFS 为每个 Agent 提供隔离、可随时丢弃的文件系统分支,而无需复制共享基础。值得保留的状态会成为持久、去重的检查点,并携带工作区级工具调用历史,可随时派生、回溯或复用于并行开发、环境实验与 MCTS 式 rollout。

01 · LayerStack 存储模型

核心存储机制

CAS、CDC 和 COW 通过复用未变化的对象、文件区域与文件系统结构,让 LayerStack 历史保持存储高效。

01 · 身份

内容寻址存储

根据规范字节为不可变对象命名,校验读取,并在文件、LayerStack 和 Agent 之间复用完全相同的内容。

02 · 字节局部性

内容定义分块

让局部修改附近的分块边界保持稳定,避免因一小处变化而重新存储整个大文件。

03 · 结构局部性

写时复制

将变更发布到新层时,只重建发生变化的文件及目录路径,父层中未变化的子树继续共享。

从任意层检出 Agent 临时文件系统

LayerStack 记录完整的文件系统检查点。Agent A 可以从 L1 开始,Agent B 则可独立从 L3 开始。每个 Agent 都拥有私有工作空间,而所选择的历史仍然共享。

一个包含 L0 到 L4 的 LayerStack。Agent A 从 L1 检出临时文件系统,Agent B 从 L3 检出另一个独立的临时文件系统。
一个 LayerStack、两个检出点,以及两个可供 Agent 独立工作的临时文件系统。

02 · 系统边界

LayerFS 组件

存储引擎已经实现;SDK 和文件系统投影是围绕它规划的接口。

已实现核心

存储引擎

负责身份、规范对象、CDC、文件清单、结构级 COW、pack、不可变 CAS 准入、生命周期协调和校验读取。

规划中的接口

SDK

将提供稳定的文件系统、工作区、LayerStack 与发布操作,而不泄露私有 CAS 句柄或存储格式。

规划中的接口

文件系统投影

向 Agent 提供工作区,并捕获范围受限的文件系统变更;身份、CDC、COW 和准入仍由存储引擎负责。

03 · 阅读路线

从第一性原理开始构建

本书沿着存储模型的依赖顺序展开:先建立不可变内容身份,再把文件修改限制在局部范围,只重建发生变化的文件系统路径,最后把这些状态组织成 Agent 历史。

第 1 章 · 编写中 基础:CAS + CDC + COW 完全相同对象复用 → 文件区域复用 → 文件系统结构复用
第 2 章 · 规划中 优化存储核心 类型化对象、验证准入、身份、pack 与高效读取
第 3 章 · 规划中 LayerStack 与 Agent 工作区 历史、私有 head、检查点、派生、回滚与发布

04 · 生态

协作项目

LayerFS 提供存储机制;周边项目负责执行环境与版本控制工作流。

Ephemeral AI Lab 提供支持