多人实时协作让多位创作者共同编辑同一个项目。成员可以看到彼此是否在线、正在查看哪个章节，以及章节、配置和素材的同步状态。
协作采用“先取得完整项目，再实时同步增量改动”的方式。它不会在首次加入时自动下载整个项目，因此邀请成员前要先用项目云端分享传递完整工程。
协作仍是测试功能。开始重要修改前保留项目历史或额外备份；出现冲突时，先确认本地和云端内容再选择覆盖方向。
准备工作
- 所有成员都需要登录 Studio 创作者账号。
- 发起协作的账号需要官方开通协作发起资格。
- 受邀成员不需要发起资格，可以直接凭邀请码加入。
- 所有成员应先导入并打开同一份项目。项目标识不一致时，Studio 会要求先通过云端分享导入正确项目。
- 保持网络连接。断线期间当前章节会进入只读状态，恢复连接并取得编辑权后再继续编辑。
发起协作
分享完整项目
从项目菜单使用「云端分享」，把分享码发给其他成员。对方先导入并打开这份项目。
打开实时协作
在 Studio 顶部项目菜单中选择「实时协作」。首次使用时按提示登录账号。
开启协作
点击「开启协作」。Studio 会为当前项目建立协作空间并生成 8 位邀请码。
发送邀请码
复制邀请码并发送给成员。邀请码用于加入实时会话，不替代前面的完整项目分享。
加入协作
- 通过发起者提供的云端分享码导入项目。
- 打开导入后的同一个项目。
- 进入「实时协作」，输入 8 位邀请码。
- 点击加入，等待顶部出现连接状态和在线成员。
如果当前项目与邀请码对应的项目不一致，Studio 不会启动一个内容不完整的协作会话，而是引导你先导入正确项目。
哪些内容会同步
| 内容 | 同步方式 |
|---|
| 章节正文与 Fragment | 保存后自动同步 |
| 章节新建、删除、重命名和排序 | 自动同步 |
| 角色、场景、变量与本地化 | 保存后自动同步 |
| 可视化 UI | 保存后自动同步 |
| 图片、音频、视频等素材文件 | 在协作面板中手动执行「同步素材」 |
章节编辑权
协作以章节为单位分配编辑权，避免两个人同时改写同一份章节：
- 打开章节时，Studio 会自动申请该章编辑权。
- 取得编辑权后可以正常修改和保存。
- 其他成员正在编辑时，本机显示实时预览和只读原因，不会覆盖对方内容。
- 从故事树修改章节名称、顺序或禁用状态时，也会先申请对应编辑权。
- 切换章节或停止协作后，当前编辑权会被释放。
- 断线或正在申请编辑权时，不要继续依赖尚未同步的本地修改。
顶部在线成员区域会显示其他成员所在的章节或模块，方便在修改前确认彼此分工。
冲突处理
当本地内容基于旧版本保存，或者离线期间本地与云端都发生变化时，会产生版本冲突。冲突可能来自章节，也可能来自角色表、场景表、变量表、本地化或可视化 UI。
协作面板会列出冲突对象。选择“使用云端版本”会用云端内容覆盖对应的本地文件，并解除该项冲突。
使用云端版本会丢弃该文件尚未同步的本地改动。处理前先复制重要文字，或使用项目历史保留当前状态。
协作动态面板
开启协作后，再次点击协作入口会打开“协作动态”面板。面板集中记录：
- 成员上线、离线及当前所在章节；
- 章节保存、文件上传和远端同步；
- 编辑权取得、释放和失败；
- 冲突、连接错误和恢复结果；
- 素材上传、下载和跳过原因。
可以按类型筛选动态、搜索内容、选中一条记录查看来源、目标文件、版本和大小。清空本次日志只清除当前机器内存中的动态记录，不会删除项目文件或云端版本。
点击“分离到独立窗口”可以把面板放到另一块屏幕；独立窗口与主窗口共享同一个协作状态和连接，不会建立第二个协作会话。关闭后可以重新打开或合并回 Studio。
上面的协作动态截图展示了成员列表、分类筛选、搜索和动态记录；右上角按钮可以把面板分离到独立窗口。
停止协作
点击“停止协作”并确认后，本机退出当前实时会话，不再上传或接收改动。其他成员不受影响，之后仍可以用同一个邀请码重新加入。
停止协作前确认：
- 当前章节已经同步完成；
- 没有尚未处理的冲突；
- 新增素材已经执行同步，或已经通过云端分享传递；
- 协作动态中没有持续失败的操作。
常见问题
为什么输入邀请码后要求先导入项目？
邀请码只建立实时增量同步，不包含完整项目。先让发起者使用云端分享，把项目导入本机后再加入。
为什么章节突然只读？
常见原因是其他成员持有编辑权、正在申请编辑权或网络断开。查看只读提示和协作动态，等待编辑权释放或连接恢复。
为什么图片没有出现在其他成员电脑上？
素材不是自动实时上传。打开协作面板执行“同步素材”；超过 20 MB 的单个文件改用云端分享。
云端覆盖本地后还能恢复吗？
协作本身不保留被覆盖的未同步内容。可以到项目历史检查覆盖前是否已有快照；关键修改应先复制或手动备份。 
