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(bots): 模型失效时允许就地换模并继续创建伙伴 (#5773)

Chris Zhangfa3fc88d37d2
diff --git a/apps/desktop/src/main/localDb/ipc/__tests__/botCanonicalSession.test.ts b/apps/desktop/src/main/localDb/ipc/__tests__/botCanonicalSession.test.ts
index 8f4cb3419c..43ca577c38 100644
--- a/apps/desktop/src/main/localDb/ipc/__tests__/botCanonicalSession.test.ts
+++ b/apps/desktop/src/main/localDb/ipc/__tests__/botCanonicalSession.test.ts
@@ -704,6 +704,73 @@ describe('Bot canonical Session lifecycle', () => {
expect(capabilities.mcpServers).toEqual([]);
});
+ it.each(['available', 'implicit', 'disconnected', 'deleted'])('checks the Desktop invitation selection at submission: %s', async state => {
+ const control = await import('../../../maker-ipc/appDefaultModelControl.js');
+ const real = await vi.importActual<typeof control>('../../../maker-ipc/appDefaultModelControl.js');
+ vi.mocked(control.validateTaskModel).mockImplementation(real.validateTaskModel);
+ try {
+ const route: BotModelRoute = { harness: 'pi', providerId: state === 'implicit' ? null : 'xd', model: 'z-ai/glm-5.3-flash', effort: 'high', fastMode: false };
+ if (state === 'disconnected') h.providers[0]!.connected = false;
+ if (state === 'deleted') h.providers = [];
+ const before = h.sqlite!.prepare('SELECT id FROM bot_profiles').all();
+ const creating = invoke('local-db:bots:create', { id: 'desktop-selected', name: 'Selected', prepareInvitation: true,
+ capabilities: { modelChainOverride: [route] } });
+ if ((state === 'available' || state === 'implicit')) await expect(creating).resolves.toMatchObject({ id: 'desktop-selected' });
+ else {
+ await expect(creating).rejects.toThrow('Model route unavailable');
+ expect(h.sqlite!.prepare('SELECT id FROM bot_profiles').all()).toEqual(before);
+ }
+ } finally { vi.mocked(control.validateTaskModel).mockResolvedValue(true); }
+ });
+
+ it.each(['available', 'implicit', 'disconnected', 'deleted'])('validates the primary route before Desktop settings persist: %s', async state => {
+ await invoke('local-db:bots:create', { id: 'desktop-settings', name: 'Settings' });
+ const before = h.sqlite!.prepare("SELECT * FROM bot_profile_versions WHERE bot_id = 'desktop-settings'").all();
+ const control = await import('../../../maker-ipc/appDefaultModelControl.js');
+ const real = await vi.importActual<typeof control>('../../../maker-ipc/appDefaultModelControl.js');
+ vi.mocked(control.validateTaskModel).mockImplementation(real.validateTaskModel);
+ try {
+ const route: BotModelRoute = { harness: 'pi', providerId: state === 'implicit' ? null : 'xd', model: 'z-ai/glm-5.3-flash', effort: 'high', fastMode: false };
+ if (state === 'disconnected') h.providers[0]!.connected = false;
+ if (state === 'deleted') h.providers = [];
+ // A stale backup must not prevent saving a usable primary.
+ const modelChainOverride = [route, { ...route, model: 'stale-backup' }];
+ const saving = invoke('local-db:bots:update', { id: 'desktop-settings', capabilities: { modelChainOverride } });
+ if (state === 'available' || state === 'implicit') {
+ await expect(saving).resolves.toMatchObject({ capabilities: { modelChainOverride } });
+ } else {
+ await expect(saving).rejects.toThrow('Model route unavailable');
+ expect(h.sqlite!.prepare("SELECT * FROM bot_profile_versions WHERE bot_id = 'desktop-settings'").all()).toEqual(before);
+ // Unrelated profile edits remain possible with an unavailable stored route.
+ await expect(invoke('local-db:bots:update', { id: 'desktop-settings', name: 'Renamed' }))
+ .resolves.toMatchObject({ name: 'Renamed' });
+ }
+ } finally { vi.mocked(control.validateTaskModel).mockResolvedValue(true); }
+ });
+
+ it.each(['rename', 'skills'])('allows legacy chain-only profile maintenance with an unavailable provider: %s', async edit => {
+ const id = 'legacy-chain-only';
+ await invoke('local-db:bots:create', { id, name: 'Legacy' });
+ const route: BotModelRoute = { harness: 'pi', providerId: 'deleted-provider', model: 'legacy-model', effort: 'high', fastMode: false };
+ h.sqlite!.prepare('UPDATE bot_profile_versions SET capabilities_json = ? WHERE bot_id = ?')
+ .run(JSON.stringify({ modelChain: [route] }), id);
+ const control = await import('../../../maker-ipc/appDefaultModelControl.js');
+ vi.mocked(control.validateTaskModel).mockClear().mockResolvedValue(false);
+ try {
+ const patch = edit === 'rename' ? { name: 'Renamed legacy' } : { skills: ['legacy-skill'] };
+ const saved = await invoke('local-db:bots:update', { id, ...patch });
+ expect(saved.capabilities.modelChain).toEqual([route]);
+ if (edit === 'rename') expect(saved.name).toBe('Renamed legacy');
+ else expect(saved.skills).toEqual(['legacy-skill']);
+ expect(control.validateTaskModel).not.toHaveBeenCalled();
+ // Actual model changes must still pass live validation.
+ await expect(invoke('local-db:bots:update', { id, capabilities: {
+ modelChainOverride: [{ ...route, model: 'another-unavailable-model' }],
+ } })).rejects.toThrow('Model route unavailable');
+ expect(control.validateTaskModel).toHaveBeenCalled();
+ } finally { vi.mocked(control.validateTaskModel).mockResolvedValue(true); }
+ });
+
it('preserves explicit creation selections under the new capability contract', async () => {
const created = await invoke('local-db:bots:create', {
id: 'selected-bot', name: 'Selected Bot',
@@ -1082,6 +1149,43 @@ describe('Bot canonical Session lifecycle', () => {
expect((await invoke('local-db:bots:get', created.id)).avatar).toBe(created.avatar);
});
+ it.each(['available', 'implicit', 'disconnected', 'deleted'])('advertises a live mobile creation default: %s', async state => {
+ const { botRemoteManagement } = await import('../botRemoteManagement');
+ const route: BotModelRoute = { harness: 'pi', providerId: state === 'implicit' ? null : 'xd', model: 'z-ai/glm-5.3-flash', effort: 'high', fastMode: false };
+ const readDefault = vi.spyOn(modelSettings, 'readEffectiveBotModelChain').mockResolvedValue([route]);
+ try {
+ if (state === 'disconnected') h.providers[0]!.connected = false;
+ if (state === 'deleted') h.providers = [];
+ const resource = await botRemoteManagement.getEditor({ controllerDeviceId: 'mobile-default-test' }, 'create', 'en');
+ const data = resource.blocks?.find(block => block.id === 'create')?.data as { creationModelChain: string };
+ expect(data.creationModelChain)
+ .toBe(JSON.stringify((state === 'available' || state === 'implicit') ? [{ ...route, providerId: 'xd' }] : []));
+ expect(await modelSettings.readEffectiveBotModelChain({})).toEqual([route]);
+ } finally { readDefault.mockRestore(); }
+ });
+
+ it.each(['disconnected', 'deleted', 'empty'])('rechecks a mobile default that becomes %s after the form loads', async state => {
+ const { botRemoteManagement } = await import('../botRemoteManagement');
+ const context = { controllerDeviceId: 'mobile-stale-default' };
+ const route: BotModelRoute = { harness: 'pi', providerId: 'xd', model: 'z-ai/glm-5.3-flash', effort: 'high', fastMode: false };
+ const readDefault = vi.spyOn(modelSettings, 'readEffectiveBotModelChain').mockResolvedValue([route]);
+ try {
+ const resource = await botRemoteManagement.getEditor(context, 'create', 'en');
+ const before = h.sqlite!.prepare('SELECT id FROM bot_profiles').all();
+ if (state === 'disconnected') h.providers[0]!.connected = false;
+ if (state === 'deleted') h.providers = [];
+ if (state === 'empty') readDefault.mockResolvedValue([]);
+ const sharp = (await import('sharp')).default;
+ const bytes = await sharp(resolve(__dirname, '../../../../renderer/assets/bot-presets/cindy.png')).resize(256, 256).jpeg({ quality: 80 }).toBuffer();
+ await expect(botRemoteManagement.invoke(context, {
+ collectionId: 'teammates', resourceRef: resource.ref, actionId: resource.actions![0].id,
+ client: { protocolVersion: 1, primitives: ['form'], locale: 'en' },
+ input: { name: 'Stale default', avatarImageBase64: bytes.toString('base64'), requestId: 'stale-default-intent-001' },
+ })).rejects.toThrow('Model route unavailable');
+ expect(h.sqlite!.prepare('SELECT id FROM bot_profiles').all()).toEqual(before);
+ } finally { readDefault.mockRestore(); }
+ });
+
it('reconciles mobile creation after a lost receipt without bypassing invitation preparation', async () => {
const { botRemoteManagement } = await import('../botRemoteManagement');
const sharp = (await import('sharp')).default;
@@ -1104,7 +1208,10 @@ describe('Bot canonical Session lifecycle', () => {
expect(preparing.blocks).toContainEqual(expect.objectContaining({ id: 'invitation', data: { stage: 'skills' } }));
expect(preparing.links).toEqual([]);
expect(readFileSync(resolveSafe(profile.avatar).absPath)).toEqual(bytes);
- expect(await submit()).toEqual(first);
+ // Receipt recovery must still return the existing teammate after its provider disconnects.
+ h.providers[0]!.connected = false;
+ try { expect(await submit()).toEqual(first); }
+ finally { h.providers[0]!.connected = true; }
// The host invitation worker owns progress; a reconnect cannot advance it.
expect((await invoke('local-db:bots:get', botId)).invitation.stage).toBe('skills');
h.sqlite!.prepare("UPDATE bot_profile_versions SET capabilities_json = json_set(capabilities_json, '$.invitation.stage', 'failed') WHERE bot_id = ?").run(botId);
diff --git a/apps/desktop/src/main/localDb/ipc/__tests__/botRemoteEditors.test.ts b/apps/desktop/src/main/localDb/ipc/__tests__/botRemoteEditors.test.ts
index 5ce8f173a8..e512ce58bb 100644
--- a/apps/desktop/src/main/localDb/ipc/__tests__/botRemoteEditors.test.ts
+++ b/apps/desktop/src/main/localDb/ipc/__tests__/botRemoteEditors.test.ts
@@ -37,6 +37,7 @@ function fixture() {
const deps: BotRemoteEditorDeps = {
owner: () => owner, assertOwner: captured => { if (captured !== owner) throw Error('OWNER_CHANGED'); },
read: vi.fn(async () => settings), update: vi.fn(async () => { source.currentVersion++; }),
+ modelDefaults: vi.fn(async () => []),
create: vi.fn(async () => {}), avatar: vi.fn(async () => {}),
skills: vi.fn(async () => [skill]), skill: vi.fn(async () => skill), saveSkill: vi.fn(async (_bot, value) => { skill = value; }),
removeSkill: vi.fn(async () => {}), capabilities: vi.fn(async () => catalog), memory,
@@ -52,6 +53,17 @@ function fixture() {
return { resource, get, context, send, entries, deps, settings, catalog, memories, teammateWrites, changeSkill: () => { skill = { ...skill, body: '在电脑上修改后的正文。' }; }, owner: (next: string) => { owner = next; } };
}
describe('portable teammate editors', () => {
+ it('accepts one explicit creation model without changing the default or losing intent identity', async () => {
+ const f = fixture();
+ const route = { harness: 'pi', model: 'available', providerId: 'provider', effort: '', fastMode: false };
+ const input = { name: 'Nova', avatarImageBase64: 'aGVsbG8=', requestId: 'model-intent-12345678', modelChain: JSON.stringify([route]) };
+ await f.send(await f.resource('create'), input);
+ expect(f.deps.create).toHaveBeenCalledWith(expect.objectContaining({ capabilities: { modelChainOverride: [route] } }));
+ expect(f.deps.update).not.toHaveBeenCalled();
+ await expect(f.send(await f.resource('create'), { ...input, modelChain: '[]' })).rejects.toThrow();
+ await expect(f.send(await f.resource('create'), { ...input, modelChain: JSON.stringify([route, route]) })).rejects.toThrow();
+ });
+
it('keeps the same durable create identity across a lost ACK, but separates paired controllers and owners', async () => {
const f = fixture(); const input = { name: '小助手', avatarImageBase64: 'aGVsbG8=', requestId: 'same-intent-12345678' };
await f.send(await f.resource('create'), input); await f.send(await f.resource('create'), input);
diff --git a/apps/desktop/src/main/localDb/ipc/__tests__/botRemoteSettingsResource.test.ts b/apps/desktop/src/main/localDb/ipc/__tests__/botRemoteSettingsResource.test.ts
index eeaeaabca3..bf61dd75a3 100644
--- a/apps/desktop/src/main/localDb/ipc/__tests__/botRemoteSettingsResource.test.ts
+++ b/apps/desktop/src/main/localDb/ipc/__tests__/botRemoteSettingsResource.test.ts
@@ -204,3 +204,14 @@ it('rejects task model submissions that discard the harness identity', async ()
taskModel: JSON.stringify([{ model: 'gpt-6-astra', providerId: 'openai', effort: 'high', fastMode: false }]) }))).rejects.toThrow();
expect(f.deps.update).not.toHaveBeenCalled();
});
+
+it('keeps pending profile fields read-only while models remain available, including after welcome failure', async () => {
+ const f = fixture();
+ Object.assign(f.source, { invitation: { stage: 'failed' } });
+ const resource = await f.get();
+ expect(resource.actions?.find(action => action.id === actionId(resource, 'profile'))?.disabled).toBe(true);
+ expect(resource.actions?.find(action => action.id === actionId(resource, 'models'))?.disabled).not.toBe(true);
+ Object.assign(f.source, { invitation: { stage: 'avatar' } });
+ const portraitRetry = await f.get();
+ expect(portraitRetry.actions?.find(action => action.id === actionId(portraitRetry, 'profile'))?.disabled).not.toBe(true);
+});
diff --git a/apps/desktop/src/main/localDb/ipc/botRemoteEditors.ts b/apps/desktop/src/main/localDb/ipc/botRemoteEditors.ts
index 6d0d65f185..58542fc5ee 100644
--- a/apps/desktop/src/main/localDb/ipc/botRemoteEditors.ts
+++ b/apps/desktop/src/main/localDb/ipc/botRemoteEditors.ts
@@ -1,3 +1,4 @@
+import { normalizeBotModelChain, type BotModelRoute } from '../../../shared/botModelChain.js';
import { createHash } from 'node:crypto';
import { resolveRemoteText, type RemoteActionDescriptor, type RemoteActionInvokeResponse, type RemoteLocalizedText, type RemoteResource } from '@cindy/device-link';
import type { BotRemoteSettingsDeps, createBotRemoteSettingsResource } from './botRemoteSettingsResource.js';
@@ -9,7 +10,8 @@ import { createBotRemoteMemoryEditor, memoryCopy, type BotRemoteMemoryService }
type Kind = 'skill' | 'mcp' | 'toolset';
type Capability = { id: string; name: string; description: string; available: boolean; joined: boolean };
export interface BotRemoteEditorDeps extends Pick<BotRemoteSettingsDeps, 'owner' | 'assertOwner' | 'read' | 'update' | 'skills'> {
- create(input: { id: string; name: string; avatarImageBase64: string; locale?: string }): Promise<void>;
+ modelDefaults(): Promise<BotModelRoute[]>;
+ create(input: { id: string; name: string; avatarImageBase64: string; locale?: string; capabilities?: { modelChainOverride: BotModelRoute[] } }): Promise<void>;
avatar(botId: string, bytes: string, version: number, expectedAvatar: string): Promise<void>;
skill(botId: string, slug: string): Promise<BotSkillDetail | null>;
saveSkill(botId: string, skill: BotSkillDetail): Promise<void>;
@@ -61,12 +63,15 @@ export function createBotRemoteEditors(deps: BotRemoteEditorDeps, bind: ReturnTy
return async (context: RemoteResourceHostContext, id: string, locale?: string, options: BotRemoteEditorOptions = {}): Promise<RemoteResource> => {
const owner = deps.owner(); deps.assertOwner(owner);
if (id === 'create') {
+ const modelChain = await deps.modelDefaults(); deps.assertOwner(owner);
const panel = form('create', editorCopy.create, [
{ id: 'name', label: editorCopy.name, kind: 'text', required: true },
{ id: 'avatarImageBase64', label: editorCopy.avatar, kind: 'text', required: true },
], { name: '', avatarImageBase64: '' });
- return bind(context, { ref: ref(id), revision: '1', display: { title: editorCopy.create }, links: [], blocks: [panel.block], actions: [panel.action] }, async () => '1', async request => {
- const input = request.input ?? {}; keys(input, ['name', 'avatarImageBase64', 'requestId']);
+ // Metadata keeps older generic form renderers from displaying raw model JSON.
+ const block = { ...panel.block, data: { ...panel.block.data, creationModelChain: JSON.stringify(modelChain.slice(0, 1)) } };
+ return bind(context, { ref: ref(id), revision: '1', display: { title: editorCopy.create }, links: [], blocks: [block], actions: [panel.action] }, async () => '1', async request => {
+ const input = request.input ?? {}; keys(input, ['name', 'avatarImageBase64', 'requestId', 'modelChain']);
const requestId = string(input.requestId, 80);
if (!/^[a-zA-Z0-9_-]{16,80}$/.test(requestId)) fail();
const name = string(input.name, 200).trim(); if (!name) fail();
@@ -74,7 +79,15 @@ export function createBotRemoteEditors(deps: BotRemoteEditorDeps, bind: ReturnTy
// Same paired controller + intent maps to the same durable identity after ACK loss/restart.
// Never overwrite an existing profile during reconciliation.
const botId = `bot_mobile_${hash([owner, context.controllerDeviceId, requestId]).slice(0, 40)}`;
- await deps.create({ id: botId, name, avatarImageBase64, locale });
+ let capabilities: { modelChainOverride: BotModelRoute[] } | undefined;
+ if (input.modelChain !== undefined) {
+ let value: unknown;
+ try { value = JSON.parse(string(input.modelChain, 4000)); } catch { fail(); }
+ const chain = normalizeBotModelChain(value);
+ if (!Array.isArray(value) || value.length !== 1 || chain.length !== 1 || !['claude', 'codex', 'pi'].includes(value[0]?.harness)) fail();
+ capabilities = { modelChainOverride: chain };
+ }
+ await deps.create({ id: botId, name, avatarImageBase64, locale, ...(capabilities ? { capabilities } : {}) });
deps.assertOwner(owner);
return { effects: [{ kind: 'refresh-collection', collectionId: 'teammates' }, { kind: 'navigate', target: { kind: 'resource', ref: ref(botId) } }] };
});
diff --git a/apps/desktop/src/main/localDb/ipc/botRemoteManagement.ts b/apps/desktop/src/main/localDb/ipc/botRemoteManagement.ts
index a2ab8b464d..8458e93463 100644
--- a/apps/desktop/src/main/localDb/ipc/botRemoteManagement.ts
+++ b/apps/desktop/src/main/localDb/ipc/botRemoteManagement.ts
@@ -1,6 +1,7 @@
+import { readEffectiveBotModelChain } from '../../maker-host/bot-model-chain-settings-store.js';
import type { RemoteResourceHostContext } from '../../device-link/remoteResourceRegistry.js';
import { botRemoteResourceFromSource } from './botRemoteResourceProjection.js';
-import { inspectAppDefaultModel } from '../../maker-ipc/appDefaultModelControl.js';
+import { resolveAvailableTaskModels } from '../../maker-ipc/appDefaultModelControl.js';
import type { BotModelRoute } from '../../../shared/botModelChain.js';
import { createBotRemoteSettingsResource } from './botRemoteSettingsResource.js';
import { createBotProfile, createBotCanonicalSession, getBotMemoryService, getBotRemoteResourceSource, getBotRemoteSettingsSource, setBotProfileAvatar, updateBotProfile } from './bots.js';
@@ -13,6 +14,13 @@ import { decodeBotAvatarImage } from './botAvatarSelection.js';
import { runRegisteredBotLifecycleAction } from '../../maker-ipc/botLifecycleService.js';
import { listBotSettingsCapabilities, validateBotCapabilityAdditions } from '../../maker-host/index.js';
+async function validateModelChain(chain: BotModelRoute[]) {
+ const scope = activeOwnerScopeKey();
+ const resolved = await resolveAvailableTaskModels(chain);
+ if (isAppSessionBoundaryPending() || scope !== activeOwnerScopeKey()) throwIpcError('PRECONDITION_FAILED', 'Account changed');
+ if (resolved.some(route => !route)) throwIpcError('INVALID_PARAMS', 'Model route unavailable');
+}
+
/** Composition only: profile transactions, skill reads and lifecycle stay with their existing owners. */
const deps = {
owner: activeOwnerScopeKey,
@@ -24,13 +32,7 @@ const deps = {
const owner = activeOwnerScopeKey();
const capabilities = input.capabilities as { modelChainOverride?: BotModelRoute[] | null } | undefined;
if (Array.isArray(capabilities?.modelChainOverride)) {
- const scope = activeOwnerScopeKey();
- const catalog = await inspectAppDefaultModel();
- if (isAppSessionBoundaryPending() || scope !== activeOwnerScopeKey()) throwIpcError('PRECONDITION_FAILED', 'Account changed');
- for (const route of capabilities.modelChainOverride) {
- const entry = catalog.available.find(item => item.route.harness === route.harness && item.route.model === route.model && item.route.providerId === route.providerId);
- if (!entry || route.effort && !entry.efforts.some(effort => effort === route.effort) || route.fastMode && !entry.supportsFastMode) throwIpcError('INVALID_PARAMS', 'Model route unavailable');
- }
+ await validateModelChain(capabilities.modelChainOverride);
}
if (isAppSessionBoundaryPending() || owner !== activeOwnerScopeKey()) throwIpcError('PRECONDITION_FAILED', 'Account changed');
return updateBotProfile(input, version, validateBotCapabilityAdditions);
@@ -41,6 +43,17 @@ const settings = createBotRemoteSettingsResource({ ...deps,
lifecycle: (botId, action, confirmName, guard) => runRegisteredBotLifecycleAction({ botId, action, confirmName, keepTaskHistory: true, worktreeDisposition: 'retain' }, guard),
});
const getEditor = createBotRemoteEditors({ ...deps,
+ async modelDefaults() {
+ const owner = deps.owner();
+ const chain = await readEffectiveBotModelChain({});
+ deps.assertOwner(owner);
+ if (!chain.length) return [];
+ const [primary] = await resolveAvailableTaskModels(chain.slice(0, 1));
+ deps.assertOwner(owner);
+ // Creation shows the primary only. Do not silently promote a backup or
+ // rewrite the persisted default when its primary is no longer usable.
+ return primary ? [primary, ...chain.slice(1)] : [];
+ },
async create(input) {
const owner = deps.owner(); deps.assertOwner(owner);
let source;
@@ -51,6 +64,16 @@ const getEditor = createBotRemoteEditors({ ...deps,
}
deps.assertOwner(owner);
if (!source) {
+ if (input.capabilities) await validateModelChain(input.capabilities.modelChainOverride);
+ else {
+ const chain = await readEffectiveBotModelChain({});
+ deps.assertOwner(owner);
+ if (!chain.length) throwIpcError('INVALID_PARAMS', 'Model route unavailable');
+ // Match the primary advertised by the creation form, without rejecting
+ // an otherwise usable default because an optional backup is unavailable.
+ await validateModelChain(chain.slice(0, 1));
+ }
+ deps.assertOwner(owner);
await createBotProfile({ ...input, prepareInvitation: true });
deps.assertOwner(owner);
source = await getBotRemoteResourceSource(input.id);
diff --git a/apps/desktop/src/main/localDb/ipc/botRemoteSettingsResource.ts b/apps/desktop/src/main/localDb/ipc/botRemoteSettingsResource.ts
index 4a1af4be20..2e3c32e351 100644
--- a/apps/desktop/src/main/localDb/ipc/botRemoteSettingsResource.ts
+++ b/apps/desktop/src/main/localDb/ipc/botRemoteSettingsResource.ts
@@ -119,7 +119,10 @@ export function createBotRemoteSettingsResource(deps: BotRemoteSettingsDeps) {
return { id: operation, primitive: 'markdown', title: copy[operation], fallbackMarkdown: Object.values(values).filter(value => typeof value === 'string').join('\n\n').slice(0, 60_000) };
}
const id = issue(context, owner, settings, operation);
+ const preparing = source.invitation && source.invitation.stage !== 'ready'
+ && !(source.invitation.stage === 'avatar' && source.canonicalSessionId);
actions.push({ id, label: copy[operation], fields,
+ ...(operation === 'profile' && preparing ? { disabled: true } : {}),
...(operation === 'permissions' ? { confirmation: { title: copy.permissions, body: copy.permissionWarning, confirmLabel: copy.save } } : {}) });
return { id: operation, primitive: 'form', title: copy[operation], fallbackMarkdown: operation === 'models' ? settings.modelChain.map(route => [route.model, route.providerId, route.harness, route.effort, `Fast: ${route.fastMode}`].filter(Boolean).join(' · ')).join('\n') : copy[operation].fallback, data: { actionId: id, values } };
};
diff --git a/apps/desktop/src/main/localDb/ipc/bots.ts b/apps/desktop/src/main/localDb/ipc/bots.ts
index 8593be0b6e..558cc6c63a 100644
--- a/apps/desktop/src/main/localDb/ipc/bots.ts
+++ b/apps/desktop/src/main/localDb/ipc/bots.ts
@@ -1546,6 +1546,16 @@ export async function updateBotProfile(raw: unknown, expectedVersion?: number,
else delete nextConfig.gender;
}
const normalizedNextConfig = normalizeBotModelCapabilitiesOrThrow(nextConfig);
+ // Legacy chain-only profiles gain mirrored fields during normalization.
+ // Compare the same representation so unrelated edits do not validate stale routes.
+ if (botProfileModelSelectionChanged(normalizeBotModelCapabilitiesOrThrow(previous), normalizedNextConfig)) {
+ const primary = (await readEffectiveBotModelChain(normalizedNextConfig))[0];
+ owner.assertCurrent();
+ if (!primary || !await validateTaskModel(primary)) {
+ throwIpcError('INVALID_PARAMS', 'Model route unavailable');
+ }
+ owner.assertCurrent();
+ }
if (JSON.stringify(previous.taskModelOverride ?? null) !== JSON.stringify(normalizedNextConfig.taskModelOverride ?? null)) {
const taskModel = readBotTaskModelOverride(normalizedNextConfig.taskModelOverride);
if (taskModel && !await validateTaskModel(taskModel)) {
@@ -1832,6 +1842,17 @@ export function registerBotIpc(): void {
ipcMain.handle('local-db:bots:create', async (event, raw: unknown) => {
assertTrustedAppRendererEvent(event);
+ const body = raw && typeof raw === 'object' && !Array.isArray(raw) ? raw as Record<string, unknown> : {};
+ if (body.prepareInvitation === true) {
+ const owner = captureBotOperationOwner();
+ const capabilities = body.capabilities && typeof body.capabilities === 'object' && !Array.isArray(body.capabilities)
+ ? body.capabilities as Record<string, unknown> : {};
+ const [primary] = await readEffectiveBotModelChain(capabilities);
+ owner.assertCurrent();
+ const available = primary && await validateTaskModel(primary);
+ owner.assertCurrent();
+ if (!available) throwIpcError('INVALID_PARAMS', 'Model route unavailable');
+ }
return createBotProfile(raw);
});
diff --git a/apps/desktop/src/main/maker-ipc/__tests__/appDefaultModelControl.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/appDefaultModelControl.test.ts
index 6e92e9b0ec..7dcef67ac3 100644
--- a/apps/desktop/src/main/maker-ipc/__tests__/appDefaultModelControl.test.ts
+++ b/apps/desktop/src/main/maker-ipc/__tests__/appDefaultModelControl.test.ts
@@ -1,7 +1,7 @@
import type { BotModelRoute } from '../../../shared/botModelChain';
import type { ProviderView } from '@cindy/model-providers';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { changeAppDefaultModel, configureAppDefaultModelSelection, inspectAppDefaultModel, validateTaskModel, resolveTaskModelSelection } from '../appDefaultModelControl';
+import { changeAppDefaultModel, configureAppDefaultModelSelection, inspectAppDefaultModel, validateTaskModel, resolveAvailableTaskModels, resolveTaskModelSelection } from '../appDefaultModelControl';
import { setNewMakerDraftCache, syncNewMakerDraftCache } from '../../maker-host/newMakerDefaultsCache';
const host = vi.hoisted(() => ({ owner: 'owner:1', enabled: true, connected: true, agents: ['codex'],
@@ -55,6 +55,18 @@ describe('Bot control of the real Cindy default', () => {
expect(await validateTaskModel(route)).toBe(false);
expect((await inspectAppDefaultModel()).current).toEqual(route);
});
+ it('resolves an implicit legacy source without changing the saved route or accepting a stale explicit source', async () => {
+ const legacy = { ...route, providerId: null };
+ mirror(legacy);
+ expect(await resolveAvailableTaskModels([legacy])).toEqual([route]);
+ expect(await validateTaskModel(legacy)).toBe(true);
+ expect((await inspectAppDefaultModel()).current).toEqual(legacy);
+ expect(await validateTaskModel({ ...legacy, providerId: 'deleted' })).toBe(false);
+ host.enabled = false;
+ expect(await validateTaskModel(legacy)).toBe(false);
+ host.enabled = true; host.connected = false;
+ expect(await validateTaskModel(legacy)).toBe(false);
+ });
it('resolves a one-task selection without changing application preferences', async () => {
const dispatch = vi.fn(); configureAppDefaultModelSelection(dispatch);
expect(await resolveTaskModelSelection({ id, effort: 'low', fastMode: true })).toEqual({ ...route, effort: 'low', fastMode: true });
diff --git a/apps/desktop/src/main/maker-ipc/appDefaultModelControl.ts b/apps/desktop/src/main/maker-ipc/appDefaultModelControl.ts
index a599e590d4..9e865a70ad 100644
--- a/apps/desktop/src/main/maker-ipc/appDefaultModelControl.ts
+++ b/apps/desktop/src/main/maker-ipc/appDefaultModelControl.ts
@@ -60,12 +60,13 @@ async function readSelection() {
const providers = await getDesktopProviderService().listProviders({ allowSideEffects: false });
assertOwner();
const current = getSelectedNewMakerRoute(owner) ?? null;
- const available = availableAppDefaultModels({ providers, currentRoute: current,
+ const inputs = { providers, currentRoute: current,
tuning: (agent, providerId, model) => getNewMakerModelTuning(owner, agent, providerId, model),
availableAgents: new Set((getMakerIfReady()?.listAvailableAgents() ?? []).map(agent => agent === 'claude-code' ? 'cc' : agent)),
enabled: (agent, providerId, model) => isModelVisible(getModelVisibilityOverride(agent, providerId, model.id), model.defaultEnabled),
- });
- return { owner, assertOwner, current, available };
+ } satisfies Parameters<typeof availableAppDefaultModels>[0];
+ const available = availableAppDefaultModels(inputs);
+ return { owner, assertOwner, current, available, inputs };
}
export async function inspectAppDefaultModel() {
@@ -96,13 +97,24 @@ export async function resolveTaskModelSelection(selection: TaskModelSelection):
};
}
+/** Resolve legacy implicit sources using the ordinary default policy, without persisting changes. */
+export async function resolveAvailableTaskModels(routes: readonly BotModelRoute[]): Promise<Array<BotModelRoute | null>> {
+ const { available, inputs } = await readSelection();
+ return routes.map(route => {
+ const resolved = defaultBotModelChain({ providers: inputs.providers, providersLoading: false,
+ availableAgents: inputs.availableAgents, availableAgentsLoaded: true,
+ preferredRoute: route, isModelEnabled: inputs.enabled })[0];
+ if (!resolved) return null;
+ const entry = available.find(item => item.route.harness === resolved.harness
+ && item.route.model === resolved.model && item.route.providerId === resolved.providerId);
+ return entry && (!resolved.effort || entry.efforts.some(effort => effort === resolved.effort))
+ && (!resolved.fastMode || entry.supportsFastMode) ? resolved : null;
+ });
+}
+
/** Check a saved full route without changing the application or teammate's primary model. */
export async function validateTaskModel(route: BotModelRoute): Promise<boolean> {
- const { available } = await inspectAppDefaultModel();
- return available.some(entry => entry.route.harness === route.harness
- && entry.route.model === route.model && entry.route.providerId === route.providerId
- && (!route.effort || entry.efforts.some(effort => effort === route.effort))
- && (!route.fastMode || entry.supportsFastMode));
+ return !!(await resolveAvailableTaskModels([route]))[0];
}
/** Wait for a fresh owner-fenced mirror after the real setter persisted the selected route. */
diff --git a/apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx b/apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx
index 9d6c72e5e2..db83305f4f 100644
--- a/apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx
+++ b/apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx
@@ -18,6 +18,7 @@ export function BotBasicProfileFields({
onChooseAvatar,
avatarBusy = false,
autoFocusName = false,
+ readOnly = false,
avatarPreview,
centeredAvatar = false,
avatarControl,
@@ -36,6 +37,7 @@ export function BotBasicProfileFields({
onChooseAvatar?: () => void;
avatarBusy?: boolean;
autoFocusName?: boolean;
+ readOnly?: boolean;
/** Unsaved local selection; never persisted as an avatar address. */
avatarPreview?: string;
}) {
@@ -76,6 +78,7 @@ export function BotBasicProfileFields({
<label className="flex w-full min-w-0 flex-1 flex-col gap-1.5 text-12 text-[var(--text-secondary)]">
{t('bots.nameLabel')}
<Input
+ readOnly={readOnly}
autoFocus={autoFocusName}
ariaLabel={t('bots.nameLabel')}
value={value.name}
@@ -93,6 +96,7 @@ export function BotBasicProfileFields({
{t('bots.profile.summary')}
<Textarea
aria-label={t('bots.profile.summary')}
+ readOnly={readOnly}
value={value.description}
onChange={(next) => update('description', next, 'text')}
onBlur={onDescriptionBlur}
diff --git a/apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx b/apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx
index 28427e0e82..204df68931 100644
--- a/apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx
+++ b/apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx
@@ -7,7 +7,11 @@ import { retryBotInvitation, type BotProfile } from './botStore';
import { useBotTranslation } from './botPronounContext';
/** The same welcome appears while inviting and when returning to a pending companion. */
-export function BotInvitationWelcome({ bot }: { bot: BotProfile }) {
+export function BotInvitationWelcome({ bot, onConfigureModel, onRetry }: {
+ bot: BotProfile;
+ onConfigureModel?: () => void;
+ onRetry?: () => Promise<void>;
+}) {
const { t } = useBotTranslation();
const [retrying, setRetrying] = useState(false);
const [retryFailed, setRetryFailed] = useState(false);
@@ -36,7 +40,7 @@ export function BotInvitationWelcome({ bot }: { bot: BotProfile }) {
onClick={() => {
setRetrying(true);
setRetryFailed(false);
- void retryBotInvitation(bot.id)
+ void Promise.resolve().then(() => onRetry ? onRetry() : retryBotInvitation(bot.id))
.catch(() => setRetryFailed(true))
.finally(() => setRetrying(false));
}}
@@ -56,6 +60,11 @@ export function BotInvitationWelcome({ bot }: { bot: BotProfile }) {
})}
</p>
)}
+ {onConfigureModel ? (
+ <Button variant="secondary" size="lg" type="button" disabled={retrying} onClick={onConfigureModel}>
+ {t('bots.invitation.changeModel')}
+ </Button>
+ ) : null}
{retryFailed ? (
<p role="alert" className="text-12 text-[var(--text-danger)]">
{t('bots.invitation.retryFailed')}
diff --git a/apps/desktop/src/renderer/features/bots/BotRosterView.tsx b/apps/desktop/src/renderer/features/bots/BotRosterView.tsx
index 75ef75a6f8..96ae3d4915 100644
--- a/apps/desktop/src/renderer/features/bots/BotRosterView.tsx
+++ b/apps/desktop/src/renderer/features/bots/BotRosterView.tsx
@@ -1,14 +1,28 @@
+import { getDataOwnerGeneration, isDataOwnerGenerationCurrent, type DataOwnerGeneration } from '@/contexts/dataOwnerGeneration';
import { useAuth } from '@/contexts/AuthContext';
import { BotImportForm } from './BotImportForm';
import { Button } from '@/components/ui/button';
import * as Dialog from '@radix-ui/react-dialog';
-import { useEffect, useRef, useState } from 'react';
+import { useEffect, useRef, useState, useSyncExternalStore } from 'react';
import { ArrowRight } from 'lucide-react';
import { useNavigate } from 'react-router-dom';
import { useTranslation } from 'react-i18next';
import { normalizeBotName } from '../../../shared/botCreation';
import { BOT_PORTRAIT_COUNT, BotPortraitPicker, galleryPortrait } from './BotPortraitPicker';
-import { addBotProfileAndWait, BotModelSelectionRequiredError, useBotProfiles, type BotProfile } from './botStore';
+import { addBotProfileAndWait, BotModelSelectionRequiredError, getEffectiveBotModelChain, subscribeBotGlobalModel, useBotProfiles, type BotProfile } from './botStore';
+import { useProviders } from '@/hooks/useProviders';
+import { BotModelChainEditor } from './BotModelChainEditor';
+import type { BotModelRoute } from '../../../shared/botModelChain';
+
+// Only the provider-setup detour retains a draft; ordinary close/unmount discards it.
+let providerSetupDraft: {
+ owner: DataOwnerGeneration;
+ dataOwnerId: string | null;
+ name: string;
+ portrait?: string;
+ initialPortrait: number;
+ modelOverride: BotModelRoute[] | null;
+} | null = null;
interface BotRosterViewProps {
onCreated?: (bot: BotProfile) => void;
@@ -23,10 +37,17 @@ export function BotRosterView({ onCreated, onClose, restoreFocus, inline = false
const { dataOwnerId } = useAuth();
const navigate = useNavigate();
const bots = useBotProfiles();
+ useProviders();
+ useSyncExternalStore(subscribeBotGlobalModel, () => JSON.stringify(getEffectiveBotModelChain()));
+ const [restoredDraft] = useState(() => providerSetupDraft
+ && providerSetupDraft.dataOwnerId === dataOwnerId
+ && isDataOwnerGenerationCurrent(providerSetupDraft.owner) ? providerSetupDraft : null);
+ useEffect(() => { providerSetupDraft = null; }, []);
+ const [modelOverride, setModelOverride] = useState<BotModelRoute[] | null>(restoredDraft?.modelOverride ?? null);
const [importing, setImporting] = useState(false);
- const [name, setName] = useState('');
- const [portrait, setPortrait] = useState<string>();
- const [initialPortrait] = useState(() => Math.floor(Math.random() * BOT_PORTRAIT_COUNT));
+ const [name, setName] = useState(restoredDraft?.name ?? '');
+ const [portrait, setPortrait] = useState<string | undefined>(restoredDraft?.portrait);
+ const [initialPortrait] = useState(() => restoredDraft?.initialPortrait ?? Math.floor(Math.random() * BOT_PORTRAIT_COUNT));
const [creating, setCreating] = useState(false);
const [error, setError] = useState<string | null>(null);
const submitting = useRef(false);
@@ -48,6 +69,7 @@ export function BotRosterView({ onCreated, onClose, restoreFocus, inline = false
setError(null);
try {
const bot = await addBotProfileAndWait({ name: name.trim(), description: '',
+ ...(modelOverride ? { capabilities: { ...modelOverride[0], modelChain: modelOverride, modelChainOverride: modelOverride } } : {}),
avatarImageBase64: portrait.split(',')[1], prepareInvitation: true });
if (!alive.current) return;
if (onCreated) onCreated(bot); else navigate(`/bots/${bot.id}`);
@@ -91,12 +113,25 @@ export function BotRosterView({ onCreated, onClose, restoreFocus, inline = false
className="mt-2 h-11 w-full rounded-full border border-[var(--border-default)] bg-[var(--confirm-bg)] px-3 text-16 text-[var(--text-primary)] outline-none focus-visible:ring-2 focus-visible:ring-[var(--focus-ring)]" />
</label>
</div>
+ <div className="mt-5">
+ <BotModelChainEditor
+ label={t('bots.settingsTabs.model')}
+ value={(modelOverride ?? getEffectiveBotModelChain()).slice(0, 1)}
+ disabled={creating}
+ allowFallbacks={false}
+ onChange={(routes) => { setModelOverride(routes.slice(0, 1)); setError(null); }}
+ onNavigateToProviders={() => {
+ providerSetupDraft = { owner: getDataOwnerGeneration(), dataOwnerId, name, portrait, initialPortrait, modelOverride };
+ navigate('/settings?tab=providers');
+ }}
+ />
+ <p className="mt-1 text-12 leading-5 text-[var(--text-secondary)]">
+ {t(modelOverride ? 'bots.guided.modelForThisBot' : 'bots.guided.modelFollowsDefault')}
+ </p>
+ </div>
{(error || duplicate) && (
<p role="alert" className="mt-4 text-13 text-[var(--text-danger)]">{duplicate ? t('bots.guided.duplicateName') : error}</p>
)}
- {error === t('bots.guided.modelRequired') && (
- <button type="button" className="mt-3 h-9 rounded-full px-4 text-13 hover:bg-[var(--surface-hover)]" onClick={() => navigate('/settings?tab=providers')}>{t('bots.settingsTabs.model')}</button>
- )}
<div className="mt-8 flex justify-between gap-3">
<Button variant="secondary" size="lg" type="button" disabled={creating} onClick={() => setImporting(true)}>{t('bots.import.entry')}</Button>
<Button
diff --git a/apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx b/apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx
index c394c72bd5..27b8acd32b 100644
--- a/apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx
+++ b/apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx
@@ -140,8 +140,8 @@ export function BotSettingsDrawer() {
) : bot ? (
<BotPronounProvider bot={bot}>
<BotSettings
- key={`${bot.id}:${open}:${initialPage}`}
- initialPage={initialPage}
+ key={`${bot.id}:${open}:${requestedPage === 'model' ? 'model' : initialPage}`}
+ initialPage={requestedPage === 'model' ? 'model' : initialPage}
beforeCloseRef={beforeCloseRef}
bot={bot}
onBack={performClose}
diff --git a/apps/desktop/src/renderer/features/bots/BotsHomeView.tsx b/apps/desktop/src/renderer/features/bots/BotsHomeView.tsx
index 49644f4502..01296342c6 100644
--- a/apps/desktop/src/renderer/features/bots/BotsHomeView.tsx
+++ b/apps/desktop/src/renderer/features/bots/BotsHomeView.tsx
@@ -100,7 +100,7 @@ export function BotSettings({
beforeCloseRef,
initialPage = 'home',
}: {
- initialPage?: 'home' | 'memory' | 'capabilities';
+ initialPage?: 'home' | 'memory' | 'capabilities' | 'model';
bot: BotProfile;
beforeCloseRef?: { current: (() => Promise<boolean>) | null };
onBack: () => void;
@@ -400,12 +400,8 @@ export function BotSettings({
/>
);
- if (
- bot.invitation &&
- bot.invitation.stage !== 'ready' &&
- !(bot.invitation.stage === 'avatar' && bot.canonicalSessionId)
- )
- return <BotInvitationWelcome bot={bot} />;
+ const invitationPending = bot.invitation && bot.invitation.stage !== 'ready'
+ && !(bot.invitation.stage === 'avatar' && bot.canonicalSessionId);
const settingsRows = [
['profile', Info, t('bots.profile.title')],
@@ -420,6 +416,15 @@ export function BotSettings({
return (
<div className="min-h-0 flex-1 overflow-y-auto overscroll-contain px-5 pb-8">
<div className="mx-auto w-full max-w-xl">
+ {invitationPending && (page === 'home' || page === 'model') ? (
+ <BotInvitationWelcome bot={bot}
+ onConfigureModel={page === 'model' ? undefined : () => go('model')}
+ onRetry={async () => {
+ // A retry must use the confirmed selection, never race an autosave.
+ if (!await canLeave()) throw new Error('Bot settings have not been saved');
+ await retryBotInvitation(bot.id);
+ }} />
+ ) : null}
<div className="flex min-h-12 flex-wrap items-center justify-between gap-3">
{page !== 'home' ? (
<div className="flex min-w-0 items-center gap-2">
@@ -520,6 +525,7 @@ export function BotSettings({
<div hidden={page !== 'profile'} className="pt-3">
<BotBasicProfileFields
centeredAvatar
+ readOnly={!!invitationPending}
value={{ name, description, avatar, avatarColor }}
avatarControl={avatarPicker}
composition={autosave.composition}
@@ -561,6 +567,7 @@ export function BotSettings({
<div hidden={page !== 'personality'} className="pt-3">
<Textarea
aria-label={t('bots.profile.personality')}
+ readOnly={!!invitationPending}
value={identitySource}
onChange={(next) => {
setIdentitySource(next);
@@ -1022,19 +1029,8 @@ export function BotsHomeView() {
)
return (
<main className="flex h-full items-center justify-center px-6" role="main">
- {selectedBot.invitation.stage === 'failed' ? (
- <Button
- variant="secondary"
- size="lg"
- tone="quiet"
- type="button"
- onClick={() => void retryBotInvitation(selectedBot.id)}
- >
- {t('commonUi.retry')}
- </Button>
- ) : (
- <Spinner size={20} />
- )}
+ <BotInvitationWelcome bot={selectedBot}
+ onConfigureModel={() => navigate(`/bots/${selectedBot.id}?settings=1&settingsPage=model`)} />
</main>
);
diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botRosterView.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/botRosterView.test.tsx
index 2bdb3bf6a9..d0aa611fdb 100644
--- a/apps/desktop/src/renderer/features/bots/__tests__/botRosterView.test.tsx
+++ b/apps/desktop/src/renderer/features/bots/__tests__/botRosterView.test.tsx
@@ -14,6 +14,7 @@ const mocks = vi.hoisted(() => ({
generateDraft: vi.fn(),
galleryPortrait: vi.fn(async (_index: number) => 'data:image/png;base64,cG9ydHJhaXQ='),
defaultModel: 'cindy-selected-model',
+ withDefaultBackup: false,
navigate: vi.fn(),
onboarding: false,
availableVendors: new Set(['cc', 'codex', 'pi']),
@@ -38,6 +39,8 @@ vi.mock('../botStore', () => ({
BotModelSelectionRequiredError: mocks.BotModelSelectionRequiredError,
addBotProfileAndWait: mocks.addBotProfileAndWait,
useBotProfiles: () => mocks.profiles,
+ subscribeBotGlobalModel: () => () => {},
+ getEffectiveBotModelChain: () => mocks.defaultModel ? [{ harness: 'codex', model: mocks.defaultModel, providerId: 'openai', effort: 'high', fastMode: false }, ...(mocks.withDefaultBackup ? [{ harness: 'pi', model: 'hidden-backup', providerId: 'backup-provider', effort: 'high', fastMode: false }] : [])] : [],
refreshBotProfiles: vi.fn(),
retryBotInvitation: vi.fn(),
getEffectiveBotModelSettings: () => ({
@@ -100,10 +103,13 @@ vi.mock('../BotPortraitPicker', () => ({
}));
import { BotRosterView } from '../BotRosterView';
+import { setDataOwnerGeneration } from '@/contexts/dataOwnerGeneration';
beforeEach(() => {
+ setDataOwnerGeneration('fixture-owner');
mocks.galleryPortrait.mockClear();
mocks.defaultModel = 'cindy-selected-model';
+ mocks.withDefaultBackup = false;
mocks.generateDraft.mockReset();
mocks.generateDraft.mockResolvedValue({
token: 'draft-1',
@@ -126,6 +132,34 @@ beforeEach(() => {
afterEach(() => { cleanup(); vi.restoreAllMocks(); });
describe('name-only creation', () => {
+ it.each([false, true])('restores the provider-setup draft after unmount (inline=%s), then discards it on cancel', async inline => {
+ const first = render(<BotRosterView inline={inline} />);
+ fireEvent.change(screen.getByRole('textbox'), { target: { value: 'Keep me' } });
+ fireEvent.click(screen.getByTestId('portrait'));
+ fireEvent.click(screen.getByRole('button', { name: 'choose-custom-model' }));
+ fireEvent.click(screen.getByRole('button', { name: 'connect-source' }));
+ expect(mocks.navigate).toHaveBeenCalledWith('/settings?tab=providers');
+ first.unmount();
+ const returned = render(<BotRosterView />);
+ expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe('Keep me');
+ expect(screen.getByTestId('portrait').textContent).toBe('data:image/png;base64,bWFudWFs');
+ expect(screen.getByTestId('selected-engine').textContent).toBe('pi');
+ fireEvent.click(screen.getByRole('button', { name: 'commonUi.confirmDialog.cancel' }));
+ returned.unmount();
+ render(<BotRosterView />);
+ expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe('');
+ });
+
+ it('does not restore a setup draft across an account transition', () => {
+ const first = render(<BotRosterView />);
+ fireEvent.change(screen.getByRole('textbox'), { target: { value: 'Private draft' } });
+ fireEvent.click(screen.getByRole('button', { name: 'connect-source' }));
+ first.unmount();
+ setDataOwnerGeneration('another-owner');
+ render(<BotRosterView />);
+ expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe('');
+ });
+
it('randomizes across all 17 portraits per new form, not by roster length', async () => {
const random = vi.spyOn(Math, 'random').mockReturnValue(0);
const first = render(<BotRosterView inline />);
@@ -161,6 +195,23 @@ describe('name-only creation', () => {
expect(mocks.generateDraft).not.toHaveBeenCalled();
});
+ it.each([false, true])('keeps default-chain inheritance but saves only the visible explicit model: selected=%s', async selected => {
+ mocks.withDefaultBackup = true;
+ render(<BotRosterView />);
+ fireEvent.change(screen.getByRole('textbox'), { target: { value: 'Mika' } });
+ if (selected) fireEvent.click(screen.getByRole('button', { name: 'choose-custom-model' }));
+ await waitFor(() => expect((screen.getByRole('button', { name: 'bots.guided.generate' }) as HTMLButtonElement).disabled).toBe(false));
+ fireEvent.click(screen.getByRole('button', { name: 'bots.guided.generate' }));
+ await waitFor(() => expect(mocks.addBotProfileAndWait).toHaveBeenCalledTimes(1));
+ const input = mocks.addBotProfileAndWait.mock.calls[0][0];
+ if (selected) {
+ expect(input.capabilities.modelChainOverride).toEqual([
+ { harness: 'pi', model: 'custom-model', providerId: 'custom', effort: 'high', fastMode: false },
+ ]);
+ expect(input.capabilities.modelChain).toEqual(input.capabilities.modelChainOverride);
+ } else expect(input.capabilities).toBeUndefined();
+ });
+
it('preserves the name when the configured model is unavailable', async () => {
mocks.addBotProfileAndWait.mockRejectedValueOnce(new mocks.BotModelSelectionRequiredError());
render(<BotRosterView />);
@@ -170,6 +221,25 @@ describe('name-only creation', () => {
await screen.findByRole('alert');
expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe('Mika');
expect(mocks.navigate).not.toHaveBeenCalled();
+ fireEvent.click(screen.getByRole('button', { name: 'choose-custom-codex-model' }));
+ fireEvent.click(screen.getByRole('button', { name: 'bots.guided.generate' }));
+ await waitFor(() => expect(mocks.navigate).toHaveBeenCalledWith('/bots/bot-new'));
+ expect(mocks.addBotProfileAndWait).toHaveBeenLastCalledWith(expect.objectContaining({
+ name: 'Mika', avatarImageBase64: 'cG9ydHJhaXQ=',
+ capabilities: expect.objectContaining({ modelChainOverride: [{ harness: 'codex', model: 'custom-model', providerId: 'custom', effort: 'high', fastMode: false }] }),
+ }));
+ });
+
+ it('allows selecting a model before creating when there is no usable default', async () => {
+ mocks.defaultModel = '';
+ render(<BotRosterView inline />);
+ fireEvent.change(screen.getByRole('textbox'), { target: { value: 'Mika' } });
+ fireEvent.click(screen.getByRole('button', { name: 'choose-custom-model' }));
+ await waitFor(() => expect((screen.getByRole('button', { name: 'bots.guided.generate' }) as HTMLButtonElement).disabled).toBe(false));
+ fireEvent.click(screen.getByRole('button', { name: 'bots.guided.generate' }));
+ await waitFor(() => expect(mocks.addBotProfileAndWait).toHaveBeenCalledWith(expect.objectContaining({
+ capabilities: expect.objectContaining({ harness: 'pi', model: 'custom-model', providerId: 'custom' }),
+ })));
});
it('renders creation directly in the empty state and prevents duplicate names', async () => {
diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botSettings.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/botSettings.test.tsx
index 904d466130..c959ab6ae4 100644
--- a/apps/desktop/src/renderer/features/bots/__tests__/botSettings.test.tsx
+++ b/apps/desktop/src/renderer/features/bots/__tests__/botSettings.test.tsx
@@ -25,6 +25,7 @@ const mocks = vi.hoisted(() => {
const sessionGet = vi.fn();
return {
navigate: vi.fn(),
+ retryBotInvitation: vi.fn(async (_id: string) => {}),
onboarding: false,
readSession: sessionGet,
initialSearch: '' as string,
@@ -80,6 +81,7 @@ vi.mock('react-router-dom', async (importOriginal) => {
vi.mock('../botStore', () => ({
updateBotProfile: mocks.updateBotProfile,
+ retryBotInvitation: mocks.retryBotInvitation,
chooseBotAvatar: mocks.chooseBotAvatar,
setCanonicalBotSession: vi.fn(),
useBotProfiles: () => mocks.profiles,
@@ -200,6 +202,7 @@ function renderSettings(overrides: Partial<BotProfile> = {}, initialSearch = 'se
beforeEach(() => {
mocks.navigate.mockReset();
+ mocks.retryBotInvitation.mockClear();
mocks.onboarding = false;
mocks.readSession.mockReset();
mocks.updateBotProfile.mockReset();
@@ -297,6 +300,44 @@ describe('Bot entry after deletion', () => {
});
describe('Bot settings profile consolidation', () => {
+ it.each(['failed', 'welcome'] as const)('keeps model settings accessible while invitation is %s', async (stage) => {
+ renderSettings({ invitation: { stage }, canonicalSessionId: undefined });
+ expect(screen.getByLabelText('bots.nameLabel')).toHaveProperty('readOnly', true);
+ expect(screen.getByLabelText('bots.profile.summary')).toHaveProperty('readOnly', true);
+ expect(screen.getByLabelText('bots.profile.personality')).toHaveProperty('readOnly', true);
+ fireEvent.click(screen.getByRole('button', { name: 'bots.invitation.changeModel' }));
+ fireEvent.click(within(screen.getByTestId('bot-primary-model-controls')).getByTestId('codex-model-selector'));
+ await waitFor(() => expect(mocks.updateBotProfile).toHaveBeenCalledWith('bot-1', expect.objectContaining({
+ capabilities: expect.objectContaining({ modelChainOverride: [expect.objectContaining({ model: 'custom-model', harness: 'codex' })] }),
+ })));
+ });
+
+ it('waits for the replacement model to be saved before retrying the same invitation', async () => {
+ let finishSave!: () => void;
+ mocks.updateBotProfile.mockImplementationOnce(async (_id, patch) => {
+ await new Promise<void>(resolve => { finishSave = resolve; });
+ return { id: 'bot-1', currentVersion: 2, ...patch };
+ });
+ renderSettings({ invitation: { stage: 'failed' } });
+ fireEvent.click(screen.getByRole('button', { name: 'bots.invitation.changeModel' }));
+ fireEvent.click(within(screen.getByTestId('bot-primary-model-controls')).getByTestId('codex-model-selector'));
+ fireEvent.click(screen.getByRole('button', { name: 'commonUi.retry' }));
+ await waitFor(() => expect(finishSave).toBeTypeOf('function'));
+ expect(mocks.retryBotInvitation).not.toHaveBeenCalled();
+ await act(async () => finishSave());
+ await waitFor(() => expect(mocks.retryBotInvitation).toHaveBeenCalledWith('bot-1'));
+ });
+
+ it('does not retry with the old model when saving the replacement fails', async () => {
+ mocks.updateBotProfile.mockRejectedValue(new Error('save unavailable'));
+ renderSettings({ invitation: { stage: 'failed' } });
+ fireEvent.click(screen.getByRole('button', { name: 'bots.invitation.changeModel' }));
+ fireEvent.click(within(screen.getByTestId('bot-primary-model-controls')).getByTestId('codex-model-selector'));
+ fireEvent.click(screen.getByRole('button', { name: 'commonUi.retry' }));
+ await screen.findByText('bots.invitation.retryFailed');
+ expect(mocks.retryBotInvitation).not.toHaveBeenCalled();
+ });
+
it.each([true, false])('opens existing history without a model when onboarding is %s', async (onboarding) => {
const existing = bot({ capabilities: capabilities({ modelChain: [], model: '' }) });
mocks.profiles = [existing];
diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.json
index c170526a6c..560beb2a58 100644
--- a/apps/desktop/src/renderer/i18n/locales/en/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json
@@ -9205,6 +9205,7 @@
"avatar": "{{name}} is choosing a new portrait",
"welcome": "Getting a first hello ready",
"failed": "Preparation paused. Everything completed so far is saved. You can try again.",
+ "changeModel": "Change Model",
"retryFailed": "Couldn’t retry just now. Please try again shortly.",
"leave": "Step away",
"avatarSkipped": "Using the default portrait for now. You can change it anytime."
@@ -9245,7 +9246,9 @@
"generate": "Create teammate",
"generating": "Shaping your teammate…",
"generationFailed": "Could not generate your teammate. Your idea is still here; please try again.",
- "modelRequired": "Select an available default model in Cindy first.",
+ "modelRequired": "Choose an available model above to continue.",
+ "modelFollowsDefault": "Follows the default teammate model.",
+ "modelForThisBot": "This selection applies only to this teammate.",
"cindyDescription": "I can help you use Cindy, connect your tools, and get things done together.",
"cindySummary": "Manage Cindy, connect tools, and get things done.",
"openCindy": "Open Cindy",
diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.json
index 65d876f720..3732815215 100644
--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json
@@ -9167,6 +9167,7 @@
"avatar": "{{name}} が新しいアバターを選んでいます",
"welcome": "最初の挨拶を準備しています",
"failed": "準備が一時停止しました。完了した内容は保存されています。もう一度試せます。",
+ "changeModel": "モデルを変更",
"retryFailed": "再試行できませんでした。少し待ってお試しください。",
"leave": "いったん離れる",
"avatarSkipped": "今は初期アバターを使っています。いつでも変更できます。"
@@ -9207,7 +9208,9 @@
"generate": "パートナーを生成",
"generating": "パートナーを考えています…",
"generationFailed": "生成できませんでした。入力内容は残っています。もう一度お試しください。",
- "modelRequired": "まず Cindy で利用可能な既定のモデルを選択してください。",
+ "modelRequired": "上で利用可能なモデルを選択して続けてください。",
+ "modelFollowsDefault": "パートナーの既定モデルに従います。",
+ "modelForThisBot": "この選択はこのパートナーにのみ適用されます。",
"cindyDescription": "Cindy の使い方やツールの接続をお手伝いし、一緒にやり遂げます。",
"cindySummary": "Cindy の管理、ツールの接続、仕事のお手伝い。",
"openCindy": "Cindy を開く",
diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.json
index f4b0fad7df..2d58992732 100644
--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json
@@ -9167,6 +9167,7 @@
"avatar": "{{name}}이 새 아바타를 고르고 있어요",
"welcome": "첫인사를 준비하고 있어요",
"failed": "준비가 잠시 멈췄어요. 완료된 내용은 저장되어 있으니 다시 시도할 수 있어요.",
+ "changeModel": "모델 변경",
"retryFailed": "지금은 다시 시도할 수 없어요. 잠시 후 시도해 주세요.",
"leave": "잠시 나가기",
"avatarSkipped": "지금은 기본 아바타를 사용해요. 언제든 바꿀 수 있어요."
@@ -9207,7 +9208,9 @@
"generate": "파트너 생성",
"generating": "파트너를 구상하고 있어요…",
"generationFailed": "생성하지 못했습니다. 입력 내용은 남아 있으니 다시 시도해 주세요.",
- "modelRequired": "먼저 Cindy에서 사용 가능한 기본 모델을 선택해 주세요.",
+ "modelRequired": "위에서 사용 가능한 모델을 선택한 후 계속해 주세요.",
+ "modelFollowsDefault": "파트너 기본 모델을 따릅니다.",
+ "modelForThisBot": "이 선택은 이 파트너에게만 적용됩니다.",
"cindyDescription": "Cindy 사용과 도구 연결을 도와드리고 함께 일을 마무리할게요.",
"cindySummary": "Cindy 관리, 도구 연결, 일 마무리.",
"openCindy": "Cindy 열기",
diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
index 29faba4453..bd3b185cee 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
@@ -9167,6 +9167,7 @@
"avatar": "{{name}} 正在挑选新头像",
"welcome": "正在准备第一声问候",
"failed": "准备暂时停住了。已经完成的内容会保留,可以再试一次。",
+ "changeModel": "更换模型",
"retryFailed": "暂时无法重试,请稍后再试。",
"leave": "先去忙",
"avatarSkipped": "暂时用了默认头像,你随时可以换一张。"
@@ -9207,7 +9208,9 @@
"generate": "生成伙伴",
"generating": "正在构思伙伴…",
"generationFailed": "暂时没能生成,请保留你的想法再试一次。",
- "modelRequired": "请先在 Cindy 中选择可用的默认模型。",
+ "modelRequired": "请在上方选择可用模型后继续。",
+ "modelFollowsDefault": "跟随伙伴默认模型。",
+ "modelForThisBot": "此选择仅用于这位伙伴。",
"cindyDescription": "我会帮你使用 Cindy、连接工具,也会和你一起把事情做完。",
"cindySummary": "打理 Cindy,连接工具,把事情做完。",
"openCindy": "打开 Cindy",
diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
index b76a93ce3a..c3cc15d75c 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
@@ -9167,6 +9167,7 @@
"avatar": "{{name}} 正在挑選新頭像",
"welcome": "正在準備第一聲問候",
"failed": "準備暫時停住了。已完成的內容會保留,可以再試一次。",
+ "changeModel": "更換模型",
"retryFailed": "暫時無法重試,請稍後再試。",
"leave": "先去忙",
"avatarSkipped": "暫時用了預設頭像,你隨時可以換一張。"
@@ -9207,7 +9208,9 @@
"generate": "產生夥伴",
"generating": "正在構思夥伴…",
"generationFailed": "暫時無法產生,請保留你的想法再試一次。",
- "modelRequired": "請先在 Cindy 中選擇可用的預設模型。",
+ "modelRequired": "請在上方選擇可用模型後繼續。",
+ "modelFollowsDefault": "跟隨夥伴預設模型。",
+ "modelForThisBot": "此選擇僅用於這位夥伴。",
"cindyDescription": "我會幫你使用 Cindy、連接工具,也會和你一起把事情做完。",
"cindySummary": "管理 Cindy,連接工具,把事情做完。",
"openCindy": "開啟 Cindy",
diff --git a/apps/mobile/app/resources/[collectionId]/[resourceId].tsx b/apps/mobile/app/resources/[collectionId]/[resourceId].tsx
index 14b3d9821c..d3215c2345 100644
--- a/apps/mobile/app/resources/[collectionId]/[resourceId].tsx
+++ b/apps/mobile/app/resources/[collectionId]/[resourceId].tsx
@@ -1,6 +1,7 @@
+import { randomUUID } from 'expo-crypto';
import { useAuth } from '@/auth/AuthContext';
import { Redirect, useFocusEffect, useLocalSearchParams, useRouter } from 'expo-router';
-import { useCallback, useMemo, useRef, useState } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
import { ActivityIndicator, AppState, StyleSheet, View } from 'react-native';
import { SafeAreaView } from 'react-native-safe-area-context';
import { useTranslation } from 'react-i18next';
@@ -19,6 +20,7 @@ import type { RemoteSession } from '@/session/types';
import { fontWeight, useTheme, useThemedStyles, type ThemeColors } from '@/theme';
import { iconSize, lineHeight, spacing, typeScale } from '@/theme/tokens';
import { goBackGuarded } from '@/utils/backGuard';
+import { CompanionProfileSheet } from '@/session/CompanionProfileSheet';
function firstParam(value: string | string[] | undefined): string {
return Array.isArray(value) ? value[0] ?? '' : value ?? '';
@@ -60,15 +62,26 @@ function RemoteResourceResolverScreenContent() {
const [error, setError] = useState<string | null>(null);
const [preparation, setPreparation] = useState<{ binding: string; resource: RemoteResource; stage: string } | null>(null);
const [retrying, setRetrying] = useState(false);
+ const [profileOpen, setProfileOpen] = useState(false);
+ const profileOpenRef = useRef(false);
+ const pendingHistory = useRef<string | null>(null);
+ useEffect(() => {
+ profileOpenRef.current = false;
+ pendingHistory.current = null;
+ setProfileOpen(false);
+ }, [binding, deviceId, resourceId]);
// Scoped to the resource binding so another teammate never inherits this notice.
const [retryFailed, setRetryFailed] = useState<string | null>(null);
const retryLock = useRef(false);
const visiblePreparation = preparation?.binding === binding ? preparation : null;
+ const historyTarget = visiblePreparation?.resource.links.find(link => link.rel === 'conversation')?.target as RemoteSessionLinkTarget | undefined;
+ const historySessionId = historyTarget?.kind === 'session' && typeof historyTarget.sessionId === 'string' ? historyTarget.sessionId : null;
const [attempt, setAttempt] = useState(0);
const resolveGenerationRef = useRef(0);
const resolveConversation = useCallback(async () => {
const generation = ++resolveGenerationRef.current;
+ if (profileOpenRef.current) return true;
setError(null);
if (!collectionId || !resourceId || !resourceKind || !deviceId) {
setError(t('devices.resources.noHosts'));
@@ -83,13 +96,14 @@ function RemoteResourceResolverScreenContent() {
kind: resourceKind,
}, i18n.language);
if (resolveGenerationRef.current !== generation || currentBinding.current !== binding) return;
+ // Do not navigate away from an in-progress model edit when preparation recovers.
+ if (profileOpenRef.current) return true;
const invitation = response.blocks?.find(block => block.id === 'invitation' && block.primitive === 'status');
const stage = (invitation?.data as { stage?: string } | undefined)?.stage;
if (resourceKind === 'bot' && stage && stage !== 'ready') {
setPreparation({ binding, resource: response, stage });
return stage !== 'failed';
}
- setPreparation(null);
const link = response.links.find((item) => item.rel === 'conversation');
const target = link?.target as RemoteSessionLinkTarget | undefined;
if (!target || target.kind !== 'session' || typeof target.sessionId !== 'string') {
@@ -98,9 +112,11 @@ function RemoteResourceResolverScreenContent() {
}
const session = await invoke<RemoteSession>(deviceId, 'local-db:sessions:get', [target.sessionId]);
if (resolveGenerationRef.current !== generation || currentBinding.current !== binding) return;
+ if (profileOpenRef.current) return true;
if (!session || session.id !== target.sessionId || (resourceKind === 'bot' && session.source !== 'bot')) throw new Error(t('devices.resources.noConversation'));
const existingOrigin = remoteSessionStore.getSessionDeviceId(session.id);
if (existingOrigin && existingOrigin !== deviceId) throw new Error(t('devices.resources.noConversation'));
+ setPreparation(null);
remoteSessionStore.upsertDeviceSession(deviceId, deviceName, session);
router.replace({
pathname: '/sessions/[sessionId]',
@@ -114,6 +130,7 @@ function RemoteResourceResolverScreenContent() {
},
});
} catch (cause) {
+ if (profileOpenRef.current) return true;
if (resolveGenerationRef.current === generation && currentBinding.current === binding) setError(formatRemoteError(cause));
}
}, [binding, collectionId, deviceId, deviceName, host, i18n.language, invoke, resourceId, resourceKind, router, t]);
@@ -198,6 +215,11 @@ function RemoteResourceResolverScreenContent() {
<MainWindowActionButton action={{ label: retrying ? t('devices.resources.resolving') : t('devices.resources.retry'), onPress: () => { void retryInvitation(); }, testID: 'remoteResourceResolver.retryInvitation' }} />
) : null}
{retryFailed === binding ? <Text accessibilityRole="alert" style={styles.muted} testID="remoteResourceResolver.retryInvitationFailed">{t('devices.companions.invitation.retryFailed')}</Text> : null}
+ <MainWindowActionButton action={{
+ label: t('devices.companionProfile.settingsTitle'),
+ onPress: () => { profileOpenRef.current = true; setProfileOpen(true); },
+ testID: 'remoteResourceResolver.settings',
+ }} />
</View>
) : (
<View style={styles.center}>
@@ -205,6 +227,20 @@ function RemoteResourceResolverScreenContent() {
<Text style={styles.muted}>{t('devices.resources.resolving')}</Text>
</View>
)}
+ {visiblePreparation ? <CompanionProfileSheet
+ visible={profileOpen}
+ onClose={() => setProfileOpen(false)}
+ onClosed={() => {
+ const sessionId = pendingHistory.current; pendingHistory.current = null;
+ profileOpenRef.current = false;
+ if (sessionId) router.push({ pathname: '/sessions/[sessionId]', params: { sessionId, deviceId, deviceName, resourceCollectionId: collectionId, resourceId, resourceKind, openSearch: '1', openSearchRequest: randomUUID() } });
+ else setAttempt(value => value + 1);
+ }}
+ onOpenSearch={historySessionId ? () => { pendingHistory.current = historySessionId; setProfileOpen(false); } : undefined}
+ resource={visiblePreparation.resource}
+ collectionId={collectionId} deviceId={deviceId} deviceName={deviceName} online={status === 'online'}
+ onDeleted={() => goBackGuarded(router)}
+ /> : null}
</SafeAreaView>
);
}
diff --git a/apps/mobile/app/sessions/[sessionId].tsx b/apps/mobile/app/sessions/[sessionId].tsx
index 21cbed8738..7ec6707822 100644
--- a/apps/mobile/app/sessions/[sessionId].tsx
+++ b/apps/mobile/app/sessions/[sessionId].tsx
@@ -1,3 +1,4 @@
+import { useSessionHistorySearch } from '@/session/useSessionHistorySearch';
import { modelNeedsReselection } from '@/session/modelReselection';
import { getCachedDeviceProviders } from '@/device-link/deviceProvidersCache';
import { MountOnFirstOpen } from '@/session/MountOnFirstOpen';
@@ -994,6 +995,8 @@ export default function SessionScreen() {
focusComposerRequestKey?: string;
focusRequestKey?: string;
visualFocusComposer?: string;
+ openSearch?: string;
+ openSearchRequest?: string;
visualOpenSearch?: string;
visualSearchQuery?: string;
}>();
@@ -1450,7 +1453,8 @@ export default function SessionScreen() {
// 首段音频到达时与 listening 同批交接;停止、取消和错误也在这里收回 pending。
setVoiceStartPending(false);
}, []);
- const [searchOpen, setSearchOpen] = useState(false);
+ const [searchOpen, setSearchOpen] = useSessionHistorySearch(
+ readRouteParam(params.openSearch), readRouteParam(params.openSearchRequest));
const [settingsOpen, setSettingsOpen] = useState(false);
const [menuInitialView, setMenuInitialView] = useState<SessionMenuView>('menu');
const [sessionSearchPendingOpen, setSessionSearchPendingOpen] = useState(false);
diff --git a/apps/mobile/src/__tests__/CompanionProfileSheet.test.tsx b/apps/mobile/src/__tests__/CompanionProfileSheet.test.tsx
index 4a475f1bba..b7e6cde325 100644
--- a/apps/mobile/src/__tests__/CompanionProfileSheet.test.tsx
+++ b/apps/mobile/src/__tests__/CompanionProfileSheet.test.tsx
@@ -22,7 +22,7 @@ vi.mock('@/session/CompanionProfileArtifacts', () => ({ CompanionProfileArtifact
vi.mock('@/theme', async () => ({ ...await import('@/theme/tokens'), useTheme: () => ({ colors: {} }), useThemedStyles: () => ({}) }));
vi.mock('@/session/companionProfileData', async original => ({ ...await original<object>(), loadCompanionProfile: (...args: unknown[]) => h.read(...args) }));
vi.mock('@/session/CompanionProfileNativeView', () => ({ CompanionProfileNativeView: (p: any) => { h.view = p; return p.models; } }));
-vi.mock('@/session/CompanionCreateNativeView', () => ({ CompanionCreateNativeView: (p: any) => { h.create = p; return null; } }));
+vi.mock('@/session/CompanionCreateNativeView', () => ({ CompanionCreateNativeView: (p: any) => { h.create = p; return p.models ?? null; } }));
vi.mock('@/session/CompanionImportSheet', async () => {
const { useEffect, useState } = await import('react');
return { CompanionImportSheet: (p: any) => {
@@ -298,3 +298,41 @@ it('blocks a duplicate name before submitting and keeps the form after a failed
expect(h.create.panel).toBeDefined(); expect(h.create.values.name).toBe('Nova');
cache.writeRemoteCollectionCache(':1', 'teammates', []);
});
+
+it('preserves creation drafts across the model picker and sends only an explicit route', async () => {
+ h.read.mockResolvedValue({ resource, panels: [{ ...panel, creationModelChain: '[]' }] });
+ await renderCreate();
+ await act(async () => h.create.onChange({ ...h.create.values, name: 'Nova' }));
+ const portrait = h.create.values.avatarImageBase64;
+ expect(h.create.modelMissing).toBe(true);
+ await act(async () => h.create.onSubmit());
+ expect(h.invoke).not.toHaveBeenCalled();
+ await act(async () => h.model.onPick(0));
+ expect(h.create.visible).toBe(false); expect(h.picker.visible).toBe(false);
+ await act(async () => h.create.onClosed()); expect(h.picker.visible).toBe(true);
+ const route = { harness: 'pi', model: 'available', providerId: 'provider', effort: '', fastMode: false };
+ await act(async () => h.picker.onSelect(route));
+ await act(async () => h.picker.onClose()); await act(async () => h.picker.onClosed());
+ expect(h.create.values).toMatchObject({ name: 'Nova', avatarImageBase64: portrait });
+ expect(h.create.modelMissing).toBe(false);
+ h.invoke.mockRejectedValueOnce(new Error('timeout'));
+ await act(async () => h.create.onSubmit());
+ const sent = h.invoke.mock.calls[0][2].input;
+ expect(sent.modelChain).toBe(JSON.stringify([route]));
+ expect(h.create.locked).toBe(true);
+ await act(async () => h.create.onSubmit());
+ expect(h.invoke.mock.calls[1][2].input).toEqual(sent);
+});
+
+
+it.each([undefined, JSON.stringify([{ harness: 'pi', model: 'default', providerId: 'provider' }])])(
+ 'preserves default creation for host model metadata %s', async creationModelChain => {
+ h.read.mockResolvedValue({ resource, panels: [{ ...panel, creationModelChain }] });
+ await renderCreate();
+ await act(async () => h.create.onChange({ ...h.create.values, name: 'Nova' }));
+ expect(h.create.modelMissing).toBe(false);
+ await act(async () => h.create.onSubmit());
+ expect(h.invoke).toHaveBeenCalledTimes(1);
+ expect(h.invoke.mock.calls[0][2].input).not.toHaveProperty('modelChain');
+ },
+);
diff --git a/apps/mobile/src/__tests__/companionProfileData.test.ts b/apps/mobile/src/__tests__/companionProfileData.test.ts
index ab609573bd..f30f2cf91a 100644
--- a/apps/mobile/src/__tests__/companionProfileData.test.ts
+++ b/apps/mobile/src/__tests__/companionProfileData.test.ts
@@ -73,3 +73,13 @@ it('preserves a host-disabled action rather than silently enabling it', () => {
const input = { ...raw(), actions: [{ ...raw().actions[0], disabled: true }] };
expect(parseCompanionProfileData(input, ref).panels[0].action?.disabled).toBe(true);
});
+
+it('recognizes creation model support without exposing a raw JSON form field to legacy clients', () => {
+ const input = raw();
+ input.blocks[0].id = 'create';
+ Object.assign(input.blocks[0].data, { creationModelChain: '[]' });
+ const panel = parseCompanionProfileData(input, ref).panels[0];
+ expect(panel.creationModelChain).toBe('[]');
+ expect(panel.action?.fields?.map(field => field.id)).toEqual(['name']);
+ expect(parseCompanionProfileData(raw(), ref).panels[0].creationModelChain).toBeUndefined();
+});
diff --git a/apps/mobile/src/__tests__/remoteResourceInvitation.test.tsx b/apps/mobile/src/__tests__/remoteResourceInvitation.test.tsx
index 133496a914..2f2455771e 100644
--- a/apps/mobile/src/__tests__/remoteResourceInvitation.test.tsx
+++ b/apps/mobile/src/__tests__/remoteResourceInvitation.test.tsx
@@ -2,8 +2,9 @@
import { act, createElement } from 'react';
import { createRoot } from 'react-dom/client';
import { afterEach, beforeEach, expect, it, vi } from 'vitest';
+vi.mock('expo-crypto', () => ({ randomUUID: vi.fn(() => 'history-request') }));
const h = vi.hoisted(() => ({
- router: { replace: vi.fn() }, generation: 1,
+ router: { replace: vi.fn(), push: vi.fn() }, generation: 1,
params: { collectionId: 'teammates', resourceId: 'bot-1', resourceKind: 'bot', deviceId: 'mac', deviceName: 'Mac' },
translation: { t: (key: string) => key, i18n: { language: 'en' } },
read: vi.fn(), action: vi.fn(), upsert: vi.fn(), push: null as null | ((device: string, payload: any) => void),
@@ -22,6 +23,12 @@ vi.mock('react-i18next', () => ({ useTranslation: () => h.translation }));
vi.mock('react-native-safe-area-context', async () => { const { createElement: el } = await import('react'); return { SafeAreaView: ({ children }: any) => el('div', {}, children) }; });
vi.mock('@/components/AppText', () => ({ Text: 'span' }));
vi.mock('@/components/RemoteCompanionAvatar', () => ({ RemoteCompanionAvatar: () => null }));
+vi.mock('@/session/CompanionProfileSheet', async () => {
+ const { createElement: el } = await import('react');
+ return { CompanionProfileSheet: ({ visible, resource, onClose, onClosed, onOpenSearch }: any) => visible
+ ? el('div', {}, el('button', { 'data-testid': 'profile-settings', onClick: () => { onClose(); onClosed(); } }, resource.ref.id), onOpenSearch ? el('button', { 'data-testid': 'profile-history', onClick: () => { onOpenSearch(); onClosed(); } }, 'History') : null)
+ : null };
+});
vi.mock('@/components/MobilePrimitives', async () => {
const { createElement: el } = await import('react');
return { MainWindowEmptyState: ({ copy }: any) => el('span', {}, copy), MainWindowActionButton: ({ action }: any) => el('button', { onClick: action.onPress, 'data-testid': action.testID }, action.label) };
@@ -65,6 +72,18 @@ it('retries failed preparation through the advertised action without creating an
expect(h.action).toHaveBeenCalledWith(h.link.invoke, { deviceId: 'mac', deviceName: 'Mac' }, expect.objectContaining({ actionId: 'opaque-retry', resourceRef: resource('failed').ref }), 'en');
expect(container.textContent).toContain('devices.companions.invitation.skills');
});
+it.each(['welcome', 'failed'])('opens settings while preparation is %s and defers navigation until editing ends', async stage => {
+ h.read.mockResolvedValue(resource(stage));
+ await act(async () => root.render(createElement(Screen)));
+ await act(async () => container.querySelector<HTMLButtonElement>('[data-testid="remoteResourceResolver.settings"]')!.click());
+ expect(container.querySelector('[data-testid="profile-settings"]')?.textContent).toBe('bot-1');
+ h.read.mockResolvedValue(resource('ready'));
+ await act(async () => h.push!('mac', { collectionId: 'teammates' }));
+ expect(h.router.replace).not.toHaveBeenCalled();
+ await act(async () => container.querySelector<HTMLButtonElement>('[data-testid="profile-settings"]')!.click());
+ expect(h.router.replace).toHaveBeenCalledWith(expect.objectContaining({ pathname: '/sessions/[sessionId]' }));
+ expect(h.action).not.toHaveBeenCalled();
+});
it('ignores a late ready response from the previous account', async () => {
let finish!: (value: unknown) => void;
h.read.mockImplementationOnce(() => new Promise(resolve => { finish = resolve; })).mockResolvedValue(resource('failed'));
@@ -75,6 +94,20 @@ it('ignores a late ready response from the previous account', async () => {
expect(h.router.replace).not.toHaveBeenCalled();
expect(h.upsert).not.toHaveBeenCalled();
});
+it('keeps settings open when a ready chat finishes loading during a model edit', async () => {
+ h.read.mockResolvedValue(resource('failed'));
+ await act(async () => root.render(createElement(Screen)));
+ let finish!: (value: unknown) => void;
+ h.link.invoke.mockImplementationOnce(() => new Promise(resolve => { finish = resolve; }));
+ h.read.mockResolvedValue(resource('ready'));
+ await act(async () => h.push!('mac', { collectionId: 'teammates' }));
+ await act(async () => container.querySelector<HTMLButtonElement>('[data-testid="remoteResourceResolver.settings"]')!.click());
+ await act(async () => finish({ id: 'chat-1', source: 'bot' }));
+ expect(h.router.replace).not.toHaveBeenCalled();
+ expect(container.querySelector('[data-testid="profile-settings"]')).not.toBeNull();
+ await act(async () => container.querySelector<HTMLButtonElement>('[data-testid="profile-settings"]')!.click());
+ expect(h.router.replace).toHaveBeenCalledWith(expect.objectContaining({ pathname: '/sessions/[sessionId]' }));
+});
it('keeps a failed preparation on screen with an inline notice when its retry fails', async () => {
h.read.mockResolvedValue(resource('failed'));
h.action.mockRejectedValue(new Error('[DEVICE_UNRESPONSIVE] mac'));
@@ -101,3 +134,12 @@ it('redirects stale routine links without reading or subscribing to the host', a
expect(h.action).not.toHaveBeenCalled();
expect(h.link.onRemoteResourceChanged).not.toHaveBeenCalled();
});
+
+it('opens existing history after the failed teammate settings close', async () => {
+ h.read.mockResolvedValue({ ...resource('failed'), links: resource('ready').links });
+ await act(async () => root.render(createElement(Screen)));
+ await act(async () => (container.querySelector('[data-testid="remoteResourceResolver.settings"]') as HTMLButtonElement).click());
+ expect(h.router.push).not.toHaveBeenCalled();
+ await act(async () => (container.querySelector('[data-testid="profile-history"]') as HTMLButtonElement).click());
+ expect(h.router.push).toHaveBeenCalledWith(expect.objectContaining({ pathname: '/sessions/[sessionId]', params: expect.objectContaining({ sessionId: 'chat-1', deviceId: 'mac', openSearch: '1', openSearchRequest: 'history-request' }) }));
+});
diff --git a/apps/mobile/src/__tests__/useRemoteResourceSession.test.tsx b/apps/mobile/src/__tests__/useRemoteResourceSession.test.tsx
index 4310831d83..0f11432a85 100644
--- a/apps/mobile/src/__tests__/useRemoteResourceSession.test.tsx
+++ b/apps/mobile/src/__tests__/useRemoteResourceSession.test.tsx
@@ -10,7 +10,7 @@ const h = vi.hoisted(() => ({
get: vi.fn(),
language: "en", focused: true,
t: (key: string) => key, metadataVerified: true,
- resourceId: 'bot-1', sessionId: 'task-1',
+ resourceId: 'bot-1', sessionId: 'task-1', openSearch: '',
markRead: vi.fn(),
store: { getSessionDeviceId: vi.fn(), upsertDeviceSession: vi.fn() },
router: { replace: vi.fn(), setParams: vi.fn() },
@@ -24,7 +24,7 @@ vi.mock('expo-router', async () => {
return {
useIsFocused: () => h.focused,
useFocusEffect: (effect: () => void | (() => void)) => useEffect(() => h.focused ? effect() : undefined, [effect, h.focused]),
- useLocalSearchParams: () => ({ resourceCollectionId: 'teammates', resourceId: h.resourceId, resourceKind: 'bot' }),
+ useLocalSearchParams: () => ({ resourceCollectionId: 'teammates', resourceId: h.resourceId, resourceKind: 'bot', openSearch: h.openSearch }),
useRouter: () => h.router,
};
});
@@ -74,7 +74,7 @@ async function render(canMarkRead = false) {
// A viewport receipt is separate from loading/entering the chat.
result.markReadThrough(200);
}
-beforeEach(() => { vi.clearAllMocks(); h.auth.accountGeneration = 1; h.metadataVerified = true; h.focused = true; h.language = "en"; h.resourceId = 'bot-1'; h.sessionId = 'task-1'; h.link.status = 'online'; h.link.connectionEpoch = 1; h.store.getSessionDeviceId.mockReturnValue(undefined); });
+beforeEach(() => { vi.clearAllMocks(); h.openSearch = ''; h.auth.accountGeneration = 1; h.metadataVerified = true; h.focused = true; h.language = "en"; h.resourceId = 'bot-1'; h.sessionId = 'task-1'; h.link.status = 'online'; h.link.connectionEpoch = 1; h.store.getSessionDeviceId.mockReturnValue(undefined); });
afterEach(() => { act(() => root?.unmount()); root = undefined; });
describe('companion task visibility refresh', () => {
@@ -286,3 +286,51 @@ it('closes controls immediately on a resource push, keeps the title, and coalesc
expect(result.ready).toBe(true);
} finally { vi.useRealTimers(); }
});
+
+
+it.each(['failed', 'identity'])('keeps %s invitation history visible without enabling writes', async stage => {
+ h.openSearch = '1';
+ h.get.mockResolvedValue({
+ blocks: [{ id: 'invitation', primitive: 'status', data: { stage } }],
+ links: [{ rel: 'conversation', target: { kind: 'session', sessionId: 'task-1' } }],
+ display: { title: 'Recovering teammate', lastReplyAt: 200 },
+ });
+ await render(true);
+ expect(h.router.replace).not.toHaveBeenCalled();
+ expect(container.textContent).toBe('Recovering teammate');
+ expect(result.ready).toBe(false);
+ expect(h.markRead).not.toHaveBeenCalled();
+
+ // The same invitation still redirects on ordinary entry.
+ h.openSearch = '';
+ await render(true);
+ expect(h.router.replace).toHaveBeenCalledWith(expect.objectContaining({ pathname: '/resources/[collectionId]/[resourceId]' }));
+});
+
+it('validates the canonical task in failed invitation history and restores controls after recovery', async () => {
+ h.openSearch = '1';
+ const resource = {
+ blocks: [{ id: 'invitation', primitive: 'status', data: { stage: 'failed' } }],
+ links: [{ rel: 'conversation', target: { kind: 'session', sessionId: 'task-2' } }],
+ display: { title: 'Recovering teammate' },
+ };
+ h.get.mockResolvedValue(resource);
+ h.link.invoke.mockResolvedValue({ id: 'task-2', source: 'bot' });
+ await render();
+ expect(h.router.setParams).toHaveBeenCalledWith({ sessionId: 'task-2' });
+ expect(result.ready).toBe(false);
+ h.sessionId = 'task-2';
+ await render();
+ expect(result.ready).toBe(false);
+ h.get.mockResolvedValue({ ...resource, blocks: [{ id: 'invitation', primitive: 'status', data: { stage: 'ready' } }] });
+ await act(async () => result.retry());
+ expect(result.ready).toBe(true);
+});
+
+it('still leaves failed invitation history when the host revokes the resource', async () => {
+ h.openSearch = '1';
+ h.get.mockRejectedValue(new Error('[NOT_FOUND] resource missing'));
+ await render();
+ expect(result.ready).toBe(false);
+ expect(h.router.replace).toHaveBeenCalledWith(expect.objectContaining({ pathname: '/resources/[collectionId]/[resourceId]' }));
+});
diff --git a/apps/mobile/src/__tests__/useSessionHistorySearch.test.tsx b/apps/mobile/src/__tests__/useSessionHistorySearch.test.tsx
new file mode 100644
index 0000000000..32047c82d5
--- /dev/null
+++ b/apps/mobile/src/__tests__/useSessionHistorySearch.test.tsx
@@ -0,0 +1,27 @@
+// @vitest-environment jsdom
+import { act, createElement } from 'react';
+import { createRoot } from 'react-dom/client';
+import { expect, it } from 'vitest';
+import { useSessionHistorySearch } from '@/session/useSessionHistorySearch';
+
+Object.assign(globalThis, { IS_REACT_ACT_ENVIRONMENT: true });
+it('opens on reused-route requests without reopening a dismissed request', async () => {
+ const root = createRoot(document.createElement('div'));
+ let result!: ReturnType<typeof useSessionHistorySearch>;
+ function Probe({ open, request }: { open: string | null; request: string | null }) {
+ result = useSessionHistorySearch(open, request);
+ return null;
+ }
+ const render = async (open: string | null, request: string | null) => {
+ await act(async () => root.render(createElement(Probe, { open, request })));
+ };
+ try {
+ await render(null, null); expect(result[0]).toBe(false);
+ await render('1', 'first'); expect(result[0]).toBe(true);
+ await act(async () => result[1](false));
+ await render('1', 'first'); expect(result[0]).toBe(false);
+ await render('1', 'second'); expect(result[0]).toBe(true);
+ await act(async () => result[1](false));
+ await render('1', 'second'); expect(result[0]).toBe(false);
+ } finally { await act(async () => root.unmount()); }
+});
diff --git a/apps/mobile/src/session/CompanionCreateNativeView.ios.tsx b/apps/mobile/src/session/CompanionCreateNativeView.ios.tsx
index ee8022302b..ba9804130b 100644
--- a/apps/mobile/src/session/CompanionCreateNativeView.ios.tsx
+++ b/apps/mobile/src/session/CompanionCreateNativeView.ios.tsx
@@ -21,10 +21,11 @@ export function CompanionCreateNativeView(p: CompanionCreateNativeViewProps) {
{p.panel ? <>
<Section title={tr('name')}><TextField text={state} onTextChange={name => p.onChange({ ...p.values, name })} maxLength={200} testID="companionCreate.name" modifiers={[accessibilityLabel(tr('name')), disabled(p.busy || !p.online || !!p.locked)]} /></Section>
<Section title={tr('avatar')}><CompanionNativeContent><CompanionPortraitPicker value={String(p.values.avatarImageBase64 ?? '')} onChange={avatarImageBase64 => p.onChange({ ...p.values, avatarImageBase64 })} disabled={p.busy || !p.online || !!p.locked} /></CompanionNativeContent></Section>
+ {p.models ? <Section><CompanionNativeContent>{p.models}</CompanionNativeContent></Section> : null}
</> : null}
<Section>{!p.panel && !p.loading && p.online ? <Button onPress={p.onRetry} modifiers={[buttonStyle('plain'), disabled(p.busy), frame({ minHeight: 44 })]}><HStack modifiers={[frame({ maxWidth: Infinity, minHeight: 44 }), contentShape(shapes.rectangle())]}><Text>{t('devices.resources.retry')}</Text><Spacer /></HStack></Button> : null}
{p.onImport ? <Button onPress={p.onImport} modifiers={[buttonStyle('plain'), frame({ minHeight: 44 }), disabled(p.busy || !p.online || !!p.locked)]}><HStack modifiers={[frame({ maxWidth: Infinity, minHeight: 44 }), contentShape(shapes.rectangle())]}><Text>{t('devices.companionImport.entry')}</Text><Spacer /></HStack></Button> : null}
- <Button onPress={p.onSubmit} testID="companionCreate.submit" modifiers={[buttonStyle('plain'), frame({ minHeight: 44 }), disabled(p.busy || !p.online || !p.panel?.action || p.panel.action.disabled || !name.trim() || !p.values.avatarImageBase64 || !!p.duplicate)]}><HStack modifiers={[frame({ maxWidth: Infinity, minHeight: 44 }), contentShape(shapes.rectangle())]}><Text>{tr('create')}</Text><Spacer /></HStack></Button>
+ <Button onPress={p.onSubmit} testID="companionCreate.submit" modifiers={[buttonStyle('plain'), frame({ minHeight: 44 }), disabled(p.busy || !p.online || !p.panel?.action || p.panel.action.disabled || !name.trim() || !p.values.avatarImageBase64 || !!p.duplicate || !!p.modelMissing)]}><HStack modifiers={[frame({ maxWidth: Infinity, minHeight: 44 }), contentShape(shapes.rectangle())]}><Text>{tr('create')}</Text><Spacer /></HStack></Button>
<Button onPress={p.onClose} modifiers={[buttonStyle('plain'), frame({ minHeight: 44 }), disabled(p.busy)]}><HStack modifiers={[frame({ maxWidth: Infinity, minHeight: 44 }), contentShape(shapes.rectangle())]}><Text>{t('devices.common.cancel')}</Text><Spacer /></HStack></Button>
</Section>
</ComposerSheet>;
diff --git a/apps/mobile/src/session/CompanionCreateNativeView.tsx b/apps/mobile/src/session/CompanionCreateNativeView.tsx
index a9edd13a1e..8dec4b7964 100644
--- a/apps/mobile/src/session/CompanionCreateNativeView.tsx
+++ b/apps/mobile/src/session/CompanionCreateNativeView.tsx
@@ -1,11 +1,13 @@
import type { ProfilePanel, ProfileValues } from './companionProfileData';
export interface CompanionCreateNativeViewProps {
+ models?: import('react').ReactNode;
onImport?(): void;
deviceName: string; nameTaken: boolean; visible: boolean; onClose(): void; onClosed?(): void; panel?: ProfilePanel;
values: ProfileValues; onChange(values: ProfileValues): void; onSubmit(): void; onRetry(): void;
online: boolean; busy: boolean; loading: boolean; error: boolean; dirty: boolean;
/** The typed name already belongs to a teammate on this computer (NFKC, case-insensitive). */
duplicate?: boolean;
+ modelMissing?: boolean;
/** The last create is unconfirmed; the retry resends exactly what was sent. */
locked?: boolean;
}
diff --git a/apps/mobile/src/session/CompanionProfileNativeView.ios.tsx b/apps/mobile/src/session/CompanionProfileNativeView.ios.tsx
index ccf42f1330..271a1afad1 100644
--- a/apps/mobile/src/session/CompanionProfileNativeView.ios.tsx
+++ b/apps/mobile/src/session/CompanionProfileNativeView.ios.tsx
@@ -57,7 +57,7 @@ export function CompanionProfileNativeView(p: CompanionProfileNativeViewProps) {
<Text modifiers={[font({ textStyle: 'headline' }), lineLimit(2)]}>{p.name}</Text><Spacer />
</HStack></Section>
<Section>{row('profile', 'person.crop.circle')}{row('memory', 'brain')}{row('models', 'slider.horizontal.3')}{row('skills', 'sparkles')}</Section>
- <Section>{row('artifacts', 'doc.text')}{row('search', 'magnifyingglass', p.onSearch)}{row('permissions', 'hand.raised')}</Section>
+ <Section>{row('artifacts', 'doc.text')}{p.onSearch ? row('search', 'magnifyingglass', p.onSearch) : null}{row('permissions', 'hand.raised')}</Section>
<Section>{p.data?.panels.filter(item => ['restart', 'resume', 'delete'].includes(item.id) && item.action).map(item => <Button key={item.id} onPress={() => p.onConfirm(item)} modifiers={[buttonStyle('plain'), listRowInsets({ top: 4, bottom: 4, leading: 16, trailing: 16 }), disabled(p.busy || !p.online), frame({ minHeight: 44 }), ...(item.id === 'delete' ? [foregroundStyle(colors.destructive)] : [])]}><HStack modifiers={[frame({ maxWidth: Infinity, minHeight: 44 }), contentShape(shapes.rectangle())]}><Text>{label(item.action!.label)}</Text><Spacer /></HStack></Button>)}</Section>
{/* Same as Android: a host without the settings forms asks for a Cindy update on that computer. */}
{p.online && p.data && !p.data.panels.some(item => item.id === 'profile') ? note(tr('hostUpgrade')) : null}
diff --git a/apps/mobile/src/session/CompanionProfileNativeView.tsx b/apps/mobile/src/session/CompanionProfileNativeView.tsx
index 0f82bfcfb6..493380cbc3 100644
--- a/apps/mobile/src/session/CompanionProfileNativeView.tsx
+++ b/apps/mobile/src/session/CompanionProfileNativeView.tsx
@@ -13,7 +13,7 @@ export interface CompanionProfileNativeViewProps {
onChange(values: ProfileValues): void; onSubmit(panel: ProfilePanel, confirmed?: boolean): void;
onConfirm(panel: ProfilePanel | null): void; onRetry(): void; onDiscard(reload: boolean): void;
onEditor(resourceId: string): void; onEditorPanel(panel: ProfilePanel): void;
- onSearch(): void;
+ onSearch?(): void;
}
// SwiftUI is isolated from Android's bundle. The shared component owns all draft/save logic.
export function CompanionProfileNativeView(_props: CompanionProfileNativeViewProps) { return null; }
diff --git a/apps/mobile/src/session/CompanionProfileSheet.tsx b/apps/mobile/src/session/CompanionProfileSheet.tsx
index c37f177172..c597ef8c44 100644
--- a/apps/mobile/src/session/CompanionProfileSheet.tsx
+++ b/apps/mobile/src/session/CompanionProfileSheet.tsx
@@ -45,7 +45,7 @@ export interface CompanionProfileSheetProps {
deviceName: string;
online: boolean;
onDeleted?: () => void;
- onOpenSearch: () => void;
+ onOpenSearch?: () => void;
}
/** Identity-keyed content prevents previous-account drafts and reads from surviving a switch. */
export function CompanionProfileSheet(props: CompanionProfileSheetProps) {
@@ -380,7 +380,7 @@ function CompanionProfileSheetContent(props: CompanionProfileSheetProps) {
<Text accessibilityRole="header" numberOfLines={2} style={styles.name}>{name}</Text>
</View>
<View style={styles.group}>{row('profile', Info)}{row('memory', Brain)}{row('models', Sparkles)}{row('skills', Settings2)}</View>
- <View style={styles.group}>{row('artifacts', FileText)}{row('search', History, onOpenSearch)}{row('permissions', Hand)}</View>
+ <View style={styles.group}>{row('artifacts', FileText)}{onOpenSearch ? row('search', History, onOpenSearch) : null}{row('permissions', Hand)}</View>
{/* Host order, like iOS: restart / resume / delete are whatever the computer offers now. */}
{management.length ? <View style={styles.group}>{management.map(item => actionRow(item, () => confirm(item), item.id === 'delete'))}</View> : null}
{online && data && !actionPanel('profile') ? note('hostUpgrade') : null}
@@ -438,10 +438,12 @@ function CompanionCreateSheetContent({ visible, onClose, onClosed, deviceId, dev
const { t, i18n } = useTranslation();
const styles = useThemedStyles(makeStyles);
const { colors } = useTheme();
+ const [modelStage, setModelStage] = useState<'form' | 'closing-form' | 'picker' | 'closing-picker'>('form');
+ const [modelValues, setModelValues] = useState<ProfileValues>({ followsDefault: true, modelChain: '[]' });
const [importing, setImporting] = useState(false);
const [openingImport, setOpeningImport] = useState(false);
const openImport = () => setOpeningImport(true);
- const creationClosed = () => { if (openingImport) { setOpeningImport(false); setImporting(true); } else onClosed?.(); };
+ const creationClosed = () => { if (modelStage === 'closing-form') { setModelStage('picker'); return; } if (openingImport) { setOpeningImport(false); setImporting(true); } else onClosed?.(); };
const [data, setData] = useState<CompanionProfileData | null>(null);
const [values, setValues] = useState<ProfileValues>({ name: '', avatarImageBase64: '' });
const [loading, setLoading] = useState(false);
@@ -473,19 +475,26 @@ function CompanionCreateSheetContent({ visible, onClose, onClosed, deviceId, dev
try {
await openLink(deviceId);
const next = await loadCompanionProfile(invoke, deviceId, ref, i18n.language);
- if (current.current === sequence) setData(next);
+ if (current.current === sequence) {
+ setData(next);
+ setModelValues(previous => previous.followsDefault === true && !unconfirmed
+ ? { ...previous, modelChain: next.panels[0]?.creationModelChain ?? '[]' } : previous);
+ }
} catch { if (current.current === sequence) setError(true); }
finally { if (current.current === sequence) setLoading(false); }
};
useEffect(() => {
- if (visible) { setImporting(false); setOpeningImport(false); requestId.current = null; setPortraitChanged(false); setNameTaken(false); setUnconfirmed(false); setValues({ name: '', avatarImageBase64: randomCompanionPortrait() }); }
+ if (visible) { setModelStage('form'); setModelValues({ followsDefault: true, modelChain: '[]' }); setImporting(false); setOpeningImport(false); requestId.current = null; setPortraitChanged(false); setNameTaken(false); setUnconfirmed(false); setValues({ name: '', avatarImageBase64: randomCompanionPortrait() }); }
}, [visible]);
useEffect(() => {
setData(null); setError(false);
if (visible && online) void reload();
return () => { current.current++; };
}, [visible, online, deviceId, collectionId]);
- const dirty = !!String(values.name ?? '').trim() || portraitChanged;
+ const supportsModel = typeof data?.panels[0]?.creationModelChain === 'string';
+ const modelChain = readCompanionModelChain(modelValues.modelChain);
+ const modelMissing = supportsModel && !modelChain.length;
+ const dirty = !!String(values.name ?? '').trim() || portraitChanged || modelValues.followsDefault !== true;
const change = (next: ProfileValues) => { if (unconfirmed) return; if (next.avatarImageBase64 !== values.avatarImageBase64) setPortraitChanged(true); setValues(next); };
const close = () => {
if (inFlight.current) return;
@@ -497,12 +506,12 @@ function CompanionCreateSheetContent({ visible, onClose, onClosed, deviceId, dev
};
const submit = async () => {
const panel = data?.panels[0];
- if (!panel?.action || panel.action.disabled || inFlight.current || !online || duplicate) return;
+ if (!panel?.action || panel.action.disabled || inFlight.current || !online || duplicate || modelMissing) return;
inFlight.current = true; setBusy(true); setError(false); setNameTaken(false);
const sequence = current.current;
try {
requestId.current ??= randomUUID();
- const response = await invokeRemoteResourceAction(invoke, { deviceId, deviceName }, { collectionId, resourceRef: ref, actionId: panel.action.id, input: { ...values, requestId: requestId.current } }, i18n.language);
+ const response = await invokeRemoteResourceAction(invoke, { deviceId, deviceName }, { collectionId, resourceRef: ref, actionId: panel.action.id, input: { ...values, ...(supportsModel && modelValues.followsDefault !== true ? { modelChain: modelValues.modelChain } : {}), requestId: requestId.current } }, i18n.language);
if (current.current !== sequence) return;
const navigation = response.effects.find(effect => effect.kind === 'navigate' && effect.target.kind === 'resource');
if (navigation?.kind !== 'navigate' || navigation.target.kind !== 'resource') throw new Error('Creation receipt missing');
@@ -522,24 +531,31 @@ function CompanionCreateSheetContent({ visible, onClose, onClosed, deviceId, dev
setBusy(false);
}
};
+ const models = supportsModel ? <CompanionModelChain single deviceId={deviceId} values={modelValues}
+ disabled={busy || !online || unconfirmed} onChange={next => { if (!unconfirmed) setModelValues(next); }}
+ onPick={() => setModelStage('closing-form')} /> : null;
+ const modelPicker = <CompanionModelPicker visible={visible && modelStage === 'picker'} deviceId={deviceId} route={modelChain[0]}
+ onClose={() => setModelStage('closing-picker')} onClosed={() => setModelStage('form')}
+ onSelect={route => { setModelValues({ followsDefault: false, modelChain: JSON.stringify([route]) }); return true; }} />;
if (importing) return <CompanionImportSheet visible={visible} onClose={onClose} onClosed={onClosed} deviceId={deviceId} deviceName={deviceName} online={online} onCreated={onCreated} />;
- if (Platform.OS === 'ios') return <CompanionCreateNativeView onImport={data?.resource.actions?.some(action => action.id === 'open-agent-import') ? openImport : undefined} deviceName={deviceName} nameTaken={nameTaken} duplicate={duplicate} locked={unconfirmed} visible={visible && !openingImport} onClose={close} onClosed={creationClosed} panel={data?.panels[0]} values={values} onChange={change} onSubmit={() => void submit()} onRetry={() => void reload()} online={online} busy={busy} loading={loading} error={error} dirty={dirty} />;
+ if (Platform.OS === 'ios') return <>{modelPicker}<CompanionCreateNativeView models={models} modelMissing={modelMissing} onImport={data?.resource.actions?.some(action => action.id === 'open-agent-import') ? openImport : undefined} deviceName={deviceName} nameTaken={nameTaken} duplicate={duplicate} locked={unconfirmed} visible={visible && !openingImport && modelStage === 'form'} onClose={close} onClosed={creationClosed} panel={data?.panels[0]} values={values} onChange={change} onSubmit={() => void submit()} onRetry={() => void reload()} online={online} busy={busy} loading={loading} error={error} dirty={dirty} /></>;
const panel = data?.panels[0];
const notice = !online ? t('devices.companionProfile.offline', { deviceName }) : error || duplicate ? t(duplicate || nameTaken ? 'devices.companionProfile.nameTaken' : 'devices.companionProfile.createFailed') : null;
// Same gate as iOS: a live, enabled host action, a name and a portrait.
- const blocked = busy || !online || !panel?.action || !!panel.action.disabled || typeof values.name !== 'string' || !values.name.trim() || !values.avatarImageBase64 || duplicate;
- return <CompanionSheet visible={visible && !openingImport} onClose={close} onClosed={creationClosed} preventDismiss={dirty || busy} title={t('devices.companionProfile.create')}>
+ const blocked = busy || !online || !panel?.action || !!panel.action.disabled || typeof values.name !== 'string' || !values.name.trim() || !values.avatarImageBase64 || duplicate || modelMissing;
+ return <>{modelPicker}<CompanionSheet visible={visible && !openingImport && modelStage === 'form'} onClose={close} onClosed={creationClosed} preventDismiss={dirty || busy} title={t('devices.companionProfile.create')}>
<View style={styles.content}>
{notice ? <Text accessibilityRole={online ? 'alert' : undefined} style={styles.note}>{notice}</Text> : null}
{loading ? <ActivityIndicator accessibilityLabel={t('devices.resources.loading')} color={colors.textSecondary} style={styles.spinner} /> : null}
{panel ? <CompanionProfileForm panel={panel} values={values} onChange={change} disabled={busy || !online || unconfirmed} /> : null}
+ {models}
{!panel && online && !loading ? <MainWindowActionButton action={{ label: t('devices.resources.retry'), disabled: busy, onPress: () => void reload() }} /> : null}
{data?.resource.actions?.some(action => action.id === 'open-agent-import') ? <MainWindowActionButton action={{ label: t('devices.companionImport.entry'), disabled: busy || !online || unconfirmed, onPress: openImport }} /> : null}
<MainWindowActionButton action={{ label: t('devices.companionProfile.create'), busy, disabled: blocked, onPress: () => void submit() }} />
{/* The explicit exit while a draft blocks dismissal; `close` still asks before discarding. */}
<MainWindowActionButton action={{ label: t('devices.common.cancel'), disabled: busy, onPress: close }} />
</View>
- </CompanionSheet>;
+ </CompanionSheet></>;
}
/**
diff --git a/apps/mobile/src/session/companionProfileData.ts b/apps/mobile/src/session/companionProfileData.ts
index 818bb176a1..105e998bea 100644
--- a/apps/mobile/src/session/companionProfileData.ts
+++ b/apps/mobile/src/session/companionProfileData.ts
@@ -9,6 +9,8 @@ export interface ProfilePanel {
action?: RemoteActionDescriptor;
values: ProfileValues;
followsDefault?: boolean;
+ /** Optional creation capability; older hosts omit it. */
+ creationModelChain?: string;
title?: RemoteText;
entries?: Array<{ id: string; title: RemoteText; resourceId: string; subtitle?: RemoteText; timestamp?: number }>;
portraits?: Array<{ value: string; uri: string }>;
@@ -93,6 +95,7 @@ export function parseCompanionProfileData(raw: unknown, ref: RemoteResourceRef):
? [{ value: portrait.value, uri: portrait.uri }] : [];
}) : undefined;
panels.push({ id: block.id, text: block.fallbackMarkdown, action: formAction, values, entries, portraits,
+ ...(block.id === 'create' && string(payload?.creationModelChain, 4000) ? { creationModelChain: payload.creationModelChain as string } : {}),
...(string(block.primitive, 64) ? { primitive: block.primitive } : {}),
...(Number.isSafeInteger(payload?.count) && Number(payload?.count) >= 0 ? { count: Number(payload?.count) } : {}),
...(block.primitive === 'search' && string(payload?.query, 1_000) ? { query: payload?.query as string } : {}),
diff --git a/apps/mobile/src/session/useRemoteResourceSession.ts b/apps/mobile/src/session/useRemoteResourceSession.ts
index f59b2b3990..96700aca6a 100644
--- a/apps/mobile/src/session/useRemoteResourceSession.ts
+++ b/apps/mobile/src/session/useRemoteResourceSession.ts
@@ -15,16 +15,17 @@ import type { RemoteSession } from './types';
/** Follow a companion's current host-owned task on focus/reconnect, retaining its permanent identity. */
export function useRemoteResourceSession(deviceId: string, deviceName: string, sessionId: string, canMarkRead: boolean, metadataVerified = false) {
- const params = useLocalSearchParams<{ resourceCollectionId?: string; resourceId?: string; resourceKind?: string }>();
+ const params = useLocalSearchParams<{ resourceCollectionId?: string; resourceId?: string; resourceKind?: string; openSearch?: string }>();
const collectionId = typeof params.resourceCollectionId === 'string' ? params.resourceCollectionId : '';
const resourceId = typeof params.resourceId === 'string' ? params.resourceId : '';
const resourceKind = typeof params.resourceKind === 'string' ? params.resourceKind : '';
+ const historyEntry = params.openSearch === '1';
const { invoke, connectionEpoch, status, onRemoteResourceChanged, subscribe, unsubscribe } = useDeviceLink();
const { user, accountGeneration } = useAuth();
const { t, i18n } = useTranslation();
const router = useRouter();
const focused = useIsFocused();
- const identity = JSON.stringify([accountGeneration, deviceId, sessionId, collectionId, resourceKind, resourceId]);
+ const identity = JSON.stringify([accountGeneration, deviceId, sessionId, collectionId, resourceKind, resourceId, historyEntry]);
const [display, setDisplay] = useState<{ identity: string; resource: RemoteResource } | null>(null);
const binding = JSON.stringify([identity, connectionEpoch, i18n.language]);
const current = useRef(binding); current.current = binding;
@@ -59,7 +60,8 @@ export function useRemoteResourceSession(deviceId: string, deviceName: string, s
setDisplay({ identity, resource });
setFailure(null);
const stage = (resource.blocks?.find(block => block.id === 'invitation' && block.primitive === 'status')?.data as { stage?: string } | undefined)?.stage;
- if (stage && stage !== 'ready') {
+ const invitationPending = !!stage && stage !== 'ready';
+ if (invitationPending && !historyEntry) {
setVerified(null);
router.replace({ pathname: '/resources/[collectionId]/[resourceId]', params: {
collectionId, resourceId, resourceKind, deviceId, deviceName,
@@ -79,7 +81,9 @@ export function useRemoteResourceSession(deviceId: string, deviceName: string, s
router.setParams({ sessionId: session.id });
return; // The replacement task must mount and finish its own message sync first.
}
- setVerified(binding);
+ // History remains visible during preparation, but must not enable the
+ // composer, realtime controls or queued sends until the invitation is ready.
+ setVerified(invitationPending ? null : binding);
} catch (error) {
if (!valid()) return;
setVerified(null);
@@ -107,6 +111,6 @@ export function useRemoteResourceSession(deviceId: string, deviceName: string, s
const appState = AppState.addEventListener('change', (state) => { generation += 1; setVerified(null); if (state === 'active') void load(); });
void load();
return () => { disposed = true; setVerified(null); offPush(); offTopic(); appState.remove(); if (timer) clearTimeout(timer); };
- }, [attempt, binding, collectionId, deviceId, deviceName, identity, invoke, i18n.language, onRemoteResourceChanged, resourceId, resourceKind, router, sessionId, status, subscribe, t, unsubscribe, user?.id]));
+ }, [attempt, binding, historyEntry, collectionId, deviceId, deviceName, identity, invoke, i18n.language, onRemoteResourceChanged, resourceId, resourceKind, router, sessionId, status, subscribe, t, unsubscribe, user?.id]));
return { resource, ready, markReadThrough, error: failure?.binding === binding ? failure.message : null, retry };
}
diff --git a/apps/mobile/src/session/useSessionHistorySearch.ts b/apps/mobile/src/session/useSessionHistorySearch.ts
new file mode 100644
index 0000000000..b90223ffc7
--- /dev/null
+++ b/apps/mobile/src/session/useSessionHistorySearch.ts
@@ -0,0 +1,11 @@
+import { useEffect, useState } from 'react';
+
+/** A new navigation request opens search even when the task screen is reused. */
+export function useSessionHistorySearch(openSearch: string | null, request: string | null) {
+ const [searchOpen, setSearchOpen] = useState(openSearch === '1');
+ useEffect(() => {
+ if (openSearch === '1') setSearchOpen(true);
+ }, [openSearch, request]);
+ // Keep openSearch on the route: it also permits read-only invitation history.
+ return [searchOpen, setSearchOpen] as const;
+}
diff --git a/docs/assets/bot-model-recovery/create.png b/docs/assets/bot-model-recovery/create.png
new file mode 100644
index 0000000000..8476a68899
Binary files /dev/null and b/docs/assets/bot-model-recovery/create.png differ
diff --git a/docs/assets/bot-model-recovery/recovery.png b/docs/assets/bot-model-recovery/recovery.png
new file mode 100644
index 0000000000..7fa2bc97bf
Binary files /dev/null and b/docs/assets/bot-model-recovery/recovery.png differ
diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.md
index 679ec6a8f4..4ae43ab356 100644
--- a/docs/design-rules/design-inventory.md
+++ b/docs/design-rules/design-inventory.md
@@ -18,7 +18,7 @@
| `desktop.auth.add-account` | desktop | 添加账号 | hash `/add-account`(ProtectedRoute → AddAccountLoginPage) | AddAccountLoginPage | apps/desktop/src/renderer/components/login/AddAccountLoginPage.tsx, apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 |
| `desktop.auth.legacy-migration` | desktop | 首登数据迁移弹窗 | App 顶层挂载 LegacyMigrationDialog(仅主窗;main 检测到旧版 userData 经 `legacy-migration:state` 驱动) | LegacyMigrationDialog | apps/desktop/src/renderer/components/auth/LegacyMigrationDialog.tsx | 8 | 0 | 2 |
| `desktop.auth.login` | desktop | 登录页 | hash `/login`(GuestRoute → LoginPage) | LoginBrandStage, LoginCaptchaOverlay, LoginControls, LoginPage | apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 |
-| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊 / 群聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊、伙伴群聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentOnOtherDeviceContext.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageSourceLabels.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/markdownMedia.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useImageClipboard.ts, apps/desktop/src/renderer/components/chat/useImageLoadFailure.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotFollowMark.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotGroupAvatars.tsx, apps/desktop/src/renderer/features/bots/BotGroupChatView.tsx, apps/desktop/src/renderer/features/bots/BotGroupComposer.tsx, apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx, apps/desktop/src/renderer/features/bots/BotGroupPendingInteraction.tsx, apps/desktop/src/renderer/features/bots/BotGroupPlan.tsx, apps/desktop/src/renderer/features/bots/BotGroupRuntimeFailureNotice.tsx, apps/desktop/src/renderer/features/bots/BotGroupSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotGroupSidebarRow.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotImportForm.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLearningFooter.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskLink.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskResultCard.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotTaskCardHeader.tsx, apps/desktop/src/renderer/features/bots/BotTaskModelEditor.tsx, apps/desktop/src/renderer/features/bots/BotTodoList.tsx, apps/desktop/src/renderer/features/bots/BotWorkbench.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/ChatBotAccessField.tsx, apps/desktop/src/renderer/features/bots/ChatGroupSettings.tsx, apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsx, apps/desktop/src/renderer/features/bots/ChatInviteHost.tsx, apps/desktop/src/renderer/features/bots/ChatServerControls.tsx, apps/desktop/src/renderer/features/bots/ChatThreadPanel.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsx, apps/desktop/src/renderer/features/bots/WorkbenchSessionList.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botFollowScopes.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botGroupAttachments.ts, apps/desktop/src/renderer/features/bots/botGroupLane.ts, apps/desktop/src/renderer/features/bots/botGroupMentions.ts, apps/desktop/src/renderer/features/bots/botGroupPresentation.ts, apps/desktop/src/renderer/features/bots/botGroupStore.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botTodo.css, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/botWorkbenchProjection.ts, apps/desktop/src/renderer/features/bots/chatError.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotSettingsData.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useBotUnreadSync.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkbenchSessionPages.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 277 | 38 | 474 |
+| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊 / 群聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊、伙伴群聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentOnOtherDeviceContext.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageSourceLabels.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/markdownMedia.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useImageClipboard.ts, apps/desktop/src/renderer/components/chat/useImageLoadFailure.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotFollowMark.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotGroupAvatars.tsx, apps/desktop/src/renderer/features/bots/BotGroupChatView.tsx, apps/desktop/src/renderer/features/bots/BotGroupComposer.tsx, apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx, apps/desktop/src/renderer/features/bots/BotGroupPendingInteraction.tsx, apps/desktop/src/renderer/features/bots/BotGroupPlan.tsx, apps/desktop/src/renderer/features/bots/BotGroupRuntimeFailureNotice.tsx, apps/desktop/src/renderer/features/bots/BotGroupSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotGroupSidebarRow.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotImportForm.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLearningFooter.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskLink.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskResultCard.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotTaskCardHeader.tsx, apps/desktop/src/renderer/features/bots/BotTaskModelEditor.tsx, apps/desktop/src/renderer/features/bots/BotTodoList.tsx, apps/desktop/src/renderer/features/bots/BotWorkbench.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/ChatBotAccessField.tsx, apps/desktop/src/renderer/features/bots/ChatGroupSettings.tsx, apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsx, apps/desktop/src/renderer/features/bots/ChatInviteHost.tsx, apps/desktop/src/renderer/features/bots/ChatServerControls.tsx, apps/desktop/src/renderer/features/bots/ChatThreadPanel.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsx, apps/desktop/src/renderer/features/bots/WorkbenchSessionList.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botFollowScopes.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botGroupAttachments.ts, apps/desktop/src/renderer/features/bots/botGroupLane.ts, apps/desktop/src/renderer/features/bots/botGroupMentions.ts, apps/desktop/src/renderer/features/bots/botGroupPresentation.ts, apps/desktop/src/renderer/features/bots/botGroupStore.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botTodo.css, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/botWorkbenchProjection.ts, apps/desktop/src/renderer/features/bots/chatError.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotSettingsData.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useBotUnreadSync.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkbenchSessionPages.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 277 | 38 | 473 |
| `desktop.chat.files` | desktop | 工作目录文件浏览 | hash `/cc-agent/files/:sessionId`(WorkdirBrowseRoute) | FileBodyView, FileTreeView, WorkdirBrowseRoute | apps/desktop/src/renderer/features/cc-agent/workdir-browse/DocSearchBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/DrawioPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileBodyView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileFilterInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FilterResultList.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/ImagePreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/OpenInSystemActions.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/PdfPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/SessionTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/UnrenderablePlaceholder.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseRoute.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailCollapsed.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailResize.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useConfirmSwitchAwayIfDirty.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useDelayedFlag.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileContent.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useOpenTabs.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useProjectFileList.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useRevealFileInTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/activeFileBodyHandle.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/docModeSwitchProjects.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/drawioExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/expandedStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileContentCache.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileIcon.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileMeta.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileScrollStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileSelectionParams.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/filterFiles.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/imageExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/markdownAutosave.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/openTabsStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/pdfExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/selectedFileStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchPanel.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchResults.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/hooks/useProjectSearch.ts | 17 | 7 | 45 |
| `desktop.chat.new-draft` | desktop | 新建任务草稿页 | hash `/cc-agent/new`(NewMakerDraftRoute) | NewMakerDraftRoute | apps/desktop/src/renderer/features/cc-agent/NewMakerDraftRoute.tsx | 15 | 0 | 3 |
| `desktop.chat.orca-workflow` | desktop | Orca 协同工作台 | hash `/cc-agent/orca/:sessionId`(OrcaWorkflowRoute) | CCAgentSessionView, OrcaSplitView, OrcaWorkerPanel, OrcaWorkflowRoute | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentOnOtherDeviceContext.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageSourceLabels.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/markdownMedia.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useImageClipboard.ts, apps/desktop/src/renderer/components/chat/useImageLoadFailure.ts, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaSplitView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkflowRoute.tsx | 252 | 38 | 336 |
@@ -65,7 +65,7 @@
| `mobile.overlay.connection-startup` | mobile | 根布局挂载的启动与连接反馈 | app/_layout.tsx → StartupSplashOverlay / ConnectionNoticeProvider;各页面 ConnectionBanner | AdaptiveWindow, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ClipboardSharedTaskPrompt, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ConnectionNoticeProvider, ContextSheet, ContextSheet.ios, DeviceLinkContext, FoldTouchpad, HomeEntryProvider, IncomingShareBridge, MobileLoginHandoffContext, MobileLoginHandoffStage, MobileOutboxBridge, MobilePrimitives, NativeBottomSheet, NativeBottomSheet.android, NativeChromeBackButton.ios, NativeChromeButton.ios, NativePullDownMenu, NativeRemoteDesktopView, NativeResidentHistory, NativeSwitch, OutsideTap, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RecentMessageHistories, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, RemoteHistoryPrefetchBridge, ResidentHomeList, SharedTaskAdmissionDialog, SharedTaskScreen, SheetModal, SheetSurface, SimpleStackHeader, StartupSplashOverlay, ThemeProvider, _layout, gestureHandler, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/AdaptiveWindow.tsx, apps/mobile/src/platform/OutsideTap.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.android.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeChromeBackButton.ios.tsx, apps/mobile/src/platform/chrome/NativeChromeButton.ios.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/chrome/SimpleStackHeader.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/FoldTouchpad.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ClipboardSharedTaskPrompt.tsx, apps/mobile/src/session/ComposerNativeSection.ios.tsx, apps/mobile/src/session/ComposerNativeSection.tsx, apps/mobile/src/session/ComposerSheet.ios.tsx, apps/mobile/src/session/ComposerSheet.tsx, apps/mobile/src/session/ContextSheet.ios.tsx, apps/mobile/src/session/ContextSheet.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/MobileOutboxBridge.tsx, apps/mobile/src/session/NativeBottomSheet.android.tsx, apps/mobile/src/session/NativeBottomSheet.tsx, apps/mobile/src/session/NativeResidentHistory.tsx, apps/mobile/src/session/RecentMessageHistories.tsx, apps/mobile/src/session/RemoteHistoryPrefetchBridge.tsx, apps/mobile/src/session/ResidentHomeList.tsx, apps/mobile/src/session/SharedTaskAdmissionDialog.tsx, apps/mobile/src/session/SharedTaskScreen.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 214 | 55 |
| `mobile.plugins` | mobile | 插件目录、页面与原生交互 | app/plugins.tsx | AdaptiveWindow, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ClipboardSharedTaskPrompt, ComposerNativeRow, ComposerNativeRow.ios, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, DeviceLinkContext, FoldTouchpad, HomeEntryProvider, HomeHeaderGlassButton, HomeHeaderGlassButton.ios, HomeNativeStackHeader, HtmlBrowserChrome, HtmlBrowserChrome.ios, HtmlFileReader, HtmlWebsiteBrowser, ImageLightbox, IncomingShareBridge, MobileAgentMark, MobileAgentSwitcher, MobileLoginHandoffContext, MobileLoginHandoffStage, MobileModelPickerList, MobileModelPickerList.ios, MobileOutboxBridge, MobilePermissionPickerList, MobilePermissionPickerList.ios, MobilePrimitives, MobileProviderMark, ModelOptionsSheetView, ModelOptionsSheetView.ios, ModelPickerNativeHeader, ModelPickerNativeHeader.ios, ModelPickerSheet, NativeBottomSheet, NativeBottomSheet.android, NativeChromeBackButton.ios, NativeChromeButton.ios, NativePullDownMenu, NativeRemoteDesktopView, NativeResidentHistory, NativeSwitch, NativeVideoPlayer, OutsideTap, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PluginDetailView, PluginDetailView.ios, PluginDirectoryPicker, PluginDirectoryView, PluginDirectoryView.ios, PluginMediaViewer, PluginNativeIntent, PluginPage, PluginScheduleDraft, PluginTaskPicker, PluginTaskPickerView, PluginTaskPickerView.ios, PluginToolChips, PluginsScreen, PushNotificationsBridge, QuietSyncIndicator, RecentMessageHistories, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, RemoteHistoryPrefetchBridge, RemoteSourceMark, ResidentHomeList, SharedTaskAdmissionDialog, SharedTaskScreen, SheetModal, SheetSurface, SimpleStackHeader, StartupSplashOverlay, ThemeProvider, UnifiedModelPickerSheet, UnifiedModelPickerView, UnifiedModelPickerView.ios, _layout, gestureHandler, mediaPlayerWebView, peerFileTransport, plugins, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/plugins.tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileAgentMark.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/AdaptiveWindow.tsx, apps/mobile/src/platform/OutsideTap.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.android.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.tsx, apps/mobile/src/platform/chrome/HomeNativeStackHeader.tsx, apps/mobile/src/platform/chrome/NativeChromeBackButton.ios.tsx, apps/mobile/src/platform/chrome/NativeChromeButton.ios.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/chrome/SimpleStackHeader.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/plugins/PluginDetailView.ios.tsx, apps/mobile/src/plugins/PluginDetailView.tsx, apps/mobile/src/plugins/PluginDirectoryPicker.tsx, apps/mobile/src/plugins/PluginDirectoryView.ios.tsx, apps/mobile/src/plugins/PluginDirectoryView.tsx, apps/mobile/src/plugins/PluginMediaViewer.tsx, apps/mobile/src/plugins/PluginNativeIntent.tsx, apps/mobile/src/plugins/PluginPage.tsx, apps/mobile/src/plugins/PluginScheduleDraft.tsx, apps/mobile/src/plugins/PluginTaskPicker.tsx, apps/mobile/src/plugins/PluginTaskPickerView.ios.tsx, apps/mobile/src/plugins/PluginTaskPickerView.tsx, apps/mobile/src/plugins/PluginToolChips.tsx, apps/mobile/src/plugins/PluginsScreen.tsx, apps/mobile/src/plugins/pluginPageHtml.ts, apps/mobile/src/remote-desktop/FoldTouchpad.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ClipboardSharedTaskPrompt.tsx, apps/mobile/src/session/ComposerNativeRow.ios.tsx, apps/mobile/src/session/ComposerNativeRow.tsx, apps/mobile/src/session/ComposerNativeSection.ios.tsx, apps/mobile/src/session/ComposerNativeSection.tsx, apps/mobile/src/session/ComposerSheet.ios.tsx, apps/mobile/src/session/ComposerSheet.tsx, apps/mobile/src/session/ContextSheet.ios.tsx, apps/mobile/src/session/ContextSheet.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/HomeHeaderGlassButton.ios.tsx, apps/mobile/src/session/HomeHeaderGlassButton.tsx, apps/mobile/src/session/HtmlBrowserChrome.ios.tsx, apps/mobile/src/session/HtmlBrowserChrome.tsx, apps/mobile/src/session/HtmlFileReader.tsx, apps/mobile/src/session/HtmlWebsiteBrowser.tsx, apps/mobile/src/session/ImageLightbox.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/MobileAgentSwitcher.tsx, apps/mobile/src/session/MobileModelPickerList.ios.tsx, apps/mobile/src/session/MobileModelPickerList.tsx, apps/mobile/src/session/MobileOutboxBridge.tsx, apps/mobile/src/session/MobilePermissionPickerList.ios.tsx, apps/mobile/src/session/MobilePermissionPickerList.tsx, apps/mobile/src/session/MobileProviderMark.tsx, apps/mobile/src/session/ModelOptionsSheetView.ios.tsx, apps/mobile/src/session/ModelOptionsSheetView.tsx, apps/mobile/src/session/ModelPickerNativeHeader.ios.tsx, apps/mobile/src/session/ModelPickerNativeHeader.tsx, apps/mobile/src/session/ModelPickerSheet.tsx, apps/mobile/src/session/NativeBottomSheet.android.tsx, apps/mobile/src/session/NativeBottomSheet.tsx, apps/mobile/src/session/NativeResidentHistory.tsx, apps/mobile/src/session/NativeVideoPlayer.tsx, apps/mobile/src/session/RecentMessageHistories.tsx, apps/mobile/src/session/RemoteHistoryPrefetchBridge.tsx, apps/mobile/src/session/RemoteSourceMark.tsx, apps/mobile/src/session/ResidentHomeList.tsx, apps/mobile/src/session/SharedTaskAdmissionDialog.tsx, apps/mobile/src/session/SharedTaskScreen.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/session/UnifiedModelPickerSheet.tsx, apps/mobile/src/session/UnifiedModelPickerView.ios.tsx, apps/mobile/src/session/UnifiedModelPickerView.tsx, apps/mobile/src/session/mediaPlayerWebView.tsx, apps/mobile/src/session/mediaPlayerWebViewHtml.ts, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 251 | 88 |
| `mobile.remote-desktop` | mobile | 远程桌面 | app/devices/desktop/[deviceId].tsx | AdaptiveWindow, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ClipboardSharedTaskPrompt, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, DeviceLinkContext, FoldTouchpad, HomeEntryProvider, IncomingShareBridge, MobileLoginHandoffContext, MobileLoginHandoffStage, MobileOutboxBridge, MobilePrimitives, NativeBottomSheet, NativeBottomSheet.android, NativeChromeBackButton.ios, NativeChromeButton.ios, NativePullDownMenu, NativeRemoteDesktopView, NativeResidentHistory, NativeSwitch, OutsideTap, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RecentMessageHistories, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, RemoteHistoryPrefetchBridge, ResidentHomeList, SharedTaskAdmissionDialog, SharedTaskScreen, SheetModal, SheetSurface, SimpleStackHeader, StartupSplashOverlay, ThemeProvider, [deviceId], _layout, gestureHandler, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/devices/desktop/[deviceId].tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/AdaptiveWindow.tsx, apps/mobile/src/platform/OutsideTap.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.android.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeChromeBackButton.ios.tsx, apps/mobile/src/platform/chrome/NativeChromeButton.ios.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/chrome/SimpleStackHeader.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/FoldTouchpad.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ClipboardSharedTaskPrompt.tsx, apps/mobile/src/session/ComposerNativeSection.ios.tsx, apps/mobile/src/session/ComposerNativeSection.tsx, apps/mobile/src/session/ComposerSheet.ios.tsx, apps/mobile/src/session/ComposerSheet.tsx, apps/mobile/src/session/ContextSheet.ios.tsx, apps/mobile/src/session/ContextSheet.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/MobileOutboxBridge.tsx, apps/mobile/src/session/NativeBottomSheet.android.tsx, apps/mobile/src/session/NativeBottomSheet.tsx, apps/mobile/src/session/NativeResidentHistory.tsx, apps/mobile/src/session/RecentMessageHistories.tsx, apps/mobile/src/session/RemoteHistoryPrefetchBridge.tsx, apps/mobile/src/session/ResidentHomeList.tsx, apps/mobile/src/session/SharedTaskAdmissionDialog.tsx, apps/mobile/src/session/SharedTaskScreen.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 214 | 55 |
-| `mobile.resources` | mobile | 远程资源列表与详情 | app/resources/[collectionId].tsx / app/resources/[collectionId]/[resourceId].tsx | AdaptiveWindow, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ClipboardSharedTaskPrompt, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, DeviceLinkContext, FoldTouchpad, HomeEntryProvider, HomeHeaderGlassButton, HomeHeaderGlassButton.ios, HomeNativeStackHeader, IncomingShareBridge, MobileLoginHandoffContext, MobileLoginHandoffStage, MobileOutboxBridge, MobilePrimitives, NativeBottomSheet, NativeBottomSheet.android, NativeChromeBackButton.ios, NativeChromeButton.ios, NativePullDownMenu, NativeRemoteDesktopView, NativeResidentHistory, NativeSwitch, OutsideTap, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RecentMessageHistories, RemoteCompanionAvatar, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, RemoteHistoryPrefetchBridge, ResidentHomeList, SharedTaskAdmissionDialog, SharedTaskScreen, SheetModal, SheetSurface, SimpleStackHeader, StartupSplashOverlay, ThemeProvider, [collectionId], [resourceId], _layout, gestureHandler, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/resources/[collectionId].tsx, apps/mobile/app/resources/[collectionId]/[resourceId].tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/RemoteCompanionAvatar.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/AdaptiveWindow.tsx, apps/mobile/src/platform/OutsideTap.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.android.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.tsx, apps/mobile/src/platform/chrome/HomeNativeStackHeader.tsx, apps/mobile/src/platform/chrome/NativeChromeBackButton.ios.tsx, apps/mobile/src/platform/chrome/NativeChromeButton.ios.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/chrome/SimpleStackHeader.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/FoldTouchpad.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ClipboardSharedTaskPrompt.tsx, apps/mobile/src/session/ComposerNativeSection.ios.tsx, apps/mobile/src/session/ComposerNativeSection.tsx, apps/mobile/src/session/ComposerSheet.ios.tsx, apps/mobile/src/session/ComposerSheet.tsx, apps/mobile/src/session/ContextSheet.ios.tsx, apps/mobile/src/session/ContextSheet.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/HomeHeaderGlassButton.ios.tsx, apps/mobile/src/session/HomeHeaderGlassButton.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/MobileOutboxBridge.tsx, apps/mobile/src/session/NativeBottomSheet.android.tsx, apps/mobile/src/session/NativeBottomSheet.tsx, apps/mobile/src/session/NativeResidentHistory.tsx, apps/mobile/src/session/RecentMessageHistories.tsx, apps/mobile/src/session/RemoteHistoryPrefetchBridge.tsx, apps/mobile/src/session/ResidentHomeList.tsx, apps/mobile/src/session/SharedTaskAdmissionDialog.tsx, apps/mobile/src/session/SharedTaskScreen.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 214 | 62 |
+| `mobile.resources` | mobile | 远程资源列表与详情 | app/resources/[collectionId].tsx / app/resources/[collectionId]/[resourceId].tsx | AdaptiveWindow, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ClipboardSharedTaskPrompt, CompanionChoice, CompanionCreateNativeView, CompanionCreateNativeView.ios, CompanionImportSheet, CompanionMemoryPage, CompanionMemoryPage.ios, CompanionModelChain, CompanionNativeContent.ios, CompanionPortraitPicker, CompanionProfileArtifacts, CompanionProfileNativeView, CompanionProfileNativeView.ios, CompanionProfileSheet, CompanionSettingsRow, CompanionSettingsRow.ios, CompanionSheet, CompanionSheet.ios, ComposerNativeRow, ComposerNativeRow.ios, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, DeviceLinkContext, FoldTouchpad, HomeEntryProvider, HomeHeaderGlassButton, HomeHeaderGlassButton.ios, HomeNativeStackHeader, IncomingShareBridge, MobileAgentMark, MobileAgentSwitcher, MobileLoginHandoffContext, MobileLoginHandoffStage, MobileModelPickerList, MobileModelPickerList.ios, MobileOutboxBridge, MobilePermissionPickerList, MobilePermissionPickerList.ios, MobilePrimitives, MobileProviderMark, ModelOptionsSheetView, ModelOptionsSheetView.ios, ModelPickerNativeHeader, ModelPickerNativeHeader.ios, ModelPickerSheet, NativeBottomSheet, NativeBottomSheet.android, NativeChromeBackButton.ios, NativeChromeButton.ios, NativePullDownMenu, NativeRemoteDesktopView, NativeResidentHistory, NativeSwitch, OutsideTap, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RecentMessageHistories, RemoteCompanionAvatar, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, RemoteHistoryPrefetchBridge, RemoteSourceMark, ResidentHomeList, SharedTaskAdmissionDialog, SharedTaskScreen, SheetModal, SheetSurface, SimpleStackHeader, StartupSplashOverlay, ThemeProvider, UnifiedModelPickerSheet, UnifiedModelPickerView, UnifiedModelPickerView.ios, [collectionId], [resourceId], _layout, gestureHandler, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/resources/[collectionId].tsx, apps/mobile/app/resources/[collectionId]/[resourceId].tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileAgentMark.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/RemoteCompanionAvatar.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/AdaptiveWindow.tsx, apps/mobile/src/platform/OutsideTap.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.android.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.tsx, apps/mobile/src/platform/chrome/HomeNativeStackHeader.tsx, apps/mobile/src/platform/chrome/NativeChromeBackButton.ios.tsx, apps/mobile/src/platform/chrome/NativeChromeButton.ios.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/chrome/SimpleStackHeader.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/FoldTouchpad.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ClipboardSharedTaskPrompt.tsx, apps/mobile/src/session/CompanionChoice.tsx, apps/mobile/src/session/CompanionCreateNativeView.ios.tsx, apps/mobile/src/session/CompanionCreateNativeView.tsx, apps/mobile/src/session/CompanionImportSheet.tsx, apps/mobile/src/session/CompanionMemoryPage.ios.tsx, apps/mobile/src/session/CompanionMemoryPage.tsx, apps/mobile/src/session/CompanionModelChain.tsx, apps/mobile/src/session/CompanionNativeContent.ios.tsx, apps/mobile/src/session/CompanionPortraitPicker.tsx, apps/mobile/src/session/CompanionProfileArtifacts.tsx, apps/mobile/src/session/CompanionProfileNativeView.ios.tsx, apps/mobile/src/session/CompanionProfileNativeView.tsx, apps/mobile/src/session/CompanionProfileSheet.tsx, apps/mobile/src/session/CompanionSettingsRow.ios.tsx, apps/mobile/src/session/CompanionSettingsRow.tsx, apps/mobile/src/session/CompanionSheet.ios.tsx, apps/mobile/src/session/CompanionSheet.tsx, apps/mobile/src/session/ComposerNativeRow.ios.tsx, apps/mobile/src/session/ComposerNativeRow.tsx, apps/mobile/src/session/ComposerNativeSection.ios.tsx, apps/mobile/src/session/ComposerNativeSection.tsx, apps/mobile/src/session/ComposerSheet.ios.tsx, apps/mobile/src/session/ComposerSheet.tsx, apps/mobile/src/session/ContextSheet.ios.tsx, apps/mobile/src/session/ContextSheet.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/HomeHeaderGlassButton.ios.tsx, apps/mobile/src/session/HomeHeaderGlassButton.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/MobileAgentSwitcher.tsx, apps/mobile/src/session/MobileModelPickerList.ios.tsx, apps/mobile/src/session/MobileModelPickerList.tsx, apps/mobile/src/session/MobileOutboxBridge.tsx, apps/mobile/src/session/MobilePermissionPickerList.ios.tsx, apps/mobile/src/session/MobilePermissionPickerList.tsx, apps/mobile/src/session/MobileProviderMark.tsx, apps/mobile/src/session/ModelOptionsSheetView.ios.tsx, apps/mobile/src/session/ModelOptionsSheetView.tsx, apps/mobile/src/session/ModelPickerNativeHeader.ios.tsx, apps/mobile/src/session/ModelPickerNativeHeader.tsx, apps/mobile/src/session/ModelPickerSheet.tsx, apps/mobile/src/session/NativeBottomSheet.android.tsx, apps/mobile/src/session/NativeBottomSheet.tsx, apps/mobile/src/session/NativeResidentHistory.tsx, apps/mobile/src/session/RecentMessageHistories.tsx, apps/mobile/src/session/RemoteHistoryPrefetchBridge.tsx, apps/mobile/src/session/RemoteSourceMark.tsx, apps/mobile/src/session/ResidentHomeList.tsx, apps/mobile/src/session/SharedTaskAdmissionDialog.tsx, apps/mobile/src/session/SharedTaskScreen.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/session/UnifiedModelPickerSheet.tsx, apps/mobile/src/session/UnifiedModelPickerView.ios.tsx, apps/mobile/src/session/UnifiedModelPickerView.tsx, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 214 | 82 |
| `mobile.settings` | mobile | 设置(含调试与日志上传可见入口) | app/settings.tsx / app/settings/device-name.tsx / app/settings/user-bubble.tsx / app/settings/voice-dictionary.tsx | AdaptiveWindow, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ClipboardSharedTaskPrompt, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, DeviceLinkContext, FoldTouchpad, HomeEntryProvider, HomeHeaderGlassButton, HomeHeaderGlassButton.ios, HomeNativeStackHeader, IncomingShareBridge, MobileChoicePickerList, MobileLoginHandoffContext, MobileLoginHandoffStage, MobileOutboxBridge, MobilePrimitives, MobileUserAvatar, NativeBottomSheet, NativeBottomSheet.android, NativeChromeBackButton.ios, NativeChromeButton.ios, NativePullDownMenu, NativeRemoteDesktopView, NativeResidentHistory, NativeSwitch, OutsideTap, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RecentMessageHistories, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, RemoteHistoryPrefetchBridge, ResidentHomeList, SettingsGroupRows, SharedTaskAdmissionDialog, SharedTaskScreen, SheetModal, SheetSurface, SimpleStackHeader, StartupSplashOverlay, ThemeProvider, UserBubbleHueSlider, UserBubblePage, UserBubblePage.ios, UserBubbleSettings, UserBubbleSettings.ios, _layout, device-name, gestureHandler, listDisclosureTransition, peerFileTransport, settings, useLocale, user-bubble, voice-dictionary | apps/mobile/app/_layout.tsx, apps/mobile/app/settings.tsx, apps/mobile/app/settings/device-name.tsx, apps/mobile/app/settings/user-bubble.tsx, apps/mobile/app/settings/voice-dictionary.tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/MobileUserAvatar.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/AdaptiveWindow.tsx, apps/mobile/src/platform/OutsideTap.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.android.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.tsx, apps/mobile/src/platform/chrome/HomeNativeStackHeader.tsx, apps/mobile/src/platform/chrome/NativeChromeBackButton.ios.tsx, apps/mobile/src/platform/chrome/NativeChromeButton.ios.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/chrome/SimpleStackHeader.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/FoldTouchpad.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ClipboardSharedTaskPrompt.tsx, apps/mobile/src/session/ComposerNativeSection.ios.tsx, apps/mobile/src/session/ComposerNativeSection.tsx, apps/mobile/src/session/ComposerSheet.ios.tsx, apps/mobile/src/session/ComposerSheet.tsx, apps/mobile/src/session/ContextSheet.ios.tsx, apps/mobile/src/session/ContextSheet.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/HomeHeaderGlassButton.ios.tsx, apps/mobile/src/session/HomeHeaderGlassButton.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/MobileChoicePickerList.tsx, apps/mobile/src/session/MobileOutboxBridge.tsx, apps/mobile/src/session/NativeBottomSheet.android.tsx, apps/mobile/src/session/NativeBottomSheet.tsx, apps/mobile/src/session/NativeResidentHistory.tsx, apps/mobile/src/session/RecentMessageHistories.tsx, apps/mobile/src/session/RemoteHistoryPrefetchBridge.tsx, apps/mobile/src/session/ResidentHomeList.tsx, apps/mobile/src/session/SettingsGroupRows.tsx, apps/mobile/src/session/SharedTaskAdmissionDialog.tsx, apps/mobile/src/session/SharedTaskScreen.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/session/listDisclosureTransition.tsx, apps/mobile/src/settings/UserBubbleHueSlider.tsx, apps/mobile/src/settings/UserBubblePage.ios.tsx, apps/mobile/src/settings/UserBubblePage.tsx, apps/mobile/src/settings/UserBubbleSettings.ios.tsx, apps/mobile/src/settings/UserBubbleSettings.tsx, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 214 | 71 |
### 生产路由覆盖
diff --git a/docs/dev-rules/protocol-compatibility.md b/docs/dev-rules/protocol-compatibility.md
index 49933b8d59..a6670a7482 100644
--- a/docs/dev-rules/protocol-compatibility.md
+++ b/docs/dev-rules/protocol-compatibility.md
@@ -1499,6 +1499,16 @@ Chat Server `/me` 追加 `capabilities.groupDiscussionParity: 1`。Desktop 只
去重需要两端更新。手机外部推送在执行端及远控 Desktop 的通知出口完成去重,手机无需新增协议处理;
移动列表继续原 phase/attention 语义。无需服务端、数据库 migration 或 Mobile fingerprint 改动。
+## 伙伴创建时选择模型
+
+伙伴 `create` 表单块在 data 追加可选 `creationModelChain` 元数据,表示支持创建选模并给出默认首选。
+旧端忽略该元数据,不会在通用表单中显示 JSON。新 Mobile 看到它才显示现有选择器;
+显式选择时动作输入追加 `modelChain`(单条既有 BotModelRoute 的 JSON),省略即跟随伙伴默认。
+选择不改全局默认。
+主机复用设置页的模型可用性验证;旧手机省略字段照常创建,新手机连接旧主机保留原创建流程。
+丢失回执后的重试仍沿用原 requestId 和原模型选择,不覆盖已创建伙伴。
+无新增 channel、权限、数据库 migration、服务端改动或原生 fingerprint 变化。
+
## 移动插件只读权限摘要
plugin-capabilities.data 可选追加 permissions(title/description 字符串数组),仅由 Host 从
diff --git a/docs/product-rules/cindy-bots-runtime.md b/docs/product-rules/cindy-bots-runtime.md
index 59e1174232..90def88396 100644
--- a/docs/product-rules/cindy-bots-runtime.md
+++ b/docs/product-rules/cindy-bots-runtime.md
@@ -161,9 +161,14 @@ harness + provider + model + effort + fastMode
已有“跟随默认”的伙伴继续读取当前有效链,不把历史创建时的型号当作显式覆盖。
未连接或没有可用默认组合时保持空值,不写入 GLM / Gateway 占位;伙伴创建和打开入口
复用客户端现有连接引导,配置完成后重新解析,不能创建没有模型的主任务。
-创建只收名字和头像,不设置独立模型或推荐候选链。已有连接但应用默认不可用时,明确提示并保留配置入口,
-由用户恢复应用默认后重试,不在创建表单恢复伙伴模型选择器。已创建伙伴的设置仍保留统一模型选择器,
-用户可显式配置自己的候选链;跟随默认的伙伴仍等待应用默认恢复,不能偷偷替换型号。
+创建表单显示名字、头像和当前模型,默认跟随伙伴默认配置,不写入独立覆盖。默认失效时,
+用户可以在表单内用统一模型选择器改选,保留已填写内容;显式选择只保存为新伙伴的候选链,
+不改变应用或其它伙伴的默认。Desktop 没有连接时沿用选择器的连接入口,不偷偷替换型号。
+Mobile 使用电脑端已连接的模型目录;目录为空时保持创建禁用,需先在电脑配置连接,
+再回到手机选择模型。手机选模器不提供远程供应商授权/配置入口。
+已创建伙伴的准备中或失败状态不得遮挡设置:模型页始终可进入,保留资料、记忆与历史;
+准备期间主进程不接受的姓名、简介和个性字段只读,不能留下无法保存的草稿堵住恢复入口;
+更换模型后重试必须先确认设置保存成功,再继续同一伙伴的邀请,不重复创建伙伴。
全局伙伴设置保存用户自定义的默认候选链。单个伙伴没有显式覆盖时跟随全局链;一旦用户在伙伴设置里调整,
该伙伴保存自己的链。全局链由主进程按当前数据 owner 持久化,并由所有 Session 创建与 fallback