《美好的周六》开源工程 v1.0.0
一款点击式解谜文游的完整源码,原生 JS 手写,不依赖任何框架。双击 index.html 就能跑,也可以 npm run dev 起本地服务。
【工程结构】
src/data.js 全部文案与数据:6 个房间、12 条线索、6 场开场戏、3 个沉沦检查点、13 道思考题、5 个结局、音频映射表。纯数据,不含逻辑。
src/engine.js 纯逻辑:时段推进、行动计数、线索收集、计分与结局判定。零 DOM,Node 端可以直接 require。
src/ui.js 流程编排与渲染:打字机、立绘框、透明热区、单实例音频播放。
src/index.html 与 src/styles.css 界面骨架与样式。
assets/ 美术与音频(18 张背景、12 张 CG、3 张立绘、8 首 BGM、16 条音效),全部本地文件,零外链。
docs/ 策划案(唯一事实来源)与全量故事文案。
【值得一看的几个做法】
一是三层严格分层:数据、规则、渲染互不越界。改文案只动 data.js,改判定只动 engine.js,改手感只动 ui.js。
二是把判定逻辑做成可离线验证的:engine.js 不碰 DOM,于是可以在 Node 里跑上万次仿真,把每条分支的结局都验一遍,不用靠手点。
三是三套自动化校验,改完必跑:validate.js 查引用完整性、题库结构与防剧透禁词;playthrough.js 跑三条沉沦线、行动边界和 729 种问答组合的判定矩阵;smoke.js 用 jsdom 跑真实 DOM,从开场一路走到结局。
四是交互热区用 1% 透明度的 div:肉眼看不见,但点得到,比拿贴图对位更省事也更准。
五是音频踩过的坑都写进了 AGENTS.md:素材库里标着「按钮点击」的文件,实际上是一段 136 秒的音乐,所以音效一律先按波形裁剪,再做淡入淡出与归一。
【怎么跑】
npm install 装依赖;npm run dev 构建并起本地服务;npm run build 只构建到 dist/;npm run check 三套校验一次跑完。
AGENTS.md 里写清了每一处该改哪里,接手的人或 AI 都能直接上手。
v1.0.0,ISC 协议,随意取用改造。
协议是 协议。
加载中