这是一个可以直接拆开看的中小型文字冒险工程。整部作品是一个 index.html,没有框架、没有构建期转译,构建脚本做的事只是把源码和素材复制到 dist。适合想快速看懂「一个能上线的文游到底需要哪些东西」的人。
【技术形态】
原生 HTML + 内联 CSS + 内联 JS,约 2500 行。运行时不加载任何外部脚本、样式或字体,全部素材走本地 assets。
目录结构遵循幻光模板规范:src/index.html 是唯一源码,assets/img 是 29 张图,assets/bgm 是 5 段配乐加版权说明,tools 下是 build / serve / validate 三个零依赖脚本。
【可以学到什么】
一、剧本与状态机的组织方式。
角色表、物证表、碎片表、论据表、结局表都是常量;流程按幕写成 prologue / actOne / hub1 / actTwo / actThree / actFour,每幕的调查项拼成数组交给 renderActions。改台词不需要碰逻辑。
二、打字机对白与自动推进。
seq 队列、逐字输出、点击跳过、自动播放、对话记录,都封装在几百行里。
三、云存档的最小接入。
Store 对象只做三件事:开局 readSave 读回结局收集、名字与草稿;改动时 debounce 后 writeSave;无宿主(本地预览)时退化成内存。没有同步存档,也没有本地存储依赖。
四、音频的自动播放策略处理。
标题曲在加载时即尝试播放,被浏览器拦下就显示提示,并在首次点击或按键时补播;静音开关与 HUD 联动。
五、循环接缝与削波的后期处理。
assets/bgm/配乐版权说明.txt 里记录了每段音频的来源、授权,以及为消除循环静音断口和削波所做的具体处理,可以当作一个音频打磨的实例参考。
六、端到端测试。
根目录的 smoke.test.mjs 用 Playwright 跑四条主线,覆盖 92 项断言:结局标题、指认成功与失败、名字保留、图鉴解锁、静音、自动播放等。改完玩法跑一次就知道有没有踩坏。
【怎么用】
npm install 之后 npm run dev 本地预览,npm run build 出 dist,npm run validate 做结构与素材自检,npm test 跑回归。想改成自己的故事,改 src/index.html 里的常量区和各幕函数即可,构建与测试都不用动。
【说明】
素材(图片与四段外部配乐)仅授权随本作使用,二次创作请替换为自己的素材;标题曲由脚本合成,可自由使用。
协议是 协议。
【工程主体】src/index.html 单文件承载全部作品(约 2500 行,零框架、零外部依赖),配 tools/ 三个零依赖脚本与 92 项 Playwright 回归测试,npm run build 直接出 dist。 【文档】README.md 讲改剧情、换素材、跑测试;AGENTS.md 给 AI 协作者定改动边界;配乐版权说明记录来源、授权与后期处理。 【示例】剧本常量表 + 按幕拆分的流程函数、打字机对白、多选指认判定、云存档接入、音频自动播放处理,均可直接复用;测试内含一条真结局路线的完整操作序列。 【素材范围】29 张图(13 场景 / 3 立绘 / 8 物证 / 4 结局 / 1 封面)、5 段配乐(4 段 Pixabay,1 段原创)。图片与外部音乐仅授权随本作使用,二次创作请替换;原创曲可自由使用。