turn_model.backend 出廠為 vad；所有 turn idle 時，狀態頁可 process-wide 切換 turnsense、vad 或 smart-turn，重啟回 YAML。三種 backend 的 wait_secs 均為 0.1；兩個 scoring backend 的 threshold 均為 0.6。VAD 不跑模型，出廠路徑為 web-ui stop debounce 0.4 秒 + STT wait 0.1 秒；COMPLETE 立即 commit。不支援 per-car 或 mid-turn 切換。本輪驗收條件使用 A1–A10。附錄 B 的反應式排程表沿用 2026-07-29 的 A1–A6；同號並存時以下表兩欄為準，不是同一條需求。
| ID | 本輪（2026-09-15-eot-backends） | 同號歷史（若有） |
|---|---|---|
| A1 | 出廠 nested：backend vad；三種 backend wait 均為 0.1；兩個 scoring backend threshold 均為 0.6。資產在 turnsense: 下 | 2026-07-29 排程：沒有前次延遲時使用 initial_interval |
| A2 | 頂層純量或 sibling map、殘留 complete_wait_secs、舊三檔、enabled、頂層 turn:、頂層資產鍵拒絕啟動 | 2026-07-29 排程：間隔為延遲 × margin，設地板但不設上限 |
| A3 | vad.wait_secs 接受 0.1–3.0。backend=vad 不建構 TurnSense，等待後 commit reason=vad | 2026-07-29 排程：margin 必須大於 1 |
| A4 | overlay 只改 backend: smart-turn 繼承三個區塊 | 2026-07-29 排程：最小間隔必須大於 0 |
| A5 | nested wait 越出 0.1–3.0、threshold 越出 0–1 拒絕啟動 | 2026-07-29 排程：初始間隔必須大於 0 |
| A6 | deploy.sh 從 nested turnsense: 讀 key／onnx_file／cmvn_file | 2026-07-29 排程：環境變數可覆寫 YAML margin |
| A7 | COMPLETE 嚴格大於門檻並立即 commit；incomplete／invalid 等 wait；滑桿只改 incomplete；JSON 仍是 per-backend map；全行程共用、不依車 | — |
| A8 | smart-turn 呼叫 _predict_endpoint；過門檻 reason=model；不呼叫 append_audio。兩個 scoring backend 共用 model reason；VAD 使用 vad reason；三種 backend 下 KWS／force 仍優先 | — |
| A9 | SW-OPS-04／SW-EOT-01／SW-EOT-08 路徑為 nested；出廠 VAD 路徑為 400+100=500。不宣稱修 490/510 | — |
| A10 | 狀態頁可在所有 turn idle 時切換 backend；busy 回 409；目標 detector 準備失敗保留原 backend；既有與新 connection 共用新 detector；重啟回 YAML | — |
| 名詞／ID | 意義與本報告用途 |
|---|---|
EOT backend / turn_model.backend | YAML 值是行程啟動預設，出廠為 vad；狀態頁選擇後由單一「儲存設定」在所有 turn idle 時 process-wide 切換 turnsense、vad 或 smart-turn，重啟回 YAML。它選的是 verdict 來源，不是關掉 VAD，也不是 per-user 開關。Turn 等待時間（wait_secs）旋鈕只改目前 backend 的等待秒數，不是 backend，也不改 complete threshold。 |
wait_secs / Turn 等待時間 / SW-OPS-04 | YAML、JSON 與 API 欄位維持 wait_secs；狀態頁在 Turn settings 顯示 Turn 等待時間（wait_secs）。TurnSense／Smart Turn 用於 incomplete／invalid／runtime error；VAD 用於收到 stop 後的 continuation window。三種 backend 各自持有 wait_secs，出廠皆為 0.1，範圍 0.1–3.0；滑桿覆寫目前 running backend 到 turn_settings.json（per-backend map，全行程共用、不依車）。兩個 scoring backend 的 complete_threshold 出廠皆為 0.6，YAML-only，嚴格大於才 COMPLETE。預設 VAD backend 的靜音到 commit 為 web-ui stop debounce 0.4 秒 + kitt-stt VAD wait 0.1 秒，不扣 ASR。 |
turnsense / vad / smart-turn | turnsense 沿用 CUDA 語尾三分類；vad skip 模型並在合格 VAD stop 後等待 turn_model.vad.wait_secs。VAD stop 由 kitt-web-ui LoggingSileroVADAnalyzer 產生，預設 VADParams(stop_secs=0.4)；兩段時間前後相加。smart-turn 是 kitt-stt 第三個 detector：對 VAD-stop 快照呼叫 Pipecat LocalSmartTurnAnalyzerV3._predict_endpoint，門檻 probability > turn_model.smart-turn.complete_threshold（出廠 0.6），commit reason=model。既有測試檔名中的 smart-turn 場景不一定代表使用此 backend。 |
skipped / reason=model / reason=vad | eot.model.state=skipped 表示沒有模型機率。TurnSense／Smart Turn 的正常 commit 用 reason=model；VAD backend 用 reason=vad。Wire reason 只區分 model-backed 與 VAD，不再區分兩種模型 backend。 |
| KWS / STT / ASR | KWS 是喚醒詞偵測；本版用 STT（語音轉文字，也稱 ASR）的 final transcript 做文字比對，尚無聲學 KWS。三種 EOT backend 都仍跑 ASR 與 KWS。 |
| Active / Standby / manual | Active／Standby 是共用喚醒狀態；manual 是略過 match_wake 的 KWS method，不等於 Standby，也不是 EOT backend。 |
| VAD / segment / turn | VAD 偵測語音起訖；一段 VAD 音訊是 segment，一次送交下游的對話輸入是 turn，可包含多段 segment。VAD stop 不一定立即結束 turn；backend=vad 時，在 KWS 與強制停止之後，正常 stop 會等待 vad.wait_secs，期間的新語音延續同一 turn。 |
| EOT / TurnSense / EotController / SmartTurnDetector | EOT 是 turn 結束判定。TurnSense 提供語尾三分類；SmartTurnDetector 包裝 Pipecat CPU ONNX。detector 只回 TurnSenseResult。KittSttService 選出 TurnOutcome，由 EotController 執行 WAIT／COMMIT／CANCEL。Detector 不送 frame、不跑 KWS、不擁有 deadline。 |
| HR / ITN / s2t | HR 是同音替換，配置於 recognizer；ITN 將口語數字正規化，包含 OpenCC s2t（簡轉繁）。interim 只做 s2t，final 做完整 ITN。本輪不改這條路徑。 |
| SW_id / PRD F_id / UX | SW_id 是 SW 規格的穩定需求編號；PRD F_id 是產品功能分組；UX 條款補充互動要求。附錄 B 行為欄描述要求，結果欄描述驗證，兩者不等同。本輪新增可切換 EOT backend，並把 SW-OPS-04、SW-EOT-01 與 SW-EOT-08 的路徑改成 nested YAML。 |
| fbank / LFR / CMVN | 聲學前處理的濾波器組特徵／低幀率堆疊／均值變異數正規化。TurnSense 路徑仍依此前處理；VAD backend 不跑這段。 |
| RTF / CER / WER | 處理時間與音訊時長之比／字元錯誤率／詞錯誤率。本輪未量測，不作效能比較。 |
| 掉句 / 餘裕 | 掉句是評測分帶時漏掉輸入句；餘裕是實測值距判定門檻尚有多少空間。兩者出現在 rebase 後繼承的語言政策需求：前者守住評測樣本完整，後者說明英文閂鎖門檻對偶發誤判的容忍空間；本次只補入現行契約，未重跑其登記測試。 |
| SNR / FP32 / bf16 | 訊噪比與浮點精度格式。出現在累積訓練／模型測試；本輪未做 live 精度驗證。 |
| TensorRT / execution provider / sm89 | 模型執行後端與 GPU 架構；RTX 4090 為 sm89（compute capability），TensorRT engine 綁定該架構、不可跨機搬。model.provider 與 turn_model.backend 是不同設定。 |
| MatMulInteger / MatMulNBits / QDQ | 量化矩陣乘法算子與量化／反量化節點；SW mapping 保留部署相容性檢查，不代表本輪執行量化模型。 |
| 歷史驗收 ID | 附錄 B 的 A1–A6 是 2026-07-29 排程驗收；B1/B2 是 interim/final ITN 拆分；B14-R1、B14-R2、B19-R1、B19-R2、B19-R3 是既有併發測試子項，不是本輪 EOT backend 的新需求。 |
設計與施工依據：
2026-09-15-eot-backends-design.md、
2026-09-15-eot-backends.md。
Kickoff baseline 67160fa（main）。出廠 YAML 依 backend 分組，啟動預設為 vad；selector 可選 turnsense／vad／smart-turn。overlay 只改 backend: smart-turn 時 deep-merge 繼承三個區塊。頂層 sibling map 與頂層資產鍵在啟動時失敗。
| 路徑 | 出廠 | 用途 |
|---|---|---|
turn_model.turnsense.wait_secs | 0.1 | TurnSense incomplete wait；滑桿覆寫目前 running backend |
turn_model.smart-turn.wait_secs | 0.1 | Smart Turn incomplete wait |
turn_model.turnsense.complete_threshold | 0.6 | TurnSense COMPLETE 機率門檻；YAML-only；嚴格大於 |
turn_model.smart-turn.complete_threshold | 0.6 | Smart Turn COMPLETE 機率門檻；YAML-only |
turn_model.vad.wait_secs | 0.1 | VAD stop 後的 continuation window；與 kitt-web-ui stop debounce 分開 |
turn_model.turnsense.{key,onnx_file,cmvn_file} | turnsense-1.1／model_fp32.onnx／am.mvn | 換 TurnSense 版本改這裡；deploy.sh 從 nested 區塊讀 |
VADParams.stop_secs 出廠值調為 0.4 秒，並維持 STT wait_ms 的 0.1 秒顯示精度。不接 Pipecat append_audio。不出廠改成 smart-turn。不做 mid-turn 或 per-user 切換。不從體感扣 ONNX 推論。不修 complete 路徑 490/510 切句。狀態頁的 backend selector、wait slider 與 Debug tools 屬於 runtime control；操作與觀測行為見§2。
turn_model.backend 只替換 VAD stop 後的判定來源；三種 backend 最後都交給同一個 EotController。turn_model.backend 是啟動預設；狀態頁只在所有 turn idle 時替換 process-wide detector（src/turn_detection.py）。TurnBackend.TURNSENSE：呼叫 TurnSenseDetector.analyze；complete 則 reason=model。TurnBackend.SMART_TURN：呼叫 SmartTurnDetector.analyze → _predict_endpoint；complete 則 reason=model。不呼叫 append_audio。TurnBackend.VAD：不跑模型，回傳 state=skipped 的 WAIT；到期由 EotController 以 reason=vad commit。不得把 turnsense 缺 runtime 的 skipped 解讀成 VAD mode。EotController.apply。強制停止的 reason 保持 mic_off／max_duration／audio_stall。Backend 只改判定來源，沒有改下游 Frame 或 metadata 外形。每個 segment 都使用同一組 eot.model keys；尚未 commit 時 eot.decision=null，commit carrier 才填入同一組 decision keys。
eot envelope；web-ui 依 action 與非空 reason 結束 turn。turn_model.backend | eot.model 差異 | 正常 commit 的 eot.decision.reason | Frame contract |
|---|---|---|---|
turnsense | state=complete/incomplete/invalid/error；模型成功時三個 probability 有值 | model | TranscriptionFrame 或無 final 時的 ZonalUserStoppedSpeakingFrame；WAIT／COMMIT 與 metadata keys 相同 |
smart-turn | state=complete/incomplete/error；只有 p_complete 有值 | model | |
vad | state=skipped；probability 全為 null，wait_ms=vad.wait_secs | vad |
smart-turn 與 vad 不會讓 stop strategy 失敗
SttEotUserTurnStopStrategy 接受 TranscriptionFrame／UserStoppedSpeakingFrame，並要求 decision.action == "commit" 與 reason 是非空字串。reason=model 與 reason=vad 都會正常呼叫 trigger_user_turn_stopped()。來源：kitt-web-ui backend/src/kitt/agent/turn_strategy.py:83-103。
UI observer 只讀 eot.model.p_complete、state、wait_ms，不讀 decision.reason。VAD 的 p_complete=null 只代表不送 turn_prediction 顯示，不影響 stop strategy 關閉 turn。來源：kitt-web-ui backend/src/kitt/agent/observers.py:149-174。
reason 收斂為判定類型：TurnSense 與 Smart Turn 都是 model-backed，使用 model；VAD 沒有呼叫模型，使用 vad。若要分辨兩種模型 backend，讀取行程設定與 server log，不再從 wire reason 判斷。
狀態頁以單一「儲存設定」套用 backend 與目前 backend 的 wait_secs。backend 只在所有 turn idle 時切換，忙碌時回 409；成功後立即影響既有與新 connection，重啟回 YAML。設定是 process-wide，不依車；complete_threshold 維持 YAML-only。
| 操作 | 實作行為 | 邊界 |
|---|---|---|
Debug audio: on/off | 動態套用到現存 connection；新 connection 讀同一個 process runtime 值。開啟才累積後續 PCM，關閉只停止新增資料；切換當下不寫檔。 | 各 connection 仍只在 disconnect / cleanup() 輸出自己的 WAV；先開後關的既有 buffer 仍會寫出。上限沿用 audio.dump_max_duration_secs=180。來源：src/server.py:63-68,108-119,253-266；src/kitt_stt_service.py:319-325,384-454,566-567。 |
| 下載最新 trace | GET <base>/debug/trace/latest 回傳 TraceManager 最近一次週期 flush 已完成原子寫入的 trace_*.json.gz；沒有已 flush 檔案時回 404。 | 按鈕不主動 flush，不回傳仍在記憶體中的 event。來源：src/server.py:269-282、utils/perfetto_trace.py:320-370。 |
| 開啟 Perfetto | 以新分頁開啟 https://ui.perfetto.dev/。 | 瀏覽器不自動上傳 trace；操作者自行把剛下載的 gzip 拖入 Perfetto UI。 |
2026-09-15 · kickoff baseline 67160fa，最終 HEAD 基於 origin/main 3c0282d7。本次出廠設定調校以 tests/test_turn_backend_config.py 與 tests/test_status_page_settings.py 驗證（60 passed）；kitt-web-ui 的 VAD runtime settings／rejection selected tests 為 14 passed。主機 GPU 以獨立 port 啟動目前設定：log 顯示 [EOT] backend=vad、TurnSense preload skipped、SenseVoice ready，HTTP status page 回傳 data-current="vad"。以目前 v3b 模型的隔離 CUDA WebSocket 重播另有 41 passed。TurnSense runtime 為 15 passed，完整 offline 為 1661 passed、33 skipped；current-default v3b CUDA live 為 12 passed、3 failed。整合結果與完整命令如下。
| PRD Feature | SW_id | Behaviour | Executable evidence | Result |
|---|---|---|---|---|
| STT_EXTRA | SW-OPS-04 | YAML 依 backend 分組；滑桿可改目前 running backend 的 wait，reset 只清除該 backend override；全行程共用、不依車 | test_turn_backend_config.py · test_policy.py · test_smart_turn_detector.py · test_status_page_settings.py | ✓ PASS |
| F_3.2 / UX§3.1 | SW-EOT-01 | 路徑改為 turn_model.<backend>.wait_secs／complete_threshold；COMPLETE 立即 commit；出廠 VAD 路徑 400+100=500 | test_turn_backend_config.py · test_eot_kws_precedence.py · test_policy.py | ✓ PASS |
| STT_EXTRA / F_3.2 | SW-EOT-08 | smart-turn 讀 turn_model.smart-turn；overlay 只改 backend 即繼承三個區塊；狀態頁只在所有 turn idle 時切換，失敗保留原 backend | test_turn_backend_config.py · test_smart_turn_detector.py · test_eot_kws_precedence.py · test_status_page_settings.py · test_runtime.py | ✓ PASS |
| 驗證範圍 | 結果 |
|---|---|
| 設定／status／核心 EOT contract | PASS · current-default config/status 60 passed、TurnSense runtime 15 passed、startup contract 2 passed |
| 完整 offline regression | 1661 passed, 33 skipped · tests（排除 live／sherpa-onnx）於 host test environment 完整結束 |
| v3b CUDA live 已通過範圍 | 41 passed · 拒識、退出詞、wake／rate、主動問候／latency 與車載 hotword；主機 GPU startup/status 亦通過 |
| current-default v3b targeted live | 12 passed, 3 failed · SW-W-10、SW-B-03 與未註冊的 SW-TURN-04；詳見測試結果 |
| 量測 artifact | NOT-VERIFIED · SW-LANG-15／SW-LANG-17 缺 GPU＋TTS 量測產物 |
| 未驗證平台 | NOT-VERIFIED · k8s／Orin／Thor live |
SW-W-10 與 SW-B-03 的期望文字與 v3b 實際 transcript 不符；490 ms SW-TURN-04 在 vad／0.1 秒設定下仍切成兩輪。它們不是 backend hot-switch 失敗。SW-LANG-15／SW-LANG-17 的 GPU＋TTS 量測檔不存在，故保留 NOT-VERIFIED。nested 設定、三種 backend、idle-only process-wide 切換與共用 Frame contract 已由 focused／offline／startup 驗證。current-default live 仍有三個明確失敗與兩組未備量測 artifact，因此不將整體 live 宣稱為通過。Artifact 已 PUBLISHED：kitt-stt-eot-backend-switch.pages.dev。
正文 Speech path 說明 turn_model.backend=turnsense / vad / smart-turn 的判定路徑；本節呈現共用系統架構與 Frame flow。圖面來源：2026-09-04-itn-latency-optimization.html 的既有架構圖；標籤與程式引用以目前 branch 為準。相對 main，本輪新增三種 EOT backend 與 nested YAML；ASR／KWS／EotController 仍共用。
turn_model.backend 選 EOT 判定來源；interim／final 仍共用單一 SenseVoice，EotController 仍是唯一 commit 執行者。create_stt_processor 每連線建立 KittSttService；UserSessionManager 以 user_id 分開音訊／turn，同一連線共用 KWSStreamManager。preload 時 SherpaOnnxModelCache 跨連線共用 recognizer 與 lock；模型由 DVC 取得，部署沿用 deploy.sh → Skaffold → K8s／Orin／Thor。來源：src/server.py:67、src/session/user_session_manager.py:10、src/model_cache.py:9、utils/model_manager.py:154。
src/kitt_stt_service.py:599、src/kitt_stt_service.py:1253）。backend=vad 會略過模型但產生固定 WAIT；force stop、scoring backend 的空 turn tail或缺 detector 會回 skipped。VAD WAIT 經 outcome_from_verdict(..., backend=vad) 保留 reason=vad。src/kitt_stt_service.py:1408、src/kitt_stt_service.py:1800）。src/kitt_stt_service.py:1773、src/kitt_stt_service.py:1513、src/kitt_stt_service.py:1044）。| EotController 結果 | 輸出與狀態 | 後續事件 | 位置 |
|---|---|---|---|
WAIT | 有 final_frame 就先送出，不附 commit 的 eot.decision；turn 保持開啟。 | 排程 per-user EOT deadline；新 VAD start 取消 deadline 並延續 turn。deadline 到期且仍有效，改以 explicit stop commit。 | src/eot.py:186src/eot.py:258 |
COMMIT | 只選一個載體：有 final 用 TranscriptionFrame；無 final 用 ZonalUserStoppedSpeakingFrame。載體附 eot.decision。 | 關閉該 user 的 turn；若 room Active，重設共用 wake idle timer。 | src/eot.py:221 |
CANCEL | 丟棄連線內所有 pending turn；EotController 本身不發 commit frame。 | 呼叫端已送出或收到 agent_standby，供下游丟棄累積內容。 | src/eot.py:210 |
IN／OUT 表示收／送，不等同於 FrameDirection。Web UI 控制通常從 DOWNSTREAM 收入，LM standby 從 UPSTREAM 收入；服務產生的文字與狀態通常送往 DOWNSTREAM。下表列本服務特別處理或產生的 Frame，未列出的基底 passthrough 不新增本服務的行為契約。_emit_seat_load 只寫 trace，不送 ASRMetadataFrame（src/kitt_stt_service.py:1228）。
reason。| Frame | 方向 | 觸發 case | 動作／條件 | Metadata／payload | 位置（file:line） |
|---|---|---|---|---|---|
StartFrame | IN | pipeline 啟動 | 呼叫基底 start，送模型／主機 metadata；模型與 session manager 已在 service 建構時準備。 | model_name、system info | src/kitt_stt_service.py:325 |
AudioRawFrame | IN | PCM chunk 到達 | 依 user_id 選 session；正常 chunk 更新 preroll／turn tail，utterance_active 時累積 segment 並評估 interim 排程。帶 metadata["max_utterance_duration"] 的 chunk 不進 segment buffer、不解碼，仍交由基底往下游傳給 VAD。 | audio、sample_rate、num_channels、user_id、可選 max_utterance_duration | src/kitt_stt_service.py:616src/kitt_stt_service.py:644src/kitt_stt_service.py:1173src/kitt_stt_service.py:1200 |
VADUserStartedSpeakingFrame | IN | VAD 開始 | 建立或延續 per-user turn，取消舊 EOT deadline；以 preroll 起始 segment。 | user_id、start timing | src/kitt_stt_service.py:683 |
VADUserStoppedSpeakingFrame | IN | VAD 停止 | 快照 segment／turn tail，交棒 stream，並行 final ASR 與選定 EOT detector。已知 eot_force_reason 可要求 force-complete；不直接代表 EOT commit。backend=vad 略過 TurnSense 推論。 | user_id、eot_force_reason | src/kitt_stt_service.py:785src/kitt_stt_service.py:1513 |
UserStartedSpeakingFrame | IN | 上游 legacy semantic start | 本服務不以此建立或重開 turn；原 frame 交由基底路徑傳遞。 | 原 frame payload（passthrough） | src/kitt_stt_service.py:998 |
UserStoppedSpeakingFrame | IN | 上游 legacy semantic stop | 本服務不以此結束 turn；原 frame 交由基底路徑傳遞，STT 自行決定 EOT。 | 原 frame payload（passthrough） | src/kitt_stt_service.py:998 |
BotStartedSpeakingFrame | IN | TTS 開始播放 | Active 改掛 bot_speaking_watchdog_secs；Standby 取消 shared timer。 | 無新增 payload；更新 shared timer | src/kitt_stt_service.py:918 |
BotStoppedSpeakingFrame | IN | TTS 播放結束 | Active 且無 user 正在 utterance 中時，重設 shared idle timeout。 | 無新增 payload；更新 shared timer | src/kitt_stt_service.py:950 |
InterruptionFrame | IN | reason=agent_active；Web UI 手動 Active | 啟用共用 wake state、重設 idle timer；各 session 從當下重啟辨識，丟棄切換前 segment。stt／manual 都接受此控制。 | reason=agent_active、user_id | src/kitt_stt_service.py:1035src/kitt_stt_service.py:662 |
InterruptionFrame | IN | reason=agent_standby；Web UI（DOWNSTREAM） | 清除共用 wake state，結束所有 pending turn；交由基底傳遞。 | reason=agent_standby、user_id | src/kitt_stt_service.py:1009 |
InterruptionFrame | IN | reason=agent_standby；LM（UPSTREAM） | 同樣取消 room-wide pending turn，另向 DOWNSTREAM relay 讓 Web UI 同步。 | reason=agent_standby、user_id | src/kitt_stt_service.py:1024 |
STTUpdateSettingsFrame | IN | 設定 delta | 由基底設定路徑呼叫 _update_settings；依 delta 更新支援的 wake／bypass 設定，不代表所有 YAML 欄位都可熱切換。 | 支援欄位的 settings delta | src/kitt_stt_service.py:1188 |
EndFrame | IN | pipeline 收尾 | 取消 idle timer；仍在 utterance 的 session 可跑 final，使用 apply_eot=false，不發 EOT commit。之後丟棄 pending turn，交由基底收尾。 | 無新增 payload | src/kitt_stt_service.py:1044 |
ASRMetadataFrame | OUT | start 完成 | 送 model_name 與 CPU／GPU／RAM 資訊；不是文字或 EOT 載體。 | model_name、CPU／GPU／RAM | src/kitt_stt_service.py:325 |
InterimTranscriptionFrame | OUT | interim decode 有更新文字 | features.streaming_interim=true 且 _should_emit_interim 通過；須同時符合排程條件。後處理只做 s2t，不作 final 的權威輸出。 | text、user_id、timestamp、language | src/kitt_stt_service.py:1253src/kitt_stt_service.py:1289 |
InterimTranscriptionFrame | OUT | 無可送 final，但 room 仍 Active | 送空文字清除 interim；Standby 清除顯示改由 agent_standby 通知處理。 | text=""、user_id、timestamp | src/kitt_stt_service.py:1776 |
TranscriptionFrame | OUT | 非空 final，_should_emit_final 通過，且非 exit | 帶 eot.model；WAIT 先送 segment final 並等待，COMMIT 在同一 frame 附 eot.decision。EndFrame 收尾例外不套用 EotController。 | text、user_id、timestamp、language、metrics、eot.model／eot.decision | src/kitt_stt_service.py:1692src/eot.py:186 |
ZonalUserStoppedSpeakingFrame | OUT | COMMIT 且沒有 final_frame | 如有效 EOT deadline 到期、wake-only、ASR error；以 explicit stop 承載 eot.decision，不是每個 final 都加送 stop。 | user_id、eot.model、eot.decision、reason | src/eot.py:221 |
InterruptionFrame | OUT | STT wake 命中／Active re-wake | reason=agent_active；喚醒或重申共用 Active 狀態。manual 不以 transcript 觸發這條路徑。 | reason=agent_active、user_id | src/kitt_stt_service.py:594src/kitt_stt_service.py:594 |
InterruptionFrame | OUT | exit word 命中 | reason=agent_standby；清除 wake state 並取消 room-wide pending turn，不送 exit transcript。 | reason=agent_standby、user_id | src/kitt_stt_service.py:1408src/kitt_stt_service.py:1426 |
InterruptionFrame | OUT | Standby 且無可送 final | reason=agent_standby；通常是 wake／bypass 無匹配，CANCEL / no_wake 丟棄 pending turn。 | reason=agent_standby、user_id | src/kitt_stt_service.py:1785 |
InterruptionFrame | OUT | 共用 wake idle／watchdog timeout 到期 | reason=agent_standby；callback 先確認無 user 正在 speaking／finalizing。這個 timer 與 per-user EOT deadline 不同。 | reason=agent_standby | src/kitt_stt_service.py:482 |
InterruptionFrame | OUT | 轉送 LM 的 UPSTREAM agent_standby | 向 DOWNSTREAM relay 同一 frame，讓 Web UI 回 Standby。 | reason=agent_standby、user_id | src/kitt_stt_service.py:1024 |
TTSSpeakFrame | OUT | 符合 Standby wake-only 全部條件 | 送 wake.response_text，append_to_context=false；COMMIT / wake_only 另以 explicit stop 結束控制 turn。 | text、append_to_context=false | src/kitt_stt_service.py:1800src/kitt_stt_service.py:1811 |
本附錄保留目前 SW 規格的完整 traceability，供審閱與報告契約使用；不是首頁的結果摘要。標示「2026-09-15 v3b retest」者以本輪結果為準，其餘是現行契約的既有驗證資訊；目前結論見§3，命令見重現方式。
下表計算需求列，不是 pytest case 數；同一需求可能跨 Feature，同一測試也可涵蓋多個需求，因此各組不能相加當成測試總數。執行命令見重現方式。
| PRD F_id | Feature | 有 STT SW_id？ | 需求列數 | 2026-09-14 驗證狀態 |
|---|---|---|---|---|
| F_2 | One-shot（喚醒詞 + 指令連說） | 有；見分組細表 | 12 個需求列 | PASS 10 / FAIL 2 |
| F_3 | 聆聽等待 / 智慧斷句 / 解除喚醒時機 | 有；見分組細表 | 26 個需求列 | PASS 18 / FAIL 6 / PARTIAL 2 |
| F_4.3 | 語音打斷 Barge-in / 解除喚醒詞 | 有；見分組細表 | 3 個需求列 | FAIL 1 / PASS 2 |
| UX 專有 | PRD 無對應 F_id | 有；見分組細表 | 3 個需求列 | FAIL 2 / PASS 1 |
| STT_EXTRA | PRD 未描述、STT 已具備 | 有；見分組細表 | 76 個需求列 | PASS 62 / PARTIAL 1 / — 10 / FAIL 2 / SKIP 1 |
| F_1 | 多音區識別／控制 | 下游／OUT_OF_SCOPE | — | 未執行下游驗收 |
| F_4.1 | 背景併行 | 下游／OUT_OF_SCOPE | — | 未執行下游驗收 |
| F_4.2 | 後令壓前令 | 下游／OUT_OF_SCOPE | — | 未執行下游驗收 |
| F_5 | 連續指令 | 下游／OUT_OF_SCOPE | — | 未執行下游驗收 |
| F_6 | 上下文理解 | 下游／OUT_OF_SCOPE | — | 未執行下游驗收 |
| SW_id | 行為（規格） | 測試 | 結果 |
|---|---|---|---|
SW-W-03 | Standby→Active（喚醒詞在句首）：喚醒詞+指令連說，辨識其後之指令；喚醒詞不得出現在 final，且不得因前期聽歪而誤顯示喚醒詞 | test_wake.py | ✓ PASS |
SW-W-04 | 喚醒詞 <停頓> 指令 亦能喚醒，final 無喚醒詞 | test_wake.py | ✓ PASS |
SW-W-05 | 喚醒詞不在句首不觸發 | test_standby.py | ✓ PASS |
SW-W-08 | Active 期間：喚醒後任何話都辨識並往後送；句首喚醒詞於 final 過濾、非句首喚醒詞保留；interim 出現喚醒詞可接受 | test_active.py | ✓ PASS |
SW-W-09 | Active 句首喚醒詞 + smart-turn，仍不顯示喚醒詞 | test_active.py | ✓ PASS |
SW-W-13 | Standby 第一句未命中 → turn 關閉，故第二句句首的喚醒詞是新 turn 的句首，正常觸發喚醒 | test_smart_turn_wake.py | ✓ PASS |
SW-W-14 | 英文出廠喚醒詞 Hi Foxtron 須觸發（大小寫無關），且喚醒詞不得留在 final | test_wake_factory_words.py | ✓ PASS |
SW-W-15 | 第一次主動問候的時機（UX§1.3.2）：喚醒成立後須送出問候的 TTSSpeakFrame，STT 側上界 500ms。狀態頁可 process-wide 儲存 ui_handler_p99_secs／tts_handler_p99_secs（秒、三位小數、最小 0、無上限），下一次喚醒套用；兩個 handler legs 也用於第二次問候，非 per-car 設定。 | test_active_greeting.py · test_wake_latency.py · tests/test_greeting_settings.py | ✓ PASS 2026-09-15 v3b retest；handler settings 12 passed |
SW-W-16 | 喚醒成立後 <550ms 內有人說話 → 不觸發第一次主動問候。窗的起點是 InterruptionFrame(agent_active) 送出的那一刻——下游能觀測到的「喚醒成功」就是這個 frame | test_active_greeting.py | ✓ PASS 2026-09-15 v3b retest |
SW-W-17 | 喚醒詞+指令連說須觸發喚醒：連讀成一句時同樣要送出 InterruptionFrame(agent_active)，不因喚醒詞未單獨成句而不通知下游 | test_active_greeting.py | ✓ PASS |
SW-W-18 | 喚醒詞+指令連說不得出現問候語：使用者在喚醒當下就把指令說完了，等同已在抑制窗內說過話 | test_active_greeting.py | ✓ PASS |
SW-WM-01 | 喚醒詞比對與剝除：latin 大小寫無關、分隔字元先剝除、喚醒詞後可直接接指令、剝除喚醒詞後指令完整保留 | tests/test_wake_matcher.py | ✓ PASS |
| SW_id | 行為（規格） | 測試 | 結果 |
|---|---|---|---|
SW-W-01 | 非喚醒(Standby)：說喚醒詞以外任何句子，STT 不出任何文字、不往後送；相似音喚醒詞不得觸發 | test_standby.py | ✓ PASS |
SW-W-02 | 非喚醒下說無關長語音，需立即 smart-turn stop | test_standby.py | ✓ PASS |
SW-W-07 | smart-turn 斷句不因 VAD 誤判過度斷句 | test_smart_turn_wake.py | ✓ PASS |
SW-W-09 | Active 句首喚醒詞 + smart-turn，仍不顯示喚醒詞 | test_active.py | ✓ PASS |
SW-W-10 | Active 期間 smart-turn 功能正常（跨段黏合） | test_active.py | ✗ FAIL |
SW-W-11 | Active 第二句開頭喚醒詞不過濾（正常顯示） | test_smart_turn_wake.py | ✓ PASS |
SW-W-12 | 斷句前後不得因雜音產生語助詞（嗯/啊/喔） | test_active.py | ✓ PASS |
SW-W-13 | Standby 第一句未命中 → turn 關閉，故第二句句首的喚醒詞是新 turn 的句首，正常觸發喚醒 | test_smart_turn_wake.py | ✓ PASS |
SW-WM-02 | alias 只能買回實測誤聽，不得擴大誤觸發：全中文 alias 與 canonical 距離 ≤1 字；普通語句不得誤觸發 | tests/test_wake_matcher.py | ✓ PASS |
SW-B-03 | Prefix + smart-turn 正常合併 | test_bypass_prefix.py | ✗ FAIL |
SW-B-08 | 特定指令於 smart-turn 第一句句首觸發，只傳「關閉空調」 | test_bypass_cmd.py | ✓ PASS |
SW-B-10 | Standby 第一句未命中 → turn 關閉，故第二句句首的 Prefix 是新 turn 的句首，正常觸發 | test_smart_turn_bypass.py | ✓ PASS |
SW-B-11 | 同上，第二句句首的特定指令正常觸發 | test_smart_turn_bypass.py | ✓ PASS |
SW-X-01 | Timeout 15s：TTS 說完起算，15s 無人說話 → 回 Standby | test_timeout.py | ✓ PASS |
SW-X-02 | 重新喚醒後 timeout 重新計時 | test_timeout.py | ✓ PASS |
SW-X-05 | 第二次主動問候的時機（UX§1.3.3）：喚醒起算 =10秒 任何座位都沒說話 → 播「你好，需要我為你做什麼呢？」 | test_active_greeting.py · test_remaining_ux_gaps.py | ✓ PASS 2026-09-15 v3b retest |
SW-X-06 | 10 秒內有人說話 → 不觸發第二次主動問候 | test_active_greeting.py | ✓ PASS 2026-09-15 v3b retest |
SW-X-07 | 退出聆聽路徑一（UX§1.3.4）：第二次問候播完後再 =5秒 無人說話 → 回 Standby | test_active_greeting.py | ✓ PASS 2026-09-15 v3b retest |
SW-TURN-01 | 一個 turn 內只有第一個 VAD segment 是 turn head；其餘為續段，不跑喚醒／免喚醒偵測 | tests/test_turn_arbitration.py | ✓ PASS |
SW-TURN-02 | 續段的送出權依 bypass 種類授權：prefix 授予（SW-B-03 需要），exact 不授予（SW-B-07 的語意） | tests/test_turn_arbitration.py | ✓ PASS |
SW-TURN-03 | 新 turn head 清除上一個 turn 的指令送出權，續段則保留 | tests/test_turn_arbitration.py | ✓ PASS |
SW-EOT-01 | STT 是唯一 EOT authority：每個 VAD stop 由目前 backend 判定。TurnSense／Smart Turn 評分 turn tail；COMPLETE 當 p_complete > turn_model.<backend>.complete_threshold（兩個 scoring backend 出廠皆為 0.6），然後立即 commit。模型的 INCOMPLETE／INVALID 與 VAD backend 的正常 stop 都等該 backend 的 wait_secs，期間有新語音則延續同一 turn。立即完成的非空 final 與 eot.decision 在同一個 TranscriptionFrame | tests/test_eot_state.py、tests/turnsense/test_policy.py、tests/test_eot_kws_precedence.py、tests/test_turn_backend_config.py · live：test_remaining_ux_gaps.py | 部分覆蓋 |
SW-EOT-02 | KWS 事件（standby 無匹配／離開詞／agent_standby／連線結束）一律丟棄 turn，優先於強制停止與模型判定；被丟棄的 turn 永不進 LLM。ASR final 失敗不屬 KWS cancel：該段不送 transcription，改以 asr_error 結束 turn | 離線：tests/test_eot_kws_precedence.py · live（wire contract）：test_forced_stop.py | ✓ PASS |
SW-EOT-05 | kitt-web-ui 在 UX§8.2 超限後標記 metadata["max_utterance_duration"]；STT 對後續音訊不進 buffer、不做 interim 解碼，但仍往下游傳給 VAD。VAD STOP 時以標記前的音訊出 final，是否拒識由 kitt-web-ui 決定。 | tests/test_max_utterance_audio.py | ✓ PASS |
SW-EOT-06 | 已廢止：長文字拒識改由 kitt-web-ui RejectionGate 負責 | — | N/A |
SW-EOT-07 | 已廢止：隨拒識門檻移出 STT | — | N/A |
| SW_id | 行為（規格） | 測試 | 結果 |
|---|---|---|---|
SW-X-04 | 說解除喚醒詞 → 切 Standby（UX§2.1 指定 13 個：謝謝／再見／退出／退下／滾蛋／滾／Thank you／Thanks／Goodbye／ByeBye／Dismiss／Quiet／Shut up） | live：test_exit_words.py · test_btn_control.py · 離線比對層：tests/test_exit_word.py | ✓ PASS 2026-09-15 v3b retest；13 詞各 10 次 |
SW-WM-03 | 退出詞 alias 必須錨定到已設定的退出詞：alias 群組的 canonical 不在 exit_words 內則整組忽略 | tests/test_wake_matcher.py | ✓ PASS |
SW-EOT-02 | KWS 事件（standby 無匹配／離開詞／agent_standby／連線結束）一律丟棄 turn，優先於強制停止與模型判定；被丟棄的 turn 永不進 LLM。ASR final 失敗不屬 KWS cancel：該段不送 transcription，改以 asr_error 結束 turn | 離線：tests/test_eot_kws_precedence.py · live（wire contract）：test_forced_stop.py | ✓ PASS |
| SW_id | 行為（規格） | 測試 | 結果 |
|---|---|---|---|
SW-X-08 | 拒識之後必須維持聆聽（UX§10.2）：越過 UX§8.2 門檻的語句丟棄不往下送，但不得因此離開 Active——拒識是「裝沒聽到」，不是「結束這一輪」 | test_rejection_thresholds.py | ✓ PASS 2026-09-15 v3b retest；>15 秒／>50 字 |
SW-LANG-01 | 整句英文指令須被辨識，且不需切換任何語言設定 | test_bilingual.py | ✓ PASS |
SW-LANG-02 | 同一句內中英夾雜時兩種文字都要保留：辨識器須在句中換文字系統，不是為整句選一種語言 | test_bilingual.py | ✓ PASS 2026-09-15 v3b live 重跑 |
| SW_id | 行為（規格） | 測試 | 結果 |
|---|---|---|---|
SW-W-19 | kws.method.name=stt 執行 transcript 喚醒；manual 跳過 match_wake 與 strip_wake_prefix | test_kws_method_policy.py · test_kws_method_manual.py | ✓ PASS |
SW-B-12 | manual 保留 match_bypass；已驗證 current-segment exact／prefix、非句首不觸發與 prefix 跨段 continuation | test_kws_method_policy.py · test_kws_method_manual.py | ✓ PASS |
SW-UI-07 | stt / manual 共用 InterruptionFrame(agent_active/agent_standby) 控制 | test_kws_method_policy.py · test_kws_method_manual.py | ✓ PASS |
SW-CFG-03 | kws.method.name 預設 stt、只接受 stt / manual；舊設定鍵拒絕啟動 | test_kws_method_config.py · test_status_page_settings.py | ✓ PASS |
SW-B-01 | Prefix（default「冷氣溫度*」「導航到*」）：非喚醒下前綴符合即整句往後送 | test_bypass_prefix.py | ✓ PASS |
SW-B-02 | Prefix 不在句首不觸發 | test_bypass_prefix.py | ✓ PASS |
SW-B-05 | 特定指令（exact，default「關閉空調」）：非喚醒下整句相符即往後送 | test_bypass_cmd.py | ✓ PASS |
SW-B-06 | 特定指令 不在句首不觸發 | test_bypass_cmd.py | ✓ PASS |
SW-B-07 | 特定指令句中夾雜其他話不觸發 | test_bypass_cmd.py | ✓ PASS |
SW-X-03 | 按 WebUI 綠色 active 按鈕 → 回 Standby | test_btn_control.py | ✓ PASS |
SW-UI-01 | WebUI Standby 按鈕可啟動喚醒（灰→綠），之後任何話都辨識往後送 | test_btn_control.py | ✓ PASS |
SW-UI-02 | 每次 connect 後狀態不壞：Connect→喚醒→disconnect ×5 都正常 | test_btn_control.py | ✓ PASS |
SW-UI-03 | 頻繁切換穩定：連點喚醒按鈕 ≥10 次後，切換仍正常 | test_btn_control.py | ✓ PASS |
SW-UI-04 | 連點後於 Standby 說「嗨鴻華」仍能觸發 | test_btn_control.py | ✓ PASS |
SW-UI-05 | 講話中瞬間切 Standby，WebUI 不得有灰字卡住 | test_btn_control.py | ✓ PASS |
SW-UI-06 | 講話中瞬間切靜音(mic)，WebUI 不得卡住 | STT_EXTRA | — |
SW-MU-01 | 同車多 user 喚醒狀態同步（按鈕同開同關） | —（歸屬：web-ui） | — |
SW-MU-02 | 多 user 按鈕/語音喚醒穩定度（交互點擊 ≥5 次仍正常） | —（歸屬：web-ui） | — |
SW-MU-03 | UserA 講話中(final 未送)，UserB 切 standby → STT 立即停聽、WebUI 無卡字 | —（歸屬：web-ui + STT） | — |
SW-MU-04 | 新 connect 的 user 同步當前喚醒狀態 | —（歸屬：web-ui） | — |
SW-MU-05 | 開關 mic 不影響喚醒狀態同步 | —（歸屬：web-ui） | — |
SW-MU-06 | 多 user timeout 穩定：長句期間不得誤切 standby | —（歸屬：web-ui + STT） | — |
SW-MU-07 | 自定義喚醒詞在多 user 間同步（含刪除同步） | —（歸屬：web-ui） | — |
SW-MU-08 | 多車隔離：Car1 喚醒/自定義詞不影響 Car2 | —（歸屬：web-ui（STT 以 ?car= 分段）） | — |
SW-CFG-01 | 可經 WebUI 客製化喚醒詞/免喚醒詞，行為與原廠一致 | test_stt_config.py | ✓ PASS |
SW-CFG-02 | 刪除客製化詞後不再觸發 | test_stt_config.py | ✓ PASS |
SW-PERF-01 | 連續長句（≥90 秒）講話期間，interim 重新解碼排程不得因緩衝區持續變長而失控卡住 | test_audio_stress.py | ✓ PASS |
SW-PERF-02 | 反應式 interim 重解碼排程的設定解析：間隔由上一次解碼延遲 × 安全係數決定，並受下限約束 | tests/test_audio_cfg.py | ✓ PASS |
SW-PERF-03 | 整車多人同時講話（1 條連線、4 個座位帶不同 user_id）：interim 重新解碼排程不得因共用辨識器的鎖爭用而卡住；每個座位都必須拿到自己的 final，且不得有非本車座位的 user_id（不串話） | tests/functional/live/test_multiuser_concurrency.py（5 條）｜離線機制測試 tests/test_interim_concurrency.py（13 條）、tests/test_itn_off_frame_path.py（3 條） | ✓ PASS |
SW-PERF-04 | 喚醒通知須在 200ms 內送出（UX§1.3.1）：UI 動效由此 frame 觸發 | test_wake_latency.py | ✓ PASS 2026-09-15 v3b retest |
SW-PERF-05 | 喚醒率回歸下限 ≥90%（UX§1.1） | test_wake_rate.py | ✓ PASS |
SW-EOT-03 | 語尾模型的音訊前處理必須與訓練時逐位元相同（fbank 80 → LFR 7/6 → CMVN，裁到最後 8 秒），否則三分類機率不成立 | tests/turnsense/test_frontend.py | ✓ PASS |
SW-EOT-04 | 語尾模型只在 CUDA 上執行（與 SW-OPS-06 同一原則，見 kitt-stt-sw-spec.md §10）：provider 未生效時伺服器拒絕啟動而非降級到 CPU；行程內單例、推論序列化且不佔用 event loop | tests/turnsense/test_runtime.py | ✓ PASS |
SW-EOT-08 | 可切換 EOT backend（2026-09-14）：turn_model.backend 是啟動預設；狀態頁可在所有 connection 的 turn idle 時 process-wide 切換，busy 回 409，目標 detector 準備失敗保留原 backend，既有與新 connection 同步套用，重啟回 YAML。vad 不 preload／不推論 TurnSense，正常 VAD stop 等 turn_model.vad.wait_secs 後 commit reason=vad。smart-turn 不 preload TurnSense，對 VAD-stop 快照呼叫 _predict_endpoint，p > turn_model.smart-turn.complete_threshold（出廠 0.6）則 COMPLETE 並立即 commit reason=model。TurnSense／Smart Turn 都是 model-backed，wire reason 共用 model。非法值、enabled、頂層 turn: 與頂層 sibling map 拒絕啟動。缺 runtime 且 active backend 仍為 turnsense 時不得偽裝成 reason=vad | tests/test_turn_backend_config.py、tests/test_smart_turn_detector.py、tests/test_eot_kws_precedence.py、tests/turnsense/test_runtime.py、tests/test_status_page_settings.py | ✓ PASS |
SW-ITN-01 | final 的 ITN：中文數字正規化 + 繁簡轉換 | tests/test_text_converter.py | ✓ PASS |
SW-ITN-02 | interim 與 final 的 ITN 刻意不同：interim 只做 s2t()，final 做完整 itn()；故兩者在數字上可以不同，這是設計不是 bug | tests/test_batch_asr_manager_itn_split.py | ✓ PASS |
| SW-ITN-03 | 「這個數字字元是不是數字」由詞庫決定而非執行期斷詞器；緊鄰受保護詞的真數字仍必須轉換；執行期不得持有斷詞器（jieba 不在 runtime 依賴內） | tests/test_itn_lexicon.py（43，offline） | ✓ PASS |
| SW-ITN-04 | 整數與小數（含正負號）轉阿拉伯數字：一→1、負十→-10、負三點一四一六九九九九九→-3.141699999 | test_text_converter.py::test_all（pytest -k "G1- or G2- or G12-"） | ✓ PASS |
| SW-ITN-05 | 百分比（含正負號）轉阿拉伯數字：百分之一→1%、百分之負零點五→-0.5% | test_text_converter.py::test_all（pytest -k G3-） | ✓ PASS |
| SW-ITN-06 | 分數（含正負號）轉阿拉伯數字：二分之一→1/2、負三分之一→-1/3 | test_text_converter.py::test_all（pytest -k G4-） | ✓ PASS |
| SW-ITN-07 | 日期／時間：數字轉阿拉伯數字，單位詞維持中文：一月五號→1月5號、十一點五十九分五十九秒→11點59分59秒 | test_text_converter.py::test_all（pytest -k "G5- or G8-"） | ✓ PASS |
| SW-ITN-08 | 程度副詞維持全中文、不得數字化：一點點、一些、十分滿意 等 40+ 慣用語 | test_text_converter.py::test_all（pytest -k G7-） | ✓ PASS |
| SW-ITN-09 | 完整車內出貨指令語料 495 列、29 個產品功能分類，逐句 100% 正確；分類本身不得靜默缺漏 | test_itn_lexicon.py::test_every_incar_command_normalises_as_adjudicated／test_every_product_category_is_represented | ✓ PASS |
SW-OPS-01 | 模型解析：get_local_model_path 維持純函式（不觸發下載）；ensure_local_model_path 只在 bundle 真的缺失時 pull、且只 pull 自己那個 .dvc；失敗訊息必須指名該跑的指令 | tests/test_model_manager.py | ✓ PASS |
SW-OPS-02 | 出貨模型的五處必須一致：config-basic.yaml 的 model.key、utils/model_manager.py 註冊表、三個 Dockerfile* 的 COPY、deploy.sh 的 MODEL_DVC_FILES、.dockerignore 的 build context 白名單 | tests/test_augment.py | ✓ PASS |
SW-OPS-03 | Per-turn debug log 檢索端點（GET ，2026-08-20）：features.enable_debug_log_endpoint 關閉時回 404；開啟時可依 trace_id（來自 WS 握手 ?trace_id=，經 logger.contextualize 標記，比照既有 ?car= 機制）與時間窗（since_ms/until_ms/minutes）篩選 in-memory ring buffer（debug.debug_log_buffer_lines 筆數上限）；零筆符合回 200 而非錯誤 | tests/test_debug_log_buffer.py、tests/test_debug_log_config.py、tests/test_debug_log_endpoint.py、tests/functional/live/test_debug_logs.py | ✓ PASS |
SW-OPS-04 | Per-backend EOT 等待與 complete 門檻：YAML 依 backend 分組。三種 backend 各自持有 wait；兩個 scoring backend 另持有 threshold；TurnSense 資產在 turnsense: 下。wait 出廠皆為 0.1；狀態頁顯示為 Turn 等待時間（wait_secs），範圍 0.1–3.0 秒，滑桿覆寫目前 running backend，全行程共用、不依車。complete threshold 出廠皆為 0.6（0–1，YAML-only，嚴格大於）。COMPLETE 立即 commit；scoring backend incomplete 到期用 timeout，VAD 到期用 vad。頂層 sibling map、頂層資產鍵、純量 wait與殘留 complete_wait_secs 拒絕啟動。JSON overlay 仍是 per-backend map；舊純量 JSON 只套用 turnsense | tests/test_turn_backend_config.py、tests/turnsense/test_policy.py、tests/test_smart_turn_detector.py、tests/test_status_page_settings.py、tests/test_eot_kws_precedence.py | ✓ PASS |
SW-OPS-05 | live 測試 harness 不得產生 false pass：tests/docker-test.sh 重用映像的新鮮度檢查，必須涵蓋 Dockerfile 所有 COPY 進映像的路徑。清單以 Dockerfile 為來源推導驗證，不得手工維護——漏一個路徑就會讓套件對著不是受測版本的程式碼跑出綠燈 | tests/test_augment.py::test_docker_test_rebuilds_when_any_baked_in_path_changes | ✓ PASS |
SW-OPS-06 | provider=trt 不得靜默降級成 CUDA（與 SW-EOT-04 是同一原則的兩個實例：指定的 provider 沒生效就拒絕啟動），兩層：① 註冊層——TensorRT EP 註冊失敗時（onnxruntime build 沒有 TRT、libnvinfer 不在載入路徑、ORT 退回選項），vendored sherpa-onnx 中止行程而非 fallback；② 執行層——recognizer 建好之後，若 model.provider 要的是 trt 而 libnvinfer 未常駐於本行程，服務啟動必須失敗。①擋不到②：engine 因 sm 或 TRT 版本不符而無法反序列化時 EP 仍註冊成功，ORT 可以把節點丟回 CUDA。兩者的共同理由是該降級在執行期不可見——服務照常啟動、答案正確，只是慢數倍，該輪就因此量到一組標著 TensorRT 卻跑在 CUDA 的數字 | tests/test_trt_provider_guard.py | ✓ PASS |
SW-OPS-07 | C-X1 部署契約：host network、ClusterFirstWithHostNet、NVIDIA RuntimeClass、既有 Gateway 與 localhost 服務互連；預設 CLI 在操作端 build/push Thor image 後部署，--deploy-only 只部署既有 image | tests/test_cx1_deployment.py（6 項） | ✓ PASS 2026-09-15 v3b retest；C-X1 route 已對齊 v6.0.0 |
SW-FT-01 | 訓練語料建構：目標詞以 config-basic.yaml 為單一事實來源；句型展開不污染標籤；音色池與配額可重現；AISHELL-3 全程只當評估、永不進訓練 | tests/test_finetune_corpus.py | ✓ PASS |
SW-FT-02 | 量測與判定：MODEL／PRODUCT 雙軸（別名不計入模型能力）、三軸判定須同時成立、checkpoint 選擇規則（一般 ASR 品質門檻未通過者不得被選中、全 NO-GO 時不得回傳贏家） | tests/test_finetune_eval.py | ✓ PASS |
SW-FT-03 | LoRA 接線：不可達目標必須拋錯而非靜默不啟用；可訓練集合非空且只含 lora；merge 後鍵集合＝base 且權重確實改變 | tests/test_finetune_lora.py | SKIP |
SW-FT-04 | 波形增強：SNR 精度、訓練／評估池不相交、確定性、不削波；預設 AUG_RATIO=0.25（波形增強，與出貨模型一致） | tests/test_augment.py | ✓ PASS |
SW-FT-05 | 論文基準計分不得與一般 ASR 品質驗收計分共用程式碼；中英文正規化分流、論文目標值釘住；精度以 --model-file 選擇（預設 model.onnx，歷史呼叫方式不變），且寫進 report JSON 讓每個數字帶著它的精度來源 | tests/test_paper_bench.py | ✓ PASS |
SW-FT-06 | 模型量化匯出：sherpa-onnx 的 metadata_props（model_type / lfr_window_size / neg_mean / inv_stddev / lang_* / with_itn …）在 INT8 與 FP16 轉換後必須逐鍵存活——少一個，sherpa-onnx 就載不起來；FP16 圖必須保持 fp32 的 graph I/O（keep_io_types），否則餵 fp32 waveform 會型別不符；INT8 的量化參數（op_types_to_quantize / weight_type）只允許存在一份，exporter 與獨立量化工具共用同一個函式，不得各寫一份而漂移 | tests/test_quantize_bundle.py | ✓ PASS |
SW-FT-07 | 量測後端可換為 ONNX：--onnx-dir（sherpa-onnx）與 --init-param（PyTorch）互斥，避免報告出現一個不知道用哪個後端量的數字；--require-cache 時，付費 TTS 語料只要有一個 clip 不在快取裡就在發出任何 TTS 請求之前失敗（Google TTS 按字計費，一次誤觸就是真實支出） | tests/test_eval_onnx_backend.py | ✓ PASS |
SW-FT-08 | 運算子的裝置可攜性：量化會把 MatMul 換成 MatMulInteger／MatMulNBits 等運算子，而目標裝置的 execution provider 未必實作它們——未實作時 ORT 會靜默指派回 CPU，模型照跑、文字照樣正確，只是速度不是部署時假設的那個。工具須：①列出圖中所有運算子；②列出某個量化方案新增／移除了哪些運算子；③以 ORT profiler 的實際節點指派回答「哪些落在目標 provider、哪些退回 CPU」；④把「provider 根本沒載入」與「部分運算子退回」分開報告（前者是環境問題，後者才是運算子支援問題）。輸入由圖的簽章合成，所以在沒有語料的邊緣裝置上也能重跑 | tests/test_op_support.py | ✓ PASS |
SW-DOC-01 | 新增測試檔必須在本規格留下紀錄：掛在某個 SW_id 之下，或明示「刻意不給 ID」與理由。反向亦然——本規格不得引用已不存在的測試檔（重新命名或刪除後留下的空指向，比未覆蓋更危險，因為它看起來有覆蓋）。§8／§9 兩區與其 ID 前綴不得被靜默移除 | tests/test_spec_traceability.py | ✓ PASS |
SW-DOC-02 | cycle 報告的累積 ledger 只增不減：最新一份報告必須涵蓋歷輪聯集的所有 SW_id（不只是對前一輪比對——那會讓某個 ID 消失一輪後就永遠消失，因為下一次比的是兩份都已缺它的報告）。報告檔名須與 docs/dev-specs/ 的 cycle stem 對應 | tests/test_report_integrity.py | ✓ PASS |
SW-DOC-03 | 報告要定義自己用的技術名詞（CLAUDE.md Rule 5）：凡讀者需要查才看得懂、且結論依賴其意義的名詞（sm89／RTF／MatMulInteger／CMVN…），必須在報告的名詞定義節裡說明「是什麼」與「該輪為何重要」。⚠️ 機械檢查的範圍是「有名詞表的報告，其涵蓋必須完整」；「報告有沒有名詞表」判不了誰是該輪的 cycle，故列入 close-out checklist | tests/test_report_glossary.py | ✓ PASS |
SW-DOC-04 | 報告的圖表要能被讀懂（CLAUDE.md §6 item 4b）：每張圖需有 aria-label；每張數據圖需有 caption，且 caption 要寫出結論而非重複標題（架構／流程圖屬 item 4，豁免）。⚠️ 規則不追溯——報告以「至少有一張帶 caption 的圖」表示採用此慣例，之後其圖才受檢；該輪之前無任何報告為圖加 caption | tests/test_report_charts.py | ✓ PASS |
SW-DOC-05 | 報告的章節交叉引用必須指得到（CLAUDE.md §6 item 7e）：報告是獨立閱讀的文件，§N 是讀者從結論走到證據的唯一途徑；重新編號章節時，引用它的文字必須同步改。⚠️ 檢查只驗指得到，無法判斷「§9 其實該寫 §10」。既有 4 份報告的 12 個懸空引用列成 KNOWN_DANGLING 明帳，只能減不能加 | tests/test_report_crossrefs.py | ✓ PASS |
SW-DOC-06 | 報告的 ID 對照表要逐項定義（CLAUDE.md Rule 3）：報告引用的每一個 A／D／E／F／R 都要在表裡有自己一列——只定義「家族」與範圍不算數，那回答的是「A 是什麼」不是「其中某一個 id 是什麼」。⚠️ 規則不追溯：以報告是否含「ID 對照」章節判定是否受檢；既有 2 份報告的 18 個未定義 ID 列成 KNOWN_UNDEFINED 明帳，只能減不能加 | tests/test_report_ids.py | ✓ PASS |
SW-DOC-07 | 報告的小節要掛在自己的章節底下（CLAUDE.md §6 item 7f）：不得有 <h3> 排在本節 <h2> 之前；編號 N.M 的小節必須位於編號 N 的 <section> 內；站內連結必須指得到錨點。該輪發生兩次——插入時以「下一個 h2」定位，內容落進下一節，而 HTML 解析／標籤平衡／錨點檢查全部看不出來 | tests/test_report_structure.py | ✓ PASS |
SW-DOC-08 | 報告引用的測試檔必須存在（CLAUDE.md §3 懸空引用原則）：ledger 是審閱者判斷「這個需求有沒有人守」的依據，指向不存在的檔案讀起來和有覆蓋一模一樣，比空白更糟——空白至少會促使人去查。SW-DOC-01 守的是規格↔測試，這條守的是報告↔測試，而後者才是審閱者實際會讀的。⚠️ 只驗檔名；函式是否存在、結果是否與實跑相符，仍是收尾檢查表的工作 | tests/test_report_test_refs.py | ✓ PASS |
| SW-DOC-09 | 累積 ledger 裡「該需求所屬 cycle新增」的高亮必須跟著換手：沒被該需求所屬 cycle新增的列要清掉 class="hl"，只有該需求所屬 cycle自己新增的列能保留，且要帶明確日期（CLAUDE.md §6 rule 7g）。原編號 SW-DOC-08，rebase 到 2026-09-04-ai-agent-ux-alignment 時撞號而改號 | test_report_highlighting.py（1） | ✓ PASS |
| SW_id | 行為（規格） | 測試 | 結果 |
|---|---|---|---|
SW-W-06 | smart-turn 第二句開頭說喚醒詞不觸發喚醒 · 2026-08-17 廢止，與 SW-W-02 互斥，見 SW 規格的廢止紀錄。由 SW-W-13 取代 | — | — |
SW-B-04 | Prefix 出現在 smart-turn 第二句句首不觸發 · 2026-08-17 廢止，與 SW-W-02 互斥，見 SW 規格的廢止紀錄。由 SW-B-10 取代 | — | — |
SW-B-09 | 特定指令於 smart-turn 第二句句首不觸發 · 2026-08-17 廢止，與 SW-W-02 互斥，見 SW 規格的廢止紀錄。由 SW-B-11 取代 | — | — |
SW-TURN-04 | 幽靈 ID（未註冊）——2026-09-05 循環的後續驗證方向指出 tests/functional/live/test_remaining_ux_gaps.py 的 docstring 引用了 SW-TURN-04（UX§3.1 490/510 ms 斷句邊界），但 kitt-stt-sw-spec.md 從未登記此 ID；保留以滿足 SW-DOC-02 的累積 ledger。 | test_remaining_ux_gaps.py（live，docstring 引用） | —（未註冊） |
| —（已移除） | — |
| SW_id | 行為（規格） | 測試 | 結果 |
|---|---|---|---|
SW-HW-01 | from_sense_voice(decoding_method="modified_beam_search") 在未提供 hotwords_file 時必須正常建構並解碼，不得因無條件呼叫熱詞載入而 hard-exit | tests/test_sensevoice_hotword_python_api.py | ✓ PASS |
SW-HW-02 | 載入 hotwords_file 後，對已知因該詞彙被誤聽的音檔，解碼輸出必須改變並更接近正確答案 | tests/test_sensevoice_hotword_python_api.py | ✓ PASS |
SW-HW-03 | hotword_debug 預設 False，此時 hotword_debug_json 維持空字串 | tests/test_sensevoice_hotword_python_api.py | ✓ PASS |
SW-HW-04 | hotword_debug=True 時，解碼結果必須帶有逐 frame 的真實除錯軌跡 | tests/test_sensevoice_hotword_python_api.py | ✓ PASS |
SW-HW-05 | 除錯軌跡的每個 frame 必須額外帶 beams：依 total_score 排序的候選路徑分數拆解 | tests/test_sensevoice_hotword_python_api.py；C++ 側 offline-ctc-prefix-beam-search-decoder-test.cc::DebugRankedBeamsExposeWhyTheFlipHappened | ✓ PASS |
SW-HW-06 | add_hotwords_dict({phrase: weight_or_None})：執行期純新增熱詞，不重建 recognizer、不讀檔案，且不覆寫既有詞 | tests/test_sensevoice_hotword_python_api.py；C++ 側 offline-ctc-prefix-beam-search-decoder-test.cc::SetContextGraphAffectsOnlySubsequentDecodes | ✓ PASS |
SW-HW-07 | 建構時的 hotwords_file 參數維持既有行為：讀取純文字檔轉成 C++ 端可用的熱詞資料結構 | tests/test_sensevoice_hotword_python_api.py | ✓ PASS |
SW-HW-08 | features.enable_hotwords 與 hotwords.{file,score,max_active_paths} 正式接進 BatchASRManager._build()／KittSttService：只有熱詞檔含真正內容時才切到 modified_beam_search，否則（含空檔）維持 greedy_search；空檔或純註解檔維持 no-op。 | tests/test_batch_asr_manager_hotwords.py（6）、tests/test_config_hotwords.py（2）、tests/test_hotwords_default_file.py（3） | ✓ PASS |
| 驗收 ID | 行為 | 測試（file::test） | 結果 |
|---|---|---|---|
| A1 | 第一次 interim 無前次延遲 → 用 initial_interval | test_audio_cfg::test_next_interval_uses_initial_when_no_prior_latency | ✓ PASS |
| A2 | 間隔 = max(延遲×margin, 地板)，無上限 | test_audio_cfg::test_next_interval_is_latency_times_margin_above_the_floor / test_next_interval_has_no_upper_ceiling | ✓ PASS |
| 延遲很小時被地板夾住 | test_audio_cfg::test_next_interval_clamped_to_floor_for_small_latency | ✓ PASS | |
| A3–A5 | margin≤1 / 地板≤0 / 初始值≤0 → ValidationError | test_audio_cfg::test_safety_margin_must_be_greater_than_one / test_min_interval_must_be_positive / test_initial_interval_must_be_positive | ✓ PASS |
| A6 | ASR_INTERIM_SAFETY_MARGIN 覆寫 / 未設時吃 YAML | test_audio_cfg::test_env_var_overrides_margin / test_no_env_var_keeps_yaml_default | ✓ PASS |
| 驗收 ID | 行為 | 測試（file::test） | 結果 |
|---|---|---|---|
| SW-PERF-01 | 連線無錯誤 | test_audio_stress::test_audio_stress_no_errors | ✓ PASS |
| SW-PERF-01 | 90 秒連續長句仍收到 final | test_audio_stress::test_audio_stress_final_received | ✓ PASS |
| SW-PERF-01 | time to final 有界 | test_audio_stress::test_audio_stress_time_to_final_bounded | ✓ PASS |
| SW-PERF-01 | 相鄰 interim 最大間隔有界 | test_audio_stress::test_audio_stress_interim_gap_bounded | ✓ PASS |
| 驗收 ID | 行為 | 測試（file::test） | 結果 |
|---|---|---|---|
| B1 | interim 只套用 s2t()，不做數字正規化 | test_batch_asr_manager_itn_split::test_interim_inference_only_applies_s2t_not_numeral_normalization | ✓ PASS |
| B2 | final 仍套用完整 itn()（s2t + 數字），不受影響 | test_batch_asr_manager_itn_split::test_offline_inference_still_applies_full_itn | ✓ PASS |
| 驗收 ID | 行為 | 測試（file::test） | 結果 |
|---|---|---|---|
| B14-R1 | RTF 只計 decode_stream() 的時間，不含鎖等待 | test_interim_concurrency::test_decode_ms_and_latency_ms_agree_with_no_contention / test_decode_ms_excludes_lock_queueing_but_latency_ms_includes_it | ✓ PASS |
| B14-R2 | 每個 session 有獨立的 buffer_lock，與 inference_lock 分開，且真的序列化併發存取 | test_interim_concurrency::test_buffer_lock_is_per_session_and_separate_from_inference_lock / test_buffer_lock_serializes_append_against_read | ✓ PASS |
| B19-R1 | _interim_redecode_body 不得被 inline await；恰有一次背景派發，且必須是 self.create_task | test_interim_concurrency::test_interim_redecode_is_dispatched_never_awaited | ✓ PASS |
| B19-R2 | ×人數 不得偷渡回來：呼叫端只能帶 1 個位置引數，函式簽名不得有人數參數 | test_interim_concurrency::test_the_schedule_is_never_given_a_speaker_count | ✓ PASS |
| B19-R3 | 三個已移除的旗標保持移除：FeaturesCfg 無欄位、config-basic.yaml 無鍵，舊 override 檔仍可載入且為惰性 | test_interim_concurrency::test_the_removed_knobs_stay_removed | ✓ PASS |
| F_id / SW_id | Feature / 行為 | 歸屬 |
|---|---|---|
| F_1 | 多音區識別/控制（權限·AreaID·多區並行） | 下游 + STT per-user_id hook |
| F_4.1 | 語音打斷_背景併行處理 | 下游 DM/TTS |
| F_4.2 | 語音打斷_後令壓前令 | 下游 DM 仲裁 |
| F_5 | 連續指令 | 下游 NLU 拆解（UX§4.2.1 拆解成功率同歸此列） |
| F_6 | 上下文理解 | 下游 DM 快取（UX§5 保留輪數同歸此列） |
| F_3.4c | 最大錄音時限自動停止 | kitt-web-ui——✓ 已實作，設定 20s（2026-09-04 UX cycle 記錄的使用者確認；2026-09-05 未驗證 Web UI） |
| SW-UI-06 | 講話中切 mic 靜音、WebUI 不卡字 | web-ui（無 STT 測試） |
| SW-MU-01..08 | 多使用者/多車喚醒同步、隔離 | web-ui（STT 提供 per-user_id / ?car= hook） |
UX§1.3.1／UX§7／UX§9／UX§10（除 11.3） | 問候語 UI／Guardrail／回復策略／顯示策略 | 下游 UI/LLM/TTS |
| SW_id | 行為 | 測試 | 結果 |
|---|---|---|---|
| — 刻意不掛 SW_id |
interim 重解碼的特徵抽取增量化：增量餵入與一次性餵入產生的特徵必須逐 bit 相同；
持續 stream 不得跨 utterance 復用；該句的 final 沿用同一個 stream 只補未餵的尾巴；
餵入失敗必須可見且可復原（拋 IncrementalFeedError、游標只在成功後推進、
半餵的 stream 丟棄重建）；交棒不得在 interim 餵入中途發生（否則 final 重複餵同一段音訊） |
tests/test_offline_stream_incremental.py（8） tests/test_batch_asr_manager_incremental_prep.py（8） tests/test_interim_incremental_wiring.py（6） tests/test_final_stream_reuse.py（9） |
31/31 PASS · 2026-09-05 offline |
最終 HEAD 基於 origin/main 3c0282d7，現行 SW 規格共有 159 個 SW_id。此表只記錄同一 MR 併入的非 EOT 路徑之最終結果；EOT 結論仍見上方 §3。
| 需求／範圍 | 本輪結果 | 證據或未驗原因 |
|---|---|---|
SW-DOC-10、SW-FT-09..13、SW-HW-10、SW-LANG-03..14、SW-LANG-16、SW-LANG-18..30、SW-OPS-08、SW-PERF-07 | ✓ PASS | 登記的 unit／scenario tests 443 passed；其餘輔助測項 114 passed；完整 offline 1661 passed、33 skipped。 |
SW-HR-01、SW-HW-09 | ✓ PASS | 公司名行為與熱詞測項通過；安裝 hr-build group 的 pynini 後，FST 與詞表重建相等性 test_committed_fst_is_built_from_the_word_maps 1/1 通過。 |
SW-LANG-15、SW-LANG-17 | NOT-VERIFIED | 測試正確 skip：缺 lid_risk.json／probe.json GPU＋TTS 量測 artifact；不能把沒有量測資料當 PASS。 |
SW-LANG-02、non-wake／10-second prompt／vehicle hotwords | ✓ PASS | current-default v3b CUDA live：中英夾雜兩案、non-wake、10-second prompt、除霧與小憩模式均通過。 |
SW-W-10、SW-B-03、未註冊 SW-TURN-04 | ✗ FAIL | current-default vad／wait_secs=0.1 下重現 3 例。前兩例的 fixture 沒有選 smart-turn 卻期待跨段黏合；490 ms 例缺 UX 要求的 500 ms command wait。 |
| 範圍 | 結果 | 說明 |
|---|---|---|
| Status／config focused | 60 passed | 設定與狀態頁讓三種 backend 接受 0.1–3.0 秒，並涵蓋空 VAD summary、VAD 模式 wake／wait 儲存與 reset、WAV 180 秒 hard cap／逐筆與全部 ZIP 下載，以及 runtime backend controls。 |
| Startup backend contract | 2 passed | VAD 不建構 TurnSense；明確選擇 TurnSense 時 preload failure 中止啟動。 |
| Report contract | 140 passed, 1 skipped | 最終 HTML 的結構、連結、SW_id、圖表與測試引用檢查。 |
| Offline full | 1661 passed, 33 skipped | 以目前 v3b workspace 完整重跑；先前 sandbox 卡住與缺 WAV 的結果均未在 host test environment 重現。 |
| current-default v3b CUDA live | 12 passed, 3 failed | 失敗為 test_active_smart_turn、test_prefix_smart_turn、490 ms command-wait boundary；10-second prompt 已通過。 |
| 2026-09-15 v3b Live WebSocket／CUDA | 41 passed | 隔離 container：拒識 2、退出詞 13×10、wake／false wake／rate、主動問候／latency、車載 hotword；JUnit 0 errors／0 failures，43m33s。 |
| 驗證範圍 | 命令 |
|---|---|
| Current default config + status（60 passed） | PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -m pytest -q tests/test_turn_backend_config.py tests/test_status_page_settings.py |
| Current startup backend contract（2 passed） | PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -m pytest -q tests/turnsense/test_runtime.py -k 'vad_backend_skips_runtime_construction or turnsense_backend_preload_failure_still_aborts_startup' |
| Current-default host GPU startup/status（PASS） | 以臨時 overlay 將 server.port 設為未使用的 <port>：PYTHONPATH=./sherpa-onnx/build ASR_CONFIG_FILE=<overlay.yaml> .venv/bin/python -m src.server；再以 curl --fail http://127.0.0.1:<port>/stt/sensevoice 確認 data-current="vad"。 |
| TurnSense runtime（15 passed） | PYTHONDONTWRITEBYTECODE=1 uv run --frozen --group test pytest -q --tb=short tests/turnsense/test_runtime.py |
| Offline full（1661 passed, 33 skipped） | PYTHONDONTWRITEBYTECODE=1 uv run --frozen --group test pytest -q --tb=short tests --ignore=tests/functional/live --ignore=tests/sherpa-onnx |
| v3b selected offline（220 passed） | uv run --frozen --group test pytest -q tests/test_max_utterance_audio.py tests/test_eot_state.py tests/test_eot_kws_precedence.py tests/test_turn_backend_config.py tests/test_status_page_settings.py tests/test_cx1_deployment.py tests/test_exit_word.py tests/test_wake_matcher.py tests/test_hotwords_default_file.py；另跑 tests/test_wake_false_accept.py（2）與 tests/test_greeting_settings.py（12） |
| v3b Live WebSocket／CUDA（41 passed） | 以同步模型快照的 isolated Docker image：HOST_PORT=<free-port> LIVE_TEST_TARGET=tests/functional/live/test_rejection_thresholds.py ./tests/docker-test.sh --build；再跑 test_exit_words.py、test_wake.py、test_wake_factory_words.py、test_wake_rate.py、test_active_greeting.py、test_wake_latency.py、test_hotwords_vehicle_terms.py |
| 2026-09-15 report contract（140 passed, 1 skipped） | uv run --frozen --group test pytest -q tests/test_report_*.py |
| current-default v3b CUDA live（12 passed, 3 failed） | 以同步模型快照的 isolated Docker image：IMAGE=kitt-stt:fail-notverified-20260915 HOST_PORT=<free-port> LIVE_TEST_TARGET=tests/functional/live/test_active.py ./tests/docker-test.sh；再跑 test_bypass_prefix.py、test_bilingual.py、test_remaining_ux_gaps.py、test_hotwords_vehicle_terms.py。 |
| Static | git diff --check · bash -n deploy.sh |
vad。Smart Turn 仍非出廠值。wait_ms 以 0.1 秒精度顯示。滑桿不是 mode switch，也不編輯 complete threshold。喚醒／免喚醒詞仍依 ?car=；wait 滑桿套用目前 backend，且全行程共用。vad／0.1 秒設定下，490 ms command-wait boundary 仍為 RED（510 ms 兩 turn 例通過）；另有 SW-W-10、SW-B-03 transcript 期望差異。完整狀態見§3 已知缺口。data-current=vad；隔離 Docker 的 v3b WebSocket selected suite 為 41 passed。current-default targeted live 為 12 passed、3 failed。