GalCraft Studio 操作教学
从春灯教学副本开始使用 GalCraft Studio,学习修改对白、编排演出、管理素材与玩家页面,保存、试玩并构建独立视觉小说。
开始使用
安装与启动 · 第一个作品 · 基本操作 · Agent/MCP · 示例教程 · 常见问题与排错
适用版本:Studio 桌面与本机浏览器工作台。最后更新:2026-10-27。
这份教学以《今晚,让春天亮起来》为参照。你可以先在线试玩;取得教学备份后,恢复独立作品副本,再改一句对白、换背景、调整界面,最后输出一个可以独立运行的作品。
第一次练习的目标很具体:在示例中改一句旁白,保存并试玩,再运行一份 Web 发行物。完成后,你会得到一个包含 project.json 的可编辑作品目录,以及另一个可以通过浏览器运行的发行目录。它是一条可选学习路线;已有内容时可以直接进入相关操作。
| 你的起点 | 直接完成的目标 |
|---|---|
| 已有剧本,缺少素材 | 保留正文,按制作分册补素材及演出 |
| 已有图片或录音 | 在素材页导入,再绑定到目标角色、语句或页面 |
| 已有提示词和服务连接 | 直接制作;方案及文字整理可选 |
| 只改头像、音色或某个页面 | 只编辑该对象和必要关联,保留其他内容 |
| Studio 中已有制作 | 接续原草稿、任务或候选,保留远端身份与发送次数 |
| 分享整套 UI 或发行 | 导出完整模板,或按发行目标构建指定保存快照 |
已连接 AI 客户端的官方 galcraft-create Skill 使用相同操作和版本校验。已有授权覆盖时,客户端连续完成所需准备、提交、等待及采用/绑定;候选完成、已采用、已绑定和已保存分别报告。下方完整教学包含主动练习这些功能的步骤。
先读本页完成一次练习,需要了解字段、弹窗、取消和保存范围时打开对应分册:
| 我现在要做什么 | 详细帮助 |
|---|---|
| 打开最近作品、切换、复制、备份与保存 | 作品中心、保存与文件 |
| 管理全局角色、写对白、配置演出头像与试玩 | 剧情、角色与演出操作 |
| 配置服务、单步生成、多轮讨论、管理上下文和预设 | AI 制作、服务连接与多轮创作 |
| 导入和去背、选择素材、调整阅读区与页面 | 素材与玩家页面设计 |
| 安装插件、发布、引擎切换、存读档与阅读 | 插件、发行与 Player 阅读 |
| 按外观找到页面、弹窗和按钮 | 页面与弹窗图册 |
“帮助 → 操作教学”通过默认浏览器打开匹配版本的在线手册。中文 Studio 打开中文,英文和日文 Studio 直接打开英文。使用分组目录和当前语言搜索查找操作;应用内继续提供键盘速查、字段说明和操作恢复。截图保留实际捕获语言与来源。
开始之前:启动 Studio
使用已取得的桌面程序
如果维护者已经提供打包后的 Windows 程序,保留完整的 win-unpacked 文件夹,双击其中的 GalCraft Studio.exe。也可以在该文件夹打开 PowerShell 后运行:
& '.\GalCraft Studio.exe'程序打开后应看到作品中心。这个桌面程序可以直接运行,无需 Node.js 或 pnpm。移动程序时一起移动整个文件夹,素材与运行依赖也在其中。
从源码启动
按源码开发准备 Node.js、pnpm 和依赖,再构建并启动桌面宿主。源码修改后停止旧服务,再重新构建。
使用同一本机服务的浏览器入口
按安装与启动准备 Node.js 22.12.0 或更高版本(推荐 Node.js 24 LTS 最新补丁),安装维护者提供的本地 npm 应用包后,运行:
galcraft-studio
galcraft-studio status
galcraft-studio stop第一条命令复用或启动本机服务并打开浏览器。桌面、浏览器与 MCP 使用同一当前作品和领域服务;切换作品会同步到其他界面。关闭窗口或标签后,服务和任务继续运行。工作台的服务入口显示实际地址,并提供明确的停止操作;stop 或前台 serve 的 Ctrl+C 执行停止。
服务持续保留未应用字段草稿,重开界面可恢复;“保存作品”仍由正常保存审阅提交到磁盘。恢复稿版本与当前文档不同时,按提示复核内容再应用。浏览器的文件选择器浏览的是本机服务所在电脑的目录。
源码用户完成 desktop:prepare 后,可用 pnpm --filter @galcraft/studio web:start 打开浏览器入口。捕获、布局测量或媒体验证缺少 Chromium 时,运行 galcraft-studio prepare-browser;源码用户使用 node apps/studio/service/cli.mjs prepare-browser。已有兼容运行时会复用,工具缓存独立于作品。
1. 创建你的第一个作品
- 先从示例页在线试玩,并从 GitHub Release 下载
galcraft-tutorial-0.1.1.galproject和中英 readme.txt。作者也可以按基本操作从“标准”模板新建练习作品。 - 打开 Studio,在“作品”选择“从备份恢复”,选择该
.galproject。 - 指定独立的作品目录,例如“我的春灯故事”,选择“创建独立副本”。副本使用新的作品身份。
- 点击“准备恢复并检查依赖”。若缺少精确引擎或插件,按清单补齐对应版本后继续。
- 确认恢复,打开恢复出的作品。该短篇包含 1 位无声玩家主角与 3 位路线角色、18 张透明立绘差分、39句日语成品配音、9 个场景、3 条路线及各自的普通后日谈,还有背景、CG、BGM及四支可编辑Motion Canvas影片。中文正文保留。
- 在“创作”查看“街道 · 春灯的最后一晚”“店前 · 把星星挂起来”、个人路线和“春灯 · 今晚的银幕”;素材页可查看已采用的背景、人物、声音、影片、动画与作品图标。
故事讲述即将关闭的春灯放映馆:你以玩家主角身份与澜汐、绮白、绯书完成旧街最后一场露天放映。首次开始时先在 OP 前确认姓名,默认“玩家”,上限8个可见字符。未通关时从头开始沿用当前正篇姓名;任一路线完成结尾、ED并终止正篇后,再次开始会重新询名。三位路线角色各保留13句日语成品配音,玩家对白和第一人称旁白保持无声。通关后,从标题页角色目录进入对应普通后日谈,新开后日谈继承当前正篇姓名。剧情流程包含七个节点,其中三个独立回想使用当前姓名及作者初值;返回时恢复来源剧情。
五首 BGM 各约 89~92 秒,保留精确 0.1.0 编曲插件的可编辑作者源;四段影片为 H.264、1920×1080、30fps、18.5 秒。素材使用条件见媒体来源与许可。
从头创作时选择“新建作品”,填写作品名称、父目录、画布和已安装引擎,再选轻量、标准、丰富或空白模板。模板决定玩家界面的功能组合;丰富模板的关系页与HUD使用核心变量。教学备份包含完整剧情和自己的丰富模板实例。
打开已有作品时,从作品中心或“文件”菜单点击“打开作品文件夹”,选择包含 project.json 的作品目录。复制或备份作品时保留完整目录,剧情、界面和素材之间存在引用关系。
2. 认识工作台并完成第一次修改
左边的主导航分为作品、创作、素材、制作、页面、插件、发布。顶部菜单负责保存、编辑、视图和帮助;右上角可切换语言与明暗主题。左上角按钮可以收起主导航。
工作台左侧对象树组织章节、场景、页面、素材和扩展文档;中央标签保存打开的对象,右侧检查器显示当前对象的属性。单击打开预览标签,双击或 Enter 固定标签,开始编辑也会固定。F2 修改对象名称,Esc 取消命名。问题、输出和调试位于中央文档下方;左右栏保持自己的滚动区域。“聚焦编辑”暂时收起辅助区域,退出后回到原布局和编辑位置。
作品库单击查看 Inspector,双击打开作品。素材库单击查看 Inspector,F2 或双击名称进入改名;版本和预览也在 Inspector 操作。制作、插件和发布的 Explorer 随业务对象组织内容,Inspector 保留所选对象的参数和操作。没有底栏内容的页面把高度留给中央工作区。顶部标签过多时,在标签栏滚轮横向浏览;拖动标签调整顺序,拖至边缘继续滚动,Esc 取消拖动。方向键和 Home/End 移动焦点,Enter 打开。右键标签可关闭其他或右侧文档,有未应用输入时会逐项确认。Ctrl + P 搜索对象,Ctrl + Shift + P 搜索命令,Esc 返回原输入位置。搜索在顶部展开紧凑列表,背景保持可操作;点击背景关闭搜索并继续操作。蓝色亮色与暮色主题用不同底色区分活动栏、Explorer、中央编辑器和 Inspector。

- 在“创作”左栏选择“街道 · 春灯的最后一晚”。
- 中间的卡片按执行顺序排列:背景、音乐、立绘、旁白、角色对白、选择分支。
- 点击旁白卡片。在右栏“属性”中找到“正文”,把句子改成“灯还亮着,我们的故事刚刚开始。”。
- 把焦点移出输入框,等待卡片内容更新。顶部会显示未保存状态。
- 右栏顶部“当前指令舞台”会准备该位置的背景与立绘,并显示该句内容。预览静音,不会自动推进剧情。
- 点击“保存全部”,或按 Ctrl + Shift + S。检查底部状态变为已保存。
**完成检查:**卡片和舞台都应显示新旁白。接着按第 4 节从这句开始试玩,确认 Player 显示同一句话。练习结束后关闭并重新打开作品,再检查文字仍然存在;这一步确认你保存了作品内容。
对象树中的“作品设置”打开持续文档,玩家自动存档开关会影响作品。“启动与主页”配置开屏和主页媒体;它与页面区的同名入口修改同一份作品配置。“工作台偏好”只调整你自己的编辑体验:字号、字体、换行以及左右栏和问题栏尺寸。每条滑杆都显示名称和像素值;可以恢复默认值。
“角色与路线”管理全局的玩家视角角色、有个人路线和结局的主角色、配角;分类用于整个作品。先分类玩家视角角色,再打开中央“作品设置”文档,选择对应角色、姓名变量、默认姓名和姓名方式。固定姓名时 Player 使用作者默认名;允许改名时,上限为1~100的整数,姓名至少包含一个非空字符。作者可选“每次新游戏确认”或“首次及正篇结束后确认”,既有作品缺省采用前者。需要询名时,Player 在首条剧情指令前预填作者默认名;空白或超长输入会显示修正提示,取消返回标题。继续与读取正篇存档会切换当前正篇姓名及完成状态;新开后日谈或独立回想使用当前姓名,读取后日谈旧档恢复该档姓名,退出后保留外层正篇上下文。没有配置主角姓名的作品继续使用角色原名;普通文字输入指令仍可独立使用。
你可以拖动创作区左右分隔线调整侧栏宽度,拖动问题栏上方分隔线调整高度。问题栏为空时也能调整。窗口较窄时,侧栏可能通过按钮展开;恢复默认布局在顶部“视图”菜单。

3. 三种创作视图
演出:按舞台与分支编排
卡片适合排列对白与演出指令。选中一条卡片后,右栏显示它的参数;“更多属性”展开不常用参数。带“必填”的字段需要提供有效值。输入框内说明会标注用途、单位、默认值或示例,随 Studio 语言切换;输入值后仍可通过字段帮助查看。
添加一条对白:点击“插入对白”,在当前位置的行内输入区填写正文并确认,Ctrl + Enter 提交。添加其他指令:点击“添加指令”,从可搜索列表选择种类,再在右侧 Inspector 填写参数并应用。例如背景指令需要选素材;新增立绘的舞台对象标识由系统生成,作者选择角色和素材;分支指令需要选项文字与目标场景。缺少必填项时,字段旁显示具体提示,未完成的插入不会写入脚本。
鼠标可从卡片左侧手柄、正文或缩略图拖动调整顺序;聚焦手柄后也可用 Alt + 上/下移动。触摸操作从手柄长按开始。Ctrl 点击可以选择多条指令。复制、移动到其他场景、删除等操作作用于所选指令,请先看清选中范围。
新立绘默认采用常见的上半身构图。右栏“立绘取景”提供上半身、远景、中景、近景和全身,点击后立即预览;还可展开更多属性微调缩放和偏移。时长、音量等参数提供常用数值快捷键。卡片缩略图显示完整素材,舞台按所选构图显示,两者用途不同。

写作:连续修改文本
点击中间“写作”。对白以“角色+正文”的紧凑行连续排列,背景、音乐等演出只占一条短标记;选中后在属性栏调整细节。选择对应说话者;旁白不绑定角色。Ctrl + Enter 可新增下一句。完成输入后移出焦点,再保存作品。
“批量粘贴”打开中央文档,在同一页输入原文、映射说话者、编辑拆分结果和合并行,再一次应用。切到其他文档保留输入;新角色与对白一起应用、一起撤销。未映射的说话者不要直接当成角色标识。
源码:编辑精确参数
点击“源码”可以查看和编辑当前场景的 .gal 指令。每条指令尾部的 @… 是稳定标识,用于引用和定位,不是素材文件名;调整正文时保留它。
脚本存在错误时,下方“问题”列出诊断。点击有来源的诊断定位到相应文本,修复后等待重新编译。卡片与字段视图在原文无效时会限制编辑,防止覆盖原文。右侧舞台标注“上次有效内容”;在问题栏定位并修正当前输入,再重新预览。
第一次使用建议先在卡片表单中生成指令,再查看对应脚本,逐步理解参数。
视觉参数:从常见调整开始

选中背景或立绘,在“更多属性”点击“编辑视觉效果”。面板中的舞台会预览当前调整;“应用”写入一次修改,“取消”放弃本次调整。未填写的可选效果保留原状态,重置开关决定是否先从默认效果开始。
| 参数 | 含义与练习 |
|---|---|
| 水平/垂直位移 | 按作品逻辑画布像素移动;正 X 向右、正 Y 向下。先尝试水平位移 100 |
| 水平/垂直缩放 | 倍率,1 为原样;0.8 缩小到八成,两个方向相同可保留比例 |
| 旋转角度 | 单位为度;0 不旋转 |
| 不透明度 | 0 完全透明,1 完全显示;先尝试 0.5 |
| 模糊 | 0 无模糊,数值增大更模糊;不改变原素材文件 |
| 颜色叠加 | 勾选启用,点色块打开二维拾色面板,可用色相条、HEX 或 R/G/B 调整;每通道 0–255,白色 255/255/255 保持原色。关闭删除整个颜色覆盖,没有加减通道操作 |
| 亮度/对比度/饱和度/伽马 | 1 保持原样;饱和度 0 为灰度,伽马主要改变中间调 |
| 泛光 | 强度大于 0 才有可见效果;阈值控制哪些亮部产生泛光 |
| 倒角 | 不透明度和厚度都需要大于 0;颜色控制边缘着色 |
| 滤镜 | 按名称开启老电影、网点、反射、故障、色差或光线效果,先一次只开一个比较 |
| 叠放顺序 | 数值越大越靠前;同层仍受舞台自身排序规则影响 |
| 过渡时间、入退场时间 | 单位为毫秒;1000 毫秒等于 1 秒,0 表示立即完成 |
| 取景位置 | 0 靠左/上,0.5 居中,1 靠右/下;与像素位移不同 |
在“显示背景/立绘”中设置的是该次显示的初始效果;需要改变已经在场的对象时,使用效果或动画指令并选择已有目标。预览是静音定格;动画、循环音频和跨语句播放仍应通过试玩检查。
名称、标识和版本如何区分
新场景、语句、分支选项等身份由系统生成。普通编辑选择名称、正文和目标;高级标识只读可复制,不需要自己编写 UUID。重命名保留引用,复制一个新对象生成新身份。引用现有场景、素材或舞台对象时从名称列表选择;“按标识指定”只供已知标识的高级操作。
素材名称帮助识别内容;素材版本名称区分同一素材的处理或生成结果;发行版本(例如 1.2.0)标记发布批次;内部修订号负责保存冲突。它们不会替代内部稳定标识。修改名称或版本名称不用同步手改剧情 UUID。
4. 预览、分支与试玩
选中指令即可查看右上角舞台。Studio 按真实条件准备通往目标的路线,唯一可达路线直接显示并标记自动来源;有多条可达路线时才询问必要分支,遇到玩家输入时填写后继续。舞台和试玩共用同一份调试选择。选择了无法到达目标的路线时,重新选择路线,或者选择该路线内的目标指令。
“当前指令舞台”用于检查这个位置的演出状态。音乐、视频播放和完整动态效果用“开始试玩”检查。
- 在练习中选择第一场景的旁白,在“试玩起点”选择“从此句试玩”,点击“开始试玩”。
- 普通情况直接进入剧情;只有目标跨越尚未选择的分支或玩家输入时,才补选到达目标的路线。
- 想从正常开头体验时,选择“从头试玩”;检查单个场景则选择“从当前场景试玩”。
- 点击推进对白,在舞台上的选项中选择与澜汐、绮白或绯书同行。三条路线都会经过共同放映场景,再进入各自的结局。
- 点击“返回编辑位置”回到刚才的场景和语句。
调试检查默认收起,提供暂停、继续、单步和问题记录导出。选择“开始游戏”进行普通试玩;选择“导入试玩记录”重放已导出的路线与输入。调试变量初值只影响这次试玩;正式初始值仍在作品中编辑。
练习一:把澜汐的最后一句台词改成自己的句子,分别试玩三条路线。练习二:把某条立绘指令的站位从中央改到左侧,比较右侧舞台,再撤销一次。

5. 素材:导入、查找、预览与去背
进入“素材”查看练习自带的图片和音乐。用搜索框、类型、目录与排序控件缩小范围。点击素材可以查看详情,图片有缩略图,音频可以试听。点击“预览”后在弹窗中检查;图片默认适应窗口,可切换原始尺寸,放大只影响弹窗内部。关闭音视频预览会停止播放。
导入自己的素材有两种方式:点击“导入素材”选择本机文件,或把文件从资源管理器拖到素材页。导入结果持续显示成功数、失败文件与原因,直到点击“关闭结果”。修正原因后点“重试未导入项”,成功文件无需重复导入,再保存全部。普通本地导入沿用原文件名;已有同名素材需要按导入提示处理。跨页多选时点“查看所选”,在右侧表格核对范围,关闭后保留原筛选与页码。
素材名称是给人看的,例如 春灯_背景_001.png。内部素材与版本仍保留稳定标识,修改名称不会让剧情引用失效。批量命名先查看预览,再应用。删除素材前检查引用,避免删掉正在使用的背景或角色图片。
在创作页选择背景、立绘、音乐等指令的素材字段时,优先从名称列表选择。高级“按标识指定”仅用于明确知道目标标识的情况。
本机去背
- 在素材页点击“准备本机去背模型”。首次需要下载模型;提示会显示检查、下载、初始化等阶段,有总大小时显示进度百分比。
- 看到“去背模型已准备好”后,选择要处理的图片并进入详情。
- 点击“本机去背”,等待候选结果,检查头发、衣物边缘和透明区域。
- 结果合适再确认采用;不合适可以取消或继续调整。随后保存作品。
先准备模型,再选择图片并执行去背景。失败时按提示检查网络与磁盘空间,再重试。

6. 页面:修改玩家看到的界面
“页面”设计的是玩家的标题、阅读、存档等界面。页面中间使用实际 Player 预览;左栏选择页面与组件,右栏编辑组件属性。
- 进入“页面”,左栏选择标题页。
- 在中间点击作品标题,或在左侧组件树选择
title.workTitle。蓝色边框表示所选组件。 - 拖动组件,观察它实时跟随鼠标;松开后提交一次布局修改。
- 右栏可以进一步调整位置、尺寸、颜色和其他公开属性。锁定组件需要先取消锁定。
- 画布聚焦时,方向键移动 1 像素;Shift + 方向键移动 10 像素。Shift 点击可多选。
- Ctrl + Z 撤销布局修改,Ctrl + Y 重做。点击“保存页面”或“保存全部”保存。
“导航预览”用于点击玩家按钮、切换玩家页面。在此模式下鼠标操作会交给 Player;返回“设计”后再选择和拖动组件。组件拖拽不会在导航预览模式中执行。
设计工具还可以选择普通、悬浮、按下、焦点、禁用状态,检查中文、英文、日文长文本,以及空内容、满存档等样例。设计器使用独立样例预览满存档、解锁等状态。
“设置图片槽”把已导入素材绑定到组件。图片显示方式可选择包含、覆盖、原始尺寸或九宫格;九宫格适合需要拉伸而保持边角的面板。先调布局再补图片,通常更容易检查。
“CSS / SCSS”适合需要精确样式的人:选择页面或组件,编辑作用域内的样式,编译并应用,检查结果,再保存。编译失败时先看错误提示。只读的 JSON 详情以代码块显示,支持高亮、复制、换行与展开。长详情通过上一页/下一页浏览,复制包含全部内容;可编辑 JSON 使用代码编辑器,提供高亮、格式化、缩进与错误位置。
点击“AI 辅助”进入当前页面的制作子视图,顶部“返回页面设计”恢复原页面、选中组件和样式草稿。候选需审阅并应用后才改变界面。
“模板”会改变玩家界面的组成。应用前阅读保留、覆盖、隐藏与依赖清单;剧情和作品身份按方案保留,页面公开属性按你选择的保留项处理。

7. 制作:从草稿到采用候选
“制作”用于生成或整理剧本、图片、声音、界面候选。制作草稿、外部服务请求、候选结果、作品中的已采用内容是不同阶段。生成完成后选择候选,审阅采用计划并应用,再保存作品。
“写剧情”可以改故事、对白和分支;“配演出”锁定这些内容,只补背景、立绘、声音与过渡。“先讨论情节”只产生讨论稿。完成一轮后可在同一任务“继续创作”,选择旧版本、提出新要求并复用资料;也可以只生成一轮后直接审阅采用。详细字段与上下文整理见 AI 制作帮助。
- 先打开“服务连接”,填写服务地址,并按服务需要配置模型和凭据。地址使用完整的 HTTP 或 HTTPS URL。
- 保存连接并运行能力检查,确认服务支持当前用途。
- 新建制作草稿,选择用途,例如背景、立绘、配音或剧本。
- 按表单填写目标场景、角色、语言、提示词、尺寸、数量等。标为必填的字段缺失时会显示字段旁提示;草稿可以先保存,提交前再补全。
- 选择连接与可用创作方案。需要参考素材或上下文时,通过对应控件添加。
- 点击检查请求,阅读将发送的内容与任务项。确认后提交任务。
- 任务完成后比较候选。图片或声音候选下方的“素材名称”默认使用场景、角色、用途和序号,可以在采用前修改,保留原扩展名。
- 选择“仅入素材库”或“绑定到来源场景”,选择要采用的候选,查看采用方案并应用。
- 回到创作或素材页检查结果,最后保存全部。
例如背景候选可能命名为 春灯_背景_001.png,同名时自动使用下一个序号。已有作品的文件和标识不会被批量重命名。临时任务文件可能仍使用内部标识,素材库和新采用文件使用可读名称。
配音需要正文、语言以及服务支持的语音设置;背景音乐需要提示与时长;差分需要参考图片和修改说明。采用创作方案时,一些参数可能由方案提供。以当前表单和请求检查结果为准。
UI 制作或页面辅助还需要选择目标页面范围。生成的页面方案、素材与组合先进入候选或审阅状态,检查作用范围和替换清单后再应用。
先理解保存发生在哪里
| 内容 | 何时出现 | 关闭或删除的含义 |
|---|---|---|
| 新建表单 | 点击“新建制作” | 未改动关闭不留记录;改动后可保存、放弃或继续编辑 |
| 制作草稿 | 点击“保存草稿”或准备发送计划 | 之后编辑自动保存;草稿行可删除,不会发送生成请求 |
| 制作任务 | 审阅发送计划并确认提交 | 才会调用外部服务;运行中先取消,结束后可移除记录 |
| 候选 | 服务返回可审阅结果 | 先比较、修改或重试,再明确采用;移除任务记录保留候选 |
| 作品内容 | 明确采用候选后 | 再保存作品;删除任务记录不删除已经采用的素材或正文 |
一次剧本制作练习
- 在创作页选中“街道 · 春灯的最后一晚”的旁白作为插入位置,再进入制作。也可在制作表单里重新选择目标场景和来源语句。
- 在“服务连接 → 添加服务”先选服务类型,填写易识别的连接名称、完整 API 地址、模型;服务要求密钥时填写。服务类型必须对应实际接口。
- 保存连接并运行连接/能力检查。检查成功说明配置可访问,仍需实际生成才能确认模型返回的内容可用。错误留在相关表单,按提示修正地址、模型或凭据。
- 点击“写剧情”,选择“直接写剧情”和刚才的连接。填写要求,例如:“接在当前旁白后写三句澜汐和玩家视角角色的对话;保持春夜旧街氛围;不要新增场景或角色。”
- 打开上下文表格,勾选需要发送的场景、设定或文本;“查看与编辑全文”用于修改单项内容。搜索、类型与发送状态筛选只改变可见行,已勾选资料仍会发送;核对选择总数和被隐藏的数量。未勾选内容不随这次请求发送。
- 需要暂时离开时点击“保存草稿”。快捷表单先核对“本次发送”的服务、上下文与请求数,再点“生成候选”直接发送;完整制作表单先进入发送计划核对文本、附件、目标、步骤与数量,再确认发送。
- 确认后观察任务状态。排队表示尚未运行;执行中可取消;失败按具体步骤重试,不必重发已经成功的步骤。服务不支持的参数应换服务或明确排除,不能把非空值当作已经生效。
- 候选出现后展开全文,检查语气、角色和目标位置。选择候选,阅读采用计划后应用,再到创作页检查新增内容并保存全部。
画面制作把用途换成背景、立绘或 CG。正向提示词描述主体、环境、构图和风格;负向提示词描述要避免的内容;宽高单位为像素,数量是本次生成候选数。差分必须有参考图和修改要求。配音正文是要朗读的内容,语言是语种代码;语速 1 表示原速。音乐时长单位为秒;选择纯音乐时歌词留空。参数是否可用取决于连接能力,发送计划会列出实际发送值。
从 ComfyUI 导出到可执行工作流

- 在 ComfyUI 中先确保工作流可以正常运行,再导出 API 格式 JSON。普通编辑器 JSON 保存的是节点布局,不能直接作为执行图使用;导入时会说明需要重新导出。
- 进入“服务连接 → ComfyUI 工作流 → 添加工作流”,选择或拖入
.json文件。也可展开“粘贴 JSON”,粘贴后点击“识别并导入”。已配置的 GalCraft 语义绑定会恢复输入、上传与输出映射。 - 填写工作流名称和用途;图像用途继续选背景、立绘、CG 或页面素材。只显示这个用途的工作流供对应制作选择。
- 在节点图或“节点列表”选择节点,检查右侧输入与连线来源。在“输入映射”表中筛选节点和映射状态,把提示词、尺寸、数量、种子绑定到相应字段。“保留原值”继续使用图中的值。节点连线只读;平移和缩放不改变执行图。
- 有参考图片时,把加载图片节点的文件字段绑定参考图片,选 ComfyUI 图片上传接口或共享目录。有参考音频时使用服务端共享目录,填写服务端可读取的绝对路径。
- 在“输出映射”勾选实际产生文件的输出节点。图片通常是 SaveImage 的
images;音频以节点执行历史里的文件列表键为准,可直接修改“输出键”。不要勾选只返回中间张量的节点。 - 检查下方节点依赖和高级 JSON,点击“校验并保存”。校验会检查图、映射和上传配置;服务上还需安装相应节点与模型。缺字段时修正同一弹窗,不要反复新建。
- 在 ComfyUI 连接中使用该工作流,返回制作页完成请求审阅和一次实际生成。生成失败时核对节点名称、模型和输出键;生成成功后仍需审阅候选并采用。
导入与管理创作方案
创作方案导出为 JSON,默认文件名是 recipes.galrecipe.json。文件顶层包含 schemaVersion: 1 与 recipes 数组。文件用途与打开方式见文件类型表。
在制作页的方案管理中点击“导入方案”,文件选择器会列出 JSON 文件,包括上述双后缀文件。选择从 Studio 导出的方案,查看导入计划,再应用。导入失败时检查文件来源与格式,不要只给其他文件改后缀。
官方预设可查看和复制;需要修改时先建立自己的副本,再保存名称与内容。只读提示词按正文自然换行,模板变量突出显示,可用“复制文本”复制完整内容。“保存并使用”会继续填写本轮要求并确认服务,保存预设本身不会发送请求。
8. 插件与发布
“插件”管理扩展包和作品依赖。先查看已安装版本与作品需要的版本;安装、启用、停用或变更时阅读影响清单,应用后检查作品问题栏。春灯教学备份使用引擎 0.1.1,以及精确 0.1.0 丰富模板和编曲插件,缺项按恢复清单补齐;播放已有素材无需生成服务。
发布之前先保存全部,并把创作问题栏中的错误修好。发布使用已保存内容。
- 进入“发布”,选择 Web 或 Windows。
- 填写或选择一个独立的输出目录,不要把作品源目录当作发行目录。
- 检查发行版本,例如
0.1.0。修改版本后先保存,再检查发布。 - 点击“检查已保存版本”,查看依赖、目标能力、素材和字体检查。
- 如果需要旧存档兼容验证,选择代表旧档并检查映射;没有旧档时,界面会说明兼容性尚未验证。
- 检查成功后点“确认构建”,并阅读发行回执和运行说明;改变发行配置后先重新检查。
- 运行发行物测试。Web 版本按说明通过 HTTP 打开;Windows 版本保留完整发行目录。
“高级发布设置”默认收起,摘要显示当前字体、额外素材和旧档数量,展开可调整旧档映射以及特定平台与 Live2D 选项。仅使用图片与音乐的入门练习可以先使用默认选项。“引擎版本与历史”在独立右侧面板管理引擎切换与恢复。
生成发行物和上传到网站是不同操作。Studio 生成本机输出目录;把作品发给别人前,先测试实际输出目录中的程序。
9. 保存、撤销、备份与恢复
标题栏提供“保存全部”,编辑器提供“保存当前”。“当前文档未保存”和舞台附近的“预览:上次有效内容”分别说明保存与预览状态。指令行的更多操作在悬停或键盘聚焦时出现,删除位于菜单末尾的独立组。问题栏首次收起,手动展开后保留你的选择。
Ctrl + S 以当前文档为初选,Ctrl + Shift + S 以全部修改为初选,再在保存审阅按对象选择。联动项显示实际原因;未选内容继续未保存。逐项丢弃确认后立即生效,可用“撤销丢弃”恢复,取消保存审阅保留已执行的丢弃。部分保存后,离开作品仍需处理剩余修改。详见对象保存与丢弃。
Ctrl + Z 撤销,Ctrl + Y 或 Ctrl + Shift + Z 重做。焦点在文本输入框或脚本编辑器中时,快捷键先作用于该输入控件的文字;移出输入区后再撤销作品或页面编辑。弹窗打开时,不会顺带撤销背后的作品。
作品页提供复制与完整备份入口,适合在大规模改写或模板切换前保留一份。在作品中心选择“从备份恢复”,选择 .galproject 和目标目录,再选择“创建独立副本”。点击“准备恢复并检查依赖”,补齐精确依赖后确认恢复。引擎升级的恢复入口位于发布页升级历史,见发行帮助。制作候选等个人工作台数据与作品保存范围不同。
关闭有未保存修改的作品时,选择保存、放弃或取消。异常退出后,按恢复提示检查可恢复工作;不要为了消除提示直接删除内部工作文件。
10. 一次完整练习与常见问题
建议按下面的顺序完成一次练习:创建示例 → 改第一句旁白 → 保存 → 试听音乐 → 更换一条背景引用 → 拖动标题位置 → 撤销再重做 → 试玩两条路线 → 检查发布 → 生成并运行 Web 发行物。
完成后,你应能区分剧情指令、素材、玩家页面和制作候选,并知道哪里检查结果。
| 现象 | 处理方式 |
|---|---|
| 导入方案时找不到文件 | 使用“导入方案”,选择 recipes.galrecipe.json 或其他合法方案 JSON;不要走素材导入。 |
| 去背模型准备成功但图片没变化 | 准备只是安装工具,随后进入图片详情执行“本机去背”。 |
| 页面组件不能移动 | 返回设计模式,选中组件,检查锁定状态;可以从左侧组件树选择。 |
| 舞台提示选择路线 | 目标在分支后面,先选通往目标的真实路线。 |
| 舞台不显示最新内容 | 查看问题栏;修复脚本错误后重新选择指令。 |
| 修改后发布里仍是旧内容 | 发布读取已保存内容,先保存全部,再重新检查。 |
| 鼠标点击 JSON 不可编辑 | 这是只读详情代码块,可复制;回到相应表单或源码入口修改。 |
| Ctrl + Z 只撤销了输入文字 | 当前焦点在输入框中;移出输入区再撤销作品编辑。 |
| 有些控件暂时不可用 | 先打开作品;再检查是否正在执行任务、当前内容是否有效,以及服务是否就绪。 |
更多操作入口在顶部“帮助 → 键盘操作”和“帮助 → 操作教学”。
11. Player 中的阅读与路线
选择肢叠在舞台中上部,背景与立绘保留。点击可用选项继续;键盘焦点跳过禁用选项。右下工具栏提供保存、读取、历史、设置、自动与快进,整组最左侧为固定按钮,锁定只改变显示方式,不推进剧情。读取进度前按确认框核对动作。
同一句中,文字全部显示不会打断配音。第一次点击尚未显示完整的正文只补全文字,再次点击才进入下一句。打开设置或历史时暂停当前阅读和语音,返回后继续。示例中的樱花、雪与雨是“纹理与滤镜”指令产生的运动粒子,可在对应指令里调整密度、速度、方向和大小。

丰富模板的流程图从上向下排列:选择节点可查看状态,使用缩放或适应窗口观察整条路线。未解锁节点显示锁定状态;选择已开放节点后点击确认才进入。右侧缩略图可定位长路线,返回回到上一页面。

阅读面板为正文提供独立默认文字色和背景遮罩,亮暗场景都保持可读。页面设计中的正文组件颜色和作者样式仍可单独覆盖;玩家透明度设置控制阅读背景。

需要让外部助手协作时,阅读外部创作协作。