一个 Decky 插件,用 rclone 把 Steam Deck 游戏存档同步到云端。本版本仅支持 坚果云(Nutstore)WebDAV——国内无需 VPN 即可稳定使用。
- 问题反馈:在本仓库提交 Issue,或加入 SteamDeckHomebrew Discord。
- 插件界面:跟随 Steam 语言设置,选「简体中文」即为中文界面。
当前版本:v1.1.0(Releases)
- 将游戏存档(或任意文件/文件夹)备份到坚果云 WebDAV。
- 游戏关闭后自动备份。
- 文件数预估,避免误选整个 Steam Deck。
- 包含/排除规则的高级过滤。
- 可选云端子目录。
- 游戏启动/退出自动同步(启动下载、退出上传)。
- 插件面板内直接查看同步日志。
配置 → 同步路径 的「添加到同步 / 从同步中排除」现在拆分为两个独立入口:
- 手动添加(原功能):直接选择文件 / 文件夹 / 文件夹(排除子文件夹)。
- 打开存档目录:仿 protontricks 的页面,自动列出
compatdata下各游戏的 Proton 前缀(自动解析游戏名,含非 Steam 游戏),点游戏进入目录浏览器,逐级进入存档目录挑选具体文件/文件夹后再确认加入同步——而非整文件夹直接上传。支持手柄方向键导航与聚焦高亮。
适合「只想同步某个游戏的
pfx/drive_c/users/steamuser/…存档,而不想把整个 compatdata 传上去」的场景。
注意:常规复制模式下,本地删除不会删除云端文件(防误删,设计如此)。
从 Releases 页面 下载最新 decky-nutstore.zip,通过 Decky 内置安装器安装:Decky → 设置 → 开发者 → 从 ZIP 安装插件。也可直接 clone 本仓库、用解压后的文件夹同样方式安装。
进入 配置 → 云端服务商,点击 坚果云(WebDAV) 按钮,填入:
- WebDAV 地址:
https://dav.jianguoyun.com/dav/(已预填,一般无需改动) - 坚果云账号(邮箱)
- 应用专用密码(不是登录密码;在坚果云网页 → 安全 → 第三方应用授权 中生成)
确认后插件会自动写入 rclone 配置,顶部显示「当前使用:坚果云 WebDAV」。
大屏输入不便时,可在桌面模式运行
defaults/quickstart/nutstore_webdav.sh(bash ./defaults/quickstart/nutstore_webdav.sh)。
进入 配置 → 同步路径,点击 添加到同步(或 从同步中排除),会弹出两个选项:
- 手动添加:直接选择文件 / 文件夹 / 文件夹(排除子文件夹),与原用法一致。
- 打开存档目录:跳转到游戏存档选择页(详见下方)。
无论哪种方式,选择后都会显示预估文件数;若超过 9000,很可能是选错路径(单个游戏存档通常不足 10 个)。
该页面列出 /home/deck/.steam/steam/steamapps/compatdata/ 下所有数字目录(即各游戏的 Proton 前缀),并按 appmanifest_<appid>.acf / shortcuts.vdf 自动解析游戏名(非 Steam 游戏也能显示名称)。操作流程:
- 在游戏列表中选择一款游戏 → 进入该游戏的目录浏览器。
- 逐级进入存档所在目录(例如
pfx/drive_c/users/steamuser/…)。 - 在顶部点 选择此文件夹 上传当前层(递归),或点具体文件/子文件夹右侧的 选择 仅加入该项。
- 底部 返回上级 可回退,左上 返回 回到同步路径页。
手柄操作:方向键上下移动焦点(聚焦项会高亮),A 键确认选择。
- 云端布局:每个文件夹以其原名称上传到坚果云根目录,插件记住其 Steam Deck 路径,逆向同步时原样恢复。「坚果云存放目录」为可选子目录,留空即直接传到根目录(推荐,方便在电脑端查看)。
- 两个同步按钮:
- SD → 云端(上传存档):本地存档推送到坚果云。
- 云端 → SD(下载存档):从坚果云恢复到 Steam Deck;未上传过的文件夹自动跳过。
- 游戏启动/退出自动同步逻辑同上:启动先下载最新云存档,退出再上传本地存档。
安全提示:rclone 在 Steam Deck 上以「混淆」而非强加密方式保存 WebDAV 密码,请务必使用坚果云应用专用密码,不要用主账号密码。
文件位置:~/homebrew/settings/decky-nutstore/plugin.properties
log_level:日志级别,调试时设DEBUG(默认INFO)。destination_directory:可选坚果云子目录,留空同步到根目录。additional_sync_args:传给每次 rclone copy 的额外参数。sync_root:同步路径必须位于此绝对路径前缀下(默认/,须以/结尾)。
pnpm install
pnpm build # 输出到 dist/把含 dist/、bin/、py_modules/、main.py、plugin.json 的插件文件夹通过 Decky 开发者安装器安装。bin/rclone 与 bin/rcloneLauncher 已内置,开箱即用。
- rclone:同步引擎。
- SteamDeckHomebrew:Decky 加载器与开发支持。
- 本插件是 GedasFX 的 decky-cloud-save 的坚果云定制版。
- 新增「打开存档目录」同步方式:把「添加到同步 / 从同步中排除」拆分为 手动添加 与 打开存档目录 两个入口。
- 「打开存档目录」仿 protontricks:列出
compatdata下各游戏 Proton 前缀并解析游戏名(含非 Steam 游戏),点游戏进入目录浏览器,逐级挑选具体存档目录/文件后再确认加入同步。 - 非 Steam 游戏正确显示名称:按 Steam
crc32(Exe + 空字节 + AppName) | 0x80000000算法从shortcuts.vdf原始字节推导 appid 并匹配目录名(兼容 string / wstring 字段、双向顺序兜底)。 - 列表项改用原生
ButtonItem:支持手柄方向键导航与聚焦高亮,去掉底部白条。 - 多 Steam 库 / native-Flatpak 软链同目录去重。