Studio v0.1.1 · 产品手册
构建与交付 Web 作品
把视觉小说构建为完整 Web 静态目录,使用本机 HTTP 预览核对作品,再通过 HTTP(S) 静态托管交付在线试玩。
Web 发行物是完整静态目录,适合在线试玩和静态托管。先按发行与 Player 总览准备作品、依赖与目标素材。
1. 保存并构建
- 打开“发布”,选择发行目标 Web。
- 填写发行版本,例如
0.1.0,应用版本修改并保存全部。更改作品名称或图标时,在“作品名称、图标与 Windows 身份”应用作品身份,再保存。 - 选择专用输出目录,例如
D:\作品发行\春灯-0.1.0-web。使用新的空目录,或同一作品、同一目标的已有发行目录。 - 点击“检查已保存版本”,处理依赖、素材和字体问题。出现待保存修改时,使用“审阅保存并重新检查”。
- 计划可用后点击“确认构建”。完成后阅读发行回执,并打开回执给出的输出目录。
目录中包含 index.html、preview.mjs、Windows 启动脚本 preview.cmd、作品快照、运行文件、素材和许可。交付时保留完整目录。
2. 在本机预览
准备可运行的 Node.js,在终端运行 node --version 确认命令可用。然后在 Web 输出目录打开终端:
node preview.mjs在 Windows 上也可双击该 Web 目录的 preview.cmd;它使用本机 Node.js 启动服务并打开浏览器。缺少 Node.js 时,启动窗口会显示环境提示。
预览仅监听 127.0.0.1,优先使用 4173 端口;被占用时选择其他可用端口。打开终端打印的 HTTP 地址,查看首页并开始剧情。服务运行期间保留终端窗口;按 Ctrl+C 或关闭窗口停止服务。
浏览器按访问地址保存玩家资料。继续同一进度时使用原地址;变更端口或托管域名时,可先在 Player“设置 → 数据”导出,再在目标地址导入兼容的资料。
3. 托管与交付
把完整目录上传到可提供 HTTP(S) 的静态托管服务,使用托管地址进入 index.html。将该地址发给玩家;收到压缩目录的玩家先完整解压,再运行预览服务。直接以 file:// 打开 index.html 时,页面会指引使用 HTTP 服务。
常见问题
| 情况 | 处理 |
|---|---|
| 找不到 node | 安装 Node.js,重开终端后检查版本 |
| 找不到 preview.mjs | 打开完整 Web 发行目录;收到压缩包时先解压 |
| 仍显示旧剧情 | 在 Studio 应用并保存修改,重新检查、构建,再刷新发行地址 |
| 素材或字体缺失 | 查看回执与目标检查,修复源作品并重新构建完整目录 |