发布游戏模块用于生成可独立运行的游戏程序。
发布游戏界面

​
界面布局

发布游戏页面分为左右两栏：
  • 左栏：打包配置，设置游戏名称、版本号、图标等信息
  • 右栏：执行面板，显示打包进度、日志和最终产物
左侧导航有两个入口：「发布游戏」进入打包配置页，「历史」查看过去的打包记录。

​
目标平台

目前支持以下平台：
平台状态说明
桌面端可用支持 macOS、Windows
Web规划中打包为网页版，可部署到服务器
移动端规划中Android / iOS

​
打包配置

打包配置包括：
  • 游戏名称（必填）：游戏的显示名称，会出现在应用标题栏和系统中
  • 版本号（必填）：语义化版本号，如 1.0.0
  • 游戏图标（可选）：替换默认的应用图标

​
打包流程

点击「开始打包」后，Studio 会按顺序执行以下阶段：
1

预检

检查项目目录结构是否完整，验证配置信息是否有效，并扫描所有素材引用是否都能找到对应文件。
2

准备

清理上一次的打包输出目录。
3

序列化

读取章节与素材引用，重写素材路径，并生成章节文件和元数据。
4

素材策略

根据素材的引用情况决定哪些素材需要打包、哪些可以排除。
5

复制素材

将被引用或设置为强制打包的素材复制到输出目录。
6

生成清单

生成游戏的资源清单文件，记录章节列表、元数据引用和素材索引。
7

打包运行时

将引擎运行时与项目内容组合，生成目标平台的程序。
打包过程中，右栏会实时显示当前阶段的进度和日志输出。你可以随时取消打包。

​
缺失素材会中断打包

如果项目引用的素材文件不存在，打包会中断并显示缺失引用。 报错信息会列出每一条缺失的引用，精确到它在哪里被用到，例如： 
以下资源被引用但文件不存在，无法构建：
   · 剧本 · 序章 · Sound(SE) → se/医院.mp3
   · 角色 · 小美 · 立绘 → characters/xiaomi/sad.png

请重新导入这些资源，或删除剧本里对它们的引用后再打包。
重新导入素材、恢复原路径或删除对应引用后，再次打包。也可以在资源总览中提前检查缺失引用。

​
打包完成

打包成功后，执行面板会显示：
  • 产物统计：打包耗时、文件数量、总体积
  • 产物列表：所有输出文件的路径和大小
  • 本地试玩：点击「本地试玩 Web」按钮可以立即在浏览器中预览打包后的游戏效果

​
桌面端产物

  • macOS：生成 .app 应用包，游戏名和图标会自动替换
  • Windows：生成 .exe 可执行文件和相关资源
产物默认输出到项目目录下的 dist/desktop 或 dist/web 文件夹。

​
游戏运行窗口

画布分辨率、窗口标题、全屏权限和启动模式在个性化 › 画布与窗口中配置。打包前请检查这些设置。

​
打包历史

「历史」页面记录了最近 20 次打包的结果，包括：
  • 打包时间
  • 目标平台
  • 耗时
  • 成功 / 失败状态
  • 产物信息
历史记录可以按状态和平台筛选。
打包前运行完整流程，并检查场景、角色、音频和分支。