Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
perf(voice): 优化桌面语音采集、停顿润色与确认收尾 (#5089)
Dash6bf80ebb6047
diff --git a/apps/desktop/help-knowledge/voice-input.md b/apps/desktop/help-knowledge/voice-input.mdindex 67a4301ea0..bd6d716513 100644--- a/apps/desktop/help-knowledge/voice-input.md+++ b/apps/desktop/help-knowledge/voice-input.md@@ -11,6 +11,7 @@ Voice input lets you dictate instead of typing. Hold a shortcut, talk, release- Default shortcut: **Alt+Space** on macOS, **Ctrl+Shift+Space** on Windows. The shortcut is customizable on macOS and Windows. On Linux, global voice shortcuts are not supported yet (the setting is hidden).- The shortcut is **global** — it works even when Cindy isn't the focused app, so you can dictate into the composer from anywhere.- It's **push-and-hold**: press to start listening, release to stop and submit.+- Pressing the microphone immediately shows the recording controls and starts the timer. The start cue acknowledges the action and plays independently while capture starts in the background. Once audio becomes available, it is retained even while the recognition service is connecting; up to about 60 seconds is buffered locally and sent in order when it connects. You can stop before connection completes without discarding that buffered audio.**Settings:**@@ -18,6 +19,7 @@ Voice input lets you dictate instead of typing. Hold a shortcut, talk, release- **Language** — auto / 中文 (zh-CN) / 繁體中文 (zh-TW) / English / 日本語 / 한국어. Those are the supported recognition locales — there's no free-form locale field.- **Refinement** — optional LLM post-process that cleans up the raw ASR text (fixes punctuation, removes ums, joins fragments). You can write a custom refinement prompt to bias it toward your preferences.- **Mute system audio while recording** — toggle; reduces feedback / echo from your speakers picking up onto the mic. On by default.+- When enabled, the start cue finishes before system audio is muted. Capture continues throughout. Audio captured before the mute finishes is retained too, so the beginning of your speech is not cut off; a brief amount of sound already playing through the speakers may also be captured.- **Fast activation** — toggle; keeps the mic warm so press-to-talk has lower latency at the cost of slightly more background mic usage. Off by default.- **Interaction sound** — a short sound cue when dictation starts / stops. On by default.diff --git a/apps/desktop/native/voice-input/macos-audio-mute-helper.swift b/apps/desktop/native/voice-input/macos-audio-mute-helper.swiftnew file mode 100644index 0000000000..6fc581d089--- /dev/null+++ b/apps/desktop/native/voice-input/macos-audio-mute-helper.swift@@ -0,0 +1,64 @@+import CoreAudio+import Foundation++// One-shot helper: no microphone access, event loop, or resident process.+func fail(_ message: String) -> Never {+ FileHandle.standardError.write(Data(message.utf8))+ exit(1)+}++func check(_ status: OSStatus) {+ if status != noErr { fail("CoreAudio status \(status)") }+}++func address(_ selector: AudioObjectPropertySelector,+ _ scope: AudioObjectPropertyScope = kAudioObjectPropertyScopeGlobal) -> AudioObjectPropertyAddress {+ AudioObjectPropertyAddress(mSelector: selector, mScope: scope, mElement: kAudioObjectPropertyElementMain)+}++func deviceUID(_ device: AudioDeviceID) -> String {+ var property = address(kAudioDevicePropertyDeviceUID)+ var uid: Unmanaged<CFString>?+ var size = UInt32(MemoryLayout<Unmanaged<CFString>?>.size)+ check(AudioObjectGetPropertyData(device, &property, 0, nil, &size, &uid))+ guard let uid else { fail("Missing device UID") }+ return uid.takeUnretainedValue() as String+}++let args = Array(CommandLine.arguments.dropFirst())+guard let command = args.first, ["read", "mute", "set"].contains(command) else {+ fail("Expected read, mute or set")+}+var device = AudioDeviceID(kAudioObjectUnknown)+if command == "set" {+ guard args.count == 4, let id = UInt32(args[1]), ["true", "false"].contains(args[3]) else {+ fail("Expected set device uid true|false")+ }+ device = id+ // Never apply an old snapshot to a different device after disconnect/reuse.+ guard deviceUID(device) == args[2] else { fail("Output device changed") }+} else {+ guard args.count == 1 else { fail("Unexpected arguments") }+ var property = address(kAudioHardwarePropertyDefaultOutputDevice)+ var size = UInt32(MemoryLayout<AudioDeviceID>.size)+ check(AudioObjectGetPropertyData(AudioObjectID(kAudioObjectSystemObject), &property, 0, nil, &size, &device))+}+var property = address(kAudioDevicePropertyMute, kAudioDevicePropertyScopeOutput)+var writable: DarwinBoolean = false+check(AudioObjectIsPropertySettable(device, &property, &writable))+guard writable.boolValue else { fail("Output mute is not writable") }+var muted: UInt32 = 0+var size = UInt32(MemoryLayout<UInt32>.size)+check(AudioObjectGetPropertyData(device, &property, 0, nil, &size, &muted))++// Publish the original state BEFORE any write. The parent retains this even+// when the write fails or the helper is killed, so restoration remains possible.+let snapshot: [String: Any] = ["outputMuted": muted != 0, "deviceId": device, "deviceUID": deviceUID(device)]+let json = try JSONSerialization.data(withJSONObject: snapshot, options: [.sortedKeys])+FileHandle.standardOutput.write(json + Data([10]))+if command != "read" {+ var desired: UInt32 = command == "mute" || args[3] == "true" ? 1 : 0+ if desired != muted {+ check(AudioObjectSetPropertyData(device, &property, 0, nil, UInt32(MemoryLayout<UInt32>.size), &desired))+ }+}diff --git a/apps/desktop/src/main/voice-input/StopSoundActivity.ts b/apps/desktop/src/main/voice-input/StopSoundActivity.tsnew file mode 100644index 0000000000..30614ee3b0--- /dev/null+++ b/apps/desktop/src/main/voice-input/StopSoundActivity.ts@@ -0,0 +1,76 @@+/** Local evidence for stop-time ASR finalization, not a speech classifier.+ * Measure 1 ms RMS buckets across packet boundaries. A 20 ms window must+ * contain 16 ms of quiet sound or 6 ms of stronger sound. Isolated impulses+ * cannot pass just by being loud. Every PCM sample still goes to the ASR.+ */+export class StopSoundActivity {+ static readonly thresholds = {+ weakRms: 32,+ strongRms: 96,+ windowMs: 20,+ weakDurationMs: 16,+ strongDurationMs: 6,+ };+ private samples = 0;+ private bucketSamples = 0;+ private energy = 0;+ private readonly window: number[] = Array(20).fill(0);+ private cursor = 0;+ private weakCount = 0;+ private strongCount = 0;+ private acceptedEndMs = 0;+ private candidateEndMs = 0;+ private readonly samplesPerMs: number;++ constructor(private readonly sampleRate: number) {+ this.samplesPerMs = Math.max(1, Math.round(sampleRate / 1000));+ }++ append(pcm: Buffer): void {+ const t = StopSoundActivity.thresholds;+ for (let offset = 0; offset + 1 < pcm.length; offset += 2) {+ const value = pcm.readInt16LE(offset);+ this.samples++;+ this.bucketSamples++;+ this.energy += value * value;+ if (this.bucketSamples < this.samplesPerMs) continue;+ const meanSquare = this.energy / this.bucketSamples;+ const level = meanSquare >= t.strongRms ** 2 ? 2 : meanSquare >= t.weakRms ** 2 ? 1 : 0;+ const old = this.window[this.cursor];+ this.weakCount += Number(level > 0) - Number(old > 0);+ this.strongCount += Number(level === 2) - Number(old === 2);+ this.window[this.cursor] = level;+ this.cursor = (this.cursor + 1) % this.window.length;+ if (level > 0) {+ this.candidateEndMs = (this.samples * 1000) / this.sampleRate;+ if (this.weakCount >= t.weakDurationMs || this.strongCount >= t.strongDurationMs) {+ this.acceptedEndMs = this.candidateEndMs;+ }+ }+ this.bucketSamples = 0;+ this.energy = 0;+ }+ }++ get lastSoundEndMs(): number {+ const nowMs = (this.samples * 1000) / this.sampleRate;+ // An unfinished burst (including a final partial bucket) is uncertain:+ // protect it on immediate stop. After quiet audio fills the window, a+ // burst that never met either duration threshold no longer blocks stop.+ if (this.energy >= StopSoundActivity.thresholds.weakRms ** 2 * Math.max(1, this.bucketSamples))+ return nowMs;+ if (+ this.candidateEndMs > 0 &&+ nowMs - this.candidateEndMs < StopSoundActivity.thresholds.windowMs+ ) {+ return Math.max(this.acceptedEndMs, this.candidateEndMs);+ }+ return this.acceptedEndMs;+ }++ reset(): void {+ this.samples = this.bucketSamples = this.energy = this.cursor = 0;+ this.weakCount = this.strongCount = this.acceptedEndMs = this.candidateEndMs = 0;+ this.window.fill(0);+ }+}diff --git a/apps/desktop/src/main/voice-input/VolcengineSaucAsrProvider.ts b/apps/desktop/src/main/voice-input/VolcengineSaucAsrProvider.tsindex 5e91b8a2bd..1a9a9c576e 100644--- a/apps/desktop/src/main/voice-input/VolcengineSaucAsrProvider.ts+++ b/apps/desktop/src/main/voice-input/VolcengineSaucAsrProvider.ts@@ -8,6 +8,8 @@ import { resamplePcm16 } from './RealtimeAsrWebSocketProvider.js';import { volcengineSaucLanguageCode } from './language.js';import { mergeRecoveredTranscript } from './transcriptMerge.js';import { describeAsrHandshakeTraceId, describeAsrWebSocketTarget } from './voiceInputAsrConfig.js';+import { createWebSocketHandshakeTiming } from './webSocketHandshakeTiming.js';+import { StopSoundActivity } from './StopSoundActivity.js';type VolcengineSaucAsrProviderOptions = {proxyApiKey?: string;@@ -91,7 +93,6 @@ export class VolcengineSaucAsrProvider implements AsrProvider {private started = false;private sequence = 1;private sentAudioMs = 0;- private pendingFinalAudioChunk?: ReplayAudioChunk;private lastTranscript = '';private sessionTranscriptPrefix = '';private unconfirmedAudio: ReplayAudioChunk[] = [];@@ -99,6 +100,10 @@ export class VolcengineSaucAsrProvider implements AsrProvider {private flushResolvers: Array<() => void> = [];private finalRequested = false;private stableEmitted = false;+ private confirmedEndMs = 0;+ private readonly soundActivity: StopSoundActivity;+ private get lastSoundEndMs(): number { return this.soundActivity.lastSoundEndMs; }+ private recovered = false;private keepAliveTimer?: ReturnType<typeof setInterval>;private pongTimeoutTimer?: ReturnType<typeof setTimeout>;private recoveryPromise?: Promise<void>;@@ -114,6 +119,7 @@ export class VolcengineSaucAsrProvider implements AsrProvider {this.resourceId = options.resourceId;this.sourceLanguage = options.sourceLanguage ?? 'auto';this.pcmSampleRate = options.pcmSampleRate ?? DEFAULT_PCM_SAMPLE_RATE;+ this.soundActivity = new StopSoundActivity(this.pcmSampleRate);this.connectTimeoutMs = options.connectTimeoutMs ?? CONNECT_TIMEOUT_MS;this.missingCredentialMessage = options.missingCredentialMessage ?? 'API key is required for Volcengine SAUC ASR.';this.errorFallbackMessage = options.errorFallbackMessage ?? 'Volcengine SAUC transcription failed.';@@ -145,6 +151,7 @@ export class VolcengineSaucAsrProvider implements AsrProvider {// 解析代理是一次异步往返,期间可能已停录 —— 复查后再建连,不留孤儿 socket。if (this.stopRequested) throw new Error('Volcengine SAUC ASR connection stopped.');const dialStartedAt = performance.now();+ const handshakeTiming = createWebSocketHandshakeTiming();let socketOpenedAt = 0;const socket = new WebSocket(connection.websocketUrl, {headers: {@@ -153,6 +160,7 @@ export class VolcengineSaucAsrProvider implements AsrProvider {'X-Api-Connect-Id': buildConnectId(),},agent,+ finishRequest: handshakeTiming.finishRequest,});this.socket = socket;this.attachSocketHandlers(socket);@@ -189,7 +197,8 @@ export class VolcengineSaucAsrProvider implements AsrProvider {log.warn('volcengine sauc connection timed out before ready', {timeoutMs: this.connectTimeoutMs,});- fail(new Error(`Volcengine SAUC ASR connection timed out after ${this.connectTimeoutMs}ms`), true);+ const error = new Error(`Volcengine SAUC ASR connection timed out after ${this.connectTimeoutMs}ms`);+ fail(error, true);}, this.connectTimeoutMs);const onOpen = (): void => {if (settled) return;@@ -198,6 +207,7 @@ export class VolcengineSaucAsrProvider implements AsrProvider {return;}socketOpenedAt = performance.now();+ log.debug('websocket transport opened', { viaProxy: Boolean(agent), ...handshakeTiming.snapshot() });this.startKeepAlive();this.sendInitialRequest();};@@ -233,6 +243,7 @@ export class VolcengineSaucAsrProvider implements AsrProvider {socketOpenMs: socketOpenedAt ? Math.round(socketOpenedAt - dialStartedAt) : undefined,firstResponseMs: socketOpenedAt ? Math.round(readyAt - socketOpenedAt) : undefined,totalMs: Math.round(readyAt - openStartedAt),+ transport: { viaProxy: Boolean(agent), ...handshakeTiming.snapshot() },});this.callback({ type: 'connected', at: Date.now() });resolve();@@ -252,19 +263,16 @@ export class VolcengineSaucAsrProvider implements AsrProvider {const inputRate = trace?.sampleRate ?? DEFAULT_PCM_SAMPLE_RATE;const pcm = resamplePcm16(Buffer.from(chunk), inputRate, this.pcmSampleRate);if (pcm.length === 0) return;- const durationMs = trace?.durationMs ?? estimatePcmDurationMs(chunk.byteLength, inputRate);+ // Use the actual wire PCM clock, matching utterance end_time (milliseconds).+ const durationMs = estimatePcmDurationMs(pcm.length, this.pcmSampleRate);this.sentAudioMs += durationMs;+ this.soundActivity.append(pcm);const entry = this.addUnconfirmedAudio(pcm, durationMs);const socket = this.socket;if (!this.connected || !socket || socket.readyState !== WebSocket.OPEN) return;- // Volcengine's binary protocol marks the last audio packet via the- // message-type flag. Keep one chunk back so flush can send that real final- // audio packet with a negative sequence instead of sending an empty final- // marker that may cut off the tail.- if (this.pendingFinalAudioChunk) {- this.sendAudioEntry(this.pendingFinalAudioChunk, socket);- }- this.pendingFinalAudioChunk = entry;+ // flushAudio sends a dedicated final silence packet. No need to hold a+ // real audio packet back until the next append (40 ms in live capture).+ this.sendAudioEntry(entry, socket);}async flushAudio(): Promise<void> {@@ -279,16 +287,45 @@ export class VolcengineSaucAsrProvider implements AsrProvider {if (!socket || socket.readyState !== WebSocket.OPEN) return;if (this.sentAudioMs <= 0) return;this.finalRequested = true;- if (this.pendingFinalAudioChunk) {- this.sendAudioEntry(this.pendingFinalAudioChunk, socket);- }- this.pendingFinalAudioChunk = undefined;// SAUC's two-pass mode finalizes utterances through VAD. Send a short// silence packet as the protocol-level final audio packet so the last// spoken word has a chance to enter the definite result instead of being// cut off by an empty final marker.const finalChunk = silencePcm16(this.pcmSampleRate, NONSTREAM_END_WINDOW_MS);socket.send(encodeAudioOnlyRequest(finalChunk, -this.nextSequence()));+ const silenceMs = this.sentAudioMs - this.lastSoundEndMs;+ const missedReasons: string[] = [];+ if (this.recovered) missedReasons.push('recovered_audio_clock');+ if (!this.stableEmitted) missedReasons.push('transcript_not_fully_confirmed');+ if (this.lastSoundEndMs <= 0) missedReasons.push('no_sound_position');+ if (this.confirmedEndMs <= 0) missedReasons.push('no_confirmed_audio_position');+ if (this.confirmedEndMs < this.lastSoundEndMs) missedReasons.push('sound_after_confirmed_audio');+ if (this.confirmedEndMs > this.sentAudioMs) missedReasons.push('confirmed_position_beyond_sent_audio');+ if (silenceMs < 2_000) missedReasons.push('silence_under_2000ms');+ // Capture before awaiting the final response: that response can change the+ // confirmation state and must not obscure why the original decision waited.+ // Positions are milliseconds on the transmitted PCM clock, not wall time.+ const stopDecision = {+ lastSoundEndMs: this.lastSoundEndMs,+ confirmedEndMs: this.confirmedEndMs,+ sentAudioMs: this.sentAudioMs,+ silenceMs,+ unconfirmedSoundMs: Math.max(0, this.lastSoundEndMs - this.confirmedEndMs),+ soundDetection: 'rms_duration_v1',+ soundThresholds: StopSoundActivity.thresholds,+ requiredSilenceMs: 2_000,+ hasStable: this.stableEmitted,+ recovered: this.recovered,+ fastFinish: missedReasons.length === 0,+ missedReasons,+ };+ log.debug('stop finalization decision', stopDecision);+ if (stopDecision.fastFinish) {+ log.debug('flush settled', { waitMs: 0, timedOut: false,+ sentAudioMs: Math.round(this.sentAudioMs), hasStable: true,+ reason: 'confirmed_before_stop', stopDecision });+ return;+ }const flushStartedAt = performance.now();let flushTimedOut = false;await new Promise<void>((resolve) => {@@ -309,6 +346,7 @@ export class VolcengineSaucAsrProvider implements AsrProvider {timedOut: flushTimedOut,sentAudioMs: Math.round(this.sentAudioMs),hasStable: this.stableEmitted,+ stopDecision,});if (this.lastTranscript && !this.stableEmitted) {this.callback({ type: 'stable', text: this.lastTranscript, at: Date.now() });@@ -330,7 +368,6 @@ export class VolcengineSaucAsrProvider implements AsrProvider {this.started = false;this.connected = false;this.startReject?.(new Error('Volcengine SAUC stopped before the protocol was ready.'));- this.pendingFinalAudioChunk = undefined;this.clearUnconfirmedAudio();this.sessionTranscriptPrefix = '';this.teardownSocketForReconnect();@@ -355,7 +392,9 @@ export class VolcengineSaucAsrProvider implements AsrProvider {// Volcengine SAUC, so the first audio-only request must start at 2.this.sequence = 1;this.sentAudioMs = 0;- this.pendingFinalAudioChunk = undefined;+ this.confirmedEndMs = 0;+ this.soundActivity.reset();+ this.recovered = false;this.lastTranscript = '';this.sessionTranscriptPrefix = '';this.clearUnconfirmedAudio();@@ -367,6 +406,10 @@ export class VolcengineSaucAsrProvider implements AsrProvider {}private async performRecover(): Promise<void> {+ // A replay uses a different audio origin. Do not compare its timestamps+ // with the original capture clock, even when the transcript prefix is empty.+ this.recovered = true;+ this.confirmedEndMs = 0;const prefix = this.lastTranscript;const initialReplayMs = this.unconfirmedAudioMs;const startedAt = Date.now();@@ -384,7 +427,6 @@ export class VolcengineSaucAsrProvider implements AsrProvider {// recently-confirmed tail so network recovery cannot drop words that were// sent just before the partial transcript arrived.this.sequence = 1;- this.pendingFinalAudioChunk = undefined;this.finalRequested = false;this.stableEmitted = false;this.sessionTranscriptPrefix = prefix;@@ -513,23 +555,21 @@ export class VolcengineSaucAsrProvider implements AsrProvider {const rawTranscript = extractTranscript(message.payload);const transcript = mergeRecoveredTranscript(this.sessionTranscriptPrefix, rawTranscript);- // `definite` is a two-pass utterance marker. It can stabilize visible text,- // but only the protocol last-response flag means stop-time ASR finalization is complete.- const isDefinite = hasDefiniteUtterance(message.payload);+ const confirmation = getTranscriptConfirmation(message.payload, rawTranscript);+ const isDefinite = confirmation.confirmed;const isLastResponse = isProtocolLastResponse(message);if (rawTranscript) {this.clearConfirmedAudio(Date.now() - CONFIRMED_AUDIO_RETENTION_MS);}- if (transcript && transcript !== this.lastTranscript) {+ if (rawTranscript) this.confirmedEndMs = confirmation.endMs;+ if (transcript && (transcript !== this.lastTranscript || isDefinite !== this.stableEmitted)) {this.lastTranscript = transcript;+ this.stableEmitted = isDefinite;this.callback({type: isDefinite ? 'stable' : 'partial',text: transcript,at: Date.now(),});- if (isDefinite) {- this.stableEmitted = true;- }}if (this.finalRequested && isLastResponse) {this.resolveFlushWaiters();@@ -727,13 +767,29 @@ function rawDataToBuffer(data: WebSocket.RawData): Buffer {return Buffer.from(data);}-function extractTranscript(payload: unknown): string {- const values = collectStringFields(payload, new Set(['text', 'transcript', 'sentence', 'asr_text']));- const best = values- .map((value) => value.trim())- .filter(Boolean)- .sort((a, b) => b.length - a.length)[0];- return best ?? '';+export function extractTranscript(payload: unknown): string {+ let best = '';+ const visit = (value: unknown): void => {+ if (!value || typeof value !== 'object') return;+ if (Array.isArray(value)) {+ for (const child of value) visit(child);+ return;+ }+ for (const [key, child] of Object.entries(value)) {+ const name = key.toLowerCase();+ if (typeof child === 'string' && (+ name === 'text' || name === 'transcript' || name === 'sentence' || name === 'asr_text'+ )) {+ const text = child.trim();+ // Match the previous stable descending sort: the first longest field+ // wins ties. Avoid collecting and sorting every candidate on each partial.+ if (text.length > best.length) best = text;+ }+ visit(child);+ }+ };+ visit(payload);+ return best;}function extractErrorMessage(payload: unknown): string | undefined {@@ -741,11 +797,21 @@ function extractErrorMessage(payload: unknown): string | undefined {return values.map((value) => value.trim()).find(Boolean);}-function hasDefiniteUtterance(payload: unknown): boolean {- if (Array.isArray(payload)) return payload.some((item) => hasDefiniteUtterance(item));- if (!isRecord(payload)) return false;- if (payload.definite === true) return true;- return Object.values(payload).some((value) => hasDefiniteUtterance(value));+export function getTranscriptConfirmation(payload: unknown, transcript: string): { confirmed: boolean; endMs: number } {+ const unknown = { confirmed: false, endMs: 0 };+ if (!transcript || !isRecord(payload)) return unknown;+ const results = Array.isArray(payload.result) ? payload.result : [payload.result];+ // Only accept a matching aggregate, not an arbitrary nested definite flag.+ const result = results.find((item) => isRecord(item) && item.text === transcript);+ if (!isRecord(result) || !Array.isArray(result.utterances) || !result.utterances.length) return unknown;+ const utterances = result.utterances;+ if (!utterances.every((item) => isRecord(item) && item.definite === true && typeof item.text === 'string')) return unknown;+ const compact = (value: string): string => value.replace(/\s/gu, '');+ if (compact(utterances.map((item) => item.text).join('')) !== compact(transcript)) return unknown;+ const last = utterances[utterances.length - 1];+ const endMs = typeof last.end_time === 'number' && Number.isFinite(last.end_time) && last.end_time > 0+ ? last.end_time : 0;+ return { confirmed: true, endMs };}function isProtocolLastResponse(message: ParsedVolcengineMessage): boolean {diff --git a/apps/desktop/src/main/voice-input/__tests__/StopSoundActivity.test.ts b/apps/desktop/src/main/voice-input/__tests__/StopSoundActivity.test.tsnew file mode 100644index 0000000000..fca2f0ec90--- /dev/null+++ b/apps/desktop/src/main/voice-input/__tests__/StopSoundActivity.test.ts@@ -0,0 +1,77 @@+import { describe, expect, it } from 'vitest';+import { StopSoundActivity } from '../StopSoundActivity.js';++const rate = 16000;+const silence = (ms: number) => Buffer.alloc(((ms * rate) / 1000) * 2);+function tone(ms: number, peak: number): Buffer {+ const pcm = silence(ms);+ for (let i = 0; i < pcm.length / 2; i++)+ pcm.writeInt16LE(Math.round(peak * Math.sin((2 * Math.PI * i) / 16)), i * 2);+ return pcm;+}++describe('stop-time sound activity', () => {+ it('ignores low background noise and isolated high-amplitude impulses', () => {+ const detector = new StopSoundActivity(rate);+ const pcm = tone(1000, 20);+ for (const index of [1, 999, 8000]) pcm.writeInt16LE(30000, index * 2);+ detector.append(pcm);+ detector.append(silence(30));+ expect(detector.lastSoundEndMs).toBe(0);+ });++ it.each([1, 2, 3])('ignores an isolated %s ms burst after the uncertainty window', (ms) => {+ const detector = new StopSoundActivity(rate);+ detector.append(tone(ms, 20000));+ expect(detector.lastSoundEndMs).toBe(ms); // immediate stop stays conservative+ detector.append(silence(30));+ expect(detector.lastSoundEndMs).toBe(0);+ });++ it.each([+ [40, 56],+ [20, 56],+ [10, 160],+ [6, 160],+ ])('protects a %s ms sound with peak %s', (duration, peak) => {+ const detector = new StopSoundActivity(rate);+ detector.append(silence(300));+ detector.append(tone(duration, peak));+ detector.append(silence(3000));+ expect(detector.lastSoundEndMs).toBe(300 + duration);+ });++ it('ignores a later impulse without forgetting earlier quiet speech', () => {+ const detector = new StopSoundActivity(rate);+ detector.append(tone(40, 56));+ detector.append(silence(500));+ detector.append(tone(1, 30000));+ detector.append(silence(3000));+ expect(detector.lastSoundEndMs).toBe(40);+ });++ it('is independent of audio packet boundaries, including partial millisecond buckets', () => {+ const pcm = Buffer.concat([+ silence(100),+ tone(20, 56),+ silence(100),+ tone(2, 20000),+ silence(30),+ ]);+ for (const bytes of [2, 14, 320, 1280, pcm.length]) {+ const detector = new StopSoundActivity(rate);+ for (let offset = 0; offset < pcm.length; offset += bytes)+ detector.append(pcm.subarray(offset, offset + bytes));+ expect(detector.lastSoundEndMs).toBe(120);+ }+ });++ it('protects an unfinished tail and resets all evidence between recordings', () => {+ const detector = new StopSoundActivity(rate);+ detector.append(Buffer.from(new Int16Array([100, 100, 100, 100]).buffer));+ expect(detector.lastSoundEndMs).toBe(0.25);+ detector.reset();+ detector.append(silence(100));+ expect(detector.lastSoundEndMs).toBe(0);+ });+});diff --git a/apps/desktop/src/main/voice-input/__tests__/VolcengineSaucAsrProvider.test.ts b/apps/desktop/src/main/voice-input/__tests__/VolcengineSaucAsrProvider.test.tsindex 6881ca1ae4..62d417a06d 100644--- a/apps/desktop/src/main/voice-input/__tests__/VolcengineSaucAsrProvider.test.ts+++ b/apps/desktop/src/main/voice-input/__tests__/VolcengineSaucAsrProvider.test.ts@@ -1,17 +1,29 @@-import { gzipSync } from 'node:zlib';+import { gzipSync, gunzipSync } from 'node:zlib';import { WebSocketServer, type WebSocket } from 'ws';import { describe, expect, it, vi } from 'vitest';+const diagnosticLog = vi.hoisted(() => ({ debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() }));+vi.mock('../../logger.js', () => ({ createLogger: () => diagnosticLog }));+import {decodeVolcengineMessage,encodeAudioOnlyRequest,encodeFullClientRequest,+ getTranscriptConfirmation,VolcengineSaucAsrProvider,} from '../VolcengineSaucAsrProvider.js';import { volcengineSaucLanguageCode } from '../language.js';import { mergeRecoveredTranscript } from '../transcriptMerge.js';describe('VolcengineSaucAsrProvider protocol helpers', () => {+ it('requires all utterances to cover the aggregate transcript', () => {+ const check = (utterances: unknown[]) => getTranscriptConfirmation({ result: { text: '一句。二句。', utterances } }, '一句。二句。');+ expect(check([{ text: '一句。', definite: true }, { text: '二句。', definite: false }]).confirmed).toBe(false);+ expect(check([{ text: '一句。', definite: true }]).confirmed).toBe(false);+ expect(check([{ text: '一句。', definite: true }, { text: '二句。', definite: true, end_time: 1000 }]))+ .toEqual({ confirmed: true, endMs: 1000 });+ expect(check([{ text: '一句。二句。', definite: true }])).toEqual({ confirmed: true, endMs: 0 });+ });it('normalizes Traditional Chinese to the documented provider hint', () => {expect(volcengineSaucLanguageCode('auto')).toBeUndefined();expect(volcengineSaucLanguageCode('zh-TW')).toBe('zh-CN');@@ -109,7 +121,7 @@ describe('VolcengineSaucAsrProvider protocol helpers', () => {});it('recovers by replaying unconfirmed audio and preserving the visible transcript prefix', async () => {- const server = new WebSocketServer({ port: 0 });+ const server = new WebSocketServer({ host: '127.0.0.1', port: 0 });const sockets: WebSocket[] = [];const messageCounts: number[] = [];let provider: VolcengineSaucAsrProvider | undefined;@@ -167,7 +179,7 @@ describe('VolcengineSaucAsrProvider protocol helpers', () => {});it('requests a fresh one-shot connection ticket when transport recovery reconnects', async () => {- const server = new WebSocketServer({ port: 0 });+ const server = new WebSocketServer({ host: '127.0.0.1', port: 0 });const sockets: WebSocket[] = [];const authorizations: Array<string | undefined> = [];let provider: VolcengineSaucAsrProvider | undefined;@@ -208,7 +220,7 @@ describe('VolcengineSaucAsrProvider protocol helpers', () => {});it('waits for a provider protocol response before reporting connected', async () => {- const server = new WebSocketServer({ port: 0 });+ const server = new WebSocketServer({ host: '127.0.0.1', port: 0 });const sockets: WebSocket[] = [];let provider: VolcengineSaucAsrProvider | undefined;server.on('connection', (socket) => {@@ -248,8 +260,78 @@ describe('VolcengineSaucAsrProvider protocol helpers', () => {}});+ it.each(['close', 'timeout', 'cancel'] as const)('rejects startup on %s before the protocol ACK without reporting connected', async (outcome) => {+ const server = new WebSocketServer({ host: '127.0.0.1', port: 0 });+ const sockets: WebSocket[] = [];+ const events: string[] = [];+ let provider: VolcengineSaucAsrProvider | undefined;+ server.on('connection', (socket) => sockets.push(socket));+ try {+ await waitFor(() => server.address() !== null);+ const address = server.address();+ if (!address || typeof address === 'string') throw new Error('Expected loopback server');+ provider = new VolcengineSaucAsrProvider({+ proxyApiKey: 'test-key', baseUrl: `http://127.0.0.1:${address.port}`,+ endpointPath: '/asr', resourceId: 'test', connectTimeoutMs: 250,+ });+ provider.onEvent((event) => events.push(event.type));+ // Attach both settlement paths immediately, including the timeout case.+ const started = provider.start().then(() => 'unexpected success', (error: Error) => error.message);+ await waitFor(() => sockets.length === 1);+ if (outcome === 'close') sockets[0].close();+ if (outcome === 'cancel') await provider.stop();+ expect(await started).toMatch(outcome === 'timeout' ? /timed out/ : /closed|stopped/i);+ expect(events).not.toContain('connected');+ await waitFor(() => sockets[0].readyState === 3);+ } finally {+ await provider?.stop();+ sockets.forEach((socket) => socket.terminate());+ await new Promise<void>((resolve) => server.close(() => resolve()));+ }+ });++ it('sends the first real audio without a second append and finalizes without duplicating it', async () => {+ const server = new WebSocketServer({ host: '127.0.0.1', port: 0 });+ const sockets: WebSocket[] = [];+ const audio: Buffer[] = [];+ let provider: VolcengineSaucAsrProvider | undefined;+ server.on('connection', (socket) => {+ sockets.push(socket);+ socket.send(serverAckPacket());+ socket.on('message', (raw) => {+ const packet = Buffer.from(raw as Buffer);+ if (packet[1] >> 4 !== 2) return;+ audio.push(packet);+ if ((packet[1] & 0xf) === 3) socket.send(serverTranscriptPacket('完成', true, 0x3));+ });+ });+ try {+ await waitFor(() => server.address() !== null);+ const address = server.address();+ if (!address || typeof address === 'string') throw new Error('Expected server address');+ provider = new VolcengineSaucAsrProvider({+ proxyApiKey: 'test-key', baseUrl: `http://127.0.0.1:${address.port}`,+ endpointPath: '/asr', resourceId: 'volc.test',+ });+ await provider.start();+ const pcm = makePcmChunk();+ provider.appendAudio(pcm, makeTrace(0));+ await waitFor(() => audio.length === 1);+ expect(audio[0].readInt32BE(4)).toBe(2);+ expect(gunzipSync(audio[0].subarray(12))).toEqual(Buffer.from(pcm));+ await provider.flushAudio();+ expect(audio).toHaveLength(2);+ expect(audio[1].readInt32BE(4)).toBe(-3);+ expect(gunzipSync(audio[1].subarray(12))).toEqual(Buffer.alloc(16000 * 0.3 * 2));+ } finally {+ await provider?.stop();+ sockets.forEach((socket) => socket.terminate());+ await new Promise<void>((resolve) => server.close(() => resolve()));+ }+ });+it('does not open a managed socket when stopped during session allocation', async () => {- const server = new WebSocketServer({ port: 0 });+ const server = new WebSocketServer({ host: '127.0.0.1', port: 0 });const sockets: WebSocket[] = [];server.on('connection', (socket) => {sockets.push(socket);@@ -289,8 +371,79 @@ describe('VolcengineSaucAsrProvider protocol helpers', () => {}});+ it.each(['confirmed', 'new_sound', 'missing_time', 'partial_tail', 'short_pause', 'uncovered_audio', 'recovered', 'future_time', 'isolated_click'])+ ('only skips final response when audio and text are both confirmed: %s', async (scenario) => {+ diagnosticLog.debug.mockClear();+ const server = new WebSocketServer({ host: '127.0.0.1', port: 0 });+ const sockets: WebSocket[] = [];+ let provider: VolcengineSaucAsrProvider | undefined;+ server.on('connection', (socket) => { sockets.push(socket); socket.send(serverAckPacket()); });+ try {+ await waitFor(() => server.address() !== null);+ const address = server.address();+ if (!address || typeof address === 'string') throw new Error('Expected local server');+ provider = new VolcengineSaucAsrProvider({ proxyApiKey: 'test', baseUrl: `http://127.0.0.1:${address.port}`, endpointPath: '/asr', resourceId: 'test' });+ const events: Array<{ type: string }> = [];+ provider.onEvent((event) => events.push(event));+ await provider.start();+ provider.appendAudio(new Int16Array(1600).fill(512).buffer);+ sockets[0].send(serverTranscriptPacket('一句。', false));+ await waitFor(() => events.some((e) => e.type === 'partial'));+ sockets[0].send(serverTranscriptPacket('一句。', true, 0,+ scenario === 'missing_time' ? undefined : scenario === 'uncovered_audio' ? 50 : scenario === 'future_time' ? 10000 : 100));+ await waitFor(() => events.some((e) => e.type === 'stable'));+ if (scenario === 'recovered') {+ await provider.recover();+ sockets[1].send(serverTranscriptPacket('一句。', true, 0, 100));+ await waitFor(() => events.filter((e) => e.type === 'stable').length === 2);+ }+ if (scenario === 'new_sound') provider.appendAudio(new Int16Array(160).fill(40).buffer);+ if (scenario === 'isolated_click') {+ provider.appendAudio(new Int16Array(1600).buffer);+ const click = new Int16Array(160);+ click[0] = 30000;+ provider.appendAudio(click.buffer);+ }+ if (scenario === 'partial_tail') {+ sockets[0].send(serverTranscriptPacket('一句。新尾句', false));+ await waitFor(() => events.filter((e) => e.type === 'partial').length === 2);+ }+ provider.appendAudio(new Int16Array(scenario === 'short_pause' ? 1600 : 32000).buffer);+ let settled = false;+ const flushing = provider.flushAudio().then(() => { settled = true; });+ await sleep(30);+ const fastFinish = scenario === 'confirmed' || scenario === 'isolated_click';+ expect(settled).toBe(fastFinish);+ const decision = diagnosticLog.debug.mock.calls.find(([name]) => name === 'stop finalization decision')?.[1];+ const expectedReason: Record<string, string> = {+ new_sound: 'sound_after_confirmed_audio', missing_time: 'no_confirmed_audio_position',+ partial_tail: 'transcript_not_fully_confirmed', short_pause: 'silence_under_2000ms',+ uncovered_audio: 'sound_after_confirmed_audio', recovered: 'recovered_audio_clock',+ future_time: 'confirmed_position_beyond_sent_audio',+ };+ expect(decision).toMatchObject({+ lastSoundEndMs: scenario === 'new_sound' ? 110 : 100,+ silenceMs: scenario === 'short_pause' ? 100 : scenario === 'isolated_click' ? 2110 : 2000,+ fastFinish,+ soundDetection: 'rms_duration_v1',+ });+ if (fastFinish) {+ expect(decision).toMatchObject({ confirmedEndMs: 100, sentAudioMs: scenario === 'isolated_click' ? 2210 : 2100, missedReasons: [] });+ } else {+ expect(decision.missedReasons).toContain(expectedReason[scenario]);+ }+ sockets[sockets.length - 1].send(serverTranscriptPacket('一句。', true, 3));+ await flushing;+ expect(diagnosticLog.debug.mock.calls.find(([name]) => name === 'flush settled')?.[1].stopDecision).toEqual(decision);+ } finally {+ await provider?.stop();+ for (const socket of sockets) socket.terminate();+ await new Promise<void>((resolve) => server.close(() => resolve()));+ }+ });+it('waits for the protocol last response before completing flush', async () => {- const server = new WebSocketServer({ port: 0 });+ const server = new WebSocketServer({ host: '127.0.0.1', port: 0 });const sockets: WebSocket[] = [];let provider: VolcengineSaucAsrProvider | undefined;server.on('connection', (socket) => {@@ -340,6 +493,7 @@ describe('VolcengineSaucAsrProvider protocol helpers', () => {it('does not reopen a socket after stop while recovery is connecting', async () => {const server = new WebSocketServer({+ host: '127.0.0.1',port: 0,verifyClient(_info, done) {setTimeout(() => done(true), 80);@@ -392,6 +546,7 @@ describe('VolcengineSaucAsrProvider protocol helpers', () => {it('fails startup instead of hanging when the provider-native socket does not open in time', async () => {const server = new WebSocketServer({+ host: '127.0.0.1',port: 0,verifyClient(_info, done) {setTimeout(() => done(true), 200);@@ -433,6 +588,7 @@ describe('VolcengineSaucAsrProvider protocol helpers', () => {it('reports provider-native handshake failures without waiting for the connect timeout', async () => {const server = new WebSocketServer({+ host: '127.0.0.1',port: 0,verifyClient(_info, done) {done(false, 403, 'Forbidden');@@ -467,7 +623,7 @@ describe('VolcengineSaucAsrProvider protocol helpers', () => {});-function serverTranscriptPacket(text: string, isFinal: boolean, flags = 0x0): Buffer {+function serverTranscriptPacket(text: string, isFinal: boolean, flags = 0x0, endTime?: number): Buffer {const payload = gzipSync(Buffer.from(JSON.stringify({result: {text,@@ -475,6 +631,7 @@ function serverTranscriptPacket(text: string, isFinal: boolean, flags = 0x0): Bu{text,definite: isFinal,+ end_time: endTime,},],},diff --git a/apps/desktop/src/main/voice-input/__tests__/extractTranscript.test.ts b/apps/desktop/src/main/voice-input/__tests__/extractTranscript.test.tsnew file mode 100644index 0000000000..bf7fd6159d--- /dev/null+++ b/apps/desktop/src/main/voice-input/__tests__/extractTranscript.test.ts@@ -0,0 +1,58 @@+import { expect, it } from 'vitest';+import { extractTranscript } from '../VolcengineSaucAsrProvider';++it.each([+ [null, ''],+ ['root text is not a transcript field', ''],+ [{ text: ' ', transcript: '' }, ''],+ [{ TEXT: ' 中文结果 ', unrelated: 'a much longer unrelated value' }, '中文结果'],+ [{ text: 'first', nested: [{ sentence: 'later' }] }, 'first'],+ [{ result: { utterances: [{ text: '短句' }, { ASR_TEXT: '完整识别结果' }] } }, '完整识别结果'],+ [{ text: 123, nested: { transcript: '有效文本' } }, '有效文本'],+])('preserves field matching, whitespace and tie behavior for %j', (payload, expected) => {+ expect(extractTranscript(payload)).toBe(expected);+});++// Frozen pre-optimization algorithm, used as a differential oracle over varied+// nested server JSON. Longest-field and tie semantics must not change.+function previousExtract(payload: unknown): string {+ const keys = new Set(['text', 'transcript', 'sentence', 'asr_text']);+ function collect(value: unknown): string[] {+ if (!value || typeof value !== 'object') return [];+ if (Array.isArray(value)) return value.flatMap(collect);+ const result: string[] = [];+ for (const [key, child] of Object.entries(value)) {+ if (keys.has(key.toLowerCase()) && typeof child === 'string') result.push(child);+ result.push(...collect(child));+ }+ return result;+ }+ return (+ collect(payload)+ .map((value) => value.trim())+ .filter(Boolean)+ .sort((a, b) => b.length - a.length)[0] ?? ''+ );+}++it('matches the previous implementation for 200 deterministic nested payloads', () => {+ let seed = 12345;+ const random = () => {+ seed = (Math.imul(seed, 1664525) + 1013904223) >>> 0;+ return seed;+ };+ function payload(depth: number): unknown {+ if (depth === 0)+ return [' 中文 ', 'same', '', null, 0, ' another result ', '😀'][random() % 7];+ if (random() % 3 === 0) return Array.from({ length: random() % 5 }, () => payload(depth - 1));+ return Object.fromEntries(+ ['text', 'TRANSCRIPT', 'sentence', 'asr_text', 'other']+ .slice(0, random() % 6)+ .map((key) => [key, payload(random() % depth)]),+ );+ }+ for (let i = 0; i < 200; i++) {+ const value = payload(4);+ expect(extractTranscript(value)).toBe(previousExtract(value));+ }+});diff --git a/apps/desktop/src/main/voice-input/__tests__/webSocketHandshakeTiming.test.ts b/apps/desktop/src/main/voice-input/__tests__/webSocketHandshakeTiming.test.tsnew file mode 100644index 0000000000..65615e5c8f--- /dev/null+++ b/apps/desktop/src/main/voice-input/__tests__/webSocketHandshakeTiming.test.ts@@ -0,0 +1,76 @@+import { EventEmitter } from 'node:events';+import type { ClientRequest } from 'node:http';+import { expect, it, vi } from 'vitest';+import { createWebSocketHandshakeTiming } from '../webSocketHandshakeTiming';++function harness() {+ let clock = 100;+ const timing = createWebSocketHandshakeTiming(() => clock);+ const request = Object.assign(new EventEmitter(), { end: vi.fn(), reusedSocket: false });+ timing.finishRequest(request as unknown as ClientRequest);+ return {+ timing,+ request,+ at: (elapsed: number) => {+ clock = 100 + elapsed;+ },+ };+}++it('ends the request immediately and separates DNS, TCP, TLS and upgrade milestones', () => {+ const h = harness();+ expect(h.request.end).toHaveBeenCalledTimes(1);+ const socket = Object.assign(new EventEmitter(), {+ encrypted: true,+ isSessionReused: () => false,+ });+ h.at(1);+ h.request.emit('socket', socket);+ h.at(10);+ socket.emit('lookup', null);+ h.at(200);+ socket.emit('connect');+ h.at(450);+ socket.emit('secureConnect');+ h.at(700);+ h.request.emit('upgrade');+ expect(h.timing.snapshot()).toEqual({+ socketAssignedMs: 1,+ dnsResolvedMs: 10,+ tcpConnectedMs: 200,+ tlsConnectedMs: 450,+ upgradeResponseMs: 700,+ responseWaitMs: 250,+ reusedSocket: false,+ tlsResumed: false,+ });+});++it('does not invent zero-cost handshake stages for a reused socket', () => {+ const h = harness();+ h.request.reusedSocket = true;+ h.at(1);+ h.request.emit('socket', new EventEmitter());+ h.at(300);+ h.request.emit('upgrade');+ expect(h.timing.snapshot()).toEqual({+ socketAssignedMs: 1,+ upgradeResponseMs: 300,+ responseWaitMs: 299,+ reusedSocket: true,+ });+});++it('records rejected upgrades and distinguishes a preconnected proxy socket from reuse', () => {+ const h = harness();+ h.at(900);+ h.request.emit('socket', new EventEmitter());+ h.at(1200);+ h.request.emit('response');+ expect(h.timing.snapshot()).toEqual({+ socketAssignedMs: 900,+ upgradeResponseMs: 1200,+ responseWaitMs: 300,+ reusedSocket: false,+ });+});diff --git a/apps/desktop/src/main/voice-input/index.ts b/apps/desktop/src/main/voice-input/index.tsindex 477fae3be3..92e220e002 100644--- a/apps/desktop/src/main/voice-input/index.ts+++ b/apps/desktop/src/main/voice-input/index.ts@@ -2343,6 +2343,7 @@ export function registerVoiceInputIpc(): void {const controller = new VoiceInputController({asr: provider,refiner,+ pauseRefinementEnabled: true,logger,callbacks: {onStateChanged: (state, outcome) => {diff --git a/apps/desktop/src/main/voice-input/webSocketHandshakeTiming.ts b/apps/desktop/src/main/voice-input/webSocketHandshakeTiming.tsnew file mode 100644index 0000000000..7a220be470--- /dev/null+++ b/apps/desktop/src/main/voice-input/webSocketHandshakeTiming.ts@@ -0,0 +1,58 @@+import type { ClientRequest } from 'node:http';+import type { TLSSocket } from 'node:tls';++/** Times are milestones from dial start, not durations to add together.+ * A proxy agent may return an already-connected tunnel: unavailable TCP/TLS+ * events stay absent rather than being misreported as zero-cost handshakes.+ * Never collect request URLs, headers, addresses, tokens or response bodies.+ */+export function createWebSocketHandshakeTiming(now: () => number = () => performance.now()) {+ const startedAt = now();+ const elapsed = () => Math.max(0, Math.round(now() - startedAt));+ const timing: {+ socketAssignedMs?: number;+ dnsResolvedMs?: number;+ tcpConnectedMs?: number;+ tlsConnectedMs?: number;+ upgradeResponseMs?: number;+ responseWaitMs?: number;+ reusedSocket?: boolean;+ tlsResumed?: boolean;+ } = {};+ let request: ClientRequest | undefined;++ return {+ finishRequest(req: ClientRequest): void {+ request = req;+ req.once('socket', (socket) => {+ timing.socketAssignedMs = elapsed();+ const tls = socket as TLSSocket;+ if (tls.encrypted) timing.tlsResumed = tls.isSessionReused();+ socket.once('lookup', (error) => {+ if (!error) timing.dnsResolvedMs = elapsed();+ });+ socket.once('connect', () => {+ timing.tcpConnectedMs = elapsed();+ });+ socket.once('secureConnect', () => {+ timing.tlsConnectedMs = elapsed();+ timing.tlsResumed = tls.isSessionReused();+ });+ });+ const responded = () => {+ timing.upgradeResponseMs = elapsed();+ timing.reusedSocket = req.reusedSocket;+ const ready = timing.tlsConnectedMs ?? timing.tcpConnectedMs ?? timing.socketAssignedMs;+ if (ready !== undefined) timing.responseWaitMs = timing.upgradeResponseMs - ready;+ };+ // Capture before ws emits open synchronously from its upgrade handler.+ req.prependOnceListener('upgrade', responded);+ req.prependOnceListener('response', responded);+ // ws delegates end() to finishRequest. Never add an await here.+ req.end();+ },+ snapshot() {+ return { ...timing, reusedSocket: request?.reusedSocket };+ },+ };+}diff --git a/apps/desktop/src/renderer/__tests__/voiceInputDraftDecoration.test.ts b/apps/desktop/src/renderer/__tests__/voiceInputDraftDecoration.test.tsindex eeb163b4bb..e54be3137f 100644--- a/apps/desktop/src/renderer/__tests__/voiceInputDraftDecoration.test.ts+++ b/apps/desktop/src/renderer/__tests__/voiceInputDraftDecoration.test.ts@@ -28,6 +28,7 @@ import type { EditorView } from '@tiptap/pm/view';import {createVoiceInputDraftPlugin,+ clearVoiceInputDraftInTransaction,setVoiceInputDraftDecoration,type VoiceInputCaretState,} from '../components/new-chat/VoiceInputDraftDecoration';@@ -84,6 +85,20 @@ function widgetKeys(plugin: ReturnType<typeof createVoiceInputDraftPlugin>, stat}describe('voice input draft decoration anti-flicker contract', () => {+ it.each([false, true])('clears the draft atomically with committed text (replacement=%s)', (replace) => {+ const { plugin, state } = makeState(replace ? '原来的文字' : '');+ const from = 1;+ const to = replace ? state.doc.content.size - 1 : 1;+ const draft = applyDraftMeta(state, { text: '最终文字', source: 'stable', from, to, caretState: 'processing' });+ // Reproduce the old two-phase path: the widget survives the document write.+ const oldCommit = draft.apply(draft.tr.insertText('最终文字', from, to));+ expect(plugin.getState(oldCommit)?.text).toBe('最终文字');+ const committed = draft.apply(clearVoiceInputDraftInTransaction(draft.tr.insertText('最终文字', from, to)));+ expect(committed.doc.textContent).toBe('最终文字');+ expect(plugin.getState(committed)?.text).toBe('');+ expect(widgetKeys(plugin, committed).draft).toBeNull();+ expect(widgetKeys(plugin, committed).caret).not.toBeNull();+ });it('keeps the draft widget key stable across streamed text and source updates', () => {const { plugin, state } = makeState('前文');const listening = applyDraftMeta(state, {diff --git a/apps/desktop/src/renderer/__tests__/voiceInputEnterToSend.test.ts b/apps/desktop/src/renderer/__tests__/voiceInputEnterToSend.test.tsindex 2d67a69c73..8b86e0c233 100644--- a/apps/desktop/src/renderer/__tests__/voiceInputEnterToSend.test.ts+++ b/apps/desktop/src/renderer/__tests__/voiceInputEnterToSend.test.ts@@ -286,7 +286,7 @@ describe('ChatInput voice input Enter-to-send contract', () => {const waitForBusyCompletionBlock = extractBetween(voiceInputSource,'const waitForBusyCompletion = useCallback((waitForRefinement: boolean) => {',- 'const stop = useCallback(async (options?: VoiceInputStopOptions) => {',+ 'const cancel = useCallback(async () => {',);expect(voiceInputSource).toContain('type StopCompletionWaiter = {');expect(voiceInputSource).toContain(@@ -310,7 +310,7 @@ describe('ChatInput voice input Enter-to-send contract', () => {const stopBlock = extractBetween(voiceInputSource,'const stop = useCallback(async (options?: VoiceInputStopOptions) => {',- 'const cancel = useCallback(async () => {',+ 'stopWithGateRef.current = stopWithGate;',);expect(stopBlock).toContain("if (stateRef.current === 'error')");expect(stopBlock).toContain("throw new Error(lastErrorRef.current ?? 'Voice input failed.')");diff --git a/apps/desktop/src/renderer/__tests__/voiceTooltipControl.test.tsx b/apps/desktop/src/renderer/__tests__/voiceTooltipControl.test.tsxnew file mode 100644index 0000000000..91aa9e6fbf--- /dev/null+++ b/apps/desktop/src/renderer/__tests__/voiceTooltipControl.test.tsx@@ -0,0 +1,66 @@+// @vitest-environment jsdom+import React from 'react';+import { act, cleanup, render } from '@testing-library/react';+import { afterEach, expect, it, vi } from 'vitest';++const bridge = vi.hoisted(() => ({+ open: undefined as boolean | undefined,+ change: (_open: boolean) => {},+}));+// Exercise Tip's controlled/hover bridge; Radix's pointer timing is external.+vi.mock('@radix-ui/react-tooltip', () => ({+ Provider: ({ children }: { children: React.ReactNode }) => children,+ Root: ({+ open,+ onOpenChange,+ children,+ }: {+ open?: boolean;+ onOpenChange: (open: boolean) => void;+ children: React.ReactNode;+ }) => {+ bridge.open = open;+ bridge.change = onOpenChange;+ return children;+ },+ Trigger: ({ children }: { children: React.ReactNode }) => children,+ Portal: ({ children }: { children: React.ReactNode }) => children,+ Content: ({ children }: { children: React.ReactNode }) => children,+}));++import { Tip } from '../components/ui/tooltip';+afterEach(cleanup);++it.each([false, true])(+ 'does not revive an old hover after forced open=%s is released',+ (forced) => {+ const view = (controlledOpen?: boolean, text = 'Stop') => (+ <Tip text={text} controlledOpen={controlledOpen} resetHoverOnControlChange>+ <button>Mic</button>+ </Tip>+ );+ const h = render(view());+ act(() => bridge.change(true));+ expect(bridge.open).toBe(true);+ h.rerender(view(forced, 'Confirming'));+ act(() => bridge.change(true)); // pointer remains on the disabled trigger+ expect(bridge.open).toBe(forced);+ h.rerender(view(undefined, 'Start'));+ expect(bridge.open).toBe(false);+ act(() => bridge.change(true)); // a new hover still works+ expect(bridge.open).toBe(true);+ },+);++it('does not change the default hover handoff for other tooltips', () => {+ const view = (controlledOpen?: boolean) => (+ <Tip text="Other" controlledOpen={controlledOpen}>+ <button>Other</button>+ </Tip>+ );+ const h = render(view());+ act(() => bridge.change(true));+ h.rerender(view(false));+ h.rerender(view());+ expect(bridge.open).toBe(true);+});diff --git a/apps/desktop/src/renderer/components/new-chat/ChatInput.tsx b/apps/desktop/src/renderer/components/new-chat/ChatInput.tsxindex 38b0e22ca9..6b679938e5 100644--- a/apps/desktop/src/renderer/components/new-chat/ChatInput.tsx+++ b/apps/desktop/src/renderer/components/new-chat/ChatInput.tsx@@ -47,6 +47,7 @@ import {promoteTrailingPlainListParagraph,} from './ComposerListNodes';import { WindowsSelectionReplacement } from './WindowsSelectionReplacement';+import { useVoiceProcessingIndicator } from '../../voice-input/useVoiceProcessingIndicator';import { EmptyDocSelectionGuard } from './EmptyDocSelectionGuard';import { restoreComposerDocument } from './restoreComposerDocument';import {@@ -3198,12 +3199,13 @@ export function ChatInput({}}, [voiceInputSettings.playInteractionSound]);const handleVoiceInputStart = useCallback(async () => {- const proceed = await onBeforeVoiceInputStart?.();- if (proceed === false) return;- if (voiceInputSettings.playInteractionSound) {- playVoiceInputStartCue();- }- await voiceInput.start();+ await voiceInput.start({+ startedAt: performance.now(),+ beforeStart: onBeforeVoiceInputStart,+ onStartFeedback: () => {+ if (voiceInputSettings.playInteractionSound) return playVoiceInputStartCue();+ },+ });}, [onBeforeVoiceInputStart, voiceInput.start, voiceInputSettings.playInteractionSound]);const playVoiceInputEndCueNow = useCallback(() => {@@ -3606,12 +3608,13 @@ export function ChatInput({// While dictation holds the editor read-only the native caret disappears;// the decoration renders a mic-shaped caret at the insertion point instead// (listening = animated level bars, submitting/refining = spinner).+ const showVoiceProcessing = useVoiceProcessingIndicator(voiceInput.state);const voiceCaretState: VoiceInputCaretState | null = !voiceBusyOnCurrentComposer? null: voiceInput.isListening? 'listening': voiceInput.isBusy- ? 'processing'+ ? showVoiceProcessing ? 'processing' : 'stopping': null;useEffect(() => {@@ -9357,8 +9360,10 @@ function VoiceInputButton({const listening = state === 'listening';const refining = state === 'refining';const busy = state === 'submitting' || state === 'refining';+ const showProcessing = useVoiceProcessingIndicator(state);+ const stopping = busy && !showProcessing;const activeRecording = listening || longPressActive;- const disabledOrBusy = disabled || (busy && !longPressActive);+ const disabledOrBusy = disabled || busy;// ── 录音态宽度形变 + 计时(DESIGN.md §14.4 窄变体,≤240ms)──// 仅录音中展开(2026-07-22 用户定稿:展开必须承载信息,hover 展出「语音」@@ -9369,7 +9374,7 @@ function VoiceInputButton({const pillLabelRef = useRef<HTMLSpanElement>(null);const [pillWidth, setPillWidth] = useState<number | null>(null);const expandable = true;- const expanded = expandable && activeRecording;+ const expanded = expandable && (activeRecording || stopping);const minuteDigits = String(Math.floor(recSeconds / 60)).length;useEffect(() => {@@ -9403,13 +9408,15 @@ function VoiceInputButton({label = t('newChat.chatInput.voiceInput.releaseToStop');} else if (refining) {label = t('newChat.chatInput.voiceInput.refining');+ } else if (state === 'submitting') {+ label = t('voiceInputOverlay.status.submitting');} else if (activeRecording) {label = t('newChat.chatInput.voiceInput.stop');}const tooltipText =- shortcutLabel && !longPressActive && !refining ? `${label} · ${shortcutLabel}` : label;- const controlledTooltipOpen = refining- ? true+ shortcutLabel && !longPressActive && !busy ? `${label} · ${shortcutLabel}` : label;+ const controlledTooltipOpen = busy+ ? showProcessing: longPressActive? !releaseToSendActive: undefined;@@ -9509,7 +9516,8 @@ function VoiceInputButton({}, [clearLongPressTimer, clearSuppressNextClick, setReleaseToSendActive]);return (- <Tip text={tooltipText} side="top" controlledOpen={controlledTooltipOpen}>+ <Tip text={tooltipText} side="top" controlledOpen={controlledTooltipOpen}+ resetHoverOnControlChange contentClassName="data-[state=closed]:hidden"><buttontype="button"className={cn(@@ -9521,10 +9529,11 @@ function VoiceInputButton({'bg-[var(--composer-pill-bg,#FCFCFC)] dark:bg-[var(--composer-pill-bg,#393838)] border border-[var(--border-default)] text-[var(--composer-pill-icon,#3C3F43)] dark:text-[var(--composer-pill-icon,#D9D9D9)]' /* spec 2026-07-17, token by 一哥 */,'hover:bg-[var(--model-trigger-hover)]',// 录音态:与主题同极性的 chip 填充(light 亮灰 / dark 深灰),红点 + 计时承担状态信号- activeRecording &&+ (activeRecording || stopping) &&'bg-[var(--surface-chip)] text-[var(--text-primary)] hover:bg-[var(--surface-chip)]','focus-visible:outline-none',- disabledOrBusy && 'cursor-not-allowed opacity-40',+ disabledOrBusy && 'cursor-not-allowed',+ disabledOrBusy && !stopping && 'opacity-40',className,)}style={expandable ? { width: pillWidth ?? 30, transition: pillTransition } : undefined}@@ -9571,11 +9580,13 @@ function VoiceInputButton({void (listening ? onStop() : onStart());}}>- {/* 28px 图标位: idle 麦克风 / 录音红点(呼吸动画挂 wrapper,仅 opacity) / refining spinner。+ {/* 28px 图标位: idle 麦克风 / 录音红点(呼吸动画挂 wrapper,仅 opacity) / 停止后处理 spinner。会话内与新建对话框共用(不再按 create-agent 分叉)。 */}<span className="flex h-[28px] w-[28px] shrink-0 items-center justify-center">- {refining ? (+ {showProcessing ? (<Spinner size={15} />+ ) : stopping ? (+ <span className="h-2 w-2 rounded-full bg-[var(--settings-badge-error)]" />) : activeRecording ? (<span className="inline-flex animate-pulse motion-reduce:animate-none"><span className="h-2 w-2 rounded-full bg-[var(--settings-badge-error)]" />@@ -9594,7 +9605,7 @@ function VoiceInputButton({'motion-reduce:transition-none',)}>- {activeRecording ? recTimeText : ''}+ {activeRecording || stopping ? recTimeText : ''}</span></button></Tip>diff --git a/apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts b/apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.tsindex 808d588eed..7077554ed4 100644--- a/apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts+++ b/apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts@@ -15,7 +15,7 @@ import { MIC_WAVE_ICON_SVG } from '../../voice-input/VoiceInputMicWaveIcon';* 'listening' shows a static mic with animated level bars inside the capsule;* 'processing' (submitting/refining) shows a spinner arc. Null hides the caret.*/-export type VoiceInputCaretState = 'listening' | 'processing';+export type VoiceInputCaretState = 'listening' | 'stopping' | 'processing';type VoiceInputDraftMeta = {text: string;@@ -33,6 +33,18 @@ type VoiceInputDraftDecorationState = VoiceInputDraftMeta & {const PLUGIN_KEY = new PluginKey<VoiceInputDraftDecorationState>('voiceInputDraftDecoration');const META_KEY = 'voiceInputDraftDecoration';+/** Remove the temporary text in the very transaction that commits real text.+ * React's later effect is too late: the old widget can survive next to the+ * newly inserted document for a paint. Keep the processing caret meanwhile.+ */+export function clearVoiceInputDraftInTransaction(tr: Transaction): Transaction {+ return tr.setMeta(META_KEY, {+ text: '', source: null,+ from: tr.selection.from, to: tr.selection.from,+ anchorLocked: false, caretState: 'stopping',+ } satisfies VoiceInputDraftMeta);+}+export type VoiceInputReplacementRange = {from: number;to: number;diff --git a/apps/desktop/src/renderer/components/ui/tooltip.tsx b/apps/desktop/src/renderer/components/ui/tooltip.tsxindex 6dd6453c64..c868f60cb7 100644--- a/apps/desktop/src/renderer/components/ui/tooltip.tsx+++ b/apps/desktop/src/renderer/components/ui/tooltip.tsx@@ -124,6 +124,8 @@ export interface TipProps {forceOpen?: boolean;/** 受控开关。提供时优先于 forceOpen,用于需要明确关闭 tooltip 的拖拽态。 */controlledOpen?: boolean;+ /** Discard hover requests while temporarily controlled (e.g. recording). */+ resetHoverOnControlChange?: boolean;/** 自定义 Content 样式(覆盖默认宽度等) */contentClassName?: string;}@@ -141,6 +143,7 @@ export const Tip = React.forwardRef<unknown, TipProps>(function Tip(props, forwadisabled,forceOpen,controlledOpen,+ resetHoverOnControlChange = false,contentClassName,...rest} = props;@@ -162,6 +165,9 @@ export const Tip = React.forwardRef<unknown, TipProps>(function Tip(props, forwa);if (requestedOpen !== undefined) controlledRef.current = true;const open = requestedOpen ?? (controlledRef.current ? hoverOpen : undefined);+ React.useLayoutEffect(() => {+ if (resetHoverOnControlChange && requestedOpen !== undefined) setHoverOpen(false);+ }, [resetHoverOnControlChange, requestedOpen]);// 没有 tooltip 内容时,Tip 仍要保持"透明传递":把外层 props/ref 直接合并到 children,// 避免在复合 trigger 里成为 ref/事件断点。React 18 的 cloneElement 类型签名不接受 ref@@ -175,7 +181,11 @@ export const Tip = React.forwardRef<unknown, TipProps>(function Tip(props, forwareturn (<TooltipProvider delayDuration={delay}>- <TooltipRoot open={open} onOpenChange={setHoverOpen}>+ <TooltipRoot open={open} onOpenChange={(next) => {+ // A hover callback during forced display must not reopen a different+ // label when control returns to the pointer after recording stops.+ setHoverOpen(resetHoverOnControlChange && requestedOpen !== undefined ? false : next);+ }}><TooltipTriggerasChildref={forwardedRef as React.Ref<HTMLButtonElement>}diff --git a/apps/desktop/src/renderer/hooks/useVendorAuthGate.ts b/apps/desktop/src/renderer/hooks/useVendorAuthGate.tsindex 174f31eaea..f6b583e8d5 100644--- a/apps/desktop/src/renderer/hooks/useVendorAuthGate.ts+++ b/apps/desktop/src/renderer/hooks/useVendorAuthGate.ts@@ -244,7 +244,8 @@ export function useVendorAuthGate(): UseVendorAuthGateReturn {options?: { purpose?: GatePurpose; deviceId?: string; existingSessionRoute?: boolean },): Promise<GateResult> => {if (options?.purpose === 'voice-input') {- const readiness = await window.electronAPI.voiceInput.getReadiness();+ const cached = window.electronAPI.voiceInput.getReadinessCached();+ const readiness = cached?.ok ? cached : await window.electronAPI.voiceInput.getReadiness();if (readiness.ok) return { proceed: true };const dialogCopy = pickVoiceInputDialogCopy(copy, readiness);diff --git a/apps/desktop/src/renderer/voice-input/VoiceInputOverlay.tsx b/apps/desktop/src/renderer/voice-input/VoiceInputOverlay.tsxindex f14e2002c0..f0bd2b8cba 100644--- a/apps/desktop/src/renderer/voice-input/VoiceInputOverlay.tsx+++ b/apps/desktop/src/renderer/voice-input/VoiceInputOverlay.tsx@@ -45,7 +45,6 @@ import {import {playVoiceInputEndCue,playVoiceInputStartCue,- prepareVoiceInputCues,} from './startCue';import {VOICE_INPUT_REFINEMENT_CACHE_SCOPE,@@ -67,6 +66,7 @@ import {resolveBrowserVoiceInputLanguage,} from './refinementContextBuilder';import { requestRendererMicrophonePermission, resolveVoiceInputStartGuards } from './startGuards';+import { createVoiceInputStartupTimeline, type VoiceInputStartupTimeline } from './startupTimeline';import { formatVoiceInputShortcut } from './shortcut';import { VoiceInputMicWaveIcon } from './VoiceInputMicWaveIcon';import { getVoiceInputWorkletUrl } from './workletUrl';@@ -77,6 +77,7 @@ import {type VoiceInputRecoverySettingsTab,} from './readinessRecovery';import { buildRefinementPreviewText } from './refinementPreviewText';+import { useVoiceProcessingIndicator } from './useVoiceProcessingIndicator';import { isVoiceInputEventScopeActive, shouldHandleVoiceInputEvent } from './eventScope';import { VoiceInputStatusErrorIcon, VoiceInputStatusNotice } from './VoiceInputStatusNotice';import { useVoiceInputOverlayDrag } from './useVoiceInputOverlayDrag';@@ -223,6 +224,7 @@ export function VoiceInputOverlay() {},});const [state, setState] = useState<VoiceInputState>('idle');+ const showProcessing = useVoiceProcessingIndicator(state);const [draftText, setDraftText] = useState('');const [finalText, setFinalText] = useState('');const [refinementPreviewText, setRefinementPreviewText] = useState('');@@ -239,6 +241,7 @@ export function VoiceInputOverlay() {));const settingsRef = useRef(getVoiceInputSettings());+ const startupTimelineRef = useRef<VoiceInputStartupTimeline | null>(null);const engineRef = useRef<WebMicAudioEngine | null>(null);const runIdRef = useRef<string | null>(null);const stateRef = useRef<VoiceInputState>('idle');@@ -250,11 +253,10 @@ export function VoiceInputOverlay() {const pendingPasteTextRef = useRef('');const historyEntryIdRef = useRef<string | null>(null);const sentAudioMsRef = useRef(0);+ const hasRecordingContentRef = useRef(false);const terminalOutcomeRef = useRef<VoiceInputUsageOutcome>('success');const systemAudioMutedRef = useRef(false);const pendingSystemAudioMutePromiseRef = useRef<Promise<void> | null>(null);- const systemAudioMuteGateOpenRef = useRef(true);- const systemAudioMuteGateDropLoggedRef = useRef(false);const closingRef = useRef(false);const startAttemptIdRef = useRef(0);const pasteAttemptIdRef = useRef(0);@@ -351,6 +353,8 @@ export function VoiceInputOverlay() {const invalidateStartAttempt = useCallback(() => {startAttemptIdRef.current += 1;+ startReadyRef.current?.resolve({ ok: false, error: 'Voice input start was cancelled.' });+ startReadyRef.current = null;}, []);const createStartReadyState = useCallback((attemptId: number) => {@@ -486,14 +490,6 @@ export function VoiceInputOverlay() {window.electronAPI.voiceInput.appendAudio(chunk);}, []);- const canAcceptAudioChunk = useCallback(() => {- if (systemAudioMuteGateOpenRef.current) return true;- if (!systemAudioMuteGateDropLoggedRef.current) {- systemAudioMuteGateDropLoggedRef.current = true;- log.debug('global dropping pcm until system audio mute completes');- }- return false;- }, []);const cancelStartedRun = useCallback((startPromise: Promise<StartVoiceInputResult>) => {void startPromise@@ -506,19 +502,17 @@ export function VoiceInputOverlay() {});}, []);- const muteSystemAudioForRecording = useCallback(() => {+ const muteSystemAudioForRecording = useCallback((feedback: Promise<void>) => {if (!supportsSystemAudioMute()) {- systemAudioMuteGateOpenRef.current = true;return Promise.resolve();}if (systemAudioMutedRef.current) {- systemAudioMuteGateOpenRef.current = true;return pendingSystemAudioMutePromiseRef.current ?? Promise.resolve();}if (pendingSystemAudioMutePromiseRef.current) return pendingSystemAudioMutePromiseRef.current;- const mutePromise = window.electronAPI.voiceInput- .muteSystemAudio()+ const mutePromise = feedback.catch(() => undefined)+ .then(() => window.electronAPI.voiceInput.muteSystemAudio()).then((result) => {if (result.ok) {systemAudioMutedRef.current = true;@@ -530,7 +524,6 @@ export function VoiceInputOverlay() {log.warn('global system audio mute failed:', muteError instanceof Error ? muteError.message : String(muteError));}).finally(() => {- systemAudioMuteGateOpenRef.current = true;if (pendingSystemAudioMutePromiseRef.current === mutePromise) {pendingSystemAudioMutePromiseRef.current = null;}@@ -540,7 +533,6 @@ export function VoiceInputOverlay() {}, []);const restoreSystemAudioForRecording = useCallback(async () => {- systemAudioMuteGateOpenRef.current = true;if (!supportsSystemAudioMute()) return;const pendingMute = pendingSystemAudioMutePromiseRef.current;if (pendingMute) await pendingMute;@@ -784,6 +776,8 @@ export function VoiceInputOverlay() {if (stateRef.current === 'listening' || stateRef.current === 'submitting' || stateRef.current === 'refining') {return;}+ const timeline = createVoiceInputStartupTimeline('overlay');+ startupTimelineRef.current = timeline;invalidateCodexRecoveryPrompt();clearErrorCloseTimer();resetOverlayInteraction();@@ -796,8 +790,7 @@ export function VoiceInputOverlay() {closingRef.current = false;cancelRequestedRef.current = false;await stopEngine();- const bootstrapStartedAt = performance.now();- const elapsedMs = () => Math.round(performance.now() - bootstrapStartedAt);+ const { elapsedMs } = timeline;setError(null);setCodexRecovery(null);@@ -817,24 +810,63 @@ export function VoiceInputOverlay() {pendingPasteTextRef.current = '';historyEntryIdRef.current = null;sentAudioMsRef.current = 0;+ hasRecordingContentRef.current = false;terminalOutcomeRef.current = 'success';runIdRef.current = null;ownedRunIdRef.current = null;- systemAudioMuteGateOpenRef.current = true;- systemAudioMuteGateDropLoggedRef.current = false;- if (settings.muteSystemAudio && supportsSystemAudioMute()) {- systemAudioMuteGateOpenRef.current = false;- void muteSystemAudioForRecording();- }+setVoiceState('listening');log.debug('global voice input bootstrap requested');- // Positive permission/readiness cache removes the common two-IPC delay- // from shortcut-to-microphone. Negative or missing cache still uses the- // async path so newly granted permission / freshly completed Codex login- // can be picked up immediately. Main verifies readiness again in start().- const guards = await resolveVoiceInputStartGuards({ requireAccessibility: true });+ const capturePromise = startVoiceInputCaptureSession({+ label: 'global',+ workletUrl,+ deviceId: settings.microphoneDeviceId ?? undefined,+ fastActivationEnabled: settings.fastActivationEnabled,+ getRunId: () => runIdRef.current,+ setEngine: (engine) => {+ engineRef.current = engine;+ },+ isCurrentEngine: (engine) => startAttemptIdRef.current === attemptId && engineRef.current === engine,+ timeline,+ appendAudioChunk,+ onSoundDetected: () => { hasRecordingContentRef.current = true; },+ onInterrupted: (message) => {+ if (isActiveStartAttempt(attemptId)) void failRecording(message);+ },+ onStateChange: (event, details) => {+ log.debug('global microphone engine', event, details);+ },+ getFallbackMessage: formatMicrophoneFallbackMessage,+ onFallback: setMicrophoneNotice,+ formatStartError: formatMicrophoneStartError,+ elapsedMs,+ });++ // Start capture first; feedback runs independently without awaiting the+ // microphone. Only system mute waits for playback to avoid cutting it off.+ const feedback = Promise.resolve().then(() => {+ if (!isActiveStartAttempt(attemptId) || stateRef.current !== 'listening') return;+ return settings.playInteractionSound ? playVoiceInputStartCue() : undefined;+ });+ if (settings.muteSystemAudio && supportsSystemAudioMute()) {+ void muteSystemAudioForRecording(feedback).then(() => timeline.mark('mute_finished'));+ } else {+ void feedback.catch(() => undefined);+ }+ let guards: Awaited<ReturnType<typeof resolveVoiceInputStartGuards>>;+ try {+ guards = await resolveVoiceInputStartGuards({ requireAccessibility: true });+ } catch (error) {+ if (isActiveStartAttempt(attemptId)) {+ const message = error instanceof Error ? error.message : String(error);+ resolveStartReadyState(attemptId, { ok: false, error: message });+ await failRecording(message);+ }+ return;+ }+ timeline.mark('checks_finished');log.info('global voice input start guards checked', {ok: guards.ok,failed: guards.ok ? undefined : guards.failed,@@ -846,7 +878,6 @@ export function VoiceInputOverlay() {});if (!isActiveStartAttempt(attemptId)) {resolveStartReadyState(attemptId, { ok: false, error: 'Voice input start was cancelled.' });- await restoreSystemAudioForRecording();return;}if (!guards.permission.ok) {@@ -855,6 +886,7 @@ export function VoiceInputOverlay() {setPermissionPrompt('microphone');setVoiceState('done');closingRef.current = false;+ await stopEngine();await restoreSystemAudioForRecording();return;}@@ -864,6 +896,7 @@ export function VoiceInputOverlay() {setPermissionPrompt('accessibility');setVoiceState('done');closingRef.current = false;+ await stopEngine();await restoreSystemAudioForRecording();return;}@@ -877,13 +910,6 @@ export function VoiceInputOverlay() {return;}- if (settings.playInteractionSound) {- prepareVoiceInputCues();- playVoiceInputStartCue();- }-- // Both gates passed — fire the start IPC in parallel with engine.start()- // so the ASR WebSocket and mic capture initialize concurrently.const startResultPromise: Promise<StartVoiceInputResult> = window.electronAPI.voiceInput.start({sourceLanguage: settings.language,@@ -891,34 +917,23 @@ export function VoiceInputOverlay() {refinementContext: settings.refinementEnabled ? buildRefinementContext() : undefined,refinementCacheScope: VOICE_INPUT_REFINEMENT_CACHE_SCOPE,})+ .then((result) => {+ if (result.ok) timeline.mark('connection_ready');+ return result;+ }).catch((startError): StartVoiceInputResult => ({ok: false,error: startError instanceof Error ? startError.message : String(startError),}));- const captureStart = await startVoiceInputCaptureSession({- label: 'global',- workletUrl,- deviceId: settings.microphoneDeviceId ?? undefined,- fastActivationEnabled: settings.fastActivationEnabled,- getRunId: () => runIdRef.current,- setEngine: (engine) => {- engineRef.current = engine;- },- isCurrentEngine: (engine) => startAttemptIdRef.current === attemptId && engineRef.current === engine,- canAcceptAudioChunk,- appendAudioChunk,- onInterrupted: (message) => {- void failRecording(message);- },- onStateChange: (event, details) => {- log.debug('global microphone engine', event, details);- },- getFallbackMessage: formatMicrophoneFallbackMessage,- onFallback: setMicrophoneNotice,- formatStartError: formatMicrophoneStartError,- elapsedMs,- });+ const captureStart = await capturePromise;+ if (!isActiveStartAttempt(attemptId)) {+ resolveStartReadyState(attemptId, { ok: false, error: 'Voice input start was cancelled.' });+ void startResultPromise.then((result) => {+ if (result.ok) void window.electronAPI.voiceInput.cancel({ runId: result.runId });+ });+ return;+ }if (!captureStart.ok) {// 电源释放(锁屏/挂起)取消了启动:走与「启动尝试已失效」相同的静默清理,// 不把内部错误消息推到 UI —— 用户是主动离开,不是遇到故障。@@ -970,13 +985,9 @@ export function VoiceInputOverlay() {const result = await startResultPromise;if (!isActiveStartAttempt(attemptId)) {resolveStartReadyState(attemptId, { ok: false, error: result.ok ? 'Voice input start was cancelled.' : result.error });- await stopEngine();- await restoreSystemAudioForRecording();- if (result.ok) {- await window.electronAPI.voiceInput.cancel({ runId: result.runId });- } else if (!suppressedStartErrorAttemptsRef.current.has(attemptId)) {- await showStartFailure(result.error, result.authErrorReason);- }+ // The cancelling attempt already stopped its own device. A late network+ // result must not touch a replacement attempt's microphone or UI.+ if (result.ok) await window.electronAPI.voiceInput.cancel({ runId: result.runId });suppressedStartErrorAttemptsRef.current.delete(attemptId);return;}@@ -995,7 +1006,6 @@ export function VoiceInputOverlay() {}, [appendAudioChunk,buildRefinementContext,- canAcceptAudioChunk,cancelStartedRun,clearErrorCloseTimer,closeOverlay,@@ -1177,9 +1187,16 @@ export function VoiceInputOverlay() {closingRef.current = true;const settings = settingsRef.current;- setVoiceState('submitting');+ if (hasRecordingContentRef.current) setVoiceState('submitting');await drainAndStopEngine();+ if (cancelRequestedRef.current) return;void restoreSystemAudioAndMaybePlayEndCue(settings.playInteractionSound);+ if (!hasRecordingContentRef.current && !draftTextRef.current.trim() && !finalTextRef.current.trim()) {+ log.info('global silent recording ended without ASR finalization');+ await cancelAndClose();+ return;+ }+ setVoiceState('submitting');let runId = runIdRef.current;if (!runId && startReadyRef.current) {@@ -1276,6 +1293,7 @@ export function VoiceInputOverlay() {closeOverlay,closeOverlayAndReset,commitUsageStats,+ cancelAndClose,drainAndStopEngine,drainQueuedAudioToMain,formatVoiceInputStartError,@@ -1352,12 +1370,16 @@ export function VoiceInputOverlay() {}break;case 'draft':+ if (event.text.trim()) hasRecordingContentRef.current = true;+ if (event.text.trim()) startupTimelineRef.current?.mark('first_transcript');draftTextRef.current = event.text;setDraftText(event.text);break;case 'submitted':+ if (event.text.trim()) hasRecordingContentRef.current = true;+ if (event.text.trim()) startupTimelineRef.current?.mark('first_transcript');finalTextRef.current = event.text;- rawTranscriptTextRef.current = event.text;+ rawTranscriptTextRef.current = event.segment.basedOnText ?? event.text;setRefinementPreviewText('');// closingRef only prevents duplicate submit/paste. The overlay remains// visible while ASR/refine finishes, so keep its transcript display live@@ -1556,10 +1578,11 @@ export function VoiceInputOverlay() {if (pasteErrorCode === 'retained') return t('voiceInputOverlay.status.transcriptKept');if (hasPasteError) return t('voiceInputOverlay.status.inputFailed');if (hasBlockingError) return t('voiceInputOverlay.status.error');+ if ((state === 'submitting' || state === 'refining') && !showProcessing) return '';if (state === 'refining') return t('voiceInputOverlay.status.refining');if (state === 'submitting') return t('voiceInputOverlay.status.submitting');return t('voiceInputOverlay.status.listening');- }, [hasBlockingError, hasPasteError, hasPermissionPrompt, pasteErrorCode, state, t]);+ }, [hasBlockingError, hasPasteError, hasPermissionPrompt, pasteErrorCode, state, showProcessing, t]);// The retained-transcript panel shows the session's own error (cause + "text// was kept"); every other code is an actual paste failure with its own hint.const pasteFailureHint = pasteErrorCode === 'retained'@@ -1592,7 +1615,7 @@ export function VoiceInputOverlay() {<div className="mb-2 flex items-center gap-2 text-[var(--cmd-palette-item-meta)]">{hasBlockingError ? (<VoiceInputStatusErrorIcon />- ) : state === 'refining' || state === 'submitting' ? (+ ) : showProcessing ? (<Spinner size={16} className="text-[var(--cmd-palette-item-text)]" />) : (// Same mic icon as the in-app voice caret. The cached overlay candiff --git a/apps/desktop/src/renderer/voice-input/WebMicAudioEngine.ts b/apps/desktop/src/renderer/voice-input/WebMicAudioEngine.tsindex f766748a34..f05be36aed 100644--- a/apps/desktop/src/renderer/voice-input/WebMicAudioEngine.ts+++ b/apps/desktop/src/renderer/voice-input/WebMicAudioEngine.ts@@ -1069,6 +1069,9 @@ export class WebMicAudioEngine {return;} catch (error) {if (isSelectedMicrophoneUnavailableError(error)) throw error;+ // Permission is requested by this capture, not by a disposable probe.+ // Retrying the cold path after denial would open/request it twice.+ if (isMicrophonePermissionDeniedError(error)) throw error;// Only a *power* release ends the attempt. Falling through to the cold// getUserMedia() below after a suspend/lock would open a brand-new// stream once that one-shot event has passed, with nothing left to@@ -1631,9 +1634,10 @@ export class WebMicAudioEngine {this.onInterrupted?.(message);}- private resample(input: Float32Array, fromRate: number, toRate: number): number[] {+ private resample(input: Float32Array, fromRate: number, toRate: number): number[] | Float32Array {if (input.length === 0) return [];- if (fromRate === toRate) return Array.from(input);+ // handleInputFrame consumes the values synchronously without retaining input.+ if (fromRate === toRate) return input;const ratio = fromRate / toRate;const output: number[] = [];diff --git a/apps/desktop/src/renderer/voice-input/__tests__/WebMicAudioEngine.prewarm.test.ts b/apps/desktop/src/renderer/voice-input/__tests__/WebMicAudioEngine.prewarm.test.tsindex 60d2b97b53..af004f6b28 100644--- a/apps/desktop/src/renderer/voice-input/__tests__/WebMicAudioEngine.prewarm.test.ts+++ b/apps/desktop/src/renderer/voice-input/__tests__/WebMicAudioEngine.prewarm.test.ts@@ -114,6 +114,17 @@ describe('prewarmVoiceInputMicrophoneWithAutomaticFallback', () => {vi.restoreAllMocks();});+ it('requests microphone permission only once when keep-alive capture is denied', async () => {+ getUserMedia.mockRejectedValue(new DOMException('Permission denied', 'NotAllowedError'));+ const engine = new WebMicAudioEngine({+ workletUrl: 'https://app.local/pcm16k-worklet.js',+ keepAlive: true,+ });+ await expect(engine.start()).rejects.toMatchObject({ name: 'NotAllowedError' });+ expect(getUserMedia).toHaveBeenCalledTimes(1);+ await engine.stop();+ });+it('defers keep-alive disposal when the active microphone receives a devicechange event', async () => {const onStateChange = vi.fn();const engine = new WebMicAudioEngine({diff --git a/apps/desktop/src/renderer/voice-input/__tests__/audioResampling.test.ts b/apps/desktop/src/renderer/voice-input/__tests__/audioResampling.test.tsindex 1f2efbc077..cc6a8cc18e 100644--- a/apps/desktop/src/renderer/voice-input/__tests__/audioResampling.test.ts+++ b/apps/desktop/src/renderer/voice-input/__tests__/audioResampling.test.ts@@ -10,6 +10,7 @@ vi.mock('../audioContextPool', () => ({ PCM16K_WORKLET_NAME: 'pcm16k-worklet' })type Capture = {output: number[];+ frames?: number[];feed: (input: Float32Array) => void;drain: () => Promise<void>;reset: () => Promise<void>;@@ -17,6 +18,7 @@ type Capture = {function createWorkletCapture(rate: number): Capture {const output: number[] = [];+ const frames: number[] = [];type Processor = {port: { onmessage: (event: { data: Record<string, unknown> }) => void };process: (inputs: Float32Array[][]) => void;@@ -29,7 +31,11 @@ function createWorkletCapture(rate: number): Capture {port = {onmessage: null,postMessage: (message: { type: string; pcm16k?: ArrayBuffer }) => {- if (message.type === 'pcm16k') output.push(...new Int16Array(message.pcm16k!));+ if (message.type === 'pcm16k') {+ const pcm = new Int16Array(message.pcm16k!);+ output.push(...pcm);+ frames.push(pcm.length);+ }},};},@@ -45,6 +51,7 @@ function createWorkletCapture(rate: number): Capture {const send = (data: Record<string, unknown>): void => processor.port.onmessage({ data });return {output,+ frames,feed: (input) => processor.process([[input]]),drain: async () => {send({ type: 'flush', flushId: 1 });@@ -112,7 +119,7 @@ describe.each([},);- it.each([48_000, 44_100, 8_000])(+ it.each([48_000, 44_100, 16_000, 8_000])('preserves the waveform across arbitrary block boundaries at %i Hz',async (rate) => {const input = Float32Array.from({ length: 4097 }, (_, i) => Math.sin(i * 0.13) * 0.7);@@ -129,6 +136,18 @@ describe.each([},);+ it('does not retain or mutate the browser input buffer when no resampling is needed', async () => {+ const capture = createCapture(16_000);+ const input = Float32Array.from({ length: 128 }, (_, i) => Math.sin(i * 0.13) * 0.7);+ const original = input.slice();+ capture.feed(input);+ expect(input).toEqual(original);+ // The browser may overwrite its input buffer on the next render quantum.+ input.fill(-1);+ await capture.drain();+ expect(capture.output).toEqual(expectedPcm(original, 16_000));+ });+it('does not carry samples or fractional position into the next recording', async () => {const capture = createCapture(44_100);feedChunks(capture, new Float32Array(256).fill(-0.75), [128]);@@ -140,3 +159,19 @@ describe.each([expect(capture.output).toEqual(expectedPcm(next, 44_100));});});++it('delivers 10 ms first, then normal 40 ms packets, including after reactivation', async () => {+ const capture = createWorkletCapture(16000);+ for (let attempt = 0; attempt < 2; attempt++) {+ capture.output.length = 0;+ capture.frames!.length = 0;+ capture.feed(new Float32Array(159).fill(0.5));+ expect(capture.output).toHaveLength(0);+ capture.feed(new Float32Array(1).fill(0.5));+ expect(capture.frames).toEqual([160]);+ capture.feed(new Float32Array(640).fill(0.5));+ expect(capture.frames).toEqual([160, 640]);+ expect(capture.output).toEqual(expectedPcm(new Float32Array(800).fill(0.5), 16000));+ await capture.reset();+ }+});diff --git a/apps/desktop/src/renderer/voice-input/__tests__/pcmActivity.test.ts b/apps/desktop/src/renderer/voice-input/__tests__/pcmActivity.test.tsnew file mode 100644index 0000000000..b95ddefb45--- /dev/null+++ b/apps/desktop/src/renderer/voice-input/__tests__/pcmActivity.test.ts@@ -0,0 +1,29 @@+import { describe, expect, it } from 'vitest';+import { hasPcmSound } from '../pcmActivity';++describe('conservative PCM silence check', () => {+ it('accepts empty, digital silence and a very low noise floor as silent', () => {+ for (const pcm of [+ new Int16Array(),+ new Int16Array(640),+ Int16Array.from({ length: 640 }, (_, i) => (i % 2 ? 12 : -12)),+ ]) {+ expect(hasPcmSound(pcm.buffer)).toBe(false);+ }+ });++ it('keeps quiet sound well below the cloud stall watchdog speech threshold', () => {+ const pcm = Int16Array.from({ length: 640 }, (_, i) => Math.round(60 * Math.sin(i * 0.1)));+ expect(hasPcmSound(pcm.buffer)).toBe(true);+ });++ it('keeps a brief sound even when the full chunk RMS is small', () => {+ const pcm = new Int16Array(640);+ pcm[300] = -150;+ expect(hasPcmSound(pcm.buffer)).toBe(true);+ });++ it('does not discard malformed PCM as silence', () => {+ expect(hasPcmSound(new ArrayBuffer(3))).toBe(true);+ });+});diff --git a/apps/desktop/src/renderer/voice-input/__tests__/refinementPreviewText.test.ts b/apps/desktop/src/renderer/voice-input/__tests__/refinementPreviewText.test.tsindex de1f3c86e0..83a4c43f0b 100644--- a/apps/desktop/src/renderer/voice-input/__tests__/refinementPreviewText.test.ts+++ b/apps/desktop/src/renderer/voice-input/__tests__/refinementPreviewText.test.ts@@ -3,12 +3,12 @@ import { describe, expect, it } from 'vitest';import { buildRefinementPreviewText } from '../refinementPreviewText';describe('buildRefinementPreviewText', () => {- it('preserves the raw suffix while the streaming preview is shorter', () => {- expect(buildRefinementPreviewText('嗯那个我们今天先不要提交', '我们今天')).toBe('我们今天们今天先不要提交');+ it('does not splice a shifted raw suffix after filler words are removed', () => {+ expect(buildRefinementPreviewText('嗯那个我们今天先不要提交', '我们今天')).toBe('嗯那个我们今天先不要提交');});- it('uses the preview directly after it reaches the raw text length', () => {- expect(buildRefinementPreviewText('今天测试', '今天测试语音输入')).toBe('今天测试语音输入');+ it('does not expand the text with an unvalidated streaming result', () => {+ expect(buildRefinementPreviewText('今天测试', '今天测试语音输入')).toBe('今天测试');});it('keeps the raw text visible when preview is empty', () => {diff --git a/apps/desktop/src/renderer/voice-input/__tests__/startCue.test.ts b/apps/desktop/src/renderer/voice-input/__tests__/startCue.test.tsnew file mode 100644index 0000000000..1c9914db99--- /dev/null+++ b/apps/desktop/src/renderer/voice-input/__tests__/startCue.test.ts@@ -0,0 +1,79 @@+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++beforeEach(() => {+ vi.useFakeTimers();+ vi.resetModules();+});+afterEach(() => {+ vi.useRealTimers();+ vi.unstubAllGlobals();+});++function audioContext(state = 'running') {+ const parameter = { setValueAtTime: vi.fn(), exponentialRampToValueAtTime: vi.fn() };+ const oscillator = {+ type: '',+ frequency: parameter,+ connect: vi.fn(),+ disconnect: vi.fn(),+ start: vi.fn(),+ stop: vi.fn(),+ onended: null as (() => void) | null,+ };+ const gain = { gain: parameter, connect: vi.fn(), disconnect: vi.fn() };+ const context = {+ state,+ currentTime: 0,+ destination: {},+ createOscillator: () => oscillator,+ createGain: () => gain,+ resume: vi.fn(() => new Promise<void>(() => {})),+ };+ vi.stubGlobal(+ 'AudioContext',+ vi.fn(function () {+ return context;+ }),+ );+ return { oscillator, gain, context };+}++describe('ready cue completion for system mute', () => {+ it('settles after playback ends and disconnects its audio nodes', async () => {+ const { oscillator, gain } = audioContext();+ const { playVoiceInputStartCue } = await import('../startCue');+ const done = vi.fn();+ const playback = playVoiceInputStartCue().then(done);+ await Promise.resolve();+ expect(done).not.toHaveBeenCalled();+ oscillator.onended?.();+ await playback;+ expect(done).toHaveBeenCalledOnce();+ expect(oscillator.disconnect).toHaveBeenCalledOnce();+ expect(gain.disconnect).toHaveBeenCalledOnce();+ expect(vi.getTimerCount()).toBe(0);+ });++ it('bounds a suspended context and cancels the sound so it cannot play late', async () => {+ const { oscillator } = audioContext('suspended');+ const { playVoiceInputStartCue } = await import('../startCue');+ const playback = playVoiceInputStartCue();+ await vi.advanceTimersByTimeAsync(310);+ await playback;+ expect(oscillator.stop).toHaveBeenLastCalledWith();+ expect(oscillator.disconnect).toHaveBeenCalledOnce();+ expect(oscillator.onended).toBeNull();+ });++ it('does not prevent muting when playback is unavailable', async () => {+ vi.stubGlobal(+ 'AudioContext',+ vi.fn(function () {+ throw new Error('unavailable');+ }),+ );+ const { playVoiceInputStartCue } = await import('../startCue');+ await expect(playVoiceInputStartCue()).resolves.toBeUndefined();+ expect(vi.getTimerCount()).toBe(0);+ });+});diff --git a/apps/desktop/src/renderer/voice-input/__tests__/startGuards.test.ts b/apps/desktop/src/renderer/voice-input/__tests__/startGuards.test.tsindex e064dfac3d..bca6a3b3d2 100644--- a/apps/desktop/src/renderer/voice-input/__tests__/startGuards.test.ts+++ b/apps/desktop/src/renderer/voice-input/__tests__/startGuards.test.ts@@ -70,36 +70,13 @@ describe('resolveVoiceInputStartGuards', () => {expect(apis.setRendererMicrophonePermissionVerified).not.toHaveBeenCalled();});- it('refreshes a missing Windows permission cache before allowing voice input to start', async () => {- const unknownPermission = {- ok: false as const,- status: 'unknown',- error: 'Microphone permission is required for voice input. Enable it in Windows Settings.',- };- const apis = stubVoiceInputApis('win32', unknownPermission);- const denial = {- ok: false as const,- status: 'denied',- error: 'Microphone permission is required for voice input. Enable it in Windows Settings.',- };- apis.getUserMedia.mockRejectedValue(new Error('Permission denied'));- apis.requestMicrophonePermission.mockResolvedValue(denial);- apis.getSystemPermissions.mockResolvedValue({- microphone: denial,- inputMonitoring: grantedPermission,- accessibility: grantedPermission,- });-+ it.each(['unknown', 'denied'])('leaves %s permission to the real capture without opening a probe', async (status) => {+ const apis = stubVoiceInputApis('win32', { ok: false, status, error: 'Permission required' });const result = await resolveVoiceInputStartGuards();-- expect(result).toMatchObject({- ok: false,- failed: 'permission',- permission: denial,- permissionSource: 'async',- });- expect(apis.getUserMedia).toHaveBeenCalledWith({ audio: true });- expect(apis.setRendererMicrophonePermissionVerified).toHaveBeenCalledWith(false);+ expect(result).toMatchObject({ ok: true, permissionSource: 'capture' });+ expect(apis.getUserMedia).not.toHaveBeenCalled();+ expect(apis.requestMicrophonePermission).not.toHaveBeenCalled();+ expect(apis.setRendererMicrophonePermissionVerified).not.toHaveBeenCalled();});it('keeps trusting a positive macOS cache on the start path', async () => {diff --git a/apps/desktop/src/renderer/voice-input/__tests__/useVoiceInput.dictionaryUndo.test.ts b/apps/desktop/src/renderer/voice-input/__tests__/useVoiceInput.dictionaryUndo.test.tsindex 5402f145be..5206416df1 100644--- a/apps/desktop/src/renderer/voice-input/__tests__/useVoiceInput.dictionaryUndo.test.ts+++ b/apps/desktop/src/renderer/voice-input/__tests__/useVoiceInput.dictionaryUndo.test.ts@@ -42,6 +42,7 @@ vi.mock('../eventScope', () => ({}));import { useVoiceInput } from '../useVoiceInput';+import { createVoiceInputDraftPlugin } from '@/components/new-chat/VoiceInputDraftDecoration';const baseline = '使用 Cloud Code。';const schema = new Schema({@@ -52,7 +53,7 @@ const schema = new Schema({},});-function mountDictation() {+function mountDictation(rawTranscriptText?: string) {let onEvent!: (event: VoiceInputRendererEvent) => void;vi.stubGlobal('electronAPI', {voiceInput: {@@ -63,10 +64,26 @@ function mountDictation() {cancel: vi.fn().mockResolvedValue({ ok: true }),},});- let state = EditorState.create({ doc: schema.node('doc', null, [schema.node('paragraph')]) });+ const draftPlugin = createVoiceInputDraftPlugin();+ let state = EditorState.create({+ doc: schema.node('doc', null, [schema.node('paragraph')]),+ plugins: [draftPlugin],+ });+ state = state.apply(+ state.tr.setMeta('voiceInputDraftDecoration', {+ text: baseline,+ source: 'stable',+ from: 1,+ to: 1,+ anchorLocked: true,+ caretState: 'processing',+ }),+ );const listeners = new Set<(payload: { transaction: Transaction }) => void>();+ const visibleTexts: string[] = [];const dispatch = (transaction: Transaction) => {state = state.apply(transaction);+ visibleTexts.push(state.doc.textContent + (draftPlugin.getState(state)?.text ?? ''));listeners.forEach((listener) => listener({ transaction }));};// Real ProseMirror documents, steps and mappings; only the editor view is stubbed.@@ -98,6 +115,7 @@ function mountDictation() {source: 'mic',status: 'submitted',text: baseline,+ basedOnText: rawTranscriptText,updatedAt: Date.now(),},}),@@ -105,6 +123,40 @@ function mountDictation() {expect(state.doc.textContent).toBe(baseline);return {+ visibleTexts,+ acceptRefinement() {+ state = state.apply(+ state.tr.setMeta('voiceInputDraftDecoration', {+ text: baseline,+ source: 'refinement',+ from: 1,+ to: baseline.length + 1,+ anchorLocked: true,+ caretState: 'processing',+ }),+ );+ act(() =>+ onEvent({+ type: 'refined',+ runId: 'run',+ text: baseline,+ segment: {+ id: 'segment',+ source: 'mic',+ status: 'refined',+ text: baseline,+ updatedAt: Date.now(),+ },+ range: {+ id: 'range',+ segmentIds: ['segment'],+ startOffset: 0,+ endOffset: baseline.length,+ userTouched: false,+ },+ }),+ );+ },unmount: hook.unmount,correct(replacement = 'Claude') {const transaction = state.tr.insertText(replacement, 4, 9);@@ -136,6 +188,23 @@ afterEach(() => {});describe('in-app dictionary learning after undo', () => {+ it('keeps pre-refined text visible on confirmation and retains the raw source for learning', () => {+ const raw = '呃使用 cloud code。';+ const dictation = mountDictation(raw);+ dictation.acceptRefinement();+ expect(dictation.visibleTexts.length).toBeGreaterThan(0);+ expect(dictation.visibleTexts.every((text) => text === baseline)).toBe(true);+ dictation.correct('Codex');+ act(() => vi.advanceTimersByTime(15_000));+ expect(mocks.advise).toHaveBeenCalledExactlyOnceWith(+ expect.objectContaining({+ beforeText: baseline,+ rawTranscriptText: raw,+ afterText: '使用 Codex Code。',+ }),+ );+ dictation.unmount();+ });describe.each(['unchanged', 'undone correction'] as const)('clearing %s dictation', (source) => {it.each(['clear', 'unmount', 'timeout'] as const)('does not learn unrelated new input on %s',diff --git a/apps/desktop/src/renderer/voice-input/__tests__/useVoiceInput.startup.test.ts b/apps/desktop/src/renderer/voice-input/__tests__/useVoiceInput.startup.test.tsnew file mode 100644index 0000000000..5575f6b5fa--- /dev/null+++ b/apps/desktop/src/renderer/voice-input/__tests__/useVoiceInput.startup.test.ts@@ -0,0 +1,494 @@+// @vitest-environment jsdom+import { act, cleanup, renderHook } from '@testing-library/react';+import type { Editor } from '@tiptap/core';+import { Schema } from '@tiptap/pm/model';+import { EditorState } from '@tiptap/pm/state';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import type { PcmChunk } from '../WebMicAudioEngine';+import type { VoiceInputRendererEvent } from '@cindy/voice-input-core';++const mocks = vi.hoisted(() => ({+ translate: (key: string) => key,+ settings: {+ language: 'auto',+ refinementEnabled: false,+ muteSystemAudio: true,+ fastActivationEnabled: false,+ },+ startEngine: vi.fn<() => Promise<void>>(),+ stopEngine: vi.fn(),+ drainEngine: vi.fn(),+ engines: [] as Array<{ emit: (chunk: PcmChunk) => void }>,+ promptExpired: vi.fn(),+}));+vi.mock('react-i18next', () => ({ useTranslation: () => ({ t: mocks.translate }) }));+vi.mock('@/lib/logger', () => ({+ createLogger: () => ({ debug: vi.fn(), info: vi.fn(), warn: vi.fn() }),+}));+vi.mock('@/lib/toast', () => ({ toast: { warning: vi.fn(), error: vi.fn() } }));+vi.mock('@/hooks/useCodexSessionExpiredPrompt', () => ({+ useCodexSessionExpiredPrompt: () => mocks.promptExpired,+ isCodexSessionExpiredError: () => false,+}));+vi.mock('@/hooks/useVoiceInputSettings', () => ({+ useVoiceInputSettings: () => ({ settings: mocks.settings }),+ adviseAndRecordVoiceInputDictionaryLearning: vi.fn(),+}));+vi.mock('@/hooks/useVoiceInputHistory', () => ({+ recordVoiceInputHistory: () => null,+ updateVoiceInputHistoryEntry: vi.fn(),+}));+vi.mock('@/hooks/useVoiceInputUsageStats', () => ({+ recordVoiceInputUsage: vi.fn(),+ recordVoiceInputRefinementUsage: vi.fn(),+}));+vi.mock('../workletUrl', () => ({ getVoiceInputWorkletUrl: () => '' }));+vi.mock('../audioContextPool', () => ({+ prewarmVoiceInputAudio: vi.fn().mockResolvedValue(undefined),+}));+vi.mock('../WebMicAudioEngine', () => ({+ WebMicAudioEngine: class {+ emit = (_chunk: PcmChunk) => {};+ constructor() {+ mocks.engines.push(this);+ }+ onPcm16k(callback: (chunk: PcmChunk) => void) {+ this.emit = callback;+ }+ start() {+ return mocks.startEngine();+ }+ async stop() {+ mocks.stopEngine();+ }+ async drainBufferedAudio() {+ mocks.drainEngine(this.emit);+ }+ },+ currentPowerReleaseGeneration: () => 0,+ isMicrophonePermissionDeniedError: (e: Error) => e.name === 'NotAllowedError',+ isPowerReleaseCancellation: () => false,+ isSelectedMicrophoneUnavailableError: () => false,+ isMicrophoneDeviceUnavailableError: () => false,+ powerReleaseCancellation: () => new Error('cancelled'),+ disposeKeepAliveVoiceInputMicrophone: vi.fn().mockResolvedValue(undefined),+ prewarmVoiceInputBenchmarkFixture: vi.fn().mockResolvedValue(undefined),+ prewarmVoiceInputMicrophoneWithAutomaticFallback: vi.fn().mockResolvedValue(undefined),+}));++import { useVoiceInput } from '../useVoiceInput';++function deferred<T>() {+ let resolve!: (value: T) => void;+ let reject!: (error: Error) => void;+ const promise = new Promise<T>((yes, no) => {+ resolve = yes;+ reject = no;+ });+ return { promise, resolve, reject };+}++function chunk(index: number, amplitude = 512): PcmChunk {+ return {+ pcm16k: Int16Array.from({ length: 640 }, (_, i) => (i % 2 ? amplitude : -amplitude)).buffer,+ trace: {+ capturedAt: index * 40,+ convertedAt: index * 40,+ chunkIndex: index,+ sampleRate: 16000,+ durationMs: 40,+ },+ };+}++function mount() {+ const connection = deferred<{ ok: true; runId: string }>();+ const mute = deferred<{ ok: true }>();+ const permissionRequired = vi.fn();+ const api = {+ onEvent: vi.fn((_listener: (event: VoiceInputRendererEvent) => void) => vi.fn()),+ start: vi.fn(() => connection.promise),+ stop: vi.fn().mockResolvedValue({ ok: true }),+ cancel: vi.fn().mockResolvedValue({ ok: true }),+ prewarm: vi.fn().mockResolvedValue(undefined),+ muteSystemAudio: vi.fn(() => mute.promise),+ restoreSystemAudio: vi.fn().mockResolvedValue({ ok: true }),+ appendAudio: vi.fn(),+ drainAudioQueue: vi.fn().mockResolvedValue({ ok: true }),+ setRendererMicrophonePermissionVerified: vi.fn().mockResolvedValue({ ok: true }),+ getMicrophonePermissionCached: vi.fn(() => ({ ok: false, status: 'unknown' })),+ getSystemPermissionsCached: vi.fn(() => ({ accessibility: { ok: true } })),+ getReadinessCached: vi.fn(() => ({ ok: true })),+ getReadiness: vi.fn().mockResolvedValue({ ok: true }),+ };+ vi.stubGlobal('electronAPI', { platform: 'darwin', voiceInput: api });+ const schema = new Schema({+ nodes: { doc: { content: 'paragraph+' }, paragraph: { content: 'text*' }, text: {} },+ });+ const state = EditorState.create({ doc: schema.node('doc', null, [schema.node('paragraph')]) });+ const editor = {+ state,+ view: { state },+ isDestroyed: false,+ isEditable: true,+ commands: { focus: vi.fn() },+ on: vi.fn(),+ off: vi.fn(),+ } as unknown as Editor;+ const hook = renderHook(() =>+ useVoiceInput(editor, false, undefined, { onMicrophonePermissionRequired: permissionRequired }),+ );+ return { ...hook, api, connection, mute, permissionRequired };+}++beforeEach(() => {+ vi.useFakeTimers();+ mocks.engines.length = 0;+ mocks.startEngine.mockReset().mockResolvedValue(undefined);+ mocks.stopEngine.mockReset();+ mocks.drainEngine.mockReset();+});+afterEach(() => {+ cleanup();+ vi.useRealTimers();+ vi.unstubAllGlobals();+});++describe('local voice capture independent of startup checks and cloud', () => {+ it('ends before the microphone produces its first frame and closes the late microphone', async () => {+ const h = mount();+ const device = deferred<void>();+ mocks.startEngine.mockReturnValue(device.promise);+ const endCue = vi.fn();+ let starting!: Promise<void>;+ await act(async () => {+ starting = h.result.current.start();+ });+ await act(async () => {+ h.mute.resolve({ ok: true });+ await h.result.current.stop({ onReadyForEndCue: endCue });+ });+ expect(h.result.current.state).toBe('done');+ expect(endCue).toHaveBeenCalledOnce();+ expect(h.api.stop).not.toHaveBeenCalled();+ await act(async () => {+ device.resolve();+ h.connection.resolve({ ok: true, runId: 'late-mic' });+ await starting;+ });+ expect(mocks.stopEngine).toHaveBeenCalledTimes(2);+ expect(h.result.current.state).toBe('done');+ });++ it('keeps cloud-recognized text even when local PCM is below the silence threshold', async () => {+ const h = mount();+ await act(async () => {+ h.mute.resolve({ ok: true });+ h.connection.resolve({ ok: true, runId: 'quiet-text' });+ await h.result.current.start();+ mocks.engines[0].emit(chunk(0, 1));+ });+ act(() =>+ h.api.onEvent.mock.calls.at(-1),+ );+ let stopping!: Promise<void>;+ await act(async () => {+ stopping = h.result.current.stop();+ });+ await act(async () => {+ await vi.advanceTimersByTimeAsync(1100);+ await stopping;+ });+ expect(h.api.stop).toHaveBeenCalledOnce();+ expect(h.api.cancel).not.toHaveBeenCalled();+ });++ it('finishes silent capture without waiting for a pending cloud connection, and cancels a late run', async () => {+ const h = mount();+ const endCue = vi.fn();+ let starting!: Promise<void>;+ await act(async () => {+ starting = h.result.current.start();+ });+ act(() => mocks.engines[0].emit(chunk(0, 0)));+ await act(async () => {+ h.mute.resolve({ ok: true });+ await h.result.current.stop({ onReadyForEndCue: endCue, waitForRefinement: true });+ });+ expect(h.result.current.state).toBe('done');+ expect(h.api.stop).not.toHaveBeenCalled();+ expect(h.api.appendAudio).not.toHaveBeenCalled();+ expect(h.api.restoreSystemAudio).toHaveBeenCalled();+ expect(endCue).toHaveBeenCalledOnce();+ await act(async () => {+ h.connection.resolve({ ok: true, runId: 'late-silent' });+ await starting;+ });+ expect(h.api.cancel).toHaveBeenCalledWith({ runId: 'late-silent' });+ expect(h.result.current.state).toBe('done');+ });++ it('skips ASR finalization for connected silence and resets detection for the next recording', async () => {+ const h = mount();+ await act(async () => {+ h.mute.resolve({ ok: true });+ h.connection.resolve({ ok: true, runId: 'run' });+ await h.result.current.start();+ mocks.engines[0].emit(chunk(0));+ await h.result.current.cancel();+ await h.result.current.start();+ mocks.engines[1].emit(chunk(0, 12));+ await h.result.current.stop();+ });+ expect(h.api.stop).not.toHaveBeenCalled();+ expect(h.api.cancel).toHaveBeenLastCalledWith({ runId: 'run' });+ expect(h.result.current.state).toBe('done');+ });++ it('preserves quiet sound present only in the final drained sub-chunk', async () => {+ const h = mount();+ await act(async () => {+ h.mute.resolve({ ok: true });+ h.connection.resolve({ ok: true, runId: 'tail' });+ await h.result.current.start();+ mocks.engines[0].emit(chunk(0, 0));+ });+ mocks.drainEngine.mockImplementationOnce((emit: (frame: PcmChunk) => void) =>+ emit(chunk(1, 40)),+ );+ let stopping!: Promise<void>;+ await act(async () => {+ stopping = h.result.current.stop();+ });+ await act(async () => {+ await vi.advanceTimersByTimeAsync(1100);+ await stopping;+ });+ expect(h.api.stop).toHaveBeenCalledOnce();+ expect(h.api.cancel).not.toHaveBeenCalled();+ expect(h.api.appendAudio).toHaveBeenLastCalledWith(chunk(1, 40));+ });++ it('retains all 8 seconds while both cloud and system mute are pending; signals ready only after PCM', async () => {+ const h = mount();+ const cue = vi.fn();+ let starting!: Promise<void>;+ await act(async () => {+ starting = h.result.current.start({ onStartFeedback: cue });+ });+ expect(mocks.startEngine).toHaveBeenCalledTimes(1);+ expect(cue).toHaveBeenCalledTimes(1);+ expect(h.result.current.isCaptureReady).toBe(false);+ const frames = Array.from({ length: 200 }, (_, i) => chunk(i));+ await act(async () => {+ for (const frame of frames) mocks.engines[0].emit(frame);+ });+ expect(cue).toHaveBeenCalledTimes(1);+ expect(h.result.current.isCaptureReady).toBe(true);+ expect(h.api.appendAudio).not.toHaveBeenCalled();+ await act(async () => {+ h.connection.resolve({ ok: true, runId: 'run' });+ await starting;+ });+ expect(h.api.appendAudio.mock.calls.map(([frame]) => frame)).toEqual(frames);+ act(() => mocks.engines[0].emit(chunk(200)));+ expect(h.api.appendAudio).toHaveBeenLastCalledWith(chunk(200));+ h.mute.resolve({ ok: true });+ });++ it('starts local capture before a slow preflight, and stops it if preflight declines', async () => {+ const h = mount();+ const preflight = deferred<boolean>();+ let starting!: Promise<void>;+ await act(async () => {+ starting = h.result.current.start({ beforeStart: () => preflight.promise });+ });+ expect(mocks.startEngine).toHaveBeenCalledTimes(1);+ expect(h.api.start).not.toHaveBeenCalled();+ await act(async () => {+ h.mute.resolve({ ok: true });+ preflight.resolve(false);+ await starting;+ });+ expect(mocks.stopEngine).toHaveBeenCalled();+ expect(h.result.current.isBusy).toBe(false);+ expect(h.api.start).not.toHaveBeenCalled();+ });++ it('plays feedback and mutes without waiting for a slow microphone', async () => {+ const h = mount();+ const device = deferred<void>();+ mocks.startEngine.mockReturnValue(device.promise);+ const cue = vi.fn(() => {+ expect(mocks.startEngine).toHaveBeenCalledTimes(1);+ });+ let starting!: Promise<void>;+ await act(async () => {+ starting = h.result.current.start({ onStartFeedback: cue });+ });+ expect(cue).toHaveBeenCalledTimes(1);+ expect(h.api.muteSystemAudio).toHaveBeenCalledTimes(1);+ expect(h.result.current.isCaptureReady).toBe(false);+ await act(async () => {+ device.resolve();+ h.mute.resolve({ ok: true });+ h.connection.resolve({ ok: true, runId: 'slow-microphone' });+ await starting;+ mocks.engines[0].emit(chunk(0));+ });+ expect(h.api.appendAudio).toHaveBeenCalledExactlyOnceWith(chunk(0));+ expect(cue).toHaveBeenCalledTimes(1);+ });++ it('retains PCM during the start cue and mutes only after playback finishes', async () => {+ const h = mount();+ const cue = deferred<void>();+ let starting!: Promise<void>;+ await act(async () => {+ starting = h.result.current.start({ onStartFeedback: () => cue.promise });+ });+ await act(async () => {+ mocks.engines[0].emit(chunk(0));+ });+ expect(h.api.muteSystemAudio).not.toHaveBeenCalled();+ await act(async () => {+ mocks.engines[0].emit(chunk(1));+ cue.resolve();+ });+ expect(h.api.muteSystemAudio).toHaveBeenCalledOnce();+ await act(async () => {+ h.connection.resolve({ ok: true, runId: 'run' });+ h.mute.resolve({ ok: true });+ await starting;+ });+ expect(h.api.appendAudio.mock.calls.map(([frame]) => frame)).toEqual([chunk(0), chunk(1)]);+ });++ it('closes a late microphone after cancellation and does not replay the start cue', async () => {+ const h = mount();+ const device = deferred<void>();+ mocks.startEngine.mockReturnValue(device.promise);+ const cue = vi.fn();+ let starting!: Promise<void>;+ await act(async () => {+ starting = h.result.current.start({ onStartFeedback: cue });+ });+ await act(async () => {+ h.mute.resolve({ ok: true });+ await h.result.current.cancel();+ });+ await act(async () => {+ device.resolve();+ h.connection.resolve({ ok: true, runId: 'cancelled-run' });+ await starting;+ mocks.engines[0].emit(chunk(0));+ });+ expect(mocks.stopEngine).toHaveBeenCalledTimes(2);+ expect(cue).toHaveBeenCalledTimes(1);+ expect(h.api.appendAudio).not.toHaveBeenCalled();+ expect(h.result.current.isBusy).toBe(false);+ expect(h.api.cancel).toHaveBeenCalledWith({ runId: 'cancelled-run' });+ });++ it('uses the capture permission failure for recovery without a second microphone open', async () => {+ const h = mount();+ mocks.startEngine.mockRejectedValue(new DOMException('Permission denied', 'NotAllowedError'));+ await act(async () => {+ h.mute.resolve({ ok: true });+ await h.result.current.start();+ });+ expect(mocks.startEngine).toHaveBeenCalledTimes(1);+ expect(h.permissionRequired).toHaveBeenCalled();+ expect(h.api.setRendererMicrophonePermissionVerified).toHaveBeenCalledWith(false);+ expect(h.result.current.isCaptureReady).toBe(false);+ h.connection.resolve({ ok: true, runId: 'failed-capture' });+ });++ it('preserves buffered opening audio when Stop is pressed before cloud connects', async () => {+ const h = mount();+ let starting!: Promise<void>;+ await act(async () => {+ starting = h.result.current.start();+ });+ const frames = Array.from({ length: 25 }, (_, i) => chunk(i));+ act(() => {+ for (const frame of frames) mocks.engines[0].emit(frame);+ });+ let stopping!: Promise<void>;+ await act(async () => {+ h.mute.resolve({ ok: true });+ stopping = h.result.current.stop();+ });+ expect(h.result.current.isCaptureReady).toBe(false);+ expect(h.api.stop).not.toHaveBeenCalled();+ await act(async () => {+ h.connection.resolve({ ok: true, runId: 'stopped-before-connect' });+ await starting;+ await vi.advanceTimersByTimeAsync(1100);+ await stopping;+ });+ expect(h.api.appendAudio.mock.calls.map(([frame]) => frame)).toEqual(frames);+ expect(h.api.stop).toHaveBeenCalledTimes(1);+ expect(h.api.appendAudio.mock.invocationCallOrder.at(-1)).toBeLessThan(+ h.api.stop.mock.invocationCallOrder[0],+ );+ expect(h.result.current.isBusy).toBe(false);+ });++ it('ignores the old connection after cancel and immediate restart', async () => {+ const h = mount();+ let oldStart!: Promise<void>;+ await act(async () => {+ oldStart = h.result.current.start();+ });+ await act(async () => {+ h.mute.resolve({ ok: true });+ await h.result.current.cancel();+ });+ const nextConnection = deferred<{ ok: true; runId: string }>();+ h.api.start.mockReturnValue(nextConnection.promise);+ let nextStart!: Promise<void>;+ await act(async () => {+ nextStart = h.result.current.start();+ });+ const stopCount = mocks.stopEngine.mock.calls.length;+ await act(async () => {+ h.connection.resolve({ ok: true, runId: 'old' });+ await oldStart;+ mocks.engines[1].emit(chunk(0));+ });+ expect(mocks.stopEngine).toHaveBeenCalledTimes(stopCount);+ expect(h.result.current.isCaptureReady).toBe(true);+ await act(async () => {+ nextConnection.resolve({ ok: true, runId: 'new' });+ await nextStart;+ });+ expect(h.api.appendAudio).toHaveBeenCalledExactlyOnceWith(chunk(0));+ });++ it('cleans up local capture when readiness IPC rejects', async () => {+ const h = mount();+ h.api.getReadinessCached.mockReturnValue({ ok: false });+ h.api.getReadiness.mockRejectedValue(new Error('IPC unavailable'));+ await act(async () => {+ h.mute.resolve({ ok: true });+ await h.result.current.start();+ });+ expect(mocks.stopEngine).toHaveBeenCalled();+ expect(h.result.current.isCaptureReady).toBe(false);+ expect(h.result.current.isBusy).toBe(false);+ expect(h.api.start).not.toHaveBeenCalled();+ });+});diff --git a/apps/desktop/src/renderer/voice-input/__tests__/useVoiceProcessingIndicator.test.ts b/apps/desktop/src/renderer/voice-input/__tests__/useVoiceProcessingIndicator.test.tsnew file mode 100644index 0000000000..f8aa59e95b--- /dev/null+++ b/apps/desktop/src/renderer/voice-input/__tests__/useVoiceProcessingIndicator.test.ts@@ -0,0 +1,54 @@+// @vitest-environment jsdom+import { act, cleanup, renderHook } from '@testing-library/react';+import { afterEach, beforeEach, expect, it, vi } from 'vitest';+import type { VoiceInputState } from '@cindy/voice-input-core';+import { useVoiceProcessingIndicator } from '../useVoiceProcessingIndicator';++beforeEach(() => vi.useFakeTimers());+afterEach(() => {+ cleanup();+ vi.useRealTimers();+});++it('never shows processing when stop completes within 150 ms', () => {+ const h = renderHook(+ ({ state }: { state: VoiceInputState }) => useVoiceProcessingIndicator(state),+ { initialProps: { state: 'listening' as VoiceInputState } },+ );+ h.rerender({ state: 'submitting' });+ act(() => vi.advanceTimersByTime(100));+ expect(h.result.current).toBe(false);+ h.rerender({ state: 'done' });+ act(() => vi.advanceTimersByTime(200));+ expect(h.result.current).toBe(false);+});++it('counts submitting and refining as one continuous wait', () => {+ const h = renderHook(+ ({ state }: { state: VoiceInputState }) => useVoiceProcessingIndicator(state),+ { initialProps: { state: 'submitting' as VoiceInputState } },+ );+ act(() => vi.advanceTimersByTime(100));+ h.rerender({ state: 'refining' });+ act(() => vi.advanceTimersByTime(49));+ expect(h.result.current).toBe(false);+ act(() => vi.advanceTimersByTime(1));+ expect(h.result.current).toBe(true);+ h.rerender({ state: 'done' });+ expect(h.result.current).toBe(false);+});++it('clears the timer on cancellation and starts fresh for another recording', () => {+ const h = renderHook(+ ({ state }: { state: VoiceInputState }) => useVoiceProcessingIndicator(state),+ { initialProps: { state: 'submitting' as VoiceInputState } },+ );+ act(() => vi.advanceTimersByTime(150));+ expect(h.result.current).toBe(true);+ h.rerender({ state: 'error' });+ h.rerender({ state: 'listening' });+ h.rerender({ state: 'submitting' });+ expect(h.result.current).toBe(false);+ h.unmount();+ expect(vi.getTimerCount()).toBe(0);+});diff --git a/apps/desktop/src/renderer/voice-input/captureSession.ts b/apps/desktop/src/renderer/voice-input/captureSession.tsindex 34f8dbcdda..25bce98b5f 100644--- a/apps/desktop/src/renderer/voice-input/captureSession.ts+++ b/apps/desktop/src/renderer/voice-input/captureSession.ts@@ -9,6 +9,8 @@ import {type PcmChunk,} from './WebMicAudioEngine';import { createVoiceInputAudioProfile } from './audioProfile';+import { hasPcmSound } from './pcmActivity';+import type { VoiceInputStartupTimeline } from './startupTimeline';const log = createLogger('voice-input-capture');@@ -27,7 +29,7 @@ export type VoiceInputCaptureSessionStartResult =ok: false;error: string;/**- * Startup was cancelled rather than broken — currently only by a power+ * Startup was cancelled rather than broken — by its owner or a power* release (suspend / lock) landing mid-start. Callers should clean up* silently instead of surfacing `error`, which is an internal message.*/@@ -49,7 +51,11 @@ type VoiceInputCaptureSessionOptions = {getRunId: () => string | null;setEngine: (engine: WebMicAudioEngine | null) => void;isCurrentEngine?: (engine: WebMicAudioEngine) => boolean;- canAcceptAudioChunk?: () => boolean;+ /** Fires once after the first PCM frame has been retained locally. */+ onCaptureReady?: () => void;+ /** Fires once when captured PCM contains sound, even before cloud startup. */+ onSoundDetected?: () => void;+ timeline?: VoiceInputStartupTimeline;appendAudioChunk: (chunk: PcmChunk) => void;onInterrupted: (message: string) => void;onStateChange: (event: string, details?: Record<string, unknown>) => void;@@ -69,6 +75,8 @@ export async function startVoiceInputCaptureSession(const pendingChunks: PcmChunk[] = [];let pendingOverflowWarnedAt = 0;let firstChunkLogged = false;+ let captureReady = false;+ let soundDetected = false;let engine: WebMicAudioEngine;const createEngine = (deviceId?: string): WebMicAudioEngine => {@@ -81,11 +89,15 @@ export async function startVoiceInputCaptureSession(});next.onPcm16k((chunk) => {if (options.isCurrentEngine && !options.isCurrentEngine(next)) return;+ if (chunk.pcm16k.byteLength === 0) return;+ if (!soundDetected && hasPcmSound(chunk.pcm16k)) {+ soundDetected = true;+ options.onSoundDetected?.();+ }if (!firstChunkLogged) {firstChunkLogged = true;- log.debug(message(options.label, 'first pcm16k chunk'), chunk.trace);+ options.timeline?.mark('first_pcm');}- if (options.canAcceptAudioChunk && !options.canAcceptAudioChunk()) return;if (!options.getRunId()) {if (pendingChunks.length >= MAX_PENDING_AUDIO_CHUNKS) {const now = Date.now();@@ -103,9 +115,16 @@ export async function startVoiceInputCaptureSession(pendingChunks.shift();}pendingChunks.push(chunk);- return;+ options.timeline?.mark('first_buffered_audio');+ } else {+ options.appendAudioChunk(chunk);+ }+ // System mute and cloud setup must never discard the user's opening+ // words. Readiness means PCM is retained, not merely engine.start() done.+ if (!captureReady) {+ captureReady = true;+ options.onCaptureReady?.();}- options.appendAudioChunk(chunk);});return next;};@@ -119,6 +138,7 @@ export async function startVoiceInputCaptureSession(await engine.start();return;} catch (error) {+ if (options.isCurrentEngine && !options.isCurrentEngine(engine)) throw error;if (!options.deviceId || !isSelectedMicrophoneUnavailableError(error)) {throw error;}@@ -138,6 +158,7 @@ export async function startVoiceInputCaptureSession(if (currentPowerReleaseGeneration() !== powerGenerationAtStart) {throw powerReleaseCancellation();}+ if (options.isCurrentEngine && !options.isCurrentEngine(engine)) throw error;engine = createEngine(undefined);options.setEngine(engine);await engine.start();@@ -145,11 +166,24 @@ export async function startVoiceInputCaptureSession(};try {+ options.timeline?.mark('microphone_requested');log.debug(message(options.label, 'microphone start requested'), { elapsedMs: options.elapsedMs?.() });await startEngineWithAutomaticFallback();+ // A cancellation can finish while getUserMedia is still pending. Never+ // leave the late device open or clear a newer attempt's engine reference.+ if (options.isCurrentEngine && !options.isCurrentEngine(engine)) {+ await engine.stop();+ return { ok: false, cancelled: true, error: 'Voice input start was cancelled.' };+ }+ options.timeline?.mark('engine_ready');+ void window.electronAPI.voiceInput.setRendererMicrophonePermissionVerified(true).catch(() => undefined);log.info(message(options.label, 'microphone started'), { elapsedMs: options.elapsedMs?.() });} catch (error) {- options.setEngine(null);+ if (options.isCurrentEngine && !options.isCurrentEngine(engine)) {+ await engine.stop().catch(() => undefined);+ return { ok: false, cancelled: true, error: options.formatStartError(error) };+ }+ if (!options.isCurrentEngine || options.isCurrentEngine(engine)) options.setEngine(null);// Suspend/lock cancelling startup is the user walking away on purpose, not// a failure worth an error surface. Report it as cancellation so callers// clean up quietly instead of showing an internal message.@@ -161,11 +195,8 @@ export async function startVoiceInputCaptureSession(error: options.formatStartError(error),};}- // The start guard trusts a positive permission cache so it does not open a- // throwaway microphone stream before every recording. If the real capture- // discovers that permission was revoked, invalidate that cache so the next- // start returns to the permission gate, and tell the caller so the current- // attempt surfaces the permission recovery UI rather than a raw error.+ // The real capture requests permission once and detects revocation. Keep+ // the cached UI snapshot in sync and show the existing recovery surface.if (isMicrophonePermissionDeniedError(error)) {log.warn(message(options.label, 'microphone permission denied during capture start'));void window.electronAPI.voiceInputdiff --git a/apps/desktop/src/renderer/voice-input/pcm16k-worklet.js b/apps/desktop/src/renderer/voice-input/pcm16k-worklet.jsindex d2e8882622..0731cee81e 100644--- a/apps/desktop/src/renderer/voice-input/pcm16k-worklet.js+++ b/apps/desktop/src/renderer/voice-input/pcm16k-worklet.js@@ -10,6 +10,7 @@ class PCM16kWorklet extends AudioWorkletProcessor {this.carry = 0;this.previousSample = 0;this.chunkIndex = 0;+ this.firstFramePending = true;this.active = true;this.disposed = false;@@ -45,6 +46,7 @@ class PCM16kWorklet extends AudioWorkletProcessor {this.pending = [];this.carry = 0;this.previousSample = 0;+ this.firstFramePending = true;}this.active = event.data.active;};@@ -65,8 +67,14 @@ class PCM16kWorklet extends AudioWorkletProcessor {this.pending.push(sample);}- while (this.pending.length >= this.chunkSamples) {- const frame = this.pending.splice(0, this.chunkSamples);+ // Deliver the first 10 ms promptly, then return to normal-sized packets.+ // This changes packet boundaries only, never the retained samples.+ while (true) {+ const count = this.firstFramePending+ ? Math.min(this.chunkSamples, Math.max(1, Math.round(this.targetSampleRate * 0.01)))+ : this.chunkSamples;+ if (this.pending.length < count) break;+ const frame = this.pending.splice(0, count);this.postFrameFromSamples(frame, capturedAt);}@@ -90,6 +98,7 @@ class PCM16kWorklet extends AudioWorkletProcessor {},});this.chunkIndex += 1;+ this.firstFramePending = false;}postFrame(frame) {@@ -105,7 +114,9 @@ class PCM16kWorklet extends AudioWorkletProcessor {resample(input, fromRate, toRate) {if (input.length === 0) return [];- if (fromRate === toRate) return Array.from(input);+ // The caller immediately copies sample values into pending; it does not+ // retain or mutate the browser's input buffer. No intermediate array needed.+ if (fromRate === toRate) return input;const ratio = fromRate / toRate;const output = [];diff --git a/apps/desktop/src/renderer/voice-input/pcmActivity.ts b/apps/desktop/src/renderer/voice-input/pcmActivity.tsnew file mode 100644index 0000000000..9ed1e32ba8--- /dev/null+++ b/apps/desktop/src/renderer/voice-input/pcmActivity.ts@@ -0,0 +1,13 @@+// This is a conservative silence check, not speech recognition. Keep any+// plausible sound (including background noise) rather than discard quiet words.+// PCM16 RMS 32 is about -60 dBFS; a short peak also keeps a very brief sound.+export function hasPcmSound(pcm: ArrayBuffer): boolean {+ if (pcm.byteLength % 2 !== 0) return true; // Unknown data must not be discarded.+ const samples = new Int16Array(pcm);+ let energy = 0;+ for (const sample of samples) {+ if (Math.abs(sample) >= 128) return true;+ energy += sample * sample;+ }+ return samples.length > 0 && energy >= samples.length * 32 * 32;+}diff --git a/apps/desktop/src/renderer/voice-input/refinementPreviewText.ts b/apps/desktop/src/renderer/voice-input/refinementPreviewText.tsindex 33fd3d2cf3..ef71e612ff 100644--- a/apps/desktop/src/renderer/voice-input/refinementPreviewText.ts+++ b/apps/desktop/src/renderer/voice-input/refinementPreviewText.ts@@ -1,14 +1,11 @@/*** Keep submitted ASR text visible while streaming refinement arrives.*- * The refiner streams a current refined prefix, not a diff against the ASR- * text. Until the final refined text is ready, preserve the raw suffix by- * length so in-app input and the global overlay share the same gradual- * replacement behavior instead of clearing the whole transcript and typing the- * refined text from scratch.+ * A refined prefix has no positional correspondence with the original text:+ * removing filler words shifts every subsequent character. Keep the current+ * text until the validated final result arrives instead of manufacturing a+ * hybrid by appending an arbitrary original suffix.*/export function buildRefinementPreviewText(baseText: string, previewText: string): string {- if (!previewText) return baseText;- if (!baseText || previewText.length >= baseText.length) return previewText;- return `${previewText}${baseText.slice(previewText.length)}`;+ return baseText || previewText;}diff --git a/apps/desktop/src/renderer/voice-input/startCue.ts b/apps/desktop/src/renderer/voice-input/startCue.tsindex 3a09d4103d..75f2715c01 100644--- a/apps/desktop/src/renderer/voice-input/startCue.ts+++ b/apps/desktop/src/renderer/voice-input/startCue.ts@@ -6,6 +6,8 @@ type VoiceInputCue = {rampAt: number;duration: number;volume: number;+ bodyVolume: number;+ decayAt: number;delay?: number;attack?: number;};@@ -25,69 +27,83 @@ export function prepareVoiceInputCues(): void {}}-function playVoiceInputCue(cue: VoiceInputCue): void {- try {- const context = getAudioContext();- const startedAt = context.currentTime + 0.005 + (cue.delay ?? 0);- const endedAt = startedAt + cue.duration;- const oscillator = context.createOscillator();- const gain = context.createGain();-- oscillator.type = 'sine';- oscillator.frequency.setValueAtTime(cue.fromFrequency, startedAt);- oscillator.frequency.exponentialRampToValueAtTime(cue.toFrequency, startedAt + cue.rampAt);-- gain.gain.setValueAtTime(0.0001, startedAt);- gain.gain.exponentialRampToValueAtTime(cue.volume, startedAt + (cue.attack ?? 0.01));- gain.gain.exponentialRampToValueAtTime(0.0001, endedAt);-- oscillator.connect(gain);- gain.connect(context.destination);- oscillator.onended = () => {- oscillator.disconnect();- gain.disconnect();+function playVoiceInputCue(cue: VoiceInputCue): Promise<void> {+ return new Promise((resolve) => {+ let oscillator: OscillatorNode | undefined;+ let gain: GainNode | undefined;+ let settled = false;+ const finish = () => {+ if (settled) return;+ settled = true;+ clearTimeout(timer);+ if (oscillator) {+ oscillator.onended = null;+ try {+ oscillator.stop();+ } catch {+ /* Already ended or never started. */+ }+ oscillator.disconnect();+ }+ gain?.disconnect();+ resolve();};- oscillator.start(startedAt);- oscillator.stop(endedAt);-- if (context.state === 'suspended') {- void context.resume().catch(() => {});+ // A suspended audio context must not delay system mute indefinitely or+ // play a stale start cue when it eventually resumes.+ const timer = setTimeout(finish, Math.ceil(((cue.delay ?? 0) + cue.duration) * 1000) + 200);+ try {+ const context = getAudioContext();+ const startedAt = context.currentTime + 0.005 + (cue.delay ?? 0);+ const endedAt = startedAt + cue.duration;+ oscillator = context.createOscillator();+ gain = context.createGain();+ oscillator.type = 'sine';+ oscillator.frequency.setValueAtTime(cue.fromFrequency, startedAt);+ oscillator.frequency.exponentialRampToValueAtTime(cue.toFrequency, startedAt + cue.rampAt);+ gain.gain.setValueAtTime(0.0001, startedAt);+ gain.gain.exponentialRampToValueAtTime(cue.volume, startedAt + (cue.attack ?? 0.01));+ // Keep a round, audible body after the soft attack, then a short bell-like+ // decay. One sine oscillator avoids harsh upper harmonics and extra nodes.+ gain.gain.exponentialRampToValueAtTime(cue.bodyVolume, startedAt + cue.decayAt);+ gain.gain.exponentialRampToValueAtTime(0.0001, endedAt);+ oscillator.connect(gain);+ gain.connect(context.destination);+ oscillator.onended = finish;+ oscillator.start(startedAt);+ oscillator.stop(endedAt);+ if (context.state === 'suspended') void context.resume().catch(finish);+ } catch {+ // Feedback is optional. Never block capture or mute on a playback error.+ finish();}- } catch {- // Ignore playback failures. The microphone startup path must stay non-blocking.- }+ });}-export function playVoiceInputStartCue(): void {- playVoiceInputCue({- fromFrequency: 720,- toFrequency: 920,- rampAt: 0.045,- duration: 0.11,- volume: 0.095,- attack: 0.006,- });+// Both cues use the same note, envelope and pitch gesture. The end cue repeats+// the start note, then answers a minor third lower.+const interactionNote: VoiceInputCue = {+ fromFrequency: 880,+ toFrequency: 987.77,+ rampAt: 0.032,+ duration: 0.11,+ volume: 0.18,+ bodyVolume: 0.065,+ decayAt: 0.04,+ attack: 0.008,+};++export function playVoiceInputStartCue(): Promise<void> {+ return playVoiceInputCue(interactionNote);}export function playVoiceInputEndCue(): void {- // End feedback keeps the same simple sine-glide timbre as the start cue. The- // only distinction is the two-note low-to-high rhythm, which marks "stop"- // without introducing a separate alert-like sound.- playVoiceInputCue({- fromFrequency: 520,- toFrequency: 660,- rampAt: 0.045,- duration: 0.11,- volume: 0.095,- attack: 0.006,- });- playVoiceInputCue({- fromFrequency: 720,- toFrequency: 920,- rampAt: 0.045,- duration: 0.11,- volume: 0.095,- delay: 0.16,- attack: 0.006,+ // Schedule both immediately; playback never gates recognition or capture.+ void playVoiceInputCue(interactionNote);+ const lowerPitchRatio = 2 ** (-3 / 12);+ void playVoiceInputCue({+ ...interactionNote,+ fromFrequency: interactionNote.fromFrequency * lowerPitchRatio,+ toFrequency: interactionNote.toFrequency * lowerPitchRatio,+ delay: 0.14,});}diff --git a/apps/desktop/src/renderer/voice-input/startGuards.ts b/apps/desktop/src/renderer/voice-input/startGuards.tsindex a2c91fe2cf..4ae102721b 100644--- a/apps/desktop/src/renderer/voice-input/startGuards.ts+++ b/apps/desktop/src/renderer/voice-input/startGuards.ts@@ -14,7 +14,7 @@ export type VoiceInputStartGuardsResult =permission: Extract<VoiceInputPermissionResult, { ok: true }>;accessibility: Extract<VoiceInputPermissionResult, { ok: true }>;readiness: VoiceInputReadinessResult;- permissionSource: 'cache' | 'async';+ permissionSource: 'cache' | 'capture';accessibilitySource: 'cache';readinessSource: 'cache' | 'async';}@@ -24,7 +24,7 @@ export type VoiceInputStartGuardsResult =permission: VoiceInputPermissionResult;accessibility: VoiceInputPermissionResult;readiness: VoiceInputReadinessResult;- permissionSource: 'cache' | 'async';+ permissionSource: 'cache' | 'capture';accessibilitySource: 'cache';readinessSource: 'cache' | 'async';};@@ -72,13 +72,12 @@ export async function requestRendererMicrophonePermission(): Promise<VoiceInputP}/**- * Resolve the two gates that must pass before voice input is allowed.+ * Check service/accessibility readiness alongside local capture.*- * The synchronous cache is only trusted for positive results. Negative or- * missing cache values take the existing async path so a just-finished Codex- * login or a freshly granted microphone permission is not hidden by stale- * state. Main still verifies readiness in `voice-input:start`; this helper only- * removes avoidable IPC latency from the renderer-to-microphone critical path.+ * The capture engine's getUserMedia is the microphone permission request and+ * authoritative check, including first use and revocation. Never open a probe+ * stream here: closing it then reopening capture costs a second device startup+ * and loses anything spoken into the probe. Main still verifies service auth.*/export async function resolveVoiceInputStartGuards(options: VoiceInputStartGuardsOptions = {},@@ -89,25 +88,18 @@ export async function resolveVoiceInputStartGuards(? cachedSystemPermissions.accessibility: ({ ok: true, status: 'not-required' } as const);const cachedReadiness = window.electronAPI.voiceInput.getReadinessCached();- // A positive OS permission snapshot is sufficient for the start guard. The- // real capture engine calls getUserMedia immediately after this gate and is- // the authoritative revocation check; opening a second, short-lived stream- // here made every Windows recording pay the microphone cold-start cost twice.- // Keep the async path for missing/negative/unknown snapshots so newly granted- // permission still takes effect without restarting the app.- const shouldVerifyPermission = !cachedPermission.ok- || cachedPermission.status !== 'granted';- const permissionSource = shouldVerifyPermission ? 'async' : 'cache';+ const permissionSource = cachedPermission.ok && cachedPermission.status === 'granted'+ ? 'cache' : 'capture';const readinessSource = cachedReadiness?.ok ? 'cache' : 'async';- const permissionPromise: Promise<VoiceInputPermissionResult> = shouldVerifyPermission- ? requestRendererMicrophonePermission()- : Promise.resolve(cachedPermission);+ const permission: VoiceInputPermissionResult = permissionSource === 'cache'+ ? cachedPermission+ : { ok: true, status: 'checked-by-capture' };const readinessPromise: Promise<VoiceInputReadinessResult> = cachedReadiness?.ok? Promise.resolve(cachedReadiness): window.electronAPI.voiceInput.getReadiness();- const [permission, readiness] = await Promise.all([permissionPromise, readinessPromise]);+ const readiness = await readinessPromise;if (!permission.ok) {return {ok: false,diff --git a/apps/desktop/src/renderer/voice-input/startupTimeline.ts b/apps/desktop/src/renderer/voice-input/startupTimeline.tsnew file mode 100644index 0000000000..745c2e59a6--- /dev/null+++ b/apps/desktop/src/renderer/voice-input/startupTimeline.ts@@ -0,0 +1,33 @@+import { createLogger } from '@/lib/logger';++const log = createLogger('voice-input-startup');++type StartupStage =+ | 'requested'+ | 'checks_finished'+ | 'microphone_requested'+ | 'engine_ready'+ | 'first_pcm'+ | 'first_buffered_audio'+ | 'connection_ready'+ | 'first_transcript'+ | 'mute_finished';++/** One attempt's local clock, starting at the UI action; never records audio or text. */+export function createVoiceInputStartupTimeline(+ source: 'inline' | 'overlay',+ startedAt = performance.now(),+) {+ const seen = new Set<StartupStage>();+ const attempt = `${source}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;+ const elapsedMs = () => Math.round(performance.now() - startedAt);+ const mark = (stage: StartupStage) => {+ if (seen.has(stage)) return;+ seen.add(stage);+ log.info('startup stage', { attempt, source, stage, elapsedMs: elapsedMs() });+ };+ mark('requested');+ return { mark, elapsedMs };+}++export type VoiceInputStartupTimeline = ReturnType<typeof createVoiceInputStartupTimeline>;diff --git a/apps/desktop/src/renderer/voice-input/useVoiceInput.ts b/apps/desktop/src/renderer/voice-input/useVoiceInput.tsindex 2f8034957d..e3d8265c75 100644--- a/apps/desktop/src/renderer/voice-input/useVoiceInput.ts+++ b/apps/desktop/src/renderer/voice-input/useVoiceInput.ts@@ -54,8 +54,10 @@ import {resolveBrowserVoiceInputLanguage,} from './refinementContextBuilder';import { resolveVoiceInputStartGuards } from './startGuards';+import { createVoiceInputStartupTimeline, type VoiceInputStartupTimeline } from './startupTimeline';import { getVoiceInputWorkletUrl } from './workletUrl';import { buildRefinementPreviewText } from './refinementPreviewText';+import { clearVoiceInputDraftInTransaction } from '@/components/new-chat/VoiceInputDraftDecoration';import { isVoiceInputEventScopeActive, shouldHandleVoiceInputEvent } from './eventScope';import {clampEditorTextRangeToDoc,@@ -90,6 +92,7 @@ type SubmittedTextRange = {start: number;end: number;submittedText: string;+ rawTranscriptText?: string;historyEntryId: string | null;};@@ -136,14 +139,21 @@ export type UseVoiceInputResult = {draftRange: EditorTextRange | null;lastError: string | null;isListening: boolean;+ isCaptureReady: boolean;isBusy: boolean;getLastSubmittedText: () => string;getLastRefinement: () => VoiceInputRefinementSnapshot | null;- start: () => Promise<void>;+ start: (options?: VoiceInputStartOptions) => Promise<void>;stop: (options?: VoiceInputStopOptions) => Promise<void>;cancel: () => Promise<void>;};+export type VoiceInputStartOptions = {+ startedAt?: number;+ beforeStart?: () => boolean | Promise<boolean>;+ onStartFeedback?: () => void | Promise<void>;+};+export type VoiceInputStopOptions = {onReadyForEndCue?: () => void;waitForRefinement?: boolean;@@ -181,6 +191,8 @@ export function useVoiceInput(options?: UseVoiceInputOptions,): UseVoiceInputResult {const [state, setState] = useState<VoiceInputState>('idle');+ const [captureReady, setCaptureReady] = useState(false);+ const startupTimelineRef = useRef<VoiceInputStartupTimeline | null>(null);const [draftText, setDraftText] = useState('');const [draftSource, setDraftSource] = useState<VoiceInputDraftSource | null>(null);const [lastError, setLastError] = useState<string | null>(null);@@ -196,10 +208,9 @@ export function useVoiceInput(// in-flight promise lets restoreSystemAudioForRecording await it before// checking the muted ref, preventing leaked mute state.const pendingSystemAudioMutePromiseRef = useRef<Promise<void> | null>(null);- const systemAudioMuteGateOpenRef = useRef(true);- const systemAudioMuteGateDropLoggedRef = useRef(false);const stopCompletionWaitersRef = useRef<StopCompletionWaiter[]>([]);const sentAudioMsRef = useRef(0);+ const hasRecordingContentRef = useRef(false);const terminalOutcomeRef = useRef<VoiceInputUsageOutcome>('success');const startAttemptIdRef = useRef(0);const startReadyRef = useRef<StartReadyState | null>(null);@@ -234,6 +245,7 @@ export function useVoiceInput(const setVoiceState = useCallback((next: VoiceInputState) => {stateRef.current = next;+ if (next !== 'listening') setCaptureReady(false);if (next === 'error') terminalOutcomeRef.current = 'failed';setState(next);}, []);@@ -245,6 +257,8 @@ export function useVoiceInput(const invalidateStartAttempt = useCallback(() => {startAttemptIdRef.current += 1;+ startReadyRef.current?.resolve({ ok: false, error: 'Voice input start was cancelled.' });+ startReadyRef.current = null;}, []);const createStartReadyState = useCallback((attemptId: number) => {@@ -426,14 +440,6 @@ export function useVoiceInput(window.electronAPI.voiceInput.appendAudio(chunk);}, []);- const canAcceptAudioChunk = useCallback(() => {- if (systemAudioMuteGateOpenRef.current) return true;- if (!systemAudioMuteGateDropLoggedRef.current) {- systemAudioMuteGateDropLoggedRef.current = true;- log.debug('dropping voice input pcm until system audio mute completes');- }- return false;- }, []);const commitUsageStats = useCallback(() => {const audioMs = sentAudioMsRef.current;@@ -441,20 +447,18 @@ export function useVoiceInput(recordVoiceInputUsage(audioMs, terminalOutcomeRef.current);}, []);- const muteSystemAudioForRecording = useCallback((): Promise<void> => {+ const muteSystemAudioForRecording = useCallback((feedback: Promise<void>): Promise<void> => {if (!supportsSystemAudioMute()) {- systemAudioMuteGateOpenRef.current = true;return Promise.resolve();}if (systemAudioMutedRef.current) {- systemAudioMuteGateOpenRef.current = true;return pendingSystemAudioMutePromiseRef.current ?? Promise.resolve();}if (pendingSystemAudioMutePromiseRef.current) {return pendingSystemAudioMutePromiseRef.current;}- const mutePromise = window.electronAPI.voiceInput- .muteSystemAudio()+ const mutePromise = feedback.catch(() => undefined)+ .then(() => window.electronAPI.voiceInput.muteSystemAudio()).then((result) => {if (result.ok) {systemAudioMutedRef.current = true;@@ -466,7 +470,6 @@ export function useVoiceInput(log.warn('system audio mute failed:', error instanceof Error ? error.message : String(error));}).finally(() => {- systemAudioMuteGateOpenRef.current = true;if (pendingSystemAudioMutePromiseRef.current === mutePromise) {pendingSystemAudioMutePromiseRef.current = null;}@@ -476,7 +479,6 @@ export function useVoiceInput(}, []);const restoreSystemAudioForRecording = useCallback(async () => {- systemAudioMuteGateOpenRef.current = true;if (!supportsSystemAudioMute()) return;// Await any in-flight mute so we never skip a restore for a mute that// hadn't yet flipped systemAudioMutedRef when restore began.@@ -847,7 +849,7 @@ export function useVoiceInput(// fit 进段落,字形实际落在边界之后。用旧 from 记录会让润色回填、润色预览与// 词典学习 watch 整体错位(润色会因读到截断文本而被丢弃)。const inserted = resolveInsertedTextRange(transaction, range.from, text.length);- dispatch(transaction);+ dispatch(clearVoiceInputDraftInTransaction(transaction));return inserted;} finally {applyingVoiceTextRef.current = false;@@ -899,7 +901,7 @@ export function useVoiceInput(// This guard is for stale async refinement results after cancellation,// route/session changes, draft restore, or other programmatic editor updates.const currentText = state.doc.textBetween(range.start, range.end, '');- const basedOnText = event.segment.basedOnText ?? range.submittedText;+ const basedOnText = event.segment.basedOnText ?? range.rawTranscriptText ?? range.submittedText;if (currentText !== range.submittedText && currentText !== basedOnText) {log.debug('refinement skipped: submitted range changed', {segmentId,@@ -912,7 +914,7 @@ export function useVoiceInput(applyingVoiceTextRef.current = true;try {- dispatch(state.tr.insertText(event.text, range.start, range.end));+ dispatch(clearVoiceInputDraftInTransaction(state.tr.insertText(event.text, range.start, range.end)));} finally {applyingVoiceTextRef.current = false;}@@ -968,6 +970,8 @@ export function useVoiceInput(}break;case 'draft':+ if (event.text.trim()) hasRecordingContentRef.current = true;+ if (event.text.trim()) startupTimelineRef.current?.mark('first_transcript');draftDisplayRangeRef.current = insertionRangeRef.current;setDraftText(event.text);setDraftSource(event.source);@@ -980,6 +984,8 @@ export function useVoiceInput(});break;case 'submitted':+ if (event.text.trim()) hasRecordingContentRef.current = true;+ if (event.text.trim()) startupTimelineRef.current?.mark('first_transcript');{lastSubmittedTextRef.current = event.text;const range = insertSubmittedText(event.text);@@ -991,11 +997,12 @@ export function useVoiceInput(start: range.start,end: range.end,submittedText: event.text,+ rawTranscriptText: event.segment.basedOnText ?? event.text,historyEntryId,});upsertDictionaryLearningWatch({segmentId: event.segment.id,- rawTranscriptText: event.text,+ rawTranscriptText: event.segment.basedOnText ?? event.text,baselineText: event.text,start: range.start,end: range.end,@@ -1046,7 +1053,7 @@ export function useVoiceInput(const segmentId = event.range.segmentIds[0];const range = segmentId ? submittedRangesRef.current.get(segmentId) : undefined;lastRefinementRef.current = {- basedOnText: event.segment.basedOnText ?? range?.submittedText ?? '',+ basedOnText: event.segment.basedOnText ?? range?.rawTranscriptText ?? range?.submittedText ?? '',refinedText: event.text,};}@@ -1225,7 +1232,7 @@ export function useVoiceInput(voiceInputSettings.microphoneDeviceId,]);- const start = useCallback(async () => {+ const start = useCallback(async (startOptions?: VoiceInputStartOptions) => {const currentState = stateRef.current;if (disabled ||@@ -1237,6 +1244,9 @@ export function useVoiceInput() {return;}+ const timeline = createVoiceInputStartupTimeline('inline', startOptions?.startedAt);+ startupTimelineRef.current = timeline;+ setCaptureReady(false);dismissInlineError();shouldRestoreEditorFocusRef.current = true;insertionRangeRef.current = readEditorSelectionRange();@@ -1252,33 +1262,92 @@ export function useVoiceInput(submittedRangesRef.current.clear();lastRefinementRef.current = null;lastSubmittedTextRef.current = '';+ hasRecordingContentRef.current = false;sentAudioMsRef.current = 0;terminalOutcomeRef.current = 'success';- systemAudioMuteGateOpenRef.current = true;- systemAudioMuteGateDropLoggedRef.current = false;++ const { elapsedMs } = timeline;++ const capturePromise = startVoiceInputCaptureSession({+ label: '',+ workletUrl,+ deviceId: voiceInputSettings.microphoneDeviceId ?? undefined,+ fastActivationEnabled: voiceInputSettings.fastActivationEnabled,+ getRunId: () => runIdRef.current,+ setEngine: (engine) => {+ engineRef.current = engine;+ },+ isCurrentEngine: (engine) => startAttemptIdRef.current === attemptId && engineRef.current === engine,+ timeline,+ onCaptureReady: () => {+ if (!isActiveStartAttempt(attemptId) || stateRef.current !== 'listening') return;+ setCaptureReady(true);+ },+ onSoundDetected: () => { hasRecordingContentRef.current = true; },+ appendAudioChunk,+ onInterrupted: (message) => {+ if (isActiveStartAttempt(attemptId)) void failActiveRecording(message);+ },+ onStateChange: (event, details) => {+ log.debug('microphone engine', event, details);+ },+ getFallbackMessage: formatMicrophoneFallbackMessage,+ onFallback: (message) => {+ toast.warning(message);+ },+ formatStartError: formatMicrophoneStartError,+ elapsedMs,+ });++ // Start capture first; feedback runs independently without awaiting the+ // microphone. Only system mute waits for playback to avoid cutting it off.+ const feedback = Promise.resolve().then(() => {+ if (!isActiveStartAttempt(attemptId) || stateRef.current !== 'listening') return;+ return startOptions?.onStartFeedback?.();+ });if (voiceInputSettings.muteSystemAudio && supportsSystemAudioMute()) {- systemAudioMuteGateOpenRef.current = false;- void muteSystemAudioForRecording();+ void muteSystemAudioForRecording(feedback).then(() => timeline.mark('mute_finished'));+ } else {+ void feedback.catch(() => undefined);}- const bootstrapStartedAt = performance.now();- const elapsedMs = () => Math.round(performance.now() - bootstrapStartedAt);-- // Critical-path parallelization (mirrors VoiceInputOverlay.startRecording):- //- // 1. Permission + provider-readiness use main's positive cache when- // available. Missing/negative cache falls back to the existing async- // checks. Main still verifies readiness inside voice-input:start, so a- // stale positive cache cannot bypass auth; it only avoids blocking- // getUserMedia on two IPC round trips.- // 2. After both gates, getUserMedia/worklet setup and the main-side- // WebSocket dial run concurrently — the network round-trip overlaps- // the OS microphone handshake instead of waiting for it.- // 3. PCM chunks emitted before `runId` is known are buffered and drained- // the moment the start IPC resolves.- // 4. System-audio mute starts before the gates. While it is pending,- // microphone PCM is gated so system audio playing during the mute delay- // cannot enter ASR.- const guards = await resolveVoiceInputStartGuards();++ // Local capture (and its permission request) starts before service checks.+ // A slow account/readiness dialog must not cost the user's opening words.+ let proceed = true;+ try {+ proceed = (await startOptions?.beforeStart?.()) !== false;+ } catch (error) {+ if (isActiveStartAttempt(attemptId)) {+ const message = error instanceof Error ? error.message : String(error);+ resolveStartReadyState(attemptId, { ok: false, error: message });+ await failActiveRecording(message);+ }+ return;+ }+ if (!isActiveStartAttempt(attemptId)) return;+ if (!proceed) {+ resolveStartReadyState(attemptId, { ok: false, error: 'Voice input start was cancelled.' });+ invalidateStartAttempt();+ await stopEngine();+ await restoreSystemAudioForRecording();+ draftDisplayRangeRef.current = null;+ insertionRangeRef.current = null;+ setVoiceState('idle');+ restoreEditorFocusAfterVoiceInput();+ return;+ }+ let guards: Awaited<ReturnType<typeof resolveVoiceInputStartGuards>>;+ try {+ guards = await resolveVoiceInputStartGuards();+ } catch (error) {+ if (isActiveStartAttempt(attemptId)) {+ const message = error instanceof Error ? error.message : String(error);+ resolveStartReadyState(attemptId, { ok: false, error: message });+ await failActiveRecording(message);+ }+ return;+ }+ timeline.mark('checks_finished');log.info('voice input start guards checked', {ok: guards.ok,failed: guards.ok ? undefined : guards.failed,@@ -1288,10 +1357,6 @@ export function useVoiceInput(});if (!isActiveStartAttempt(attemptId)) {resolveStartReadyState(attemptId, { ok: false, error: 'Voice input start was cancelled.' });- draftDisplayRangeRef.current = null;- insertionRangeRef.current = null;- await restoreSystemAudioForRecording();- restoreEditorFocusAfterVoiceInput();return;}if (!guards.permission.ok) {@@ -1304,6 +1369,7 @@ export function useVoiceInput(} else {reportVoiceInputError(guards.permission.error);}+ await stopEngine();await restoreSystemAudioForRecording();restoreEditorFocusAfterVoiceInput();return;@@ -1329,6 +1395,7 @@ export function useVoiceInput(insertionRangeRef.current = null;setVoiceState('error');reportVoiceInputError(readinessError);+ await stopEngine();await restoreSystemAudioForRecording();restoreEditorFocusAfterVoiceInput();return;@@ -1342,36 +1409,23 @@ export function useVoiceInput(};const startResultPromise: Promise<StartVoiceInputResult> = window.electronAPI.voiceInput.start(startPayload)+ .then((result) => {+ if (result.ok) timeline.mark('connection_ready');+ return result;+ }).catch((startError) => ({ok: false as const,error: startError instanceof Error ? startError.message : String(startError),}));- const captureStart = await startVoiceInputCaptureSession({- label: '',- workletUrl,- deviceId: voiceInputSettings.microphoneDeviceId ?? undefined,- fastActivationEnabled: voiceInputSettings.fastActivationEnabled,- getRunId: () => runIdRef.current,- setEngine: (engine) => {- engineRef.current = engine;- },- isCurrentEngine: (engine) => startAttemptIdRef.current === attemptId && engineRef.current === engine,- canAcceptAudioChunk,- appendAudioChunk,- onInterrupted: (message) => {- void failActiveRecording(message);- },- onStateChange: (event, details) => {- log.debug('microphone engine', event, details);- },- getFallbackMessage: formatMicrophoneFallbackMessage,- onFallback: (message) => {- toast.warning(message);- },- formatStartError: formatMicrophoneStartError,- elapsedMs,- });+ const captureStart = await capturePromise;+ if (!isActiveStartAttempt(attemptId)) {+ resolveStartReadyState(attemptId, { ok: false, error: 'Voice input start was cancelled.' });+ void startResultPromise.then((result) => {+ if (result.ok) void window.electronAPI.voiceInput.cancel({ runId: result.runId });+ });+ return;+ }if (!captureStart.ok) {// 电源释放(锁屏/挂起)取消了启动:静默回收,不显示错误态 —— 用户是主动// 离开,内部的 disposed 消息不该出现在界面上。@@ -1434,14 +1488,9 @@ export function useVoiceInput(const result = await startResultPromise;if (!isActiveStartAttempt(attemptId)) {resolveStartReadyState(attemptId, { ok: false, error: result.ok ? 'Voice input start was cancelled.' : result.error });- await stopEngine();- await restoreSystemAudioForRecording();- draftDisplayRangeRef.current = null;- insertionRangeRef.current = null;- if (result.ok) {- await window.electronAPI.voiceInput.cancel({ runId: result.runId });- }- restoreEditorFocusAfterVoiceInput();+ // The cancelling attempt already stopped its own device. A late network+ // result must not touch a replacement attempt's microphone or UI.+ if (result.ok) await window.electronAPI.voiceInput.cancel({ runId: result.runId });return;}if (!result.ok) {@@ -1480,7 +1529,6 @@ export function useVoiceInput(}, [appendAudioChunk,buildRefinementContext,- canAcceptAudioChunk,createStartReadyState,disabled,failActiveRecording,@@ -1548,6 +1596,28 @@ export function useVoiceInput(});}, []);+ const cancel = useCallback(async () => {+ const runId = runIdRef.current;+ invalidateStartAttempt();+ resolveStopCompletion();+ await stopEngine();+ try {+ await window.electronAPI.voiceInput.cancel(runId ? { runId } : undefined);+ } finally {+ await restoreSystemAudioForRecording();+ }+ commitUsageStats();+ setDraftText('');+ setDraftSource(null);+ draftDisplayRangeRef.current = null;+ runIdRef.current = null;+ ownedRunIdRef.current = null;+ insertionRangeRef.current = null;+ submittedRangesRef.current.clear();+ setVoiceState('done');+ restoreEditorFocusAfterVoiceInput();+ }, [commitUsageStats, invalidateStartAttempt, resolveStopCompletion, restoreEditorFocusAfterVoiceInput, restoreSystemAudioForRecording, setVoiceState, stopEngine]);+const stop = useCallback(async (options?: VoiceInputStopOptions) => {const currentState = stateRef.current;if (currentState === 'submitting' || currentState === 'refining') {@@ -1559,6 +1629,20 @@ export function useVoiceInput(return;}if (currentState !== 'listening') return;+ if (hasRecordingContentRef.current) setVoiceState('submitting');+ // Include the final worklet sub-chunk before deciding there was no sound.+ // A silent recording must not wait for a pending cloud start or final text.+ await drainAndStopEngine();+ if (stateRef.current === 'error') {+ throw new Error(lastErrorRef.current ?? 'Voice input failed.');+ }+ if (stateRef.current !== 'listening' && stateRef.current !== 'submitting') return;+ if (!hasRecordingContentRef.current) {+ log.info('silent recording ended without ASR finalization');+ await cancel();+ notifyReadyForEndCue(options);+ return;+ }let runId = runIdRef.current;let restorePromise: Promise<void> | null = null;setVoiceState('submitting');@@ -1645,7 +1729,7 @@ export function useVoiceInput(setVoiceState('done');restoreEditorFocusAfterVoiceInput();}- }, [commitUsageStats, dismissInlineError, drainAndStopEngine, drainQueuedAudioToMain, formatVoiceInputStartError, invalidateStartAttempt, reportVoiceInputError, resolveStopCompletion, restoreEditorFocusAfterVoiceInput, restoreSystemAudioAndNotifyEndCue, setVoiceState, waitForBusyCompletion, waitForStartReadyWhileStopping]);+ }, [cancel, notifyReadyForEndCue, commitUsageStats, dismissInlineError, drainAndStopEngine, drainQueuedAudioToMain, formatVoiceInputStartError, invalidateStartAttempt, reportVoiceInputError, resolveStopCompletion, restoreEditorFocusAfterVoiceInput, restoreSystemAudioAndNotifyEndCue, setVoiceState, waitForBusyCompletion, waitForStartReadyWhileStopping]);const stopWithGate = useCallback(async (options?: VoiceInputStopOptions) => {if (stopInFlightPromiseRef.current) return stopInFlightPromiseRef.current;@@ -1659,28 +1743,6 @@ export function useVoiceInput(}, [stop]);stopWithGateRef.current = stopWithGate;- const cancel = useCallback(async () => {- const runId = runIdRef.current;- invalidateStartAttempt();- resolveStopCompletion();- await stopEngine();- try {- await window.electronAPI.voiceInput.cancel(runId ? { runId } : undefined);- } finally {- await restoreSystemAudioForRecording();- }- commitUsageStats();- setDraftText('');- setDraftSource(null);- draftDisplayRangeRef.current = null;- runIdRef.current = null;- ownedRunIdRef.current = null;- insertionRangeRef.current = null;- submittedRangesRef.current.clear();- setVoiceState('done');- restoreEditorFocusAfterVoiceInput();- }, [commitUsageStats, invalidateStartAttempt, resolveStopCompletion, restoreEditorFocusAfterVoiceInput, restoreSystemAudioForRecording, setVoiceState, stopEngine]);-useEffect(() => {const editorUnavailable = !editor || editor.isDestroyed || disabled;if (!editorUnavailable) return;@@ -1708,6 +1770,7 @@ export function useVoiceInput(draftRange: draftDisplayRangeRef.current ?? insertionRangeRef.current,lastError,isListening: state === 'listening',+ isCaptureReady: state === 'listening' && captureReady,isBusy: state === 'listening' || state === 'submitting' || state === 'refining',getLastSubmittedText: () => lastSubmittedTextRef.current,getLastRefinement: () => lastRefinementRef.current,diff --git a/apps/desktop/src/renderer/voice-input/useVoiceProcessingIndicator.ts b/apps/desktop/src/renderer/voice-input/useVoiceProcessingIndicator.tsnew file mode 100644index 0000000000..a2a1dce612--- /dev/null+++ b/apps/desktop/src/renderer/voice-input/useVoiceProcessingIndicator.ts@@ -0,0 +1,15 @@+import { useEffect, useState } from 'react';+import type { VoiceInputState } from '@cindy/voice-input-core';++/** Delay only visual feedback, never the stop operation or interaction lock. */+export function useVoiceProcessingIndicator(state: VoiceInputState): boolean {+ const processing = state === 'submitting' || state === 'refining';+ const [visible, setVisible] = useState(false);+ useEffect(() => {+ setVisible(false);+ if (!processing) return;+ const timer = setTimeout(() => setVisible(true), 150);+ return () => clearTimeout(timer);+ }, [processing]);+ return processing && visible;+}diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.mdindex ba7b3878c7..d17d513e7b 100644--- a/docs/design-rules/design-inventory.md+++ b/docs/design-rules/design-inventory.md@@ -18,12 +18,12 @@| `desktop.auth.add-account` | desktop | 添加账号 | hash `/add-account`(ProtectedRoute → AddAccountLoginPage) | AddAccountLoginPage | apps/desktop/src/renderer/components/login/AddAccountLoginPage.tsx, apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 || `desktop.auth.legacy-migration` | desktop | 首登数据迁移弹窗 | App 顶层挂载 LegacyMigrationDialog(仅主窗;main 检测到旧版 userData 经 `legacy-migration:state` 驱动) | LegacyMigrationDialog | apps/desktop/src/renderer/components/auth/LegacyMigrationDialog.tsx | 8 | 0 | 2 || `desktop.auth.login` | desktop | 登录页 | hash `/login`(GuestRoute → LoginPage) | LoginBrandStage, LoginCaptchaOverlay, LoginControls, LoginPage | apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 |-| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskResultCard.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotSettingsData.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 276 | 43 | 442 |+| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskResultCard.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotSettingsData.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 276 | 43 | 443 || `desktop.chat.files` | desktop | 工作目录文件浏览 | hash `/cc-agent/files/:sessionId`(WorkdirBrowseRoute) | FileBodyView, FileTreeView, WorkdirBrowseRoute | apps/desktop/src/renderer/features/cc-agent/workdir-browse/DocSearchBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/DrawioPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileBodyView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileFilterInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FilterResultList.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/ImagePreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/OpenInSystemActions.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/PdfPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/SessionTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/UnrenderablePlaceholder.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseRoute.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailCollapsed.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailResize.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useConfirmSwitchAwayIfDirty.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useDelayedFlag.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileContent.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useOpenTabs.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useProjectFileList.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useRevealFileInTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/activeFileBodyHandle.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/docModeSwitchProjects.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/drawioExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/expandedStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileContentCache.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileIcon.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileMeta.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileScrollStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileSelectionParams.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/filterFiles.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/imageExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/markdownAutosave.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/openTabsStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/pdfExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/selectedFileStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchPanel.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchResults.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/hooks/useProjectSearch.ts | 17 | 7 | 62 || `desktop.chat.new-draft` | desktop | 新建任务草稿页 | hash `/cc-agent/new`(NewMakerDraftRoute) | NewMakerDraftRoute | apps/desktop/src/renderer/features/cc-agent/NewMakerDraftRoute.tsx | 15 | 0 | 2 |-| `desktop.chat.orca-workflow` | desktop | Orca 协同工作台 | hash `/cc-agent/orca/:sessionId`(OrcaWorkflowRoute) | CCAgentSessionView, OrcaSplitView, OrcaWorkerPanel, OrcaWorkflowRoute | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaSplitView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkflowRoute.tsx | 256 | 43 | 356 |+| `desktop.chat.orca-workflow` | desktop | Orca 协同工作台 | hash `/cc-agent/orca/:sessionId`(OrcaWorkflowRoute) | CCAgentSessionView, OrcaSplitView, OrcaWorkerPanel, OrcaWorkflowRoute | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaSplitView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkflowRoute.tsx | 256 | 43 | 357 || `desktop.chat.scheduled` | desktop | 调度任务列表 | hash `/cc-agent/scheduled`(SchedulerPage) | SchedulerPage | apps/desktop/src/renderer/features/scheduler/SchedulerPage.tsx, apps/desktop/src/renderer/features/scheduler/components/AgentMark.tsx, apps/desktop/src/renderer/features/scheduler/components/BoundSessionCard.tsx, apps/desktop/src/renderer/features/scheduler/components/ProjectAutomationNotifyBridge.tsx, apps/desktop/src/renderer/features/scheduler/components/RunHistoryCard.tsx, apps/desktop/src/renderer/features/scheduler/components/RunHistoryPane.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleChips.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleFormDialog.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleSessionIndexOwner.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleStatusChip.tsx, apps/desktop/src/renderer/features/scheduler/components/ScriptCapabilityMultiSelect.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListCell.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListFilterPopover.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListPane.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateCard.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateGallery.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateParamForm.tsx, apps/desktop/src/renderer/features/scheduler/hooks/useDeleteScheduleWithSessions.tsx, apps/desktop/src/renderer/features/scheduler/hooks/useReadFailedScheduleRuns.ts, apps/desktop/src/renderer/features/scheduler/hooks/useRunNowBusyGuard.ts, apps/desktop/src/renderer/features/scheduler/hooks/useRuns.ts, apps/desktop/src/renderer/features/scheduler/hooks/useScheduleForm.ts, apps/desktop/src/renderer/features/scheduler/hooks/useScheduleUnreadRunCounts.ts, apps/desktop/src/renderer/features/scheduler/hooks/useSchedules.ts, apps/desktop/src/renderer/features/scheduler/hooks/useSessionReferences.ts, apps/desktop/src/renderer/features/scheduler/hooks/useTemplates.ts, apps/desktop/src/renderer/features/scheduler/index.ts, apps/desktop/src/renderer/features/scheduler/lib/cronCodexPreset.ts, apps/desktop/src/renderer/features/scheduler/lib/cronToHuman.ts, apps/desktop/src/renderer/features/scheduler/lib/failedScheduleDismissal.ts, apps/desktop/src/renderer/features/scheduler/lib/formatters.ts, apps/desktop/src/renderer/features/scheduler/lib/pluginScheduleCreateIntent.ts, apps/desktop/src/renderer/features/scheduler/lib/projectAutomationConfig.ts, apps/desktop/src/renderer/features/scheduler/lib/projectScheduleSidebarIndex.ts, apps/desktop/src/renderer/features/scheduler/lib/runHistoryGrouping.ts, apps/desktop/src/renderer/features/scheduler/lib/runUnread.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleFormLogic.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleRunReadSync.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleSessionBinding.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleSidebarIndexRuns.ts, apps/desktop/src/renderer/features/scheduler/lib/schedulesStore.ts, apps/desktop/src/renderer/features/scheduler/lib/statusFilter.ts, apps/desktop/src/renderer/features/scheduler/lib/statusFilterStorage.ts, apps/desktop/src/renderer/features/scheduler/lib/templateLocalization.ts, apps/desktop/src/renderer/features/scheduler/lib/usageLimitScheduleCreateIntent.ts | 37 | 0 | 95 |-| `desktop.chat.session` | desktop | 会话工作台 | hash `/cc-agent/:sessionId`;副窗经 `/cc-agent/boot` 解析后落到同一会话视图 | AssistantMessage, CCAgentFeatureLayout, CCAgentSessionView, ChatInput, PermissionPrompt | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 256 | 43 | 355 |+| `desktop.chat.session` | desktop | 会话工作台 | hash `/cc-agent/:sessionId`;副窗经 `/cc-agent/boot` 解析后落到同一会话视图 | AssistantMessage, CCAgentFeatureLayout, CCAgentSessionView, ChatInput, PermissionPrompt | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 256 | 43 | 356 || `desktop.dev.maker-experimental` | desktop | Maker 实验诊断页 | hash `/maker-experimental`(MakerExperimentalView;EXPERIMENTAL_FEATURES 现为空,仍是生产路由) | MakerExperimentalView | apps/desktop/src/renderer/features/maker-experimental/MakerExperimentalView.tsx | 9 | 0 | 7 || `desktop.issues.guide` | desktop | Issue 引导页 | hash `/issues`(IssueTrackerFeatureLayout,已迁 GitHub 后的引导页) | IssueTrackerFeatureLayout | apps/desktop/src/renderer/features/issue-tracker/IssueTrackerFeatureLayout.tsx, apps/desktop/src/renderer/features/issue-tracker/MyIssueList.tsx, apps/desktop/src/renderer/features/issue-tracker/hooks/useMyIssues.ts, apps/desktop/src/renderer/features/issue-tracker/lib/myIssuesNotices.ts, apps/desktop/src/renderer/features/issue-tracker/lib/startIssueChat.ts | 0 | 0 | 7 || `desktop.native.app-menu` | desktop | 应用菜单 | Menu.setApplicationMenu(用户可见出口,不展开业务逻辑) | applicationMenuLabels | apps/desktop/src/main/applicationMenuLabels.ts | 0 | 0 | 0 |diff --git a/docs/voice-connection-benchmark-2026-09-25.md b/docs/voice-connection-benchmark-2026-09-25.mdnew file mode 100644index 0000000000..035c77b9ec--- /dev/null+++ b/docs/voice-connection-benchmark-2026-09-25.md@@ -0,0 +1,80 @@+# 语音云端连接等待拆解++> 2026-09-26 更新:本文保留历史实验结果。生产代码已移除原生静音接入及提前发送音频+> 实验;macOS 使用原有 AppleScript 后端,ASR 等待协议就绪后发送音频。独立静音基准+> 脚本及 Swift 源码仅供复现实验,不参与客户端打包或运行。+++2026-09-25,Apple Silicon / macOS 27.0。本轮没有启动客户端,没有使用账号凭证、+申请识别会话或发送音频;网络探测使用独立 Node 22 进程直连 Global 公共入口。++## 已有真实录音日志++当日 12 条完整 `volcengine-sauc-asr connected` 日志统计:++| 阶段 | 最小 | 中位数 | 最大 |+| ------------------- | -----: | ------: | -----: |+| 获取会话连接信息 | 265ms | 303ms | 633ms |+| 代理解析 | 0ms | 0ms | 0ms |+| WebSocket open | 1035ms | 1194ms | 1395ms |+| open 到首个协议响应 | 509ms | 563.5ms | 658ms |+| 合计 | 1828ms | 2072ms | 2442ms |++各列中位数不是同一条样本,不应直接相加。代理解析为 0ms 是取整后的耗时,+不证明应用没有走代理。本轮独立网络测试是直连,不能替代应用的真实代理路径。++代码确认:`serverApiClient.ts` 申请会话用 Electron `net.fetch`(Chromium),+`VolcengineSaucAsrProvider.ts` 的 WebSocket 用 `ws` / Node HTTPS。+两套网络栈不共享连接池。因此刚申请过票据不意味着 WebSocket 已有可复用的连接。++## 网络对照++第一组:公开入口无凭证 HEAD,比较全新连接、TLS 会话缓存、完整 socket 复用。+首个 DNS 查询 430ms,此后约 2–4ms;后续新连接从开始到 TCP 完成为 527–564ms,+到 TLS 完成为 1089–1210ms。这些是相对开始的里程碑,不可累加。+复用完整 socket 的两次 HEAD 响应为 313 / 315ms。+TLS 缓存组没有观测到 `isSessionReused=true`,不据此推断服务永久不支持 TLS 恢复。++第二组:使用生产依赖 `ws` 向 `/api/voice/asr` 发无凭证升级请求。+所有请求均返回 401,**不是识别成功或已认证建连测试**。+按 cold / warm / warm / cold / cold / warm 交错执行。++| 模式 | 请求到响应 | 中位数 | socket 复用 |+| ---------------- | -------------------- | -----: | ----------- |+| 冷连接 | 1606 / 1628 / 1515ms | 1606ms | 否 |+| 先完成 HEAD 预热 | 368 / 358 / 359ms | 359ms | 三次均是 |++点击路径候选收益约 1247ms;预热本身消耗 1525 / 1671 / 1532ms。+如果点击以后才等待预热完成,总时间反而可能更长。必须在点击之前完成并保留连接,+才能把这段等待移出点击路径。本实验没有证明认证、网关上游准备和首字时间也省同样多。++可复现第二组:++```sh+node scripts/voice-transport-benchmark.mjs wss://voice.cindy.app/api/voice/asr+```++脚本不发送认证或音频,不读取开发版登录态。默认 Node 直连,不声称复现系统代理。++仓库脚本随后复跑一次:冷连接 1373 / 1349 / 1364ms(中位数 1364ms),+预热连接 279 / 278 / 314ms(中位数 279ms),差值 1085ms。六次仍均为 401,+三次预热组仍均确认 socket 复用。两轮一致支持约 1.1–1.25 秒的网络层候选收益。++## 取舍与落地条件++1. **优先候选:普通 HTTPS 连接预热,然后同一个 Node Agent 发 WebSocket 升级。**+ 可以挂现有输入框语音预热入口,不提前创建计费识别会话。只有已就绪连接才能命中;+ 点击不等预热。连接会被升级消耗,下一轮需要新连接。需要明确空闲连接的回收期限,+ 避免把一次实验变成无限后台请求;还需测试空闲超时、代理变化、区域切换、重连。+2. **提前发送缓存音频仅保留历史结论,代码已撤下。** 原日志首次响应约 564ms;允许先发音频才可能+ 和这段等待重叠。之前本地服务模拟已证明这取决于服务端何时开始消费,不能承诺首字+ 一定等额提速。发布版本统一等待协议就绪,避免增加启动失败的状态分支。+3. **不优先缓存票据。** 会话票据是一次性的,还关联会话 ID、语言和后续润色;复用+ 旧票据会破坏语义,提前申请会话也超出当前“实际使用才创建”的设计。+4. **不为代理解析、TLS 缓存继续加机制。** 前者现有样本接近零,后者本轮没有实测收益。++本轮产品代码只补实际 WebSocket 的分段观测,不默认启用新的连接池。+记录 socket 分配、DNS、TCP、TLS、升级响应里程碑及复用/代理标志;不记录 URL、+地址、凭证、请求头或响应正文。代理可能交付已连接隧道,缺失阶段保留为空,不伪造 0ms。+完整认证会话对照、首字收益和代理路径收益仍待验证。+21 项握手计时与 SAUC 协议回归测试、Desktop 类型检查通过。diff --git a/docs/voice-mute-benchmark-2026-09-25.md b/docs/voice-mute-benchmark-2026-09-25.mdnew file mode 100644index 0000000000..b67459a838--- /dev/null+++ b/docs/voice-mute-benchmark-2026-09-25.md@@ -0,0 +1,50 @@+# macOS 语音输入静音对照实验++> 2026-09-26 更新:本文保留历史实验结果。生产代码已移除原生静音接入及提前发送音频+> 实验;macOS 使用原有 AppleScript 后端,ASR 等待协议就绪后发送音频。独立静音基准+> 脚本及 Swift 源码仅供复现实验,不参与客户端打包或运行。+++2026-09-25,macOS 27.0 (26A428),Apple Silicon。独立脚本调用真实系统输出设备,+没有启动 Electron,没有访问麦克风、账号或云端。每次静音后都核验已静音,并恢复、+核验原状态。测试前系统输出未静音。++可复现入口:`node scripts/voice-mute-benchmark.mjs --apply`。+不加 `--apply` 时只读状态,不会改变系统输出。脚本在唯一临时目录编译、测试并清理。++## 结果与选择++每组 6 次,按原生 → AppleScript → 预编译 AppleScript → 反向顺序交错,共 18 次。+耗时包括子进程启动、系统读写与退出,不是麦克风启动或首字出现时间。++| 方案 | 静音中位数 | 静音范围 | 恢复中位数 |+| ------------------ | ---------: | ------------: | ---------: |+| 原生 CoreAudio | 66.9ms | 61.3–79.5ms | 69.7ms |+| 原有 AppleScript | 149.3ms | 137.0–177.3ms | 154.1ms |+| 预编译 AppleScript | 156.0ms | 139.1–177.0ms | 148.7ms |++预编译组只预编译静音脚本,恢复沿用原有 AppleScript。原生较原方案静音快约 82ms+(55%),恢复快约 84ms。此前一轮两组各 6 次的独立交错测试结果为静音 52.0ms /+144.8ms、恢复 52.6ms / 151.4ms;两轮结论一致,但绝对时间会随系统负载变化。++新编译原生程序第一次只读探测为 345ms(此前一轮 397ms)。这不是清空系统缓存或+重启机器后的冷启动测量,不可承诺所有设备都能复现。因此采用**后台只读预热后才启用+原生路径**:点击时未就绪就立即走 AppleScript,不等待编译或预热。+不新增常驻进程,不缓存输出设备的静音状态;每次录音重新读取实际状态。++## 正确性与边界++- 原生程序在写入前输出原状态;即使后续写入失败或超时,父进程仍保留恢复依据。+- 原生恢复使用采集的设备 ID,并校验 UID,避免默认输出切换后误改其它设备。+- 未就绪、缺少编译器、设备不支持时使用 AppleScript;已取得原状态后的写入失败+ 不重新读取并覆盖原状态,交给现有恢复流程处理。+- 静音继续等待提示音完成;麦克风准备和收音不等待本流程。+- Windows 保持原后端,平台分支由单测覆盖,未在 Windows 实机测试。++48 项定向测试通过(静音后端/状态恢复、提示音、录音启动、现有原生依赖打包测试)。+Apple Silicon 原生程序编译并实测通过;错误设备 UID 的原生拒绝路径也已实测,未改变+输出状态。Intel macOS 10.15 目标源码编译通过,但本机链接验证未完成:+本机 Command Line Tools 的 Swift 兼容库仅含 arm64/arm64e,缺少 x86_64;需要完整+工具链或 Intel 构建机验证。未生成、签名或启动完整安装包,未重启当前开发版。++上述收益仅证明静音与恢复更快,不代表识别首字提速。真实云端连接 A/B 不在本实验中。diff --git a/docs/voice-optimization-summary-2026-09-25.md b/docs/voice-optimization-summary-2026-09-25.mdnew file mode 100644index 0000000000..af65097534--- /dev/null+++ b/docs/voice-optimization-summary-2026-09-25.md@@ -0,0 +1,157 @@+# 语音输入优化总览与实机复测++## 发布范围(2026-09-26 review 收敛)++生产路径已撤下原生静音 helper 和提前发送音频实验。macOS 恢复原有 AppleScript 静音,+避免新增设备快照在部分失败或输出设备拔出后阻碍恢复与下一次录音;Swift helper 仅供+独立基准脚本使用,不再打包、预热或从客户端调用。ASR 必须收到首个协议响应才就绪,+删除 XDT_VOICE_EARLY_AUDIO 开关及相关实验测试。保留本地先收音、停顿润色、快速收尾+和显示修复。下方实测记录属于当时版本,不能作为当前版本原生静音收益的声明。++## 历史测试条件++2026-09-25 23:17–23:18(Pacific/Auckland),从 `dash/voice-local-capture`+worktree 重新启动隔离 Global 开发版,`DESKTOP_DEV_VERDICT=ready`,PID 76672。+源码身份与 worktree 匹配;测试针对当前未提交改动,不等于这些改动已经发布。++当前设置由开发版只读回查:快速启动关闭、录音时静音开启、提示音开启。+麦克风为默认 Studio Display XDR,实际输入 48kHz,输出 PCM 16kHz。+本次不启用 `XDT_VOICE_EARLY_AUDIO`;真实连接日志确认 `earlyAudio: false`。+没有云端连接预热。用户在运行中的开发版产生3次录音,本轮读取其日志和界面状态,+未发送合成音频、未代替用户提交文本。测试后按钮回到“开始语音输入”、未按下、可用。++## 保留的优化++| 改动 | 作用 | 验证及限制 |+| ----------------------------------------------------- | -------------------------------------- | -------------------------------------------------------------------- |+| 点击后立即显示录音状态与计时,取消准备转圈 | 减少视觉等待 | 启动回归已测;本轮未对点击后的逐帧动画录像 |+| 本地麦克风先启动,账号/云端检查随后进行 | 不让云端建连拖延本地采集 | 实机126–183ms出现PCM,连接就绪为2.06–2.62秒 |+| 实际采集负责麦克风权限请求,不再额外开一次探测麦克风 | 减少重复设备初始化 | 启动、预热、权限相关回归;拒绝权限后不重复冷启动 |+| 复用有效的语音就绪结果 | 减少重复IPC检查 | 启动回归;不改变实际服务端认证 |+| 提示音与麦克风启动独立,静音只等待提示音完成 | 声音反馈不阻塞采集,也不被过早静音切掉 | 提示音有结束回执与超时收尾;本轮3次均先收音后静音 |+| 静音未完成时仍保存PCM;云端连接前保留本地音频 | 保住开头,不为静音丢帧 | 沿用原有60秒缓冲上限,不是新增无限缓存 |+| 取消/失败只清理所属采集实例 | 防止旧请求回调误停新录音 | 启动竞态与恢复回归覆盖 |+| 首包先交付10ms音频,其后回到常规40ms包 | 音频已产生后,首包少攒约24–29ms | 离线波形完全一致;每次录音可能多一个包,不属于严格零开销改动 |+| 取消SAUC“留一包等下一包”的发送等待 | 每个已收到的音频包立即发送 | 协议测试保持顺序;结束仍使用原有尾部静音包 |+| 文本提取边遍历边选最长项 | 减少数组与排序 | 与旧算法等价;局部约减半,每次仅约1微秒收益 |+| 同采样率音频省去一次中间数组复制 | 降低无需重采样时的处理量 | 两种采集路径均已改;局部约7%,本轮48k→16k不走该分支 |+| 增加本地与网络分段计时 | 区分收音、静音、连接与首字瓶颈 | 不把计时本身算成提速;日志不包含新增音频、凭证或网络正文 |++“快速启动”常驻采集、共享AudioContext/Worklet等已有机制不是本轮新增成果;+本次也没有为提速擅自开启快速启动。此前已批准的原生静音预热、先前已做的首包拆分+与后续“零新增开销”的小优化分开列示,不把整个分支概括成绝对零代价。++## 实验和未采用的方案++- **连接open后、首次协议响应前发送音频**:已撤下开发实验开关;历史实测时关闭。本地模拟可省一轮等待,但服务端若要先初始化,首字未必变快。+- **点击前预热普通HTTPS连接并给WebSocket复用**:公共入口无凭证实验有约1.1–1.25秒+ 网络层潜在收益,但增加请求及空闲连接,用户已否决,未默认接入。+- **预编译AppleScript、TLS缓存**:没有测得足够收益,不采用。+- **降低gzip压缩强度**:可能增加流量,不采用。+- **单次分配协议包、合并重连缓存清理遍历**:前者接近噪声、后者略慢,不采用。++## 本轮真实录音数据++下表均为点击开始后的毫秒数;“首个PCM”是音频数据真正进入本地缓存的证据,+不等于从点击第一毫秒就已能捕获声音。++| 次数 | 麦克风引擎就绪 | 首个PCM/进入缓存 | 静音完成 | 云端就绪 | 首次识别文字 |+| ---------- | -------------: | ---------------: | -------: | -------: | -----------: |+| 启动后首次 | 171 | 183 | 215 | 2617 | 4292 |+| 第二次 | 119 | 126 | 198 | 2280 | 3498 |+| 第三次 | 119 | 128 | 194 | 2064 | 3223 |++三次均有识别结果、最终恢复系统输出。没有逐字对照用户原话,不能据此宣称识别准确率+或开头字完整性已全部验收。后两次首包126–128ms,比此前重复录音约155–158ms的记录+少约30ms;静音中位数198ms,比前一阶段约284.5ms少约87ms。不同时间的样本并非严格+同条件A/B,这些只能视作趋势,不能把全部变化归因到某一项代码。++实际云端仍为直连、无socket复用、无TLS会话恢复。本轮DNS为2–11ms,TCP完成约300ms,+TLS完成约927–946ms(相对拨号起点),HTTP升级响应再约303–306ms;连接open后首个+协议响应492–670ms。它们解释了首字仍然较慢,但按用户取舍不以新增后台连接换首字速度。++## 验证记录与剩余边界++### 2026-09-26:静音录音直接结束++聊天框和全局浮窗在停止时先取出最后的麦克风缓冲,再检查本次是否录到声音。+没有声音且没有识别文字时,走现有取消/清理流程,跳过等待云端启动、最终识别和润色;+仍恢复系统输出、播放结束提示音。云端迟到的启动结果按原有 runId 取消机制清理。++判断在已有 PCM 回调中完成,没有新增云端请求、模型或后台采集;一旦检测到声音,+本次不再扫描音频。当前采用保守阈值:PCM16 RMS 至少32(约−60dBFS),或任何采样+峰值至少128,都继续正常识别。它不是人声分类器,明显底噪或麦克风录入的提示音也会+保留;极弱声音仍有阈值误判可能,已有识别文字可阻止跳过。录音期间已发送的云端音频+不因停止时的判断而撤回,也不承诺消除已产生的费用。++本轮以合成 PCM 和 Hook 集成测试覆盖静音、低底噪、短暂/轻声、尾帧、快速停止、+未连接时结束和迟到连接回收;尚未用不同真实麦克风标定阈值。++### 2026-09-26:停顿时提前润色并即时显示++用户明确调整此前零新增请求限制:一句话即可;后续每新增至少一句话可以再次润色,+不限制每次录音仅一次,结果立即显示。Desktop 在既有润色设置开启时启用;共享核心+的其他宿主默认不启用。沿用已有每秒检查及音量检测,不增加后台采集或云端连接。++触发条件为最近2秒未检测到说话、原始识别文字也未变化,并比上次请求至少多一句;+沿用每秒检查,因此实际触发约2–3秒。句界按中英文句末标点识别,停顿时无标点的+末尾也算一句;完全不输出标点的供应商可能只触发第一轮,不靠字数猜测新增句子。+每次请求使用完整原始识别文本,沿用原有缓存前缀;同一录音的提前请求串行执行,+同样内容不重复请求。停止时原文一致则复用已有请求/结果,原文变化则按最终全文润色。++已通过验证的润色结果立即更新临时文字,不提前提交、粘贴或写入语音历史;后续只+新增尾句时保留已润色前缀并拼上新尾句。ASR改写旧前缀时恢复最新原文;过期、取消、+失败和旧录音结果不能覆盖新文字。润色失败保留原文。缓存不保证命中,新增或最终+更改的全文请求仍会产生额外输入/输出用量,此项不再归为零代价优化。++- 最近零新增开销改动:85项定向测试及Desktop类型检查通过。+- 原生静音:48项相关回归通过,Apple Silicon真实静音/恢复对照通过;Intel源码可编译,+ 本机缺x86_64 Swift兼容库,完整Intel链接与安装包验证未完成。+- 握手分段观测:21项计时/协议回归及类型检查通过。+- 上述测试组有重叠,不把计数相加。Windows仅有分支单测,未实机测试。+- 当前开发版保持打开。改动尚未提交、发布或合并。++### 2026-09-26:确认时的三个等待缺口++- SAUC 逐句检查 definite,且句子拼接必须覆盖完整原文;修复“前一句已确认就把整段当稳定”+ 和“文字没变、确认状态变化却不通知”的问题。完整确认的末尾时间覆盖最后有声 PCM、+ 连续至少2秒安静、未发生重连时,仍发送结束包,但不再等待最后响应。缺失/异常时间戳、+ 新声音、部分尾句、重连均走原有收尾。使用实际发送 PCM 的音频时钟,不把网络响应到达+ 时间当作音频确认位置。依据:[供应商协议](https://docs.byteplus.com/en/docs/byteplusvoice/asrstreaming)。+- 音量判据取 PCM16 采样绝对值32,比原来的语音 VAD 更保守;底噪可阻止快速结束。+ 这是有阈值的本地判据,不能保证区分任意微弱声音;未做真实麦克风命中率标定。+ 新增每帧的短循环检查,不新增云端请求、连接或后台录音。+- Desktop 开启停顿润色后,已有请求原文一致则继续复用;原文已变化或仅有未确认尾句时,+ 等 ASR 收尾后只对最终原文启动新请求,省掉中间版本。已经发出的旧请求不会撤回费用;+ 最终新请求无需等待失效旧请求结束。其他未开启停顿润色的宿主保持原先并行策略。+- 已完成且匹配最终原文的润色直接作为提交文字;原文通过 basedOnText 保留,聊天框和+ 全局浮窗仍可用于词典学习。停止时不重放已完成请求的旧流式片段,避免闪回原文/半成品。++### 2026-09-26:结束瞬间文字变长再缩短++确认/最终润色写入编辑器正文时,旧草稿 widget 原先要等 React effect 才清理;+空插入位置会把 widget 映射到新文字后方,短暂显示两份。现在用同一个 ProseMirror+事务提交正文并清理草稿,保留处理中光标。回归测试包含真实草稿插件状态,覆盖空位+插入、替换选区和最终润色;不再仅检查正文字符串。++流式预览原先按输出字数截原文尾部拼接,删口头语后会产生重复/错位片段。+现在保持现有正文直到完整润色校验完成,不拼接半成品;录音停顿时完整润色结果的+即时显示不变。52项显示、启动、提交与词典学习定向测试通过。++### 2026-09-26:快速结束的声音判据++替换上述逐采样峰值32的判据:按1毫秒计算RMS,在20毫秒窗口内累计至少16毫秒+RMS≥32的轻声,或至少6毫秒RMS≥96的较明显短音,才保留为最后声音位置。+不足时长的孤立尖峰在安静窗口后不再阻止快速结束;刚出现的候选声音及未满1毫秒的+尾帧仍临时阻止结束,避免点击停止时尚未来得及判断。分包不重置窗口,重开录音重置。+音频完整发送给ASR;此判据只影响提前结束等待,不用于删音频或全程无声录音判断。+日志标记 soundDetection=rms_duration_v1 并记录实际阈值,便于比较。++39项合成PCM及本机WebSocket测试通过,覆盖低底噪、1–3毫秒脉冲、20/40毫秒弱音、+6/10毫秒较强短音、跨包、尾帧和重置。这不是人声分类模型;持续噪声可能仍触发,+极弱或更短声音也有误判可能,尚未用真实麦克风验证识别准确率或命中率。++详细实验:+[静音对照](voice-mute-benchmark-2026-09-25.md)、+[云端连接拆解](voice-connection-benchmark-2026-09-25.md)、+[零新增开销实验](voice-zero-cost-experiments-2026-09-25.md)。diff --git a/docs/voice-zero-cost-experiments-2026-09-25.md b/docs/voice-zero-cost-experiments-2026-09-25.mdnew file mode 100644index 0000000000..e74c757b5d--- /dev/null+++ b/docs/voice-zero-cost-experiments-2026-09-25.md@@ -0,0 +1,30 @@+# 零新增开销的语音处理实验++2026-09-25,Node 22 / Apple Silicon。本轮不联网、不启动客户端、不使用麦克风,+不增加产品后台请求、连接、预热或模型调用,也不改变音频格式、包数与压缩参数。+原先已经批准的原生静音预热有一次启动工作量,不属于本轮的零新增开销改动。++微基准是进程内 CPU 耗时,不是用户感知的录音启动或首字时间。++| 候选 | 对照结果 | 选择 |+| ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |+| 单次分配音频协议包,替代多个 Buffer 与 concat | 每批6000次,ABBA重复,旧84.64ms,新83.87ms,约0.9%差异;37种输入逐字节一致 | 收益接近噪声,不采用 |+| 遍历时选择最长识别文本,替代递归收集、trim/filter和排序 | 每批30000次,ABBA重复,旧55.13ms,新27.61ms,约49.9%减少;29种输入结果相同 | 采用;进一步用200种生成输入锁住旧语义 |+| 把重连缓存 filter 与时长求和合成一次遍历 | 每批30000次,旧中位数40.12ms,新42.53ms;20种输入相同 | 略慢,不采用 |+| gzip level 1 替代默认压缩 | 40ms静音包从30字节增至34字节;随机音频未测得计算优势 | 有流量代价,不采用 |+| 输入采样率已等于目标时,省去 Array.from 的中间数组 | 实际 worklet 源码在 VM 中每批处理4000个128样本输入,ABBA重复,旧79.96ms,新74.14ms,约7.3%减少;16k/44.1k/48k输出一致 | 采用,同步覆盖 ScriptProcessor 回退路径;只影响无需重采样的输入 |++输入覆盖空包、10ms/40ms音频、300ms尾部静音长度、固定伪随机PCM与合成波形。+这些是协议/计算输入,不代表真实语音的压缩率或识别效果。压缩组计时仅是探索性单批,+不能据此作稳定CPU收益承诺;仅凭确定的包体变大,已足够排除其为零代价方案。++同采样率路径只在本次处理回调内读取输入,仍立即把数值保存到原有待发缓冲,不持有浏览器+可复用的 Float32Array。测试覆盖输入不被修改、浏览器随后覆盖输入不影响待发音频。+worklet 微基准使用模拟端口,无真实音频线程调度,不能等同整机CPU下降7.3%。++文本提取保持大小写不敏感字段匹配、trim、最长字段选择和同长度首个字段优先,+不会改变送给用户的识别结果。典型基准中单次仅节省约0.9微秒,收益是更少中间分配与+计算,不应描述成可感知的毫秒级或秒级提速。++验证:85项定向回归测试通过,覆盖SAUC协议、文本提取、两种音频路径、空闲麦克风与+录音启动。未启动开发版,未做真实云端识别或麦克风实测。diff --git a/packages/voice-input-core/src/VoiceInputController.ts b/packages/voice-input-core/src/VoiceInputController.tsindex c8d29a2472..768a9bd645 100644--- a/packages/voice-input-core/src/VoiceInputController.ts+++ b/packages/voice-input-core/src/VoiceInputController.ts@@ -13,6 +13,7 @@ import type {VoiceInputTerminalOutcome,} from './types';import { VoiceTimelineLogger } from './VoiceTimelineLogger';+import { hasAdditionalSentence } from './pauseRefinement';type DictationRefiner = {refine(input: {@@ -30,6 +31,8 @@ type PendingRefinement = {latestPreview?: string;onPreview?: (text: string) => void;promise: Promise<{ result?: RefinementResult; error?: unknown }>;+ settled?: boolean;+ result?: RefinementResult;};type VoiceInputControllerOptions = {@@ -38,6 +41,8 @@ type VoiceInputControllerOptions = {logger: VoiceTimelineLogger;callbacks: VoiceInputCallbacks;stableWaitMs?: number;+ /** Host opt-in: refine during a speech pause and publish a live draft. */+ pauseRefinementEnabled?: boolean;};type CryptoWithUuid = {@@ -85,6 +90,11 @@ export class VoiceInputController {private readonly logger: VoiceTimelineLogger;private readonly callbacks: VoiceInputCallbacks;private readonly stableWaitMs: number;+ private readonly pauseRefinementEnabled: boolean;+ private lastSoundAt = 0;+ private lastTranscriptChangeAt = 0;+ private pauseRefinement?: PendingRefinement;+ private liveRefinementPreview?: { basedOnText: string; text: string };private state: VoiceInputState = 'idle';private runId = '';private startedAt = 0;@@ -95,8 +105,8 @@ export class VoiceInputController {// full aggregate transcript, so a partial arriving after a stable (the next// utterance already in progress) is strictly more complete. Preferring the// stable lane would drop that tail — exactly the loss this salvage exists to- // prevent. stop() keeps its own stable-first ordering: there the flush is what- // produces the authoritative final stable.+ // prevent. Stop waits for a new stable after a newer partial; an older stable+ // must never replace the tail while reusing a pause-time refinement.private latestTranscript = '';private latestTranscriptSource: 'partial' | 'stable' = 'partial';private firstPartialSeen = false;@@ -145,6 +155,7 @@ export class VoiceInputController {this.logger = options.logger;this.callbacks = options.callbacks;this.stableWaitMs = options.stableWaitMs ?? 500;+ this.pauseRefinementEnabled = options.pauseRefinementEnabled ?? false;this.asr.onEvent((event) => this.handleAsrEvent(event));}@@ -179,6 +190,10 @@ export class VoiceInputController {this.everSawAsrSignal = false;this.transcriptEmitted = false;this.submitCallbackThrew = false;+ this.lastSoundAt = performance.now();+ this.lastTranscriptChangeAt = performance.now();+ this.pauseRefinement = undefined;+ this.liveRefinementPreview = undefined;this.startStallWatchdog();this.setState('listening');this.logger.record({ type: 'start_clicked', runId: this.runId, at: Date.now() });@@ -204,7 +219,10 @@ export class VoiceInputController {});}const voiced = isChunkVoiced(chunk);- if (voiced) this.speechActivitySeen = true;+ if (voiced) {+ this.lastSoundAt = performance.now();+ this.speechActivitySeen = true;+ }if (typeof trace?.durationMs === 'number') {this.audioMsSinceLastSignal += trace.durationMs;if (voiced) {@@ -231,8 +249,8 @@ export class VoiceInputController {}const stable = await this.waitForStable(this.stableWaitMs);- const text = normalizeSubmittedText(stable || this.latestStable || this.latestPartial);- const source = stable || this.latestStable ? 'stable' : 'partial';+ const text = normalizeSubmittedText(stable || this.latestTranscript);+ const source = stable ? 'stable' : this.latestTranscriptSource;await this.asr.stop();@@ -263,16 +281,22 @@ export class VoiceInputController {return;}+ const readyResult = this.pauseRefinementEnabled && optimisticRefinement?.text === text+ ? optimisticRefinement.result : undefined;+ const readyText = readyResult?.accepted && readyResult.refinedText+ && normalizeSubmittedText(readyResult.basedOnText) === text+ ? readyResult.refinedText : undefined;const segment: SpeechSegment = {id: optimisticRefinement?.text === text ? optimisticRefinement.segmentIds[0] : createVoiceInputId(),source: 'mic',status: 'submitted',- text,+ text: readyText ?? text,+ ...(readyText ? { basedOnText: text } : {}),updatedAt: Date.now(),};let range: EditableRange | undefined;try {- range = this.callbacks.onSubmitted(text, segment);+ range = this.callbacks.onSubmitted(readyText ?? text, segment);} catch (error) {// salvageTranscript() already treats a throwing host as a real scenario// (destroyed window, torn-down editor); this path has to survive it too.@@ -347,6 +371,7 @@ export class VoiceInputController {break;case 'partial':if (this.state !== 'listening' && this.state !== 'submitting') return;+ if (event.text !== this.latestTranscript) this.lastTranscriptChangeAt = performance.now();this.latestPartial = event.text;this.latestTranscript = event.text;this.latestTranscriptSource = 'partial';@@ -366,6 +391,7 @@ export class VoiceInputController {break;case 'stable':if (this.state !== 'listening' && this.state !== 'submitting') return;+ if (event.text !== this.latestTranscript) this.lastTranscriptChangeAt = performance.now();this.latestStable = event.text;this.latestTranscript = event.text;this.latestTranscriptSource = 'stable';@@ -437,14 +463,23 @@ export class VoiceInputController {}private publishDraft(text: string, source: VoiceInputDraftSource): void {- const normalized = text.trim();+ let normalized = text.trim();if (!normalized) return;- const reason: VoiceInputDraftReason = source === 'stable' ? 'asr_stable' : 'asr_partial';+ const preview = this.liveRefinementPreview;+ const rawText = normalizeSubmittedText(text);+ if (preview && rawText.startsWith(preview.basedOnText)) {+ normalized = preview.text + rawText.slice(preview.basedOnText.length);+ source = 'refinement';+ }+ const reason: VoiceInputDraftReason = source === 'refinement'+ ? 'refinement_preview'+ : source === 'stable' ? 'asr_stable' : 'asr_partial';const segment: SpeechSegment = {id: `draft-${this.runId}`,source: 'mic',status: 'draft',text: normalized,+ ...(source === 'refinement' ? { basedOnText: rawText } : {}),updatedAt: Date.now(),};this.callbacks.onDraftChanged(normalized, segment, source);@@ -459,7 +494,9 @@ export class VoiceInputController {}private waitForStable(timeoutMs: number): Promise<string | undefined> {- if (this.latestStable) return Promise.resolve(this.latestStable);+ if (this.latestTranscriptSource === 'stable' && this.latestTranscript) {+ return Promise.resolve(this.latestTranscript);+ }return new Promise((resolve) => {const resolver = (text: string | undefined): void => {clearTimeout(timer);@@ -476,8 +513,12 @@ export class VoiceInputController {private startOptimisticRefinement(runId: string): PendingRefinement | undefined {if (!this.refiner) return undefined;- const text = normalizeSubmittedText(this.latestStable || this.latestPartial);+ const text = normalizeSubmittedText(this.latestTranscript);if (!text) return undefined;+ if (this.pauseRefinement?.text === text) return this.pauseRefinement;+ // A pause request already became stale, or the visible tail is still+ // provisional. Wait for final ASR text instead of speculating again.+ if (this.pauseRefinementEnabled && (this.pauseRefinement || this.latestTranscriptSource !== 'stable')) return undefined;// Stop-time ASR finalization can take close to a second. Start refinement// against the visible draft immediately, but only apply it if the final// ASR text matches. If the provider corrects or extends the text, we@@ -485,6 +526,28 @@ export class VoiceInputController {return this.startRefinementRequest(runId, text, [createVoiceInputId()]);}+ private maybeRefineDuringPause(): void {+ if (!this.pauseRefinementEnabled || !this.refiner || this.state !== 'listening') return;+ const now = performance.now();+ if (now - this.lastSoundAt < 2_000 || now - this.lastTranscriptChangeAt < 2_000) return;+ if (this.pauseRefinement && !this.pauseRefinement.settled) return;+ const text = normalizeSubmittedText(this.latestTranscript);+ if (!hasAdditionalSentence(this.pauseRefinement?.text ?? '', text)) return;+ const runId = this.runId;+ const request = this.startRefinementRequest(runId, text, [createVoiceInputId()]);+ this.pauseRefinement = request;+ void request.promise.then(({ result }) => {+ if (runId !== this.runId || this.state !== 'listening' || this.currentRunCancelled) return;+ if (this.pauseRefinement !== request || !result?.accepted || !result.refinedText) return;+ if (normalizeSubmittedText(result.basedOnText) !== request.text) return;+ // A newer ASR revision may correct the beginning. Never overlay a result+ // on a different source; if only a suffix grew, keep that new suffix.+ if (!normalizeSubmittedText(this.latestTranscript).startsWith(request.text)) return;+ this.liveRefinementPreview = { basedOnText: request.text, text: result.refinedText };+ this.publishDraft(this.latestTranscript, this.latestTranscriptSource);+ });+ }+private startRefinementRequest(runId: string, text: string, segmentIds: string[]): PendingRefinement {if (!this.refiner) throw new Error('Dictation refiner is not configured.');const refineStartedAt = performance.now();@@ -505,8 +568,8 @@ export class VoiceInputController {request.onPreview?.(partial);},}).then(- (result) => ({ result }),- (error: unknown) => ({ error }),+ (result) => { request.settled = true; request.result = result; return { result }; },+ (error: unknown) => { request.settled = true; return { error }; },);return request;}@@ -517,7 +580,9 @@ export class VoiceInputController {range: EditableRange,request: PendingRefinement,): Promise<void> {- this.attachRefinementPreview(runId, segment, range, request);+ // A completed result may already have been submitted atomically. Replaying+ // its earlier streaming preview would briefly replace it with older text.+ if (!request.settled) this.attachRefinementPreview(runId, segment, range, request);const { result, error } = await request.promise;if (runId !== this.runId) {this.discardRefinement(runId, request, 'stale_run');@@ -732,6 +797,7 @@ export class VoiceInputController {return;}if (this.networkRecoveryInFlight) return;+ this.maybeRefineDuringPause();const wallMs = performance.now() - this.lastAsrSignalAt;const audioMs = this.audioMsSinceLastSignal;diff --git a/packages/voice-input-core/src/__tests__/pauseRefinement.test.ts b/packages/voice-input-core/src/__tests__/pauseRefinement.test.tsnew file mode 100644index 0000000000..8747acd317--- /dev/null+++ b/packages/voice-input-core/src/__tests__/pauseRefinement.test.ts@@ -0,0 +1,339 @@+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";+import { VoiceInputController } from "../VoiceInputController";+import { VoiceTimelineLogger } from "../VoiceTimelineLogger";+import { hasAdditionalSentence } from "../pauseRefinement";+import type {+ AsrEvent,+ AsrProvider,+ RefinementResult,+ SpeechSegment,+} from "../types";++beforeEach(() => vi.useFakeTimers());+afterEach(() => {+ vi.clearAllTimers();+ vi.useRealTimers();+});++function setup(enabled = true) {+ let event: (value: AsrEvent) => void = () => {};+ const asr: AsrProvider = {+ start: vi.fn(async () => {}),+ stop: vi.fn(async () => {}),+ appendAudio: vi.fn(),+ flushAudio: vi.fn(async () => {}),+ onEvent: (listener) => {+ event = listener;+ },+ };+ const requests: Array<{+ text: string;+ resolve: (result: RefinementResult) => void;+ reject: (error: Error) => void;+ }> = [];+ const refine = vi.fn(+ (input: { text: string }) =>+ new Promise<RefinementResult>((resolve, reject) => {+ requests.push({ text: input.text, resolve, reject });+ }),+ );+ const drafts = vi.fn();+ const submitted = vi.fn((text: string, segment: SpeechSegment) => ({+ id: "range",+ segmentIds: [segment.id],+ startOffset: 0,+ endOffset: text.length,+ userTouched: false,+ }));+ const applied = vi.fn(() => true);+ const controller = new VoiceInputController({+ asr,+ refiner: { refine },+ logger: new VoiceTimelineLogger(),+ pauseRefinementEnabled: enabled,+ callbacks: {+ onDraftChanged: drafts,+ onSubmitted: submitted,+ applyRefinement: applied,+ },+ });+ const say = (text: string, type: "partial" | "stable" = "stable") =>+ event({ type, text, at: Date.now() });+ const finish = async (index: number, text: string) => {+ requests[index].resolve({+ accepted: true,+ basedOnText: requests[index].text,+ refinedText: text,+ sourceSegmentIds: [],+ elapsedMs: 100,+ });+ await vi.advanceTimersByTimeAsync(0);+ };+ return {+ asr,+ controller,+ refine,+ requests,+ drafts,+ submitted,+ applied,+ say,+ finish,+ };+}++describe("sentence growth", () => {+ it("allows one short sentence and an unpunctuated sentence completed by a pause", () => {+ expect(hasAdditionalSentence("", "好。")).toBe(true);+ expect(hasAdditionalSentence("", "帮我看看")).toBe(true);+ expect(hasAdditionalSentence("", "……")).toBe(false);+ });+ it("requires another sentence, not repeated text or a same-sentence revision", () => {+ expect(hasAdditionalSentence("第一句。", "第一句。")).toBe(false);+ expect(hasAdditionalSentence("第一句。", "修正的第一句。")).toBe(false);+ expect(hasAdditionalSentence("第一句", "第一句。")).toBe(false);+ expect(hasAdditionalSentence("第一句。", "第一句。第二句。")).toBe(true);+ expect(hasAdditionalSentence("Use 3.14.", "Use 3.14. Next sentence.")).toBe(+ true,+ );+ });+});++describe("pause refinement", () => {+ it("refines one sentence after two seconds and publishes immediately while still listening", async () => {+ const h = setup();+ await h.controller.start();+ h.say("帮我看看。");+ await vi.advanceTimersByTimeAsync(1999);+ expect(h.refine).not.toHaveBeenCalled();+ await vi.advanceTimersByTimeAsync(1);+ expect(h.refine).toHaveBeenCalledOnce();+ await h.finish(0, "帮我看一下。");+ expect(h.controller.currentState).toBe("listening");+ expect(h.drafts).toHaveBeenLastCalledWith(+ "帮我看一下。",+ expect.objectContaining({ basedOnText: "帮我看看。" }),+ "refinement",+ );+ expect(h.submitted).not.toHaveBeenCalled();+ await vi.advanceTimersByTimeAsync(10000);+ expect(h.refine).toHaveBeenCalledOnce();+ await h.controller.cancel();+ });++ it("waits for silence and unchanged text; repeated identical ASR events do not delay it", async () => {+ const h = setup();+ await h.controller.start();+ h.say("第一句。");+ await vi.advanceTimersByTimeAsync(1000);+ h.controller.appendAudio(new Int16Array(160).fill(512).buffer);+ await vi.advanceTimersByTimeAsync(1000);+ expect(h.refine).not.toHaveBeenCalled();+ h.say("第一句。");+ await vi.advanceTimersByTimeAsync(1000);+ expect(h.refine).toHaveBeenCalledOnce();+ await h.controller.cancel();+ });++ it("supports multiple pauses with at least a sentence added, without overlapping requests", async () => {+ const h = setup();+ await h.controller.start();+ h.say("第一句。");+ await vi.advanceTimersByTimeAsync(2000);+ h.say("第一句。第二句。");+ await vi.advanceTimersByTimeAsync(3000);+ expect(h.refine).toHaveBeenCalledOnce();+ await h.finish(0, "第一句话。");+ expect(h.drafts).toHaveBeenLastCalledWith(+ "第一句话。第二句。",+ expect.anything(),+ "refinement",+ );+ await vi.advanceTimersByTimeAsync(1000);+ expect(h.refine).toHaveBeenCalledTimes(2);+ await h.finish(1, "第一句话。第二句话。");+ h.say("第一句。第二句。第三句。");+ await vi.advanceTimersByTimeAsync(2000);+ expect(h.refine).toHaveBeenCalledTimes(3);+ expect(h.requests[2].text).toBe("第一句。第二句。第三句。");+ await h.controller.cancel();+ });++ it("does not overwrite revised ASR text with a stale result", async () => {+ const h = setup();+ await h.controller.start();+ h.say("去北京。");+ await vi.advanceTimersByTimeAsync(2000);+ h.say("去南京。");+ await h.finish(0, "去北京市。");+ expect(h.drafts).toHaveBeenLastCalledWith(+ "去南京。",+ expect.anything(),+ "stable",+ );+ await h.controller.cancel();+ });++ it("reuses a completed pause request at stop", async () => {+ const h = setup();+ await h.controller.start();+ h.say("第一句。");+ await vi.advanceTimersByTimeAsync(2000);+ await h.finish(0, "第一句话。");+ await h.controller.stop();+ await vi.advanceTimersByTimeAsync(0);+ expect(h.refine).toHaveBeenCalledOnce();+ expect(h.applied).toHaveBeenCalledWith(expect.anything(), "第一句话。");+ expect(h.submitted).toHaveBeenCalledExactlyOnceWith(+ "第一句话。",+ expect.objectContaining({ text: "第一句话。", basedOnText: "第一句。" }),+ );+ expect(h.controller.currentState).toBe("done");+ });++ it("reuses an in-flight pause request at stop", async () => {+ const h = setup();+ await h.controller.start();+ h.say("第一句。");+ await vi.advanceTimersByTimeAsync(2000);+ await h.controller.stop();+ expect(h.refine).toHaveBeenCalledOnce();+ await h.finish(0, "第一句话。");+ expect(h.applied).toHaveBeenCalledOnce();+ expect(h.controller.currentState).toBe("done");+ });++ it("does not reuse old text when the final ASR result changes", async () => {+ const h = setup();+ await h.controller.start();+ h.say("第一句。");+ await vi.advanceTimersByTimeAsync(2000);+ await h.finish(0, "第一句话。");+ h.asr.flushAudio = async () => {+ h.say("修正的第一句。");+ };+ await h.controller.stop();+ expect(h.refine).toHaveBeenCalledTimes(2);+ expect(h.requests[1].text).toBe("修正的第一句。");+ await h.finish(1, "修正后的第一句话。");+ expect(h.applied).toHaveBeenLastCalledWith(+ expect.anything(),+ "修正后的第一句话。",+ );+ });++ it("ignores late results after cancellation and restart", async () => {+ const h = setup();+ await h.controller.start();+ h.say("旧录音。");+ await vi.advanceTimersByTimeAsync(2000);+ await h.controller.cancel();+ await h.controller.start();+ h.say("新录音。");+ await h.finish(0, "旧的录音。");+ expect(h.drafts).toHaveBeenLastCalledWith(+ "新录音。",+ expect.anything(),+ "stable",+ );+ expect(h.controller.currentState).toBe("listening");+ await h.controller.cancel();+ });++ it("skips the intermediate stop request when text changes again during finalization", async () => {+ const h = setup();+ await h.controller.start();+ h.say("第一句。");+ await vi.advanceTimersByTimeAsync(2000);+ h.say("第一句。新尾句", "partial");+ let release!: () => void;+ h.asr.flushAudio = () =>+ new Promise<void>((resolve) => {+ release = resolve;+ });+ const stopping = h.controller.stop();+ expect(h.requests.map((r) => r.text)).toEqual(["第一句。"]);+ h.say("第一句。最终尾句。");+ release();+ await stopping;+ expect(h.requests.map((r) => r.text)).toEqual([+ "第一句。",+ "第一句。最终尾句。",+ ]);+ await h.finish(0, "旧结果。");+ expect(h.applied).not.toHaveBeenCalled();+ await h.finish(1, "完整结果。");+ expect(h.applied).toHaveBeenCalledExactlyOnceWith(+ expect.anything(),+ "完整结果。",+ );+ });++ it("reuses refinement that completes while ASR is flushing without reverting to raw text", async () => {+ const h = setup();+ await h.controller.start();+ h.say("第一句。");+ await vi.advanceTimersByTimeAsync(2000);+ let release!: () => void;+ h.asr.flushAudio = () =>+ new Promise<void>((resolve) => {+ release = resolve;+ });+ const stopping = h.controller.stop();+ await h.finish(0, "第一句话。");+ expect(h.submitted).not.toHaveBeenCalled();+ release();+ await stopping;+ await vi.advanceTimersByTimeAsync(0);+ expect(h.refine).toHaveBeenCalledOnce();+ expect(h.submitted).toHaveBeenCalledExactlyOnceWith(+ "第一句话。",+ expect.anything(),+ );+ expect(h.controller.currentState).toBe("done");+ });++ it("does not drop a newer partial tail in favor of an old stable sentence at stop", async () => {+ const h = setup();+ await h.controller.start();+ h.say("第一句。");+ await vi.advanceTimersByTimeAsync(2000);+ await h.finish(0, "第一句话。");+ h.say("第一句。还有新的尾句", "partial");+ const stopping = h.controller.stop();+ await vi.advanceTimersByTimeAsync(500);+ await stopping;+ expect(h.submitted).toHaveBeenCalledWith(+ "第一句。还有新的尾句",+ expect.anything(),+ );+ expect(h.requests[1].text).toBe("第一句。还有新的尾句");+ await h.finish(1, "第一句话。还有新的尾句。");+ expect(h.controller.currentState).toBe("done");+ });++ it("keeps raw text on failure without retrying unchanged text", async () => {+ const h = setup();+ await h.controller.start();+ h.say("第一句。");+ await vi.advanceTimersByTimeAsync(2000);+ h.requests[0].reject(new Error("offline"));+ await vi.advanceTimersByTimeAsync(3000);+ expect(h.refine).toHaveBeenCalledOnce();+ expect(h.drafts).toHaveBeenLastCalledWith(+ "第一句。",+ expect.anything(),+ "stable",+ );+ await h.controller.cancel();+ });++ it("does not enable paid speculative calls for hosts that have not opted in", async () => {+ const h = setup(false);+ await h.controller.start();+ h.say("第一句。");+ await vi.advanceTimersByTimeAsync(10000);+ expect(h.refine).not.toHaveBeenCalled();+ await h.controller.cancel();+ });+});diff --git a/packages/voice-input-core/src/pauseRefinement.ts b/packages/voice-input-core/src/pauseRefinement.tsnew file mode 100644index 0000000000..e02cf6b345--- /dev/null+++ b/packages/voice-input-core/src/pauseRefinement.ts@@ -0,0 +1,20 @@+// A pause may complete a sentence without ASR punctuation. Subsequent requests+// require another sentence, not a spelling/punctuation revision of the same one.+// This is intentionally conservative when the provider omits all punctuation.+function sentenceCount(text: string): number {+ return text+ .split(/[。!?!?]+|\.(?=\s|$)/u)+ .filter((part) => /[\p{L}\p{N}]/u.test(part)).length;+}++export function hasAdditionalSentence(+ previous: string,+ current: string,+): boolean {+ const contentLength = (text: string) =>+ (text.match(/[\p{L}\p{N}]/gu) ?? []).length;+ return (+ contentLength(current) > contentLength(previous) &&+ sentenceCount(current) > sentenceCount(previous)+ );+}diff --git a/packages/voice-input-core/src/types.ts b/packages/voice-input-core/src/types.tsindex 902066e394..5f01f669e3 100644--- a/packages/voice-input-core/src/types.ts+++ b/packages/voice-input-core/src/types.ts@@ -45,7 +45,7 @@ export type AsrEvent =export type VoiceInputDraftSource = 'partial' | 'stable' | 'refinement';-export type VoiceInputDraftReason = 'asr_partial' | 'asr_stable';+export type VoiceInputDraftReason = 'asr_partial' | 'asr_stable' | 'refinement_preview';export type AudioTrace = {capturedAt: number;diff --git a/scripts/voice-input-benchmark.mjs b/scripts/voice-input-benchmark.mjsindex f89da5496d..b212387f88 100644--- a/scripts/voice-input-benchmark.mjs+++ b/scripts/voice-input-benchmark.mjs@@ -983,14 +983,10 @@ async function runVolcengineSaucAsrIteration(spec, audio, opts, apiKey, iteratio// The initial full client request is auto-assigned sequence 1 by// Volcengine SAUC, so audio-only requests begin at 2.let sequence = 1;- let pendingFinalAudioChunk;const sendAudioChunk = (chunk) => {if (fatalError) return;- if (pendingFinalAudioChunk) {- sequence += 1;- ws.send(encodeVolcengineBenchmarkAudioOnlyRequest(pendingFinalAudioChunk, sequence));- }- pendingFinalAudioChunk = chunk;+ sequence += 1;+ ws.send(encodeVolcengineBenchmarkAudioOnlyRequest(chunk, sequence));};marks.audioStart = performance.now();await streamPcmAudio(pcm, spec.pcmSampleRate, opts.chunkMs, sendAudioChunk, true);@@ -1000,11 +996,6 @@ async function runVolcengineSaucAsrIteration(spec, audio, opts, apiKey, iteratioif (fatalError) throw fatalError;marks.tailSilenceFinished = performance.now();finalRequested = true;- if (pendingFinalAudioChunk) {- sequence += 1;- ws.send(encodeVolcengineBenchmarkAudioOnlyRequest(pendingFinalAudioChunk, sequence));- }- pendingFinalAudioChunk = undefined;// Match production VolcengineSaucAsrProvider: the last real audio chunk is// sent normally, then a short silence packet carries the negative final// sequence so the final marker does not cut off the spoken tail.diff --git a/scripts/voice-mute-benchmark.mjs b/scripts/voice-mute-benchmark.mjsnew file mode 100644index 0000000000..63cee2cb80--- /dev/null+++ b/scripts/voice-mute-benchmark.mjs@@ -0,0 +1,147 @@+#!/usr/bin/env node+// macOS only. Default is read-only; --apply briefly mutes/restores system output.+// No Electron instance, account, network connection, or microphone is used.+import { execFile as execFileCallback } from "node:child_process";+import { mkdtemp, rm } from "node:fs/promises";+import os from "node:os";+import path from "node:path";+import { fileURLToPath } from "node:url";+import { promisify } from "node:util";++if (process.platform !== "darwin")+ throw new Error("This benchmark requires macOS");+const execFile = promisify(execFileCallback);+const apply = process.argv.includes("--apply");+const temporary = await mkdtemp(path.join(os.tmpdir(), "cindy-voice-mute-ab-"));+const binary = path.join(temporary, "audio-helper");+const compiled = path.join(temporary, "mute.scpt");+const source = fileURLToPath(+ new URL(+ "../apps/desktop/native/voice-input/macos-audio-mute-helper.swift",+ import.meta.url,+ ),+);+const script = apply+ ? [+ "set wasMuted to output muted of (get volume settings)",+ "if wasMuted is false then set volume with output muted",+ "return wasMuted",+ ]+ : ["output muted of (get volume settings)"];+const scriptArgs = script.flatMap((line) => ["-e", line]);+async function timed(file, args) {+ const start = performance.now();+ const { stdout } = await execFile(file, args, { timeout: 5_000 });+ return { stdout: stdout.trim(), ms: performance.now() - start };+}+const readApple = () =>+ timed("/usr/bin/osascript", ["-e", "output muted of (get volume settings)"]);+const restoreApple = (muted) =>+ timed("/usr/bin/osascript", [+ "-e",+ `set volume ${muted ? "with" : "without"} output muted`,+ ]);+const median = (values) => {+ const sorted = [...values].sort((a, b) => a - b);+ return (+ (sorted[Math.floor((sorted.length - 1) / 2)] ++ sorted[Math.floor(sorted.length / 2)]) /+ 2+ );+};+let original;+let nativeOriginal;+try {+ await execFile("/usr/bin/xcrun", ["swiftc", source, "-o", binary], {+ timeout: 30_000,+ });+ await execFile("/usr/bin/osacompile", ["-o", compiled, ...scriptArgs], {+ timeout: 10_000,+ });+ original = (await readApple()).stdout === "true";+ const cold = await timed(binary, ["read"]);+ nativeOriginal = JSON.parse(cold.stdout);+ const rows = [];+ // Reverse each block to reduce order bias. All three variants get six runs.+ const order = Array.from({ length: 3 }, () => [+ "native",+ "apple",+ "compiled",+ "compiled",+ "apple",+ "native",+ ]).flat();+ for (const mode of order) {+ const result =+ mode === "native"+ ? await timed(binary, [apply ? "mute" : "read"])+ : await timed(+ "/usr/bin/osascript",+ mode === "compiled" ? [compiled] : scriptArgs,+ );+ let restoreMs;+ if (apply) {+ if ((await readApple()).stdout !== "true")+ throw new Error("Mute did not apply");+ const restored =+ mode === "native"+ ? await timed(binary, [+ "set",+ String(nativeOriginal.deviceId),+ nativeOriginal.deviceUID,+ String(original),+ ])+ : await restoreApple(original);+ restoreMs = restored.ms;+ if ((await readApple()).stdout !== String(original))+ throw new Error("Restore mismatch");+ }+ rows.push({+ mode,+ ms: result.ms,+ ...(restoreMs === undefined ? {} : { restoreMs }),+ });+ }+ console.log(+ JSON.stringify(+ {+ kind: apply ? "REAL_OUTPUT_MUTE_AB" : "READ_ONLY_AB",+ firstNativeProbeMs: cold.ms,+ // First launch of a new binary, not a reboot/OS-cache-cleared measurement.+ medians: Object.fromEntries(+ ["native", "apple", "compiled"].map((mode) => {+ const matching = rows.filter((row) => row.mode === mode);+ return [+ mode,+ {+ ms: median(matching.map((row) => row.ms)),+ ...(apply+ ? { restoreMs: median(matching.map((row) => row.restoreMs)) }+ : {}),+ },+ ];+ }),+ ),+ rows,+ },+ null,+ 2,+ ),+ );+} finally {+ try {+ if (apply && original !== undefined) {+ // Restore the original device first; fall back to the OS route on error.+ if (nativeOriginal) {+ await timed(binary, [+ "set",+ String(nativeOriginal.deviceId),+ nativeOriginal.deviceUID,+ String(original),+ ]).catch(() => restoreApple(original));+ } else await restoreApple(original);+ }+ } finally {+ await rm(temporary, { recursive: true, force: true });+ }+}diff --git a/scripts/voice-transport-benchmark.mjs b/scripts/voice-transport-benchmark.mjsnew file mode 100644index 0000000000..dc81f04b2f--- /dev/null+++ b/scripts/voice-transport-benchmark.mjs@@ -0,0 +1,81 @@+#!/usr/bin/env node+// Direct-network, unauthenticated probe. No ASR allocation, audio, or app launch.+// Usage: node scripts/voice-transport-benchmark.mjs wss://voice.cindy.app/api/voice/asr+import https from "node:https";+import WebSocket from "ws";++const target = new URL(process.argv[2]);+if (+ target.protocol !== "wss:" ||+ target.username ||+ target.password ||+ target.search+) {+ throw new Error("Expected a wss URL without credentials or query parameters");+}+const warmupUrl = new URL("/", target);+warmupUrl.protocol = "https:";+const rows = [];+for (const mode of ["cold", "warm", "warm", "cold", "cold", "warm"]) {+ const agent = new https.Agent({+ keepAlive: true,+ maxSockets: 2,+ maxFreeSockets: 1,+ });+ const row = { mode };+ try {+ if (mode === "warm") {+ const start = performance.now();+ await new Promise((resolve, reject) => {+ const request = https.request(+ warmupUrl,+ { method: "HEAD", agent },+ (response) => {+ response.resume();+ response.on("end", resolve);+ response.on("error", reject);+ },+ );+ const timer = setTimeout(+ () => request.destroy(new Error("Warmup timeout")),+ 8_000,+ );+ request.on("close", () => clearTimeout(timer));+ request.on("error", reject);+ request.end();+ });+ row.warmupMs = Math.round(performance.now() - start);+ }+ const start = performance.now();+ await new Promise((resolve, reject) => {+ let handled = false;+ const socket = new WebSocket(target, { agent, handshakeTimeout: 8_000 });+ socket.on("unexpected-response", (request, response) => {+ handled = true;+ row.status = response.statusCode;+ row.reusedSocket = request.reusedSocket;+ row.upgradeResponseMs = Math.round(performance.now() - start);+ // We only need headers; do not retain a response body or wait for it.+ response.destroy();+ socket.terminate();+ resolve();+ });+ socket.on("open", () => {+ handled = true;+ row.status = 101;+ row.upgradeResponseMs = Math.round(performance.now() - start);+ socket.terminate();+ resolve();+ });+ socket.on("error", (error) => {+ if (!handled) reject(error);+ });+ });+ rows.push(row);+ } finally {+ agent.destroy();+ }+}+console.log(+ JSON.stringify({ kind: "UNAUTHENTICATED_UPGRADE_NOT_ASR", rows }, null, 2),+);