跳转到内容

规范

英文规范定义 Graft 的可观察契约。实现兼容适配器、审查行为变更或判断规则归属时, 应以英文规范为准。普通产品接入请使用任务指南。

契约规范
仓库路径、对象、引用、index 与 commitGraft Repository 1.0
SQLite 存储快照与恢复语义Graft Storage Snapshots 1.0
工作区捕获与 materializationGraft Worktree Materialization 1.0
路径与 SQLite 逻辑差异Graft Diff 1.0
三方合并与冲突Graft Merge 1.0
Runtime 与宿主适配器边界Graft Runtime Adapters 1.0
远端发布与同步Graft Remote Sync 1.0
可移植固定页 SQLite deltaGraft SQLite Page Delta 1.0

先阅读规范索引, 了解职责归属、conformance 标记和规范层次。

仓库标识、快照内容、差异与合并结果、适配器安全边界和远端发布顺序属于可观察 契约。缓存文件名、Rust 模块边界、临时路径和存储引擎 key encoding 属于实现细节, 除非规范另有说明。

行为发生变化时,应同时更新所属规范与可执行 conformance evidence。