首次提交:脑晴测 H5 项目

包含前端源码、预构建产物(dist/)、零依赖 Node.js 服务器(server.mjs)、
Cloudflare Worker 版本(worker/)、部署文档(DEPLOY.md)和交接文档。

技术总监可直接 clone 后运行 node server.mjs 启动,无需安装 React 或 build。
DEEPSEEK_API_KEY 通过环境变量注入,未纳入仓库。
This commit is contained in:
MingNian
2026-07-28 10:24:47 +08:00
commit b0fce840a3
152 changed files with 8536 additions and 0 deletions

42
brain-h5/GAME-AUDIT.md Normal file
View File

@@ -0,0 +1,42 @@
# 脑晴测游戏完整性复审
复审日期2026-07-23
复审范围无登录入口、资料页、四项任务、AI 报告、手机竖屏交互。
## 复审结论
初版已具备完整闭环,但存在“能玩、尚未完全产品化”的问题。本轮已完成关键补强,当前版本适合作为免费 H5 内测版;评分仍属于产品分档,不属于医学常模。
## 已发现并修复
1. 教学只有文字:四项任务现均包含必须完成的互动练习,错误时给出纠错提示,练习不计分。
2. 连线任务辨识度不足:改为绿色扇区面积排序,目标位置每次随机且避免重叠,并绘制真实连接轨迹。
3. 注意力场景存在位置规律:青色目标位置和所有干扰方向改为逐题随机。
4. 任务未完成可能出现虚高分:评分加入任务完成度 20% 权重,报告展示完成比例。
5. 购物记忆缺少辅助行为记录:每轮允许查看一次清单并记录辅助使用。
6. 找零一次错误即结束:每轮增加一次纠错机会,第二次后才推进。
7. 切到后台继续计时:改为自动暂停,返回后由用户主动恢复。
8. 报告只能查看处理速度:四个认知维度均可点击展开解释、完成度和建议。
9. 基础资料文案容易让人误认为已有常模:明确说明当前尚未建立医学常模。
10. 可访问性不足:增加中文方向标签、计时器语义、键盘焦点样式和减少动画适配。
## 当前仍需后续数据工作的部分
- 分数阈值需要真实用户样本校准。
- 年龄、教育程度和设备差异目前只用于 AI 解释,不用于医学常模换算。
- 上线前应完成至少 3050 名目标用户的可用性测试,再调整题量、限时和字体尺寸。
- 若未来用于科研或医疗辅助,需要伦理、数据合规和专业量表效度验证。
## 审核证据
- `audit-2026-07-23/01-start.png`
- `audit-2026-07-23/04-symbol.png`
- `audit-2026-07-23/05-trail.png`
- `audit-2026-07-23/06-attention.png`
- `audit-2026-07-23/07-memory.png`
- `audit-2026-07-23/08-report.png`
- `audit-2026-07-23/09-practice.png`
- `audit-2026-07-23/10-trail-improved.png`
- `audit-2026-07-23/11-report-improved.png`
final result: passed for H5 internal testing