Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
feat(desktop): add provider voice selection and TTS preview
JiangJiahao06ecd0998171
diff --git a/apps/desktop/src/main/voice-conversation/__tests__/ipc.test.ts b/apps/desktop/src/main/voice-conversation/__tests__/ipc.test.tsindex b539c2a3c3..da1d761cb5 100644--- a/apps/desktop/src/main/voice-conversation/__tests__/ipc.test.ts+++ b/apps/desktop/src/main/voice-conversation/__tests__/ipc.test.ts@@ -55,6 +55,7 @@ vi.mock('../../utility-model/oneShotCandidates.js', () => ({import { normalizeVoiceInputSettings } from '../../../shared/voiceInputData.js';import { registerVoiceConversationIpc } from '../index.js';+import { outboundFetch } from '../../maker-host/outbound-fetch.js';const sender = (id = 1) => ({ sender: { id, once: vi.fn() } });const call = (name: string, ...args: unknown[]) =>h.handlers.get(`voice-conversation:${name}`)!(sender(), ...args);@@ -64,6 +65,7 @@ beforeEach(() => {h.trusted.mockReset();h.append.mockReset();h.boundary = false;+ vi.mocked(outboundFetch).mockReset();let settings = normalizeVoiceInputSettings({});registerVoiceConversationIpc({getSettings: () => settings,@@ -85,6 +87,7 @@ beforeEach(() => {afterEach(async () => {h.trusted.mockReset();await call('end', 'call');+ await call('stop-preview', 'preview');});const start = () =>call('start', {@@ -101,6 +104,42 @@ it('rejects an untrusted sender before returning models or opening a connection'});await expect(call('models')).rejects.toThrow('untrusted frame');await expect(start()).rejects.toThrow('untrusted frame');+ for (const name of ['voices', 'preview', 'read-preview', 'stop-preview']) {+ await expect(call(name, {})).rejects.toThrow('untrusted frame');+ }+});++it('validates preview boundaries before synthesis and cleans up when its sender is destroyed', async () => {+ const input = {+ previewId: 'preview',+ botId: 'bot',+ sessionId: 'canonical',+ modelId: 'voice-test',+ voice: 'alloy',+ text: 'sample',+ };+ await expect(call('preview', { ...input, voice: 'bad\nvoice' })).rejects.toThrow();+ await expect(call('preview', { ...input, text: 'x'.repeat(257) })).rejects.toThrow();+ await expect(call('preview', { ...input, sessionId: 'another-task' })).rejects.toThrow();+ h.boundary = true;+ await expect(call('voices', { modelId: 'voice-test' })).rejects.toThrow();+ await expect(call('preview', input)).rejects.toThrow();+ h.boundary = false;+ expect(outboundFetch).not.toHaveBeenCalled();+ vi.mocked(outboundFetch).mockResolvedValue(+ new Response(new Uint8Array([1, 2]), { headers: { 'Content-Type': 'audio/pcm' } }),+ );+ const event = sender(3);+ await h.handlers.get('voice-conversation:preview')!(event, input);+ expect(h.append).not.toHaveBeenCalled();+ const destroyed = event.sender.once.mock.calls.find(([name]) => name === 'destroyed')?.[1] as+ (() => void) | undefined;+ expect(destroyed).toBeTypeOf('function');+ destroyed!();+ await expect(+ h.handlers.get('voice-conversation:read-preview')!(event, 'preview'),+ ).rejects.toThrow();+ await expect(start()).resolves.toEqual({ callId: 'call' });});it('enforces sender ownership and PCM size/alignment on the non-awaitable capture channel', async () => {diff --git a/apps/desktop/src/main/voice-conversation/__tests__/service.test.ts b/apps/desktop/src/main/voice-conversation/__tests__/service.test.tsindex 116d3a2a64..b4b0b82130 100644--- a/apps/desktop/src/main/voice-conversation/__tests__/service.test.ts+++ b/apps/desktop/src/main/voice-conversation/__tests__/service.test.ts@@ -5,6 +5,94 @@ import { hasVoiceConversationLease } from '../lease.js';const active: VoiceConversationService[] = [];afterEach(async () => {await Promise.all(active.splice(0).map((service) => service.end(1)));+ vi.useRealTimers();+});++const previewSelection = {+ previewId: 'preview-1',+ botId: 'bot',+ sessionId: 'canonical',+ modelId: 'tts',+ voice: 'alloy',+ text: 'voice sample',+};+describe('voice preview ownership', () => {+ it('synthesizes the exact selection without allocating ASR, and excludes concurrent calls', async () => {+ const { service, deps } = fixture();+ expect(await service.startPreview(1, previewSelection)).toEqual({ sampleRate: 24000 });+ expect(deps.assertCompanion).toHaveBeenCalledWith('bot', 'canonical');+ expect(deps.createProvider).not.toHaveBeenCalled();+ expect(deps.fetch).toHaveBeenCalledWith(+ new URL('https://gateway.test/v1/audio/speech'),+ expect.objectContaining({+ body: JSON.stringify({+ model: 'tts',+ voice: 'alloy',+ input: 'voice sample',+ response_format: 'pcm',+ }),+ }),+ );+ await expect(service.start(1, selection)).rejects.toThrow('busy');+ await expect(service.readPreview(2, 'preview-1')).rejects.toThrow('preview_ended');+ service.stopPreview(2, 'preview-1');+ expect(hasVoiceConversationLease()).toBe(true);+ expect((await service.readPreview(1, 'preview-1')).pcm.byteLength).toBe(2);+ service.stopPreview(1, 'preview-1');+ expect(hasVoiceConversationLease()).toBe(false);+ });++ it('cancels while companion authorization is pending without issuing a late paid request', async () => {+ const { service, deps } = fixture();+ let release!: () => void;+ deps.assertCompanion.mockReturnValueOnce(+ new Promise<void>((resolve) => {+ release = resolve;+ }),+ );+ const pending = service.startPreview(1, previewSelection);+ service.stopPreview(1, 'preview-1');+ release();+ await expect(pending).rejects.toThrow('preview_ended');+ expect(deps.fetch).not.toHaveBeenCalled();+ expect(hasVoiceConversationLease()).toBe(false);+ });++ it('checks eligibility and canonical ownership before preview execution', async () => {+ const { service, deps } = fixture();+ await expect(+ service.startPreview(1, { ...previewSelection, modelId: 'invented' }),+ ).rejects.toThrow('model_unavailable');+ deps.assertCompanion.mockRejectedValueOnce(new Error('not canonical'));+ await expect(service.startPreview(1, previewSelection)).rejects.toThrow('not canonical');+ deps.hasDictation.mockReturnValueOnce(true);+ await expect(service.startPreview(1, previewSelection)).rejects.toThrow('busy');+ expect(deps.fetch).not.toHaveBeenCalled();+ expect(hasVoiceConversationLease()).toBe(false);+ });++ it.each(['owner', 'connection'] as const)('releases playback on a changed %s', async (change) => {+ const { service, deps } = fixture();+ await service.startPreview(1, previewSelection);+ if (change === 'owner') deps.owner.mockReturnValue('owner-b');+ else+ deps.connection.mockImplementation(() => {+ throw new Error('model_unavailable');+ });+ await expect(service.readPreview(1, 'preview-1')).rejects.toThrow();+ expect(hasVoiceConversationLease()).toBe(false);+ });++ it('releases the lease on sender teardown and on the bounded preview deadline', async () => {+ vi.useFakeTimers();+ const { service } = fixture();+ await service.startPreview(1, previewSelection);+ await service.end(1);+ expect(hasVoiceConversationLease()).toBe(false);+ await service.startPreview(1, previewSelection);+ await vi.advanceTimersByTimeAsync(60_000);+ expect(hasVoiceConversationLease()).toBe(false);+ });});const selection = {callId: 'call-1',diff --git a/apps/desktop/src/main/voice-conversation/__tests__/voices.test.ts b/apps/desktop/src/main/voice-conversation/__tests__/voices.test.tsnew file mode 100644index 0000000000..a0e52114f5--- /dev/null+++ b/apps/desktop/src/main/voice-conversation/__tests__/voices.test.ts@@ -0,0 +1,183 @@+import { describe, expect, it, vi } from 'vitest';+import { loadSpeechVoices } from '../voices.js';+import { normalizeVoiceConversationSelection } from '../../../shared/voiceConversation.js';+import type { SpeechConnection } from '../speech.js';++const connection = (protocol: SpeechConnection['protocol']): SpeechConnection => ({+ baseUrl: 'https://provider.test/prefix/v1',+ protocol,+ headers:+ protocol === 'elevenlabs' ? { 'xi-api-key': 'test-key' } : { authorization: 'Bearer test-key' },+});+const json = (value: unknown) => new Response(JSON.stringify(value));++describe('provider voice catalogs', () => {+ it('supports real MiniMax IDs and keeps malformed IDs out of persisted selections', () => {+ for (const voice of [+ 'Chinese (Mandarin)_News_Anchor',+ 'Cantonese_ProfessionalHost (F)',+ 'my.voice:1',+ ]) {+ expect(normalizeVoiceConversationSelection({ modelId: 'tts', voice })?.voice).toBe(voice);+ }+ for (const voice of [+ '',+ ' '.repeat(3),+ '../voice',+ 'voice\\id',+ 'voice\nname',+ 'x'.repeat(129),+ ]) {+ expect(normalizeVoiceConversationSelection({ modelId: 'tts', voice })).toBeUndefined();+ }+ expect(normalizeVoiceConversationSelection({ modelId: 'tts', voice: ' alloy ' })?.voice).toBe(+ 'alloy',+ );+ });++ it('uses model-specific OpenAI references without inventing a network catalog or voices for unknown models', async () => {+ const fetcher = vi.fn();+ const full = await loadSpeechVoices(connection('openai'), 'gpt-4o-mini-tts', fetcher, () => {});+ expect(full.source).toBe('reference');+ expect(full.voices).toHaveLength(13);+ expect(full.voices.map((v) => v.id)).toContain('cedar');+ const legacy = await loadSpeechVoices(connection('openai'), 'tts-1-hd', fetcher, () => {});+ expect(legacy.voices).toHaveLength(9);+ expect(legacy.voices.map((v) => v.id)).not.toContain('cedar');+ expect(await loadSpeechVoices(connection('openai'), 'custom-tts', fetcher, () => {})).toEqual({+ source: 'manual',+ voices: [],+ });+ expect(fetcher).not.toHaveBeenCalled();+ });++ it('paginates ElevenLabs within the selected origin/prefix and preserves account voices regardless of high-quality labels', async () => {+ const fetcher = vi+ .fn<typeof fetch>()+ .mockResolvedValueOnce(+ json({+ voices: [+ { voice_id: 'one', name: 'First', high_quality_base_model_ids: ['different-model'] },+ { voice_id: 'bad/path', name: 'Invalid' },+ ],+ has_more: true,+ next_page_token: 'opaque + token',+ }),+ )+ .mockResolvedValueOnce(+ json({ voices: [{ voice_id: 'two', name: 'Second' }], has_more: false }),+ );+ const result = await loadSpeechVoices(connection('elevenlabs'), 'eleven_v3', fetcher, () => {});+ expect(result.voices).toEqual([+ { id: 'one', name: 'First' },+ { id: 'two', name: 'Second' },+ ]);+ expect(fetcher).toHaveBeenNthCalledWith(+ 1,+ 'https://provider.test/prefix/v2/voices?page_size=100',+ expect.objectContaining({+ method: 'GET',+ headers: { 'xi-api-key': 'test-key' },+ redirect: 'error',+ }),+ );+ expect(String(fetcher.mock.calls[1][0])).toContain('next_page_token=opaque+%2B+token');+ });++ it('reads MiniMax system, cloned and generated voices without persisting preview URLs', async () => {+ const fetcher = vi.fn<typeof fetch>().mockResolvedValue(+ json({+ base_resp: { status_code: 0 },+ system_voice: [{ voice_id: 'Chinese (Mandarin)_News_Anchor', voice_name: 'News Anchor' }],+ voice_cloning: [{ voice_id: 'clone-1', preview_url: 'https://untrusted.test' }],+ voice_generation: [{ voice_id: 'generated-1' }],+ }),+ );+ const result = await loadSpeechVoices(+ connection('minimax'),+ 'speech-2.8-hd',+ fetcher,+ () => {},+ );+ expect(result.voices).toEqual([+ { id: 'Chinese (Mandarin)_News_Anchor', name: 'News Anchor' },+ { id: 'clone-1', name: 'clone-1' },+ { id: 'generated-1', name: 'generated-1' },+ ]);+ expect(fetcher).toHaveBeenCalledWith(+ 'https://provider.test/prefix/v1/get_voice',+ expect.objectContaining({+ method: 'POST',+ body: JSON.stringify({ voice_type: 'all' }),+ redirect: 'error',+ }),+ );+ });++ it('rejects business errors, malformed pagination and oversized responses', async () => {+ await expect(+ loadSpeechVoices(+ connection('minimax'),+ 'tts',+ vi.fn().mockResolvedValue(+ json({+ base_resp: { status_code: 1004, status_msg: 'private diagnostic' },+ system_voice: [],+ }),+ ),+ () => {},+ ),+ ).rejects.toThrow('voice_catalog_unavailable');+ await expect(+ loadSpeechVoices(+ connection('elevenlabs'),+ 'tts',+ vi.fn().mockResolvedValue(+ json({+ voices: [],+ has_more: true,+ }),+ ),+ () => {},+ ),+ ).rejects.toThrow('invalid_voice_pagination');+ await expect(+ loadSpeechVoices(+ connection('elevenlabs'),+ 'tts',+ vi.fn().mockResolvedValue(new Response(' '.repeat(2 * 1024 * 1024 + 1))),+ () => {},+ ),+ ).rejects.toThrow('voice_catalog_too_large');+ });++ it('rechecks the connection before returning a private voice list', async () => {+ let current = true;+ const fetcher = vi.fn(async () => {+ current = false;+ return json({ voices: [{ voice_id: 'private', name: 'Private' }] });+ });+ await expect(+ loadSpeechVoices(connection('elevenlabs'), 'tts', fetcher, () => {+ if (!current) throw new Error('changed');+ }),+ ).rejects.toThrow('changed');+ });++ it('cancels a stalled catalog body at the total deadline', async () => {+ vi.useFakeTimers();+ const cancelled = vi.fn();+ try {+ const fetcher = vi+ .fn<typeof fetch>()+ .mockResolvedValue(new Response(new ReadableStream({ cancel: cancelled })));+ const pending = loadSpeechVoices(connection('elevenlabs'), 'tts', fetcher, () => {});+ const rejected = expect(pending).rejects.toThrow();+ await vi.advanceTimersByTimeAsync(15_000);+ await rejected;+ expect(cancelled).toHaveBeenCalledOnce();+ } finally {+ vi.useRealTimers();+ }+ });+});diff --git a/apps/desktop/src/main/voice-conversation/index.ts b/apps/desktop/src/main/voice-conversation/index.tsindex cd60230069..72ba61cf89 100644--- a/apps/desktop/src/main/voice-conversation/index.ts+++ b/apps/desktop/src/main/voice-conversation/index.ts@@ -2,6 +2,7 @@ import { ipcMain, webContents, type IpcMainInvokeEvent } from 'electron';import type { AsrProvider } from '@cindy/voice-input-core';import {normalizeVoiceConversationSelection,+ normalizeSpeechModelSelection,type VoiceConversationPreference,} from '../../shared/voiceConversation.js';import { getActiveCatalog } from '../maker-host/active-catalog.js';@@ -62,6 +63,15 @@ export function registerVoiceConversationIpc(deps: {},});const observed = new Set<number>();+ const observe = (event: IpcMainInvokeEvent): void => {+ if (observed.has(event.sender.id)) return;+ const sender = event.sender.id;+ observed.add(sender);+ event.sender.once('destroyed', () => {+ observed.delete(sender);+ void service.end(sender);+ });+ };const handle = (name: string,action: (event: IpcMainInvokeEvent, ...args: unknown[]) => unknown,@@ -76,6 +86,31 @@ export function registerVoiceConversationIpc(deps: {});};handle('models', () => service.models());+ handle('voices', (_event, raw) => {+ const selection = normalizeSpeechModelSelection(raw);+ if (!selection) throwIpcError('INVALID_PARAMS', 'Invalid speech model');+ return service.voices(selection);+ });+ handle('preview', (event, raw) => {+ if (isAppSessionBoundaryPending()) throw new Error('changing_account');+ const value = requireObject(raw);+ const selection = normalizeVoiceConversationSelection(value);+ if (!selection) throwIpcError('INVALID_PARAMS', 'Invalid speech selection');+ observe(event);+ return service.startPreview(event.sender.id, {+ ...selection,+ previewId: boundedString(value.previewId, 'previewId', 64),+ botId: boundedString(value.botId, 'botId', 256),+ sessionId: boundedString(value.sessionId, 'sessionId', 256),+ text: boundedString(value.text, 'text', 256),+ });+ });+ handle('read-preview', (event, id) =>+ service.readPreview(event.sender.id, boundedString(id, 'previewId', 64)),+ );+ handle('stop-preview', (event, id) =>+ service.stopPreview(event.sender.id, boundedString(id, 'previewId', 64)),+ );const preferenceBot = async (raw: unknown,action: (botId: string) => VoiceConversationPreference,@@ -104,14 +139,7 @@ export function registerVoiceConversationIpc(deps: {const value = requireObject(raw);const selection = normalizeVoiceConversationSelection(value);if (!selection) throwIpcError('INVALID_PARAMS', 'Invalid speech selection');- if (!observed.has(event.sender.id)) {- observed.add(event.sender.id);- const sender = event.sender.id;- event.sender.once('destroyed', () => {- observed.delete(sender);- void service.end(sender);- });- }+ observe(event);return service.start(event.sender.id, {...selection,callId: boundedString(value.callId, 'callId', 64),diff --git a/apps/desktop/src/main/voice-conversation/models.ts b/apps/desktop/src/main/voice-conversation/models.tsindex e7f7c44d6f..ddaec1591f 100644--- a/apps/desktop/src/main/voice-conversation/models.ts+++ b/apps/desktop/src/main/voice-conversation/models.ts@@ -10,8 +10,10 @@ import {voiceModelKey,type SpeechProtocol,type VoiceConversationModel,+ type SpeechModelSelection,type VoiceConversationSelection,} from '../../shared/voiceConversation.js';+import { referenceSpeechVoices } from '../../shared/speechVoices.js';import type { SpeechConnection } from './speech.js';export type SpeechCatalogDeps = {@@ -85,7 +87,7 @@ function endpointProtocol(base: URL): SpeechProtocol | null {return null;}-function bindings(deps: SpeechCatalogDeps, selection?: VoiceConversationSelection): Binding[] {+function bindings(deps: SpeechCatalogDeps, selection?: SpeechModelSelection): Binding[] {const result: Binding[] = [];for (const provider of deps.catalog.providers) {if (selection && provider.id !== (selection.providerId ?? 'xd')) continue;@@ -115,7 +117,7 @@ function bindings(deps: SpeechCatalogDeps, selection?: VoiceConversationSelectioproviderId: 'xd',providerName: provider.name,protocol: 'openai',- defaultVoice: 'alloy',+ defaultVoice: referenceSpeechVoices(media.id, 'openai')[0] ?? '',},connection: {baseUrl: connection.baseUrl,@@ -187,7 +189,7 @@ function bindings(deps: SpeechCatalogDeps, selection?: VoiceConversationSelectioproviderName: provider.name,agent,protocol: detectedProtocol ?? undefined,- defaultVoice: protocol === 'openai' ? 'alloy' : '',+ defaultVoice: referenceSpeechVoices(media.id, protocol ?? undefined)[0] ?? '',},connection: protocol? { baseUrl: base.toString().replace(/\/+$/, ''), headers, protocol }@@ -204,7 +206,7 @@ export function speechModels(deps: SpeechCatalogDeps): VoiceConversationModel[]}export function resolveSpeechConnection(deps: SpeechCatalogDeps,- selection: VoiceConversationSelection,+ selection: SpeechModelSelection | VoiceConversationSelection,): SpeechConnection {const binding = bindings(deps, selection).find((entry) => voiceModelKey(entry.model) === voiceModelKey(selection),diff --git a/apps/desktop/src/main/voice-conversation/service.ts b/apps/desktop/src/main/voice-conversation/service.tsindex c6a9203f83..a6e1ca4988 100644--- a/apps/desktop/src/main/voice-conversation/service.ts+++ b/apps/desktop/src/main/voice-conversation/service.ts@@ -1,5 +1,10 @@import { VoiceConversationInput, type AsrProvider, type AudioTrace } from '@cindy/voice-input-core';-import { voiceModelKey, type VoiceConversationSelection } from '../../shared/voiceConversation.js';+import {+ voiceModelKey,+ type SpeechModelSelection,+ type SpeechPreviewStart,+ type SpeechVoiceCatalog,+} from '../../shared/voiceConversation.js';import type {VoiceConversationEvent,VoiceConversationModel,@@ -7,6 +12,7 @@ import type {} from '../../shared/voiceConversation.js';import { acquireVoiceConversationLease, releaseVoiceConversationLease } from './lease.js';import { SpeechSynthesisSession, type SpeechConnection } from './speech.js';+import { loadSpeechVoices } from './voices.js';type Call = {id: string;@@ -16,10 +22,18 @@ type Call = {speech: SpeechSynthesisSession;selection: VoiceConversationStart;};+type Preview = {+ id: string;+ sender: number;+ owner: string;+ speech: SpeechSynthesisSession;+ timer?: ReturnType<typeof setTimeout>;+};/** One local call owns the microphone. Cancellation invalidates all pending starts and audio reads. */export class VoiceConversationService {private call: Call | null = null;+ private preview: Preview | null = null;constructor(private readonly deps: {@@ -28,7 +42,7 @@ export class VoiceConversationService {assertCompanion(botId: string, sessionId: string): Promise<void>;models(): VoiceConversationModel[];createProvider(): Promise<AsrProvider>;- connection(selection: VoiceConversationSelection): SpeechConnection;+ connection(selection: SpeechModelSelection): SpeechConnection;fetch: typeof fetch;emit(sender: number, event: VoiceConversationEvent): void;},@@ -38,8 +52,89 @@ export class VoiceConversationService {return this.deps.models();}+ async voices(selection: SpeechModelSelection): Promise<SpeechVoiceCatalog> {+ const owner = this.deps.owner();+ const connection = this.deps.connection(selection);+ const identity = JSON.stringify(connection);+ return loadSpeechVoices(connection, selection.modelId, this.deps.fetch, () => {+ if (+ this.deps.owner() !== owner ||+ JSON.stringify(this.deps.connection(selection)) !== identity+ )+ throw new Error('connection_changed');+ });+ }++ /** Preview uses the exact synthesis adapter without starting ASR or submitting a task. */+ async startPreview(+ sender: number,+ selection: SpeechPreviewStart,+ ): Promise<{ sampleRate: number }> {+ if (this.call || this.preview || this.deps.hasDictation()) throw new Error('busy');+ if (!this.models().some((model) => voiceModelKey(model) === voiceModelKey(selection)))+ throw new Error('model_unavailable');+ const binding = this.deps.connection(selection);+ const identity = JSON.stringify(binding);+ const owner = this.deps.owner();+ if (!acquireVoiceConversationLease(selection.previewId)) throw new Error('busy');+ const preview: Preview = {+ id: selection.previewId,+ sender,+ owner,+ speech: new SpeechSynthesisSession({+ connection: () => binding,+ fetch: this.deps.fetch,+ assertCurrent: () => {+ if (+ this.preview !== preview ||+ this.deps.owner() !== owner ||+ JSON.stringify(this.deps.connection(selection)) !== identity+ )+ throw new Error('preview_ended');+ },+ }),+ };+ this.preview = preview;+ // A crashed/hidden renderer must not retain the global voice lease indefinitely.+ preview.timer = setTimeout(() => this.stopPreview(sender, preview.id), 60_000);+ try {+ await this.deps.assertCompanion(selection.botId, selection.sessionId);+ return await preview.speech.start({+ requestId: preview.id,+ modelId: selection.modelId,+ voice: selection.voice,+ text: selection.text,+ });+ } catch (error) {+ if (this.preview === preview) this.stopPreview(sender, preview.id);+ throw error;+ }+ }++ async readPreview(sender: number, id: string): Promise<{ pcm: ArrayBuffer; done: boolean }> {+ const preview = this.preview;+ if (!preview || preview.sender !== sender || preview.id !== id)+ throw new Error('preview_ended');+ try {+ if (preview.owner !== this.deps.owner()) throw new Error('preview_ended');+ return await preview.speech.read(id);+ } catch (error) {+ if (this.preview === preview) this.stopPreview(sender, id);+ throw error;+ }+ }++ stopPreview(sender: number, id?: string): void {+ const preview = this.preview;+ if (!preview || preview.sender !== sender || (id && preview.id !== id)) return;+ this.preview = null;+ clearTimeout(preview.timer);+ preview.speech.cancel();+ releaseVoiceConversationLease(preview.id);+ }+async start(sender: number, selection: VoiceConversationStart): Promise<{ callId: string }> {- if (this.call || this.deps.hasDictation()) throw new Error('busy');+ if (this.call || this.preview || this.deps.hasDictation()) throw new Error('busy');if (!this.models().some((model) => voiceModelKey(model) === voiceModelKey(selection)))throw new Error('model_unavailable');const binding = this.deps.connection(selection);@@ -124,6 +219,7 @@ export class VoiceConversationService {}async end(sender: number, id?: string): Promise<void> {+ if (!id) this.stopPreview(sender);const call = this.call;if (!call || call.sender !== sender || (id && call.id !== id)) return;this.call = null;diff --git a/apps/desktop/src/main/voice-conversation/voices.ts b/apps/desktop/src/main/voice-conversation/voices.tsnew file mode 100644index 0000000000..dcd84d766d--- /dev/null+++ b/apps/desktop/src/main/voice-conversation/voices.ts@@ -0,0 +1,134 @@+import {+ normalizeSpeechVoiceId,+ type SpeechVoiceCatalog,+ type SpeechVoice,+} from '../../shared/voiceConversation.js';+import { referenceSpeechVoices } from '../../shared/speechVoices.js';+import type { SpeechConnection } from './speech.js';++type RecordValue = Record<string, unknown>;+const record = (value: unknown): RecordValue =>+ value && typeof value === 'object' && !Array.isArray(value) ? (value as RecordValue) : {};++async function readJson(response: Response, signal: AbortSignal): Promise<RecordValue> {+ if (!response.ok || !response.body) {+ await response.body?.cancel();+ throw new Error('voice_catalog_unavailable');+ }+ const reader = response.body.getReader();+ const abort = (): void => {+ void reader.cancel().catch(() => undefined);+ };+ signal.addEventListener('abort', abort, { once: true });+ const decoder = new TextDecoder();+ let text = '';+ let size = 0;+ try {+ while (true) {+ signal.throwIfAborted();+ const chunk = await reader.read();+ signal.throwIfAborted();+ if (chunk.done) break;+ size += chunk.value.byteLength;+ if (size > 2 * 1024 * 1024) throw new Error('voice_catalog_too_large');+ text += decoder.decode(chunk.value, { stream: true });+ }+ return record(JSON.parse(text + decoder.decode()));+ } finally {+ signal.removeEventListener('abort', abort);+ await reader.cancel().catch(() => undefined);+ }+}++/** Account-owned lists stay in memory, never in the public model Registry or user settings.+ * No universal OpenAI /voices endpoint exists. A catalog entry is not execution proof;+ * in particular ElevenLabs high_quality_base_model_ids is not an availability allowlist.+ */+export async function loadSpeechVoices(+ connection: SpeechConnection,+ modelId: string,+ fetcher: typeof fetch,+ assertCurrent: () => void,+): Promise<SpeechVoiceCatalog> {+ assertCurrent();+ if (connection.protocol === 'openai') {+ const voices = referenceSpeechVoices(modelId, connection.protocol).map((id) => ({+ id,+ name: id,+ }));+ return { source: voices.length ? 'reference' : 'manual', voices };+ }+ const controller = new AbortController();+ const timer = setTimeout(() => controller.abort(), 15_000);+ const voices = new Map<string, SpeechVoice>();+ const append = (raw: unknown, nameKey: string): void => {+ const entry = record(raw);+ const id = normalizeSpeechVoiceId(entry.voice_id);+ if (!id) return;+ const name = typeof entry[nameKey] === 'string' ? entry[nameKey].trim().slice(0, 256) : '';+ if (voices.size < 1000) voices.set(id, { id, name: name || id });+ };+ const request = async (url: URL, body?: unknown): Promise<RecordValue> => {+ assertCurrent();+ const response = await fetcher(url.toString(), {+ method: body ? 'POST' : 'GET',+ headers: { ...connection.headers, ...(body ? { 'content-type': 'application/json' } : {}) },+ ...(body ? { body: JSON.stringify(body) } : {}),+ redirect: 'error',+ signal: controller.signal,+ });+ const json = await readJson(response, controller.signal);+ assertCurrent();+ return json;+ };+ try {+ const base = connection.baseUrl.replace(/\/+$/, '');+ if (connection.protocol === 'minimax') {+ // https://platform.minimax.io/docs/api-reference/voice-management-get+ const json = await request(new URL(`${base}/get_voice`), { voice_type: 'all' });+ if (record(json.base_resp).status_code !== 0) throw new Error('voice_catalog_unavailable');+ let count = 0;+ for (const key of ['system_voice', 'voice_cloning', 'voice_generation']) {+ const entries = json[key];+ if (entries !== undefined && !Array.isArray(entries))+ throw new Error('invalid_voice_catalog');+ if (Array.isArray(entries)) {+ count += entries.length;+ entries.forEach((entry) => append(entry, 'voice_name'));+ }+ }+ return { source: 'provider', voices: [...voices.values()], truncated: count > 1000 };+ }+ // https://elevenlabs.io/docs/api-reference/voices/search+ // Preserve a custom proxy prefix and origin. Unversioned proxies can expose the+ // legacy /voices route; failure falls back to manual entry in the UI.+ const paginated = /\/v1$/.test(base);+ const url = new URL(paginated ? `${base.slice(0, -3)}/v2/voices` : `${base}/voices`);+ if (paginated) url.searchParams.set('page_size', '100');+ const tokens = new Set<string>();+ for (let page = 0; page < 10; page += 1) {+ const json = await request(url);+ if (!Array.isArray(json.voices)) throw new Error('invalid_voice_catalog');+ json.voices.forEach((entry) => append(entry, 'name'));+ if (json.has_more !== true)+ return {+ source: 'provider',+ voices: [...voices.values()],+ truncated: json.voices.length > 1000,+ };+ if (!paginated || voices.size >= 1000) break;+ if (+ typeof json.next_page_token !== 'string' ||+ !json.next_page_token ||+ tokens.has(json.next_page_token)+ )+ throw new Error('invalid_voice_pagination');+ tokens.add(json.next_page_token);+ url.searchParams.set('next_page_token', json.next_page_token);+ }+ return { source: 'provider', voices: [...voices.values()], truncated: true };+ } finally {+ clearTimeout(timer);+ controller.abort();+ }+}diff --git a/apps/desktop/src/preload/preload.ts b/apps/desktop/src/preload/preload.tsindex f230326cdb..23943e6f0f 100644--- a/apps/desktop/src/preload/preload.ts+++ b/apps/desktop/src/preload/preload.ts@@ -1595,6 +1595,10 @@ contextBridge.exposeInMainWorld('electronAPI', {},voiceConversation: {models: () => ipcRenderer.invoke('voice-conversation:models'),+ voices: (selection) => ipcRenderer.invoke('voice-conversation:voices', selection),+ preview: (input) => ipcRenderer.invoke('voice-conversation:preview', input),+ readPreview: (previewId) => ipcRenderer.invoke('voice-conversation:read-preview', previewId),+ stopPreview: (previewId) => ipcRenderer.invoke('voice-conversation:stop-preview', previewId),preference: (botId) => ipcRenderer.invoke('voice-conversation:preference', botId),setPreference: (botId, selection) => ipcRenderer.invoke('voice-conversation:set-preference', botId, selection),start: (input) => ipcRenderer.invoke('voice-conversation:start', input),diff --git a/apps/desktop/src/renderer/features/bots/voice/CompanionVoicePanel.tsx b/apps/desktop/src/renderer/features/bots/voice/CompanionVoicePanel.tsxindex 53352c868d..9fb9b8bb34 100644--- a/apps/desktop/src/renderer/features/bots/voice/CompanionVoicePanel.tsx+++ b/apps/desktop/src/renderer/features/bots/voice/CompanionVoicePanel.tsx@@ -10,7 +10,6 @@ import {import { AudioLines, Mic, MicOff, PhoneOff, RefreshCw, Send, VolumeX, X } from 'lucide-react';import { useTranslation } from 'react-i18next';import { Button } from '@/components/ui/button';-import { Input } from '@/components/ui/input';import { FormField } from '@/components/ui/form-field';import { Select } from '@/components/ui/select';import { getDataOwnerGeneration } from '@/contexts/dataOwnerGeneration';@@ -24,10 +23,13 @@ import type {VoiceConversationSelection,} from '@/../shared/voiceConversation';import { normalizeVoiceConversationSelection, voiceModelKey } from '@/../shared/voiceConversation';+import { referenceSpeechVoices } from '@/../shared/speechVoices';import { BotAvatar } from '../BotAvatar';import type { BotChatIdentity } from '../BotSessionContentHeader';import { VoiceConversationController } from './VoiceConversationController';import { PcmSpeechPlayer } from './PcmSpeechPlayer';+import { VoicePreviewController } from './VoicePreviewController';+import { SpeechVoicePicker } from './SpeechVoicePicker';import './voiceConversation.css';type Props = {@@ -42,7 +44,6 @@ type Props = {export function CompanionVoicePanel(props: Props) {const { t } = useTranslation();const labelId = useId();- const voiceId = useId();const latest = useRef(props);latest.current = props;const titleRef = useRef<HTMLHeadingElement>(null);@@ -55,6 +56,8 @@ export function CompanionVoicePanel(props: Props) {const [preferenceOwner, setPreferenceOwner] = useState<string>();const [preferenceError, setPreferenceError] = useState(false);const [saving, setSaving] = useState(false);+ const [starting, setStarting] = useState(false);+ const startingRef = useRef(false);const dirty = useRef(false);const pendingSave = useRef<Promise<boolean> | null>(null);const ready = preferenceOwner === props.bot.id;@@ -62,7 +65,7 @@ export function CompanionVoicePanel(props: Props) {? models.find((model) => voiceModelKey(model) === voiceModelKey(preference)): models[0];const validModel = !!selectedModel;- const selectedVoice = voice ?? preference?.voice ?? selectedModel?.defaultVoice ?? 'alloy';+ const selectedVoice = voice ?? preference?.voice ?? selectedModel?.defaultVoice ?? '';const selection = normalizeVoiceConversationSelection({providerId: selectedModel?.providerId,agent: selectedModel?.agent,@@ -99,6 +102,16 @@ export function CompanionVoicePanel(props: Props) {}),[props.bot.id, props.sessionId],);+ const preview = useMemo(+ () =>+ new VoicePreviewController({+ api: window.electronAPI.voiceConversation,+ botId: props.bot.id,+ sessionId: props.sessionId,+ player: () => new PcmSpeechPlayer(() => undefined),+ }),+ [props.bot.id, props.sessionId],+ );const state = useSyncExternalStore(controller.subscribe, controller.getSnapshot);const active = ['connecting', 'listening', 'thinking', 'preparing', 'speaking'].includes(state.phase,@@ -153,9 +166,13 @@ export function CompanionVoicePanel(props: Props) {++refreshVersion.current;++preferenceVersion.current;controller.end();+ void preview.stop();};- }, [controller, loadPreference, refresh]);- useEffect(() => controller.setBlocked(props.blocked), [controller, props.blocked]);+ }, [controller, preview, loadPreference, refresh]);+ useEffect(() => {+ controller.setBlocked(props.blocked);+ if (props.blocked) void preview.stop();+ }, [controller, preview, props.blocked]);useEffect(() => controller.updateMessages(props.messages), [controller, props.messages]);useEffect(() => {const initialOwner = getDataOwnerGeneration();@@ -164,18 +181,25 @@ export function CompanionVoicePanel(props: Props) {const key = `${next.dataOwnerId}:${next.ownerGeneration}`;if (next.ownerBoundaryPending || key !== owner) {controller.end();+ void preview.stop();latest.current.onClose();}owner = key;});- const removePower = window.electronAPI.voiceInput.onPowerStateChange(() =>- controller.setBlocked(true),- );+ const removePower = window.electronAPI.voiceInput.onPowerStateChange(() => {+ controller.setBlocked(true);+ void preview.stop();+ });+ const hidden = () => {+ if (document.hidden) void preview.stop();+ };+ document.addEventListener('visibilitychange', hidden);return () => {removeAuth();removePower();+ document.removeEventListener('visibilitychange', hidden);};- }, [controller]);+ }, [controller, preview]);const persist = (next: VoiceConversationSelection | null): Promise<boolean> => {if (pendingSave.current) return pendingSave.current;@@ -206,13 +230,23 @@ export function CompanionVoicePanel(props: Props) {return pending;};const start = async () => {- if (!selection || !validModel || !protocol || props.blocked || !ready) return;+ if (startingRef.current || !selection || !validModel || !protocol || props.blocked || !ready)+ return;+ startingRef.current = true;+ setStarting(true);const version = preferenceVersion.current;- if (dirty.current && !(await persist(selection))) return;- if (version !== preferenceVersion.current || latest.current.blocked) return;- controller.setBlocked(false);- await controller.start(selection);- controller.retryUnsent();+ try {+ await preview.stop();+ if (version !== preferenceVersion.current || latest.current.blocked) return;+ if (dirty.current && !(await persist(selection))) return;+ if (version !== preferenceVersion.current || latest.current.blocked) return;+ controller.setBlocked(false);+ await controller.start(selection);+ controller.retryUnsent();+ } finally {+ startingRef.current = false;+ if (version === preferenceVersion.current) setStarting(false);+ }};const chooseModel = (key: string) => {const model = models.find((item) => voiceModelKey(item) === key);@@ -221,11 +255,10 @@ export function CompanionVoicePanel(props: Props) {providerId: model.providerId,agent: model.agent,modelId: model.id,- voice:- model.providerId === selectedModel?.providerId && model.protocol === selectedModel?.protocol- ? selectedVoice- : (model.defaultVoice ?? 'alloy'),+ // Voice compatibility is model-specific, even within the same connection/protocol.+ voice: model.defaultVoice ?? '',};+ void preview.stop();dirty.current = true;setCustomized(true);setPreference(next);@@ -319,43 +352,44 @@ export function CompanionVoicePanel(props: Props) {{t(catalogError ? 'bots.voiceMode.catalogError' : 'bots.voiceMode.noModels')}</p>) : null}- <FormField label={t('bots.voiceMode.model')}>- {(control) => (- <div className="flex items-center gap-2">- <Select- {...control}- label={t('bots.voiceMode.model')}- value={selectedModel ? voiceModelKey(selectedModel) : ''}- options={models.map((model) => ({- value: voiceModelKey(model),- label: [model.name, model.providerName].filter(Boolean).join(' · '),- }))}- onValueChange={chooseModel}- disabled={loading || !ready || saving || models.length === 0}- className="flex-1"- />- <Button- variant="secondary"- size="lg"- disabled={loading}- aria-label={t('bots.voiceMode.refresh')}- title={t('bots.voiceMode.refresh')}- onClick={() => {- void refresh(true);- if (!ready) loadPreference();- }}- >- <RefreshCw size={15} />- </Button>- </div>- )}- </FormField>- {!validModel && preference && models.length > 0 ? (- <p className="text-12 text-[var(--text-secondary)]">- {t('bots.voiceMode.modelUnavailable')}- </p>- ) : null}<div className="flex flex-wrap items-start gap-3">+ <FormField label={t('bots.voiceMode.model')} className="min-w-52 flex-[2]">+ {(control) => (+ <div className="flex items-center gap-2">+ <Select+ {...control}+ label={t('bots.voiceMode.model')}+ value={selectedModel ? voiceModelKey(selectedModel) : ''}+ options={models.map((model) => ({+ value: voiceModelKey(model),+ label: [model.name, model.providerName].filter(Boolean).join(' · '),+ }))}+ onValueChange={chooseModel}+ disabled={loading || !ready || saving || starting || models.length === 0}+ className="flex-1"+ />+ <Button+ variant="secondary"+ size="lg"+ className="w-9 shrink-0 px-0"+ disabled={loading || starting}+ aria-label={t('bots.voiceMode.refresh')}+ title={t('bots.voiceMode.refresh')}+ onClick={() => {+ void refresh(true);+ if (!ready) loadPreference();+ }}+ >+ <RefreshCw size={15} />+ </Button>+ </div>+ )}+ </FormField>+ {!validModel && preference && models.length > 0 ? (+ <p className="w-full text-12 text-[var(--text-secondary)]">+ {t('bots.voiceMode.modelUnavailable')}+ </p>+ ) : null}{selectedModel && selectedModel.providerId !== 'xd' && selectedModel.agent ? (<FormFieldlabel={t('bots.voiceMode.protocol')}@@ -372,15 +406,18 @@ export function CompanionVoicePanel(props: Props) {{ value: 'elevenlabs', label: 'ElevenLabs' },{ value: 'minimax', label: 'MiniMax' },]}- disabled={!ready || saving}+ disabled={!ready || saving || starting}onValueChange={(value) => {const next = {providerId: selectedModel.providerId,agent: selectedModel.agent,modelId: selectedModel.id,- voice: selectedVoice || (value === 'openai' ? 'alloy' : ''),+ voice:+ referenceSpeechVoices(selectedModel.id, value as SpeechProtocol)[0] ??+ '',protocol: value as SpeechProtocol,};+ void preview.stop();dirty.current = true;setCustomized(true);setPreference(next);@@ -392,36 +429,34 @@ export function CompanionVoicePanel(props: Props) {)}</FormField>) : null}- {models.length > 0 ? (- <FormField- id={voiceId}- label={t('bots.voiceMode.voice')}- hint={t(- protocol === 'elevenlabs' || protocol === 'minimax'- ? 'bots.voiceMode.voiceIdHint'- : 'bots.voiceMode.voiceHint',- )}- className="min-w-52 flex-1"- >- {(control) => (- <Input- {...control}- value={selectedVoice}- disabled={!ready || saving}- maxLength={128}- onChange={(value) => {- dirty.current = true;- setVoice(value);- }}- onBlur={() => {- if (dirty.current && selection && validModel) void persist(selection);- }}- className="w-full"- />- )}- </FormField>- ) : null}</div>+ {selectedModel ? (+ <SpeechVoicePicker+ route={{+ providerId: selectedModel.providerId,+ agent: selectedModel.agent,+ modelId: selectedModel.id,+ protocol: preference?.protocol,+ }}+ protocol={protocol}+ voice={selectedVoice}+ disabled={!ready || saving || starting || props.blocked}+ previewDisabled={!ready || starting || props.blocked}+ preview={preview}+ onChange={(value, save) => {+ dirty.current = true;+ setVoice(value);+ const next = normalizeVoiceConversationSelection({+ providerId: selectedModel.providerId,+ agent: selectedModel.agent,+ modelId: selectedModel.id,+ protocol: preference?.protocol,+ voice: value,+ });+ if (save && next && validModel) void persist(next);+ }}+ />+ ) : null}{preferenceError ? (<p role="alert" className="text-13 text-[var(--error-fg)]">{t('bots.voiceMode.preferenceError')}@@ -434,7 +469,7 @@ export function CompanionVoicePanel(props: Props) {<Buttonvariant="secondary"size="sm"- disabled={!ready || saving || (!customized && !dirty.current)}+ disabled={!ready || saving || starting || (!customized && !dirty.current)}onClick={() => void persist(null)}>{t('bots.voiceMode.resetPreference')}@@ -449,7 +484,15 @@ export function CompanionVoicePanel(props: Props) {variant="primary"size="lg"onClick={() => void start()}- disabled={!validModel || !selection || !protocol || props.blocked || loading || !ready}+ disabled={+ starting ||+ !validModel ||+ !selection ||+ !protocol ||+ props.blocked ||+ loading ||+ !ready+ }><Mic size={16} />{t(diff --git a/apps/desktop/src/renderer/features/bots/voice/SpeechVoicePicker.tsx b/apps/desktop/src/renderer/features/bots/voice/SpeechVoicePicker.tsxnew file mode 100644index 0000000000..c945d96d6c--- /dev/null+++ b/apps/desktop/src/renderer/features/bots/voice/SpeechVoicePicker.tsx@@ -0,0 +1,182 @@+import { useEffect, useRef, useState, useSyncExternalStore } from 'react';+import { useTranslation } from 'react-i18next';+import { RefreshCw, Square, Volume2 } from 'lucide-react';+import { Button } from '@/components/ui/button';+import { FormField } from '@/components/ui/form-field';+import { Input } from '@/components/ui/input';+import { Select } from '@/components/ui/select';+import {+ normalizeVoiceConversationSelection,+ type SpeechModelSelection,+ type SpeechProtocol,+ type SpeechVoiceCatalog,+} from '@/../shared/voiceConversation';+import type { VoicePreviewController } from './VoicePreviewController';++const MANUAL = 'manual';+type Props = {+ route: SpeechModelSelection;+ protocol?: SpeechProtocol;+ voice: string;+ disabled: boolean;+ previewDisabled: boolean;+ preview: VoicePreviewController;+ onChange(voice: string, save: boolean): void;+};++export function SpeechVoicePicker({+ route,+ protocol,+ voice,+ disabled,+ previewDisabled,+ preview,+ onChange,+}: Props) {+ const { t } = useTranslation();+ const [catalog, setCatalog] = useState<SpeechVoiceCatalog>();+ const [failed, setFailed] = useState(false);+ const [loading, setLoading] = useState(false);+ const [revision, setRevision] = useState(0);+ const [manual, setManual] = useState(false);+ const version = useRef(0);+ const routeKey = JSON.stringify([route, protocol]);+ const phase = useSyncExternalStore(preview.subscribe, preview.getSnapshot);+ const previewing = phase === 'preparing' || phase === 'playing';+ const selection = normalizeVoiceConversationSelection({ ...route, voice });+ const listed = catalog?.voices.some((item) => item.id === voice);+ const showManual = manual || (!!voice && !listed) || !catalog?.voices.length;++ useEffect(() => {+ const request = ++version.current;+ setCatalog(undefined);+ setFailed(false);+ setLoading(!!protocol);+ if (protocol) {+ void window.electronAPI.voiceConversation+ .voices(route)+ .then((result) => {+ if (version.current === request) setCatalog(result);+ })+ .catch(() => {+ if (version.current === request) setFailed(true);+ })+ .finally(() => {+ if (version.current === request) setLoading(false);+ });+ }+ return () => {+ ++version.current;+ };+ // Include the detected protocol in the refresh key, but send only an explicit+ // user override. Main must resolve inferred protocols against its current catalog.+ }, [routeKey, revision]);++ useEffect(() => {+ setManual(false);+ void preview.stop();+ return () => {+ void preview.stop();+ };+ }, [routeKey, preview]);+ useEffect(() => {+ void preview.stop();+ }, [voice, preview]);++ return (+ <div className="min-w-0 space-y-3">+ <FormField label={t('bots.voiceMode.voice')} hint={t('bots.voiceMode.voiceCatalogHint')}>+ {(control) => (+ <div className="flex min-w-0 items-center gap-2">+ <Select+ {...control}+ label={t('bots.voiceMode.voice')}+ value={showManual ? MANUAL : listed ? `voice:${voice}` : ''}+ options={[+ ...(catalog?.voices ?? []).map((item) => ({+ value: `voice:${item.id}`,+ label: item.name === item.id ? item.name : `${item.name} · ${item.id}`,+ })),+ { value: MANUAL, label: t('bots.voiceMode.manualVoice') },+ ]}+ disabled={disabled}+ onValueChange={(value) => {+ void preview.stop();+ setManual(value === MANUAL);+ if (value !== MANUAL) onChange(value.slice(6), true);+ }}+ className="min-w-0 flex-1"+ truncateOptions+ />+ <Button+ variant="secondary"+ size="lg"+ className="w-9 shrink-0 px-0"+ aria-label={t('bots.voiceMode.refreshVoices')}+ title={t('bots.voiceMode.refreshVoices')}+ disabled={disabled || loading || !protocol}+ onClick={() => setRevision((value) => value + 1)}+ >+ <RefreshCw size={15} aria-hidden="true" />+ </Button>+ </div>+ )}+ </FormField>+ <p role="status" className="text-12 text-[var(--text-secondary)]">+ {loading+ ? t('bots.voiceMode.voicesLoading')+ : failed+ ? t('bots.voiceMode.voicesError')+ : catalog?.source === 'reference'+ ? t('bots.voiceMode.voicesReference')+ : catalog?.truncated+ ? t('bots.voiceMode.voicesTruncated')+ : !catalog?.voices.length+ ? t('bots.voiceMode.voicesManual')+ : ''}+ </p>+ {showManual ? (+ <FormField label={t('bots.voiceMode.voiceId')} hint={t('bots.voiceMode.voiceIdHint')}>+ {(control) => (+ <Input+ {...control}+ value={voice}+ maxLength={128}+ disabled={disabled}+ onChange={(value) => {+ void preview.stop();+ setManual(true);+ onChange(value, false);+ }}+ onBlur={() => {+ if (selection) onChange(selection.voice, true);+ }}+ className="w-full"+ />+ )}+ </FormField>+ ) : null}+ <div className="flex flex-wrap items-center gap-2">+ <Button+ variant="secondary"+ size="lg"+ disabled={!previewing && (previewDisabled || !selection || !protocol)}+ onClick={() => {+ if (previewing) void preview.stop();+ else if (selection) void preview.start(selection, t('bots.voiceMode.previewText'));+ }}+ >+ {previewing ? (+ <Square size={14} aria-hidden="true" />+ ) : (+ <Volume2 size={16} aria-hidden="true" />+ )}+ {t(previewing ? 'bots.voiceMode.stopPreview' : 'bots.voiceMode.preview')}+ </Button>+ <p role="status" className="min-w-0 flex-1 text-12 text-[var(--text-secondary)]">+ {t(`bots.voiceMode.previewStatus.${phase}`)}+ </p>+ </div>+ </div>+ );+}diff --git a/apps/desktop/src/renderer/features/bots/voice/VoicePreviewController.ts b/apps/desktop/src/renderer/features/bots/voice/VoicePreviewController.tsnew file mode 100644index 0000000000..b91d32b87d--- /dev/null+++ b/apps/desktop/src/renderer/features/bots/voice/VoicePreviewController.ts@@ -0,0 +1,88 @@+import type {+ VoiceConversationApi,+ VoiceConversationSelection,+} from '@/../shared/voiceConversation';+import type { SpeechPlayer } from './PcmSpeechPlayer';++type Phase = 'idle' | 'preparing' | 'playing' | 'complete' | 'error';++/** Playback-only preview. It never captures the microphone, submits a message or saves a preference. */+export class VoicePreviewController {+ private phase: Phase = 'idle';+ private generation = 0;+ private current: { id: string; player: SpeechPlayer } | null = null;+ private stopping: Promise<void> = Promise.resolve();+ private listeners = new Set<() => void>();++ constructor(+ private readonly deps: {+ api: Pick<VoiceConversationApi, 'preview' | 'readPreview' | 'stopPreview'>;+ botId: string;+ sessionId: string;+ player(): SpeechPlayer;+ },+ ) {}++ getSnapshot = (): Phase => this.phase;+ subscribe = (listener: () => void): (() => void) => {+ this.listeners.add(listener);+ return () => this.listeners.delete(listener);+ };+ private update(phase: Phase): void {+ this.phase = phase;+ this.listeners.forEach((listener) => listener());+ }++ stop(): Promise<void> {+ ++this.generation;+ const current = this.current;+ this.current = null;+ current?.player.close();+ this.update('idle');+ if (current) {+ const stop = this.deps.api.stopPreview(current.id).catch(() => undefined);+ this.stopping = Promise.all([this.stopping, stop]).then(() => undefined);+ }+ return this.stopping;+ }++ async start(selection: VoiceConversationSelection, text: string): Promise<void> {+ const stopped = this.stop();+ const generation = this.generation;+ const id = crypto.randomUUID();+ let player: SpeechPlayer;+ try {+ // Construct/resume AudioContext during the user's click, before awaiting IPC.+ player = this.deps.player();+ } catch {+ this.update('error');+ return;+ }+ this.current = { id, player };+ this.update('preparing');+ try {+ await stopped;+ if (generation !== this.generation) return;+ const { sampleRate } = await this.deps.api.preview({+ ...selection,+ previewId: id,+ botId: this.deps.botId,+ sessionId: this.deps.sessionId,+ text,+ });+ if (generation !== this.generation) return;+ this.update('playing');+ await player.play(() => this.deps.api.readPreview(id), sampleRate);+ if (generation === this.generation) this.update('complete');+ } catch {+ if (generation === this.generation) this.update('error');+ } finally {+ player.close();+ if (this.current?.id === id) this.current = null;+ // Include teardown in the next preview/call's barrier, including a late start.+ const stop = this.deps.api.stopPreview(id).catch(() => undefined);+ this.stopping = Promise.all([this.stopping, stop]).then(() => undefined);+ await this.stopping;+ }+ }+}diff --git a/apps/desktop/src/renderer/features/bots/voice/__tests__/CompanionVoicePanel.test.tsx b/apps/desktop/src/renderer/features/bots/voice/__tests__/CompanionVoicePanel.test.tsxindex b311d7305a..7a0d7aa4d5 100644--- a/apps/desktop/src/renderer/features/bots/voice/__tests__/CompanionVoicePanel.test.tsx+++ b/apps/desktop/src/renderer/features/bots/voice/__tests__/CompanionVoicePanel.test.tsx@@ -71,6 +71,10 @@ beforeEach(() => {value: {voiceConversation: {models: async () => models,+ voices: vi.fn(async () => ({ source: 'manual', voices: [] })),+ preview: vi.fn(async () => ({ sampleRate: 24000 })),+ readPreview: vi.fn(async () => ({ pcm: new ArrayBuffer(2), done: true })),+ stopPreview: vi.fn(async () => {}),preference: vi.fn(async () => ({ selection: null, customized: false })),setPreference: vi.fn(async (_botId, selection) => ({ selection, customized: !!selection })),start,@@ -109,14 +113,14 @@ it('shows a useful empty state without requesting a microphone or inventing mode});it('opens the chosen voice route and releases capture when the panel unmounts', async () => {- models = [{ id: 'gateway-speech', name: 'Speech' }];+ models = [{ id: 'gateway-speech', name: 'Speech', defaultVoice: 'alloy' }];const view = renderPanel();await waitFor(() =>expect(screen.getByRole('button', { name: 'bots.voiceMode.start' }).hasAttribute('disabled'),).toBe(false),);- fireEvent.change(screen.getByLabelText('bots.voiceMode.voice'), { target: { value: 'nova' } });+ fireEvent.change(screen.getByLabelText('bots.voiceMode.voiceId'), { target: { value: 'nova' } });fireEvent.click(screen.getByRole('button', { name: 'bots.voiceMode.start' }));await waitFor(() => expect(audio.start).toHaveBeenCalledOnce());expect(start).toHaveBeenCalledWith({@@ -135,9 +139,7 @@ it('opens the chosen voice route and releases capture when the panel unmounts',it('keeps permission cards authoritative and never starts through a pending confirmation', async () => {models = [{ id: 'tts', name: 'Speech' }];renderPanel(true);- await waitFor(() =>- expect(screen.getByRole('status').textContent).toBe('bots.voiceMode.status.confirmation'),- );+ await waitFor(() => expect(screen.getByText('bots.voiceMode.status.confirmation')).toBeTruthy());expect(screen.getByRole('button', { name: 'bots.voiceMode.start' }).hasAttribute('disabled'),).toBe(true);@@ -185,7 +187,7 @@ it('requires an explicit API choice for an unknown endpoint before requesting a];renderPanel();await screen.findByText('bots.voiceMode.protocolHint');- fireEvent.change(screen.getByLabelText('bots.voiceMode.voice'), {+ fireEvent.change(screen.getByLabelText('bots.voiceMode.voiceId'), {target: { value: 'voice-id' },});expect(@@ -194,6 +196,11 @@ it('requires an explicit API choice for an unknown endpoint before requesting afireEvent.change(screen.getByLabelText('bots.voiceMode.protocol'), {target: { value: 'elevenlabs' },});+ expect((screen.getByLabelText('bots.voiceMode.voiceId') as HTMLInputElement).value).toBe('');+ fireEvent.change(screen.getByLabelText('bots.voiceMode.voiceId'), {+ target: { value: 'voice-id' },+ });+ fireEvent.blur(screen.getByLabelText('bots.voiceMode.voiceId'));await waitFor(() =>expect(window.electronAPI.voiceConversation.setPreference).toHaveBeenCalledWith('bot',@@ -248,18 +255,22 @@ it('reloads the right companion preference after reopening and does not save a d}));const first = renderPanel(false, 'a');await waitFor(() =>- expect((screen.getByLabelText('bots.voiceMode.voice') as HTMLInputElement).value).toBe('nova'),+ expect((screen.getByLabelText('bots.voiceMode.voiceId') as HTMLInputElement).value).toBe(+ 'nova',+ ),);first.unmount();renderPanel(false, 'b');await waitFor(() =>- expect((screen.getByLabelText('bots.voiceMode.voice') as HTMLInputElement).value).toBe('alloy'),+ expect((screen.getByLabelText('bots.voiceMode.voiceId') as HTMLInputElement).value).toBe(+ 'alloy',+ ),);expect(window.electronAPI.voiceConversation.setPreference).not.toHaveBeenCalled();});it('retries a failed preference load and still lists BYOK when Gateway refresh fails', async () => {- models = [{ id: 'tts', name: 'Speech' }];+ models = [{ id: 'tts', name: 'Speech', defaultVoice: 'alloy' }];vi.mocked(window.electronAPI.voiceConversation.preference).mockRejectedValueOnce(new Error('load failed'),);@@ -277,3 +288,85 @@ it('retries a failed preference load and still lists BYOK when Gateway refresh f);expect(window.electronAPI.voiceConversation.preference).toHaveBeenCalledTimes(2);});++it('selects an account voice, keeps manual IDs on catalog failure, and previews without capturing audio', async () => {+ models = [+ { id: 'speech', name: 'MiniMax', providerId: 'mine', agent: 'codex', protocol: 'minimax' },+ ];+ vi.mocked(window.electronAPI.voiceConversation.voices)+ .mockResolvedValueOnce({+ source: 'provider',+ voices: [{ id: 'Chinese (Mandarin)_News_Anchor', name: 'News Anchor' }],+ })+ .mockRejectedValueOnce(new Error('offline'));+ renderPanel();+ await screen.findByRole('option', { name: 'News Anchor · Chinese (Mandarin)_News_Anchor' });+ fireEvent.change(screen.getByLabelText('bots.voiceMode.voice'), {+ target: { value: 'voice:Chinese (Mandarin)_News_Anchor' },+ });+ await waitFor(() =>+ expect(window.electronAPI.voiceConversation.setPreference).toHaveBeenCalledWith(+ 'bot',+ expect.objectContaining({+ voice: 'Chinese (Mandarin)_News_Anchor',+ providerId: 'mine',+ }),+ ),+ );+ fireEvent.click(screen.getByRole('button', { name: 'bots.voiceMode.preview' }));+ await waitFor(() =>+ expect(window.electronAPI.voiceConversation.preview).toHaveBeenCalledWith(+ expect.objectContaining({+ modelId: 'speech',+ voice: 'Chinese (Mandarin)_News_Anchor',+ text: 'bots.voiceMode.previewText',+ }),+ ),+ );+ expect(+ vi.mocked(window.electronAPI.voiceConversation.preview).mock.calls[0][0].protocol,+ ).toBeUndefined();+ expect(+ vi.mocked(window.electronAPI.voiceConversation.voices).mock.calls[0][0].protocol,+ ).toBeUndefined();+ expect(start).not.toHaveBeenCalled();+ expect(audio.start).not.toHaveBeenCalled();+ fireEvent.click(screen.getByRole('button', { name: 'bots.voiceMode.refreshVoices' }));+ await screen.findByText('bots.voiceMode.voicesError');+ expect((screen.getByLabelText('bots.voiceMode.voiceId') as HTMLInputElement).value).toBe(+ 'Chinese (Mandarin)_News_Anchor',+ );+});++it('resets a voice when switching models on the same connection and ignores a late catalog', async () => {+ models = ['first', 'second'].map((id) => ({+ id,+ name: id,+ providerId: 'mine',+ agent: 'codex',+ protocol: 'elevenlabs',+ }));+ vi.mocked(window.electronAPI.voiceConversation.preference).mockResolvedValue({+ selection: { providerId: 'mine', agent: 'codex', modelId: 'first', voice: 'private-voice' },+ customized: true,+ });+ let release!: (value: { source: 'provider'; voices: { id: string; name: string }[] }) => void;+ vi.mocked(window.electronAPI.voiceConversation.voices)+ .mockReturnValueOnce(+ new Promise((resolve) => {+ release = resolve;+ }),+ )+ .mockResolvedValue({ source: 'provider', voices: [{ id: 'new', name: 'New voice' }] });+ renderPanel();+ await waitFor(() => expect(window.electronAPI.voiceConversation.voices).toHaveBeenCalled());+ fireEvent.change(screen.getByLabelText('bots.voiceMode.model'), {+ target: { value: voiceModelKey(models[1]) },+ });+ await screen.findByRole('option', { name: 'New voice · new' });+ expect((screen.getByLabelText('bots.voiceMode.voice') as HTMLSelectElement).value).toBe('');+ expect(screen.queryByLabelText('bots.voiceMode.voiceId')).toBeNull();+ release({ source: 'provider', voices: [{ id: 'old', name: 'Old voice' }] });+ await waitFor(() => expect(screen.queryByRole('option', { name: 'Old voice · old' })).toBeNull());+ expect(window.electronAPI.voiceConversation.setPreference).not.toHaveBeenCalled();+});diff --git a/apps/desktop/src/renderer/features/bots/voice/__tests__/VoiceConversationController.test.ts b/apps/desktop/src/renderer/features/bots/voice/__tests__/VoiceConversationController.test.tsindex b49289b26e..82bd4c7778 100644--- a/apps/desktop/src/renderer/features/bots/voice/__tests__/VoiceConversationController.test.ts+++ b/apps/desktop/src/renderer/features/bots/voice/__tests__/VoiceConversationController.test.ts@@ -14,6 +14,10 @@ function fixture() {let calls = 0;const api = {models: vi.fn(async () => []),+ voices: vi.fn(async () => ({ source: 'manual' as const, voices: [] })),+ preview: vi.fn(async () => ({ sampleRate: 24000 })),+ readPreview: vi.fn(async () => ({ pcm: new ArrayBuffer(0), done: true })),+ stopPreview: vi.fn(async () => {}),preference: vi.fn(async () => ({ selection: null, customized: false })),setPreference: vi.fn(async () => ({ selection: null, customized: false })),start: vi.fn(async () => ({ callId: `call-${++calls}` })),diff --git a/apps/desktop/src/renderer/features/bots/voice/__tests__/VoicePreviewController.test.ts b/apps/desktop/src/renderer/features/bots/voice/__tests__/VoicePreviewController.test.tsnew file mode 100644index 0000000000..3d87b1b964--- /dev/null+++ b/apps/desktop/src/renderer/features/bots/voice/__tests__/VoicePreviewController.test.ts@@ -0,0 +1,100 @@+import { expect, it, vi } from 'vitest';+import { VoicePreviewController } from '../VoicePreviewController';++function fixture() {+ const api = {+ preview: vi.fn(async () => ({ sampleRate: 24000 })),+ readPreview: vi.fn(async () => ({ pcm: new ArrayBuffer(2), done: true })),+ stopPreview: vi.fn<(id: string) => Promise<void>>(async () => {}),+ };+ const player = {+ play: vi.fn(async (read: () => Promise<unknown>) => {+ await read();+ }),+ cancel: vi.fn(),+ close: vi.fn(),+ };+ const controller = new VoicePreviewController({+ api,+ botId: 'bot',+ sessionId: 'task',+ player: () => player,+ });+ return { api, player, controller };+}+const choice = {+ providerId: 'mine',+ agent: 'codex' as const,+ modelId: 'speech',+ voice: 'voice-id',+};++it('previews through the selected model and closes playback after draining', async () => {+ const { controller, api, player } = fixture();+ await controller.start(choice, 'sample');+ expect(api.preview).toHaveBeenCalledWith({+ ...choice,+ botId: 'bot',+ sessionId: 'task',+ previewId: expect.any(String),+ text: 'sample',+ });+ expect(api.readPreview).toHaveBeenCalledOnce();+ expect(player.play).toHaveBeenCalledWith(expect.any(Function), 24000);+ expect(player.close).toHaveBeenCalled();+ expect(api.stopPreview).toHaveBeenCalled();+ expect(controller.getSnapshot()).toBe('complete');+});++it('drops a late start after stopping while synthesis is pending', async () => {+ const { controller, api, player } = fixture();+ let release!: (value: { sampleRate: number }) => void;+ api.preview.mockReturnValueOnce(+ new Promise((resolve) => {+ release = resolve;+ }),+ );+ const pending = controller.start(choice, 'sample');+ await vi.waitFor(() => expect(api.preview).toHaveBeenCalledOnce());+ await controller.stop();+ release({ sampleRate: 24000 });+ await pending;+ expect(player.play).not.toHaveBeenCalled();+ expect(api.readPreview).not.toHaveBeenCalled();+ expect(controller.getSnapshot()).toBe('idle');+});++it('keeps the current preview alive when an earlier request settles late', async () => {+ const { controller, api, player } = fixture();+ let fail!: (reason: Error) => void;+ api.preview.mockReturnValueOnce(+ new Promise((_resolve, reject) => {+ fail = reject;+ }),+ );+ const old = controller.start(choice, 'old');+ await vi.waitFor(() => expect(api.preview).toHaveBeenCalledOnce());+ let drain!: () => void;+ player.play.mockReturnValueOnce(+ new Promise<void>((resolve) => {+ drain = resolve;+ }),+ );+ const current = controller.start({ ...choice, voice: 'second' }, 'new');+ await vi.waitFor(() => expect(controller.getSnapshot()).toBe('playing'));+ fail(new Error('cancelled'));+ await old;+ expect(controller.getSnapshot()).toBe('playing');+ drain();+ await current;+ expect(controller.getSnapshot()).toBe('complete');+});++it('shows errors without retrying or changing the selected model', async () => {+ const { controller, api } = fixture();+ api.preview.mockRejectedValueOnce(new Error('unavailable'));+ await controller.start(choice, 'sample');+ expect(controller.getSnapshot()).toBe('error');+ expect(api.preview).toHaveBeenCalledOnce();+ expect(api.stopPreview).toHaveBeenCalledOnce();+});diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.jsonindex 07e49a80a3..df81b7f5cc 100644--- a/apps/desktop/src/renderer/i18n/locales/en/common.json+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json@@ -9347,6 +9347,25 @@"skillUpdated": "Updated skill: {{title}}"},"voiceMode": {+ "voiceId": "Voice ID",+ "manualVoice": "Enter a voice ID",+ "voiceCatalogHint": "Choose a voice, then preview it to check that it works with the selected model.",+ "refreshVoices": "Refresh voices",+ "voicesLoading": "Loading voices…",+ "voicesError": "Couldn't load voices. Retry or enter a voice ID.",+ "voicesReference": "These are OpenAI reference voices for this model. Compatible services may support different voices.",+ "voicesTruncated": "Showing part of the voice list. Enter an ID to use an unlisted voice.",+ "voicesManual": "No voice list is available for this interface. Enter a voice ID.",+ "preview": "Preview",+ "stopPreview": "Stop preview",+ "previewText": "Hello, this is my voice. It's nice to talk with you.",+ "previewStatus": {+ "idle": "Preview uses the selected model and may incur usage charges.",+ "preparing": "Generating preview…",+ "playing": "Playing preview…",+ "complete": "Preview complete.",+ "error": "Preview failed. Check the interface, model access and voice ID, then retry."+ },"finishBeforeDictation": "End voice mode before starting dictation.","title": "Voice Mode","close": "Close voice mode",diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.jsonindex 643b482f76..e673743230 100644--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json@@ -9309,6 +9309,25 @@"skillUpdated": "スキルを更新:{{title}}"},"voiceMode": {+ "voiceId": "音声 ID",+ "manualVoice": "音声 ID を手動入力",+ "voiceCatalogHint": "音声を選び、現在のモデルで使えるか試聴で確認してください。",+ "refreshVoices": "音声リストを更新",+ "voicesLoading": "音声を取得中…",+ "voicesError": "音声を取得できませんでした。再試行するか、音声 ID を入力してください。",+ "voicesReference": "このモデルの OpenAI 参考音声です。互換サービスで使える音声は異なる場合があります。",+ "voicesTruncated": "音声リストの一部を表示しています。未掲載の音声は ID を入力してください。",+ "voicesManual": "このインターフェースには音声リストがありません。音声 ID を入力してください。",+ "preview": "試聴",+ "stopPreview": "試聴を停止",+ "previewText": "こんにちは、これが私の声です。お話しできてうれしいです。",+ "previewStatus": {+ "idle": "試聴には選択したモデルを使用し、利用料金が発生する場合があります。",+ "preparing": "試聴用の音声を生成中…",+ "playing": "試聴中…",+ "complete": "試聴が完了しました。",+ "error": "試聴に失敗しました。インターフェース、モデルの利用権限、音声 ID を確認して再試行してください。"+ },"finishBeforeDictation": "音声モードを終了してから音声入力を開始してください。","title": "音声モード","close": "音声モードを閉じる",diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.jsonindex cc9b22f987..5775fba3a8 100644--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json@@ -9309,6 +9309,25 @@"skillUpdated": "스킬 업데이트: {{title}}"},"voiceMode": {+ "voiceId": "음성 ID",+ "manualVoice": "음성 ID 직접 입력",+ "voiceCatalogHint": "음성을 선택한 후 미리 들어 현재 모델에서 사용할 수 있는지 확인하세요.",+ "refreshVoices": "음성 목록 새로고침",+ "voicesLoading": "음성 불러오는 중…",+ "voicesError": "음성을 불러오지 못했습니다. 다시 시도하거나 음성 ID를 입력하세요.",+ "voicesReference": "이 모델의 OpenAI 참고 음성입니다. 호환 서비스에서 지원하는 음성은 다를 수 있습니다.",+ "voicesTruncated": "음성 목록의 일부만 표시합니다. 목록에 없는 음성은 ID를 입력하세요.",+ "voicesManual": "이 인터페이스에는 음성 목록이 없습니다. 음성 ID를 입력하세요.",+ "preview": "미리 듣기",+ "stopPreview": "미리 듣기 중지",+ "previewText": "안녕하세요, 제 목소리입니다. 함께 이야기하게 되어 반갑습니다.",+ "previewStatus": {+ "idle": "미리 듣기는 선택한 모델을 사용하며 사용 요금이 발생할 수 있습니다.",+ "preparing": "미리 듣기 음성 생성 중…",+ "playing": "미리 듣는 중…",+ "complete": "미리 듣기를 완료했습니다.",+ "error": "미리 듣기에 실패했습니다. 인터페이스, 모델 접근 권한, 음성 ID를 확인한 후 다시 시도하세요."+ },"finishBeforeDictation": "음성 모드를 종료한 후 받아쓰기를 시작하세요.","title": "음성 모드","close": "음성 모드 닫기",diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.jsonindex 9d75aff44d..dccb7be5ea 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json@@ -9309,6 +9309,25 @@"skillUpdated": "已更新技能:{{title}}"},"voiceMode": {+ "voiceId": "音色 ID",+ "manualVoice": "手动输入音色 ID",+ "voiceCatalogHint": "选择音色后试听,确认当前模型可以使用它。",+ "refreshVoices": "刷新音色列表",+ "voicesLoading": "正在获取音色…",+ "voicesError": "未能获取音色列表。可重试,或手动输入音色 ID。",+ "voicesReference": "这是该型号的 OpenAI 参考音色;兼容服务的实际支持可能不同。",+ "voicesTruncated": "仅显示部分音色;未列出的音色可手动输入 ID。",+ "voicesManual": "此接口没有可用的音色列表,请手动输入音色 ID。",+ "preview": "试听",+ "stopPreview": "停止试听",+ "previewText": "你好,这是我的声音。很高兴与你交流。",+ "previewStatus": {+ "idle": "试听会调用所选模型,可能产生用量。",+ "preparing": "正在生成试听语音…",+ "playing": "正在试听…",+ "complete": "试听完成。",+ "error": "试听失败。请检查接口、模型权限和音色 ID 后重试。"+ },"finishBeforeDictation": "请先结束语音模式,再开始听写。","title": "语音模式","close": "关闭语音模式",diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.jsonindex 83774aeec3..0d93950469 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json@@ -9309,6 +9309,25 @@"skillUpdated": "已更新技能:{{title}}"},"voiceMode": {+ "voiceId": "音色 ID",+ "manualVoice": "手動輸入音色 ID",+ "voiceCatalogHint": "選擇音色後試聽,確認目前的模型可以使用它。",+ "refreshVoices": "重新整理音色清單",+ "voicesLoading": "正在取得音色…",+ "voicesError": "無法取得音色清單。請重試,或手動輸入音色 ID。",+ "voicesReference": "這是此型號的 OpenAI 參考音色;相容服務的實際支援可能不同。",+ "voicesTruncated": "僅顯示部分音色;未列出的音色可手動輸入 ID。",+ "voicesManual": "此介面沒有可用的音色清單,請手動輸入音色 ID。",+ "preview": "試聽",+ "stopPreview": "停止試聽",+ "previewText": "你好,這是我的聲音。很高興與你交流。",+ "previewStatus": {+ "idle": "試聽會呼叫所選模型,可能產生用量。",+ "preparing": "正在產生試聽語音…",+ "playing": "正在試聽…",+ "complete": "試聽完成。",+ "error": "試聽失敗。請檢查介面、模型權限與音色 ID 後重試。"+ },"finishBeforeDictation": "請先結束語音模式,再開始聽寫。","title": "語音模式","close": "關閉語音模式",diff --git a/apps/desktop/src/shared/speechVoices.ts b/apps/desktop/src/shared/speechVoices.tsnew file mode 100644index 0000000000..815b935b34--- /dev/null+++ b/apps/desktop/src/shared/speechVoices.ts@@ -0,0 +1,31 @@+import type { SpeechProtocol } from './voiceConversation.js';++// Model-specific reference lists, not a provider capability declaration. Compatible+// endpoints may expose a different set; manual IDs and a real preview remain available.+// https://developers.openai.com/api/docs/guides/text-to-speech#voice-options+const STANDARD = ['alloy', 'ash', 'coral', 'echo', 'fable', 'nova', 'onyx', 'sage', 'shimmer'];+const EXPRESSIVE = [+ 'alloy',+ 'ash',+ 'ballad',+ 'coral',+ 'echo',+ 'fable',+ 'nova',+ 'onyx',+ 'sage',+ 'shimmer',+ 'verse',+ 'marin',+ 'cedar',+];++export function referenceSpeechVoices(+ modelId: string,+ protocol?: SpeechProtocol,+): readonly string[] {+ if (protocol !== 'openai') return [];+ if (/^gpt-4o-mini-tts(?:-\d{4}-\d{2}-\d{2})?$/.test(modelId)) return EXPRESSIVE;+ if (/^tts-1(?:-hd)?(?:-1106)?$/.test(modelId)) return STANDARD;+ return [];+}diff --git a/apps/desktop/src/shared/voiceConversation.ts b/apps/desktop/src/shared/voiceConversation.tsindex 4346ea5383..20c765aa57 100644--- a/apps/desktop/src/shared/voiceConversation.ts+++ b/apps/desktop/src/shared/voiceConversation.ts@@ -4,14 +4,27 @@ import type { AgentKind } from '@cindy/model-providers';/** Local Desktop voice UI contract. No credentials, raw paths or remote invoke access. */export type SpeechProtocol = 'openai' | 'elevenlabs' | 'minimax';// Missing provider/runtime is the original Cindy AI selection, never another connection.-export type VoiceConversationSelection = {+export type SpeechModelSelection = {providerId?: string;agent?: AgentKind;modelId: string;- voice: string;/** Explicit user choice for a custom speech endpoint; absent follows a known adapter. */protocol?: SpeechProtocol;};+export type VoiceConversationSelection = SpeechModelSelection & { voice: string };+export type SpeechVoice = { id: string; name: string };+export type SpeechVoiceCatalog = {+ voices: SpeechVoice[];+ /** References are model-specific suggestions, not proof a compatible proxy supports them. */+ source: 'provider' | 'reference' | 'manual';+ truncated?: boolean;+};+export type SpeechPreviewStart = VoiceConversationSelection & {+ previewId: string;+ botId: string;+ sessionId: string;+ text: string;+};export type VoiceConversationModel = {id: string;name: string;@@ -44,6 +57,10 @@ export type VoiceConversationStart = VoiceConversationSelection & {};export interface VoiceConversationApi {models(): Promise<VoiceConversationModel[]>;+ voices(selection: SpeechModelSelection): Promise<SpeechVoiceCatalog>;+ preview(input: SpeechPreviewStart): Promise<{ sampleRate: number }>;+ readPreview(previewId: string): Promise<{ pcm: ArrayBuffer; done: boolean }>;+ stopPreview(previewId: string): Promise<void>;preference(botId: string): Promise<VoiceConversationPreference>;setPreference(botId: string,@@ -67,14 +84,30 @@ export function normalizeVoiceConversationSelection(value: unknown,): VoiceConversationSelection | undefined {if (!value || typeof value !== 'object') return undefined;- const { modelId, voice, providerId, agent, protocol } =- value as Partial<VoiceConversationSelection>;+ const route = normalizeSpeechModelSelection(value);+ const voice = normalizeSpeechVoiceId((value as Partial<VoiceConversationSelection>).voice);+ return route && voice ? { ...route, voice } : undefined;+}++/** Voice IDs are opaque provider identifiers; MiniMax IDs include spaces and parentheses. */+export function normalizeSpeechVoiceId(value: unknown): string | undefined {+ if (typeof value !== 'string' || value.length > 128) return undefined;+ const voice = value.trim();+ // Retain the path/control-character boundary for manual IDs. URL use also encodes the ID.+ const invalid = [...value].some(+ (char) =>+ char.charCodeAt(0) < 32 || char.charCodeAt(0) === 127 || char === '/' || char === '\\',+ );+ return voice && !invalid ? voice : undefined;+}++export function normalizeSpeechModelSelection(value: unknown): SpeechModelSelection | undefined {+ if (!value || typeof value !== 'object') return undefined;+ const { modelId, providerId, agent, protocol } = value as Partial<SpeechModelSelection>;if (typeof modelId !== 'string' ||!modelId.trim() ||modelId.length > 256 ||- typeof voice !== 'string' ||- !/^[a-zA-Z0-9_-]{1,128}$/.test(voice) ||(providerId !== undefined &&(typeof providerId !== 'string' || !providerId.trim() || providerId.length > 256)) ||(protocol !== undefined && !['openai', 'elevenlabs', 'minimax'].includes(protocol)) ||@@ -88,7 +121,6 @@ export function normalizeVoiceConversationSelection(return undefined;return {modelId: modelId.trim(),- voice,...(providerId ? { providerId } : {}),...(agent ? { agent } : {}),...(protocol ? { protocol } : {}),diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.mdindex 1a89b5c86d..9fb3b23c51 100644--- a/docs/design-rules/design-inventory.md+++ b/docs/design-rules/design-inventory.md@@ -18,7 +18,7 @@| `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, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, 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/AgentOnOtherDeviceContext.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.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/GhostCardHostPrompts.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/MessageSourceLabels.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.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/UserAttachmentChip.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/animateFocusScroll.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/markdownMedia.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.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/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.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/streamingMessageProjection.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/useImageClipboard.ts, apps/desktop/src/renderer/components/chat/useImageLoadFailure.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.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/ComposerAttachments.tsx, 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/PluginSetupRemoteDesktopButton.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.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/BotFollowMark.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotGroupAvatars.tsx, apps/desktop/src/renderer/features/bots/BotGroupChatView.tsx, apps/desktop/src/renderer/features/bots/BotGroupComposer.tsx, apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx, apps/desktop/src/renderer/features/bots/BotGroupPendingInteraction.tsx, apps/desktop/src/renderer/features/bots/BotGroupPlan.tsx, apps/desktop/src/renderer/features/bots/BotGroupRuntimeFailureNotice.tsx, apps/desktop/src/renderer/features/bots/BotGroupSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotGroupSidebarRow.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotImportForm.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLearningFooter.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/BotSessionTaskLink.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/BotTaskCardHeader.tsx, apps/desktop/src/renderer/features/bots/BotTaskModelEditor.tsx, apps/desktop/src/renderer/features/bots/BotTodoList.tsx, apps/desktop/src/renderer/features/bots/BotWorkbench.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/ChatBotAccessField.tsx, apps/desktop/src/renderer/features/bots/ChatGroupSettings.tsx, apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsx, apps/desktop/src/renderer/features/bots/ChatInviteHost.tsx, apps/desktop/src/renderer/features/bots/ChatServerControls.tsx, apps/desktop/src/renderer/features/bots/ChatThreadPanel.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/WorkbenchSessionList.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/botFollowScopes.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botGroupAttachments.ts, apps/desktop/src/renderer/features/bots/botGroupLane.ts, apps/desktop/src/renderer/features/bots/botGroupMentions.ts, apps/desktop/src/renderer/features/bots/botGroupPresentation.ts, apps/desktop/src/renderer/features/bots/botGroupStore.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/botTodo.css, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/botWorkbenchProjection.ts, apps/desktop/src/renderer/features/bots/chatError.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/useBotUnreadSync.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkbenchSessionPages.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/bots/voice/CompanionVoicePanel.tsx, apps/desktop/src/renderer/features/bots/voice/PcmSpeechPlayer.ts, apps/desktop/src/renderer/features/bots/voice/VoiceConversationController.ts, apps/desktop/src/renderer/features/bots/voice/VoiceReplyTracker.ts, apps/desktop/src/renderer/features/bots/voice/voiceConversation.css, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 278 | 38 | 477 |+| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊 / 群聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊、伙伴群聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, 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/AgentOnOtherDeviceContext.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.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/GhostCardHostPrompts.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/MessageSourceLabels.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.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/UserAttachmentChip.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/animateFocusScroll.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/markdownMedia.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.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/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.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/streamingMessageProjection.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/useImageClipboard.ts, apps/desktop/src/renderer/components/chat/useImageLoadFailure.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.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/ComposerAttachments.tsx, 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/PluginSetupRemoteDesktopButton.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.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/BotFollowMark.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotGroupAvatars.tsx, apps/desktop/src/renderer/features/bots/BotGroupChatView.tsx, apps/desktop/src/renderer/features/bots/BotGroupComposer.tsx, apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx, apps/desktop/src/renderer/features/bots/BotGroupPendingInteraction.tsx, apps/desktop/src/renderer/features/bots/BotGroupPlan.tsx, apps/desktop/src/renderer/features/bots/BotGroupRuntimeFailureNotice.tsx, apps/desktop/src/renderer/features/bots/BotGroupSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotGroupSidebarRow.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotImportForm.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLearningFooter.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/BotSessionTaskLink.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/BotTaskCardHeader.tsx, apps/desktop/src/renderer/features/bots/BotTaskModelEditor.tsx, apps/desktop/src/renderer/features/bots/BotTodoList.tsx, apps/desktop/src/renderer/features/bots/BotWorkbench.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/ChatBotAccessField.tsx, apps/desktop/src/renderer/features/bots/ChatGroupSettings.tsx, apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsx, apps/desktop/src/renderer/features/bots/ChatInviteHost.tsx, apps/desktop/src/renderer/features/bots/ChatServerControls.tsx, apps/desktop/src/renderer/features/bots/ChatThreadPanel.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/WorkbenchSessionList.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/botFollowScopes.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botGroupAttachments.ts, apps/desktop/src/renderer/features/bots/botGroupLane.ts, apps/desktop/src/renderer/features/bots/botGroupMentions.ts, apps/desktop/src/renderer/features/bots/botGroupPresentation.ts, apps/desktop/src/renderer/features/bots/botGroupStore.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/botTodo.css, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/botWorkbenchProjection.ts, apps/desktop/src/renderer/features/bots/chatError.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/useBotUnreadSync.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkbenchSessionPages.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/bots/voice/CompanionVoicePanel.tsx, apps/desktop/src/renderer/features/bots/voice/PcmSpeechPlayer.ts, apps/desktop/src/renderer/features/bots/voice/SpeechVoicePicker.tsx, apps/desktop/src/renderer/features/bots/voice/VoiceConversationController.ts, apps/desktop/src/renderer/features/bots/voice/VoicePreviewController.ts, apps/desktop/src/renderer/features/bots/voice/VoiceReplyTracker.ts, apps/desktop/src/renderer/features/bots/voice/voiceConversation.css, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 278 | 38 | 477 || `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 | 45 || `desktop.chat.new-draft` | desktop | 新建任务草稿页 | hash `/cc-agent/new`(NewMakerDraftRoute) | NewMakerDraftRoute | apps/desktop/src/renderer/features/cc-agent/NewMakerDraftRoute.tsx | 15 | 0 | 3 || `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/AgentOnOtherDeviceContext.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.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/GhostCardHostPrompts.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/MessageSourceLabels.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.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/UserAttachmentChip.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/animateFocusScroll.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/markdownMedia.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.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/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.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/streamingMessageProjection.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/useImageClipboard.ts, apps/desktop/src/renderer/components/chat/useImageLoadFailure.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.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/ComposerAttachments.tsx, 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/PluginSetupRemoteDesktopButton.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.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 | 252 | 38 | 336 |diff --git a/docs/product-rules/companion-voice-mode.md b/docs/product-rules/companion-voice-mode.mdindex b6c58773b7..439e5bd83f 100644--- a/docs/product-rules/companion-voice-mode.md+++ b/docs/product-rules/companion-voice-mode.md@@ -8,8 +8,9 @@- 原任务空闲时正常发送,仍在运行时沿既有插话路径投递。语音是本机用户本人输入,不盖自动化或远程设备来源标签,不增加系统提示词。识别结果按普通文字发送,不执行桌面斜杠命令。- 最终回复经过持久化完成标记确认后才朗读。按本次语音发送的 clientId 关联,不朗读历史、过程文字、工具、子代理、内部协调或群来源私信。文本消息始终是对话记录的正本。- 独立选择朗读模型和音色,按当前账号下的伙伴保存,不改变聊天模型。来源包括有权限的 Cindy AI,以及已连接的本地 BYOK 供应商;候选必须是 `audio_speech`、未停用且具备可用的 API key 或明确的本机免鉴权连接。同名模型按连接 ID、runtime 和上游模型 ID 区分,不能借另一连接的密钥。无候选时显示空状态,不采集麦克风。-- BYOK 支持 OpenAI 兼容、ElevenLabs、MiniMax 三种语音接口。已声明的 OpenAI speech 协议或已知官方端点可确定默认接口;其余候选(包括显式未验证协议)必须由用户在语音面板明确选择接口,不能只凭模型名、`mode` 或聊天协议推断。这个覆盖仅作用于当前伙伴的朗读,不重写公共 Registry 或供应商的聊天协议。ElevenLabs / MiniMax 需填写账号可用的音色 ID;本次不做音色目录、试听或克隆。+- BYOK 支持 OpenAI 兼容、ElevenLabs、MiniMax 三种语音接口。已声明的 OpenAI speech 协议或已知官方端点可确定默认接口;其余候选(包括显式未验证协议)必须由用户在语音面板明确选择接口,不能只凭模型名、`mode` 或聊天协议推断。这个覆盖仅作用于当前伙伴的朗读,不重写公共 Registry 或供应商的聊天协议。音色支持列表选择、手动输入和试听;本次不提供创建或删除克隆音色的能力。- 模型、语音接口和音色为伙伴级显式偏好,打开面板、重启后保留。恢复默认删除该伙伴的选择,继续跟随可用目录;已有旧版全局偏好仍可继承,单独重置一个伙伴时以 `null` 清除该伙伴的旧偏好继承,不复制默认模型、不影响其他伙伴。保存失败明确提示。保存的连接消失或停用时保留选择并禁止开始,不静默改用同名模型。+- 更换连接、runtime、型号或接口时,不沿用旧音色;目标型号有明确参考默认值才填入,否则等待用户选择或输入。同一连接下的不同型号也不视为音色兼容。已有保存音色不因刷新失败、列表未收录而被覆盖,仍显示在手动输入中。- 刷新重新读取当前有效目录,并尝试刷新 Cindy AI;Gateway 刷新失败不阻止本机 BYOK 目录显示。新增第三方型号仍沿设置页已有的获取列表、手动添加和启用流程。- 朗读结束继续监听。用户开口时立即取消待生成及正在播放的声音;新的文字仍投递到原任务。停止朗读不会取消 Agent 工具、清空任务队列或代答权限确认。- 需要确认权限、问题或计划,或任务队列暂停时,关闭麦克风并暂停语音模式;用户完成确认后显式继续。静音、锁屏、休眠、切走任务、关面板、账号切换同样释放采集和播放资源,不在后台重新开始。@@ -19,7 +20,7 @@面板保留伙伴头像和姓名,持续显示连接、监听、思考、准备语音、朗读或暂停状态。音量条反映实际输入或输出音量,没有循环伪造的声波。进入动效和音量条只变换 opacity/transform,使用现有 motion token,并支持减少动态效果。模型、接口和音色可在开始前或暂停后更换,静止配置区采用紧凑的头像与状态行;语音运行时恢复集中呈现的伙伴头像和音量条。进行中的结束、静音及面板关闭按钮不随内容滚走,暂停后可继续或关闭。面板最多占视口高度的 65%,中间内容独立滚动。Light/Dark 使用语义颜色。-设计依据为 `DESIGN.md` §4 标准控件、§5 圆角分层、§14.4 动效与 `design-governance.md` §13 点击层分类:标题栏语音入口是 32px 的普通动作按钮,沿用同栏的 pill;面板和未发送文字框属于容器,使用 12px 圆角;音量条是无交互的指示层,不是按钮。设置、开始、静音、结束等操作复用现有 Button / Select / Input / FormField,模型、接口和音色均有可见标签。较窄的窗口将接口和音色折行,操作区保持可见。+设计依据为 `DESIGN.md` §4 标准控件、§5 圆角分层、§14.4 动效与 `design-governance.md` §13 点击层分类:标题栏语音入口是 32px 的普通动作按钮,沿用同栏的 pill;面板和未发送文字框属于容器,使用 12px 圆角;音量条是无交互的指示层,不是按钮。设置、开始、静音、结束等操作复用现有 Button / Select / Input / FormField,模型、接口和音色均有可见标签。配置区将模型与接口并列;较窄的窗口自动折行,音色单独成行。试听可随时停止,主要操作区保持可见。## 执行边界@@ -42,6 +43,15 @@原生接口依据:[ElevenLabs stream](https://elevenlabs.io/docs/api-reference/text-to-speech/stream)、[MiniMax HTTP TTS](https://platform.minimax.io/docs/api-reference/speech-t2a-http)。响应有类型、大小、超时和完整性检查,重定向被拒绝,上游原始错误不穿过 IPC。流式传输与插话取消共用原有代次检查和播放背压,不增加音频落盘。+## 音色目录与试听++- **OpenAI 兼容**:仅对已知精确型号及已知格式的日期版本提供代码内的官方参考列表;`gpt-4o-mini-tts` 与 `tts-1` / `tts-1-hd` 的集合分开。未知型号不强行填 `alloy`,也不探测不存在的通用 `/voices`。兼容服务可能只实现部分音色,列表明确标注为参考,是否可用仍需试听。[资料来源](https://developers.openai.com/api/docs/guides/text-to-speech#voice-options)。+- **ElevenLabs**:从对应连接的 `/v2/voices` 分页查询账号音色;由既有 `/v1` base 替换末段,保留代理 origin 和路径前缀。无版本后缀的自定义代理尝试其 `<base>/voices` 旧接口。`high_quality_base_model_ids` 不作为模型可用性的硬过滤条件。失败时允许重试或手动输入。[资料来源](https://elevenlabs.io/docs/api-reference/voices/search)。+- **MiniMax**:调用 `<base>/get_voice`,`voice_type: all`,合并 `system_voice`、`voice_cloning`、`voice_generation`;名称与 ID 分开,缺名称时显示 ID。音色 ID 接受真实型号所需的空格、括号等字符,保留长度、控制字符和路径分隔符校验。[资料来源](https://platform.minimax.io/docs/api-reference/voice-management-get)。+- 目录请求只在 Main 使用当前连接的凭证,拒绝重定向,限制 15 秒、每页 2MB 和最多 1000 个音色 / 10 页;超过显示范围时提示手动输入兜底。账号、密钥或路由在请求期间变化则丢弃结果。账号专属音色列表只留在面板内存,不写入公共 Registry 或新的配置文件;已有伙伴偏好仅保存所选 ID,不自动迁移或重写。+- 用户点击试听后,以当前连接、型号、接口和音色合成短示例文本,并明确提示可能产生用量。复用既有 PCM 合成、解码和播放;不采集麦克风、不发送伙伴消息、不调用聊天模型,不使用供应商返回的任意 `preview_url`。试听结果表示这次调用结果,不持久标记整个账号或型号已验证。+- 试听与语音模式/听写互斥,绑定可信窗口、账号和伙伴 canonical 任务。生成过程中也可停止;改选、隐藏页面、关面板、账号变化、系统挂起或权限阻塞时取消;开始语音前等待试听停止。窗口销毁与 60 秒总时限均释放 Main 的语音占用。晚到的结果不恢复播放、不覆盖新选择。+## 后续扩展计划以下为后续演进方向,本 PR 尚未实现适配器拆分、统一参数描述或公共 Registry schema 扩展,也不包含 Qwen / CosyVoice 原生执行器。@@ -55,6 +65,6 @@## 验证-自动化覆盖分段去重、乱序完成、空转写、连接轮换、权限与账号边界、取消启动、插话抢占、迟到音频、PCM 字节边界、回复关联、无模型空状态及现有 ASR 回归。BYOK 回归覆盖接口请求、SSE 断帧与结束聚合包、连接/密钥隔离、停用与账号切换、伙伴偏好重开与重置、未知接口须用户选择,以及合成失败不换供应商、不重发消息。+自动化覆盖分段去重、乱序完成、空转写、连接轮换、权限与账号边界、取消启动、插话抢占、迟到音频、PCM 字节边界、回复关联、无模型空状态及现有 ASR 回归。BYOK 回归覆盖接口请求、SSE 断帧与结束聚合包、连接/密钥隔离、停用与账号切换、伙伴偏好重开与重置、未知接口须用户选择,以及合成失败不换供应商、不重发消息。音色与试听回归包含真实 MiniMax ID、OpenAI 型号差异、ElevenLabs 分页、账号私有列表边界、手动输入与刷新失败、改选清除旧音色、试听取消与迟到结果、窗口销毁,以及试听不启动 ASR。没有真实 Gateway / BYOK TTS 账号可用于验收时,自动化和组件预览使用明确的测试替身;产品目录不添加演示模型。真实模型开放后,还需验证其音色和 PCM 合同,并在 macOS/Windows 的耳机、扬声器、蓝牙设备上验证连续多轮、回声与插话延迟。测试替身不构成这些项目已通过的证据。