WHC系列: CrossWatch --- 跨平台媒体观看历史与评级同步工具

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.crosswatch


## 🎯 What —— 这是什么？
- 🏷️ **一句话定位**：跨平台媒体观看历史与评级同步工具
- 🚀 **核心优势**  
  - ✨ 支持Plex/Jellyfin/Emby与Trakt/SIMKL/MDBlist多向同步  
  - ⚡ 实时scrobbling与内置备份，确保数据安全无丢失  
  - 🔒 本地运行Web UI，Docker部署简单，隐私优先无云依赖
- 📊 **适用场景**：多设备追剧用户管理观看进度与评分一致性

## 🛠️ How —— 怎么用？
### 多平台配置
打开应用，右上角进入**Settings**。
![CleanShot 2025-12-28 at 21.05.58.png](https://dl.playground.lazycat.cloud/guidelines/402/9497252a-8aa5-4c90-b82a-f5d9d18b4f42.png "CleanShot 2025-12-28 at 21.05.58.png")
进入后，点击provides，我这边以Plex和Trakt为例
先配置Plex，直接点击**Connect PLEX**
> 注意：PLEX需要你先登录账号

![CleanShot 2025-12-28 at 21.06.57.png](https://dl.playground.lazycat.cloud/guidelines/402/0088ffcf-d1d8-4d05-8375-fa1cb21b9107.png "CleanShot 2025-12-28 at 21.06.57.png")
会跳转到以下网页，需要填入Link Code
![CleanShot 2025-12-28 at 21.07.26.png](https://dl.playground.lazycat.cloud/guidelines/402/ff0b9172-0a7f-4f4c-84c6-92a3eda01b73.png "CleanShot 2025-12-28 at 21.07.26.png")
这个可以回到应用，可以在**Link Code**里看到，点击**Copy**复制粘贴即可。
![CleanShot 2025-12-28 at 21.06.57.png](https://dl.playground.lazycat.cloud/guidelines/402/0088ffcf-d1d8-4d05-8375-fa1cb21b9107.png "CleanShot 2025-12-28 at 21.06.57.png")
然后回到应用中，**current token**有数据显示即表示成功，点击下方Save保存。
![CleanShot 2025-12-28 at 21.08.34.png](https://dl.playground.lazycat.cloud/guidelines/402/9577a780-7caa-4729-bd96-233cbbc09275.png "CleanShot 2025-12-28 at 21.08.34.png")

接下来我们配置**Trakt**，点击Traket的配置，按照下方说明对应操作。
> 注意：请先确保你已经注册Traket账号，才能进行后续步骤。


![CleanShot 2025-12-28 at 21.10.43.png](https://dl.playground.lazycat.cloud/guidelines/402/77822fb8-40fa-4b63-9699-d156dbfe0825.png "CleanShot 2025-12-28 at 21.10.43.png")

点击**Trakt Applications**链接，点击**New Application**
![CleanShot 2025-12-28 at 21.12.02.png](https://dl.playground.lazycat.cloud/guidelines/402/50d42f11-ec88-4df5-8d48-7bd5af6e0124.png "CleanShot 2025-12-28 at 21.12.02.png")

可参考下方内容对应填写，然后点击**Save App**.
> **注意：Redirect url的配置一定是上面Trakt里要求的链接**

![CleanShot 2025-12-28 at 21.15.00.png](https://dl.playground.lazycat.cloud/guidelines/402/059b75b8-2b3a-49bc-b500-463d3946decc.png "CleanShot 2025-12-28 at 21.15.00.png")

接下来我们就得到了**Client ID**和**Client Secret**
![CleanShot 2025-12-28 at 21.15.23.png](https://dl.playground.lazycat.cloud/guidelines/402/315a6c06-6129-4f0a-a015-31b374f0890b.png "CleanShot 2025-12-28 at 21.15.23.png")

然后点击**OAuth**里的Authorize
![CleanShot 2025-12-28 at 21.21.55.png](https://dl.playground.lazycat.cloud/guidelines/402/54d0e445-bf96-48d4-9581-076c687aead1.png "CleanShot 2025-12-28 at 21.21.55.png")

在跳转的页面里点击Yes
![CleanShot 2025-12-28 at 21.20.48.png](https://dl.playground.lazycat.cloud/guidelines/402/febb967e-fe99-42e0-b886-b66f7324e348.png "CleanShot 2025-12-28 at 21.20.48.png")

你就会得到PIN Code，可以不用管这个。
![CleanShot 2025-12-28 at 21.20.57.png](https://dl.playground.lazycat.cloud/guidelines/402/bf0679d2-7e03-4e0b-b824-87fcb6b33363.png "CleanShot 2025-12-28 at 21.20.57.png")

回到Trakt里对应填写**Client ID**和**Client Secret**后，点击Connect TRAKT
![CleanShot 2025-12-28 at 21.19.06.png](https://dl.playground.lazycat.cloud/guidelines/402/135c9086-5ea7-4fc7-94c7-8ad9f924b6d2.png "CleanShot 2025-12-28 at 21.19.06.png")

在跳转的页面里需要输入PIN Code，回到CrossWatch应用里，在Trakt配置下可以看到PIN Code，对应复制粘贴即可，点击Continue，选择Yes，显示Woohoo即表示成功。
![CleanShot 2025-12-28 at 21.25.34.png](https://dl.playground.lazycat.cloud/guidelines/402/1157b9ac-abd2-4b38-8b86-7e87d86e2235.png "CleanShot 2025-12-28 at 21.25.34.png")
![CleanShot 2025-12-28 at 21.25.42.png](https://dl.playground.lazycat.cloud/guidelines/402/7ae36918-a65a-41bd-b7fb-be941e77b823.png "CleanShot 2025-12-28 at 21.25.42.png")
![CleanShot 2025-12-28 at 21.25.49.png](https://dl.playground.lazycat.cloud/guidelines/402/d0b2c5ff-79b8-4844-9ae7-bd7ba309fc05.png "CleanShot 2025-12-28 at 21.25.49.png")

最后回到Trakt里，Current Token有数据即表示成功，点击下方Save。
![CleanShot 2025-12-28 at 21.27.47.png](https://dl.playground.lazycat.cloud/guidelines/402/21ea6f94-2e7b-41fd-ad68-091974ea95f3.png "CleanShot 2025-12-28 at 21.27.47.png")


![CleanShot 2025-12-28 at 21.31.25.png](https://dl.playground.lazycat.cloud/guidelines/402/f46929af-c5c4-4f77-9d88-bb9fc5906c76.png "CleanShot 2025-12-28 at 21.31.25.png")
> 这样，我们就配置好了PLEX和Trakt，两个配置都显示🟢就表示配置成功了。

### 二、创建配对同步
1. 点击**Synchronization Providers**
![CleanShot 2025-12-28 at 21.31.53.png](https://dl.playground.lazycat.cloud/guidelines/402/37cc3b2b-2a99-4d38-806e-4fa3a7db79c3.png "CleanShot 2025-12-28 at 21.31.53.png")
2. 选择来源和目标，这边我就以Plex为来源，目标选择Trakt
3. 选择后会跳转到下面界面，我这边选择 **ONE-WAY(单向)** 为例，只需要配置**Watchlist** 和**History** 即可，对应打开功能即可，然后点击**Save**。
![CleanShot 2025-12-28 at 21.33.11.png](https://dl.playground.lazycat.cloud/guidelines/402/0f640e2a-ca9c-4fc2-bc03-de8bf3ddec52.png "CleanShot 2025-12-28 at 21.33.11.png")
![CleanShot 2025-12-28 at 21.33.22.png](https://dl.playground.lazycat.cloud/guidelines/402/e43f5f6f-de18-4f74-a4c3-da79d7775aa1.png "CleanShot 2025-12-28 at 21.33.22.png")
保存后就会显示如下，如需修改就点击编辑小图标即可。
![CleanShot 2025-12-28 at 21.34.02.png](https://dl.playground.lazycat.cloud/guidelines/402/12ae7e43-5195-4aa8-a1d9-e46e1c8c29e0.png "CleanShot 2025-12-28 at 21.34.02.png")

### 三、配置TMDB（可选）
点击**Movie Database**，配置TMDB API Key.
![CleanShot 2025-12-07 at 12.57.24.png](https://dl.playground.lazycat.cloud/guidelines/402/dfec2ff7-0e77-4e6a-922f-01edc8a26995.png "CleanShot 2025-12-07 at 12.57.24.png")
> 注意：配置后，需要开启小猫咪或者小猪佩奇才可正常使用

### 四、配置同步
点击**Scheduling**，可按需配置下方参数
![CleanShot 2025-12-07 at 13.01.18.png](https://dl.playground.lazycat.cloud/guidelines/402/c12e0900-8ad8-4713-86dc-a5912fd8a4dd.png "CleanShot 2025-12-07 at 13.01.18.png")
我这边先按照以下配置进行
![CleanShot 2025-12-28 at 21.40.03.png](https://dl.playground.lazycat.cloud/guidelines/402/d232a7fc-86b0-481f-a005-9a271b8f9ff6.png "CleanShot 2025-12-28 at 21.40.03.png")

配置完之后，点击底部**Save**即可。
![CleanShot 2025-12-28 at 21.41.19.png](https://dl.playground.lazycat.cloud/guidelines/402/404f2540-686e-4214-bc92-15508503d784.png "CleanShot 2025-12-28 at 21.41.19.png")

### 五、同步数据
回到应用主页面，可以直接点击**Synchronize** 进行同步
![CleanShot 2025-12-28 at 21.42.00.png](https://dl.playground.lazycat.cloud/guidelines/402/974839ce-83f1-4645-9e1a-ffa0c941d348.png "CleanShot 2025-12-28 at 21.42.00.png")

配置完之后就会有相应的数据展示
![CleanShot 2025-12-28 at 21.42.52.png](https://dl.playground.lazycat.cloud/guidelines/402/9461fd45-3247-4aa4-80bb-5d720305da33.png "CleanShot 2025-12-28 at 21.42.52.png")
![CleanShot 2025-12-28 at 21.43.48.png](https://dl.playground.lazycat.cloud/guidelines/402/33f8279d-7db8-450d-b5f3-a8d4730fb5d6.png "CleanShot 2025-12-28 at 21.43.48.png")

打开Trakt，可以看到也对应同步信息了。
![CleanShot 2025-12-28 at 21.43.57.png](https://dl.playground.lazycat.cloud/guidelines/402/3133ec45-ddc5-4051-a8af-1c67eae6125c.png "CleanShot 2025-12-28 at 21.43.57.png")

**因PLEX的历史记录需要Plex Pass才能开启，所以这里用Jellyfin和Trakt来演示历史记录同步**

首先配置Jellfin的配置，对应填写地址和账号密码，点击Sign in，登录成功后点击save保存
![CleanShot 2025-12-28 at 22.18.21.png](https://dl.playground.lazycat.cloud/guidelines/402/e80e03cf-68e7-433b-995d-d157e92d0597.png "CleanShot 2025-12-28 at 22.18.21.png")

同样按照上述步骤二，创建Jellyfin和Trakt的配置
![CleanShot 2025-12-28 at 22.11.37.png](https://dl.playground.lazycat.cloud/guidelines/402/5594280a-be5a-4488-bd57-99e5e9925c10.png "CleanShot 2025-12-28 at 22.11.37.png")

![CleanShot 2025-12-28 at 22.11.41.png](https://dl.playground.lazycat.cloud/guidelines/402/84b89ddd-1e90-4068-9492-1d3dd96cbd86.png "CleanShot 2025-12-28 at 22.11.41.png")

同样按照上述步骤四，配置同步，点击Save保存
![CleanShot 2025-12-28 at 22.22.21.png](https://dl.playground.lazycat.cloud/guidelines/402/fd629c07-9cf2-4af5-8c3f-cc01731b3b38.png "CleanShot 2025-12-28 at 22.22.21.png")

回到主页，点击Synchronize，即可看到数据更新。
![CleanShot 2025-12-28 at 22.14.59.png](https://dl.playground.lazycat.cloud/guidelines/402/c619b7da-5950-424c-ab4a-d6e688297664.png "CleanShot 2025-12-28 at 22.14.59.png")

打开Trakt，可以看到也对应历史记录信息了。
![CleanShot 2025-12-28 at 22.15.12.png](https://dl.playground.lazycat.cloud/guidelines/402/8484515e-8d77-4b3c-9fb9-8c5a7f97681f.png "CleanShot 2025-12-28 at 22.15.12.png")

也可参考官方教程：[CrossWatch - Sync Best Practices](https://github.com/cenodude/CrossWatch/wiki/Best-Practices)

## 🧩 Conclusion —— 一句话总结
**CrossWatch以简洁Docker部署和灵活同步机制脱颖而出，完美解决多平台追剧痛点。**