Mind Gym 技术白皮书
以浏览器原生记忆训练为对象的系统设计案例
Mind Gym 是一个面向开放 Web 的零依赖记忆训练 PWA：没有后端、没有运行时框架、没有账号墙，也没有隐藏的基础设施。这个站点把项目同时当作可玩的产品与可被审视的技术论证来介绍。文档先建立论点，再由试玩版提供证据。
本站目标
资深工程师、严格评审者与贡献者应当可以把页面中的主要结论一路追溯到 app.js、src/game-state.js、src/game-manager.js、src/storage.js、sw.js 等真实文件。
一眼看到的系统杠杆
| 信号 | 为什么重要 | 主要证据 |
|---|---|---|
| 零运行时依赖 | 应用直接以 HTML、CSS 与浏览器原生 JavaScript 交付，源码与运行时行为之间的映射非常直接。 | index.html、app.js、src/*.js |
| 三层状态模型 | Settings、GameState 与 ModeState 把持久偏好、实时协调与专项流程明确拆开。 | src/settings-manager.js、src/game-state.js、src/nback-state.js、src/recall-state.js |
| 关键热点使用深模块 | 复杂度被收束在局部，而不是扩散成一个巨型编排器。 | src/game-manager.js、src/modal-manager.js、src/ui/renderer.js、src/pipeline/win-pipeline.js |
| 离线优先交付 | 首次成功加载之后，即使弱网或离线，短会话依然更可靠。 | sw.js、manifest.webmanifest、src/storage.js |
| 双语文档外壳 | 英文与中文都能完整表达核心架构论点，而不只是翻译菜单。 | docs/en/*、docs/zh/* |
推荐阅读路线
能力版图
| 训练能力 | 训练什么 | 支撑系统 |
|---|---|---|
| 经典配对 | 识别、成对关联、节奏控制 | 核心牌面循环、计分、统计 |
| 倒计时模式 | 有时间预算的高压对局 | 计时器编排、成绩持久化 |
| 每日挑战 | 可重复、可比较的确定性会话 | 日期种子、存储、比对逻辑 |
| N-back | 工作记忆负荷与反应时 | 模式专属状态与训练逻辑 |
| 延迟回忆 | 对局后的识别测试 | RecallState、胜利管道、评分 |
| 长期进展 | 从重复使用中累积价值 | 成就、自适应评级、FSRS 掌握度 |
本白皮书覆盖什么
- 产品意图： 为什么 Mind Gym 被组织成一个严肃的小型系统，而不是一次性的演示页。
- 系统架构： 运行时模块、持久化机制与离线能力如何协作。
- 贡献者杠杆： 从哪里入手、先读什么、怎样验证变更。
- 研究背景： 哪些想法来自认知训练，哪些来自 Web 工程实践。
编辑说明
本站刻意保持高信号风格：尽量减少空泛口号，以真实文件、真实边界与真实约束为主线，避免把简单系统包装成复杂戏法。