跳到主要内容

备份文件规范

本文用于说明 FolderRewind 在备份文件命名、存储结构上的规范，以及这些规范与 “重建历史记录” 功能的关系。

命名格式规范​

源码中备份文件名由 GenerateFileName(...) 统一生成，格式为：

[Full/Smart/Overwrite][时间戳]文件夹名称 [注释].扩展名

示例：

  • [Full][2026-03-01_09-30-15]WorldA.7z
  • [Smart][2026-03-01_10-00-10]WorldA [Auto].7z
  • [Overwrite][2026-03-01_11-22-08]WorldA [Manual].zip

字段说明​

  • 备份类型前缀：[Full]、[Smart]、[Overwrite]
  • 时间戳：yyyy-MM-dd_HH-mm-ss
  • 文件夹名称：当前被备份文件夹的显示名
  • 注释：可选，存在时前置一个空格，格式为 [注释]
  • 扩展名：由压缩格式决定，常见为 7z 或 zip

命名注意事项​

  • 注释会经过文件名清洗，非法字符会被移除。
  • 为避免影响解析，注释中的 [ 与 ] 会被移除。
  • 如果你希望未来可稳定重建历史，建议不要手动改名已生成的备份文件。

源码解析正则​

HistoryService 使用以下正则表达式解析备份文件名：

^\[(Full|Smart|Overwrite)\]\[(\d{4}-\d{2}-\d{2}_\d{2}-\d{2}-\d{2})\](.+?)(?:\s\[(.+?)\])?\.(7z|zip)$

这意味着：

  • 类型前缀必须是 [Full]、[Smart] 或 [Overwrite] 之一
  • 时间戳格式严格为 yyyy-MM-dd_HH-mm-ss
  • 注释部分是可选的，如果有则用方括号包裹
  • 扩展名必须是 7z 或 zip

备份文件存储结构​

单个配置（Config）的目标路径为 DestinationPath，其下按“被管理文件夹名”分目录存储。

DestinationPath/
├─ <FolderDisplayName>/
│  ├─ [Full][...].7z
│  ├─ [Smart][...].7z
│  └─ [Overwrite][...].zip
└─ _metadata/
   └─ <FolderDisplayName>/
      └─ metadata.json

备份目录结构示例

说明：

  • DestinationPath/<FolderDisplayName>/：实际备份压缩包目录。
  • DestinationPath/_metadata/<FolderDisplayName>/metadata.json：智能增量链元数据。

metadata.json 版本说明​

当前版本为 v3.0（BackupMetadataState），包含：

  • FileStates：字典结构，记录每个文件的 Size、LastWriteTimeUtc、Hash
  • BackupRecords：备份记录列表，包含每次备份的增删改文件清单

智能增量备份依赖此文件判断哪些文件发生了变更。

默认目标路径规则​

如果你没有手动设置目标路径，默认推荐根目录为：

文档/FolderRewind-Backup

单个配置默认目标目录通常为：

文档/FolderRewind-Backup/<配置名称>

与“重建历史记录”的关系​

“重建历史记录”会依赖现有备份文件进行重建。为了得到更准确的重建结果，建议：

  1. 保持上述命名格式（尤其是类型前缀与时间戳）。
  2. 保持按 DestinationPath/<FolderDisplayName>/ 的目录组织。
  3. 不要随意删除或改名增量链中的关键文件（特别是 Full 基线）。

重要标记与自动清理​

  • 历史条目可被标记为“重要（Important）”。
  • 自动清理旧备份时，会跳过被标记为重要的文件。

这意味着：为长期保留的关键版本打星标，可以避免其被保留策略自动删除。

自动清理与安全删除​

当 保留最近备份数（KeepCount）设置大于 0 时，系统会在每次备份后自动清理超出数量的旧备份。

清理行为与 安全删除（SafeDeleteEnabled）的交互：

  • 安全删除关闭：直接删除旧备份文件和对应的历史记录
  • 安全删除开启：如果要删除的备份位于智能增量链中，系统会先将其内容合并到后继备份，再执行删除，避免链断裂导致后续备份不可还原

建议：对使用智能增量模式的配置，保持安全删除开启。

远程命令（KnotLink）补充​

v1.4.2 新增 MARK_IMPORTANT 远程命令，用于标记/取消标记重要备份：

MARK_IMPORTANT <config_id> <folder_index|folder_name> <backup_file> [true|false]

  • 省略最后参数时，默认标记为 true。
  • backup_file 建议传入完整备份文件名（包含前缀与扩展名）。

相关链接​