游戏叙事与剧情 / 系统课时
按项目需求导出和验收作品
按项目需求导出和验收作品
最终交付不能只以“作者模式里能运行”为准。这里把 Twine 作品发布为独立 HTML,在脱离编辑器的环境中重新检查内容结构、交互逻辑、资源引用和关键结局,最后用一组可执行的验收条件判断作品是否真的可交付。
学习目标
- 能把完成的 Twine 项目导出为可独立运行的交付物。
- 能在独立环境复测关键路径、资源和异常入口。
- 能用明确的验收清单判断是否达到交付标准。
先冻结本次交付范围
导出前先确认“这次交什么”,否则验收会不断加入临时需求。至少固定作品版本、必测结局、目标浏览器、是否要求离线运行,以及图片、音频等额外资源是否属于交付包。
如果项目有已知限制,例如仅支持桌面浏览器、音频需要用户首次点击后才能播放,也应写进交付说明。已知限制可以被接受,但不能依赖验收人员自己猜。
导出后在独立环境运行
Twine 2 的发布功能会生成一个可在浏览器打开的 HTML 文件。将最终文件保存到独立目录,并建议统一命名为 index.html。若作品引用了本地图片、音频或其他文件,还要按原有相对路径一起复制,不能只交一个 HTML 后再依赖作者电脑上的路径。
不要只双击文件完成验收。用本地 HTTP 服务打开,可以更接近真实部署环境,也更容易发现资源路径问题。假设交付目录是 dist:
python3 -m http.server 8000 --directory dist预期输出会包含监听端口,具体主机地址可能因系统而异:
Serving HTTP on <HOST> port 8000 (http://<HOST>:8000/) ...保持服务运行,再在另一个终端检查首页是否能正常返回:
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8000/预期输出:
200随后在目标浏览器打开 http://127.0.0.1:8000/,从新游戏状态开始验收,而不是沿用编辑器里的调试会话。

分三层完成验收
先验内容结构:开场是否正确、关键 Passage 是否可达、所有必须结局是否存在、非结局页面是否出现死路。再验交互逻辑:条件选项是否按状态显示,变量变化是否符合设计,重新开始或读档后状态是否正确。
最后验运行结果:图片和音频能否加载,外部链接是否正确,浏览器控制台是否出现影响流程的错误,刷新页面后是否仍符合项目设计。若项目声明支持离线运行,还要断网再测一次;任何远程字体、脚本或媒体依赖都会在这一步暴露出来。
| 验收层 | 重点检查 | 通过标准 |
|---|---|---|
| 内容结构 | 入口、关键分支、结局、死路 | 必交付路径全部可达,无意外断路 |
| 交互逻辑 | 条件、变量、重开、存档 | 同一前置状态得到稳定一致结果 |
| 运行环境 | 资源、浏览器、网络依赖 | 目标环境无阻断流程的加载或脚本错误 |
检查真正要交出去的目录
验收对象必须是最终交付包,而不是源项目。可以先列出目录里的文件,确认资源没有遗漏。
find dist -maxdepth 2 -type f -print一种只有单文件作品的预期结果是:
dist/index.html如果作品还有本地媒体,输出中应同时出现对应资源文件。文件名和目录结构取决于你的项目,不要为了让清单“好看”而改名后忘记同步正文中的相对路径。
用可判定条件结束验收
交付前逐项确认:最终版本号已经冻结;所有关键路径和结局重新跑过;异常状态不会卡死;目标浏览器能加载作品;本地资源没有 404;需要离线运行的项目已断网验证;交付目录中只包含本次需要的文件。
当这些条件都能在最终导出物上重复得到相同结果时,作品才算完成验收。源文件“看起来没问题”不是交付标准,最终 HTML 和它实际依赖的资源能否在目标环境稳定运行才是。