快速上手

首次使用前请手动备份

备份你的存档和 Mod 文件夹。本软件经过初步测试，但多一道保险总没错。

准备工作

使用 Sync the Spire 之前，你需要准备两样东西：

1. 一个远程 Git 仓库 — 用于存储和同步 Mod 配置
2. Sync the Spire 客户端 — 下载安装

第一步：准备远程仓库

Sync the Spire 使用 Git 仓库来同步数据，你需要一个远程仓库地址。

• 自己建房：在 Git 托管平台创建一个仓库，然后邀请队友加入
• 跟随队友：直接使用队友提供的仓库地址，跳过创建步骤

平台	说明	创建指南
Gitee	国内访问快，推荐国内用户首选	查看 Gitee 配置指南
GitHub	全球通用，但国内部分地区访问受限	查看 GitHub 配置指南
其他平台	GitLab、Gitea 等理论上均可	—

如果你要自己创建仓库，按照对应指南完成仓库创建和认证配置。如果使用队友的仓库地址，可直接跳到下一步。

第二步：创建工作区

打开 Sync the Spire，你会看到工作区主页。

1. 点击「新建工作区」按钮

2. 在弹出的向导中选择游戏类型（如杀戮尖塔 2）

   

3. 输入一个工作区名称（默认已填好，也可以自定义），点击「创建」

   

第三步：填写配置并初始化

创建工作区后自动进入配置页面：

1. 将仓库地址粘贴到「远程仓库 URL」输入框
2. 填写你的昵称（队友会看到这个名字）
3. 选择认证方式（各平台推荐的方式见对应配置指南）
4. 填写或点击「自动查找」来设置游戏路径和存档路径
5. 点击「保存并初始化」

找不到路径？

• 游戏安装路径：Steam 中右键游戏 → 管理 → 浏览本地文件
• 存档路径：启动游戏后按 ~ 键打开控制台，输入 open saves 回车
• 也可以点击「自动查找」让软件自动检测（支持 Steam 平台）

初始化过程中会显示进度条，完成后自动进入仪表盘。

第四步：开始使用

配置完成后，根据你的角色选择操作。

做房主 — 分享 Mod 配置

你负责维护 Mod 配置，队友从你这里同步。

1. 在「创建分支」卡片中填入一个名称（简单描述一下这套 Mod 配置），点击「创建」
2. 像平时一样安装、调整 Mods（也可以使用内置的 Mod 管理器）
3. 完成后点击「上传」，上传前会自动显示 Mod 差异预览

别忘了把仓库地址分享给队友，并在仓库中邀请他们为协作者。

更多细节见 做房主

跟随别人 — 使用房主的配置

你只需要拉取房主分享的配置即可。

1. 在「联机跟随」卡片中点击「切换分支」，在列表中选择房主的分支

   

2. 可预览该分支包含的所有 Mod，确认无误后点击「同步此分支」

   

3. 同步完成，点击「启动游戏」即可开玩

之后每次联机前，点击「拉取」获取房主的最新配置。

更多细节见 跟随别人