打开项目后,点击左下角 项目同步。窗口可以拖动、拉大和关闭;关闭只收起窗口,不会取消已经开始的同步。它是创作过程中的一个步骤,不需要离开编辑工作区。

第一次启用

  1. 在同步面板点击 为当前项目启用同步。如果未安装 Git 支持组件,先按提示前往设置下载一次,之后所有项目共用。
  2. 为当前项目建立本机版本记录。已有 Git 仓库直接读取,不重复初始化。
  3. 在 连接与说明 中选择平台、创建仓库,复制 HTTPS 地址并填写访问令牌。
作品尚未公开时,创建仓库请选择 私有(Private),再单独邀请制作组成员。新建空仓库时不要预先添加 README、许可证或忽略文件,以免与当前项目产生两份无关历史。
这个面板操作的是已经打开的项目。下载另一个远端项目,请返回首页使用 从 Git 克隆,不要把另一份仓库直接连到当前作品。

基础模式:看内容,按一次同步

基础模式默认显示,主要有三个入口:
  • 本次修改:按剧情、角色、场景、界面、个性化、蓝图、素材等具体内容列出变化,彩色图标帮助识别。选择一项可查看文字、属性和设置的修改前后内容,不需要阅读逐行文件差异。
  • 版本记录:查看最近的保存说明、作者、时间,以及仅在本机或已在远端的状态。未配置上游时不会声称已经上传。
  • 连接与说明:管理仓库连接,展示制作组和成员,查看平台、认证与大素材说明。
写一句可选的保存说明,点击 同步项目。Studio 会先检查远端更新,严格保存所有待保存内容、记录本机修改,合并远端版本并刷新编辑器,再上传这次保存的版本。任何一步失败都会停止后续操作;只有本机记录成功不代表上传成功。 列表预览的是已写入项目的内容。搜索只筛选显示,不会缩小同步范围。暂不能预览的内容、二进制素材和未知格式仍会保留在同步范围中。界面、主题个性化、项目与片段蓝图、扩展参数、变量、数据库、多语言、字体及素材打包策略都属于共享项目内容;本机窗口布局、授权数据和运行缓存不应进入仓库。 检查远端与上传期间可以继续创作。合并和重新载入时会短暂暂停编辑,以免旧稿覆盖更新。如果磁盘已更新但编辑器重新载入失败,面板会保留恢复入口,成功重新载入后才能继续编辑。上传期间新产生的修改留到下一次同步。

高级模式

点击 切换高级模式 可使用文件列表、逐行差异、提交说明、独立拉取与推送、历史记录和冲突处理。切换模式保留本次保存说明。
高级版本管理界面的文件变更、提交与历史记录
提交只保存在本机,推送才上传到远端。拉取获取团队更新并刷新项目内容。文件右侧的丢弃操作会先要求确认:已记录文件恢复到最近版本,新文件会删除,请仔细检查目标。 当前项目若只是更大仓库的子目录,基础模式会要求使用高级模式确认范围。项目文件夹外已暂存的修改不能混入本次项目提交;项目文件夹外尚未记录的本机文件与远端更新重叠时,同步也会停止并提示。这两种情况应先在外部 Git 工具中处理。分支切换等完整仓库操作可以在外部 Git 工具完成,再回到 Studio 刷新。

平台与认证

优先推荐 GitHub:支持公开与私有仓库,提供 Git LFS 免费额度,适合共享剧本与素材。请先确认网络可以访问。创建仓库 · 创建访问令牌。 **Gitee(码云)**是国内常用的代码托管平台,支持公开与私有仓库。素材较多时,先核对当前套餐的 LFS 支持、容量和费用。创建仓库 · 私人令牌 · 官方帮助。 Studio 账号登录不等于仓库认证。GitHub 的 HTTPS Git 操作不接受网站密码,需要访问令牌;Gitee 也建议使用私人令牌。Gitee 用户名必须是令牌所属账号的用户名,不是昵称,也不一定是仓库所有者。 令牌以明文保存在 Studio 本机用户目录,使用用户目录权限保护,不进入项目,不访问系统钥匙串。同域名仓库共用凭据。只授予需要的仓库权限,失效时到平台重新生成,再在连接设置更新。

LFS:大素材的单独仓库

LFS 是 Git 的大文件存储功能。可以把它理解为:剧本和设置放进版本记录,图片、音乐、语音和视频另存一份,版本记录里保留素材的地址。同步时两部分都需要传输;只有指针并不代表素材已经备份成功。
Git 本身免费,但托管大量素材可能需要付费。LFS 存储与下载有额度;旧素材的历史版本继续占空间,团队成员重复下载也消耗额度。超额后可能需要付费,或暂时无法上传、下载。
GitHub Free 当前包含 10 GiB LFS 存储、每月 10 GiB 下载额度。账户预算与付款设置也会影响超额后的处理,以官方 LFS 计费说明和账户账单为准。Gitee 的免费仓库不代表免费 LFS,请核对具体账户、企业套餐与仓库页面。

Git 怎么知道哪些文件使用 LFS?

由项目里的 .gitattributes 规则决定,不是自动按文件大小识别。Studio 新启用同步时默认使用:
assets/** filter=lfs diff=lfs merge=lfs -text
这表示 assets 目录中的匹配素材使用 LFS。已有项目保留自己的规则,子目录也可以设置规则。在 连接与说明 → 当前项目的大素材设置 可以查看根目录规则及本机组件是否可用。组件可用不能证明远端套餐已经开通。 新增规则影响之后记录的内容,已经进入历史的大文件不会自动迁移。迁移旧历史会改写提交,应先备份并与团队商量。

不用 LFS 会怎样?

素材的多个历史版本会使仓库增大,第一次下载、同步与备份变慢,也可能触及平台的单文件或仓库上限。删除现在的素材并不会自动删除历史中的大文件。

制作组和作者关联

使用当前 Studio 账号读取已加入的制作组,可选择展示制作组的名字、头像、封面及成员。选择保存在本机,不改变项目权限。 在 关联提交作者(仅本机展示) 中,可以手动把 Git 作者的姓名与邮箱组合对应到成员,版本记录会显示本机标记。该关联不改写历史、不授予权限,也不能证明 Git 作者的真实身份。同名但不同邮箱不会自动归为同一个人。

同步失败与冲突

网络失败可稍后重试;认证失败检查仓库地址、令牌权限与 Gitee 用户名;素材失败检查 LFS 组件、容量及下载额度。失败时本机已记录的版本仍保留,不能把失败提示当作云端备份完成。 双方修改冲突时,基础模式会停止上传并打开冲突处理。检查本地与远端内容后,明确选择合并结果,或放弃这次合并。高级模式保留结构化合并与 AI 辅助功能;使用 AI 前仍应确认内容可发送给相应服务。完成冲突处理后再同步,不能默认覆盖任何一方。

与项目历史、时光机备份的关系

功能用途
项目历史自动记录,回退最近的剧本与配置
时光机备份整项目(含素材)的备份
项目同步主动记录版本,与远端和团队同步
实时协作多人同时编辑时,自动同步正在修改的内容
「所有更改已保存」仅表示本机文件已写入,不表示已经记录 Git 版本或上传远端。这些功能可以同时使用。实时协作不同步 Git 版本记录和仓库连接。

从 Git 克隆工程

  1. 在经典首页选择「从 Git 克隆」,填写 HTTPS 仓库地址和目标位置。
  2. 私有仓库填写服务商访问令牌;缺少 Git/LFS 时按引导安装支持组件。
  3. 等待仓库、LFS 大型素材及工程校验完成,再选择打开或稍后处理。
  4. 打开后核对章节、素材和缺失引用,确认已保存到目标目录。
目标目录不能覆盖已有文件夹。克隆完成前先写入临时目录,只有校验通过才生成目标工程;中途失败时先阅读错误,不把临时内容当作完整工程。 私有仓库拉取提示认证失败时,补充或更新令牌再重试。本机记住的令牌按服务域名复用,不会写进工程或 Git 提交;它是本机明文凭证,并不是系统加密保险库。同域名使用多个账号时注意所保存令牌的账号权限。

批量冲突与 AI 合并

冲突列表可多选并批量采用本机或远端版本,先检查选择范围和预览;二进制文件不能按文字自动拼接。AI 合并会生成可审阅的结果,阅读差异并确认后再应用,不能把模型返回等同于已解决冲突。稿件会发送到配置的模型服务,按团队约定选择可用服务。 修改列表支持批量放弃,操作前查看确认范围。同步、合并与上传提供阶段进度和详细日志,失败时以最终状态判断,不能把合并成功当作推送完成。提交作者关联可对应多位成员,仍仅用于本机展示,不改写历史或证明身份。