完善韩泰 EOT 标注编辑器并更新标注规范与项目资料

2026-10-09 15:55:46 +08:00
parent 138b08a8e4
commit 0204f1288a
29 changed files with 1340 additions and 1271 deletions
@@ -14,15 +14,15 @@ npm run dev

 ## 使用

-1. 默认聚焦“韩泰机器人抢话”的 6 通录音。左侧数据集选择器可切换到其他目录、标准示例或全部数据，通话数量与标注进度按当前数据集统计。分别导入 ASR 和 EOT CSV，或直接选择项目 `data` 目录中的通话录音开始整理。
-2. 选择通话和录音，在时间轴查看机器人、用户语音段及 EOT 判断标记。播放、拖动时间轴或选择标记定位需要核对的位置。
-3. 编辑 `decision_ms`、当前用户文本、是否可以接话、判断原因、置信度和标注员。音频播放器的时间采用整通录音的媒体时钟。
-4. 对话历史默认只显示 `end_ms <= decision_ms` 的记录。当前段横跨判断位置时，请听音频填写 `user_text_at_decision`；不能按完整转写的字符长度推算前半句。查看后续对话用于仲裁，后续内容不进入该判断位置的模型输入。
-5. 点击“保存到项目”将两份 CSV 写到 `labels/EOT标注/工作数据/`。导出 CSV 会下载当前数据，可交给其他标注员或用于训练和评测。
+1. 默认载入“韩泰机器人抢话”的 6 通录音，以及原 XLSX 转换出的 76 条转写、39 个 EOT 判断点。已有工作数据时优先读取工作数据，初稿保留在 `labels/EOT标注/韩泰初稿/`。
+2. 左右声道分别显示波形，共用时间刻度。机器人、用户转写作为对应轨道上的块显示；点击块在右侧栏编辑说话人、文本和起止时间；拖动左右边界直接调整片段范围。拖动结束作为一次修改，可撤销。查看模式的字段为只读。点击“在播放位置新增”的下拉菜单，选择机器人转写、用户转写或 EOT 判断点。
+3. 点击判断点轨道空白处直接新增 EOT；聚焦该轨道后按 Enter 可在播放位置新增。点击已有标记选择标签，直接拖动判断点轴上的标记调整时间，聚焦标记后可用方向键微调；拖动时吸附转写边界、播放位置和其他判断点，按住 Alt 暂停吸附，松开后作为一次修改可撤销。同一通话的判断点不能重合。放大时间轴便于查看短片段。顶部只保留播放头。播放头在点击或拖动定位时，会吸附附近的转写块边界及 EOT 判断点；按住 Alt 暂停吸附。
+4. 右侧编辑判断时的用户文本、是否可以接话、判断原因、置信度和标注员。标注员可选，不影响处理状态。标签为“可以接话”或“继续等待”就计入已处理，只有空白标签（需要仲裁）算待处理。
+5. 时间轴下方“撤销上一步 / 重做上一步”支持最近 40 步转写、判断点和导入修改，Ctrl+Z 撤销，Ctrl+Y 或 Ctrl+Shift+Z 重做；Mac 也支持 ⌘+Z / ⌘+Shift+Z。在时间轴的块或判断点上聚焦时同样有效，文本输入框内保留原生文字撤销。撤销后作新修改会清空重做记录；刷新页面后历史记录清空，浏览器草稿仍按原规则恢复。
+5. 时间轴显示整段对话，模型输入仍仅使用 `end_ms <= decision_ms` 的完整历史；当前用户表达跨越判断点时需回听填写 `user_text_at_decision`，不按字符比例推算。
+6. 点击“保存到项目”写入 `labels/EOT标注/工作数据/`。切换数据集只改变浏览范围；导出菜单可选当前数据集或全部，项目保存保留全部数据。

-草稿在当前浏览器的本地存储中保存，刷新后可恢复。录音来自项目目录或本次选择的本地文件；本地文件的播放地址不会存入草稿。浏览器草稿与项目 CSV 分开，只有明确点击“保存到项目”才会改写项目中的工作数据。原始示例和 `data` 下的录音不会被修改。
-
-切换数据集只改变浏览范围；导出菜单可选择“当前数据集”或“全部”，项目保存会保留完整数据。韩泰录音旁可展开“原表校对参考”，查看已校对表提取的 39 条原始片段。它们没有起止时间或 EOT 判断时间，因此需回听定位后填写标准转写和标签。原表第 5 列没有表头，提取结果按原值展示；原表结论不会自动转为 EOT 标签。参考数据在 `labels/eot-studio/data/hantai-reference.json` 中，保留源文件、工作表和行号，不会随 CSV 保存被改写。当前工具没有工作 CSV 时，仍载入标准示例供切换查看。
+浏览器草稿自动保留，刷新后可恢复。网页保存不覆盖原 XLSX、初稿和录音。初稿转换方法、标签映射与限制见 [转换说明](../EOT标注/韩泰初稿/转换说明.md)，原行号及原结论保留在初稿目录的 `source_rows.json` 中。原表没有时间信息，录音中未收录的开场与其他发言需人工补充。

 ## CSV 格式

@@ -47,7 +47,7 @@ demo,5200,我明天下午,0,high,mid_turn_pause,A

 ## 本地接口

- `GET /api/workspace`：读取工作数据、项目录音列表和只读 `callReferences` 原表参考。工作数据的两份 CSV 都存在时使用它们，否则载入示例；已保存 CSV 格式错误时返回错误，不用示例覆盖。
+- `GET /api/workspace`：读取工作数据和项目录音列表。工作数据的两份 CSV 都存在时使用它们，否则载入韩泰初稿；初稿不存在时载入示例；已保存 CSV 格式错误时返回错误，不用示例覆盖。
 - `POST /api/workspace`：接受 `{ transcripts, annotations }`，校验后保存到固定工作数据目录，并返回 `savedAt`。同一进程的读写按顺序执行；文件锁防止不同进程同时操作，请求完成后释放。若进程在保存中被强制终止，请确认没有其他服务运行，检查残留 `.backup` 文件并恢复同一次保存前的两份 CSV，再移除工作数据目录的 `.workspace.lock`。
 - `GET /api/audio?path=...`：仅提供 `data` 内的 MP3、WAV、M4A、OGG、FLAC 和 WebM 录音，支持 Range 请求和 HEAD，便于跳转播放。路径相对 `data` 目录，不能通过 `..` 或符号链接访问目录之外的文件。