docs: 更新 CLAUDE.md 与 README.md 至当前代码状态

补充 eval.js/grammar 文件说明、三种模式与口诀范围介绍、
/stt 带题目参数的示例、多音色评测的音色全名注意事项

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

README.md

@@ -1,9 +1,14 @@
 # 🦉 乘法口诀大闯关
 
 小学生乘法口诀语音背诵小程序：**自动读题 → 小朋友开口说答案 → 离线语音识别判分**，全程免手。
-支持顺序闯关 / 随机挑战（错题动态加权，练熟自动减少）/ 双人抢答，限时作答、正/负反馈动效音效。
 
-语音识别用 **whisper.cpp 本地离线模型**，不联网、不花钱、不上传任何数据到云端。
+- **🐢 顺序闯关**：按口诀表顺序背，答错重问同题
+- **🎲 随机挑战**：打乱抽题，错题/慢题动态加权多练，练熟自动减少
+- **🆚 双人抢答**：键盘或蓝牙手柄按键抢答（可自定义绑定），抢到者限时开口作答，答对 +5、答错/超时 −2，一局结束加冕冠军
+- **📖 口诀范围**：家长设置里可全局限定「几开头～几开头」（比如只练到 4 的口诀），三种模式共用
+- 界面面向 **PC / Pad**（多邻国风格），麦克风不可用时自动降级为数字键盘
+
+语音识别用 **whisper.cpp 本地离线模型**（按题动态语法约束解码 + 方言发音兼容），不联网、不花钱、不上传任何数据到云端。
 
 ---
 
@@ -11,12 +16,13 @@
 
 ```
 calx/
-├── index.html            # 前端（单页面）
+├── index.html            # 前端（单页面，含全部 UI/逻辑）
 ├── server.js             # 后端（零 npm 依赖，纯 Node）
 ├── start.sh              # 一键启动
-├── bootstrap.sh          # 新机一键部署
-├── grammar/              # whisper 解码语法约束
-└── models/
+├── bootstrap.sh          # 新机一键部署（装依赖 → 补模型 → 启动）
+├── eval.js               # 识别准确率回归评测（开发用，见 CLAUDE.md）
+├── grammar/              # whisper 解码语法约束（静态兜底）
+└── models/               # 识别模型（git 不追踪，bootstrap 自动下载）
     ├── ggml-small.bin    # 中文识别模型（默认，较准，465MB）
     └── ggml-base.bin     # 备用模型（较快，141MB）
 ```