[开源/跨平台] Steam 云存档管理器 — Steam Cloud File Manager 介绍

1474913 · 发表于昨天 03:48 · 四川

我最近写了一个 Steam 云存档管理工具，在这里分享介绍一下。

项目地址：https://github.com/Fldicoahkiin/SteamCloudFileManager
支持平台：Windows / macOS / Linux
技术栈：Rust + egui（GUI）+ steamworks-rs（Steam API）

【功能介绍】

- 查看云端文件列表：以树状结构显示所有云存档文件

- 文件操作：下载、上传、删除单个或多个文件

- 路径映射：显示每个云端文件对应的本地硬盘位置
- 冲突检测：计算文件哈希值，对比本地和云端版本
- 备份功能：操作前可以先备份当前状态

【Steam 云同步机制】

Steam Cloud 的工作流程：

1. 游戏把存档写到本地目录（不是直接写到云端）
2. Steam 客户端检测到文件变化后，在后台把文件上传到云端服务器
3. 在另一台电脑上，Steam 会在启动游戏前把云端文件下载到本地

本地缓存位置：Steam/userdata/<你的ID>/<游戏ID>/remote/

元数据文件：remotecache.vdf
这个文件记录了每个云端文件的状态，包括文件名、大小、修改时间、是否已同步等信息。
格式是 Valve 自定义的键值对格式（VDF），类似 JSON 但语法不同。

【关于存档位置】

不同游戏的存档可能在完全不同的位置：
- 有的在"我的文档"
- 有的在 AppData
- 有的在游戏安装目录
- 有的在 Steam 云目录

这是因为 Steam 有一套 Root 路径系统。游戏开发者在 Steamworks 后台配置存档路径时，使用的是路径宏（比如 WinMyDocuments、WinSavedGames 等）。

Steam 会把这些宏转换成数字 ID（0-12），记录在每个游戏的 remotecache.vdf 文件中。这个 Root ID 到实际路径的对应关系，官方文档没有完整公开，我在仓库里整理了一份映射表，但还不够完善，如果你发现有问题或者想补充，欢迎来 GitHub 提 Issue 或 PR。

常见的 Root ID：
- 0 = Steam 云目录 (userdata/.../remote/)
- 1 = 游戏安装目录
- 2 = 我的文档
- 4 = AppData/Local
- 9 = Saved Games 文件夹
- 12 = AppData/LocalLow
（共 13 种，完整映射表见 GitHub 仓库的 ROOT_PATH_MAPPING.md）

另外 appinfo.vdf 是个二进制文件（约 150MB），包含所有游戏的元数据，其中有每个游戏的云存储配置规则（ufs 节），但里面存的是路径宏名称，不是 Root ID 数字。

这个工具会解析 remotecache.vdf 获取 Root ID，然后根据内置的映射表转换成实际路径，所以你能看到每个文件真正存在哪里。

【关于调试模式】

工具需要从 Steam 获取文件下载链接。Steam 客户端内置了一个 Chromium 浏览器，开启调试模式后可以通过 CDP 协议（Chrome DevTools Protocol）连接这个浏览器，注入脚本获取下载链接。

开启方法：Steam 启动参数加上 -cef-enable-debugging
工具里有一键重启 Steam 的按钮，会自动加上这个参数。

【文件操作说明】

操作对应的 API：
- 上传：write_file → 把本地文件写入缓存
- 同步到云端：write_file + sync_cloud_files → 仅上传本地有但云端没有的文件
- 下载：CDP 获取下载链接 → HTTP 下载到本地磁盘
- 删除：delete_file → 同时删除本地缓存和云端
- 移出同步：forget_file → 从云端移除但保留本地文件
- 备份：read_file → 把云端文件读取到本地
- 刷新：VDF 解析器 + CDP 客户端 → 重新获取文件列表
- 文件对比：计算本地和云端文件的 Hash 值进行对比

【注意事项】

1. 删除操作不可撤销，建议先用备份功能
2. 同步是后台异步进行的，操作后等几秒再关闭 Steam
3. 这个工具只是帮你看和操作文件，不会修改 Steam 的同步逻辑

【安装方式】

GitHub Release 下载：https://github.com/Fldicoahkiin/SteamCloudFileManager/releases
macOS Homebrew：

brew tap Fldicoahkiin/tap && brew install steam-cloud-file-manager

复制代码

Arch Linux AUR：

yay -S steam-cloud-file-manager-bin

复制代码

【参考资料】

- Steam Cloud 开发者文档：https://partner.steamgames.com/doc/features/cloud
- ISteamRemoteStorage 接口：https://partner.steamgames.com/doc/api/ISteamRemoteStorage
- Valve VDF 格式说明：https://developer.valvesoftware.com/wiki/KeyValues
- steamfiles (Python VDF 解析)：https://github.com/leo工具teamfiles
- steamworks-rs (Rust Steam API)：https://github.com/Noxime/steamworks-rs

项目完全开源，代码在 GitHub 上。
有问题欢迎提 Issue，也欢迎 PR 贡献。
觉得有用的话给个 Star 支持一下。

以上内容如有错误或不准确的地方，欢迎指正。
我对 Steam 内部机制的理解也在不断学习中，欢迎交流讨论。

更详细的技术说明和使用文档请查看 GitHub 仓库的 README。

QQ 交流群：324504270

本帖子中包含更多资源

本帖被以下淘专辑推荐:

积分封禁

预备会员

超级版主

研发支持

认证发行商

浪人

平台开发者

绿光作者

QQ游客

初阶会员

实习版主

管理员

版主

禁言会员

封禁帐户

封禁网段

游客

待验证用户

论坛贵宾

群组维护

进阶会员

高阶会员

精锐会员

支柱会员

核心会员

旗舰会员

毕业会员