CrossWatch Captures 回滚教程：改坏了 Trakt 收藏？一键回到上周-平芜编程栈

【免费下载链接】CrossWatch

Synchronize your data across media servers, media agents and trackers. Keep your movies and shows in sync, no matter where you watch.

项目地址：https://gitcode.com/gh_mirrors/cr/CrossWatch

点击查看免费下载

CrossWatch 是一个在媒体服务器、媒体代理与追踪站点（Trakt、SIMKL 等）之间同步电影、剧集数据的开源工具，其中的Captures功能可以为你收藏、评分、观看历史、进度和合集拍下一份完整"快照"。一旦同步改坏了 Trakt 收藏或误删了数据，你可以一键回滚到任意一份快照，让数据快速恢复原样。

为什么你需要 CrossWatch 数据回滚

日常使用同步工具时，这些场景几乎每个用户都会遇到：

🗑️误删除：在 Trakt 收藏里手滑删掉了一整批影片
🔄同步出错：双向同步把不该删除的条目清掉了
🧪试错改动：批量改评分、整理合集，结果改乱了
⚠️数据漂移：多次同步后，收藏列表和服务器里的对不上了

CrossWatch 的 Captures（快照/回滚）功能正是为此而生：它在本地保存某个 Provider 某项功能的完整数据副本，支持对比差异（Compare/Diff）与一键恢复（Restore），回滚 watchlist、ratings、history、progress、collections 五类数据。相关实现见 services/snapshots.py 与 api/snapshotsAPI.py。

第一步：为 Trakt 收藏创建一份 Captures 快照

最佳习惯：在动手批量修改或运行大同步之前，先留一份快照。

在 Web 界面中，点击顶部导航栏的Captures标签（源码：assets/js/snapshots.js），打开Create capture面板：

选择 Provider：TRAKT
选择要备份的功能（feature）：
- watchlist（收藏）
- ratings（评分）
- history（观看历史）
- progress（进度）
- collection（合集）
- 也可以一次备份全部功能，生成一个 capture bundle
点击创建，界面会显示实时进度，完成后快照即出现在列表中

快照按日期归档保存在本地snapshots目录中，文件名带有时间戳，例如TRAKT_watchlist_2026-10-22_...，方便你一眼认出"上周的备份"。

第二步：改坏了 Trakt 收藏？一键回滚

发现收藏被改坏后，回到 Captures 页面，勾选出问题之前的那份快照，右侧会出现Restore capture恢复面板，提供两种恢复模式：

恢复模式	行为	适用场景
Merge missing（补回缺失）	只把快照里有、但你现在没有的条目加回来	误删了收藏，想补回被删的条目
Replace（完全替换）	把目标数据重置成与快照完全一致	数据大面积错乱，想精确回到快照时刻

操作步骤：

选中快照 → 选择恢复模式（Merge missing或Replace）
选择目标 Provider 实例
点击Restore capture并二次确认
等待进度条完成，界面会提示Restore complete以及新增/删除的条目数

💡 建议先用Merge missing试探性地补回数据；只有确认需要彻底重置时，才使用Replace。

用 Capture Compare 对比两次快照差异

不确定哪次改动出了问题？CrossWatch 内置了Capture Compare对比页（源码：assets/js/capture-compare/）：

在 Captures 列表中勾选任意两份快照，选择 Compare
对比页会列出两个时间点之间的所有变更：Added（新增）/ Removed（删除）/ Updated（修改）
点击具体条目，可并排查看变更前后（A · Before / B · After）的完整字段
支持按标题、ID 搜索，按媒体类型（电影/剧集/季/集）和变更类型筛选

这样你能精确定位"上周和这周之间，我的 Trakt 收藏到底少了什么"，再决定回滚到哪一份快照。

用命令行回滚：cw capture 命令

如果你习惯终端操作，CrossWatch 提供了完整的 CLI（源码：cli/commands/capture.py，完整文档见 cli/README.md）：

# 1. 列出所有快照（路径、Provider、功能、时间、条目数、大小） cw capture list # 2. 查看某份快照的原始内容 cw capture read <path> # 3. 对比两份快照，只看变化项 cw capture diff <older> <newer> # 4. 先做演练：只报告会改动什么，不做任何修改 cw capture restore <path> --dry-run # 5. 确认无误后，真正执行回滚 cw capture restore <path> --yes # 6. 删除不再需要的快照 cw capture delete <path>

--dry-run参数是安全回滚的关键：先用它预演一遍改动范围，再正式执行，避免误操作。