Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
feat(bots): 云端伙伴:同一个伙伴、主力电脑与换电脑继续 (#5899)
Dashf2d51c62def2
diff --git a/AGENTS.md b/AGENTS.mdindex 2cb5af6fa8..5f250429ac 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -70,6 +70,9 @@`docs/product-rules/message-source.md`:界面标签与模型说明同源,两侧一起改。- 修改伙伴(Bot)的身份、Session 生命周期、模型 fallback、工作目录、Skill / MCP 装配、委派协作或伙伴设置前,必须先读 `docs/product-rules/cindy-bots-runtime.md`。+- 修改伙伴的跨电脑身份、主力电脑(登记、接管、交出、降级)、云端对话层与资料上传,或+ `apps/desktop/src/main/companion-cloud/`、Chat Server 的伙伴 actor/1:1 房间合同前,必须先读+ `docs/product-rules/cloud-companions.md`。- 新增或修改伙伴群聊的数据、发言编排、群专线 Session、分工(负责人、安排、分工 Session、群工作目录)、群聊界面或手机端群聊(`bot-groups` 远程资源、群推送深链)前,必须先读 `docs/product-rules/bot-group-chat.md`。- 新增或修改 `/review`、Reviewer 任务、成果快照、Finding 协议、复核入口、结果呈现或diff --git a/apps/desktop/src/main/companion-cloud/__tests__/control.test.ts b/apps/desktop/src/main/companion-cloud/__tests__/control.test.tsnew file mode 100644index 0000000000..9577147776--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/__tests__/control.test.ts@@ -0,0 +1,525 @@+import { afterEach, describe, expect, it, vi } from 'vitest';+import type { DeviceLinkDeviceView } from '../../../shared/deviceLinkIpc.js';+import { createCompanionHomeRegistry } from '../homes.js';+import { readTranscriptPage } from '../room.js';+import { startCompanionCloud, type CompanionCloudHost, type CompanionCloudRuntime, type CompanionRuntimeActor } from '../runtime.js';+import { fakeApi, fakeLocal, memoryState, rejection, type ApiHandler } from './fakes.js';++const ROOM = '10000000-0000-4000-8000-000000000001';+const device = (deviceId: string, extra: Partial<DeviceLinkDeviceView> = {}): DeviceLinkDeviceView => ({+ deviceId, name: deviceId, platform: 'darwin', appVersion: '1', lastSeenAt: null, online: true, busy: false,+ remoteControlEnabled: true, controlEnabled: true, isSelf: false, ...extra,+});++// A complete profile snapshot as the home uploads it.+const MIA = { name: 'Mia', description: '', soul: '', systemPrompt: '', user: '' };++let runtime: CompanionCloudRuntime | undefined;+afterEach(() => { runtime?.dispose(); runtime = undefined; });++function setup(options: { home: string | null; handler?: ApiHandler; devices?: DeviceLinkDeviceView[]; profiles?: string[];+ installationId?: string; probe?: (deviceId: string) => Promise<boolean>; values?: Array<{ key: string; value: unknown }>;+ readValues?: () => Promise<Array<{ key: string; value: unknown }>>; syncProfile?: (botId: string) => Promise<void>;+ turnActive?: () => boolean }) {+ const actors: CompanionRuntimeActor[] = [{ id: 'actor-1', kind: 'bot', externalId: 'bot_mia', name: 'Mia', avatar: null, homeDeviceId: options.home }];+ const { api, calls } = fakeApi(options.handler ?? ((route, method) => {+ // The home has uploaded the profile snapshot a take-over builds from.+ if (route === '/preferences') return method === 'GET' ? [{ key: 'companion.profile.v1', value: MIA, revision: 1 }] : { revision: 1 };+ if (route === '/conversations') return { id: ROOM };+ if (route.includes('/messages?')) return [];+ if (route.endsWith('/import')) return {};+ if (method === 'PATCH') return {};+ throw new Error(`unexpected ${method} ${route}`);+ }));+ const local = fakeLocal();+ const { state } = memoryState();+ const refresh = vi.fn(async () => undefined);+ const publish = vi.fn();+ const host: CompanionCloudHost = {+ homes: createCompanionHomeRegistry(), openState: () => state,+ readValues: options.readValues ?? (async () => options.values ?? [{ key: 'companion.profile.v1', value: { name: 'Mia' } }]),+ canonicalSession: async () => 'session-1', rowsAfter: async () => [], latestRows: async () => [],+ deliverToCanonical: async () => ({ ok: true }),+ materializer: local.host, listDevices: async () => options.devices ?? [],+ ...(options.installationId ? { installationId: () => options.installationId! } : {}),+ ...(options.probe ? { probeCompanionCloud: options.probe } : {}),+ ...(options.turnActive ? { isBotBusy: async () => options.turnActive!() } : {}),+ };+ runtime = startCompanionCloud({ api, host, endpoint: 'https://chat', humanActorId: 'human', selfDeviceId: 'desk', current: () => true,+ bots: () => actors.filter(a => a.homeDeviceId === 'desk' && !state.isDemoted(a.externalId)).map(a => ({ botId: a.externalId, actorId: a.id, name: a.name })),+ actors: () => actors, refresh, publish, ...(options.syncProfile ? { syncProfile: options.syncProfile } : {}) });+ return { runtime, actors, calls, local, state, refresh, publish };+}++describe('take over', () => {+ it('moves the home with compare-and-set, then builds the local companion', async () => {+ const t = setup({ home: 'laptop' });+ expect(await t.runtime.takeOver('bot_mia')).toEqual({ ok: true });+ expect(t.calls.find(call => call.method === 'PATCH')).toMatchObject({ route: '/actors/actor-1', data: { homeDeviceId: 'desk', expectedHomeDeviceId: 'laptop' } });+ expect(t.actors[0]!.homeDeviceId).toBe('desk');+ expect(t.local.host.createProfile).toHaveBeenCalledOnce();+ expect(t.publish).toHaveBeenCalled();+ });++ it('does not move the home while the cloud has no profile snapshot', async () => {+ const t = setup({ home: 'laptop', handler: (route, method) => {+ if (route === '/preferences' && method === 'GET') return [];+ return {};+ } });+ expect(await t.runtime.takeOver('bot_mia')).toEqual({ ok: false, code: 'FAILED' });+ expect(t.calls.some(call => call.method === 'PATCH')).toBe(false);+ expect(t.local.host.createProfile).not.toHaveBeenCalled();+ });++ it('does not move the home for an incomplete profile snapshot', async () => {+ const t = setup({ home: 'laptop', handler: (route, method) => {+ if (route === '/preferences' && method === 'GET') return [{ key: 'companion.profile.v1', value: { name: 'Mia' }, revision: 1 }];+ return {};+ } });+ expect(await t.runtime.takeOver('bot_mia')).toEqual({ ok: false, code: 'FAILED' });+ expect(t.calls.some(call => call.method === 'PATCH')).toBe(false);+ });++ it('returns the current home when another device won', async () => {+ const t = setup({ home: 'laptop', handler: (route, method) => {+ if (method === 'PATCH') throw rejection(409, 'HOME_DEVICE_CONFLICT', { homeDeviceId: 'tablet' });+ return route === '/preferences' ? [{ key: 'companion.profile.v1', value: MIA, revision: 1 }] : [];+ } });+ expect(await t.runtime.takeOver('bot_mia')).toEqual({ ok: false, code: 'HOME_CONFLICT', homeDeviceId: 'tablet' });+ expect(t.refresh).toHaveBeenCalled();+ expect(t.local.host.createProfile).not.toHaveBeenCalled();+ });++ it('reports an unreachable server as offline', async () => {+ const t = setup({ home: 'laptop', handler: () => { throw Object.assign(new Error('REQUEST_TIMEOUT')); } });+ expect(await t.runtime.takeOver('bot_mia')).toEqual({ ok: false, code: 'OFFLINE' });+ });++ it('still compares with the server when the cached home already says this computer', async () => {+ const t = setup({ home: 'desk' });+ expect(await t.runtime.takeOver('bot_mia')).toEqual({ ok: true });+ expect(t.calls.filter(call => call.method === 'PATCH').map(call => call.data)).toEqual([{ homeDeviceId: 'desk', expectedHomeDeviceId: 'desk' }]);+ });+});++describe('reconcile', () => {+ it('demotes a local copy whose home is another computer', () => {+ const t = setup({ home: 'laptop' });+ t.runtime.reconcile([{ id: 'bot_mia', status: 'active' }]);+ expect(t.state.isDemoted('bot_mia')).toBe(true);+ expect(t.local.host.createProfile).not.toHaveBeenCalled();+ });++ it('materializes a companion handed to this computer once, and not a companion deleted here', async () => {+ const t = setup({ home: 'desk' });+ t.local.setProfile({ status: 'active', displayName: 'Mia', description: '' });+ t.state.update('bot_mia', 'actor-1', entry => { entry.demoted = true; });+ t.runtime.reconcile([{ id: 'bot_mia', status: 'active' }]);+ t.runtime.reconcile([{ id: 'bot_mia', status: 'active' }]);+ await vi.waitFor(() => expect(t.state.isDemoted('bot_mia')).toBe(false));+ expect(t.local.host.updateProfile).toHaveBeenCalledOnce();+ t.runtime.dispose();++ const deleted = setup({ home: 'desk' });+ deleted.state.update('bot_mia', 'actor-1', entry => { entry.mirror = { sessionId: 's', createdAt: 1, id: 'x' }; });+ deleted.runtime.reconcile([]);+ await Promise.resolve();+ expect(deleted.local.host.createProfile).not.toHaveBeenCalled();+ });++ it('builds a companion this computer never had when it is handed here', async () => {+ const t = setup({ home: 'desk' });+ t.runtime.reconcile([]);+ await vi.waitFor(() => expect(t.local.host.createProfile).toHaveBeenCalledOnce());+ });+});++describe('transfer', () => {+ it('flushes uploads and the mirror before moving the home, then demotes locally', async () => {+ const t = setup({ home: 'desk', devices: [device('laptop')] });+ expect(await t.runtime.transfer('bot_mia', 'laptop')).toEqual({ ok: true });+ const order = t.calls.map(call => `${call.method} ${call.route}`);+ const patch = order.indexOf('PATCH /actors/actor-1');+ const conversation = order.lastIndexOf('POST /conversations');+ const upload = order.lastIndexOf('GET /preferences');+ expect(conversation).toBeGreaterThanOrEqual(0);+ // Values are synced last, so edits made while the backlog drains still reach the server.+ expect(upload).toBeGreaterThan(conversation);+ expect(upload).toBeLessThan(patch);+ expect(t.calls[patch]!.data).toEqual({ homeDeviceId: 'laptop', expectedHomeDeviceId: 'desk' });+ expect(t.state.isDemoted('bot_mia')).toBe(true);+ expect(t.actors[0]!.homeDeviceId).toBe('laptop');+ });++ it.each([+ ['unknown', []],+ ['offline', [device('laptop', { online: false })]],+ ['remote control off', [device('laptop', { remoteControlEnabled: false })]],+ ['a phone', [device('laptop', { platform: 'ios' })]],+ ])('rejects a target that is %s without touching the home', async (_name, devices) => {+ const t = setup({ home: 'desk', devices });+ expect(await t.runtime.transfer('bot_mia', 'laptop')).toEqual({ ok: false, code: 'TARGET_UNAVAILABLE' });+ expect(t.calls.some(call => call.method === 'PATCH')).toBe(false);+ });++ it('does not move the home when the flush cannot reach the server', async () => {+ const t = setup({ home: 'desk', devices: [device('laptop')], handler: (route, method) => {+ if (route === '/preferences' && method === 'GET') throw rejection(503, 'UNAVAILABLE');+ return {};+ } });+ expect(await t.runtime.transfer('bot_mia', 'laptop')).toEqual({ ok: false, code: 'OFFLINE' });+ expect(t.calls.some(call => call.method === 'PATCH')).toBe(false);+ expect(t.state.isDemoted('bot_mia')).toBe(false);+ });++ it('uploads again when the companion changed during the flush, and refuses while it keeps changing', async () => {+ // Changes once while the first pass uploads, then stays put: the move uses the newest value.+ let version = 0;+ const once = setup({ home: 'desk', devices: [device('laptop')], readValues: async () => {+ const current = [{ key: 'companion.profile.v1', value: { name: `Mia ${version}` } }];+ if (version < 1) version += 1;+ return current;+ } });+ expect(await once.runtime.transfer('bot_mia', 'laptop')).toEqual({ ok: true });+ const order = once.calls.map(call => `${call.method} ${call.route}`);+ expect(order.filter(entry => entry === 'POST /preferences')).toHaveLength(2);+ expect(order.lastIndexOf('POST /preferences')).toBeLessThan(order.indexOf('PATCH /actors/actor-1'));+ once.runtime.dispose();++ let tick = 0;+ const busy = setup({ home: 'desk', devices: [device('laptop')],+ readValues: async () => [{ key: 'companion.profile.v1', value: { name: `Mia ${tick++}` } }] });+ expect(await busy.runtime.transfer('bot_mia', 'laptop')).toEqual({ ok: false, code: 'FAILED' });+ expect(busy.calls.some(call => call.method === 'PATCH')).toBe(false);+ });++ it('waits for a background upload already in flight before flushing and moving the home', async () => {+ let release: () => void = () => undefined;+ const held = new Promise<void>(resolve => { release = resolve; });+ let first = true;+ const t = setup({ home: 'desk', devices: [device('laptop')], readValues: async () => {+ if (first) { first = false; await held; }+ return [{ key: 'companion.profile.v1', value: MIA }];+ } });+ const background = t.runtime.syncNow();+ await new Promise(resolve => setTimeout(resolve, 0));+ const moved = t.runtime.transfer('bot_mia', 'laptop');+ await new Promise(resolve => setTimeout(resolve, 20));+ expect(t.calls.some(call => call.method === 'PATCH')).toBe(false);+ release();+ await background;+ expect(await moved).toEqual({ ok: true });+ const order = t.calls.map(call => `${call.method} ${call.route}`);+ expect(order.lastIndexOf('GET /preferences')).toBeLessThan(order.indexOf('PATCH /actors/actor-1'));+ });++ it('publishes the actor name and avatar before moving the home, and stays put when that fails', async () => {+ const order: string[] = [];+ const t = setup({ home: 'desk', devices: [device('laptop')], syncProfile: async botId => { order.push(`profile:${botId}`); } });+ expect(await t.runtime.transfer('bot_mia', 'laptop')).toEqual({ ok: true });+ const patch = t.calls.findIndex(call => call.method === 'PATCH');+ expect(order).toEqual(['profile:bot_mia']);+ expect(patch).toBeGreaterThanOrEqual(0);+ t.runtime.dispose();++ const failing = setup({ home: 'desk', devices: [device('laptop')], syncProfile: async () => { throw new Error('AVATAR_UPLOAD_FAILED'); } });+ expect(await failing.runtime.transfer('bot_mia', 'laptop')).toEqual({ ok: false, code: 'FAILED' });+ expect(failing.calls.some(call => call.method === 'PATCH')).toBe(false);+ expect(failing.state.isDemoted('bot_mia')).toBe(false);+ });++ it('does not move the home while a turn is still running, checked before and after the flush', async () => {+ const busy = setup({ home: 'desk', devices: [device('laptop')], turnActive: () => true });+ expect(await busy.runtime.transfer('bot_mia', 'laptop')).toEqual({ ok: false, code: 'BUSY' });+ expect(busy.calls.some(call => call.method === 'PATCH')).toBe(false);+ busy.runtime.dispose();++ // A turn starts while the backlog is flushed.+ let checks = 0;+ const late = setup({ home: 'desk', devices: [device('laptop')], turnActive: () => ++checks > 1 });+ expect(await late.runtime.transfer('bot_mia', 'laptop')).toEqual({ ok: false, code: 'BUSY' });+ expect(late.calls.some(call => call.method === 'PATCH')).toBe(false);+ expect(late.state.isDemoted('bot_mia')).toBe(false);+ });++ it('does not move the home when a value is too large to upload', async () => {+ const t = setup({ home: 'desk', devices: [device('laptop')], values: [+ { key: 'companion.profile.v1', value: { name: 'Mia' } },+ { key: 'companion.skill.v1:huge', value: { slug: 'huge', content: 'x'.repeat(70 * 1024) } }] });+ expect(await t.runtime.transfer('bot_mia', 'laptop')).toEqual({ ok: false, code: 'FAILED' });+ expect(t.calls.some(call => call.method === 'PATCH')).toBe(false);+ expect(t.state.isDemoted('bot_mia')).toBe(false);+ });++ it('only transfers from the home computer', async () => {+ const t = setup({ home: 'laptop', devices: [device('tablet')] });+ expect(await t.runtime.transfer('bot_mia', 'tablet')).toMatchObject({ ok: false, code: 'FAILED', homeDeviceId: 'laptop' });+ });+});++describe('transcript', () => {+ it('maps authors to roles and pages oldest-first', async () => {+ const page = Array.from({ length: 100 }, (_, i) => ({ id: `m${i}`, seq: String(200 - i), authorId: i % 2 ? 'actor-1' : 'human',+ createdAt: new Date(1_700_000_000_000 - i * 1000).toISOString(), content: [{ type: 'text', text: `t${i}` }] }));+ page[1] = { ...page[1]!, content: [{ type: 'media', caption: 'a.png' } as never] };+ const { api } = fakeApi(() => page);+ const result = await readTranscriptPage(api, ROOM, 'actor-1');+ expect(result.nextBefore).toBe('101');+ expect(result.messages.at(-1)).toMatchObject({ id: 'm0', seq: '200', role: 'user', text: 't0' });+ expect(result.messages.at(-2)).toMatchObject({ id: 'm1', role: 'assistant', text: '[附件: a.png]' });+ });+});++describe('retire', () => {+ it('disables the cloud companion when it is deleted on its main computer', async () => {+ const t = setup({ home: 'desk' });+ await t.runtime.retire('bot_mia');+ expect(t.calls.filter(call => call.method === 'PATCH')).toEqual([expect.objectContaining({ route: '/actors/actor-1',+ data: { disabled: true, homeDeviceId: 'desk', expectedHomeDeviceId: 'desk' } })]);+ expect(t.actors[0]!.disabled).toBe(true);+ // A retired companion is never revived or demoted again.+ t.runtime.reconcile([]);+ await Promise.resolve();+ expect(t.local.host.createProfile).not.toHaveBeenCalled();+ });++ it('does not retire the companion when another computer took it over in the meantime', async () => {+ const t = setup({ home: 'desk', handler: (_route, method) => {+ if (method === 'PATCH') throw rejection(409, 'HOME_DEVICE_CONFLICT', { homeDeviceId: 'laptop' });+ return [];+ } });+ await t.runtime.retire('bot_mia');+ expect(t.actors[0]!.disabled).toBeFalsy();+ expect(t.actors[0]!.homeDeviceId).toBe('laptop');+ expect(t.state.bot('bot_mia')?.retirePending).toBeUndefined();+ expect(t.refresh).toHaveBeenCalled();+ });++ it('hides a copy here once the companion was deleted on its main computer', () => {+ const t = setup({ home: 'laptop' });+ t.actors[0]!.disabled = true;+ t.runtime.reconcile([{ id: 'bot_mia', status: 'active' }]);+ expect(t.runtime.isShadowed('bot_mia')).toBe(true);+ expect(t.local.host.createProfile).not.toHaveBeenCalled();+ });++ it.each([+ ['a demoted local copy', 'desk', true],+ ['a copy whose home is elsewhere', 'laptop', false],+ ])('leaves the cloud companion alone when deleting %s', async (_name, home, demoted) => {+ const t = setup({ home });+ if (demoted) t.state.update('bot_mia', 'actor-1', entry => { entry.demoted = true; });+ await t.runtime.retire('bot_mia');+ expect(t.calls.some(call => call.method === 'PATCH')).toBe(false);+ });+});++describe('review fixes', () => {+ it('confirms the home with a self-to-self compare-and-set before un-demoting', async () => {+ const t = setup({ home: 'desk' });+ t.local.setProfile({ status: 'active', displayName: 'Mia', description: '' });+ t.state.update('bot_mia', 'actor-1', entry => { entry.demoted = true; });+ t.runtime.reconcile([{ id: 'bot_mia', status: 'active' }]);+ await vi.waitFor(() => expect(t.state.isDemoted('bot_mia')).toBe(false));+ const patch = t.calls.find(call => call.method === 'PATCH');+ expect(patch).toMatchObject({ route: '/actors/actor-1', data: { homeDeviceId: 'desk', expectedHomeDeviceId: 'desk' } });+ expect(t.calls.indexOf(patch!)).toBeLessThan(t.calls.findIndex(call => call.route === '/preferences' && call.method === 'GET'));+ });++ it('does not resurrect a demoted copy when the cached home is stale', async () => {+ const t = setup({ home: 'desk', handler: (route, method) => {+ if (method === 'PATCH') throw rejection(409, 'HOME_DEVICE_CONFLICT', { homeDeviceId: 'laptop' });+ return [];+ } });+ t.local.setProfile({ status: 'active', displayName: 'Mia', description: '' });+ t.state.update('bot_mia', 'actor-1', entry => { entry.demoted = true; });+ t.runtime.reconcile([{ id: 'bot_mia', status: 'active' }]);+ await vi.waitFor(() => expect(t.refresh).toHaveBeenCalled());+ expect(t.state.isDemoted('bot_mia')).toBe(true);+ expect(t.local.host.updateProfile).not.toHaveBeenCalled();+ });++ it('rejects a hand-over target whose Cindy cannot take a companion over', async () => {+ const t = setup({ home: 'desk', devices: [device('laptop')], probe: async () => false });+ expect(await t.runtime.transfer('bot_mia', 'laptop')).toEqual({ ok: false, code: 'TARGET_UNAVAILABLE' });+ expect(await t.runtime.transferTargets()).toEqual([]);+ expect(t.calls.some(call => call.method === 'PATCH')).toBe(false);+ });++ it('drops a pending retirement once another computer took the companion over', async () => {+ let fail = true;+ const t = setup({ home: 'desk', handler: (_route, method, data) => {+ if (method === 'PATCH' && (data as { disabled?: boolean }).disabled && fail) throw rejection(503, 'UNAVAILABLE');+ return {};+ } });+ await expect(t.runtime.retire('bot_mia')).rejects.toThrow('UNAVAILABLE');+ fail = false;+ t.actors[0]!.homeDeviceId = 'laptop';+ t.runtime.reconcile([]);+ expect(t.state.bot('bot_mia')?.retirePending).toBeUndefined();+ // Handed back later: the companion is not retired by the stale deletion.+ t.actors[0]!.homeDeviceId = 'desk';+ t.runtime.reconcile([]);+ await new Promise(resolve => setTimeout(resolve, 20));+ // Only the first, failed attempt ever asked to disable it.+ expect(t.calls.filter(call => call.method === 'PATCH' && (call.data as { disabled?: boolean }).disabled)).toHaveLength(1);+ expect(t.actors[0]!.disabled).toBeFalsy();+ });++ it('keeps retrying to retire a companion deleted on its home until it succeeds', async () => {+ let fail = true;+ const t = setup({ home: 'desk', handler: (_route, method, data) => {+ if (method === 'PATCH' && (data as { disabled?: boolean }).disabled && fail) throw rejection(503, 'UNAVAILABLE');+ return {};+ } });+ await expect(t.runtime.retire('bot_mia')).rejects.toThrow('UNAVAILABLE');+ expect(t.state.bot('bot_mia')?.retirePending).toBe(true);+ fail = false;+ t.runtime.reconcile([]);+ await vi.waitFor(() => expect(t.state.bot('bot_mia')?.retirePending).toBeUndefined());+ expect(t.actors[0]!.disabled).toBe(true);+ expect(t.local.host.createProfile).not.toHaveBeenCalled();+ });+});++describe('installation guard', () => {+ const guarded = (owner: string | { installationId: string; deviceId: string } | null) => {+ const record = typeof owner === 'string' ? { installationId: owner } : owner;+ const prefs = new Map<string, { value: unknown; revision: number }>([['companion.profile.v1', { value: { ...MIA, name: 'Mia (cloud)' }, revision: 1 }],+ ...(record ? [['companion.install.v1', { value: record, revision: 1 }] as const] : [])]);+ return setup({ home: 'desk', installationId: 'install-a', handler: (route, method, data) => {+ if (route === '/preferences' && method === 'GET') return [...prefs].map(([key, row]) => ({ key, ...row }));+ if (route === '/preferences') {+ const body = data as { key: string; value: unknown; expectedRevision: number };+ const current = prefs.get(body.key)?.revision ?? 0;+ if (current !== body.expectedRevision) throw rejection(409, 'REVISION_CONFLICT', { revision: current });+ prefs.set(body.key, { value: body.value, revision: current + 1 });+ return { revision: current + 1 };+ }+ if (route === '/conversations') return { id: ROOM };+ if (route.includes('/messages?')) return [];+ return {};+ } });+ };++ it('shadows a companion another installation on this device runs', async () => {+ const t = guarded({ installationId: 'install-b', deviceId: 'desk' });+ t.runtime.reconcile([{ id: 'bot_mia', status: 'active' }]);+ // Not confirmed while the claim is still being read: execution polling stays off.+ expect(t.runtime.installConfirmed('bot_mia')).toBe(false);+ await vi.waitFor(() => expect(t.runtime.isShadowed('bot_mia')).toBe(true));+ expect(t.runtime.installConfirmed('bot_mia')).toBe(false);+ expect(t.runtime.shadowIds()).toEqual(['bot_mia']);+ await t.runtime.syncNow();+ expect(t.calls.some(call => call.method === 'POST' && call.route === '/preferences' && (call.data as { key: string }).key !== 'companion.install.v1')).toBe(false);+ // Taking over from this installation overwrites the claim.+ expect(await t.runtime.takeOver('bot_mia')).toEqual({ ok: true });+ expect(t.runtime.isShadowed('bot_mia')).toBe(false);+ expect(t.calls.some(call => call.method === 'POST' && (call.data as { key?: string; value?: unknown }).key === 'companion.install.v1'+ && (call.data as { value: { installationId: string } }).value.installationId === 'install-a')).toBe(true);+ });++ it('deletes only the local copy when the installation check shows another Cindy here runs it', async () => {+ const t = guarded({ installationId: 'install-b', deviceId: 'desk' });+ // Deleted before the check finished: confirm first, never disable the other installation's companion.+ await t.runtime.retire('bot_mia');+ expect(t.calls.some(call => call.method === 'PATCH')).toBe(false);+ expect(t.state.bot('bot_mia')?.retirePending).toBeUndefined();++ const mine = guarded(null);+ await mine.runtime.retire('bot_mia');+ expect(mine.calls.filter(call => call.method === 'PATCH')).toEqual([expect.objectContaining({ data: expect.objectContaining({ disabled: true }) })]);+ });++ it('claims a companion just handed here before retiring it, and leaves it to the installation that won', async () => {+ const handed = guarded({ installationId: 'install-x', deviceId: 'laptop' });+ await handed.runtime.retire('bot_mia');+ const order = handed.calls.map(call => call.method === 'POST' ? `POST ${(call.data as { key?: string }).key}` : `${call.method} ${call.route}`);+ expect(order.indexOf('POST companion.install.v1')).toBeGreaterThanOrEqual(0);+ expect(order.indexOf('POST companion.install.v1')).toBeLessThan(order.indexOf('PATCH /actors/actor-1'));++ // The other Cindy on this computer claimed it first: deleting here never disables it.+ const lost = setup({ home: 'desk', installationId: 'install-a', handler: (route, method) => {+ if (route === '/preferences' && method === 'GET') return [{ key: 'companion.profile.v1', value: MIA, revision: 1 },+ { key: 'companion.install.v1', value: { installationId: 'install-x', deviceId: 'laptop' }, revision: 1 }];+ if (route === '/preferences') throw rejection(409, 'REVISION_CONFLICT', { revision: 2 });+ return {};+ } });+ await lost.runtime.retire('bot_mia');+ expect(lost.calls.some(call => call.method === 'PATCH')).toBe(false);+ expect(lost.state.bot('bot_mia')?.retirePending).toBeUndefined();+ });++ it('hides the copy before this installation claims it during a take-over', async () => {+ let demotedAtClaim: boolean | undefined;+ let state: { isDemoted: (botId: string) => boolean } | undefined;+ const t = setup({ home: 'laptop', installationId: 'install-a', handler: (route, method, data) => {+ if (route === '/preferences' && method === 'GET') return [{ key: 'companion.profile.v1', value: MIA, revision: 1 },+ { key: 'companion.install.v1', value: { installationId: 'install-b', deviceId: 'desk' }, revision: 1 }];+ if (route === '/preferences' && (data as { key?: string }).key === 'companion.install.v1') demotedAtClaim = state?.isDemoted('bot_mia');+ if (route === '/preferences') return { revision: 2 };+ if (route === '/conversations') return { id: ROOM };+ if (route.includes('/messages?')) return [];+ return {};+ } });+ state = t.state;+ expect(await t.runtime.takeOver('bot_mia')).toEqual({ ok: true });+ expect(demotedAtClaim).toBe(true);+ expect(t.state.isDemoted('bot_mia')).toBe(false);+ });++ it('claims an unclaimed companion for this installation and then syncs it', async () => {+ const t = guarded(null);+ t.runtime.reconcile([{ id: 'bot_mia', status: 'active' }]);+ await vi.waitFor(() => expect(t.calls.some(call => call.method === 'POST' && (call.data as { key?: string }).key === 'companion.install.v1')).toBe(true));+ await vi.waitFor(() => expect(t.runtime.installConfirmed('bot_mia')).toBe(true));+ expect(t.runtime.isShadowed('bot_mia')).toBe(false);+ await t.runtime.syncNow();+ expect(t.calls.some(call => call.method === 'POST' && (call.data as { key?: string }).key === 'companion.profile.v1')).toBe(true);+ });++ it('never takes a companion handed back to this computer from the other installation here automatically', async () => {+ const t = guarded({ installationId: 'install-b', deviceId: 'desk' });+ t.local.setProfile({ status: 'active', displayName: 'Mia', description: '' });+ t.state.update('bot_mia', 'actor-1', entry => { entry.demoted = true; });+ t.runtime.reconcile([{ id: 'bot_mia', status: 'active' }]);+ await vi.waitFor(() => expect(t.calls.some(call => call.method === 'PATCH')).toBe(true));+ await new Promise(resolve => setTimeout(resolve, 20));+ expect(t.calls.some(call => call.method === 'POST' && (call.data as { key?: string }).key === 'companion.install.v1')).toBe(false);+ expect(t.local.host.updateProfile).not.toHaveBeenCalled();+ expect(t.state.isDemoted('bot_mia')).toBe(true);+ // The user's explicit take-over still moves it to this installation.+ expect(await t.runtime.takeOver('bot_mia')).toEqual({ ok: true });+ });++ it('hides a copy handed here before confirming the home with the server', async () => {+ let demotedAtPatch: boolean | undefined;+ let state: { isDemoted: (botId: string) => boolean } | undefined;+ const t = setup({ home: 'desk', handler: (route, method) => {+ if (method === 'PATCH') { demotedAtPatch = state?.isDemoted('bot_mia'); return {}; }+ if (route === '/preferences') return method === 'GET' ? [{ key: 'companion.profile.v1', value: MIA, revision: 1 }] : { revision: 1 };+ if (route === '/conversations') return { id: ROOM };+ if (route.includes('/messages?')) return [];+ return {};+ } });+ state = t.state;+ t.runtime.reconcile([]);+ await vi.waitFor(() => expect(t.local.host.createProfile).toHaveBeenCalledOnce());+ expect(demotedAtPatch).toBe(true);+ await vi.waitFor(() => expect(t.state.isDemoted('bot_mia')).toBe(false));+ });++ it('takes over an existing, never-synced copy handed here before this computer saw the move', async () => {+ // Another computer's installation ran it; this device's own copy was never demoted.+ const t = guarded({ installationId: 'install-x', deviceId: 'laptop' });+ t.local.setProfile({ status: 'active', displayName: 'Mia', description: '' });+ t.runtime.reconcile([{ id: 'bot_mia', status: 'active' }]);+ await vi.waitFor(() => expect(t.runtime.installConfirmed('bot_mia')).toBe(true));+ await vi.waitFor(() => expect(t.local.host.updateProfile).toHaveBeenCalledOnce());+ expect(t.calls.find(call => call.method === 'PATCH')?.data).toEqual({ homeDeviceId: 'desk', expectedHomeDeviceId: 'desk' });+ expect(t.calls.some(call => call.method === 'POST' && (call.data as { key?: string; value?: unknown }).key === 'companion.install.v1'+ && JSON.stringify((call.data as { value: unknown }).value) === JSON.stringify({ installationId: 'install-a', deviceId: 'desk' }))).toBe(true);+ await vi.waitFor(() => expect(t.state.isDemoted('bot_mia')).toBe(false));+ expect(t.runtime.isShadowed('bot_mia')).toBe(false);+ });+});diff --git a/apps/desktop/src/main/companion-cloud/__tests__/fakes.ts b/apps/desktop/src/main/companion-cloud/__tests__/fakes.tsnew file mode 100644index 0000000000..2ef9e8739b--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/__tests__/fakes.ts@@ -0,0 +1,66 @@+import { vi } from 'vitest';+import type { CompanionMaterializeHost } from '../materialize.js';+import type { CompanionMirrorRow } from '../mirror.js';+import { createCompanionCloudState } from '../state.js';+import type { CompanionApi } from '../types.js';++/** Same shape as chatServer's response error: code as message, plus status/details. */+export function rejection(status: number, code: string, details?: Record<string, unknown>) {+ return Object.assign(new Error(code), { status, details });+}++export function memoryState(initial?: string) {+ const files = new Map<string, string>(initial ? [['state.json', initial]] : []);+ const state = createCompanionCloudState({+ filePath: 'state.json',+ io: { read: path => files.get(path) ?? null, write: (path, contents) => { files.set(path, contents); } },+ });+ return { state, files };+}++export type ApiHandler = (route: string, method: string, data: unknown, actorId?: string) => unknown;++export function fakeApi(handler: ApiHandler) {+ const calls: Array<{ route: string; method: string; data: unknown; actorId?: string }> = [];+ const api = vi.fn(async (route: string, method = 'GET', data?: unknown, actorId?: string) => {+ calls.push({ route, method, data, actorId });+ return handler(route, method, data, actorId);+ }) as unknown as CompanionApi;+ return { api, calls };+}++export function fakeLocal(overrides: Partial<CompanionMaterializeHost> = {}) {+ const memories = new Map<string, string>();+ const skills = new Map<string, string>();+ const disabledSkills = new Set<string>();+ const rows: CompanionMirrorRow[] = [];+ let profile: { status: string; displayName: string; description: string } | null = null;+ const host = {+ readProfile: vi.fn(async () => profile),+ createProfile: vi.fn(async (input: { name: string; description: string }) => { profile = { status: 'active', displayName: input.name, description: input.description }; }),+ updateProfile: vi.fn(async (input: { name: string }) => { profile = { ...profile!, status: 'active', displayName: input.name }; }),+ writeSystemPrompt: vi.fn(async () => undefined),+ readMemory: vi.fn(async (_bot: string, file: string) => memories.get(file) ?? null),+ restoreMemory: vi.fn(async (_bot: string, file: string, raw: string) => { memories.set(file, raw); }),+ removeMemory: vi.fn(async (_bot: string, file: string) => { memories.delete(file); }),+ readSkill: vi.fn(async (_bot: string, slug: string) => skills.get(slug) ?? null),+ saveSkill: vi.fn(async (_bot: string, slug: string, content: string, enabled = true) => {+ skills.set(slug, content); if (enabled) disabledSkills.delete(slug); else disabledSkills.add(slug);+ }),+ removeSkill: vi.fn(async (_bot: string, slug: string) => { skills.delete(slug); }),+ ensureCanonicalSession: vi.fn(async () => 'session-1'),+ localMessageTimes: vi.fn(async (_sid: string, from: number) =>+ rows.filter(row => row.createdAt >= from).map(row => ({ role: row.role, createdAt: row.createdAt, clientId: row.clientId }))),+ insertHistory: vi.fn(async (_sid: string, row: { clientId: string; role: string; text: string; createdAt: number }) => {+ rows.push({ id: `local-${rows.length}`, clientId: row.clientId, role: row.role, content: row.text, agentMeta: null, createdAt: row.createdAt });+ }),+ rebuildContext: vi.fn(async (): Promise<'rebuilt' | 'busy'> => 'rebuilt'),+ latestRows: vi.fn(async (_sid: string, limit: number, options?: { excludeClientIdPrefix?: string }) => [...rows]+ .filter(row => !options?.excludeClientIdPrefix || !row.clientId.startsWith(options.excludeClientIdPrefix))+ .sort((a, b) => b.createdAt - a.createdAt).slice(0, limit)),+ ...overrides,+ };+ return { host: host as unknown as CompanionMaterializeHost & typeof host, memories, skills, disabledSkills, rows,+ setProfile: (value: typeof profile) => { profile = value; } };+}+diff --git a/apps/desktop/src/main/companion-cloud/__tests__/homes.test.ts b/apps/desktop/src/main/companion-cloud/__tests__/homes.test.tsnew file mode 100644index 0000000000..e318a58655--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/__tests__/homes.test.ts@@ -0,0 +1,98 @@+import { describe, expect, it, vi } from 'vitest';+import { companionSnapshot, createCompanionHomeRegistry, registerCompanionHomes } from '../homes.js';+import { fakeApi, rejection } from './fakes.js';++const bot = (id: string, externalId: string, homeDeviceId: string | null) =>+ ({ id, kind: 'bot', externalId, name: externalId, homeDeviceId });++describe('companion home registry', () => {+ it('treats disabled, unhomed and own companions as home here', () => {+ const homes = createCompanionHomeRegistry();+ expect(homes.isHomeHere('a')).toBe(true);+ const listener = vi.fn();+ homes.onChange(listener);+ homes.update(companionSnapshot({ enabled: true, selfDeviceId: 'me', humanActorId: 'human', actors: [+ bot('actor-a', 'a', 'me'), bot('actor-b', 'b', 'other'), bot('actor-c', 'c', null),+ ] }));+ expect(listener).toHaveBeenCalledOnce();+ expect([homes.isHomeHere('a'), homes.isHomeHere('b'), homes.isHomeHere('c'), homes.isHomeHere('unknown')])+ .toEqual([true, false, true, true]);+ expect(homes.homeOf('b')).toBe('other');+ expect(homes.homeOf('unknown')).toBeUndefined();+ expect(homes.actorIdFor('c')).toBe('actor-c');+ // Same content does not notify again; disabling makes everything local again.+ homes.update(homes.snapshot());+ expect(listener).toHaveBeenCalledOnce();+ homes.reset();+ expect(homes.isEnabled()).toBe(false);+ expect(homes.isHomeHere('b')).toBe(true);+ });+});++describe('registerCompanionHomes', () => {+ it('claims only empty homes with compare-and-set against null', async () => {+ const { api, calls } = fakeApi(() => ({ homeDeviceId: 'me' }));+ const actors = [bot('actor-a', 'a', null), bot('actor-b', 'b', 'other'), bot('actor-c', 'c', null)];+ await registerCompanionHomes({ api, selfDeviceId: 'me', actors, botIds: ['a', 'b', 'c', 'missing'], isDemoted: id => id === 'c' });+ expect(calls).toEqual([{ route: '/actors/actor-a', method: 'PATCH', data: { homeDeviceId: 'me', expectedHomeDeviceId: null }, actorId: undefined }]);+ expect(actors.map(a => a.homeDeviceId)).toEqual(['me', 'other', null]);+ });++ it('adopts the winner of a concurrent registration', async () => {+ const { api } = fakeApi(() => { throw rejection(409, 'HOME_DEVICE_CONFLICT', { homeDeviceId: 'laptop' }); });+ const actors = [bot('actor-a', 'a', null)];+ await registerCompanionHomes({ api, selfDeviceId: 'me', actors, botIds: ['a'], isDemoted: () => false });+ expect(actors[0]!.homeDeviceId).toBe('laptop');+ });++ it('keeps the home empty and logs when the request fails for another reason', async () => {+ const { api } = fakeApi(() => { throw rejection(500, 'UPSTREAM_FAILED'); });+ const log = { warn: vi.fn() };+ const actors = [bot('actor-a', 'a', null)];+ await registerCompanionHomes({ api, selfDeviceId: 'me', actors, botIds: ['a'], isDemoted: () => false, log });+ expect(actors[0]!.homeDeviceId).toBeNull();+ expect(log.warn).toHaveBeenCalledWith('Companion home registration will retry', { actorId: 'actor-a', code: 'UPSTREAM_FAILED' });+ });+});++describe('retired actors', () => {+ it('drops disabled actors from the snapshot and never registers them', async () => {+ const snapshot = companionSnapshot({ enabled: true, selfDeviceId: 'me', humanActorId: 'human', actors: [+ { ...bot('actor-a', 'a', null), disabled: true }, bot('actor-b', 'b', 'me')] });+ expect(snapshot.actors.map(actor => actor.externalId)).toEqual(['b']);+ const { api, calls } = fakeApi(() => ({}));+ await registerCompanionHomes({ api, selfDeviceId: 'me', actors: [{ ...bot('actor-a', 'a', null), disabled: true }], botIds: ['a'], isDemoted: () => false });+ expect(calls).toEqual([]);+ });+});++describe('owner scoping', () => {+ it('drops the previous owner\'s homes and loads the new owner\'s persisted shadows on first read', () => {+ const homes = createCompanionHomeRegistry();+ let owner = 'a';+ const persisted: Record<string, string[]> = { a: [], b: ['mia'] };+ homes.bindOwner(() => owner, () => persisted[owner]!);+ homes.update(companionSnapshot({ enabled: true, selfDeviceId: 'me', humanActorId: 'human', actors: [bot('actor-a', 'mia', 'me')] }));+ expect(homes.isShadowed('mia')).toBe(false);+ expect(homes.snapshot().actors).toHaveLength(1);+ owner = 'b';+ expect(homes.isShadowed('mia')).toBe(true);+ expect(homes.snapshot()).toMatchObject({ enabled: false, actors: [], demotedBotIds: ['mia'] });+ });+});++describe('persisted shadows', () => {+ it('keep a demoted copy shadowed while the server is unknown or the feature is off', () => {+ const homes = createCompanionHomeRegistry();+ const listener = vi.fn();+ homes.onChange(listener);+ homes.setPersistedShadows(['mia']);+ expect(homes.isShadowed('mia')).toBe(true);+ expect(homes.snapshot()).toMatchObject({ enabled: false, demotedBotIds: ['mia'] });+ expect(listener).toHaveBeenCalledOnce();+ homes.update(companionSnapshot({ enabled: false, selfDeviceId: null, humanActorId: null, actors: [] }));+ expect(homes.isShadowed('mia')).toBe(true);+ homes.reset();+ expect(homes.isShadowed('mia')).toBe(false);+ });+});diff --git a/apps/desktop/src/main/companion-cloud/__tests__/materialize.test.ts b/apps/desktop/src/main/companion-cloud/__tests__/materialize.test.tsnew file mode 100644index 0000000000..2d0bde46b8--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/__tests__/materialize.test.ts@@ -0,0 +1,287 @@+import { describe, expect, it, vi } from 'vitest';+import { materializeCompanion } from '../materialize.js';+import { valueHash } from '../uploader.js';+import { fakeApi, fakeLocal, memoryState } from './fakes.js';++const ROOM = '10000000-0000-4000-8000-000000000001';+const actor = { id: 'actor-1', externalId: 'bot_mia', name: 'Mia', avatar: '🦊' };+const iso = (ms: number) => new Date(ms).toISOString();++const roomMessage = (id: string, seq: number, authorId: string, text: string, createdAt: number) =>+ ({ id, seq: String(seq), authorId, origin: 'chat', deleted: false, threadRootId: null, createdAt: iso(createdAt), content: [{ type: 'text', text }] });++function cloud(prefs: Array<{ key: string; value: unknown }>, room: unknown[] = []) {+ return fakeApi((route, method) => {+ if (route === '/preferences' && method === 'GET') return prefs.map((p, i) => ({ ...p, revision: i + 1 }));+ if (route.startsWith(`/conversations/${ROOM}/messages?`)) return room;+ throw new Error(`unexpected ${method} ${route}`);+ });+}++const profilePref = { key: 'companion.profile.v1', value: { name: 'Mia', description: 'helper', soul: 'I am Mia', systemPrompt: 'custom', user: 'Owner likes tea' } };++describe('materializeCompanion', () => {+ it('creates a missing companion from its cloud profile, memories and skills', async () => {+ const { api, calls } = cloud([profilePref,+ { key: 'companion.memory.v1:user_tea.md', value: { filename: 'user_tea.md', content: '---\ntitle: Tea\n---\nlikes tea' } },+ { key: 'companion.skill.v1:brew', value: { slug: 'brew', content: '---\nname: brew\n---\n\nsteps' } }]);+ const local = fakeLocal();+ const { state } = memoryState();+ state.update('bot_mia', 'actor-1', entry => { entry.demoted = true; });+ const result = await materializeCompanion({ api, state, host: local.host, actor, roomId: async () => ROOM });+ expect(calls[0]).toMatchObject({ route: '/preferences', method: 'GET', actorId: 'actor-1' });+ expect(local.host.createProfile).toHaveBeenCalledWith({ id: 'bot_mia', name: 'Mia', description: 'helper',+ identitySource: 'I am Mia', userContextSource: 'Owner likes tea', avatar: '🦊' }, expect.anything());+ expect(local.host.updateProfile).not.toHaveBeenCalled();+ expect(local.host.writeSystemPrompt).toHaveBeenCalledWith('bot_mia', 'custom', expect.anything());+ expect(local.memories.get('user_tea.md')).toContain('likes tea');+ expect(local.skills.get('brew')).toContain('steps');+ expect(result).toEqual({ created: true, inserted: 0, rebuild: 'skipped' });+ expect(state.bot('bot_mia')?.demoted).toBeUndefined();+ expect(local.host.rebuildContext).not.toHaveBeenCalled();+ });++ it('updates an existing companion from the cloud; a tombstone deletes the local file whatever it holds', async () => {+ const { api } = cloud([profilePref,+ { key: 'companion.memory.v1:user_old.md', value: null },+ { key: 'companion.memory.v1:user_edited.md', value: null },+ { key: 'companion.memory.v1:user_never.md', value: null },+ { key: 'companion.memory.v1:user_same.md', value: { filename: 'user_same.md', content: 'same' } },+ { key: 'companion.skill.v1:gone', value: null }]);+ const local = fakeLocal();+ local.setProfile({ status: 'paused', displayName: 'Old', description: '' });+ local.memories.set('user_old.md', 'old'); local.memories.set('user_edited.md', 'edited here');+ local.memories.set('user_never.md', 'only here'); local.memories.set('user_same.md', 'same');+ local.skills.set('gone', 'x');+ const { state } = memoryState();+ state.update('bot_mia', 'actor-1', entry => {+ entry.prefs['companion.memory.v1:user_old.md'] = { hash: valueHash({ filename: 'user_old.md', content: 'old' }), revision: 1, local: true };+ entry.prefs['companion.memory.v1:user_edited.md'] = { hash: valueHash({ filename: 'user_edited.md', content: 'original' }), revision: 1, local: true };+ });+ const backupHome = vi.fn(async () => '/backup');+ local.host.backupHome = backupHome;+ const result = await materializeCompanion({ api, state, host: local.host, actor, roomId: async () => ROOM });+ expect(local.host.createProfile).not.toHaveBeenCalled();+ expect(local.host.updateProfile).toHaveBeenCalledWith({ id: 'bot_mia', name: 'Mia', description: 'helper', identitySource: 'I am Mia', userContextSource: 'Owner likes tea', avatar: '🦊' }, expect.anything());+ // Deleted in the cloud means deleted here too, so the uploader cannot bring it back;+ // the copy was backed up first.+ expect(vi.mocked(local.host.removeMemory).mock.calls.map(call => call[1]).sort()).toEqual(['user_edited.md', 'user_never.md', 'user_old.md']);+ expect([...local.memories.keys()].sort()).toEqual(['user_same.md']);+ expect(local.host.restoreMemory).not.toHaveBeenCalled();+ expect(local.host.removeSkill).toHaveBeenCalledWith('bot_mia', 'gone', expect.anything());+ expect(backupHome).toHaveBeenCalledOnce();+ expect(result.backup).toBe('/backup');+ expect(state.bot('bot_mia')?.prefs['companion.memory.v1:user_never.md']).toMatchObject({ local: true });+ expect(state.bot('bot_mia')?.backedUp).toBeUndefined();+ expect(state.bot('bot_mia')?.prefs['companion.memory.v1:user_same.md']).toMatchObject({ local: true });+ });++ it('backs up a local copy that never synced before overwriting it', async () => {+ const { api } = cloud([profilePref]);+ const local = fakeLocal({ backupHome: vi.fn(async () => '/backups/bot_mia-1') });+ local.setProfile({ status: 'active', displayName: 'Cindy', description: '' });+ const log = { warn: vi.fn(), info: vi.fn() };+ const result = await materializeCompanion({ api, state: memoryState().state, host: local.host, actor, roomId: async () => ROOM, log });+ expect(result.backup).toBe('/backups/bot_mia-1');+ expect(local.host.backupHome).toHaveBeenCalledBefore(local.host.updateProfile as never);+ expect(log.info).toHaveBeenCalledWith('Companion local copy backed up before take-over', { actorId: 'actor-1', backup: '/backups/bot_mia-1' });+ });++ it('stops at the first step after the account changed', async () => {+ const { api } = cloud([profilePref, { key: 'companion.memory.v1:user_tea.md', value: { filename: 'user_tea.md', content: 'tea' } }],+ [roomMessage('m1', 1, 'human', 'hello', 1_700_000_000_000)]);+ let current = true;+ const local = fakeLocal({ createProfile: vi.fn(async () => { current = false; }) });+ await expect(materializeCompanion({ api, state: memoryState().state, host: local.host, actor, roomId: async () => ROOM,+ fence: { assertCurrent: () => { if (!current) throw new Error('OWNER_CHANGED'); } } })).rejects.toThrow('OWNER_CHANGED');+ expect(local.host.restoreMemory).not.toHaveBeenCalled();+ expect(local.host.writeSystemPrompt).not.toHaveBeenCalled();+ expect(local.host.insertHistory).not.toHaveBeenCalled();+ expect(local.host.rebuildContext).not.toHaveBeenCalled();+ });++ it('applies the cloud skill\'s enabled state even when the body is unchanged', async () => {+ const { api } = cloud([profilePref,+ { key: 'companion.skill.v1:brew', value: { slug: 'brew', content: 'same', enabled: false } },+ { key: 'companion.skill.v1:tea', value: { slug: 'tea', content: 'same' } }]);+ const local = fakeLocal();+ local.setProfile({ status: 'active', displayName: 'Mia', description: '' });+ local.skills.set('brew', 'same'); local.skills.set('tea', 'same'); local.disabledSkills.add('tea');+ await materializeCompanion({ api, state: memoryState().state, host: local.host, actor, roomId: async () => ROOM });+ expect([...local.disabledSkills]).toEqual(['brew']);+ });++ it('publishes the demotion before the first local write', async () => {+ const { api } = cloud([profilePref]);+ const local = fakeLocal();+ const { state } = memoryState();+ const onDemoted = vi.fn(() => {+ expect(state.isDemoted('bot_mia')).toBe(true);+ expect(local.host.createProfile).not.toHaveBeenCalled();+ });+ await materializeCompanion({ api, state, host: local.host, actor, roomId: async () => ROOM, onDemoted });+ expect(onDemoted).toHaveBeenCalledOnce();+ });++ it('retries history by room message id, so parts sharing a timestamp are not skipped', async () => {+ const at = 1_700_000_000_000;+ // Two parts of one split reply share role and time; the first was inserted before a failure.+ const { api } = cloud([profilePref], [roomMessage('m2', 2, 'actor-1', 'part two', at), roomMessage('m1', 1, 'actor-1', 'part one', at)]);+ const local = fakeLocal();+ local.setProfile({ status: 'active', displayName: 'Mia', description: '' });+ local.rows.push({ id: 'p1', clientId: 'cloud-history:m1', role: 'assistant', content: 'part one', agentMeta: null, createdAt: at });+ const result = await materializeCompanion({ api, state: memoryState().state, host: local.host, actor, roomId: async () => ROOM });+ expect(result.inserted).toBe(1);+ expect(vi.mocked(local.host.insertHistory).mock.calls.map(call => call[1].clientId)).toEqual(['cloud-history:m2']);+ });++ it('does not bring back a message that was rewound or deleted here', async () => {+ const at = 1_700_000_000_000;+ const { api } = cloud([profilePref], [roomMessage('m1', 1, 'human', 'regretted', at)]);+ const local = fakeLocal({ localMessageTimes: vi.fn(async () => [{ role: 'message_tombstone', createdAt: at, clientId: 'c1', removed: true }]) });+ local.setProfile({ status: 'active', displayName: 'Mia', description: '' });+ const result = await materializeCompanion({ api, state: memoryState().state, host: local.host, actor, roomId: async () => ROOM });+ expect(result.inserted).toBe(0);+ });++ it('inserts the room history that is not local yet, then rebuilds the context once', async () => {+ const mirroredAt = 1_700_000_000_000;+ const room = [+ roomMessage('m3', 3, 'actor-1', 'reply from laptop', mirroredAt + 2000),+ roomMessage('m2', 2, 'human', 'question on laptop', mirroredAt + 1000),+ roomMessage('m1', 1, 'human', 'mirrored from here', mirroredAt),+ ];+ const { api } = cloud([profilePref], room);+ const local = fakeLocal();+ local.setProfile({ status: 'active', displayName: 'Mia', description: '' });+ local.rows.push({ id: 'own', clientId: 'c-own', role: 'user', content: 'mirrored from here', agentMeta: null, createdAt: mirroredAt });+ const { state } = memoryState();+ const result = await materializeCompanion({ api, state, host: local.host, actor, roomId: async () => ROOM });+ expect(vi.mocked(local.host.insertHistory).mock.calls.map(call => call[1])).toEqual([+ { clientId: 'cloud-history:m2', role: 'user', text: 'question on laptop', createdAt: mirroredAt + 1000 },+ { clientId: 'cloud-history:m3', role: 'assistant', text: 'reply from laptop', createdAt: mirroredAt + 2000 },+ ]);+ expect(result).toMatchObject({ inserted: 2, rebuild: 'rebuilt' });+ expect(local.host.rebuildContext).toHaveBeenCalledOnce();+ // Imported history never moves the mirror cursor: it stays on the newest row written here.+ expect(state.bot('bot_mia')).toMatchObject({ mirror: { sessionId: 'session-1', createdAt: mirroredAt, id: 'own' } });+ expect(state.bot('bot_mia')?.pendingRebuild).toBeUndefined();+ // A second run finds everything local and does not rebuild again.+ const again = await materializeCompanion({ api, state, host: local.host, actor, roomId: async () => ROOM });+ expect(again).toMatchObject({ inserted: 0, rebuild: 'skipped' });+ expect(local.host.rebuildContext).toHaveBeenCalledOnce();+ });++ it('does not re-insert a room message that was already delivered here as a direct-room input', async () => {+ const room = [roomMessage('m9', 9, 'human', 'from the phone', 1_700_000_000_000)];+ const { api } = cloud([profilePref], room);+ const local = fakeLocal();+ local.setProfile({ status: 'active', displayName: 'Mia', description: '' });+ // Delivered later than the room message was written, under its own client id.+ local.rows.push({ id: 'd', clientId: 'chat-direct:exec-1:m9', role: 'user', content: 'from the phone', agentMeta: null, createdAt: 1_700_000_005_000 });+ const result = await materializeCompanion({ api, state: memoryState().state, host: local.host, actor, roomId: async () => ROOM });+ expect(result.inserted).toBe(0);+ expect(local.host.insertHistory).not.toHaveBeenCalled();+ });++ it('stays demoted while the Session is busy, and completes once a retry can rebuild', async () => {+ const { api } = cloud([profilePref], [roomMessage('m1', 1, 'human', 'hello', 1_700_000_000_000)]);+ const local = fakeLocal({ rebuildContext: vi.fn(async (): Promise<'rebuilt' | 'busy'> => 'busy') });+ local.setProfile({ status: 'active', displayName: 'Mia', description: '' });+ const { state } = memoryState();+ await expect(materializeCompanion({ api, state, host: local.host, actor, roomId: async () => ROOM })).rejects.toThrow('CONTEXT_REBUILD_PENDING');+ expect(state.bot('bot_mia')).toMatchObject({ demoted: true, pendingRebuild: true });+ vi.mocked(local.host.rebuildContext).mockResolvedValue('rebuilt');+ expect((await materializeCompanion({ api, state, host: local.host, actor, roomId: async () => ROOM })).rebuild).toBe('rebuilt');+ expect(state.bot('bot_mia')?.demoted).toBeUndefined();+ });++ it('stays demoted until every memory is restored, then the retry completes the take-over', async () => {+ const { api } = cloud([profilePref,+ { key: 'companion.memory.v1:user_ok.md', value: { filename: 'user_ok.md', content: 'ok' } },+ { key: 'companion.memory.v1:user_bad.md', value: { filename: 'user_bad.md', content: 'x' } }]);+ let broken = true;+ const backupHome = vi.fn(async () => '/backup');+ const local = fakeLocal({ backupHome });+ vi.mocked(local.host.restoreMemory).mockImplementation(async (_bot: string, filename: string, raw: string) => {+ if (broken && filename === 'user_bad.md') throw new Error('EBUSY');+ local.memories.set(filename, raw);+ });+ local.setProfile({ status: 'active', displayName: 'Old', description: '' });+ local.memories.set('user_bad.md', 'stale');+ const log = { warn: vi.fn(), info: vi.fn() };+ const { state } = memoryState();+ await expect(materializeCompanion({ api, state, host: local.host, actor, roomId: async () => ROOM, log })).rejects.toThrow('RESTORE_INCOMPLETE');+ expect(log.warn).toHaveBeenCalledWith('Companion content could not be restored', { actorId: 'actor-1', kind: 'memory', code: 'EBUSY' });+ // Not runnable, so the stale file is never uploaded over the cloud value.+ expect(state.bot('bot_mia')?.demoted).toBe(true);+ expect(state.bot('bot_mia')?.prefs['companion.memory.v1:user_ok.md']?.local).toBe(true);+ expect(state.bot('bot_mia')?.prefs['companion.memory.v1:user_bad.md']).toBeUndefined();+ expect(local.host.ensureCanonicalSession).not.toHaveBeenCalled();++ broken = false;+ await materializeCompanion({ api, state, host: local.host, actor, roomId: async () => ROOM, log });+ expect(local.memories.get('user_bad.md')).toBe('x');+ expect(state.bot('bot_mia')?.demoted).toBeUndefined();+ // The never-synced copy was backed up once, not again on the retry.+ expect(backupHome).toHaveBeenCalledTimes(1);+ });++ it('stays demoted when the cloud avatar cannot be restored, and backs the copy up only once', async () => {+ const { api } = cloud([profilePref]);+ const backupHome = vi.fn(async () => '/backup');+ const local = fakeLocal({ backupHome, updateProfile: vi.fn(async () => { throw new Error('AVATAR_UNAVAILABLE'); }) });+ local.setProfile({ status: 'active', displayName: 'Old', description: '' });+ const { state } = memoryState();+ const run = () => materializeCompanion({ api, state, host: local.host, actor: { ...actor, avatar: 'https://cdn/a.png' }, roomId: async () => ROOM });+ await expect(run()).rejects.toThrow('AVATAR_UNAVAILABLE');+ await expect(run()).rejects.toThrow('AVATAR_UNAVAILABLE');+ expect(state.bot('bot_mia')?.demoted).toBe(true);+ expect(backupHome).toHaveBeenCalledTimes(1);+ });++ it('stays demoted until the home has uploaded a profile snapshot', async () => {+ const { api } = cloud([{ key: 'companion.memory.v1:user_tea.md', value: { filename: 'user_tea.md', content: 'tea' } }]);+ const local = fakeLocal();+ local.setProfile({ status: 'active', displayName: 'Mine', description: 'local only' });+ const { state } = memoryState();+ await expect(materializeCompanion({ api, state, host: local.host, actor, roomId: async () => ROOM })).rejects.toThrow('PROFILE_SNAPSHOT_MISSING');+ expect(state.bot('bot_mia')?.demoted).toBe(true);+ expect(local.host.updateProfile).not.toHaveBeenCalled();+ expect(local.host.createProfile).not.toHaveBeenCalled();+ });++ it('seeds the mirror cursor at the newest own row even under many newer imported history rows', async () => {+ const room = Array.from({ length: 60 }, (_, i) => roomMessage(`m${i}`, i + 1, i % 2 ? 'actor-1' : 'human', `cloud ${i}`, 1_700_000_100_000 + i * 1000));+ const { api } = cloud([profilePref], room);+ const local = fakeLocal();+ local.setProfile({ status: 'active', displayName: 'Mia', description: '' });+ local.rows.push({ id: 'own-last', clientId: 'c-own', role: 'assistant', content: 'old local reply', agentMeta: null, createdAt: 1_600_000_000_000 });+ const { state } = memoryState();+ const result = await materializeCompanion({ api, state, host: local.host, actor, roomId: async () => ROOM });+ expect(result.inserted).toBe(60);+ // The copy's own older conversation is behind the cursor: it never goes up to the room.+ expect(state.bot('bot_mia')?.mirror).toMatchObject({ id: 'own-last', createdAt: 1_600_000_000_000 });+ });++ it('stays demoted when the context rebuild fails, until a retry rebuilds it', async () => {+ const { api } = cloud([profilePref], [roomMessage('m1', 1, 'human', 'hello', 1_700_000_000_000)]);+ const local = fakeLocal({ rebuildContext: vi.fn(async (): Promise<'rebuilt' | 'busy'> => { throw new Error('RECOVERY_FAILED'); }) });+ local.setProfile({ status: 'active', displayName: 'Mia', description: '' });+ const { state } = memoryState();+ await expect(materializeCompanion({ api, state, host: local.host, actor, roomId: async () => ROOM })).rejects.toThrow('RECOVERY_FAILED');+ expect(state.bot('bot_mia')).toMatchObject({ demoted: true, pendingRebuild: true });+ vi.mocked(local.host.rebuildContext).mockResolvedValue('rebuilt');+ const retried = await materializeCompanion({ api, state, host: local.host, actor, roomId: async () => ROOM });+ expect(retried.rebuild).toBe('rebuilt');+ expect(state.bot('bot_mia')?.demoted).toBeUndefined();+ expect(state.bot('bot_mia')?.pendingRebuild).toBeUndefined();+ });++ it('refuses a profile that is being deleted', async () => {+ const { api } = cloud([profilePref]);+ const local = fakeLocal();+ local.setProfile({ status: 'deleting', displayName: 'Mia', description: '' });+ await expect(materializeCompanion({ api, state: memoryState().state, host: local.host, actor, roomId: async () => ROOM })).rejects.toThrow('PROFILE_DELETING');+ });+});diff --git a/apps/desktop/src/main/companion-cloud/__tests__/mirror.test.ts b/apps/desktop/src/main/companion-cloud/__tests__/mirror.test.tsnew file mode 100644index 0000000000..1350e118bf--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/__tests__/mirror.test.ts@@ -0,0 +1,195 @@+import { describe, expect, it } from 'vitest';+import { UI_ACTION_TRIGGER_PREFIX } from '../../../shared/interruptedTurn.js';+import { createCompanionMirror, mirrorMessageText, splitMirrorText, type CompanionMirrorCursor, type CompanionMirrorRow } from '../mirror.js';+import { fakeApi, memoryState, rejection } from './fakes.js';++const ROOM = '10000000-0000-4000-8000-000000000001';+let nextId = 0;+const row = (role: string, content: unknown, extra: Partial<CompanionMirrorRow> = {}): CompanionMirrorRow => {+ nextId += 1;+ return { id: `m${String(nextId).padStart(5, '0')}`, clientId: `c${nextId}`, role, agentMeta: null, createdAt: 1_000 + nextId,+ content: typeof content === 'string' ? content : JSON.stringify(content), ...extra };+};+const user = (text: string, extra?: Partial<CompanionMirrorRow>) => row('user', { text, images: [], files: [] }, extra);+const reply = (text: string, extra?: Partial<CompanionMirrorRow>) => row('assistant', [{ type: 'text', text }], extra);++describe('mirrorMessageText', () => {+ it('keeps visible user text with attachment placeholders and assistant replies', () => {+ expect(mirrorMessageText(row('user', { text: 'look', images: [{ url: 'x', originalName: 'cat.png' }], files: [{ name: 'a.pdf', path: '/a.pdf' }] })))+ .toBe('look\n[附件: cat.png]\n[附件: a.pdf]');+ expect(mirrorMessageText(reply('hello'))).toBe('hello');+ });+ it('keeps an attachment-only message as placeholders, but not one from another source', () => {+ expect(mirrorMessageText(row('user', { text: '', images: [{ url: 'x', originalName: 'cat.png' }], files: [] }))).toBe('[附件: cat.png]');+ expect(mirrorMessageText(row('user', { text: '', images: [{ url: 'x' }], files: [] },+ { agentMeta: JSON.stringify({ imSource: { channel: 'feishu' } }) }))).toBeNull();+ });+ it.each([+ ['tool rows', row('tool_use', { name: 'Bash' })],+ ['thinking rows', row('thinking', 'hmm')],+ ['hidden synthetic input', row('user', `${UI_ACTION_TRIGGER_PREFIX}continue`)],+ ['messages that came from the room', user('hi', { clientId: 'chat-direct:exec-1' })],+ ['imported cloud history', reply('old', { clientId: 'cloud-history:abc' })],+ ['empty text', reply(' ')],+ ['private coordination replies', reply('internal', { agentMeta: JSON.stringify({ botPrivateReply: true }) })],+ ['progress commentary', reply('checking files', { agentMeta: JSON.stringify({ assistantPhase: 'commentary' }) })],+ ['sub-agent output', reply('sub result', { agentMeta: JSON.stringify({ parentToolUseId: 'toolu_1' }) })],+ ['sub-agent output (snake case)', reply('sub result', { agentMeta: JSON.stringify({ parent_tool_use_id: 'toolu_1' }) })],+ ['Claude sub-agent output (parentUuid)', reply('sub result', { agentMeta: JSON.stringify({ parentUuid: 'toolu_subagent' }) })],+ ['input sent by another task or teammate', user('do this', { agentMeta: JSON.stringify({ origin: { kind: 'session', senderSessionId: 's' } }) })],+ ['input from an automation', user('scheduled', { agentMeta: JSON.stringify({ origin: { kind: 'scheduler', scheduleId: 'r' } }) })],+ ['input from a plugin', user('plugin says', { agentMeta: JSON.stringify({ sourcePlugin: { pluginId: 'p' } }) })],+ ['input from an IM channel', user('from feishu', { agentMeta: JSON.stringify({ imSource: { channel: 'feishu' } }) })],+ ['input from a shared-task member', user('guest', { agentMeta: JSON.stringify({ sharedTaskAuthor: { memberId: 'm' } }) })],+ ['a group-sourced message', user('group', { agentMeta: JSON.stringify({ sourceGroup: { groupId: 'g' } }) })],+ ])('drops %s', (_name, value) => {+ expect(mirrorMessageText(value)).toBeNull();+ });+});++describe('owner-typed input', () => {+ it('keeps what the owner typed on another device', () => {+ expect(mirrorMessageText(user('from my phone', { agentMeta: JSON.stringify({ sourceDevice: { deviceId: 'phone', platform: 'mobile' } }) })))+ .toBe('from my phone');+ });+});++describe('splitMirrorText', () => {+ it('splits long and multibyte text into room-sized parts', () => {+ const ascii = splitMirrorText('a'.repeat(65_000));+ expect(ascii.map(part => part.length)).toEqual([30_000, 30_000, 5_000]);+ const cjk = splitMirrorText('字'.repeat(30_000));+ expect(cjk.join('')).toBe('字'.repeat(30_000));+ expect(cjk.every(part => Buffer.byteLength(JSON.stringify(part)) <= 60_000)).toBe(true);+ const emoji = splitMirrorText('😀'.repeat(20_000));+ expect(emoji.join('')).toBe('😀'.repeat(20_000));+ expect(emoji.every(part => !/[\uD800-\uDBFF]$/.test(part))).toBe(true);+ });+});++function setup(rows: CompanionMirrorRow[], failImport?: (call: number) => boolean) {+ let imports = 0;+ const { api, calls } = fakeApi((route, method) => {+ if (route === '/conversations' && method === 'POST') return { id: ROOM };+ if (route.endsWith('/import')) {+ imports += 1;+ if (failImport?.(imports)) throw rejection(503, 'UNAVAILABLE');+ return { messages: [] };+ }+ throw new Error(`unexpected ${route}`);+ });+ const { state } = memoryState();+ const after = (cursor: CompanionMirrorCursor) => (r: CompanionMirrorRow) =>+ r.createdAt > cursor.createdAt || (r.createdAt === cursor.createdAt && r.id > cursor.id);+ const mirror = createCompanionMirror({+ api, state, humanActorId: () => 'human',+ canonicalSession: async () => 'session-1',+ rowsAfter: async (_sessionId, cursor, limit) => rows.filter(after(cursor))+ .sort((a, b) => a.createdAt - b.createdAt || a.id.localeCompare(b.id)).slice(0, limit),+ latestRows: async (_sessionId, limit) => [...rows].reverse().slice(0, limit),+ });+ const imported = () => calls.filter(call => call.route.endsWith('/import'))+ .map(call => (call.data as { messages: Array<{ sourceId: string; authorId: string; content: Array<{ text: string }> }> }).messages);+ return { mirror, state, calls, imported, rows };+}++describe('companion conversation mirror', () => {+ it('creates the deterministic room once and imports authored messages in order', async () => {+ const rows = [user('hi'), row('tool_use', {}), reply('hello')];+ const t = setup(rows);+ await t.mirror.syncBot('bot', 'actor', 'Mia');+ expect(t.calls[0]).toMatchObject({ route: '/conversations', method: 'POST',+ data: { operationId: 'companion-room:actor', kind: 'direct', name: 'Mia', participants: ['actor'], sourceId: 'actor' } });+ expect(t.imported()).toEqual([[+ expect.objectContaining({ sourceId: `cindy:session-1:${rows[0]!.id}`, authorId: 'human', content: [{ type: 'text', text: 'hi' }],+ createdAt: new Date(rows[0]!.createdAt).toISOString() }),+ expect.objectContaining({ sourceId: `cindy:session-1:${rows[2]!.id}`, authorId: 'actor', content: [{ type: 'text', text: 'hello' }] }),+ ]]);+ expect(t.state.bot('bot')).toMatchObject({ roomId: ROOM, mirror: { sessionId: 'session-1', id: rows[2]!.id } });+ rows.push(user('again'));+ await t.mirror.syncBot('bot', 'actor', 'Mia');+ expect(t.calls.filter(call => call.route === '/conversations')).toHaveLength(1);+ expect(t.imported()[1]!.map(m => m.content[0]!.text)).toEqual(['again']);+ });++ it('backfills only the latest 200 eligible messages on the first run', async () => {+ const rows = Array.from({ length: 260 }, (_, i) => (i % 2 ? reply(`r${i}`) : user(`u${i}`)));+ const t = setup(rows);+ await t.mirror.syncBot('bot', 'actor', 'Mia');+ const batches = t.imported();+ expect(batches.map(batch => batch.length)).toEqual([50, 50, 50, 50]);+ expect(batches.flat()[0]!.content[0]!.text).toBe('u60');+ expect(batches.flat().at(-1)!.content[0]!.text).toBe('r259');+ });++ it('advances the cursor only past successfully imported batches', async () => {+ const rows = Array.from({ length: 120 }, (_, i) => user(`u${i}`));+ const t = setup([], call => call === 2);+ // Start from an existing cursor so the rows are read incrementally.+ t.state.update('bot', 'actor', entry => { entry.mirror = { sessionId: 'session-1', createdAt: 0, id: '' }; });+ t.rows.push(...rows);+ await expect(t.mirror.syncBot('bot', 'actor', 'Mia')).rejects.toThrow('UNAVAILABLE');+ expect(t.state.bot('bot')?.mirror?.id).toBe(rows[49]!.id);+ await t.mirror.syncBot('bot', 'actor', 'Mia');+ const texts = t.imported().map(batch => batch.map(m => m.content[0]!.text));+ expect(texts[2]![0]).toBe('u50');+ expect(t.state.bot('bot')?.mirror?.id).toBe(rows[119]!.id);+ });++ it('caps an ordinary pass at ten pages, but drains the whole backlog before a hand-over', async () => {+ const t = setup([]);+ t.state.update('bot', 'actor', entry => { entry.mirror = { sessionId: 'session-1', createdAt: 0, id: '' }; });+ t.rows.push(...Array.from({ length: 2_300 }, (_, i) => user(`u${i}`)));+ const last = t.rows.at(-1)!.id;+ await t.mirror.syncBot('bot', 'actor', 'Mia');+ expect(t.state.bot('bot')?.mirror?.id).not.toBe(last);+ await t.mirror.syncBot('bot', 'actor', 'Mia', { drain: true });+ expect(t.state.bot('bot')?.mirror?.id).toBe(last);+ });++ it('splits a long reply into parts with stable source ids', async () => {+ const long = reply('y'.repeat(31_000));+ const t = setup([long]);+ await t.mirror.syncBot('bot', 'actor', 'Mia');+ expect(t.imported()[0]!.map(m => m.sourceId)).toEqual([`cindy:session-1:${long.id}`, `cindy:session-1:${long.id}:p1`]);+ });++ it('does nothing without a canonical Session', async () => {+ const { api, calls } = fakeApi(() => ({}));+ const mirror = createCompanionMirror({ api, state: memoryState().state, humanActorId: () => 'human',+ canonicalSession: async () => null, rowsAfter: async () => [], latestRows: async () => [] });+ await mirror.syncBot('bot', 'actor', 'Mia');+ expect(calls).toEqual([]);+ });+});++describe('cursor safety', () => {+ it('re-scans a trailing window for rows persisted late, without re-sending recent imports', async () => {+ const rows = [user('one'), reply('two')];+ const t = setup(rows);+ await t.mirror.syncBot('bot', 'actor', 'Mia');+ expect(t.imported()).toHaveLength(1);+ // An assistant reply stamped before the cursor but persisted after the last pass.+ const late = reply('late reply', { createdAt: rows[1]!.createdAt - 1 });+ t.rows.push(late);+ t.rows.sort((a, b) => a.createdAt - b.createdAt || a.id.localeCompare(b.id));+ await t.mirror.syncBot('bot', 'actor', 'Mia');+ expect(t.imported()[1]!.map(m => m.content[0]!.text)).toEqual(['late reply']);+ await t.mirror.syncBot('bot', 'actor', 'Mia');+ expect(t.imported()).toHaveLength(2);+ });++ it('never lets imported history move the cursor forward', async () => {+ const own = user('mine');+ const t = setup([own]);+ await t.mirror.syncBot('bot', 'actor', 'Mia');+ // A row brought in by take-over, stamped by a peer clock far in the future.+ t.rows.push(reply('from peer', { clientId: 'cloud-history:x', createdAt: own.createdAt + 86_400_000 }));+ await t.mirror.syncBot('bot', 'actor', 'Mia');+ expect(t.state.bot('bot')?.mirror?.id).toBe(own.id);+ const next = user('typed after');+ t.rows.push(next);+ await t.mirror.syncBot('bot', 'actor', 'Mia');+ expect(t.imported().at(-1)!.map(m => m.content[0]!.text)).toEqual(['typed after']);+ });+});diff --git a/apps/desktop/src/main/companion-cloud/__tests__/state.test.ts b/apps/desktop/src/main/companion-cloud/__tests__/state.test.tsnew file mode 100644index 0000000000..4ebb80eb40--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/__tests__/state.test.ts@@ -0,0 +1,50 @@+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';+import os from 'node:os';+import path from 'node:path';+import { afterEach, describe, expect, it, vi } from 'vitest';+import { createCompanionCloudState } from '../state.js';++describe('companion sync state file', () => {+ let dir = '';+ afterEach(() => { if (dir) rmSync(dir, { recursive: true, force: true }); dir = ''; });++ it('starts empty from a corrupt file and persists updates atomically', () => {+ dir = mkdtempSync(path.join(os.tmpdir(), 'companion-state-'));+ const filePath = path.join(dir, 'nested', 'state.json');+ const log = { warn: vi.fn() };+ writeFileSync(path.join(dir, 'corrupt.json'), '{not json');+ const corrupt = createCompanionCloudState({ filePath: path.join(dir, 'corrupt.json'), log });+ expect(corrupt.bot('a')).toBeNull();+ expect(log.warn).toHaveBeenCalledOnce();++ const state = createCompanionCloudState({ filePath });+ state.update('a', 'actor-a', entry => { entry.roomId = 'room'; entry.prefs.k = { hash: 'h', revision: 2 }; });+ const reread = createCompanionCloudState({ filePath });+ expect(reread.bot('a')).toEqual({ actorId: 'actor-a', roomId: 'room', prefs: { k: { hash: 'h', revision: 2 } } });+ expect(reread.botForRoom('room')).toBe('a');+ expect(JSON.parse(readFileSync(filePath, 'utf8')).version).toBe(1);+ // A different cloud actor for the same local id starts from scratch.+ reread.update('a', 'actor-b', () => undefined);+ expect(reread.bot('a')).toEqual({ actorId: 'actor-b', prefs: {} });+ });++ it('applies an update in this run when the disk write fails, and saves it with the next one', () => {+ const writes: string[] = [];+ let failing = true;+ const state = createCompanionCloudState({ filePath: 'state.json', io: { read: () => null, write: (_path, contents) => {+ if (failing) throw Object.assign(new Error('disk full'), { code: 'ENOSPC' });+ writes.push(contents);+ } } });+ state.update('a', 'actor', entry => { entry.demoted = true; });+ expect(state.isDemoted('a')).toBe(true);+ failing = false;+ state.update('b', 'actor-b', () => undefined);+ expect(JSON.parse(writes.at(-1)!).bots.a.demoted).toBe(true);+ });++ it('refuses writes after the account changed', () => {+ const state = createCompanionCloudState({ filePath: 'unused.json', current: () => false,+ io: { read: () => null, write: () => { throw new Error('must not write'); } } });+ expect(() => state.update('a', 'actor', () => undefined)).toThrow('OWNER_CHANGED');+ });+});diff --git a/apps/desktop/src/main/companion-cloud/__tests__/twoDevices.harness.test.ts b/apps/desktop/src/main/companion-cloud/__tests__/twoDevices.harness.test.tsnew file mode 100644index 0000000000..3238e9f6b1--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/__tests__/twoDevices.harness.test.ts@@ -0,0 +1,377 @@+/**+ * Opt-in end-to-end proof against a REAL chat-server (cloud-companions.md): two "devices"+ * of one owner, each with its own state file and in-memory local host, drive the real+ * companion-cloud modules. Skipped unless CINDY_CHAT_HARNESS_URL points at a throwaway+ * server whose stub auth accepts `<owner>@<device>` bearer tokens.+ *+ * CINDY_CHAT_HARNESS_URL=http://127.0.0.1:3018 npx vitest run --project standard \+ * src/main/companion-cloud/__tests__/twoDevices.harness.test.ts+ */+import { randomUUID } from 'node:crypto';+import { mkdtempSync, rmSync } from 'node:fs';+import os from 'node:os';+import path from 'node:path';+import { afterAll, describe, expect, it } from 'vitest';+import type { DeviceLinkDeviceView } from '../../../shared/deviceLinkIpc.js';+import { UI_ACTION_TRIGGER_PREFIX } from '../../../shared/interruptedTurn.js';+import { DIRECT_ROOM_COMPLETION, deliverDirectRoomMessage } from '../directRoom.js';+import { companionSnapshot, createCompanionHomeRegistry, registerCompanionHomes } from '../homes.js';+import type { CompanionMirrorRow } from '../mirror.js';+import { startCompanionCloud, type CompanionCloudHost, type CompanionCloudRuntime, type CompanionRuntimeActor } from '../runtime.js';+import { createCompanionCloudState } from '../state.js';+import type { CompanionApi } from '../types.js';+import { COMPANION_MEMORY_PREFIX, COMPANION_PROFILE_KEY, COMPANION_SKILL_PREFIX, type CompanionPreferenceValue } from '../uploader.js';++const BASE = process.env.CINDY_CHAT_HARNESS_URL?.replace(/\/$/, '');+const OWNER = `e2e${Date.now().toString(36)}${randomUUID().slice(0, 6)}`;+const BOT = `bot_e2e_${randomUUID().slice(0, 8)}`;+const tempDirs: string[] = [];++/** Same error contract as chatServer.ts: code as message, `status` and `details` on the error. */+function harnessApi(token: string, calls: Array<{ route: string; method: string }>): CompanionApi {+ return async <T>(route: string, method = 'GET', data?: unknown, actorId?: string): Promise<T> => {+ calls.push({ route, method });+ const response = await fetch(`${BASE}/v1${route}`, {+ method,+ headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json', ...(actorId ? { 'X-Chat-Actor': actorId } : {}) },+ body: data === undefined ? undefined : JSON.stringify(data),+ });+ const text = await response.text();+ let value: { error?: { code?: string; details?: unknown } } & Record<string, unknown>;+ try { value = JSON.parse(text); } catch { throw Object.assign(new Error('INVALID_CHAT_RESPONSE'), { status: response.status }); }+ if (response.status >= 400) {+ throw Object.assign(new Error(typeof value?.error?.code === 'string' ? value.error.code : 'REQUEST_FAILED'),+ { status: response.status, details: value?.error?.details });+ }+ return value as T;+ };+}++interface LocalBot { status: string; displayName: string; description: string; soul: string; user: string; systemPrompt: string }++/** One computer: its own token/device claim, state file and in-memory local companion data. */+async function createDevice(name: string, peers: () => DeviceLinkDeviceView[], options: { installationId?: string } = {}) {+ const calls: Array<{ route: string; method: string }> = [];+ const api = harnessApi(`${OWNER}@${name}`, calls);+ const dir = mkdtempSync(path.join(os.tmpdir(), `companion-${name}-`));+ tempDirs.push(dir);+ const profiles = new Map<string, LocalBot>();+ const memories = new Map<string, Map<string, string>>();+ const skills = new Map<string, Map<string, string>>();+ const sessions = new Map<string, string>();+ const rows = new Map<string, CompanionMirrorRow[]>();+ const deliveries: Array<{ botId: string; text: string; clientId: string }> = [];+ const rebuilds: string[] = [];+ let alive = true;+ let rowClock = Date.now();+ const sessionRows = (sessionId: string) => rows.get(sessionId) ?? (rows.set(sessionId, []), rows.get(sessionId)!);+ const visible = (sessionId: string) => sessionRows(sessionId).filter(row => row.role === 'user' || row.role === 'assistant')+ .sort((a, b) => a.createdAt - b.createdAt || a.id.localeCompare(b.id));+ const addRow = (sessionId: string, role: string, content: unknown, clientId = `c-${randomUUID()}`, createdAt = (rowClock = Math.max(rowClock + 1, Date.now()))) => {+ const row = { id: `m-${randomUUID()}`, clientId, role, content: typeof content === 'string' ? content : JSON.stringify(content), agentMeta: null, createdAt };+ sessionRows(sessionId).push(row);+ return row;+ };+ const ensureSession = (botId: string) => {+ if (!sessions.has(botId)) sessions.set(botId, `session-${name}-${randomUUID().slice(0, 8)}`);+ return sessions.get(botId)!;+ };++ const homes = createCompanionHomeRegistry();+ const host: CompanionCloudHost = {+ homes,+ openState: (_endpoint, _human, current) => createCompanionCloudState({ filePath: path.join(dir, 'state.json'), current }),+ // Same value shapes as host.ts readCompanionValues.+ readValues: async (botId) => {+ const profile = profiles.get(botId);+ if (!profile) return [];+ const values: CompanionPreferenceValue[] = [{ key: COMPANION_PROFILE_KEY, value: {+ name: profile.displayName, description: profile.description, soul: profile.soul, systemPrompt: profile.systemPrompt, user: profile.user } }];+ for (const [filename, content] of memories.get(botId) ?? []) values.push({ key: `${COMPANION_MEMORY_PREFIX}${filename}`, value: { filename, content } });+ for (const [slug, content] of skills.get(botId) ?? []) values.push({ key: `${COMPANION_SKILL_PREFIX}${slug}`, value: { slug, content } });+ return values;+ },+ canonicalSession: async (botId) => sessions.get(botId) ?? null,+ rowsAfter: async (sessionId, cursor, limit) => visible(sessionId)+ .filter(row => row.createdAt > cursor.createdAt || (row.createdAt === cursor.createdAt && row.id > cursor.id)).slice(0, limit),+ latestRows: async (sessionId, limit, options) => visible(sessionId).reverse()+ .filter(row => !options?.excludeClientIdPrefix || !row.clientId.startsWith(options.excludeClientIdPrefix)).slice(0, limit),+ deliverToCanonical: async (botId, text, clientId) => {+ deliveries.push({ botId, text, clientId });+ addRow(ensureSession(botId), 'user', text, clientId);+ return { ok: true };+ },+ materializer: {+ readProfile: async (botId) => profiles.get(botId) ?? null,+ createProfile: async (input) => {+ profiles.set(input.id, { status: 'active', displayName: input.name, description: input.description,+ soul: input.identitySource, user: input.userContextSource, systemPrompt: '' });+ },+ updateProfile: async (input) => {+ const current = profiles.get(input.id)!;+ profiles.set(input.id, { ...current, status: 'active', displayName: input.name,+ description: input.description ?? current.description, soul: input.identitySource ?? current.soul, user: input.userContextSource ?? current.user });+ },+ writeSystemPrompt: async (botId, text) => { profiles.get(botId)!.systemPrompt = text; },+ readMemory: async (botId, filename) => memories.get(botId)?.get(filename) ?? null,+ restoreMemory: async (botId, filename, raw) => { (memories.get(botId) ?? (memories.set(botId, new Map()), memories.get(botId)!)).set(filename, raw); },+ removeMemory: async (botId, filename) => { memories.get(botId)?.delete(filename); },+ readSkill: async (botId, slug) => skills.get(botId)?.get(slug) ?? null,+ saveSkill: async (botId, slug, content, _enabled) => { (skills.get(botId) ?? (skills.set(botId, new Map()), skills.get(botId)!)).set(slug, content); },+ removeSkill: async (botId, slug) => { skills.get(botId)?.delete(slug); },+ ensureCanonicalSession: async (botId) => ensureSession(botId),+ localMessageTimes: async (sessionId, fromMs) => visible(sessionId).filter(row => row.createdAt >= fromMs)+ .map(row => ({ role: row.role, createdAt: row.createdAt, clientId: row.clientId })),+ insertHistory: async (sessionId, row) => {+ addRow(sessionId, row.role, row.role === 'user' ? { text: row.text, images: [], files: [] } : [{ type: 'text', text: row.text }], row.clientId, row.createdAt);+ },+ rebuildContext: async (sessionId) => { rebuilds.push(sessionId); return 'rebuilt'; },+ },+ listDevices: async () => peers(),+ probeCompanionCloud: async () => true,+ ...(options.installationId ? { installationId: () => options.installationId! } : {}),+ };++ let selfDeviceId = '';+ let humanActorId = '';+ let actors: CompanionRuntimeActor[] = [];+ let runtime: CompanionCloudRuntime;+ const publish = () => {+ homes.update(companionSnapshot({ enabled: true, selfDeviceId, humanActorId, actors, demotedBotIds: runtime.shadowIds() }));+ };+ /** The companion part of chatServer.register(), forced. */+ const refresh = async () => {+ const me = await api<{ actor: { id: string }; deviceId: string; capabilities?: { companionHome?: boolean } }>('/me');+ expect(me.capabilities?.companionHome).toBe(true);+ expect(me.deviceId).toBe(name);+ actors = await api<CompanionRuntimeActor[]>('/actors');+ for (const [id, profile] of profiles) {+ if (profile.status !== 'active' || actors.some(actor => actor.kind === 'bot' && actor.externalId === id)) continue;+ actors.push(await api<CompanionRuntimeActor>('/actors', 'POST', { operationId: randomUUID(), kind: 'bot', externalId: id, name: profile.displayName }));+ }+ await registerCompanionHomes({ api, selfDeviceId, actors, isDemoted: botId => runtime.state.isDemoted(botId),+ botIds: [...profiles].filter(([, profile]) => profile.status === 'active').map(([id]) => id) });+ runtime.reconcile([...profiles].map(([id, profile]) => ({ id, status: profile.status })));+ publish();+ };+ const start = () => {+ alive = true;+ runtime = startCompanionCloud({ api, host, endpoint: BASE!, humanActorId, selfDeviceId, current: () => alive,+ bots: () => actors.filter(actor => actor.kind === 'bot' && !actor.disabled && actor.homeDeviceId === selfDeviceId+ && profiles.get(actor.externalId)?.status === 'active' && !runtime.isShadowed(actor.externalId))+ .map(actor => ({ botId: actor.externalId, actorId: actor.id, name: actor.name })),+ actors: () => actors, refresh, publish, initialKick: false, uploadIntervalMs: 3_600_000, mirrorIntervalMs: 3_600_000 });+ };+ const me = await api<{ actor: { id: string }; deviceId: string }>('/me');+ humanActorId = me.actor.id;+ selfDeviceId = me.deviceId;+ start();+ return {+ name, api, calls, deliver: host.deliverToCanonical, profiles, memories, skills, sessions, rows, deliveries, rebuilds, homes, addRow, ensureSession, visible, refresh,+ get runtime() { return runtime; },+ get humanActorId() { return humanActorId; },+ actor: (botId: string) => actors.find(actor => actor.kind === 'bot' && actor.externalId === botId),+ /** Go offline: every loop stops and nothing reaches the server. */+ stop: () => { alive = false; runtime.dispose(); },+ /** Come back with whatever (possibly stale) actor list it had. */+ restart: () => start(),+ };+}++const eligible = (deviceId: string): DeviceLinkDeviceView => ({ deviceId, name: deviceId, platform: 'darwin', appVersion: '1',+ lastSeenAt: null, online: true, busy: false, remoteControlEnabled: true, controlEnabled: true, isSelf: false });+const waitFor = async <T>(read: () => Promise<T | null | undefined | false> | T | null | undefined | false, label: string, timeoutMs = 15_000): Promise<T> => {+ const deadline = Date.now() + timeoutMs;+ for (;;) {+ const value = await read();+ if (value) return value as T;+ if (Date.now() > deadline) throw new Error(`Timed out waiting for ${label}`);+ await new Promise(resolve => setTimeout(resolve, 150));+ }+};++describe.skipIf(!BASE)('cloud companions against a real chat-server (two devices)', () => {+ afterAll(() => { for (const dir of tempDirs) rmSync(dir, { recursive: true, force: true }); });++ it('registers, syncs, takes over, conflicts, hands over and retires one companion', { timeout: 120_000 }, async () => {+ const macmini = await createDevice('macmini', () => [eligible('laptop')]);+ const laptop = await createDevice('laptop', () => [eligible('macmini')]);+ const prefsOf = async (actorId: string) => new Map((await macmini.api<Array<{ key: string; value: unknown; revision: number }>>(+ '/preferences', 'GET', undefined, actorId)).map(row => [row.key, row.value]));++ // 1. macmini registers the companion and becomes its home; laptop sees that.+ macmini.profiles.set(BOT, { status: 'active', displayName: 'E2E Mia', description: 'tester', soul: 'I am Mia v1', user: 'Owner likes tea', systemPrompt: 'Be brief' });+ macmini.memories.set(BOT, new Map([['user_tea.md', '---\ntitle: Tea\n---\nlikes tea'], ['reference_old.md', '---\ntitle: Old\n---\nold fact']]));+ macmini.skills.set(BOT, new Map([['brew', '---\nname: "brew"\n---\n\nsteps v1\n']]));+ const macSession = macmini.ensureSession(BOT);+ await macmini.refresh();+ const actorId = macmini.actor(BOT)!.id;+ expect(macmini.actor(BOT)!.homeDeviceId).toBe('macmini');+ expect(macmini.homes.isHomeHere(BOT)).toBe(true);+ await laptop.refresh();+ expect(laptop.homes.homeOf(BOT)).toBe('macmini');+ expect(laptop.homes.isHomeHere(BOT)).toBe(false);++ // 2. Profile, memories and a skill change; the uploader pushes them, a removed memory is tombstoned.+ await macmini.runtime.syncNow();+ macmini.profiles.get(BOT)!.soul = 'I am Mia v2';+ macmini.memories.get(BOT)!.delete('reference_old.md');+ macmini.memories.get(BOT)!.set('project_launch.md', '---\ntitle: Launch\n---\nship on Friday');+ macmini.skills.get(BOT)!.set('brew', '---\nname: "brew"\n---\n\nsteps v2\n');+ await macmini.runtime.syncNow();+ const prefs = await prefsOf(actorId);+ expect(prefs.get(COMPANION_PROFILE_KEY)).toEqual({ name: 'E2E Mia', description: 'tester', soul: 'I am Mia v2', user: 'Owner likes tea', systemPrompt: 'Be brief' });+ expect(prefs.get(`${COMPANION_MEMORY_PREFIX}user_tea.md`)).toEqual({ filename: 'user_tea.md', content: '---\ntitle: Tea\n---\nlikes tea' });+ expect(prefs.get(`${COMPANION_MEMORY_PREFIX}project_launch.md`)).toEqual({ filename: 'project_launch.md', content: '---\ntitle: Launch\n---\nship on Friday' });+ expect(prefs.has(`${COMPANION_MEMORY_PREFIX}reference_old.md`)).toBe(true);+ expect(prefs.get(`${COMPANION_MEMORY_PREFIX}reference_old.md`)).toBeNull();+ expect(prefs.get(`${COMPANION_SKILL_PREFIX}brew`)).toEqual({ slug: 'brew', content: '---\nname: "brew"\n---\n\nsteps v2\n' });++ // 3. Only visible user/assistant rows reach the deterministic 1:1 room; a rerun imports nothing.+ macmini.addRow(macSession, 'user', { text: 'hello', images: [], files: [] });+ macmini.addRow(macSession, 'user', `${UI_ACTION_TRIGGER_PREFIX}hidden continuation`);+ macmini.addRow(macSession, 'tool_use', { name: 'Bash' });+ macmini.addRow(macSession, 'assistant', [{ type: 'text', text: 'hi there' }]);+ macmini.addRow(macSession, 'user', 'already in the room', 'chat-direct:earlier:00000000-0000-4000-8000-000000000000');+ await macmini.runtime.syncNow();+ const roomId = macmini.runtime.roomIdFor(BOT)!;+ expect(roomId).toMatch(/^[0-9a-f-]{36}$/);+ const importsBefore = macmini.calls.filter(call => call.route.endsWith('/import')).length;+ await macmini.runtime.syncNow();+ expect(macmini.calls.filter(call => call.route.endsWith('/import')).length).toBe(importsBefore);+ const first = await laptop.runtime.transcript(BOT);+ expect(first.messages.map(m => [m.role, m.text])).toEqual([['user', 'hello'], ['assistant', 'hi there']]);+ expect(laptop.runtime.roomIdFor(BOT)).toBe(roomId);++ // 4. A message written straight into the room is claimed only by the home and delivered to its main task.+ const posted = await laptop.api<{ id: string }>(`/conversations/${roomId}/messages`, 'POST',+ { operationId: `e2e-post-${randomUUID()}`, content: [{ type: 'text', text: 'from laptop' }], mentions: [] });+ const queued = await waitFor(async () => (await laptop.api<Array<{ id: string; source_message_id: string; status: string }>>(+ `/conversations/${roomId}/executions`)).find(e => e.source_message_id === posted.id && e.status === 'queued'), 'queued execution');+ const claim = { executorId: 'desktop:e2e', accessPolicyVersion: 1, planVersion: 1 };+ const laptopClaim = await laptop.api<{ execution: unknown }>('/executions/claim', 'POST', { operationId: randomUUID(), ...claim }, actorId);+ expect(laptopClaim.execution).toBeNull();+ const execution = await waitFor(async () => (await macmini.api<{ execution: { id: string; epoch: number; source_message_id: string } | null }>(+ '/executions/claim', 'POST', { operationId: randomUUID(), ...claim }, actorId)).execution, 'macmini claim');+ expect(execution.id).toBe(queued.id);+ const clientId = await deliverDirectRoomMessage({ api: macmini.api, roomId, executionId: execution.id, sourceMessageId: execution.source_message_id,+ humanActorId: macmini.humanActorId, botId: BOT, deliver: macmini.deliver,+ beforeDeliver: async () => { await macmini.api(`/conversations/${roomId}/executions/${execution.id}`, 'POST', { operationId: randomUUID(), executorId: 'desktop:e2e', epoch: execution.epoch, action: 'heartbeat' }, actorId); } });+ expect(clientId).toBe(`chat-direct:${execution.id}:${posted.id}`);+ expect(macmini.deliveries).toEqual([{ botId: BOT, text: 'from laptop', clientId }]);+ const roomBefore = (await laptop.api<unknown[]>(`/conversations/${roomId}/messages?limit=100`)).length;+ await macmini.api(`/conversations/${roomId}/executions/${execution.id}`, 'POST', {+ operationId: `chat:${execution.id}:${execution.epoch}:complete`, executorId: 'desktop:e2e', epoch: execution.epoch, action: 'complete', ...DIRECT_ROOM_COMPLETION,+ }, actorId);+ const settled = (await laptop.api<Array<{ id: string; status: string; output_message_id: string | null }>>(`/conversations/${roomId}/executions`))+ .find(e => e.id === execution.id)!;+ expect(settled.status).toBe('succeeded');+ expect(settled.output_message_id).toBeNull();+ expect((await laptop.api<unknown[]>(`/conversations/${roomId}/messages?limit=100`)).length).toBe(roomBefore);+ // The reply reaches the room through the mirror; the delivered input itself is not mirrored again.+ macmini.addRow(macSession, 'assistant', [{ type: 'text', text: 'reply to laptop' }]);+ await macmini.runtime.syncNow();+ const second = await laptop.runtime.transcript(BOT);+ expect(second.messages.map(m => [m.role, m.text])).toEqual([+ ['user', 'hello'], ['assistant', 'hi there'], ['user', 'from laptop'], ['assistant', 'reply to laptop']]);++ // 5. macmini goes offline; laptop takes over and builds the companion from the cloud.+ macmini.stop();+ expect(await laptop.runtime.takeOver(BOT)).toEqual({ ok: true });+ expect(laptop.actor(BOT)!.homeDeviceId).toBe('laptop');+ expect(laptop.profiles.get(BOT)).toEqual({ status: 'active', displayName: 'E2E Mia', description: 'tester',+ soul: 'I am Mia v2', user: 'Owner likes tea', systemPrompt: 'Be brief' });+ expect([...laptop.memories.get(BOT)!.keys()].sort()).toEqual(['project_launch.md', 'user_tea.md']);+ expect(laptop.skills.get(BOT)!.get('brew')).toBe('---\nname: "brew"\n---\n\nsteps v2\n');+ const lapSession = laptop.sessions.get(BOT)!;+ const history = laptop.visible(lapSession);+ expect(history.map(row => [row.role, row.clientId.startsWith('cloud-history:')])).toEqual([+ ['user', true], ['assistant', true], ['user', true], ['assistant', true]]);+ expect(laptop.rebuilds).toEqual([lapSession]);+ expect(laptop.runtime.state.bot(BOT)?.demoted).toBeUndefined();+ // Taking over again is idempotent: nothing is inserted twice and no second rebuild.+ expect(await laptop.runtime.takeOver(BOT)).toEqual({ ok: true });+ expect(laptop.visible(lapSession)).toHaveLength(4);+ expect(laptop.rebuilds).toHaveLength(1);++ // 6. macmini comes back with a stale actor list: its take-over loses the compare-and-set.+ macmini.restart();+ expect(macmini.actor(BOT)!.homeDeviceId).toBe('macmini');+ expect(await macmini.runtime.takeOver(BOT)).toEqual({ ok: false, code: 'HOME_CONFLICT', homeDeviceId: 'laptop' });+ expect(macmini.runtime.state.isDemoted(BOT)).toBe(true);+ expect(macmini.homes.snapshot().demotedBotIds).toEqual([BOT]);+ expect(macmini.homes.isHomeHere(BOT)).toBe(false);+ const macCallsBefore = macmini.calls.length;+ macmini.memories.get(BOT)!.set('user_stale.md', '---\ntitle: Stale\n---\nmust not upload');+ macmini.addRow(macSession, 'assistant', [{ type: 'text', text: 'stale reply' }]);+ await macmini.runtime.syncNow();+ expect(macmini.calls.slice(macCallsBefore).filter(call => call.method !== 'GET')).toEqual([]);++ // 7. laptop hands the companion back: flush first, then the move, then macmini picks it up.+ laptop.addRow(lapSession, 'user', { text: 'on laptop', images: [], files: [] });+ laptop.addRow(lapSession, 'assistant', [{ type: 'text', text: 'laptop reply' }]);+ const lapCallsBefore = laptop.calls.length;+ expect(await laptop.runtime.transfer(BOT, 'macmini')).toEqual({ ok: true });+ const transferCalls = laptop.calls.slice(lapCallsBefore).map(call => `${call.method} ${call.route}`);+ const patchAt = transferCalls.indexOf(`PATCH /actors/${actorId}`);+ expect(patchAt).toBeGreaterThan(-1);+ expect(transferCalls.findIndex(call => call.endsWith('/import'))).toBeLessThan(patchAt);+ expect(laptop.runtime.state.isDemoted(BOT)).toBe(true);+ expect(laptop.homes.snapshot().demotedBotIds).toEqual([BOT]);+ await macmini.refresh();+ await waitFor(() => !macmini.runtime.state.isDemoted(BOT), 'macmini auto-materialize');+ await waitFor(() => macmini.rebuilds.length === 1, 'macmini rebuild');+ const macHistory = macmini.visible(macSession);+ const inserted = macHistory.filter(row => row.clientId.startsWith('cloud-history:'));+ // Rows mirrored from here and the delivered room message are recognised; only laptop's are new.+ expect(inserted.map(row => [row.role, JSON.parse(row.content)])).toEqual([+ ['user', { text: 'on laptop', images: [], files: [] }], ['assistant', [{ type: 'text', text: 'laptop reply' }]]]);+ expect(macmini.homes.isHomeHere(BOT)).toBe(true);+ const third = await macmini.runtime.transcript(BOT);+ expect(third.messages.map(m => m.text)).toEqual(['hello', 'hi there', 'from laptop', 'reply to laptop', 'on laptop', 'laptop reply']);++ // 8. Deleting on the current home retires the cloud companion; the other device drops it.+ macmini.profiles.delete(BOT);+ await macmini.runtime.retire(BOT);+ await laptop.refresh();+ expect(laptop.homes.snapshot().actors.some(actor => actor.externalId === BOT)).toBe(false);+ const retired = (await laptop.api<Array<{ id: string; disabled: boolean }>>('/actors')).find(actor => actor.id === actorId);+ expect(retired?.disabled).toBe(true);+ macmini.stop();+ laptop.stop();+ });++ it('lets only one Cindy installation on the same computer run a companion', { timeout: 60_000 }, async () => {+ const bot = `bot_e2e_inst_${randomUUID().slice(0, 8)}`;+ const local = { status: 'active', displayName: 'E2E Twin', description: '', soul: 'twin', user: '', systemPrompt: '' };+ const release = await createDevice('studio', () => [], { installationId: `release-${randomUUID()}` });+ const dev = await createDevice('studio', () => [], { installationId: `dev-${randomUUID()}` });+ release.profiles.set(bot, { ...local });+ dev.profiles.set(bot, { ...local });+ await release.refresh();+ const actorId = release.actor(bot)!.id;+ expect(release.actor(bot)!.homeDeviceId).toBe('studio');+ const installOf = async () => (await release.api<Array<{ key: string; value: { installationId?: string } }>>('/preferences', 'GET', undefined, actorId))+ .find(row => row.key === 'companion.install.v1')?.value.installationId;+ await waitFor(installOf, 'release claims the companion');+ await release.refresh();+ expect(release.runtime.isShadowed(bot)).toBe(false);+ // The second installation shares the device id, so the home matches, but the claim is not its own.+ await dev.refresh();+ await waitFor(() => dev.runtime.isShadowed(bot), 'dev install sees the other claim');+ await dev.refresh();+ expect(dev.homes.isShadowed(bot)).toBe(true);+ const devWritesBefore = dev.calls.filter(call => call.method !== 'GET').length;+ await dev.runtime.syncNow();+ expect(dev.calls.filter(call => call.method !== 'GET').length).toBe(devWritesBefore);+ // Taking over needs the home's profile snapshot; without it the take-over waits.+ expect(await dev.runtime.takeOver(bot)).toEqual({ ok: false, code: 'FAILED' });+ await release.runtime.syncNow();+ // Taking over from the dev installation overwrites the claim.+ expect(await dev.runtime.takeOver(bot)).toEqual({ ok: true });+ expect(dev.runtime.isShadowed(bot)).toBe(false);+ expect(await installOf()).toMatch(/^dev-/);+ release.stop();+ dev.stop();+ });+});diff --git a/apps/desktop/src/main/companion-cloud/__tests__/uploader.test.ts b/apps/desktop/src/main/companion-cloud/__tests__/uploader.test.tsnew file mode 100644index 0000000000..876bce7055--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/__tests__/uploader.test.ts@@ -0,0 +1,138 @@+import { describe, expect, it, vi } from 'vitest';+import { canonicalJson, createCompanionUploader, valueHash as canonicalHash, type CompanionPreferenceValue } from '../uploader.js';+import { fakeApi, memoryState, rejection } from './fakes.js';++const profile = (soul: string): CompanionPreferenceValue =>+ ({ key: 'companion.profile.v1', value: { name: 'Mia', description: '', soul, systemPrompt: '', user: '' } });+const memory = (filename: string, content: string): CompanionPreferenceValue =>+ ({ key: `companion.memory.v1:${filename}`, value: { filename, content } });++function setup(server: Array<{ key: string; value: unknown; revision: number }> = [], options: { home?: () => boolean } = {}) {+ const rows = new Map(server.map(row => [row.key, { ...row }]));+ const { api, calls } = fakeApi((route, method, data) => {+ if (route === '/preferences' && method === 'GET') return [...rows.values()];+ const body = data as { key: string; expectedRevision: number; value: unknown };+ const current = rows.get(body.key)?.revision ?? 0;+ if (current !== body.expectedRevision) throw rejection(409, 'REVISION_CONFLICT', { revision: current });+ rows.set(body.key, { key: body.key, value: body.value, revision: current + 1 });+ return { revision: current + 1 };+ });+ const { state } = memoryState();+ let values: CompanionPreferenceValue[] = [];+ const log = { warn: vi.fn() };+ const onLostHome = vi.fn();+ const uploader = createCompanionUploader({ api, state, readValues: async () => values, log, maxValueBytes: 2000,+ ...(options.home ? { confirmHome: async () => options.home!(), onLostHome } : {}) });+ const writes = () => calls.filter(call => call.method === 'POST').map(call => call.data as { key: string; value: unknown; expectedRevision: number });+ return { uploader, state, calls, rows, writes, log, onLostHome, setValues: (next: CompanionPreferenceValue[]) => { values = next; } };+}++describe('companion profile uploader', () => {+ it('uploads only changed values, as the companion actor', async () => {+ const t = setup();+ t.setValues([profile('soul v1'), memory('a.md', 'alpha')]);+ await t.uploader.syncBot('bot', 'actor');+ expect(t.writes().map(w => [w.key, w.expectedRevision])).toEqual([['companion.profile.v1', 0], ['companion.memory.v1:a.md', 0]]);+ expect(t.calls.every(call => call.actorId === 'actor')).toBe(true);+ await t.uploader.syncBot('bot', 'actor');+ expect(t.writes()).toHaveLength(2);+ t.setValues([profile('soul v2'), memory('a.md', 'alpha')]);+ await t.uploader.syncBot('bot', 'actor');+ expect(t.writes().slice(2).map(w => [w.key, w.expectedRevision])).toEqual([['companion.profile.v1', 1]]);+ expect(t.state.bot('bot')?.prefs['companion.profile.v1']?.revision).toBe(2);+ });++ it('writes a null tombstone once for a value that disappeared locally', async () => {+ const t = setup();+ t.setValues([profile('soul'), memory('a.md', 'alpha')]);+ await t.uploader.syncBot('bot', 'actor');+ t.setValues([profile('soul')]);+ await t.uploader.syncBot('bot', 'actor');+ await t.uploader.syncBot('bot', 'actor');+ expect(t.writes().slice(2)).toEqual([expect.objectContaining({ key: 'companion.memory.v1:a.md', value: null, expectedRevision: 1 })]);+ });++ it('seeds revisions from the server and never tombstones keys this device did not have', async () => {+ const t = setup([+ { key: 'companion.profile.v1', value: profile('soul').value, revision: 4 },+ // E.g. a memory another computer uploaded, or one this device could not restore.+ { key: 'companion.memory.v1:elsewhere.md', value: { filename: 'elsewhere.md', content: 'x' }, revision: 2 },+ { key: 'other.app.key', value: 1, revision: 9 },+ ]);+ t.setValues([profile('soul'), memory('new.md', 'n')]);+ await t.uploader.syncBot('bot', 'actor');+ // The unchanged profile is recognised regardless of key order on the server.+ expect(t.writes().map(w => [w.key, w.expectedRevision])).toEqual([['companion.memory.v1:new.md', 0]]);+ expect(t.rows.get('companion.memory.v1:elsewhere.md')?.value).toEqual({ filename: 'elsewhere.md', content: 'x' });+ // Its own key disappears locally: that one is tombstoned.+ t.setValues([profile('soul')]);+ await t.uploader.syncBot('bot', 'actor');+ expect(t.writes().slice(1).map(w => [w.key, w.value])).toEqual([['companion.memory.v1:new.md', null]]);+ });++ it('keeps a late server value the take-over did not restore, until this device really edits the key', async () => {+ // The take-over restored soul v1; the old home's late upload then wrote v2 before the first sync here.+ const t = setup([{ key: 'companion.profile.v1', value: profile('v2').value, revision: 5 }]);+ t.state.update('bot', 'actor', entry => {+ entry.prefsSeeded = false;+ entry.prefs['companion.profile.v1'] = { hash: canonicalHash(profile('v1').value), revision: 4, local: true };+ });+ t.setValues([profile('v1')]);+ await t.uploader.syncBot('bot', 'actor');+ expect(t.writes()).toEqual([]);+ expect(t.rows.get('companion.profile.v1')?.value).toEqual(profile('v2').value);+ // A real edit here still goes up, against the server's current revision.+ t.setValues([profile('v3')]);+ await t.uploader.syncBot('bot', 'actor');+ expect(t.writes().map(w => [w.key, w.expectedRevision])).toEqual([['companion.profile.v1', 5]]);+ });++ it('re-checks the home and re-reads the server before overwriting a conflicting value, once', async () => {+ let home = true;+ const t = setup([], { home: () => home });+ t.setValues([memory('a.md', 'mine')]);+ await t.uploader.syncBot('bot', 'actor');+ // Someone else wrote the key meanwhile.+ t.rows.set('companion.memory.v1:a.md', { key: 'companion.memory.v1:a.md', value: { filename: 'a.md', content: 'theirs' }, revision: 5 });+ t.setValues([memory('a.md', 'mine v2')]);+ await t.uploader.syncBot('bot', 'actor');+ expect(t.writes().slice(1).map(w => w.expectedRevision)).toEqual([1, 5]);+ expect(t.state.bot('bot')?.prefs['companion.memory.v1:a.md']).toMatchObject({ revision: 6, local: true });+ // When the home moved away, nothing is overwritten and actors are re-read.+ t.rows.set('companion.memory.v1:a.md', { key: 'companion.memory.v1:a.md', value: { filename: 'a.md', content: 'new home' }, revision: 9 });+ home = false;+ t.setValues([memory('a.md', 'mine v3')]);+ await expect(t.uploader.syncBot('bot', 'actor')).rejects.toThrow('NOT_HOME');+ expect(t.onLostHome).toHaveBeenCalledOnce();+ expect(t.rows.get('companion.memory.v1:a.md')?.value).toEqual({ filename: 'a.md', content: 'new home' });+ });++ it('spreads a large first upload over cycles', async () => {+ const t = setup();+ t.setValues(Array.from({ length: 45 }, (_, i) => memory(`m${i}.md`, `v${i}`)));+ expect(await t.uploader.syncAll([{ botId: 'bot', actorId: 'actor' }])).toBe(true);+ expect(t.writes()).toHaveLength(30);+ expect(await t.uploader.syncAll([{ botId: 'bot', actorId: 'actor' }])).toBe(false);+ expect(t.writes()).toHaveLength(45);+ });++ it('skips oversized values without truncating and keeps going', async () => {+ const t = setup();+ t.setValues([memory('big.md', 'x'.repeat(5000)), memory('small.md', 's')]);+ await t.uploader.syncBot('bot', 'actor');+ expect(t.writes().map(w => w.key)).toEqual(['companion.memory.v1:small.md']);+ expect(t.log.warn).toHaveBeenCalledWith('Companion value too large to upload; skipped', expect.objectContaining({ keyKind: 'companion.memory.v1' }));+ });++ it('logs and retries later when the server keeps failing', async () => {+ const { api } = fakeApi(() => { throw rejection(503, 'UNAVAILABLE'); });+ const log = { warn: vi.fn() };+ const uploader = createCompanionUploader({ api, state: memoryState().state, readValues: async () => [profile('s')], log });+ await uploader.syncAll([{ botId: 'bot', actorId: 'actor' }]);+ expect(log.warn).toHaveBeenCalledWith('Companion upload will retry', { actorId: 'actor', code: 'UNAVAILABLE' });+ });++ it('serialises JSON with sorted keys', () => {+ expect(canonicalJson({ b: 1, a: [{ d: null, c: 'x' }], e: undefined })).toBe('{"a":[{"c":"x","d":null}],"b":1}');+ });+});diff --git a/apps/desktop/src/main/companion-cloud/directRoom.ts b/apps/desktop/src/main/companion-cloud/directRoom.tsnew file mode 100644index 0000000000..18e4183361--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/directRoom.ts@@ -0,0 +1,59 @@+/**+ * A message the owner wrote in a companion's 1:1 room (cloud-companions.md §4): it is handed+ * to the companion's canonical Session like a message from another device. The reply reaches+ * the room through the conversation mirror, so the execution completes without content.+ */+import { COMPANION_DIRECT_CLIENT_PREFIX } from './mirror.js';+import type { CompanionApi } from './types.js';++/** Terminal payload of a delivered direct-room execution: no room message of its own. */+export const DIRECT_ROOM_COMPLETION = Object.freeze({ continueDiscussion: false });++export interface DirectRoomSource {+ id: string;+ authorId: string;+ deleted?: boolean;+ origin?: string;+ content?: Array<{ type?: string; text?: string; caption?: string; fallback?: string }>;+}++/** Names both the execution and the room message, so a take-over never re-inserts it as history. */+export const directRoomClientId = (executionId: string, sourceMessageId: string) =>+ `${COMPANION_DIRECT_CLIENT_PREFIX}${executionId}:${sourceMessageId}`;++/** The room message a delivered row came from, if it is one. */+export function directRoomSourceId(clientId: string): string | null {+ if (!clientId.startsWith(COMPANION_DIRECT_CLIENT_PREFIX)) return null;+ const parts = clientId.slice(COMPANION_DIRECT_CLIENT_PREFIX.length).split(':');+ return parts.length === 2 && parts[1] ? parts[1] : null;+}++export function directRoomText(message: DirectRoomSource): string {+ return (message.content ?? []).map(block => block.type === 'text' ? block.text ?? ''+ : block.type === 'media' ? `[附件: ${block.caption ?? '文件'}]` : block.fallback ?? '').filter(Boolean).join('\n').trim();+}++/** Validate the source and deliver it; throws an error code when it must fail instead. */+export async function deliverDirectRoomMessage(input: {+ api: CompanionApi;+ roomId: string;+ executionId: string;+ sourceMessageId: string;+ /** Only the owner's own words reach the companion's main task. */+ humanActorId: string;+ botId: string;+ deliver: (botId: string, text: string, clientId: string) => Promise<{ ok: true } | { ok: false; errorCode: string }>;+ /** Lease check right before the irreversible hand-off. */+ beforeDeliver?: () => Promise<void>;+}): Promise<string> {+ const source = await input.api<DirectRoomSource>(`/conversations/${input.roomId}/messages/${input.sourceMessageId}`);+ if (source.id !== input.sourceMessageId || source.deleted || source.origin === 'system' || source.authorId !== input.humanActorId)+ throw new Error('INVALID_EXECUTION_TRIGGER');+ const text = directRoomText(source);+ if (!text) throw new Error('INVALID_INPUT');+ await input.beforeDeliver?.();+ const clientId = directRoomClientId(input.executionId, input.sourceMessageId);+ const delivered = await input.deliver(input.botId, text, clientId);+ if (!delivered.ok) throw new Error(delivered.errorCode);+ return clientId;+}diff --git a/apps/desktop/src/main/companion-cloud/homes.ts b/apps/desktop/src/main/companion-cloud/homes.tsnew file mode 100644index 0000000000..871dfbdfa7--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/homes.ts@@ -0,0 +1,129 @@+/** Which computer runs each companion (cloud-companions.md §3), fed by chatServer register(). */+import {+ EMPTY_COMPANION_CLOUD_SNAPSHOT,+ type CompanionCloudActor,+ type CompanionCloudSnapshot,+} from '../../shared/companionCloud.js';+import { chatRejection, errorCode, type CompanionApi, type CompanionLog } from './types.js';++export type CompanionHomeListener = (snapshot: CompanionCloudSnapshot) => void;++export function createCompanionHomeRegistry() {+ let live = EMPTY_COMPANION_CLOUD_SNAPSHOT;+ // Shadowed ids persisted per owner: demotion holds even before the first successful+ // /me + /actors, while the server is unreachable, or when the feature is off.+ let persisted: readonly string[] = [];+ let snapshot = EMPTY_COMPANION_CLOUD_SNAPSHOT;+ const listeners = new Set<CompanionHomeListener>();+ // Owner scoping: reads after an account / data-owner switch never see the previous owner's+ // homes; the new owner's persisted shadows apply at once, before its Chat Server instance runs.+ let ownerBinding: { owner: () => string; loadPersisted: () => readonly string[] } | null = null;+ let boundOwner: string | null = null;+ const sync = () => {+ if (!ownerBinding) return;+ const owner = ownerBinding.owner();+ if (owner === boundOwner) return;+ boundOwner = owner;+ live = EMPTY_COMPANION_CLOUD_SNAPSHOT;+ try { persisted = [...new Set(ownerBinding.loadPersisted())].sort(); } catch { persisted = []; }+ emit();+ };+ const current = () => { sync(); return snapshot; };+ const actorOf = (botId: string) => current().actors.find(actor => actor.externalId === botId);+ const emit = () => {+ const demotedBotIds = [...new Set([...live.demotedBotIds, ...persisted])].sort();+ const next = { ...live, actors: live.actors.map(actor => ({ ...actor })), demotedBotIds };+ if (JSON.stringify(next) === JSON.stringify(snapshot)) return;+ snapshot = next;+ for (const listener of listeners) {+ try { listener(snapshot); } catch { /* one listener never blocks the others */ }+ }+ };+ const registry = {+ /** Live state plus persisted shadows (demotedBotIds is their union). */+ snapshot: current,+ update(next: CompanionCloudSnapshot) { sync(); live = next; emit(); },+ /** Replace the persisted shadow set (loaded at owner start, rewritten when demotion changes). */+ setPersistedShadows(ids: readonly string[]) { sync(); persisted = [...new Set(ids)].sort(); emit(); },+ persistedShadows: () => { sync(); return persisted; },+ reset() { live = EMPTY_COMPANION_CLOUD_SNAPSHOT; persisted = []; emit(); },+ /** Scope the registry to the active data owner (process-wide instance). */+ bindOwner(owner: () => string, loadPersisted: () => readonly string[]) {+ ownerBinding = { owner, loadPersisted };+ boundOwner = owner();+ },+ isEnabled: () => current().enabled,+ /** Home device of a registered companion; undefined when this account has no actor for it. */+ homeOf: (botId: string): string | null | undefined => actorOf(botId)?.homeDeviceId,+ /** True when the feature is off, the companion has no home yet, or this computer is its home. */+ isHomeHere(botId: string): boolean {+ const view = current();+ if (!view.enabled) return true;+ const home = actorOf(botId)?.homeDeviceId;+ return !home || home === view.selfDeviceId;+ },+ actorIdFor: (botId: string): string | null => actorOf(botId)?.id ?? null,+ /** The local copy of a companion that runs elsewhere (or in another install): hidden, never runs here. */+ isShadowed: (botId: string): boolean => current().demotedBotIds.includes(botId),+ onChange(listener: CompanionHomeListener): () => void {+ listeners.add(listener);+ return () => { listeners.delete(listener); };+ },+ };+ return registry;+}++export type CompanionHomeRegistry = ReturnType<typeof createCompanionHomeRegistry>;++/** Process-wide registry; chatServer resets it when its account/endpoint instance ends. */+export const companionHomes = createCompanionHomeRegistry();++/** True while this computer's copy of the companion is demoted (its home is elsewhere). */+export function isCompanionShadowed(botId: string): boolean {+ return companionHomes.isShadowed(botId);+}++interface HomeActor { id: string; kind: string; externalId: string; homeDeviceId?: string | null; disabled?: boolean }++/**+ * First registration only: claim companions whose home is still empty for this+ * computer (compare-and-set against null). A conflict means another computer won;+ * adopt its answer. Mutates `actors` with the resulting homes.+ */+export async function registerCompanionHomes(input: {+ api: CompanionApi;+ selfDeviceId: string;+ actors: HomeActor[];+ botIds: string[];+ isDemoted: (botId: string) => boolean;+ log?: CompanionLog;+}): Promise<void> {+ for (const botId of input.botIds) {+ const actor = input.actors.find(a => a.kind === 'bot' && a.externalId === botId);+ if (!actor || actor.disabled || actor.homeDeviceId != null || input.isDemoted(botId)) continue;+ try {+ const result = await input.api<{ homeDeviceId?: string | null }>(`/actors/${actor.id}`, 'PATCH',+ { homeDeviceId: input.selfDeviceId, expectedHomeDeviceId: null });+ actor.homeDeviceId = result?.homeDeviceId ?? input.selfDeviceId;+ } catch (error) {+ const conflict = chatRejection(error, 409, 'HOME_DEVICE_CONFLICT');+ if (conflict) actor.homeDeviceId = typeof conflict.homeDeviceId === 'string' ? conflict.homeDeviceId : null;+ else input.log?.warn('Companion home registration will retry', { actorId: actor.id, code: errorCode(error) });+ }+ }+}++export function companionSnapshot(input: {+ enabled: boolean;+ selfDeviceId: string | null;+ humanActorId: string | null;+ actors: Array<HomeActor & { name: string; avatar?: string | null }>;+ demotedBotIds?: string[];+}): CompanionCloudSnapshot {+ // Retired actors (deleted on their home) are not companions any more.+ const actors: CompanionCloudActor[] = input.actors.filter(a => a.kind === 'bot' && !a.disabled).map(a => ({+ id: a.id, externalId: a.externalId, name: a.name, avatar: a.avatar ?? null, homeDeviceId: a.homeDeviceId ?? null,+ }));+ return { enabled: input.enabled, selfDeviceId: input.selfDeviceId, humanActorId: input.humanActorId, actors,+ demotedBotIds: [...(input.demotedBotIds ?? [])].sort() };+}diff --git a/apps/desktop/src/main/companion-cloud/host.ts b/apps/desktop/src/main/companion-cloud/host.tsnew file mode 100644index 0000000000..c2198db175--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/host.ts@@ -0,0 +1,273 @@+/** Local (Electron + SQLite + Bot Home) side of cloud companions; see runtime.ts. */+import { createHash, randomUUID } from 'node:crypto';+import fs from 'node:fs/promises';+import path from 'node:path';+import { app } from 'electron';+import { and, asc, desc, eq, gt, gte, inArray, isNull, or, sql } from 'drizzle-orm';+import { portableBotAvatarOrFallback, BOT_AVATAR_MAX_BYTES } from '../../shared/botAvatarValue.js';+import type { DeviceLinkDeviceView } from '../../shared/deviceLinkIpc.js';+import { activeOwnerScopeKey, ownerScopedUserDataPath } from '../appSessionState.js';+import { atomicWriteFileSync, readAtomicFileSync } from '../utils/atomicWriteFile.js';+import { fetchPublicImageBytes } from '../im/publicImageFetch.js';+import { getDbClient } from '../localDb/client/current.js';+import { createBotProfile, getBotMemoryService, setBotProfileAvatar, updateBotProfile } from '../localDb/ipc/bots.js';+import { decodeBotAvatarImage } from '../localDb/ipc/botAvatarSelection.js';+import { createMessage } from '../localDb/ipc/messages.js';+import { botProfiles, botSessionLinks, messages } from '../localDb/schema.js';+import { resolveBotCanonicalSession } from '../maker-ipc/botCanonicalSessionRegistry.js';+import { botProfileDir, botProfileMemoryDir, readBotProfileFolder, writeBotProfileFolder } from '../maker-ipc/botProfileFolder.js';+import { onBotRemoteResourceChanged } from '../maker-ipc/botRemoteResourceInvalidation.js';+import { deleteBotSkillForBot, listBotSkillSourcesForBot, readBotSkillSourceForBot, saveBotSkillSourceForBot } from '../maker-ipc/botSkillService.js';+import type { CompanionMaterializeHost } from './materialize.js';+import { companionHomes } from './homes.js';+import type { CompanionMirrorCursor, CompanionMirrorRow } from './mirror.js';+import type { CompanionCloudHost } from './runtime.js';+import { createCompanionCloudState } from './state.js';+import type { CompanionLog } from './types.js';+import {+ COMPANION_MEMORY_PREFIX,+ COMPANION_PROFILE_KEY,+ COMPANION_SKILL_PREFIX,+ type CompanionPreferenceValue,+} from './uploader.js';++/** Derived memory files: USER.md travels inside the profile, MEMORY.md is a rebuilt index. */+const SKIPPED_MEMORY_FILES = new Set(['USER.md', 'MEMORY.md']);++export async function readCompanionValues(botId: string): Promise<CompanionPreferenceValue[]> {+ const userDataDir = ownerScopedUserDataPath();+ const [row] = await getDbClient().drizzle+ .select({ displayName: botProfiles.displayName, description: botProfiles.description })+ .from(botProfiles).where(eq(botProfiles.id, botId)).limit(1);+ if (!row) return [];+ // Strict: an unreadable SOUL/USER/prompt file aborts the cycle instead of uploading it as empty.+ const folder = await readBotProfileFolder(userDataDir, botId, { strict: true });+ const values: CompanionPreferenceValue[] = [{ key: COMPANION_PROFILE_KEY, value: {+ name: row.displayName, description: row.description, soul: folder.identitySource,+ systemPrompt: folder.systemPromptOverride, user: folder.userContextSource,+ } }];+ const memoryDir = botProfileMemoryDir(userDataDir, botId);+ // Only a missing folder means "no memories"; any other read error aborts this cycle so the+ // uploader never tombstones memories it merely failed to read.+ const entries = await fs.readdir(memoryDir, { withFileTypes: true }).catch((error: NodeJS.ErrnoException) => {+ if (error?.code === 'ENOENT') return [];+ throw error;+ });+ for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {+ if (!entry.isFile() || !entry.name.endsWith('.md') || entry.name.startsWith('.') || SKIPPED_MEMORY_FILES.has(entry.name)) continue;+ const content = await fs.readFile(path.join(memoryDir, entry.name), 'utf8');+ values.push({ key: `${COMPANION_MEMORY_PREFIX}${entry.name}`, value: { filename: entry.name, content } });+ }+ // Strict too: a skill that cannot be read must not look deleted (the uploader would tombstone it).+ for (const skill of await listBotSkillSourcesForBot(botId)) {+ values.push({ key: `${COMPANION_SKILL_PREFIX}${skill.slug}`, value: {+ slug: skill.slug, content: skill.source, ...(skill.enabled ? {} : { enabled: false }),+ } });+ }+ return values;+}++/** The SKILL.md as stored, so native frontmatter (tools, invocation, …) moves with the companion. */+async function readSkillContent(botId: string, slug: string): Promise<string | null> {+ return readBotSkillSourceForBot(botId, slug);+}++const AVATAR_FETCH_TIMEOUT_MS = 15_000;++/**+ * The actor's public avatar (https) as bounded image bytes for the normal creation path. Cloud+ * data is untrusted: the shared guarded download checks every hop against private networks and+ * stops reading at the size limit.+ */+async function fetchAvatarBase64(url: string, signal?: AbortSignal): Promise<string | null> {+ try {+ const { buffer } = await fetchPublicImageBytes(url, BOT_AVATAR_MAX_BYTES, undefined, { signal, timeoutMs: AVATAR_FETCH_TIMEOUT_MS });+ return Buffer.from(buffer).toString('base64');+ } catch {+ return null;+ }+}++/**+ * The cloud avatar in a form the local profile holds; no usable cloud avatar means the same+ * default a new profile gets. A downloadable image that cannot be read throws: the take-over+ * must not finish with a stale avatar that the new home would publish.+ */+async function cloudAvatar(avatar: string | null, signal?: AbortSignal): Promise<{ portable: string } | { imageBase64: string }> {+ if (!avatar?.startsWith('https://')) return { portable: portableBotAvatarOrFallback(avatar) };+ const imageBase64 = await fetchAvatarBase64(avatar, signal);+ if (!imageBase64) throw new Error('AVATAR_UNAVAILABLE');+ return { imageBase64 };+}++type MaterializeLocal = Omit<CompanionMaterializeHost, 'latestRows'>;++function createMaterializer(input: {+ ensureCanonicalSession: (botId: string) => Promise<string>;+ rebuildContext: (sessionId: string) => Promise<'rebuilt' | 'busy'>;+}): MaterializeLocal {+ return {+ readProfile: async botId => {+ const [row] = await getDbClient().drizzle+ .select({ status: botProfiles.status, displayName: botProfiles.displayName, description: botProfiles.description })+ .from(botProfiles).where(eq(botProfiles.id, botId)).limit(1);+ return row ?? null;+ },+ // Normal creation path: no invitation, no generated persona, the new home's default model.+ createProfile: async ({ id, name, description, identitySource, userContextSource, avatar }, fence) => {+ const restored = await cloudAvatar(avatar, fence.signal);+ fence.assertCurrent();+ await createBotProfile({ id, name: name.slice(0, 200), description, identitySource, userContextSource,+ ...('portable' in restored ? { avatar: restored.portable } : { avatarImageBase64: restored.imageBase64 }) });+ },+ updateProfile: async ({ id, name, description, identitySource, userContextSource, avatar }, fence) => {+ const restored = await cloudAvatar(avatar, fence.signal);+ fence.assertCurrent();+ await updateBotProfile({ id, name: name.slice(0, 200), enabled: true,+ ...(description !== undefined ? { description } : {}),+ ...(identitySource !== undefined ? { identitySource } : {}),+ ...(userContextSource !== undefined ? { userContextSource } : {}),+ ...('portable' in restored ? { avatar: restored.portable } : {}) });+ if ('imageBase64' in restored) {+ const image = decodeBotAvatarImage(restored.imageBase64);+ fence.assertCurrent();+ if (image) await setBotProfileAvatar(id, image);+ }+ },+ writeSystemPrompt: async (botId, text, fence) => {+ const root = ownerScopedUserDataPath();+ fence.assertCurrent();+ await writeBotProfileFolder(root, botId, { systemPromptOverride: text });+ },+ backupHome: async (botId, fence) => {+ const source = botProfileDir(ownerScopedUserDataPath(), botId);+ const target = ownerScopedUserDataPath('companion-cloud-backups', `${path.basename(source)}-${new Date().toISOString().replace(/[:.]/g, '-')}`);+ fence.assertCurrent();+ // Only a missing folder means "nothing to back up"; any other error stops the take-over.+ try { await fs.access(source); } catch (error) {+ if ((error as NodeJS.ErrnoException).code === 'ENOENT') return null;+ throw error;+ }+ // Identity, prompt, user file, memories and skills; the work folder stays where it is.+ await fs.cp(source, target, { recursive: true, filter: from => path.relative(source, from).split(path.sep)[0] !== 'workspace' });+ fence.assertCurrent();+ return target;+ },+ readMemory: async (botId, filename) => {+ if (path.basename(filename) !== filename) return null;+ // Only a missing file is "no memory"; other errors keep the take-over demoted for a retry.+ return fs.readFile(path.join(botProfileMemoryDir(ownerScopedUserDataPath(), botId), filename), 'utf8')+ .catch((error: NodeJS.ErrnoException) => { if (error?.code === 'ENOENT') return null; throw error; });+ },+ restoreMemory: (botId, filename, raw) => getBotMemoryService().restoreRaw(botId, filename, raw),+ removeMemory: (botId, filename) => getBotMemoryService().removeRaw(botId, filename),+ readSkill: readSkillContent,+ saveSkill: async (botId, slug, content, enabled) => { await saveBotSkillSourceForBot(botId, slug, content, { enabled }); },+ removeSkill: async (botId, slug) => { await deleteBotSkillForBot(botId, slug); },+ ensureCanonicalSession: botId => input.ensureCanonicalSession(botId),+ // Rewound and deleted rows are included (`removed`): removed here means never re-imported.+ localMessageTimes: async (sessionId, fromMs) => (await getDbClient().drizzle+ .select({ role: messages.role, createdAt: messages.createdAt, clientId: messages.clientId, rewindAt: messages.rewindAt }).from(messages)+ .where(and(eq(messages.sessionId, sessionId), inArray(messages.role, ['user', 'assistant', 'message_tombstone']), gte(messages.createdAt, fromMs))))+ .map(row => ({ role: row.role, createdAt: row.createdAt, clientId: row.clientId,+ ...(row.rewindAt !== null || row.role === 'message_tombstone' ? { removed: true } : {}) })),+ // Same row shape as ordinary messages; the client id keeps it out of the mirror.+ insertHistory: async (sessionId, row, fence) => {+ fence.assertCurrent();+ await createMessage(sessionId, { clientId: row.clientId, role: row.role, createdAt: row.createdAt,+ content: row.role === 'user' ? { text: row.text, images: [], files: [] } : [{ type: 'text', text: row.text }] });+ },+ rebuildContext: sessionId => input.rebuildContext(sessionId),+ };+}++const mirrorColumns = {+ id: messages.id, clientId: messages.clientId, role: messages.role, content: messages.content,+ agentMeta: messages.agentMeta, createdAt: messages.createdAt,+};+const visibleRows = (sessionId: string) => and(eq(messages.sessionId, sessionId), isNull(messages.rewindAt),+ inArray(messages.role, ['user', 'assistant']));++export async function readMirrorRowsAfter(sessionId: string, cursor: CompanionMirrorCursor, limit: number): Promise<CompanionMirrorRow[]> {+ return getDbClient().drizzle.select(mirrorColumns).from(messages)+ .where(and(visibleRows(sessionId), or(gt(messages.createdAt, cursor.createdAt),+ and(eq(messages.createdAt, cursor.createdAt), gt(messages.id, cursor.id)))))+ .orderBy(asc(messages.createdAt), asc(messages.id)).limit(limit);+}++export async function readLatestMirrorRows(sessionId: string, limit: number,+ options: { excludeClientIdPrefix?: string } = {}): Promise<CompanionMirrorRow[]> {+ const prefix = options.excludeClientIdPrefix;+ return getDbClient().drizzle.select(mirrorColumns).from(messages)+ .where(prefix ? and(visibleRows(sessionId), or(isNull(messages.clientId), sql`substr(${messages.clientId}, 1, ${prefix.length}) <> ${prefix}`)) : visibleRows(sessionId))+ .orderBy(desc(messages.createdAt), desc(messages.id)).limit(limit);+}++/** One random id per Cindy installation (userData), so two installs on one computer can tell themselves apart. */+export function companionInstallationId(): string {+ const file = path.join(app.getPath('userData'), 'companion-installation-id');+ try {+ const stored = readAtomicFileSync(file)?.trim();+ if (stored && /^[0-9a-f-]{36}$/.test(stored)) return stored;+ } catch { /* regenerate below */ }+ const created = randomUUID();+ atomicWriteFileSync(file, created);+ return created;+}++/** Owner-scoped list of shadowed (demoted) companions, read before the server answers. */+export function companionShadowStore() {+ const file = () => ownerScopedUserDataPath('companion-cloud', 'shadowed.json');+ return {+ read(): string[] {+ try {+ const value = JSON.parse(readAtomicFileSync(file()) ?? '[]');+ return Array.isArray(value) ? value.filter((id): id is string => typeof id === 'string') : [];+ } catch { return []; }+ },+ write(ids: string[]) { atomicWriteFileSync(file(), JSON.stringify([...ids].sort())); },+ };+}++export function createCompanionCloudHost(input: {+ deliverToCanonical: CompanionCloudHost['deliverToCanonical'];+ ensureCanonicalSession: (botId: string) => Promise<string>;+ rebuildContext: (sessionId: string) => Promise<'rebuilt' | 'busy'>;+ /** A turn is running (or queued) in this Session. */+ isTurnActive?: (sessionId: string) => boolean;+ listDevices: () => Promise<DeviceLinkDeviceView[]>;+ probeCompanionCloud?: (deviceId: string) => Promise<boolean>;+ log?: CompanionLog;+}): CompanionCloudHost {+ // Every reader (send guards, routines, lists) sees only the active owner's homes, and that+ // owner's persisted demotion, even before its Chat Server instance has started.+ companionHomes.bindOwner(activeOwnerScopeKey, () => companionShadowStore().read());+ return {+ homes: companionHomes,+ openState: (endpoint, humanActorId, current) => createCompanionCloudState({+ filePath: ownerScopedUserDataPath('companion-cloud',+ `${createHash('sha256').update(`${endpoint}\n${humanActorId}`).digest('hex')}.json`),+ current, log: input.log,+ }),+ readValues: readCompanionValues,+ canonicalSession: async botId => {+ const resolved = await resolveBotCanonicalSession(botId);+ return resolved.status === 'resolved' ? resolved.sessionId : null;+ },+ rowsAfter: readMirrorRowsAfter,+ latestRows: readLatestMirrorRows,+ deliverToCanonical: input.deliverToCanonical,+ onLocalChange: onBotRemoteResourceChanged,+ materializer: createMaterializer(input),+ listDevices: input.listDevices,+ ...(input.isTurnActive ? { isBotBusy: async (botId: string) => {+ // Every live task the companion runs in: its main task, group lanes and delegations.+ const rows = await getDbClient().drizzle.select({ sessionId: botSessionLinks.sessionId }).from(botSessionLinks)+ .where(and(eq(botSessionLinks.botId, botId), isNull(botSessionLinks.archivedAt)));+ return rows.some(row => input.isTurnActive!(row.sessionId));+ } } : {}),+ ...(input.probeCompanionCloud ? { probeCompanionCloud: input.probeCompanionCloud } : {}),+ installationId: companionInstallationId,+ shadows: companionShadowStore(),+ };+}diff --git a/apps/desktop/src/main/companion-cloud/materialize.ts b/apps/desktop/src/main/companion-cloud/materialize.tsnew file mode 100644index 0000000000..11e56e2e04--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/materialize.ts@@ -0,0 +1,267 @@+/**+ * Build or update the local companion from its cloud copy (cloud-companions.md §3.1 step 2-3):+ * profile, memories and own skills from the companion's preferences, then the latest room+ * history as local history, then a deterministic context rebuild. Nothing old is replayed.+ * Every local write is fenced by the owner that started it. The copy stays demoted (does not+ * run, upload or mirror) until everything is restored; a partial restore throws and the+ * automatic take-over retries it.+ */+import type { CompanionMirrorCursor, CompanionMirrorRow } from './mirror.js';+import { COMPANION_HISTORY_CLIENT_PREFIX } from './mirror.js';+import { directRoomSourceId } from './directRoom.js';+import { readRecentRoomMessages } from './room.js';+import type { CompanionCloudState } from './state.js';+import { errorCode, type CompanionApi, type CompanionLog } from './types.js';+import { COMPANION_MEMORY_PREFIX, COMPANION_PROFILE_KEY, COMPANION_SKILL_PREFIX, TOMBSTONE_HASH, isCompanionProfileSnapshot, valueHash } from './uploader.js';++export const COMPANION_HISTORY_LIMIT = 200;++export interface CompanionLocalProfile { status: string; displayName: string; description: string }++/** The owner that started the operation; every host write checks it and aborts on change. */+export interface CompanionWriteFence {+ assertCurrent: () => void;+ signal?: AbortSignal;+}++/** Local profile, Bot Home and Session operations, all through the existing services. */+export interface CompanionMaterializeHost {+ readProfile: (botId: string) => Promise<CompanionLocalProfile | null>;+ /** The cloud avatar must be restored (an image that cannot be downloaded fails the call). */+ createProfile: (input: {+ id: string; name: string; description: string; identitySource: string; userContextSource: string; avatar: string | null;+ }, fence: CompanionWriteFence) => Promise<void>;+ /**+ * Also makes the profile active again. Undefined fields stay unchanged; a cloud avatar replaces+ * the local one (failing like createProfile), since the home publishes its avatar back.+ */+ updateProfile: (input: {+ id: string; name: string; description?: string; identitySource?: string; userContextSource?: string; avatar: string | null;+ }, fence: CompanionWriteFence) => Promise<void>;+ writeSystemPrompt: (botId: string, text: string, fence: CompanionWriteFence) => Promise<void>;+ /** Copy the companion's Home (identity, prompt, user file, memories, skills) aside; returns where. */+ backupHome?: (botId: string, fence: CompanionWriteFence) => Promise<string | null>;+ readMemory: (botId: string, filename: string) => Promise<string | null>;+ restoreMemory: (botId: string, filename: string, raw: string, fence: CompanionWriteFence) => Promise<void>;+ removeMemory: (botId: string, filename: string, fence: CompanionWriteFence) => Promise<void>;+ readSkill: (botId: string, slug: string) => Promise<string | null>;+ saveSkill: (botId: string, slug: string, content: string, enabled: boolean, fence: CompanionWriteFence) => Promise<void>;+ removeSkill: (botId: string, slug: string, fence: CompanionWriteFence) => Promise<void>;+ ensureCanonicalSession: (botId: string, fence: CompanionWriteFence) => Promise<string>;+ /**+ * Local rows created at or after `fromMs`, including rewound and deleted ones (`removed`):+ * dedupe against mirrored, delivered and deliberately removed messages.+ */+ localMessageTimes: (sessionId: string, fromMs: number) => Promise<Array<{ role: string; createdAt: number; clientId: string; removed?: boolean }>>;+ insertHistory: (sessionId: string, row: { clientId: string; role: 'user' | 'assistant'; text: string; createdAt: number }, fence: CompanionWriteFence) => Promise<void>;+ /** Rebuild the native context from DB history like a companion restart; never interrupts a turn. */+ rebuildContext: (sessionId: string, fence: CompanionWriteFence) => Promise<'rebuilt' | 'busy'>;+ /** Newest first; `excludeClientIdPrefix` leaves out rows whose client id starts with it. */+ latestRows: (sessionId: string, limit: number, options?: { excludeClientIdPrefix?: string }) => Promise<CompanionMirrorRow[]>;+}++export interface CompanionMaterializeActor { id: string; externalId: string; name: string; avatar: string | null }++export interface CompanionMaterializeResult {+ created: boolean;+ inserted: number;+ rebuild: 'rebuilt' | 'skipped';+ /** Where an existing, never-synced local copy was saved before being overwritten. */+ backup?: string | null;+}++const text = (value: unknown) => typeof value === 'string' ? value : undefined;+const record = (value: unknown) => value && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : null;+const noFence: CompanionWriteFence = { assertCurrent: () => undefined };++export async function materializeCompanion(input: {+ api: CompanionApi;+ state: CompanionCloudState;+ host: CompanionMaterializeHost;+ actor: CompanionMaterializeActor;+ roomId: () => Promise<string>;+ fence?: CompanionWriteFence;+ log?: CompanionLog;+ /** Publish the demotion (send guard, routines, lists) before the first local write. */+ onDemoted?: () => void;+}): Promise<CompanionMaterializeResult> {+ const { api, state, host, actor, log } = input;+ const fence = input.fence ?? noFence;+ /** Check the owner before and after each local step. */+ const step = async <T>(run: () => Promise<T>): Promise<T> => {+ fence.assertCurrent();+ const value = await run();+ fence.assertCurrent();+ return value;+ };+ const botId = actor.externalId;+ const rows = await step(() => api<Array<{ key: string; value: unknown; revision: number }>>('/preferences', 'GET', undefined, actor.id));+ const prefs = new Map((Array.isArray(rows) ? rows : []).map(row => [row.key, row]));+ const profileValue = prefs.get(COMPANION_PROFILE_KEY)?.value;+ const profile = isCompanionProfileSnapshot(profileValue) ? profileValue : null;+ const known = state.bot(botId);+ const knownPrefs = known?.actorId === actor.id ? known.prefs : {};++ const local = await step(() => host.readProfile(botId));+ if (local?.status === 'deleting') throw new Error('PROFILE_DELETING');+ // Not runnable here until the take-over completes: a half-restored copy must never run or+ // upload its stale files over the cloud values.+ fence.assertCurrent();+ state.update(botId, actor.id, entry => { entry.demoted = true; });+ input.onDemoted?.();+ // Without the home's profile snapshot this copy's own (or empty) profile would be published as+ // the companion's identity: wait (demoted, retried) until the home has uploaded one.+ if (!profile) throw new Error('PROFILE_SNAPSHOT_MISSING');+ // An existing local copy is saved before the cloud copy replaces (or deletes) its files.+ let backup: string | null | undefined;+ if (local && !(known?.actorId === actor.id && known.backedUp) && host.backupHome) {+ backup = await step(() => host.backupHome!(botId, fence));+ if (backup) log?.info?.('Companion local copy backed up before take-over', { actorId: actor.id, backup });+ // Once is enough: a take-over that fails later (e.g. avatar unavailable) retries without a new copy.+ state.update(botId, actor.id, entry => { entry.backedUp = true; });+ }+ const name = text(profile?.name)?.trim() || actor.name || local?.displayName || '伙伴';+ if (!local) {+ await step(() => host.createProfile({ id: botId, name, description: text(profile?.description) ?? '',+ identitySource: text(profile?.soul) ?? '', userContextSource: text(profile?.user) ?? '', avatar: actor.avatar }, fence));+ } else {+ await step(() => host.updateProfile({ id: botId, name, description: text(profile?.description),+ identitySource: text(profile?.soul), userContextSource: text(profile?.user), avatar: actor.avatar }, fence));+ }+ const systemPrompt = text(profile?.systemPrompt);+ if (systemPrompt !== undefined) await step(() => host.writeSystemPrompt(botId, systemPrompt, fence));++ // Keys whose value this device now has locally; only these may be tombstoned later.+ const applied = new Map<string, { hash: string; revision: number }>();+ const profileRow = prefs.get(COMPANION_PROFILE_KEY);+ if (profileRow && profile) applied.set(COMPANION_PROFILE_KEY, { hash: valueHash(profileRow.value), revision: profileRow.revision });+ let failures = 0;+ const apply = async (kind: string, run: () => Promise<void>) => {+ try { await run(); } catch (error) {+ if (errorCode(error) === 'OWNER_CHANGED') throw error;+ failures += 1;+ log?.warn('Companion content could not be restored', { actorId: actor.id, kind, code: errorCode(error) });+ }+ };+ // The cloud copy wins: a tombstone deletes the local file (the copy was backed up above), so+ // the uploader can never bring deleted content back.+ for (const [key, row] of prefs) {+ const value = row.value;+ if (key.startsWith(COMPANION_MEMORY_PREFIX)) {+ const filename = key.slice(COMPANION_MEMORY_PREFIX.length);+ const content = text(record(value)?.content);+ await apply('memory', async () => {+ const current = await host.readMemory(botId, filename);+ if (value === null) {+ if (current !== null) await step(() => host.removeMemory(botId, filename, fence));+ applied.set(key, { hash: TOMBSTONE_HASH, revision: row.revision });+ return;+ }+ if (content === undefined) return;+ if (content !== current) await step(() => host.restoreMemory(botId, filename, content, fence));+ applied.set(key, { hash: valueHash(value), revision: row.revision });+ });+ } else if (key.startsWith(COMPANION_SKILL_PREFIX)) {+ const slug = key.slice(COMPANION_SKILL_PREFIX.length);+ const content = text(record(value)?.content);+ await apply('skill', async () => {+ const current = await host.readSkill(botId, slug);+ if (value === null) {+ if (current !== null) await step(() => host.removeSkill(botId, slug, fence));+ applied.set(key, { hash: TOMBSTONE_HASH, revision: row.revision });+ return;+ }+ if (content === undefined) return;+ // Always written: also sets the cloud's enabled state, even when the body is unchanged.+ await step(() => host.saveSkill(botId, slug, content, record(value)?.enabled !== false, fence));+ applied.set(key, { hash: valueHash(value), revision: row.revision });+ });+ }+ }++ if (failures > 0) {+ // Keep what was restored (so the retry does not back the copy up again) and stay demoted.+ state.update(botId, actor.id, entry => { for (const [key, value] of applied) entry.prefs[key] = { ...value, local: true }; });+ throw new Error('RESTORE_INCOMPLETE');+ }++ const sessionId = await step(() => host.ensureCanonicalSession(botId, fence));+ const roomId = await step(() => input.roomId());+ const inserted = await importCloudHistory({ api, host, sessionId, botActorId: actor.id, roomId, fence });+ // Keep the mirror coherent: everything up to now is already in the room. Imported history+ // (possibly stamped by a peer's clock) never sets the cursor.+ const [latest] = await host.latestRows(sessionId, 1, { excludeClientIdPrefix: COMPANION_HISTORY_CLIENT_PREFIX });+ const cursor: CompanionMirrorCursor = latest ? { createdAt: latest.createdAt, id: latest.id } : { createdAt: 0, id: '' };+ const keepCursor = known?.actorId === actor.id && known.mirror?.sessionId === sessionId+ && (known.mirror.createdAt > cursor.createdAt || (known.mirror.createdAt === cursor.createdAt && known.mirror.id >= cursor.id));+ const needsRebuild = inserted > 0 || known?.pendingRebuild === true;+ fence.assertCurrent();+ state.update(botId, actor.id, entry => {+ // Revisions may have moved on while another computer was the home.+ entry.prefsSeeded = false;+ for (const [key, value] of applied) entry.prefs[key] = { ...value, local: true };+ if (!keepCursor) entry.mirror = { sessionId, ...cursor };+ if (needsRebuild) entry.pendingRebuild = true;+ });+ // Rebuild while still demoted: a failure, or a turn still running (`busy`), leaves the copy+ // demoted and the automatic take-over retries until the rebuild completes.+ const rebuild = needsRebuild ? await rebuildPending({ state, host, botId, actorId: actor.id, sessionId, fence }) : 'skipped';+ if (rebuild === 'busy') throw new Error('CONTEXT_REBUILD_PENDING');+ fence.assertCurrent();+ state.update(botId, actor.id, entry => {+ delete entry.demoted;+ // The next take-over (after this copy hands the companion away again) backs it up anew.+ delete entry.backedUp;+ });+ return { created: !local, inserted, rebuild, ...(backup !== undefined ? { backup } : {}) };+}++/** Insert the room's latest messages that are not already local, oldest first. */+export async function importCloudHistory(input: {+ api: CompanionApi;+ host: Pick<CompanionMaterializeHost, 'localMessageTimes' | 'insertHistory'>;+ sessionId: string;+ botActorId: string;+ roomId: string;+ fence?: CompanionWriteFence;+}): Promise<number> {+ const fence = input.fence ?? noFence;+ const messages = await readRecentRoomMessages(input.api, input.roomId, input.botActorId, COMPANION_HISTORY_LIMIT);+ if (!messages.length) return 0;+ // Rows already imported, and delivered direct-room messages, name their room message in the+ // client id: exact. Rows mirrored from this Session keep their local timestamp; the server+ // does not return import source ids, so (role, createdAt) identifies only those. Rewound or+ // deleted rows count too: what the owner removed here does not come back.+ const local = await input.host.localMessageTimes(input.sessionId, messages[0]!.createdAt);+ const known = new Set(local.flatMap(row => (row.clientId.startsWith(COMPANION_HISTORY_CLIENT_PREFIX)+ ? row.clientId.slice(COMPANION_HISTORY_CLIENT_PREFIX.length) : directRoomSourceId(row.clientId)) ?? []));+ const present = new Set(local.flatMap(row => row.clientId.startsWith(COMPANION_HISTORY_CLIENT_PREFIX) ? []+ : row.removed ? [`user:${row.createdAt}`, `assistant:${row.createdAt}`] : [`${row.role}:${row.createdAt}`]));+ let inserted = 0;+ for (const message of messages) {+ if (known.has(message.id) || present.has(`${message.role}:${message.createdAt}`)) continue;+ fence.assertCurrent();+ await input.host.insertHistory(input.sessionId, { clientId: `${COMPANION_HISTORY_CLIENT_PREFIX}${message.id}`,+ role: message.role, text: message.text, createdAt: message.createdAt }, fence);+ inserted += 1;+ }+ fence.assertCurrent();+ return inserted;+}++/** Rebuild now when idle; otherwise keep the flag for the next sync cycle. */+export async function rebuildPending(input: {+ state: CompanionCloudState;+ host: Pick<CompanionMaterializeHost, 'rebuildContext'>;+ botId: string;+ actorId: string;+ sessionId: string;+ fence?: CompanionWriteFence;+}): Promise<'rebuilt' | 'busy'> {+ const fence = input.fence ?? noFence;+ fence.assertCurrent();+ const outcome = await input.host.rebuildContext(input.sessionId, fence);+ fence.assertCurrent();+ if (outcome === 'rebuilt') input.state.update(input.botId, input.actorId, entry => { delete entry.pendingRebuild; });+ return outcome;+}diff --git a/apps/desktop/src/main/companion-cloud/mirror.ts b/apps/desktop/src/main/companion-cloud/mirror.tsnew file mode 100644index 0000000000..bdf94be9d7--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/mirror.ts@@ -0,0 +1,232 @@+/**+ * Home-only mirror of a companion's canonical Session into its 1:1 Chat Server room+ * (cloud-companions.md §4): user-visible messages and the companion's replies only,+ * deduplicated by local message id, resumed from a cursor after each successful import.+ */+import { createHash } from 'node:crypto';+import { isSubagentParentToolUseId } from '@cindy/maker-shared/message-render';+import { visibleMessageText } from '../localDb/conversationSearch.pure.js';+import type { CompanionCloudState } from './state.js';+import { chatRejection, type CompanionApi } from './types.js';++export interface CompanionMirrorRow {+ id: string;+ clientId: string;+ role: string;+ content: string;+ agentMeta: string | null;+ createdAt: number;+}+export interface CompanionMirrorCursor { createdAt: number; id: string }++/** Rows of these inputs already live in the room, or came from it. */+export const COMPANION_DIRECT_CLIENT_PREFIX = 'chat-direct:';+export const COMPANION_HISTORY_CLIENT_PREFIX = 'cloud-history:';+export const COMPANION_BACKFILL_LIMIT = 200;+const BACKFILL_SCAN = 1000;+const PAGE = 200;+const MAX_PAGES = 10;+const BATCH_MESSAGES = 50;+// Chat Server accepts 256 KiB bodies; each message stays within its 64 KiB content limit.+const BATCH_BYTES = 200_000;+const PART_CHARS = 30_000;+const PART_BYTES = 60_000;+const RESCAN_WINDOW_MS = 10 * 60_000;+const RESCAN_LIMIT = 200;+const RECENT_IDS = 400;++const parse = (raw: string | null): unknown => {+ if (!raw) return null;+ try { return JSON.parse(raw); } catch { return raw; }+};++function attachmentNames(content: unknown): string[] {+ if (!content || typeof content !== 'object' || Array.isArray(content)) return [];+ const names: string[] = [];+ for (const [field, fallback] of [['images', '图片'], ['files', '文件']] as const) {+ const list = (content as Record<string, unknown>)[field];+ if (!Array.isArray(list)) continue;+ for (const item of list) {+ const record = item && typeof item === 'object' ? item as Record<string, unknown> : {};+ const name = [record.originalName, record.name].find((value): value is string => typeof value === 'string' && !!value.trim());+ names.push((name ?? fallback).replace(/[\r\n]+/g, ' ').slice(0, 200));+ }+ }+ return names;+}++/**+ * Host-stamped sender/source metadata (message-source.md). A user row carrying any of these+ * was sent by another task, teammate, plugin, IM channel, automation, Orca or a shared-task+ * member — not typed by the owner — so it never goes up as the owner's words.+ * `sourceDevice` (the owner on another device) is the one source that stays.+ */+const NON_OWNER_SOURCE_KEYS = ['origin', 'sourcePlugin', 'sharedTaskAuthor', 'imSource', 'hookSource', 'sourceGroup',+ 'botTaskCoordination', 'autoReviewUserText', 'autoResume'] as const;++/** Room text of a canonical row, or null when the row is not part of the visible conversation. */+export function mirrorMessageText(row: CompanionMirrorRow): string | null {+ if (row.role !== 'user' && row.role !== 'assistant') return null;+ if (row.clientId.startsWith(COMPANION_DIRECT_CLIENT_PREFIX) || row.clientId.startsWith(COMPANION_HISTORY_CLIENT_PREFIX)) return null;+ const parsedMeta = parse(row.agentMeta);+ const meta = parsedMeta && typeof parsedMeta === 'object' ? parsedMeta as Record<string, unknown> : {};+ // Private/coordination replies are hidden in the local timeline as well; so are progress+ // commentary and sub-agent output, which are never a reply (bots.ts canonicalReplyVisibility).+ if (row.role === 'assistant' && (meta.botPrivateReply === true || meta.assistantPhase === 'commentary'+ || (meta.parentToolUseId ?? null) !== null || (meta.parent_tool_use_id ?? null) !== null+ // Claude sub-agent rows; same predicate as the renderer (a legacy transcript link is not one).+ || (typeof meta.parentUuid === 'string' && !!meta.parentUuid && isSubagentParentToolUseId(meta.parentUuid)))) return null;+ if (row.role === 'user' && NON_OWNER_SOURCE_KEYS.some(key => meta[key] !== undefined && meta[key] !== null && meta[key] !== false)) return null;+ const text = visibleMessageText(row.role, row.content);+ // Attachments count on their own: an images-only message is still the owner's message.+ // Hidden synthetic inputs carry no attachments, so they stay out.+ const names = row.role === 'user' ? attachmentNames(parse(row.content)) : [];+ const result = [text, ...names.map(name => `[附件: ${name}]`)].filter(Boolean).join('\n').trim();+ return result || null;+}++/** Split into room-sized parts without breaking surrogate pairs. */+export function splitMirrorText(text: string): string[] {+ const parts: string[] = [];+ let rest = text;+ while (rest) {+ let size = Math.min(rest.length, PART_CHARS);+ while (size > 1 && Buffer.byteLength(JSON.stringify(rest.slice(0, size))) > PART_BYTES) size = Math.floor(size * 0.8);+ if (size > 1 && size < rest.length && /[\uD800-\uDBFF]/.test(rest[size - 1]!)) size -= 1;+ parts.push(rest.slice(0, size));+ rest = rest.slice(size);+ }+ return parts;+}++interface ImportMessage {+ sourceId: string; authorId: string; createdAt: string; content: Array<{ type: 'text'; text: string }>;+}++export function createCompanionMirror(deps: {+ api: CompanionApi;+ state: CompanionCloudState;+ humanActorId: () => string;+ canonicalSession: (botId: string) => Promise<string | null>;+ /** Strictly after the cursor, ascending by (createdAt, id); user/assistant rows that were not rewound. */+ rowsAfter: (sessionId: string, cursor: CompanionMirrorCursor, limit: number) => Promise<CompanionMirrorRow[]>;+ /** Newest first, same filters as rowsAfter. */+ latestRows: (sessionId: string, limit: number) => Promise<CompanionMirrorRow[]>;+}) {+ async function ensureRoom(botId: string, actorId: string, name: string): Promise<string> {+ const known = deps.state.bot(botId);+ if (known?.actorId === actorId && known.roomId) return known.roomId;+ const body = { kind: 'direct', name: name.trim().slice(0, 160) || '伙伴', participants: [actorId], sourceId: actorId };+ let room: { id: string };+ try {+ room = await deps.api<{ id: string }>('/conversations', 'POST', { operationId: `companion-room:${actorId}`, ...body });+ } catch (error) {+ // An earlier attempt used another name; the room id is still keyed by the companion.+ if (!chatRejection(error, 409, 'OPERATION_CONFLICT')) throw error;+ const suffix = createHash('sha256').update(body.name).digest('hex').slice(0, 12);+ room = await deps.api<{ id: string }>('/conversations', 'POST', { operationId: `companion-room:${actorId}:${suffix}`, ...body });+ }+ deps.state.update(botId, actorId, entry => { entry.roomId = room.id; });+ return room.id;+ }++ /**+ * Import rows in order. With `advance`, the cursor moves past each fully imported row, but+ * never onto an imported (`cloud-history:`) row and never backwards. Imported ids are+ * remembered so the trailing re-scan does not send them again.+ */+ async function importRows(botId: string, actorId: string, roomId: string, sessionId: string, rows: CompanionMirrorRow[], advance = true) {+ const parts: Array<{ message: ImportMessage; row: number; last: boolean; bytes: number }> = [];+ rows.forEach((row, index) => {+ const text = mirrorMessageText(row);+ if (!text) return;+ const pieces = splitMirrorText(text);+ pieces.forEach((piece, n) => {+ const message: ImportMessage = {+ sourceId: `cindy:${sessionId}:${row.id}${n ? `:p${n}` : ''}`.slice(0, 200),+ authorId: row.role === 'user' ? deps.humanActorId() : actorId,+ createdAt: new Date(row.createdAt).toISOString(),+ content: [{ type: 'text', text: piece }],+ };+ parts.push({ message, row: index, last: n === pieces.length - 1, bytes: Buffer.byteLength(JSON.stringify(message)) });+ });+ });+ const moveTo = (upTo: number) => {+ if (!advance) return;+ let index = upTo;+ while (index >= 0 && rows[index]!.clientId.startsWith(COMPANION_HISTORY_CLIENT_PREFIX)) index -= 1;+ if (index < 0) return;+ const row = rows[index]!;+ deps.state.update(botId, actorId, entry => {+ const current = entry.mirror?.sessionId === sessionId ? entry.mirror : undefined;+ if (current && (current.createdAt > row.createdAt || (current.createdAt === row.createdAt && current.id >= row.id))) return;+ entry.mirror = { sessionId, createdAt: row.createdAt, id: row.id, ...(current?.recent ? { recent: current.recent } : {}) };+ });+ };+ const remember = (ids: string[]) => {+ if (!ids.length) return;+ deps.state.update(botId, actorId, entry => {+ if (!entry.mirror || entry.mirror.sessionId !== sessionId) return;+ entry.mirror = { ...entry.mirror, recent: [...new Set([...(entry.mirror.recent ?? []), ...ids])].slice(-RECENT_IDS) };+ });+ };+ let start = 0;+ while (start < parts.length) {+ let end = start; let bytes = 0;+ while (end < parts.length && end - start < BATCH_MESSAGES && (end === start || bytes + parts[end]!.bytes <= BATCH_BYTES)) {+ bytes += parts[end]!.bytes; end += 1;+ }+ const batch = parts.slice(start, end).map(part => part.message);+ const operationId = `companion-import:${createHash('sha256').update(JSON.stringify(batch)).digest('hex').slice(0, 48)}`;+ try {+ await deps.api(`/conversations/${roomId}/import`, 'POST', { operationId, messages: batch });+ } catch (error) {+ // The room went away (e.g. archived on the server): create it again next cycle.+ if (chatRejection(error, 404, 'CONVERSATION_NOT_FOUND')) deps.state.update(botId, actorId, entry => { delete entry.roomId; });+ throw error;+ }+ const tail = parts[end - 1]!;+ const done = tail.last ? tail.row : tail.row - 1;+ if (done >= 0) moveTo(done);+ remember([...new Set(parts.slice(start, end).filter(part => part.last).map(part => rows[part.row]!.id))]);+ start = end;+ }+ if (rows.length) moveTo(rows.length - 1);+ }++ /** One bounded pass; `drain` (before a hand-over) keeps paging until the backlog is empty. */+ async function syncBot(botId: string, actorId: string, name: string, options: { drain?: boolean } = {}): Promise<void> {+ const sessionId = await deps.canonicalSession(botId);+ if (!sessionId) return;+ const roomId = await ensureRoom(botId, actorId, name);+ const known = deps.state.bot(botId);+ const cursor = known?.actorId === actorId && known.mirror?.sessionId === sessionId ? known.mirror : null;+ if (!cursor) {+ // First run for this Session: only the most recent conversation goes up.+ const rows = (await deps.latestRows(sessionId, BACKFILL_SCAN)).reverse();+ const eligible = rows.flatMap((row, index) => mirrorMessageText(row) ? [index] : []);+ const from = eligible.length > COMPANION_BACKFILL_LIMIT ? eligible[eligible.length - COMPANION_BACKFILL_LIMIT]! : 0;+ if (rows.length) await importRows(botId, actorId, roomId, sessionId, rows.slice(from));+ else deps.state.update(botId, actorId, entry => { entry.mirror = { sessionId, createdAt: 0, id: '' }; });+ return;+ }+ // Assistant rows are stamped when they start and persisted later, and imported history can+ // carry a peer's clock: re-scan a trailing window behind the cursor for anything missed.+ // Server-side sourceId dedupe makes any repeat a no-op; recent ids avoid the request.+ const recent = new Set(cursor.recent ?? []);+ const behind = (row: CompanionMirrorRow) => row.createdAt < cursor.createdAt || (row.createdAt === cursor.createdAt && row.id <= cursor.id);+ const missed = (await deps.rowsAfter(sessionId, { createdAt: cursor.createdAt - RESCAN_WINDOW_MS, id: '' }, RESCAN_LIMIT))+ .filter(row => behind(row) && !recent.has(row.id) && mirrorMessageText(row));+ if (missed.length) await importRows(botId, actorId, roomId, sessionId, missed, false);+ let after: CompanionMirrorCursor = { createdAt: cursor.createdAt, id: cursor.id };+ for (let page = 0; options.drain || page < MAX_PAGES; page += 1) {+ const rows = await deps.rowsAfter(sessionId, after, PAGE);+ if (!rows.length) return;+ await importRows(botId, actorId, roomId, sessionId, rows);+ after = rows[rows.length - 1]!;+ if (rows.length < PAGE) return;+ }+ }++ return { ensureRoom, syncBot };+}diff --git a/apps/desktop/src/main/companion-cloud/room.ts b/apps/desktop/src/main/companion-cloud/room.tsnew file mode 100644index 0000000000..aea7740a7d--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/room.ts@@ -0,0 +1,55 @@+/** Reading a companion's 1:1 room: the conversation layer every device can see. */+import type { CompanionTranscriptMessage, CompanionTranscriptPage } from '../../shared/companionCloud.js';+import type { CompanionApi } from './types.js';++export interface CompanionRoomMessage {+ id: string;+ seq: string;+ authorId: string;+ author?: { kind?: string };+ origin?: string;+ deleted?: boolean;+ threadRootId?: string | null;+ createdAt: string;+ content?: Array<{ type?: string; text?: string; caption?: string; fallback?: string }>;+}++const PAGE = 100;++/** Visible user/assistant text of a room message; null for system rows, threads and deletions. */+export function roomMessageView(message: CompanionRoomMessage, botActorId: string): CompanionTranscriptMessage | null {+ if (message.deleted || message.origin === 'system' || message.threadRootId) return null;+ const text = (message.content ?? []).map(block => block.type === 'text' ? block.text ?? ''+ : block.type === 'media' ? `[附件: ${block.caption ?? '文件'}]` : block.fallback ?? '').filter(Boolean).join('\n').trim();+ const createdAt = Date.parse(message.createdAt);+ if (!text || !Number.isFinite(createdAt)) return null;+ return { id: message.id, seq: message.seq, role: message.authorId === botActorId ? 'assistant' : 'user', text, createdAt };+}++export async function readRoomPage(api: CompanionApi, roomId: string, before?: string): Promise<CompanionRoomMessage[]> {+ const query = new URLSearchParams({ limit: String(PAGE) });+ if (before) query.set('before', before);+ const page = await api<CompanionRoomMessage[]>(`/conversations/${roomId}/messages?${query}`);+ return Array.isArray(page) ? page : [];+}++/** One page of the room for display, oldest first. */+export async function readTranscriptPage(api: CompanionApi, roomId: string, botActorId: string, before?: string): Promise<CompanionTranscriptPage> {+ const page = await readRoomPage(api, roomId, before);+ const messages = page.flatMap(message => roomMessageView(message, botActorId) ?? []).reverse();+ const oldest = page.reduce<string | undefined>((min, m) => min === undefined || BigInt(m.seq) < BigInt(min) ? m.seq : min, undefined);+ return { messages, ...(page.length === PAGE && oldest ? { nextBefore: oldest } : {}) };+}++/** Latest `limit` visible messages, oldest first. */+export async function readRecentRoomMessages(api: CompanionApi, roomId: string, botActorId: string, limit: number, maxPages = 5) {+ const collected: CompanionTranscriptMessage[] = [];+ let before: string | undefined;+ for (let page = 0; page < maxPages && collected.length < limit; page += 1) {+ const result = await readTranscriptPage(api, roomId, botActorId, before);+ collected.unshift(...result.messages);+ if (!result.nextBefore) break;+ before = result.nextBefore;+ }+ return collected.slice(-limit);+}diff --git a/apps/desktop/src/main/companion-cloud/runtime.ts b/apps/desktop/src/main/companion-cloud/runtime.tsnew file mode 100644index 0000000000..e24ed06e3f--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/runtime.ts@@ -0,0 +1,552 @@+/**+ * Background sync and home changes owned by one Chat Server instance (one account ++ * endpoint). Started only when the server announces companion homes; background+ * failures are logged and retried, never surfaced to chat.+ */+import type {+ CompanionCloudActionResult,+ CompanionTranscriptPage,+ CompanionTransferTarget,+} from '../../shared/companionCloud.js';+import type { DeviceLinkDeviceView } from '../../shared/deviceLinkIpc.js';+import { isMobilePlatform } from '@cindy/maker-shared/device-list';+import type { CompanionHomeRegistry } from './homes.js';+import { materializeCompanion, rebuildPending, type CompanionMaterializeHost, type CompanionMaterializeResult } from './materialize.js';+import { createCompanionMirror, type CompanionMirrorCursor, type CompanionMirrorRow } from './mirror.js';+import { readTranscriptPage } from './room.js';+import type { CompanionCloudState } from './state.js';+import { chatRejection, errorCode, type CompanionApi, type CompanionLog } from './types.js';+import { COMPANION_PROFILE_KEY, COMPANION_VALUE_TOO_LARGE, createCompanionUploader, isCompanionProfileSnapshot, type CompanionPreferenceValue } from './uploader.js';++/** Electron/database side of the feature, wired in register.ts. */+export interface CompanionCloudHost {+ homes: CompanionHomeRegistry;+ openState: (endpoint: string, humanActorId: string, current: () => boolean) => CompanionCloudState;+ readValues: (botId: string) => Promise<CompanionPreferenceValue[]>;+ canonicalSession: (botId: string) => Promise<string | null>;+ rowsAfter: (sessionId: string, cursor: CompanionMirrorCursor, limit: number) => Promise<CompanionMirrorRow[]>;+ latestRows: (sessionId: string, limit: number, options?: { excludeClientIdPrefix?: string }) => Promise<CompanionMirrorRow[]>;+ /** Hand a room message to the companion's canonical Session as an ordinary user message. */+ deliverToCanonical: (botId: string, text: string, clientId: string) => Promise<{ ok: true } | { ok: false; errorCode: string }>;+ /** Local profile, memory, skill or canonical message change of a companion. */+ onLocalChange?: (listener: (botId: string) => void) => () => void;+ /** Local side of taking a companion over; absent disables take-over and auto-materialize. */+ materializer?: Omit<CompanionMaterializeHost, 'latestRows'>;+ /** The owner's devices from device-link. */+ listDevices?: () => Promise<DeviceLinkDeviceView[]>;+ /** Does that computer's Cindy support cloud companions (`maker:companion-cloud:caps`)? */+ probeCompanionCloud?: (deviceId: string) => Promise<boolean>;+ /** A turn is running (or queued) in any of the companion's tasks (main task, group lanes, delegations). */+ isBotBusy?: (botId: string) => Promise<boolean>;+ /** Random id of this Cindy installation (per userData); absent disables the install guard. */+ installationId?: () => string;+ /** Owner-scoped persisted shadow set (demotion survives restarts, an offline server and a disabled feature). */+ shadows?: { read: () => string[]; write: (ids: string[]) => void };+}++export interface CompanionCloudBot { botId: string; actorId: string; name: string }+/** Live actor record owned by chatServer.ts; home changes are written back in place. */+export interface CompanionRuntimeActor {+ id: string; kind: string; externalId: string; name: string; avatar?: string | null; homeDeviceId?: string | null;+ /** Retired in the cloud (deleted on its home); ignored everywhere. */+ disabled?: boolean;+}++export interface CompanionCloudRuntime {+ readonly state: CompanionCloudState;+ kickUploads: (botId?: string) => void;+ kickMirror: (botId?: string) => void;+ roomIdFor: (botId: string) => string | null;+ isDirectRoom: (roomId: string) => boolean;+ /** One full upload + mirror pass (tests and explicit refresh). */+ syncNow: () => Promise<void>;+ /** Demote local copies homed elsewhere and materialize companions handed to this computer. */+ reconcile: (localProfiles: Array<{ id: string; status: string }>) => void;+ takeOver: (botId: string) => Promise<CompanionCloudActionResult>;+ transfer: (botId: string, targetDeviceId: string) => Promise<CompanionCloudActionResult>;+ transferTargets: () => Promise<CompanionTransferTarget[]>;+ transcript: (botId: string, before?: string) => Promise<CompanionTranscriptPage>;+ /** The companion was deleted on its home (this computer): retire its cloud actor (retried until it succeeds). */+ retire: (botId: string) => Promise<void>;+ /** Demoted here, or homed on this device but owned by another Cindy installation. */+ isShadowed: (botId: string) => boolean;+ /** This installation is confirmed to run the companion (always true without an install guard). */+ installConfirmed: (botId: string) => boolean;+ /** Every shadowed local companion id (persisted by the caller). */+ shadowIds: () => string[];+ dispose: () => void;+}++/**+ * Bot preference naming the installation (and its device) that runs the companion. Another+ * installation on the same device defers to it; a record from another device means the+ * companion was handed here.+ */+export const COMPANION_INSTALL_KEY = 'companion.install.v1';+const INSTALL_RECHECK_MS = 2 * 60_000;++let active: CompanionCloudRuntime | null = null;+/** The running sync of the current account, or null when the feature is off. */+export function activeCompanionCloud(): CompanionCloudRuntime | null { return active; }++type Only = Set<string> | null | undefined;+const union = (left: Only, right: Set<string> | null): Only =>+ left === null || right === null ? null : new Set([...(left ?? []), ...right]);++const TRANSPORT_CODES = /^(REQUEST_TIMEOUT|CHAT_ENDPOINT_UNAVAILABLE|ECONN\w*|ENOTFOUND|EAI_AGAIN|ETIMEDOUT|ENETUNREACH|EHOSTUNREACH|EPIPE)$/;+/** The server could not be reached (or is temporarily failing): retry later. */+export function isUnreachable(error: unknown): boolean {+ if (!(error instanceof Error)) return false;+ const status = (error as { status?: unknown }).status;+ if (typeof status === 'number') return status >= 500 || status === 408 || status === 429;+ const code = (error as { code?: unknown }).code;+ return TRANSPORT_CODES.test(error.message) || (typeof code === 'string' && TRANSPORT_CODES.test(code));+}++function actionFailure(error: unknown, fallback: 'FAILED' | 'OFFLINE' = 'FAILED'): CompanionCloudActionResult {+ const conflict = chatRejection(error, 409, 'HOME_DEVICE_CONFLICT');+ if (conflict) return { ok: false, code: 'HOME_CONFLICT', homeDeviceId: typeof conflict.homeDeviceId === 'string' ? conflict.homeDeviceId : null };+ return { ok: false, code: isUnreachable(error) ? 'OFFLINE' : fallback };+}++const AUTO_RETRY_MS = 60_000;++/** The home has uploaded the profile snapshot a take-over builds the companion from. */+export function hasProfileSnapshot(rows: unknown): boolean {+ const row = (Array.isArray(rows) ? rows : []).find((candidate: { key?: unknown }) => candidate?.key === COMPANION_PROFILE_KEY) as { value?: unknown } | undefined;+ return isCompanionProfileSnapshot(row?.value);+}++/** Same computers Orca may run work on (orcaRemoteWorkers.isExecutionDeviceCandidate). */+export function isCompanionTransferTarget(device: DeviceLinkDeviceView): boolean {+ return device.online && device.remoteControlEnabled && device.controlEnabled && !device.isSelf && !isMobilePlatform(device.platform);+}++export function startCompanionCloud(input: {+ api: CompanionApi;+ host: CompanionCloudHost;+ endpoint: string;+ humanActorId: string;+ selfDeviceId?: string;+ current: () => boolean;+ /** Active local companions whose home is this computer (and not demoted). */+ bots: () => CompanionCloudBot[];+ /** The account's actors as last read by register(). */+ actors?: () => CompanionRuntimeActor[];+ /** Re-read actors now (forced register). */+ refresh?: () => Promise<void>;+ /** Publish the registry snapshot after a local home change. */+ publish?: () => void;+ /** Publish the companions' actor name and avatar now (they sync outside the preferences). */+ syncProfile?: (botId: string) => Promise<void>;+ log?: CompanionLog;+ uploadIntervalMs?: number;+ mirrorIntervalMs?: number;+ /** Run a first pass shortly after start (default). Harnesses drive passes explicitly. */+ initialKick?: boolean;+}): CompanionCloudRuntime {+ const state = input.host.openState(input.endpoint, input.humanActorId, input.current);+ const uploader = createCompanionUploader({ api: input.api, state, readValues: input.host.readValues, log: input.log,+ confirmHome: async (_botId, actorId) => {+ const actors = await input.api<CompanionRuntimeActor[]>('/actors');+ return actors.find(actor => actor.id === actorId)?.homeDeviceId === input.selfDeviceId;+ },+ onLostHome: () => { void input.refresh?.().catch(() => undefined); },+ });+ const mirror = createCompanionMirror({ api: input.api, state, humanActorId: () => input.humanActorId,+ canonicalSession: input.host.canonicalSession, rowsAfter: input.host.rowsAfter, latestRows: input.host.latestRows });+ let disposed = false;+ const live = () => !disposed && input.current();+ const aborts = new AbortController();+ /** Writes started by this account stop as soon as it is no longer current. */+ const fence = {+ assertCurrent: () => { if (!live()) throw new Error('OWNER_CHANGED'); },+ signal: aborts.signal,+ };+ // Install guard: which bots this installation runs ('mine'), another install on this device+ // runs ('other'), or another computer ran before handing them here ('handed').+ type InstallOwner = 'mine' | 'other' | 'handed';+ const installs = new Map<string, { owner: InstallOwner | 'pending'; checkedAt: number }>();+ const installId = input.host.installationId?.();+ const installOwner = (botId: string) => installId ? installs.get(botId)?.owner : 'mine';+ const pick = (only: Set<string> | null) => input.bots()+ .filter(bot => (!only || only.has(bot.botId)) && installOwner(bot.botId) === 'mine');+ const actorOf = (botId: string) => (input.actors?.() ?? []).find(a => a.kind === 'bot' && !a.disabled && (a.externalId === botId || a.id === botId));+ const publish = () => { if (live()) input.publish?.(); };++ function loop(run: (only: Set<string> | null) => Promise<void>, intervalMs: number, debounceMs: number) {+ let busy: Promise<void> | undefined;+ let queued: Only;+ let kicked: Only;+ let debounce: ReturnType<typeof setTimeout> | undefined;+ const hold = (work: Promise<unknown>): Promise<void> => {+ busy = work.then(() => undefined, () => undefined).finally(() => {+ busy = undefined;+ const next = queued; queued = undefined;+ if (next !== undefined) void fire(next);+ });+ return busy;+ };+ const fire = (only: Set<string> | null): Promise<void> => {+ if (!live()) return Promise.resolve();+ if (busy) { queued = union(queued, only); return busy; }+ return hold(run(only).catch(error => { input.log?.warn('Companion sync cycle failed', { code: errorCode(error) }); }));+ };+ const interval = setInterval(() => { void fire(null); }, intervalMs);+ interval.unref?.();+ return {+ run: () => fire(null),+ /** Run `task` once the cycle in flight is done; cycles started meanwhile wait for it. */+ async exclusive<T>(task: () => Promise<T>): Promise<T> {+ while (busy) await busy;+ const result = task();+ void hold(result);+ return result;+ },+ kick(botId?: string) {+ kicked = union(kicked, botId === undefined ? null : new Set([botId]));+ clearTimeout(debounce);+ debounce = setTimeout(() => { const only = kicked ?? null; kicked = undefined; void fire(only); }, debounceMs);+ debounce.unref?.();+ },+ dispose() { clearInterval(interval); clearTimeout(debounce); },+ };+ }++ const uploads = loop(async only => {+ // A first-upgrade burst is spread over cycles; continue soon when the budget ran out.+ if (await uploader.syncAll(pick(only))) uploads.kick();+ }, input.uploadIntervalMs ?? 60_000, 15_000);+ const mirrors = loop(async only => {+ for (const bot of pick(only)) {+ if (!live()) return;+ try {+ if (state.bot(bot.botId)?.pendingRebuild && input.host.materializer) {+ const sessionId = await input.host.canonicalSession(bot.botId);+ if (sessionId) await rebuildPending({ state, host: input.host.materializer, botId: bot.botId, actorId: bot.actorId, sessionId, fence });+ }+ await mirror.syncBot(bot.botId, bot.actorId, bot.name);+ } catch (error) { input.log?.warn('Companion conversation mirror will retry', { actorId: bot.actorId, code: errorCode(error) }); }+ }+ }, input.mirrorIntervalMs ?? 15_000, 2_000);+ const unsubscribe = input.host.onLocalChange?.(botId => { mirrors.kick(botId); uploads.kick(botId); });++ // One materialize per companion at a time; take-over and automatic runs share it.+ const materializing = new Map<string, Promise<CompanionMaterializeResult>>();+ const autoRetryAt = new Map<string, number>();+ function materialize(actor: CompanionRuntimeActor): Promise<CompanionMaterializeResult> {+ const materializer = input.host.materializer;+ if (!materializer) return Promise.reject(new Error('MATERIALIZE_UNAVAILABLE'));+ const botId = actor.externalId;+ const pending = materializing.get(botId);+ if (pending) return pending;+ const run = materializeCompanion({ api: input.api, state, log: input.log, fence, onDemoted: publish, host: { ...materializer, latestRows: input.host.latestRows },+ actor: { id: actor.id, externalId: botId, name: actor.name, avatar: actor.avatar ?? null },+ roomId: () => mirror.ensureRoom(botId, actor.id, actor.name) })+ .finally(() => { materializing.delete(botId); });+ materializing.set(botId, run);+ return run;+ }++ /**+ * Record that this installation runs the companion. `check` only claims an empty record;+ * `handed` (automatic take-over) also replaces another computer's record, never another+ * installation's claim on this computer; `takeover` (the user's explicit take-over) replaces any.+ */+ async function claimInstall(actor: CompanionRuntimeActor, mode: 'check' | 'handed' | 'takeover'): Promise<InstallOwner> {+ if (!installId) return 'mine';+ const rows = await input.api<Array<{ key: string; value: unknown; revision: number }>>('/preferences', 'GET', undefined, actor.id);+ const row = (Array.isArray(rows) ? rows : []).find(candidate => candidate.key === COMPANION_INSTALL_KEY);+ const record = row?.value && typeof row.value === 'object' ? row.value as { installationId?: unknown; deviceId?: unknown } : {};+ const current = record.installationId;+ let owner: InstallOwner = current === installId ? 'mine'+ : typeof record.deviceId === 'string' && record.deviceId !== input.selfDeviceId ? 'handed' : 'other';+ // A hand-over is completed by the take-over (which overwrites), never by this check.+ if ((owner === 'other' && (mode === 'takeover' || typeof current !== 'string')) || (owner === 'handed' && mode !== 'check')) {+ try {+ await input.api('/preferences', 'POST', { operationId: `cinstall:${actor.id}:${installId}:${row?.revision ?? 0}`,+ key: COMPANION_INSTALL_KEY, expectedRevision: row?.revision ?? 0,+ value: { installationId: installId, ...(input.selfDeviceId ? { deviceId: input.selfDeviceId } : {}) } }, actor.id);+ owner = 'mine';+ } catch (error) {+ // Another installation on this device claimed it first.+ if (!chatRejection(error, 409, 'REVISION_CONFLICT')) throw error;+ }+ }+ installs.set(actor.externalId, { owner, checkedAt: Date.now() });+ return owner;+ }++ function checkInstall(actor: CompanionRuntimeActor) {+ if (!installId) return;+ const known = installs.get(actor.externalId);+ if (known && Date.now() - known.checkedAt < INSTALL_RECHECK_MS) return;+ installs.set(actor.externalId, { owner: known?.owner ?? 'pending', checkedAt: Date.now() });+ void claimInstall(actor, 'check').then(owner => {+ // Handed here before this computer ever saw the move: take the existing copy over.+ if (owner === 'handed' && input.host.materializer) scheduleAuto(actor);+ if (owner !== known?.owner) { publish(); uploads.kick(actor.externalId); mirrors.kick(actor.externalId); }+ }, error => {+ installs.delete(actor.externalId);+ input.log?.warn('Companion installation check will retry', { actorId: actor.id, code: errorCode(error) });+ });+ }++ /** Hide and stop the local copy now (materialize lifts it once the take-over completes). */+ function demoteNow(actor: CompanionRuntimeActor) {+ if (state.isDemoted(actor.externalId)) return;+ state.update(actor.externalId, actor.id, entry => { entry.demoted = true; });+ publish();+ }++ function scheduleAuto(actor: CompanionRuntimeActor) {+ const botId = actor.externalId;+ if (materializing.has(botId) || Date.now() < (autoRetryAt.get(botId) ?? 0)) return;+ autoRetryAt.set(botId, Date.now() + AUTO_RETRY_MS);+ // Hidden first, through the home confirmation and the claim: the stale copy must not run or sync+ // meanwhile. The take-over lifts it once complete; a failure keeps it hidden and retries.+ demoteNow(actor);+ // Confirm the home with the server before un-demoting: a stale actor cache must not+ // resurrect a copy whose companion has already moved on.+ void input.api(`/actors/${actor.id}`, 'PATCH', { homeDeviceId: input.selfDeviceId, expectedHomeDeviceId: input.selfDeviceId })+ .then(async () => {+ // Automatic: never take the companion from the other installation on this computer.+ if (await claimInstall(actor, 'handed') !== 'mine') throw new Error('INSTALL_CLAIM_LOST');+ return materialize(actor);+ }).then(result => {+ autoRetryAt.delete(botId);+ input.log?.info?.('Companion moved to this computer', { actorId: actor.id, created: result.created, inserted: result.inserted, rebuild: result.rebuild });+ publish(); mirrors.kick(botId); uploads.kick(botId);+ }, error => {+ autoRetryAt.set(botId, Date.now() + AUTO_RETRY_MS);+ if (chatRejection(error, 409, 'HOME_DEVICE_CONFLICT')) { void input.refresh?.().catch(() => undefined); return; }+ input.log?.warn('Companion take-over will retry', { actorId: actor.id, code: errorCode(error) });+ });+ }++ /** Retire only from the installation that may run it: another Cindy on this computer may own it. */+ async function retireOwned(actor: CompanionRuntimeActor) {+ let owner = installOwner(actor.externalId);+ // Not confirmed yet (pending, failed, or just handed here): claim it the way the automatic+ // take-over does, so only one installation on this computer can win; a failure retries later.+ if (owner !== 'mine' && owner !== 'other') owner = await claimInstall(actor, 'handed');+ if (owner !== 'mine') {+ state.update(actor.externalId, actor.id, entry => { delete entry.retirePending; });+ return;+ }+ await retireActor(actor);+ }++ async function retireActor(actor: CompanionRuntimeActor) {+ // Compare-and-set on the home: if another computer took the companion over meanwhile, this+ // was only a copy, and deleting it never retires the companion itself.+ try {+ await input.api(`/actors/${actor.id}`, 'PATCH', { disabled: true, homeDeviceId: input.selfDeviceId, expectedHomeDeviceId: input.selfDeviceId });+ } catch (error) {+ const conflict = chatRejection(error, 409, 'HOME_DEVICE_CONFLICT');+ if (!conflict) throw error;+ actor.homeDeviceId = typeof conflict.homeDeviceId === 'string' ? conflict.homeDeviceId : null;+ state.update(actor.externalId, actor.id, entry => { delete entry.retirePending; });+ void input.refresh?.().catch(() => undefined);+ publish();+ return;+ }+ actor.disabled = true;+ state.update(actor.externalId, actor.id, entry => { delete entry.retirePending; });+ publish();+ }++ async function flush(botId: string) {+ const bot = pick(null).find(candidate => candidate.botId === botId);+ if (!bot) throw new Error('NOT_HOME');+ // The whole conversation backlog first: the old copy stops mirroring once demoted, and a long+ // drain must not leave edits made meanwhile behind.+ await mirror.syncBot(bot.botId, bot.actorId, bot.name, { drain: true });+ // Every portable value must reach the server: a skipped one would be lost by the move. Repeat+ // until a pass writes nothing, so the move starts from what is on disk right now.+ for (let pass = 0; ; pass += 1) {+ if (await uploader.syncBot(bot.botId, bot.actorId, Number.POSITIVE_INFINITY, { requireAll: true }) === 0) break;+ if (pass >= 2) throw new Error('COMPANION_STILL_CHANGING');+ }+ // The actor's name and avatar too: once demoted, this copy may no longer publish them.+ await input.syncProfile?.(bot.botId);+ }++ /** Everything the new home needs reaches the server, then the home moves and this copy is demoted. */+ async function handOver(actor: CompanionRuntimeActor, targetDeviceId: string): Promise<CompanionCloudActionResult> {+ // A running turn would keep working here (tools, files, replies) after the target took over.+ const turnActive = async () => !!(await input.host.isBotBusy?.(actor.externalId));+ if (await turnActive()) return { ok: false, code: 'BUSY' };+ try { await flush(actor.externalId); }+ catch (error) {+ input.log?.warn('Companion hand-over stopped: sync did not finish', { actorId: actor.id, code: errorCode(error) });+ const code = errorCode(error);+ return [COMPANION_VALUE_TOO_LARGE, 'COMPANION_STILL_CHANGING', 'INVALID_AVATAR', 'AVATAR_UPLOAD_FAILED'].includes(code)+ ? { ok: false, code: 'FAILED' } : actionFailure(error, 'OFFLINE');+ }+ // Checked again right before the move: a turn may have started during the flush.+ if (await turnActive()) return { ok: false, code: 'BUSY' };+ try {+ await input.api(`/actors/${actor.id}`, 'PATCH', { homeDeviceId: targetDeviceId, expectedHomeDeviceId: input.selfDeviceId });+ } catch (error) {+ const failure = actionFailure(error);+ if (!failure.ok && failure.code === 'HOME_CONFLICT') await input.refresh?.().catch(() => undefined);+ return failure;+ }+ actor.homeDeviceId = targetDeviceId;+ state.update(actor.externalId, actor.id, entry => { entry.demoted = true; });+ publish();+ return { ok: true };+ }++ const runtime: CompanionCloudRuntime = {+ state,+ kickUploads: botId => uploads.kick(botId),+ kickMirror: botId => mirrors.kick(botId),+ roomIdFor: botId => state.bot(botId)?.roomId ?? null,+ isDirectRoom: roomId => state.botForRoom(roomId) !== null,+ syncNow: async () => { await uploads.run(); await mirrors.run(); },++ reconcile(localProfiles) {+ const self = input.selfDeviceId;+ if (!self || !live()) return;+ for (const actor of input.actors?.() ?? []) {+ if (actor.kind !== 'bot') continue;+ const botId = actor.externalId;+ const local = localProfiles.find(profile => profile.id === botId);+ const entry = state.bot(botId);+ if (actor.disabled) {+ // Deleted on its main computer (perhaps while this one was offline): a copy here is no+ // longer the companion, so it is hidden and stopped like any other old copy.+ if (local && local.status !== 'deleting' && !entry?.demoted) {+ state.update(botId, actor.id, next => { next.demoted = true; });+ input.log?.info?.('Companion was deleted on its main computer; local copy demoted', { actorId: actor.id });+ }+ continue;+ }+ if (entry?.retirePending && actor.homeDeviceId !== self) {+ // Another computer took the companion over before the retry: the deletion here only+ // removed a copy (as with HOME_DEVICE_CONFLICT), and must not retire it if handed back.+ state.update(botId, actor.id, next => { delete next.retirePending; });+ } else if (entry?.retirePending) {+ if (Date.now() >= (autoRetryAt.get(`retire:${botId}`) ?? 0)) {+ autoRetryAt.set(`retire:${botId}`, Date.now() + AUTO_RETRY_MS);+ void retireOwned(actor).catch(error => input.log?.warn('Companion retire will retry', { actorId: actor.id, code: errorCode(error) }));+ }+ continue;+ }+ if (actor.homeDeviceId === self && local) checkInstall(actor);+ if (actor.homeDeviceId && actor.homeDeviceId !== self) {+ if (local && local.status !== 'deleting' && !entry?.demoted) {+ state.update(botId, actor.id, next => { next.demoted = true; });+ input.log?.info?.('Companion now runs on another computer; local copy demoted', { actorId: actor.id });+ }+ } else if (actor.homeDeviceId === self && input.host.materializer) {+ // Handed here: the local copy was demoted, or this computer never ran it. A companion+ // deleted on its own home keeps its sync history and is not revived.+ const ranHere = !!entry?.mirror || entry?.prefsSeeded === true;+ if (installOwner(botId) !== 'other' && (entry?.demoted === true || (!local && !ranHere))) scheduleAuto(actor);+ }+ }+ },++ async takeOver(botId) {+ const self = input.selfDeviceId;+ if (!self || !live() || !input.host.materializer) return { ok: false, code: 'NOT_ENABLED' };+ let actor = actorOf(botId);+ if (!actor) {+ try { await input.refresh?.(); } catch (error) { return actionFailure(error); }+ actor = actorOf(botId);+ }+ if (!actor) return { ok: false, code: 'FAILED' };+ // Never move the home before the companion's profile snapshot is in the cloud: without it+ // this copy could not be built, and the old home would already be demoted.+ try {+ const rows = await input.api<Array<{ key: string; value: unknown }>>('/preferences', 'GET', undefined, actor.id);+ if (!hasProfileSnapshot(rows)) return { ok: false, code: 'FAILED' };+ } catch (error) { return actionFailure(error); }+ // Always compare-and-set, even when the cached home already says "here": the cache may be+ // stale (another computer took over while this one was offline). Unchanged homes are a no-op.+ try {+ await input.api(`/actors/${actor.id}`, 'PATCH', { homeDeviceId: self, expectedHomeDeviceId: actor.homeDeviceId ?? null });+ } catch (error) {+ const failure = actionFailure(error);+ if (!failure.ok && failure.code === 'HOME_CONFLICT') {+ actor.homeDeviceId = failure.homeDeviceId ?? null;+ await input.refresh?.().catch(() => undefined);+ publish();+ }+ return failure;+ }+ actor.homeDeviceId = self;+ try {+ // Taking over from this installation also takes it from another install on the same device.+ demoteNow(actor);+ if (await claimInstall(actor, 'takeover') !== 'mine') return { ok: false, code: 'FAILED' };+ await materialize(actor);+ } catch (error) {+ input.log?.warn('Companion take-over could not finish locally', { actorId: actor.id, code: errorCode(error) });+ publish();+ return actionFailure(error);+ }+ publish(); mirrors.kick(actor.externalId); uploads.kick(actor.externalId);+ return { ok: true };+ },++ async transferTargets() {+ const devices = (await input.host.listDevices?.().catch(() => []) ?? []).filter(isCompanionTransferTarget);+ // Older Cindy versions cannot take a companion over: never strand one there.+ const probe = input.host.probeCompanionCloud;+ const supported = probe ? await Promise.all(devices.map(device => probe(device.deviceId).catch(() => false))) : devices.map(() => true);+ return devices.filter((_device, index) => supported[index])+ .map(device => ({ deviceId: device.deviceId, name: device.name, online: device.online }));+ },++ async transfer(botId, targetDeviceId) {+ const self = input.selfDeviceId;+ if (!self || !live()) return { ok: false, code: 'NOT_ENABLED' };+ const actor = actorOf(botId);+ if (!actor || actor.homeDeviceId !== self) return { ok: false, code: 'FAILED', homeDeviceId: actor?.homeDeviceId ?? null };+ const devices = await input.host.listDevices?.().catch(() => []) ?? [];+ const target = devices.find(device => device.deviceId === targetDeviceId && isCompanionTransferTarget(device));+ const probe = input.host.probeCompanionCloud;+ if (!target || (probe && !(await probe(targetDeviceId).catch(() => false)))) return { ok: false, code: 'TARGET_UNAVAILABLE' };+ // No background cycle may write in between: one already in flight could carry older values+ // past the flush, or past the move. Background sync resumes after the copy is demoted.+ return mirrors.exclusive(() => uploads.exclusive(() => handOver(actor, targetDeviceId)));+ },++ async transcript(botId, before) {+ const actor = actorOf(botId);+ if (!actor) throw new Error('COMPANION_NOT_FOUND');+ const roomId = await mirror.ensureRoom(actor.externalId, actor.id, actor.name);+ return readTranscriptPage(input.api, roomId, actor.id, before);+ },+++ async retire(botId) {+ const self = input.selfDeviceId;+ const actor = actorOf(botId);+ // A demoted copy is not the companion: deleting it never touches the cloud.+ if (!self || !live() || !actor || actor.homeDeviceId !== self || runtime.isShadowed(botId)) return;+ state.update(botId, actor.id, entry => { entry.retirePending = true; });+ await retireOwned(actor);+ },++ isShadowed: botId => state.isDemoted(botId) || installOwner(botId) === 'other',+ installConfirmed: botId => installOwner(botId) === 'mine',+ shadowIds: () => [...new Set([...state.demotedBotIds(),+ ...[...installs].flatMap(([botId, value]) => value.owner === 'other' ? [botId] : [])])].sort(),++ dispose() {+ disposed = true;+ aborts.abort();+ uploads.dispose(); mirrors.dispose(); unsubscribe?.();+ if (active === runtime) active = null;+ },+ };+ active = runtime;+ // First pass soon after start; later passes follow the intervals and local changes.+ if (input.initialKick !== false) { uploads.kick(); mirrors.kick(); }+ return runtime;+}diff --git a/apps/desktop/src/main/companion-cloud/state.ts b/apps/desktop/src/main/companion-cloud/state.tsnew file mode 100644index 0000000000..d15dda5b56--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/state.ts@@ -0,0 +1,103 @@+/**+ * Owner-scoped sync bookkeeping for one account + Chat Server endpoint: room ids,+ * mirror cursors and uploaded preference hashes. Never authoritative data; losing+ * it only costs a re-check against the server.+ */+import { z } from 'zod';+import { atomicWriteFileSync, readAtomicFileSync } from '../utils/atomicWriteFile.js';+import type { CompanionLog } from './types.js';++const pref = z.object({+ hash: z.string(),+ revision: z.number().int().nonnegative(),+ /**+ * This device had exactly this value locally (uploaded it, or applied it while taking over).+ * Only such keys may be tombstoned by the uploader or deleted locally by a cloud tombstone;+ * keys that merely exist on the server never are.+ */+ local: z.boolean().optional(),+});+const bot = z.object({+ actorId: z.string(),+ roomId: z.string().optional(),+ /** Last canonical message handed to the room, ordered by (createdAt, id). */+ mirror: z.object({+ sessionId: z.string(), createdAt: z.number(), id: z.string(),+ /** Recently imported local message ids, so the trailing re-scan does not re-send them. */+ recent: z.array(z.string()).optional(),+ }).optional(),+ prefs: z.record(z.string(), pref).default({}),+ /** Revisions were read back from the server once (after a fresh or lost state file). */+ prefsSeeded: z.boolean().optional(),+ /** This computer gave the companion away; never re-register it as home here. */+ demoted: z.boolean().optional(),+ /** Cloud history was added while the canonical Session was busy; rebuild at the next idle point. */+ pendingRebuild: z.boolean().optional(),+ /** The never-synced local copy was backed up before a take-over; retries do not back it up again. */+ backedUp: z.boolean().optional(),+ /** Deleted here while this computer was the home; disable the cloud actor until it succeeds. */+ retirePending: z.boolean().optional(),+});+const file = z.object({ version: z.literal(1), bots: z.record(z.string(), bot) });++export type CompanionBotState = z.infer<typeof bot>;++export interface CompanionCloudStateIo {+ read: (filePath: string) => string | null;+ write: (filePath: string, contents: string) => void;+}++const defaultIo: CompanionCloudStateIo = { read: readAtomicFileSync, write: atomicWriteFileSync };++export function createCompanionCloudState(options: {+ filePath: string;+ current?: () => boolean;+ log?: CompanionLog;+ io?: CompanionCloudStateIo;+}) {+ const io = options.io ?? defaultIo;+ let data: z.infer<typeof file> | undefined;+ const load = () => {+ if (data) return data;+ try {+ const raw = io.read(options.filePath);+ data = raw ? file.parse(JSON.parse(raw)) : { version: 1, bots: {} };+ } catch (error) {+ // A damaged bookkeeping file must never stop chat; start over and re-check.+ options.log?.warn('Companion sync state unreadable; starting empty', { error: error instanceof Error ? error.name : 'UNKNOWN' });+ data = { version: 1, bots: {} };+ }+ return data;+ };+ return {+ bot: (botId: string): CompanionBotState | null => load().bots[botId] ?? null,+ isDemoted: (botId: string) => load().bots[botId]?.demoted === true,+ demotedBotIds: (): string[] => Object.entries(load().bots).flatMap(([botId, entry]) => entry.demoted ? [botId] : []),+ botForRoom: (roomId: string): string | null =>+ Object.entries(load().bots).find(([, entry]) => entry.roomId === roomId)?.[0] ?? null,+ /**+ * Mutate one companion's entry and persist atomically. The new state applies in this run even+ * when the disk write fails (e.g. a full disk): a demotion must never wait on it. Every update+ * writes the whole file, so the next one retries the lost write.+ */+ update(botId: string, actorId: string, mutate: (entry: CompanionBotState) => void): CompanionBotState {+ if (options.current && !options.current()) throw new Error('OWNER_CHANGED');+ const state = load();+ const previous = state.bots[botId];+ // A different actor for the same local id is a different cloud companion.+ const entry: CompanionBotState = previous && previous.actorId === actorId+ ? structuredClone(previous) : { actorId, prefs: {} };+ mutate(entry);+ const next = { ...state, bots: { ...state.bots, [botId]: bot.parse(entry) } };+ data = next;+ try {+ io.write(options.filePath, JSON.stringify(next));+ } catch (error) {+ options.log?.warn('Companion sync state not saved; will retry', { code: (error as NodeJS.ErrnoException)?.code ?? 'UNKNOWN' });+ }+ return next.bots[botId]!;+ },+ };+}++export type CompanionCloudState = ReturnType<typeof createCompanionCloudState>;diff --git a/apps/desktop/src/main/companion-cloud/types.ts b/apps/desktop/src/main/companion-cloud/types.tsnew file mode 100644index 0000000000..9f10bfa820--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/types.ts@@ -0,0 +1,23 @@+/** The Chat Server request function owned by chatServer.ts (account/endpoint bound). */+export type CompanionApi = <T>(route: string, method?: string, data?: unknown, actorId?: string) => Promise<T>;++export interface CompanionLog {+ warn: (message: string, meta?: Record<string, unknown>) => void;+ info?: (message: string, meta?: Record<string, unknown>) => void;+}++/**+ * Details of a definitive Chat Server rejection (`{ error: { code, details } }`),+ * or null when the error is anything else. chatServer.ts keeps the code as the+ * message and exposes `status` / `details` on its response error.+ */+export function chatRejection(error: unknown, status: number, code: string): Record<string, unknown> | null {+ if (!(error instanceof Error) || error.message !== code) return null;+ if ((error as { status?: unknown }).status !== status) return null;+ const details = (error as { details?: unknown }).details;+ return details && typeof details === 'object' && !Array.isArray(details) ? details as Record<string, unknown> : {};+}++export function errorCode(error: unknown): string {+ return error instanceof Error ? error.message.slice(0, 80) : 'UNKNOWN';+}diff --git a/apps/desktop/src/main/companion-cloud/uploader.ts b/apps/desktop/src/main/companion-cloud/uploader.tsnew file mode 100644index 0000000000..0bcfdadaad--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/uploader.ts@@ -0,0 +1,162 @@+/**+ * Home-only upload of a companion's profile, memories and own skills as Chat Server+ * preferences of the companion actor (cloud-companions.md §2). Only changed values+ * are written; values that disappeared locally become `null` tombstones.+ */+import { createHash } from 'node:crypto';+import type { CompanionCloudState } from './state.js';+import { chatRejection, errorCode, type CompanionApi, type CompanionLog } from './types.js';++export const COMPANION_PROFILE_KEY = 'companion.profile.v1';+export const COMPANION_MEMORY_PREFIX = 'companion.memory.v1:';+export const COMPANION_SKILL_PREFIX = 'companion.skill.v1:';+const OWNED_PREFIXES = [COMPANION_PROFILE_KEY, COMPANION_MEMORY_PREFIX, COMPANION_SKILL_PREFIX];+const MAX_KEY_LENGTH = 160;+export const COMPANION_VALUE_MAX_BYTES = 60 * 1024;+/** A value over the size limit was not uploaded (thrown only when every value is required). */+export const COMPANION_VALUE_TOO_LARGE = 'COMPANION_VALUE_TOO_LARGE';++export interface CompanionPreferenceValue { key: string; value: unknown }++const PROFILE_FIELDS = ['name', 'description', 'soul', 'systemPrompt', 'user'] as const;+export type CompanionProfileSnapshot = Record<(typeof PROFILE_FIELDS)[number], string>;++/** The complete profile the home uploads (host.readCompanionValues); anything less is not a snapshot. */+export function isCompanionProfileSnapshot(value: unknown): value is CompanionProfileSnapshot {+ return !!value && typeof value === 'object' && !Array.isArray(value)+ && PROFILE_FIELDS.every(field => typeof (value as Record<string, unknown>)[field] === 'string');+}++/** Stable JSON (sorted object keys): the server's JSONB does not preserve key order. */+export function canonicalJson(value: unknown): string {+ if (Array.isArray(value)) return `[${value.map(canonicalJson).join(',')}]`;+ if (value && typeof value === 'object') {+ return `{${Object.keys(value).sort().filter(key => (value as Record<string, unknown>)[key] !== undefined)+ .map(key => `${JSON.stringify(key)}:${canonicalJson((value as Record<string, unknown>)[key])}`).join(',')}}`;+ }+ return JSON.stringify(value ?? null);+}++const sha256 = (text: string) => createHash('sha256').update(text).digest('hex');+export const TOMBSTONE_HASH = sha256('null');+export const valueHash = (value: unknown) => sha256(canonicalJson(value));+/** First-upgrade bursts are spread over cycles. */+export const COMPANION_UPLOAD_WRITES_PER_CYCLE = 30;++export class CompanionLostHomeError extends Error {+ constructor() { super('NOT_HOME'); }+}++export function createCompanionUploader(deps: {+ api: CompanionApi;+ state: CompanionCloudState;+ readValues: (botId: string) => Promise<CompanionPreferenceValue[]>;+ /** Re-read the server: is this computer still the home? Asked before overwriting a conflicting value. */+ confirmHome?: (botId: string, actorId: string) => Promise<boolean>;+ /** The home moved away while uploading: re-read actors so this copy is demoted. */+ onLostHome?: () => void;+ log?: CompanionLog;+ maxValueBytes?: number;+}) {+ const maxBytes = deps.maxValueBytes ?? COMPANION_VALUE_MAX_BYTES;+ const owned = (key: string) => OWNED_PREFIXES.some(prefix => key === prefix || (prefix.endsWith(':') && key.startsWith(prefix)));+ type Row = { key: string; value: unknown; revision: number };+ const readRows = async (actorId: string) => {+ const rows = await deps.api<Row[]>('/preferences', 'GET', undefined, actorId);+ return Array.isArray(rows) ? rows : [];+ };++ async function write(actorId: string, key: string, value: unknown, json: string, expectedRevision: number) {+ const operationId = `cpref:${sha256(`${key}\n${expectedRevision}\n${json}`).slice(0, 48)}`;+ const result = await deps.api<{ revision?: number }>('/preferences', 'POST', { operationId, key, expectedRevision, value }, actorId);+ return typeof result?.revision === 'number' ? result.revision : expectedRevision + 1;+ }++ /** Read the server's revisions once, so a lost state file never conflicts forever. Keeps which keys were ours. */+ async function seed(botId: string, actorId: string) {+ const rows = await readRows(actorId);+ deps.state.update(botId, actorId, entry => {+ for (const row of rows) {+ if (!owned(row.key) || typeof row.revision !== 'number') continue;+ const known = entry.prefs[row.key];+ // A key this device holds keeps the value it holds (e.g. what a take-over just restored):+ // a newer server value written meanwhile (the old home's late upload) is not an edit here,+ // and must not be overwritten unless this device really changes the key.+ entry.prefs[row.key] = known?.local+ ? { ...known, revision: row.revision }+ : { hash: valueHash(row.value), revision: row.revision };+ }+ entry.prefsSeeded = true;+ });+ }++ /** Someone else wrote this key: only the home may overwrite it, and only once. */+ async function resolveConflict(botId: string, actorId: string, key: string, value: unknown, json: string, hash: string, fallbackRevision: number) {+ if (deps.confirmHome && !(await deps.confirmHome(botId, actorId))) {+ deps.onLostHome?.();+ throw new CompanionLostHomeError();+ }+ const server = (await readRows(actorId)).find(row => row.key === key);+ if (server && valueHash(server.value) === hash) return server.revision;+ return write(actorId, key, value, json, server?.revision ?? fallbackRevision);+ }++ /**+ * Upload what changed; returns the number of writes made (bounded by `budget`). With+ * `requireAll` (before a hand-over) an oversized value fails the sync instead of being skipped.+ */+ async function syncBot(botId: string, actorId: string, budget = Number.POSITIVE_INFINITY,+ options: { requireAll?: boolean } = {}): Promise<number> {+ const values = await deps.readValues(botId);+ if (deps.state.bot(botId)?.actorId !== actorId || !deps.state.bot(botId)?.prefsSeeded) await seed(botId, actorId);+ const desired = new Map<string, unknown>();+ for (const { key, value } of values) desired.set(key, value);+ // Only keys this device itself had are tombstoned; never what merely exists on the server.+ for (const [key, entry] of Object.entries(deps.state.bot(botId)?.prefs ?? {})) {+ if (!desired.has(key) && entry.local && entry.hash !== TOMBSTONE_HASH) desired.set(key, null);+ }+ let writes = 0;+ let skipped = 0;+ for (const [key, value] of desired) {+ const json = canonicalJson(value);+ if (key.length > MAX_KEY_LENGTH || Buffer.byteLength(json) > maxBytes) {+ deps.log?.warn('Companion value too large to upload; skipped', { actorId, keyKind: key.split(':')[0], bytes: Buffer.byteLength(json) });+ skipped += 1;+ continue;+ }+ const hash = sha256(json);+ const prior = deps.state.bot(botId)?.prefs[key];+ if (prior ? prior.hash === hash : value === null) {+ if (prior && !prior.local && value !== null) deps.state.update(botId, actorId, entry => { entry.prefs[key] = { ...prior, local: true }; });+ continue;+ }+ if (writes >= budget) break;+ writes += 1;+ let revision: number;+ try {+ revision = await write(actorId, key, value, json, prior?.revision ?? 0);+ } catch (error) {+ const conflict = chatRejection(error, 409, 'REVISION_CONFLICT');+ if (!conflict || typeof conflict.revision !== 'number') throw error;+ revision = await resolveConflict(botId, actorId, key, value, json, hash, conflict.revision);+ }+ deps.state.update(botId, actorId, entry => { entry.prefs[key] = { hash, revision, local: true }; });+ }+ if (skipped > 0 && options.requireAll) throw new Error(COMPANION_VALUE_TOO_LARGE);+ return writes;+ }++ return {+ syncBot,+ /** Errors are logged per companion and retried next cycle. Returns true when the write budget ran out. */+ async syncAll(bots: Array<{ botId: string; actorId: string }>, limit = COMPANION_UPLOAD_WRITES_PER_CYCLE): Promise<boolean> {+ let remaining = limit;+ for (const { botId, actorId } of bots) {+ if (remaining <= 0) return true;+ try { remaining -= await syncBot(botId, actorId, remaining); }+ catch (error) { deps.log?.warn('Companion upload will retry', { actorId, code: errorCode(error) }); }+ }+ return remaining <= 0;+ },+ };+}diff --git a/apps/desktop/src/main/companion-cloud/view.ts b/apps/desktop/src/main/companion-cloud/view.tsnew file mode 100644index 0000000000..9f9273ee51--- /dev/null+++ b/apps/desktop/src/main/companion-cloud/view.ts@@ -0,0 +1,21 @@+/** Renderer view of companion homes: the registry plus device-link names and presence. */+import type { CompanionCloudSnapshot } from '../../shared/companionCloud.js';+import type { DeviceLinkDeviceView } from '../../shared/deviceLinkIpc.js';++export async function companionCloudView(+ snapshot: CompanionCloudSnapshot,+ listDevices: () => Promise<DeviceLinkDeviceView[]>,+): Promise<CompanionCloudSnapshot> {+ if (!snapshot.enabled) return snapshot;+ // Presence is advisory; without the list the homes still show, just not their names.+ const devices = await listDevices().catch(() => [] as DeviceLinkDeviceView[]);+ return {+ ...snapshot,+ actors: snapshot.actors.map(actor => {+ if (!actor.homeDeviceId) return { ...actor, homeDevice: null };+ const isSelf = actor.homeDeviceId === snapshot.selfDeviceId;+ const device = devices.find(candidate => candidate.deviceId === actor.homeDeviceId);+ return { ...actor, homeDevice: { deviceId: actor.homeDeviceId, name: device?.name ?? '', online: isSelf || device?.online === true, isSelf } };+ }),+ };+}diff --git a/apps/desktop/src/main/im/dingtalk/__tests__/publicImageFetch.test.ts b/apps/desktop/src/main/im/dingtalk/__tests__/publicImageFetch.test.tsindex 2cc3a6bb45..779c4e089b 100644--- a/apps/desktop/src/main/im/dingtalk/__tests__/publicImageFetch.test.ts+++ b/apps/desktop/src/main/im/dingtalk/__tests__/publicImageFetch.test.ts@@ -47,4 +47,16 @@ describe('IM public image fetch', () => {).rejects.toThrow(/size limit/);expect(release).toHaveBeenCalledOnce();});++ it('aborts the download when the caller cancels', async () => {+ const caller = new AbortController();+ let seen: AbortSignal | undefined;+ const guardedFetch = vi.fn<GuardedImageFetch>(async ({ signal }) => {+ seen = signal;+ caller.abort();+ return { response: new Response(PNG_BYTES), finalUrl: 'https://cdn.example/image.png', release: async () => undefined };+ });+ await fetchPublicImageBytes('https://cdn.example/image.png', 1024, guardedFetch, { signal: caller.signal });+ expect(seen?.aborted).toBe(true);+ });});diff --git a/apps/desktop/src/main/im/publicImageFetch.ts b/apps/desktop/src/main/im/publicImageFetch.tsindex aa3b5cf423..39dd25ac5a 100644--- a/apps/desktop/src/main/im/publicImageFetch.ts+++ b/apps/desktop/src/main/im/publicImageFetch.ts@@ -53,12 +53,16 @@ export async function fetchPublicImageBytes(url: string,maxBytes: number,guardedFetch: GuardedImageFetch = fetchWithSsrFGuard,+ options: { signal?: AbortSignal; timeoutMs?: number } = {},): Promise<{ buffer: Uint8Array; mimeType?: string }> {if (!Number.isSafeInteger(maxBytes) || maxBytes <= 0) {throw new Error('invalid remote image size limit');}const controller = new AbortController();- const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);+ const timer = setTimeout(() => controller.abort(), options.timeoutMs ?? FETCH_TIMEOUT_MS);+ const abort = () => controller.abort();+ if (options.signal?.aborted) controller.abort();+ options.signal?.addEventListener('abort', abort, { once: true });let result: GuardedFetchResult | null = null;try {result = await guardedFetch({@@ -79,6 +83,7 @@ export async function fetchPublicImageBytes(};} finally {clearTimeout(timer);+ options.signal?.removeEventListener('abort', abort);await result?.release();}}diff --git a/apps/desktop/src/main/localDb/ipc/__tests__/botRemoteResourceProjection.test.ts b/apps/desktop/src/main/localDb/ipc/__tests__/botRemoteResourceProjection.test.tsindex c00503bd61..d98bc9a6be 100644--- a/apps/desktop/src/main/localDb/ipc/__tests__/botRemoteResourceProjection.test.ts+++ b/apps/desktop/src/main/localDb/ipc/__tests__/botRemoteResourceProjection.test.ts@@ -1,4 +1,5 @@import { describe, expect, it } from 'vitest';+import { companionHomes } from '../../../companion-cloud/homes.js';import {botRemoteCollectionItemFromSource,@@ -86,4 +87,15 @@ describe('bot remote resource projection', () => {expect(ordered.map((item) => item.id)).toEqual(['pinned-old', 'recent', 'old']);});++ it('does not list a demoted copy whose main computer is another device', () => {+ companionHomes.update({ enabled: true, selfDeviceId: 'desk', humanActorId: 'human', demotedBotIds: ['moved'],+ actors: [{ id: 'actor', externalId: 'moved', name: 'Moved', avatar: null, homeDeviceId: 'laptop' }] });+ try {+ const visible = visibleBotRemoteResourceSources([{ ...source, id: 'moved' }, { ...source, id: 'here' }]);+ expect(visible.map((item) => item.id)).toEqual(['here']);+ } finally {+ companionHomes.reset();+ }+ });});diff --git a/apps/desktop/src/main/localDb/ipc/botRemoteResourceProjection.ts b/apps/desktop/src/main/localDb/ipc/botRemoteResourceProjection.tsindex a973927ce8..0e357ddbcc 100644--- a/apps/desktop/src/main/localDb/ipc/botRemoteResourceProjection.ts+++ b/apps/desktop/src/main/localDb/ipc/botRemoteResourceProjection.ts@@ -7,6 +7,7 @@ import type {import type { BotRemoteResourceSource } from './bots.js';import { isBotVisibleRemotely } from './botRemoteVisibility.js';+import { isCompanionShadowed } from '../../companion-cloud/homes.js';import { isManagedBotAvatarUrl } from '../../../shared/botAvatarValue.js';export const TEAMMATES_REMOTE_COLLECTION_ID = 'teammates';@@ -140,7 +141,8 @@ export function visibleBotRemoteResourceSources(sources: readonly BotRemoteResourceSource[],): BotRemoteResourceSource[] {return sources- .filter(isBotVisibleRemotely)+ // A demoted copy runs on its home computer; listing it here would duplicate it on other devices.+ .filter(source => isBotVisibleRemotely(source) && !isCompanionShadowed(source.id)).sort((left, right) => {const pinned = Number(Boolean(right.pinnedAt)) - Number(Boolean(left.pinnedAt));return pinned || right.activityAt - left.activityAt || left.id.localeCompare(right.id);diff --git a/apps/desktop/src/main/maker-ipc/__tests__/botMemoryService.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/botMemoryService.test.tsindex ba220fc426..ed66a93a1c 100644--- a/apps/desktop/src/main/maker-ipc/__tests__/botMemoryService.test.ts+++ b/apps/desktop/src/main/maker-ipc/__tests__/botMemoryService.test.ts@@ -304,3 +304,28 @@ it('retries legacy imported shards using their original trimmed-body semantics',expect(await fs.readFile(file, 'utf8')).toBe(before);await expect(service.importDocument('bot-1', 'legacy', 'legacy', 'different')).rejects.toMatchObject({ code: 'version-conflict' });});++describe('cloud companion restore', () => {+ it('restores a raw memory file exactly through the store and removes tombstones', async () => {+ const { service, requestRefresh, flushTimers } = setup();+ const raw = await fs.readFile(path.join(dir, 'feedback_verify-before-claiming.md'), 'utf8');+ await service.restoreRaw('bot-1', 'user_tea.md', raw.replace('feedback', 'user'));+ const restored = await storage.read('user_tea.md');+ expect(restored.frontmatter).toMatchObject({ title: '说结论前核实', description: '先核实再陈述事实', type: 'user' });+ expect(restored.body).toBe((await storage.read('feedback_verify-before-claiming.md')).body);+ expect(await storage.getIndex()).toContain('user_tea.md');+ // Updating an existing file keeps going through the same path.+ await service.restoreRaw('bot-1', 'user_tea.md', '---\ntitle: Tea\n---\nlikes green tea');+ expect((await storage.read('user_tea.md')).body).toBe('likes green tea');+ await service.removeRaw('bot-1', 'user_tea.md');+ await service.removeRaw('bot-1', 'user_tea.md');+ await expect(storage.read('user_tea.md')).rejects.toMatchObject({ code: 'not-found' });+ flushTimers();+ expect(requestRefresh).toHaveBeenCalledWith('session-1');+ });++ it('rejects filenames outside the memory naming rule', async () => {+ const { service } = setup();+ await expect(service.restoreRaw('bot-1', '../evil.md', 'x')).rejects.toThrow();+ });+});diff --git a/apps/desktop/src/main/maker-ipc/__tests__/botProfileFolder.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/botProfileFolder.test.tsindex 58eaa67b31..e28b6a906b 100644--- a/apps/desktop/src/main/maker-ipc/__tests__/botProfileFolder.test.ts+++ b/apps/desktop/src/main/maker-ipc/__tests__/botProfileFolder.test.ts@@ -414,3 +414,20 @@ describe('搬家', () => {expect(result).toEqual({ seeded: true, skillsMoved: false });});});++describe('strict reads (cloud companions)', () => {+ // chmod cannot make a file unreadable on Windows.+ it.skipIf(process.platform === 'win32')('treats a missing file as empty but never an unreadable one', async () => {+ expect((await readBotProfileFolder(root, 'bot-a', { strict: true })).identitySource).toBe('');+ await writeBotProfileFolder(root, 'bot-a', { identitySource: SEED.identitySource });+ const soul = path.join(botProfileDir(root, 'bot-a'), 'SOUL.md');+ await fs.chmod(soul, 0o000);+ try {+ // The lenient reader still renders the settings page; the strict one refuses to report "empty".+ expect((await readBotProfileFolder(root, 'bot-a')).identitySource).toBe('');+ await expect(readBotProfileFolder(root, 'bot-a', { strict: true })).rejects.toMatchObject({ code: 'EACCES' });+ } finally {+ await fs.chmod(soul, 0o600);+ }+ });+});diff --git a/apps/desktop/src/main/maker-ipc/__tests__/botSessionInputGuard.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/botSessionInputGuard.test.tsindex 934ac45f8d..3cdb1aa1b4 100644--- a/apps/desktop/src/main/maker-ipc/__tests__/botSessionInputGuard.test.ts+++ b/apps/desktop/src/main/maker-ipc/__tests__/botSessionInputGuard.test.ts@@ -1,6 +1,9 @@import { describe, expect, it } from 'vitest';-import { botSessionInputBlockReason } from '../botSessionInputGuard.js';+import {+ botSessionInputBlockReason,+ isShadowedCompanionCanonical,+} from '../botSessionInputGuard.js';describe('Bot task input guard', () => {it('does not affect ordinary Cindy tasks', () => {@@ -27,3 +30,19 @@ describe('Bot task input guard', () => {).toContain('归属信息不完整');});});++describe('shadowed companion guard', () => {+ const shadowed = (botId: string) => botId === 'bot_mia';+ it('blocks only the main task of a demoted copy', () => {+ expect(isShadowedCompanionCanonical({ role: 'canonical', botId: 'bot_mia' }, shadowed)).toBe(+ true,+ );+ expect(isShadowedCompanionCanonical({ role: 'delegation', botId: 'bot_mia' }, shadowed)).toBe(+ false,+ );+ expect(isShadowedCompanionCanonical({ role: 'canonical', botId: 'bot_other' }, shadowed)).toBe(+ false,+ );+ expect(isShadowedCompanionCanonical(null, shadowed)).toBe(false);+ });+});diff --git a/apps/desktop/src/main/maker-ipc/__tests__/botSkillStore.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/botSkillStore.test.tsindex b36a66d74a..1e567edd2a 100644--- a/apps/desktop/src/main/maker-ipc/__tests__/botSkillStore.test.ts+++ b/apps/desktop/src/main/maker-ipc/__tests__/botSkillStore.test.ts@@ -19,8 +19,11 @@ import {normalizeBotSkillSlug,parseBotSkillFile,readBotSkill,+ readBotSkillSource,+ listBotSkillSources,renderBotSkillFile,saveBotSkill,+ saveBotSkillSource,seedBotSkillIfMissing,} from '../botSkillStore';@@ -368,3 +371,48 @@ it('preserves a foreground edit when background learning uses an older snapshot'expect((await readBotSkill(userDataDir, 'bot-1', 'weekly-report'))?.body).toBe('Human corrected workflow');await expect(saveBotSkill(userDataDir, 'bot-1', { ...SAMPLE, expectedUpdatedAt: null })).rejects.toThrow('Skill changed during review');});++describe('verbatim SKILL.md (cloud companions)', () => {+ it('round-trips native frontmatter the settings model does not know', async () => {+ const source = '---\nname: brew\ndescription: Brew tea\nallowed-tools: Bash(git:*)\ndisable-model-invocation: true\nmetadata:\n displayName: Brew\n---\n\nsteps\n';+ await saveBotSkillSource(userDataDir, 'bot_a', 'brew', source);+ expect(await readBotSkillSource(userDataDir, 'bot_a', 'brew')).toBe(source);+ expect((await readBotSkill(userDataDir, 'bot_a', 'brew'))?.body).toBe('steps');+ expect(await readBotSkillSource(userDataDir, 'bot_a', 'missing')).toBeNull();+ await expect(saveBotSkillSource(userDataDir, 'bot_a', '../x', source)).rejects.toBeInstanceOf(BotSkillStoreError);+ await expect(saveBotSkillSource(userDataDir, 'bot_a', 'big', `---\nname: big\n---\n${'x'.repeat(BOT_SKILL_MAX_BODY_BYTES + 1)}`))+ .rejects.toBeInstanceOf(BotSkillStoreError);+ });++ it('applies the requested enabled state, moving the whole skill folder', async () => {+ const source = '---\nname: brew\ndescription: Brew\n---\n\nsteps\n';+ await saveBotSkillSource(userDataDir, 'bot_c', 'brew', source);+ await fs.writeFile(path.join(botSkillsDir(userDataDir, 'bot_c'), 'brew', 'helper.sh'), 'echo hi');+ await saveBotSkillSource(userDataDir, 'bot_c', 'brew', source, { enabled: false });+ expect((await readBotSkill(userDataDir, 'bot_c', 'brew'))?.enabled).toBe(false);+ expect(await listBotSkillSources(userDataDir, 'bot_c')).toEqual([{ slug: 'brew', source, enabled: false }]);+ await saveBotSkillSource(userDataDir, 'bot_c', 'brew', source, { enabled: true });+ expect((await readBotSkill(userDataDir, 'bot_c', 'brew'))?.enabled).toBeUndefined();+ expect(await fs.readFile(path.join(botSkillsDir(userDataDir, 'bot_c'), 'brew', 'helper.sh'), 'utf8')).toBe('echo hi');+ });+});++describe('strict skill reads (cloud companions)', () => {+ // chmod cannot make a file unreadable on Windows.+ it.skipIf(process.platform === 'win32')('lists every skill source, empty without a folder, and fails instead of hiding an unreadable one', async () => {+ expect(await listBotSkillSources(userDataDir, 'bot_b')).toEqual([]);+ const source = '---\nname: brew\ndescription: Brew\n---\n\nsteps\n';+ await saveBotSkillSource(userDataDir, 'bot_b', 'brew', source);+ expect(await listBotSkillSources(userDataDir, 'bot_b')).toEqual([{ slug: 'brew', source, enabled: true }]);+ const dir = botSkillsDir(userDataDir, 'bot_b');+ await fs.chmod(dir, 0o000);+ try {+ await expect(listBotSkillSources(userDataDir, 'bot_b')).rejects.toMatchObject({ code: 'EACCES' });+ await expect(readBotSkillSource(userDataDir, 'bot_b', 'brew')).rejects.toMatchObject({ code: 'EACCES' });+ // The settings list keeps its lenient behaviour.+ expect(await listBotSkills(userDataDir, 'bot_b')).toEqual([]);+ } finally {+ await fs.chmod(dir, 0o700);+ }+ });+});diff --git a/apps/desktop/src/main/maker-ipc/__tests__/chatServerCompanion.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/chatServerCompanion.test.tsnew file mode 100644index 0000000000..de551ada55--- /dev/null+++ b/apps/desktop/src/main/maker-ipc/__tests__/chatServerCompanion.test.ts@@ -0,0 +1,299 @@+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+const fixture = vi.hoisted(() => ({ handle: vi.fn(), profiles: [] as unknown[], sockets: [] as import('ws').WebSocket[] }));+vi.mock('../../authManager.js', () => ({ getAccessToken: () => 'isolated-test-token', refresh: vi.fn(async () => true) }));+vi.mock('../../clientEndpointsService.js', () => ({ getClientEndpoint: () => 'https://chat.cindy.app' }));+vi.mock('../chatServerMedia.js', () => ({ createChatMedia: () => ({ upload: vi.fn(async () => []), download: vi.fn() }) }));+vi.mock('../chatServerWorkspaces.js', () => ({ chatServerWorkspaces: () => ({ read: () => null, save: vi.fn() }) }));+vi.mock('../chatMigrationReceipts.js', () => ({ chatMigrationReceipts: () => ({ read: () => null, save: vi.fn() }) }));+vi.mock('electron', () => ({ app: { isPackaged: false, getPath: () => '/isolated' } }));+vi.mock('node:fs', () => ({ existsSync: () => true, readFileSync: () => '{"baseUrl":"http://127.0.0.1:3018","auth":"cindy"}' }));+vi.mock('../botGroupChatService.js', () => ({ readPersistedReplyText: vi.fn() }));+vi.mock('../../localDb/client/current.js', () => ({ getDbClient: () => ({ drizzle: {+ select: () => ({ from: () => ({ where: () => Object.assign(Promise.resolve(fixture.profiles), { limit: async () => [{ id: 'existing-local-group' }] }) }) }),+ insert: () => ({ values: () => ({ onConflictDoNothing: async () => undefined }) }),+} }) }));+vi.mock('node:http', async () => {+ const { EventEmitter } = await import('node:events');+ return { request: (url: string, options: { method: string; headers: Record<string, string> }, callback: (response: unknown) => void) => {+ const req = Object.assign(new EventEmitter(), {+ end: (data?: string) => {+ const target = new URL(url);+ void Promise.resolve().then(() => fixture.handle(target.pathname.slice(3) + target.search, options.method,+ data ? JSON.parse(data) : undefined, options.headers['X-Chat-Actor']))+ .then(result => {+ const response = Object.assign(new EventEmitter(), { statusCode: result?.status ?? 200, headers: {} });+ callback(response);+ response.emit('data', Buffer.from(JSON.stringify(result?.body ?? {})));+ response.emit('end');+ }, error => req.emit('error', error));+ },+ destroy: (error: Error) => req.emit('error', error),+ });+ return req;+ } };+});+vi.mock('node:https', async () => ({ request: (await import('node:http')).request }));+vi.mock('ws', async () => {+ const { EventEmitter } = await import('node:events');+ return { default: class extends EventEmitter {+ static OPEN = 1; readyState = 0; send = vi.fn();+ constructor() { super(); fixture.sockets.push(this as unknown as import('ws').WebSocket); }+ close() { this.emit('close'); }+ } };+});+import { withChatServer } from '../chatServer.js';+import { createCompanionHomeRegistry } from '../../companion-cloud/homes.js';+import { createCompanionCloudState } from '../../companion-cloud/state.js';+import type { CompanionCloudHost } from '../../companion-cloud/runtime.js';+import type { BotGroupChatService, BotGroupChatServiceDeps } from '../botGroupChatService.js';++const selfId = '30000000-0000-4000-8000-000000000001';+const botActor = '20000000-0000-4000-8000-000000000001';+const roomId = '10000000-0000-4000-8000-000000000001';+const sourceId = '50000000-0000-4000-8000-000000000001';+const execution = { id: '40000000-0000-4000-8000-000000000001', conversation_id: roomId, source_message_id: sourceId,+ bot_id: botActor, requester_id: selfId, context_seq: '1', epoch: 1, status: 'running', access_mode: 'owner', access_revision: 1 };++describe('Chat Server cloud companions', () => {+ let service: BotGroupChatService;+ let deps: BotGroupChatServiceDeps;+ let host: CompanionCloudHost & { deliverToCanonical: ReturnType<typeof vi.fn> };+ let me: Record<string, unknown>;+ let home: string | null;+ let patch: (body: unknown) => { status?: number; body: unknown };+ let claimed: boolean;+ let directMembers: Array<{ id: string; state: string }>;+ const calls = (route: string, method?: string) => fixture.handle.mock.calls.filter(([r, m]) => r === route && (!method || m === method));++ function respond(route: string, method: string, body: unknown) {+ if (route === '/me') return { body: me };+ if (route === '/actors' && method === 'GET') return { body: [{ id: botActor, kind: 'bot', externalId: 'local-bot', name: 'Mia', homeDeviceId: home }] };+ if (route === `/actors/${botActor}` && method === 'PATCH') return patch(body);+ if (route === '/executions/claim') { const next = claimed ? null : execution; claimed = true; return { body: { execution: next } }; }+ if (route === `/conversations/${roomId}/snapshot`) return { body: { room: { id: roomId, kind: 'direct', name: 'Mia', revision: 1 }, members: directMembers, messages: [], cursor: '1' } };+ if (route === `/conversations/${roomId}/messages/${sourceId}`) return { body: { id: sourceId, seq: '1', authorId: selfId, author: { kind: 'human', name: 'Me' },+ deleted: false, threadRootId: null, createdAt: '2026-10-13T00:00:00Z', content: [{ type: 'text', text: 'hi' }, { type: 'media', mediaId: sourceId, caption: 'a.png' }] } };+ if (route === '/preferences') return { body: [] };+ return { body: {} };+ }++ beforeEach(() => {+ vi.useFakeTimers({ toFake: ['setInterval', 'clearInterval', 'setTimeout', 'clearTimeout', 'Date'] });+ vi.setSystemTime(new Date('2026-10-13T00:00:00Z'));+ vi.stubEnv('XDT_ISOLATED', '1');+ fixture.profiles = [{ id: 'local-bot', displayName: 'Mia', avatar: null, status: 'active' }];+ fixture.sockets = [];+ me = { actor: { id: selfId }, deviceId: 'desk-1', capabilities: { companionHome: true } };+ home = null; claimed = false;+ directMembers = [{ id: selfId, state: 'joined' }, { id: botActor, state: 'joined' }];+ patch = () => { home = 'desk-1'; return { body: { id: botActor, homeDeviceId: 'desk-1' } }; };+ fixture.handle.mockImplementation((route, method, body) => respond(route, method, body));+ const files = new Map<string, string>();+ host = {+ homes: createCompanionHomeRegistry(),+ openState: (_endpoint, _human, current) => createCompanionCloudState({ filePath: 'state.json', current,+ io: { read: path => files.get(path) ?? null, write: (path, contents) => { files.set(path, contents); } } }),+ readValues: async () => [], canonicalSession: async () => null, rowsAfter: async () => [], latestRows: async () => [],+ deliverToCanonical: vi.fn(async () => ({ ok: true as const })),+ };+ deps = { ensureLane: vi.fn(), abortLane: vi.fn(async () => {}), dispatch: vi.fn(), companionCloud: host } as unknown as BotGroupChatServiceDeps;+ service = withChatServer({ listGroups: vi.fn(async () => ({ ok: true, groups: [] })), dispose: vi.fn() } as unknown as BotGroupChatService, deps);+ });+ afterEach(() => { service.dispose(); vi.useRealTimers(); vi.unstubAllEnvs(); vi.clearAllMocks(); });++ it('claims an empty home for this computer once', async () => {+ claimed = true;+ await vi.advanceTimersByTimeAsync(2000);+ expect(calls(`/actors/${botActor}`, 'PATCH').map(call => call[2])).toEqual([{ homeDeviceId: 'desk-1', expectedHomeDeviceId: null }]);+ expect(host.homes.snapshot()).toMatchObject({ enabled: true, selfDeviceId: 'desk-1', humanActorId: selfId,+ actors: [{ id: botActor, externalId: 'local-bot', homeDeviceId: 'desk-1' }] });+ expect(host.homes.isHomeHere('local-bot')).toBe(true);+ await vi.advanceTimersByTimeAsync(10_000);+ expect(calls(`/actors/${botActor}`, 'PATCH')).toHaveLength(1);+ expect(calls('/executions/claim').length).toBeGreaterThan(1);+ });++ it('drops the previous owner\'s companion homes as soon as the service is touched after an account switch', async () => {+ service.dispose();+ let owner = 'a';+ deps = { ...deps, captureOwnerScope: () => owner, isOwnerScopeCurrent: (scope: unknown) => scope === owner } as unknown as BotGroupChatServiceDeps;+ service = withChatServer({ listGroups: vi.fn(async () => ({ ok: true, groups: [] })), dispose: vi.fn() } as unknown as BotGroupChatService, deps);+ claimed = true;+ await vi.advanceTimersByTimeAsync(2000);+ expect(host.homes.snapshot().actors).toHaveLength(1);+ owner = 'b';+ void service.chatServer;+ expect(host.homes.snapshot().actors).toEqual([]);+ });++ it('claims nothing while the home could not be registered yet', async () => {+ claimed = true;+ patch = () => ({ status: 503, body: { error: { code: 'UNAVAILABLE' } } });+ await vi.advanceTimersByTimeAsync(10_000);+ expect(calls(`/actors/${botActor}`, 'PATCH').length).toBeGreaterThan(0);+ expect(calls('/executions/claim')).toHaveLength(0);+ // Registration succeeds on a later cycle: this computer is the home and starts claiming.+ patch = () => { home = 'desk-1'; return { body: { id: botActor, homeDeviceId: 'desk-1' } }; };+ await vi.advanceTimersByTimeAsync(20_000);+ expect(calls('/executions/claim').length).toBeGreaterThan(0);+ });++ it('adopts another computer as home and stops claiming its work', async () => {+ patch = () => { home = 'laptop'; return { status: 409, body: { error: { code: 'HOME_DEVICE_CONFLICT', details: { homeDeviceId: 'laptop' } } } }; };+ await vi.advanceTimersByTimeAsync(2000);+ expect(host.homes.homeOf('local-bot')).toBe('laptop');+ expect(host.homes.isHomeHere('local-bot')).toBe(false);+ // The local copy is demoted: hidden from the roster, no routines, no uploads.+ expect(host.homes.snapshot().demotedBotIds).toEqual(['local-bot']);+ expect(host.homes.isShadowed('local-bot')).toBe(true);+ await vi.advanceTimersByTimeAsync(10_000);+ expect(calls('/executions/claim')).toHaveLength(0);+ });++ it('publishes each companion\'s name on its own, so one broken avatar never blocks the others', async () => {+ const broken = '60000000-0000-4000-8000-0000000000b2';+ fixture.profiles = [{ id: 'broken-bot', displayName: 'Bad', avatar: 'cindy-media://missing', status: 'active' },+ { id: 'local-bot', displayName: 'Mia (renamed)', avatar: null, status: 'active' }];+ home = 'desk-1'; claimed = true;+ fixture.handle.mockImplementation((route, method, body) => route === '/actors' && method === 'GET'+ ? { body: [{ id: broken, kind: 'bot', externalId: 'broken-bot', name: 'Bad', homeDeviceId: 'desk-1' },+ { id: botActor, kind: 'bot', externalId: 'local-bot', name: 'Mia', homeDeviceId: 'desk-1' }] }+ : respond(route, method, body));+ await vi.advanceTimersByTimeAsync(2000);+ expect(calls(`/actors/${botActor}/profile`, 'POST').map(call => call[2])).toEqual([expect.objectContaining({ name: 'Mia (renamed)' })]);+ expect(calls(`/actors/${broken}/profile`, 'POST')).toHaveLength(0);+ });++ it('publishes the name only from the home, after the home is known', async () => {+ fixture.profiles = [{ id: 'local-bot', displayName: 'Mia (renamed)', avatar: null, status: 'active' }];+ claimed = true;+ await vi.advanceTimersByTimeAsync(2000);+ const order = fixture.handle.mock.calls.map(([route, method]) => `${method} ${route}`);+ expect(order.indexOf(`POST /actors/${botActor}/profile`)).toBeGreaterThan(order.indexOf(`PATCH /actors/${botActor}`));+ });++ it('never publishes the name or avatar from a copy whose home is another computer', async () => {+ fixture.profiles = [{ id: 'local-bot', displayName: 'Mia (stale copy)', avatar: null, status: 'active' }];+ home = 'laptop';+ claimed = true;+ await vi.advanceTimersByTimeAsync(10_000);+ expect(calls(`/actors/${botActor}/profile`)).toHaveLength(0);+ expect(host.homes.isShadowed('local-bot')).toBe(true);+ });++ it('never publishes the name or avatar from an installation not confirmed as the home one', async () => {+ service.dispose();+ host = { ...host, homes: createCompanionHomeRegistry(), installationId: () => 'install-b' } as typeof host;+ deps = { ...deps, companionCloud: host } as BotGroupChatServiceDeps;+ home = 'desk-1';+ fixture.profiles = [{ id: 'local-bot', displayName: 'Mia (other install)', avatar: null, status: 'active' }];+ // The other Cindy installation on this computer runs the companion.+ fixture.handle.mockImplementation((route, method, body) => route === '/preferences' && method === 'GET'+ ? { body: [{ key: 'companion.install.v1', value: { installationId: 'install-a', deviceId: 'desk-1' }, revision: 1 }] }+ : respond(route, method, body));+ service = withChatServer({ listGroups: vi.fn(async () => ({ ok: true, groups: [] })), dispose: vi.fn() } as unknown as BotGroupChatService, deps);+ claimed = true;+ await vi.advanceTimersByTimeAsync(10_000);+ expect(calls(`/actors/${botActor}/profile`)).toHaveLength(0);+ expect(calls('/executions/claim')).toHaveLength(0);+ });++ it('keeps a demoted copy shadowed from the persisted list before the server answers', async () => {+ service.dispose();+ const persisted = { ids: ['local-bot'] };+ host = { ...host, homes: createCompanionHomeRegistry(),+ shadows: { read: () => persisted.ids, write: (ids: string[]) => { persisted.ids = ids; } } } as typeof host;+ deps = { ...deps, companionCloud: host } as BotGroupChatServiceDeps;+ fixture.handle.mockImplementation(() => { throw new Error('server unreachable'); });+ service = withChatServer({ listGroups: vi.fn(async () => ({ ok: true, groups: [] })), dispose: vi.fn() } as unknown as BotGroupChatService, deps);+ await vi.advanceTimersByTimeAsync(4000);+ expect(host.homes.isShadowed('local-bot')).toBe(true);+ expect(host.homes.snapshot()).toMatchObject({ enabled: false, demotedBotIds: ['local-bot'] });+ });++ it('retries saving the demotion until it reaches the disk', async () => {+ service.dispose();+ const writes: string[][] = [];+ let failing = true;+ host = { ...host, homes: createCompanionHomeRegistry(), shadows: { read: () => [], write: (ids: string[]) => {+ writes.push(ids);+ if (failing) throw Object.assign(new Error('disk full'), { code: 'ENOSPC' });+ } } } as typeof host;+ deps = { ...deps, companionCloud: host } as BotGroupChatServiceDeps;+ patch = () => { home = 'laptop'; return { status: 409, body: { error: { code: 'HOME_DEVICE_CONFLICT', details: { homeDeviceId: 'laptop' } } } }; };+ service = withChatServer({ listGroups: vi.fn(async () => ({ ok: true, groups: [] })), dispose: vi.fn() } as unknown as BotGroupChatService, deps);+ await vi.advanceTimersByTimeAsync(2000);+ // Hidden right away even though the list could not be saved.+ expect(host.homes.isShadowed('local-bot')).toBe(true);+ expect(writes).toContainEqual(['local-bot']);+ failing = false;+ const attempts = writes.length;+ await vi.advanceTimersByTimeAsync(120_000);+ expect(writes.length).toBeGreaterThan(attempts);+ expect(writes.at(-1)).toEqual(['local-bot']);+ // Saved: not written again while unchanged.+ const saved = writes.length;+ await vi.advanceTimersByTimeAsync(120_000);+ expect(writes).toHaveLength(saved);+ });++ it('stays inert on a server without companion homes', async () => {+ me = { actor: { id: selfId } };+ claimed = true;+ await vi.advanceTimersByTimeAsync(20_000);+ expect(fixture.handle.mock.calls.filter(([route, method]) => route.startsWith('/actors/') && method === 'PATCH')).toHaveLength(0);+ expect(calls('/preferences')).toHaveLength(0);+ expect(host.homes.snapshot().enabled).toBe(false);+ expect(host.homes.isHomeHere('local-bot')).toBe(true);+ });++ it('delivers a 1:1 room message to the canonical Session and completes without content', async () => {+ await vi.advanceTimersByTimeAsync(2000);+ await vi.advanceTimersByTimeAsync(0);+ expect(host.deliverToCanonical).toHaveBeenCalledWith('local-bot', 'hi\n[附件: a.png]', `chat-direct:${execution.id}:${sourceId}`);+ expect(deps.ensureLane).not.toHaveBeenCalled();+ expect(deps.dispatch).not.toHaveBeenCalled();+ const results = fixture.handle.mock.calls.filter(([route, , body]) => route === `/conversations/${roomId}/executions/${execution.id}`+ && ['complete', 'fail'].includes(body?.action));+ expect(results).toHaveLength(1);+ expect(results[0]![2]).toMatchObject({ action: 'complete', continueDiscussion: false });+ expect(results[0]![2]).not.toHaveProperty('content');+ expect(results[0]![3]).toBe(botActor);+ });++ it('never treats someone else\'s 1:1 room as the companion\'s own room', async () => {+ directMembers = [{ id: selfId, state: 'joined' }, { id: '60000000-0000-4000-8000-000000000009', state: 'joined' }];+ await vi.advanceTimersByTimeAsync(2000);+ await vi.advanceTimersByTimeAsync(0);+ expect(host.deliverToCanonical).not.toHaveBeenCalled();+ expect(deps.ensureLane).not.toHaveBeenCalled();+ const results = fixture.handle.mock.calls.filter(([route, , body]) => route === `/conversations/${roomId}/executions/${execution.id}`+ && ['complete', 'fail'].includes(body?.action));+ expect(results.map(call => call[2].action)).toEqual(['fail']);+ });++ it('fails the execution with a short reason when the main task does not accept it', async () => {+ host.deliverToCanonical.mockResolvedValue({ ok: false, errorCode: 'TARGET_BOT_INACTIVE' });+ await vi.advanceTimersByTimeAsync(2000);+ await vi.advanceTimersByTimeAsync(0);+ const results = fixture.handle.mock.calls.filter(([route, , body]) => route === `/conversations/${roomId}/executions/${execution.id}`+ && ['complete', 'fail'].includes(body?.action));+ expect(results.map(call => call[2].action)).toEqual(['fail']);+ expect(typeof results[0]![2].detail).toBe('string');+ });++ it('re-reads homes immediately when the actor stream reports a move', async () => {+ claimed = true;+ await vi.advanceTimersByTimeAsync(2000);+ expect(host.homes.homeOf('local-bot')).toBe('desk-1');+ const socket = fixture.sockets[0]!;+ socket.emit('message', JSON.stringify({ type: 'ready' }));+ home = 'laptop';+ const before = calls('/me').length;+ socket.emit('message', JSON.stringify({ type: 'changes', scope: `actor:${selfId}`, cursor: '2',+ changes: [{ type: 'actor.changed', entityId: botActor, data: { homeDeviceId: 'laptop' } }] }));+ await vi.advanceTimersByTimeAsync(0);+ expect(calls('/me').length).toBe(before + 1);+ expect(host.homes.homeOf('local-bot')).toBe('laptop');+ });+});diff --git a/apps/desktop/src/main/maker-ipc/botDirectMessageService.ts b/apps/desktop/src/main/maker-ipc/botDirectMessageService.tsindex fcf9f9d53a..56f5179c20 100644--- a/apps/desktop/src/main/maker-ipc/botDirectMessageService.ts+++ b/apps/desktop/src/main/maker-ipc/botDirectMessageService.ts@@ -1,4 +1,5 @@import { parseBotPeerAddress, botPeerAddress, MAX_BOT_PEER_ADDRESS_CHARS } from '../../shared/botPeerAddress.js';+import { isCompanionShadowed } from '../companion-cloud/homes.js';import { createHash, randomUUID } from 'node:crypto';import { withBotProfileLocks } from './botProfileLock.js';import { authorizeGroupTool, GroupToolAuthorizationError } from './botGroupToolAuthorization.js';@@ -134,7 +135,8 @@ async function activeRoster(beforeReturn?: () => Promise<void>): Promise<BotRost.where(eq(botProfiles.status, 'active')).orderBy(desc(botProfiles.updatedAt));await beforeReturn?.();- return roster;+ // Demoted copies run on another computer, where list_agents finds them remotely.+ return roster.filter(row => !isCompanionShadowed(row.id));}async function failed(diff --git a/apps/desktop/src/main/maker-ipc/botGroupChatService.ts b/apps/desktop/src/main/maker-ipc/botGroupChatService.tsindex 86b6e494fe..8676d02746 100644--- a/apps/desktop/src/main/maker-ipc/botGroupChatService.ts+++ b/apps/desktop/src/main/maker-ipc/botGroupChatService.ts@@ -160,6 +160,8 @@ export interface BotGroupChatServiceDeps {captureOwnerScope?: () => DataOwnerBroadcastScope;isOwnerScopeCurrent?: (scope: DataOwnerBroadcastScope) => boolean;onChanged?: (payload: BotGroupChangedPayload, ownerScope?: DataOwnerBroadcastScope) => void;+ /** Cloud companions (cloud-companions.md); absent keeps the Chat Server per-computer only. */+ companionCloud?: import('../companion-cloud/runtime.js').CompanionCloudHost;now?: () => number;createId?: () => string;memberTurnTimeoutMs?: number;diff --git a/apps/desktop/src/main/maker-ipc/botMemoryService.ts b/apps/desktop/src/main/maker-ipc/botMemoryService.tsindex 555aece8bb..e314b02d2f 100644--- a/apps/desktop/src/main/maker-ipc/botMemoryService.ts+++ b/apps/desktop/src/main/maker-ipc/botMemoryService.ts@@ -29,6 +29,7 @@ import {type BotMemoryUpdateInput,} from '../../shared/botMemory.js';import { throwIpcError } from '../utils/ipcValidate.js';+import matter from 'gray-matter';const PREVIEW_CHARS = 240;const DESCRIPTION_MAX = 200;@@ -301,6 +302,48 @@ export function createBotMemoryService(deps: BotMemoryServiceDeps) {});},+ /**+ * Restore one memory file exactly as another computer stored it (cloud companions).+ * Goes through the store so MEMORY.md, FTS and the runtime refresh stay consistent.+ */+ async restoreRaw(botId: string, rawFilename: unknown, raw: string): Promise<void> {+ const filename = readFilename(rawFilename);+ const [, type, name] = /^([a-z]+)_(.+)\.md$/.exec(filename)!;+ const parsed = matter(raw);+ const data = parsed.data as { title?: unknown; description?: unknown; bodyLength?: unknown };+ const title = typeof data.title === 'string' && data.title.trim() ? data.title.trim().slice(0, BOT_MEMORY_TITLE_MAX) : name!;+ const exact = Number.isSafeInteger(data.bodyLength) && parsed.content.length === (data.bodyLength as number) + 1 && parsed.content.endsWith('\n');+ const body = exact ? parsed.content.slice(0, -1) : parsed.content.trim();+ if (!body) throwIpcError('INVALID_PARAMS', 'Invalid memory content');+ const description = typeof data.description === 'string' && data.description.trim()+ ? data.description.trim().slice(0, DESCRIPTION_MAX) : botMemoryDescriptionFromBody(body) || title;+ const { store, owner } = await storeOf(botId);+ await serialized(`${botId}/${filename}`, async () => {+ owner.assertCurrent?.();+ const existing = await store.read(filename).catch((error: unknown) => {+ if (error instanceof MemoryError && error.code === 'not-found') return null;+ throw error;+ });+ await store.write({ type: type as BotMemoryType, name: name!, title, description, body,+ mode: existing ? 'update' : 'create', preserveBody: exact }).catch(translateStoreError);+ owner.assertCurrent?.();+ });+ scheduleRefresh(owner);+ },++ /** Remove a memory regardless of its version (cloud tombstone). Missing is fine. */+ async removeRaw(botId: string, rawFilename: unknown): Promise<void> {+ const filename = readFilename(rawFilename);+ const { store, owner } = await storeOf(botId);+ await serialized(`${botId}/${filename}`, async () => {+ await store.delete(filename).catch((error: unknown) => {+ if (error instanceof MemoryError && error.code === 'not-found') return;+ translateStoreError(error);+ });+ });+ scheduleRefresh(owner);+ },+async delete(input: BotMemoryDeleteInput): Promise<void> {const filename = readFilename(input.filename);const expected = readExpected(input.expectedUpdatedAt);diff --git a/apps/desktop/src/main/maker-ipc/botProfileFolder.ts b/apps/desktop/src/main/maker-ipc/botProfileFolder.tsindex 2c39dc5da0..7ed08d07e4 100644--- a/apps/desktop/src/main/maker-ipc/botProfileFolder.ts+++ b/apps/desktop/src/main/maker-ipc/botProfileFolder.ts@@ -190,10 +190,12 @@ function resolveInside(userDataDir: string, botId: string, relative: string): st}/** 读一个文本槽。缺失或读不动一律当空,不抛 —— 坏文件不该卡死伙伴。 */-async function readTextSlot(absPath: string): Promise<string> {+async function readTextSlot(absPath: string, strict = false): Promise<string> {try {return await fs.readFile(absPath, 'utf8');- } catch {+ } catch (error) {+ // Strict readers (cloud sync) must not mistake an unreadable file for an empty one.+ if (strict && (error as NodeJS.ErrnoException)?.code !== 'ENOENT') throw error;return '';}}@@ -303,13 +305,15 @@ function parseJsonOr<T>(raw: string, fallback: T, accept: (value: unknown) => boexport async function readBotProfileFolder(userDataDir: string,botId: string,+ options: { strict?: boolean } = {},): Promise<BotProfileFolderContent> {const at = (relative: string) => resolveInside(userDataDir, botId, relative);+ const strict = options.strict === true;const [identitySource, userContextSource, systemPromptOverride, configRaw] = await Promise.all([- readTextSlot(at(SLOT.soul)),- readTextSlot(at(SLOT.userContext)),- readTextSlot(at(SLOT.systemPrompt)),- readTextSlot(at(SLOT.config)),+ readTextSlot(at(SLOT.soul), strict),+ readTextSlot(at(SLOT.userContext), strict),+ readTextSlot(at(SLOT.systemPrompt), strict),+ readTextSlot(at(SLOT.config), strict),]);return {identitySource,diff --git a/apps/desktop/src/main/maker-ipc/botRemoteResourceInvalidation.ts b/apps/desktop/src/main/maker-ipc/botRemoteResourceInvalidation.tsindex 32a6fab934..9b9d96463f 100644--- a/apps/desktop/src/main/maker-ipc/botRemoteResourceInvalidation.ts+++ b/apps/desktop/src/main/maker-ipc/botRemoteResourceInvalidation.ts@@ -20,8 +20,19 @@ import {const log = createLogger('maker-ipc:bot-remote-resource');+const localListeners = new Set<(botId: string) => void>();++/** In-process observers of the same invalidation (e.g. cloud companion sync). */+export function onBotRemoteResourceChanged(listener: (botId: string) => void): () => void {+ localListeners.add(listener);+ return () => { localListeners.delete(listener); };+}+/** Notify every controller that a host-owned teammate projection must be re-read. */export function broadcastBotRemoteResourceChanged(botId: string): void {+ for (const listener of localListeners) {+ try { listener(botId); } catch { /* observers never block the broadcast */ }+ }const payload = {collectionId: TEAMMATES_REMOTE_COLLECTION_ID,resourceRefs: [{diff --git a/apps/desktop/src/main/maker-ipc/botSessionInputGuard.ts b/apps/desktop/src/main/maker-ipc/botSessionInputGuard.tsindex 9fe7bcd073..4267ac889b 100644--- a/apps/desktop/src/main/maker-ipc/botSessionInputGuard.ts+++ b/apps/desktop/src/main/maker-ipc/botSessionInputGuard.ts@@ -19,3 +19,17 @@ export function botSessionInputBlockReason(}return null;}++export const SHADOWED_COMPANION_INPUT_MESSAGE =+ 'This teammate now runs on its main computer; continue it there or take it over on this computer';++/**+ * A demoted copy's companion runs on another computer (cloud-companions.md §3): its main+ * task never starts a turn here, whichever send path (renderer, internal, queue drain) asks.+ */+export function isShadowedCompanionCanonical(+ link: { role?: string | null; botId?: string | null } | null | undefined,+ isShadowed: (botId: string) => boolean,+): boolean {+ return link?.role === 'canonical' && !!link.botId && isShadowed(link.botId);+}diff --git a/apps/desktop/src/main/maker-ipc/botSkillService.ts b/apps/desktop/src/main/maker-ipc/botSkillService.tsindex a8a657aa6c..3088e41808 100644--- a/apps/desktop/src/main/maker-ipc/botSkillService.ts+++ b/apps/desktop/src/main/maker-ipc/botSkillService.ts@@ -24,7 +24,10 @@ import {deleteBotSkill,listBotSkills,readBotSkill,+ readBotSkillSource,+ listBotSkillSources,saveBotSkill,+ saveBotSkillSource,type BotSkillSummary,} from './botSkillStore.js';import type {@@ -277,6 +280,30 @@ export async function readBotSkillForBot(: null;}+/** One own skill's SKILL.md exactly as stored (cloud companions upload it unchanged). */+export async function readBotSkillSourceForBot(botId: string, slug: string, deps: BotSkillServiceDeps = {}): Promise<string | null> {+ const boundary = captureOwnerBoundary(deps);+ const source = await readBotSkillSource(await skillHomeOf(deps, botId, boundary), botId, slug);+ assertOwnerBoundary(deps, boundary);+ return source;+}++/** Every own skill's SKILL.md for cloud sync; read errors propagate instead of reading as "no skill". */+export async function listBotSkillSourcesForBot(botId: string, deps: BotSkillServiceDeps = {}): Promise<Array<{ slug: string; source: string; enabled: boolean }>> {+ const boundary = captureOwnerBoundary(deps);+ const sources = await listBotSkillSources(await skillHomeOf(deps, botId, boundary), botId);+ assertOwnerBoundary(deps, boundary);+ return sources;+}++/** Restore one own skill's SKILL.md verbatim (cloud companions), keeping its native frontmatter. */+export async function saveBotSkillSourceForBot(botId: string, slug: string, source: string,+ options: { enabled?: boolean } = {}, deps: BotSkillServiceDeps = {}): Promise<void> {+ const boundary = captureOwnerBoundary(deps);+ await saveBotSkillSource(await skillHomeOf(deps, botId, boundary), botId, slug, source, options);+ assertOwnerBoundary(deps, boundary);+}+/** 设置页删除一条技能。 */export async function deleteBotSkillForBot(botId: string,diff --git a/apps/desktop/src/main/maker-ipc/botSkillStore.ts b/apps/desktop/src/main/maker-ipc/botSkillStore.tsindex d560e7177f..e00f71fbdf 100644--- a/apps/desktop/src/main/maker-ipc/botSkillStore.ts+++ b/apps/desktop/src/main/maker-ipc/botSkillStore.ts@@ -472,6 +472,79 @@ export async function saveBotSkill(try { return await pending; }finally { if (skillWrites.get(key) === pending) skillWrites.delete(key); }}+/** Like readSkillFilePath, but only a missing file counts as absent; other errors propagate. */+async function strictSkillFilePath(skillDir: string): Promise<string | null> {+ for (const candidate of ['SKILL.md', 'skill.md']) {+ const filePath = path.join(skillDir, candidate);+ try {+ if ((await fs.stat(filePath)).isFile()) return filePath;+ } catch (error) {+ const code = (error as NodeJS.ErrnoException)?.code;+ if (code !== 'ENOENT' && code !== 'ENOTDIR') throw error;+ }+ }+ return null;+}++/**+ * The skill's SKILL.md as stored, native frontmatter included (old three-field files migrated),+ * or null when it does not exist. Read errors propagate: cloud sync must not treat an unreadable+ * skill as a deleted one.+ */+export async function readBotSkillSource(userDataDir: string, botId: string, slug: string): Promise<string | null> {+ const filePath = await strictSkillFilePath(resolveSkillDir(userDataDir, botId, slug))+ ?? await strictSkillFilePath(resolveSkillDir(userDataDir, botId, slug, false));+ return filePath ? readCompatibleBotSkillSource(filePath, slug) : null;+}++/** Every own skill's SKILL.md for cloud sync; a missing folder is empty, any other read error throws. */+export async function listBotSkillSources(userDataDir: string, botId: string): Promise<Array<{ slug: string; source: string; enabled: boolean }>> {+ const out: Array<{ slug: string; source: string; enabled: boolean }> = [];+ for (const enabled of [true, false]) {+ const dir = enabled ? botSkillsDir(userDataDir, botId) : path.join(botSkillRootDir(userDataDir, botId), 'disabled-skills');+ const entries = await fs.readdir(dir, { withFileTypes: true }).catch((error: NodeJS.ErrnoException) => {+ if (error?.code === 'ENOENT') return [];+ throw error;+ });+ for (const entry of entries.filter(item => item.isDirectory() && !item.name.startsWith('.')).sort((a, b) => a.name.localeCompare(b.name))) {+ const filePath = await strictSkillFilePath(path.join(dir, entry.name));+ if (!filePath) continue;+ out.push({ slug: entry.name, source: await readCompatibleBotSkillSource(filePath, entry.name), enabled });+ }+ }+ return out;+}++/**+ * Write a whole SKILL.md verbatim (cloud companions restoring a copy), so native frontmatter+ * survives; same write queue, size limit and runtime refresh as saveBotSkill. `enabled` sets+ * where it lives (moving the whole skill folder); omitted, it keeps its current state.+ */+export async function saveBotSkillSource(userDataDir: string, botId: string, slug: string, source: string,+ options: { enabled?: boolean } = {}): Promise<void> {+ if (!normalizeBotSkillSlug(slug) || normalizeBotSkillSlug(slug) !== slug) throw new BotSkillStoreError('INVALID_ARGS', 'Invalid skill slug');+ if (Buffer.byteLength(parseBotSkillFile(source).body, 'utf8') > BOT_SKILL_MAX_BODY_BYTES)+ throw new BotSkillStoreError('SKILL_BODY_TOO_LARGE', 'Skill body too large');+ const key = botSkillRootDir(userDataDir, botId);+ const pending = (skillWrites.get(key) ?? Promise.resolve()).catch(() => {}).then(async () => {+ const previous = await readBotSkill(userDataDir, botId, slug);+ await ensureLayout(userDataDir, botId);+ const enabled = options.enabled ?? previous?.enabled !== false;+ const skillDir = resolveSkillDir(userDataDir, botId, slug, enabled);+ if (previous && (previous.enabled !== false) !== enabled) {+ // Move the folder (scripts and templates included) to the other state.+ await fs.mkdir(path.dirname(skillDir), { recursive: true });+ await fs.rename(resolveSkillDir(userDataDir, botId, slug, !enabled), skillDir);+ }+ await fs.mkdir(skillDir, { recursive: true });+ await fs.writeFile(path.join(skillDir, 'SKILL.md'), source, 'utf8');+ invalidateBotSkillRuntime(key);+ });+ skillWrites.set(key, pending);+ try { await pending; }+ finally { if (skillWrites.get(key) === pending) skillWrites.delete(key); }+}+async function writeBotSkill(userDataDir: string,botId: string,diff --git a/apps/desktop/src/main/maker-ipc/channels.ts b/apps/desktop/src/main/maker-ipc/channels.tsindex 92a38ef184..15004fa89e 100644--- a/apps/desktop/src/main/maker-ipc/channels.ts+++ b/apps/desktop/src/main/maker-ipc/channels.ts@@ -806,6 +806,16 @@ export const MAKER_INVOKE = {BOT_GROUP_PLAN_RETRY: 'maker:bot-group:plan-retry',BOT_GROUP_PLAN_EDIT: 'maker:bot-group:plan-edit',BOT_LIFECYCLE_ACTION: 'maker:bot-lifecycle:action',+ /** Where each companion runs (cloud-companions.md §3); read-only snapshot. */+ COMPANION_CLOUD_STATE: 'maker:companion-cloud:state',+ /** Make this computer the companion's home (cloud-companions.md §3.1). */+ COMPANION_CLOUD_TAKE_OVER: 'maker:companion-cloud:take-over',+ /** Hand the companion to another of the owner's computers. */+ COMPANION_CLOUD_TRANSFER: 'maker:companion-cloud:transfer',+ /** Read the companion's 1:1 room (works while its home is offline). */+ COMPANION_CLOUD_TRANSCRIPT: 'maker:companion-cloud:transcript',+ /** Computers a companion can be handed to. */+ COMPANION_CLOUD_DEVICES: 'maker:companion-cloud:devices',} as const;/**@@ -959,6 +969,8 @@ export const MAKER_PUSH = {BOT_DIRECT_MESSAGE_CHANGED: 'maker:bot-direct-message:changed',/** A Bot group, its members, messages or running round changed. */BOT_GROUP_CHANGED: 'maker:bot-group:changed',+ /** Companion homes changed; payload is the full CompanionCloudSnapshot. */+ COMPANION_CLOUD_CHANGED: 'maker:companion-cloud:changed',/** Bot 档案经主进程创建或更新后变化;renderer 收到后重拉伙伴列表。 */BOT_PROFILE_CHANGED: 'maker:bot-profile:changed',/** 伙伴工作台已接手的项目变化(payload: { botId });renderer 收到后重读项目列表。 */diff --git a/apps/desktop/src/main/maker-ipc/chatServer.ts b/apps/desktop/src/main/maker-ipc/chatServer.tsindex adf08ac0c2..8c3d7e28e5 100644--- a/apps/desktop/src/main/maker-ipc/chatServer.ts+++ b/apps/desktop/src/main/maker-ipc/chatServer.ts@@ -37,8 +37,11 @@ import type { BotGroupChatService, BotGroupChatServiceDeps, BotGroupLaneTerminalimport { readPersistedReplyText } from './botGroupChatService.js';import { botGroupRuntimeFailureCode, botGroupRuntimeFailureDetail } from './botGroupRuntimeFailure.js';import { botGroupExecutionFailureBatches } from '@cindy/maker-shared/botGroupPresentation';+import { companionSnapshot, registerCompanionHomes } from '../companion-cloud/homes.js';+import { startCompanionCloud, type CompanionCloudRuntime } from '../companion-cloud/runtime.js';+import { DIRECT_ROOM_COMPLETION, deliverDirectRoomMessage, directRoomClientId } from '../companion-cloud/directRoom.js';-interface Actor { id: string; kind: string; externalId: string; name: string; avatar?: string | null; avatarSource?: string | null }+interface Actor { id: string; kind: string; externalId: string; name: string; avatar?: string | null; avatarSource?: string | null; homeDeviceId?: string | null; disabled?: boolean }interface Member { id: string; kind: 'human' | 'bot' | 'integration'; name: string; state: string; role: 'owner' | 'admin' | 'member' | 'guest';displayName: string; avatar: string | null; nickname: string | null; ownerActorId: string; ownerName: string;guestAccess: 'none' | 'chat' | 'tools'; accessRevision: number }@@ -49,7 +52,7 @@ interface Message {}interface Room {id: string; name: string; topic: string; description: string; response_mode: 'all' | 'mentioned'; speaking_mode: 'auto' | 'sequential';- created_at: string; updated_at: string; revision: number; archived: boolean; organizer_id?: string | null;+ created_at: string; updated_at: string; revision: number; archived: boolean; organizer_id?: string | null; kind?: string;}interface Snapshot { room: Room; members: Member[]; messages: Message[]; cursor: string }interface Execution {@@ -78,7 +81,7 @@ interface Running {releaseToolAuthority?: () => void;}class ChatResponseError extends Error {- constructor(code: string, readonly status: number, readonly retryAt?: number) { super(code); }+ constructor(code: string, readonly status: number, readonly retryAt?: number, readonly details?: unknown) { super(code); }}const CHAT_AUTH_RETRY_MS = 60_000;/** Main-group messages kept as background for a Thread request (the Thread itself is read separately). */@@ -163,11 +166,21 @@ export function withChatServer(local: BotGroupChatService, deps: BotGroupChatSerfunction createChatServer(local: BotGroupChatService, deps: BotGroupChatServiceDeps, config: { baseUrl: string }): BotGroupChatService {const scope = deps.captureOwnerScope?.();let disposed = false;+ // Demotion persisted for this owner applies before the server has answered.+ if (deps.companionCloud?.shadows) deps.companionCloud.homes.setPersistedShadows(deps.companionCloud.shadows.read());+ // What is on disk: a failed write is retried on the next publish, not taken as saved.+ let savedShadows = JSON.stringify(deps.companionCloud?.homes.persistedShadows() ?? []);let connected = false;const current = () => !disposed && (!scope || !deps.isOwnerScopeCurrent || deps.isOwnerScopeCurrent(scope));const executorId = `desktop:${randomUUID()}`;let actors: Actor[] = [];let selfId = '';+ // Cloud companions (cloud-companions.md): inert unless the server announces homes.+ let selfDeviceId: string | null = null;+ let companionHome = false;+ let companion: CompanionCloudRuntime | undefined;+ let companionSelf: string | null = null;+ let actorsStale = false;let profiles: Array<typeof botProfiles.$inferSelect> = [];const workspaces = () => chatServerWorkspaces(config.baseUrl, selfId, current);const planning = new Map<string, { botId: string; controller: AbortController }>();@@ -205,6 +218,8 @@ function createChatServer(local: BotGroupChatService, deps: BotGroupChatServiceD// explicit validation rejection, and keep the decision within this account/endpoint.let memberJoinedClaims = true;let registeredAt = 0;+ // Per-companion name / avatar publish failures of the last pass: one broken avatar never blocks the rest.+ let profileFailures = new Map<string, unknown>();let profileRefreshedAt = 0;const running = new Map<string, Running>();const metadata = new Map<string, Promise<void>>();@@ -285,7 +300,7 @@ function createChatServer(local: BotGroupChatService, deps: BotGroupChatServiceDif (res.statusCode === 401 && !retried && CHAT_REFRESHABLE_ERROR_CODES.has(code)) {if (await refreshRejectedToken(token) && current()) { resolve(api<T>(route, method, data, actorId, true, successStatus)); return; }}- if (status >= 400) throw new ChatResponseError(code, status, retryAt);+ if (status >= 400) throw new ChatResponseError(code, status, retryAt, value?.error?.details);if (successStatus && status !== successStatus) throw new Error('CHAT_RESPONSE_INVALID');resolve(value);} catch (error) { reject(error); }@@ -401,43 +416,114 @@ function createChatServer(local: BotGroupChatService, deps: BotGroupChatServiceD}return upgradedGroups.get(groupId) ?? groupId;};+ /** Publish one companion's name and avatar to its actor (home copy only). */+ async function publishActorProfile(profile: typeof profiles[number], found: Actor) {+ // Only the confirmed home installation publishes (same predicate as claiming work).+ if (companionHome && (found.homeDeviceId !== selfDeviceId || !!companion?.isShadowed(profile.id)+ || !companion?.installConfirmed(profile.id))) return;+ const source = profile.avatar?.startsWith('cindy-media://') ? createHash('sha256').update(profile.avatar).digest('hex') : null;+ let avatar = source && found.avatarSource === source ? found.avatar ?? null : profile.avatar || null;+ if (source && found.avatarSource !== source) {+ const media = await readMedia(profile.avatar!);+ if (media.buffer.length > 5 * 1024 * 1024 || !['image/png', 'image/jpeg', 'image/webp'].includes(media.mimeType)) throw new Error('INVALID_AVATAR');+ if (!current()) throw new Error('OWNER_CHANGED');+ const uploaded = await uploadPublicAsset({ fetchImpl: net.fetch, getBaseUrl: () => getClientEndpoint('ossApiBaseUrl'), getToken: getAccessToken },+ { scene: 'avatar', contentType: media.mimeType, body: media.buffer });+ if (!uploaded.ok) throw new Error('AVATAR_UPLOAD_FAILED');+ avatar = uploaded.publicUrl;+ }+ if (found.name === profile.displayName && (found.avatar ?? null) === avatar && (found.avatarSource ?? null) === source) return;+ await api(`/actors/${found.id}/profile`, 'POST', { name: profile.displayName, avatar, avatarSource: source });+ Object.assign(found, { name: profile.displayName, avatar, avatarSource: source });+ }async function register() {if (refreshActors) return refreshActors;- if (Date.now() - registeredAt < 5000) return;+ if (Date.now() - registeredAt < 5000 && !actorsStale) return;refreshActors = (async () => {+ actorsStale = false;profiles = await getDbClient().drizzle.select().from(botProfiles).where(undefined);- const me = await api<{ actor: Actor; capabilities?: { groupDiscussionParity?: number } }>('/me'); selfId = me.actor.id;+ const me = await api<{ actor: Actor; deviceId?: string | null; capabilities?: { groupDiscussionParity?: number; companionHome?: boolean } }>('/me'); selfId = me.actor.id;groupDiscussionParity = me.capabilities?.groupDiscussionParity === 1;+ selfDeviceId = typeof me.deviceId === 'string' && me.deviceId ? me.deviceId : null;+ companionHome = !!deps.companionCloud && me.capabilities?.companionHome === true && !!selfDeviceId;// Refresh from the issuing auth server, never overwrite with a stale device cache.if (Date.now() - profileRefreshedAt > 60000) {await api('/profile/refresh', 'POST').then(() => { profileRefreshedAt = Date.now(); }).catch(() => undefined);}actors = await api<Actor[]>('/actors');for (const profile of profiles.filter(p => p.status === 'active')) {- let found = actors.find(a => a.kind === 'bot' && a.externalId === profile.id);- if (!found) {- found = await api<Actor>('/actors', 'POST', { operationId: randomUUID(), kind: 'bot', externalId: profile.id, name: profile.displayName });- actors.push(found);- }- const source = profile.avatar?.startsWith('cindy-media://') ? createHash('sha256').update(profile.avatar).digest('hex') : null;- let avatar = source && found.avatarSource === source ? found.avatar ?? null : profile.avatar || null;- if (source && found.avatarSource !== source) {- const media = await readMedia(profile.avatar!);- if (media.buffer.length > 5 * 1024 * 1024 || !['image/png', 'image/jpeg', 'image/webp'].includes(media.mimeType)) throw new Error('INVALID_AVATAR');- if (!current()) throw new Error('OWNER_CHANGED');- const uploaded = await uploadPublicAsset({ fetchImpl: net.fetch, getBaseUrl: () => getClientEndpoint('ossApiBaseUrl'), getToken: getAccessToken },- { scene: 'avatar', contentType: media.mimeType, body: media.buffer });- if (!uploaded.ok) throw new Error('AVATAR_UPLOAD_FAILED');- avatar = uploaded.publicUrl;+ if (actors.some(a => a.kind === 'bot' && a.externalId === profile.id)) continue;+ actors.push(await api<Actor>('/actors', 'POST', { operationId: randomUUID(), kind: 'bot', externalId: profile.id, name: profile.displayName }));+ }+ // Homes first: only the home's own copy may publish the companion's name and avatar.+ await syncCompanionHomes();+ const failures = new Map<string, unknown>();+ for (const profile of profiles.filter(p => p.status === 'active')) {+ const found = actors.find(a => a.kind === 'bot' && a.externalId === profile.id);+ if (!found) continue;+ try { await publishActorProfile(profile, found); } catch (error) {+ if (!current()) throw error;+ failures.set(profile.id, error);+ deps.log?.warn('Companion name / avatar not published', { actorId: found.id, ...chatErrorDiagnostic(error) });}- if (found.name === profile.displayName && (found.avatar ?? null) === avatar && (found.avatarSource ?? null) === source) continue;- await api(`/actors/${found.id}/profile`, 'POST', { name: profile.displayName, avatar, avatarSource: source });- Object.assign(found, { name: profile.displayName, avatar, avatarSource: source });}+ profileFailures = failures;registeredAt = Date.now();})().finally(() => { refreshActors = undefined; });return refreshActors;}+ /** Claim empty homes for this computer and publish where every companion runs. */+ async function syncCompanionHomes() {+ const host = deps.companionCloud;+ if (!host || !current()) return;+ if (!companionHome || !selfDeviceId) {+ companion?.dispose(); companion = undefined;+ host.homes.update(companionSnapshot({ enabled: false, selfDeviceId, humanActorId: selfId || null, actors: [] }));+ return;+ }+ const self = selfDeviceId;+ if (companion && companionSelf !== self) { companion.dispose(); companion = undefined; }+ companionSelf = self;+ companion ??= startCompanionCloud({ api, host, endpoint: config.baseUrl, humanActorId: selfId, selfDeviceId: self, current, log: deps.log,+ bots: () => actors.filter(a => a.kind === 'bot' && !a.disabled && a.homeDeviceId === self && localBot(a.id)?.status === 'active'+ && !companion?.isShadowed(a.externalId)).map(a => ({ botId: a.externalId, actorId: a.id, name: a.name })),+ actors: () => actors, refresh: refreshHomes, publish: publishHomes, syncProfile: syncActorProfiles });+ const runtime = companion;+ await registerCompanionHomes({ api, selfDeviceId: self, actors, log: deps.log,+ botIds: profiles.filter(p => p.status === 'active').map(p => p.id), isDemoted: botId => runtime.state.isDemoted(botId) });+ if (!current()) return;+ runtime.reconcile(profiles.map(p => ({ id: p.id, status: p.status })));+ publishHomes();+ }+ function publishHomes() {+ const host = deps.companionCloud;+ if (!host || !current() || !companionHome || !companion) return;+ const shadows = companion.shadowIds();+ // Persist demotion so it holds before the next /me, offline, and with the feature off.+ const key = JSON.stringify(shadows);+ if (key !== savedShadows) {+ try { host.shadows?.write(shadows); savedShadows = key; } catch (error) { deps.log?.warn('Companion shadow list not saved', chatErrorDiagnostic(error)); }+ }+ if (key !== JSON.stringify(host.homes.persistedShadows())) host.homes.setPersistedShadows(shadows);+ host.homes.update(companionSnapshot({ enabled: true, selfDeviceId, humanActorId: selfId, actors, demotedBotIds: shadows }));+ }+ /** Publish name and avatar now (before handing `botId` over); unlike refreshHomes, its failure surfaces. */+ async function syncActorProfiles(botId: string) {+ actorsStale = true;+ // A pass already in flight may have read the profiles before the latest edit.+ await refreshActors?.catch(() => undefined);+ await register();+ const failure = profileFailures.get(botId);+ if (failure) throw failure;+ }+ /** Another device moved a companion: re-read actors now instead of after the throttle. */+ async function refreshHomes() {+ actorsStale = true;+ // A refresh already in flight may have read the previous actor list.+ await refreshActors?.catch(() => undefined);+ if (!actorsStale || !current()) return;+ await register().catch(error => deps.log?.warn('Companion home refresh failed', chatErrorDiagnostic(error)));+ }/*** Follow a room from a cursor whose state has already been read. A snapshot cursor skips* replaying the room's whole change log, one full re-read per hundred old changes.@@ -476,6 +562,7 @@ function createChatServer(local: BotGroupChatService, deps: BotGroupChatServiceD}else {for (const change of event.changes ?? []) if (change.type === 'membership.changed') changed(change.entityId);+ if (companionHome && (event.changes ?? []).some((change: { type?: unknown }) => change?.type === 'actor.changed')) void refreshHomes();changed('');}ws.send(JSON.stringify({ type: 'ack', scope: event.scope, cursor: event.cursor }));@@ -864,6 +951,13 @@ function createChatServer(local: BotGroupChatService, deps: BotGroupChatServiceDthrow new Error('INVALID_EXECUTION_TRIGGER');}if (!current() || running.get(execution.bot_id) !== run) throw new Error('STALE_EXECUTOR');+ // A companion's own 1:1 room is not a group: hand the message to its main task instead.+ const joined = new Set(s.members.filter(m => m.state === 'joined').map(m => m.id));+ const ownDirectRoom = companionHome && (companion?.isDirectRoom(s.room.id)+ || (s.room.kind === 'direct' && joined.size === 2 && joined.has(selfId) && joined.has(execution.bot_id)));+ if (ownDirectRoom) { await runDirectExecution(run, bot.id, s.room.id); return; }+ // Any other 1:1 room is never answered as a group.+ if (s.room.kind === 'direct') throw new Error('INVALID_EXECUTION_TRIGGER');// Metadata only: the server remains the sole message store and scheduler.if (!metadata.has(s.room.id)) metadata.set(s.room.id, (async () => {const client = getDbClient();@@ -1053,6 +1147,31 @@ function createChatServer(local: BotGroupChatService, deps: BotGroupChatServiceDoutcome: 'error', resultText: '', failureCode: botGroupRuntimeFailureCode(error) }, true);}}+ /**+ * The owner wrote in the companion's room (e.g. from a phone while it was queued):+ * deliver it to the canonical Session like a message from another device. The reply+ * reaches the room through the conversation mirror, so the execution completes empty.+ */+ async function runDirectExecution(run: Running, botId: string, roomId: string) {+ const { execution } = run;+ if (!deps.companionCloud) throw new Error('MEMBER_UNAVAILABLE');+ if (run.context?.kind !== 'message' || execution.plan_id) throw new Error('INVALID_EXECUTION_TRIGGER');+ run.clientId = directRoomClientId(execution.id, execution.source_message_id);+ await deliverDirectRoomMessage({ api, roomId, executionId: execution.id, sourceMessageId: id.parse(execution.source_message_id),+ humanActorId: selfId, botId, deliver: deps.companionCloud.deliverToCanonical,+ beforeDeliver: async () => {+ await updateExecution(run, 'heartbeat');+ if (!current() || running.get(execution.bot_id) !== run) throw new Error('STALE_EXECUTOR');+ // Handed to another computer since the claim (the hand-over demotes this copy): never run it here.+ if (companion?.isShadowed(botId) || !companion?.installConfirmed(botId)) throw new Error('MEMBER_UNAVAILABLE');+ } });+ run.accepted = true;+ run.settlement = { terminal: { sessionId: '', activeInputClientId: run.clientId, outcome: 'done', resultText: '' },+ payload: { ...DIRECT_ROOM_COMPLETION }, retryAt: 0 };+ await deliverSettlement(run);+ companion?.kickMirror(botId);+ changed(roomId);+ }let polling = false;let pollRetryAt = 0;let pollFailures = 0;@@ -1066,6 +1185,12 @@ function createChatServer(local: BotGroupChatService, deps: BotGroupChatServiceDif (!socket) connect();for (const actor of actors.filter(a => a.kind === 'bot' && localBot(a.id)?.status === 'active')) {if (running.has(actor.id)) continue;+ // Only the registered home runs a companion: skip while the home is elsewhere or not yet+ // registered (an unset home would let any copy of the owner claim it).+ if (companionHome && actor.homeDeviceId !== selfDeviceId) continue;+ // Shadowed here (demoted, or run by another installation on this device), or this+ // installation is not yet confirmed to run it (the server only tells devices apart): never claim.+ if (companionHome && (companion?.isShadowed(actor.externalId) || !companion?.installConfirmed(actor.externalId))) continue;let claim: { execution: Execution | null };const payload = { operationId: randomUUID(), executorId, accessPolicyVersion: 1, planVersion: 1 };try {@@ -1328,7 +1453,7 @@ function createChatServer(local: BotGroupChatService, deps: BotGroupChatServiceDlet after: string | undefined;do {const page = await api<Array<Room & { state: string }>>(`/conversations?limit=100${after ? `&after=${after}` : ''}`);- const joined = page.filter(r => r.state === 'joined');+ const joined = page.filter(r => r.state === 'joined' && r.kind !== 'direct');for (let i = 0; i < joined.length; i += 8)groups.push(...await Promise.all(joined.slice(i, i + 8).map(r => detail(r.id, undefined, true))));after = page.length === 100 ? page.at(-1)!.id : undefined;@@ -1431,6 +1556,7 @@ function createChatServer(local: BotGroupChatService, deps: BotGroupChatServiceDeditPlanStep: input => safe(() => actPlan(input, 'reassign')),dispose: () => {disposed = true; clearInterval(timer); clearInterval(heartbeat); clearTimeout(reconnect); socket?.close();+ companion?.dispose(); companion = undefined; deps.companionCloud?.homes.reset();for (const refresh of attachmentRefreshes.values()) clearTimeout(refresh);attachmentRefreshes.clear();for (const run of running.values()) {diff --git a/apps/desktop/src/main/maker-ipc/register.ts b/apps/desktop/src/main/maker-ipc/register.tsindex 96554b7708..c7aede1230 100644--- a/apps/desktop/src/main/maker-ipc/register.ts+++ b/apps/desktop/src/main/maker-ipc/register.ts@@ -563,6 +563,11 @@ import {import { createBotGroupChatService, type BotGroupChatService, type BotGroupChatServiceDeps } from './botGroupChatService.js';import { settleUndispatchedBotGroupTurn } from './botGroupRuntimeFailure.js';import { withChatServer } from './chatServer.js';+import { companionHomes, isCompanionShadowed } from '../companion-cloud/homes.js';+import { createCompanionCloudHost } from '../companion-cloud/host.js';+import { activeCompanionCloud } from '../companion-cloud/runtime.js';+import { companionCloudView } from '../companion-cloud/view.js';+import type { CompanionCloudActionResult } from '../../shared/companionCloud.js';import { createBotGroupPlanDecider } from './botGroupPlanDecider.js';import { botGroupMembersVisibleRemotely, registerBotGroupRemoteResourceProvider } from './botGroupRemoteResourceProvider.js';import { broadcastBotGroupRemoteResourceChanged } from './botGroupRemoteResourceInvalidation.js';@@ -592,7 +597,7 @@ import {} from './botCompactRuntimeRefresh.js';import { isBotCanonicalReplacementBusy } from './botCanonicalReplacementGuard.js';import { configureBotCanonicalReplacementCoordinator } from './botCanonicalReplacementCoordinator.js';-import { botSessionInputBlockReason } from './botSessionInputGuard.js';+import { botSessionInputBlockReason, isShadowedCompanionCanonical, SHADOWED_COMPANION_INPUT_MESSAGE } from './botSessionInputGuard.js';import { configureBotRuntimeEpochRefreshRequest } from './botRuntimeEpochRefreshSignal.js';import { createGitSnapshotCoordinator } from '../maker-host/git-snapshot-host.js';import {@@ -952,9 +957,9 @@ import {createOrcaRemoteWorkerSessionOpener,registerOrcaRemoteWorkerHandlers,} from './orcaRemoteWorkerHost.js';-import { createOrcaRemoteWorkers, isExecutionDeviceCandidate, type OrcaRemoteWorkers } from './orcaRemoteWorkers.js';+import { createOrcaRemoteWorkers, invokeDeviceValue, isExecutionDeviceCandidate, type OrcaRemoteWorkers } from './orcaRemoteWorkers.js';import { getReceivedShares, providerShareAgentDeviceId } from '../device-link/providerShareGuest.js';-import { ORCA_EXECUTION_DEVICES_CHANNEL } from '@cindy/device-link';+import { ORCA_EXECUTION_DEVICES_CHANNEL, COMPANION_CLOUD_CAPS_CHANNEL, COMPANION_CLOUD_VERSION, isCompanionCloudCaps } from '@cindy/device-link';import { INPUT_HANDOFF_LOCAL_CHANNEL, INPUT_HANDOFF_LOCAL_PICTURE_CHANNEL, type InputHandoffHolder, type InputHandoffSnapshot } from '@cindy/device-link';import { getInputHandoffService, initInputHandoffService } from '../input-handoff/service.js';import { closeInputHandoffAskpass, initInputHandoffAskpass } from '../input-handoff/askpass/index.js';@@ -2630,6 +2635,13 @@ let orcaCollabServiceHolder: OrcaCollabService | null = null;let botDelegationServiceHolder: BotDelegationService | null = null;let botDirectMessageServiceHolder: BotDirectMessageService | null = null;let botGroupChatServiceHolder: BotGroupChatService | null = null;+/**+ * Settle a pending account / endpoint switch before using the companion runtime: the lazy Chat+ * Server wrapper rebinds only when touched. (The home registry itself is owner-scoped.)+ */+function settleCompanionOwner(): void { void botGroupChatServiceHolder?.chatServer; }+let unsubscribeCompanionCloudBroadcast: (() => void) | null = null;+const listCompanionDevices = async () => (await handleListDevices(deviceDirectoryDeps())).devices;const botRuntimeRestoreCoordinator = createBotRuntimeRestoreCoordinator({readDbIdentity: () => {@@ -8978,6 +8990,8 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions).where(eq(sessions.id, sessionId));broadcastSessionPatched(sessionId, { orcaRemoteLead: lead });};+ // Cloud companions: another computer asks before handing a companion here (read-only constant).+ makerSessionRegistry.handle(COMPANION_CLOUD_CAPS_CHANNEL, () => ({ companionCloud: COMPANION_CLOUD_VERSION }));registerOrcaRemoteWorkerHandlers(makerSessionRegistry, createOrcaRemoteWorkerHost({getCaller: () => {const context = getDeviceLinkInvokeContext();@@ -11022,6 +11036,13 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)message: `session ${targetSessionId} is deleted`,};}+ // Internal sends (plugins, tasks, routines) reach idle sessions without sendToAgentAccepted.+ const [companionLink] = await getDbClient().drizzle+ .select({ role: botSessionLinks.role, botId: botSessionLinks.botId })+ .from(botSessionLinks).where(eq(botSessionLinks.sessionId, targetSessionId)).limit(1);+ if (isShadowedCompanionCanonical(companionLink, isCompanionShadowed)) {+ return { ok: false as const, errorCode: 'AGENT_NOT_READY' as const, message: SHADOWED_COMPANION_INPUT_MESSAGE };+ }// 崩溃恢复:在路由决策前加载快照,确保恢复的排队 prompt 不被跳过。// 失败时 shouldQueueNewTurn 仍返回 true(未恢复即入队),消息不丢。@@ -11416,6 +11437,8 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)files?: AgentInputQueuedMessage['files'];onAccepted?: (replayed?: boolean) => void | Promise<void>;onAcceptedRollback?: () => void | Promise<void>;+ /** Remote-origin input: a cold session resumes with its stored permission mode, never bypass. */+ resumeWithStoredPermissionMode?: boolean;}) => {if (params.clientId && params.authorizationGuard) {const delivery = await resolveBotAuthorizationDelivery(params.clientId, async (clientId) => {@@ -11651,6 +11674,34 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)git: async (args, cwd) => (await gitExec(args, cwd, { timeoutMs: 10_000 })).stdout,trashItem: (fullPath) => shell.trashItem(fullPath),});+ // The companion "restart": durable handoff from DB history, no replay of any input.+ async function restartBotCanonicalRuntime(sessionId: string, assertOwnerCurrent: () => void): Promise<void> {+ const recovery = contextOverflowRolloverHolder;+ if (!recovery) throwIpcError('PRECONDITION_FAILED', 'Bot recovery is not ready');+ await restartBotRuntime(sessionId, assertOwnerCurrent, {+ stopInput: (id) => {+ // Save the visible partial reply before abort/close clears the stream buffers.+ flushAssistantBlock(id);+ flushOrphanToolResults(id, null);+ resetAutomaticRecoveryForExplicitStop(id);+ recovery.cancelRecovery(id);+ // Cancel sends/retries before waiting for their serialization lock.+ // Preserve queued user input, paused until the user explicitly resumes it.+ agentInputCoordinatorHolder?.stop(id, { keepQueue: true, pauseQueue: true, resumeOnUserInput: true });+ },+ withSessionLock: withSessionRestartLock,+ rebuild: async (id, assertCurrent, signal) => {+ await pauseGoalBeforeExplicitStop(id);+ assertCurrent();+ cleanupPendingInteractionsForSession(id, 'session_closed');+ await recovery.prepareNativeSessionRecovery(id, null, assertCurrent, signal);+ },+ onClosed: (id) => agentInputCoordinatorHolder?.onSessionClosed(id),+ });+ }+ // A turn is running or queued in a companion's main task: no context rebuild, no hand-over.+ const companionTurnActive = (sessionId: string) => !!maker.getSession(sessionId)?.isTurnRunning?.()+ || inputCoordinator.getQueueControlSnapshot(sessionId).pendingQueue.length > 0;const botGroupChatDeps: BotGroupChatServiceDeps = {ensureLane: async (input) => {try {@@ -11734,6 +11785,50 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)// Phones read groups as remote resources; any change re-reads the row and the chat.broadcastBotGroupRemoteResourceChanged(payload.groupId);},+ companionCloud: createCompanionCloudHost({+ log,+ ensureCanonicalSession: async (botId) => {+ if (!botDelegationServiceHolder) throw new Error('DELEGATION_UNAVAILABLE');+ const ensured = await botDelegationServiceHolder.ensureCanonicalSession(botId);+ if (!ensured.ok) throw new Error(ensured.errorCode);+ return ensured.sessionId;+ },+ // Cloud history was added: rebuild like a restart, but never interrupt a turn.+ rebuildContext: async (sessionId) => {+ if (companionTurnActive(sessionId)) return 'busy';+ const scope = captureDataOwnerBroadcastScope();+ await restartBotCanonicalRuntime(sessionId, () => {+ if (!isDataOwnerBroadcastScopeCurrent(scope)) throw new Error('OWNER_CHANGED');+ });+ return 'rebuilt';+ },+ isTurnActive: companionTurnActive,+ listDevices: listCompanionDevices,+ // Old clients answer CHANNEL_NOT_ALLOWED; unreachable ones time out. Neither may receive a companion.+ probeCompanionCloud: async (deviceId) => {+ let timer: ReturnType<typeof setTimeout> | undefined;+ try {+ const value = await Promise.race([+ invokeDeviceValue(invokeBotPeer, deviceId, COMPANION_CLOUD_CAPS_CHANNEL, []),+ new Promise<never>((_, reject) => { timer = setTimeout(() => reject(new Error('[INVOKE_TIMEOUT] caps probe timed out')), 5_000); }),+ ]);+ return isCompanionCloudCaps(value);+ } catch { return false; } finally { clearTimeout(timer); }+ },+ // A message the owner wrote in the companion's room reaches its main task like any user input.+ deliverToCanonical: async (botId, text, clientId) => {+ // A room message drives the companion's main task like a same-account device: only where this+ // computer allows same-account device control (the room carries no authenticated device).+ if (!readDeviceLinkSettings().remoteControlEnabled) return { ok: false as const, errorCode: 'REMOTE_CONTROL_DISABLED' };+ if (!botDelegationServiceHolder) return { ok: false as const, errorCode: 'DELEGATION_UNAVAILABLE' };+ const ensured = await botDelegationServiceHolder.ensureCanonicalSession(botId);+ if (!ensured.ok) return { ok: false as const, errorCode: ensured.errorCode };+ // Content from the cloud room must not wake the task with more permission than the user chose.+ const result = await dispatchBotSessionMessage({ targetSessionId: ensured.sessionId, message: text, clientId,+ resumeWithStoredPermissionMode: true });+ return result.ok ? { ok: true as const } : { ok: false as const, errorCode: result.errorCode };+ },+ }),onStepSettled: (event, scope) => {const ownerScope = scope as ReturnType<typeof captureDataOwnerBroadcastScope> | undefined;if (ownerScope && !isDataOwnerBroadcastScopeCurrent(ownerScope)) return;@@ -11755,6 +11850,15 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)log,};botGroupChatServiceHolder = withChatServer(createBotGroupChatService(botGroupChatDeps), botGroupChatDeps);+ unsubscribeCompanionCloudBroadcast?.();+ unsubscribeCompanionCloudBroadcast = companionHomes.onChange((snapshot) => {+ const scope = captureDataOwnerBroadcastScope();+ void companionCloudView(snapshot, listCompanionDevices).then((view) => {+ // Device lookups can finish out of order: a superseded snapshot is never pushed after a newer one.+ if (companionHomes.snapshot() !== snapshot) return;+ broadcastToAllWindows(MAKER_PUSH.COMPANION_CLOUD_CHANGED, view, scope);+ });+ });// Phones reach groups through the Remote Resource protocol (bot-group-chat.md §8).registerBotGroupRemoteResourceProvider(() => botGroupChatServiceHolder);botDelegationServiceHolder?.dispose();@@ -11897,30 +12001,7 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)});registerBotLifecycleHandlers({maker,- restartRuntime: async (sessionId, assertOwnerCurrent) => {- const recovery = contextOverflowRolloverHolder;- if (!recovery) throwIpcError('PRECONDITION_FAILED', 'Bot recovery is not ready');- await restartBotRuntime(sessionId, assertOwnerCurrent, {- stopInput: (id) => {- // Save the visible partial reply before abort/close clears the stream buffers.- flushAssistantBlock(id);- flushOrphanToolResults(id, null);- resetAutomaticRecoveryForExplicitStop(id);- recovery.cancelRecovery(id);- // Cancel sends/retries before waiting for their serialization lock.- // Preserve queued user input, paused until the user explicitly resumes it.- agentInputCoordinatorHolder?.stop(id, { keepQueue: true, pauseQueue: true, resumeOnUserInput: true });- },- withSessionLock: withSessionRestartLock,- rebuild: async (id, assertCurrent, signal) => {- await pauseGoalBeforeExplicitStop(id);- assertCurrent();- cleanupPendingInteractionsForSession(id, 'session_closed');- await recovery.prepareNativeSessionRecovery(id, null, assertCurrent, signal);- },- onClosed: (id) => agentInputCoordinatorHolder?.onSessionClosed(id),- });- },+ restartRuntime: restartBotCanonicalRuntime,getDelegationService: () => botDelegationServiceHolder,onPaused: (botId) => updateBotRoutineLifecycle(botId, 'pause'),onResumed: async (botId) => {@@ -11933,6 +12014,13 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)onBeforeDelete: prepareCompanionImportDeletion,onDeleted: async (botId, assertOwner) => {assertOwner();+ // Deleted on its home: other devices stop showing it. Started first and independently, so a+ // local cleanup failure below never skips it; it records retirePending and retries itself.+ // A demoted copy never retires the cloud companion.+ settleCompanionOwner();+ void activeCompanionCloud()?.retire(botId).catch((error: unknown) => {+ log.warn('companion cloud retire failed', { error: error instanceof Error ? error.message.slice(0, 80) : 'UNKNOWN' });+ });// Profile deletion has committed. Startup also purges orphaned routines// if this cleanup fails or the process stops before it finishes.await updateBotRoutineLifecycle(botId, 'delete');@@ -12068,6 +12156,47 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)assertTrustedAppRendererEvent(event);return botGroupChatServiceHolder ? botGroupChatServiceHolder.startPlan(input) : botGroupNotReady;});+ const currentCompanionHomes = () => { settleCompanionOwner(); return companionHomes; };+ ipcMain.handle(MAKER_INVOKE.COMPANION_CLOUD_STATE, async (event) => {+ assertTrustedAppRendererEvent(event);+ return companionCloudView(currentCompanionHomes().snapshot(), listCompanionDevices);+ });+ const companionBotId = (value: unknown) => {+ if (typeof value !== 'string' || !value.trim() || value.length > 200) throwIpcError('INVALID_PARAMS', 'botId required');+ return value;+ };+ const companionNotEnabled: CompanionCloudActionResult = { ok: false, code: 'NOT_ENABLED' };+ ipcMain.handle(MAKER_INVOKE.COMPANION_CLOUD_TAKE_OVER, async (event, botId: unknown) => {+ assertTrustedAppRendererEvent(event);+ const id = companionBotId(botId);+ currentCompanionHomes();+ return activeCompanionCloud()?.takeOver(id) ?? companionNotEnabled;+ });+ ipcMain.handle(MAKER_INVOKE.COMPANION_CLOUD_TRANSFER, async (event, botId: unknown, targetDeviceId: unknown) => {+ assertTrustedAppRendererEvent(event);+ const id = companionBotId(botId);+ if (typeof targetDeviceId !== 'string' || !targetDeviceId || targetDeviceId.length > 200) throwIpcError('INVALID_PARAMS', 'targetDeviceId required');+ currentCompanionHomes();+ return activeCompanionCloud()?.transfer(id, targetDeviceId) ?? companionNotEnabled;+ });+ ipcMain.handle(MAKER_INVOKE.COMPANION_CLOUD_TRANSCRIPT, async (event, botId: unknown, before: unknown) => {+ assertTrustedAppRendererEvent(event);+ const id = companionBotId(botId);+ if (before !== undefined && before !== null && (typeof before !== 'string' || !/^[1-9][0-9]{0,18}$/.test(before)))+ throwIpcError('INVALID_PARAMS', 'Invalid cursor');+ const runtime = activeCompanionCloud();+ if (!runtime) throwIpcError('PRECONDITION_FAILED', 'Cloud companions are not available');+ try {+ return await runtime.transcript(id, typeof before === 'string' ? before : undefined);+ } catch (error) {+ log.warn('companion transcript read failed', { error: error instanceof Error ? error.message.slice(0, 80) : 'UNKNOWN' });+ throwIpcError('PRECONDITION_FAILED', 'Companion conversation is not available');+ }+ });+ ipcMain.handle(MAKER_INVOKE.COMPANION_CLOUD_DEVICES, async (event) => {+ assertTrustedAppRendererEvent(event);+ return (await activeCompanionCloud()?.transferTargets()) ?? [];+ });ipcMain.handle(MAKER_INVOKE.BOT_GROUP_PLAN_DISMISS, async (event, input: unknown) => {assertTrustedAppRendererEvent(event);return botGroupChatServiceHolder ? botGroupChatServiceHolder.dismissPlan(input) : botGroupNotReady;@@ -16074,6 +16203,7 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)remoteHostId: sessions.remoteHostId,profileStatus: botProfiles.status,hiddenAt: botProfiles.hiddenAt,+ botId: botSessionLinks.botId,}).from(sessions).leftJoin(botSessionLinks, eq(botSessionLinks.sessionId, sessions.id))@@ -16082,6 +16212,10 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions).limit(1);assertCindyMakeSessionAvailable(botInput?.source);const blocked = botSessionInputBlockReason(botInput ?? null);+ // Rechecked under the send lock right before every real send, including queue drains.+ if (botInput?.source === 'bot' && isShadowedCompanionCanonical(botInput, isCompanionShadowed)) {+ throwIpcError('PRECONDITION_FAILED', SHADOWED_COMPANION_INPUT_MESSAGE);+ }if (args[2] && typeof args[2] === 'object') {if (botInput?.source === 'bot' && ['canonical', 'delegation', 'group'].includes(botInput.role ?? '')) {botFallbackInputs.add(args[2]);diff --git a/apps/desktop/src/main/maker-ipc/teammateGuide.ts b/apps/desktop/src/main/maker-ipc/teammateGuide.tsindex 4999ad055c..e15ff5923e 100644--- a/apps/desktop/src/main/maker-ipc/teammateGuide.ts+++ b/apps/desktop/src/main/maker-ipc/teammateGuide.ts@@ -35,6 +35,7 @@ export function buildTeammateGuide('When the user asks to change the application’s default model, use `get_app_default_model` to read the actual current selection and enabled options, then `set_app_default_model` with the returned id and a supported effort if requested. Check the confirmed result. This changes the same default used by new tasks and following teammates; it does not overwrite existing task choices or explicit teammate/global teammate chains. Do not use this global setter when asked to change only this teammate, edit configuration files, guess providers, enable hidden models, or call an auxiliary model.',`Use \`get_capabilities\` with \`scope: runtime\` to inspect registered tools and explicit availability reasons when needed. Use direct teammate tools for your own memory and teammates. When work needs another capability, use \`find_teammate_capabilities\` through the helper’s teammate tools to search existing Skills, MCP connections or built-in tools, and inspect actual availability. Tools and MCP connections follow Cindy by default; use \`set_teammate_capability\` only to change an explicit selection. References reuse existing installations and authorization; do not copy credentials or edit shared sources. New mounts take effect next turn in this same task.${pluginGuidance} Discover only what the work needs; do not repeatedly list the whole tool surface.`,"A real background task is a standalone Session in the user's task list. Prefer completing work in the current chat. Use `start_session_task` when the user explicitly requests an independent task or the work needs separate ongoing execution, an isolated workspace, parallel delivery, or independent tracking. Use `check_session_task`, `message_session_task`, and `stop_session_task` to control that same task when needed. Completion returns automatically; you remain responsible for reviewing and presenting the result.",+ 'You can also work on the user\'s other computers that allow remote control, through collaboration. `get_workspace_info` lists them as `execution_devices`; `create_worker` with `execution_device_id` runs that work, its directory and its commands on that computer, and never falls back to this one. A computer that is offline or has remote control turned off is unavailable.','Todo maintenance is a shared responsibility alongside task execution. Use `list_teammate_todos` and `update_teammate_todo` for your own affairs; read by id/key when known, otherwise use the returned total and pagination: explicit user requests and actionable discoveries from information you are already authorized to access. Distinguish assigned from discovered, include sources, why it matters, an outcome and one concrete next action. No project or execution task is required. Optional task/PR links never duplicate an affair. Ordinary task titles, engine states and archives retain their own lifecycle; project filters or removal never delete Todos.','Each turn check for relevant new requests, corrections, progress or completion evidence, and maintain the same stable Todo id/key on task results and authorized follow-up. Read relevant records for progress questions even without a change; only write actual changes. Updates are partial: omitted fields preserve sources, links and deadlines. Use id plus expectedRevision for existing entries; on CONFLICT re-read and reconcile rather than overwrite. Read back or inspect the successful returned record; errors are not saving. Never encode state in title prefixes or leave old PR prose after new verified facts. Complete only with a verifiable completion summary/reference satisfying outcome. Task end, merge and archive do not by themselves finish every affair; remaining acceptance is the next step. Reopening retains completion history.','For proactive discovery, reuse available authorized events and existing routines, not new periodic scans. A project teammate filters to its entrusted responsibilities first; personal teammates still use only available authorized sources. Never claim an unconnected mailbox, Feishu account or community was scanned, or read unrelated private message bodies. Apply cheap scope rules and stable event/problem ids, then `preflight_teammate_todo_events` against cursors, existing affairs and ignore records before fetching relevant bodies or using a model. Merge the same feedback from different sources into one key. Commit successful events in source order using `record_teammate_todo_event`; failure must not advance the cursor. Batch relevant summaries/cache results within the existing configured budget, never repeatedly scan full histories or wake an idle model to find no changes. No source event means no rescan. These tools maintain records and preflight supplied events; they do not install connectors, scanners or timers.',diff --git a/apps/desktop/src/main/routines/__tests__/service.test.ts b/apps/desktop/src/main/routines/__tests__/service.test.tsindex b34173585a..e7edbca2fc 100644--- a/apps/desktop/src/main/routines/__tests__/service.test.ts+++ b/apps/desktop/src/main/routines/__tests__/service.test.ts@@ -42,7 +42,7 @@ vi.mock('electron', () => ({}));vi.mock('../../security/trustedAppRenderer.js', () => ({ assertTrustedAppRendererEvent: vi.fn() }));vi.mock('../../utils/ipcValidate.js', () => ({ throwIpcError: vi.fn() }));-vi.mock('../../logger.js', () => ({ createLogger: () => ({ warn: vi.fn() }) }));+vi.mock('../../logger.js', () => ({ createLogger: () => ({ warn: vi.fn(), info: vi.fn() }) }));vi.mock('../../localDb/client/current.js', () => ({getCurrentDbClientSnapshot: () => mock.dbReady ? {userId: mock.dbOwner ?? mock.scope,@@ -58,6 +58,7 @@ vi.mock('../store.js', () => ({import { configureRoutineHost, getRoutineEngine, routineTools, stopRoutines, updateBotRoutineLifecycle } from '../service.js';import { handleRoutineRequest } from '../../cindy-brain/routineSlot.js';import type { InstalledGhost } from '../../../shared/ghost.js';+import { companionHomes } from '../../companion-cloud/homes.js';beforeEach(() => { mock.readProfiles.mockImplementation(async () => mock.profiles); });beforeEach(() => configureRoutineHost({getBot: mock.getBot,@@ -101,6 +102,35 @@ it('dispatches into the current canonical task through the existing silent runneexpect((await routineTools.history('bot', routine.id))[0].resultText).toBe('Reviewed PR');});+it('skips a demoted teammate\'s routine while its home is another computer, keeping the rule', async () => {+ companionHomes.update({ enabled: true, selfDeviceId: 'desk', humanActorId: 'human', demotedBotIds: ['bot'],+ actors: [{ id: 'actor', externalId: 'bot', name: 'Bot', avatar: null, homeDeviceId: 'laptop' }] });+ try {+ const routine = await routineTools.save('bot', { name: 'Review', prompt: 'Check', enabled: true,+ triggers: [{ id: 'tick', kind: 'interval', intervalMs: 60000 }] });+ await routineTools.runNow('bot', routine.id);+ await vi.waitFor(async () => expect((await routineTools.history('bot', routine.id))[0]?.status).toBe('skipped'));+ expect(mock.scheduler.runNow).not.toHaveBeenCalled();+ expect(mock.storage.insert).not.toHaveBeenCalled();+ expect((await routineTools.list('bot'))[0]).toMatchObject({ id: routine.id, enabled: true, prompt: 'Check' });+ } finally {+ companionHomes.reset();+ }+});++it('keeps skipping a demoted teammate\'s routine from the persisted list while the server is unreachable', async () => {+ companionHomes.setPersistedShadows(['bot']);+ try {+ const routine = await routineTools.save('bot', { name: 'Offline', prompt: 'Check', enabled: true,+ triggers: [{ id: 'tick', kind: 'interval', intervalMs: 60000 }] });+ await routineTools.runNow('bot', routine.id);+ await vi.waitFor(async () => expect((await routineTools.history('bot', routine.id))[0]?.status).toBe('skipped'));+ expect(mock.scheduler.runNow).not.toHaveBeenCalled();+ } finally {+ companionHomes.reset();+ }+});+it.skipIf(process.platform === 'win32')('rejects saving a pre-run hook command with a shell syntax error', async () => {const input = {name: 'Broken check',diff --git a/apps/desktop/src/main/routines/service.ts b/apps/desktop/src/main/routines/service.tsindex f7210abc09..889fc0a4a1 100644--- a/apps/desktop/src/main/routines/service.ts+++ b/apps/desktop/src/main/routines/service.ts@@ -27,6 +27,7 @@ import { assertPreRunHookCommandSyntax } from '../scheduler-host/pre-run-hook.jsimport { untrustedJsonBlock } from '../../shared/untrustedPrompt.js';import { getCurrentDbClientSnapshot } from '../localDb/client/current.js';import { botProfiles } from '../localDb/schema.js';+import { isCompanionShadowed } from '../companion-cloud/homes.js';/** Bootstrap supplies live getters without a service -> scheduler -> IPC dependency cycle. */export interface RoutineHostDeps {@@ -51,6 +52,8 @@ function getRoutineHost(): RoutineHostDeps {}const log = createLogger('routines');+/** Logged once per demoted teammate until it runs here again. */+const shadowedRoutineBots = new Set<string>();let current:{ scope: string; engine: RoutineEngine; timer: ReturnType<typeof setInterval> } | undefined;let starting: Promise<RoutineEngine> | undefined;@@ -100,6 +103,15 @@ async function execute(scope: string, routine: Routine, run: RoutineRun, signal:if (signal.aborted) throw new Error('Routine cancelled');if (bot.status !== 'active' || !bot.canonicalSessionId)throw new Error('The teammate is unavailable');+ // Its home moved to another computer (cloud-companions.md §3): routines run only there.+ if (isCompanionShadowed(routine.botId)) {+ if (!shadowedRoutineBots.has(routine.botId)) {+ shadowedRoutineBots.add(routine.botId);+ log.info('routine skipped: teammate runs on another computer', { botId: routine.botId });+ }+ return { skipped: true };+ }+ shadowedRoutineBots.delete(routine.botId);if (!canDispatch()) return { deferred: true };const root = ownerScopedUserDataPath();const imported = await getRoutineHost().prepareImportedAutomation?.(root, routine, run.id, signal, () => assertScope(scope));diff --git a/apps/desktop/src/preload/preload.ts b/apps/desktop/src/preload/preload.tsindex 3a6f46946e..a02d4208a2 100644--- a/apps/desktop/src/preload/preload.ts+++ b/apps/desktop/src/preload/preload.ts@@ -799,6 +799,7 @@ const fanOutMakerSessionBackgroundActivityChanged = createIpcFanOut(const fanOutBotDelegationChanged = createIpcFanOut('maker:bot-delegation:changed');const fanOutBotDirectMessageChanged = createIpcFanOut('maker:bot-direct-message:changed');const fanOutBotGroupChanged = createIpcFanOut('maker:bot-group:changed');+const fanOutCompanionCloudChanged = createIpcFanOut('maker:companion-cloud:changed');const fanOutBotProfileChanged = createIpcFanOut('maker:bot-profile:changed');const fanOutBotWorkbenchChanged = createIpcFanOut('maker:bot-workbench:changed');const fanOutBotLifecycleChanged = createIpcFanOut('maker:bot-lifecycle:changed');@@ -6077,6 +6078,17 @@ contextBridge.exposeInMainWorld('electronAPI', {): Promise<import('../shared/botGroupChat').BotGroupMutationResult> =>ipcRenderer.invoke('maker:bot-group:plan-edit', input),onBotGroupChanged: fanOutBotGroupChanged,+ getCompanionCloudState: (): Promise<import('../shared/companionCloud').CompanionCloudSnapshot> =>+ ipcRenderer.invoke('maker:companion-cloud:state'),+ onCompanionCloudChanged: fanOutCompanionCloudChanged,+ takeOverCompanion: (botId: string): Promise<import('../shared/companionCloud').CompanionCloudActionResult> =>+ ipcRenderer.invoke('maker:companion-cloud:take-over', botId),+ transferCompanion: (botId: string, targetDeviceId: string): Promise<import('../shared/companionCloud').CompanionCloudActionResult> =>+ ipcRenderer.invoke('maker:companion-cloud:transfer', botId, targetDeviceId),+ getCompanionTranscript: (botId: string, before?: string): Promise<import('../shared/companionCloud').CompanionTranscriptPage> =>+ ipcRenderer.invoke('maker:companion-cloud:transcript', botId, before),+ listCompanionTransferTargets: (): Promise<import('../shared/companionCloud').CompanionTransferTarget[]> =>+ ipcRenderer.invoke('maker:companion-cloud:devices'),onBotProfileChanged: fanOutBotProfileChanged,onBotWorkbenchChanged: fanOutBotWorkbenchChanged,runBotLifecycleAction: (diff --git a/apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx b/apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsxindex cdf9bf8601..f8c1710bb2 100644--- a/apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx+++ b/apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx@@ -5,15 +5,19 @@ export function BotConnectionStatus({online = true,deviceName,inline = false,+ homeOffline = false,className,}: {online?: boolean | null;+ /** The device is this companion's main computer (cloud companions): say so when offline. */+ homeOffline?: boolean;deviceName?: string;inline?: boolean;className?: string;}) {const { t } = useTranslation();- const status = t(online === null ? 'bots.remote.unknown' : online ? 'bots.remote.online' : 'bots.remote.offline');+ const status = t(homeOffline && !online ? 'bots.cloud.homeOfflineShort'+ : online === null ? 'bots.remote.unknown' : online ? 'bots.remote.online' : 'bots.remote.offline');const name = deviceName?.trim();const label = name ? `${status} · ${name}` : status;if (inline) {diff --git a/apps/desktop/src/renderer/features/bots/BotHomeComputerSetting.tsx b/apps/desktop/src/renderer/features/bots/BotHomeComputerSetting.tsxnew file mode 100644index 0000000000..830c276254--- /dev/null+++ b/apps/desktop/src/renderer/features/bots/BotHomeComputerSetting.tsx@@ -0,0 +1,135 @@+/**+ * 伙伴设置里的「主力电脑」一行(docs/product-rules/cloud-companions.md §3.1):本机是主力电脑时+ * 显示「这台电脑」,点开列出可接手的其他电脑;确认后交出去并打开那台电脑上的伙伴。+ * 服务器不支持云端伙伴时整行不出现。+ */+import { useRef, useState } from 'react';+import { ChevronRight, Monitor } from 'lucide-react';+import { useNavigate } from 'react-router-dom';+import { useTranslation } from 'react-i18next';++import { ConfirmDialog } from '@/components/ui/confirm-dialog';+import {+ DropdownMenu,+ DropdownMenuContent,+ DropdownMenuItem,+ DropdownMenuTrigger,+} from '@/components/ui/dropdown-menu';+import { toast } from '@/lib/toast';+import type { CompanionCloudFailureCode, CompanionTransferTarget } from '../../../shared/companionCloud';+import { companionCloudApi, refreshCompanionCloud, useCompanionCloud } from './companionCloudStore';++const TRANSFER_ERROR_KEYS: Record<CompanionCloudFailureCode, string> = {+ HOME_CONFLICT: 'bots.cloud.transferConflict',+ OFFLINE: 'bots.cloud.transferOffline',+ NOT_ENABLED: 'bots.cloud.notEnabled',+ TARGET_UNAVAILABLE: 'bots.cloud.targetUnavailable',+ FAILED: 'bots.cloud.transferFailed',+ BUSY: 'bots.cloud.transferBusy',+};++export function BotHomeComputerSetting({ bot }: { bot: { id: string; name: string; status?: string } }) {+ const { t } = useTranslation();+ const navigate = useNavigate();+ const cloud = useCompanionCloud();+ const [targets, setTargets] = useState<CompanionTransferTarget[] | null>(null);+ const [targetsFailed, setTargetsFailed] = useState(false);+ const [pending, setPending] = useState<CompanionTransferTarget | null>(null);+ const [busy, setBusy] = useState(false);+ const [error, setError] = useState<string | null>(null);+ const inFlight = useRef(false);+ const actor = cloud.enabled ? cloud.actors.find((candidate) => candidate.externalId === bot.id) : undefined;+ if (!actor || !cloud.selfDeviceId || actor.homeDeviceId !== cloud.selfDeviceId) return null;++ // Only a running companion syncs (and so can be handed over); a paused one is resumed first.+ const movable = bot.status === undefined || bot.status === 'active';+ const loadTargets = () => {+ if (!movable) return;+ setTargets(null);+ setTargetsFailed(false);+ const api = companionCloudApi();+ if (!api) { setTargetsFailed(true); return; }+ void api.listCompanionTransferTargets().then(setTargets, () => setTargetsFailed(true));+ };++ const transfer = async () => {+ if (!pending || inFlight.current) return;+ const api = companionCloudApi();+ if (!api) return;+ inFlight.current = true;+ setBusy(true);+ setError(null);+ const target = pending;+ try {+ const result = await api.transferCompanion(bot.id, target.deviceId);+ if (result.ok) {+ setPending(null);+ toast.info(t('bots.cloud.transferred', { name: bot.name, device: target.name }));+ navigate(`/bots/remote/${encodeURIComponent(target.deviceId)}/${encodeURIComponent(bot.id)}`);+ return;+ }+ setPending(null);+ setError(t(TRANSFER_ERROR_KEYS[result.code], { name: bot.name, device: target.name }));+ if (result.code === 'HOME_CONFLICT') refreshCompanionCloud();+ } catch {+ setPending(null);+ setError(t('bots.cloud.transferFailed', { name: bot.name, device: target.name }));+ } finally {+ inFlight.current = false;+ setBusy(false);+ }+ };++ return (+ <div className="mt-3">+ <div className="overflow-hidden rounded-xl border border-[var(--border-default)] bg-[var(--surface-elevated)]">+ <DropdownMenu onOpenChange={(open) => { if (open) loadTargets(); }}>+ <DropdownMenuTrigger asChild>+ <button+ type="button"+ data-testid="bot-home-computer-row"+ className="flex min-h-12 w-full items-center gap-3 px-4 py-3 text-left text-14 text-[var(--text-primary)] outline-none hover:bg-[var(--surface-hover)] focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-[var(--focus-ring)]"+ >+ <Monitor size={18} className="shrink-0 text-[var(--text-secondary)]" />+ <span className="min-w-0 flex-1">{t('bots.cloud.homeLabel')}</span>+ <span className="shrink-0 text-13 text-[var(--text-secondary)]">{t('bots.cloud.thisComputer')}</span>+ <ChevronRight size={14} className="shrink-0 text-[var(--text-tertiary)]" />+ </button>+ </DropdownMenuTrigger>+ <DropdownMenuContent align="end" className="min-w-56 max-w-80">+ {!movable ? (+ <DropdownMenuItem disabled className="whitespace-normal">{t('bots.cloud.resumeToMove', { name: bot.name })}</DropdownMenuItem>+ ) : targetsFailed ? (+ <DropdownMenuItem disabled>{t('bots.cloud.devicesFailed')}</DropdownMenuItem>+ ) : targets === null ? (+ <DropdownMenuItem disabled>{t('bots.cloud.loadingDevices')}</DropdownMenuItem>+ ) : targets.length === 0 ? (+ <DropdownMenuItem disabled className="whitespace-normal">{t('bots.cloud.noTargets')}</DropdownMenuItem>+ ) : (+ targets.map((target) => (+ <DropdownMenuItem key={target.deviceId} onSelect={() => { setError(null); setPending(target); }}>+ <span className="min-w-0 truncate">{t('bots.cloud.moveTo', { device: target.name })}</span>+ </DropdownMenuItem>+ ))+ )}+ </DropdownMenuContent>+ </DropdownMenu>+ </div>+ {error ? (+ <p role="alert" className="mt-2 px-1 text-12 text-[var(--text-danger)]">{error}</p>+ ) : null}+ <ConfirmDialog+ open={pending !== null}+ presentation="standard"+ cancelFirst+ onOpenChange={(open) => { if (!open && !inFlight.current) setPending(null); }}+ title={t('bots.cloud.transferTitle', { name: bot.name, device: pending?.name ?? '' })}+ description={t('bots.cloud.transferDescription', { name: bot.name, device: pending?.name ?? '' })}+ confirmText={t('bots.cloud.transferAction', { device: pending?.name ?? '' })}+ cancelText={t('bots.cancel')}+ loading={busy}+ onConfirm={() => void transfer()}+ />+ </div>+ );+}diff --git a/apps/desktop/src/renderer/features/bots/BotSessionView.tsx b/apps/desktop/src/renderer/features/bots/BotSessionView.tsxindex b7106909ce..bec9364ac9 100644--- a/apps/desktop/src/renderer/features/bots/BotSessionView.tsx+++ b/apps/desktop/src/renderer/features/bots/BotSessionView.tsx@@ -7,6 +7,8 @@ import { useTranslation } from 'react-i18next';import { Spinner } from '@/components/ui/spinner';import { CCAgentSessionView } from '@/features/cc-agent/CCAgentSessionView';+import { useCompanionCloud } from './companionCloudStore';+import { CompanionShadowBanner } from './CompanionShadowBanner';import type { ComposerBotMention } from '@/lib/fileTypes';import { getBotLastReadAt, markBotRead } from './botReadState';import { useBotProfiles } from './botStore';@@ -83,6 +85,8 @@ function BotSessionGateView() {const { botId, sessionId } = useParams();const [reloadVersion, setReloadVersion] = useState(0);const [gate, setGate] = useState<BotSessionGate>({ kind: 'loading' });+ // The companion now runs on its main computer: this copy's main task is read only.+ const shadowed = useCompanionCloud().demotedBotIds.includes(botId ?? '');useBotIslandVisibleSession(gate.kind === 'ready' ? sessionId ?? null : null);// The gate proves ownership once; name and avatar edited in settings must// still reach the open chat's header and composer.@@ -257,15 +261,20 @@ function BotSessionGateView() {</main>);}+ const readOnly = shadowed && gate.isCanonical;return (<main className="relative flex h-full min-w-0 overflow-hidden bg-[var(--surface)]">- <div className="min-w-0 flex-1">- <CCAgentSessionView- botMentions={gate.mentions}- botIdentity={identity ?? gate.identity}- botUnreadBoundaryAt={gate.unreadBoundaryAt}- onBotReadThrough={gate.isCanonical ? onReadThrough : undefined}- />+ <div className="flex min-w-0 flex-1 flex-col">+ {readOnly && botId ? <CompanionShadowBanner botId={botId} name={(identity ?? gate.identity).name} /> : null}+ <div className="min-h-0 flex-1">+ <CCAgentSessionView+ botMentions={gate.mentions}+ botIdentity={identity ?? gate.identity}+ botUnreadBoundaryAt={gate.unreadBoundaryAt}+ onBotReadThrough={gate.isCanonical ? onReadThrough : undefined}+ {...(readOnly ? { readOnly: true } : {})}+ />+ </div></div></main>);diff --git a/apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx b/apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsxindex 0942507d3c..f03cd60ed8 100644--- a/apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx+++ b/apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx@@ -8,6 +8,7 @@ import { WINDOW_NO_DRAG_STYLE } from '@/components/layout/windowDrag';import { BotPronounProvider, useBotTranslation } from './botPronounContext';import { BotSettings } from './BotsHomeView';import { useBotProfiles } from './botStore';+import { useCompanionCloud } from './companionCloudStore';import { useRemoteBots } from './useRemoteBots';import { RemoteBotSettings } from './RemoteBotSettings';@@ -26,9 +27,13 @@ export function BotSettingsDrawer() {);const match =matchPath('/bots/:botId/*', location.pathname) ?? matchPath('/bots/:botId', location.pathname);- const bot = remoteMatch+ const cloud = useCompanionCloud();+ const localBot = remoteMatch? null: (bots.find((candidate) => candidate.id === match?.params.botId) ?? null);+ // A demoted copy (the companion runs on another computer) is read-only: edits here would never+ // reach the companion. Its settings live on the main computer (the banner on its task links there).+ const bot = localBot && cloud.demotedBotIds.includes(localBot.id) ? null : localBot;const open = searchParams.get('settings') === '1' && (bot !== null || !!remoteBot);const requestedPage = searchParams.get('settingsPage');diff --git a/apps/desktop/src/renderer/features/bots/BotsHomeView.tsx b/apps/desktop/src/renderer/features/bots/BotsHomeView.tsxindex 47da6aeec0..1181c42cf3 100644--- a/apps/desktop/src/renderer/features/bots/BotsHomeView.tsx+++ b/apps/desktop/src/renderer/features/bots/BotsHomeView.tsx@@ -55,6 +55,9 @@ import {shouldDeferCanonicalBotSessionNavigation,withBotCanonicalSessionReadTimeout,} from './botNavigation';+import { useCompanionCloud } from './companionCloudStore';+import { withoutShadowedBots } from './companionCloudPresentation';+import { BotHomeComputerSetting } from './BotHomeComputerSetting';import { BotLifecycleSettings } from './BotLifecycleSettings';import { BotInvitationWelcome } from './BotInvitationWelcome';import { BotModelChainEditor } from './BotModelChainEditor';@@ -512,6 +515,7 @@ export function BotSettings({</button>))}</div>+ <BotHomeComputerSetting bot={bot} /><div className="mt-6"><BotLifecycleSettingsbot={bot}@@ -769,7 +773,9 @@ export function BotsHomeView() {const history = useContext(MainViewHistoryContext);const selectedBot = useMemo(() => bots.find((bot) => bot.id === botId && bot.status !== 'deleting') ?? null, [botId, bots]);const profilesLoaded = hasLoadedBotProfiles();- const entryTarget = botEntryTarget(bots, history?.current.lastBotId);+ const cloud = useCompanionCloud();+ // Demoted copies (home moved to another computer) are never the entry choice.+ const entryTarget = botEntryTarget(withoutShadowedBots(bots, cloud), history?.current.lastBotId);// An empty profile projection can predate the newly connected source/runtime.// Only followers may resume from live defaults; Main resolves the actual route// when opening the canonical task without writing a per-Bot override.diff --git a/apps/desktop/src/renderer/features/bots/BotsSidebar.tsx b/apps/desktop/src/renderer/features/bots/BotsSidebar.tsxindex 9850bada6d..a564c5a77b 100644--- a/apps/desktop/src/renderer/features/bots/BotsSidebar.tsx+++ b/apps/desktop/src/renderer/features/bots/BotsSidebar.tsx@@ -39,6 +39,8 @@ import {import { useSidebarCollapsedState, useRegisterSidebarUpper } from '../feature-context';import { SidebarIconButton } from '@/components/sidebar/SidebarIconButton';import { useRemoteBots } from './useRemoteBots';+import { useCompanionCloud } from './companionCloudStore';+import { cloudRemoteBots, isCloudHomeOffline, withoutShadowedBots } from './companionCloudPresentation';import { useDeviceLinkDeviceList } from '@/features/device-link/useDeviceLinkDeviceList';import { remoteBotKey, isRemoteBotUnread } from './remoteBotRoster';import { BotConnectionStatus } from './BotConnectionStatus';@@ -87,14 +89,19 @@ function BotsSidebarContent() {const navigate = useNavigate();const { pathname } = useLocation();const { botId, sessionId, deviceId, groupId } = useParams();- const remoteBots = useRemoteBots();+ const cloud = useCompanionCloud();+ const rosterRemoteBots = useRemoteBots();+ // One row per companion, on its main computer (offline rows for computers never listed here).+ const remoteBots = useMemo(() => cloudRemoteBots(cloud, rosterRemoteBots), [rosterRemoteBots, cloud]);const devices = useDeviceLinkDeviceList();const self = devices?.find((device) => device.isSelf);const rosterDevices = [...(self ? [self] : []),...remoteBots.map((bot) => ({ deviceId: bot.deviceId, name: bot.deviceName })),];- const bots = useBotProfiles();+ const allBots = useBotProfiles();+ // A demoted local copy runs on its main computer now; it is listed there, not here.+ const bots = useMemo(() => withoutShadowedBots(allBots, cloud), [allBots, cloud]);const { groups } = useBotGroupList();useSyncExternalStore(subscribeBotReadState, readRevision, readRevision);const unreadByBotId = useBotUnreadCounts();@@ -456,10 +463,10 @@ function BotsSidebarContent() {<button key={remoteBotKey(bot)} type="button" aria-current={selected ? 'page' : undefined}onClick={() => navigate(`/bots/remote/${encodeURIComponent(bot.deviceId)}/${encodeURIComponent(bot.id)}`)}className={cn('flex w-full min-w-0 items-center gap-2.5 rounded-xl px-2.5 py-2 text-left outline-none focus-visible:ring-2 focus-visible:ring-ring', selected ? 'bg-sidebar-item-active text-sidebar-item-active-foreground' : 'text-[var(--sidebar-nav-text)] hover:bg-sidebar-item-hover')}>- <span className="relative shrink-0"><BotAvatar bot={bot} size="md" /><BotConnectionStatus online={bot.connectionKnown === false ? null : bot.online} deviceName={deviceName} /></span>+ <span className="relative shrink-0"><BotAvatar bot={bot} size="md" /><BotConnectionStatus online={bot.connectionKnown === false ? null : bot.online} deviceName={deviceName} homeOffline={isCloudHomeOffline(cloud, bot)} /></span><span className="flex min-w-0 flex-1 flex-col gap-0.5"><span className="truncate text-14 leading-5">{bot.name}</span>- <BotConnectionStatus inline online={bot.connectionKnown === false ? null : bot.online} deviceName={deviceName} className={selected ? 'opacity-70' : 'text-[var(--text-secondary)]'} />+ <BotConnectionStatus inline online={bot.connectionKnown === false ? null : bot.online} deviceName={deviceName} homeOffline={isCloudHomeOffline(cloud, bot)} className={selected ? 'opacity-70' : 'text-[var(--text-secondary)]'} /><span className="truncate text-12 leading-4 text-[var(--sidebar-list-muted)]">{bot.online && bot.generation ? <BotGenerationLabel sessionId={bot.sessionId ?? undefined} {...bot.generation} remote={{ deviceId: bot.deviceId, botId: bot.id }} /> : bot.preview || bot.description || t('bots.list.startChat')}</span></span>{!selected && isRemoteBotUnread(bot) ? <span aria-label={t('bots.list.unread', { count: 1 })} className="size-[7px] shrink-0 rounded-full bg-[var(--bot-unread-bg)]" /> : null}diff --git a/apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx b/apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsxindex b1e0f60d30..08fd603537 100644--- a/apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx+++ b/apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx@@ -5,6 +5,8 @@ import { useDeviceLinkDeviceList } from '@/features/device-link/useDeviceLinkDevimport { cn } from '@/lib/utils';import { useBotProfiles, useBotUnreadCounts } from './botStore';import { useRemoteBots } from './useRemoteBots';+import { useCompanionCloud } from './companionCloudStore';+import { cloudRemoteBots, withoutShadowedBots } from './companionCloudPresentation';import { cindyDeviceKey, cindyDeviceOptions, type CindyDeviceOption } from './cindyDeviceRoster';import { formatBotUnreadBadge } from './botListDisplay';import type { BotChatIdentity } from './BotSessionContentHeader';@@ -72,8 +74,11 @@ export function CindyDevicePicker({export function CindyHeaderDevicePicker({ bot }: { bot: BotChatIdentity }) {const { t } = useTranslation();const navigate = useNavigate();- const bots = useBotProfiles();- const remoteBots = useRemoteBots();+ const cloud = useCompanionCloud();+ // A demoted local Cindy is not the "local" option: she runs on her main computer.+ const bots = withoutShadowedBots(useBotProfiles(), cloud);+ // Copies other computers still list for a Cindy that runs elsewhere are not choices either.+ const remoteBots = cloudRemoteBots(cloud, useRemoteBots());const devices = useDeviceLinkDeviceList();const unread = useBotUnreadCounts();const options = cindyDeviceOptions(diff --git a/apps/desktop/src/renderer/features/bots/CloudCompanionOfflineView.tsx b/apps/desktop/src/renderer/features/bots/CloudCompanionOfflineView.tsxnew file mode 100644index 0000000000..35a2317610--- /dev/null+++ b/apps/desktop/src/renderer/features/bots/CloudCompanionOfflineView.tsx@@ -0,0 +1,202 @@+/**+ * 主力电脑离线时的伙伴视图(docs/product-rules/cloud-companions.md §3.1):保留伙伴头部,+ * 横幅说明哪台主力电脑离线并提供「在这台电脑继续」,下方只读显示云端保存的对话。+ */+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';+import { useNavigate } from 'react-router-dom';+import { useTranslation } from 'react-i18next';++import { CHAT_BODY_CLASS } from '@/components/chat/chatChrome';+import { MarkdownRenderer } from '@/components/chat/MarkdownRenderer';+import { Button } from '@/components/ui/button';+import { Spinner } from '@/components/ui/spinner';+import { getDataOwnerGeneration, isDataOwnerGenerationCurrent } from '@/contexts/dataOwnerGeneration';+import { useDeviceLinkDeviceList } from '@/features/device-link/useDeviceLinkDeviceList';+import { toast } from '@/lib/toast';+import type { CompanionTranscriptMessage } from '../../../shared/companionCloud';+import { BotAvatar } from './BotAvatar';+import { BotSessionContentHeaderRegistration, type BotChatIdentity } from './BotSessionContentHeader';+import { ensureBotProfilesLoaded } from './botStore';+import { companionCloudApi, refreshCompanionCloud } from './companionCloudStore';++export interface CloudCompanionOfflineViewProps {+ botId: string;+ deviceId: string;+ name: string;+ avatar?: string | null;+ avatarColor?: string | null;+ /** Home computer name; empty when this device never saw it. */+ deviceName: string;+ /** The home is online but does not allow remote control from here. */+ reachable?: boolean;+}++type TakeOverState =+ | { kind: 'idle' }+ | { kind: 'running' }+ | { kind: 'conflict'; device: string }+ | { kind: 'error'; key: string };++export function CloudCompanionOfflineView({ botId, deviceId, name, avatar, avatarColor, deviceName, reachable = false }: CloudCompanionOfflineViewProps) {+ const { t } = useTranslation();+ const navigate = useNavigate();+ const devices = useDeviceLinkDeviceList();+ const device = deviceName.trim() || t('bots.cloud.unknownDevice');+ const identity = useMemo<BotChatIdentity>(() => ({ id: botId, deviceId, deviceName: device, name, avatar, avatarColor, sessionId: null }),+ [botId, deviceId, device, name, avatar, avatarColor]);+ const [messages, setMessages] = useState<CompanionTranscriptMessage[]>([]);+ const [nextBefore, setNextBefore] = useState<string | undefined>();+ const [loading, setLoading] = useState(true);+ const [loadFailed, setLoadFailed] = useState(false);+ const [state, setState] = useState<TakeOverState>({ kind: 'idle' });+ const scroller = useRef<HTMLDivElement>(null);+ const anchor = useRef<{ height: number; top: number } | null>(null);+ const stickToBottom = useRef(true);+ const loadingRef = useRef(false);++ const load = useCallback(async (before?: string) => {+ const api = companionCloudApi();+ if (!api || loadingRef.current) return;+ loadingRef.current = true;+ setLoading(true);+ setLoadFailed(false);+ const owner = getDataOwnerGeneration();+ try {+ const page = await api.getCompanionTranscript(botId, before);+ if (!isDataOwnerGenerationCurrent(owner)) return;+ if (before && scroller.current) anchor.current = { height: scroller.current.scrollHeight, top: scroller.current.scrollTop };+ setMessages((current) => before ? [...page.messages.filter((m) => !current.some((c) => c.id === m.id)), ...current] : page.messages);+ setNextBefore(page.nextBefore);+ } catch {+ if (isDataOwnerGenerationCurrent(owner)) setLoadFailed(true);+ } finally {+ loadingRef.current = false;+ setLoading(false);+ }+ }, [botId]);++ useEffect(() => {+ setMessages([]);+ setNextBefore(undefined);+ stickToBottom.current = true;+ void load();+ }, [load]);++ useLayoutEffect(() => {+ const node = scroller.current;+ if (!node) return;+ if (anchor.current) {+ // Older messages were prepended: keep the reader on the same message.+ node.scrollTop = node.scrollHeight - anchor.current.height + anchor.current.top;+ anchor.current = null;+ } else if (stickToBottom.current) {+ node.scrollTop = node.scrollHeight;+ }+ }, [messages]);++ const takeOver = async () => {+ const api = companionCloudApi();+ if (!api || state.kind === 'running') return;+ setState({ kind: 'running' });+ const owner = getDataOwnerGeneration();+ try {+ const result = await api.takeOverCompanion(botId);+ if (!isDataOwnerGenerationCurrent(owner)) return;+ if (result.ok) {+ await ensureBotProfilesLoaded(true).catch(() => undefined);+ refreshCompanionCloud();+ navigate(`/bots/${encodeURIComponent(botId)}`);+ return;+ }+ refreshCompanionCloud();+ if (result.code === 'HOME_CONFLICT') {+ const winner = devices?.find((candidate) => candidate.deviceId === result.homeDeviceId)?.name?.trim() || t('bots.cloud.unknownDevice');+ if (result.homeDeviceId && result.homeDeviceId !== deviceId) {+ // Another computer already continued: show the companion where it runs now.+ toast.info(t('bots.cloud.takeOverConflict', { name, device: winner }));+ setState({ kind: 'idle' });+ navigate(`/bots/remote/${encodeURIComponent(result.homeDeviceId)}/${encodeURIComponent(botId)}`);+ } else setState({ kind: 'conflict', device: winner });+ } else setState({ kind: 'error', key: result.code === 'OFFLINE' ? 'bots.cloud.takeOverOffline'+ : result.code === 'NOT_ENABLED' ? 'bots.cloud.notEnabled' : 'bots.cloud.takeOverFailed' });+ } catch {+ if (isDataOwnerGenerationCurrent(owner)) setState({ kind: 'error', key: 'bots.cloud.takeOverFailed' });+ }+ };++ return (+ <main className="flex h-full min-h-0 flex-col bg-[var(--surface)]" data-testid="cloud-companion-offline">+ <BotSessionContentHeaderRegistration bot={identity} />+ <section+ role="status"+ className="mx-4 mt-3 flex flex-wrap items-center gap-3 rounded-xl border border-[var(--border-default)] bg-[var(--surface-elevated)] px-4 py-3"+ >+ <BotAvatar bot={identity} size="sm" />+ <div className="min-w-0 flex-1">+ <p className="text-14 font-medium text-[var(--text-primary)]">+ {t(reachable ? 'bots.cloud.homeUnreachable' : 'bots.cloud.homeOffline', { device })}+ </p>+ <p className="mt-0.5 text-12 text-[var(--text-secondary)]">+ {state.kind === 'running' ? t('bots.cloud.takingOver', { name })+ : state.kind === 'conflict' ? t('bots.cloud.takeOverConflict', { name, device: state.device })+ : state.kind === 'error' ? t(state.key, { name })+ : t('bots.cloud.takeOverHint', { name })}+ </p>+ </div>+ <Button+ variant="primary"+ size="md"+ type="button"+ loading={state.kind === 'running'}+ disabled={state.kind === 'running'}+ onClick={() => void takeOver()}+ >+ {t('bots.cloud.continueHere')}+ </Button>+ </section>+ <div+ ref={scroller}+ className="min-h-0 flex-1 overflow-y-auto px-6 py-4"+ onScroll={(event) => {+ const node = event.currentTarget;+ stickToBottom.current = node.scrollHeight - node.scrollTop - node.clientHeight < 24;+ if (node.scrollTop < 40 && nextBefore && !loadingRef.current) void load(nextBefore);+ }}+ >+ <div className="mx-auto flex max-w-3xl flex-col gap-4">+ {nextBefore ? (+ <Button variant="secondary" tone="quiet" compact type="button" className="self-center" disabled={loading} onClick={() => void load(nextBefore)}>+ {t('bots.cloud.loadOlder')}+ </Button>+ ) : null}+ {loading && messages.length === 0 ? <Spinner size={18} className="self-center" /> : null}+ {loadFailed ? (+ <div role="alert" className="flex flex-col items-center gap-2 text-13 text-[var(--text-secondary)]">+ <p>{t('bots.cloud.loadFailed')}</p>+ <Button variant="secondary" compact type="button" onClick={() => void load(messages.length ? nextBefore : undefined)}>+ {t('bots.cloud.reload')}+ </Button>+ </div>+ ) : null}+ {!loading && !loadFailed && messages.length === 0 ? (+ <p className="text-center text-13 text-[var(--text-tertiary)]">{t('bots.cloud.empty')}</p>+ ) : null}+ {messages.map((message) => message.role === 'user' ? (+ <article key={message.id} className="flex justify-end">+ <div className={`max-w-[72%] whitespace-pre-wrap break-words rounded-xl border border-[var(--msg-user-border)] bg-[var(--msg-user-bg)] px-3.5 py-2.5 text-[var(--msg-user-text)] ${CHAT_BODY_CLASS}`}>+ {message.text}+ </div>+ </article>+ ) : (+ <article key={message.id} className={`min-w-0 text-[var(--msg-assistant-text)] ${CHAT_BODY_CLASS}`}>+ <MarkdownRenderer workingDir="" content={message.text} allowPrivilegedLinks={false} />+ </article>+ ))}+ </div>+ </div>+ <p className="border-t border-[var(--border-default)] px-6 py-3 text-center text-12 text-[var(--text-tertiary)]">+ {t('bots.cloud.readOnlyNote')}+ </p>+ </main>+ );+}diff --git a/apps/desktop/src/renderer/features/bots/CompanionShadowBanner.tsx b/apps/desktop/src/renderer/features/bots/CompanionShadowBanner.tsxnew file mode 100644index 0000000000..5c6e374b79--- /dev/null+++ b/apps/desktop/src/renderer/features/bots/CompanionShadowBanner.tsx@@ -0,0 +1,69 @@+/**+ * 已降级的本机副本(docs/product-rules/cloud-companions.md §3.1):伙伴在主力电脑上运行,这里的+ * 主任务只读;横幅提供「打开主力电脑上的伙伴」与「在这台电脑继续」。+ */+import { useState } from 'react';+import { useNavigate } from 'react-router-dom';+import { useTranslation } from 'react-i18next';++import { Button } from '@/components/ui/button';+import { getDataOwnerGeneration, isDataOwnerGenerationCurrent } from '@/contexts/dataOwnerGeneration';+import { toast } from '@/lib/toast';+import { ensureBotProfilesLoaded } from './botStore';+import { companionCloudApi, refreshCompanionCloud, useCompanionCloud } from './companionCloudStore';++export function CompanionShadowBanner({ botId, name }: { botId: string; name: string }) {+ const { t } = useTranslation();+ const navigate = useNavigate();+ const cloud = useCompanionCloud();+ const [busy, setBusy] = useState(false);+ const [error, setError] = useState<string | null>(null);+ const actor = cloud.actors.find((candidate) => candidate.externalId === botId);+ const home = actor?.homeDeviceId && actor.homeDeviceId !== cloud.selfDeviceId ? actor.homeDeviceId : null;+ const device = actor?.homeDevice?.name?.trim() || t('bots.cloud.unknownDevice');++ const takeOver = async () => {+ const api = companionCloudApi();+ if (!api || busy) return;+ setBusy(true);+ setError(null);+ const owner = getDataOwnerGeneration();+ try {+ const result = await api.takeOverCompanion(botId);+ if (!isDataOwnerGenerationCurrent(owner)) return;+ refreshCompanionCloud();+ if (result.ok) { await ensureBotProfilesLoaded(true).catch(() => undefined); return; }+ if (result.code === 'HOME_CONFLICT') toast.info(t('bots.cloud.takeOverConflict', { name, device }));+ else setError(t(result.code === 'OFFLINE' ? 'bots.cloud.takeOverOffline' : result.code === 'NOT_ENABLED'+ ? 'bots.cloud.notEnabled' : 'bots.cloud.takeOverFailed', { name }));+ } catch {+ if (isDataOwnerGenerationCurrent(owner)) setError(t('bots.cloud.takeOverFailed', { name }));+ } finally {+ setBusy(false);+ }+ };++ return (+ <section+ role="status"+ data-testid="companion-shadow-banner"+ className="mx-4 mt-3 flex flex-wrap items-center gap-3 rounded-xl border border-[var(--border-default)] bg-[var(--surface-elevated)] px-4 py-3"+ >+ <div className="min-w-0 flex-1">+ <p className="text-14 font-medium text-[var(--text-primary)]">{t('bots.cloud.shadowTitle', { device })}</p>+ <p className="mt-0.5 text-12 text-[var(--text-secondary)]">+ {busy ? t('bots.cloud.takingOver', { name }) : error ?? t('bots.cloud.shadowHint')}+ </p>+ </div>+ {home ? (+ <Button variant="secondary" size="md" type="button" disabled={busy}+ onClick={() => navigate(`/bots/remote/${encodeURIComponent(home)}/${encodeURIComponent(botId)}`)}>+ {t('bots.cloud.openOnHome', { device })}+ </Button>+ ) : null}+ <Button variant="primary" size="md" type="button" loading={busy} disabled={busy} onClick={() => void takeOver()}>+ {t('bots.cloud.continueHere')}+ </Button>+ </section>+ );+}diff --git a/apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx b/apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsxindex 119874d3e1..a466c45340 100644--- a/apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx+++ b/apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx@@ -1,7 +1,7 @@import { getDataOwnerGeneration, isDataOwnerGenerationCurrent } from '@/contexts/dataOwnerGeneration';import { Button } from '@/components/ui/button';import { REMOTE_RESOURCE_GET_CHANNEL, type RemoteResourceGetRequest } from '@cindy/device-link';-import { useCallback, useEffect, useRef, useState } from 'react';+import { Suspense, lazy, useCallback, useEffect, useRef, useState } from 'react';import { useParams } from 'react-router-dom';import { useTranslation } from 'react-i18next';import { CCAgentSessionView } from '@/features/cc-agent/CCAgentSessionView';@@ -11,6 +11,11 @@ import { Spinner } from '@/components/ui/spinner';import { BotAvatar } from './BotAvatar';import { parseRemoteBots, type RemoteBot } from './remoteBotRoster';import { markRemoteBotRead, useRemoteBots } from './useRemoteBots';+import { useCompanionCloud } from './companionCloudStore';+import { cloudCompanionAt } from './companionCloudPresentation';+// Loaded only when a main computer is offline; keeps the live remote path light.+const CloudCompanionOfflineView = lazy(() => import('./CloudCompanionOfflineView')+ .then((module) => ({ default: module.CloudCompanionOfflineView })));/** The session id comes from the host's collection, never from an arbitrary URL. */export function RemoteBotSessionView() {@@ -18,6 +23,8 @@ export function RemoteBotSessionView() {const { t } = useTranslation();const bots = useRemoteBots();const bot = bots.find((row) => row.id === botId && row.deviceId === deviceId);+ const cloud = useCompanionCloud();+ const cloudActor = cloudCompanionAt(cloud, deviceId, botId);const [ready, setReady] = useState<(RemoteBot & { sessionId: string }) | null>(null);const [validatedSessionId, setValidatedSessionId] = useState<string | null | undefined>(null);const [failed, setFailed] = useState(false);@@ -87,6 +94,25 @@ export function RemoteBotSessionView() {}}, [bot, failed, ready, validatedSessionId]);+ // Its main computer is offline (or never reachable here): read the cloud conversation+ // and offer to continue on this computer instead of a stale read-only mirror.+ if (cloudActor && deviceId && botId && cloudActor.homeDeviceId !== cloud.selfDeviceId+ && (!bot || (!bot.online && bot.connectionKnown !== false))) {+ return (+ <Suspense fallback={<main className="flex h-full items-center justify-center bg-[var(--surface)]"><Spinner size={18} /></main>}>+ <CloudCompanionOfflineView+ key={`${deviceId}:${botId}`}+ botId={botId}+ deviceId={deviceId}+ name={bot?.name || cloudActor.name}+ avatar={bot?.avatar || cloudActor.avatar}+ avatarColor={bot?.avatarColor}+ deviceName={bot?.deviceName || cloudActor.homeDevice?.name || ''}+ reachable={!bot && cloudActor.homeDevice?.online === true}+ />+ </Suspense>+ );+ }if (bot && !failed && ready?.sessionId && ready.id === botId && ready.deviceId === deviceId) {return (<CCAgentSessionViewdiff --git a/apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsx b/apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsxindex 9ff44ac70d..4c652a34ab 100644--- a/apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsx+++ b/apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsx@@ -28,6 +28,8 @@ import { BotAvatar } from './BotAvatar';import { isManagedBotAvatarUrl, isSupportedBotAvatarValue } from '../../../shared/botAvatarValue';import { rewriteToRemoteMediaOrigin } from '../../../shared/remoteMediaUrl';import type { RemoteBot } from './remoteBotRoster';+import { useCompanionCloud } from './companionCloudStore';+import { cloudCompanionAt } from './companionCloudPresentation';import {readRemoteBotSettings,readRemoteBotModelChain,@@ -56,6 +58,8 @@ export function RemoteBotSettings(props: Props) {}function RemoteBotSettingsContent({ bot, beforeCloseRef, onDeleted, initialPage = 'home' }: Props) {const { t, i18n } = useTranslation();+ // Read-only here: the main computer is changed from that computer's own settings.+ const homeActor = cloudCompanionAt(useCompanionCloud(), bot.deviceId, bot.id);const { confirm } = useConfirmDialog();const [data, setData] = useState<RemoteBotSettingsData | null>(null);const [resourceId, setResourceId] = useState(initialPage === 'memory' ? `settings:${bot.id}/memory` : initialPage === 'capabilities' ? `settings:${bot.id}/connections` : bot.id);@@ -574,7 +578,9 @@ function RemoteBotSettingsContent({ bot, beforeCloseRef, onDeleted, initialPageconst panels = data?.panels ?? [];return (<div className="min-h-0 flex-1 overflow-y-auto p-5 text-[var(--text-primary)]">- <p className="mb-4 truncate text-12 text-[var(--text-tertiary)]">{bot.deviceName}</p>+ <p className="mb-4 truncate text-12 text-[var(--text-tertiary)]">+ {homeActor ? t('bots.cloud.homeReadOnly', { device: homeActor.homeDevice?.name?.trim() || bot.deviceName }) : bot.deviceName}+ </p>{page || resourceId !== bot.id ? (<Buttonvariant="secondary"diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botSessionRead.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/botSessionRead.test.tsxindex 27638eda71..d3512a5220 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/botSessionRead.test.tsx+++ b/apps/desktop/src/renderer/features/bots/__tests__/botSessionRead.test.tsx@@ -13,16 +13,19 @@ const mocks = vi.hoisted(() => ({navigate: vi.fn(),read: undefined as undefined | ((at: number) => void),params: { botId: 'bot-1', sessionId: 'session-1' } as Record<string, string | undefined>,+ demoted: [] as string[],}));+vi.mock('../companionCloudStore', () => ({ useCompanionCloud: () => ({ enabled: false, selfDeviceId: null, humanActorId: null, actors: [], demotedBotIds: mocks.demoted }) }));+vi.mock('../CompanionShadowBanner', () => ({ CompanionShadowBanner: ({ botId }: { botId: string }) => <div data-testid="shadow-banner">{botId}</div> }));vi.mock('react-router-dom', () => ({useNavigate: () => mocks.navigate,useParams: () => mocks.params,}));vi.mock('@/features/cc-agent/CCAgentSessionView', () => ({- CCAgentSessionView: ({ botUnreadBoundaryAt, onBotReadThrough }: { botUnreadBoundaryAt?: number | null; onBotReadThrough?: (at: number) => void }) => {+ CCAgentSessionView: ({ botUnreadBoundaryAt, onBotReadThrough, readOnly }: { botUnreadBoundaryAt?: number | null; onBotReadThrough?: (at: number) => void; readOnly?: boolean }) => {mocks.read = onBotReadThrough;- return <div data-testid="chat" data-unread-boundary={botUnreadBoundaryAt ?? ''} />;+ return <div data-testid="chat" data-unread-boundary={botUnreadBoundaryAt ?? ''} data-readonly={readOnly ? 'yes' : 'no'} />;},}));@@ -73,6 +76,7 @@ beforeEach(() => {resetBotReadStateForTests();setBotReadStateOwner('owner-1');mocks.params = { botId: 'bot-1', sessionId: 'session-1' };+ mocks.demoted = [];vi.useFakeTimers({ toFake: ['Date'] });vi.setSystemTime(10_000);installElectronApi(readyBot);@@ -123,3 +127,20 @@ describe('Bot conversation read position', () => {expect(getBotLastReadAt('bot-1')).toBeNull();});});++describe('a demoted copy', () => {+ it('shows the main-computer banner and keeps the main task read only', async () => {+ mocks.demoted = ['bot-1'];+ const view = render(<BotSessionView />);+ await waitFor(() => expect(view.getByTestId('chat')).toBeTruthy());+ expect(view.getByTestId('shadow-banner').textContent).toBe('bot-1');+ expect(view.getByTestId('chat').getAttribute('data-readonly')).toBe('yes');+ });++ it('keeps an ordinary companion writable', async () => {+ const view = render(<BotSessionView />);+ await waitFor(() => expect(view.getByTestId('chat')).toBeTruthy());+ expect(view.queryByTestId('shadow-banner')).toBeNull();+ expect(view.getByTestId('chat').getAttribute('data-readonly')).toBe('no');+ });+});diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botSettingsDrawer.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/botSettingsDrawer.test.tsxindex 0ce088e0a7..36e397d90d 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/botSettingsDrawer.test.tsx+++ b/apps/desktop/src/renderer/features/bots/__tests__/botSettingsDrawer.test.tsx@@ -71,6 +71,12 @@ vi.mock('../BotsHomeView', async () => {};});+const cloud = vi.hoisted(() => ({ demotedBotIds: [] as string[] }));+vi.mock('../companionCloudStore', () => ({+ useCompanionCloud: () => ({ enabled: true, selfDeviceId: 'desk', humanActorId: 'human', actors: [], demotedBotIds: cloud.demotedBotIds }),+}));+beforeEach(() => { cloud.demotedBotIds = []; });+import { BotSettingsDrawer } from '../BotSettingsDrawer';function LocationProbe() {@@ -87,6 +93,16 @@ afterEach(() => {});describe('BotSettingsDrawer', () => {+ it('does not open editable settings for a copy demoted to another computer', async () => {+ cloud.demotedBotIds = ['bot-1'];+ const router = createMemoryRouter([{ path: '*', element: <BotSettingsDrawer /> }],+ { initialEntries: ['/bots/bot-1?settings=1'] });+ render(<RouterProvider router={router} />);+ await act(async () => { await Promise.resolve(); });+ expect(screen.queryByTestId('simple-bot-settings')).toBeNull();+ expect(screen.queryByRole('dialog')).toBeNull();+ });+it.each(['query', 'sidebar', 'back'])('protects drafts when %s navigation removes settings',async (kind) => {diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botsSidebar.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/botsSidebar.test.tsxindex 8c305857d8..29c497bfa6 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/botsSidebar.test.tsx+++ b/apps/desktop/src/renderer/features/bots/__tests__/botsSidebar.test.tsx@@ -44,7 +44,9 @@ const mocks = vi.hoisted(() => ({registered: { node: null as ReactNode },/** 灵动岛活动镜像:sessionId -> phase。侧栏据此显示「正在输入…」。 */islandActivity: new Map<string, { sessionId: string; phase: string; compactDetail?: string }>(),+ cloud: { enabled: false, selfDeviceId: null, humanActorId: null, actors: [], demotedBotIds: [] } as import('../../../../shared/companionCloud').CompanionCloudSnapshot,}));+vi.mock('../companionCloudStore', () => ({ useCompanionCloud: () => mocks.cloud }));vi.mock('../useRemoteBots', () => ({ useRemoteBots: () => mocks.remoteBots }));vi.mock('@/features/device-link/useDeviceLinkDeviceList', () => ({@@ -157,6 +159,7 @@ beforeEach(() => {mocks.devices = [];mocks.registered.node = null;mocks.islandActivity = new Map();+ mocks.cloud = { enabled: false, selfDeviceId: null, humanActorId: null, actors: [], demotedBotIds: [] };Object.defineProperty(window, 'electronAPI', {configurable: true,writable: true,@@ -784,3 +787,37 @@ describe('BotsSidebar rows', () => {expect(mocks.refreshBotProfiles).toHaveBeenCalledTimes(1);});});++describe('cloud companions in the roster', () => {+ it('hides demoted local copies and lists companions homed on a computer never seen here', async () => {+ mocks.profiles = [bot({ id: 'mia', name: 'Mia' }), bot({ id: 'ada', name: 'Ada' })];+ mocks.cloud = {+ enabled: true, selfDeviceId: 'desk', humanActorId: 'human', demotedBotIds: ['mia'],+ actors: [+ { id: 'a-mia', externalId: 'mia', name: 'Mia', avatar: null, homeDeviceId: 'laptop',+ homeDevice: { deviceId: 'laptop', name: 'Laptop', online: false, isSelf: false } },+ { id: 'a-ada', externalId: 'ada', name: 'Ada', avatar: null, homeDeviceId: 'desk' },+ ],+ };+ await renderSidebar();+ expect(screen.getByText('Ada')).toBeTruthy();+ const rows = screen.getAllByText('Mia');+ expect(rows).toHaveLength(1);+ const row = rows[0]!.closest('button')!;+ expect(row.textContent).toContain('bots.cloud.homeOfflineShort');+ fireEvent.click(row);+ expect(mocks.navigate).toHaveBeenCalledWith('/bots/remote/laptop/mia');+ });++ it('does not offer a demoted local Cindy as the local option', async () => {+ mocks.profiles = [bot({ id: 'cindy-default', name: 'Cindy', lastMessagePreview: 'Local preview' })];+ mocks.remoteBots = [{ id: 'cindy-default', deviceId: 'laptop', deviceName: 'Laptop', name: 'Cindy', avatar: '🤖',+ avatarColor: 'violet', description: '', preview: 'Laptop preview', activityAt: 1, sessionId: 'laptop-chat', online: true }];+ mocks.cloud = { enabled: true, selfDeviceId: 'desk', humanActorId: 'human', demotedBotIds: ['cindy-default'],+ actors: [{ id: 'a-cindy', externalId: 'cindy-default', name: 'Cindy', avatar: null, homeDeviceId: 'laptop' }] };+ await renderSidebar();+ expect(screen.queryByText('Local preview')).toBeNull();+ expect(screen.queryByTestId('cindy-device-row')).toBeNull();+ expect(screen.getByText('Laptop preview')).toBeTruthy();+ });+});diff --git a/apps/desktop/src/renderer/features/bots/__tests__/companionCloudUi.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/companionCloudUi.test.tsxnew file mode 100644index 0000000000..bd43237906--- /dev/null+++ b/apps/desktop/src/renderer/features/bots/__tests__/companionCloudUi.test.tsx@@ -0,0 +1,242 @@+// @vitest-environment jsdom+import { act, cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import type { CompanionCloudSnapshot } from '../../../../shared/companionCloud';++const h = vi.hoisted(() => ({+ navigate: vi.fn(),+ toast: vi.fn(),+ ensureLoaded: vi.fn(async () => []),+ devices: [{ deviceId: 'tablet', name: 'Tablet', isSelf: false }],+}));+vi.mock('react-router-dom', () => ({ useNavigate: () => h.navigate }));+vi.mock('react-i18next', () => ({+ useTranslation: () => ({ t: (key: string, opts?: Record<string, unknown>) => opts ? `${key}:${JSON.stringify(opts)}` : key }),+}));+vi.mock('@/components/chat/MarkdownRenderer', () => ({ MarkdownRenderer: ({ content }: { content: string }) => <div>{content}</div> }));+vi.mock('../BotSessionContentHeader', () => ({ BotSessionContentHeaderRegistration: () => null }));+vi.mock('../BotAvatar', () => ({ BotAvatar: () => <span /> }));+vi.mock('../botStore', () => ({ ensureBotProfilesLoaded: h.ensureLoaded }));+vi.mock('@/features/device-link/useDeviceLinkDeviceList', () => ({ useDeviceLinkDeviceList: () => h.devices }));+vi.mock('@/lib/toast', () => ({ toast: { info: h.toast, error: h.toast } }));++import { CloudCompanionOfflineView } from '../CloudCompanionOfflineView';+import { BotHomeComputerSetting } from '../BotHomeComputerSetting';+import { resetCompanionCloudStoreForTests, useCompanionCloud } from '../companionCloudStore';+import { cloudOnlyRemoteBots, cloudRemoteBots, isCloudHomeOffline, withoutShadowedBots } from '../companionCloudPresentation';+import { BotConnectionStatus } from '../BotConnectionStatus';++const maker = {+ getCompanionCloudState: vi.fn(),+ onCompanionCloudChanged: vi.fn(() => () => undefined),+ getCompanionTranscript: vi.fn(),+ takeOverCompanion: vi.fn(),+ listCompanionTransferTargets: vi.fn(),+ transferCompanion: vi.fn(),+};++const snapshot = (home: string | null, enabled = true): CompanionCloudSnapshot => ({+ enabled, selfDeviceId: 'desk', humanActorId: 'human', demotedBotIds: [],+ actors: [{ id: 'a-mia', externalId: 'mia', name: 'Mia', avatar: null, homeDeviceId: home,+ homeDevice: home ? { deviceId: home, name: home === 'desk' ? 'Desk' : 'Laptop', online: false, isSelf: home === 'desk' } : null }],+});++beforeEach(() => {+ for (const fn of Object.values(maker)) fn.mockReset();+ maker.onCompanionCloudChanged.mockImplementation(() => () => undefined);+ h.navigate.mockReset();+ h.toast.mockReset();+ Object.defineProperty(window, 'electronAPI', { configurable: true, writable: true, value: { maker } });+});+afterEach(() => { cleanup(); });++describe('presentation helpers', () => {+ it('hides demoted copies and adds unseen cloud homes as offline rows', () => {+ const cloud = { ...snapshot('laptop'), demotedBotIds: ['mia'] };+ expect(withoutShadowedBots([{ id: 'mia' }, { id: 'ada' }], cloud)).toEqual([{ id: 'ada' }]);+ // Persisted demotion holds with the feature off or the server unreachable.+ expect(withoutShadowedBots([{ id: 'mia' }], { ...cloud, enabled: false })).toEqual([]);+ const extra = cloudOnlyRemoteBots(cloud, []);+ expect(extra).toMatchObject([{ id: 'mia', deviceId: 'laptop', deviceName: 'Laptop', online: false }]);+ expect(cloudOnlyRemoteBots(cloud, extra)).toEqual([]);+ expect(isCloudHomeOffline(cloud, extra[0])).toBe(true);+ expect(isCloudHomeOffline(cloud, { ...extra[0]!, online: true })).toBe(false);+ expect(isCloudHomeOffline(snapshot('desk'), { id: 'mia', deviceId: 'desk', online: false })).toBe(false);+ });++ it('lists a companion once, on its main computer, dropping old computers\' cached copies', () => {+ const row = (deviceId: string, id = 'mia') => ({ id, deviceId, deviceName: deviceId, name: id, avatar: '', avatarColor: 'violet',+ description: '', preview: '', activityAt: 0, sessionId: null, online: false, connectionKnown: true }) as const;+ // The old computer is offline and only its cached row is left: replaced by the main computer's row.+ expect(cloudRemoteBots(snapshot('laptop'), [row('old-mac'), row('old-mac', 'ada')]).map((bot) => `${bot.deviceId}/${bot.id}`))+ .toEqual(['old-mac/ada', 'laptop/mia']);+ expect(cloudRemoteBots(snapshot('laptop'), [row('old-mac'), row('laptop')]).map((bot) => bot.deviceId)).toEqual(['laptop']);+ // Homed here: other computers' copies are not separate entries.+ expect(cloudRemoteBots(snapshot('desk'), [row('old-mac')])).toEqual([]);+ expect(cloudRemoteBots(snapshot('laptop', false), [row('old-mac')])).toHaveLength(1);+ });++ it('labels an offline main computer in the row status', () => {+ render(<BotConnectionStatus inline online={false} homeOffline deviceName="Laptop" />);+ expect(screen.getByText('bots.cloud.homeOfflineShort · Laptop')).toBeTruthy();+ });+});++describe('CloudCompanionOfflineView', () => {+ const page = { messages: [+ { id: 'm1', seq: '1', role: 'user', text: 'hello', createdAt: 1 },+ { id: 'm2', seq: '2', role: 'assistant', text: 'hi there', createdAt: 2 },+ ] };+ const renderView = () => render(<CloudCompanionOfflineView botId="mia" deviceId="laptop" name="Mia" deviceName="Laptop" />);++ it('shows the banner and the read-only cloud conversation, oldest first', async () => {+ maker.getCompanionTranscript.mockResolvedValue(page);+ renderView();+ expect(screen.getByText('bots.cloud.homeOffline:{"device":"Laptop"}')).toBeTruthy();+ await waitFor(() => expect(screen.getByText('hi there')).toBeTruthy());+ const texts = [...document.querySelectorAll('article')].map((node) => node.textContent);+ expect(texts).toEqual(['hello', 'hi there']);+ expect(maker.getCompanionTranscript).toHaveBeenCalledWith('mia', undefined);+ expect(screen.getByText('bots.cloud.readOnlyNote')).toBeTruthy();+ });++ it('loads older messages on request', async () => {+ maker.getCompanionTranscript.mockResolvedValueOnce({ ...page, nextBefore: '1' })+ .mockResolvedValueOnce({ messages: [{ id: 'm0', seq: '0', role: 'user', text: 'earlier', createdAt: 0 }] });+ renderView();+ await waitFor(() => expect(screen.getByText('bots.cloud.loadOlder')).toBeTruthy());+ fireEvent.click(screen.getByText('bots.cloud.loadOlder'));+ await waitFor(() => expect(screen.getByText('earlier')).toBeTruthy());+ expect(maker.getCompanionTranscript).toHaveBeenLastCalledWith('mia', '1');+ expect([...document.querySelectorAll('article')].map((node) => node.textContent)).toEqual(['earlier', 'hello', 'hi there']);+ });++ it('continues on this computer and opens the local companion', async () => {+ maker.getCompanionTranscript.mockResolvedValue(page);+ let finish!: (value: unknown) => void;+ maker.takeOverCompanion.mockReturnValue(new Promise((resolve) => { finish = resolve; }));+ renderView();+ fireEvent.click(screen.getByText('bots.cloud.continueHere'));+ await waitFor(() => expect(screen.getByText('bots.cloud.takingOver:{"name":"Mia"}')).toBeTruthy());+ await act(async () => { finish({ ok: true }); });+ await waitFor(() => expect(h.navigate).toHaveBeenCalledWith('/bots/mia'));+ expect(maker.takeOverCompanion).toHaveBeenCalledWith('mia');+ expect(h.ensureLoaded).toHaveBeenCalledWith(true);+ });++ it('follows the companion when another computer already continued', async () => {+ maker.getCompanionTranscript.mockResolvedValue(page);+ maker.takeOverCompanion.mockResolvedValue({ ok: false, code: 'HOME_CONFLICT', homeDeviceId: 'tablet' });+ renderView();+ fireEvent.click(screen.getByText('bots.cloud.continueHere'));+ await waitFor(() => expect(h.navigate).toHaveBeenCalledWith('/bots/remote/tablet/mia'));+ expect(h.toast).toHaveBeenCalledWith('bots.cloud.takeOverConflict:{"name":"Mia","device":"Tablet"}');+ });++ it('explains a failed take-over inline and lets the user try again', async () => {+ maker.getCompanionTranscript.mockResolvedValue(page);+ maker.takeOverCompanion.mockResolvedValueOnce({ ok: false, code: 'OFFLINE' }).mockResolvedValueOnce({ ok: true });+ renderView();+ fireEvent.click(screen.getByText('bots.cloud.continueHere'));+ await waitFor(() => expect(screen.getByText('bots.cloud.takeOverOffline:{"name":"Mia"}')).toBeTruthy());+ expect(h.navigate).not.toHaveBeenCalled();+ fireEvent.click(screen.getByText('bots.cloud.continueHere'));+ await waitFor(() => expect(h.navigate).toHaveBeenCalledWith('/bots/mia'));+ });+});++describe('BotHomeComputerSetting', () => {+ const bot = { id: 'mia', name: 'Mia' };+ const openMenu = () => fireEvent.keyDown(screen.getByTestId('bot-home-computer-row'), { key: 'ArrowDown' });++ it.each([+ ['the feature is off', snapshot('desk', false)],+ ['the home is another computer', snapshot('laptop')],+ ])('is hidden when %s', (_name, cloud) => {+ resetCompanionCloudStoreForTests(cloud);+ maker.getCompanionCloudState.mockResolvedValue(cloud);+ render(<BotHomeComputerSetting bot={bot} />);+ expect(screen.queryByTestId('bot-home-computer-row')).toBeNull();+ });++ it('confirms before moving the companion, then opens it on the new computer', async () => {+ resetCompanionCloudStoreForTests(snapshot('desk'));+ maker.getCompanionCloudState.mockResolvedValue(snapshot('desk'));+ maker.listCompanionTransferTargets.mockResolvedValue([{ deviceId: 'laptop', name: 'Laptop', online: true }]);+ maker.transferCompanion.mockResolvedValue({ ok: true });+ render(<BotHomeComputerSetting bot={bot} />);+ expect(screen.getByText('bots.cloud.thisComputer')).toBeTruthy();+ openMenu();+ const item = await screen.findByText('bots.cloud.moveTo:{"device":"Laptop"}');+ fireEvent.click(item);+ await screen.findByText('bots.cloud.transferDescription:{"name":"Mia","device":"Laptop"}');+ expect(maker.transferCompanion).not.toHaveBeenCalled();+ fireEvent.click(screen.getByRole('button', { name: 'bots.cloud.transferAction:{"device":"Laptop"}' }));+ await waitFor(() => expect(h.navigate).toHaveBeenCalledWith('/bots/remote/laptop/mia'));+ expect(maker.transferCompanion).toHaveBeenCalledWith('mia', 'laptop');+ });++ it('shows why a move did not happen', async () => {+ resetCompanionCloudStoreForTests(snapshot('desk'));+ maker.getCompanionCloudState.mockResolvedValue(snapshot('desk'));+ maker.listCompanionTransferTargets.mockResolvedValue([{ deviceId: 'laptop', name: 'Laptop', online: true }]);+ maker.transferCompanion.mockResolvedValue({ ok: false, code: 'OFFLINE' });+ render(<BotHomeComputerSetting bot={bot} />);+ openMenu();+ fireEvent.click(await screen.findByText('bots.cloud.moveTo:{"device":"Laptop"}'));+ fireEvent.click(await screen.findByRole('button', { name: 'bots.cloud.transferAction:{"device":"Laptop"}' }));+ expect(await screen.findByRole('alert')).toHaveProperty('textContent', 'bots.cloud.transferOffline:{"name":"Mia","device":"Laptop"}');+ expect(h.navigate).not.toHaveBeenCalled();+ });++ it('asks to resume a paused companion before moving it', async () => {+ resetCompanionCloudStoreForTests(snapshot('desk'));+ maker.getCompanionCloudState.mockResolvedValue(snapshot('desk'));+ render(<BotHomeComputerSetting bot={{ ...bot, status: 'paused' }} />);+ openMenu();+ expect(await screen.findByText('bots.cloud.resumeToMove:{"name":"Mia"}')).toBeTruthy();+ expect(maker.listCompanionTransferTargets).not.toHaveBeenCalled();+ });++ it('says when no other computer can take over', async () => {+ resetCompanionCloudStoreForTests(snapshot('desk'));+ maker.getCompanionCloudState.mockResolvedValue(snapshot('desk'));+ maker.listCompanionTransferTargets.mockResolvedValue([]);+ render(<BotHomeComputerSetting bot={bot} />);+ openMenu();+ expect(await screen.findByText('bots.cloud.noTargets')).toBeTruthy();+ });+});++describe('companionCloudStore', () => {+ it('keeps a newer push when an older refresh answers later', async () => {+ const { renderHook } = await import('@testing-library/react');+ resetCompanionCloudStoreForTests(snapshot('desk'));+ let answer: (value: CompanionCloudSnapshot) => void = () => undefined;+ maker.getCompanionCloudState.mockReturnValue(new Promise(resolve => { answer = resolve; }));+ let push: (next: CompanionCloudSnapshot) => void = () => undefined;+ maker.onCompanionCloudChanged.mockImplementation(((listener: typeof push) => { push = listener; return () => undefined; }) as never);+ const { result, unmount } = renderHook(() => useCompanionCloud());+ await waitFor(() => expect(maker.getCompanionCloudState).toHaveBeenCalled());+ act(() => push(snapshot('laptop')));+ await act(async () => { answer(snapshot('desk')); await Promise.resolve(); });+ expect(result.current.actors[0]!.homeDeviceId).toBe('laptop');+ unmount();+ });+});++describe('CompanionShadowBanner', () => {+ it('opens the companion on its main computer or takes it over here', async () => {+ const { CompanionShadowBanner } = await import('../CompanionShadowBanner');+ resetCompanionCloudStoreForTests(snapshot('laptop'));+ maker.getCompanionCloudState.mockResolvedValue(snapshot('laptop'));+ maker.takeOverCompanion.mockResolvedValue({ ok: true });+ render(<CompanionShadowBanner botId="mia" name="Mia" />);+ expect(screen.getByText('bots.cloud.shadowTitle:{"device":"Laptop"}')).toBeTruthy();+ fireEvent.click(screen.getByText('bots.cloud.openOnHome:{"device":"Laptop"}'));+ expect(h.navigate).toHaveBeenCalledWith('/bots/remote/laptop/mia');+ fireEvent.click(screen.getByText('bots.cloud.continueHere'));+ await waitFor(() => expect(maker.takeOverCompanion).toHaveBeenCalledWith('mia'));+ await waitFor(() => expect(h.ensureLoaded).toHaveBeenCalledWith(true));+ });+});diff --git a/apps/desktop/src/renderer/features/bots/__tests__/remoteBotSession.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/remoteBotSession.test.tsxindex 6cce91c869..88b610df98 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/remoteBotSession.test.tsx+++ b/apps/desktop/src/renderer/features/bots/__tests__/remoteBotSession.test.tsx@@ -10,6 +10,12 @@ const h = vi.hoisted(() => ({view: vi.fn(),online: true,lastReplyAt: 0,+ cloud: { enabled: false, selfDeviceId: null, humanActorId: null, actors: [], demotedBotIds: [] } as import('../../../../shared/companionCloud').CompanionCloudSnapshot,+ cloudView: vi.fn(),+}));+vi.mock('../companionCloudStore', () => ({ useCompanionCloud: () => h.cloud }));+vi.mock('../CloudCompanionOfflineView', () => ({+ CloudCompanionOfflineView: (props: unknown) => { h.cloudView(props); return <div>cloud-offline-view</div>; },}));vi.mock('react-router-dom', () => ({ useParams: () => ({ deviceId: 'home', botId: 'writer' }) }));vi.mock('react-i18next', () => ({ useTranslation: () => ({ t: (key: string) => key }) }));@@ -49,6 +55,8 @@ beforeEach(() => {h.markRead.mockClear();h.online = true;h.lastReplyAt = 0;+ h.cloud = { enabled: false, selfDeviceId: null, humanActorId: null, actors: [], demotedBotIds: [] };+ h.cloudView.mockReset();h.pin.mockReset();h.merge.mockReset();h.view.mockReset();@@ -110,3 +118,17 @@ it('never mounts a task with a mismatched authoritative source', async () => {await screen.findByText('bots.sessionLoadFailedDescription');expect(h.view).not.toHaveBeenCalled();});+it('shows the cloud conversation instead of a stale mirror when the main computer is offline', async () => {+ h.cloud = { enabled: true, selfDeviceId: 'desk', humanActorId: 'human', demotedBotIds: [], actors: [+ { id: 'a-writer', externalId: 'writer', name: 'Writer', avatar: null, homeDeviceId: 'home' }] };+ const { rerender } = render(<RemoteBotSessionView />);+ await screen.findByText('remote-conversation');+ h.online = false;+ rerender(<RemoteBotSessionView />);+ await screen.findByText('cloud-offline-view');+ expect(h.cloudView).toHaveBeenLastCalledWith(expect.objectContaining({ botId: 'writer', deviceId: 'home', name: 'Writer', deviceName: 'Home' }));+ // Another computer as the cloud home keeps the existing offline behaviour.+ h.cloud = { ...h.cloud, actors: [{ ...h.cloud.actors[0]!, homeDeviceId: 'elsewhere' }] };+ rerender(<RemoteBotSessionView />);+ await waitFor(() => expect(h.view).toHaveBeenLastCalledWith(expect.objectContaining({ readOnly: true })));+});diff --git a/apps/desktop/src/renderer/features/bots/companionCloudPresentation.ts b/apps/desktop/src/renderer/features/bots/companionCloudPresentation.tsnew file mode 100644index 0000000000..975d1b362f--- /dev/null+++ b/apps/desktop/src/renderer/features/bots/companionCloudPresentation.ts@@ -0,0 +1,69 @@+import type { CompanionCloudActor, CompanionCloudSnapshot } from '../../../shared/companionCloud';+import type { RemoteBot } from './remoteBotRoster';++/**+ * Local copies whose home moved to another computer stay out of the roster and entry choice.+ * The shadow list is persisted in main, so it applies offline and with the feature off too.+ */+export function withoutShadowedBots<T extends { id: string }>(bots: readonly T[], cloud: CompanionCloudSnapshot): T[] {+ if (cloud.demotedBotIds.length === 0) return [...bots];+ const shadowed = new Set(cloud.demotedBotIds);+ return bots.filter((bot) => !shadowed.has(bot.id));+}++/** The cloud companion whose home is `deviceId`, when the feature is on. */+export function cloudCompanionAt(cloud: CompanionCloudSnapshot, deviceId: string | undefined, botId: string | undefined): CompanionCloudActor | null {+ if (!cloud.enabled || !deviceId || !botId) return null;+ return cloud.actors.find((actor) => actor.externalId === botId && actor.homeDeviceId === deviceId) ?? null;+}++/** A remote companion whose home computer cannot be reached right now. */+export function isCloudHomeOffline(cloud: CompanionCloudSnapshot, bot: Pick<RemoteBot, 'id' | 'deviceId' | 'online'> | undefined, deviceId?: string, botId?: string): boolean {+ const actor = cloudCompanionAt(cloud, bot?.deviceId ?? deviceId, bot?.id ?? botId);+ if (!actor || actor.homeDeviceId === cloud.selfDeviceId) return false;+ return !bot?.online;+}++/**+ * Companions homed on a computer this device never listed (e.g. it was never online+ * here): still reachable as offline remote rows, so the cloud conversation can open.+ */+export function cloudOnlyRemoteBots(cloud: CompanionCloudSnapshot, remoteBots: readonly RemoteBot[]): RemoteBot[] {+ if (!cloud.enabled) return [];+ return cloud.actors.flatMap((actor) => {+ const home = actor.homeDeviceId;+ if (!home || home === cloud.selfDeviceId) return [];+ if (remoteBots.some((bot) => bot.deviceId === home && bot.id === actor.externalId)) return [];+ return [{+ id: actor.externalId,+ deviceId: home,+ deviceName: actor.homeDevice?.name ?? '',+ name: actor.name,+ avatar: actor.avatar ?? '',+ avatarColor: 'violet',+ description: '',+ preview: '',+ activityAt: 0,+ sessionId: null,+ online: false,+ connectionKnown: true,+ }];+ });+}++/**+ * One row per cloud companion: rows another computer still lists for a companion whose home is+ * known to be elsewhere (old copies, possibly cached while that computer is offline) are+ * dropped, and companions homed on a computer never listed here get an offline row.+ */+export function cloudRemoteBots(cloud: CompanionCloudSnapshot, remoteBots: readonly RemoteBot[]): RemoteBot[] {+ if (!cloud.enabled) return [...remoteBots];+ const homes = new Map(cloud.actors.flatMap((actor) => actor.homeDeviceId ? [[actor.externalId, actor.homeDeviceId] as const] : []));+ const listed = remoteBots.filter((bot) => { const home = homes.get(bot.id); return !home || home === bot.deviceId; });+ return [...listed, ...cloudOnlyRemoteBots(cloud, listed)];+}++export function homeDeviceName(cloud: CompanionCloudSnapshot, botId: string, fallback: string): string {+ const actor = cloud.actors.find((candidate) => candidate.externalId === botId);+ return actor?.homeDevice?.name?.trim() || fallback;+}diff --git a/apps/desktop/src/renderer/features/bots/companionCloudStore.ts b/apps/desktop/src/renderer/features/bots/companionCloudStore.tsnew file mode 100644index 0000000000..7d38af95d9--- /dev/null+++ b/apps/desktop/src/renderer/features/bots/companionCloudStore.ts@@ -0,0 +1,100 @@+/**+ * Renderer mirror of where each companion runs (docs/product-rules/cloud-companions.md).+ * Main owns the truth; this keeps the latest snapshot, re-reads on owner change and+ * follows `onCompanionCloudChanged`. Old-owner responses and pushes are dropped, and so is a+ * refresh answered after a newer push.+ */+import { useEffect, useSyncExternalStore } from 'react';++import {+ getDataOwnerGeneration,+ isDataOwnerGenerationCurrent,+ isDataOwnerPushCurrent,+} from '@/contexts/dataOwnerGeneration';+import {+ EMPTY_COMPANION_CLOUD_SNAPSHOT,+ type CompanionCloudSnapshot,+} from '../../../shared/companionCloud';++type MakerApi = Window['electronAPI']['maker'];++let snapshot: CompanionCloudSnapshot = EMPTY_COMPANION_CLOUD_SNAPSHOT;+let owner = getDataOwnerGeneration();+// Counts pushes: a refresh answered after a push may carry the older snapshot.+let pushes = 0;+let users = 0;+let unsubscribePush: (() => void) | null = null;+const listeners = new Set<() => void>();++export function companionCloudApi(): MakerApi | null {+ if (typeof window === 'undefined') return null;+ const maker = window.electronAPI?.maker;+ return maker && typeof maker.getCompanionCloudState === 'function' ? maker : null;+}++function apply(next: CompanionCloudSnapshot): void {+ snapshot = next;+ for (const listener of listeners) listener();+}++function ensureOwner(): void {+ if (isDataOwnerGenerationCurrent(owner)) return;+ owner = getDataOwnerGeneration();+ snapshot = EMPTY_COMPANION_CLOUD_SNAPSHOT;+}++export function refreshCompanionCloud(): void {+ ensureOwner();+ const api = companionCloudApi();+ if (!api) return;+ const requestOwner = owner;+ const requestPushes = pushes;+ void Promise.resolve().then(() => api.getCompanionCloudState()).then((next) => {+ if (isDataOwnerGenerationCurrent(requestOwner) && pushes === requestPushes && next) apply(next);+ }).catch(() => undefined);+}++function start(): () => void {+ users += 1;+ if (users === 1) {+ const api = companionCloudApi();+ if (api && typeof api.onCompanionCloudChanged === 'function') {+ unsubscribePush = api.onCompanionCloudChanged((next, ownerStamp) => {+ if (!isDataOwnerPushCurrent(ownerStamp)) return;+ ensureOwner();+ pushes += 1;+ apply(next);+ });+ }+ refreshCompanionCloud();+ }+ return () => {+ users = Math.max(0, users - 1);+ if (users === 0) {+ unsubscribePush?.();+ unsubscribePush = null;+ }+ };+}++function subscribe(listener: () => void): () => void {+ listeners.add(listener);+ return () => { listeners.delete(listener); };+}++function read(): CompanionCloudSnapshot {+ ensureOwner();+ return snapshot;+}++/** Live companion homes; inert (`enabled: false`) on servers without the feature. */+export function useCompanionCloud(): CompanionCloudSnapshot {+ useEffect(() => start(), []);+ return useSyncExternalStore(subscribe, read, read);+}++/** Test-only reset of the module mirror. */+export function resetCompanionCloudStoreForTests(next: CompanionCloudSnapshot = EMPTY_COMPANION_CLOUD_SNAPSHOT): void {+ owner = getDataOwnerGeneration();+ apply(next);+}diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.jsonindex b603997e06..6719d7e761 100644--- a/apps/desktop/src/renderer/i18n/locales/en/common.json+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json@@ -9420,6 +9420,44 @@"memory": "Remembered: {{title}}","skillCreated": "Created skill: {{title}}","skillUpdated": "Updated skill: {{title}}"+ },+ "cloud": {+ "homeLabel": "Main Computer",+ "thisComputer": "This computer",+ "homeOffline": "Main computer “{{device}}” is offline",+ "homeOfflineShort": "Main computer offline",+ "homeUnreachable": "Main computer “{{device}}” doesn’t allow remote control",+ "homeReadOnly": "Main computer: {{device}}",+ "continueHere": "Continue on This Computer",+ "takeOverHint": "{{name}} will run here from now on, and the conversation below comes along.",+ "takingOver": "Getting {{name}} ready on this computer…",+ "takeOverConflict": "{{name}} has already moved to “{{device}}”",+ "takeOverOffline": "Can’t reach the server, so {{name}} can’t continue here right now",+ "takeOverFailed": "Couldn’t take over {{name}} on this computer",+ "notEnabled": "This server doesn’t support changing the main computer",+ "readOnlyNote": "This conversation is saved in the cloud and is read only",+ "empty": "No conversation in the cloud yet",+ "loadFailed": "Couldn’t load the cloud conversation",+ "reload": "Reload Conversation",+ "loadOlder": "Load Earlier Messages",+ "unknownDevice": "another computer",+ "loadingDevices": "Loading your computers…",+ "devicesFailed": "Couldn’t load your computers",+ "noTargets": "No computer can take over. The other computer must be online, signed in to the same account, and have “Allow same-account devices to control this machine” turned on",+ "resumeToMove": "Resume {{name}} before moving it to another computer",+ "moveTo": "Move to “{{device}}”",+ "transferTitle": "Move {{name}} to “{{device}}”?",+ "transferDescription": "From now on {{name}} runs on “{{device}}”. The working directory and connections stay on this computer, and the conversation here becomes history.",+ "transferAction": "Move to “{{device}}”",+ "transferred": "{{name}} moved to “{{device}}”",+ "transferConflict": "{{name}}’s main computer has already changed, so it wasn’t moved",+ "transferOffline": "Can’t reach the server. {{name}} still runs on this computer",+ "transferBusy": "{{name}} is still working on a reply. Move it after the reply finishes",+ "transferFailed": "Couldn’t move {{name}} to “{{device}}”",+ "targetUnavailable": "“{{device}}” isn’t available. It must be online with remote control turned on",+ "shadowTitle": "This teammate now runs on “{{device}}”",+ "shadowHint": "The conversation here is read only.",+ "openOnHome": "Open on “{{device}}”"}},"common": {diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.jsonindex c506f58a24..8d0f59b802 100644--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json@@ -9383,6 +9383,44 @@"memory": "記憶しました:{{title}}","skillCreated": "スキルを作成:{{title}}","skillUpdated": "スキルを更新:{{title}}"+ },+ "cloud": {+ "homeLabel": "メインのパソコン",+ "thisComputer": "このパソコン",+ "homeOffline": "メインのパソコン「{{device}}」がオフラインです",+ "homeOfflineShort": "メインのパソコンがオフライン",+ "homeUnreachable": "メインのパソコン「{{device}}」はリモート操作を許可していません",+ "homeReadOnly": "メインのパソコン:{{device}}",+ "continueHere": "このパソコンで続ける",+ "takeOverHint": "このパソコンで続けると、{{name}} はこちらで動作し、下の会話も引き継がれます。",+ "takingOver": "このパソコンで {{name}} を準備しています…",+ "takeOverConflict": "{{name}} はすでに「{{device}}」に移っています",+ "takeOverOffline": "サーバーに接続できないため、今はこのパソコンで続けられません",+ "takeOverFailed": "このパソコンで {{name}} を引き継げませんでした",+ "notEnabled": "このサーバーはメインのパソコンの変更に対応していません",+ "readOnlyNote": "クラウドに保存された会話です。閲覧のみできます",+ "empty": "クラウドの会話はまだありません",+ "loadFailed": "クラウドの会話を読み込めませんでした",+ "reload": "会話を再読み込み",+ "loadOlder": "以前のメッセージを読み込む",+ "unknownDevice": "別のパソコン",+ "loadingDevices": "パソコンの一覧を読み込んでいます…",+ "devicesFailed": "パソコンの一覧を読み込めませんでした",+ "noTargets": "引き継げるパソコンがありません。別のパソコンがオンラインで、同じアカウントでログインし、「同一アカウントのデバイスによる操作を許可」をオンにしている必要があります",+ "resumeToMove": "{{name}} を再開してから別のパソコンに移動してください",+ "moveTo": "「{{device}}」に移す",+ "transferTitle": "{{name}} を「{{device}}」に移しますか?",+ "transferDescription": "これから {{name}} は「{{device}}」で動作します。作業ディレクトリと接続はこのパソコンに残り、このパソコンの会話は履歴になります。",+ "transferAction": "「{{device}}」に移す",+ "transferred": "{{name}} を「{{device}}」に移しました",+ "transferConflict": "{{name}} のメインのパソコンはすでに変わっているため、移しませんでした",+ "transferOffline": "サーバーに接続できません。{{name}} は引き続きこのパソコンで動作します",+ "transferBusy": "{{name}} はまだ返信中です。返信が終わってから移動してください",+ "transferFailed": "{{name}} を「{{device}}」に移せませんでした",+ "targetUnavailable": "「{{device}}」は今は使えません。オンラインでリモート操作がオンになっている必要があります",+ "shadowTitle": "この仲間は「{{device}}」で動作しています",+ "shadowHint": "ここの会話は閲覧のみできます。",+ "openOnHome": "「{{device}}」で開く"}},"common": {diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.jsonindex 85ef41627a..03ec3b2031 100644--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json@@ -9383,6 +9383,44 @@"memory": "기억했어요: {{title}}","skillCreated": "스킬 생성: {{title}}","skillUpdated": "스킬 업데이트: {{title}}"+ },+ "cloud": {+ "homeLabel": "주 컴퓨터",+ "thisComputer": "이 컴퓨터",+ "homeOffline": "주 컴퓨터 '{{device}}' 오프라인",+ "homeOfflineShort": "주 컴퓨터 오프라인",+ "homeUnreachable": "주 컴퓨터 '{{device}}'에서 원격 제어를 허용하지 않았습니다",+ "homeReadOnly": "주 컴퓨터: {{device}}",+ "continueHere": "이 컴퓨터에서 계속하기",+ "takeOverHint": "이 컴퓨터에서 계속하면 {{name}}이(가) 여기에서 실행되고 아래 대화도 함께 옮겨집니다.",+ "takingOver": "이 컴퓨터에서 {{name}}을(를) 준비하는 중…",+ "takeOverConflict": "{{name}}은(는) 이미 '{{device}}'(으)로 옮겨졌습니다",+ "takeOverOffline": "서버에 연결할 수 없어 지금은 이 컴퓨터에서 계속할 수 없습니다",+ "takeOverFailed": "이 컴퓨터에서 {{name}}을(를) 이어받지 못했습니다",+ "notEnabled": "이 서버는 주 컴퓨터 변경을 지원하지 않습니다",+ "readOnlyNote": "클라우드에 저장된 대화로, 보기만 할 수 있습니다",+ "empty": "아직 클라우드 대화가 없습니다",+ "loadFailed": "클라우드 대화를 불러오지 못했습니다",+ "reload": "대화 다시 불러오기",+ "loadOlder": "이전 메시지 불러오기",+ "unknownDevice": "다른 컴퓨터",+ "loadingDevices": "컴퓨터 목록을 불러오는 중…",+ "devicesFailed": "컴퓨터 목록을 불러오지 못했습니다",+ "noTargets": "이어받을 수 있는 컴퓨터가 없습니다. 다른 컴퓨터가 온라인 상태이고 같은 계정으로 로그인한 뒤 '동일 계정 기기의 이 컴퓨터 제어 허용'을 켜야 합니다",+ "resumeToMove": "{{name}}을(를) 다시 시작한 뒤 다른 컴퓨터로 옮겨 주세요",+ "moveTo": "'{{device}}'(으)로 옮기기",+ "transferTitle": "{{name}}을(를) '{{device}}'(으)로 옮길까요?",+ "transferDescription": "이제부터 {{name}}은(는) '{{device}}'에서 실행됩니다. 작업 디렉터리와 연결은 이 컴퓨터에 남고, 이 컴퓨터의 대화는 기록이 됩니다.",+ "transferAction": "'{{device}}'(으)로 옮기기",+ "transferred": "{{name}}을(를) '{{device}}'(으)로 옮겼습니다",+ "transferConflict": "{{name}}의 주 컴퓨터가 이미 바뀌어 옮기지 않았습니다",+ "transferOffline": "서버에 연결할 수 없습니다. {{name}}은(는) 계속 이 컴퓨터에서 실행됩니다",+ "transferBusy": "{{name}}이(가) 아직 답장 중입니다. 답장이 끝난 뒤 옮겨 주세요",+ "transferFailed": "{{name}}을(를) '{{device}}'(으)로 옮기지 못했습니다",+ "targetUnavailable": "'{{device}}'은(는) 지금 사용할 수 없습니다. 온라인 상태이고 원격 제어가 켜져 있어야 합니다",+ "shadowTitle": "이 동료는 '{{device}}'에서 실행 중입니다",+ "shadowHint": "여기 대화는 보기만 할 수 있습니다.",+ "openOnHome": "'{{device}}'에서 열기"}},"common": {diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.jsonindex f418ab0a22..5b7a1ffbcc 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json@@ -9383,6 +9383,44 @@"memory": "已记住:{{title}}","skillCreated": "已建立技能:{{title}}","skillUpdated": "已更新技能:{{title}}"+ },+ "cloud": {+ "homeLabel": "主力电脑",+ "thisComputer": "这台电脑",+ "homeOffline": "主力电脑「{{device}}」离线",+ "homeOfflineShort": "主力电脑离线",+ "homeUnreachable": "主力电脑「{{device}}」没有开放远程控制",+ "homeReadOnly": "主力电脑:{{device}}",+ "continueHere": "在这台电脑继续",+ "takeOverHint": "在这台电脑继续后,{{name}} 改在这里运行,下面的对话一起带过来。",+ "takingOver": "正在这台电脑上准备 {{name}}…",+ "takeOverConflict": "{{name}} 已经换到「{{device}}」继续了",+ "takeOverOffline": "连不上服务器,暂时无法在这台电脑继续",+ "takeOverFailed": "未能在这台电脑上接手 {{name}}",+ "notEnabled": "当前服务器不支持更换主力电脑",+ "readOnlyNote": "这里是云端保存的对话,只能查看",+ "empty": "还没有云端对话",+ "loadFailed": "未能读取云端对话",+ "reload": "重新读取对话",+ "loadOlder": "加载更早的消息",+ "unknownDevice": "另一台电脑",+ "loadingDevices": "正在读取电脑列表…",+ "devicesFailed": "未能读取电脑列表",+ "noTargets": "没有可接手的电脑。另一台电脑需要在线、登录同一账号,并开启「允许同账号设备控制本机」",+ "resumeToMove": "先恢复 {{name}},再换到另一台电脑",+ "moveTo": "交给「{{device}}」",+ "transferTitle": "把 {{name}} 交给「{{device}}」?",+ "transferDescription": "从现在起 {{name}} 在「{{device}}」上运行。工作目录和连接留在这台电脑,这台电脑上的对话变为历史记录。",+ "transferAction": "交给「{{device}}」",+ "transferred": "{{name}} 已交给「{{device}}」",+ "transferConflict": "{{name}} 的主力电脑已经变了,这次没有交出",+ "transferOffline": "连不上服务器,{{name}} 仍在这台电脑运行",+ "transferBusy": "{{name}} 还在回复,等这一轮结束再换电脑",+ "transferFailed": "未能把 {{name}} 交给「{{device}}」",+ "targetUnavailable": "「{{device}}」现在不可用,它需要在线并开启远程控制",+ "shadowTitle": "这个伙伴已在「{{device}}」上运行",+ "shadowHint": "这里的对话只能查看。",+ "openOnHome": "打开「{{device}}」上的伙伴"}},"common": {diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.jsonindex 10c19037a7..d94e6bfa4c 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json@@ -9383,6 +9383,44 @@"memory": "已記住:{{title}}","skillCreated": "已建立技能:{{title}}","skillUpdated": "已更新技能:{{title}}"+ },+ "cloud": {+ "homeLabel": "主力電腦",+ "thisComputer": "這台電腦",+ "homeOffline": "主力電腦「{{device}}」離線",+ "homeOfflineShort": "主力電腦離線",+ "homeUnreachable": "主力電腦「{{device}}」沒有開放遠端控制",+ "homeReadOnly": "主力電腦:{{device}}",+ "continueHere": "在這台電腦繼續",+ "takeOverHint": "在這台電腦繼續後,{{name}} 改在這裡執行,下面的對話一起帶過來。",+ "takingOver": "正在這台電腦上準備 {{name}}…",+ "takeOverConflict": "{{name}} 已經換到「{{device}}」繼續了",+ "takeOverOffline": "連不上伺服器,暫時無法在這台電腦繼續",+ "takeOverFailed": "未能在這台電腦上接手 {{name}}",+ "notEnabled": "目前的伺服器不支援更換主力電腦",+ "readOnlyNote": "這裡是雲端儲存的對話,只能檢視",+ "empty": "還沒有雲端對話",+ "loadFailed": "未能讀取雲端對話",+ "reload": "重新讀取對話",+ "loadOlder": "載入更早的訊息",+ "unknownDevice": "另一台電腦",+ "loadingDevices": "正在讀取電腦清單…",+ "devicesFailed": "未能讀取電腦清單",+ "noTargets": "沒有可接手的電腦。另一台電腦需要上線、登入同一帳號,並開啟「允許同帳號裝置控制本機」",+ "resumeToMove": "先恢復 {{name}},再換到另一台電腦",+ "moveTo": "交給「{{device}}」",+ "transferTitle": "把 {{name}} 交給「{{device}}」?",+ "transferDescription": "從現在起 {{name}} 在「{{device}}」上執行。工作目錄和連線留在這台電腦,這台電腦上的對話變為歷史紀錄。",+ "transferAction": "交給「{{device}}」",+ "transferred": "{{name}} 已交給「{{device}}」",+ "transferConflict": "{{name}} 的主力電腦已經變了,這次沒有交出",+ "transferOffline": "連不上伺服器,{{name}} 仍在這台電腦執行",+ "transferBusy": "{{name}} 還在回覆,等這一輪結束再換電腦",+ "transferFailed": "未能把 {{name}} 交給「{{device}}」",+ "targetUnavailable": "「{{device}}」現在無法使用,它需要上線並開啟遠端控制",+ "shadowTitle": "這個夥伴已在「{{device}}」上執行",+ "shadowHint": "這裡的對話只能檢視。",+ "openOnHome": "開啟「{{device}}」上的夥伴"}},"common": {diff --git a/apps/desktop/src/renderer/vite-env.d.ts b/apps/desktop/src/renderer/vite-env.d.tsindex 9f185b661a..ba118c3967 100644--- a/apps/desktop/src/renderer/vite-env.d.ts+++ b/apps/desktop/src/renderer/vite-env.d.ts@@ -5422,6 +5422,17 @@ interface ElectronAPI {ownerStamp?: import('../shared/dataOwnerPush').DataOwnerPushStamp,) => void,) => () => void;+ getCompanionCloudState: () => Promise<import('../shared/companionCloud').CompanionCloudSnapshot>;+ takeOverCompanion: (botId: string) => Promise<import('../shared/companionCloud').CompanionCloudActionResult>;+ transferCompanion: (botId: string, targetDeviceId: string) => Promise<import('../shared/companionCloud').CompanionCloudActionResult>;+ getCompanionTranscript: (botId: string, before?: string) => Promise<import('../shared/companionCloud').CompanionTranscriptPage>;+ listCompanionTransferTargets: () => Promise<import('../shared/companionCloud').CompanionTransferTarget[]>;+ onCompanionCloudChanged: (+ cb: (+ payload: import('../shared/companionCloud').CompanionCloudSnapshot,+ ownerStamp?: import('../shared/dataOwnerPush').DataOwnerPushStamp,+ ) => void,+ ) => () => void;onBotProfileChanged: (cb: (payload: { botId: string; change: 'created' | 'updated' }) => void,) => () => void;diff --git a/apps/desktop/src/shared/companionCloud.ts b/apps/desktop/src/shared/companionCloud.tsnew file mode 100644index 0000000000..49b1de3e9a--- /dev/null+++ b/apps/desktop/src/shared/companionCloud.ts@@ -0,0 +1,68 @@+/** Cloud companions (docs/product-rules/cloud-companions.md): which computer runs each companion. */+export interface CompanionCloudHomeDevice {+ deviceId: string;+ /** Device-link name; empty when the device is not in this account's device list. */+ name: string;+ online: boolean;+ isSelf: boolean;+}++export interface CompanionCloudActor {+ /** Chat Server actor id. */+ id: string;+ /** Local Bot profile id. */+ externalId: string;+ name: string;+ avatar: string | null;+ /** device-link deviceId of the companion's home computer; null when not registered yet. */+ homeDeviceId: string | null;+ /** Resolved home computer; only present in the renderer view (state IPC / change push). */+ homeDevice?: CompanionCloudHomeDevice | null;+}++export interface CompanionCloudSnapshot {+ /** Server supports companion homes and this login carries a device id. */+ enabled: boolean;+ selfDeviceId: string | null;+ humanActorId: string | null;+ actors: CompanionCloudActor[];+ /** Local companions whose home moved to another computer: hidden, never run here. */+ demotedBotIds: string[];+}++export const EMPTY_COMPANION_CLOUD_SNAPSHOT: CompanionCloudSnapshot = Object.freeze({+ enabled: false,+ selfDeviceId: null,+ humanActorId: null,+ actors: [],+ demotedBotIds: [],+}) as CompanionCloudSnapshot;++export type CompanionCloudFailureCode = 'HOME_CONFLICT' | 'OFFLINE' | 'NOT_ENABLED' | 'FAILED' | 'TARGET_UNAVAILABLE' | 'BUSY';++export type CompanionCloudActionResult =+ | { ok: true }+ | { ok: false; code: CompanionCloudFailureCode; homeDeviceId?: string | null };++export interface CompanionTranscriptMessage {+ /** Chat Server message id. */+ id: string;+ seq: string;+ role: 'user' | 'assistant';+ text: string;+ /** Unix ms. */+ createdAt: number;+}++export interface CompanionTranscriptPage {+ /** Oldest first. */+ messages: CompanionTranscriptMessage[];+ /** Pass back as `before` for older messages; absent at the start of the room. */+ nextBefore?: string;+}++export interface CompanionTransferTarget {+ deviceId: string;+ name: string;+ online: boolean;+}diff --git a/apps/mobile/app/companions/cloud/[actorId].tsx b/apps/mobile/app/companions/cloud/[actorId].tsxnew file mode 100644index 0000000000..013c3442e6--- /dev/null+++ b/apps/mobile/app/companions/cloud/[actorId].tsx@@ -0,0 +1,22 @@+import { useLocalSearchParams } from 'expo-router';+import { useAuth } from '@/auth/AuthContext';+import { CloudCompanionScreen } from '@/session/CloudCompanionScreen';++function firstParam(value: string | string[] | undefined): string {+ return Array.isArray(value) ? value[0] ?? '' : value ?? '';+}++/**+ * A companion whose main computer is offline (docs/product-rules/cloud-companions.md §3.1): the+ * read-only cloud conversation and「换一台电脑继续」. Opened from the teammates list; the row's+ * computer is the companion's main computer.+ */+export default function CloudCompanionRoute() {+ const params = useLocalSearchParams<{ actorId?: string | string[]; botId?: string | string[]; deviceId?: string | string[];+ deviceName?: string | string[]; title?: string | string[] }>();+ const { accountGeneration } = useAuth();+ const actorId = firstParam(params.actorId);+ const deviceId = firstParam(params.deviceId);+ return <CloudCompanionScreen key={`${accountGeneration}:${actorId}`} actorId={actorId} botId={firstParam(params.botId)}+ deviceId={deviceId} deviceName={firstParam(params.deviceName) || deviceId} title={firstParam(params.title)} />;+}diff --git a/apps/mobile/src/__tests__/TeammateHomeScreen.test.tsx b/apps/mobile/src/__tests__/TeammateHomeScreen.test.tsxindex ed78aa154a..a7cd5fed51 100644--- a/apps/mobile/src/__tests__/TeammateHomeScreen.test.tsx+++ b/apps/mobile/src/__tests__/TeammateHomeScreen.test.tsx@@ -16,6 +16,8 @@ const h = vi.hoisted(() => ({groups: { loading: false, refreshing: false, error: null as string | null, items: [] as HostedRemoteCollectionItem[], supported: false, isOnline: () => true, refresh: vi.fn() },groupTargetsSeen: [] as unknown[],create: {} as any, chrome: {} as any, titleArgs: [] as number[], nativeHeader: true, headerHeight: 106, barEdge: 'none',+ cloud: { supported: false, actors: [] as Array<{ id: string; kind: string; externalId: string; name: string; avatar: null; homeDeviceId: string | null }>,+ refresh: vi.fn(), setHome: vi.fn() },}));vi.mock('react-native', async () => {const { createElement: el } = await import('react');@@ -57,6 +59,7 @@ vi.mock('@/session/AccountSwitcherSheet', () => ({ AccountSwitcherSheet: (props:vi.mock('@/session/HomeHeaderGlassButton', () => ({ HomeHeaderGlassButton: () => null }));vi.mock('@/session/TeammateList', () => ({ TeammateList: (props: unknown) => { h.list = props; return null; } }));vi.mock('@/session/useTeammateRoster', () => ({ useTeammateRoster: () => ({ ...h.roster }) }));+vi.mock('@/chat/useCloudCompanion', () => ({ useCloudCompanionHome: () => h.cloud }));vi.mock('@/session/useBotGroupRoster', () => ({ useBotGroupRoster: (targets: unknown) => { h.groupTargetsSeen.push(targets); return h.groups; } }));vi.mock('@/session/useTeammateNavigation', async original => {const actual = await original<typeof import('@/session/useTeammateNavigation')>();@@ -90,6 +93,7 @@ beforeEach(() => {h.modeMenu = {}; h.nativeMenus = true; h.nativeHeader = true; h.headerHeight = 106; h.barEdge = 'none'; h.chrome = {};h.groups.loading = false; h.groups.refreshing = false; h.groups.error = null;h.roster.loading = false; h.roster.error = null; h.roster.isOnline.mockReturnValue(true);+ h.cloud.supported = false; h.cloud.actors = [];});afterEach(() => { act(() => root?.unmount()); root = undefined; });describe('teammate home entry', () => {@@ -212,6 +216,56 @@ describe('server groups in the actual teammate home', () => {});});+describe('cloud companions (main computer offline)', () => {+ const actorId = '00000000-0000-4000-8000-000000000001';+ const copy = (deviceId: string): HostedRemoteCollectionItem => ({ ...teammate, key: `${deviceId}:writer`, host: { deviceId, deviceName: deviceId.toUpperCase() } });+ it('opens the cloud view for an offline main computer and hides demoted copies', async () => {+ h.cloud.supported = true;+ h.cloud.actors = [{ id: actorId, kind: 'bot', externalId: 'writer', name: 'Writer', avatar: null, homeDeviceId: 'mac' }];+ h.roster.items = [teammate, copy('pc')];+ h.roster.isOnline.mockReturnValue(false);+ await render();+ expect(h.list.items.map((row: HostedRemoteCollectionItem) => row.key)).toEqual(['mac:bot']);+ expect(h.list.cloudOpenable(teammate)).toBe(true);+ expect(h.list.cloudOpenable(copy('pc'))).toBe(false);+ await act(async () => h.list.onSelect(teammate));+ expect(h.push).toHaveBeenLastCalledWith({ pathname: '/companions/cloud/[actorId]',+ params: { actorId, botId: 'writer', deviceId: 'mac', deviceName: 'Mac', title: 'Writer' } });+ expect(h.nav.openTeammate).not.toHaveBeenCalled();+ });+ it('re-reads main computers when the listed rows change and on pull-to-refresh', async () => {+ h.cloud.supported = true;+ h.cloud.refresh = vi.fn();+ h.roster.items = [teammate];+ await render();+ const afterMount = h.cloud.refresh.mock.calls.length;+ await render();+ expect(h.cloud.refresh).toHaveBeenCalledTimes(afterMount);+ // Another device moved the companion: the new main computer now lists it.+ h.roster.items = [teammate, copy('pc')];+ await render();+ expect(h.cloud.refresh).toHaveBeenCalledTimes(afterMount + 1);+ // Both computers were already cached: the new main computer re-lists the same row.+ h.roster.items = [teammate, { ...copy('pc'), item: { ...copy('pc').item, revision: 'taken-over' } }];+ await render();+ expect(h.cloud.refresh).toHaveBeenCalledTimes(afterMount + 2);+ await act(async () => h.list.onRefresh());+ expect(h.cloud.refresh).toHaveBeenCalledTimes(afterMount + 3);+ });+ it('keeps the per-computer behavior on an older server or an online computer', async () => {+ h.cloud.actors = [{ id: actorId, kind: 'bot', externalId: 'writer', name: 'Writer', avatar: null, homeDeviceId: 'mac' }];+ h.roster.items = [teammate, copy('pc')];+ h.roster.isOnline.mockReturnValue(false);+ await render();+ expect(h.list.items).toHaveLength(2);+ expect(h.list.cloudOpenable(teammate)).toBe(false);+ h.cloud.supported = true; h.roster.isOnline.mockReturnValue(true);+ await render();+ await act(async () => h.list.onSelect(teammate));+ expect(h.nav.openTeammate).toHaveBeenCalledExactlyOnceWith(teammate);+ });+});+describe('shared native home chrome', () => {it('uses the measured bar inset once and opens the existing drawer from the shared menu', async () => {await render();diff --git a/apps/mobile/src/__tests__/apiClient.test.ts b/apps/mobile/src/__tests__/apiClient.test.tsindex ffe42df97f..50beb4d8b3 100644--- a/apps/mobile/src/__tests__/apiClient.test.ts+++ b/apps/mobile/src/__tests__/apiClient.test.ts@@ -17,6 +17,14 @@ describe('apiFetchRaw', () => {vi.unstubAllGlobals();});+ it('sends extra headers without letting them replace auth or content type', async () => {+ const fetch = vi.fn().mockResolvedValue({ ok: true, status: 200, json: async () => ({ ok: true }) });+ vi.stubGlobal('fetch', fetch);+ await apiFetchRaw('/v1/preferences', { baseUrl: 'https://chat.example.invalid', token: 'tok',+ headers: { 'X-Chat-Actor': 'actor-1', Authorization: 'Bearer other', 'Content-Type': 'text/plain' } });+ expect(fetch.mock.calls[0]![1].headers).toMatchObject({ 'X-Chat-Actor': 'actor-1', Authorization: 'Bearer tok', 'Content-Type': 'application/json' });+ });+it('classifies RN offline failures as a typed NETWORK_UNAVAILABLE ApiError (中文文案,可被重试层识别)', async () => {// RN 离线时 fetch 抛 TypeError("Network request failed")——不含 "fetch" 子串,// 历史实现匹配不到,英文原文一路透传到 UI。diff --git a/apps/mobile/src/__tests__/cloudCompanion.test.ts b/apps/mobile/src/__tests__/cloudCompanion.test.tsnew file mode 100644index 0000000000..2e4e33fd4d--- /dev/null+++ b/apps/mobile/src/__tests__/cloudCompanion.test.ts@@ -0,0 +1,155 @@+import { describe, expect, it, vi } from 'vitest';+import { ApiError } from '@/api/client';+import { createChatServerClient, type ChatActor, type ChatMessage } from '@/chat/chatServerClient';+import {+ CLOUD_SWITCH_TIMEOUT_MS, cloudActorForRow, cloudCompanionMessages, cloudSwitchAfterSetHome, cloudSwitchCandidates,+ cloudSwitchTick, cloudCompanionRows, type CloudSwitchState,+} from '@/chat/cloudCompanion';+import type { HostedRemoteCollectionItem } from '@/device-link/remoteResources';++const id = (n: number) => `00000000-0000-4000-8000-${String(n).padStart(12, '0')}`;+const row = (botId: string, deviceId: string, kind = 'bot'): HostedRemoteCollectionItem => ({+ key: `${deviceId}:${botId}`, host: { deviceId, deviceName: `Mac ${deviceId}` },+ item: { ref: { collectionId: 'teammates', kind, id: botId }, revision: '1', display: { title: botId }, links: [] },+}) as HostedRemoteCollectionItem;+const actor = (n: number, externalId: string, homeDeviceId: string | null, kind = 'bot'): ChatActor =>+ ({ id: id(n), kind, externalId, name: externalId, avatar: null, homeDeviceId });++describe('cloud companion rows', () => {+ it('matches a row only to the actor whose main computer is that row\'s computer', () => {+ const actors = [actor(1, 'cindy', 'mac-a'), actor(2, 'lizi', null), actor(3, 'human-x', 'mac-a', 'human')];+ expect(cloudActorForRow(actors, row('cindy', 'mac-a'))?.id).toBe(id(1));+ expect(cloudActorForRow(actors, row('cindy', 'mac-b'))).toBeNull();+ expect(cloudActorForRow(actors, row('lizi', 'mac-a'))).toBeNull();+ expect(cloudActorForRow(actors, row('human-x', 'mac-a'))).toBeNull();+ expect(cloudActorForRow(actors, row('cindy', 'mac-a', 'bot-group'))).toBeNull();+ });++ it('lists each companion once, under its main computer, adding a row for an unlisted main computer', () => {+ const items = [row('cindy', 'mac-a'), row('cindy', 'mac-b'), row('dash', 'mac-b'), row('lizi', 'mac-a'), row('ada', 'mac-a')];+ const actors = [actor(1, 'cindy', 'mac-b'), actor(2, 'dash', 'mac-a'), actor(3, 'lizi', 'mac-c'), actor(4, 'ada', null),+ { ...actor(5, 'mia', 'mac-c'), avatar: '🦊' }];+ const rows = cloudCompanionRows(items, actors, new Map([['mac-a', 'Studio']]));+ // cindy: only mac-b; dash and lizi: old copies replaced by their main computer's row; ada: no main computer, as listed.+ expect(rows.map(item => `${item.host.deviceId}:${item.item.ref.id}`))+ .toEqual(['mac-b:cindy', 'mac-a:ada', 'mac-a:dash', 'mac-c:lizi', 'mac-c:mia']);+ expect(rows.find(item => item.item.ref.id === 'dash')?.host.deviceName).toBe('Studio');+ // A new phone that never saw the main computer still gets an entry for the cloud conversation.+ const mia = rows.find(item => item.item.ref.id === 'mia')!;+ expect(mia.host).toEqual({ deviceId: 'mac-c', deviceName: 'mac-c' });+ expect(mia.item.display).toMatchObject({ title: 'mia', avatar: { kind: 'emoji', value: '🦊' } });+ expect(cloudActorForRow(actors, mia)?.id).toBe(id(5));+ expect(cloudCompanionRows(items, []).map(item => item.key)).toEqual(items.map(item => item.key));+ });++ it('offers online controllable computers except the current main computer and phones', () => {+ const device = (deviceId: string, canOpen: boolean, platform: string | null = 'darwin') =>+ ({ canOpen, device: { deviceId, name: `Name ${deviceId}`, platform } });+ expect(cloudSwitchCandidates([device('home', true), device('b', true), device('c', false), device('phone', true, 'ios'), device('w', true, 'win32')], 'home'))+ .toEqual([{ deviceId: 'b', name: 'Name b' }, { deviceId: 'w', name: 'Name w' }]);+ });++ it('projects the 1:1 room oldest first with the companion and owner sides', () => {+ const message = (n: number, authorId: string, text: string, extra: Partial<ChatMessage> = {}): ChatMessage => ({+ id: id(n), seq: String(n), authorId, author: { kind: authorId === id(1) ? 'bot' : 'human', name: '' }, createdAt: '2026-10-13T00:00:00Z',+ deleted: false, threadRootId: null, content: [{ type: 'text', text }], ...extra });+ const view = cloudCompanionMessages([+ message(12, id(1), 'reply'), message(11, id(9), 'hello'), message(11, id(9), 'hello'),+ message(13, id(9), 'gone', { deleted: true }), message(14, id(9), 'notice', { origin: 'system' }), message(15, id(1), ' '),+ ], id(1));+ expect(view.map(item => [item.text, item.fromCompanion])).toEqual([['hello', false], ['reply', true]]);+ });+});++describe('switching the main computer', () => {+ const target = { deviceId: 'mac-b', name: 'Studio' };++ it('waits after a successful compare-and-set and reports a conflict with the winning computer', () => {+ expect(cloudSwitchAfterSetHome(target, { ok: true, homeDeviceId: 'mac-b' }, 5)).toEqual({ phase: 'waiting', target, since: 5 });+ expect(cloudSwitchAfterSetHome(target, { ok: false, homeDeviceId: 'mac-c' }, 5)).toEqual({ phase: 'conflict', homeDeviceId: 'mac-c' });+ // Someone else already moved it to the same computer: just wait for it.+ expect(cloudSwitchAfterSetHome(target, { ok: false, homeDeviceId: 'mac-b' }, 5).phase).toBe('waiting');+ });++ it('opens the companion once the new computer lists it in a fresh read, and times out otherwise', () => {+ const waiting: CloudSwitchState = { phase: 'waiting', target, since: 1000 };+ const others = [row('cindy', 'mac-a'), row('dash', 'mac-b')];+ const fresh = () => true;+ expect(cloudSwitchTick(waiting, others, 'cindy', 1000 + CLOUD_SWITCH_TIMEOUT_MS - 1, fresh)).toEqual({ state: waiting, arrived: null });+ expect(cloudSwitchTick(waiting, others, 'cindy', 1000 + CLOUD_SWITCH_TIMEOUT_MS, fresh)).toEqual({ state: { phase: 'timeout', target }, arrived: null });+ const arrived = row('cindy', 'mac-b');+ // A cached row from an earlier stay on that computer does not end the wait.+ expect(cloudSwitchTick(waiting, [...others, arrived], 'cindy', 2000, () => false)).toEqual({ state: waiting, arrived: null });+ expect(cloudSwitchTick(waiting, [...others, arrived], 'cindy', 2000, fresh)).toEqual({ state: { phase: 'idle' }, arrived });+ const idle: CloudSwitchState = { phase: 'idle' };+ expect(cloudSwitchTick(idle, [arrived], 'cindy', 2000, fresh)).toEqual({ state: idle, arrived: null });+ });+});++describe('Chat Server client for companions', () => {+ it('reads the capability only from a human /me and keeps valid actors', async () => {+ const request = vi.fn(async (path: string): Promise<unknown> => path === '/me'+ ? { actor: { id: id(9), kind: 'human' }, deviceId: 'phone', capabilities: { companionHome: true } }+ : [{ id: id(1), kind: 'bot', externalId: 'cindy', name: 'Cindy', avatar: null, homeDeviceId: 'mac-a' },+ { id: 'not-an-id', kind: 'bot', externalId: 'x', name: 'X', avatar: null, homeDeviceId: null },+ // Deleted on its main computer: retired, never offered again.+ { id: id(2), kind: 'bot', externalId: 'old', name: 'Old', avatar: null, homeDeviceId: 'mac-a', disabled: true }]);+ const client = createChatServerClient(request as never);+ await expect(client.capabilities()).resolves.toEqual({ companionHome: true });+ await expect(client.actors()).resolves.toEqual([{ id: id(1), kind: 'bot', externalId: 'cindy', name: 'Cindy', avatar: null, homeDeviceId: 'mac-a' }]);+ request.mockResolvedValueOnce({ actor: { id: id(9), kind: 'human' } });+ await expect(client.capabilities()).resolves.toEqual({ companionHome: false });+ });++ it('reads the profile snapshot as the companion, and only a complete one counts', async () => {+ const request = vi.fn(async (): Promise<unknown> => [{ key: 'companion.profile.v1',+ value: { name: 'Cindy', description: '', soul: '', systemPrompt: '', user: '' } }]);+ const client = createChatServerClient(request as never);+ await expect(client.hasProfileSnapshot(id(1))).resolves.toBe(true);+ expect(request).toHaveBeenLastCalledWith('/preferences', 'GET', undefined, id(1));+ request.mockResolvedValueOnce([{ key: 'companion.memory.v1:a.md', value: { content: 'x' } }]);+ await expect(client.hasProfileSnapshot(id(1))).resolves.toBe(false);+ request.mockResolvedValueOnce([{ key: 'companion.profile.v1', value: null }]);+ await expect(client.hasProfileSnapshot(id(1))).resolves.toBe(false);+ request.mockResolvedValueOnce([{ key: 'companion.profile.v1', value: { name: 'Cindy' } }]);+ await expect(client.hasProfileSnapshot(id(1))).resolves.toBe(false);+ });++ it('sends compare-and-set and returns a typed conflict', async () => {+ const request = vi.fn().mockResolvedValueOnce({ id: id(1), homeDeviceId: 'mac-b' })+ .mockRejectedValueOnce(new ApiError('HOME_DEVICE_CONFLICT', 409, 'conflict', { homeDeviceId: 'mac-c' }))+ .mockRejectedValueOnce(new ApiError('HOME_DEVICE_CONFLICT', 409, 'conflict'))+ .mockRejectedValueOnce(new ApiError('FORBIDDEN', 403, 'no'));+ const client = createChatServerClient(request);+ await expect(client.setHome(id(1), 'mac-b', 'mac-a')).resolves.toEqual({ ok: true, homeDeviceId: 'mac-b' });+ expect(request).toHaveBeenCalledWith(`/actors/${id(1)}`, 'PATCH', { homeDeviceId: 'mac-b', expectedHomeDeviceId: 'mac-a' });+ await expect(client.setHome(id(1), 'mac-b', 'mac-a')).resolves.toEqual({ ok: false, homeDeviceId: 'mac-c' });+ await expect(client.setHome(id(1), 'mac-b', 'mac-a')).resolves.toEqual({ ok: false, homeDeviceId: null });+ await expect(client.setHome(id(1), 'mac-b', 'mac-a')).rejects.toMatchObject({ code: 'FORBIDDEN' });+ });++ it('resolves the companion room, falling back to the desktop\'s name-keyed operation', async () => {+ const request = vi.fn().mockRejectedValueOnce(new ApiError('OPERATION_CONFLICT', 409, 'conflict'))+ .mockResolvedValueOnce({ id: id(5) });+ const hash = vi.fn(async () => 'abcdef0123456789');+ const client = createChatServerClient(request);+ await expect(client.companionRoom(id(1), ' Cindy ', hash)).resolves.toBe(id(5));+ const body = { kind: 'direct', name: 'Cindy', participants: [id(1)], sourceId: id(1) };+ expect(request.mock.calls).toEqual([+ ['/conversations', 'POST', { operationId: `companion-room:${id(1)}`, ...body }],+ ['/conversations', 'POST', { operationId: `companion-room:${id(1)}:abcdef012345`, ...body }],+ ]);+ expect(hash).toHaveBeenCalledWith('Cindy');+ });++ it('pages the direct room history without the group filter', async () => {+ const page = Array.from({ length: 100 }, (_, n) => ({ id: id(300 - n), seq: String(300 - n) }));+ const request = vi.fn().mockResolvedValueOnce(page).mockResolvedValueOnce([{ id: id(1), seq: '1' }]);+ const client = createChatServerClient(request);+ const first = await client.history(id(5));+ expect(first.before).toBe('201');+ expect(request).toHaveBeenLastCalledWith(`/conversations/${id(5)}/messages?limit=100`);+ await expect(client.history(id(5), first.before)).resolves.toMatchObject({ before: null });+ expect(request).toHaveBeenLastCalledWith(`/conversations/${id(5)}/messages?limit=100&before=201`);+ });+});diff --git a/apps/mobile/src/api/client.ts b/apps/mobile/src/api/client.tsindex d446ae4fb6..8280fb1527 100644--- a/apps/mobile/src/api/client.ts+++ b/apps/mobile/src/api/client.ts@@ -5,6 +5,8 @@ export class ApiError extends Error {public readonly code: string,public readonly status: number,message: string,+ /** The server's structured `error.details`, when it sent an object. */+ public readonly details?: Record<string, unknown>,) {super(message);this.name = 'ApiError';@@ -21,6 +23,8 @@ export interface ApiFetchOptions {cache?: 'no-store';/** Reject stale account-scoped work before transport or auth side effects. */assertCurrent?: () => void;+ /** Extra request headers (e.g. Chat Server's X-Chat-Actor); never overrides auth or content type. */+ headers?: Record<string, string>;}const DEFAULT_API_TIMEOUT_MS = 20_000;@@ -46,7 +50,7 @@ export async function apiFetchRaw<T>(opts: ApiFetchOptions,): Promise<T> {opts.assertCurrent?.();- const headers: Record<string, string> = { 'Content-Type': 'application/json' };+ const headers: Record<string, string> = { ...opts.headers, 'Content-Type': 'application/json' };if (opts.token) headers.Authorization = `Bearer ${opts.token}`;if (opts.cache === 'no-store') {// Also tell native HTTP caches not to reuse or store short-lived responses.@@ -121,7 +125,7 @@ export async function apiFetchRaw<T>(// Preserve the original typed API error even if local cleanup fails.}}- throw new ApiError(code, response.status, error.message ?? i18n.t('apiErrors.requestFailed'));+ throw new ApiError(code, response.status, error.message ?? i18n.t('apiErrors.requestFailed'), error.details);}return data as T;@@ -131,7 +135,7 @@ function isAbortError(err: unknown): boolean {return !!err && typeof err === 'object' && 'name' in err && err.name === 'AbortError';}-function readError(data: unknown): { code?: string; message?: string } {+function readError(data: unknown): { code?: string; message?: string; details?: Record<string, unknown> } {if (!data || typeof data !== 'object') return {};const payload = data as Record<string, unknown>;const nested = payload.error;@@ -141,5 +145,7 @@ function readError(data: unknown): { code?: string; message?: string } {return {code: typeof record.code === 'string' ? record.code : undefined,message: typeof record.message === 'string' ? record.message : undefined,+ details: record.details && typeof record.details === 'object' && !Array.isArray(record.details)+ ? record.details as Record<string, unknown> : undefined,};}diff --git a/apps/mobile/src/chat/chatServerClient.ts b/apps/mobile/src/chat/chatServerClient.tsindex cc67090696..743a8a7ea4 100644--- a/apps/mobile/src/chat/chatServerClient.ts+++ b/apps/mobile/src/chat/chatServerClient.ts@@ -25,7 +25,14 @@ export interface ChatExecutionFailure {failure_code?: unknown; updated_at?: string; plan_id?: string | null;}export interface ChatPage { snapshot: ChatSnapshot; messages: ChatMessage[]; before: string | null; failures?: ChatExecutionFailure[] }-export type ChatRequest = <T>(path: string, method?: 'GET' | 'POST', body?: unknown) => Promise<T>;+/** `actorId` acts as one of the account's own actors (Chat Server `X-Chat-Actor`). */+export type ChatRequest = <T>(path: string, method?: 'GET' | 'POST' | 'PATCH', body?: unknown, actorId?: string) => Promise<T>;+/** An actor the account owns; a companion's `externalId` is its bot id on every computer. */+export interface ChatActor { id: string; kind: string; externalId: string; name: string; avatar: string | null; homeDeviceId: string | null }+export interface ChatCapabilities { companionHome: boolean }+/** Compare-and-set result: a conflict carries the main computer another device already chose. */+export type ChatSetHomeResult = { ok: true; homeDeviceId: string } | { ok: false; homeDeviceId: string | null };+export interface ChatHistoryPage { messages: ChatMessage[]; before: string | null }export function chatId(value: string): string {if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value)) throw new Error('INVALID_CHAT_ID');@@ -43,12 +50,20 @@ export function chatHttpsUrl(value: string): string {export function chatAccessLost(error: unknown): boolean {return !!error && typeof error === 'object' && 'status' in error && (error.status === 403 || error.status === 404);}+/** A typed server rejection: its `details` object (possibly empty), or null when it is another error. */+export function chatRejection(error: unknown, status: number, code: string): Record<string, unknown> | null {+ if (!error || typeof error !== 'object' || !('status' in error) || error.status !== status) return null;+ if ((error as { code?: unknown }).code !== code) return null;+ const details = (error as { details?: unknown }).details;+ return details && typeof details === 'object' && !Array.isArray(details) ? details as Record<string, unknown> : {};+}const memberName = (member: ChatMember) => member.kind === 'bot' && member.ownerName?.trim()? `${member.name} (${member.ownerName.trim()})` : member.name;// A recognized 引用回复 card renders as the quote; an unknown revision keeps its readable fallback.const contentText = (message: ChatMessage) => message.deleted || readImportedBotGroupRuntimeFailureCode(message) ? '' : message.content.filter(block => !readBotGroupQuoteCard(block)).map(block => block.text ?? block.fallback ?? (block.type === 'media' ? block.caption ?? '' : '')).join('\n');+export const chatMessageText = (message: ChatMessage) => contentText(message);/** Empty device identity means a server-owned conversation, never a fictitious computer. */export function chatRoomRow(room: ChatRoom, snapshot?: ChatSnapshot, selfId?: string): HostedRemoteCollectionItem {@@ -177,6 +192,13 @@ export function createChatServerClient(request: ChatRequest) {if (!Array.isArray(value)) throw new Error('INVALID_CHAT_EXECUTIONS');return value.filter(row => sources.has(row.source_message_id));}+ async function history(roomId: string, before?: string | null): Promise<ChatHistoryPage> {+ const messages = await request<ChatMessage[]>(`/conversations/${chatId(roomId)}/messages?limit=100${before ? `&before=${chatCursor(before)}` : ''}`);+ if (!Array.isArray(messages)) throw new Error('INVALID_CHAT_MESSAGES');+ const next = messages.length === 100 ? chatCursor(messages.at(-1)!.seq) : null;+ if (before && next && BigInt(next) >= BigInt(before)) throw new Error('INVALID_CHAT_PAGE');+ return { messages, before: next };+ }return {async list(): Promise<ChatRoom[]> {const rooms = new Map<string, ChatRoom>();@@ -200,6 +222,62 @@ export function createChatServerClient(request: ChatRequest) {if (actor.kind !== 'human') throw new Error('INVALID_CHAT_IDENTITY');return chatId(actor.id);},+ /** Server feature switches; an older server without them keeps per-computer companions. */+ async capabilities(): Promise<ChatCapabilities> {+ const me = await request<{ actor?: { kind?: string }; capabilities?: { companionHome?: unknown } }>('/me');+ return { companionHome: me?.actor?.kind === 'human' && me.capabilities?.companionHome === true };+ },+ async actors(): Promise<ChatActor[]> {+ const rows = await request<Array<ChatActor & { disabled?: unknown }>>('/actors');+ if (!Array.isArray(rows)) throw new Error('INVALID_CHAT_ACTORS');+ return rows.flatMap(row => {+ // Retired in the cloud (deleted on its main computer): not a companion any more.+ if (row.disabled === true) return [];+ try { chatId(row.id); } catch { return []; }+ if (typeof row.externalId !== 'string' && row.externalId != null) return [];+ return [{ id: row.id, kind: String(row.kind), externalId: row.externalId ?? '', name: typeof row.name === 'string' ? row.name : '',+ avatar: typeof row.avatar === 'string' ? row.avatar : null, homeDeviceId: typeof row.homeDeviceId === 'string' && row.homeDeviceId ? row.homeDeviceId : null }];+ });+ },+ /** The main computer has uploaded the profile snapshot another computer builds the companion from. */+ async hasProfileSnapshot(actorId: string): Promise<boolean> {+ const rows = await request<Array<{ key?: unknown; value?: unknown }>>('/preferences', 'GET', undefined, chatId(actorId));+ const row = (Array.isArray(rows) ? rows : []).find(candidate => candidate?.key === 'companion.profile.v1');+ // Same check as Desktop (companion-cloud/uploader.ts isCompanionProfileSnapshot): a complete profile.+ const value = row?.value as Record<string, unknown> | null | undefined;+ return !!value && typeof value === 'object' && !Array.isArray(value)+ && ['name', 'description', 'soul', 'systemPrompt', 'user'].every(field => typeof value[field] === 'string');+ },+ /** Move a companion's main computer only if it is still `expected` (no two devices race it). */+ async setHome(actorId: string, homeDeviceId: string, expected: string | null): Promise<ChatSetHomeResult> {+ try {+ const actor = await request<{ homeDeviceId?: unknown } | null>(`/actors/${chatId(actorId)}`, 'PATCH', { homeDeviceId, expectedHomeDeviceId: expected });+ return { ok: true, homeDeviceId: typeof actor?.homeDeviceId === 'string' ? actor.homeDeviceId : homeDeviceId };+ } catch (error) {+ const conflict = chatRejection(error, 409, 'HOME_DEVICE_CONFLICT');+ if (!conflict) throw error;+ return { ok: false, homeDeviceId: typeof conflict.homeDeviceId === 'string' && conflict.homeDeviceId ? conflict.homeDeviceId : null };+ }+ },+ /**+ * The companion's fixed 1:1 room. Every device asks with the same operation and gets the same+ * room; a room first created under another name answers OPERATION_CONFLICT, then the name-keyed+ * operation (the desktop's) resolves the same room.+ */+ async companionRoom(actorId: string, name: string, hash: (text: string) => Promise<string>): Promise<string> {+ const body = { kind: 'direct', name: name.trim().slice(0, 160) || '伙伴', participants: [chatId(actorId)], sourceId: actorId };+ let room: { id: string };+ try {+ room = await request<{ id: string }>('/conversations', 'POST', { operationId: `companion-room:${actorId}`, ...body });+ } catch (error) {+ if (!chatRejection(error, 409, 'OPERATION_CONFLICT')) throw error;+ const suffix = (await hash(body.name)).slice(0, 12);+ room = await request<{ id: string }>('/conversations', 'POST', { operationId: `companion-room:${actorId}:${suffix}`, ...body });+ }+ return chatId(room?.id ?? '');+ },+ /** Main-timeline messages of any room kind (a companion's room is `direct`), newest first. */+ history,async snapshot(roomId: string): Promise<ChatSnapshot> {return request(`/conversations/${chatId(roomId)}/snapshot`);},diff --git a/apps/mobile/src/chat/cloudCompanion.ts b/apps/mobile/src/chat/cloudCompanion.tsnew file mode 100644index 0000000000..2010dc7654--- /dev/null+++ b/apps/mobile/src/chat/cloudCompanion.ts@@ -0,0 +1,118 @@+/**+ * 云端伙伴(docs/product-rules/cloud-companions.md §3.1)在手机上的纯逻辑:哪一行能在主力电脑离线时+ * 打开云端对话、同一伙伴只在主力电脑名下列一行(没见过的主力电脑补一行离线入口)、换电脑后的等待与超时。+ * 不触碰网络或界面,便于单测。+ */+import { isMobilePlatform } from '@cindy/maker-shared/device-list';+import type { RemoteResourceAvatar } from '@cindy/device-link';+import type { HostedRemoteCollectionItem } from '@/device-link/remoteResources';+import { chatCursor, chatMessageText, type ChatActor, type ChatMessage, type ChatSetHomeResult } from './chatServerClient';++/** How long the phone waits for the new main computer to list the companion. */+export const CLOUD_SWITCH_TIMEOUT_MS = 90_000;+/** Roster re-read cadence while waiting (pushes usually arrive first). */+export const CLOUD_SWITCH_POLL_MS = 5_000;++/** The account's companion actor for this roster row, when that row's computer is its main computer. */+export function cloudActorForRow(actors: readonly ChatActor[], row: HostedRemoteCollectionItem): ChatActor | null {+ if (row.item.ref.kind !== 'bot' || !row.host.deviceId) return null;+ return actors.find(actor => actor.kind === 'bot' && actor.externalId === row.item.ref.id+ && actor.homeDeviceId === row.host.deviceId) ?? null;+}++const TEAMMATES = 'teammates';++function cloudAvatar(actor: ChatActor): RemoteResourceAvatar {+ const fallbackText = Array.from(actor.name.trim())[0] ?? 'C';+ const value = actor.avatar ?? '';+ const kind = value.startsWith('cindy://avatar/') ? 'asset' : value && !/^https?:/.test(value) ? 'emoji' : 'text';+ return { kind, value: kind === 'text' ? fallbackText : value, fallbackText };+}++/**+ * One row per companion, under its main computer: rows other computers still list for a+ * companion whose main computer is known (old copies, often cached while that computer is+ * offline) are dropped, and a main computer this phone has no row from (e.g. a new phone while+ * it is offline) gets a row built from the cloud actor, so the cloud conversation can open.+ * Without a known main computer every row stays as listed.+ */+export function cloudCompanionRows(items: readonly HostedRemoteCollectionItem[], actors: readonly ChatActor[],+ deviceNames: ReadonlyMap<string, string> = new Map()): HostedRemoteCollectionItem[] {+ const homes = new Map<string, ChatActor>();+ for (const actor of actors) if (actor.kind === 'bot' && actor.externalId && actor.homeDeviceId) homes.set(actor.externalId, actor);+ const listed = items.filter(row => {+ const home = row.item.ref.kind === 'bot' ? homes.get(row.item.ref.id)?.homeDeviceId : undefined;+ return !home || home === row.host.deviceId;+ });+ const added = [...homes.values()].flatMap((actor): HostedRemoteCollectionItem[] => {+ const deviceId = actor.homeDeviceId!;+ if (listed.some(row => row.item.ref.kind === 'bot' && row.item.ref.id === actor.externalId && row.host.deviceId === deviceId)) return [];+ const ref = { collectionId: TEAMMATES, kind: 'bot', id: actor.externalId };+ return [{ key: JSON.stringify([deviceId, ref.collectionId, ref.kind, ref.id]), host: { deviceId, deviceName: deviceNames.get(deviceId) ?? deviceId },+ item: { ref, display: { title: actor.name, avatar: cloudAvatar(actor) }, links: [], revision: 'cloud' } }];+ });+ return [...listed, ...added];+}++export interface CloudSwitchCandidate { deviceId: string; name: string }++/** Computers the companion can move to: online, remote control allowed, not a phone, not the current home. */+export function cloudSwitchCandidates(+ devices: readonly { canOpen: boolean; device: { deviceId: string; name: string; platform: string | null } }[],+ currentHome: string | null,+): CloudSwitchCandidate[] {+ return devices.filter(row => row.canOpen && !isMobilePlatform(row.device.platform) && row.device.deviceId !== currentHome)+ .map(row => ({ deviceId: row.device.deviceId, name: row.device.name }));+}++export interface CloudMessage { id: string; fromCompanion: boolean; text: string; createdAt: number }++/** Oldest first, deduplicated; the companion's actor wrote its replies, everyone else is the owner. */+export function cloudCompanionMessages(messages: readonly ChatMessage[], actorId: string): CloudMessage[] {+ const unique = [...new Map(messages.map(message => [message.id, message])).values()]+ .filter(message => !message.deleted && !message.threadRootId && message.origin !== 'system');+ unique.sort((a, b) => {+ const left = BigInt(chatCursor(a.seq)); const right = BigInt(chatCursor(b.seq));+ return left < right ? -1 : left > right ? 1 : 0;+ });+ return unique.flatMap(message => {+ const text = chatMessageText(message).trim();+ return text ? [{ id: message.id, fromCompanion: message.authorId === actorId, text, createdAt: Date.parse(message.createdAt) }] : [];+ });+}++/** What the phone shows while (and after) asking another computer to take over. */+export type CloudSwitchState =+ | { phase: 'idle' }+ | { phase: 'requesting'; target: CloudSwitchCandidate }+ | { phase: 'waiting'; target: CloudSwitchCandidate; since: number }+ | { phase: 'timeout'; target: CloudSwitchCandidate }+ | { phase: 'conflict'; homeDeviceId: string | null }+ | { phase: 'failed'; target: CloudSwitchCandidate };++/** The server's answer to the compare-and-set. */+export function cloudSwitchAfterSetHome(target: CloudSwitchCandidate, result: ChatSetHomeResult, now: number): CloudSwitchState {+ if (result.ok) return { phase: 'waiting', target, since: now };+ // Another device moved it to exactly this computer: wait for it just the same.+ if (result.homeDeviceId === target.deviceId) return { phase: 'waiting', target, since: now };+ return { phase: 'conflict', homeDeviceId: result.homeDeviceId };+}++/**+ * The new main computer's row for the companion, once that computer lists it in a read made+ * while waiting (`answered`). A cached row (it ran there before) is not proof the take-over finished.+ */+export function cloudSwitchArrival<T extends HostedRemoteCollectionItem>(items: readonly T[], deviceId: string, botId: string,+ answered: (row: T) => boolean): T | null {+ return items.find(row => row.item.ref.kind === 'bot' && row.host.deviceId === deviceId && row.item.ref.id === botId && answered(row)) ?? null;+}++/** One waiting tick: open the arrived row, give up after the timeout, otherwise keep waiting. */+export function cloudSwitchTick<T extends HostedRemoteCollectionItem>(state: CloudSwitchState, items: readonly T[], botId: string, now: number,+ answered: (row: T) => boolean, timeoutMs = CLOUD_SWITCH_TIMEOUT_MS): { state: CloudSwitchState; arrived: T | null } {+ if (state.phase !== 'waiting') return { state, arrived: null };+ const arrived = cloudSwitchArrival(items, state.target.deviceId, botId, answered);+ if (arrived) return { state: { phase: 'idle' }, arrived };+ if (now - state.since >= timeoutMs) return { state: { phase: 'timeout', target: state.target }, arrived: null };+ return { state, arrived: null };+}diff --git a/apps/mobile/src/chat/useChatServer.ts b/apps/mobile/src/chat/useChatServer.tsindex 2f9c60dc81..90708968d4 100644--- a/apps/mobile/src/chat/useChatServer.ts+++ b/apps/mobile/src/chat/useChatServer.ts@@ -11,7 +11,8 @@ import type { BotGroupChatState } from '@/session/useBotGroupChat';import { chatAccessLost, chatCursor, chatGroupView, chatHttpsUrl, chatRoomRow, chatReadAt, chatReadSequence, chatLastReplyAt, chatLastReplySequence, createChatServerClient, type ChatPage, type ChatRequest, type ChatSnapshot } from './chatServerClient';import { subscribeChatServer } from './chatServerSubscription';-function useChatClient() {+/** The account's Chat Server client, fenced to the current account, realm and mount. */+export function useChatClient() {const auth = useAuth();const owner = `${auth.user?.id ?? ''}:${auth.accountGeneration}:${getActiveMobileSessionRealm()}`;const active = useRef(owner); active.current = owner;@@ -36,10 +37,11 @@ function useChatClient() {.finally(() => { discovering = undefined; });return discovering;};- const request: ChatRequest = async <T,>(path: string, method: 'GET' | 'POST' = 'GET', body?: unknown) => {+ const request: ChatRequest = async <T,>(path: string, method: 'GET' | 'POST' | 'PATCH' = 'GET', body?: unknown, actorId?: string) => {check();const url = await endpoint(); check();- const result = await deps.current.apiFetch<T>(`/v1${path}`, { baseUrl: url, method, cache: 'no-store', ...(body !== undefined ? { body } : {}), assertCurrent: check });+ const result = await deps.current.apiFetch<T>(`/v1${path}`, { baseUrl: url, method, cache: 'no-store', ...(body !== undefined ? { body } : {}),+ ...(actorId ? { headers: { 'X-Chat-Actor': actorId } } : {}), assertCurrent: check });check(); return result;};const client = createChatServerClient(request);diff --git a/apps/mobile/src/chat/useCloudCompanion.ts b/apps/mobile/src/chat/useCloudCompanion.tsnew file mode 100644index 0000000000..59d7f95e26--- /dev/null+++ b/apps/mobile/src/chat/useCloudCompanion.ts@@ -0,0 +1,52 @@+import { useCallback, useRef, useState } from 'react';+import { AppState } from 'react-native';+import { useFocusEffect } from 'expo-router';+import type { ChatActor, ChatSetHomeResult } from './chatServerClient';+import { useChatClient } from './useChatServer';+import { useDeviceLink } from '@/device-link/DeviceLinkContext';++const NO_ACTORS: ChatActor[] = [];+const NO_NAMES: ReadonlyMap<string, string> = new Map();++/**+ * Whether the account's Chat Server supports main computers (`/me` capabilities.companionHome),+ * and the account's companion actors with their main computers (and those computers' names,+ * best effort, for rows of computers this phone never listed). Read on focus and foreground;+ * an older server, a missing chat endpoint or a failed read leaves the feature off (or the last answer).+ */+export function useCloudCompanionHome(enabled: boolean) {+ const api = useChatClient();+ const { readDeviceList } = useDeviceLink();+ const [state, setState] = useState({ owner: api.owner, supported: false, actors: NO_ACTORS, deviceNames: NO_NAMES });+ const generation = useRef(0);+ const refresh = useCallback(async () => {+ if (!enabled || !api.enabled) return;+ const run = ++generation.current;+ try {+ const { companionHome } = await api.client.capabilities();+ const actors = companionHome ? await api.client.actors() : NO_ACTORS;+ const deviceNames = companionHome && actors.length+ ? await readDeviceList().then(({ devices }) => new Map(devices.map(device => [device.deviceId, device.name] as const)), () => NO_NAMES)+ : NO_NAMES;+ if (run !== generation.current || !api.current()) return;+ setState({ owner: api.owner, supported: companionHome, actors, deviceNames });+ } catch {+ // Keep the previous answer: rows simply behave as before when the server cannot be read.+ }+ }, [api, enabled, readDeviceList]);+ useFocusEffect(useCallback(() => {+ if (!enabled || !api.enabled) return;+ void refresh();+ const foreground = AppState.addEventListener('change', value => { if (value === 'active') void refresh(); });+ return () => { generation.current += 1; foreground.remove(); };+ }, [api.enabled, enabled, refresh]));+ const own = state.owner === api.owner;+ // Never move the home before its profile snapshot is in the cloud: the new computer could not+ // build the companion, and the old one would already be demoted (cloud-companions.md).+ const setHome = useCallback(async (actorId: string, homeDeviceId: string, expected: string | null): Promise<ChatSetHomeResult> => {+ if (!(await api.client.hasProfileSnapshot(actorId))) throw new Error('PROFILE_SNAPSHOT_MISSING');+ return api.client.setHome(actorId, homeDeviceId, expected);+ }, [api]);+ return { supported: own && state.supported, actors: own ? state.actors : NO_ACTORS,+ deviceNames: own ? state.deviceNames : NO_NAMES, refresh, setHome };+}diff --git a/apps/mobile/src/chat/useCloudCompanionRoom.ts b/apps/mobile/src/chat/useCloudCompanionRoom.tsnew file mode 100644index 0000000000..95fadfc35f--- /dev/null+++ b/apps/mobile/src/chat/useCloudCompanionRoom.ts@@ -0,0 +1,68 @@+import { useCallback, useRef, useState } from 'react';+import { AppState } from 'react-native';+import { useFocusEffect } from 'expo-router';+import * as Crypto from 'expo-crypto';+import { chatAccessLost, type ChatMessage } from './chatServerClient';+import { useChatClient } from './useChatServer';++/** Same name-keyed room operation as the desktop (sha256 hex of the room name). */+const sha256Hex = (text: string) => Crypto.digestStringAsync(Crypto.CryptoDigestAlgorithm.SHA256, text, { encoding: Crypto.CryptoEncoding.HEX });++type RoomState = {+ identity: string; roomId: string | null; messages: ChatMessage[]; before: string | null;+ status: 'loading' | 'ready' | 'error'; loadingOlder: boolean;+};++/** The companion's read-only 1:1 cloud conversation: the latest page, then older pages on demand. */+export function useCloudCompanionRoom(actorId: string, name: string, enabled: boolean) {+ const api = useChatClient();+ const identity = `${api.owner}:${actorId}`;+ const active = useRef(identity); active.current = identity;+ const initial = (): RoomState => ({ identity, roomId: null, messages: [], before: null, status: 'loading', loadingOlder: false });+ const [state, setState] = useState<RoomState>(initial);+ const latest = useRef(state); latest.current = state;+ const generation = useRef(0);+ const olderPending = useRef(false);+ const valid = () => api.current() && active.current === identity;+ const reload = useCallback(async () => {+ if (!enabled || !api.enabled || !actorId) return;+ const run = ++generation.current;+ const previous = latest.current.identity === identity ? latest.current : null;+ try {+ const roomId = previous?.roomId ?? await api.client.companionRoom(actorId, name, sha256Hex);+ const page = await api.client.history(roomId);+ if (run !== generation.current || !valid()) return;+ // Keep pages already loaded above the refreshed newest page.+ const fresh = new Set(page.messages.map(message => message.id));+ const kept = previous?.roomId === roomId && previous.messages.length > page.messages.length+ ? previous.messages.filter(message => !fresh.has(message.id)) : [];+ setState({ identity, roomId, messages: [...page.messages, ...kept], before: kept.length ? previous!.before : page.before,+ status: 'ready', loadingOlder: false });+ } catch (error) {+ if (run !== generation.current || !valid()) return;+ setState(old => old.identity === identity && old.status === 'ready' && !chatAccessLost(error)+ ? old : { ...initial(), status: 'error' });+ }+ }, [actorId, api, enabled, identity, name]);+ useFocusEffect(useCallback(() => {+ if (!enabled || !api.enabled) return;+ void reload();+ const foreground = AppState.addEventListener('change', value => { if (value === 'active') void reload(); });+ return () => { generation.current += 1; foreground.remove(); };+ }, [api.enabled, enabled, reload]));+ const loadOlder = useCallback(async () => {+ const current = latest.current;+ if (current.identity !== identity || !current.roomId || !current.before || olderPending.current) return;+ olderPending.current = true;+ setState(old => ({ ...old, loadingOlder: true }));+ try {+ const page = await api.client.history(current.roomId, current.before);+ if (!valid() || latest.current.roomId !== current.roomId) return;+ setState(old => ({ ...old, messages: [...old.messages, ...page.messages], before: page.before, loadingOlder: false }));+ } catch {+ if (valid()) setState(old => ({ ...old, loadingOlder: false }));+ } finally { olderPending.current = false; }+ }, [api, identity]);+ const own = state.identity === identity ? state : initial();+ return { ...own, reload, loadOlder };+}diff --git a/apps/mobile/src/i18n/locales/en/devices.json b/apps/mobile/src/i18n/locales/en/devices.jsonindex ae66fffea9..b5e2e1c715 100644--- a/apps/mobile/src/i18n/locales/en/devices.json+++ b/apps/mobile/src/i18n/locales/en/devices.json@@ -893,5 +893,22 @@"continue": "Continue","addTime": "Add time","dateOnly": "Date only"+ },+ "cloudCompanion": {+ "homeOffline": "Main computer “{{device}}” is offline",+ "switchAction": "Continue on another computer",+ "composerHint": "Main computer is offline. Switch to another computer to continue.",+ "readOnlyNote": "This conversation is saved in the cloud and is read only.",+ "empty": "No conversation in the cloud yet.",+ "loadFailed": "Can’t load the cloud conversation right now.",+ "loadOlder": "Load earlier messages",+ "noTargets": "No other computer is available. Open Cindy on another computer, sign in to the same account, and turn on “Allow same-account devices to control this computer”, then try again.",+ "devicesFailed": "Can’t load your computers right now. Try again later.",+ "preparing": "Getting ready on “{{device}}”…",+ "preparingHint": "That computer takes over the teammate from its cloud profile and opens it when ready.",+ "timeout": "“{{device}}” isn’t ready yet. Make sure Cindy is open and online on that computer, then try again.",+ "conflict": "{{name}} has already moved to “{{device}}”.",+ "switchFailed": "Can’t change the main computer right now. Try again later.",+ "unknownDevice": "another computer"}}diff --git a/apps/mobile/src/i18n/locales/ja/devices.json b/apps/mobile/src/i18n/locales/ja/devices.jsonindex e460eb7152..296c3883bc 100644--- a/apps/mobile/src/i18n/locales/ja/devices.json+++ b/apps/mobile/src/i18n/locales/ja/devices.json@@ -893,5 +893,22 @@"continue": "続ける","addTime": "時刻を追加","dateOnly": "日付のみ"+ },+ "cloudCompanion": {+ "homeOffline": "メインのパソコン「{{device}}」がオフラインです",+ "switchAction": "別のパソコンで続ける",+ "composerHint": "メインのパソコンがオフラインです。別のパソコンに切り替えると続けられます。",+ "readOnlyNote": "クラウドに保存された会話です。閲覧のみできます。",+ "empty": "クラウドの会話はまだありません。",+ "loadFailed": "クラウドの会話を読み込めません。",+ "loadOlder": "以前のメッセージを読み込む",+ "noTargets": "ほかに使えるパソコンがありません。別のパソコンで Cindy を開いて同じアカウントでログインし、「同じアカウントのデバイスにこのパソコンの操作を許可」をオンにしてから、もう一度お試しください。",+ "devicesFailed": "パソコンの一覧を読み込めません。しばらくしてからもう一度お試しください。",+ "preparing": "「{{device}}」で準備しています…",+ "preparingHint": "そのパソコンがクラウドのプロフィールからチームメイトを引き継ぎ、準備ができたら自動で開きます。",+ "timeout": "「{{device}}」の準備がまだ終わっていません。そのパソコンで Cindy が開いていてオンラインか確認して、もう一度お試しください。",+ "conflict": "{{name}} はすでに「{{device}}」に移っています。",+ "switchFailed": "メインのパソコンを変更できません。しばらくしてからもう一度お試しください。",+ "unknownDevice": "別のパソコン"}}diff --git a/apps/mobile/src/i18n/locales/ko/devices.json b/apps/mobile/src/i18n/locales/ko/devices.jsonindex 4e78721349..9962998e46 100644--- a/apps/mobile/src/i18n/locales/ko/devices.json+++ b/apps/mobile/src/i18n/locales/ko/devices.json@@ -893,5 +893,22 @@"continue": "계속","addTime": "시각 추가","dateOnly": "날짜만"+ },+ "cloudCompanion": {+ "homeOffline": "주 컴퓨터 '{{device}}' 오프라인",+ "switchAction": "다른 컴퓨터에서 계속하기",+ "composerHint": "주 컴퓨터가 오프라인입니다. 다른 컴퓨터로 바꾸면 계속할 수 있습니다.",+ "readOnlyNote": "클라우드에 저장된 대화로, 보기만 할 수 있습니다.",+ "empty": "아직 클라우드 대화가 없습니다.",+ "loadFailed": "지금은 클라우드 대화를 불러올 수 없습니다.",+ "loadOlder": "이전 메시지 불러오기",+ "noTargets": "사용할 수 있는 다른 컴퓨터가 없습니다. 다른 컴퓨터에서 Cindy를 열고 같은 계정으로 로그인한 뒤 '동일 계정 기기의 이 컴퓨터 제어 허용'을 켜고 다시 시도하세요.",+ "devicesFailed": "지금은 컴퓨터 목록을 불러올 수 없습니다. 잠시 후 다시 시도하세요.",+ "preparing": "'{{device}}'에서 준비하는 중…",+ "preparingHint": "그 컴퓨터가 클라우드 프로필로 팀원을 이어받고, 준비되면 자동으로 엽니다.",+ "timeout": "'{{device}}'이(가) 아직 준비되지 않았습니다. 그 컴퓨터에서 Cindy가 열려 있고 온라인인지 확인한 뒤 다시 시도하세요.",+ "conflict": "{{name}}은(는) 이미 '{{device}}'(으)로 옮겨졌습니다.",+ "switchFailed": "지금은 주 컴퓨터를 바꿀 수 없습니다. 잠시 후 다시 시도하세요.",+ "unknownDevice": "다른 컴퓨터"}}diff --git a/apps/mobile/src/i18n/locales/zh-CN/devices.json b/apps/mobile/src/i18n/locales/zh-CN/devices.jsonindex ca86347be2..d0b4265233 100644--- a/apps/mobile/src/i18n/locales/zh-CN/devices.json+++ b/apps/mobile/src/i18n/locales/zh-CN/devices.json@@ -893,5 +893,22 @@"continue": "继续","addTime": "添加时间","dateOnly": "仅日期"+ },+ "cloudCompanion": {+ "homeOffline": "主力电脑「{{device}}」离线",+ "switchAction": "换一台电脑继续",+ "composerHint": "主力电脑离线,换一台电脑后继续",+ "readOnlyNote": "这里是云端保存的对话,只能查看。",+ "empty": "还没有云端对话。",+ "loadFailed": "暂时无法读取云端对话。",+ "loadOlder": "加载更早的消息",+ "noTargets": "没有其他可用的电脑。在另一台电脑上打开 Cindy、登录同一账号,并开启「允许同账号设备控制本机」后再试。",+ "devicesFailed": "暂时无法读取你的电脑列表,请稍后再试。",+ "preparing": "正在「{{device}}」上准备…",+ "preparingHint": "那台电脑会按云端资料接手伙伴,准备好后自动打开。",+ "timeout": "「{{device}}」还没准备好。请确认那台电脑上的 Cindy 已打开并联网,再试一次。",+ "conflict": "{{name}} 已经换到「{{device}}」继续了。",+ "switchFailed": "暂时无法更换主力电脑,请稍后再试。",+ "unknownDevice": "另一台电脑"}}diff --git a/apps/mobile/src/i18n/locales/zh-TW/devices.json b/apps/mobile/src/i18n/locales/zh-TW/devices.jsonindex 625c552d69..86ae84bee1 100644--- a/apps/mobile/src/i18n/locales/zh-TW/devices.json+++ b/apps/mobile/src/i18n/locales/zh-TW/devices.json@@ -893,5 +893,22 @@"continue": "繼續","addTime": "新增時間","dateOnly": "僅日期"+ },+ "cloudCompanion": {+ "homeOffline": "主力電腦「{{device}}」離線",+ "switchAction": "換一台電腦繼續",+ "composerHint": "主力電腦離線,換一台電腦後繼續",+ "readOnlyNote": "這裡是雲端儲存的對話,只能檢視。",+ "empty": "還沒有雲端對話。",+ "loadFailed": "暫時無法讀取雲端對話。",+ "loadOlder": "載入更早的訊息",+ "noTargets": "沒有其他可用的電腦。在另一台電腦上開啟 Cindy、登入同一帳號,並開啟「允許同帳號裝置控制本機」後再試。",+ "devicesFailed": "暫時無法讀取你的電腦清單,請稍後再試。",+ "preparing": "正在「{{device}}」上準備…",+ "preparingHint": "那台電腦會依雲端資料接手夥伴,準備好後自動開啟。",+ "timeout": "「{{device}}」還沒準備好。請確認那台電腦上的 Cindy 已開啟並連上網路,再試一次。",+ "conflict": "{{name}} 已經換到「{{device}}」繼續了。",+ "switchFailed": "暫時無法更換主力電腦,請稍後再試。",+ "unknownDevice": "另一台電腦"}}diff --git a/apps/mobile/src/session/ChatIdentityHeader.tsx b/apps/mobile/src/session/ChatIdentityHeader.tsxindex 453f3216b3..3d638c7078 100644--- a/apps/mobile/src/session/ChatIdentityHeader.tsx+++ b/apps/mobile/src/session/ChatIdentityHeader.tsx@@ -33,8 +33,9 @@ export function ChatIdentityHeader({identityHint?: string;controlsReady?: boolean;onBack(): void;- onOpenSettings(): void;- settingsLabel: string;+ /** Omitted when there is nothing to open (the identity is then plain, without a settings button). */+ onOpenSettings?(): void;+ settingsLabel?: string;testIDPrefix: string;/** Defaults to `${testIDPrefix}.settings`. */settingsTestID?: string;@@ -42,13 +43,15 @@ export function ChatIdentityHeader({const { t } = useTranslation();const { colors } = useTheme();const styles = useThemedStyles(makeStyles);- const open = () => { if (controlsReady) { Keyboard.dismiss(); onOpenSettings(); } };+ const settings = !!onOpenSettings;+ const open = () => { if (controlsReady && onOpenSettings) { Keyboard.dismiss(); onOpenSettings(); } };return <View style={styles.header} testID={`${testIDPrefix}.header`}>{/* Same system back as the task header. */}<NativeChromeBackButton testID={`${testIDPrefix}.back`} label={t('shared.back')} onPress={() => { Keyboard.dismiss(); onBack(); }} />- <Pressable style={({ pressed }) => [styles.identity, pressed && styles.pressed]} accessibilityRole="button"- accessibilityLabel={identityLabel} accessibilityHint={identityHint} accessibilityState={{ disabled: !controlsReady }}- disabled={!controlsReady} onPress={open} testID={`${testIDPrefix}.identity`}>+ <Pressable style={({ pressed }) => [styles.identity, pressed && styles.pressed]} accessibilityRole={settings ? 'button' : 'header'}+ accessibilityLabel={identityLabel} accessibilityHint={settings ? identityHint : undefined}+ accessibilityState={settings ? { disabled: !controlsReady } : undefined}+ disabled={!controlsReady || !settings} onPress={open} testID={`${testIDPrefix}.identity`}><View style={styles.mark}>{mark}</View><View style={styles.identityText}><Text numberOfLines={1} style={styles.title}>{title}</Text>@@ -56,9 +59,9 @@ export function ChatIdentityHeader({</View></Pressable>{accessory}- <HomeHeaderGlassButton testID={settingsTestID ?? `${testIDPrefix}.settings`} disabled={!controlsReady} accessibilityLabel={settingsLabel} onPress={open}>+ {settings ? <HomeHeaderGlassButton testID={settingsTestID ?? `${testIDPrefix}.settings`} disabled={!controlsReady} accessibilityLabel={settingsLabel ?? ''} onPress={open}><Settings2 size={iconSize.lg} strokeWidth={CHAT_HEADER_GLYPH_STROKE} color={colors.textPrimary} />- </HomeHeaderGlassButton>+ </HomeHeaderGlassButton> : null}</View>;}diff --git a/apps/mobile/src/session/CloudCompanionScreen.tsx b/apps/mobile/src/session/CloudCompanionScreen.tsxnew file mode 100644index 0000000000..93929a3d14--- /dev/null+++ b/apps/mobile/src/session/CloudCompanionScreen.tsx@@ -0,0 +1,287 @@+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';+import { ActivityIndicator, ScrollView, StyleSheet, View, type NativeScrollEvent, type NativeSyntheticEvent } from 'react-native';+import { Stack, useRouter } from 'expo-router';+import { SafeAreaView } from 'react-native-safe-area-context';+import { useTranslation } from 'react-i18next';+import { useAuth } from '@/auth/AuthContext';+import { Text } from '@/components/AppText';+import { RemoteCompanionAvatar } from '@/components/RemoteCompanionAvatar';+import { chatHttpsUrl } from '@/chat/chatServerClient';+import {+ CLOUD_SWITCH_POLL_MS, cloudCompanionMessages, cloudSwitchAfterSetHome, cloudSwitchCandidates, cloudSwitchTick,+ type CloudSwitchCandidate, type CloudSwitchState,+} from '@/chat/cloudCompanion';+import { useCloudCompanionHome } from '@/chat/useCloudCompanion';+import { useCloudCompanionRoom } from '@/chat/useCloudCompanionRoom';+import { useDeviceLink } from '@/device-link/DeviceLinkContext';+import { toDeviceListItems } from '@/device-link/devices';+import { cachedBotItem } from '@/device-link/remoteResourceCache';+import { useRevokedDevices } from '@/device-link/revokedDevicesStore';+import { useTheme, useThemedStyles, type ThemeColors } from '@/theme';+import { fontWeight, lineHeight, radius, spacing, typeScale } from '@/theme/tokens';+import { useUserBubbleAppearance } from '@/theme/userBubblePreference';+import { goBackGuarded } from '@/utils/backGuard';+import { BOT_GROUP_MESSAGE_AVATAR_SIZE } from './BotGroupAvatars';+import { BotGroupMarkdownText, BotGroupUserText } from './BotGroupMessageText';+import { CHAT_HEADER_MARK_SIZE, ChatIdentityHeader, ChatIdentitySubtitle } from './ChatIdentityHeader';+import { CompanionCardActions, CompanionCardButton } from './CompanionCardButton';+import { CompanionSettingsRow } from './CompanionSettingsRow';+import { CompanionSheet } from './CompanionSheet';+import { useTeammateNavigation } from './useTeammateNavigation';+import { TEAMMATE_COLLECTION_ID, useTeammateRoster } from './useTeammateRoster';++/** Presence dot before the subtitle, as in the 1:1 header. */+const PRESENCE_DOT = 6;+/** Reply geometry of the 1:1 chat: 28pt portrait, 10pt to the text. */+const REPLY_AVATAR_GAP = 10;+/** Load the previous page once the reader is this close to the top. */+const LOAD_OLDER_THRESHOLD_PX = 120;+const STICK_TO_BOTTOM_PX = 48;+const NO_MENTIONS: readonly string[] = [];++type Notice = 'noTargets' | 'devicesFailed' | null;++/**+ * 伙伴的主力电脑离线时,手机上的云端对话(docs/product-rules/cloud-companions.md §3.1):只读显示+ * 1:1 房间里的对话层,横幅「主力电脑「名字」离线」+「换一台电脑继续」。选中电脑后服务器改主力电脑,+ * 那台电脑自动接手;手机等它在伙伴列表里出现后,像普通点按一样打开那台电脑上的伙伴。+ */+export function CloudCompanionScreen({ actorId, botId, deviceId, deviceName, title }: {+ actorId: string; botId: string; deviceId: string; deviceName: string; title: string;+}) {+ const { t } = useTranslation();+ const { colors } = useTheme();+ const styles = useThemedStyles(makeStyles);+ const router = useRouter();+ const { user } = useAuth();+ const { readDeviceList } = useDeviceLink();+ const revoked = useRevokedDevices();+ const navigation = useTeammateNavigation();+ const home = useCloudCompanionHome(true);+ const actor = home.actors.find(candidate => candidate.id === actorId) ?? null;+ const name = actor?.name || title;+ const currentHome = actor?.homeDeviceId ?? deviceId;+ const room = useCloudCompanionRoom(actorId, name, true);+ const { colors: userBubbleColors } = useUserBubbleAppearance();+ const cached = cachedBotItem(user?.id ?? '', TEAMMATE_COLLECTION_ID, deviceId, botId);+ const imageUrl = useMemo(() => {+ try { return actor?.avatar ? chatHttpsUrl(actor.avatar) : null; } catch { return null; }+ }, [actor?.avatar]);++ // Computer names seen in the latest device list (conflict / waiting copy).+ const [names, setNames] = useState<ReadonlyMap<string, string>>(() => new Map([[deviceId, deviceName]]));+ const deviceLabel = (id: string | null) => (id && names.get(id)) || t('devices.cloudCompanion.unknownDevice');+ const homeName = currentHome === deviceId ? deviceName || deviceLabel(currentHome) : deviceLabel(currentHome);+ const homeOffline = t('devices.cloudCompanion.homeOffline', { device: homeName });++ const [candidates, setCandidates] = useState<CloudSwitchCandidate[]>([]);+ const [picker, setPicker] = useState(false);+ const [loadingDevices, setLoadingDevices] = useState(false);+ const [notice, setNotice] = useState<Notice>(null);+ const pendingChoice = useRef<CloudSwitchCandidate | null>(null);+ const [switching, setSwitching] = useState<CloudSwitchState>({ phase: 'idle' });+ const switchingRef = useRef(switching); switchingRef.current = switching;+ const mounted = useRef(true);+ useEffect(() => { mounted.current = true; return () => { mounted.current = false; }; }, []);++ const openPicker = async () => {+ if (loadingDevices) return;+ setNotice(null); setLoadingDevices(true);+ try {+ const response = await readDeviceList();+ if (!mounted.current) return;+ const rows = toDeviceListItems(response.devices, Date.now(), revoked);+ setNames(new Map([[deviceId, deviceName], ...rows.map(row => [row.device.deviceId, row.device.name] as const)]));+ const next = cloudSwitchCandidates(rows, currentHome);+ setCandidates(next);+ if (next.length) setPicker(true); else setNotice('noTargets');+ } catch {+ if (mounted.current) setNotice('devicesFailed');+ } finally { if (mounted.current) setLoadingDevices(false); }+ };++ const moveTo = async (target: CloudSwitchCandidate) => {+ setNotice(null);+ setSwitching({ phase: 'requesting', target });+ try {+ const result = await home.setHome(actorId, target.deviceId, currentHome);+ if (!mounted.current) return;+ const next = cloudSwitchAfterSetHome(target, result, Date.now());+ setSwitching(next);+ if (next.phase === 'conflict') void home.refresh();+ } catch {+ if (mounted.current) setSwitching({ phase: 'failed', target });+ }+ };++ // Watch the roster only while the new main computer is getting ready.+ const waiting = switching.phase === 'waiting';+ const roster = useTeammateRoster(waiting);+ const rosterRef = useRef(roster); rosterRef.current = roster;+ const openTeammate = useRef(navigation.openTeammate); openTeammate.current = navigation.openTeammate;+ const tick = useCallback(() => {+ // Only a read of that computer made while waiting counts; a cached row is not the arrival.+ const { state, arrived } = cloudSwitchTick(switchingRef.current, rosterRef.current.items, botId, Date.now(),+ row => rosterRef.current.isOnline(row.host));+ if (arrived) {+ switchingRef.current = { phase: 'idle' };+ setSwitching(switchingRef.current);+ void openTeammate.current(arrived, { replace: true });+ } else if (state !== switchingRef.current) setSwitching(state);+ }, [botId]);+ // Every roster change may be the arrival; the interval re-reads the roster and enforces the timeout.+ useEffect(() => { if (waiting) tick(); });+ useEffect(() => {+ if (!waiting) return;+ const timer = setInterval(() => { void rosterRef.current.refresh(); tick(); }, CLOUD_SWITCH_POLL_MS);+ return () => clearInterval(timer);+ }, [tick, waiting]);++ // Timeline: newest at the bottom; older pages load near the top.+ const messages = useMemo(() => cloudCompanionMessages(room.messages, actorId), [actorId, room.messages]);+ const scrollRef = useRef<ScrollView>(null);+ const stickToBottom = useRef(true);+ const onScroll = (event: NativeSyntheticEvent<NativeScrollEvent>) => {+ const { contentOffset, contentSize, layoutMeasurement } = event.nativeEvent;+ stickToBottom.current = contentSize.height - contentOffset.y - layoutMeasurement.height < STICK_TO_BOTTOM_PX;+ if (contentOffset.y < LOAD_OLDER_THRESHOLD_PX && room.before && !room.loadingOlder && contentSize.height > layoutMeasurement.height) {+ stickToBottom.current = false;+ void room.loadOlder();+ }+ };++ const avatar = (size: number) => <RemoteCompanionAvatar avatar={cached?.display.avatar} imageUrl={imageUrl} deviceId={deviceId} name={name}+ online={false} size={size} framed />;++ const status = (() => {+ switch (switching.phase) {+ case 'waiting':+ return <View accessibilityLiveRegion="polite" style={styles.statusBlock} testID="cloudCompanion.waiting">+ <View style={styles.statusRow}>+ <ActivityIndicator color={colors.textSecondary} />+ <Text style={styles.statusStrong}>{t('devices.cloudCompanion.preparing', { device: switching.target.name })}</Text>+ </View>+ <Text style={styles.bannerCopy}>{t('devices.cloudCompanion.preparingHint')}</Text>+ </View>;+ case 'timeout':+ return <Text accessibilityRole="alert" style={styles.bannerCopy} testID="cloudCompanion.timeout">+ {t('devices.cloudCompanion.timeout', { device: switching.target.name })}</Text>;+ case 'conflict':+ return <Text accessibilityRole="alert" style={styles.bannerCopy} testID="cloudCompanion.conflict">+ {t('devices.cloudCompanion.conflict', { name, device: deviceLabel(switching.homeDeviceId) })}</Text>;+ case 'failed':+ return <Text accessibilityRole="alert" style={styles.bannerCopy} testID="cloudCompanion.failed">{t('devices.cloudCompanion.switchFailed')}</Text>;+ default:+ return notice ? <Text accessibilityRole="alert" style={styles.bannerCopy} testID={`cloudCompanion.${notice}`}>+ {t(`devices.cloudCompanion.${notice}`)}</Text> : null;+ }+ })();++ let timeline;+ if (room.status === 'loading') {+ timeline = <View style={styles.center}><ActivityIndicator color={colors.textSecondary} /></View>;+ } else if (room.status === 'error') {+ timeline = <View style={styles.center} testID="cloudCompanion.loadFailed">+ <Text style={styles.centerText}>{t('devices.cloudCompanion.loadFailed')}</Text>+ <CompanionCardActions>+ <CompanionCardButton label={t('devices.resources.retry')} onPress={() => { void room.reload(); }} testID="cloudCompanion.reload" />+ </CompanionCardActions>+ </View>;+ } else {+ timeline = <ScrollView ref={scrollRef} style={styles.flex} contentContainerStyle={styles.timeline}+ maintainVisibleContentPosition={{ minIndexForVisible: 1 }}+ onScroll={onScroll} scrollEventThrottle={64}+ onContentSizeChange={() => { if (stickToBottom.current) scrollRef.current?.scrollToEnd({ animated: false }); }}+ testID="cloudCompanion.timeline">+ <View style={styles.olderSlot}>+ {room.loadingOlder ? <ActivityIndicator color={colors.textTertiary} testID="cloudCompanion.loadingOlder" />+ : room.before ? <CompanionCardActions>+ <CompanionCardButton label={t('devices.cloudCompanion.loadOlder')} onPress={() => { stickToBottom.current = false; void room.loadOlder(); }}+ testID="cloudCompanion.loadOlder" />+ </CompanionCardActions> : null}+ </View>+ {messages.length === 0 ? <Text style={styles.centerText} testID="cloudCompanion.empty">{t('devices.cloudCompanion.empty')}</Text> : null}+ {messages.map((message, index) => {+ if (!message.fromCompanion) return <View key={message.id} style={styles.userRow} testID="cloudCompanion.message.user">+ <View style={[styles.userBubble, userBubbleColors && { backgroundColor: userBubbleColors.background, borderColor: userBubbleColors.border }]}>+ <BotGroupUserText content={message.text} mentionLabels={NO_MENTIONS} />+ </View>+ </View>;+ const continued = index > 0 && messages[index - 1]!.fromCompanion;+ return <View key={message.id} style={[styles.replyRow, continued && styles.replyRowContinued]} testID="cloudCompanion.message.companion">+ {continued ? <View style={styles.avatarSpacer} /> : <View style={styles.avatarSlot}>{avatar(BOT_GROUP_MESSAGE_AVATAR_SIZE)}</View>}+ <View style={styles.replyColumn}><BotGroupMarkdownText content={message.text} /></View>+ </View>;+ })}+ </ScrollView>;+ }++ const busy = loadingDevices || switching.phase === 'requesting';+ return <SafeAreaView style={styles.screen} edges={['top', 'left', 'right', 'bottom']} testID="cloudCompanion.screen">+ <Stack.Screen options={{ headerShown: false }} />+ <ChatIdentityHeader testIDPrefix="cloudCompanion"+ mark={avatar(CHAT_HEADER_MARK_SIZE)}+ title={name}+ subtitle={<View style={styles.subtitleRow}>+ <View style={styles.presenceOff} testID="cloudCompanion.header.presence" />+ <ChatIdentitySubtitle>{homeOffline}</ChatIdentitySubtitle>+ </View>}+ identityLabel={[name, homeOffline].join(', ')}+ onBack={() => goBackGuarded(router)} />+ <View style={styles.banner} testID="cloudCompanion.banner">+ <Text style={styles.bannerTitle}>{homeOffline}</Text>+ {status ?? <Text style={styles.bannerCopy}>{t('devices.cloudCompanion.readOnlyNote')}</Text>}+ {waiting ? null : <CompanionCardActions>+ {switching.phase === 'timeout' ? <CompanionCardButton label={t('devices.resources.retry')} testID="cloudCompanion.retryWait"+ onPress={() => setSwitching({ phase: 'waiting', target: switching.target, since: Date.now() })} /> : null}+ <CompanionCardButton primary busy={busy} label={t('devices.cloudCompanion.switchAction')} testID="cloudCompanion.switch"+ onPress={() => { void openPicker(); }} />+ </CompanionCardActions>}+ </View>+ {timeline}+ <View style={styles.footer} testID="cloudCompanion.composerHint">+ <Text style={styles.footerText}>{t('devices.cloudCompanion.composerHint')}</Text>+ </View>+ <CompanionSheet visible={picker} title={t('devices.cloudCompanion.switchAction')} testID="cloudCompanion.picker"+ onClose={() => { pendingChoice.current = null; setPicker(false); }}+ onClosed={() => { const choice = pendingChoice.current; pendingChoice.current = null; if (choice) void moveTo(choice); }}>+ {candidates.map(candidate => <CompanionSettingsRow key={candidate.deviceId} icon={null} label={candidate.name}+ testID={`cloudCompanion.picker.${candidate.deviceId}`}+ onPress={() => { pendingChoice.current = candidate; setPicker(false); }} />)}+ </CompanionSheet>+ </SafeAreaView>;+}++const makeStyles = (colors: ThemeColors) => StyleSheet.create({+ screen: { flex: 1, backgroundColor: colors.surface },+ flex: { flex: 1 },+ subtitleRow: { flexDirection: 'row', alignItems: 'center', gap: spacing.xs },+ presenceOff: { width: PRESENCE_DOT, height: PRESENCE_DOT, borderRadius: radius.pill, backgroundColor: colors.borderStrong },+ // Card shell (mobile guide §4): elevated surface, 1px border, container radius, 16 padding.+ banner: { marginHorizontal: spacing.lg, marginBottom: spacing.sm, padding: spacing.lg, gap: spacing.xs, backgroundColor: colors.surfaceElevated,+ borderColor: colors.border, borderWidth: StyleSheet.hairlineWidth, borderRadius: radius.container },+ // Row title role: 16/22 medium.+ bannerTitle: { color: colors.textPrimary, fontSize: typeScale.body, lineHeight: lineHeight.body, fontWeight: fontWeight.medium },+ // Explanation role: 13/18 regular secondary.+ bannerCopy: { color: colors.textSecondary, fontSize: typeScale.footnote, lineHeight: lineHeight.caption },+ statusBlock: { gap: spacing.xs },+ statusRow: { flexDirection: 'row', alignItems: 'center', gap: spacing.sm },+ statusStrong: { flexShrink: 1, color: colors.textPrimary, fontSize: typeScale.footnote, lineHeight: lineHeight.caption },+ center: { flex: 1, alignItems: 'center', justifyContent: 'center', padding: spacing.xl, gap: spacing.sm },+ centerText: { color: colors.textTertiary, fontSize: typeScale.footnote, lineHeight: lineHeight.caption, textAlign: 'center' },+ timeline: { flexGrow: 1, justifyContent: 'flex-end', gap: spacing.lg, paddingHorizontal: spacing.lg, paddingVertical: spacing.md },+ olderSlot: { alignItems: 'center' },+ userRow: { flexDirection: 'row', justifyContent: 'flex-end' },+ // The 1:1 user bubble: 86% wide, padding 12.+ userBubble: { maxWidth: '86%', backgroundColor: colors.surfaceElevated, borderColor: colors.border, borderWidth: StyleSheet.hairlineWidth,+ borderRadius: radius.container, padding: spacing.md },+ replyRow: { flexDirection: 'row', alignItems: 'flex-start', gap: REPLY_AVATAR_GAP },+ replyRowContinued: { marginTop: -spacing.sm },+ avatarSlot: { marginTop: 2 },+ avatarSpacer: { width: BOT_GROUP_MESSAGE_AVATAR_SIZE },+ replyColumn: { flex: 1, minWidth: 0 },+ // Where the composer would be: a quiet, disabled-looking strip with the explanation.+ footer: { marginHorizontal: spacing.lg, marginTop: spacing.xs, marginBottom: spacing.sm, minHeight: 44, justifyContent: 'center',+ paddingHorizontal: spacing.lg, paddingVertical: spacing.sm, borderRadius: radius.pill, backgroundColor: colors.surfaceChip },+ footerText: { color: colors.textSecondary, fontSize: typeScale.footnote, lineHeight: lineHeight.caption, textAlign: 'center' },+});diff --git a/apps/mobile/src/session/TeammateHomeScreen.tsx b/apps/mobile/src/session/TeammateHomeScreen.tsxindex a2336b37e3..36276d501c 100644--- a/apps/mobile/src/session/TeammateHomeScreen.tsx+++ b/apps/mobile/src/session/TeammateHomeScreen.tsx@@ -29,10 +29,14 @@ import { useTeammateRoster } from './useTeammateRoster';import { useBotGroupRoster } from './useBotGroupRoster';import { useTeammateNavigation } from './useTeammateNavigation';import { remoteSessionStore } from './remoteSessionStore';+import { cloudActorForRow, cloudCompanionRows } from '@/chat/cloudCompanion';+import { useCloudCompanionHome } from '@/chat/useCloudCompanion';+import { cloudCompanionRoute } from './teammateNavigation';+import type { HostedRemoteCollectionItem } from '@/device-link/remoteResources';/** The teammate home is the roster: launch and every entry land on the list, never inside a chat. */export function TeammateHomeScreen({ active = true }: { active?: boolean }) {- const { t } = useTranslation();+ const { t, i18n } = useTranslation();const auth = useAuth();const styles = useThemedStyles(makeStyles);const { colors } = useTheme();@@ -46,6 +50,17 @@ export function TeammateHomeScreen({ active = true }: { active?: boolean }) {const ownGroups = useBotGroupRoster(ownRoster.groupTargets, focused && !sharedRoster);const roster = sharedRoster?.roster ?? ownRoster;const groups = sharedRoster?.groups ?? ownGroups;+ // Main computers (cloud-companions.md): only with a server that declares companionHome.+ const cloud = useCloudCompanionHome(focused);+ // One row per companion, under its main computer (a row built from the cloud when none is listed).+ const items = useMemo(() => cloud.supported ? cloudCompanionRows(roster.items, cloud.actors, cloud.deviceNames) : roster.items,+ [cloud.actors, cloud.deviceNames, cloud.supported, roster.items]);+ const cloudActor = (row: HostedRemoteCollectionItem) => cloud.supported && !roster.isOnline(row.host) ? cloudActorForRow(cloud.actors, row) : null;+ // A companion moved by another device shows up as changed roster rows (a new row, or a cached+ // row whose computer re-listed it): re-read the main computers then, not only on focus.+ const listedCompanions = roster.items.map(row => `${row.key}\t${row.item.revision}`).sort().join('\n');+ const refreshCloud = cloud.refresh;+ useEffect(() => { if (cloud.supported) void refreshCloud(); }, [cloud.supported, listedCompanions, refreshCloud]);const counts = useHomeUnreadCounts();const [drawer, setDrawer] = useState(false);const [accounts, setAccounts] = useState(false);@@ -142,14 +157,19 @@ export function TeammateHomeScreen({ active = true }: { active?: boolean }) {</View></View></>}- <TeammateList key={searchEpoch} {...roster}+ <TeammateList key={searchEpoch} {...roster} items={items}+ cloudOpenable={(row) => !!cloudActor(row)}topInset={nativeHeader ? headerHeight : undefined}notice={navigation.saveFailed ? <Text accessibilityRole="alert" style={styles.notice}>{t('devices.companions.preferenceSaveFailed')}</Text> : null} autoFocusSearch={searchEpoch > 0}loading={roster.items.length + groups.items.length === 0 && (roster.loading || groups.loading)}refreshing={roster.refreshing || groups.refreshing}error={groups.error ?? roster.error}- onRefresh={() => { void roster.refresh(); if (groups.supported) void groups.refresh(); }}- onSelect={(item) => { void navigation.openTeammate(item); }}+ onRefresh={() => { void roster.refresh(); void cloud.refresh(); if (groups.supported) void groups.refresh(); }}+ onSelect={(item) => {+ const actor = cloudActor(item);+ if (actor) { Keyboard.dismiss(); push(cloudCompanionRoute(item, actor.id, i18n.language)); }+ else void navigation.openTeammate(item);+ }}groups={groups.supported || groups.items.length > 0 ? {items: groups.items,isOnline: groups.isOnline,diff --git a/apps/mobile/src/session/TeammateList.tsx b/apps/mobile/src/session/TeammateList.tsxindex 737d88eaa2..802a457e36 100644--- a/apps/mobile/src/session/TeammateList.tsx+++ b/apps/mobile/src/session/TeammateList.tsx@@ -50,6 +50,11 @@ export interface TeammateListProps {error: string | null;isOnline(host: RemoteResourceHostTarget): boolean;connectionState?(host: RemoteResourceHostTarget): boolean | null;+ /**+ * The row's computer is the companion's main computer and the server keeps its cloud+ * conversation: an offline row stays openable (docs/product-rules/cloud-companions.md §3.1).+ */+ cloudOpenable?(row: HostedRemoteCollectionItem): boolean;onRefresh(): void;onSelect(item: HostedRemoteCollectionItem): void;/** SheetSurface already owns the scroll view. */@@ -85,7 +90,7 @@ function useAwaitingSessions(items: readonly HostedRemoteCollectionItem[]): Read}/** Identity list shared by home (with group chats) and the collection route. No host headings. */-export function TeammateList({ items, loading, refreshing, error, isOnline, connectionState, onRefresh, onSelect,+export function TeammateList({ items, loading, refreshing, error, isOnline, connectionState, cloudOpenable, onRefresh, onSelect,embedded = false, autoFocusSearch = false, onInteract, groups, emptyAction, scrollInsetProps, topInset, notice }: TeammateListProps) {const { t, i18n } = useTranslation();const { user } = useAuth();@@ -177,7 +182,9 @@ export function TeammateList({ items, loading, refreshing, error, isOnline, connconst timestamp = display.timestamp;const time = timestamp !== undefined && Number.isFinite(new Date(timestamp).getTime())? formatRemoteSessionSidebarTime(new Date(timestamp).toISOString(), now) : '';- const connection = connected === false ? t('devices.resources.hostOffline') : connected === null ? t('devices.resources.connectionUnknown') : '';+ const cloud = !online && !!cloudOpenable?.(row);+ const connection = cloud ? t('devices.cloudCompanion.homeOffline', { device: row.host.deviceName })+ : connected === false ? t('devices.resources.hostOffline') : connected === null ? t('devices.resources.connectionUnknown') : '';const prefix = attention || (waiting ? t('devices.companions.awaiting') : '');return <CompanionListRow key={`bot:${row.key}`} testID={`teammates.item.${row.host.deviceId}.${row.item.ref.id}`}accessibilityLabel={[title, ambiguous ? row.host.deviceName : '', connection, prefix, generating ? workingCopy : summary, time,diff --git a/apps/mobile/src/session/teammateNavigation.ts b/apps/mobile/src/session/teammateNavigation.tsindex be46181ecf..9081e8174d 100644--- a/apps/mobile/src/session/teammateNavigation.ts+++ b/apps/mobile/src/session/teammateNavigation.ts@@ -45,6 +45,21 @@ export function teammateResourceRoute(hosted: HostedRemoteCollectionItem, locale};}+/**+ * The read-only cloud view of a companion whose main computer is offline+ * (docs/product-rules/cloud-companions.md §3.1). The row's computer is that main computer.+ */+export function cloudCompanionRoute(hosted: HostedRemoteCollectionItem, actorId: string, locale: string) {+ return {+ pathname: '/companions/cloud/[actorId]' as const,+ params: {+ actorId, botId: hosted.item.ref.id,+ deviceId: hosted.host.deviceId, deviceName: hosted.host.deviceName,+ title: resolveRemoteText(hosted.item.display.title, locale),+ },+ };+}+/** Reuse the actual home route; retired collection routes are replaced. */export function homeDismissCount(routes: readonly { name: string; params?: unknown }[]): number | null {for (let index = routes.length - 1; index >= 0; index--) {diff --git a/apps/mobile/src/session/useTeammateNavigation.ts b/apps/mobile/src/session/useTeammateNavigation.tsindex 5ebfd6435b..98a08cf244 100644--- a/apps/mobile/src/session/useTeammateNavigation.ts+++ b/apps/mobile/src/session/useTeammateNavigation.ts@@ -49,7 +49,8 @@ export function useTeammateNavigation() {}} finally { if (pendingAccount.current === accountGeneration) pendingAccount.current = null; }}, [accountGeneration, navigation, preferences.setMode, router]);- const openTeammate = useCallback(async (hosted: HostedRemoteCollectionItem) => {+ /** `replace` swaps the current screen (the cloud view handing over to the new main computer). */+ const openTeammate = useCallback(async (hosted: HostedRemoteCollectionItem, options?: { replace?: boolean }) => {const identity = teammateIdentity(hosted);if (!identity || pendingAccount.current === accountGeneration) return;// Fence rapid taps before the async preference write, not only at router.push.@@ -69,10 +70,12 @@ export function useTeammateNavigation() {&& !remoteSessionStore.getSessionDeviceId(preview.id)) {remoteSessionStore.upsertDeviceSession(hosted.host.deviceId, hosted.host.deviceName, preview);}- push(teammateResourceRoute(hosted, i18n.language));+ const route = teammateResourceRoute(hosted, i18n.language);+ if (options?.replace) router.replace(route);+ else push(route);}} finally { if (pendingAccount.current === accountGeneration) pendingAccount.current = null; }- }, [accountGeneration, i18n.language, preferences.selectTeammate, push, user?.id]);+ }, [accountGeneration, i18n.language, preferences.selectTeammate, push, router, user?.id]);const openCreatedTeammate = useCallback(async (host: RemoteResourceHostTarget, ref: RemoteResourceRef) => {if (!mounted.current || current.current !== accountGeneration || !host.deviceId || !ref.id || !ref.collectionId|| ref.kind !== 'bot' || pendingAccount.current === accountGeneration) return;diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.mdindex 2d04262744..a4fa948957 100644--- a/docs/design-rules/design-inventory.md+++ b/docs/design-rules/design-inventory.md@@ -11,14 +11,14 @@计数快照日期:2026-10-14。生成命令:`pnpm design:inventory`。裸颜色匹配与 `scripts/hardcoded-color-audit.mjs` 共用 `scripts/shared/hardcoded-color-match.mjs`(HEX / RGB / HSL / OKLCH 等字面通道),两者在共享 matcher 内统一排除纯语义包装、注释及 PR 编号;数值颜色函数还需位于样式属性、CSS 声明/函数或任意值语境,普通文案字符串里的颜色函数文本不计入;字面 fallback 仍计入——语义 token 消费与注释引用不是迁移债务;裸圆角为粗粒度(`rounded*` class、`border-radius:` 与 React style 对象的 `borderRadius:`)。Token 计数为样式源里 `var(--token)` / `hsl(var(--token)` 的去重 ID 数;Mobile 的 ThemeColors / typeScale 等 RN 属性不计入此列,不能将 0 解释为未使用 Token。-登记 surface 数:52。平台包含 Desktop 与 Mobile;静态入口发现不表示已迁移或已实机验证。+登记 surface 数:53。平台包含 Desktop 与 Mobile;静态入口发现不表示已迁移或已实机验证。| ID | 平台 | 标题 | 生产入口 | 可达组件 | 样式来源 | Token 数 | 裸颜色 | 裸圆角 || --- | --- | --- | --- | --- | --- | ---: | ---: | ---: || `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/ChatLoadingImage.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/BotGroupQuote.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 | 477 |+| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊 / 群聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊、伙伴群聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentOnOtherDeviceContext.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatLoadingImage.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/BotGroupQuote.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/BotHomeComputerSetting.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/CloudCompanionOfflineView.tsx, apps/desktop/src/renderer/features/bots/CompanionShadowBanner.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/companionCloudPresentation.ts, apps/desktop/src/renderer/features/bots/companionCloudStore.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 | 481 || `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/ChatLoadingImage.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 | 337 |@@ -56,6 +56,7 @@| `mobile.chat.new` | mobile | 新建任务 | app/sessions/new.tsx | AdaptiveWindow, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AnnotationBurnInWebView, AppText, AuthContext, BlurBackdrop, CenteredScreen, ClipboardSharedTaskPrompt, CompanionNativeContent.ios, ComposerActivityPill, ComposerAttachmentTray, ComposerDockKeyboardFollow, ComposerFrame, ComposerFrame.ios, ComposerKeyboardAvoidingView, ComposerNativeRow, ComposerNativeRow.ios, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, ContextSheetCollabView, ContextSheetGoalView, ContextSheetGoalView.ios, ContextSheetMediaViews, ContextSheetPlugins, DeviceLinkContext, FileTypeIcon, FoldTouchpad, HomeEntryProvider, HomeHeaderGlassButton, HomeHeaderGlassButton.ios, HomeNativeStackHeader, HomeStackHeader, ImageLightbox, IncomingShareBridge, MobileAgentMark, MobileAgentSwitcher, MobileChoicePickerList, MobileComposerInputRow, MobileLoginHandoffContext, MobileLoginHandoffStage, MobileModelPickerList, MobileModelPickerList.ios, MobileOutboxBridge, MobilePermissionPickerList, MobilePermissionPickerList.ios, MobilePrimitives, MobileProviderMark, MobileVendorIcon, ModelOptionsSheetView, ModelOptionsSheetView.ios, ModelPickerNativeHeader, ModelPickerNativeHeader.ios, ModelPickerSheet, NativeBottomSheet, NativeBottomSheet.android, NativeChromeBackButton.ios, NativeChromeButton.ios, NativePermissionSheet, NativePermissionSheet.ios, NativePullDownMenu, NativeRemoteDesktopView, NativeResidentHistory, NativeSwitch, NativeVideoPlayer, NewTaskSelectionRow, NewTaskSelectionSheet, NewTaskSelectionSheet.android, NewTaskSelectionSheet.ios, OrcaWorkerDirectoryPicker, OutsideTap, PaperPlaneIcon, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PlanModeChip, 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, SlowSendNotice, StartupSplashOverlay, ThemeProvider, UnifiedModelPickerSheet, UnifiedModelPickerView, UnifiedModelPickerView.ios, VoiceRecordingPill, _layout, composerPullThrough, gestureHandler, mediaPlayerWebView, nativeToolbarMenuItems, new, peerFileTransport, useLocale, voicePillWidthMotion | apps/mobile/app/_layout.tsx, apps/mobile/app/sessions/new.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/FileTypeIcon.tsx, apps/mobile/src/components/MobileAgentMark.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/MobileVendorIcon.tsx, apps/mobile/src/components/PaperPlaneIcon.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/HomeStackHeader.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/chrome/nativeToolbarMenuItems.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/AnnotationBurnInWebView.tsx, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ClipboardSharedTaskPrompt.tsx, apps/mobile/src/session/CompanionNativeContent.ios.tsx, apps/mobile/src/session/ComposerActivityPill.tsx, apps/mobile/src/session/ComposerAttachmentTray.tsx, apps/mobile/src/session/ComposerDockKeyboardFollow.tsx, apps/mobile/src/session/ComposerFrame.ios.tsx, apps/mobile/src/session/ComposerFrame.tsx, apps/mobile/src/session/ComposerKeyboardAvoidingView.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/ContextSheetCollabView.tsx, apps/mobile/src/session/ContextSheetGoalView.ios.tsx, apps/mobile/src/session/ContextSheetGoalView.tsx, apps/mobile/src/session/ContextSheetMediaViews.tsx, apps/mobile/src/session/ContextSheetPlugins.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/HomeHeaderGlassButton.ios.tsx, apps/mobile/src/session/HomeHeaderGlassButton.tsx, apps/mobile/src/session/ImageLightbox.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/MobileAgentSwitcher.tsx, apps/mobile/src/session/MobileChoicePickerList.tsx, apps/mobile/src/session/MobileComposerInputRow.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/NativePermissionSheet.ios.tsx, apps/mobile/src/session/NativePermissionSheet.tsx, apps/mobile/src/session/NativeResidentHistory.tsx, apps/mobile/src/session/NativeVideoPlayer.tsx, apps/mobile/src/session/NewTaskSelectionRow.tsx, apps/mobile/src/session/NewTaskSelectionSheet.android.tsx, apps/mobile/src/session/NewTaskSelectionSheet.ios.tsx, apps/mobile/src/session/NewTaskSelectionSheet.tsx, apps/mobile/src/session/OrcaWorkerDirectoryPicker.tsx, apps/mobile/src/session/PlanModeChip.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/SlowSendNotice.tsx, apps/mobile/src/session/UnifiedModelPickerSheet.tsx, apps/mobile/src/session/UnifiedModelPickerView.ios.tsx, apps/mobile/src/session/UnifiedModelPickerView.tsx, apps/mobile/src/session/VoiceRecordingPill.tsx, apps/mobile/src/session/composerPullThrough.tsx, apps/mobile/src/session/mediaPlayerWebView.tsx, apps/mobile/src/session/mediaPlayerWebViewHtml.ts, apps/mobile/src/session/voicePillWidthMotion.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 | 251 | 114 || `mobile.chat.session` | mobile | 任务内容与输入 | app/sessions/[sessionId].tsx | AccountSwitcherSheet, AdaptiveWindow, AgentErrorDetails, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AnnotationBurnInWebView, AppText, AuthContext, AuthorizationMessageCard, AutomationTimerIcon, BlurBackdrop, CenteredScreen, ChatFileChipMenuSheet, ChatIdentityHeader, CindyMakeSessionGate, ClipboardSharedTaskPrompt, CompanionChoice, CompanionCreateNativeView, CompanionCreateNativeView.ios, CompanionEntering, CompanionHeader, CompanionImportSheet, CompanionLearningFooter, CompanionMemoryPage, CompanionMemoryPage.ios, CompanionMessageActions, CompanionMessageCard, CompanionModelChain, CompanionNativeContent.ios, CompanionPortraitPicker, CompanionPresenceRing, CompanionProfileArtifacts, CompanionProfileNativeView, CompanionProfileNativeView.ios, CompanionProfileSheet, CompanionSettingsRow, CompanionSettingsRow.ios, CompanionSheet, CompanionSheet.ios, CompanionTaskResultCard, CompanionTodoRow, CompanionTodos, CompanionWorkingStatus, ComposerActivityPill, ComposerAttachmentTray, ComposerDockKeyboardFollow, ComposerExpandButton, ComposerExpandButton.ios, ComposerFrame, ComposerFrame.ios, ComposerKeyboardAvoidingView, ComposerMorphSource, ComposerMorphSource.ios, ComposerNativeInput, ComposerNativeInput.ios, ComposerNativeRow, ComposerNativeRow.ios, ComposerNativeSection, ComposerNativeSection.ios, ComposerRichInput, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, ContextSheetCollabView, ContextSheetGoalView, ContextSheetGoalView.ios, ContextSheetMediaViews, ContextSheetPlugins, ConversationSearchFilterSheet, ConversationShareSvg, ConversationShareWebView, DeviceLinkContext, FailedScheduleNotice, FileTypeIcon, FoldTouchpad, HomeChromeDrawer, HomeChromeFrost, HomeEntryProvider, HomeGlassMenuPanel, HomeHeaderGlassButton, HomeHeaderGlassButton.ios, HomeListVisuals, HomeModeSwitch, HomeNativeStackHeader, HomeNewTaskButton, HomeProjectMachineLabel, HomeSearchBar, HomeSessionInfoMeta, HomeStackHeader, HomeSurface, HomeUnreadContext, ImageLightbox, IncomingShareBridge, InlineQueueSection, InlineQuoteChip, InlineReferenceChip, InputHandoffCard, InputHandoffDeviceCode, InputHandoffPictureStep, InputHandoffQrCode, InputHandoffRecordRow, InputHandoffSheet, InputHandoffSheet.ios, InputHandoffStepFields, InteractionPanel, MarkdownBlockContent, MessageActionSheet, MessageLoadingImage, MessageRenderer, MobileAgentMark, MobileAgentSwitcher, MobileBoundaryNotice, MobileComposerInputRow, MobileLoginHandoffContext, MobileLoginHandoffStage, MobileModelPickerList, MobileModelPickerList.ios, MobileOutboxBridge, MobilePermissionPickerList, MobilePermissionPickerList.ios, MobilePrimitives, MobileProviderMark, MobileUserAvatar, MobileVendorIcon, ModalContentArea, ModelOptionsSheetView, ModelOptionsSheetView.ios, ModelPickerNativeHeader, ModelPickerNativeHeader.ios, ModelPickerSheet, MountOnFirstOpen, NativeBottomSheet, NativeBottomSheet.android, NativeChromeBackButton, NativeChromeBackButton.ios, NativeChromeButton.ios, NativePermissionSheet, NativePermissionSheet.ios, NativePullDownMenu, NativeRemoteDesktopView, NativeResidentHistory, NativeSwitch, NativeVideoPlayer, NewTaskSelectionRow, NewTaskSelectionSheet, NewTaskSelectionSheet.android, NewTaskSelectionSheet.ios, OrcaWorkerDirectoryPicker, OutsideTap, PaperPlaneIcon, PendingSendBubble, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PlanModeChip, PluginCardActions, PluginInvocationHeader, PluginMenuUnreadDot, PluginSetupNativeActions, PluginSetupNativeForm, PromptRecommendation, PushNotificationsBridge, QuietSyncIndicator, QuoteCapsule, ReadableHistoryRecovery, RecentMessageHistories, RemoteAccessGuide, 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, RemoteTaskSuggestions, RenameSessionModal, ResidentHomeList, RewindPreviewPanel, RunningTokenRatePopover, SentInlineAtomBody, SessionActionSheet, SessionActionSheetFrame, SessionActionSheetFrame.android, SessionDetailsNative, SessionDetailsNative.ios, SessionHeaderNativeControls, SessionHeaderNativeControls.ios, SessionListDrawer, SessionMenuSheet, SessionOptionsExpoSheet, SessionResourceCards, SessionRightSpinner, SessionSearchNative, SessionSearchNative.ios, SessionTailBanner, SessionTransientNotice, SessionUsageSummary, ShareImageNativeButton, ShareImageNativeButton.ios, ShareMessageCheckbox, ShareSelectAllButton, ShareSelectionBar, SharedTaskAdmissionDialog, SharedTaskEndedState, SharedTaskScreen, SheetModal, SheetSurface, SimpleStackHeader, SlowSendNotice, StartupSplashOverlay, SwipeableSessionRow, SwipeableSessionRow.ios, SystemNavigationBack, TaskTags, TaskTagsSheet, ThemeProvider, ThinkingDots, TodoDateInput, TodoDateInput.android, TodoDateInput.ios, UnifiedModelPickerSheet, UnifiedModelPickerView, UnifiedModelPickerView.ios, VoiceRecordingPill, WorkingStatusText, [sessionId], _layout, composerPullThrough, gestureHandler, listDisclosureTransition, mathWebView, mediaPlayerWebView, mermaidWebView, nativeToolbarMenuItems, peerFileTransport, useLocale, useSharedTaskConfirmation, voicePillWidthMotion | apps/mobile/app/_layout.tsx, apps/mobile/app/sessions/[sessionId].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/FileTypeIcon.tsx, apps/mobile/src/components/MobileAgentMark.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/MobileUserAvatar.tsx, apps/mobile/src/components/MobileVendorIcon.tsx, apps/mobile/src/components/PaperPlaneIcon.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/RemoteAccessGuide.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/inputHandoff/InputHandoffCard.tsx, apps/mobile/src/inputHandoff/InputHandoffDeviceCode.tsx, apps/mobile/src/inputHandoff/InputHandoffPictureStep.tsx, apps/mobile/src/inputHandoff/InputHandoffQrCode.tsx, apps/mobile/src/inputHandoff/InputHandoffRecordRow.tsx, apps/mobile/src/inputHandoff/InputHandoffSheet.ios.tsx, apps/mobile/src/inputHandoff/InputHandoffSheet.tsx, apps/mobile/src/inputHandoff/InputHandoffStepFields.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/AdaptiveWindow.tsx, apps/mobile/src/platform/ModalContentArea.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/HomeStackHeader.tsx, apps/mobile/src/platform/chrome/NativeChromeBackButton.ios.tsx, apps/mobile/src/platform/chrome/NativeChromeBackButton.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/chrome/SystemNavigationBack.tsx, apps/mobile/src/platform/chrome/nativeToolbarMenuItems.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/plugins/PluginCardActions.tsx, apps/mobile/src/plugins/PluginMenuUnreadDot.tsx, apps/mobile/src/plugins/PluginSetupNativeActions.tsx, apps/mobile/src/plugins/PluginSetupNativeForm.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/AccountSwitcherSheet.tsx, apps/mobile/src/session/AgentErrorDetails.tsx, apps/mobile/src/session/AnnotationBurnInWebView.tsx, apps/mobile/src/session/AuthorizationMessageCard.tsx, apps/mobile/src/session/AutomationTimerIcon.tsx, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/ChatFileChipMenuSheet.tsx, apps/mobile/src/session/ChatIdentityHeader.tsx, apps/mobile/src/session/CindyMakeSessionGate.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/CompanionEntering.tsx, apps/mobile/src/session/CompanionHeader.tsx, apps/mobile/src/session/CompanionImportSheet.tsx, apps/mobile/src/session/CompanionLearningFooter.tsx, apps/mobile/src/session/CompanionMemoryPage.ios.tsx, apps/mobile/src/session/CompanionMemoryPage.tsx, apps/mobile/src/session/CompanionMessageActions.tsx, apps/mobile/src/session/CompanionMessageCard.tsx, apps/mobile/src/session/CompanionModelChain.tsx, apps/mobile/src/session/CompanionNativeContent.ios.tsx, apps/mobile/src/session/CompanionPortraitPicker.tsx, apps/mobile/src/session/CompanionPresenceRing.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/CompanionTaskResultCard.tsx, apps/mobile/src/session/CompanionTodoRow.tsx, apps/mobile/src/session/CompanionTodos.tsx, apps/mobile/src/session/CompanionWorkingStatus.tsx, apps/mobile/src/session/ComposerActivityPill.tsx, apps/mobile/src/session/ComposerAttachmentTray.tsx, apps/mobile/src/session/ComposerDockKeyboardFollow.tsx, apps/mobile/src/session/ComposerExpandButton.ios.tsx, apps/mobile/src/session/ComposerExpandButton.tsx, apps/mobile/src/session/ComposerFrame.ios.tsx, apps/mobile/src/session/ComposerFrame.tsx, apps/mobile/src/session/ComposerKeyboardAvoidingView.tsx, apps/mobile/src/session/ComposerMorphSource.ios.tsx, apps/mobile/src/session/ComposerMorphSource.tsx, apps/mobile/src/session/ComposerNativeInput.ios.tsx, apps/mobile/src/session/ComposerNativeInput.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/ComposerRichInput.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/ContextSheetCollabView.tsx, apps/mobile/src/session/ContextSheetGoalView.ios.tsx, apps/mobile/src/session/ContextSheetGoalView.tsx, apps/mobile/src/session/ContextSheetMediaViews.tsx, apps/mobile/src/session/ContextSheetPlugins.tsx, apps/mobile/src/session/ConversationSearchFilterSheet.tsx, apps/mobile/src/session/ConversationShareSvg.tsx, apps/mobile/src/session/ConversationShareWebView.tsx, apps/mobile/src/session/FailedScheduleNotice.tsx, apps/mobile/src/session/HomeChromeDrawer.tsx, apps/mobile/src/session/HomeChromeFrost.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/HomeGlassMenuPanel.tsx, apps/mobile/src/session/HomeHeaderGlassButton.ios.tsx, apps/mobile/src/session/HomeHeaderGlassButton.tsx, apps/mobile/src/session/HomeListVisuals.tsx, apps/mobile/src/session/HomeModeSwitch.tsx, apps/mobile/src/session/HomeNewTaskButton.tsx, apps/mobile/src/session/HomeProjectMachineLabel.tsx, apps/mobile/src/session/HomeSearchBar.tsx, apps/mobile/src/session/HomeSessionInfoMeta.tsx, apps/mobile/src/session/HomeSurface.tsx, apps/mobile/src/session/HomeUnreadContext.tsx, apps/mobile/src/session/ImageLightbox.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/InlineQueueSection.tsx, apps/mobile/src/session/InlineQuoteChip.tsx, apps/mobile/src/session/InlineReferenceChip.tsx, apps/mobile/src/session/InteractionPanel.tsx, apps/mobile/src/session/MarkdownBlockContent.tsx, apps/mobile/src/session/MessageActionSheet.tsx, apps/mobile/src/session/MessageLoadingImage.tsx, apps/mobile/src/session/MessageRenderer.tsx, apps/mobile/src/session/MobileAgentSwitcher.tsx, apps/mobile/src/session/MobileBoundaryNotice.tsx, apps/mobile/src/session/MobileComposerInputRow.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/MountOnFirstOpen.tsx, apps/mobile/src/session/NativeBottomSheet.android.tsx, apps/mobile/src/session/NativeBottomSheet.tsx, apps/mobile/src/session/NativePermissionSheet.ios.tsx, apps/mobile/src/session/NativePermissionSheet.tsx, apps/mobile/src/session/NativeResidentHistory.tsx, apps/mobile/src/session/NativeVideoPlayer.tsx, apps/mobile/src/session/NewTaskSelectionRow.tsx, apps/mobile/src/session/NewTaskSelectionSheet.android.tsx, apps/mobile/src/session/NewTaskSelectionSheet.ios.tsx, apps/mobile/src/session/NewTaskSelectionSheet.tsx, apps/mobile/src/session/OrcaWorkerDirectoryPicker.tsx, apps/mobile/src/session/PendingSendBubble.tsx, apps/mobile/src/session/PlanModeChip.tsx, apps/mobile/src/session/PluginInvocationHeader.tsx, apps/mobile/src/session/PromptRecommendation.tsx, apps/mobile/src/session/QuoteCapsule.tsx, apps/mobile/src/session/ReadableHistoryRecovery.tsx, apps/mobile/src/session/RecentMessageHistories.tsx, apps/mobile/src/session/RemoteHistoryPrefetchBridge.tsx, apps/mobile/src/session/RemoteSourceMark.tsx, apps/mobile/src/session/RemoteTaskSuggestions.tsx, apps/mobile/src/session/RenameSessionModal.tsx, apps/mobile/src/session/ResidentHomeList.tsx, apps/mobile/src/session/RewindPreviewPanel.tsx, apps/mobile/src/session/RunningTokenRatePopover.tsx, apps/mobile/src/session/SentInlineAtomBody.tsx, apps/mobile/src/session/SessionActionSheet.tsx, apps/mobile/src/session/SessionActionSheetFrame.android.tsx, apps/mobile/src/session/SessionActionSheetFrame.tsx, apps/mobile/src/session/SessionDetailsNative.ios.tsx, apps/mobile/src/session/SessionDetailsNative.tsx, apps/mobile/src/session/SessionHeaderNativeControls.ios.tsx, apps/mobile/src/session/SessionHeaderNativeControls.tsx, apps/mobile/src/session/SessionListDrawer.tsx, apps/mobile/src/session/SessionMenuSheet.tsx, apps/mobile/src/session/SessionOptionsExpoSheet.tsx, apps/mobile/src/session/SessionResourceCards.tsx, apps/mobile/src/session/SessionRightSpinner.tsx, apps/mobile/src/session/SessionSearchNative.ios.tsx, apps/mobile/src/session/SessionSearchNative.tsx, apps/mobile/src/session/SessionTailBanner.tsx, apps/mobile/src/session/SessionTransientNotice.tsx, apps/mobile/src/session/SessionUsageSummary.tsx, apps/mobile/src/session/ShareImageNativeButton.ios.tsx, apps/mobile/src/session/ShareImageNativeButton.tsx, apps/mobile/src/session/ShareMessageCheckbox.tsx, apps/mobile/src/session/ShareSelectAllButton.tsx, apps/mobile/src/session/ShareSelectionBar.tsx, apps/mobile/src/session/SharedTaskAdmissionDialog.tsx, apps/mobile/src/session/SharedTaskEndedState.tsx, apps/mobile/src/session/SharedTaskScreen.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/session/SlowSendNotice.tsx, apps/mobile/src/session/SwipeableSessionRow.ios.tsx, apps/mobile/src/session/SwipeableSessionRow.tsx, apps/mobile/src/session/TaskTags.tsx, apps/mobile/src/session/TaskTagsSheet.tsx, apps/mobile/src/session/ThinkingDots.tsx, apps/mobile/src/session/TodoDateInput.android.tsx, apps/mobile/src/session/TodoDateInput.ios.tsx, apps/mobile/src/session/TodoDateInput.tsx, apps/mobile/src/session/UnifiedModelPickerSheet.tsx, apps/mobile/src/session/UnifiedModelPickerView.ios.tsx, apps/mobile/src/session/UnifiedModelPickerView.tsx, apps/mobile/src/session/VoiceRecordingPill.tsx, apps/mobile/src/session/WorkingStatusText.tsx, apps/mobile/src/session/composerPullThrough.tsx, apps/mobile/src/session/composerRichInputHtml.ts, apps/mobile/src/session/conversationShareWebViewHtml.ts, apps/mobile/src/session/listDisclosureTransition.tsx, apps/mobile/src/session/mathWebView.tsx, apps/mobile/src/session/mathWebViewHtml.ts, apps/mobile/src/session/mediaPlayerWebView.tsx, apps/mobile/src/session/mediaPlayerWebViewHtml.ts, apps/mobile/src/session/mermaidWebView.tsx, apps/mobile/src/session/mermaidWebViewHtml.ts, apps/mobile/src/session/selectableMarkdownHtml.ts, apps/mobile/src/session/useSharedTaskConfirmation.tsx, apps/mobile/src/session/voicePillWidthMotion.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 | 7 | 252 | 316 || `mobile.chat.sharing` | mobile | 共享任务邀请与成员;供应商分享链接提示 | app/shared-session.tsx / app/provider-share.tsx | AdaptiveWindow, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ClipboardSharedTaskPrompt, CompanionNativeContent.ios, 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, SharedTaskEndedState, SharedTaskScreen, SheetModal, SheetSurface, SimpleStackHeader, StartupSplashOverlay, ThemeProvider, _layout, gestureHandler, peerFileTransport, provider-share, shared-session, useLocale, useSharedTaskConfirmation | apps/mobile/app/_layout.tsx, apps/mobile/app/provider-share.tsx, apps/mobile/app/shared-session.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/CompanionNativeContent.ios.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/SharedTaskEndedState.tsx, apps/mobile/src/session/SharedTaskScreen.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/session/SheetSurface.tsx, apps/mobile/src/session/useSharedTaskConfirmation.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 | 69 |+| `mobile.companions.cloud` | mobile | 云端伙伴:主力电脑离线时的对话与换电脑 | app/companions/cloud/[actorId].tsx | AdaptiveWindow, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, BotGroupAvatars, BotGroupMessageText, CenteredScreen, ChatIdentityHeader, ClipboardSharedTaskPrompt, CloudCompanionScreen, CompanionCardButton, CompanionNativeContent.ios, CompanionPresenceRing, CompanionSettingsRow, CompanionSettingsRow.ios, CompanionSheet, CompanionSheet.ios, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, DeviceLinkContext, FoldTouchpad, HomeEntryProvider, HomeHeaderGlassButton, HomeHeaderGlassButton.ios, IncomingShareBridge, MobileLoginHandoffContext, MobileLoginHandoffStage, MobileOutboxBridge, MobilePrimitives, NativeBottomSheet, NativeBottomSheet.android, NativeChromeBackButton, 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, [actorId], _layout, gestureHandler, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/companions/cloud/[actorId].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/NativeChromeBackButton.ios.tsx, apps/mobile/src/platform/chrome/NativeChromeBackButton.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/BotGroupAvatars.tsx, apps/mobile/src/session/BotGroupMessageText.tsx, apps/mobile/src/session/ChatIdentityHeader.tsx, apps/mobile/src/session/ClipboardSharedTaskPrompt.tsx, apps/mobile/src/session/CloudCompanionScreen.tsx, apps/mobile/src/session/CompanionCardButton.tsx, apps/mobile/src/session/CompanionNativeContent.ios.tsx, apps/mobile/src/session/CompanionPresenceRing.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/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 | 68 || `mobile.companions.direct` | mobile | 伙伴私聊回看 | app/companions/direct/[threadId].tsx | AdaptiveWindow, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ClipboardSharedTaskPrompt, CompanionNativeContent.ios, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, DeviceLinkContext, FoldTouchpad, HomeEntryProvider, HomeHeaderGlassButton, HomeHeaderGlassButton.ios, HomeNativeStackHeader, HomeStackHeader, 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, [threadId], _layout, gestureHandler, nativeToolbarMenuItems, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/companions/direct/[threadId].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/HomeStackHeader.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/chrome/nativeToolbarMenuItems.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/CompanionNativeContent.ios.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 | 60 || `mobile.companions.groups` | mobile | 伙伴群聊与分工 | app/companions/groups/[groupId].tsx | AdaptiveWindow, AgentErrorDetails, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AppText, AuthContext, AuthorizationMessageCard, BlurBackdrop, BotGroupAvatars, BotGroupChatScreen, BotGroupComposer, BotGroupMenu, BotGroupMessageAttachments, BotGroupMessageText, BotGroupPlan, BotGroupQuote, BotGroupSettingsSheet, BotGroupSpeakerRow, CenteredScreen, ChatIdentityHeader, ClipboardSharedTaskPrompt, CompanionCardButton, CompanionEntering, CompanionLearningFooter, CompanionMessageActions, CompanionMessageCard, CompanionNativeContent.ios, CompanionPresenceRing, CompanionSheet, CompanionSheet.ios, CompanionTaskResultCard, ComposerAttachmentTray, ComposerFrame, ComposerFrame.ios, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, ContextSheetMediaViews, DeviceLinkContext, FileTypeIcon, FoldTouchpad, HomeEntryProvider, HomeHeaderGlassButton, HomeHeaderGlassButton.ios, HomeNativeStackHeader, HomeStackHeader, ImageLightbox, IncomingShareBridge, InlineQuoteChip, InlineReferenceChip, InputHandoffCard, InputHandoffDeviceCode, InputHandoffPictureStep, InputHandoffQrCode, InputHandoffRecordRow, InputHandoffSheet, InputHandoffSheet.ios, InputHandoffStepFields, InteractionPanel, MarkdownBlockContent, MessageActionSheet, MessageLoadingImage, MessageRenderer, MobileBoundaryNotice, MobileComposerInputRow, MobileLoginHandoffContext, MobileLoginHandoffStage, MobileOutboxBridge, MobilePrimitives, NativeBottomSheet, NativeBottomSheet.android, NativeChromeBackButton, NativeChromeBackButton.ios, NativeChromeButton.ios, NativePullDownMenu, NativeRemoteDesktopView, NativeResidentHistory, NativeSwitch, NativeVideoPlayer, OutsideTap, PaperPlaneIcon, PendingSendBubble, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PluginCardActions, PluginInvocationHeader, PluginSetupNativeActions, PluginSetupNativeForm, PushNotificationsBridge, QuietSyncIndicator, QuoteCapsule, 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, SentInlineAtomBody, SessionHeaderNativeControls, SessionHeaderNativeControls.ios, ShareMessageCheckbox, SharedTaskAdmissionDialog, SharedTaskScreen, SheetModal, SheetSurface, SimpleStackHeader, StartupSplashOverlay, TaskTags, ThemeProvider, ThinkingDots, WorkingStatusText, [groupId], _layout, gestureHandler, mathWebView, mediaPlayerWebView, mermaidWebView, nativeToolbarMenuItems, peerFileTransport, useLocale, voicePillWidthMotion | apps/mobile/app/_layout.tsx, apps/mobile/app/companions/groups/[groupId].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/FileTypeIcon.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/PaperPlaneIcon.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/inputHandoff/InputHandoffCard.tsx, apps/mobile/src/inputHandoff/InputHandoffDeviceCode.tsx, apps/mobile/src/inputHandoff/InputHandoffPictureStep.tsx, apps/mobile/src/inputHandoff/InputHandoffQrCode.tsx, apps/mobile/src/inputHandoff/InputHandoffRecordRow.tsx, apps/mobile/src/inputHandoff/InputHandoffSheet.ios.tsx, apps/mobile/src/inputHandoff/InputHandoffSheet.tsx, apps/mobile/src/inputHandoff/InputHandoffStepFields.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/HomeStackHeader.tsx, apps/mobile/src/platform/chrome/NativeChromeBackButton.ios.tsx, apps/mobile/src/platform/chrome/NativeChromeBackButton.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/chrome/nativeToolbarMenuItems.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/plugins/PluginCardActions.tsx, apps/mobile/src/plugins/PluginSetupNativeActions.tsx, apps/mobile/src/plugins/PluginSetupNativeForm.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/AgentErrorDetails.tsx, apps/mobile/src/session/AuthorizationMessageCard.tsx, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/BotGroupAvatars.tsx, apps/mobile/src/session/BotGroupChatScreen.tsx, apps/mobile/src/session/BotGroupComposer.tsx, apps/mobile/src/session/BotGroupMenu.tsx, apps/mobile/src/session/BotGroupMessageAttachments.tsx, apps/mobile/src/session/BotGroupMessageText.tsx, apps/mobile/src/session/BotGroupPlan.tsx, apps/mobile/src/session/BotGroupQuote.tsx, apps/mobile/src/session/BotGroupSettingsSheet.tsx, apps/mobile/src/session/BotGroupSpeakerRow.tsx, apps/mobile/src/session/ChatIdentityHeader.tsx, apps/mobile/src/session/ClipboardSharedTaskPrompt.tsx, apps/mobile/src/session/CompanionCardButton.tsx, apps/mobile/src/session/CompanionEntering.tsx, apps/mobile/src/session/CompanionLearningFooter.tsx, apps/mobile/src/session/CompanionMessageActions.tsx, apps/mobile/src/session/CompanionMessageCard.tsx, apps/mobile/src/session/CompanionNativeContent.ios.tsx, apps/mobile/src/session/CompanionPresenceRing.tsx, apps/mobile/src/session/CompanionSheet.ios.tsx, apps/mobile/src/session/CompanionSheet.tsx, apps/mobile/src/session/CompanionTaskResultCard.tsx, apps/mobile/src/session/ComposerAttachmentTray.tsx, apps/mobile/src/session/ComposerFrame.ios.tsx, apps/mobile/src/session/ComposerFrame.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/ContextSheetMediaViews.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/HomeHeaderGlassButton.ios.tsx, apps/mobile/src/session/HomeHeaderGlassButton.tsx, apps/mobile/src/session/ImageLightbox.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/InlineQuoteChip.tsx, apps/mobile/src/session/InlineReferenceChip.tsx, apps/mobile/src/session/InteractionPanel.tsx, apps/mobile/src/session/MarkdownBlockContent.tsx, apps/mobile/src/session/MessageActionSheet.tsx, apps/mobile/src/session/MessageLoadingImage.tsx, apps/mobile/src/session/MessageRenderer.tsx, apps/mobile/src/session/MobileBoundaryNotice.tsx, apps/mobile/src/session/MobileComposerInputRow.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/NativeVideoPlayer.tsx, apps/mobile/src/session/PendingSendBubble.tsx, apps/mobile/src/session/PluginInvocationHeader.tsx, apps/mobile/src/session/QuoteCapsule.tsx, apps/mobile/src/session/RecentMessageHistories.tsx, apps/mobile/src/session/RemoteHistoryPrefetchBridge.tsx, apps/mobile/src/session/ResidentHomeList.tsx, apps/mobile/src/session/SentInlineAtomBody.tsx, apps/mobile/src/session/SessionHeaderNativeControls.ios.tsx, apps/mobile/src/session/SessionHeaderNativeControls.tsx, apps/mobile/src/session/ShareMessageCheckbox.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/TaskTags.tsx, apps/mobile/src/session/ThinkingDots.tsx, apps/mobile/src/session/WorkingStatusText.tsx, apps/mobile/src/session/mathWebView.tsx, apps/mobile/src/session/mathWebViewHtml.ts, apps/mobile/src/session/mediaPlayerWebView.tsx, apps/mobile/src/session/mediaPlayerWebViewHtml.ts, apps/mobile/src/session/mermaidWebView.tsx, apps/mobile/src/session/mermaidWebViewHtml.ts, apps/mobile/src/session/voicePillWidthMotion.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 | 251 | 209 || `mobile.device-management` | mobile | 设备管理 | app/devices/manage.tsx / app/devices/manage/[deviceId].tsx | AdaptiveWindow, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ClipboardSharedTaskPrompt, CompanionNativeContent.ios, ComposerNativeSection, ComposerNativeSection.ios, ComposerSheet, ComposerSheet.ios, ConnectionBanner, ConnectionNoticeOverlay, ContextSheet, ContextSheet.ios, DeviceInformationFields, DeviceInformationFields.ios, DeviceLinkContext, DeviceManagementDialogs, DeviceManagementList, DeviceManagementList.ios, FoldTouchpad, HomeEntryProvider, HomeHeaderGlassButton, HomeHeaderGlassButton.ios, HomeNativeStackHeader, HomeStackHeader, IncomingShareBridge, MobileLoginHandoffContext, MobileLoginHandoffStage, MobileOutboxBridge, MobilePrimitives, ModalContentArea, 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, RenameDeviceModal, ResidentHomeList, SettingsGroupRows, SharedTaskAdmissionDialog, SharedTaskScreen, SheetModal, SheetSurface, SimpleStackHeader, StartupSplashOverlay, ThemeProvider, [deviceId], _layout, gestureHandler, listDisclosureTransition, manage, nativeToolbarMenuItems, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/devices/manage.tsx, apps/mobile/app/devices/manage/[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/DeviceInformationFields.ios.tsx, apps/mobile/src/device-link/DeviceInformationFields.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/DeviceManagementDialogs.tsx, apps/mobile/src/device-link/DeviceManagementList.ios.tsx, apps/mobile/src/device-link/DeviceManagementList.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/ModalContentArea.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/HomeStackHeader.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/chrome/nativeToolbarMenuItems.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/CompanionNativeContent.ios.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/RenameDeviceModal.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/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 214 | 60 |@@ -126,6 +127,7 @@| apps/mobile/app/(auth)/login.tsx | LoginRoute | `mobile.auth` || apps/mobile/app/account-deletion.tsx | AccountDeletionScreen | `mobile.account-deletion` || apps/mobile/app/add-account.tsx | AddAccountScreen | `mobile.auth` |+| apps/mobile/app/companions/cloud/[actorId].tsx | CloudCompanionRoute | `mobile.companions.cloud` || apps/mobile/app/companions/direct/[threadId].tsx | CompanionDirectMessages | `mobile.companions.direct` || apps/mobile/app/companions/groups/[groupId].tsx | BotGroupChatRoute | `mobile.companions.groups` || apps/mobile/app/devices/[deviceId].tsx | DeviceDetailScreen | `mobile.devices` |@@ -222,6 +224,7 @@ Mobile 已由 DS-7 纳入同一台账(2026-09-10 静态入口发现),保| `mobile.chat.new` | kirozeng 协调 / Codex 发现维护;页面 owner 待认领 | legacy | — | DS-7 已发现入口;Mobile 独立阶段接管,未迁移 | 2026-09-17 复查入口变化和页面 owner;动态内容、平台实际呈现留 Mobile 独立阶段验证 || `mobile.chat.session` | kirozeng 协调 / Codex 发现维护;页面 owner 待认领 | legacy | — | DS-7 已发现入口;Mobile 独立阶段接管,未迁移 | 2026-09-17 复查入口变化和页面 owner;动态内容、平台实际呈现留 Mobile 独立阶段验证 || `mobile.chat.sharing` | unassigned | legacy | — | DS-7 发现入口,Mobile 独立阶段接管;未迁移 | 保持现状;发现问题记下一动作,本张不修视觉 |+| `mobile.companions.cloud` | unassigned | legacy | — | DS-7 发现入口,Mobile 独立阶段接管;未迁移 | 保持现状;发现问题记下一动作,本张不修视觉 || `mobile.companions.direct` | kirozeng 协调 / Codex 发现维护;页面 owner 待认领 | legacy | — | DS-7 已发现入口;Mobile 独立阶段接管,未迁移 | 2026-09-17 复查入口变化和页面 owner;动态内容、平台实际呈现留 Mobile 独立阶段验证 || `mobile.companions.groups` | unassigned | legacy | — | DS-7 发现入口,Mobile 独立阶段接管;未迁移 | 保持现状;发现问题记下一动作,本张不修视觉 || `mobile.device-management` | kirozeng 协调 / Codex 发现维护;页面 owner 待认领 | legacy | — | DS-7 已发现入口;Mobile 独立阶段接管,未迁移 | 2026-09-17 复查入口变化和页面 owner;动态内容、平台实际呈现留 Mobile 独立阶段验证 |diff --git a/docs/dev-rules/credentials-and-local-storage.md b/docs/dev-rules/credentials-and-local-storage.mdindex be3279ab16..73cd69e557 100644--- a/docs/dev-rules/credentials-and-local-storage.md+++ b/docs/dev-rules/credentials-and-local-storage.md@@ -205,6 +205,7 @@ Desktop 的运行时 refresh 遇到瞬时失败后,主动调用与定时重试| 供应商按使用方的用量 | `userData/owners/<账号>/provider-usage-by-party.json`,按(日期、供应商、使用方、设备 id、组内电脑的键、Agent、模型)聚合 token 与轮次。使用方:本机、同账号另一台电脑、经同账号组所在电脑转来的受邀者任务、本机经另一台电脑的组在别的组内电脑上运行的(只用来报告给那台组所在电脑)、同账号电脑报告来的(每次报告整体替换那台从某天起的行);没有使用方字段的旧行按设备 id 推出。原子替换写入,保留 400 天;只含供应商 id、设备 id、组内电脑的键与模型名,不含对话或凭证。按账号存放(供应商 id 在不同账号下会重复),从开始记录起不补历史 || macOS 菜单栏余量设置 | `userData/menubar-settings.json`,本机偏好:是否显示、来源顺序与显隐、菜单栏文字、快见底通知、隐藏个人信息、统计范围;只含供应商 id,不含凭证或用量数值 || macOS 菜单栏 Cindy 余额样本 | `userData/owners/<账号>/menubar-credit-samples.json`,只记录观测到的余额数值与时间(按区域与币种分组),用于估算日均消耗;保留 30 天、原子替换写入,不含凭证或账号标识 |+| 云端伙伴同步状态 | `userData/owners/<账号>/companion-cloud/<sha256(端点\n主人 actor id)>.json`,只记伙伴的云端 actor id、1:1 房间 id、对话导入游标(本机消息时间与 id)、已上传资料的内容哈希与版本号、是否已交出主力电脑(本机副本隐藏、不跑例行任务)、接管后待重建上下文的标记;原子替换写入,读不出时从空开始并向服务器重新核对,不含凭证、消息正文或资料正文。见 `main/companion-cloud/state.ts` || macOS 菜单栏 helper(开发构建) | `userData/menubar/`,开发时由 `swiftc` 编译的 helper 及其 wordmark 图片和源码哈希;打包版改用 `resources/tools/menubar/`,不在 userData 落盘 || 供应商分享:受邀者会话登记 | `userData/remote-agent/guest-sessions.json`(控制端摘要 → 本机侧任务与原生会话 id),只用来限制受邀者只能恢复自己的会话,并在分享删除时精确清理影子工作区、附件与会话记录 || 供应商分享:跨区域标记 | `userData/remote-agent/provider-share-regions.json`,账号摘要 → 对方区域;**不含凭证**。跨区连接凭证只在内存里,用新身份名片重新换取;没有标记的账号从不联系对方区域 |diff --git a/docs/product-rules/cindy-bots-runtime.md b/docs/product-rules/cindy-bots-runtime.mdindex 8049200acc..20debf2188 100644--- a/docs/product-rules/cindy-bots-runtime.md+++ b/docs/product-rules/cindy-bots-runtime.md@@ -38,6 +38,9 @@ Bot Profile└── history Sessions 仅用于旧版本数据与异常恢复后的记录```+伙伴属于账号而不是某台电脑:同一伙伴只在它的主力电脑上运行,其他电脑与手机通过云端对话层查看并可接管,+规则见 [云端伙伴](cloud-companions.md)。+每条伙伴 Session 必须能反查唯一的 Bot owner 与 Profile 版本。伙伴启动的后台任务是普通Cindy Session,以父任务关系回到发起伙伴,但不冒充该伙伴或另一个伙伴的主任务。伙伴在群聊里使用独立的群专线 Session(`role = 'group'`),与主任务共享 Profile 与 Home,diff --git a/docs/product-rules/cloud-companions.md b/docs/product-rules/cloud-companions.mdnew file mode 100644index 0000000000..3fd0ad9701--- /dev/null+++ b/docs/product-rules/cloud-companions.md@@ -0,0 +1,179 @@+# 云端伙伴:同一个伙伴、主力电脑与切换++> 修改伙伴的跨电脑身份、主力电脑、云端对话、切换电脑继续或相关 Chat Server 合同前必须先读本文。+> 伙伴运行时其余规则见 [cindy-bots-runtime.md](cindy-bots-runtime.md),群聊见 [bot-group-chat.md](bot-group-chat.md)。++## 1. 用户心智++伙伴属于账号,不属于某台电脑。用户在任意电脑或手机上看到的是**同一个伙伴**:同一个名字、头像、+性格、记忆、技能和连续的对话。++每个伙伴有一台**主力电脑**:伙伴的 Agent 只在这台电脑上运行,工作目录、登录状态、模型连接和+本机文件都在这里。其他电脑和手机是看和说的入口,不另起一个同名伙伴。++2026-10-13 产品裁决(Dash 确认):++1. 服务器按区域分开部署,伙伴数据不跨境,不为此另做加密方案。+2. 云端只存**对话层**:用户看得到的消息和伙伴的最终回复。工具调用明细、思考过程和完整运行记录+ 留在主力电脑。+3. 主力电脑离线时明确告诉用户,并提供「在这台电脑继续」;默认不自动换电脑。+4. 迁移:每台电脑上的默认 Cindy 合并成一个云端 Cindy,第一台升级并登记的电脑成为主力电脑;+ 其他电脑上原有的 Cindy 对话作为本机历史保留,可回看、可搜索,不再继续运行。其他伙伴本来就只+ 存在于一台电脑,那台电脑就是它的主力电脑。++## 2. 数据归属++| 存在服务器(跟着伙伴走) | 只留在主力电脑 |+|---|---|+| 身份:名字、头像(Chat Server actor) | 工作目录 `workspace/` 与其中文件 |+| 资料:简介、SOUL、自定义提示词、关于用户(USER.md) | 模型连接、登录凭证、MCP 配置、权限档 |+| 记忆:`memories/*.md` 每条一份 | 完整运行记录(工具调用、思考、附件原件) |+| 自有技能:`skills/<slug>/SKILL.md` | 例行任务的定义与执行(只在主力电脑运行) |+| 1:1 对话层:用户消息与伙伴最终回复 | 待办 `todos.v1.json` |+| 主力电脑(`homeDeviceId`) | 工作台项目登记 |++- 服务器是对话层与资料快照的权威副本;主力电脑是运行与写入的唯一来源。+- **只有主力电脑写云端资料**。其他电脑修改伙伴设置时,经现有远程设置(device-link)写到主力电脑,+ 再由主力电脑上传。主力电脑离线时,其他端只读显示云端资料,不提供离线编辑,避免两端改出冲突。+- 模型候选链引用的是主力电脑的连接与型号,不跨电脑复用。换主力电脑后,新电脑先跟随本机默认模型,+ 用户可再在设置里选。++## 3. 主力电脑++- 新建伙伴时,创建它的电脑就是主力电脑。存量伙伴在首次登记到服务器时,由登记的电脑成为主力电脑+ (服务器上为空才写入,不抢已有主力电脑)。+- 服务器只把伙伴的执行(群聊发言、1:1 离线排队的消息)派给主力电脑;其他电脑即使持有同一账号的+ 凭证也领取不到。主力电脑用登录凭证里的设备标识(device-link 的 deviceId)表示。开启后,主力电脑尚未登记+ 成功的伙伴在支持该功能的客户端上都不领取执行,直到某台电脑登记成功(之后每轮登记重试;服务端对空主力电脑保持原行为)。+- 其他电脑上同一伙伴的本机副本(例如合并前各电脑的 Cindy、换走主力电脑后的旧电脑)不再出现在伙伴+ 列表里,也不运行例行任务;它的历史对话保留为本机历史。+- 桌面与手机的伙伴列表里,已知主力电脑的伙伴只在主力电脑名下列一行:其他电脑列出(或缓存着)的同一伙伴不显示;+ 这台设备从没列到过主力电脑时(例如新手机、主力电脑一直离线),按云端伙伴补一行离线入口,用于打开云端对话。++### 3.1 离线与切换++- 伙伴的主力电脑离线时:伙伴列表与聊天头部显示「主力电脑「<名字>」离线」;聊天区显示云端对话(只读)+ 与一条横幅「主力电脑「<名字>」离线 · 在这台电脑继续」。+- 点「在这台电脑继续」:+ 1. 服务器把主力电脑改成这台电脑(带原主力电脑做比较,避免两端同时抢);+ 2. 这台电脑按云端资料、记忆和技能建立(或更新)本机伙伴,伙伴 ID 与云端一致;+ 3. 把云端对话导入本机主任务作为历史,并以持久交接重建模型上下文,不重放任何旧请求;+ 4. 打开这台电脑上的伙伴聊天,用户可以直接继续说话。+- 手机上同样显示离线横幅,「换一台电脑继续」列出在线且已允许远程控制的电脑;选中后服务器改主力+ 电脑,那台电脑收到变化后自动完成第 2、3 步,手机随即打开那台电脑上的伙伴。+- 原主力电脑重新上线后,发现主力电脑已换走:停止领取执行,隐藏本机副本,伙伴改为显示在新主力+ 电脑名下。它离线期间没来得及上传的资料以服务器版本为准,不回写覆盖。+- 伙伴设置的「主力电脑」一行显示当前主力电脑;在主力电脑上可以把伙伴交给另一台在线电脑,规则同上。++## 4. 1:1 对话层同步++- 每个伙伴在 Chat Server 上有一个固定的私聊房间(主人 ↔ 伙伴),房间 ID 由伙伴 actor ID 确定,+ 任意电脑并发创建得到同一个房间。+- 主力电脑把主任务里用户可见的消息和伙伴的最终回复按顺序导入这个房间(导入不触发伙伴执行、不发通知),+ 以本机消息 ID 去重,断网后从上次位置续传。附件只同步文件名占位,原件留在主力电脑;只发附件没有文字的消息同样以占位同步。+- 主力电脑在线时,其他电脑与手机继续用现有远程方式(device-link)直接看和发主任务,体验不变。+- 主力电脑离线时,其他端从房间读取对话层;用户在离线横幅里选择切换电脑后再继续。+- 房间里由主人直接发出的消息(例如未来的离线排队)在主力电脑上线后由它领取,作为「来自其他设备」的+ 消息投递进主任务;伙伴回复由导入同步回房间,不重复写。主任务未在运行时按它保存的权限档唤醒,不借后台唤醒的默认完全访问。房间消息等同同账号设备远程操作这台电脑,只在这台电脑开启「允许同账号设备控制本机」时投递(否则该条执行失败、不进主任务);房间消息没有经认证的设备标识,无法按「已撤销的控制设备」逐台拒绝。++## 5. 管理用户开放的其他电脑++- 伙伴可以在用户开放的其他电脑上干活:沿用协同(Orca)的跨电脑执行,`get_workspace_info` 返回的+ `execution_devices` 即可用电脑,`create_worker` 传 `execution_device_id` 把任务、目录与命令放到那台电脑上。+- 「开放」沿用每台电脑设置里的「允许同账号设备控制本机」,不新增授权开关;关闭后伙伴立即用不了那台电脑。+- 共享伙伴指南只说明这条路径与限制,不暗示能直接读写别的电脑上的任意文件。++## 6. 兼容与发布++- 新功能以服务器 `GET /me` 返回的 `capabilities.companionHome` 为开关;旧服务器上客户端保持原有+ 按电脑工作的方式,不登记主力电脑、不导入对话。+- 旧客户端不认识主力电脑:服务器对它们的执行领取同样按主力电脑过滤,因此旧电脑不会再抢新主力电脑的+ 群聊发言;旧客户端的本机伙伴列表不受影响。+- 对话导入、资料上传都是幂等、可重试的后台工作,失败不影响本机聊天;不新增本机数据库表,+ 映射与游标存于账号隔离的状态文件。+- 在主力电脑上删除伙伴时,同时在服务器停用它的 actor(带「主力电脑仍是本机」的比较,期间已被别的电脑接走就只删本机副本),其他电脑与手机不再显示;失败时在状态文件记下+ `retirePending`,之后每轮登记重试直到成功;重试前伙伴已被别的电脑接走时清掉这条记录(与比较失败一样只删本机副本),以后交回来也不会被停用。删除已降级的本机副本只删本机,不动云端伙伴;同一台电脑上另一个 Cindy+ 安装认领了伙伴时同样只删本机;本安装尚未确认认领(检查未完成,或伙伴刚被交到这台电脑)时,先按自动接管的方式认领,+ 抢到才停用,被另一个安装抢先则只删本机。其他电脑(包括删除时离线、之后才上线的)+ 看到云端伙伴已停用时,把本机副本转为降级:隐藏、只读、不运行。+- 接管时导入云端最近 200 条对话为本机历史。服务器不回传导入来源 ID,本机按「角色 + 消息时间(毫秒)」+ 识别这台电脑当初导入上去的消息;已插入的云端历史(`cloud-history:<消息>`)和房间里直接发给伙伴、已投递进本机主任务的消息(`chat-direct:<执行>:<消息>`)按房间消息 ID 识别,都不重复插入(接管中途失败重试时,同一时间的拆分片段不会被误跳过);之后像「重启伙伴」一样从历史重建上下文,伙伴还有一轮在跑时等它结束再重建,期间副本保持降级。+- 已降级的本机副本:不领取执行、不上传、不导入对话,不同步名字与头像,不出现在伙伴列表、主入口选择、+ Cindy 多设备合并、本机 `list_agents` 和远程资源 `teammates` 列表(因此也不出现在其他设备的 `list_agents`),+ 例行任务跳过但定义保留。主任务的所有发送通路(界面、内部派发、插件、队列出队)都在真正发送前拒绝。降级名单另存于账号隔离的 `companion-cloud/shadowed.json`,切换账号后的第一次读取就换成新账号的名单(不沿用上一个账号的主力电脑与降级状态),启动后、服务器不可达+ 或功能关闭时同样生效;写盘失败时本次运行照样隐藏,并在之后每轮登记时重试写入,直到写入成功。打开它的主任务时只读(本机的设置抽屉不打开,设置从主力电脑上的伙伴进入):横幅「这个伙伴已在「X」上运行」,可打开主力电脑上的伙伴或+ 「在这台电脑继续」;主进程向降级副本主任务的发送一律拒绝。+- 只有主力电脑上、未降级、且本安装已确认运行该伙伴的副本才把名字与头像同步到云端 actor,并且在主力电脑登记之后才同步。+- 接管总以缓存里的主力电脑做比较再写入,即使缓存显示本机已是主力电脑(离线期间可能已被别的电脑接走)。+ 自动接管(被手机或另一台电脑交过来)先以「本机→本机」比较确认主力电脑仍是本机,再解除降级。+- 接管期间本机副本保持降级(不运行、不上传、不导入),在本安装认领伙伴之前、第一次本机写入之前就发布降级(发送拦截、例行任务、列表立即生效),资料、头像、记忆和技能全部写入成功、历史导入且上下文重建完成后才解除+ (伙伴还有一轮在跑时等它结束再重建,期间保持降级);重建失败同样保持降级重试(已有副本的头像+ 也换成云端头像,云端没有头像时用新建伙伴的默认头像,避免新主力电脑把旧头像回写覆盖云端身份);任一条写入失败或头像下载失败+ 时保留已写入的部分并保持降级,由自动接管约每分钟重试,避免残缺副本运行或把旧文件上传覆盖云端。云端还没有+ 主力电脑上传的完整资料快照(`companion.profile.v1`,`name` / `description` / `soul` / `systemPrompt` / `user` 都是字符串)时不改主力电脑:「在这台电脑继续」和手机「换一台电脑继续」都先检查+ 快照,没有就提示失败、主力电脑不变;万一已被交过来(例如旧版本)也保持降级重试,不把这台电脑的旧资料当成伙伴身份发布。+- 接管的本机写入(资料、文件、记忆、技能、历史、重建)都绑定发起时的账号,切换账号即中止;头像经共用的公网图片下载(逐跳拒绝内网 / 本机地址,边读边限 5 MB)获取,15 秒超时,+ 账号结束时取消。+- 接管已有的本机副本(例如第二台电脑自己的 Cindy、曾经交出去的旧副本)前,先把它的伙伴目录(不含 workspace)+ 备份到账号隔离的 `companion-cloud-backups/<伙伴>-<时间>/`,并写日志;每次接管只备份一次,接管失败后的重试不再备份。+ 接管以云端为准:云端有值的记忆 / 技能覆盖本机,云端墓碑删除本机同名文件(内容不同也删,原件在备份里),之后上传+ 不会把已删除的内容带回云端。资料上传只给本机曾上传或曾接管写入过的键写墓碑,服务器上仅存在的键(含本机未能写入的+ 记忆)从不被墓碑。云端既没有值也没有墓碑、只存在于这台电脑的记忆 / 技能(例如第二台电脑 Cindy 自己积累的)接管后保留,+ 并作为新内容上传、合入伙伴(Dash 2026-10-13 确认:合并,不按云端删除)。+- 技能按 `SKILL.md` 原文(含 Cindy 不认识的原生 frontmatter)上传与恢复,停用状态一并恢复(整个技能目录在启用 / 停用之间移动),换电脑后技能语义不变。+- 接管后对话镜像从本机最后一条自有消息(不含导入的云端历史)之后开始,本机接管前的旧对话不上传到房间。+- 资料上传遇到版本冲突时先确认本机仍是主力电脑(否则停止并重新读取),再按服务器当前值最多重写一次;读本机资料(SOUL / USER / 自定义提示词)、+ 记忆与技能时只有「不存在」视为空,其它读取错误跳过本轮且不写墓碑;接管时读不到本机文件同样中止、保持降级重试;首次升级的大批写入每轮每台电脑最多约 30 条,其余下一轮。+- 对话导入只导入主人亲手输入的用户消息(`agentMeta` 无来源标记,或只有 `sourceDevice`)与伙伴回复(不含私有协调回复、过程旁白 `assistantPhase: commentary` 与子 Agent 输出(`parentToolUseId` / `parent_tool_use_id`,以及与界面同一判据的 Claude `parentUuid`);一轮还没结束时、工具调用前的旁白仍按普通回复导入);来自其他+ 任务、伙伴、插件、IM、自动化、Orca、共享成员的输入一律不上云。游标之外每轮回扫最近 10 分钟(从窗口开头起最多 200 行;10 分钟内超过 200 行时,排在后面的晚落库回复可能漏掉、只留在本机),+ 补上晚落库的回复;接管导入的 `cloud-history:` 行不推进游标。首次同步只看本机最近 1,000 行,导入其中最近 200 条可上云的+ 消息;这 1,000 行里一条都没有时(例如主人最后一次输入后伙伴又处理了上千条自动化或 IM 输入),房间从此刻开始,更早的对话+ 只留在本机。已回退或删除的本机消息不导入,接管时也不再插回。+- 已暂停的伙伴不交出(不同步资料与对话):设置里的「主力电脑」行提示先恢复再换电脑。+- 伙伴在任一任务里(主任务、群聊 / 群分工专线、委派)还有一轮在运行或排队时不交出;已领取、尚未投递的 1:1 房间消息在投递前再确认本机仍是主力电脑,交出后不再投递(提示「还在回复,等这一轮结束再换电脑」),在同步前和改主力电脑前各检查一次,避免交出后旧电脑上的这一轮继续调用工具、改文件、产生不会同步的回复。+- 交出伙伴前先把积压的对话全部导入房间(不受平时每轮最多 10 页的限制),再上传全部资料并重复上传直到一轮没有新变化,再立即同步伙伴的名字与头像(不再等下一轮登记;这个伙伴的头像上传失败同样不交出;别的伙伴头像有问题不影响,各伙伴的名字与头像分别同步),然后才改主力电脑(连续变化时不交出、提示失败),导入期间改动的资料也会带上;交出期间后台的定时上传与导入暂停(先等正在进行的一轮结束),+ 不会有旧的一轮在交出之后再写入云端;有超过上传+ 上限的值(例如过大的技能)时同样不交出,原主力电脑保持不变。+- 交出伙伴前探测目标电脑的 `maker:companion-cloud:caps`(device-link 只读通道,返回 `{companionCloud: 1}`),+ 旧版本不支持则拒绝该目标;可选目标列表同样只列支持的电脑。手机端「换一台电脑继续」暂未探测(见下)。+- 同一台电脑上的两个 Cindy 安装(例如开发版与正式版)共用设备标识。每个安装在自己的 userData 生成随机安装 ID,+ 主力电脑上的安装把伙伴偏好 `companion.install.v1 = {installationId, deviceId}` 写为自己的;设备相同但安装 ID 不同的+ 安装把伙伴视为降级(隐藏、不领取、不上传、不导入、不自动接管)。在那个安装里「在这台电脑继续」会改写这条记录;+ 另一个安装最多约 2 分钟后发现并转为降级。记录还未读到(或读取失败)时不领取执行,但不隐藏本机副本、不拦本机发送(离线的主力电脑必须照常可用);因此伙伴刚被交到这台电脑、本机恰有一份从未同步的副本时,在读到记录之前的一次请求往返里,这份副本仍可在本机使用,读到后才转入自动接管。记录来自另一台电脑时,说明伙伴+ 刚被交到这台电脑:即使本机已有一份从未同步、也未降级的副本,也按自动接管完成(先备份)。自动接管只替换来自其他电脑的+ 记录,不抢同一电脑上另一个安装已认领的伙伴;要换安装只能在该安装里手动「在这台电脑继续」。+- 1:1 房间的执行只在开启该功能、且房间是这个伙伴自己的房间(已记录的房间 ID,或成员恰为主人与该伙伴的 `direct`+ 房间)时投递进主任务;其它 `direct` 房间不按群聊回答。所有 `direct` 房间都不出现在群聊列表。+- 端到端验证:`apps/desktop/src/main/companion-cloud/__tests__/twoDevices.harness.test.ts`,设置+ `CINDY_CHAT_HARNESS_URL` 指向一次性的本地 chat-server 时运行,CI 跳过。+- 当前未覆盖:从房间投递到主任务的消息暂不标注+ 「来自其他设备」,因为房间消息没有经认证的设备标识,不满足 [消息来源](message-source.md) 的盖章条件。+- 手机换电脑后,只有在等待期间从目标电脑读到的列表行才算接管完成,缓存里的旧行不算。手机伙伴列表在列出的行变化+ (新行出现或已有行内容更新)和下拉刷新时重新读取各伙伴的主力电脑,停留在列表上也能跟上别处发起的换电脑。+- 已知限制:主力电脑在第一次上传资料之前就离线时,其他电脑和手机暂时不能换电脑继续,要等主力电脑重新上线上传后。+- 已知限制:交出伙伴时,对话导入完成之后产生的对话,以及最后一轮上传之后、服务器改主力电脑的请求返回之前(一次请求往返)+ 写入的资料或记忆不会上传,只留在原电脑的本机副本里;不为此冻结伙伴的本机写入。原主力电脑仍在线时被别处「在这台电脑继续」接走,+ 它正在进行的那一轮上传(资料,或一批对话导入)可能在接走之后才写入云端;迟到的对话留在房间里,新主力电脑已完成的历史导入不会再吸收它,直到下次接管。资料方面:新主力电脑本机仍是接管时的值,且不会覆盖这次写入(首次同步只更新版本号,不把云端较新的值当成本机修改;本机真正改了这一项才会上传),下次接管时才拿到;+ 服务器的偏好写入不校验主力电脑,不为此新增服务端契约。+- 已知限制:哪些云端值由本机上传或接管写入,只记在账号隔离的状态文件里(只有这些键会写墓碑)。状态文件丢失或损坏后,+ 重建的记录不带这个归属:此后在本机删除的记忆或技能不会在云端删除,下次接管会带回来(原值仍在,不丢数据);+ 不为此另存一份归属。状态文件写入失败(例如磁盘已满)时,本次运行里的状态照常生效(降级立即生效),下一次更新时连同写入;+ 在写入成功前退出则丢失这些记录,按上面的状态文件丢失处理。降级名单(`shadowed.json`)读不出来或内容损坏时按空名单处理:服务器可达且功能开启时会按主力电脑+ 重新降级;在服务器不可达或功能关闭的那次启动里,旧副本可能暂时显示并可在本机使用。状态文件损坏不另做保护。+- 已知限制:「在这台电脑继续」用于原主力电脑离线(或被认为离线)时接管,不能等待或停止原电脑上正在运行的一轮。原电脑其实+ 还在跑时,它下一次同步就会降级、不再接新工作,但已在进行的那一轮会跑完,期间的工具调用、文件改动和回复只留在原电脑本机;+ 不为此在降级时强行中断运行中的一轮。+- 已知限制:`/me` 返回的设备标识变化(例如重新绑定设备)会让这台电脑上所有伙伴转为降级;房间里的占位文字+ (如 `[附件: …]`)固定为中文;降级发生时正在进行的那一轮不会导入;已导入房间后又在本机回退的消息仍留在房间;+ 删除伙伴时若当时没有可用的云端连接(未登录或旧服务器),不会记下待停用;手机换电脑不探测目标版本。+- 未覆盖、留作后续:手机与非主力电脑离线编辑资料;例行任务与待办上云;IM 渠道按伙伴绑定;+ 离线时在其他端直接发送并排队。++## 7. 实现位置++- 服务器:`cindy-server/chat-server`(actor 的 `home_device_id`、按主力电脑过滤领取、私聊房间确定 ID、+ `/me` 的设备标识与能力开关)。+- Desktop:`apps/desktop/src/main/companion-cloud/`(登记主力电脑、资料上传、对话导入、接管、降级、+ 删除时停用);渲染层 `features/bots/` 的 `companionCloudStore.ts`(`maker:companion-cloud:*` 状态与变化推送)、+ `CloudCompanionOfflineView.tsx`(离线横幅与云端对话)、`BotHomeComputerSetting.tsx`(设置里的「主力电脑」行)。+- Mobile:伙伴离线横幅、云端对话只读视图与换电脑选择。diff --git a/i18n/GLOSSARY.md b/i18n/GLOSSARY.mdindex 1f32dd079c..7ff2796829 100644--- a/i18n/GLOSSARY.md+++ b/i18n/GLOSSARY.md@@ -239,6 +239,10 @@ Cindy Make 中与个人版对应的来源应用。用户明确要求 Dev 和正Cindy Make 生成的本机定制应用成品。可与原版切换并沿用同一份日常数据,与使用独立数据的隔离测试版区分。+### Main computer++云端伙伴运行的那台电脑(docs/product-rules/cloud-companions.md §3):伙伴的 Agent、工作目录与连接只在这台电脑上,其他电脑与手机是查看和发消息的入口。手机与桌面同一叫法,伙伴设置行名、离线横幅与侧栏状态共用。英文行名用 Title Case(Main Computer),句中小写 main computer,故 checkCase 为 false。不要写成「主设备」「宿主机」或 home device(代码字段 homeDeviceId 不是界面用语)。先登记为 proposed,待桌面与手机实机走查后再定。+### Content Update指不更换 TestFlight 或商店安装包、可通过 OTA 下发的 JS 与资源更新。当前先采用四语直译并登记为待讨论术语,避免与整包更新或测试版本更新混称。diff --git a/i18n/glossary.json b/i18n/glossary.jsonindex 2f045eecd6..7277c364e5 100644--- a/i18n/glossary.json+++ b/i18n/glossary.json@@ -2438,6 +2438,19 @@},"checkCase": false,"note": "伙伴独立事务清单,含交办与获准信息中的主动发现;项目、执行任务与PR仅可选关联。不替代Session任务生命周期。"+ },+ {+ "id": "companion-main-computer",+ "status": "proposed",+ "en": "Main computer",+ "translations": {+ "zh-CN": "主力电脑",+ "zh-TW": "主力電腦",+ "ja": "メインのパソコン",+ "ko": "주 컴퓨터"+ },+ "checkCase": false,+ "note": "云端伙伴运行的那台电脑(docs/product-rules/cloud-companions.md §3):伙伴的 Agent、工作目录与连接只在这台电脑上,其他电脑与手机是查看和发消息的入口。手机与桌面同一叫法,伙伴设置行名、离线横幅与侧栏状态共用。英文行名用 Title Case(Main Computer),句中小写 main computer,故 checkCase 为 false。不要写成「主设备」「宿主机」或 home device(代码字段 homeDeviceId 不是界面用语)。先登记为 proposed,待桌面与手机实机走查后再定。"}]}diff --git a/packages/device-link/src/allowlist.ts b/packages/device-link/src/allowlist.tsindex 611308c8bc..0bae738545 100644--- a/packages/device-link/src/allowlist.ts+++ b/packages/device-link/src/allowlist.ts@@ -35,6 +35,7 @@ import {ORCA_REMOTE_WORKER_RELEASE_CHANNEL,} from './orcaRemoteWorker.js';import { TASK_MIGRATION_CHANNEL } from './taskMigration.js';+import { COMPANION_CLOUD_CAPS_CHANNEL } from './companionCloud.js';import { SESSION_ACTIVITY_CHANNEL, SESSION_SYNC_CHANNEL } from './topics.js';import { REMOTE_DESKTOP_INVOKE_MS } from './remoteDesktopIce.js';import {@@ -434,6 +435,9 @@ const EXTENDED_INVOKE_CHANNELS: readonly string[] = [ORCA_REMOTE_WORKER_RELEASE_CHANNEL,// 远程控制 Lead 所在电脑时,读取那台视角下可选的运行设备(只读,真相在被控端)。ORCA_EXECUTION_DEVICES_CHANNEL,+ // 云端伙伴:交出伙伴前探测目标电脑是否支持接手(只读常量,无 sender 依赖、无本机 UI 副作用)。+ // 老版本无 handler → CHANNEL_NOT_ALLOWED,交出方拒绝该目标。+ COMPANION_CLOUD_CAPS_CHANNEL,// —— Rewind / Fork / Title / Context ——'maker:rewind:preview','maker:rewind:commit',diff --git a/packages/device-link/src/companionCloud.ts b/packages/device-link/src/companionCloud.tsnew file mode 100644index 0000000000..07c24ca067--- /dev/null+++ b/packages/device-link/src/companionCloud.ts@@ -0,0 +1,17 @@+/**+ * 云端伙伴(docs/product-rules/cloud-companions.md):把伙伴交给另一台电脑前,先确认那台电脑的+ * Cindy 支持接手云端伙伴。只读能力探测,返回 `{ companionCloud: 1 }`;老版本没有该 channel →+ * CHANNEL_NOT_ALLOWED,交出方据此拒绝目标(不把伙伴交给接不住它的电脑)。+ */+export const COMPANION_CLOUD_CAPS_CHANNEL = 'maker:companion-cloud:caps';+export const COMPANION_CLOUD_VERSION = 1;++export interface CompanionCloudCaps {+ companionCloud: number;+}++/** True when the remote answer declares cloud-companion support. */+export function isCompanionCloudCaps(value: unknown): value is CompanionCloudCaps {+ return !!value && typeof value === 'object' && typeof (value as { companionCloud?: unknown }).companionCloud === 'number'+ && (value as { companionCloud: number }).companionCloud >= COMPANION_CLOUD_VERSION;+}diff --git a/packages/device-link/src/index.ts b/packages/device-link/src/index.tsindex a418335e31..d16bb621fc 100644--- a/packages/device-link/src/index.ts+++ b/packages/device-link/src/index.ts@@ -64,4 +64,5 @@ export * from "./inputDelivery.js";export * from "./taskMigration.js";export * from "./remoteAgent.js";export * from "./orcaRemoteWorker.js";+export * from "./companionCloud.js";export * from './pluginPages.js';diff --git a/scripts/shared/design-inventory.mjs b/scripts/shared/design-inventory.mjsindex bac252854a..628a55fde2 100644--- a/scripts/shared/design-inventory.mjs+++ b/scripts/shared/design-inventory.mjs@@ -1405,6 +1405,7 @@ export function mobileCatalogSurfaces() {['plugins', '插件目录、页面与原生交互', ['plugins.tsx']],['companions.direct', '伙伴私聊回看', ['companions/direct/[threadId].tsx']],['companions.groups', '伙伴群聊与分工', ['companions/groups/[groupId].tsx']],+ ['companions.cloud', '云端伙伴:主力电脑离线时的对话与换电脑', ['companions/cloud/[actorId].tsx']],['chat.session', '任务内容与输入', ['sessions/[sessionId].tsx']],['chat.sharing', '共享任务邀请与成员;供应商分享链接提示', ['shared-session.tsx', 'provider-share.tsx']],['chat.new', '新建任务', ['sessions/new.tsx']],