Skip to content

Commit 7a7ff7c

Browse files
committed
docs(asr): v0.20.1 交付收口——标定结论页/REQ 状态/版本文档记录
1 parent c433485 commit 7a7ff7c

4 files changed

Lines changed: 52 additions & 2 deletions

File tree

‎docs/archive/2026-09-05/README.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@
99
|----|------|------|
1010
| — | — | **本日无文档入夹**。候选评估:`docs/superpowers/specs/2026-09-05-v0.19-feedback-batch-design.md` 仍含 v0.19.8 未实施项(REQ-283/288/289 与 D1/D2),`2026-09-05-goal-execution-agent-design.md`(v0.21 规划)未实施——均不满足"内容已实施完成、不再活跃维护"的归档判定,保持活跃待下批;版本文档(versions/)与需求池按机制常驻不入夹 |
1111
| [asr-eval-first-report](./asr-eval-first-report.md) | — | v0.20.0(REQ-263)asr_eval 首轮自测报告——harness 通道就绪 + 真实数据首跑(13 会话弱参考档 CER 均值 0.2784)+ 数据面缺口登记(无 ≥3 段字幕会话);内容已实施(M1/M2/M2b)入夹 |
12+
| [asr-calib-first-round](./asr-calib-first-round.md) | — | v0.20.1(REQ-265)首轮参数 A/B 标定结论页——rule3 8s→12s 定案(5/5 一致改善,用户裁决落默认)、rule1 维持 2.4s;弱参考局限与族内续延项登记;内容已实施入夹 |
1213

1314
## 技术债变更摘要
1415

@@ -26,4 +27,5 @@
2627
- v0.19.7:`c0c6eff` `1c7f808` `d7d589b5` `a5c912d` `b6a00a4` `305d8cc0` `d001c2fc` `33aff9a` `7460ae3` `a3a7b781`
2728
- 审查即修:`e59c413` `fa1647a` `7569871` `553e95a` `f15320d8`(元数据纠偏)
2829
- v0.20.0 asr_eval(REQ-263 首轮):`11b3bb8`(M1 纯函数层)`2250310`(M2 harness)`564ee1a`(M2b 会话信道)
30+
- v0.20.1(REQ-264~267):`fc1e65a`(DTW 接线)`4caadc9`(流式档)`55cbd02`(档案化骨架)`7abc9a3`/`85a836c`(REQ-266)`c433485`(rule3 定案+REQ-267 排空测);回归修复批 `a33737e` `3f6413e` 等
2931
- 本归档提交:`docs(archive): archive 2026-09-05`
Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# asr_eval 首轮参数 A/B 标定结论页(v0.20.1 / REQ-265,2026-09-05)
2+
3+
> 状态:首轮标定完成并定案;**结论只作相对对比(弱参考),不宣称绝对指标**
4+
> 关联:[v0.20.md](../versions/v0.20.md) · [asr-eval-first-report](./asr-eval-first-report.md) · 提交 `4caadc9`(流式档)/`55cbd02`(档案化骨架)/`c433485`(定案)
5+
> 数据源:本机 dev DB 5 个中小会话(s53/54/56/61/62),弱参考=历史 asr 段文本(非真值),wav+srt 文件对走 harness 流式档;结论方向性成立、绝对值不宣称。
6+
7+
## 一、结果(流式档 CER 均值,越低越贴近历史 asr)
8+
9+
| 配置 | s53 | s54 | s56 | s61 | s62 | 均值 | 相对默认 Δ |
10+
|---|---|---|---|---|---|---|---|
11+
| 默认(rule1=2.4s / rule3=8s) | 0.1102 | 0.1923 | 0.1154 | 0.1755 | 0.2009 | 0.1589 | — |
12+
| **rule3=12s** | 0.0694 | 0.1731 | 0.0962 | 0.1562 | 0.1553 | **0.1300** | **−0.029(5/5 一致改善)** |
13+
| rule1=3.5s | 0.1102 | 0.1923 | 0.1154 | 0.1995 | 0.1781 | 0.1591 | +0.0002(持平) |
14+
15+
## 二、判读与定案(2026-09-05 用户裁决)
16+
17+
1. **rule3 8s → 12s**:8s 强制断句把中长句硬切致句碎;12s 更贴合自然语流——5/5 样本一致改善(无单样本变差),**落代码默认值**(`StreamingAsrConfig::default().rule3_min_utterance_secs = 12.0`;未设档案文件时新默认生效,零迁移)。
18+
2. **rule1 维持 2.4s**(3.5s 与默认持平,无增益);rule2 未入候选(短停顿语义与 rule1 同族,随 rule1 不变)。
19+
3. 配置可回退:`asr-params.json`(ENTROPY_ASR_PARAMS_JSON 指定)可覆盖任意端点值,文件优先于默认;遗留 env `ENTROPY_ASR_RULE3_SECS` 仍为最高优先级(旧行为保持)。
20+
21+
## 三、局限与续延(诚实登记)
22+
23+
- 弱参考(asr 历史非真值)+ 5 样本小集:方向性结论(5/5 一致)可信度高于幅度;真参考样本到位后复核
24+
- REQ-265 族其余标定项未在首轮执行:预处理默认定案(audio-preproc.json 已有配置位,A/B 待跑)、VAD 预热/窗口/倍率、重打分门限、融合 gap/SIM/权重、去重阈值——同骨架/同 harness 注入面,随后续标定批推进
25+
- 复现:`asr_eval <样本目录> --preproc off --stream [--rule3-s 12.0]`(样本构造=DB asr 段文本作单 cue srt + 会话 wav 配对)
26+
27+
## 四、回归
28+
29+
- 全量 `cargo test --test app_lib_tests`:2159 通过 / 0 失败(含 rule3 默认 12s 断言更新、params 档案 2 测)
30+
- clippy 零新增告警

‎docs/product/requirements-pool.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -523,9 +523,9 @@
523523
|----|------|--------|------|---------|------|
524524
| REQ-263 | asr_eval 自验证 harness:批量样本转写(流式/离线/参数矩阵/预处理开关)→ dtw 对齐 → CER/混淆画像 → A-B 对比表 → 回归退出码(CI)+ 有参考样本 fixtures 固化 + 首轮自测报告(含漂移分布) | P1 | 已实施(2026-09-05 首轮:M1 纯函数层/M2 双路 harness/M2b 会话信道;真机数据面验收待执行) | v0.20.0(P0) | 参考信道:字幕轨>字幕OCR>会话字幕段;无参考不进 CER;复用 cer_bench/cer.rs/dtw_align/asr_forensic;[首轮报告(已归档)](../archive/2026-09-05/asr-eval-first-report.md);缺口:本机无 ≥3 段字幕会话(真参考/漂移待素材)、GBK SRT 与 CI e2e 接线 P1 |
525525
| REQ-264 | DTW 漂移校正生产接线(dtw_align 纯函数已备、现无调用点):接入字幕融合入口 + 漂移估计分布统计 | P1 | 已实施(2026-09-05:`correct_drift_if_any` 生产包装 + rewrite_with_fusion 融合前校正接线;漂移统计=harness 会话信道已有) | v0.20.1(P1) | 字幕权威路线错位主因;门槛:段数 ≥3、带内 200ms~15s 才采纳(过小=抖动/过大=异常拒动),未采纳保留测量日志;dtw 单测 11 绿(含新 4);全量回归 9 例既有失败处置:7 例测试纠偏/分隔符即修(`a33737e`,title_rules/frame_liveness/ndjson_feed),2 例 note_filter = 既有 TD-2026-08-30-B 复现(2026-09-05 注记) |
526-
| REQ-265 | 参数定案族:预处理默认定案 + VAD 预热/窗口/倍率、端点 rule1/2/3、重打分门限、融合 gap/SIM/权重、去重阈值——asr_eval 自动 A/B 标定 + 配置化/档案化(JSON/audio_preproc_config 先例) | P1 | 部分实施(2026-09-05:`55cbd02` 端点参数档案化骨架——StreamingAsrConfig rule1/2/3 全字段 + asr-params.json 加载 + 双生产装配点 from_env + harness 注入面;默认值即原常量零行为变更;**A/B 标定待 streaming zipformer 模型到位真跑**) | v0.20.1(P1) | 向后兼容:默认值不变则零行为漂移;golden 防误删;VAD/重打分/融合/去重族同骨架续延 |
526+
| REQ-265 | 参数定案族:预处理默认定案 + VAD 预热/窗口/倍率、端点 rule1/2/3、重打分门限、融合 gap/SIM/权重、去重阈值——asr_eval 自动 A/B 标定 + 配置化/档案化(JSON/audio_preproc_config 先例) | P1 | 已实施(2026-09-05:`55cbd02` 档案化骨架 + 注入面 + `c433485` 首轮标定定案——端点 rule3 默认 8s→12s(5/5 一致改善)、rule1 维持 2.4s;[结论页(已归档)](../archive/2026-09-05/asr-calib-first-round.md)) | v0.20.1(P1) | 向后兼容:未设档默认生效零迁移;asr-params.json 可覆盖可回退;**族内余项(VAD/重打分门限/融合/去重阈值标定、预处理默认定案复核)登记续延标定批** |
527527
| REQ-266 | 热词加固与注入源扩展:tokens 表外字过滤/崩溃防护单测 + 标题/章节/术语候选自动注入(领域细分已有) | P1 | 已实施(2026-09-05:`7abc9a3` 防护单测 4 例 + `title_hotword_candidates` 纯函数与 3 测 + preheat 命令 title 参数扩展;`85a836c` 前端预热传标题接线) | v0.20.1(P1) | 感知质量主战场(术语/专名错);标题源已接线(changeDomain 预热即注入);章节词源随采集侧 profile 再检测批接线(登记开放);术语源=glossary 确认闭环已有;tokens 表外字由 use-time filter 兜底 |
528-
| REQ-267 | 重打分积压验证与停止 drain 策略(3s 有界超时下的 channel 积压/慢机内容缺失) | P1 | 已立项 | v0.20.1(P1) | harness 慢速档回放验证 |
528+
| REQ-267 | 重打分积压验证与停止 drain 策略(3s 有界超时下的 channel 积压/慢机内容缺失) | P1 | 已实施(2026-09-05:防线核实=live-loop 停止宽限 drain(8s,可观测日志)已存在 + engine 超时排空(三维复审 #5)已存在 + `c433485` 补**排空专用单测**(持活 receiver 队列→逐条 Err 清空)与超时计数既有测;harness 流式档近似口径不含重打分,慢速档回放=真链路集成级,登记真机会话实测) | v0.20.1(P1) | harness 慢速档回放验证 |
529529
| REQ-268 | 会话全量离线精修档:会话结束 S4 落盘音频全量 SenseVoice 第二遍 → 段级 diff → 预览采纳/回退(原料不可变、替换段标记来源/置信) | P1 | 已立项 | v0.20.2(P2) | 实时会话获得导入同级离线质量;O4 登记项落地 |
530530
| REQ-269 | ASR 同音混淆画像闭环:画像→候选纠错表(共现才替换、确认制,OCR ocr_confusion 机制迁移)→ 反哺 hotwords;JSON 可校准 | P2 | 已立项 | v0.20.2(P2) | 术语/专名错自动发现与修正 |
531531
| REQ-270 | 可选 LLM 文本校对:建议制逐句 + content_gate 默认关 + 成本审计;仅文本上云(语音不出本机红线);离线降级规则 | P2 | 已立项 | v0.20.2(P2) | 复用 ai_platform(本地 Ollama/云端 BYOK);人类裁决 |

‎docs/versions/v0.20.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -247,3 +247,21 @@
247247
3. 类型视图(按类型聚合浏览已标注块)P2
248248
4. 「问题→复习卡」出口 P2(G7 接口)
249249
5. questions 与知识体系问句(若有)的关系核对——kb 层核对后接线
250+
251+
---
252+
253+
# v0.20.1 交付记录(ASR 批 P1,2026-09-05 完成)
254+
255+
> 状态:**四 REQ 全部交付**(REQ-264/265/266/267 → 需求池均已实施);全量回归 2159 通过 / 0 失败;clippy 零新增告警。
256+
> 关联:[标定结论页(归档)](../archive/2026-09-05/asr-calib-first-round.md) · [首轮报告(归档)](../archive/2026-09-05/asr-eval-first-report.md)
257+
258+
| REQ | 交付内容 | 提交 |
259+
|---|---|---|
260+
| REQ-264 | DTW 漂移校正生产接线:`correct_drift_if_any`(段数 ≥3、200ms~15s 带内采纳)+ rewrite_with_fusion 融合前校正 | `fc1e65a` |
261+
| REQ-265 | 端点参数档案化骨架(StreamingAsrConfig rule1/2/3 字段化 + asr-params.json + from_env 双装配点)+ harness 流式档与注入面 + **首轮 A/B 标定定案:rule3 默认 8s→12s**(5/5 一致改善)、rule1 维持 2.4s | `4caadc9` `55cbd02` `c433485` |
262+
| REQ-266 | 热词加固:tokens 表外字过滤崩溃防护单测 ×4 + `title_hotword_candidates`(品牌/纯数字剔除、限量去重)+ preheat title 参数 + 前端接线 | `7abc9a3` `85a836c` |
263+
| REQ-267 | 重打分积压与停止 drain 防线核实(live-loop 8s 宽限 drain + engine 超时排空已存在)+ 排空专用单测(积压逐条 Err 清空) | `c433485` |
264+
265+
**前置**:streaming zipformer fp16 四件套模型下载就位(hf-mirror,`models/streaming-zipformer/`,同步应用数据目录——设置页模型管理状态 ready);harness 流式档真模型端到端冒烟通过。
266+
267+
**族内余项登记(续延标定批)**:VAD 预热/窗口/倍率、重打分门限、融合 gap/SIM/权重、去重阈值 A/B;预处理默认定案复核;REQ-267 慢速档回放=真链路集成级(真机会话实测登记)。

0 commit comments

Comments
 (0)