Summer Cloud 同步的内容
简单来说
你的游戏项目，在每台机器上，始终一致。
游戏不只是代码。还有模型、贴图、音乐、场景、设置。这些文件很大、经常变化，一旦两台机器上的内容不一致就会出问题。Summer Cloud 保存整个项目的唯一真实副本，并让每台机器与它保持一致。
保存即同步到所有地方
在台式机上工作，打开笔记本，继续做。在一台机器 push，在另一台 pull，项目就会逐字节一致地到达。不用压缩包，不用网盘链接，不用猜"这是哪个版本"。
什么都不会丢
每次 push 都会生成一个可以随时回退的编号版本。Summer Cloud 在改动你磁盘上的任何内容之前，都会先创建本地检查点。误删不再可怕。
文件始终属于你
不需要学习单独的查看器。项目文件夹本身就是界面：文件就地同步，引擎自动识别，summer cloud status 告诉你发生了什么变化。存储对你的账户完全私有。
它是什么
面向游戏的完整项目同步，而不是文件夹备份。
整个项目随你移动
Summer Cloud 跟踪让游戏运行起来的项目文件：场景、资源、脚本、导入、项目设置、插件以及资产二进制文件。
大型资产是一等公民
blob 按 sha256 存放在私有对象存储中，生成的模型、纹理、音频和资源包可以直接同步，不必假装它们是漂亮的文本 diff。
Git 仍然是可选项
Git 中唯一可见的云文件是很小的项目绑定。独立创作者可以不用 Git 进行同步，使用 Git 的团队也能避免云状态的合并冲突。
agent 使用同一套接口
每个操作都以幂等的 HTTP 调用、CLI 命令和 MCP 工具的形式暴露，agent 操作的系统与人类完全相同。
工作原理
本地计算哈希，只传一次，然后提交 manifest。
1. 绑定项目
运行 cloud init 命令。Summer 会写入一个小的项目绑定，并为项目创建一个空的云端 head。
2. 只推送缺失的字节
CLI 对跟踪的目录树计算哈希，向 API 询问哪些 blob 已存在，将缺失的 blob 上传到签名的暂存 URL，然后提交 manifest。
3. 拉取并校验
在另一台机器上，Summer 下载 manifest，为所需 blob 获取签名 URL，校验每个 sha256，并在本地检查点的保护下应用变更。
agent 操作
文档化 HTTP 调用，并由 CLI 和 MCP 镜像。
Summer Cloud 的设计目标是：拿着 token 和操作文档的 agent 可以创建项目、检查 blob、上传、提交、水合、恢复版本、摄取资产并查看用量，全程没有隐藏的 UI 步骤。
HTTP API
/api/cloud/ 下的路由覆盖项目、blob 的 check/presign/complete、manifest 提交、版本、恢复、摄取、协作者和用量。
CLI 命令
summer cloud init、push、pull、status、restore 和 conflicts 是人类与自动化共用的入口。
MCP 工具
同样的操作通过 Summer 的 agent 层暴露给 Claude Code、Codex、Cursor、Windsurf 以及其他 MCP 客户端。
内容寻址同步
每个文件都指向已验证的字节，每个项目状态都指向一个 manifest 版本。
恢复
破坏性同步也会留下恢复路径。
Summer Cloud 从不依赖时钟或 last-write-wins。服务器的 manifest 版本决定顺序，本地检查点保护尚未推送的工作，冲突会保留双方的字节。
版本历史
每个被接受的 manifest 版本都会按策略保留，恢复操作会创建新版本，而不是改写旧版本。
本地检查点
在 pull 修改或删除现有文件之前，CLI 会向项目本地的 SummerGit 仓库写入完整目录树的检查点。
冲突保全
当两台机器编辑同一路径时，被接受的远端文件落在正常路径上，落败的本地字节保存在引擎扫描树之外。
价格
存储跟随现有 Summer 方案。
即使账户超出配额或处于只读状态，pull 和读取仍然可用。存储上限跟随方案层级，库与模板 blob 不计入用户配额。
Free
足够备份小型实验和 game jam 项目。
Basic
足以在多台机器间同步你的第一个正式项目。
Pro
适合在多台桌面机器间同步活跃项目的创作者。
Pro+
适合包含生成模型、音频和纹理库的较大项目。
Ultra
适合重度资产工作和多项目制作。
FAQ
实用解答。
- Summer Cloud 是 Git 的替代品吗？
- 它替代的是 Git 让许多游戏创作者头疼的那部分：把整个项目和资产保持在多台机器上。Git 在文本审查和分支工作流上仍然有用，但 Summer Cloud 不要求使用它。
- 它能同步大型生成资产吗？
- 能。Summer Cloud 将资产字节存为内容寻址的 blob，并通过签名的对象存储 URL 同步，而不是让资产字节挤过 Web 应用。
- agent 能操作它吗？
- 能。这套 API 有意按 agent 接口来撰写文档。CLI 和 MCP 工具镜像同样的操作，agent 可以推送、拉取、查看状态、恢复和摄取资产。
- 编辑冲突时会发生什么？
- 在服务器 CAS 竞争中获胜的提交成为规范路径。落败的本地字节会保存为冲突集，之后可以恢复。文档从不把这称为 last-write-wins，因为时钟不可信。
- 存储用完了怎么办？
- 写入和摄取可能被阻止，但读取、pull、manifest 访问和恢复仍然可用。欠费不会删除项目数据。