Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

fix(providers): address review findings and resolve main conflicts

xdf47b7c2de50d
diff --cc apps/desktop/scripts/provider-e2e-profile.mjs
index 0000000000,0000000000..f7dda4a80b
new file mode 100644
--- /dev/null
+++ b/apps/desktop/scripts/provider-e2e-profile.mjs
@@@ -1,0 -1,0 +1,42 @@@
++// Read-only provenance check before any provider E2E UI or IPC mutation.
++import assert from 'node:assert/strict';
++import fs from 'node:fs/promises';
++import path from 'node:path';
++import { execFile } from 'node:child_process';
++import { promisify } from 'node:util';
++const execFileAsync = promisify(execFile);
++
++export async function assertProviderE2EProfile(browser, dbFile, {
++ readFile = fs.readFile, realpath = fs.realpath, run = execFileAsync, platform = process.platform,
++} = {}) {
++ assert.ok(dbFile && path.basename(dbFile) === 'cindy-local-v1.db'
++ && /^CindyGlobal-dev2-provider-auto-detection-.+$/.test(path.basename(path.dirname(dbFile))), 'E2E_DB must identify the isolated provider test database');
++ const db = await realpath(dbFile);
++ assert.equal(db, path.resolve(dbFile), 'E2E database must not redirect through a symlink');
++ const session = await browser.newBrowserCDPSession();
++ try {
++ const { processInfo } = await session.send('SystemInfo.getProcessInfo');
++ const main = processInfo.filter(p => p.type === 'browser');
++ assert.equal(main.length, 1, 'Cannot identify the connected Desktop main process');
++ const pid = main[0].id;
++ assert.ok(Number.isSafeInteger(pid) && pid > 0);
++ const profile = path.dirname(db);
++ const record = JSON.parse(await readFile(path.join(profile, '.dev-instances', `${pid}.json`), 'utf8'));
++ assert.equal(record.pid, pid);
++ assert.equal(record.isolated, true, 'Connected Desktop is not isolated');
++ assert.equal(record.profileKind, 'isolated-sandbox');
++ assert.equal(record.state, 'ready');
++ assert.equal(await realpath(record.userDataDir), profile, 'Connected Desktop uses another profile');
++ // Reject stale registrations after PID reuse. These scripts currently target macOS.
++ assert.equal(platform, 'darwin', 'Profile identity verification requires macOS');
++ const { stdout } = await run('ps', ['-ww', '-p', String(pid), '-o', 'lstart=', '-o', 'comm='], {
++ encoding: 'utf8', timeout: 5000, maxBuffer: 16384, env: { ...process.env, LC_ALL: 'C', TZ: 'UTC0' },
++ });
++ const match = /^(\w{3}\s+\w{3}\s+\d{1,2}\s+\d{2}:\d{2}:\d{2}\s+\d{4})\s+(.+)$/.exec(stdout.trim());
++ assert.ok(match && record.processIdentity, 'Desktop process identity is unavailable');
++ assert.equal(Date.parse(`${match[1]} UTC`), record.processIdentity.startedAtMs, 'Stale Desktop registration');
++ assert.equal(match[2], record.processIdentity.executablePath, 'Desktop executable changed');
++ } finally {
++ await session.detach();
++ }
++}
diff --cc apps/desktop/scripts/provider-protocol-e2e.mjs
index 32f045a63d,0000000000..99fcffb944
mode 100644,000000..100644
--- a/apps/desktop/scripts/provider-protocol-e2e.mjs
+++ b/apps/desktop/scripts/provider-protocol-e2e.mjs
@@@ -1,117 -1,0 +1,119 @@@
++import { assertProviderE2EProfile } from './provider-e2e-profile.mjs';
+// Black-box real Desktop IPC -> native adapters -> loopback HTTP fault injection.
+// No database writes, host mocks, SDK mocks, real keys or paid upstreams.
+import assert from 'node:assert/strict';
+import http from 'node:http';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { chromium } from 'playwright-core';
+const out = await fs.mkdtemp(path.join(os.tmpdir(), 'cindy-protocol-e2e-'));
+const wires = ['openai-chat', 'openai-responses', 'anthropic-messages', 'google-generative-ai'];
+const model = 'e2e-protocol-model';
+const records = [];
+let active;
+function frames(wire) {
+ const events = wire === 'openai-responses' ? [
+ { type: 'response.created', response: { id: 'reply' } },
+ { type: 'response.output_item.added', output_index: 0, item: { id: 'msg', type: 'message', role: 'assistant', content: [] } },
+ { type: 'response.output_text.delta', output_index: 0, content_index: 0, delta: 'OK' },
+ { type: 'response.completed', response: { id: 'reply', status: 'completed', output: [], usage: { input_tokens: 1, output_tokens: 1 } } },
+ ] : wire === 'anthropic-messages' ? [
+ { type: 'message_start', message: { id: 'reply', model, role: 'assistant', type: 'message', content: [], usage: { input_tokens: 1, output_tokens: 0 } } },
+ { type: 'content_block_start', index: 0, content_block: { type: 'text', text: '' } },
+ { type: 'content_block_delta', index: 0, delta: { type: 'text_delta', text: 'OK' } },
+ { type: 'content_block_stop', index: 0 },
+ { type: 'message_delta', delta: { stop_reason: 'end_turn' }, usage: { output_tokens: 1 } },
+ { type: 'message_stop' },
+ ] : wire === 'google-generative-ai' ? [{ candidates: [{ content: { parts: [{ text: 'OK' }] }, finishReason: 'STOP' }] }] : [{ id: 'reply', object: 'chat.completion.chunk', choices: [{ index: 0, delta: { role: 'assistant', content: 'OK' } }] },
+ { id: 'reply', choices: [{ index: 0, delta: {}, finish_reason: 'stop' }], usage: { prompt_tokens: 1, completion_tokens: 1 } }];
+ return events;
+}
+const encode = events => events.map(e => `${e.type ? `event: ${e.type}\n` : ''}data: ${JSON.stringify(e)}\n\n`).join('');
+const server = http.createServer(async (req, res) => {
+ const chunks = []; for await (const c of req) chunks.push(c);
+ const url = new URL(req.url, 'http://fixture');
+ const wire = url.pathname.endsWith('/chat/completions') ? wires[0] : url.pathname.endsWith('/responses') ? wires[1]
+ : url.pathname.endsWith('/messages') ? wires[2] : url.pathname.includes(':streamGenerateContent') ? wires[3] : 'unknown';
+ active.requests.push({ method: req.method, path: url.pathname, wire });
+ const json = (status, body) => { res.writeHead(status, { 'content-type': 'application/json' }); res.end(JSON.stringify(body)); };
+ if (active.kind === 'success' && wire !== active.wire || active.kind === 'unsupported') return json(active.status ?? 400, { error: { code: 'unsupported_protocol', message: 'protocol not supported' } });
+ if (active.kind === 'http') return json(active.status, { error: { message: active.message } });
+ if (active.kind === 'disconnect') return req.socket.destroy();
+ if (active.kind === 'timeout') return; // Real 8-second candidate deadline.
+ if (active.kind === 'overall') return setTimeout(() => {
+ if (!res.destroyed) json(400, { error: { code: 'unsupported_protocol', message: 'protocol not supported' } });
+ }, 6000);
+ if (active.kind === 'redirect') { res.writeHead(307, { location: '/redirect-target' }); return res.end(); }
+ if (active.kind === 'html') { res.writeHead(200, { 'content-type': 'text/html' }); return res.end('<html>Login</html>'); }
+ res.writeHead(200, { 'content-type': 'text/event-stream' });
+ if (active.kind === 'empty') return res.end('data: [DONE]\n\n');
+ if (active.kind === 'malformed') return res.end('data: {broken}\n\n');
+ if (active.kind === 'stream-error') return res.end(encode([{ error: { type: 'authentication_error', message: 'invalid api key' } }]));
+ const events = frames(wire);
+ if (active.kind === 'partial-end' || active.kind === 'partial-reset') {
+ const partial = wire === wires[3] ? [{ candidates: [{ content: { parts: [{ text: 'partial' }] } }] }] : events.slice(0, wire === wires[0] ? 1 : 3);
+ res.write(encode(partial));
+ if (active.kind === 'partial-end') return res.end();
+ return setTimeout(() => res.destroy(), 80);
+ }
+ res.end(encode(events));
+});
+await new Promise(resolve => server.listen(0, '127.0.0.1', resolve));
+const baseUrl = `http://127.0.0.1:${server.address().port}/team/v1`;
+let browser;
+try {
+ browser = await chromium.connectOverCDP(process.env.E2E_CDP_URL ?? 'http://127.0.0.1:19427');
++ await assertProviderE2EProfile(browser, process.env.E2E_DB);
+ const page = browser.contexts()[0].pages().find(p => /localhost:\d+\/#\/settings/.test(p.url()));
+ assert.ok(page, 'An isolated Desktop settings window must be open');
+ const cases = wires.map((wire, i) => ({ kind: 'success', wire, count: i + 1 }));
+ for (const wire of wires) cases.push(...[
+ { kind: 'http', status: 401, message: 'invalid api key', code: 'AUTH_INVALID' },
+ { kind: 'http', status: 403, message: 'forbidden', code: 'AUTH_FORBIDDEN' },
+ { kind: 'http', status: 402, message: 'insufficient_quota', code: 'QUOTA_EXCEEDED' },
+ { kind: 'http', status: 429, message: 'rate limit unsupported_protocol', code: 'RATE_LIMITED' },
+ { kind: 'http', status: 400, message: 'invalid request parameter' },
+ { kind: 'http', status: 404, message: 'not found' },
+ { kind: 'http', status: 503, message: 'unsupported_protocol' },
+ { kind: 'disconnect' }, { kind: 'partial-end' }, { kind: 'partial-reset' },
+ { kind: 'empty' }, { kind: 'malformed' }, { kind: 'html' }, { kind: 'redirect' },
+ { kind: 'stream-error' }, { kind: 'timeout', code: 'TIMEOUT' },
+ ].map(c => ({ ...c, wire, count: 1, preferred: wire })));
+ for (const status of [400, 404, 405, 415, 422]) cases.push({ kind: 'unsupported', status, count: 4 });
+ cases.push({ kind: 'overall', count: 3, code: 'TIMEOUT' });
+ for (const c of cases) {
+ active = { ...c, requests: [] };
+ const input = { kind: 'adhoc', strategy: 'auto', requestId: `matrix-${Date.now()}-${records.length}`,
+ spec: { agent: 'pi', baseUrl, modelId: model, authMethod: 'apiKey', apiKey: 'fake-e2e-not-a-real-key',
+ ...(c.preferred ? { wireProtocol: c.preferred } : {}) } };
+ const start = Date.now();
+ const result = await page.evaluate(input => window.electronAPI.maker.testProviderConnection(input), input);
+ const row = { ...c, elapsedMs: Date.now() - start, result, requests: active.requests };
+ records.push(row);
+ await fs.writeFile(path.join(out, 'results.json'), JSON.stringify(records, null, 2));
+ assert.equal(result.ok, c.kind === 'success', JSON.stringify(row));
+ assert.equal(active.requests.length, c.count, JSON.stringify(row));
+ assert.equal(result.attempts.length, c.count, JSON.stringify(row));
+ if (c.kind === 'success') {
+ assert.equal(result.selected.wireProtocol, c.wire);
+ assert.deepEqual(active.requests.map(r => r.wire), wires.slice(0, c.count));
+ } else if (c.kind === 'unsupported' || c.kind === 'overall') assert.deepEqual(active.requests.map(r => r.wire), wires.slice(0, c.count));
+ else { assert.equal(active.requests[0].wire, c.wire); assert.notEqual(result.decision, 'next'); }
+ if (c.code) assert.equal(result.code, c.code, JSON.stringify(row));
+ if (c.kind === 'timeout') assert.ok(row.elapsedMs >= 7500 && row.elapsedMs < 12000, JSON.stringify(row));
+ if (c.kind === 'overall') assert.ok(row.elapsedMs >= 14500 && row.elapsedMs < 19000, JSON.stringify(row));
+ row.pass = true;
+ await fs.writeFile(path.join(out, 'results.json'), JSON.stringify(records, null, 2));
+ console.log(`PASS ${c.kind} ${c.wire ?? ''} ${c.status ?? ''} requests=${c.count}`);
+ }
+} catch (error) {
+ console.error(error);
+ await fs.writeFile(path.join(out, 'failure.txt'), String(error.stack));
+ process.exitCode = 1;
+} finally {
+ await browser?.close();
+ server.closeAllConnections();
+ await new Promise(resolve => server.close(resolve));
+ console.log(`REPORT=${out}`);
+}
diff --cc apps/desktop/scripts/provider-save-e2e.mjs
index 6f5267c784,0000000000..998cf3b194
mode 100644,000000..100644
--- a/apps/desktop/scripts/provider-save-e2e.mjs
+++ b/apps/desktop/scripts/provider-save-e2e.mjs
@@@ -1,178 -1,0 +1,180 @@@
++import { assertProviderE2EProfile } from './provider-e2e-profile.mjs';
+// Real isolated Desktop IPC + persistence + loopback HTTP. No host mocks or real keys.
+// Start with XDT_CDP_PORT=19427 pnpm restart:desktop:remote --region=global --isolated=@worktree --passive
+import assert from 'node:assert/strict';
+import http from 'node:http';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+import { chromium } from 'playwright-core';
+
+const require = createRequire(import.meta.url);
+const Database = require('better-sqlite3');
+const dbFile = process.env.E2E_DB;
+assert.ok(dbFile && /CindyGlobal-dev2-provider-auto-detection-[^/]+\/cindy-local-v1\.db$/.test(dbFile),
+ 'E2E_DB must name this worktree isolated local database; never use a real profile');
+const disk = new Database(dbFile, { readonly: true });
+const out = await fs.mkdtemp(path.join(os.tmpdir(), 'cindy-provider-save-e2e-'));
+const results = [];
+const requests = [];
+let scenario;
+const model = 'e2e-fixture-chat';
+const key = 'fake-e2e-not-a-real-key';
+const server = http.createServer(async (req, res) => {
+ const chunks = [];
+ for await (const chunk of req) chunks.push(chunk);
+ const body = chunks.length ? JSON.parse(Buffer.concat(chunks).toString()) : undefined;
+ const url = new URL(req.url, 'http://fixture');
+ requests.push({ scenario: scenario?.name, method: req.method, path: url.pathname,
+ model: body?.model, authMatches: req.headers.authorization === `Bearer ${key}`,
+ apiKeyMatches: req.headers['x-api-key'] === key, marker: req.headers['x-e2e-marker'] });
+ const json = (value, status = 200) => { res.writeHead(status, { 'content-type': 'application/json' }); res.end(JSON.stringify(value)); };
+ const prefix = scenario?.prefix ?? '';
+ if (!url.pathname.startsWith(prefix + '/')) return json({ error: 'wrong prefix' }, 404);
+ const route = url.pathname.slice(prefix.length);
+ if (req.method === 'GET') {
+ if (route === '/v1/models') return json({ data: [{ id: model, owned_by: scenario.system === 'vllm' ? 'vllm' : 'fixture', root: model, max_model_len: 8192 }] });
+ const fixtures = {
+ sub2api: { '/api/v1/settings/public': { code: 0, data: { version: 'fixture', hide_ccs_import_button: false, backend_mode_enabled: true, subscription_enabled: false } }, '/v1/sub2api/billing': { object: 'sub2api.key_billing', schema_version: 1 } },
+ litellm: { '/health/readiness/details': { litellm_version: 'fixture', status: 'healthy', success_callbacks: [] }, '/v1/model/info': { data: [{ model_name: model, litellm_params: {}, model_info: {} }] } },
+ lmstudio: { '/lmstudio-greeting': { lmstudio: true }, '/api/v1/models': { models: [{ key: model, type: 'llm', publisher: 'fixture', loaded_instances: [] }] } },
+ llamacpp: { '/props': { default_generation_settings: {}, total_slots: 1, build_info: 'fixture' } },
+ vllm: { '/version': { version: 'fixture' } },
+ };
+ return fixtures[scenario.system]?.[route] ? json(fixtures[scenario.system][route]) : json({ error: 'not found' }, 404);
+ }
+ if (!['/v1/chat/completions', '/v1/responses', '/v1/messages'].includes(route)) return json({ error: 'unsupported endpoint' }, 404);
+ if (body?.model !== model) return json({ error: 'wrong model' }, 400);
+ if (scenario.reject) return json({ error: { message: 'invalid fixture key', type: 'authentication_error' } }, 401);
+ res.writeHead(200, { 'content-type': 'text/event-stream' });
+ const events = route.endsWith('/responses') ? [
+ { type: 'response.created', response: { id: 'reply' } },
+ { type: 'response.output_item.added', output_index: 0, item: { id: 'msg', type: 'message', role: 'assistant', content: [] } },
+ { type: 'response.output_text.delta', output_index: 0, content_index: 0, delta: 'OK' },
+ { type: 'response.completed', response: { id: 'reply', status: 'completed', output: [], usage: { input_tokens: 1, output_tokens: 1 } } },
+ ] : route.endsWith('/messages') ? [
+ { type: 'message_start', message: { id: 'reply', model, role: 'assistant', type: 'message', content: [], usage: { input_tokens: 1, output_tokens: 0 } } },
+ { type: 'content_block_start', index: 0, content_block: { type: 'text', text: '' } },
+ { type: 'content_block_delta', index: 0, delta: { type: 'text_delta', text: 'OK' } },
+ { type: 'content_block_stop', index: 0 },
+ { type: 'message_delta', delta: { stop_reason: 'end_turn' }, usage: { output_tokens: 1 } },
+ { type: 'message_stop' },
+ ] : [{ id: 'reply', object: 'chat.completion.chunk', choices: [{ index: 0, delta: { role: 'assistant', content: 'OK' } }] },
+ { id: 'reply', choices: [{ index: 0, delta: {}, finish_reason: 'stop' }], usage: { prompt_tokens: 1, completion_tokens: 1 } }];
+ res.end(events.map(e => `${e.type ? `event: ${e.type}\n` : ''}data: ${JSON.stringify(e)}\n\n`).join('') + (route.endsWith('/completions') ? 'data: [DONE]\n\n' : ''));
+});
+await new Promise(resolve => server.listen(0, '127.0.0.1', resolve));
+const origin = `http://127.0.0.1:${server.address().port}`;
+let browser;
+let page;
+const created = [];
+try {
+ browser = await chromium.connectOverCDP(process.env.E2E_CDP_URL ?? 'http://127.0.0.1:19427');
++ await assertProviderE2EProfile(browser, process.env.E2E_DB);
+ page = browser.contexts()[0].pages().find(p => /\/#\/settings/.test(p.url()));
+ assert.ok(page, 'Open the isolated Desktop Settings / Providers page first');
+ page.setDefaultTimeout(20000);
+ const presets = await page.evaluate(async () => (await window.electronAPI.maker.listProviderPresets()).presets);
+ if (await page.getByRole('dialog').count()) {
+ await page.getByRole('dialog').getByRole('button', { name: '取消', exact: true }).click();
+ await page.getByRole('dialog').waitFor({ state: 'hidden' });
+ }
+ for (const item of [
+ { system: 'sub2api', prefix: '' }, { system: 'sub2api', prefix: '/team', back: true },
+ { system: 'litellm', prefix: '/team' }, { system: 'lmstudio', prefix: '/team' },
+ { system: 'llamacpp', prefix: '/team' }, { system: 'vllm', prefix: '/team' },
+ ]) {
+ scenario = { ...item, name: `E2E ${item.system} ${item.back ? 'return' : 'save'} ${Date.now()}` };
+ if (!await page.getByPlaceholder('我的 AI 供应商').count()) {
+ await page.getByRole('button', { name: '添加供应商', exact: true }).click();
+ await page.getByText('自定义端点', { exact: true }).click();
+ }
+ await page.getByPlaceholder('我的 AI 供应商').fill(scenario.name);
+ await page.getByPlaceholder('API 密钥', { exact: true }).fill(key);
+ await page.getByRole('button', { name: '添加请求头', exact: true }).click();
+ await page.getByPlaceholder('Header-Name').first().fill('X-E2E-Marker');
+ await page.getByPlaceholder('value', { exact: true }).first().fill('preserved-through-wizard');
+ await page.getByPlaceholder('https://api.myprovider.com/v1').fill(origin + item.prefix + '/v1');
+ const next = page.getByRole('button', { name: '下一步', exact: true });
+ await next.waitFor();
+ await page.screenshot({ path: path.join(out, `${results.length}-handoff.png`) });
+ await next.click();
+ const finish = page.getByRole('button', { name: '完成添加', exact: true });
+ await finish.waitFor();
+ if (item.back) {
+ await page.getByRole('button', { name: '← 上一步', exact: true }).click();
+ await page.getByRole('button', { name: '← 上一步', exact: true }).click();
+ await page.getByRole('button', { name: '保存供应商', exact: true }).click();
+ } else await finish.click();
+ await page.waitForFunction(async name => (await window.electronAPI.maker.listProviders()).providers.some(p => p.name === name), scenario.name);
+ const saved = await page.evaluate(async name => (await window.electronAPI.maker.listProviders()).providers.find(p => p.name === name), scenario.name);
+ created.push(saved.id);
+ const row = disk.prepare('SELECT * FROM custom_providers WHERE id = ?').get(saved.id.replace(/^custom:/, ''));
+ assert.ok(row, 'Real save must create a SQLite row');
+ const stored = JSON.parse(row.runtimes);
+ const preset = presets.find(p => p.id === item.system);
+ assert.ok(preset);
+ const expectedAgents = item.back ? ['pi'] : Object.keys(preset.runtimes);
+ assert.deepEqual(Object.keys(saved.routing).sort(), expectedAgents.sort());
+ assert.deepEqual(Object.keys(stored).sort(), expectedAgents.sort());
+ assert.equal(stored.pi.baseUrl, origin + item.prefix + '/v1');
+ assert.ok(stored.pi.models.some(m => m.id === model && m.defaultEnabled !== false));
+ assert.equal(saved.source, 'user');
+ assert.ok(saved.models.pi.some(m => m.id === model));
+ assert.equal(new URL(saved.routing.pi.upstream).port, String(server.address().port));
+ assert.equal(saved.routing.pi.upstream, origin + item.prefix + '/v1');
+ const start = requests.length;
+ const probes = {};
+ for (const agent of Object.keys(saved.routing)) {
+ const probe = await page.evaluate(input => window.electronAPI.maker.testProviderConnection(input), { kind: 'saved', providerId: saved.id, agent });
+ probes[agent] = probe;
+ assert.equal(probe.ok, true, JSON.stringify({ system: item.system, agent, probe }));
+ }
+ const posts = requests.slice(start).filter(r => r.method === 'POST');
+ assert.equal(posts.length, Object.keys(saved.routing).length);
+ assert.ok(posts.every(r => r.model === model && (r.authMatches || r.apiKeyMatches)));
+ assert.ok(posts.every(r => r.marker === 'preserved-through-wizard'));
+ assert.ok(posts.every(r => r.path.startsWith(item.prefix + '/v1/')));
+ const expectedPaths = expectedAgents.map(agent => {
+ // The existing provider interface audit overrides LM Studio's Codex
+ // catalog default to Responses (providerInterfaceRoutes.ts).
+ const wire = item.back ? 'openai-chat' : item.system === 'lmstudio' && agent === 'codex' ? 'openai-responses'
+ : preset.runtimes[agent].wireProtocol ?? (agent === 'claude-code' ? 'anthropic-messages' : agent === 'codex' ? 'openai-responses' : 'openai-chat');
+ assert.equal(stored[agent].wireProtocol ?? (agent === 'claude-code' ? 'anthropic-messages' : agent === 'codex' ? 'openai-responses' : 'openai-chat'), wire);
+ return item.prefix + '/v1/' + ({ 'openai-chat': 'chat/completions', 'openai-responses': 'responses', 'anthropic-messages': 'messages' })[wire];
+ }).sort();
+ assert.deepEqual(posts.map(r => r.path).sort(), expectedPaths);
+ await page.reload();
+ await page.getByRole('button', { name: '添加供应商', exact: true }).waitFor();
+ const reread = await page.evaluate(async id => (await window.electronAPI.maker.listProviders()).providers.find(p => p.id === id), saved.id);
+ assert.deepEqual(reread.routing, saved.routing);
+ const again = await page.evaluate(id => window.electronAPI.maker.testProviderConnection({ kind: 'saved', providerId: id, agent: 'pi' }), saved.id);
+ assert.equal(again.ok, true);
+ scenario.reject = true;
+ const beforeReject = requests.length;
+ const rejected = await page.evaluate(id => window.electronAPI.maker.testProviderConnection({ kind: 'saved', providerId: id, agent: 'pi' }), saved.id);
+ assert.equal(rejected.ok, false);
+ assert.equal(rejected.status, 401);
+ assert.equal(requests.slice(beforeReject).filter(r => r.method === 'POST').length, 1, '401 must not retry another protocol');
+ assert.deepEqual(disk.prepare('SELECT * FROM custom_providers WHERE id = ?').get(row.id), row, 'Probe must not mutate saved config');
+ results.push({ system: item.system, prefix: item.prefix, returned: !!item.back, saved, stored, probes, posts, reread: true, diskVerified: true, reloadedProbe: again, rejected });
+ console.log(`PASS ${item.system} ${item.back ? 'return' : 'save'}`);
+ }
+} catch (error) {
+ console.error(error);
+ if (page) { await page.screenshot({ path: path.join(out, 'failure.png') }).catch(() => {}); console.error((await page.getByRole('dialog').innerText().catch(() => '')).slice(0,2200)); }
+ results.push({ error: error.message });
+ process.exitCode = 1;
+} finally {
+ if (page) for (const id of created) await page.evaluate(async providerId => {
+ const { dataOwnerId, ownerGeneration } = await window.electronAPI.maker.listProviders();
+ await window.electronAPI.maker.deleteCustomProvider(providerId.replace(/^custom:/, ''), { dataOwnerId, ownerGeneration });
+ }, id).catch(e => { console.error('Cleanup failed', e.message); process.exitCode = 1; });
+ for (const id of created) assert.equal(disk.prepare('SELECT id FROM custom_providers WHERE id = ?').get(id.replace(/^custom:/, '')), undefined, 'Fixture cleanup must remove disk row');
+ disk.close();
+ await fs.writeFile(path.join(out, 'results.json'), JSON.stringify({ results, requests }, null, 2));
+ console.log(`REPORT=${out}`);
+ await browser?.close();
+ await new Promise(resolve => server.close(resolve));
+}
diff --cc apps/desktop/scripts/provider-ui-lifecycle-e2e.mjs
index 74800c4e71,0000000000..ab4f791fe5
mode 100644,000000..100644
--- a/apps/desktop/scripts/provider-ui-lifecycle-e2e.mjs
+++ b/apps/desktop/scripts/provider-ui-lifecycle-e2e.mjs
@@@ -1,127 -1,0 +1,128 @@@
++import { assertProviderE2EProfile } from './provider-e2e-profile.mjs';
+// Real Desktop UI, IPC, SQLite and loopback server; fake keys only.
+import assert from 'node:assert/strict';
+import http from 'node:http';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import {createRequire} from 'node:module';
+import {chromium} from 'playwright-core';
+const require=createRequire(import.meta.url);
+assert.ok(/CindyGlobal-dev2-provider-auto-detection-[^/]+\/cindy-local-v1\.db$/.test(process.env.E2E_DB??''));
+const db=new (require('better-sqlite3'))(process.env.E2E_DB,{readonly:true});
+const out=await fs.mkdtemp(path.join(os.tmpdir(),'cindy-provider-ui-lifecycle-'));
+const wires=['openai-chat','openai-responses','anthropic-messages','google-generative-ai'];
+const model='e2e-lifecycle-model';
+const records=[],created=[],requests=[],held=[];
+let desired=wires[0],hold=false,reject=false;
+function frames(wire) {
+ const events = wire === 'openai-responses' ? [
+ { type: 'response.created', response: { id: 'reply' } },
+ { type: 'response.output_item.added', output_index: 0, item: { id: 'msg', type: 'message', role: 'assistant', content: [] } },
+ { type: 'response.output_text.delta', output_index: 0, content_index: 0, delta: 'OK' },
+ { type: 'response.completed', response: { id: 'reply', status: 'completed', output: [], usage: { input_tokens: 1, output_tokens: 1 } } },
+ ] : wire === 'anthropic-messages' ? [
+ { type: 'message_start', message: { id: 'reply', model, role: 'assistant', type: 'message', content: [], usage: { input_tokens: 1, output_tokens: 0 } } },
+ { type: 'content_block_start', index: 0, content_block: { type: 'text', text: '' } },
+ { type: 'content_block_delta', index: 0, delta: { type: 'text_delta', text: 'OK' } },
+ { type: 'content_block_stop', index: 0 },
+ { type: 'message_delta', delta: { stop_reason: 'end_turn' }, usage: { output_tokens: 1 } },
+ { type: 'message_stop' },
+ ] : wire === 'google-generative-ai' ? [{ candidates: [{ content: { parts: [{ text: 'OK' }] }, finishReason: 'STOP' }] }] : [{ id: 'reply', object: 'chat.completion.chunk', choices: [{ index: 0, delta: { role: 'assistant', content: 'OK' } }] },
+ { id: 'reply', choices: [{ index: 0, delta: {}, finish_reason: 'stop' }], usage: { prompt_tokens: 1, completion_tokens: 1 } }];
+ return events;
+}
+const encode = events => events.map(e => `${e.type ? `event: ${e.type}\n` : ''}data: ${JSON.stringify(e)}\n\n`).join('');
+
+const server=http.createServer(async(req,res)=>{
+ const parts=[];for await(const p of req)parts.push(p);
+ const url=new URL(req.url,'http://fixture');
+ const json=(body,status=200)=>{res.writeHead(status,{'content-type':'application/json'});res.end(JSON.stringify(body))};
+ if(req.method==='GET')return url.pathname.endsWith('/models')?json({data:[{id:model}]}):json({error:'not found'},404);
+ const wire=url.pathname.endsWith('/chat/completions')?wires[0]:url.pathname.endsWith('/responses')?wires[1]:url.pathname.endsWith('/messages')?wires[2]:wires[3];
+ const requestModel=JSON.parse(Buffer.concat(parts).toString()||'{}').model??decodeURIComponent(url.pathname.split('/models/')[1]?.split(':')[0]??'');
+ if(requestModel!==model)return json({error:'unexpected model'},400);
+ const row={path:url.pathname,wire,model:requestModel,engine:req.headers['x-e2e-engine'],closed:false,key:req.headers.authorization??req.headers['x-api-key']??req.headers['x-goog-api-key']};
+ requests.push(row);res.on('close',()=>{row.closed=true});
+ const respond=()=>{if(res.destroyed)return;if(reject||wire!==desired)return json({error:{code:'unsupported_protocol',message:'protocol not supported'}},400);res.writeHead(200,{'content-type':'text/event-stream'});res.end(encode(frames(wire)))};
+ if(hold)held.push(respond);else respond();
+});
+await new Promise(r=>server.listen(0,'127.0.0.1',r));
+const origin=`http://127.0.0.1:${server.address().port}`;
+let browser,page;
+const row=id=>db.prepare('SELECT * FROM custom_providers WHERE id=?').get(id.replace(/^custom:/,''));
+const persist=async()=>fs.writeFile(path.join(out,'results.json'),JSON.stringify({records,created,requests},null,2));
+async function record(name,details={}){records.push({name,pass:true,...details});await persist();if(await page.getByRole('dialog').count())await page.getByRole('dialog').screenshot({path:path.join(out,name+'.png')});console.log('PASS',name)}
+async function closeDialog(){if(await page.getByRole('dialog').count()){await page.getByRole('dialog').getByRole('button',{name:'取消',exact:true}).click();await page.getByRole('dialog').waitFor({state:'hidden'})}}
+async function open(name,base=origin+'/team/v1'){
+ await closeDialog();await page.getByRole('button',{name:'添加供应商',exact:true}).click();await page.getByText('自定义端点',{exact:true}).click();
+ await page.getByPlaceholder('我的 AI 供应商').fill(name);await page.getByPlaceholder('API 密钥',{exact:true}).fill('fake-lifecycle-key');await page.getByPlaceholder('https://api.myprovider.com/v1').fill(base);
+ await page.getByText(model+' 自动识别',{exact:true}).waitFor();
+}
+async function success(){await page.getByText(/^连接成功(/).waitFor()}
+async function test(){await page.getByRole('dialog').getByRole('button',{name:'测试连接',exact:true}).click()}
+async function save(name){await page.getByRole('button',{name:'保存供应商',exact:true}).click();await page.getByRole('dialog').waitFor({state:'hidden'});
+ const provider=await page.evaluate(async name=>(await window.electronAPI.maker.listProviders()).providers.find(p=>p.name===name),name);assert.ok(provider);created.push(provider.id);await persist();return provider}
+async function edit(name){await page.getByRole('button').filter({hasText:name}).first().click();await page.getByRole('button',{name:'更多操作',exact:true}).click();await page.getByRole('menuitem',{name:'编辑连接设置',exact:true}).click();await page.getByPlaceholder('我的 AI 供应商').waitFor()}
+try{
- browser=await chromium.connectOverCDP('http://127.0.0.1:19427');page=browser.contexts()[0].pages().find(p=>p.url().includes('/#/settings'));assert.ok(page);page.setDefaultTimeout(15000);
++ browser=await chromium.connectOverCDP(process.env.E2E_CDP_URL ?? 'http://127.0.0.1:19427');await assertProviderE2EProfile(browser,process.env.E2E_DB);page=browser.contexts()[0].pages().find(p=>p.url().includes('/#/settings'));assert.ok(page);page.setDefaultTimeout(15000);
+ for(const action of ['legacy','id'].includes(process.env.E2E_ONLY)?[]:['stop','close','address','key']){
+ await open('E2E lifecycle '+action);desired=wires[0];hold=true;const start=requests.length;await test();
+ while(requests.length===start)await page.waitForTimeout(20);
+ if(action==='stop')await page.getByRole('button',{name:'停止测试',exact:true}).click();
+ if(action==='close')await closeDialog();
+ if(action==='address')await page.getByPlaceholder('https://api.myprovider.com/v1').fill(origin+'/new/v1');
+ if(action==='key')await page.getByPlaceholder('API 密钥',{exact:true}).fill('fake-new-key');
+ await page.waitForTimeout(250);assert.equal(requests[start].closed,true,'old request must be aborted');
+ hold=false;
+ if(action==='close')await open('E2E lifecycle reopen');
+ await test();await success();const before=await page.getByPlaceholder('https://api.myprovider.com/v1').inputValue();
+ for(const release of held.splice(0))release();await page.waitForTimeout(300);
+ assert.equal(await page.getByPlaceholder('https://api.myprovider.com/v1').inputValue(),before);await success();
+ assert.equal(requests.length-start,2);if(action==='key')assert.equal(requests.at(-1).key,'Bearer fake-new-key');if(action==='address')assert.equal(requests.at(-1).path,'/new/v1/chat/completions');await record('cancel-'+action,{requests:requests.slice(start)});
+ }
+ for(const wire of ['legacy','id'].includes(process.env.E2E_ONLY)?[]:wires){
+ desired=wire;const name='E2E auto '+wires.indexOf(wire)+' '+Date.now();await open(name);const start=requests.length;await test();await success();
+ assert.deepEqual(requests.slice(start).map(r=>r.wire),wires.slice(0,wires.indexOf(wire)+1));
+ const base=await page.getByPlaceholder('https://api.myprovider.com/v1').inputValue();const again=requests.length;await test();await success();assert.equal(requests.length-again,1);assert.equal(requests.at(-1).wire,wire);
+ const p=await save(name);const stored=JSON.parse(row(p.id).runtimes);assert.equal(stored.pi.wireProtocol,wire);assert.equal(stored.pi.baseUrl,base);assert.equal(stored.pi.models[0].route.wireProtocol,wire);
+ await page.reload();await page.getByRole('button',{name:'添加供应商',exact:true}).waitFor();await edit(name);assert.equal(await page.getByPlaceholder('https://api.myprovider.com/v1').inputValue(),base);
+ const last=requests.length;await test();await success();assert.equal(requests.length-last,1);assert.equal(requests.at(-1).wire,wire);await closeDialog();
+ const result=await page.evaluate(id=>window.electronAPI.maker.testProviderConnection({kind:'saved',providerId:id,agent:'pi'}),p.id);assert.equal(result.ok,true,JSON.stringify(result));assert.equal(requests.at(-1).wire,wire);
+ await record('auto-save-reopen-call-'+wire,{base,stored});
+ }
+ if(!['legacy','id'].includes(process.env.E2E_ONLY)){desired=wires[0];const manual='E2E manual '+Date.now();await open(manual);const count=requests.length;const manualProvider=await save(manual);assert.equal(requests.length,count);assert.equal(JSON.parse(row(manualProvider.id).runtimes).pi.wireProtocol,wires[0]);await record('manual-save-without-probe');}
+ if(!process.env.E2E_ONLY||process.env.E2E_ONLY==='id'){
+ desired=wires[0];
+ const prefix=('E2E long '+Date.now()+' ').padEnd(40,'a');
+ for(const ending of ['', ' first', ' second']){
+ const name=prefix+ending;await open(name);const p=await save(name);
+ assert.ok(p.id.length<=40);assert.equal(row(p.id).name,name);
+ await page.reload();await page.getByRole('button',{name:'添加供应商',exact:true}).waitFor();await edit(name);
+ assert.equal(await page.getByPlaceholder('我的 AI 供应商').inputValue(),name);
+ await page.getByRole('button',{name:'保存',exact:true}).click();await page.getByRole('dialog').waitFor({state:'hidden'});
+ assert.equal(row(p.id).name,name,'editing preserves the ID and display name');
+ const result=await page.evaluate(id=>window.electronAPI.maker.testProviderConnection({kind:'saved',providerId:id,agent:'pi'}),p.id);assert.equal(result.ok,true);
+ await record('long-id-save-'+(ending.trim()||'boundary'),{id:p.id,name});
+ }
+ assert.equal(new Set(created).size,created.length);
+ }
+ if(process.env.E2E_ONLY!=='id'){
+ // Existing multi-engine connection is seeded through the real create IPC.
+ const id='e2e-independent-'+Date.now(),name='E2E independent '+Date.now();
+ const config={id,name,auth:{method:'apiKey'},runtimes:Object.fromEntries(['claude-code','codex','pi'].map(agent=>[agent,{baseUrl:origin+'/'+agent+'/v1',wireProtocol:'openai-chat',headers:{'X-E2E-Engine':agent},models:[{id:model,name:model}]}]))};
+ await page.evaluate(({config})=>window.electronAPI.maker.createCustomProvider(config,{'claude-code':'fake-claude','codex':'fake-codex','pi':'fake-pi'}),{config});created.push(id);await persist();
+ await page.reload();await page.getByRole('button',{name:'添加供应商',exact:true}).waitFor();await edit(name);
+ await page.getByRole('tab',{name:'Pi',exact:true}).click();
+ const before=JSON.parse(row(id).runtimes);reject=true;const prior=requests.length;await test();await page.getByRole('button',{name:'测试连接',exact:true}).waitFor();await page.waitForTimeout(300);assert.equal(requests.length-prior,1,'legacy edit probe must not enumerate protocols');reject=false;
+ await page.getByPlaceholder('https://api.myprovider.com/v1').fill(origin+'/changed-pi/v1');await page.getByPlaceholder('API 密钥',{exact:true}).fill('fake-pi-edited');
+ await page.getByRole('button',{name:'保存',exact:true}).click();await page.getByRole('dialog').waitFor({state:'hidden'});
+ const after=JSON.parse(row(id).runtimes);assert.deepEqual(after['claude-code'],before['claude-code']);assert.deepEqual(after.codex,before.codex);assert.equal(after.pi.baseUrl,origin+'/changed-pi/v1');
+ for(const agent of ['claude-code','codex','pi']){const result=await page.evaluate(({id,agent})=>window.electronAPI.maker.testProviderConnection({kind:'saved',providerId:id,agent}),{id,agent});assert.equal(result.ok,true);assert.equal(requests.at(-1).engine,agent==='pi'?undefined:agent);assert.equal(requests.at(-1).path,'/'+(agent==='pi'?'changed-pi':agent)+'/v1/chat/completions');assert.equal(requests.at(-1).key,'Bearer '+(agent==='pi'?'fake-pi-edited':agent==='codex'?'fake-codex':'fake-claude'))}
+ await record('edit-old-connection-preserves-independent-engines',{before,after});
+ }
+}catch(e){console.error(e);records.push({error:e.message});process.exitCode=1;if(page)console.error(await page.getByRole('dialog').innerText().catch(()=>''))}
+finally{
+ if(page){await closeDialog().catch(()=>{});for(const id of created){await page.evaluate(async id=>{const {dataOwnerId,ownerGeneration}=await window.electronAPI.maker.listProviders();await window.electronAPI.maker.deleteCustomProvider(id.replace(/^custom:/,''),{dataOwnerId,ownerGeneration})},id).catch(e=>{records.push({cleanupError:e.message});process.exitCode=1})}}
+ await persist();db.close();await browser?.close();server.closeAllConnections();await new Promise(r=>server.close(r));console.log('REPORT='+out);
+}
diff --cc apps/desktop/src/main/maker-ipc/__tests__/providerHandlers.test.ts
index 7cf1770bae,29837bf650..e5c1ac32e3
--- a/apps/desktop/src/main/maker-ipc/__tests__/providerHandlers.test.ts
+++ b/apps/desktop/src/main/maker-ipc/__tests__/providerHandlers.test.ts
@@@ -4668,106 -4837,98 +4837,201 @@@ it('preserves the actual Vertex API thr
expect(deps.testConnection).toHaveBeenCalledOnce();
});
+// Scheme-2 detection shares the existing local credential boundary. The new ingress
+// needs explicit sender/cancellation coverage; ordinary model fetch has no draft lifecycle.
+describe('provider detection drafts', () => {
+ const input = { requestId: 'draft-1', agent: 'pi', authMethod: 'apiKey', baseUrl: 'https://relay.example/v1', apiKey: 'fake-test-key' };
+ it('rejects untrusted senders and invalid inputs before dispatch', async () => {
+ const harness = new IpcHarness();
+ const detectProvider = vi.fn();
+ const guard = vi.fn<() => void>(() => { throwIpcError('PERMISSION_DENIED', 'untrusted'); });
+ registerProviderHandlers(harness, makeDeps({ detectProvider, assertTrustedSender: guard }));
+ await expect(harness.invokeFrom(1, MAKER_INVOKE.PROVIDER_DETECT, input)).rejects.toThrow(/PERMISSION_DENIED/);
+ guard.mockImplementation(() => undefined);
+ for (const invalid of [{ ...input, requestId: '../other' }, { ...input, savedProviderId: 'saved' }, { ...input, baseUrl: 'file:///tmp/key' }, { ...input, headers: { bad: 1 } }]) {
+ await expect(harness.invokeFrom(1, MAKER_INVOKE.PROVIDER_DETECT, invalid)).rejects.toThrow(/INVALID_PARAMS/);
+ }
+ expect(detectProvider).not.toHaveBeenCalled();
+ });
+ it('discards a replaced result without deleting the newer detection operation', async () => {
+ const harness = new IpcHarness();
+ const pending: { signal: AbortSignal; finish: (value: any) => void }[] = [];
+ registerProviderHandlers(harness, makeDeps({ detectProvider: (_spec, signal) => new Promise(resolve => {
+ pending.push({ signal, finish: resolve });
+ }) }));
+ const first = harness.invokeFrom(1, MAKER_INVOKE.PROVIDER_DETECT, input);
+ const second = harness.invokeFrom(1, MAKER_INVOKE.PROVIDER_DETECT, { ...input, requestId: 'draft-2' });
+ expect(pending[0].signal.aborted).toBe(true);
+ pending[0].finish({ candidates: ['sub2api'], reason: 'matched' });
+ expect(await first).toEqual({ candidates: [], reason: 'insufficient_evidence' });
+ await harness.invokeFrom(1, MAKER_INVOKE.PROVIDER_DETECT, { requestId: 'draft-1', cancel: true });
+ expect(pending[1].signal.aborted).toBe(false);
+ await harness.invokeFrom(1, MAKER_INVOKE.PROVIDER_DETECT, { requestId: 'draft-2', cancel: true });
+ expect(pending[1].signal.aborted).toBe(true);
+ pending[1].finish({ candidates: ['litellm'], reason: 'matched' });
+ expect(await second).toEqual({ candidates: [], reason: 'insufficient_evidence' });
+ });
+ it('isolates cancellations by sender and request, and cancels destroyed windows', async () => {
+ const harness = new IpcHarness();
+ const signals: AbortSignal[] = [];
+ registerProviderHandlers(harness, makeDeps({ detectProvider: async (_spec, signal) => {
+ signals.push(signal);
+ await new Promise<void>(resolve => signal.addEventListener('abort', () => resolve(), { once: true }));
+ return { candidates: [], reason: 'insufficient_evidence' };
+ } }));
+ const first = harness.invokeFrom(1, MAKER_INVOKE.PROVIDER_DETECT, input);
+ const second = harness.invokeFrom(2, MAKER_INVOKE.PROVIDER_DETECT, input);
+ await harness.invokeFrom(1, MAKER_INVOKE.PROVIDER_DETECT, { requestId: 'old-draft', cancel: true });
+ expect(signals.map(s => s.aborted)).toEqual([false, false]);
+ await harness.invokeFrom(1, MAKER_INVOKE.PROVIDER_DETECT, { requestId: 'draft-1', cancel: true });
+ expect(signals.map(s => s.aborted)).toEqual([true, false]);
+ harness.destroySender(2);
+ await Promise.all([first, second]);
+ expect(signals[1].aborted).toBe(true);
+ });
+});
+
+// New probe lifecycle shares the existing IPC, with sender-owned cancellation and no secret echo.
+describe('one-click protocol test ownership', () => {
+ const request = { kind: 'adhoc', requestId: 'probe-test', strategy: 'auto', spec: {
+ agent: 'pi', authMethod: 'apiKey', baseUrl: 'https://relay.example/v1', modelId: 'test', apiKey: 'fake-key',
+ } };
+ it('forwards the automatic strategy and cancels only the owning renderer operation', async () => {
+ const harness = new IpcHarness();
+ let signal!: AbortSignal;
+ let finish!: (result: { ok: boolean; latencyMs: number }) => void;
+ const testConnection = vi.fn((_input: unknown, current?: AbortSignal) => { signal = current!; return new Promise<{ ok: boolean; latencyMs: number }>(resolve => { finish = resolve; }); });
+ registerProviderHandlers(harness, makeDeps({ testConnection }));
+ const pending = harness.invokeFrom(7, MAKER_INVOKE.PROVIDER_TEST_CONNECTION, request);
+ await harness.invokeFrom(8, MAKER_INVOKE.PROVIDER_TEST_CONNECTION, { kind: 'cancel', requestId: request.requestId });
+ expect(signal.aborted).toBe(false);
+ await expect(harness.invokeFrom(7, MAKER_INVOKE.PROVIDER_TEST_CONNECTION, request)).rejects.toThrow(/PRECONDITION_FAILED/);
+ await harness.invokeFrom(7, MAKER_INVOKE.PROVIDER_TEST_CONNECTION, { kind: 'cancel', requestId: request.requestId });
+ expect(signal.aborted).toBe(true);
+ finish({ ok: true, latencyMs: 1 });
+ expect(await pending).toMatchObject({ ok: false, decision: 'cancelled' });
+ expect(testConnection).toHaveBeenCalledOnce();
+ expect(testConnection.mock.calls[0][0]).toMatchObject(request);
+ });
+ it.each([
+ { ...request, spec: { ...request.spec, agent: 'codex' } },
+ { ...request, spec: { ...request.spec, catalogPresetId: 'google-gemini-api' } },
+ { ...request, spec: { ...request.spec, api: 'google-vertex' } },
+ { ...request, spec: { ...request.spec, baseUrl: 'https://user:[email protected]/v1' } },
+ { ...request, requestId: '../bad' },
+ ])('rejects unsupported strategy or credential binding before executing', async input => {
+ const harness = new IpcHarness();
+ const deps = makeDeps();
+ registerProviderHandlers(harness, deps);
+ await expect(harness.invokeFrom(7, MAKER_INVOKE.PROVIDER_TEST_CONNECTION, input)).rejects.toThrow(/INVALID_PARAMS/);
+ expect(deps.testConnection).not.toHaveBeenCalled();
+ });
+ it('aborts the operation when its renderer is destroyed', async () => {
+ const harness = new IpcHarness();
+ let signal!: AbortSignal;
+ const testConnection = vi.fn((_input: unknown, current?: AbortSignal) => {
+ signal = current!;
+ return new Promise<{ ok: boolean; latencyMs: number }>(resolve => current!.addEventListener('abort', () => resolve({ ok: false, latencyMs: 0 }), { once: true }));
+ });
+ registerProviderHandlers(harness, makeDeps({ testConnection }));
+ const pending = harness.invokeFrom(7, MAKER_INVOKE.PROVIDER_TEST_CONNECTION, request);
+ harness.destroySender(7);
+ expect(signal.aborted).toBe(true);
+ expect(await pending).toMatchObject({ decision: 'cancelled' });
+ });
+});
+ describe('speech additions through the real provider update handler', () => {
+ it('merges into the latest connection, preserving settings, credentials, duplicate IDs and another connection', async () => {
+ mountDb();
+ const harness = new IpcHarness();
+ const deps = makeDeps();
+ registerProviderHandlers(harness, deps);
+ const config: CustomProviderConfig = { id: 'speech-a', name: 'Renamed while dialog open', runtimes: {
+ codex: { baseUrl: 'https://api.minimax.io/v1', wireProtocol: 'openai-chat', models: [
+ { id: 'MiniMax-M3', name: 'My chat', defaultEnabled: false },
+ { id: 'speech-2.8-hd', name: 'My voice', mode: 'audio_speech', defaultEnabled: false },
+ ] },
+ pi: { baseUrl: 'https://api.minimax.io/anthropic', wireProtocol: 'anthropic-messages', models: [{ id: 'MiniMax-M3', name: 'Pi chat' }] },
+ } };
+ await harness.invoke(MAKER_INVOKE.PROVIDER_CUSTOM_CREATE, config);
+ await harness.invoke(MAKER_INVOKE.PROVIDER_CUSTOM_CREATE, { ...config, id: 'speech-b' });
+ vi.mocked(deps.storeCustomProviderKey).mockClear();
+ vi.mocked(deps.removeCustomProviderKey).mockClear();
+ const result = await harness.invoke(MAKER_INVOKE.PROVIDER_CUSTOM_UPDATE, {
+ ...config, name: 'Stale name', runtimes: { codex: { ...config.runtimes.codex, models: [
+ { id: 'speech-2.8-turbo', name: 'Speech 2.8 Turbo' },
+ { id: 'speech-2.8-hd', name: 'Overwrite attempt', mode: 'audio_speech' },
+ ] } },
+ }, {}, { appendSpeechModelsOnly: true });
+ expect(result).toEqual({ ok: true });
+ const saved = await getCustomProvider(config.id);
+ expect(saved?.name).toBe(config.name);
+ expect(saved?.runtimes.pi).toEqual(config.runtimes.pi);
+ expect(saved?.runtimes.codex?.models).toEqual([...config.runtimes.codex!.models, { id: 'speech-2.8-turbo', name: 'Speech 2.8 Turbo' }]);
+ expect((await getCustomProvider('speech-b'))?.runtimes).toEqual(config.runtimes);
+ expect(deps.storeCustomProviderKey).not.toHaveBeenCalled();
+ expect(deps.removeCustomProviderKey).not.toHaveBeenCalled();
+ });
+ it('rejects stale endpoints and attempts to replace credentials without changing membership', async () => {
+ mountDb();
+ const harness = new IpcHarness();
+ const deps = makeDeps();
+ registerProviderHandlers(harness, deps);
+ await harness.invoke(MAKER_INVOKE.PROVIDER_CUSTOM_CREATE, validConfig);
+ const request = { ...validConfig, runtimes: { codex: { ...validConfig.runtimes.codex, models: [{ id: 'speech-2.8-turbo', name: 'Speech' }] } } };
+ await expect(harness.invoke(MAKER_INVOKE.PROVIDER_CUSTOM_UPDATE, request, { codex: 'fake-replacement' }, { appendSpeechModelsOnly: true })).rejects.toThrow(/INVALID_PARAMS/);
+ await expect(harness.invoke(MAKER_INVOKE.PROVIDER_CUSTOM_UPDATE, { ...request, runtimes: { codex: { ...request.runtimes.codex, baseUrl: 'https://changed.example/v1' } } }, {}, { appendSpeechModelsOnly: true })).rejects.toThrow(/INVALID_PARAMS/);
+ expect((await getCustomProvider(validConfig.id))?.runtimes).toEqual(validConfig.runtimes);
+ });
+ });
+
+ // A saved explicit default becomes omitted in ProviderView; opening Settings must not make it stale.
+ it('speech additions accept an unchanged projected default protocol and preserve its declaration', async () => {
+ mountDb();
+ const harness = new IpcHarness();
+ registerProviderHandlers(harness, makeDeps());
+ const config: CustomProviderConfig = { id: 'legacy-speech', name: 'Legacy', runtimes: {
+ codex: { baseUrl: 'https://api.openai.com/v1', wireProtocol: 'openai-responses', models: [{ id: 'gpt-5.4', name: 'Chat' }] },
+ pi: { baseUrl: 'https://api.openai.com/v1', wireProtocol: 'openai-chat', models: [{ id: 'tts-1', name: 'Already added', defaultEnabled: false }] },
+ } };
+ await harness.invoke(MAKER_INVOKE.PROVIDER_CUSTOM_CREATE, config);
+ await expect(harness.invoke(MAKER_INVOKE.PROVIDER_CUSTOM_UPDATE, { ...config, runtimes: {
+ codex: { baseUrl: config.runtimes.codex!.baseUrl, models: [{ id: 'gpt-4o-mini-tts', name: 'Speech' }, { id: 'tts-1', name: 'Duplicate' }] },
+ } }, {}, { appendSpeechModelsOnly: true })).resolves.toEqual({ ok: true });
+ const stored = await getCustomProvider(config.id);
+ expect(stored?.runtimes.codex?.wireProtocol).toBe('openai-responses');
+ expect(stored?.runtimes.codex?.models.map(model => model.id)).toEqual(['gpt-5.4', 'gpt-4o-mini-tts']);
+ expect(stored?.runtimes.pi).toEqual(config.runtimes.pi);
+ });
+
+ // Review regression: real catalog projection + update handler. A current preset can
+ // replace a stored directory URL without changing the connection. Existing tests
+ // only compared raw snapshots, so they missed this failed save (DB tier, no network).
+ it.each([undefined, 'https://api.minimax.io/v1/old-models'])(
+ 'appends speech against the current preset while preserving stored modelsUrl %s',
+ async (modelsUrl) => {
+ mountDb();
+ const harness = new IpcHarness();
+ const config: CustomProviderConfig = { id: 'preset-speech', name: 'My MiniMax', runtimes: {
+ codex: { catalogPresetId: 'minimax-api', baseUrl: 'https://api.minimax.io/v1',
+ modelsUrl, models: [{ id: 'MiniMax-M3', name: 'My chat' }] },
+ } };
+ const presets: ProviderPreset[] = [{ id: 'minimax-api', name: 'MiniMax API', runtimes: {
+ codex: { baseUrl: 'https://api.minimax.io/v1', modelsUrl: 'https://api.minimax.io/v1/current-models', models: [] },
+ } }];
+ registerProviderHandlers(harness, makeDeps({ listPresets: () => presets }));
+ await harness.invoke(MAKER_INVOKE.PROVIDER_CUSTOM_CREATE, config);
+ const projected = buildUserProvider(config, { presets });
+ const request = providerViewToCustomProviderConfig({ ...projected, connected: true } as ProviderView);
+ request.runtimes.codex!.models = [{ id: 'speech-2.8-turbo', name: 'Speech' }];
+ expect(request.runtimes.codex!.modelsUrl).toBe(presets[0].runtimes.codex!.modelsUrl);
+ // A dialog from before the preset update is genuinely stale; reopening fixes it.
+ const stale = structuredClone(request);
+ stale.runtimes.codex!.modelsUrl = 'https://api.minimax.io/v1/stale-models';
+ await expect(harness.invoke(MAKER_INVOKE.PROVIDER_CUSTOM_UPDATE, stale, {}, { appendSpeechModelsOnly: true })).rejects.toThrow(/INVALID_PARAMS/);
+ await expect(harness.invoke(MAKER_INVOKE.PROVIDER_CUSTOM_UPDATE, request, {}, { appendSpeechModelsOnly: true })).resolves.toEqual({ ok: true });
+ expect((await getCustomProvider(config.id))?.runtimes.codex).toEqual({
+ ...config.runtimes.codex, models: [...config.runtimes.codex!.models, ...request.runtimes.codex!.models],
+ });
+ },
+ );
diff --cc apps/desktop/src/main/maker-ipc/providerHandlers.ts
index 9feb40edc7,9c5f309d73..4ab39e848a
--- a/apps/desktop/src/main/maker-ipc/providerHandlers.ts
+++ b/apps/desktop/src/main/maker-ipc/providerHandlers.ts
@@@ -1,5 -1,5 +1,6 @@@
+ import { appendSpeechModels } from '../../shared/speechProviderSetup.js';
import { setProviderPresentation, retainProviderPresentationAfterAuthChange } from '../maker-host/provider-presentation-store.js';
+import type { DeploymentDetectionResult } from '../../shared/providerDetection.js';
import { pruneProviderGroupBindings } from '../provider-group/bindings.js';
import { writeProviderGroup } from '../provider-group/store.js';
/**
diff --cc apps/desktop/src/renderer/__tests__/addProviderWizardPresetEntry.test.tsx
index ddcce6c00f,795bfd8141..122ab18a33
--- a/apps/desktop/src/renderer/__tests__/addProviderWizardPresetEntry.test.tsx
+++ b/apps/desktop/src/renderer/__tests__/addProviderWizardPresetEntry.test.tsx
@@@ -1494,194 -1503,319 +1503,510 @@@ it('sets up Sub2API from one site addre
}
});
+// Scheme-2 handoff must keep connection ownership and user choices; the managed-local
+// entry tests above do not cover an independently addressed LM Studio deployment.
+describe('identified provider handoff', () => {
+ const model = { id: 'private-alias', name: 'My model', contextWindow: 4096, route: { baseUrl: 'https://relay.example/team/v1', wireProtocol: 'openai-chat' as const } };
+ const detected = {
+ agent: 'pi' as const, apiKey: 'fake-key', keys: { pi: 'fake-key' },
+ preset: { id: 'lmstudio', name: 'LM Studio', runtimes: { pi: {
+ baseUrl: 'https://relay.example/team/v1', baseUrlEditable: true, wireProtocol: 'openai-chat' as const,
+ headers: { 'X-Project': 'test' }, models: [],
+ } } },
+ config: { id: 'draft', name: 'My remote server', runtimes: { pi: { baseUrl: 'https://relay.example/team/v1', models: [model] } } },
+ catalog: { ok: true, models: [{ id: 'private-alias', name: 'Upstream name' }, { id: 'unselected', name: 'Another' }] },
+ };
+ it.each([false, true])('saves an independent connection and retains overrides on its edited endpoint: %s', async edited => {
+ const managed = { ...anthropicProvider, id: 'cindy-local-lmstudio', name: 'LM Studio', source: 'user' } as ProviderView;
+ render(<AddProviderWizard providers={[managed]} detected={detected} onClose={vi.fn()} onDone={vi.fn()} onOpenCustomForm={vi.fn()} />);
+ const baseUrl = edited ? 'https://new-relay.example/team/v1' : detected.config.runtimes.pi.baseUrl;
+ if (edited) vi.mocked(window.electronAPI.maker.fetchProviderModels).mockResolvedValue(detected.catalog);
+ if (edited) fireEvent.change(await screen.findByDisplayValue(detected.config.runtimes.pi.baseUrl), { target: { value: baseUrl } });
+ fireEvent.click(await screen.findByRole('button', { name: 'settings.providers.wizard.next' }));
+ const finish = await screen.findByRole('button', { name: 'settings.providers.wizard.finish' });
+ await waitFor(() => expect(finish.hasAttribute('disabled')).toBe(false));
+ if (!edited) expect(window.electronAPI.maker.fetchProviderModels).not.toHaveBeenCalled();
+ fireEvent.click(finish);
+ await waitFor(() => expect(createCustomProvider).toHaveBeenCalledOnce());
+ const [config, keys] = vi.mocked(createCustomProvider).mock.calls[0];
+ expect(config.id).not.toBe('cindy-local-lmstudio');
+ expect(config.runtimes.pi).toMatchObject({ baseUrl, wireProtocol: 'openai-chat', headers: { 'X-Project': 'test' } });
+ expect(config.runtimes.pi!.models.find(m => m.id === 'private-alias')).toMatchObject({ ...model, route: { ...model.route, baseUrl } });
+ expect(config.runtimes.pi!.models.find(m => m.id === 'unselected')?.defaultEnabled).toBe(false);
+ expect(keys).toEqual({ pi: 'fake-key' });
+ });
+ it.each([true, false])('current checkbox overrides an old disabled draft: checked=%s', async checked => {
+ const handoff = { ...detected, config: { ...detected.config, runtimes: { pi: {
+ ...detected.config.runtimes.pi, models: [{ ...model, defaultEnabled: false }, { id: 'keep', name: 'Keep' }],
+ } } } };
+ render(<AddProviderWizard providers={[]} detected={handoff} onClose={vi.fn()} onDone={vi.fn()} onOpenCustomForm={vi.fn()} />);
+ fireEvent.click(await screen.findByRole('button', { name: 'settings.providers.wizard.next' }));
+ const finish = await screen.findByRole('button', { name: 'settings.providers.wizard.finish' });
+ await waitFor(() => expect(finish.hasAttribute('disabled')).toBe(false));
+ if (!checked) fireEvent.click(screen.getByText('Upstream name'));
+ fireEvent.click(finish);
+ await waitFor(() => expect(createCustomProvider).toHaveBeenCalledOnce());
+ const saved = vi.mocked(createCustomProvider).mock.calls[0][0].runtimes.pi!.models.find(m => m.id === model.id)!;
+ expect(saved.defaultEnabled).toBe(checked ? undefined : false);
+ expect(saved).toMatchObject({ contextWindow: model.contextWindow, route: model.route });
+ });
+ it.each([true, false])('returns the current selection without reviving disabled flags: %s', async checked => {
+ const handoff = { ...detected, config: { ...detected.config, runtimes: { pi: {
+ ...detected.config.runtimes.pi, models: [{ ...model, defaultEnabled: false }, { id: 'keep', name: 'Keep' }],
+ } } } };
+ const onReturnCustom = vi.fn();
+ render(<AddProviderWizard providers={[]} detected={handoff} onReturnCustom={onReturnCustom} onClose={vi.fn()} onDone={vi.fn()} onOpenCustomForm={vi.fn()} />);
+ fireEvent.click(await screen.findByRole('button', { name: 'settings.providers.wizard.next' }));
+ const finish = await screen.findByRole('button', { name: 'settings.providers.wizard.finish' });
+ await waitFor(() => expect(finish.hasAttribute('disabled')).toBe(false));
+ if (!checked) fireEvent.click(screen.getByText('Upstream name'));
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.wizard.back' }));
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.wizard.back' }));
+ const models = onReturnCustom.mock.calls[0][0].config.runtimes.pi.models;
+ const returned = models.find((m: { id: string }) => m.id === model.id);
+ if (checked) {
+ expect(returned.defaultEnabled).toBeUndefined();
+ expect(returned).toMatchObject({ contextWindow: model.contextWindow, route: model.route });
+ } else expect(returned).toBeUndefined();
+ expect(models.some((m: { id: string }) => m.id === 'keep')).toBe(true);
+ expect(createCustomProvider).not.toHaveBeenCalled();
+ });
+ it('saves the explicit native image option carried by a Codex handoff', async () => {
+ const runtime = { ...detected.preset.runtimes.pi, wireProtocol: 'openai-responses' as const, supportsImageGeneration: true };
+ const handoff = { ...detected, agent: 'codex' as const, keys: { codex: 'fake-key' },
+ preset: { ...detected.preset, runtimes: { codex: runtime } },
+ config: { ...detected.config, runtimes: { codex: { ...runtime, models: [{ id: 'private-alias', name: 'Model' }] } } },
+ };
+ render(<AddProviderWizard providers={[]} detected={handoff} onClose={vi.fn()} onDone={vi.fn()} onOpenCustomForm={vi.fn()} />);
+ fireEvent.click(await screen.findByRole('button', { name: 'settings.providers.wizard.next' }));
+ const finish = await screen.findByRole('button', { name: 'settings.providers.wizard.finish' });
+ await waitFor(() => expect(finish.hasAttribute('disabled')).toBe(false));
+ fireEvent.click(finish);
+ await waitFor(() => expect(createCustomProvider).toHaveBeenCalledOnce());
+ expect(vi.mocked(createCustomProvider).mock.calls[0][0].runtimes.codex).toMatchObject({ supportsImageGeneration: true, wireProtocol: 'openai-responses' });
+ });
+ it('retains a hand-entered model when OpenRouter returns a complete public catalog', async () => {
+ const baseUrl = 'https://openrouter.ai/api/v1';
+ const handoff = { ...detected,
+ preset: { ...detected.preset, id: 'openrouter', name: 'OpenRouter', runtimes: { pi: { ...detected.preset.runtimes.pi, baseUrl } } },
+ config: { ...detected.config, runtimes: { pi: { baseUrl, models: [{ ...model, route: { ...model.route, baseUrl } }] } } },
+ catalog: { ok: true, models: [{ id: 'public-only', name: 'Public' }] },
+ };
+ render(<AddProviderWizard providers={[]} detected={handoff} onClose={vi.fn()} onDone={vi.fn()} onOpenCustomForm={vi.fn()} />);
+ fireEvent.click(await screen.findByRole('button', { name: 'settings.providers.wizard.next' }));
+ const finish = await screen.findByRole('button', { name: 'settings.providers.wizard.finish' });
+ await waitFor(() => expect(finish.hasAttribute('disabled')).toBe(false));
+ expect(screen.getByText('My model')).toBeTruthy();
+ fireEvent.click(finish);
+ await waitFor(() => expect(createCustomProvider).toHaveBeenCalledOnce());
+ expect(vi.mocked(createCustomProvider).mock.calls[0][0].runtimes.pi!.models.find(m => m.id === model.id)).toMatchObject({ id: model.id, contextWindow: 4096 });
+ });
+ it('preserves hand-entered models for every inherited engine and never fetches an independent draft', async () => {
+ const runtime = detected.preset.runtimes.pi;
+ const own = { baseUrl: 'https://independent.example/anthropic', models: [{ id: 'own-only', name: 'Own' }] };
+ const handoff = { ...detected,
+ preset: { ...detected.preset, runtimes: { pi: runtime, codex: { ...runtime } } },
+ keys: { pi: 'fake-key', codex: 'fake-key', 'claude-code': 'own-key' },
+ config: { ...detected.config, runtimes: { pi: detected.config.runtimes.pi, codex: { ...detected.config.runtimes.pi }, 'claude-code': own } },
+ };
+ vi.mocked(window.electronAPI.maker.fetchProviderModels).mockResolvedValue({ ok: true, models: [{ id: 'directory-only', name: 'Directory' }] });
+ render(<AddProviderWizard providers={[]} detected={handoff} onClose={vi.fn()} onDone={vi.fn()} onOpenCustomForm={vi.fn()} />);
+ fireEvent.click(await screen.findByRole('button', { name: 'settings.providers.wizard.next' }));
+ const finish = await screen.findByRole('button', { name: 'settings.providers.wizard.finish' });
+ await waitFor(() => expect(finish.hasAttribute('disabled')).toBe(false));
+ fireEvent.click(finish);
+ await waitFor(() => expect(createCustomProvider).toHaveBeenCalledOnce());
+ const [config, keys] = vi.mocked(createCustomProvider).mock.calls[0];
+ expect(config.runtimes.codex!.models.some(m => m.id === 'private-alias')).toBe(true);
+ expect(config.runtimes['claude-code']).toEqual(own);
+ expect(keys['claude-code']).toBe('own-key');
+ expect(vi.mocked(window.electronAPI.maker.fetchProviderModels).mock.calls.every(([request]) => request.baseUrl !== own.baseUrl)).toBe(true);
+ });
+ it('returns selected models only to their own engine with its discovery metadata', async () => {
+ const onReturnCustom = vi.fn();
+ const runtime = detected.preset.runtimes.pi;
+ const handoff = { ...detected, preset: { ...detected.preset, runtimes: { pi: runtime, codex: { ...runtime } } },
+ config: { ...detected.config, runtimes: { pi: detected.config.runtimes.pi, codex: { ...detected.config.runtimes.pi } } },
+ };
+ vi.mocked(window.electronAPI.maker.fetchProviderModels).mockResolvedValue({ ok: true, models: [
+ { id: 'codex-exclusive', name: 'Only Codex', discoveredMetadata: { contextWindow: 50000 } },
+ ] });
+ render(<AddProviderWizard providers={[]} detected={handoff} onReturnCustom={onReturnCustom} onClose={vi.fn()} onDone={vi.fn()} onOpenCustomForm={vi.fn()} />);
+ fireEvent.click(await screen.findByRole('button', { name: 'settings.providers.wizard.next' }));
+ fireEvent.click(await screen.findByText('Only Codex'));
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.wizard.back' }));
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.wizard.back' }));
+ const runtimes = onReturnCustom.mock.calls[0][0].config.runtimes;
+ expect(runtimes.pi.models.some((m: { id: string }) => m.id === 'codex-exclusive')).toBe(false);
+ expect(runtimes.codex.models.find((m: { id: string }) => m.id === 'codex-exclusive')).toMatchObject({ discoveredMetadata: { contextWindow: 50000 } });
+ });
+ it('retains a non-active engine URL edited inside the identified wizard when returning', async () => {
+ const onReturnCustom = vi.fn();
+ const codexUrl = 'https://relay.example/codex/v1';
+ const handoff = { ...detected, preset: { ...detected.preset, runtimes: { ...detected.preset.runtimes,
+ codex: { ...detected.preset.runtimes.pi, baseUrl: codexUrl },
+ } }, config: { ...detected.config, runtimes: { ...detected.config.runtimes, codex: { ...detected.config.runtimes.pi } } } };
+ render(<AddProviderWizard providers={[]} detected={handoff} onReturnCustom={onReturnCustom} onClose={vi.fn()} onDone={vi.fn()} onOpenCustomForm={vi.fn()} />);
+ fireEvent.change(await screen.findByDisplayValue(codexUrl), { target: { value: 'https://edited.example/v1' } });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.wizard.back' }));
+ expect(onReturnCustom.mock.calls[0][0].config.runtimes.codex.baseUrl).toBe('https://edited.example/v1');
+ expect(onReturnCustom.mock.calls[0][0].config.runtimes.pi.baseUrl).toBe(detected.config.runtimes.pi.baseUrl);
+ });
+ it('returns shared URL/key edits without replacing an independent engine draft', async () => {
+ const onReturnCustom = vi.fn();
+ const shared = detected.config.runtimes.pi;
+ const handoff = { ...detected, preset: { ...detected.preset, runtimes: { ...detected.preset.runtimes, codex: { ...detected.preset.runtimes.pi, baseUrl: 'https://relay.example/codex/v1' } } }, keys: { pi: 'fake-key', codex: 'fake-key', 'claude-code': 'independent-key' },
+ config: { ...detected.config, runtimes: { pi: shared, codex: { ...shared },
+ 'claude-code': { baseUrl: 'https://independent.example/anthropic', models: [{ id: 'own-model', name: 'Own' }] },
+ } },
+ };
+ render(<AddProviderWizard providers={[]} detected={handoff} onReturnCustom={onReturnCustom} onClose={vi.fn()} onDone={vi.fn()} onOpenCustomForm={vi.fn()} />);
+ fireEvent.change(await screen.findByPlaceholderText('sk-…'), { target: { value: 'edited-fake-key' } });
+ fireEvent.change(screen.getByDisplayValue(shared.baseUrl), { target: { value: 'https://new-relay.example/v1' } });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.wizard.back' }));
+ const returned = onReturnCustom.mock.calls[0][0];
+ expect(returned.keys).toEqual({ pi: 'edited-fake-key', codex: 'edited-fake-key', 'claude-code': 'independent-key' });
+ expect(returned.config.runtimes.codex.baseUrl).toBe('https://new-relay.example/v1');
+ expect(returned.config.runtimes['claude-code']).toEqual(handoff.config.runtimes['claude-code']);
+ expect(returned.catalog).toBeUndefined();
+ });
+ it.each([true, false])('keeps an excluded runtime unchanged even when its key and address overlap: %s', async sameAddress => {
+ const own = { ...detected.config.runtimes.pi,
+ baseUrl: sameAddress ? detected.config.runtimes.pi.baseUrl : 'https://independent.example/v1',
+ requestPath: '/independent/messages',
+ };
+ const handoff = { ...detected, keys: { pi: 'fake-key', 'claude-code': 'fake-key' },
+ config: { ...detected.config, runtimes: { ...detected.config.runtimes, 'claude-code': own } } };
+ const onReturnCustom = vi.fn();
+ render(<AddProviderWizard providers={[]} detected={handoff} onReturnCustom={onReturnCustom} onClose={vi.fn()} onDone={vi.fn()} onOpenCustomForm={vi.fn()} />);
+ fireEvent.change(await screen.findByPlaceholderText('sk-…'), { target: { value: 'new-shared-key' } });
+ fireEvent.change(screen.getByDisplayValue(detected.config.runtimes.pi.baseUrl), { target: { value: 'https://new.example/v1' } });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.wizard.back' }));
+ expect(onReturnCustom.mock.calls[0][0].keys['claude-code']).toBe('fake-key');
+ expect(onReturnCustom.mock.calls[0][0].config.runtimes['claude-code']).toEqual(own);
+ });
+ it('returns the draft instead of navigating to the provider gallery, keeping edited credentials', async () => {
+ const onReturnCustom = vi.fn();
+ render(<AddProviderWizard providers={[]} detected={detected} onReturnCustom={onReturnCustom} onClose={vi.fn()} onDone={vi.fn()} onOpenCustomForm={vi.fn()} />);
+ fireEvent.change(await screen.findByPlaceholderText('sk-…'), { target: { value: 'edited-fake-key' } });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.wizard.back' }));
+ expect(onReturnCustom).toHaveBeenCalledWith(expect.objectContaining({ apiKey: 'edited-fake-key', config: expect.objectContaining({ name: 'My remote server' }) }));
+ expect(createCustomProvider).not.toHaveBeenCalled();
+ });
+});
+ describe('speech models in the existing provider wizard', () => {
+ // PR #6768 unit regression: speech choices must be reached before a long chat
+ // catalog. Existing setup tests checked membership/defaults, never reading order.
+ it('puts Aliyun speech choices before the discovered general catalog and keeps the recommendation selected', async () => {
+ vi.mocked(window.electronAPI.maker.fetchProviderModels).mockResolvedValue({ ok: true, models:
+ Array.from({ length: 100 }, (_, index) => ({ id: `chat-${index}`, name: `Chat ${index}`, mode: 'chat' })),
+ });
+ await enter('aliyun-bailian-api-cn');
+ const speech = await screen.findByRole('checkbox', { name: /qwen3-tts-flash/ });
+ const firstChat = screen.getByText('Chat 0');
+ expect(speech.compareDocumentPosition(firstChat) & Node.DOCUMENT_POSITION_FOLLOWING).toBeTruthy();
+ expect(speech.getAttribute('aria-checked')).toBe('true');
+ expect(screen.queryByRole('checkbox', { name: /cosyvoice/ })).toBeNull();
+ });
+ it('reuses server API presets instead of duplicating the same speech service entry', async () => {
+ window.electronAPI.maker.listProviderPresets = vi.fn(async () => ({ presets: [{
+ id: 'aliyun-model-studio-global', name: 'Server Model Studio', runtimes: {
+ codex: { baseUrl: 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1', models: [] },
+ },
+ }] }));
+ render(<AddProviderWizard providers={[]} onClose={vi.fn()} onDone={vi.fn()} onOpenCustomForm={vi.fn()} />);
+ const serverPreset = await screen.findByRole('button', { name: /Server Model Studio/ });
+ expect(screen.queryByText('阿里云百炼 API')).toBeNull();
+ expect(screen.getByText('阿里云百炼 API(中国大陆)')).toBeTruthy();
+ fireEvent.click(serverPreset);
+ fireEvent.change(await screen.findByPlaceholderText('sk-…'), { target: { value: 'fake-test-key' } });
+ fireEvent.click(screen.getByText('settings.providers.wizard.next'));
+ expect((await screen.findByRole('checkbox', { name: /qwen3-tts-flash/ })).getAttribute('aria-checked')).toBe('true');
+ });
+ async function enter(presetId: string, speechOnly = false) {
+ render(<AddProviderWizard providers={[]} entry={{ kind: 'preset', presetId, speechOnly }} onClose={vi.fn()} onDone={vi.fn()} onOpenCustomForm={vi.fn()} />);
+ fireEvent.change(await screen.findByPlaceholderText('sk-…'), { target: { value: 'fake-test-key' } });
+ fireEvent.click(screen.getByText('settings.providers.wizard.next'));
+ await waitFor(() => expect(screen.queryByText('settings.providers.wizard.fetching')).toBeNull());
+ }
+ it('defaults to one recommended speech model, allows speech-only and does not save unchecked references', async () => {
+ await enter('openai-api', true);
+ const recommended = await screen.findByRole('checkbox', { name: /gpt-4o-mini-tts/i });
+ expect(recommended.getAttribute('aria-checked')).toBe('true');
+ expect(screen.getByRole('checkbox', { name: /tts-1(?!-hd)/i }).getAttribute('aria-checked')).toBe('false');
+ fireEvent.click(screen.getByText('settings.providers.wizard.finish'));
+ await waitFor(() => expect(createCustomProvider).toHaveBeenCalled());
+ const config = vi.mocked(createCustomProvider).mock.calls[0][0];
+ const enabled = Object.values(config.runtimes).flatMap(rt => rt?.models.filter(model => model.defaultEnabled !== false) ?? []);
+ expect(enabled.map(model => model.id)).toEqual(['gpt-4o-mini-tts']);
+ expect(config.runtimes.codex?.models.some(model => model.id === 'tts-1')).toBe(false);
+ expect(updateCustomProvider).not.toHaveBeenCalled();
+ });
+ it('supports ElevenLabs discovery and explicit false revokes a recommended offline TTS model', async () => {
+ vi.mocked(window.electronAPI.maker.fetchProviderModels).mockResolvedValue({ ok: true, models: parseModelsListResponse([
+ { model_id: 'eleven_flash_v2_5', can_do_text_to_speech: false },
+ { model_id: 'new-voice-model', name: 'New speech model', can_do_text_to_speech: true },
+ ])! });
+ await enter('elevenlabs-api');
+ expect(screen.queryByRole('checkbox', { name: /eleven_flash_v2_5/ })).toBeNull();
+ fireEvent.click(screen.getByText('settings.providers.speechSetup.more'));
+ const discovered = screen.getByRole('checkbox', { name: /New speech model/ });
+ fireEvent.click(discovered);
+ fireEvent.click(screen.getByText('settings.providers.wizard.finish'));
+ await waitFor(() => expect(createCustomProvider).toHaveBeenCalled());
+ const models = vi.mocked(createCustomProvider).mock.calls[0][0].runtimes.codex!.models;
+ expect(models.find(model => model.id === 'new-voice-model')?.discoveredMetadata?.mode).toBe('audio_speech');
+ expect(models.find(model => model.id === 'eleven_flash_v2_5')?.defaultEnabled).toBe(false);
+ });
+ it('retains a user deselection and manual speech ID in the saved connection', async () => {
+ await enter('elevenlabs-api');
+ fireEvent.click(screen.getByRole('checkbox', { name: /eleven_flash_v2_5/i }));
+ fireEvent.click(screen.getByText('settings.providers.speechSetup.manual'));
+ fireEvent.change(screen.getByRole('textbox', { name: 'settings.providers.speechSetup.modelId' }), { target: { value: 'my-private-speech-model' } });
+ fireEvent.click(screen.getByText('settings.providers.wizard.addManualModel'));
+ fireEvent.click(screen.getByText('settings.providers.wizard.finish'));
+ await waitFor(() => expect(createCustomProvider).toHaveBeenCalled());
+ expect(vi.mocked(createCustomProvider).mock.calls[0][0].runtimes.codex?.models).toEqual([
+ expect.objectContaining({ id: 'my-private-speech-model', mode: 'audio_speech' }),
+ ]);
+ });
+ // #6768 review regression (unit): the actual wizard saves an unchecked discovered
+ // TTS model, then the management switch must restore its companion picker entry.
+ // Existing tests stopped at defaultEnabled:false or disabled every saved addition.
+ it('can show a previously unchecked discovered speech model through model management', async () => {
+ const syncVisibility = vi.fn<(owner: string, generation: number, overrides: Record<string, boolean>) => Promise<void>>(async () => undefined);
+ Object.assign(window.electronAPI.maker, {
+ claimLegacyModelVisibilityOwner: () => ({ dataOwnerId: 'speech-review', ownerGeneration: 1,
+ canWriteOwnerScoped: true, claimed: true, claimedByOtherOwner: false,
+ canInitialize: true, profileOrigin: 'new' }),
+ syncModelVisibility: syncVisibility,
+ });
+ await setModelVisibilityOwner('speech-review', 1, 'cloud');
+ try {
+ vi.mocked(window.electronAPI.maker.fetchProviderModels).mockResolvedValue({ ok: true, models: [
+ { id: 'my-later-tts', name: 'Later speech', discoveredMetadata: { mode: 'audio_speech' } },
+ ] });
+ await enter('elevenlabs-api');
+ fireEvent.click(screen.getByText('settings.providers.wizard.finish'));
+ await waitFor(() => expect(createCustomProvider).toHaveBeenCalledTimes(1));
+ const config = vi.mocked(createCustomProvider).mock.calls[0][0];
+ expect(config.runtimes.codex?.models.find(model => model.id === 'my-later-tts')?.defaultEnabled).toBe(false);
+ const provider = buildUserProvider(config);
+ const other = buildUserProvider({ ...config, id: 'another-connection' });
+ const deps = {
+ catalog: { ...BUNDLED_CATALOG, providers: [provider, other] },
+ gatewayAllowed: false, disabled: () => false, readKey: () => 'fake-key',
+ gatewayConnection: () => ({ baseUrl: '', apiKey: '' }),
+ visibilityOverride: (agent: string, providerId: string, modelId: string) =>
+ (syncVisibility.mock.lastCall?.[2] as Record<string, boolean> | undefined)?.[`${agent}:${providerId}:${modelId}`],
+ };
+ cleanup();
+ const view = { ...provider, connected: true,
+ availableMediaModelIds: speechModels(deps).filter(model => model.providerId === provider.id).map(model => model.id) };
+ render(<UnifiedModelList provider={view} focusModelId="my-later-tts" />);
+ const toggle = await screen.findByRole('switch', { name: 'Later speech' });
+ expect((toggle as HTMLButtonElement).disabled).toBe(false);
+ expect(toggle.getAttribute('aria-checked')).toBe('false');
+ fireEvent.click(toggle);
+ await waitFor(() => expect(screen.getByRole('switch', { name: 'Later speech' }).getAttribute('aria-checked')).toBe('true'));
+ expect(speechModels(deps).filter(model => model.id === 'my-later-tts' && model.pickerVisible !== false).map(model => model.providerId)).toEqual([provider.id]);
+ cleanup();
+ render(<UnifiedModelList provider={view} focusModelId="my-later-tts" />);
+ expect((await screen.findByRole('switch', { name: 'Later speech' })).getAttribute('aria-checked')).toBe('true');
+ expect(config.runtimes.codex?.models.find(model => model.id === 'my-later-tts')?.defaultEnabled).toBe(false);
+ } finally {
+ cleanup();
+ resetVisibility();
+ }
+ });
+ });
+
+ // PR #6768 / #6660 integration regression (Renderer unit): the real wizard and
+ // additions dialog must save defaults supported at the configured endpoint.
+ // Previous tests asserted one brand-wide CosyVoice default; a public DashScope
+ // URL is the smallest failing input. No live credentials or synthesis required.
+ describe('Alibaba speech recommendations follow the actual endpoint', () => {
+ const endpoints = [
+ ['https://dashscope.aliyuncs.com/compatible-mode/v1', 'qwen3-tts-flash'],
+ ['https://dashscope-intl.aliyuncs.com/api/v1/', 'qwen3-tts-flash'],
+ ['https://ws-test.cn-beijing.maas.aliyuncs.com/api/v1', 'cosyvoice-v3-flash'],
+ ['https://work-unit.cn-beijing.maas.aliyuncs.com/compatible-mode/v1', 'cosyvoice-v3-flash'],
+ ['https://ws-test.ap-southeast-1.maas.aliyuncs.com/api/v1', 'qwen-audio-3.0-tts-flash'],
+ ['https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1', 'qwen-audio-3.0-tts-plus'],
+ ['https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1', null],
+ ['https://dashscope-us.aliyuncs.com/compatible-mode/v1', null],
+ ] as const;
+ const publicUrl = 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1';
+ async function openWizard(baseUrl: string) {
+ renderWizard('aliyun-bailian-api-global');
+ fireEvent.change(await screen.findByDisplayValue(publicUrl), { target: { value: baseUrl } });
+ fireEvent.change(screen.getByPlaceholderText('sk-…'), { target: { value: 'fake-test-key' } });
+ fireEvent.click(screen.getByText('settings.providers.wizard.next'));
+ await waitFor(() => expect(screen.queryByText('settings.providers.wizard.fetching')).toBeNull());
+ }
+ function expectRecommendation(id: string | null) {
+ const section = screen.getByRole('region', { name: 'settings.providers.speechSetup.title' });
+ const checked = within(section).queryAllByRole('checkbox').filter(row => row.getAttribute('aria-checked') === 'true');
+ expect(checked).toHaveLength(id ? 1 : 0);
+ if (id) {
+ expect(checked[0].textContent).toContain(id);
+ expect(within(checked[0]).getByText('settings.providers.wizard.recommended')).toBeTruthy();
+ } else {
+ expect(within(section).queryByText('settings.providers.wizard.recommended')).toBeNull();
+ }
+ }
+ it.each(endpoints)('new provider uses %s instead of the preset region', async (baseUrl, expected) => {
+ await openWizard(baseUrl);
+ expectRecommendation(expected);
+ if (!expected) return;
+ fireEvent.click(screen.getByText('settings.providers.wizard.finish'));
+ await waitFor(() => expect(createCustomProvider).toHaveBeenCalledTimes(1));
+ const runtime = vi.mocked(createCustomProvider).mock.calls[0][0].runtimes.codex!;
+ expect(runtime.baseUrl).toBe(baseUrl);
+ const speech = runtime.models.filter(model => /tts|cosyvoice/.test(model.id));
+ expect(speech.map(model => model.id)).toEqual([expected]);
+ expect(speech[0].defaultEnabled).not.toBe(false);
+ });
+ it.each(endpoints)('existing provider uses the same recommendation for %s', async (baseUrl, expected) => {
+ const provider = { ...buildUserProvider({ id: 'my-ali', name: 'Alibaba connection', runtimes: {
+ codex: { baseUrl, wireProtocol: 'openai-chat', models: [{ id: 'qwen-plus', name: 'My chat', defaultEnabled: false }] },
+ } }), connected: true } as ProviderView;
+ vi.mocked(updateCustomProvider).mockResolvedValue({ ok: true });
+ render(<AddSpeechModelsDialog provider={provider} onClose={vi.fn()} onSaved={vi.fn()} />);
+ await waitFor(() => expect(screen.queryByText('settings.providers.wizard.fetching')).toBeNull());
+ expectRecommendation(expected);
+ if (!expected) return;
+ fireEvent.click(screen.getByText('settings.providers.wizard.addManualModel'));
+ await waitFor(() => expect(updateCustomProvider).toHaveBeenCalledTimes(1));
+ expect(updateCustomProvider).toHaveBeenCalledWith(expect.objectContaining({
+ runtimes: { codex: expect.objectContaining({ baseUrl, models: [expect.objectContaining({ id: expected, defaultEnabled: true })] }) },
+ }), {}, { appendSpeechModelsOnly: true });
+ });
+ it('recomputes recommendations after going back and editing the endpoint', async () => {
+ await openWizard(publicUrl);
+ expectRecommendation('qwen3-tts-flash');
+ fireEvent.click(screen.getByText('settings.providers.wizard.back'));
+ const workspace = 'https://ws-test.cn-beijing.maas.aliyuncs.com/api/v1';
+ fireEvent.change(await screen.findByDisplayValue(publicUrl), { target: { value: workspace } });
+ fireEvent.click(screen.getByText('settings.providers.wizard.next'));
+ await waitFor(() => expect(screen.queryByText('settings.providers.wizard.fetching')).toBeNull());
+ expectRecommendation('cosyvoice-v3-flash');
+ expect(screen.queryByRole('checkbox', { name: /qwen3-tts-flash/ })).toBeNull();
+ });
+ it('keeps US catalog models unselected and lets the user explicitly add one', async () => {
+ vi.mocked(window.electronAPI.maker.fetchProviderModels).mockResolvedValue({ ok: true, models: [
+ { id: 'cosyvoice-v3-flash', name: 'CosyVoice', discoveredMetadata: { mode: 'audio_speech' } },
+ { id: 'qwen3-tts-flash', name: 'Qwen3', discoveredMetadata: { mode: 'audio_speech' } },
+ ] });
+ await openWizard('https://dashscope-us.aliyuncs.com/compatible-mode/v1');
+ expectRecommendation(null);
+ fireEvent.click(screen.getByRole('checkbox', { name: /cosyvoice-v3-flash/ }));
+ fireEvent.click(screen.getByText('settings.providers.wizard.finish'));
+ await waitFor(() => expect(createCustomProvider).toHaveBeenCalledTimes(1));
+ const models = vi.mocked(createCustomProvider).mock.calls[0][0].runtimes.codex!.models;
+ expect(models.find(model => model.id === 'cosyvoice-v3-flash')).toBeDefined();
+ expect(models.find(model => model.id === 'cosyvoice-v3-flash')?.defaultEnabled).not.toBe(false);
+ expect(models.find(model => model.id === 'qwen3-tts-flash')?.defaultEnabled).toBe(false);
+ });
+ it('keeps a previously saved CosyVoice choice when recommending Qwen3 for an existing public connection', async () => {
+ const provider = { ...buildUserProvider({ id: 'my-ali', name: 'Alibaba connection', runtimes: {
+ codex: { baseUrl: publicUrl, wireProtocol: 'openai-chat', models: [
+ { id: 'cosyvoice-v3-flash', name: 'My saved voice', mode: 'audio_speech', defaultEnabled: false },
+ ] },
+ } }), connected: true } as ProviderView;
+ vi.mocked(updateCustomProvider).mockResolvedValue({ ok: true });
+ render(<AddSpeechModelsDialog provider={provider} onClose={vi.fn()} onSaved={vi.fn()} />);
+ const saved = await screen.findByRole('checkbox', { name: /My saved voice/ });
+ expect((saved as HTMLButtonElement).disabled).toBe(true);
+ expect(within(saved).getByText('settings.providers.speechSetup.saved')).toBeTruthy();
+ expect(screen.getByRole('checkbox', { name: /qwen3-tts-flash/ }).getAttribute('aria-checked')).toBe('true');
+ fireEvent.click(screen.getByText('settings.providers.wizard.addManualModel'));
+ await waitFor(() => expect(updateCustomProvider).toHaveBeenCalledTimes(1));
+ expect(vi.mocked(updateCustomProvider).mock.calls[0][0].runtimes.codex?.models).toEqual([
+ expect.objectContaining({ id: 'qwen3-tts-flash', defaultEnabled: true }),
+ ]);
+ expect(provider.models.codex).toEqual([
+ expect.objectContaining({ id: 'cosyvoice-v3-flash', name: 'My saved voice', defaultEnabled: false }),
+ ]);
+ });
+ });
+
+ describe('existing connection speech additions', () => {
+ const provider = { ...buildUserProvider({ id: 'my-minimax', name: 'My connection', runtimes: {
+ codex: { baseUrl: 'https://api.minimax.io/v1', wireProtocol: 'openai-chat', models: [
+ { id: 'MiniMax-M3', name: 'My chat', defaultEnabled: false },
+ { id: 'speech-2.8-hd', name: 'My saved voice', mode: 'audio_speech', defaultEnabled: false },
+ ] },
+ } }), connected: true } as ProviderView;
+ it('uses the saved key and submits only selected additions, leaving existing model switches alone', async () => {
+ vi.mocked(updateCustomProvider).mockResolvedValue({ ok: true });
+ const saved = vi.fn();
+ render(<AddSpeechModelsDialog provider={provider} onClose={vi.fn()} onSaved={saved} />);
+ const recommended = await screen.findByRole('checkbox', { name: /speech-2.8-turbo/ });
+ expect(recommended.getAttribute('aria-checked')).toBe('true');
+ expect((screen.getByRole('checkbox', { name: /speech-2.8-hd/ }) as HTMLButtonElement).disabled).toBe(true);
+ expect(readCustomProviderKey).toHaveBeenCalledWith('my-minimax', 'codex');
+ expect(window.electronAPI.maker.fetchProviderModels).toHaveBeenCalledWith(expect.objectContaining({ savedProviderId: 'my-minimax', apiKey: 'fake-stored-key' }));
+ fireEvent.click(screen.getByText('settings.providers.wizard.addManualModel'));
+ await waitFor(() => expect(saved).toHaveBeenCalled());
+ expect(updateCustomProvider).toHaveBeenCalledWith(expect.objectContaining({
+ id: 'my-minimax', runtimes: { codex: expect.objectContaining({ models: [expect.objectContaining({ id: 'speech-2.8-turbo', defaultEnabled: true })] }) },
+ }), {}, { appendSpeechModelsOnly: true });
+ expect(createCustomProvider).not.toHaveBeenCalled();
+ });
+ it('does not write on cancel and ignores discovery after the dialog unmounts', async () => {
+ let resolve!: (value: { ok: true; models: [] }) => void;
+ vi.mocked(window.electronAPI.maker.fetchProviderModels).mockReturnValue(new Promise(done => { resolve = done; }));
+ const closed = vi.fn();
+ const result = render(<AddSpeechModelsDialog provider={provider} onClose={closed} onSaved={vi.fn()} />);
+ await waitFor(() => expect(window.electronAPI.maker.fetchProviderModels).toHaveBeenCalled());
+ fireEvent.click(screen.getByText('settings.providers.wizard.cancel'));
+ result.unmount();
+ resolve({ ok: true, models: [] });
+ expect(updateCustomProvider).not.toHaveBeenCalled();
+ expect(createCustomProvider).not.toHaveBeenCalled();
+ });
+ });
+
+ // Review regression: a mixed provider with no preset models and no directory must
+ // retain the chat fallback alongside speech suggestions. Prior LiteLLM coverage
+ // used a URL without speech support (Renderer unit, mock discovery, no requests).
+ describe('general manual fallback beside speech suggestions', () => {
+ it.each([
+ ['OpenAI', 'https://api.openai.com/v1'],
+ ['MiniMax', 'https://api.minimax.io/v1'],
+ ['Bailian', 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1'],
+ ].flatMap(([name, baseUrl]) => [true, false].map(failed => ({ name, baseUrl, failed }))))(
+ 'keeps manual chat entry for $name with failed=$failed directory', async ({ name, baseUrl, failed }) => {
+ window.electronAPI.maker.listProviderPresets = vi.fn(async () => ({ presets: [{
+ id: 'empty-mixed-api', name, runtimes: { codex: { baseUrl, models: [] } },
+ }] }));
+ if (!failed) vi.mocked(window.electronAPI.maker.fetchProviderModels).mockResolvedValue({ ok: true, models: [] });
+ renderWizard('empty-mixed-api');
+ fireEvent.change(await screen.findByPlaceholderText('sk-…'), { target: { value: 'fake-test-key' } });
+ fireEvent.click(screen.getByText('settings.providers.wizard.next'));
+ const input = await screen.findByPlaceholderText('settings.providers.wizard.manualModelPlaceholder');
+ expect(screen.getByText('settings.providers.speechSetup.manual')).toBeTruthy();
+ fireEvent.change(input, { target: { value: 'my-new-chat-model' } });
+ fireEvent.click(screen.getByText('settings.providers.wizard.addManualModel'));
+ fireEvent.click(screen.getByText('settings.providers.wizard.finish'));
+ await waitFor(() => expect(createCustomProvider).toHaveBeenCalledOnce());
+ const saved = vi.mocked(createCustomProvider).mock.calls[0][0].runtimes.codex!.models;
+ expect(saved.find(model => model.id === 'my-new-chat-model')).toMatchObject({ name: 'my-new-chat-model' });
+ expect(saved.find(model => model.id === 'my-new-chat-model')?.mode).toBeUndefined();
+ },
+ );
+ it.each(['elevenlabs', 'speech-only'] as const)('does not offer a chat fallback in %s setup', async (kind) => {
+ window.electronAPI.maker.listProviderPresets = vi.fn(async () => ({ presets: [{
+ id: 'empty-api', name: 'Empty API', runtimes: { codex: {
+ baseUrl: kind === 'elevenlabs' ? 'https://api.elevenlabs.io/v1' : 'https://api.openai.com/v1', models: [],
+ } },
+ }] }));
+ render(<AddProviderWizard providers={[]} entry={{ kind: 'preset', presetId: 'empty-api', speechOnly: kind === 'speech-only' }} onClose={vi.fn()} onDone={vi.fn()} onOpenCustomForm={vi.fn()} />);
+ fireEvent.change(await screen.findByPlaceholderText('sk-…'), { target: { value: 'fake-test-key' } });
+ fireEvent.click(screen.getByText('settings.providers.wizard.next'));
+ await screen.findByText('settings.providers.speechSetup.manual');
+ await waitFor(() => expect(screen.queryByText('settings.providers.wizard.fetching')).toBeNull());
+ expect(screen.queryByPlaceholderText('settings.providers.wizard.manualModelPlaceholder')).toBeNull();
+ });
+ });
diff --cc apps/desktop/src/renderer/components/settings/AddProviderWizard.tsx
index ec418b5bc7,03d4d2f41f..7e0d4d9d23
--- a/apps/desktop/src/renderer/components/settings/AddProviderWizard.tsx
+++ b/apps/desktop/src/renderer/components/settings/AddProviderWizard.tsx
@@@ -51,8 -51,8 +51,10 @@@ import { LocalOllamaInstall, offersMana
import { MANAGED_LLAMACPP_PROVIDER_ID } from '../../../shared/llamaCpp';
import { OAuthBrowserLink, OAuthDeviceCodeCard } from './OAuthDeviceCodeCard';
import { SettingsTextInput } from './SettingsTextInput';
+import { modelsAfterProviderEndpointEdit } from '@/lib/customProviderEndpointEdit';
+import type { DetectedProviderDraft } from '../../../shared/providerDetection';
+ import { SpeechModelChoices } from './SpeechModelChoices';
+ import { isSpeechModel, SPEECH_API_PRESETS, speechReferenceModels, speechSetupTarget, withSpeechApiPresets } from '../../../shared/speechProviderSetup';
import {
PROVIDER_MEDIA_FIELDS,
@@@ -78,11 -78,9 +80,11 @@@ import type
* - preset(引导卡「其他供应商」行):presets 异步载入后直达该预设的表单步。
*/
export type WizardEntry =
- { kind: 'builtin'; providerId: string } | { kind: 'preset'; presetId: string };
+ { kind: 'builtin'; providerId: string } | { kind: 'preset'; presetId: string; speechOnly?: boolean };
interface AddProviderWizardProps {
+ detected?: DetectedProviderDraft;
+ onReturnCustom?: (draft: DetectedProviderDraft) => void;
providers: ProviderView[];
entry?: WizardEntry;
/** 「自定义端点」卡片 → 关闭向导并打开完整表单。 */
@@@ -1024,19 -1023,22 +1030,34 @@@ export function AddProviderWizard(
}
}
}
+ // Suggestions add no account membership until the user finishes this wizard.
+ // Scope them to one real API-key runtime, never the device-code draft.
+ const speechTarget = !oauthDraftRef.current && speechSetupTarget(Object.fromEntries(
+ agents.map(agent => [agent, { ...preset.runtimes[agent]!, baseUrl: presetRuntimeBaseUrl(preset, agent, presetBaseUrls) }]),
+ ));
+ if (speechTarget) {
+ if (entry?.kind === 'preset' && entry.speechOnly) {
+ for (const value of initial.values()) value.checked = false;
+ }
+ for (const model of speechReferenceModels(presetRuntimeBaseUrl(preset, speechTarget.agent, presetBaseUrls))) {
+ if (initial.has(model.id)) continue;
+ initial.set(model.id, { name: model.name, checked: model.defaultEnabled !== false,
+ recommended: model.defaultEnabled !== false, agents: [speechTarget.agent], speechReference: true });
+ }
+ }
- setPicks(initial);
+ if (detected) {
+ const selectedIds = new Set(agents.flatMap(agent => detected.config.runtimes[agent]?.models.map(m => m.id) ?? []));
+ for (const [id, value] of initial) initial.set(id, { ...value, checked: selectedIds.has(id), recommended: false });
+ for (const agent of agents) for (const m of detected.config.runtimes[agent]?.models ?? []) {
+ const existing = initial.get(m.id);
+ initial.set(m.id, { ...existing, name: m.name, checked: true, recommended: false,
+ agents: [...new Set([...(existing?.agents ?? []), agent])],
+ discoveredMetadata: { ...existing?.discoveredMetadata, [agent]: m.discoveredMetadata },
+ ...(m.route ? { routes: { ...existing?.routes, [agent]: m.route } } : {}),
+ });
+ }
+ }
+ setPicks(previous => detected && previous.size ? previous : initial);
setStep(3);
setFetchState({ status: 'fetching' });
const seq = ++fetchSeqRef.current;
@@@ -1244,7 -1245,7 +1269,7 @@@
failed: !results.some((r) => r.ok),
empty: !results.some((r) => r.models.length > 0),
});
- }, [sel, apiKey, presetBaseUrls, detected]);
- }, [sel, apiKey, presetBaseUrls, entry]);
++ }, [sel, apiKey, presetBaseUrls, detected, entry]);
/**
* 零推荐模型的本机代理(例如 LiteLLM)若 `/models` 不可用或返回空清单,仍允许用户
@@@ -1487,9 -1489,19 +1529,20 @@@
const presetCanContinue =
sel?.kind === 'preset' &&
presetBaseUrlsValid &&
- (!presetNeedsApiKey || apiKey.trim().length > 0);
+ (!presetNeedsApiKey || apiKey.trim().length > 0 || (detected?.catalog?.ok === true && apiKey === detected.apiKey
+ && presetRuntimeBaseUrl(sel.preset, detected.agent, presetBaseUrls) === detected.preset.runtimes[detected.agent]?.baseUrl));
+ const wizardTitle = sel
+ ? t('settings.providers.wizard.titleWith', {
+ name:
+ sel.kind === 'preset'
+ ? presetDisplayName(sel.preset, i18n.language)
+ : sel.kind === 'ollama-onboarding'
+ ? t('settings.providers.local.title')
+ : sel.provider.name,
+ })
+ : t('settings.providers.wizard.title');
+
return (
<Dialog.Root open={dialog.open} onOpenChange={(open) => { if (!open) handleClose(); }}>
<Dialog.Portal>
@@@ -1514,19 -1526,11 +1567,11 @@@
{/* 头部:标题居左 + 步骤指示居右,同一行(2026-07 定稿原型形态)。 */}
<div className="flex items-center justify-between gap-4 px-4 pb-3 pt-4">
<Dialog.Title asChild><h3
- className="min-w-0 truncate text-16 font-medium"
+ className="min-w-0 break-words text-16 font-medium"
+ title={wizardTitle}
style={{ color: 'var(--settings-section-title)' }}
>
- {sel
- ? t('settings.providers.wizard.titleWith', {
- name:
- sel.kind === 'preset'
- ? presetDisplayName(sel.preset, i18n.language)
- : sel.kind === 'ollama-onboarding'
- ? t('settings.providers.local.title')
- : sel.provider.name,
- })
- : t('settings.providers.wizard.title')}
+ {wizardTitle}
</h3></Dialog.Title>
<div className="flex shrink-0 items-center gap-4">
{stepLabels.map((label, i) => {
diff --cc apps/desktop/src/renderer/components/settings/ProviderConnectionDialog.tsx
index a90880e673,7a8af183e4..57369b9007
--- a/apps/desktop/src/renderer/components/settings/ProviderConnectionDialog.tsx
+++ b/apps/desktop/src/renderer/components/settings/ProviderConnectionDialog.tsx
@@@ -969,152 -893,6 +969,160 @@@ export function ProviderConnectionDialo
[i18n.language, setRtSynced],
);
+ const detectionSuppressed = useRef(!!draft);
+ const [detection, setDetection] = useState<{ signature: string; preset?: ProviderPreset; pending?: boolean; ambiguous?: boolean; code?: string } | null>(null);
+ const discoveryCache = useRef(new Map<DialogAgentKind, { signature: string; promise: Promise<DetectionCatalog> }>(
+ draft?.catalog ? [[draft.agent, { signature: `${draft.agent}:${providerModelFetchRequestSignature(rt[draft.agent], authMode)}`,
+ promise: Promise.resolve(draft.catalog) }]] : [],
+ ));
+ const importedOnce = useRef(new Set<DialogAgentKind>(draft ? [draft.agent] : []));
+ const detectionSignature = `${activeTab}:${providerModelFetchRequestSignature(rt[activeTab], authMode)}`;
+ const detectionContext = useRef({ name, activeTab, onDetected, signature: detectionSignature });
+ const previousDetectionSignatures = useRef(new Map<DialogAgentKind, string>());
+ detectionContext.current = { name, activeTab, onDetected, signature: detectionSignature };
+
+ const enterDetectedProvider = useCallback((preset: ProviderPreset) => {
+ if (savingRef.current || childLayerRef.current || runtimeFillRef.current || connectionTestRef.current) return;
+ const context = detectionContext.current;
+ const sourceAgent = context.activeTab;
+ const fields = rtRef.current[sourceAgent];
+ const agent = preset.runtimes[sourceAgent] ? sourceAgent : AGENTS.find(a =>
+ preset.runtimes[a] && followsDefaultConnection(a, rtRef.current[a], fields));
+ if (!agent) return;
+ const runtimes: CustomProviderConfig['runtimes'] = {};
+ const keys: Partial<Record<AgentKind, string>> = {};
+ for (const a of AGENTS) {
+ const value = rtRef.current[a];
+ if (!value.baseUrl.trim()) continue;
+ const inherits = followsDefaultConnection(a, value, fields);
+ if (!preset.runtimes[a] && inherits) continue;
+ keys[a] = value.apiKey;
+ runtimes[a] = { baseUrl: value.baseUrl.trim(), models: value.models.filter(m => m.id.trim()),
+ wireProtocol: customProviderWireProtocolForSave(a, value.wireProtocol, defaultWireFor(a)),
+ headers: Object.fromEntries(value.headers.filter(h => h.name.trim()).map(h => [h.name.trim(), h.value])),
+ ...(value.requestPath ? { requestPath: value.requestPath } : {}),
+ ...(value.modelsUrl.trim() ? { modelsUrl: value.modelsUrl.trim() } : {}),
+ ...(value.catalogPresetId ? { catalogPresetId: value.catalogPresetId } : {}),
+ ...(value.piCatalogProviderId ? { piCatalogProviderId: value.piCatalogProviderId } : {}),
+ ...(value.imageApi ? { imageApi: value.imageApi } : {}),
+ ...(value.videoApi ? { videoApi: value.videoApi } : {}),
+ ...(a === 'codex' && value.supportsImageGeneration && canRuntimeUseNativeImageGeneration(value) ? { supportsImageGeneration: true } : {}),
+ };
+ }
+ const bound: ProviderPreset = { ...preset, authMethod: authModeRef.current === 'none' ? 'none' : 'apiKey',
+ runtimes: Object.fromEntries(AGENTS.flatMap(a => {
+ const runtime = preset.runtimes[a];
+ if (!runtime) return [];
+ const value = rtRef.current[a];
+ const independent = a !== sourceAgent && !followsDefaultConnection(a, value, fields);
+ // The existing wizard has one shared key. Never enroll independent
+ // drafts into its fetch/save loop; they remain in config/keys untouched.
+ if (independent) return [];
+ // Inherited connections use each engine's provider defaults.
+ return [[a, { ...runtime,
+ headers: { ...runtime.headers, ...runtimes[a]?.headers },
+ ...(value.requestPath ? { requestPath: value.requestPath } : {}),
+ ...(value.modelsUrl.trim() ? { modelsUrl: value.modelsUrl.trim() } : {}),
+ ...(runtimes[a]?.supportsImageGeneration ? { supportsImageGeneration: true } : {}),
+ ...(value.wireProtocol !== defaultWireFor(a) || runtimes[a]?.supportsImageGeneration ? { wireProtocol: value.wireProtocol } : {}),
+ }]];
+ })),
+ };
+ // The cache is settled before announcing a match; no credentials enter saved detection data.
+ const cache = discoveryCache.current.get(sourceAgent);
+ void (cache?.signature === context.signature ? cache.promise : Promise.resolve(undefined)).then(catalog => {
+ if (detectionContext.current.signature !== context.signature || savingRef.current || childLayerRef.current || runtimeFillRef.current) return;
+ context.onDetected?.({ preset: bound, agent, apiKey: fields.apiKey, keys, catalog,
+ config: { id: 'draft', name: context.name, auth: { method: bound.authMethod ?? 'apiKey' }, runtimes } });
+ });
+ }, []);
+
+ useEffect(() => {
+ if (editing || !onDetected || authMode === 'oauth' || saving || !dialog.open) return;
+ let live = true;
+ let jump: ReturnType<typeof setTimeout> | undefined;
+ // Correlation only, scoped to this renderer; randomUUID requires a secure context.
+ const requestId = `detect-${Date.now()}-${++detectionRequestSequence}`;
+ const agent = activeTab;
+ const fields = rt[agent];
+ const signature = detectionSignature;
+ const previousSignature = previousDetectionSignatures.current.get(agent);
+ previousDetectionSignatures.current.set(agent, signature);
+ if (previousSignature && previousSignature !== signature) {
+ setRtSynced(prev => ({ ...prev, [agent]: { ...prev[agent], models: prev[agent].models.map(model => {
+ const { discoveredMetadata: _metadata, discoveredCost: _cost, ...userFields } = model;
+ return userFields;
+ }) } }));
+ }
+ setDetection(null);
+ const timer = setTimeout(() => {
+ if (modelFetchInFlightRef.current || !fields.baseUrl.trim() || !areProviderRequestUrlsAllowed(authMode, fields.baseUrl)) return;
+ if (draft?.catalog && discoveryCache.current.get(agent)?.signature === signature) {
+ setDetection({ signature });
+ return;
+ }
+ setDetection({ signature, pending: true });
+ const all = [...presets, ...Object.values(OFFICIAL_API_PRESETS).filter(p => !presets.some(existing => existing.id === p.id))];
+ const official = matchOfficialProviders(fields.baseUrl.trim(), all);
+ const headers = Object.fromEntries(fields.headers.filter(h => h.name.trim()).map(h => [h.name.trim(), h.value]));
+ const spec = { agent, baseUrl: fields.baseUrl.trim(), apiKey: fields.apiKey.trim() || null,
+ authMethod: authMode, headers, wireProtocol: fields.wireProtocol };
+ const work = (async () => {
+ if (official.length) {
+ const preset = official.length === 1 ? bindAddPageProvider(official[0], spec.baseUrl) : undefined;
+ if (!preset) return { preset, ambiguous: official.length > 1, catalog: undefined };
+ const fetchAgent = preset.runtimes[agent] ? agent : AGENTS.find(a =>
+ preset.runtimes[a] && followsDefaultConnection(a, rtRef.current[a], fields));
+ if (!fetchAgent) return { preset: undefined, catalog: undefined };
+ const runtime = preset.runtimes[fetchAgent]!;
+ const catalog = await window.electronAPI.maker.fetchProviderModels({ ...spec, agent: fetchAgent,
+ allowEmpty: true, redirect: 'error',
+ baseUrl: runtime.baseUrl, modelsUrl: fields.modelsUrl.trim() || runtime.modelsUrl, wireProtocol: runtime.wireProtocol ?? defaultWireFor(fetchAgent),
+ headers: { ...runtime.headers, ...headers } });
+ return { preset, catalog };
+ }
+ const result = await window.electronAPI.maker.detectProvider?.({ ...spec, requestId });
+ const preset = result?.candidates.length === 1 ? all.find(p => p.id === result.candidates[0]) : undefined;
+ return { preset: preset && bindAddPageProvider(preset, spec.baseUrl), catalog: result?.catalog, ambiguous: result?.reason === 'conflict' };
+ })().catch(() => ({ preset: undefined, catalog: undefined, ambiguous: false }));
+ discoveryCache.current.set(agent, { signature, promise: work.then(r => r.catalog ?? { ok: false }) });
+ void work.then(({ preset, catalog, ambiguous }) => {
+ if (!live || detectionContext.current.signature !== signature) return;
+ if (catalog?.ok && catalog.models) {
+ const first = !importedOnce.current.has(agent);
+ importedOnce.current.add(agent);
- if (first) setRtSynced(prev => ({ ...prev, [agent]: { ...prev[agent], models: [
- ...prev[agent].models.filter(m => m.id.trim()),
- ...catalog.models!.filter(m => !prev[agent].models.some(row => row.id === m.id) && isAgentSelectableModel({ id: m.id, mode: m.discoveredMetadata?.mode })).map(m => ({
++ setRtSynced(prev => ({ ...prev, [agent]: { ...prev[agent], models: [
++ ...prev[agent].models.filter(m => m.id.trim()).map(model => {
++ const fresh = catalog.models!.find(m => m.id === model.id);
++ // Refresh discovered facts after credentials/endpoint changes, without
++ // replacing explicit overrides or reselecting models the user removed.
++ return fresh ? { ...model,
++ discoveredMetadata: fresh.discoveredMetadata ?? { contextWindow: fresh.contextWindow },
++ discoveredCost: fresh.discoveredCost,
++ } : model;
++ }),
++ ...(first ? catalog.models!.filter(m => !prev[agent].models.some(row => row.id === m.id) && isAgentSelectableModel({ id: m.id, mode: m.discoveredMetadata?.mode })).map(m => ({
+ id: m.id, name: m.name, discoveredMetadata: m.discoveredMetadata ?? { contextWindow: m.contextWindow }, discoveredCost: m.discoveredCost,
- })),
++ })) : []),
+ ] } }));
+ }
+ if (preset && !AGENTS.some(a => preset!.runtimes[a] &&
+ (a === agent || followsDefaultConnection(a, rtRef.current[a], rtRef.current[agent])))) preset = undefined;
+ setDetection({ signature, preset, ambiguous, code: catalog && !catalog.ok ? (catalog.code ?? 'UNKNOWN') : undefined });
+ if (preset && !detectionSuppressed.current) jump = setTimeout(() => {
+ if (live && !detectionSuppressed.current && detectionContext.current.signature === signature) enterDetectedProvider(preset);
+ }, 1200);
+ });
+ }, 400);
+ return () => {
+ live = false;
+ clearTimeout(timer);
+ clearTimeout(jump);
+ void window.electronAPI.maker.detectProvider?.({ requestId, cancel: true }).catch(() => undefined);
+ };
+ // A model selection/name change is not a new connection or a reason to restart detection.
+ }, [detectionSignature, presets, editing, authMode, saving, dialog.open, !!onDetected, enterDetectedProvider, setRtSynced]);
+
// 编辑态:回填各已配置 runtime 的已存明文密钥(用户本机自己的 key)——
// 让密钥框「能看」(eye 显形 / 可核对),而非空白遮罩;据此点亮「已保存」徽标。
// 鉴权请求头是 main-only 密文,不回读进表单;未显式改动时由 main 侧 update 保留旧值。
diff --cc apps/desktop/src/renderer/components/settings/ProvidersSection.tsx
index 17c62548bb,edf9031513..ae4e9f50c5
--- a/apps/desktop/src/renderer/components/settings/ProvidersSection.tsx
+++ b/apps/desktop/src/renderer/components/settings/ProvidersSection.tsx
@@@ -2496,7 -2499,8 +2500,8 @@@ export function ProvidersSection()
ids: Set<string>;
}>({ dataOwnerId, ids: new Set<string>() });
// 向导:null = 关;{ entry } = 打开(entry 指定直达的供应商,来自检测建议)。
+ const [speechProvider, setSpeechProvider] = useState<{ provider: ProviderView; owner: string | null; generation: number | null } | null>(null);
- const [wizard, setWizard] = useState<null | { entry?: WizardEntry }>(null);
+ const [wizard, setWizard] = useState<null | { entry?: WizardEntry; detected?: DetectedProviderDraft }>(null);
// 自定义供应商完整表单(编辑,或从向导「自定义端点」进入新建)。
const [dialog, setDialog] = useState<
| null
diff --cc apps/desktop/src/renderer/components/settings/__tests__/CustomProviderDialogAccessibility.test.tsx
index f72ae18629,b2c6996929..01822efd32
--- a/apps/desktop/src/renderer/components/settings/__tests__/CustomProviderDialogAccessibility.test.tsx
+++ b/apps/desktop/src/renderer/components/settings/__tests__/CustomProviderDialogAccessibility.test.tsx
@@@ -2081,467 -2081,3 +2081,512 @@@ it('main provider form contains Tab an
await waitFor(() => expect(onSaved).toHaveBeenCalledOnce());
expect(screen.queryByRole('dialog')).toBeNull();
});
+
+// New scheme-2 behavior: real dialog, fake IPC and clocks. Existing accessibility tests
+// do not cover delayed navigation or a previous connection's late model result.
+describe('new-connection identification', () => {
+ afterEach(() => { cleanup(); vi.useRealTimers(); });
+ const preset = { id: 'deepseek', name: 'DeepSeek', runtimes: { pi: { baseUrl: 'https://api.deepseek.com', wireProtocol: 'openai-chat' as const, models: [] } } };
+ async function openIdentification(available: ProviderPreset = preset, url = 'https://api.deepseek.com', apiKey = 'fake-key') {
+ vi.useFakeTimers();
+ const fetchProviderModels = vi.fn(async () => ({ ok: true, models: [{ id: 'private-model', name: 'Model' }] }));
+ Object.assign(window.electronAPI.maker, {
+ listProviderPresets: vi.fn(async () => ({ presets: [available] })), fetchProviderModels,
+ detectProvider: vi.fn(async () => ({ candidates: [], reason: 'insufficient_evidence', catalog: { ok: true, models: [{ id: 'custom-model', name: 'Custom' }] } })),
+ });
+ const onDetected = vi.fn();
+ render(<ProviderConnectionDialog focusAgent="pi" onDetected={onDetected} onClose={vi.fn()} onSaved={vi.fn()} />);
+ await act(async () => {});
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.baseUrlPlaceholder'), { target: { value: url } });
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.apiKeyPlaceholder'), { target: { value: apiKey } });
+ await act(async () => { await vi.advanceTimersByTimeAsync(400); });
+ return { onDetected, fetchProviderModels };
+ }
+ it.each([
+ ['http://127.0.0.1:1234/v1', '', 'none'],
+ ['http://localhost:1234/v1', '', 'none'],
+ ['http://[::1]:1234/v1', '', 'none'],
+ ['https://remote.example/v1', '', 'apiKey'],
+ ['https://localhost.example/v1', '', 'apiKey'],
+ ['http://127.0.0.1:1234/v1', 'fake-key', 'apiKey'],
+ ])('keeps discovery, testing and saving on the same add-form auth: %s / %s', async (url, key, method) => {
+ await openIdentification(preset, url, key);
+ const testConnection = vi.fn(async () => ({ ok: true, latencyMs: 1 }));
+ window.electronAPI.maker.testProviderConnection = testConnection;
+ expect(window.electronAPI.maker.detectProvider).toHaveBeenCalledWith(expect.objectContaining({ authMethod: method }));
+ // Local inference must never hide the input needed to add authentication later.
+ expect(screen.getByPlaceholderText('settings.providers.custom.fields.apiKeyPlaceholder')).toBeTruthy();
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.custom.test.button' }));
+ await act(async () => {});
+ expect(testConnection).toHaveBeenCalledWith(expect.objectContaining({ spec: expect.objectContaining({ authMethod: method, apiKey: key || null }) }));
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.namePlaceholder'), { target: { value: 'Auth regression' } });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.connection.saveProvider' }));
+ await act(async () => {});
+ const [config, keys] = customProviderMocks.createCustomProvider.mock.calls[0];
+ expect(config.auth?.method ?? 'apiKey').toBe(method);
+ expect(keys).toEqual(key ? { pi: key } : {});
+ });
++ it('saves refreshed metadata after first discovery and a corrected API key', async () => {
++ const { fetchProviderModels } = await openIdentification();
++ fetchProviderModels.mockResolvedValue({ ok: true, models: [
++ { id: 'private-model', name: 'Model', discoveredMetadata: { contextWindow: 64000 }, discoveredCost: { input: 2, output: 8 } },
++ { id: 'new-model', name: 'Not automatically selected' },
++ ] } as any);
++ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.apiKeyPlaceholder'), { target: { value: 'fake-corrected' } });
++ await act(async () => { await vi.advanceTimersByTimeAsync(400); });
++ expect(fetchProviderModels).toHaveBeenCalledTimes(2);
++ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.namePlaceholder'), { target: { value: 'Corrected key' } });
++ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.connection.saveProvider' }));
++ await act(async () => {});
++ expect(customProviderMocks.createCustomProvider).toHaveBeenCalledOnce();
++ expect(customProviderMocks.createCustomProvider.mock.calls[0][0].runtimes.pi.models).toEqual([
++ expect.objectContaining({ id: 'private-model', discoveredMetadata: { contextWindow: 64000 }, discoveredCost: { input: 2, output: 8 } }),
++ ]);
++ });
++ it.each(['key', 'endpoint'])('refreshes discovered facts after changing %s without changing selected models or overrides', async change => {
++ vi.useFakeTimers();
++ const detectProvider = vi.fn(async (_spec: any) => ({ candidates: [], reason: 'insufficient_evidence', catalog: { ok: true, models: [
++ { id: 'selected', name: 'Upstream name', discoveredMetadata: { contextWindow: 64000, supportsImageInput: true }, discoveredCost: { input: 2, output: 8 } },
++ { id: 'not-selected', name: 'Do not import again' },
++ ] } }));
++ Object.assign(window.electronAPI.maker, { listProviderPresets: vi.fn(async () => ({ presets: [] })), detectProvider });
++ render(<ProviderConnectionDialog onDetected={vi.fn()} onClose={vi.fn()} onSaved={vi.fn()} draft={{
++ preset, agent: 'pi', apiKey: 'fake-old', keys: { pi: 'fake-old' },
++ config: { id: 'draft', name: 'Refresh regression', runtimes: { pi: {
++ baseUrl: 'https://custom.example/v1', models: [{ id: 'selected', name: 'My name', contextWindow: 32000, defaultEnabled: false,
++ discoveredMetadata: { contextWindow: 16000 }, discoveredCost: { input: 1, output: 4 } }],
++ } } },
++ }} />);
++ await act(async () => { await vi.advanceTimersByTimeAsync(400); });
++ fireEvent.change(screen.getByPlaceholderText(change === 'key'
++ ? 'settings.providers.custom.fields.apiKeyPlaceholder' : 'settings.providers.custom.fields.baseUrlPlaceholder'),
++ { target: { value: change === 'key' ? 'fake-corrected' : 'https://other.example/v1' } });
++ await act(async () => { await vi.advanceTimersByTimeAsync(400); });
++ expect(detectProvider.mock.calls.filter(args => !(args[0] as any)?.cancel)).toHaveLength(2);
++ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.connection.saveProvider' }));
++ await act(async () => {});
++ expect(customProviderMocks.createCustomProvider).toHaveBeenCalledOnce();
++ expect(customProviderMocks.createCustomProvider.mock.calls[0][0].runtimes.pi.models).toEqual([
++ expect.objectContaining({ id: 'selected', name: 'My name', contextWindow: 32000, defaultEnabled: false,
++ discoveredMetadata: { contextWindow: 64000, supportsImageInput: true }, discoveredCost: { input: 2, output: 8 } }),
++ ]);
++ });
+ it('invalidates inferred no-auth when key or destination changes', async () => {
+ await openIdentification(preset, 'http://127.0.0.1:1234/v1', '');
+ const testConnection = vi.fn(async () => ({ ok: true, latencyMs: 1 }));
+ window.electronAPI.maker.testProviderConnection = testConnection;
+ const key = screen.getByPlaceholderText('settings.providers.custom.fields.apiKeyPlaceholder');
+ for (const [value, method] of [['fake-key', 'apiKey'], ['', 'none']] as const) {
+ fireEvent.change(key, { target: { value } });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.custom.test.button' }));
+ await act(async () => {});
+ expect(testConnection).toHaveBeenLastCalledWith(expect.objectContaining({ spec: expect.objectContaining({ authMethod: method }) }));
+ }
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.baseUrlPlaceholder'), { target: { value: 'https://remote.example/v1' } });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.custom.test.button' }));
+ await act(async () => {});
+ expect(testConnection).toHaveBeenLastCalledWith(expect.objectContaining({ spec: expect.objectContaining({ authMethod: 'apiKey' }) }));
+ });
+ it.each(['remote-engine', 'independent-key', 'remote-directory'])('does not infer global no-auth across a %s draft', async variant => {
+ vi.useFakeTimers();
+ const local = { baseUrl: 'http://127.0.0.1:1234/v1', models: [{ id: 'local-model', name: 'Local' }] };
+ const own = { ...local, baseUrl: variant === 'remote-engine' ? 'https://remote.example/v1' : local.baseUrl,
+ ...(variant === 'remote-directory' ? { modelsUrl: 'https://remote.example/v1/models' } : {}) };
+ const testConnection = vi.fn(async () => ({ ok: true, latencyMs: 1 }));
+ Object.assign(window.electronAPI.maker, { listProviderPresets: vi.fn(async () => ({ presets: [] })), testProviderConnection: testConnection });
+ render(<ProviderConnectionDialog onDetected={vi.fn()} onClose={vi.fn()} onSaved={vi.fn()} draft={{
+ preset, agent: 'pi', apiKey: '', keys: { pi: '', codex: variant === 'independent-key' ? 'own-key' : '' },
+ config: { id: 'draft', name: 'Local with independent runtime', runtimes: { pi: local, codex: own } },
+ }} />);
+ await act(async () => {});
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.custom.test.button' }));
+ await act(async () => {});
+ expect(testConnection).toHaveBeenCalledWith(expect.objectContaining({ spec: expect.objectContaining({ authMethod: 'apiKey' }) }));
+ });
+ it('preserves header-only credentials on a local new connection', async () => {
+ await openIdentification(preset, 'http://127.0.0.1:1234/v1', '');
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.custom.fields.addHeader' }));
+ // Header input labels are shared by the existing form; use its placeholders.
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.headerNamePlaceholder'), { target: { value: 'Authorization' } });
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.headerValuePlaceholder'), { target: { value: 'Bearer fake-header' } });
+ const testConnection = vi.fn(async () => ({ ok: true, latencyMs: 1 }));
+ window.electronAPI.maker.testProviderConnection = testConnection;
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.custom.test.button' }));
+ await act(async () => {});
+ expect(testConnection).toHaveBeenCalledWith(expect.objectContaining({ spec: expect.objectContaining({ authMethod: 'apiKey', headers: { Authorization: 'Bearer fake-header' } }) }));
+ });
+ // Empty-key GUI regressions: address identification must survive a 401 from
+ // model discovery and reach the wizard without saving an account. Unit.
+ it.each([
+ ['https://ark.cn-beijing.volces.com/api/v3', 'volcengine-api'],
+ ['https://api.siliconflow.cn/v1', 'siliconflow-cn'],
+ ['https://api.siliconflow.com/v1', 'siliconflow-global'],
+ ['https://api.mistral.ai/v1', 'mistral'],
+ ['https://api.together.xyz/v1', 'together'],
+ ['https://api.fireworks.ai/inference/v1', 'fireworks'],
+ ])('hands off %s with an empty key even when discovery requires authentication', async (url, id) => {
+ const available = BUNDLED_CATALOG.presets!.find(p => p.id === id)!;
+ const { onDetected, fetchProviderModels } = await openIdentification(available, '', '');
+ fetchProviderModels.mockResolvedValue({ ok: false, code: 'AUTH_INVALID' } as any);
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.baseUrlPlaceholder'), { target: { value: url } });
+ await act(async () => { await vi.advanceTimersByTimeAsync(1600); });
+ expect(onDetected).toHaveBeenCalledOnce();
+ expect(onDetected.mock.calls[0][0]).toMatchObject({ apiKey: '', preset: { id }, agent: 'pi' });
+ expect(fetchProviderModels).toHaveBeenCalledWith(expect.objectContaining({ apiKey: null }));
+ expect(customProviderMocks.createCustomProvider).not.toHaveBeenCalled();
+ });
+ it('shows missing-key guidance instead of an expired-key error, and clears stale authentication feedback on edit', async () => {
+ await openIdentification();
+ Object.assign(window.electronAPI.maker, {
+ detectProvider: vi.fn(async () => ({ candidates: [], reason: 'insufficient_evidence', catalog: { ok: false, code: 'AUTH_INVALID' } })),
+ });
+ const key = screen.getByPlaceholderText('settings.providers.custom.fields.apiKeyPlaceholder');
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.baseUrlPlaceholder'), { target: { value: 'https://relay.example/v1' } });
+ fireEvent.change(key, { target: { value: '' } });
+ await act(async () => { await vi.advanceTimersByTimeAsync(400); });
+ expect(screen.getByText('settings.providers.detection.keyRequired')).toBeTruthy();
+ expect(key.getAttribute('aria-invalid')).not.toBe('true');
+ expect(screen.queryByText('providerError.AUTH_INVALID')).toBeNull();
+ expect(screen.queryByText('settings.providers.detection.custom')).toBeNull();
+ fireEvent.change(key, { target: { value: 'rejected-test-key' } });
+ await act(async () => { await vi.advanceTimersByTimeAsync(400); });
+ expect(screen.getByText('settings.providers.detection.authRejected')).toBeTruthy();
+ expect(key.getAttribute('aria-invalid')).toBe('true');
+ fireEvent.change(key, { target: { value: 'replacement-test-key' } });
+ expect(screen.queryByText('settings.providers.detection.authRejected')).toBeNull();
+ expect(key.getAttribute('aria-invalid')).not.toBe('true');
+ });
+ it('still accepts a successful directory response from a service with an empty key', async () => {
+ await openIdentification();
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.baseUrlPlaceholder'), { target: { value: 'http://localhost:1234/v1' } });
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.apiKeyPlaceholder'), { target: { value: '' } });
+ await act(async () => { await vi.advanceTimersByTimeAsync(400); });
+ expect(window.electronAPI.maker.detectProvider).toHaveBeenCalledWith(expect.objectContaining({ baseUrl: 'http://localhost:1234/v1', apiKey: null }));
+ expect(screen.queryByText('settings.providers.detection.keyRequired')).toBeNull();
+ expect(screen.getByText('settings.providers.detection.custom')).toBeTruthy();
+ });
+ it('waits 1.2 seconds and hands off the URL, key and selected models without saving', async () => {
+ const { onDetected, fetchProviderModels } = await openIdentification();
+ expect(onDetected).not.toHaveBeenCalled();
+ await act(async () => { await vi.advanceTimersByTimeAsync(1199); });
+ expect(onDetected).not.toHaveBeenCalled();
+ await act(async () => { await vi.advanceTimersByTimeAsync(1); });
+ expect(onDetected).toHaveBeenCalledOnce();
+ expect(onDetected.mock.calls[0][0]).toMatchObject({ apiKey: 'fake-key', agent: 'pi', config: { runtimes: { pi: { baseUrl: 'https://api.deepseek.com', models: [{ id: 'private-model' }] } } } });
+ expect(fetchProviderModels).toHaveBeenCalledOnce();
+ expect(customProviderMocks.createCustomProvider).not.toHaveBeenCalled();
+ });
+ it('uses the HTML add layout and saves only Pi for the shared custom connection', async () => {
+ await openIdentification();
+ expect(screen.queryByRole('tablist')).toBeNull();
+ expect(screen.queryByText('settings.providers.custom.authMode.label')).toBeNull();
+ expect(screen.queryByText('settings.providers.custom.presets.label')).toBeNull();
+ expect(screen.queryByLabelText('settings.providers.connection.manualId')).toBeNull();
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.detection.keepCustom' }));
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.connection.removeModel' }));
+ expect(screen.queryByText('private-model')).toBeNull();
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.connection.manualAdd' }));
+ fireEvent.change(screen.getByLabelText('settings.providers.connection.manualId'), { target: { value: 'my-model' } });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.custom.fields.addModel' }));
+ expect(screen.getByText('my-model')).toBeTruthy();
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.namePlaceholder'), { target: { value: 'My custom' } });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.connection.saveProvider' }));
+ await act(async () => {});
+ expect(customProviderMocks.createCustomProvider).toHaveBeenCalledOnce();
+ const [config, keys] = customProviderMocks.createCustomProvider.mock.calls[0];
+ expect(Object.keys(config.runtimes)).toEqual(['pi']);
+ expect(config.runtimes.pi).toMatchObject({ baseUrl: 'https://api.deepseek.com', wireProtocol: 'openai-chat', models: [{ id: 'my-model' }] });
+ expect(keys).toEqual({ pi: 'fake-key' });
+ });
+ // New one-click connection contract: real form actions must preserve the successful
+ // route through Save; changed inputs must invalidate an in-flight paid probe (unit tier).
+ it('applies an automatically verified protocol and saves the same Pi model route', async () => {
+ await openIdentification();
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.detection.keepCustom' }));
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.baseUrlPlaceholder'), { target: { value: 'https://unknown.example/team/v1' } });
+ window.electronAPI.maker.testProviderConnection = vi.fn(async () => ({ ok: true, latencyMs: 3, decision: 'success' as const,
+ selected: { baseUrl: 'https://unknown.example/team', wireProtocol: 'anthropic-messages' as const } }));
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.custom.test.button' }));
+ await act(async () => {});
+ expect(window.electronAPI.maker.testProviderConnection).toHaveBeenCalledWith(expect.objectContaining({
+ requestId: expect.any(String), strategy: 'auto', kind: 'adhoc',
+ spec: expect.objectContaining({ agent: 'pi', baseUrl: 'https://unknown.example/team/v1', modelId: 'private-model' }),
+ }));
+ expect(screen.getByPlaceholderText('settings.providers.custom.fields.baseUrlPlaceholder')).toHaveProperty('value', 'https://unknown.example/team');
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.custom.test.button' }));
+ await act(async () => {});
+ expect(window.electronAPI.maker.testProviderConnection).toHaveBeenLastCalledWith(expect.objectContaining({
+ strategy: 'auto', spec: expect.objectContaining({ wireProtocol: 'anthropic-messages', baseUrl: 'https://unknown.example/team' }),
+ }));
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.namePlaceholder'), { target: { value: 'Verified custom' } });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.connection.saveProvider' }));
+ await act(async () => {});
+ const [config] = customProviderMocks.createCustomProvider.mock.calls[0];
+ expect(Object.keys(config.runtimes)).toEqual(['pi']);
+ expect(config.runtimes.pi).toMatchObject({ baseUrl: 'https://unknown.example/team', wireProtocol: 'anthropic-messages',
+ models: [{ id: 'private-model', api: 'anthropic-messages', route: { baseUrl: 'https://unknown.example/team', wireProtocol: 'anthropic-messages' } }] });
+ });
+ it.each(['key', 'address', 'stop'] as const)('cancels on %s and ignores a late successful protocol result', async change => {
+ await openIdentification();
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.detection.keepCustom' }));
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.baseUrlPlaceholder'), { target: { value: 'https://unknown.example/v1' } });
+ let finish!: (value: unknown) => void;
+ window.electronAPI.maker.testProviderConnection = vi.fn().mockImplementation(input => input.kind === 'cancel'
+ ? Promise.resolve({ ok: false, latencyMs: 0, decision: 'cancelled' }) : new Promise(resolve => { finish = resolve; }));
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.custom.test.button' }));
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.custom.test.button' }));
+ expect(window.electronAPI.maker.testProviderConnection).toHaveBeenCalledOnce();
+ if (change === 'key') {
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.apiKeyPlaceholder'), { target: { value: 'different-fake-key' } });
+ } else if (change === 'address') {
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.baseUrlPlaceholder'), { target: { value: 'https://new.example/v1' } });
+ } else {
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.custom.test.stop' }));
+ }
+ expect(window.electronAPI.maker.testProviderConnection).toHaveBeenLastCalledWith(expect.objectContaining({ kind: 'cancel' }));
+ await act(async () => { finish({ ok: true, latencyMs: 1, selected: { baseUrl: 'https://stale.example', wireProtocol: 'openai-responses' } }); });
+ expect(screen.getByPlaceholderText('settings.providers.custom.fields.baseUrlPlaceholder')).toHaveProperty('value', change === 'address' ? 'https://new.example/v1' : 'https://unknown.example/v1');
+ expect(screen.queryByText('settings.providers.custom.test.ok')).toBeNull();
+ });
+ it('binds each supported engine to the identified provider instead of copying the active protocol', async () => {
+ const available: ProviderPreset = { ...preset, runtimes: {
+ ...preset.runtimes,
+ 'claude-code': { baseUrl: 'https://api.deepseek.com/anthropic', wireProtocol: 'anthropic-messages', models: [] },
+ codex: { baseUrl: 'https://api.deepseek.com', wireProtocol: 'openai-chat', models: [] },
+ } };
+ const { onDetected } = await openIdentification(available);
+ await act(async () => { await vi.advanceTimersByTimeAsync(1200); });
+ const value = onDetected.mock.calls[0][0];
+ expect(value.preset.runtimes['claude-code']).toMatchObject({ baseUrl: 'https://api.deepseek.com/anthropic', wireProtocol: 'anthropic-messages' });
+ expect(value.preset.runtimes.codex.wireProtocol).toBe('openai-chat');
+ expect(value.preset.runtimes.pi.wireProtocol).toBe('openai-chat');
+ });
+ it('identifies a provider supported only by another engine without asking the user to choose an engine', async () => {
+ vi.useFakeTimers();
+ const onlyClaude: ProviderPreset = { ...preset, runtimes: {
+ 'claude-code': { baseUrl: 'https://api.deepseek.com', wireProtocol: 'anthropic-messages', models: [] },
+ } };
+ Object.assign(window.electronAPI.maker, {
+ listProviderPresets: vi.fn(async () => ({ presets: [onlyClaude] })),
+ fetchProviderModels: vi.fn(async () => ({ ok: true, models: [{ id: 'one', name: 'One' }] })),
+ });
+ const onDetected = vi.fn();
+ render(<ProviderConnectionDialog onDetected={onDetected} onClose={vi.fn()} onSaved={vi.fn()} />);
+ await act(async () => {});
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.baseUrlPlaceholder'), { target: { value: 'https://api.deepseek.com' } });
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.apiKeyPlaceholder'), { target: { value: 'fake-key' } });
+ await act(async () => { await vi.advanceTimersByTimeAsync(1600); });
+ expect(onDetected).toHaveBeenCalledOnce();
+ const draft = onDetected.mock.calls[0][0];
+ expect(draft.agent).toBe('claude-code');
+ expect(Object.keys(draft.config.runtimes)).toEqual(['claude-code']);
+ expect(window.electronAPI.maker.fetchProviderModels).toHaveBeenCalledWith(expect.objectContaining({ agent: 'claude-code', wireProtocol: 'anthropic-messages' }));
+ });
+ it('keeps independent endpoint credentials out of the shared-key wizard', async () => {
+ vi.useFakeTimers();
+ const available: ProviderPreset = { ...preset, runtimes: { ...preset.runtimes,
+ 'claude-code': { baseUrl: 'https://api.deepseek.com/anthropic', wireProtocol: 'anthropic-messages', models: [] },
+ } };
+ Object.assign(window.electronAPI.maker, {
+ listProviderPresets: vi.fn(async () => ({ presets: [available] })),
+ fetchProviderModels: vi.fn(async () => ({ ok: true, models: [{ id: 'source-model', name: 'Source' }] })),
+ });
+ const independent = { baseUrl: 'https://independent.example/anthropic', models: [{ id: 'own-model', name: 'Own' }] };
+ const onDetected = vi.fn();
+ render(<ProviderConnectionDialog onDetected={onDetected} onClose={vi.fn()} onSaved={vi.fn()}
+ draft={{ preset: available, agent: 'pi', apiKey: 'source-key', keys: { pi: 'source-key', 'claude-code': 'independent-key' },
+ config: { id: 'draft', name: 'Shared', runtimes: { pi: { baseUrl: 'https://api.deepseek.com', models: [] }, 'claude-code': independent } } }} />);
+ await act(async () => {});
+ await act(async () => { await vi.advanceTimersByTimeAsync(400); });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.detection.configure' }));
+ await act(async () => {});
+ const value = onDetected.mock.calls[0][0];
+ expect(value.preset.runtimes['claude-code']).toBeUndefined();
+ expect(value.config.runtimes['claude-code']).toMatchObject(independent);
+ expect(value.keys['claude-code']).toBe('independent-key');
+ expect(window.electronAPI.maker.fetchProviderModels).toHaveBeenCalledOnce();
+ expect(window.electronAPI.maker.fetchProviderModels).toHaveBeenCalledWith(expect.objectContaining({ baseUrl: 'https://api.deepseek.com', apiKey: 'source-key' }));
+ });
+ it('does not hand off to an independently configured fallback engine', async () => {
+ vi.useFakeTimers();
+ const available: ProviderPreset = { ...preset, runtimes: {
+ 'claude-code': { baseUrl: 'https://api.deepseek.com', wireProtocol: 'anthropic-messages', models: [] },
+ } };
+ Object.assign(window.electronAPI.maker, {
+ listProviderPresets: vi.fn(async () => ({ presets: [available] })),
+ fetchProviderModels: vi.fn(async () => ({ ok: true, models: [] })),
+ });
+ const onDetected = vi.fn();
+ render(<ProviderConnectionDialog onDetected={onDetected} onClose={vi.fn()} onSaved={vi.fn()}
+ draft={{ preset: available, agent: 'pi', apiKey: 'source-key', keys: { pi: 'source-key', 'claude-code': 'independent-key' },
+ config: { id: 'draft', name: 'Shared', runtimes: {
+ pi: { baseUrl: 'https://api.deepseek.com', models: [] },
+ 'claude-code': { baseUrl: 'https://private.example', models: [] },
+ } } }} />);
+ await act(async () => {});
+ await act(async () => { await vi.advanceTimersByTimeAsync(2000); });
+ expect(onDetected).not.toHaveBeenCalled();
+ expect(screen.queryByRole('button', { name: 'settings.providers.detection.configure' })).toBeNull();
+ });
+ it('fetches the catalog with the same inheriting engine used for handoff', async () => {
+ vi.useFakeTimers();
+ const available: ProviderPreset = { ...preset, runtimes: {
+ 'claude-code': { baseUrl: 'https://api.deepseek.com', wireProtocol: 'anthropic-messages', models: [] },
+ codex: { baseUrl: 'https://api.deepseek.com', wireProtocol: 'openai-responses', models: [] },
+ } };
+ const fetchProviderModels = vi.fn(async ({ agent }) => ({ ok: true, models: [{ id: agent + '-model', name: agent }] }));
+ Object.assign(window.electronAPI.maker, {
+ listProviderPresets: vi.fn(async () => ({ presets: [available] })), fetchProviderModels,
+ });
+ const onDetected = vi.fn();
+ render(<ProviderConnectionDialog onDetected={onDetected} onClose={vi.fn()} onSaved={vi.fn()}
+ draft={{ preset: available, agent: 'pi', apiKey: 'source-key', keys: { pi: 'source-key', 'claude-code': 'independent-key' },
+ config: { id: 'draft', name: 'Shared', runtimes: {
+ pi: { baseUrl: 'https://api.deepseek.com', models: [] },
+ 'claude-code': { baseUrl: 'https://private.example', models: [] },
+ } } }} />);
+ await act(async () => {});
+ await act(async () => { await vi.advanceTimersByTimeAsync(400); });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.detection.configure' }));
+ await act(async () => {});
+ expect(fetchProviderModels).toHaveBeenCalledWith(expect.objectContaining({ agent: 'codex' }));
+ expect(onDetected.mock.calls[0][0]).toMatchObject({ agent: 'codex', catalog: { models: [{ id: 'codex-model' }] } });
+ });
+ it('preserves unsupported engines with explicit request settings', async () => {
+ vi.useFakeTimers();
+ Object.assign(window.electronAPI.maker, {
+ listProviderPresets: vi.fn(async () => ({ presets: [preset] })),
+ fetchProviderModels: vi.fn(async () => ({ ok: true, models: [] })),
+ });
+ const independent = { baseUrl: 'https://api.deepseek.com', models: [], wireProtocol: 'openai-chat' as const, requestPath: '/special/chat' };
+ const onDetected = vi.fn();
+ render(<ProviderConnectionDialog onDetected={onDetected} onClose={vi.fn()} onSaved={vi.fn()}
+ draft={{ preset, agent: 'pi', apiKey: 'source-key', keys: { pi: 'source-key', codex: 'source-key' },
+ config: { id: 'draft', name: 'Shared', runtimes: { pi: { baseUrl: 'https://api.deepseek.com', models: [] }, codex: independent } } }} />);
+ await act(async () => {});
+ await act(async () => { await vi.advanceTimersByTimeAsync(400); });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.detection.configure' }));
+ await act(async () => {});
+ expect(onDetected.mock.calls[0][0].config.runtimes.codex).toMatchObject(independent);
+ expect(onDetected.mock.calls[0][0].preset.runtimes.codex).toBeUndefined();
+ });
+ it.each([true, false])('does not sync shared edits to an independent runtime with overlapping fields: %s', async sameAddress => {
+ const own = { baseUrl: sameAddress ? 'https://api.deepseek.com' : 'https://independent.example/v1',
+ models: [{ id: 'one', name: 'One' }], requestPath: '/independent/messages' };
+ render(<ProviderConnectionDialog onDetected={vi.fn()} onClose={vi.fn()} onSaved={vi.fn()}
+ draft={{ preset, agent: 'pi', apiKey: 'fake-key', keys: { pi: 'fake-key', 'claude-code': 'fake-key' },
+ config: { id: 'draft', name: 'Draft', runtimes: {
+ pi: { baseUrl: 'https://api.deepseek.com', models: [{ id: 'one', name: 'One' }] }, 'claude-code': own,
+ } } }} />);
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.apiKeyPlaceholder'), { target: { value: 'new-shared-key' } });
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.baseUrlPlaceholder'), { target: { value: 'https://new.example/v1' } });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.connection.saveProvider' }));
+ await act(async () => {});
+ const [config, keys] = customProviderMocks.createCustomProvider.mock.calls[0];
+ expect(keys['claude-code']).toBe('fake-key');
+ expect(config.runtimes['claude-code']).toMatchObject(own);
+ });
+ it('opens manual entry and focuses its error when saving without models', async () => {
+ await openIdentification();
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.detection.keepCustom' }));
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.connection.removeModel' }));
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.namePlaceholder'), { target: { value: 'My custom' } });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.connection.saveProvider' }));
+ await act(async () => {});
+ expect(screen.getByLabelText('settings.providers.connection.manualId')).toBe(document.activeElement);
+ expect(screen.getByText('settings.providers.custom.errors.modelRequired')).toBeTruthy();
+ expect(customProviderMocks.createCustomProvider).not.toHaveBeenCalled();
+ });
+ it('keeps the user in custom settings after cancellation, including later input edits', async () => {
+ const { onDetected } = await openIdentification();
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.detection.keepCustom' }));
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.apiKeyPlaceholder'), { target: { value: 'another-fake-key' } });
+ await act(async () => { await vi.advanceTimersByTimeAsync(2000); });
+ expect(onDetected).not.toHaveBeenCalled();
+ });
+ it('carries an explicit Codex image-generation option into the identified preset', async () => {
+ vi.useFakeTimers();
+ const codexPreset = { ...preset, runtimes: { codex: { ...preset.runtimes.pi, wireProtocol: 'openai-responses' as const } } };
+ Object.assign(window.electronAPI.maker, {
+ listProviderPresets: vi.fn(async () => ({ presets: [codexPreset] })),
+ fetchProviderModels: vi.fn(async () => ({ ok: true, models: [{ id: 'responses-model', name: 'Responses model' }] })),
+ });
+ const onDetected = vi.fn();
+ render(<ProviderConnectionDialog focusAgent="codex" onDetected={onDetected} onClose={vi.fn()} onSaved={vi.fn()}
+ draft={{ agent: 'codex', preset: codexPreset, apiKey: '', config: { id: 'draft', name: '', runtimes: {
+ codex: { baseUrl: '', wireProtocol: 'openai-responses', models: [], supportsImageGeneration: true },
+ } } }} />);
+ await act(async () => {});
+ expect(screen.queryByRole('button', { name: 'settings.providers.custom.fields.runtimeAdvanced' })).toBeNull();
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.baseUrlPlaceholder'), { target: { value: 'https://api.deepseek.com' } });
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.apiKeyPlaceholder'), { target: { value: 'fake-key' } });
+ await act(async () => { await vi.advanceTimersByTimeAsync(1600); });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.detection.configure' }));
+ await act(async () => {});
+ expect(onDetected).toHaveBeenCalledOnce();
+ expect(onDetected.mock.calls[0][0].preset.runtimes.codex).toMatchObject({ supportsImageGeneration: true, wireProtocol: 'openai-responses' });
+ expect(onDetected.mock.calls[0][0].config.runtimes.codex.supportsImageGeneration).toBe(true);
+ });
+ it('reuses the directory after returning to custom without restarting detection', async () => {
+ const { onDetected, fetchProviderModels } = await openIdentification();
+ await act(async () => { await vi.advanceTimersByTimeAsync(1200); });
+ const draft = onDetected.mock.calls[0][0];
+ cleanup();
+ fetchProviderModels.mockClear();
+ const onReturnDetection = vi.fn();
+ render(<ProviderConnectionDialog draft={draft} focusAgent="pi" onDetected={onReturnDetection} onClose={vi.fn()} onSaved={vi.fn()} />);
+ await act(async () => { await vi.advanceTimersByTimeAsync(2000); });
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.custom.fetch.button' }));
+ await act(async () => {});
+ expect(fetchProviderModels).not.toHaveBeenCalled();
+ expect(onReturnDetection).not.toHaveBeenCalled();
+ expect(screen.getAllByRole('dialog')).toHaveLength(2);
+ });
+ it('does not navigate over an open model picker and opening it reuses the successful directory', async () => {
+ const { onDetected, fetchProviderModels } = await openIdentification();
+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.custom.fetch.button' }));
+ await act(async () => {});
+ await act(async () => { await vi.advanceTimersByTimeAsync(1200); });
+ expect(onDetected).not.toHaveBeenCalled();
+ expect(fetchProviderModels).toHaveBeenCalledOnce();
+ });
+ it.each([
+ [[], 'insufficient_evidence'],
+ [['sub2api', 'litellm'], 'conflict'],
+ [['missing-preset'], 'matched'],
+ ])('stays custom for unusable deployment candidates: %s', async (candidates, reason) => {
+ const { onDetected } = await openIdentification();
+ window.electronAPI.maker.detectProvider = vi.fn(async () => ({ candidates, reason, catalog: { ok: true, models: [] } })) as any;
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.baseUrlPlaceholder'), { target: { value: 'https://unknown.example/team/v1' } });
+ await act(async () => { await vi.advanceTimersByTimeAsync(2000); });
+ expect(onDetected).not.toHaveBeenCalled();
+ expect(screen.queryByRole('button', { name: 'settings.providers.detection.configure' })).toBeNull();
+ });
+ it('does not navigate after unmount with a scheduled official handoff', async () => {
+ const { onDetected } = await openIdentification();
+ cleanup();
+ await act(async () => { await vi.advanceTimersByTimeAsync(2000); });
+ expect(onDetected).not.toHaveBeenCalled();
+ });
+ it('uses the current name when the user edits it during the jump delay', async () => {
+ const { onDetected } = await openIdentification();
+ fireEvent.change(screen.getByPlaceholderText('settings.providers.custom.fields.namePlaceholder'), { target: { value: 'Latest name' } });
+ await act(async () => { await vi.advanceTimersByTimeAsync(1200); });
+ expect(onDetected).toHaveBeenCalledOnce();
+ expect(onDetected.mock.calls[0][0].config.name).toBe('Latest name');
+ });
+ it('ignores a late response after the connection changes', async () => {
+ const { onDetected, fetchProviderModels } = await openIdentification();
+ let finish!: (value: { ok: true; models: { id: string; name: string }[] }) => void;
+ fetchProviderModels.mockImplementationOnce(() => new Promise(resolve => { finish = resolve; }));
+ const key = screen.getByPlaceholderText('settings.providers.custom.fields.apiKeyPlaceholder');
+ fireEvent.change(key, { target: { value: 'old-fake-key' } });
+ await act(async () => { await vi.advanceTimersByTimeAsync(400); });
+ fireEvent.change(key, { target: { value: 'new-fake-key' } });
+ await act(async () => { finish({ ok: true, models: [{ id: 'obsolete-model', name: 'Obsolete' }] }); });
+ await act(async () => { await vi.advanceTimersByTimeAsync(1600); });
+ expect(onDetected).toHaveBeenCalledOnce();
+ expect(onDetected.mock.calls[0][0].apiKey).toBe('new-fake-key');
+ expect(onDetected.mock.calls[0][0].config.runtimes.pi.models.map((m: { id: string }) => m.id)).not.toContain('obsolete-model');
+ });
+});
diff --cc apps/desktop/src/renderer/i18n/locales/en/common.json
index 5c8280d5e3,eff8d2e207..2e48870320
--- a/apps/desktop/src/renderer/i18n/locales/en/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json
@@@ -3164,14 -3260,8 +3260,13 @@@
"placeholder": "Choose a template…"
},
"test": {
- "testing": "Testing the connection and compatible interfaces…",
+ "inconclusive": "Connection could not be confirmed. Check the address or network before retrying; the previous request may have run.",
+ "exhausted": "All candidate interfaces were tried. No working connection was found.",
+ "costHint": "Testing sends short generation requests and may incur a small charge.",
+ "details": "View attempts",
"button": "Test connection",
"testing": "Testing…",
+ "stop": "Stop test",
"ok": "Connected ({{ms}} ms)",
"needFields": "Fill in the base URL and at least one model ID first",
"unsupportedProtocol": "This model protocol is not supported by connection testing"
@@@ -3779,16 -3865,24 +3874,35 @@@
"unavailable": "Temporarily unavailable"
},
"claudeAccountRetired": "Cindy no longer supports signing in to your subscription through this legacy Claude connection. Your Claude account and subscription are unaffected. Use “Sign in with Claude Code” to connect.",
+ "detection": {
+ "keyRequired": "Enter your API key to continue.",
+ "authRejected": "Authentication failed. Check the URL and API key; we’ll retry when you update them.",
+ "hint": "Enter the URL and API key to identify the provider. Protocol settings remain available when editing the saved connection.",
+ "pending": "Identifying provider…",
+ "matched": "Identified as {{name}}",
+ "ambiguous": "Multiple configurations match. Continue with custom settings or choose a provider.",
+ "custom": "Continue with custom settings. You can fetch models or add them manually.",
+ "configure": "Configure provider",
+ "keepCustom": "Continue with custom settings"
++ },
+ "speechSetup": {
+ "title": "Speech",
+ "add": "Add speech models",
+ "referenceHint": "Reference models come from the public catalog, not your account entitlements. Availability depends on an actual request.",
+ "discoveryHint": "These models were returned by the provider catalog. Speech execution has not been tested.",
+ "saved": "Added",
+ "reference": "Reference",
+ "discovered": "Discovered",
+ "more": "More speech models ({{count}})",
+ "manual": "Enter a speech model ID",
+ "modelId": "Speech model ID",
+ "modelsHint": "Saving speech models does not start speech synthesis. Choose voices and sentence playback in companion voice settings.",
+ "otherModels": "Chat and other models",
+ "separateKey": "Speech requires an API key. This creates a separate connection and keeps your subscription or device-code connection.",
+ "fetchFailed": "The model catalog is unavailable. You can still add reference models.",
+ "saveFailed": "Could not add models. Reopen this page and try again.",
+ "manualSource": "Manual",
+ "manualHint": "Enter the speech model ID provided by your supplier."
}
},
"experimental": {
diff --cc apps/desktop/src/renderer/i18n/locales/ja/common.json
index e8b6941094,ef86e6424f..243924d8ef
--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json
@@@ -3135,14 -3231,8 +3231,13 @@@
"placeholder": "テンプレートを選択…"
},
"test": {
- "testing": "接続と互換インターフェースを確認中…",
+ "inconclusive": "接続を確認できませんでした。アドレスやネットワークを確認してから再試行してください。前のリクエストが実行済みの可能性があります。",
+ "exhausted": "すべての候補を試しましたが、接続できませんでした。",
+ "costHint": "テストでは短い生成リクエストを送信し、少額の料金が発生する場合があります。",
+ "details": "試行結果を表示",
"button": "接続テスト",
"testing": "テスト中…",
+ "stop": "テストを停止",
"ok": "接続に成功しました({{ms}}ms)",
"needFields": "先にベース URL と少なくとも 1 つのモデル ID を入力してください",
"unsupportedProtocol": "接続テストはこのモデルプロトコルに対応していません"
@@@ -3748,16 -3834,24 +3843,35 @@@
"unavailable": "一時的に利用できません"
},
"claudeAccountRetired": "Cindy では、この旧式の Claude 接続を使ったサブスクリプションへのログインに対応していません。Claude アカウントとサブスクリプションには影響ありません。「Claude Code でログイン」から接続してください。",
+ "detection": {
+ "keyRequired": "API キーを入力して続けてください。",
+ "authRejected": "認証できませんでした。URL と API キーを確認してください。変更すると自動的に再試行します。",
+ "hint": "URL と API キーを入力するとプロバイダーを識別します。保存後、接続の編集でプロトコルを変更できます。",
+ "pending": "プロバイダーを識別中…",
+ "matched": "{{name}} として識別されました",
+ "ambiguous": "複数の設定が一致しました。カスタム設定を続けるか、プロバイダーを選択してください。",
+ "custom": "カスタム設定を続けます。モデル一覧を取得するか、手動で追加できます。",
+ "configure": "設定に進む",
+ "keepCustom": "カスタム設定を続ける"
++ },
+ "speechSetup": {
+ "title": "音声",
+ "add": "音声モデルを追加",
+ "referenceHint": "参考モデルは公開カタログに基づき、アカウントの利用権限を示すものではありません。実際に利用できるかは呼び出し時に確認されます。",
+ "discoveryHint": "以下はプロバイダーのカタログから取得したモデルです。音声の実行は未検証です。",
+ "saved": "追加済み",
+ "reference": "参考モデル",
+ "discovered": "取得済み",
+ "more": "その他の音声モデル({{count}})",
+ "manual": "音声モデル ID を入力",
+ "modelId": "音声モデル ID",
+ "modelsHint": "音声モデルを保存しても、音声合成は開始されません。音声や文ごとの読み上げはパートナーの音声設定で調整できます。",
+ "otherModels": "チャットとその他のモデル",
+ "separateKey": "音声には API キーが必要です。別の接続を作成し、既存のサブスクリプションやデバイスコードの接続は保持します。",
+ "fetchFailed": "モデル一覧を取得できません。参考モデルを選んで追加できます。",
+ "saveFailed": "モデルを追加できませんでした。このページを開き直して再試行してください。",
+ "manualSource": "手動追加",
+ "manualHint": "プロバイダーが提供する音声モデル ID を入力してください。"
}
},
"experimental": {
diff --cc apps/desktop/src/renderer/i18n/locales/ko/common.json
index cda24c8d18,e0bdf41b61..e6faf85679
--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json
@@@ -3135,14 -3231,8 +3231,13 @@@
"placeholder": "템플릿 선택…"
},
"test": {
- "testing": "연결 및 호환 인터페이스 확인 중…",
+ "inconclusive": "연결을 확인하지 못했습니다. 주소나 네트워크를 확인한 후 다시 시도하세요. 이전 요청이 실행되었을 수 있습니다.",
+ "exhausted": "모든 후보 인터페이스를 시도했지만 연결하지 못했습니다.",
+ "costHint": "테스트는 짧은 생성 요청을 보내며 소액의 요금이 발생할 수 있습니다.",
+ "details": "시도 결과 보기",
"button": "연결 테스트",
"testing": "테스트 중…",
+ "stop": "테스트 중지",
"ok": "연결 성공 ({{ms}}ms)",
"needFields": "먼저 기본 URL과 모델 ID를 하나 이상 입력하세요",
"unsupportedProtocol": "연결 테스트는 이 모델 프로토콜을 지원하지 않습니다"
@@@ -3748,16 -3834,24 +3843,35 @@@
"unavailable": "일시적으로 사용할 수 없음"
},
"claudeAccountRetired": "Cindy에서는 이 이전 Claude 연결 방식으로 구독에 로그인할 수 없습니다. Claude 계정과 구독에는 영향이 없습니다. ‘Claude Code로 로그인’을 사용해 구독을 연결하세요.",
+ "detection": {
+ "keyRequired": "API 키를 입력해 계속하세요.",
+ "authRejected": "인증하지 못했습니다. URL과 API 키를 확인하세요. 수정하면 자동으로 다시 시도합니다.",
+ "hint": "URL과 API 키를 입력하면 제공자를 식별합니다. 저장한 연결을 편집하여 프로토콜을 변경할 수 있습니다.",
+ "pending": "제공자 식별 중…",
+ "matched": "{{name}}(으)로 식별됨",
+ "ambiguous": "여러 설정이 일치합니다. 사용자 지정 설정을 계속하거나 제공자를 선택하세요.",
+ "custom": "사용자 지정 설정을 계속합니다. 모델 목록을 가져오거나 직접 추가할 수 있습니다.",
+ "configure": "설정으로 이동",
+ "keepCustom": "사용자 지정 계속"
++ },
+ "speechSetup": {
+ "title": "음성",
+ "add": "음성 모델 추가",
+ "referenceHint": "참조 모델은 공개 카탈로그를 기반으로 하며 계정의 이용 권한을 의미하지 않습니다. 실제 사용 가능 여부는 호출 시 확인됩니다.",
+ "discoveryHint": "제공자 카탈로그에서 반환된 모델입니다. 음성 실행은 아직 검증되지 않았습니다.",
+ "saved": "추가됨",
+ "reference": "참조 모델",
+ "discovered": "검색됨",
+ "more": "음성 모델 더 보기 ({{count}})",
+ "manual": "음성 모델 ID 직접 입력",
+ "modelId": "음성 모델 ID",
+ "modelsHint": "음성 모델을 저장해도 음성 합성은 시작되지 않습니다. 음색과 문장별 읽기는 파트너 음성 설정에서 조정할 수 있습니다.",
+ "otherModels": "대화 및 기타 모델",
+ "separateKey": "음성에는 API 키가 필요합니다. 별도 연결을 만들고 기존 구독 또는 기기 코드 연결은 유지합니다.",
+ "fetchFailed": "모델 목록을 가져올 수 없습니다. 참조 모델을 선택하여 추가할 수 있습니다.",
+ "saveFailed": "모델을 추가하지 못했습니다. 이 페이지를 다시 열고 시도해 주세요.",
+ "manualSource": "직접 추가",
+ "manualHint": "제공자가 제공한 음성 모델 ID를 입력하세요."
}
},
"experimental": {
diff --cc apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
index 9f7e0e8d98,751df5ec8e..95a880c4e7
--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
@@@ -3135,14 -3231,8 +3231,13 @@@
"placeholder": "选择一个模板…"
},
"test": {
- "testing": "正在测试连接,并按需尝试兼容接口…",
+ "inconclusive": "暂时无法确认连接。请检查地址或网络后重试;上一条请求可能已执行。",
+ "exhausted": "已尝试所有候选接口,暂未找到可用连接。",
+ "costHint": "测试会发送简短生成请求,可能产生少量费用。",
+ "details": "查看尝试结果",
"button": "测试连接",
"testing": "测试中…",
+ "stop": "停止测试",
"ok": "连接成功({{ms}}ms)",
"needFields": "请先填写基础 URL 和至少一个模型 ID",
"unsupportedProtocol": "测试连接暂不支持该模型协议"
@@@ -3748,16 -3834,24 +3843,35 @@@
"unavailable": "暂时不可用"
},
"claudeAccountRetired": "Cindy 已不再支持通过这条旧版 Claude 连接登录订阅,不影响你的 Claude 账号和订阅。请改用「使用 Claude Code 登录」连接订阅",
+ "detection": {
+ "keyRequired": "填写 API 密钥后继续。",
+ "authRejected": "认证未通过,请检查地址和 API 密钥,修改后会自动重试。",
+ "hint": "填写地址和 API 密钥后自动识别供应商。保存后可在编辑连接中调整协议。",
+ "pending": "正在识别供应商…",
+ "matched": "已识别为 {{name}}",
+ "ambiguous": "匹配到多个配置,请继续自定义或选择供应商。",
+ "custom": "继续自定义配置,可获取模型列表或手动添加。",
+ "configure": "前往配置",
+ "keepCustom": "继续自定义"
++ },
+ "speechSetup": {
+ "title": "语音",
+ "add": "添加语音模型",
+ "referenceHint": "参考型号来自公共模型资料,不代表当前账号已开通。是否可用以实际调用为准。",
+ "discoveryHint": "以下型号由供应商目录返回,尚未验证语音调用。",
+ "saved": "已添加",
+ "reference": "参考型号",
+ "discovered": "目录返回",
+ "more": "更多语音型号({{count}})",
+ "manual": "手动输入语音型号",
+ "modelId": "语音模型 ID",
+ "modelsHint": "保存语音模型不会发起语音合成。音色和逐句朗读可在伙伴语音设置中调整。",
+ "otherModels": "对话与其他模型",
+ "separateKey": "语音服务需要 API Key。将创建独立连接,原有订阅或设备码连接会保留。",
+ "fetchFailed": "模型目录暂时无法获取,仍可选择参考型号添加。",
+ "saveFailed": "添加失败,请重新打开此页面后重试。",
+ "manualSource": "手动添加",
+ "manualHint": "输入供应商提供的语音模型 ID。"
}
},
"experimental": {
diff --cc apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
index 76c6535301,8f666862f1..79379845c7
--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
@@@ -3135,14 -3231,8 +3231,13 @@@
"placeholder": "選擇一個模板…"
},
"test": {
- "testing": "正在測試連線,並視需要嘗試相容介面…",
+ "inconclusive": "暫時無法確認連線。請檢查位址或網路後重試;上一個請求可能已執行。",
+ "exhausted": "已嘗試所有候選介面,暫未找到可用連線。",
+ "costHint": "測試會傳送簡短生成請求,可能產生少量費用。",
+ "details": "查看嘗試結果",
"button": "測試連線",
"testing": "測試中…",
+ "stop": "停止測試",
"ok": "連線成功({{ms}}ms)",
"needFields": "請先填寫基礎 URL 和至少一個模型 ID",
"unsupportedProtocol": "測試連線暫不支援此模型協定"
@@@ -3748,16 -3834,24 +3843,35 @@@
"unavailable": "暫時無法使用"
},
"claudeAccountRetired": "Cindy 已不再支援透過這筆舊版 Claude 連線登入訂閱,不影響你的 Claude 帳號和訂閱。請改用「使用 Claude Code 登入」連線訂閱",
+ "detection": {
+ "keyRequired": "填寫 API 金鑰後繼續。",
+ "authRejected": "驗證未通過,請檢查位址和 API 金鑰,修改後會自動重試。",
+ "hint": "填寫網址和 API 金鑰後自動識別供應商。儲存後可在編輯連線中調整協定。",
+ "pending": "正在識別供應商…",
+ "matched": "已識別為 {{name}}",
+ "ambiguous": "符合多個設定,請繼續自訂或選擇供應商。",
+ "custom": "繼續自訂設定,可取得模型清單或手動新增。",
+ "configure": "前往設定",
+ "keepCustom": "繼續自訂"
++ },
+ "speechSetup": {
+ "title": "語音",
+ "add": "新增語音模型",
+ "referenceHint": "參考型號來自公開模型資料,不代表目前帳號已開通。是否可用以實際呼叫為準。",
+ "discoveryHint": "以下型號由供應商目錄傳回,尚未驗證語音呼叫。",
+ "saved": "已新增",
+ "reference": "參考型號",
+ "discovered": "目錄傳回",
+ "more": "更多語音型號({{count}})",
+ "manual": "手動輸入語音型號",
+ "modelId": "語音模型 ID",
+ "modelsHint": "儲存語音模型不會啟動語音合成。音色和逐句朗讀可在夥伴語音設定中調整。",
+ "otherModels": "對話與其他模型",
+ "separateKey": "語音服務需要 API Key。將建立獨立連線,原有訂閱或裝置碼連線會保留。",
+ "fetchFailed": "暫時無法取得模型目錄,仍可選擇參考型號新增。",
+ "saveFailed": "新增失敗,請重新開啟此頁面後重試。",
+ "manualSource": "手動新增",
+ "manualHint": "輸入供應商提供的語音模型 ID。"
}
},
"experimental": {
diff --cc docs/design-rules/design-inventory.md
index 281a57f3f0,c4f43c8b16..6ae870219e
--- a/docs/design-rules/design-inventory.md
+++ b/docs/design-rules/design-inventory.md
@@@ -37,9 -37,9 +37,9 @@@
| `desktop.overlay.splash` | desktop | 启动遮罩 | App → SplashScreen;同源 gating 下并挂 LoginBrandStage(z-9980 品牌画布,启动期即可见、Splash(z-9999) 之下) | LoginBrandStage, SplashScreen | apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/splash/SplashScreen.tsx | 3 | 0 | 5 |
| `desktop.overlay.toast` | desktop | Toast | App 常驻 ToastContainer(用户可见出口,不展开业务逻辑) | Toast, ToastContainer | apps/desktop/src/renderer/components/ui/toast/DownloadToast.tsx, apps/desktop/src/renderer/components/ui/toast/Toast.tsx, apps/desktop/src/renderer/components/ui/toast/ToastContainer.tsx, apps/desktop/src/renderer/components/ui/toast/index.ts | 7 | 4 | 3 |
| `desktop.plugins.app-main` | desktop | 插件主视图 | hash `/apps/:ghostId`(GhostMainViewFeatureLayout) | GhostMainViewFeatureLayout, GhostMainViewHost | apps/desktop/src/renderer/features/plugin/GhostMainViewFeatureLayout.tsx, apps/desktop/src/renderer/features/plugin/GhostMainViewHost.tsx | 0 | 0 | 0 |
- | `desktop.plugins.installed` | desktop | 已装插件 | hash `/plugins`(GhostPluginPage) | AddMarketplaceDialog, GhostPluginActions, GhostPluginDetailView, GhostPluginPage, MarketPluginDetailView, MyPublishesSection, PluginDevicePicker, PluginManagementLayout, PluginProjectMenu, RemotePluginConfiguration, RemotePluginPage, RemotePluginReadOnlyDetail, UpdateAllDialog | apps/desktop/src/renderer/features/plugin/AddMarketplaceDialog.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginActions.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginDetailView.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginPage.tsx, apps/desktop/src/renderer/features/plugin/MarketPluginDetailView.tsx, apps/desktop/src/renderer/features/plugin/MyPublishesSection.tsx, apps/desktop/src/renderer/features/plugin/PluginDevicePicker.tsx, apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx, apps/desktop/src/renderer/features/plugin/PluginScopePicker.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginConfiguration.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginPage.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginReadOnlyDetail.tsx, apps/desktop/src/renderer/features/plugin/UpdateAllDialog.tsx, apps/desktop/src/renderer/features/plugin/plugin-motion.css | 28 | 0 | 47 |
- | `desktop.settings` | desktop | 设置 | hash `/settings`(SettingsView;tab 含 general / personalization / providers / billing / usage / voice-input / im-bot / shortcuts / agent-island / import / remote-control / ghosts / builtin-tools / computer-use / help / about) | SettingsView | apps/desktop/src/renderer/components/settings/AboutSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AboutSection.tsx, apps/desktop/src/renderer/components/settings/AccountDeletionSection.tsx, apps/desktop/src/renderer/components/settings/AddProviderWizard.tsx, apps/desktop/src/renderer/components/settings/AgentIslandSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AgentIslandSection.tsx, apps/desktop/src/renderer/components/settings/AgentResourceSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AgentResourceSection.tsx, apps/desktop/src/renderer/components/settings/AppearanceSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AppearanceSection.tsx, apps/desktop/src/renderer/components/settings/AuxiliaryModelSection.tsx, apps/desktop/src/renderer/components/settings/AvatarCropEditor.tsx, apps/desktop/src/renderer/components/settings/BetaChannelCell.tsx, apps/desktop/src/renderer/components/settings/BillingSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/BrowserBackendSubsection.tsx, apps/desktop/src/renderer/components/settings/BrowserRealProfileSubsection.tsx, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.tsx, apps/desktop/src/renderer/components/settings/ChatEmbeddingCell.tsx, apps/desktop/src/renderer/components/settings/ChipMetricsSection.tsx, apps/desktop/src/renderer/components/settings/CindyMakeSection.settings-search.ts, apps/desktop/src/renderer/components/settings/CindyMakeSection.tsx, apps/desktop/src/renderer/components/settings/CollaborationSection.settings-search.ts, apps/desktop/src/renderer/components/settings/CollaborationSection.tsx, apps/desktop/src/renderer/components/settings/CompactionSection.tsx, apps/desktop/src/renderer/components/settings/ComposerSendShortcutSection.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionRow.tsx, apps/desktop/src/renderer/components/settings/ComputerUseSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx, apps/desktop/src/renderer/components/settings/CustomProviderRuntimeFillOverlay.tsx, apps/desktop/src/renderer/components/settings/DefaultOverrideControls.tsx, apps/desktop/src/renderer/components/settings/DialogueDirectorySection.tsx, apps/desktop/src/renderer/components/settings/DingTalkBotSection.tsx, apps/desktop/src/renderer/components/settings/DiscordBotSection.tsx, apps/desktop/src/renderer/components/settings/DownloadMeter.tsx, apps/desktop/src/renderer/components/settings/ExperimentalSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotNotificationSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotSection.tsx, apps/desktop/src/renderer/components/settings/FontFamilyPicker.tsx, apps/desktop/src/renderer/components/settings/GeneralSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/GenericGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/GitSafetySection.settings-search.ts, apps/desktop/src/renderer/components/settings/GitSafetySection.tsx, apps/desktop/src/renderer/components/settings/HarnessVersionMenuRow.tsx, apps/desktop/src/renderer/components/settings/HelpAssistantPanel.tsx, apps/desktop/src/renderer/components/settings/HelpSection.settings-search.ts, apps/desktop/src/renderer/components/settings/HelpSection.tsx, apps/desktop/src/renderer/components/settings/HelpThreadView.tsx, apps/desktop/src/renderer/components/settings/HookConnectionsSection.tsx, apps/desktop/src/renderer/components/settings/HookWorkspacePrefsEditor.tsx, apps/desktop/src/renderer/components/settings/ImBotSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ImBotSection.tsx, apps/desktop/src/renderer/components/settings/ImChannelSettingsCard.tsx, apps/desktop/src/renderer/components/settings/ImDefaultSettingsSection.tsx, apps/desktop/src/renderer/components/settings/ImLifecycleAnnouncementSection.tsx, apps/desktop/src/renderer/components/settings/InputDeviceConnectionStatus.tsx, apps/desktop/src/renderer/components/settings/JoyConGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.tsx, apps/desktop/src/renderer/components/settings/LanguageSection.tsx, apps/desktop/src/renderer/components/settings/LayoutResetControl.tsx, apps/desktop/src/renderer/components/settings/LinkOpenSection.tsx, apps/desktop/src/renderer/components/settings/LlamaCppCandidates.tsx, apps/desktop/src/renderer/components/settings/LlamaCppProviderDetail.tsx, apps/desktop/src/renderer/components/settings/LocalModelDownloadUI.tsx, apps/desktop/src/renderer/components/settings/LocalOllamaInstall.tsx, apps/desktop/src/renderer/components/settings/LocalPackagingTag.tsx, apps/desktop/src/renderer/components/settings/LogoutSection.tsx, apps/desktop/src/renderer/components/settings/LspBetaCell.tsx, apps/desktop/src/renderer/components/settings/McpServerDialog.tsx, apps/desktop/src/renderer/components/settings/McpServersSection.tsx, apps/desktop/src/renderer/components/settings/MemorySection.tsx, apps/desktop/src/renderer/components/settings/MessageNavRailCell.tsx, apps/desktop/src/renderer/components/settings/ModelAdvancedDrawer.tsx, apps/desktop/src/renderer/components/settings/ModelPriceOverrideDialog.tsx, apps/desktop/src/renderer/components/settings/MyDevicesPanel.tsx, apps/desktop/src/renderer/components/settings/NotificationSection.settings-search.ts, apps/desktop/src/renderer/components/settings/NotificationSection.tsx, apps/desktop/src/renderer/components/settings/OAuthDeviceCodeCard.tsx, apps/desktop/src/renderer/components/settings/OllamaProviderDetail.tsx, apps/desktop/src/renderer/components/settings/OwnRemoteProviders.tsx, apps/desktop/src/renderer/components/settings/PersonalizationDetails.settings-search.ts, apps/desktop/src/renderer/components/settings/PersonalizationSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/PiKernelVersionRow.tsx, apps/desktop/src/renderer/components/settings/PiPackagesSection.tsx, apps/desktop/src/renderer/components/settings/PlayStationGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/ProfileEditDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderConnectionDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderImportDialog.tsx, apps/desktop/src/renderer/components/settings/ProvidersSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ProvidersSection.tsx, apps/desktop/src/renderer/components/settings/ReadOnlyProviderModels.tsx, apps/desktop/src/renderer/components/settings/RemoteControlSection.settings-search.ts, apps/desktop/src/renderer/components/settings/RemoteControlSection.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopPermissions.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopSetting.tsx, apps/desktop/src/renderer/components/settings/RemoteHostDetail.tsx, apps/desktop/src/renderer/components/settings/RemoteSection.tsx, apps/desktop/src/renderer/components/settings/SessionImportSection.settings-search.ts, apps/desktop/src/renderer/components/settings/SessionImportSection.tsx, apps/desktop/src/renderer/components/settings/SessionRuntimeFallbackCell.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.settings-search.ts, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.tsx, apps/desktop/src/renderer/components/settings/SettingsSearchBox.tsx, apps/desktop/src/renderer/components/settings/SettingsSearchNavigation.ts, apps/desktop/src/renderer/components/settings/SettingsSidebarNav.tsx, apps/desktop/src/renderer/components/settings/SettingsTextInput.tsx, apps/desktop/src/renderer/components/settings/SettingsView.tsx, apps/desktop/src/renderer/components/settings/SharedTasks.settings-search.ts, apps/desktop/src/renderer/components/settings/SilentEncryptedRetryCell.tsx, apps/desktop/src/renderer/components/settings/SshKeySetupDialog.tsx, apps/desktop/src/renderer/components/settings/StorageManagementCard.settings-search.ts, apps/desktop/src/renderer/components/settings/StorageManagementCard.tsx, apps/desktop/src/renderer/components/settings/StreamFadeSection.tsx, apps/desktop/src/renderer/components/settings/SubagentModelSection.settings-search.ts, apps/desktop/src/renderer/components/settings/SubagentModelSection.tsx, apps/desktop/src/renderer/components/settings/SwitchProGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/TelegramBehaviorSettings.tsx, apps/desktop/src/renderer/components/settings/TelegramBotSection.tsx, apps/desktop/src/renderer/components/settings/TelegramRemoteDevices.tsx, apps/desktop/src/renderer/components/settings/TerminalShellSection.tsx, apps/desktop/src/renderer/components/settings/TipsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/TipsSection.tsx, apps/desktop/src/renderer/components/settings/UnifiedModelList.tsx, apps/desktop/src/renderer/components/settings/UserProfileCard.tsx, apps/desktop/src/renderer/components/settings/UserPromptSection.tsx, apps/desktop/src/renderer/components/settings/VisionBridgeSection.settings-search.ts, apps/desktop/src/renderer/components/settings/VisionBridgeSection.tsx, apps/desktop/src/renderer/components/settings/VoiceInputSection.settings-search.ts, apps/desktop/src/renderer/components/settings/VoiceInputSection.tsx, apps/desktop/src/renderer/components/settings/VoiceSpeakerEnrollmentDialog.tsx, apps/desktop/src/renderer/components/settings/VoiceSpeakerFilterCard.tsx, apps/desktop/src/renderer/components/settings/WallpaperSection.tsx, apps/desktop/src/renderer/components/settings/WechatBotSection.tsx, apps/desktop/src/renderer/components/settings/WecomBotSection.tsx, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.settings-search.ts, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeyboardLayout.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeycapGlyphs.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexSettings.tsx, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.settings-search.ts, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.tsx, apps/desktop/src/renderer/components/settings/XUsageGuide.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadSettings.tsx, apps/desktop/src/renderer/components/settings/androidStatusPresentation.ts, apps/desktop/src/renderer/components/settings/avatarCropGeometry.ts, apps/desktop/src/renderer/components/settings/avatarCropImage.ts, apps/desktop/src/renderer/components/settings/billingVisibility.ts, apps/desktop/src/renderer/components/settings/browserOpenForLoginError.ts, apps/desktop/src/renderer/components/settings/cindyMakeVisibility.ts, apps/desktop/src/renderer/components/settings/computerPermissionFlow.ts, apps/desktop/src/renderer/components/settings/contacts/ContactDetailPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsImportDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsListPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsManagerDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsSection.tsx, apps/desktop/src/renderer/components/settings/contacts/startContactsAiSession.ts, apps/desktop/src/renderer/components/settings/dialogueDirectoryDisplay.ts, apps/desktop/src/renderer/components/settings/dualSenseSilhouette.ts, apps/desktop/src/renderer/components/settings/feishuBotPresentation.ts, apps/desktop/src/renderer/components/settings/fontFamilyValue.ts, apps/desktop/src/renderer/components/settings/gamepadLayoutPrimitives.tsx, apps/desktop/src/renderer/components/settings/gamepadSilhouetteGeom.ts, apps/desktop/src/renderer/components/settings/hookWorkspacePrefsLogic.ts, apps/desktop/src/renderer/components/settings/imBotVisibility.ts, apps/desktop/src/renderer/components/settings/imDefaultSettingsLogic.ts, apps/desktop/src/renderer/components/settings/joyConSilhouette.ts, apps/desktop/src/renderer/components/settings/modelManagementPresentation.ts, apps/desktop/src/renderer/components/settings/modelManagementState.ts, apps/desktop/src/renderer/components/settings/myDevicesModel.ts, apps/desktop/src/renderer/components/settings/providerAssetModule.ts, apps/desktop/src/renderer/components/settings/realProfilePermissionGuide.ts, apps/desktop/src/renderer/components/settings/settingsRowClasses.ts, apps/desktop/src/renderer/components/settings/settingsSearchCatalog.ts, apps/desktop/src/renderer/components/settings/settingsSearchTypes.ts, apps/desktop/src/renderer/components/settings/switchProSilhouette.ts, apps/desktop/src/renderer/components/settings/ultimateC1Silhouette.ts, apps/desktop/src/renderer/components/settings/usage/UsageBarsTooltip.tsx, apps/desktop/src/renderer/components/settings/usage/UsageBreakdownTables.tsx, apps/desktop/src/renderer/components/settings/usage/UsageDeviceSelect.tsx, apps/desktop/src/renderer/components/settings/usage/UsageFilterSelect.tsx, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.settings-search.ts, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.tsx, apps/desktop/src/renderer/components/settings/usage/UsageStatRow.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTaskTable.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTokenBars.tsx, apps/desktop/src/renderer/components/settings/usage/formatUsagePercent.ts, apps/desktop/src/renderer/components/settings/usage/usageCharts.css, apps/desktop/src/renderer/components/settings/usage/usageHistoryColors.ts, apps/desktop/src/renderer/components/settings/usage/usageHistoryStats.ts, apps/desktop/src/renderer/components/settings/usageVisibility.ts, apps/desktop/src/renderer/components/settings/useProviderSubscriptionCard.ts, apps/desktop/src/renderer/components/settings/useSettingsEscape.ts, apps/desktop/src/renderer/components/settings/useSettingsSectionTarget.ts, apps/desktop/src/renderer/components/settings/wizardRecommend.ts, apps/desktop/src/renderer/components/settings/workLouderCodexCommandCopy.ts, apps/desktop/src/renderer/components/settings/xboxSeriesSilhouette.ts, apps/desktop/src/renderer/styles/sortable.css | 136 | 95 | 546 |
- | `desktop.shell.main-layout` | desktop | 主窗口壳(标题栏 / 左右栏 / 内容区) | main BrowserWindow → renderer/index.tsx → main-entry.tsx → App → MainLayout (`#/` 受保护壳) | ChromeActions, DeviceSectionHeader, FeishuConflictDialogHost, GhostMediaLightboxHost, MainLayout, ProjectsSection, RightSidebar, RightSidebarShell, SessionShareImportWizard, Sidebar, UpdateNoticeDialog, WindowControls | apps/desktop/src/renderer/cindy-brain/GhostMediaLightboxHost.tsx, apps/desktop/src/renderer/components/UpdateNoticeDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialogHost.tsx, apps/desktop/src/renderer/components/layout/AppBadgeAttentionSync.tsx, apps/desktop/src/renderer/components/layout/BrowserWebviewPool.tsx, apps/desktop/src/renderer/components/layout/ChromeActions.tsx, apps/desktop/src/renderer/components/layout/ContentHeader.tsx, apps/desktop/src/renderer/components/layout/CredentialStoreBanner.tsx, apps/desktop/src/renderer/components/layout/FadeSwitcher.tsx, apps/desktop/src/renderer/components/layout/GhostPanelWindowLayout.tsx, apps/desktop/src/renderer/components/layout/GlobalDropImportListener.tsx, apps/desktop/src/renderer/components/layout/MainEntryRedirect.tsx, apps/desktop/src/renderer/components/layout/MainLayout.tsx, apps/desktop/src/renderer/components/layout/RightSidebar.tsx, apps/desktop/src/renderer/components/layout/RightSidebarDetach.tsx, apps/desktop/src/renderer/components/layout/RightSidebarMaximize.tsx, apps/desktop/src/renderer/components/layout/RightSidebarToggle.tsx, apps/desktop/src/renderer/components/layout/SidebarWindowLayout.tsx, apps/desktop/src/renderer/components/layout/WallpaperVideo.tsx, apps/desktop/src/renderer/components/layout/chromeActionsGeometry.ts, apps/desktop/src/renderer/components/layout/chromeActionsLayout.ts, apps/desktop/src/renderer/components/layout/railChromeActions.ts, apps/desktop/src/renderer/components/layout/windowDrag.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/sidebar/AccountSwitcherDialog.tsx, apps/desktop/src/renderer/components/sidebar/AttentionDot.tsx, apps/desktop/src/renderer/components/sidebar/DatabaseSizeWarningBanner.tsx, apps/desktop/src/renderer/components/sidebar/GhostMainViewNavEntries.tsx, apps/desktop/src/renderer/components/sidebar/MobileDownloadDialog.tsx, apps/desktop/src/renderer/components/sidebar/NavigationCountBadge.tsx, apps/desktop/src/renderer/components/sidebar/NewTag.tsx, apps/desktop/src/renderer/components/sidebar/Sidebar.tsx, apps/desktop/src/renderer/components/sidebar/SidebarIconButton.tsx, apps/desktop/src/renderer/components/sidebar/SidebarNavigationCustomize.tsx, apps/desktop/src/renderer/components/sidebar/SidebarTopNav.tsx, apps/desktop/src/renderer/components/sidebar/SortableList.tsx, apps/desktop/src/renderer/components/sidebar/UpdateBanner.tsx, apps/desktop/src/renderer/components/sidebar/UserInfoSection.tsx, apps/desktop/src/renderer/components/sidebar/VendorIcon.tsx, apps/desktop/src/renderer/components/sidebar/VendorReadinessBadge.tsx, apps/desktop/src/renderer/components/sidebar/WorktreeBadge.tsx, apps/desktop/src/renderer/components/sidebar/sidebarNavigationPrefs.ts, apps/desktop/src/renderer/components/sidebar/useHoverOpenMenu.ts, apps/desktop/src/renderer/components/title-bar/ChromeIconButton.tsx, apps/desktop/src/renderer/components/title-bar/MenuButton.tsx, apps/desktop/src/renderer/components/title-bar/WindowControls.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/DeviceSectionHeader.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/sections/ProjectsSection.tsx, apps/desktop/src/renderer/features/right-sidebar/AddTabDropdown.tsx, apps/desktop/src/renderer/features/right-sidebar/EmptyState.tsx, apps/desktop/src/renderer/features/right-sidebar/RightSidebarShell.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBar.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBodyErrorBoundary.tsx, apps/desktop/src/renderer/features/right-sidebar/hooks/useBrowserWebview.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useNativePopupSurface.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useRetainedBrowserTabHosts.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserPartition.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserWebviewPool.ts, apps/desktop/src/renderer/features/right-sidebar/lib/detachedSidebarRouting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/executeSidebarCommand.ts, apps/desktop/src/renderer/features/right-sidebar/lib/lastTurnChangedFiles.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mergeSidebarWindowBack.ts, apps/desktop/src/renderer/features/right-sidebar/lib/nativePopupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBackgroundTasksTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBotWorkbenchTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSubagentsTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTerminalShortcut.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTurnReview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupRouter.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/rsbBrowserBridge.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarCommands.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarHostSession.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/BackgroundTasksBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowAgentStrip.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowProgressTree.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/chatTaskFocusIntent.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/listSessionTasks.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/workflowProgressModel.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/bot-workbench/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/CindyMakeTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.css, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/dropExternalFile.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/fileTreeImagePreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/useSessionScopedTreeWidth.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/index.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailCardBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailConversationView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailPreview.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersAttentionIcon.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/actions.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/closeDecision.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/ResourceUsageBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/resource-usage.css, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/subscription.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/retired-feature/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/ImageDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/MarkdownDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/PlainUnifiedDiff.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/diffRows.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/highlight.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/inlineDiff.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/useDiffHighlights.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/ReviewTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/diffExpansionPreference.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/fileTree.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/gitApplyCommand.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/markdownPreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useLastTurnFilter.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewGitState.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewSource.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/routines/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/ConversationStream.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/DetailView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/RunList.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentToolCard.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentsBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentChangeFence.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentConversation.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentFormat.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserCommentPopover.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/browserCommentEditorDraft.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/lib/parseOmnibox.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useBrowserComment.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useLocalHtmlAutoReload.ts, apps/desktop/src/renderer/features/right-sidebar/registry.ts, apps/desktop/src/renderer/features/right-sidebar/store.ts, apps/desktop/src/renderer/features/right-sidebar/tabAvailability.ts, apps/desktop/src/renderer/features/right-sidebar/types.ts, apps/desktop/src/renderer/layout/LayoutRoot.tsx, apps/desktop/src/renderer/layout/PanelDragController.tsx, apps/desktop/src/renderer/layout/PanelDragPrototype.tsx, apps/desktop/src/renderer/layout/collapsePrefs.ts, apps/desktop/src/renderer/layout/layoutDevTools.ts, apps/desktop/src/renderer/layout/panePlacement.tsx, apps/desktop/src/renderer/layout/paneWidths.tsx, apps/desktop/src/renderer/layout/panelMaximize.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 147 | 46 | 198 |
+ | `desktop.plugins.installed` | desktop | 已装插件 | hash `/plugins`(GhostPluginPage) | AddMarketplaceDialog, GhostPluginActions, GhostPluginDetailView, GhostPluginPage, MarketPluginDetailView, MyPublishesSection, PluginDevicePicker, PluginManagementLayout, PluginProjectMenu, RemotePluginConfiguration, RemotePluginPage, RemotePluginReadOnlyDetail, UpdateAllDialog | apps/desktop/src/renderer/features/plugin/AddMarketplaceDialog.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginActions.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginDetailView.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginPage.tsx, apps/desktop/src/renderer/features/plugin/MarketPluginDetailView.tsx, apps/desktop/src/renderer/features/plugin/MyPublishesSection.tsx, apps/desktop/src/renderer/features/plugin/PluginDevicePicker.tsx, apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx, apps/desktop/src/renderer/features/plugin/PluginScopePicker.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginConfiguration.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginPage.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginReadOnlyDetail.tsx, apps/desktop/src/renderer/features/plugin/UpdateAllDialog.tsx, apps/desktop/src/renderer/features/plugin/plugin-motion.css | 28 | 0 | 48 |
-| `desktop.settings` | desktop | 设置 | hash `/settings`(SettingsView;tab 含 general / personalization / providers / billing / usage / voice-input / im-bot / shortcuts / agent-island / import / remote-control / ghosts / builtin-tools / computer-use / help / about) | SettingsView | apps/desktop/src/renderer/components/settings/AboutSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AboutSection.tsx, apps/desktop/src/renderer/components/settings/AccountDeletionSection.tsx, apps/desktop/src/renderer/components/settings/AddProviderWizard.tsx, apps/desktop/src/renderer/components/settings/AddSpeechModelsDialog.tsx, apps/desktop/src/renderer/components/settings/AgentIslandSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AgentIslandSection.tsx, apps/desktop/src/renderer/components/settings/AgentResourceSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AgentResourceSection.tsx, apps/desktop/src/renderer/components/settings/AppearanceSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AppearanceSection.tsx, apps/desktop/src/renderer/components/settings/AuxiliaryModelSection.tsx, apps/desktop/src/renderer/components/settings/AvatarCropEditor.tsx, apps/desktop/src/renderer/components/settings/BetaChannelCell.tsx, apps/desktop/src/renderer/components/settings/BillingSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/BrowserBackendSubsection.tsx, apps/desktop/src/renderer/components/settings/BrowserRealProfileSubsection.tsx, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.tsx, apps/desktop/src/renderer/components/settings/ChatEmbeddingCell.tsx, apps/desktop/src/renderer/components/settings/ChipMetricsSection.tsx, apps/desktop/src/renderer/components/settings/CindyMakeSection.settings-search.ts, apps/desktop/src/renderer/components/settings/CindyMakeSection.tsx, apps/desktop/src/renderer/components/settings/CollaborationSection.settings-search.ts, apps/desktop/src/renderer/components/settings/CollaborationSection.tsx, apps/desktop/src/renderer/components/settings/CompactionSection.tsx, apps/desktop/src/renderer/components/settings/ComposerSendShortcutSection.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionRow.tsx, apps/desktop/src/renderer/components/settings/ComputerUseSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx, apps/desktop/src/renderer/components/settings/CustomProviderRuntimeFillOverlay.tsx, apps/desktop/src/renderer/components/settings/DefaultOverrideControls.tsx, apps/desktop/src/renderer/components/settings/DialogueDirectorySection.tsx, apps/desktop/src/renderer/components/settings/DingTalkBotSection.tsx, apps/desktop/src/renderer/components/settings/DiscordBotSection.tsx, apps/desktop/src/renderer/components/settings/DownloadMeter.tsx, apps/desktop/src/renderer/components/settings/ExperimentalSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotNotificationSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotSection.tsx, apps/desktop/src/renderer/components/settings/FontFamilyPicker.tsx, apps/desktop/src/renderer/components/settings/GeneralSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/GenericGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/GitSafetySection.settings-search.ts, apps/desktop/src/renderer/components/settings/GitSafetySection.tsx, apps/desktop/src/renderer/components/settings/HarnessVersionMenuRow.tsx, apps/desktop/src/renderer/components/settings/HelpAssistantPanel.tsx, apps/desktop/src/renderer/components/settings/HelpSection.settings-search.ts, apps/desktop/src/renderer/components/settings/HelpSection.tsx, apps/desktop/src/renderer/components/settings/HelpThreadView.tsx, apps/desktop/src/renderer/components/settings/HookConnectionsSection.tsx, apps/desktop/src/renderer/components/settings/HookWorkspacePrefsEditor.tsx, apps/desktop/src/renderer/components/settings/ImBotSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ImBotSection.tsx, apps/desktop/src/renderer/components/settings/ImChannelSettingsCard.tsx, apps/desktop/src/renderer/components/settings/ImDefaultSettingsSection.tsx, apps/desktop/src/renderer/components/settings/ImLifecycleAnnouncementSection.tsx, apps/desktop/src/renderer/components/settings/InputDeviceConnectionStatus.tsx, apps/desktop/src/renderer/components/settings/JoyConGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.tsx, apps/desktop/src/renderer/components/settings/LanguageSection.tsx, apps/desktop/src/renderer/components/settings/LayoutResetControl.tsx, apps/desktop/src/renderer/components/settings/LinkOpenSection.tsx, apps/desktop/src/renderer/components/settings/LlamaCppCandidates.tsx, apps/desktop/src/renderer/components/settings/LlamaCppProviderDetail.tsx, apps/desktop/src/renderer/components/settings/LocalAgentSection.settings-search.ts, apps/desktop/src/renderer/components/settings/LocalAgentSection.tsx, apps/desktop/src/renderer/components/settings/LocalModelDownloadUI.tsx, apps/desktop/src/renderer/components/settings/LocalOllamaInstall.tsx, apps/desktop/src/renderer/components/settings/LocalPackagingTag.tsx, apps/desktop/src/renderer/components/settings/LogoutSection.tsx, apps/desktop/src/renderer/components/settings/LspBetaCell.tsx, apps/desktop/src/renderer/components/settings/McpServerDialog.tsx, apps/desktop/src/renderer/components/settings/McpServersSection.tsx, apps/desktop/src/renderer/components/settings/MemorySection.tsx, apps/desktop/src/renderer/components/settings/MessageNavRailCell.tsx, apps/desktop/src/renderer/components/settings/ModelAdvancedDrawer.tsx, apps/desktop/src/renderer/components/settings/ModelPriceOverrideDialog.tsx, apps/desktop/src/renderer/components/settings/MyDevicesPanel.tsx, apps/desktop/src/renderer/components/settings/NotificationSection.settings-search.ts, apps/desktop/src/renderer/components/settings/NotificationSection.tsx, apps/desktop/src/renderer/components/settings/OAuthDeviceCodeCard.tsx, apps/desktop/src/renderer/components/settings/OllamaProviderDetail.tsx, apps/desktop/src/renderer/components/settings/OwnRemoteProviders.tsx, apps/desktop/src/renderer/components/settings/PersonalizationDetails.settings-search.ts, apps/desktop/src/renderer/components/settings/PersonalizationSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/PiKernelVersionRow.tsx, apps/desktop/src/renderer/components/settings/PiPackagesSection.tsx, apps/desktop/src/renderer/components/settings/PlayStationGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/ProfileEditDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderConnectionDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderImportDialog.tsx, apps/desktop/src/renderer/components/settings/ProvidersSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ProvidersSection.tsx, apps/desktop/src/renderer/components/settings/ReadOnlyProviderModels.tsx, apps/desktop/src/renderer/components/settings/RemoteControlSection.settings-search.ts, apps/desktop/src/renderer/components/settings/RemoteControlSection.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopPermissions.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopSetting.tsx, apps/desktop/src/renderer/components/settings/RemoteHostDetail.tsx, apps/desktop/src/renderer/components/settings/RemoteSection.tsx, apps/desktop/src/renderer/components/settings/SessionImportSection.settings-search.ts, apps/desktop/src/renderer/components/settings/SessionImportSection.tsx, apps/desktop/src/renderer/components/settings/SessionRuntimeFallbackCell.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.settings-search.ts, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.tsx, apps/desktop/src/renderer/components/settings/SettingsSearchBox.tsx, apps/desktop/src/renderer/components/settings/SettingsSearchNavigation.ts, apps/desktop/src/renderer/components/settings/SettingsSidebarNav.tsx, apps/desktop/src/renderer/components/settings/SettingsTextInput.tsx, apps/desktop/src/renderer/components/settings/SettingsView.tsx, apps/desktop/src/renderer/components/settings/SharedTasks.settings-search.ts, apps/desktop/src/renderer/components/settings/SilentEncryptedRetryCell.tsx, apps/desktop/src/renderer/components/settings/SpeechModelChoices.tsx, apps/desktop/src/renderer/components/settings/SshKeySetupDialog.tsx, apps/desktop/src/renderer/components/settings/StorageManagementCard.settings-search.ts, apps/desktop/src/renderer/components/settings/StorageManagementCard.tsx, apps/desktop/src/renderer/components/settings/StreamFadeSection.tsx, apps/desktop/src/renderer/components/settings/SubagentModelSection.settings-search.ts, apps/desktop/src/renderer/components/settings/SubagentModelSection.tsx, apps/desktop/src/renderer/components/settings/SwitchProGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/TelegramBehaviorSettings.tsx, apps/desktop/src/renderer/components/settings/TelegramBotSection.tsx, apps/desktop/src/renderer/components/settings/TelegramRemoteDevices.tsx, apps/desktop/src/renderer/components/settings/TerminalShellSection.tsx, apps/desktop/src/renderer/components/settings/TipsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/TipsSection.tsx, apps/desktop/src/renderer/components/settings/UnifiedModelList.tsx, apps/desktop/src/renderer/components/settings/UserProfileCard.tsx, apps/desktop/src/renderer/components/settings/UserPromptSection.tsx, apps/desktop/src/renderer/components/settings/VisionBridgeSection.settings-search.ts, apps/desktop/src/renderer/components/settings/VisionBridgeSection.tsx, apps/desktop/src/renderer/components/settings/VoiceInputSection.settings-search.ts, apps/desktop/src/renderer/components/settings/VoiceInputSection.tsx, apps/desktop/src/renderer/components/settings/VoiceSpeakerEnrollmentDialog.tsx, apps/desktop/src/renderer/components/settings/VoiceSpeakerFilterCard.tsx, apps/desktop/src/renderer/components/settings/WallpaperSection.tsx, apps/desktop/src/renderer/components/settings/WechatBotSection.tsx, apps/desktop/src/renderer/components/settings/WecomBotSection.tsx, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.settings-search.ts, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeyboardLayout.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeycapGlyphs.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexSettings.tsx, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.settings-search.ts, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.tsx, apps/desktop/src/renderer/components/settings/XUsageGuide.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadSettings.tsx, apps/desktop/src/renderer/components/settings/androidStatusPresentation.ts, apps/desktop/src/renderer/components/settings/avatarCropGeometry.ts, apps/desktop/src/renderer/components/settings/avatarCropImage.ts, apps/desktop/src/renderer/components/settings/billingVisibility.ts, apps/desktop/src/renderer/components/settings/browserOpenForLoginError.ts, apps/desktop/src/renderer/components/settings/cindyMakeVisibility.ts, apps/desktop/src/renderer/components/settings/computerPermissionFlow.ts, apps/desktop/src/renderer/components/settings/contacts/ContactDetailPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsImportDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsListPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsManagerDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsSection.tsx, apps/desktop/src/renderer/components/settings/contacts/startContactsAiSession.ts, apps/desktop/src/renderer/components/settings/dialogueDirectoryDisplay.ts, apps/desktop/src/renderer/components/settings/dualSenseSilhouette.ts, apps/desktop/src/renderer/components/settings/feishuBotPresentation.ts, apps/desktop/src/renderer/components/settings/fontFamilyValue.ts, apps/desktop/src/renderer/components/settings/gamepadLayoutPrimitives.tsx, apps/desktop/src/renderer/components/settings/gamepadSilhouetteGeom.ts, apps/desktop/src/renderer/components/settings/hookWorkspacePrefsLogic.ts, apps/desktop/src/renderer/components/settings/imBotVisibility.ts, apps/desktop/src/renderer/components/settings/imDefaultSettingsLogic.ts, apps/desktop/src/renderer/components/settings/joyConSilhouette.ts, apps/desktop/src/renderer/components/settings/modelManagementPresentation.ts, apps/desktop/src/renderer/components/settings/modelManagementState.ts, apps/desktop/src/renderer/components/settings/myDevicesModel.ts, apps/desktop/src/renderer/components/settings/providerAssetModule.ts, apps/desktop/src/renderer/components/settings/realProfilePermissionGuide.ts, apps/desktop/src/renderer/components/settings/settingsRowClasses.ts, apps/desktop/src/renderer/components/settings/settingsSearchCatalog.ts, apps/desktop/src/renderer/components/settings/settingsSearchTypes.ts, apps/desktop/src/renderer/components/settings/switchProSilhouette.ts, apps/desktop/src/renderer/components/settings/ultimateC1Silhouette.ts, apps/desktop/src/renderer/components/settings/usage/UsageBarsTooltip.tsx, apps/desktop/src/renderer/components/settings/usage/UsageBreakdownTables.tsx, apps/desktop/src/renderer/components/settings/usage/UsageDeviceSelect.tsx, apps/desktop/src/renderer/components/settings/usage/UsageFilterSelect.tsx, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.settings-search.ts, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.tsx, apps/desktop/src/renderer/components/settings/usage/UsageStatRow.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTaskTable.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTokenBars.tsx, apps/desktop/src/renderer/components/settings/usage/formatUsagePercent.ts, apps/desktop/src/renderer/components/settings/usage/usageCharts.css, apps/desktop/src/renderer/components/settings/usage/usageHistoryColors.ts, apps/desktop/src/renderer/components/settings/usage/usageHistoryStats.ts, apps/desktop/src/renderer/components/settings/usageVisibility.ts, apps/desktop/src/renderer/components/settings/useProviderSubscriptionCard.ts, apps/desktop/src/renderer/components/settings/useSettingsEscape.ts, apps/desktop/src/renderer/components/settings/useSettingsSectionTarget.ts, apps/desktop/src/renderer/components/settings/wizardRecommend.ts, apps/desktop/src/renderer/components/settings/workLouderCodexCommandCopy.ts, apps/desktop/src/renderer/components/settings/xboxSeriesSilhouette.ts, apps/desktop/src/renderer/styles/sortable.css | 137 | 95 | 548 |
++| `desktop.settings` | desktop | 设置 | hash `/settings`(SettingsView;tab 含 general / personalization / providers / billing / usage / voice-input / im-bot / shortcuts / agent-island / import / remote-control / ghosts / builtin-tools / computer-use / help / about) | SettingsView | apps/desktop/src/renderer/components/settings/AboutSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AboutSection.tsx, apps/desktop/src/renderer/components/settings/AccountDeletionSection.tsx, apps/desktop/src/renderer/components/settings/AddProviderWizard.tsx, apps/desktop/src/renderer/components/settings/AddSpeechModelsDialog.tsx, apps/desktop/src/renderer/components/settings/AgentIslandSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AgentIslandSection.tsx, apps/desktop/src/renderer/components/settings/AgentResourceSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AgentResourceSection.tsx, apps/desktop/src/renderer/components/settings/AppearanceSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AppearanceSection.tsx, apps/desktop/src/renderer/components/settings/AuxiliaryModelSection.tsx, apps/desktop/src/renderer/components/settings/AvatarCropEditor.tsx, apps/desktop/src/renderer/components/settings/BetaChannelCell.tsx, apps/desktop/src/renderer/components/settings/BillingSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/BrowserBackendSubsection.tsx, apps/desktop/src/renderer/components/settings/BrowserRealProfileSubsection.tsx, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.tsx, apps/desktop/src/renderer/components/settings/ChatEmbeddingCell.tsx, apps/desktop/src/renderer/components/settings/ChipMetricsSection.tsx, apps/desktop/src/renderer/components/settings/CindyMakeSection.settings-search.ts, apps/desktop/src/renderer/components/settings/CindyMakeSection.tsx, apps/desktop/src/renderer/components/settings/CollaborationSection.settings-search.ts, apps/desktop/src/renderer/components/settings/CollaborationSection.tsx, apps/desktop/src/renderer/components/settings/CompactionSection.tsx, apps/desktop/src/renderer/components/settings/ComposerSendShortcutSection.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionRow.tsx, apps/desktop/src/renderer/components/settings/ComputerUseSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx, apps/desktop/src/renderer/components/settings/CustomProviderRuntimeFillOverlay.tsx, apps/desktop/src/renderer/components/settings/DefaultOverrideControls.tsx, apps/desktop/src/renderer/components/settings/DialogueDirectorySection.tsx, apps/desktop/src/renderer/components/settings/DingTalkBotSection.tsx, apps/desktop/src/renderer/components/settings/DiscordBotSection.tsx, apps/desktop/src/renderer/components/settings/DownloadMeter.tsx, apps/desktop/src/renderer/components/settings/ExperimentalSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotNotificationSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotSection.tsx, apps/desktop/src/renderer/components/settings/FontFamilyPicker.tsx, apps/desktop/src/renderer/components/settings/GeneralSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/GenericGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/GitSafetySection.settings-search.ts, apps/desktop/src/renderer/components/settings/GitSafetySection.tsx, apps/desktop/src/renderer/components/settings/HarnessVersionMenuRow.tsx, apps/desktop/src/renderer/components/settings/HelpAssistantPanel.tsx, apps/desktop/src/renderer/components/settings/HelpSection.settings-search.ts, apps/desktop/src/renderer/components/settings/HelpSection.tsx, apps/desktop/src/renderer/components/settings/HelpThreadView.tsx, apps/desktop/src/renderer/components/settings/HookConnectionsSection.tsx, apps/desktop/src/renderer/components/settings/HookWorkspacePrefsEditor.tsx, apps/desktop/src/renderer/components/settings/ImBotSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ImBotSection.tsx, apps/desktop/src/renderer/components/settings/ImChannelSettingsCard.tsx, apps/desktop/src/renderer/components/settings/ImDefaultSettingsSection.tsx, apps/desktop/src/renderer/components/settings/ImLifecycleAnnouncementSection.tsx, apps/desktop/src/renderer/components/settings/InputDeviceConnectionStatus.tsx, apps/desktop/src/renderer/components/settings/JoyConGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.tsx, apps/desktop/src/renderer/components/settings/LanguageSection.tsx, apps/desktop/src/renderer/components/settings/LayoutResetControl.tsx, apps/desktop/src/renderer/components/settings/LinkOpenSection.tsx, apps/desktop/src/renderer/components/settings/LlamaCppCandidates.tsx, apps/desktop/src/renderer/components/settings/LlamaCppProviderDetail.tsx, apps/desktop/src/renderer/components/settings/LocalAgentSection.settings-search.ts, apps/desktop/src/renderer/components/settings/LocalAgentSection.tsx, apps/desktop/src/renderer/components/settings/LocalModelDownloadUI.tsx, apps/desktop/src/renderer/components/settings/LocalOllamaInstall.tsx, apps/desktop/src/renderer/components/settings/LocalPackagingTag.tsx, apps/desktop/src/renderer/components/settings/LogoutSection.tsx, apps/desktop/src/renderer/components/settings/LspBetaCell.tsx, apps/desktop/src/renderer/components/settings/McpServerDialog.tsx, apps/desktop/src/renderer/components/settings/McpServersSection.tsx, apps/desktop/src/renderer/components/settings/MemorySection.tsx, apps/desktop/src/renderer/components/settings/MessageNavRailCell.tsx, apps/desktop/src/renderer/components/settings/ModelAdvancedDrawer.tsx, apps/desktop/src/renderer/components/settings/ModelPriceOverrideDialog.tsx, apps/desktop/src/renderer/components/settings/MyDevicesPanel.tsx, apps/desktop/src/renderer/components/settings/NotificationSection.settings-search.ts, apps/desktop/src/renderer/components/settings/NotificationSection.tsx, apps/desktop/src/renderer/components/settings/OAuthDeviceCodeCard.tsx, apps/desktop/src/renderer/components/settings/OllamaProviderDetail.tsx, apps/desktop/src/renderer/components/settings/OwnRemoteProviders.tsx, apps/desktop/src/renderer/components/settings/PersonalizationDetails.settings-search.ts, apps/desktop/src/renderer/components/settings/PersonalizationSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/PiKernelVersionRow.tsx, apps/desktop/src/renderer/components/settings/PiPackagesSection.tsx, apps/desktop/src/renderer/components/settings/PlayStationGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/ProfileEditDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderConnectionDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderImportDialog.tsx, apps/desktop/src/renderer/components/settings/ProvidersSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ProvidersSection.tsx, apps/desktop/src/renderer/components/settings/ReadOnlyProviderModels.tsx, apps/desktop/src/renderer/components/settings/RemoteControlSection.settings-search.ts, apps/desktop/src/renderer/components/settings/RemoteControlSection.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopPermissions.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopSetting.tsx, apps/desktop/src/renderer/components/settings/RemoteHostDetail.tsx, apps/desktop/src/renderer/components/settings/RemoteSection.tsx, apps/desktop/src/renderer/components/settings/SessionImportSection.settings-search.ts, apps/desktop/src/renderer/components/settings/SessionImportSection.tsx, apps/desktop/src/renderer/components/settings/SessionRuntimeFallbackCell.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.settings-search.ts, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.tsx, apps/desktop/src/renderer/components/settings/SettingsSearchBox.tsx, apps/desktop/src/renderer/components/settings/SettingsSearchNavigation.ts, apps/desktop/src/renderer/components/settings/SettingsSidebarNav.tsx, apps/desktop/src/renderer/components/settings/SettingsTextInput.tsx, apps/desktop/src/renderer/components/settings/SettingsView.tsx, apps/desktop/src/renderer/components/settings/SharedTasks.settings-search.ts, apps/desktop/src/renderer/components/settings/SilentEncryptedRetryCell.tsx, apps/desktop/src/renderer/components/settings/SpeechModelChoices.tsx, apps/desktop/src/renderer/components/settings/SshKeySetupDialog.tsx, apps/desktop/src/renderer/components/settings/StorageManagementCard.settings-search.ts, apps/desktop/src/renderer/components/settings/StorageManagementCard.tsx, apps/desktop/src/renderer/components/settings/StreamFadeSection.tsx, apps/desktop/src/renderer/components/settings/SubagentModelSection.settings-search.ts, apps/desktop/src/renderer/components/settings/SubagentModelSection.tsx, apps/desktop/src/renderer/components/settings/SwitchProGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/TelegramBehaviorSettings.tsx, apps/desktop/src/renderer/components/settings/TelegramBotSection.tsx, apps/desktop/src/renderer/components/settings/TelegramRemoteDevices.tsx, apps/desktop/src/renderer/components/settings/TerminalShellSection.tsx, apps/desktop/src/renderer/components/settings/TipsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/TipsSection.tsx, apps/desktop/src/renderer/components/settings/UnifiedModelList.tsx, apps/desktop/src/renderer/components/settings/UserProfileCard.tsx, apps/desktop/src/renderer/components/settings/UserPromptSection.tsx, apps/desktop/src/renderer/components/settings/VisionBridgeSection.settings-search.ts, apps/desktop/src/renderer/components/settings/VisionBridgeSection.tsx, apps/desktop/src/renderer/components/settings/VoiceInputSection.settings-search.ts, apps/desktop/src/renderer/components/settings/VoiceInputSection.tsx, apps/desktop/src/renderer/components/settings/VoiceSpeakerEnrollmentDialog.tsx, apps/desktop/src/renderer/components/settings/VoiceSpeakerFilterCard.tsx, apps/desktop/src/renderer/components/settings/WallpaperSection.tsx, apps/desktop/src/renderer/components/settings/WechatBotSection.tsx, apps/desktop/src/renderer/components/settings/WecomBotSection.tsx, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.settings-search.ts, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeyboardLayout.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeycapGlyphs.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexSettings.tsx, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.settings-search.ts, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.tsx, apps/desktop/src/renderer/components/settings/XUsageGuide.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadSettings.tsx, apps/desktop/src/renderer/components/settings/androidStatusPresentation.ts, apps/desktop/src/renderer/components/settings/avatarCropGeometry.ts, apps/desktop/src/renderer/components/settings/avatarCropImage.ts, apps/desktop/src/renderer/components/settings/billingVisibility.ts, apps/desktop/src/renderer/components/settings/browserOpenForLoginError.ts, apps/desktop/src/renderer/components/settings/cindyMakeVisibility.ts, apps/desktop/src/renderer/components/settings/computerPermissionFlow.ts, apps/desktop/src/renderer/components/settings/contacts/ContactDetailPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsImportDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsListPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsManagerDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsSection.tsx, apps/desktop/src/renderer/components/settings/contacts/startContactsAiSession.ts, apps/desktop/src/renderer/components/settings/dialogueDirectoryDisplay.ts, apps/desktop/src/renderer/components/settings/dualSenseSilhouette.ts, apps/desktop/src/renderer/components/settings/feishuBotPresentation.ts, apps/desktop/src/renderer/components/settings/fontFamilyValue.ts, apps/desktop/src/renderer/components/settings/gamepadLayoutPrimitives.tsx, apps/desktop/src/renderer/components/settings/gamepadSilhouetteGeom.ts, apps/desktop/src/renderer/components/settings/hookWorkspacePrefsLogic.ts, apps/desktop/src/renderer/components/settings/imBotVisibility.ts, apps/desktop/src/renderer/components/settings/imDefaultSettingsLogic.ts, apps/desktop/src/renderer/components/settings/joyConSilhouette.ts, apps/desktop/src/renderer/components/settings/modelManagementPresentation.ts, apps/desktop/src/renderer/components/settings/modelManagementState.ts, apps/desktop/src/renderer/components/settings/myDevicesModel.ts, apps/desktop/src/renderer/components/settings/providerAssetModule.ts, apps/desktop/src/renderer/components/settings/realProfilePermissionGuide.ts, apps/desktop/src/renderer/components/settings/settingsRowClasses.ts, apps/desktop/src/renderer/components/settings/settingsSearchCatalog.ts, apps/desktop/src/renderer/components/settings/settingsSearchTypes.ts, apps/desktop/src/renderer/components/settings/switchProSilhouette.ts, apps/desktop/src/renderer/components/settings/ultimateC1Silhouette.ts, apps/desktop/src/renderer/components/settings/usage/UsageBarsTooltip.tsx, apps/desktop/src/renderer/components/settings/usage/UsageBreakdownTables.tsx, apps/desktop/src/renderer/components/settings/usage/UsageDeviceSelect.tsx, apps/desktop/src/renderer/components/settings/usage/UsageFilterSelect.tsx, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.settings-search.ts, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.tsx, apps/desktop/src/renderer/components/settings/usage/UsageStatRow.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTaskTable.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTokenBars.tsx, apps/desktop/src/renderer/components/settings/usage/formatUsagePercent.ts, apps/desktop/src/renderer/components/settings/usage/usageCharts.css, apps/desktop/src/renderer/components/settings/usage/usageHistoryColors.ts, apps/desktop/src/renderer/components/settings/usage/usageHistoryStats.ts, apps/desktop/src/renderer/components/settings/usageVisibility.ts, apps/desktop/src/renderer/components/settings/useProviderSubscriptionCard.ts, apps/desktop/src/renderer/components/settings/useSettingsEscape.ts, apps/desktop/src/renderer/components/settings/useSettingsSectionTarget.ts, apps/desktop/src/renderer/components/settings/wizardRecommend.ts, apps/desktop/src/renderer/components/settings/workLouderCodexCommandCopy.ts, apps/desktop/src/renderer/components/settings/xboxSeriesSilhouette.ts, apps/desktop/src/renderer/styles/sortable.css | 137 | 95 | 551 |
+ | `desktop.shell.main-layout` | desktop | 主窗口壳(标题栏 / 左右栏 / 内容区) | main BrowserWindow → renderer/index.tsx → main-entry.tsx → App → MainLayout (`#/` 受保护壳) | ChromeActions, DeviceSectionHeader, FeishuConflictDialogHost, GhostMediaLightboxHost, MainLayout, ProjectsSection, RightSidebar, RightSidebarShell, SessionShareImportWizard, Sidebar, UpdateNoticeDialog, WindowControls | apps/desktop/src/renderer/cindy-brain/GhostMediaLightboxHost.tsx, apps/desktop/src/renderer/components/UpdateNoticeDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialogHost.tsx, apps/desktop/src/renderer/components/layout/AppBadgeAttentionSync.tsx, apps/desktop/src/renderer/components/layout/BrowserWebviewPool.tsx, apps/desktop/src/renderer/components/layout/ChromeActions.tsx, apps/desktop/src/renderer/components/layout/ContentHeader.tsx, apps/desktop/src/renderer/components/layout/CredentialStoreBanner.tsx, apps/desktop/src/renderer/components/layout/FadeSwitcher.tsx, apps/desktop/src/renderer/components/layout/GlobalDropImportListener.tsx, apps/desktop/src/renderer/components/layout/MainEntryRedirect.tsx, apps/desktop/src/renderer/components/layout/MainLayout.tsx, apps/desktop/src/renderer/components/layout/RightSidebar.tsx, apps/desktop/src/renderer/components/layout/RightSidebarDetach.tsx, apps/desktop/src/renderer/components/layout/RightSidebarMaximize.tsx, apps/desktop/src/renderer/components/layout/RightSidebarToggle.tsx, apps/desktop/src/renderer/components/layout/SidebarTabWindowLayout.tsx, apps/desktop/src/renderer/components/layout/SidebarWindowLayout.tsx, apps/desktop/src/renderer/components/layout/WallpaperVideo.tsx, apps/desktop/src/renderer/components/layout/chromeActionsGeometry.ts, apps/desktop/src/renderer/components/layout/chromeActionsLayout.ts, apps/desktop/src/renderer/components/layout/railChromeActions.ts, apps/desktop/src/renderer/components/layout/windowDrag.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/sidebar/AccountSwitcherDialog.tsx, apps/desktop/src/renderer/components/sidebar/AttentionDot.tsx, apps/desktop/src/renderer/components/sidebar/DatabaseSizeWarningBanner.tsx, apps/desktop/src/renderer/components/sidebar/GhostMainViewNavEntries.tsx, apps/desktop/src/renderer/components/sidebar/MobileDownloadDialog.tsx, apps/desktop/src/renderer/components/sidebar/NavigationCountBadge.tsx, apps/desktop/src/renderer/components/sidebar/NewTag.tsx, apps/desktop/src/renderer/components/sidebar/Sidebar.tsx, apps/desktop/src/renderer/components/sidebar/SidebarIconButton.tsx, apps/desktop/src/renderer/components/sidebar/SidebarNavigationCustomize.tsx, apps/desktop/src/renderer/components/sidebar/SidebarTopNav.tsx, apps/desktop/src/renderer/components/sidebar/SortableList.tsx, apps/desktop/src/renderer/components/sidebar/UpdateBanner.tsx, apps/desktop/src/renderer/components/sidebar/UserInfoSection.tsx, apps/desktop/src/renderer/components/sidebar/VendorIcon.tsx, apps/desktop/src/renderer/components/sidebar/VendorReadinessBadge.tsx, apps/desktop/src/renderer/components/sidebar/WorktreeBadge.tsx, apps/desktop/src/renderer/components/sidebar/sidebarNavigationPrefs.ts, apps/desktop/src/renderer/components/sidebar/useHoverOpenMenu.ts, apps/desktop/src/renderer/components/title-bar/ChromeIconButton.tsx, apps/desktop/src/renderer/components/title-bar/MenuButton.tsx, apps/desktop/src/renderer/components/title-bar/WindowControls.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/DeviceSectionHeader.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/sections/ProjectsSection.tsx, apps/desktop/src/renderer/features/right-sidebar/AddTabDropdown.tsx, apps/desktop/src/renderer/features/right-sidebar/EmptyState.tsx, apps/desktop/src/renderer/features/right-sidebar/RightSidebarShell.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBar.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBodyErrorBoundary.tsx, apps/desktop/src/renderer/features/right-sidebar/TabDragController.tsx, apps/desktop/src/renderer/features/right-sidebar/TabGroupPanel.tsx, apps/desktop/src/renderer/features/right-sidebar/botMenuOwnerContext.ts, apps/desktop/src/renderer/features/right-sidebar/globalTabs.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useBrowserWebview.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useNativePopupSurface.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useRetainedBrowserTabHosts.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserPartition.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserWebviewPool.ts, apps/desktop/src/renderer/features/right-sidebar/lib/detachedSidebarRouting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/executeSidebarCommand.ts, apps/desktop/src/renderer/features/right-sidebar/lib/lastTurnChangedFiles.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.test.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mergeSidebarWindowBack.ts, apps/desktop/src/renderer/features/right-sidebar/lib/nativePopupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBackgroundTasksTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openPluginTaskTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSideChatTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSubagentsTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTerminalShortcut.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTurnReview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupRouter.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/rsbBrowserBridge.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarCommands.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarHostSession.tsx, apps/desktop/src/renderer/features/right-sidebar/lib/tabHosting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/useTabCreationMenu.ts, apps/desktop/src/renderer/features/right-sidebar/moveTab.ts, apps/desktop/src/renderer/features/right-sidebar/pluginPlacement.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/BackgroundTasksBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowAgentStrip.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowProgressTree.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/chatTaskFocusIntent.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/listSessionTasks.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/workflowProgressModel.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/CindyMakeTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.css, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/dropExternalFile.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/fileTreeImagePreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/useSessionScopedTreeWidth.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/index.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailCardBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailConversationView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailPreview.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersAttentionIcon.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/actions.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/closeDecision.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-task/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-view/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/ResourceUsageBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/resource-usage.css, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/subscription.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/retired-feature/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/ImageDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/MarkdownDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/PlainUnifiedDiff.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/diffRows.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/highlight.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/inlineDiff.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/useDiffHighlights.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/ReviewTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/diffExpansionPreference.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/fileTree.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/gitApplyCommand.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/markdownPreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useLastTurnFilter.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewGitState.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewSource.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/routines/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/state.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/ConversationStream.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/DetailView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/RunList.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentToolCard.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentsBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentChangeFence.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentConversation.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentFormat.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserCommentPopover.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/browserCommentEditorDraft.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/lib/parseOmnibox.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useBrowserComment.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useLocalHtmlAutoReload.ts, apps/desktop/src/renderer/features/right-sidebar/registry.ts, apps/desktop/src/renderer/features/right-sidebar/store.ts, apps/desktop/src/renderer/features/right-sidebar/tabAvailability.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroupHost.tsx, apps/desktop/src/renderer/features/right-sidebar/tabGroupPanes.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroups.ts, apps/desktop/src/renderer/features/right-sidebar/types.ts, apps/desktop/src/renderer/layout/LayoutRoot.tsx, apps/desktop/src/renderer/layout/PanelDragController.tsx, apps/desktop/src/renderer/layout/PanelDragPrototype.tsx, apps/desktop/src/renderer/layout/collapsePrefs.ts, apps/desktop/src/renderer/layout/layoutDevTools.ts, apps/desktop/src/renderer/layout/panePlacement.tsx, apps/desktop/src/renderer/layout/paneWidths.tsx, apps/desktop/src/renderer/layout/panelMaximize.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 147 | 46 | 201 |
| `desktop.skillhub.local` | desktop | SkillHub 本地技能 | hash `/skillhub/local` 及统一详情 `/skillhub/detail`(旧详情链接重定向) | InstallTargetPicker, PluginDevicePicker, PluginManagementLayout, RemoteSkillsPage, SkillCategoryFilterBar, SkillDetailLayout, SkillhubDetailRoute, SkillhubDetailView, SkillhubFeatureLayout, SkillhubHomeView, SkillhubLocalLayout, SkillhubMarketDetailView | apps/desktop/src/renderer/features/plugin/PluginDevicePicker.tsx, apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx, apps/desktop/src/renderer/features/skillhub/RemoteSkillsPage.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubDetailRoute.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubDetailView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubFeatureLayout.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubHomeView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubLocalLayout.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubMarketDetailView.tsx, apps/desktop/src/renderer/features/skillhub/components/InstallTargetPicker.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillCategoryFilterBar.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillDetailLayout.tsx, apps/desktop/src/renderer/features/skillhub/skillhub-home.css | 39 | 0 | 45 |
| `desktop.skillhub.market` | desktop | SkillHub 市场 | hash `/skillhub/market`(SkillhubMarketListView) | InstallTargetPicker, MarketCard, MarketInfoEditDialog, SkillhubMarketDetailView, SkillhubMarketListView, VisibilityEditorDialog | apps/desktop/src/renderer/features/skillhub/SkillhubMarketDetailView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubMarketListView.tsx, apps/desktop/src/renderer/features/skillhub/components/HomeMarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/InstallTargetPicker.tsx, apps/desktop/src/renderer/features/skillhub/components/LocalSkillControls.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketInfoEditDialog.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketInstallStatus.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketListError.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketLocalSkills.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketPreviewTree.tsx, apps/desktop/src/renderer/features/skillhub/components/OfficialSkillBadge.tsx, apps/desktop/src/renderer/features/skillhub/components/PlatformTagSelector.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillCategoryFilterBar.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillDetailLayout.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillIcon.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillTagList.tsx, apps/desktop/src/renderer/features/skillhub/components/TeamScopePicker.tsx, apps/desktop/src/renderer/features/skillhub/components/VisibilityEditorDialog.tsx | 42 | 0 | 35 |
| `desktop.window.computer-permission-guide` | desktop | 电脑使用权限引导 | `?view=computer-permission-guide` → ComputerPermissionGuideWindow;backdrop 同文件 | ComputerPermissionBackdrop, ComputerPermissionGuideWindow | apps/desktop/src/main/computer-permission-guide/MacComputerPermissionGuideNativeHost.ts, apps/desktop/src/main/computer-permission-guide/placement.ts, apps/desktop/src/main/computer-permission-guide/request.ts, apps/desktop/src/main/computer-permission-guide/switch-target.ts, apps/desktop/src/main/computer-permission-guide/window.ts, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx | 7 | 2 | 9 |
diff --cc packages/model-providers/src/index.ts
index f825129969,568118dfca..1efe0ed948
--- a/packages/model-providers/src/index.ts
+++ b/packages/model-providers/src/index.ts
@@@ -1,5 -1,5 +1,6 @@@
export { parseModelDisplayPricing, type ModelDisplayPricing } from './modelDisplayPricing.js';
+export { providerProtocolCandidates, type ProviderProtocolCandidate } from './providerProtocolProbe.js';
+ export { remoteInvocationModels } from './remoteModels.js';
/**
* @cindy/model-providers — 模型供应商目录 + 路由抽象(纯逻辑,零 Electron / maker-core 运行时依赖)。
*
diff --cc scripts/__tests__/provider-e2e-profile.test.mjs
index 0000000000,0000000000..c480a929fe
new file mode 100644
--- /dev/null
+++ b/scripts/__tests__/provider-e2e-profile.test.mjs
@@@ -1,0 -1,0 +1,36 @@@
++import test from 'node:test';
++import path from 'node:path';
++import assert from 'node:assert/strict';
++import { assertProviderE2EProfile } from '../../apps/desktop/scripts/provider-e2e-profile.mjs';
++const profile = path.resolve('isolated', 'CindyGlobal-dev2-provider-auto-detection-fixture');
++const db = path.join(profile, 'cindy-local-v1.db');
++function fixture() {
++ const record = { pid: 123, isolated: true, profileKind: 'isolated-sandbox', state: 'ready', userDataDir: profile,
++ processIdentity: { startedAtMs: Date.parse('2026-10-23T12:00:00Z'), executablePath: '/Electron' } };
++ let detached = 0;
++ const session = { send: async () => ({ processInfo: [{ type: 'browser', id: 123 }] }), detach: async () => { detached++; } };
++ const browser = { newBrowserCDPSession: async () => session };
++ const options = { platform: 'darwin', realpath: async p => p,
++ readFile: async p => { assert.equal(p, path.join(profile, '.dev-instances', '123.json')); return JSON.stringify(record); },
++ run: async () => ({ stdout: 'Fri Oct 23 12:00:00 2026 /Electron\n' }) };
++ return { record, session, browser, options, detached: () => detached };
++}
++test('accepts the actual CDP main process registered in the isolated database profile', async () => {
++ const f = fixture(); await assertProviderE2EProfile(f.browser, db, f.options); assert.equal(f.detached(), 1);
++});
++for (const scenario of ['daily-client', 'other-profile', 'not-isolated', 'stale-pid', 'missing-identity', 'symlink', 'unavailable-cdp', 'unsupported-platform']) {
++ test(`refuses ${scenario} before any UI/write callback`, async () => {
++ const f = fixture(); let writes = 0;
++ if (scenario === 'daily-client') f.options.readFile = async () => { throw new Error('No registration for this CDP process in isolated profile'); };
++ if (scenario === 'other-profile') f.record.userDataDir = '/daily';
++ if (scenario === 'not-isolated') f.record.isolated = false;
++ if (scenario === 'stale-pid') f.record.processIdentity.startedAtMs--;
++ if (scenario === 'missing-identity') delete f.record.processIdentity;
++ if (scenario === 'symlink') f.options.realpath = async () => '/daily/cindy-local-v1.db';
++ if (scenario === 'unavailable-cdp') f.session.send = async () => { throw new Error('unsupported'); };
++ if (scenario === 'unsupported-platform') f.options.platform = 'win32';
++ await assert.rejects(async () => { await assertProviderE2EProfile(f.browser, db, f.options); writes++; });
++ assert.equal(writes, 0);
++ assert.equal(f.detached(), scenario === 'symlink' ? 0 : 1);
++ });
++}