# 寻找遗失的记忆 · 开源工程说明
> 记忆会迷路,但爱认得回家的路。
《寻找遗失的记忆》是一款纯静态、离线可玩的中文文字冒险解谜游戏。故事里,一位失忆的老人在黄昏回到儿时的老屋,在院门、堂屋、厨房、卧室、小屋、书房与阁楼之间,一点点拾回被遗忘的时光。集齐 18 枚记忆碎片后,登上阁楼推开天窗,所有的回忆终将回家。
## 它适合谁来学
- 想做文字冒险 / 视觉小说、又不想被引擎绑架的创作者
- 想了解零框架、零依赖前端工程怎么组织的同学
- 想拿一套「场景 + 热点 + 选项分支 + 存档」数据驱动架构当模板的人
## 技术亮点
- 零框架、零 npm 依赖:构建只用 Node 原生模块,运行时就是一份 HTML + JS + CSS
- 数据驱动剧本:剧情 / 场景 / 角色 / 物品 / 热点集中在 `src/js/data.js`,用 N / D / F / ITEM / FLAG 辅助函数描述
- 步骤播放器:场景与热点返回步骤数组,引擎按序执行(旁白 / 对白 / 分支 / 切图 / 碎片 / 密码锁……)
- 程序化音频:BGM 与音效全部用 Web Audio 合成,不依赖外部音频文件
- 资源全本地化:所有图片音频均工程内自包含,无任何 CDN 外链
## 怎么跑起来
```
npm run dev # 本地开发预览(默认 http://localhost:5173/)
npm run build # 构建正式版到 dist/
npm run validate # 数据一致性校验(改 data.js 后建议必跑)
```
直接用浏览器打开 `dist/index.html` 即可离线游玩。
## 目录结构
- `src/` 源代码(index.html、css/style.css、js/audio.js、js/data.js、js/engine.js)
- `assets/` 资源目录(bg 背景 / cg 过场 / ch 立绘 / ch_backup 备份 / promo 宣传)
- `tools/` 构建与校验脚本(build.js、dev.js、validate_data.js、smoke.js)
## 许可
个人创作项目,代码仅供交流学习;美术资源请尊重原作者,勿商用。
协议是 协议。
加载中