# 版本控制

pvfine 的版本控制面向 PVF 内部的逻辑文件，不把完整 `.pvf` 文件作为版本对象。

## 存储

打开并初始化版本控制后，会在源文件旁创建：

```text
Script.pvf.pvfine/
├── repo.db
├── base.pvf
└── objects/
```

`base.pvf` 是唯一的不可变基线；`objects` 使用 SHA-256 内容寻址。脚本和 Unicode 文件保存逻辑文本对象，因为脚本 token 依赖 PVF 字符串池；其他类型保存原始 payload。

初始化需要扫描整个 PVF，可能持续数分钟，并会额外复制一份基线文件和建立对象索引，因此会占用较多磁盘空间。面板中的“取消版本控制”只删除对应的 `.pvfine` 侧车目录，不删除源 PVF 或当前内存编辑。

重新打开已启用版本控制的 PVF 时，普通归档会先完成打开；版本库发现、产物校验、快照恢复和基线加载在后台执行。恢复期间可以浏览和读取文件，版本操作及会改变归档的编辑/保存操作会暂时不可用。若最近的提交尚未保存到 PVF，后台恢复完成后会再发起一次内存归档重载。

当前版本库使用 SQLite 保存提交、父提交、变更路径和对象引用。V1 只提供 `main` 分支，不提供合并和远程同步。

## 操作语义

```text
编辑/批处理  → Working Tree
Ctrl+Enter   → 提交版本，不写 PVF
Ctrl+S       → 保存 PVF 产物，不创建版本
版本面板     → 查看变更、历史、撤销或加载历史版本
```

工作区和提交中的可用文件路径可以直接打开当前归档中的对应文件。历史版本支持导出该版本涉及的文件；新增/修改文件导出提交后的内容，删除文件导出删除前的内容，并保留归档内的相对目录结构。

批处理、创建文件、删除文件和一次编辑操作都会进入工作区变更历史。撤销按一次变更集执行。

Checkout 通过“基线 + 提交变更”重建内存中的归档，不会立即覆盖磁盘上的 PVF。保存后才会生成新的 PVF 产物。

## 兼容限制

V1 使用规范化路径作为文件身份，因此含有重复规范化路径的归档不会启用版本控制。源 PVF 被外部修改后，版本库会拒绝继续关联，避免覆盖未知内容。