Studio v0.1.1
Studio v0.1.1 · 产品手册

作品中心、保存与文件

作品中心、保存与文件:GalCraft Studio 操作与参考。

与已连接客户端共同编辑

在 Studio 的协作入口生成当前作品的连接资料和官方 galcraft-create Skill。原生发现目录分别是 Codex 的 .agents/skills/galcraft-create/、Claude Code 的 .claude/skills/galcraft-create/ 和 DSH 的 .dsh/skills/galcraft-create/;主文件按目标链接分领域参考。更新会保留作者改过的文件,并把官方更新放在相邻的 .galcraft-update 文件,供合并选择。

客户端先发现并明确打开目标作品,再只读确认当前作品及写绑定,随后明确创建或接入当前协作。每次操作携带真实作品和协作身份;只读发现不自动开始或切换协作。重开或切换作品后重新接入,旧任务仍按原身份查询,暂停状态与发送计数保留。已经授权的目标、范围和采用可以继续执行,不重复逐项确认。

作品已应用的工作内容由两端共用,表单尚未应用的输入保留在源工作区。作者只改简介、客户端只改音色时保留双方修改;同字段冲突保留输入和原依据。需要操作“当前选中的按钮”时,作者明确交接该对象及版本,之后改选不改变已交接目标。保存计划列出本次对象和必要联动,未选择的其他修改继续未保存。

文件选择器按素材、工作流/方案、插件/SDK/音色库、备份/资料导入等用途记忆最近成功选择的位置,作为本机个人偏好跨作品复用。取消不改变位置,客户端指定明确路径也不改手动选择位置。

适用版本:当前 Studio 桌面工作台。更新:2026-10-24。返回操作教学。

先分清你手里的文件

手里的内容用它做什么打开入口
含 project.json 的完整作品文件夹继续写剧情、管理素材、修改玩家页面Studio → 作品 → 打开作品文件夹
.galproject 文件从某次完整备份恢复可编辑作品Studio → 作品 → 从备份恢复作品
Web 或 Windows 发行目录运行和交付给玩家按发行物运行说明打开
Player 导出的玩家资料 ZIP搬移存档、阅读偏好与长期进度对应作品的 Player → 设置 → 资料管理

例如,把“我的春灯故事”建在 D:\GalCraftProjects 中,打开作品时选择 D:\GalCraftProjects\我的春灯故事。选择器要的是作品目录本身。备份包通过恢复入口处理,发行物通过 Player 运行;按用途选择入口即可。

作品内容与服务连接分别保存。把作品文件夹或备份交给另一台电脑后,按缺失依赖报告准备精确引擎和插件,再配置那台电脑自己的服务连接。先确认能打开、保存和试玩,再继续修改。

1. 作品中心怎么使用

入口:左栏“作品”,或“文件 → 作品工作台”。Explorer 按最近、全部和固定组织登记作品,中央显示可搜索的卡片或列表。单击作品查看 Inspector 的状态、引擎与管理操作;双击作品或点击 Inspector“打开作品”进入创作。返回作品库保留当前作品,“继续创作”返回创作区。

作品库与中央导航

控件操作和结果
最近打开按最后打开时间查看本机打开过的作品
全部作品按名称查看已登记作品;这里不扫描整个硬盘
已固定只显示你固定过的作品
搜索作品或路径输入名称或目录的一部分;清空恢复列表
卡片/列表图标改变展示密度,作品内容不变
作品名称区域单击查看属性,双击打开;“当前”标识指出当前会话
图钉固定或取消固定;在“已固定”中快速返回
文件夹图标在资源管理器中打开所在目录
复制图标打开该作品,再建立副本;有未保存修改时先处理保存
备份图标打开该作品,再保存完整备份
垃圾桶图标从本机列表移除记录,原目录和作品文件保留;以后可再次打开加入列表

把鼠标停在图标上可读操作名称。目录移动后,条目显示“目录已移动或无法访问”,点击“重新定位”选择移动后的原作品目录。不要选择另一个作品顶替它;如果要打开另一个作品,使用顶部“打开作品文件夹”。

列表为空时,先“新建作品”或“打开作品文件夹”。搜索结果为空时,先清除关键词并切回“全部作品”。读取失败时使用“重新读取”,再检查移动盘和文件访问权限。

作品库使用 Studio 顶部文档标签;中央通过“返回作品库”和新建草稿入口往返,保留未完成输入。准备模板和本机引擎时显示准备状态;读取失败后可重新读取,再继续原草稿。

2. 新建与打开

“新建作品”打开中央表单文档。切回作品库再回来保留输入;关闭有修改的表单时默认继续编辑,明确放弃才清除本次输入。填写名称,选择模板,检查画布与已安装引擎版本,再点“选择目录并创建”。目录选择器选择的是父目录;Studio 会在其中创建以作品名命名的子目录。取消目录选择不会创建作品。

字段示例与选择依据
作品名称“我的春灯故事”;名称用于文件夹,避免 \ / : * ? " < > |
空白作品从少量内容开始编写自己的故事
轻量/标准/丰富选择玩家界面功能组合;丰富模板包含更多鉴赏与流程页面
画布尺寸第一次保留默认值;后续素材和坐标按此逻辑画布计算
引擎版本选择本机已安装版本;列表无法读取时修复引擎安装后再创建

完整教学样例单独提供 .galproject。在“从备份恢复”中选择文件和目标目录,再选择“创建独立副本”;核对依赖清单后确认恢复。新建模板中保留基础创作模板。

作品中心和“文件”菜单均提供“打开作品文件夹”:选择包含 project.json 的目录,在原目录编辑原作品并加入最近作品。资源管理器的文件夹图标只查看位置。文件类型与打开方式见下表。

文件类型用途与打开方式
含 project.json 的作品目录在 Studio 打开作品文件夹并编辑
.galproject在作品中心从备份恢复
剧情脚本在作品的源码视图中编辑或导入
素材文件与目录在素材库导入后绑定
Web 发行目录使用 HTTP(S) 或 preview.mjs 运行
玩家资料 ZIP在 Player 设置 → 数据中导入进度与偏好

新建作品的四类起点、画布与引擎

3. 在多个作品之间切换

作品中心保留本机列表,但编辑器同一时刻编辑一个作品。打开第二个作品前,先确定当前工作如何处理。

未保存作品的切换确认

选项结果
审阅保存并切换保存当前作品,再打开目标作品
放弃并切换放弃当前未保存修改,再打开目标作品
取消留在当前作品,保留修改

目标目录无效时,Studio 保留当前作品和未保存内容,并显示错误。不要为了解除提示而删除当前作品的文件。

4. 保存与应用的区别

表单和审阅文档的“应用”先更新作品工作区,方便预览和撤销;“保存全部”才将作品修改写入磁盘。比如应用角色修改、页面拖动、采用 AI 剧本后,都应再次保存。

内容保存位置和范围
剧情、角色、大纲、页面、素材索引、插件依赖当前作品;使用保存当前文档或保存全部
服务连接与密钥个人工作台配置;服务弹窗中的保存立即生效
制作草稿、任务和候选个人制作记录;保存作品不会代替提交任务或采用候选
字号、主题、语言、侧栏尺寸、最近作品与固定记录本机工作台;不作为剧情发行给玩家
玩家存档、阅读偏好、已解锁内容Player 的玩家资料;和 Studio 创作数据不同

“文件 → 保存当前文档”或 Ctrl + S 以当前文档为初选;Ctrl + Shift + S 以全部修改为初选。保存审阅按场景、角色、作品设置等对象列出修改,素材索引中每项素材单独一行。同一对象的字段一起保存,展开“查看修改与文件位置”核对只读差异;勾选要保存的对象,再点击“保存 N 个对象”。

选择会带入引用完整性或同一次关联编辑需要的对象,并显示联动原因。取消必要依赖会一并取消需要它的选择;全不选时不能保存。未选修改继续保留在工作区并显示未保存,后续可继续保存或恢复草稿。长列表可“固定到工作区”继续审阅。

勾选只决定保存范围。未勾选的修改继续保留在工作区;丢弃需要点击“丢弃此项修改”或“丢弃已选择”,再单独确认。丢弃生效后,“保存 N 个对象”只保存剩余勾选的修改;“关闭审阅”保留本次处理结果。全部处理完成后,审阅只提供关闭和撤销丢弃。

每行的“丢弃此项修改”先显示实际影响,确认后立即恢复这些对象的最近保存内容。“撤销丢弃”可恢复本次工作;关闭或取消保存审阅会保留已经执行的丢弃结果。保存计划过期时点击“刷新修改范围”,核对新计划后重试。保存失败时按具体对象和路径修正,工作内容继续保留。

部分保存后,如果仍有未保存修改,切换作品、关闭作品或退出会继续要求处理剩余内容。继续保存、明确丢弃或取消后再离开。

对象保存选择与逐项丢弃

文件冲突与重试

磁盘文件被其他编辑器修改后,保存会打开“处理文件冲突”。展开文件可对比上次保存、工作内容与当前磁盘。选择“保留工作内容”后继续保存;“使用磁盘版本”替换冲突文件的工作内容,其他未保存修改继续保留;“另存副本”把工作内容写入尚不存在的新目录。另存副本后,原作品的工作内容仍可能未保存,可在作品中心打开副本继续创作。磁盘再次变化时,Studio 更新对比并要求重新确认。取消会保留工作内容。

文件被占用或只读导致保存失败时,Studio 保留工作内容和审阅窗口。解除文件占用或恢复写入权限后,使用同一确认按钮重试。

恢复未保存的草稿

异常退出后重新打开作品,Studio 提供“恢复未保存内容”。恢复草稿后,先检查内容,再保存全部;也可明确放弃草稿,继续使用已保存内容。取消会保留草稿,通过编辑区的“处理恢复草稿”继续处理。草稿基线与磁盘冲突时,先选择保留工作内容、使用磁盘版本或另存副本,再继续。

“恢复的输入”单独保留尚未应用到作品的字段,按原编辑对象显示内容。可以返回原编辑器复核,或“保留并关闭”;以后从命令面板搜索“查看保留输入”再次打开。明确放弃时,Studio 只移除这里的保留输入。完整输入与 JSON 位于折叠的技术详情中。正常保存或无关素材版本变化不会反复打开该文档。

保留输入审阅与折叠技术详情

5. 撤销、复制与备份

Ctrl + Z 撤销,Ctrl + Y 或 Ctrl + Shift + Z 重做。文本框有焦点时,快捷键先操作该输入控件;移出输入区后再撤销作品编辑。弹窗中的“取消”只取消当前弹窗尚未应用的修改,已经应用的修改用撤销恢复。

准备大改时,先保存全部,再在作品中心使用“复制作品”或备份图标。复制会在原作品旁建立可继续编辑的新作品副本,并打开副本;备份通过保存对话框输出 .galproject 文件,用于保留当前完整内容。完成后查看成功提示中的路径,确认副本目录或备份文件确实存在。

在作品中心选择“从备份恢复作品”,按以下顺序操作:

  1. 选择 .galproject 备份包、目标父目录和新作品文件夹名称。恢复使用新文件夹,已有目录保留。
  2. 明确选择“保留原作品身份”或“创建独立副本”。保留身份让恢复作品继续关联原作品的玩家资料;独立副本建立新的作品身份,玩家资料与原作品分开。备份包恢复作品内容,玩家存档另行管理。
  3. 点击“准备恢复并检查依赖”,核对目标、身份策略和精确依赖报告。缺少依赖时按报告导入本地精确包目录,再重新检查;服务连接仍属于个人配置,恢复后按需配置。
  4. 检查通过后选择“确认恢复并打开”。Studio恢复并打开可编辑作品;若打开未完成,使用“打开恢复作品”继续。

准备和取消保留原作品;恢复失败保留报告和具体问题。试玩与发布仍需对恢复作品执行各自检查。已有可编辑目录继续使用“打开作品文件夹”;发布页“恢复切换前副本”针对引擎升级历史,见插件与发布。

6. 关闭作品与退出

“文件 → 关闭作品”关闭当前作品并返回作品中心;窗口 X 退出 Studio;打开另一个作品使用切换语义。存在未保存修改时按当前动作显示保存审阅,取消保留窗口、输入与焦点,保存失败时保留当前工作并重试。

7. 文件操作常见问题

现象处理
新文件夹名称冲突换名称或换父目录,再创建;不要覆盖另一个作品
列表移除后不见了文件仍在原目录,用“打开作品文件夹”重新登记
目录已移动用“重新定位”选择同一作品的新目录
返回作品页是否丢修改返回页面保留会话;切换作品或退出才需要处理未保存内容
副本或备份按钮先要求保存输出需要完整已保存内容;保存成功后继续
发布内容仍是旧文本先保存全部,再重新检查已保存版本与构建

8. 关闭当前对象与放弃范围

关闭有修改的文档时,选择“保留修改并关闭”可以稍后返回继续;选择“放弃修改并关闭”会先显示当前对象及必须同行处理的关联修改。作者核对放弃前/后,再确认。Studio 在工作区应用一次可撤销操作,磁盘文件继续保留最近保存内容。

作品设置与启动/主页共用 Project 文档,各入口按自己的字段处理历史和放弃范围。放弃开屏设置会保留独立的作品设置修改。跨文档同组修改和依赖引用会扩大实际范围,审阅清单列出这些关联对象。计划过期或应用失败时,Studio 保留当前工作内容,作者重新审阅后再操作。

完整保存审阅区可以纵向滚动到所有文档和结构化详情;标题、取消与保存按钮保持可达。展开长源码差异或结构值后,可以复制完整内容。

发布文档的关闭审阅按发行配置及作品名称、图标等关联字段列出范围。正文、开屏和其他文档的独立修改保留在各自工作区中。