帮助文档

safrove（安匣） 使用指南

这份文档按照当前 Windows 客户端界面组织，覆盖备份存储、来源目录、授权、状态查看、快照搜索、二进制预览和恢复流程。

快速开始

Backup Settings
在一个窗口里完成仓库、密码、来源目录和备份频率配置，左侧图标辅助识别各配置区域。
1. 设置仓库在 Backup Storage Location 选择或输入备份仓库路径。
2. 添加来源在文件夹列表中添加需要保护的数据目录。
3. 首次备份点击 Save 保存配置，再通过托盘菜单执行 Backup Now。
建议第一次配置后立即执行一次备份，再到 Status... 中确认最近备份状态为 SUCCESS。

授权与激活

当试用到期、授权文件无效或授权与当前机器不匹配时，软件会禁止新建写入任务，例如备份、清理或维护任务。

有效授权SUCCESS

可以执行 Backup Now、计划备份和维护任务。

机器码不匹配Invalid

授权文件不是为当前机器生成，需要重新激活或重新签发。

排查步骤

  • 打开 License... 检查授权状态和到期时间。
  • 确认程序目录中的 license.lic 是当前机器的授权文件。
  • 如果提示机器码不匹配，使用当前机器码重新激活。

Backup Settings

备份配置页面将存储、来源和频率集中在一个窗口中。每个配置区域左侧配有图标，便于快速识别。

Backup Storage（存储配置）

  • Backup Storage Location — 备份仓库路径，负责保存快照、索引和数据块。
  • Encryption Password — 仓库加密密码。忘记后无法读取历史备份，请妥善保管。
  • Create storage automatically if needed — 适合首次配置或更换仓库目录时使用。

Select folders to back up（来源目录）

列表中的每一行是一个来源目录。在表格中直接编辑路径，或使用行内浏览按钮选择目录。

Backup Frequency（备份频率）

从下拉列表选择自动备份间隔。选择 Manual 时仅手动触发备份。

Maintenance（维护操作）

提供 Run Check、Clean Unused Data 和 Unlock Locks 三个快捷维护按钮，可在此页面直接执行仓库检查和清理。

Backup Settings
各配置区域左侧有图标辅助识别，界面布局紧凑高效。
不要把备份仓库目录本身加入来源目录，否则可能造成仓库递归备份、空间快速增长。

Status 页面

Status... 用于查看仓库概览、统计数据和任务日志。页面顶部信息区域配有图标辅助识别仓库路径、状态和最近备份时间。

Status page
上方为仓库概览和统计数据，下方为任务日志列表，可按类型和日期范围筛选。
Repository

显示当前仓库路径，左侧有仓库图标标识。

Status / Last backup

Status 显示当前状态（Idle / Refreshing 等），Last backup 显示最近一次备份结果。

Snapshots / Files / Size

展示仓库统计数据：快照数、文件数、原始大小、存储大小和去重节省比例。

任务日志

按时间倒序列出每次任务，包括类型、状态、耗时和错误详情，支持筛选和导出。

SUCCESS

任务已完成，Detail 通常显示 Backup completed 或具体完成信息。

QUEUED / RUNNING

任务已进入队列或正在执行中。

FAILED

任务失败，优先查看 Detail 列中的路径、权限或授权错误信息。

Refresh

状态和日志会自动刷新；也可通过托盘菜单重新打开页面获取最新数据。

Browse Backups

该页面用于查找历史文件、浏览快照、预览内容和准备恢复。打开时显示加载进度窗口，分阶段展示快照扫描、文件索引和搜索缓存构建，三个阶段的图标根据状态变换颜色。

Search Files（搜索文件）

  • 在搜索框输入文件名或路径片段，稍等片刻即可看到跨快照的匹配结果。
  • 可通过类型、时间和状态下拉框进一步筛选结果。
  • 结果较多时会限制显示数量，建议输入更具体的文件特征。
  • 左侧为搜索结果列表，右侧为文件历史记录，点击可查看不同版本的修改时间。
Global Search
输入文件名或路径片段跨快照查找历史文件，支持多维度筛选。

Snapshots（快照浏览）

Snapshot preview
选择快照后在左侧浏览文件树，右侧预览文本或二进制内容。

快照列表支持按信息筛选。选择快照后，左侧展示文件树，右侧展示文件预览。文本文件直接显示内容，二进制文件使用十六进制视图。

Timeline（时间线）

Timeline 页以可视化方式展示指定文件的修改历史，帮助判断文件在哪个备份点发生了变化，从而选择正确的版本进行恢复。

Restore Advisor（恢复建议）

Restore Advisor 帮助分析最近变化的文件，按时间范围和变化范围筛选，快速定位需要关注或恢复的文件列表。

预览二进制文件

二进制内容使用十六进制视图展示，包含偏移量、十六进制字节和 ASCII 区域，便于识别文件头或确认内容类型。

Compare Snapshots（快照对比）

选择两个快照进行差异分析，查看文件的新增、删除和修改情况。

Compare Snapshots
左上方选择两个快照，下方展示差异文件列表，可按变更类型筛选。
选择快照

分别从 A 和 B 下拉列表中选择要对比的两个快照，点击 Compare 执行对比。

差异类型

使用筛选下拉框按 Added / Removed / Modified 过滤差异结果。

快照信息

右上方显示两个快照的基本信息（时间、主机、路径等），辅助确认对比范围。

路径筛选

支持按路径关键词进一步过滤差异列表中的结果。

恢复数据

  1. 打开 Browse Backups...。
  2. 通过 Search Files、Snapshots 或 Restore Advisor 找到目标文件或快照。
  3. 使用预览或 Compare Snapshots 确认文件版本和变更内容。
  4. 确认无误后，选中目标并点击 Restore...，选择恢复模式（原路径 / 自定义路径 / 临时目录）执行恢复。

也可通过 Mount As Drive 将快照挂载为只读驱动器，在文件管理器中直接浏览和复制需要的文件。

Mount recovery
挂载后可以用文件管理器检查快照内容，再复制需要恢复的文件。
恢复到原路径前，建议先选择 Custom Path 恢复到临时目录，确认内容正确后再手动替换。

常见问题

提示文件正在被占用怎么办？

如果错误中包含 .safrove_write_in_progress，说明上一次备份或另一个进程仍持有写入标记。确认没有备份任务运行后，再重试；必要时关闭软件后重新打开。

Backup Now 显示授权不足怎么办？

先打开 License... 查看状态。如果提示机器码不匹配，需要使用当前机器码重新激活。

搜索还是慢怎么办？

尽量输入更具体的路径片段或文件名，避免只输入一个通用字符。大型仓库首次索引会更慢，后续筛选会更快。

忘记 Encryption Password 可以恢复吗？

不能。该密码用于加密仓库数据，软件无法绕过密码读取历史备份。