首次提交:脑晴测 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

104
brain-h5/GAME-DESIGN.md Normal file
View File

@@ -0,0 +1,104 @@
# 脑晴测 H5 游戏设计规范(增强版 v1.1
## 通用测试约束
- 竖屏触控优先;正式测试时不允许横屏布局改变刺激相对关系。
- 每项任务必须先完成一道互动练习,教程和正式测试严格分离,练习行为不进入正式分数。
- 每个有效操作记录:游戏、题号、期望答案、用户答案、正确性、反应时间和时间戳。
- 切换后台时自动暂停计时并要求用户主动恢复;页面刷新、主动退出视为未完整完成。
- 报告只解释本次任务表现,不输出疾病或诊断结论。
## 1. 符号速配(处理速度)
### 规则
- 10 个视觉符号与数字 09 建立随机一一映射。
- 同一次正式测试中映射固定,重新评估时重新随机。
- 屏幕中央每题显示一个目标符号,用户点击其映射数字。
- 连续目标不得与上一题相同。
- 30 题或 60 秒先到即结束。
### 数据
- 正确数、错误数、正确率。
- 每题反应时间、平均反应时间。
- 连续错误、超时、完成题数。
### 评分重点
- 正确率 55%,速度 20%,任务完成度 20%,基础分 5%,错误额外扣分。
- 未完成 30 题时按完成比例扣分,避免“只做少量题但正确率高”获得虚高结果。
## 2. 交替连线(执行功能)
### 规则
- 画布中包含数字 110 和 10 个绿色面积依次增大的扇区圆。
- 每次评估重新随机 20 个目标的位置,并使用预设安全点位避免重叠。
- 正确顺序1 → 最小绿色扇区 → 2 → 第二小绿色扇区,直到 10 → 最大绿色扇区。
- 每次正确选择后绘制连接轨迹,帮助用户确认路径与当前进度。
- 点错不推进当前步骤,并记录错误目标和错误类型。
- 20 个目标或 180 秒先到即结束。
### 数据
- 已完成步骤、总用时、单步停顿时间。
- 数字顺序错误、色块大小错误、规则切换错误。
- 错误发生在任务前段还是后段。
## 3. 方向追踪(注意力)
### 规则
- 每题展示 7 架飞机,只有 1 架保持青色,其余为高区分度干扰颜色。
- 飞机使用唯一长机头、钝尾、后方短翼和尾翼,避免方向歧义。
- 方向仅使用上、右、下、左四个标准 90° 旋转。
- 用户找到青色目标后点击机头方向。
- 每题重新随机青色目标位置和干扰飞机方向,避免用户通过固定位置规律作答。
- 30 题或 60 秒先到即结束3 次错误后提前结束。
### 数据
- 正确率、平均反应时间、剩余容错次数。
- 上下混淆、左右混淆和连续失误。
- 前后半程反应速度变化。
## 4. 购物记忆(工作记忆)
### 第 14 轮:清单回忆
- 清单长度依次为 2、3、4、5 件。
- 每轮从 8 件商品中随机抽取,用户确认记住后隐藏清单。
- 用户从完整货架中多选刚才出现的商品。
- 每轮允许查看一次原清单;查看行为会被记录为辅助使用并进入错误/辅助指标。
- 记录命中、遗漏、误选、辅助查看和回忆时间。
### 独立任务:精确找零
- 正式测试不直接显示应找金额,用户需根据价格与付款金额自行计算。
- 第 1 轮:价格 ¥13付款 ¥20目标找零 ¥7限时 40 秒。
- 第 2 轮:价格 ¥26.5,付款 ¥40目标找零 ¥13.5,限时 45 秒。
- 第 3 轮:价格 ¥41.5,付款 ¥60目标找零 ¥18.5,限时 50 秒。
- 可使用 ¥0.5、¥1、¥2、¥5、¥10、¥20 面额组合。
- 每轮最多尝试 2 次;第一次错误后清空金额并提供一次重试机会。
- 记录每次金额、金额误差、尝试次数和操作时间。
### 结束条件
- 购物记忆完成 3 轮后结束该任务;精确找零完成 3 轮后结束该任务。每轮以各自倒计时为准。
## 分数与报告
- 每个维度输出 2098 分,避免原型阶段制造虚假的绝对满分精度。
- 分数同时考虑正确率、反应速度、任务完成度和错误惩罚。
- 8098状态不错6079状态平稳2059可以提升。
- DeepSeek 根据结构化维度数据生成总结、优势、提升空间和三条建议。
- DeepSeek 超时、配置缺失或返回格式错误时,自动使用本地规则报告。
- 所有措辞限定为本次表现,不使用医疗诊断词汇。
- 报告中的四个维度均可点击展开,并显示对应解释、完成度和建议。
## 后续校准
- 当前分值属于产品 MVP 分档,不是临床常模。
- 后续应按年龄、教育程度、设备类型和真实样本分布建立常模。
- 在常模完成前,报告必须保留“仅供自我了解与能力参考”的说明。