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