为 EOT Studio 增加可展开的模型分数时间轴

labels/eot-studio/README.md

@@ -24,6 +24,27 @@ npm run dev
 
 浏览器草稿自动保留，刷新后可恢复。网页保存不覆盖原 XLSX、初稿和录音。初稿转换方法、标签映射与限制见 [转换说明](../EOT标注/韩泰初稿/转换说明.md)，原行号及原结论保留在初稿目录的 `source_rows.json` 中。原表没有时间信息，录音中未收录的开场与其他发言需人工补充。
 
+## 模型 EOT 分数
+
+点击时间轴上方的“模型 EOT 分数”展开对比，默认收起。MaAI（紫色）和 Smart Turn（青色）共用录音的时间刻度、缩放、播放头及判断点参考线。点击或拖动曲线区域定位播放，悬停查看当时已产生的分数；点击空心评分点定位到原标注时刻。顶部显示播放位置最近的有效评分，暂无评分时显示“—”，不将缺失数据当作 0。
+
+- 实线阶梯曲线来自对六通完整录音的真实推理，不是用44个点插值。MaAI每100ms输入一块音频，因流式重采样缓冲，部分评分间隔为200ms；Smart Turn每200ms计算一次，并包含原标注的精确时刻。
+- MaAI使用双声道连续回放、20秒KV缓存，分数为 `1 - p_now[user]`，是接话候选分数，不是校准的EOT概率。Smart Turn沿用原回测的用户声道、过去ASR定位、500ms前置音频、3秒内续说及最多8秒窗口；没有额外的结束信号、VAD停止门槛或超时放行。
+- 空心点保留原44点的独立窗口回测分数。尤其MaAI的连续状态与独立窗口不同，空心点可能不落在连续曲线上。原始44点指标不会被这次时间序列覆盖。
+- 参考阈值只改变虚线位置，不修改人工标签。MaAI可选0.11、0.5、0.8，Smart Turn可选0.5、0.8。保存的分数不会随标注或转写编辑而重新计算。
+- 仅在展开时读取当前项目录音的评分，并核对音频SHA256。更换为本地新录音、音频变化或没有对应推理数据时，不显示旧曲线。切换通话会取消旧请求，避免前一段数据覆盖当前段。
+
+评分数据位于各模型实验目录的 `results/score-timeline.json`。更新数据时，在两个各自的本机uv环境中运行：
+
+```bash
+cd experiments/maai-ch-kyoto
+uv run --locked python export_timeline.py
+cd ../smart-turn-v3.2
+uv run --locked python export_timeline.py
+```
+
+上述命令从项目根目录开始；生成脚本只读取录音及已有回测资料，不改人工标注。时间戳表示该评分输入已收到的时刻，MaAI使用流式重采样并计入其缓冲；Smart Turn先裁取过去音频再重采样，均不读取判断时刻之后的音频。
+
 ## CSV 格式
 
 对话转写 `asr_history.csv`：
@@ -48,6 +69,7 @@ demo,5200,我明天下午,0,high,mid_turn_pause,A
 ## 本地接口
 
 - `GET /api/workspace`：读取工作数据和项目录音列表。工作数据的两份 CSV 都存在时使用它们，否则载入韩泰初稿；初稿不存在时载入示例；已保存 CSV 格式错误时返回错误，不用示例覆盖。
+- `GET /api/model-scores?callId=...&recordingPath=...`：只读固定实验目录的已验证评分，按通话ID和项目录音路径精确匹配，并核对实际音频SHA256。缺少某模型时保留另一模型；未匹配或过期的评分不返回曲线。
 - `POST /api/workspace`：接受 `{ transcripts, annotations }`，校验后保存到固定工作数据目录，并返回 `savedAt`。同一进程的读写按顺序执行；文件锁防止不同进程同时操作，请求完成后释放。若进程在保存中被强制终止，请确认没有其他服务运行，检查残留 `.backup` 文件并恢复同一次保存前的两份 CSV，再移除工作数据目录的 `.workspace.lock`。
 - `GET /api/audio?path=...`：仅提供 `data` 内的 MP3、WAV、M4A、OGG、FLAC 和 WebM 录音，支持 Range 请求和 HEAD，便于跳转播放。路径相对 `data` 目录，不能通过 `..` 或符号链接访问目录之外的文件。