v3.0.0 全面改版
准备工作
- 所有成员都要登录 Studio 创作者账号。
- 开启协作的账号需要官方开通发起资格。受邀成员不需要资格，凭邀请码即可加入。
- 加入时没有本地工程的成员，需要先在 Studio 中设置工作区目录。
开启协作
重新生成邀请码
邀请码泄露时，所有者可以在协作窗口左下方点击「重新生成邀请码」并确认。旧邀请码立即失效，已加入的成员不受影响。加入协作
没有本地工程
剧本下载完后工程立即打开并接上协作，可以先开始编辑。素材下载完成前，部分图片和声音暂时显示为缺失。- 这台电脑上已经有这个协作项目时，弹窗会提供「打开已有项目」和「仍然新建一份」。
- 提示「云端还没有这个项目的剧本」时，请发起者打开项目，等协作窗口显示已同步后再试。
已经打开工程
在项目菜单「实时协作…」的「加入协作」处输入邀请码，点击「加入」。邀请码对应别的项目时，Studio 转到上面的下载流程，在工作区新建一份。再次打开工程
开启或加入过协作的工程，之后每次打开都会自动续上协作。 点过「停止协作」的工程不会自动续上。需要时打开「实时协作…」，点击「继续协作」。哪些内容会同步
| 内容 | 包括 |
|---|---|
| 剧本 | 章节正文、片段和演出 |
| 章节树 | 新建、删除、重命名、排序、目录、启用与禁用 |
| 项目设置 | 项目名、蓝图调度模式和其他项目设置 |
| 角色与数据 | 角色、场景、变量与变量分组、数据集合 |
| 多语言 | 语言的增删、译文和翻译选项 |
| 界面与个性化 | 可视化界面、默认游戏壳和个性化各页 |
| 素材 | 图片、音频、视频、字体，以及素材打包策略 |
| 扩展 | 加入项目的扩展及其设置，其他成员不用去工坊安装 |
| 构建设置 | 构建方案和各平台设置 |
- 项目历史快照；
- Git 版本记录和仓库连接；
- 构建产物、运行日志、本机界面布局和缓存；
- Studio 内置扩展；
- 以点开头的隐藏文件，以及素材和扩展目录以外的非 JSON 文件。
素材与扩展的传输
素材和扩展包在后台自动传输，左下角成员小窗的标题行和协作窗口都会显示进度，传输失败时稍后自动再试。其他成员删掉的素材会移进你电脑的废纸篓或回收站。 需要留意的提示：| 提示 | 含义 |
|---|---|
| N 个文件在等某某上传 | 添加这些素材的成员还没传完，例如对方已经下线 |
| 文件过大，无法同步 | 文件超过单个文件上限，没有同步给其他成员 |
| 协作空间已满 | 存储空间已用完，新的素材和扩展暂时无法同步 |
| 部分素材暂不同步 | 文件名在其他系统上无法使用（含特殊字符、以点或空格结尾等），改名后自动同步 |
| 部分素材没有覆盖本机文件 | 其他成员的素材和本机同名文件内容不同，Studio 保留了本机文件，挪开本机文件后自动下载 |
同章按句轮流写
别人正在写的句子带有成员色描边和「某某 正在编辑」标签，暂时不能改，右侧检查器也只读；这一章的其他句子照常编辑。 这一句的右键菜单只保留不会改动它的项目，例如复制、在上方或下方插入、查看协作修改记录。什么时候放开
切换章节或片段、离开剧本模块、编辑器失去焦点、关闭工程、断线，或 45 秒没有任何操作时，正在写的句子自动放开。 也可以手动放开：- 放开：在协作窗口的成员列表里，自己那一行有「放开」，列表下方有「放开我占用的内容」。
- 请 TA 放开：所有者可以在别人那一行点击「请 TA 放开」并确认，对方正在写的内容立即放开，对方会收到提示。
批量操作
查找替换、变量改名、Excel 导入这类一次改很多句的操作会跳过别人正在写的句子，其余照常修改，并提示「N 句正在被其他成员编辑，已跳过」。等对方离开后，再操作一次即可。界面编辑器里的协作
个性化里的工程界面、扩展界面、对话框样式和段落样式，同一时间只有一个人能改。在编辑区动手时这份界面由你占用，只是打开、预览不算。- 别人正在改：整个编辑区只能查看，顶部显示「某某正在编辑这个界面，你现在只能查看」；还原、恢复预设原样、改名和删除也会置灰。
- 自动放开：切到别的界面、离开个性化、关掉编辑器或 45 秒没有操作时自动放开。
- 请 TA 放开：所有者可以在横幅上或协作窗口的成员行点击「请 TA 放开」。
查看成员在做什么
左下角成员小窗
剧本、资产和发布游戏模块的侧栏底部有成员小窗，列出每位成员的头像、名字和一句话状态，例如：正在编辑「第一章」第 12 行、在看「第二章」、暂时离开（3 分钟没有操作）。 点击小窗打开协作窗口，再点一次关闭。成员较多时，拖动小窗顶边可以调高，双击拖动条恢复自动高度。顶栏成员条
顶栏显示连接状态和在线成员头像。鼠标移到上面可以看到每位成员的状态，点击打开协作窗口。故事树
章节行尾显示正在这一章的成员头像。鼠标移到头像上，可以看到对方是正在编辑还是也在本章。协作动态面板
协作窗口可以拖动和调整大小，按 Esc 或点击关闭按钮收起。
展开改了哪几行
其他成员更新章节时，这条动态上会显示「改了 N 行」。点击展开，可以看到每一行的行号、类型（新增、修改、删除、移动）和改前改后的内容，点击其中一行会跳到剧本里的这一句。分离到独立窗口
点击标题栏的「分离到独立窗口」，可以把协作窗口放到另一块屏幕，点击动态可以查看事件详情。点击「合并回 Studio」收回。 邀请码和「停止协作」只显示在主窗口的协作窗口里。查看某一句的修改记录
协作开启时，在剧本里右键某一句，选择「查看协作修改记录」，可以看到这一句在协作中的历次修改：修改人、类型、时间和改前改后的内容。 记录只能查看，不能从这里恢复，保留 90 天。两人改到同一处
修改自动合并，不会弹出「保留哪一边」的选择。下面几种情况需要留意：| 情况 | 结果 |
|---|---|
| 同时改同一个字段 | 以后到的为准 |
| 改了别人正在写的句子 | 修改不生效，恢复为对方的内容，并提示「有一处修改没有生效」 |
| 断线期间改到同一处 | 以云端为准，本机修改存进项目历史，并提示「离线期间的修改已合并」 |
| 第一次加入 | 剧本和设置以云端为准，本机版本先存进项目历史；素材和扩展两边都保留 |
| 两人同时新建同名的角色、变量或场景 | 两边都保留，并提示「检测到同名的角色「某某」」。建议改名区分，否则剧本按名字引用时可能对不上 |
断线与同步状态
断线期间可以照常编辑，修改先保存在本机，连上后自动同步。章节第一次与成员对齐时会短暂只读，显示「正在与成员对齐内容，马上就好…」。 协作窗口头部、左下角小窗和顶栏成员条都会显示当前状态：| 显示 | 含义和处理 |
|---|---|
| 已连接、正在同步…、连接中…、连接不稳定 | 不用处理 |
| 已断开 | 检查网络，修改会在连上后自动同步 |
| 未同步，正在自动重试 | 一般不用处理，也可以在协作窗口点击「重试」立即再试 |
| 内容过大，无法同步 | 某份内容超过大小上限，修改只保存在本机，删减这份内容后自动再试 |
协作已断开
遇到下面几种情况时协作会停止，并提示「协作已断开」：| 提示 | 处理 |
|---|---|
| 协作服务已升级，请更新 LetsGal Studio 后再协作 | 更新 Studio，打开工程后自动续上协作 |
| 登录状态已失效，请重新登录后再开启协作 | 重新登录后再次打开工程，或在「实时协作…」中继续协作 |
| 你不是该协作项目的成员 | 向所有者索取邀请码，重新加入 |
协作中恢复历史或备份
- 项目历史：恢复快照前会先确认「这次回退会同步给全体成员」。点击「恢复并同步」后，其他成员那边的对应内容也一起回退。详见项目历史。
- 时光机备份：协作中不能从备份恢复，「恢复」按钮会置灰。整份回退会同步给全组，备份里没有的素材在其他成员那边也会被移进废纸篓。需要时先停止协作再恢复。详见时光机备份。
AI 助手写入
通过 MCP 连接的 AI 助手，写入内容同样会自动同步给其他成员，并遵守协作规则：- 改到别人正在写的句子或正在编辑的界面时，这次写入会被拒绝，等对方离开后重试。
- 不能新建、改名、移动或删除章节和目录，请在 Studio 中操作，或先停止协作。
- 不能恢复项目历史，也不能直接编辑工程文件。
停止协作
在主窗口的协作窗口左下方点击「停止协作」并确认。本机不再与协作项目同步，其他成员不受影响。 停止前建议确认状态行没有「未同步」提示，也没有还在上传的文件。没来得及送出的修改会在下次继续协作时自动合并。常见问题
为什么改不了章节名、删不了章节？
有其他成员正在写这一章时，故事树里这一章的改名、删除和剪切会置灰，并提示是谁在写。等对方离开这一章就能操作；所有者也可以在协作窗口「请 TA 放开」。为什么图片没有出现在其他成员电脑上？
素材会自动同步，大文件需要一点时间，可以在协作窗口查看进度和提示。被云端盖掉的内容还能找回吗？
可以。打开项目历史，找里程碑「加入协作前的本机版本」或对应时间的快照；项目历史关闭或没有跟踪的文件，在工程的.studio/collab-discarded/ 目录。