Tea EN

同步

用你自己的网盘或家庭 NAS 在多台设备之间同步游戏时长、通关记录、收藏、刮削结果和游戏存档,换一台掌机接着玩。

Tea 可以把你的游戏档案和存档保存到你自己的网盘(天翼云盘、百度网盘、夸克网盘或家庭 NAS),多台掌机(以及 Steam Deck)共用同一份。只用你自己的网盘空间,不经过任何第三方服务器。

会同步什么

类别 内容
游戏记录 游戏时长(各设备的时间累加)、通关记录
游戏档案 收藏、重命名、编辑游戏信息里的版本小字和简介、搜刮名、自定义贴纸和自定义封面(连同图片)、卡带外观、街机机台的横竖屏选择、金手指选择、自定义启动指令
刮削结果 封面、游戏资料、ScreenScraper 贴纸、街机机台图片,另一台设备不用重新刮削
游戏存档 游戏内存档和即时存档,见下文游戏存档同步

设置不同步:语言、主题、界面缩放、按键布局、视频和声音这些,每台设备各自保留。

设置同步网盘

  1. 打开 设置 → 通用 → 同步网盘。
  2. 在四个网盘中选一个:
    • 天翼云盘、百度网盘、夸克网盘:点 登录,用手机 App 扫码确认。
    • 家庭 NAS:点 连接,选择或输入 NAS 地址、填用户名和密码,再在 同步保存到 里选一个共享文件夹。具体步骤见网盘资源与下载。
    • 已经作为资源库网盘登录的,卡片上会显示 使用,点一下即可,不用再登录一次。
  3. 登录后,分组标题旁的 同步 开关默认打开,Tea 会马上开始第一次同步。
  4. 在另一台设备上登录同一个网盘的同一个账号,两边就会自动同步。

同步数据放在网盘根目录的 Freedeck Sync 文件夹里(NAS 则在你选的共享文件夹里)。请不要删除、移动或改名这个文件夹。

提示 同步网盘和资源库网盘可以是同一个,也可以分开,比如用天翼云盘同步、用 NAS 放游戏。

同步开关与状态

同步网盘登录后,设置 → 通用 → 同步网盘 里只显示这个网盘的卡片:

状态行可能显示:

状态 含义
已同步 · 2 分钟前 一切正常
已同步 · 2 分钟前 · 正在同步贴纸 3/20 记录已同步,贴纸图片还在传
同步中… 正在同步
等待同步 · 无网络 连不上网盘,改动会保留,有网后自动补上
登录已过期 — 重新登录 点它重新扫码登录
同步已关闭 同步 开关是关的
其他红字 同步出错的原因,可以点 立即同步 再试

什么时候同步

不用手动操作,下面这些时候 Tea 会自动同步:

Tea 关闭时不会在后台同步。

想马上同步,点 立即同步,或点侧边栏的小云朵。

在哪里看同步状态

侧边栏的小云朵

侧边栏「设置」项的右边有一个小云朵:

图标 含义
云朵带 ✓ 已同步
云朵里箭头在转 正在同步
云朵带 ! 同步出错或登录过期
普通云朵 无网络,等待同步

点一下云朵就立即同步。用手柄时,在「设置」项上按 → 移到云朵,再按 A。竖屏的底部导航栏没有这个云朵。

游戏上的云朵标记

有游戏记录的游戏,在收藏、通关这些标记后面会多一个小标记(网格、列表、轮播和游戏页都有):

标记 含义
转动的同步图标 这款游戏有改动,等待上传
云朵 已上传
云朵带 ! 有改动没传上去,上次同步失败了

游戏库的提示

游戏页的「已玩」时间包含所有设备上玩的时间。

游戏存档同步

存档和游戏记录用同一个 同步 开关,不用另外设置。在一台设备上存档,换一台打开同一款游戏就能接着玩。

支持的模拟器

平台 模拟器
多平台 RetroArch、RetroArch G(全部核心)
GBA My Boy!
NDS melonDS、WatermelonDS、DraStic
3DS AzaharPlus、Citra MMJ、天马包 Citra
N64 M64Plus FZ / Pro
GameCube / Wii Dolphin、Dolphin MMJR
Wii U Cemu(以及 RetroArch 的 Cemu 核心)
Switch Eden、Eden Nightly、Lemon 及 Eden 的分支
PS1 DuckStation
PS2 ARMSX2、NetherSX2
PSP PPSSPP
PS Vita Vita3K、Vita3K+(以及 RetroArch 的 Vita3K 核心)
Dreamcast Flycast(新版)

同步哪些存档

正确的玩法

  1. 打开游戏页:Tea 在后台把网盘上更新的存档拿下来,游戏页会显示「正在同步存档…」,好了以后显示「存档已同步 · N 分钟前」。
  2. 按「启动」:直接开始游戏,不用等。
  3. 正常退出模拟器:用悬浮键的 存&退 或 结束,或模拟器自己的退出。
  4. 回到 Tea:这一局的存档自动上传。

换另一台设备前,先在这一台回到 Tea、等存档传上去。

注意 按 Home 离开、在多任务里划掉模拟器,存档可能没写进文件,什么都不会上传。RetroArch 的游戏内存档要等正常退出游戏时才会写进文件;悬浮键的 结束 只保留游戏内存档,想留住即时存档请用 存&退。

提示 如果没等存档下载完就开了游戏(比如离线),这一局用的是本机的存档。回到 Tea 后,网盘上的新存档和本机的新存档会成为「冲突」,由你决定保留哪份,不会被悄悄覆盖。

首次设置:掌机助手里的「存档同步」一栏

很多独立模拟器的存档放在 Tea 读不到的地方,需要设置一次。打开 掌机助手,每个模拟器卡片上有 存档同步 一栏,按提示一步步来:允许读取 → 请登录同步网盘 → 存档同步已就绪。

模拟器 需要做的
Dolphin、Eden / Lemon、Cemu、My Boy! 在卡片上点 允许读取,在打开的页面点「使用此文件夹」(只需一次)
DuckStation、NetherSX2 点 允许读取,选择它的 Android/data 文件夹。Android 13 及更早一般可以,更新的系统可能不允许选,这时无法同步
DuckStation 在它的设置 › 记忆卡里,把卡 1 类型设为「每个游戏单独一张(按序列号)」
NetherSX2 在 Memory Cards 设置里为游戏开启单游戏记忆卡
ARMSX2 数据目录设为「自定义文件夹」(内部存储下任选一个);每款游戏新建一张以游戏编号命名的记忆卡(如 SLUS-21065)放在 Slot 1,游戏页会告诉你该叫什么
melonDS / WatermelonDS 打开「存档放在 ROM 旁」;或者在卡片的 存档文件夹 里选和模拟器设置里相同的文件夹
M64Plus FZ / Pro 设置 › 数据 里把「游戏数据存储位置」设为外部存储,并在内部存储下选一个文件夹
Flycast 首次启动时把主文件夹选在内部存储下(如 内部存储/Flycast),或点 允许读取。旧版 Flycast 没有单游戏记忆卡,无法同步,请在掌机助手里换装新版
DraStic 它要你选文件夹时,选 内部存储 › DraStic
Vita3K 在卡片上选择游戏存储文件夹

还差一步时,游戏页的模拟器选择下面会出现一行黄色提示,按提示设好即可;点 知道了 可以让这条提示不再出现。玩了 10 分钟以上存档却没有任何变化时,Tea 也会提醒你检查设置。

游戏页上的存档状态

游戏页顶部「已玩」后面会显示:

显示 含义
正在同步存档… 正在下载或上传
正在等待存档同步 排队中
存档已同步 · N 分钟前 已同步,点「存档已同步」打开存档记录
存档在两台设备上都改过了 — 选择保留哪个 冲突,见下文
即时存档超过 N MB,未同步 文件太大,没有同步

冲突怎么处理

游戏记录和档案会自动合并,不用你操心:

存档不会被悄悄覆盖。只有一边改过,就直接用新的;两台设备都改过(比如两边都离线玩了),游戏页会用黄字提示冲突,点开后在「选择要保留的存档」里选:

被替换掉的存档文件会保留一份,后缀为 .freedeck-bak(只保留最近一份)。

存档记录

点游戏页的「存档已同步」,或游戏页 ⋯ 菜单里的 存档记录,可以看到最近 3 次上传:时间、设备、模拟器版本,最新的一份标着「最新」。点 选用 就换回那一份,原来的存档保存为 .freedeck-bak。

上传本地存档

游戏页 ⋯ 菜单里的 上传本地存档:确认后把这台设备上的存档作为最新的上传,即使它比网盘上的旧。网盘上原来那份仍然可以在存档记录里找回。平时同步是自动的,一般用不到它。

存档正在同步时,这两项会暂时变灰,同步完就能用。

限制

更换同步网盘

注意 同步数据保存在同步网盘里。换一个同步网盘,相当于从头开始:旧网盘上的记录和存档不会搬过去,新网盘上只有这台设备的数据。其他设备也必须换到同一个网盘,否则两边各同步各的,数据就分开了。请尽量固定使用一个同步网盘。

如果确实要换:

  1. 在 设置 → 通用 → 同步网盘 点 登出(如果它同时是资源库网盘,账号会保持登录,只是停止同步)。
  2. 选新的网盘登录。
  3. 在每一台设备上都换到这个新网盘、同一个账号。

Steam Deck

Steam Deck 版和安卓掌机共用同一个同步网盘:游戏记录、档案和游戏内存档都互通。即时存档两边各留各的,因为 Deck 上的模拟器和安卓版不同,互相读不了。详见 Steam Deck。