术语表
App State
Section titled “App State”应用需要一致打开的持久状态:SQLite 数据库、设置、附件、生成资产、导入文件等。
Artifact
Section titled “Artifact”Graft tree 中跟踪的非 SQLite 文件 entry。文本可以 inline,二进制和配置资源 路径使用 external payload。
Commit
Section titled “Commit”指向 tree 的不可变 repository object,记录一个 app-state version。
External Payload
Section titled “External Payload”按 content hash 存储在普通 commit/tree object 外部的文件字节。
Graft VFS
Section titled “Graft VFS”Graft SQLite extension 注册的可选 virtual file system。它让 SQLite 直接读写 Graft page storage,属于数据面;repository status、add、commit、branch 和 sync 仍由 CLI control plane 负责。默认 worktree 模式使用普通物理 SQLite 文件。
worktree 和下一个 commit 之间的 staging area。冲突时也保存 base/ours/theirs stages。
tracked path 的内容类型:sqlite_database、text_file、binary_file。
Materialization
Section titled “Materialization”把 tracked SQLite snapshot 写回 worktree 中的普通 SQLite database file。
Remote
Section titled “Remote”repository objects、refs、SQLite storage 和 external payloads 的命名存储后端。
Repository
Section titled “Repository”worktree 加 .graft/ metadata。保存 refs、objects、index、local SQLite
storage、config 和 payload cache。
Snapshot
Section titled “Snapshot”可被 repository object 引用的不可变 SQLite database state。
Storage
Section titled “Storage”path 的存储策略:sqlite_snapshot、inline、external。
Worktree
Section titled “Worktree”应用数据目录,包含 materialized SQLite files 和 Graft 跟踪的应用文件。