dsh-voice-mode 0.6.0 → 0.7.0

package/lib/client.js

@@ -72,9 +72,288 @@ function matchWakeWord(partial, wakeWord) {
   return false;
 }
 
+// src/fixture-recorder.ts
+var FLAG = "dsh-voice-mode.record";
+var MAX_SECONDS = 180;
+var SAMPLE_RATE = 16e3;
+function recordMode() {
+  try {
+    const v = localStorage.getItem(FLAG);
+    if (v === "full") return "full";
+    if (v === "meta" || v === "1") return "meta";
+  } catch {
+  }
+  return "off";
+}
+var Track = class {
+  chunks = [];
+  total = 0;
+  push(f) {
+    const out = new Int16Array(f.length);
+    for (let i = 0; i < f.length; i++) {
+      const v = Math.max(-1, Math.min(1, f[i]));
+      out[i] = v < 0 ? v * 32768 : v * 32767;
+    }
+    this.chunks.push(out);
+    this.total += out.length;
+  }
+  get length() {
+    return this.total;
+  }
+  toBase64() {
+    const all = new Int16Array(this.total);
+    let off = 0;
+    for (const c of this.chunks) {
+      all.set(c, off);
+      off += c.length;
+    }
+    const bytes = new Uint8Array(all.buffer);
+    let bin = "";
+    const STEP = 32768;
+    for (let i = 0; i < bytes.length; i += STEP) {
+      bin += String.fromCharCode(...bytes.subarray(i, i + STEP));
+    }
+    return btoa(bin);
+  }
+  clear() {
+    this.chunks = [];
+    this.total = 0;
+  }
+};
+var FixtureRecorder = class {
+  mode = "off";
+  active = false;
+  startedAt = 0;
+  frames = [];
+  marks = [];
+  detects = [];
+  micTrack = new Track();
+  refTrack = new Track();
+  resTrack = new Track();
+  /** 残差与 mic 是否出现过差异（原生 AEC 失效时自研 NLMS 生效）——决定是否落残差轨。 */
+  resDiffers = false;
+  env = {};
+  badge = null;
+  userSpeaking = false;
+  keyHandler = null;
+  get isActive() {
+    return this.active;
+  }
+  /** 进入语音模式时调用。档位为 off 时什么都不做。 */
+  begin(env) {
+    const mode = recordMode();
+    if (mode === "off") {
+      this.mode = "off";
+      return;
+    }
+    if (this.active) this.save("restart");
+    this.mode = mode;
+    this.active = true;
+    this.startedAt = Date.now();
+    this.frames = [];
+    this.marks = [];
+    this.detects = [];
+    this.micTrack.clear();
+    this.refTrack.clear();
+    this.resTrack.clear();
+    this.resDiffers = false;
+    this.userSpeaking = false;
+    this.env = env;
+    this.mark("begin", mode);
+    this.mountBadge();
+    this.bindKeys();
+    try {
+      ;
+      window.__dshvmRec = {
+        \u8BF4\u8BDD\u5F00\u59CB: () => this.setUserSpeaking(true),
+        \u8BF4\u8BDD\u7ED3\u675F: () => this.setUserSpeaking(false),
+        \u4FDD\u5B58: () => this.save("console"),
+        \u6807\u6CE8: (kind, note) => this.mark(kind, note),
+        \u72B6\u6001: () => ({ mode: this.mode, \u5E27\u6570: this.frames.length, \u6807\u6CE8\u6570: this.marks.length, \u8BF4\u8BDD\u4E2D: this.userSpeaking })
+      };
+    } catch {
+    }
+    console.log(
+      `[dsh-voice][rec] \u5F00\u59CB\u5F55\u5236\uFF08${mode}\uFF09\xB7 F8=\u6807\u6CE8\u8BF4\u8BDD \xB7 F9=\u4FDD\u5B58\u4E0B\u8F7D
+[dsh-voice][rec] \u952E\u76D8\u4E0D\u7075\u65F6\u7528\u63A7\u5236\u53F0\uFF1A__dshvmRec.\u8BF4\u8BDD\u5F00\u59CB() / .\u8BF4\u8BDD\u7ED3\u675F() / .\u4FDD\u5B58() / .\u72B6\u6001()`
+    );
+  }
+  /**
+   * 逐帧写入。在 asr.ts handleAudio 里 AEC 与门控统计算完之后调用。
+   * micPre = AEC 前（重采样后）；ref = 参考窗；res = AEC 后残差（判定链实际输入）。
+   */
+  frame(micPre, ref, res, stats) {
+    if (!this.active) return;
+    const t3 = Date.now() - this.startedAt;
+    if (t3 > MAX_SECONDS * 1e3) {
+      this.mark("auto-stop", `\u5230\u8FBE ${MAX_SECONDS}s \u4E0A\u9650`);
+      this.save("maxlen");
+      return;
+    }
+    this.frames.push({
+      t: t3,
+      rms: round6(stats.rms),
+      mic: round6(rmsOf(micPre)),
+      ref: round6(ref ? rmsOf(ref) : 0),
+      fl: round6(stats.floorRms),
+      pk: round6(stats.peakRms),
+      dt: stats.doubleTalk ? 1 : 0,
+      pt: stats.playingTail ? 1 : 0
+    });
+    if (this.mode === "full") {
+      this.micTrack.push(micPre);
+      this.refTrack.push(ref ?? new Float32Array(micPre.length));
+      if (res !== micPre) {
+        if (!this.resDiffers) this.resDiffers = true;
+        this.resTrack.push(res);
+      } else if (this.resDiffers) {
+        this.resTrack.push(res);
+      }
+    }
+    this.refreshBadge();
+  }
+  /**
+   * 检测通道一次往返（A 档埋点）：分离「请求在途慢」与「客户端没排上」。
+   * 停顿归因的唯一依据——回报间隔 = 往返耗时 + 客户端等待，此处记的是前者。
+   */
+  noteDetect(sentAt, rttMs, ok, samples) {
+    if (!this.active) return;
+    this.detects.push({ t: sentAt - this.startedAt, rtt: rttMs, ok: ok ? 1 : 0, n: samples });
+  }
+  /** host 下行 isSpeech：盖在最近一帧上。 */
+  noteIsSpeech(speech) {
+    if (!this.active || speech === void 0) return;
+    const last = this.frames[this.frames.length - 1];
+    if (last) last.spk = speech ? 1 : 0;
+  }
+  /** 播放态（裸口径）变化 / 打断触发 / 句子边界等事件。 */
+  mark(kind, note) {
+    if (!this.active && kind !== "begin") return;
+    this.marks.push({ t: Date.now() - this.startedAt, kind, note });
+  }
+  /** 保存并触发下载。reason 只用于文件名与日志。 */
+  save(reason = "manual") {
+    if (!this.active) return;
+    this.active = false;
+    this.unbindKeys();
+    this.unmountBadge();
+    const durationMs = Date.now() - this.startedAt;
+    const payload = {
+      schema: "dsh-voice-mode/fixture@1",
+      recordedAt: new Date(this.startedAt).toISOString(),
+      reason,
+      mode: this.mode,
+      sampleRate: SAMPLE_RATE,
+      durationMs,
+      env: this.env,
+      frames: this.frames,
+      marks: this.marks,
+      detects: this.detects
+    };
+    if (this.mode === "full" && this.micTrack.length > 0) {
+      payload.audio = {
+        encoding: "int16le-base64",
+        mic: this.micTrack.toBase64(),
+        ref: this.refTrack.toBase64(),
+        ...this.resDiffers ? { res: this.resTrack.toBase64() } : {}
+      };
+    }
+    const name = `dshvm-fixture-${new Date(this.startedAt).toISOString().replace(/[:.]/g, "-")}-${reason}.json`;
+    try {
+      const blob = new Blob([JSON.stringify(payload)], { type: "application/json" });
+      const url = URL.createObjectURL(blob);
+      const a = document.createElement("a");
+      a.href = url;
+      a.download = name;
+      document.body.appendChild(a);
+      a.click();
+      a.remove();
+      setTimeout(() => URL.revokeObjectURL(url), 1e4);
+      console.log(
+        `[dsh-voice][rec] \u5DF2\u4FDD\u5B58 ${name}\uFF1A${this.frames.length} \u5E27 / ${(durationMs / 1e3).toFixed(1)}s / \u6807\u6CE8 ${this.marks.length} \u6761 / \u68C0\u6D4B\u5F80\u8FD4 ${this.detects.length} \u6B21`
+      );
+    } catch (e) {
+      console.warn("[dsh-voice][rec] \u4FDD\u5B58\u5931\u8D25\uFF1A" + String(e));
+    }
+    this.micTrack.clear();
+    this.refTrack.clear();
+    this.resTrack.clear();
+  }
+  /** 说话区间标注（键盘与控制台入口共用；重复置同一状态不产生重复标注）。 */
+  setUserSpeaking(on) {
+    if (!this.active || this.userSpeaking === on) return;
+    this.userSpeaking = on;
+    this.mark(on ? "user-speech-start" : "user-speech-end");
+    console.log(`[dsh-voice][rec] \u6807\u6CE8\uFF1A${on ? "\u5F00\u59CB\u8BF4\u8BDD" : "\u8BF4\u5B8C\u4E86"}`);
+    this.refreshBadge();
+  }
+  // ── 键盘标注 ──
+  bindKeys() {
+    this.keyHandler = (e) => {
+      if (e.key === "F8") {
+        e.preventDefault();
+        this.setUserSpeaking(!this.userSpeaking);
+      } else if (e.key === "F9") {
+        e.preventDefault();
+        this.save("hotkey");
+      }
+    };
+    window.addEventListener("keydown", this.keyHandler, true);
+  }
+  unbindKeys() {
+    if (this.keyHandler) window.removeEventListener("keydown", this.keyHandler, true);
+    this.keyHandler = null;
+  }
+  // ── 徽标（自包含 DOM，不接 React）──
+  mountBadge() {
+    try {
+      const el = document.createElement("div");
+      el.style.cssText = [
+        "position:fixed",
+        "top:8px",
+        "right:8px",
+        "z-index:2147483647",
+        "padding:6px 10px",
+        "border-radius:6px",
+        "background:rgba(180,20,20,.92)",
+        "color:#fff",
+        "font:12px/1.4 ui-monospace,SFMono-Regular,Consolas,monospace",
+        "pointer-events:none",
+        "white-space:pre"
+      ].join(";");
+      document.body.appendChild(el);
+      this.badge = el;
+      this.refreshBadge();
+    } catch {
+    }
+  }
+  refreshBadge() {
+    if (!this.badge) return;
+    const s = ((Date.now() - this.startedAt) / 1e3).toFixed(1);
+    const last = this.frames[this.frames.length - 1];
+    this.badge.textContent = `\u25CF REC ${this.mode}  ${s}s  ${this.frames.length}\u5E27` + (this.userSpeaking ? "  [\u8BF4\u8BDD\u4E2D]" : "") + (last ? `
+resid ${last.rms.toFixed(4)}  floor ${last.fl.toFixed(4)}  peak ${last.pk.toFixed(4)}` : "") + "\nF8 \u6807\u6CE8\u8BF4\u8BDD \xB7 F9 \u4FDD\u5B58";
+  }
+  unmountBadge() {
+    try {
+      this.badge?.remove();
+    } catch {
+    }
+    this.badge = null;
+  }
+};
+function rmsOf(x) {
+  if (x.length === 0) return 0;
+  let s = 0;
+  for (let i = 0; i < x.length; i++) s += x[i] * x[i];
+  return Math.sqrt(s / x.length);
+}
+var round6 = (v) => Math.round(v * 1e6) / 1e6;
+var fixtureRecorder = new FixtureRecorder();
+
 // src/asr.ts
 var workletBlobUrl = null;
-var SAMPLE_RATE = 16e3;
+var SAMPLE_RATE2 = 16e3;
 var SPEECH_RMS = 0.015;
 var LEVEL_CEILING = 0.25;
 var MAX_SEGMENT_MS = 3e4;
@@ -120,7 +399,7 @@ function createAsrEngine(config, sessionId) {
   let stopRequested = false;
   let startSeq = 0;
   let inFlush = false;
-  let ctxRate = SAMPLE_RATE;
+  let ctxRate = SAMPLE_RATE2;
   let speechActive = false;
   let segment = [];
   let segmentMs = 0;
@@ -179,7 +458,7 @@ function createAsrEngine(config, sessionId) {
   const requestPartial = async () => {
     if (partialInFlight || segment.length === 0) return;
     const total = segment.reduce((n, c) => n + c.length, 0);
-    const seconds = total / SAMPLE_RATE;
+    const seconds = total / SAMPLE_RATE2;
     if (seconds < PARTIAL_MIN_S || seconds > PARTIAL_MAX_S) return;
     const from = uploadedSamples;
     if (total - from <= 0) return;
@@ -257,7 +536,7 @@ function createAsrEngine(config, sessionId) {
   const requestDetect = async () => {
     if (detectInFlight) return;
     let total = detectChunks.reduce((n, c) => n + c.length, 0);
-    const MAX_DETECT_PENDING = 30 * SAMPLE_RATE;
+    const MAX_DETECT_PENDING = 1 * SAMPLE_RATE2;
     if (total - detectSent > MAX_DETECT_PENDING) {
       detectSent = Math.max(0, total - MAX_DETECT_PENDING);
     }
@@ -271,6 +550,8 @@ function createAsrEngine(config, sessionId) {
     const epoch = segmentEpoch;
     const gen = detectGeneration;
     detectInFlight = true;
+    const sentAt = Date.now();
+    let rttMs = -1;
     try {
       const res = await fetch(asrUrl(false, detectSent, epoch) + "&vadOnly=1", {
         method: "POST",
@@ -279,6 +560,7 @@ function createAsrEngine(config, sessionId) {
         signal: AbortSignal.timeout(5e3)
         // 防服务端挂起长期锁死 detectInFlight（Important#2）
       });
+      rttMs = Date.now() - sentAt;
       if (epoch !== segmentEpoch || gen !== detectGeneration) return;
       if (!res.ok) return;
       const out = await res.json();
@@ -292,6 +574,9 @@ function createAsrEngine(config, sessionId) {
     } catch {
     } finally {
       detectInFlight = false;
+      if (fixtureRecorder.isActive) {
+        fixtureRecorder.noteDetect(sentAt, rttMs < 0 ? Date.now() - sentAt : rttMs, rttMs >= 0, samples.length);
+      }
     }
   };
   const resetHostStream = async () => {
@@ -409,15 +694,18 @@ function createAsrEngine(config, sessionId) {
   let echoPeak = 0;
   const handleAudio = (raw) => {
     if (!active || inFlush) return;
-    let data = ctxRate !== SAMPLE_RATE ? resampleLinear(raw, ctxRate, SAMPLE_RATE) : raw;
+    let data = ctxRate !== SAMPLE_RATE2 ? resampleLinear(raw, ctxRate, SAMPLE_RATE2) : raw;
+    const recMicPre = data;
+    let recRef = null;
     if (echo) {
       const ref = echo.windowAt(performance.now(), data.length);
+      recRef = ref;
       data = echo.process(data, ref);
     }
     let sum = 0;
     for (let i = 0; i < data.length; i++) sum += data[i] * data[i];
     const rms = Math.sqrt(sum / data.length);
-    const durationMs = data.length / SAMPLE_RATE * 1e3;
+    const durationMs = data.length / SAMPLE_RATE2 * 1e3;
     for (const fn of levelListeners) {
       try {
         fn(Math.min(1, rms / LEVEL_CEILING));
@@ -442,6 +730,15 @@ function createAsrEngine(config, sessionId) {
     if (echo) {
       echo.setFrozen(doubleTalk);
     }
+    if (fixtureRecorder.isActive) {
+      fixtureRecorder.frame(recMicPre, recRef, data, {
+        rms,
+        floorRms: echoFloorRms,
+        peakRms: echoPeak,
+        doubleTalk,
+        playingTail: playingNow
+      });
+    }
     if (playingNow && !holdActive && config.mode !== "hold") detectChunks.push(data);
     if (holdActive) {
       if (!speechActive) {
@@ -468,23 +765,23 @@ function createAsrEngine(config, sessionId) {
     } else if (rms > SPEECH_RMS) {
       if (config.isPlaying?.()) {
         if (speechActive) finalizeSegment(true);
-        return;
-      }
-      if (!speechActive) {
-        speechActive = true;
-        detectChunks = [];
-        detectSent = 0;
-        detectGeneration++;
-        utteranceEndAt = null;
-        setState("speech");
-        for (const p of prePad) segment.push(p);
-        prePad = [];
+      } else {
+        if (!speechActive) {
+          speechActive = true;
+          detectChunks = [];
+          detectSent = 0;
+          detectGeneration++;
+          utteranceEndAt = null;
+          setState("speech");
+          for (const p of prePad) segment.push(p);
+          prePad = [];
+        }
+        speechMs += durationMs;
+        segmentMs += durationMs;
+        silenceMs = 0;
+        segment.push(data);
+        if (segmentMs > MAX_SEGMENT_MS) finalizeSegment();
       }
-      speechMs += durationMs;
-      segmentMs += durationMs;
-      silenceMs = 0;
-      segment.push(data);
-      if (segmentMs > MAX_SEGMENT_MS) finalizeSegment();
     } else if (speechActive) {
       if (utteranceEndAt === null) {
         utteranceEndAt = Date.now();
@@ -515,7 +812,7 @@ function createAsrEngine(config, sessionId) {
       let total = 0;
       let cut = 0;
       for (let i = prePad.length - 1; i >= 0; i--) {
-        total += prePad[i].length / SAMPLE_RATE * 1e3;
+        total += prePad[i].length / SAMPLE_RATE2 * 1e3;
         if (total > PRE_PAD_MS) {
           cut = i + 1;
           break;
@@ -526,11 +823,15 @@ function createAsrEngine(config, sessionId) {
     const nowMs = Date.now();
     if (nowMs - lastPollAt >= PARTIAL_INTERVAL_MS) {
       if (playingNow && !speechActive && !holdActive) {
-        lastPollAt = nowMs;
-        void requestDetect();
+        if (!detectInFlight) {
+          lastPollAt = nowMs;
+          void requestDetect();
+        }
       } else if (speechActive || holdActive || state === "wake") {
-        lastPollAt = nowMs;
-        void requestPartial();
+        if (!partialInFlight) {
+          lastPollAt = nowMs;
+          void requestPartial();
+        }
       }
     }
   };
@@ -559,7 +860,7 @@ function createAsrEngine(config, sessionId) {
     }
     config.onAecState?.(aecOn);
     const AC = window.AudioContext ?? window.webkitAudioContext;
-    audioCtx = new AC({ sampleRate: SAMPLE_RATE });
+    audioCtx = new AC({ sampleRate: SAMPLE_RATE2 });
     try {
       await audioCtx.resume?.();
     } catch {
@@ -578,7 +879,7 @@ function createAsrEngine(config, sessionId) {
         };
         source.connect(workletNode);
         workletNode.connect(audioCtx.destination);
-        ctxRate = SAMPLE_RATE;
+        ctxRate = SAMPLE_RATE2;
         active = true;
         return;
       } catch {
@@ -633,7 +934,7 @@ function createAsrEngine(config, sessionId) {
     } catch {
     }
     audioCtx = null;
-    ctxRate = SAMPLE_RATE;
+    ctxRate = SAMPLE_RATE2;
     inFlush = false;
   };
   return {
@@ -681,7 +982,7 @@ function createAsrEngine(config, sessionId) {
       setState("idle");
     },
     forceSend() {
-      const speechS = segment.reduce((n, c) => n + c.length, 0) / SAMPLE_RATE;
+      const speechS = segment.reduce((n, c) => n + c.length, 0) / SAMPLE_RATE2;
       if (speechActive && speechS >= 0.25) {
         forcePending = true;
         lastPollAt = 0;
@@ -2184,7 +2485,7 @@ var TELEMETRY_VIEW = [
   { stage: "first-tts-chunk", key: "telFirstChunk" },
   { stage: "first-audio-played", key: "telFirstPlayed" }
 ];
-var BUILD_TAG = "d4c61da";
+var BUILD_TAG = "054e486";
 var TELEMETRY_FLAG = "dsh-voice-mode.telemetry";
 var telemetryEnabled = typeof localStorage !== "undefined" && localStorage.getItem(TELEMETRY_FLAG) === "1";
 console.log("[dsh-voice] build=" + BUILD_TAG);
@@ -2377,6 +2678,7 @@ function createAudioEngine(setUi, onPlayed, onPlaybackRef, onAllPlayed) {
       }
     };
     setUi({ playing: true, playingCaption: frame.text, ttsNotice: null });
+    fixtureRecorder.mark("tts-sentence", frame.text);
     void fallbackAudio.play().catch(() => playFallback());
   };
   const drainPending = () => {
@@ -2419,6 +2721,7 @@ function createAudioEngine(setUi, onPlayed, onPlaybackRef, onAllPlayed) {
           }
           captionQueue.push(frame.text);
           setUi({ playing: true, playingCaption: captionQueue[0], ttsNotice: null });
+          fixtureRecorder.mark("tts-sentence", frame.text);
         }
       } catch {
         for (const src of activeSrcs) {
@@ -2911,6 +3214,16 @@ function useVoiceCss() {
 @keyframes dshvm-eq { 0%, 100% { transform: scaleY(0.35) } 50% { transform: scaleY(1) } }
 @keyframes dshvm-spin { to { transform: rotate(360deg) } }
 .dshvm-bar { width: 3px; border-radius: 99px; transition: height 0.08s linear, opacity 0.08s linear }
+/* \u9EA6\u514B\u98CE\u6309\u94AE\u6240\u5728\u7684\u5BBF\u4E3B\u5BB9\u5668\u4E5F\u7981\u9009\uFF1A\u624B\u6307\u504F\u5927\u65F6\u957F\u6309\u53EF\u80FD\u547D\u4E2D\u6309\u94AE\u5916\u4FA7\u7684\u5BB9\u5668\u7559\u767D\uFF0C
+   \u6D4F\u89C8\u5668\u5C31\u8FD1\u9009\u4E2D\u300C\u8BED\u97F3\u300D\u6807\u7B7E\u6587\u5B57\u3002 */
+:has(> [data-dshvm="mic"]) { -webkit-user-select: none; user-select: none; -webkit-touch-callout: none }
+/* \u6309\u4F4F\u8BF4\u8BDD\u671F\u95F4\u6574\u9875\u7981\u9009\uFF08!important \u538B\u8FC7\u5BBF\u4E3B\u6837\u5F0F\uFF09\uFF1A\u5B89\u5353/\u684C\u9762\u5728\u957F\u6309\u6216\u6309\u4F4F\u5FAE\u62D6\u65F6
+   \u4F1A\u4ECE\u6309\u94AE\u9644\u8FD1\u5F00\u59CB\u9009\u533A\uFF0C\u51FA\u73B0\u84DD\u8272\u9AD8\u4EAE\u548C\u9009\u62E9\u624B\u67C4\uFF0C\u5BFC\u81F4\u300C\u6309\u4F4F\u8BF4\u8BDD\u300D\u4E0D\u53EF\u7528\u3002 */
+html.dshvm-holding, html.dshvm-holding * {
+  -webkit-user-select: none !important;
+  user-select: none !important;
+  -webkit-touch-callout: none !important;
+}
 `;
     document.head.appendChild(el);
   }, []);
@@ -3022,6 +3335,7 @@ function MicButton({
     clearIdle();
     cancelPendingSubmit();
     isSpeechTrueCount = 0;
+    fixtureRecorder.save("exit");
     breakRef.current = null;
     manualHoldRef.current = false;
     clearBreakTimer();
@@ -3103,6 +3417,7 @@ function MicButton({
           // 判真实人声前沿；仅 AI 朗读中（bus.ui.playing）触发 hardBreak，
           // 防 TTS 回声被 VAD 误判为语音而自打断。
           onIsSpeech: (speech) => {
+            fixtureRecorder.noteIsSpeech(speech);
             if (bargeInMode === "manual") return;
             if (!bus.ui.playing) {
               isSpeechTrueCount = 0;
@@ -3149,6 +3464,7 @@ function MicButton({
                 });
                 interruptFirstAt = 0;
                 isSpeechTrueCount = 0;
+                fixtureRecorder.mark("interrupt", `confirmMs=${confirmMs}`);
                 resetIdle();
                 bus.resetTelemetry();
                 bus.setUi({ interruptConfirmMs: confirmMs });
@@ -3182,12 +3498,20 @@ function MicButton({
             debugLog("aec-state", { nativeEchoCancellation: on2 });
             bus.setEchoBypass(on2);
             bus.setUi({ aecOff: !on2 });
+            fixtureRecorder.mark("native-aec", on2 ? "on\uFF08\u81EA\u7814 NLMS \u65C1\u8DEF\uFF09" : "off\uFF08\u81EA\u7814 NLMS \u751F\u6548\uFF09");
           }
         },
         sid
       );
       bus.setUi({ mode: cfg.mode });
       engineRef.current = engine;
+      fixtureRecorder.begin({
+        build: BUILD_TAG,
+        mode: cfg.mode,
+        bargeInMode,
+        echoGateDb: cfg.echoGateDb,
+        interruptLevel
+      });
       engine.onTelemetry((e) => bus.stampTelemetry(e.stage, e.at));
       bus.warmAudio();
       try {
@@ -3502,7 +3826,53 @@ function MicButton({
       breakTimerRef.current = null;
     }
   };
+  const selectGuardRef = (0, import_react2.useRef)(null);
+  const unlockSelection = () => {
+    const off = selectGuardRef.current;
+    if (!off) return;
+    selectGuardRef.current = null;
+    off();
+    try {
+      window.getSelection()?.removeAllRanges();
+    } catch {
+    }
+  };
+  const lockSelection = () => {
+    if (selectGuardRef.current) return;
+    const root = document.documentElement;
+    root.classList.add("dshvm-holding");
+    try {
+      window.getSelection()?.removeAllRanges();
+    } catch {
+    }
+    const stopSelect = (ev) => ev.preventDefault();
+    const release = () => unlockSelection();
+    document.addEventListener("selectstart", stopSelect, true);
+    document.addEventListener("contextmenu", stopSelect, true);
+    window.addEventListener("pointerup", release, true);
+    window.addEventListener("pointercancel", release, true);
+    selectGuardRef.current = () => {
+      root.classList.remove("dshvm-holding");
+      document.removeEventListener("selectstart", stopSelect, true);
+      document.removeEventListener("contextmenu", stopSelect, true);
+      window.removeEventListener("pointerup", release, true);
+      window.removeEventListener("pointercancel", release, true);
+    };
+  };
+  (0, import_react2.useEffect)(() => unlockSelection, []);
+  const btnRef = (0, import_react2.useRef)(null);
+  (0, import_react2.useEffect)(() => {
+    const el = btnRef.current;
+    if (!el) return;
+    const onTouchStart = (ev) => {
+      if (bootNow().mode !== "hold") return;
+      if (ev.cancelable) ev.preventDefault();
+    };
+    el.addEventListener("touchstart", onTouchStart, { passive: false });
+    return () => el.removeEventListener("touchstart", onTouchStart);
+  }, []);
   const onPointerDown = (e) => {
+    lockSelection();
     holdPtrRef.current = { t: Date.now(), y: e.clientY, id: e.pointerId };
     e.currentTarget.setPointerCapture?.(e.pointerId);
     if (bootNow().mode === "hold") {
@@ -3596,6 +3966,7 @@ function MicButton({
       onPointerUp,
       onPointerCancel,
       onContextMenu: (e) => e.preventDefault(),
+      ref: btnRef,
       "data-dshvm": "mic",
       "aria-label": on ? t("ariaActive") : t("ariaEnter"),
       "aria-pressed": on,

package/lib/index.js

@@ -1968,8 +1968,9 @@ function apply(ctx, config) {
     return next();
   });
   ctx.on("llm/stream", (options, next) => {
-    const sessionId = options.sessionId;
-    if (!config.enabled || sessionId === void 0 || options.purpose !== void 0) return next();
+    const rawSessionId = options.sessionId;
+    if (!config.enabled || rawSessionId === void 0 || options.purpose !== void 0) return next();
+    const sessionId = rawSessionId;
     if (activeVoiceSession !== sessionId) return next();
     const gen = (turnGen.get(sessionId) ?? 0) + 1;
     turnGen.set(sessionId, gen);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-voice-mode",
   "description": "Full-duplex voice mode for DeepSeek Harness: zipformer2 streaming ASR → editable draft, Edge TTS (default, fast) or local (VITS / Kokoro int8, privacy-first) read-aloud with live captions, true barge-in; hardened HTTP surface (loopback/origin/rate-limit) + model SHA256 pinning. · DSH 语音双工对话：流式识别入草稿、Edge 默认朗读或本地（VITS / Kokoro int8）朗读+实时字幕、开口即打断；HTTP 面安全加固。",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "main": "lib/index.js",
   "repository": {
@@ -33,6 +33,7 @@
     "scripts/list-voices.mjs",
     "scripts/bench-asr.mjs",
     "scripts/verify.mjs",
+    "scripts/check-anchors.mjs",
     "README.md",
     "README.en.md",
     "LICENSE"
@@ -45,8 +46,14 @@
     "prefetch": "node scripts/prefetch.mjs",
     "list-voices": "node scripts/list-voices.mjs",
     "bench-asr": "node scripts/bench-asr.mjs",
+    "bench:echo-gate": "node scripts/bench-echo-gate.mjs",
+    "analyze:fixture": "node scripts/analyze-fixture.mjs",
     "verify": "node scripts/verify.mjs",
-    "typecheck": "node node_modules/typescript/bin/tsc -p tsconfig.json --noEmit && node node_modules/typescript/bin/tsc -p tsconfig.client.json --noEmit"
+    "typecheck": "node node_modules/typescript/bin/tsc -p tsconfig.json --noEmit && node node_modules/typescript/bin/tsc -p tsconfig.client.json --noEmit",
+    "check:anchors": "node scripts/check-anchors.mjs",
+    "typecheck:dual": "bash scripts/typecheck-dual.sh",
+    "smoke:runtime": "bash scripts/smoke-runtime.sh",
+    "verify:dual": "bash scripts/verify-dual.sh"
   },
   "dsh": {
     "bundle": {
@@ -55,8 +62,15 @@
     "client": {
       "platform": "web",
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-ui-slots"
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-cordis-client-runner",
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-plugins"
       ]
     }
   },
@@ -68,18 +82,18 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-web": "^0.1.0-rc.6 || ^0.1.1-rc.0",
     "react": "^18.2.0"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.1.2-alpha.5",
+    "@deepseek-ai/dsh-llm": "0.1.2-alpha.5",
+    "@deepseek-ai/dsh-settings": "0.1.2-alpha.5",
+    "@deepseek-ai/dsh-system-prompt": "0.1.2-alpha.5",
     "@types/node": "^26.0.0",
     "@types/react": "^19.0.0",
     "esbuild": "^0.25.0",
+    "playwright-core": "1.62.1",
     "typescript": "^5.9.2"
   },
   "keywords": [
@@ -97,4 +111,4 @@
     "access": "public"
   },
   "license": "MIT"
-}
+}

package/scripts/check-anchors.mjs

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * 锚点健康检查（防回归 I-2）。
+ * 读取 package.json 的 dsh.client.inject 锚点，逐一校验这些锚点包在「目标 dsh 版本线」
+ * 上是否存在（默认 0.1.1-rc.2 与 0.1.2-alpha.4）。
+ *
+ * 目的：dsh 每次 minor 升级都可能删/改客户端锚点包（0.1.1→0.1.2 已删 dsh-client-runtime、
+ * 降级 dsh-client-ui-slots）。升级 dsh 前先跑本脚本，若某个锚点在新版本线缺失，脚本非零退出并点名，
+ * 避免「升级后客户端静默挂不上」。
+ *
+ * 用法：
+ *   node scripts/check-anchors.mjs [目标版本...]
+ *   （默认检查 0.1.1-rc.2 与 0.1.2-alpha.4；也可显式传版本，如 node scripts/check-anchors.mjs 0.1.3-rc.0）
+ *
+ * ── 实现说明（2026-09-02 改）──
+ * 初版用 `execFileSync('npm', ['view', ...])` 查询。该写法在 **Windows 上必然失败**：
+ *   - `npm` 实为 `npm.cmd`，不经 shell 时 execFileSync 报 ENOENT；
+ *   - 显式写 `npm.cmd` 又会被 Node 20+ 的安全限制拒绝（EINVAL，禁止 execFile 直接跑 .cmd/.bat）。
+ * 两种错误都被 catch 吞成「锚点不存在」，导致**全量假失败**（实测 win32 上 9 锚点 × 2 版本
+ * = 18 个假失败，而同样的包用 registry 直查全部存在）。
+ * 现改为直接走 registry HTTP：不 spawn 子进程，跨平台一致，且比逐个 `npm view` 快得多
+ * （每个包只取一次 packument，多版本复用）。
+ */
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const pkg = JSON.parse(readFileSync(join(here, '..', 'package.json'), 'utf8'))
+const anchors = pkg?.dsh?.client?.inject ?? []
+const targets = process.argv.slice(2).length ? process.argv.slice(2) : ['0.1.1-rc.2', '0.1.2-alpha.4']
+
+if (anchors.length === 0) {
+  console.error('package.json 未声明 dsh.client.inject 锚点')
+  process.exit(1)
+}
+
+/** registry：优先用 npm 注入的环境变量（npm run 时可得），否则官方源。 */
+const REGISTRY = (process.env.npm_config_registry || 'https://registry.npmjs.org').replace(/\/+$/, '')
+
+/** 取一次 packument，返回该包的版本集合；网络/服务端异常抛错（与「包不存在」区分）。 */
+async function fetchVersions(name) {
+  // scoped 包的 `/` 在 registry 路径里要编码成 %2f
+  const url = `${REGISTRY}/${name.replace('/', '%2f')}`
+  const res = await fetch(url, { headers: { accept: 'application/vnd.npm.install-v1+json' } })
+  if (res.status === 404) return null // 包本身不存在
+  if (!res.ok) throw new Error(`${name}: HTTP ${res.status}`)
+  const body = await res.json()
+  return new Set(Object.keys(body.versions ?? {}))
+}
+
+console.log(`registry: ${REGISTRY}`)
+
+/** 先把每个包的版本集合取回来（每包一次请求）。 */
+const versionsByAnchor = new Map()
+for (const anchor of anchors) {
+  try {
+    versionsByAnchor.set(anchor, await fetchVersions(anchor))
+  } catch (e) {
+    // 网络/registry 故障是**环境问题**，不该报成「锚点缺失」——用独立退出码 2 区分。
+    console.error(`\n⚠ 查询 ${anchor} 失败：${e.message}`)
+    console.error('这是环境/网络问题，不是锚点缺失。请检查网络或 registry 配置后重跑。')
+    process.exit(2)
+  }
+}
+
+let failures = 0
+for (const target of targets) {
+  console.log(`\n=== 目标 dsh ${target} 下的锚点存在性 ===`)
+  for (const anchor of anchors) {
+    const versions = versionsByAnchor.get(anchor)
+    if (versions && versions.has(target)) {
+      console.log(`  ✅ ${anchor} @ ${target}`)
+    } else {
+      console.error(`  ❌ ${anchor} @ ${target} 不存在`)
+      failures++
+    }
+  }
+}
+
+if (failures > 0) {
+  console.error(`\n✗ 有 ${failures} 个锚点缺失：dsh.client.inject 需收敛为交集，或等待该包在新版本提供。`)
+  process.exit(1)
+}
+console.log(`\n✓ 全部 ${anchors.length} 个锚点在 ${targets.join(' 与 ')} 均存在。`)