Skip to content

armgit / cindy

Public Imported from GitHub
0

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

fix(deeplink): 外部打开任务时保留设备归属

Dashc8126f9a57d4
diff --git a/apps/desktop/src/main/__tests__/deepLink.test.ts b/apps/desktop/src/main/__tests__/deepLink.test.ts
index 8eea8615b7..515a4f32a9 100644
--- a/apps/desktop/src/main/__tests__/deepLink.test.ts
+++ b/apps/desktop/src/main/__tests__/deepLink.test.ts
@@ -67,7 +67,7 @@ describe('history task links', () => {
['other::task', 'host', 'task', 'other'],
])('routes %s to its owning computer', (key, localDeviceId, sessionId, deviceId) => {
const url = buildHistorySessionDeepLink(key, localDeviceId);
- expect(parseDeepLink(url)).toEqual({ type: 'session', id: sessionId });
+ expect(parseDeepLink(url)).toEqual({ type: 'session', id: sessionId, deviceId });
expect(new URL(url).searchParams.get('device')).toBe(deviceId);
expect(url).not.toContain('::');
});
@@ -288,12 +288,11 @@ describe('parseDeepLink', () => {
});
});
- it('tolerates the device-frozen link format when routing a click', () => {
- // 远程会话深链带 `?device=`(renderer 生成);main 端点击路由按 sessionId
- // 导航即可,未知参数不拖累 session / message 解析。
+ it('preserves the owning device and message anchor when routing an external click', () => {
expect(parseDeepLink(buildSessionDeepLink('abc-123', { deviceId: 'dev-1' }))).toEqual({
type: 'session',
id: 'abc-123',
+ deviceId: 'dev-1',
});
expect(
parseDeepLink(buildSessionMessageDeepLink('abc-123', 'm1', { deviceId: 'dev-1' })),
@@ -301,6 +300,7 @@ describe('parseDeepLink', () => {
type: 'session',
id: 'abc-123',
messageClientId: 'm1',
+ deviceId: 'dev-1',
});
});
diff --git a/apps/desktop/src/main/deepLink.ts b/apps/desktop/src/main/deepLink.ts
index aaa9f8430c..9140f41326 100644
--- a/apps/desktop/src/main/deepLink.ts
+++ b/apps/desktop/src/main/deepLink.ts
@@ -77,7 +77,7 @@ export type DeepLinkPayload =
* islandEntryId 只由主进程的灵动岛点击写入(URL 解析从不产生它),标识这一次点击,
* 供 renderer 在导航落地后申请处置被点的那张卡。
*/
- | { type: 'session'; id: string; messageClientId?: string; islandEntryId?: string }
+ | { type: 'session'; id: string; deviceId?: string; messageClientId?: string; islandEntryId?: string }
| { type: 'chat-message'; groupId: string; messageId: string; threadRootId?: string; conversationKind?: 'direct' }
| { type: 'project'; workingDir: string }
/**
@@ -145,11 +145,13 @@ export function parseDeepLink(url: string): DeepLinkPayload | null {
}
if (!decoded) return null;
if (type === 'session') {
- // session 深链支持消息锚点 `?message=<clientId>`(其余 type 维持剥 query 语义)。
- const messageClientId = parseSessionMessageParam(rawValue);
- return messageClientId
- ? { type: 'session', id: decoded, messageClientId }
- : { type: 'session', id: decoded };
+ const messageClientId = parseSessionQueryParam(rawValue, 'message');
+ const deviceId = parseSessionQueryParam(rawValue, 'device');
+ return {
+ type: 'session', id: decoded,
+ ...(messageClientId ? { messageClientId } : {}),
+ ...(deviceId ? { deviceId } : {}),
+ };
}
if (type === 'project') {
return { type: 'project', workingDir: decoded };
@@ -200,10 +202,10 @@ function parseSettingsConnectParam(rawValue: string): string | null | typeof INV
}
/**
- * 从 session 深链的原始 value(`<id>?message=...#...`)里抽 `message` 参数。
+ * 从 session 深链的原始 value 里抽消息锚点或设备归属。
* 值为空 / 解码失败 → null(锚点非法不拖累 sessionId 本身的解析)。
*/
-function parseSessionMessageParam(rawValue: string): string | null {
+function parseSessionQueryParam(rawValue: string, key: 'message' | 'device'): string | null {
const hashIdx = rawValue.indexOf('#');
const noHash = hashIdx >= 0 ? rawValue.slice(0, hashIdx) : rawValue;
const queryIdx = noHash.indexOf('?');
@@ -211,7 +213,7 @@ function parseSessionMessageParam(rawValue: string): string | null {
const query = noHash.slice(queryIdx + 1);
for (const pair of query.split('&')) {
const eqIdx = pair.indexOf('=');
- if (eqIdx <= 0 || pair.slice(0, eqIdx) !== 'message') continue;
+ if (eqIdx <= 0 || pair.slice(0, eqIdx) !== key) continue;
const rawParam = pair.slice(eqIdx + 1);
if (!rawParam) return null;
try {
diff --git a/apps/desktop/src/preload/__tests__/deepLinkIslandEntryBridge.test.ts b/apps/desktop/src/preload/__tests__/deepLinkIslandEntryBridge.test.ts
index 46fbdd3f79..b7d0bde04b 100644
--- a/apps/desktop/src/preload/__tests__/deepLinkIslandEntryBridge.test.ts
+++ b/apps/desktop/src/preload/__tests__/deepLinkIslandEntryBridge.test.ts
@@ -3,7 +3,7 @@ import ts from 'typescript';
import { afterEach, describe, expect, it, vi } from 'vitest';
import type { BrowserWindow } from 'electron';
-import { openMainWindowSession, setDeepLinkMainWindow } from '../../main/deepLink';
+import { handleIncomingDeepLink, openMainWindowSession, setDeepLinkMainWindow, takePendingDeepLink } from '../../main/deepLink';
vi.mock('electron', () => ({ app: { focus: vi.fn() }, BrowserWindow: class {} }));
vi.mock('../../main/logger', () => ({ createLogger: () => ({ info: vi.fn(), warn: vi.fn(), debug: vi.fn() }) }));
@@ -47,6 +47,20 @@ function connect() {
afterEach(() => setDeepLinkMainWindow(null));
describe('Agent Island click id across the preload deep-link bridge', () => {
+ // External links must keep their owning computer through both the live bridge
+ // and the cold-start buffer; otherwise a same-id local task wins.
+ it('preserves a remote task and message through live delivery and cold start', () => {
+ const href = 'cindy://session/same?device=other-mac&message=m-1';
+ const expected = { type: 'session', id: 'same', deviceId: 'other-mac', messageClientId: 'm-1' };
+ const { received } = connect();
+ handleIncomingDeepLink(href, 'open-url');
+ expect(received).toEqual([expected]);
+ setDeepLinkMainWindow(null);
+ handleIncomingDeepLink(href, 'argv');
+ expect(takePendingDeepLink()).toEqual(expected);
+ expect(takePendingDeepLink()).toBeNull();
+ });
+
it('carries the click id main put on a loaded main window session entry', () => {
const { received } = connect();
openMainWindowSession('lane-1', { islandEntryId: '42' });
diff --git a/apps/desktop/src/preload/preload.ts b/apps/desktop/src/preload/preload.ts
index 6d483f6f75..b7258cbbd4 100644
--- a/apps/desktop/src/preload/preload.ts
+++ b/apps/desktop/src/preload/preload.ts
@@ -3996,7 +3996,7 @@ contextBridge.exposeInMainWorld('electronAPI', {
onDeepLinkNavigate: (
callback: (
payload:
- | { type: 'session'; id: string; messageClientId?: string; islandEntryId?: string }
+ | { type: 'session'; id: string; deviceId?: string; messageClientId?: string; islandEntryId?: string }
| { type: 'chat-message'; groupId: string; messageId: string; threadRootId?: string }
| { type: 'project'; workingDir: string }
| { type: 'new-session'; workingDir: string }
@@ -4024,6 +4024,7 @@ contextBridge.exposeInMainWorld('electronAPI', {
tab?: unknown;
connect?: unknown;
messageClientId?: unknown;
+ deviceId?: unknown;
islandEntryId?: unknown;
groupId?: unknown;
messageId?: unknown;
@@ -4033,6 +4034,9 @@ contextBridge.exposeInMainWorld('electronAPI', {
callback({
type: 'session',
id: p.id,
+ ...(typeof p.deviceId === 'string' && p.deviceId.length > 0
+ ? { deviceId: p.deviceId }
+ : {}),
...(typeof p.messageClientId === 'string' && p.messageClientId.length > 0
? { messageClientId: p.messageClientId }
: {}),
@@ -4102,7 +4106,7 @@ contextBridge.exposeInMainWorld('electronAPI', {
// MainLayout mount 和供应商导入唤醒事件共用此入口,take 一次清空。
// 详见 main/deepLink.ts 的 pending buffer 段。
takePendingDeepLink: (): Promise<
- | { type: 'session'; id: string; messageClientId?: string; islandEntryId?: string }
+ | { type: 'session'; id: string; deviceId?: string; messageClientId?: string; islandEntryId?: string }
| { type: 'chat-message'; groupId: string; messageId: string; threadRootId?: string }
| { type: 'project'; workingDir: string }
| { type: 'new-session'; workingDir: string }
diff --git a/apps/desktop/src/renderer/__tests__/orcaSessionIdentity.test.ts b/apps/desktop/src/renderer/__tests__/orcaSessionIdentity.test.ts
index b7685469d5..493038fea5 100644
--- a/apps/desktop/src/renderer/__tests__/orcaSessionIdentity.test.ts
+++ b/apps/desktop/src/renderer/__tests__/orcaSessionIdentity.test.ts
@@ -141,6 +141,12 @@ describe('orcaSessionIdentity', () => {
await expect(resolveSessionRoute('bot-main', { orcaRole: null })).resolves.toBe('/cc-agent/bot-main');
});
+ it('does not redirect an explicitly remote task to a same-id local Bot', async () => {
+ bots.profiles = [{ id: 'local', sessions: [{ id: 'same', role: 'canonical', kind: 'chat' }] }];
+ await expect(resolveSessionRoute('same', { orcaRole: null }, { remote: true })).resolves.toBe('/cc-agent/same');
+ await expect(resolveSessionRoute('same', { orcaRole: null })).resolves.toBe('/bots/local');
+ });
+
it('routes orphaned Orca workers back through the index fallback', async () => {
const api = electronApiMock();
api.localDb.orcaWorkflows.getByWorkerSession.mockResolvedValue(null);
diff --git a/apps/desktop/src/renderer/components/layout/MainLayout.tsx b/apps/desktop/src/renderer/components/layout/MainLayout.tsx
index e5462812f7..e94ac8064e 100644
--- a/apps/desktop/src/renderer/components/layout/MainLayout.tsx
+++ b/apps/desktop/src/renderer/components/layout/MainLayout.tsx
@@ -553,14 +553,15 @@ export function MainLayout() {
const currentPathRef = useRef(`${location.pathname}${location.search}`);
currentPathRef.current = `${location.pathname}${location.search}`;
const navigateToOrdinarySession = useCallback(
- (sessionId: string, messageClientId?: string, isLatest: () => boolean = () => true) => {
+ (sessionId: string, messageClientId?: string, isLatest: () => boolean = () => true, deviceId?: string) => {
+ if (deviceId) remoteProjectsStore.pinSessionOrigin(deviceId, sessionId);
// device-link 远程会话本地无 row:resolveSessionRoute 内部的 sessionService.get
// 会 miss → 远程 Orca lead/worker 被当普通会话路由,CCAgentSessionView 再
// redirect 到 orca 路由时会丢 searchJump 锚点。传入远程镜像的 session 对象,
// 让 Orca 路由一步到位(Codex review P2,与 SessionLinkChip 同款处理)。
const remoteSession =
remoteProjectsStore.getVisibleMergedRemoteSessions().find((s) => s.id === sessionId) ?? null;
- void resolveSessionRoute(sessionId, remoteSession).then((target) => {
+ void resolveSessionRoute(sessionId, remoteSession, { remote: !!deviceId }).then((target) => {
if (!isLatest()) return;
const visibleSession = resolveAgentIslandVisibleSessionFromRouteTarget(target);
if (messageClientId) {
@@ -600,6 +601,7 @@ export function MainLayout() {
// One navigator for the layout's lifetime: its sequence must span re-renders so a
// late lookup for an earlier notification cannot override a newer click.
const [navigateToSession] = useState(() => createSessionEntryNavigator({
+ isRemoteDevice: async (deviceId) => deviceId !== await window.electronAPI.getDeviceId(),
readKnownBotRoute: (sessionId) => botRouteForOwnedSession(getBotProfiles(), sessionId)
?? remoteBotRouteForSession(readRemoteBots(), sessionId),
resolveBotRoute: (sessionId) => resolveBotRouteForSessionEntry(sessionId, {
@@ -620,8 +622,8 @@ export function MainLayout() {
// 群专线没有可处置报错的横幅:目标地址提交后请 main
// 处置这次点击的那张卡(main 只认最近一次点击与当时的卡片身份,见 BotSessionEntryTarget)。
consumeAlert: requestIslandEntryAlertDisposal,
- openOrdinary: (sessionId, messageClientId, isLatest) =>
- sessionEntryDepsRef.current.navigateToOrdinarySession(sessionId, messageClientId, isLatest),
+ openOrdinary: (sessionId, messageClientId, isLatest, deviceId) =>
+ sessionEntryDepsRef.current.navigateToOrdinarySession(sessionId, messageClientId, isLatest, deviceId),
}));
navigateToSessionRef.current = navigateToSession;
// 已提交的地址交给入口导航器:灵动岛卡片的处置等到目标地址真正提交后才发。
@@ -698,7 +700,7 @@ export function MainLayout() {
const handleDeepLinkPayload = useCallback(
(
payload:
- | { type: 'session'; id: string; messageClientId?: string; islandEntryId?: string }
+ | { type: 'session'; id: string; deviceId?: string; messageClientId?: string; islandEntryId?: string }
| { type: 'chat-message'; groupId: string; messageId: string; threadRootId?: string; conversationKind?: 'direct' }
| { type: 'project'; workingDir: string }
| { type: 'new-session'; workingDir: string }
@@ -734,7 +736,7 @@ export function MainLayout() {
return;
}
if (payload.type === 'session') {
- navigateToSession(payload.id, payload.messageClientId, payload.islandEntryId);
+ navigateToSession(payload.id, payload.messageClientId, payload.islandEntryId, payload.deviceId);
return;
}
if (payload.type === 'project') {
diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botSessionOwners.test.ts b/apps/desktop/src/renderer/features/bots/__tests__/botSessionOwners.test.ts
index db15b0a741..b6d8990932 100644
--- a/apps/desktop/src/renderer/features/bots/__tests__/botSessionOwners.test.ts
+++ b/apps/desktop/src/renderer/features/bots/__tests__/botSessionOwners.test.ts
@@ -173,6 +173,46 @@ describe('伙伴归属表', () => {
});
describe('通知入口在伙伴投影未加载时的路由', () => {
+ // External task links carry a device, including this computer's own id. Resolve
+ // it within the existing latest-entry guard before consulting local Bot ownership.
+ it.each([true, false])('routes an explicit device without letting a same-id local Bot win (remote=%s)', async (remote) => {
+ const openOrdinary = vi.fn();
+ const openBotRoute = vi.fn();
+ const readKnownBotRoute = vi.fn(() => ({ route: '/bots/local', consumesAlert: false }));
+ const open = createSessionEntryNavigator({
+ isRemoteDevice: async () => remote,
+ readKnownBotRoute,
+ resolveBotRoute: vi.fn(),
+ openBotRoute, consumeAlert: vi.fn(), openOrdinary,
+ });
+ open('same', 'message-1', undefined, 'device-1');
+ await Promise.resolve();
+ if (remote) {
+ expect(openOrdinary).toHaveBeenCalledWith('same', 'message-1', expect.any(Function), 'device-1');
+ expect(readKnownBotRoute).not.toHaveBeenCalled();
+ expect(openBotRoute).not.toHaveBeenCalled();
+ } else {
+ expect(openBotRoute).toHaveBeenCalledWith('/bots/local', undefined);
+ expect(openOrdinary).not.toHaveBeenCalled();
+ }
+ });
+
+ it('drops a delayed device lookup after a newer entry has opened', async () => {
+ let resolveDevice!: (remote: boolean) => void;
+ const openOrdinary = vi.fn();
+ const open = createSessionEntryNavigator({
+ isRemoteDevice: () => new Promise((resolve) => { resolveDevice = resolve; }),
+ readKnownBotRoute: () => null, resolveBotRoute: async () => null,
+ openBotRoute: vi.fn(), consumeAlert: vi.fn(), openOrdinary,
+ });
+ open('old', undefined, undefined, 'other-mac');
+ open('new');
+ resolveDevice(true);
+ await Promise.resolve();
+ expect(openOrdinary).toHaveBeenCalledTimes(1);
+ expect(openOrdinary).toHaveBeenCalledWith('new', undefined, expect.any(Function));
+ });
+
function deps(over: {
current?: BotProfile[];
loaded?: BotProfile[];
diff --git a/apps/desktop/src/renderer/features/bots/botSessionOwners.ts b/apps/desktop/src/renderer/features/bots/botSessionOwners.ts
index 7bc6100bca..aa1107e9e3 100644
--- a/apps/desktop/src/renderer/features/bots/botSessionOwners.ts
+++ b/apps/desktop/src/renderer/features/bots/botSessionOwners.ts
@@ -157,6 +157,8 @@ export async function resolveBotRouteForSessionEntry(
}
export interface SessionEntryNavigatorDeps {
+ /** Compare an explicit link device with this computer before consulting local ownership. */
+ isRemoteDevice?: (deviceId: string) => Promise<boolean>;
/** The target from the projection already in memory; null when it does not know the Session. */
readKnownBotRoute: (sessionId: string) => BotSessionEntryTarget | null;
/** Re-reads the projection for a Session it did not know (see resolveBotRouteForSessionEntry). */
@@ -166,11 +168,11 @@ export interface SessionEntryNavigatorDeps {
/** Asks main to dispose the card of this island click (see BotSessionEntryTarget). */
consumeAlert: (sessionId: string, islandEntryId: string) => void;
/** `isLatest` lets the ordinary path drop its own late async route result too. */
- openOrdinary: (sessionId: string, messageClientId: string | undefined, isLatest: () => boolean) => void;
+ openOrdinary: (sessionId: string, messageClientId: string | undefined, isLatest: () => boolean, deviceId?: string) => void;
}
export interface SessionEntryNavigator {
- (sessionId: string, messageClientId?: string, islandEntryId?: string): void;
+ (sessionId: string, messageClientId?: string, islandEntryId?: string, deviceId?: string): void;
/** Report every location the router has committed (`pathname + search`). */
locationCommitted: (path: string) => void;
}
@@ -218,31 +220,42 @@ export function createSessionEntryNavigator(
throw error;
}
};
- const open = (sessionId: string, messageClientId?: string, islandEntryId?: string) => {
+ const open = (sessionId: string, messageClientId?: string, islandEntryId?: string, deviceId?: string) => {
const entry = ++sequence;
pending = null;
committedSinceOpen = new Set();
const isLatest = () => sequence === entry;
- const known = deps.readKnownBotRoute(sessionId);
- // Background tasks keep their ordinary page with message anchors and visible-session reporting.
- if (known && !known.route.startsWith('/cc-agent/')) {
- openBotTarget(entry, sessionId, known, islandEntryId);
+ if (deviceId && deps.isRemoteDevice) {
+ void deps.isRemoteDevice(deviceId).then((remote) => {
+ if (!isLatest()) return;
+ if (remote) deps.openOrdinary(sessionId, messageClientId, isLatest, deviceId);
+ else openLocal();
+ });
return;
}
- let movedToBotPage = false;
- deps.openOrdinary(sessionId, messageClientId, () => isLatest() && !movedToBotPage);
- if (known) return;
- const ordinaryRoute = `/cc-agent/${encodeURIComponent(sessionId)}`;
- void deps.resolveBotRoute(sessionId).then((target) => {
- if (!isLatest() || !target || target.route.startsWith('/cc-agent/')) return;
- // Correct only this entry's own landing: the ordinary page, or the Bot page the ordinary
- // path already resolved to. Any other committed location means the user moved on.
- for (const path of committedSinceOpen) {
- if (path !== ordinaryRoute && path !== target.route) return;
+ openLocal();
+ function openLocal() {
+ const known = deps.readKnownBotRoute(sessionId);
+ // Background tasks keep their ordinary page with message anchors and visible-session reporting.
+ if (known && !known.route.startsWith('/cc-agent/')) {
+ openBotTarget(entry, sessionId, known, islandEntryId);
+ return;
}
- movedToBotPage = true;
- openBotTarget(entry, sessionId, target, islandEntryId);
- });
+ let movedToBotPage = false;
+ deps.openOrdinary(sessionId, messageClientId, () => isLatest() && !movedToBotPage);
+ if (known) return;
+ const ordinaryRoute = `/cc-agent/${encodeURIComponent(sessionId)}`;
+ void deps.resolveBotRoute(sessionId).then((target) => {
+ if (!isLatest() || !target || target.route.startsWith('/cc-agent/')) return;
+ // Correct only this entry's own landing: the ordinary page, or the Bot page the ordinary
+ // path already resolved to. Any other committed location means the user moved on.
+ for (const path of committedSinceOpen) {
+ if (path !== ordinaryRoute && path !== target.route) return;
+ }
+ movedToBotPage = true;
+ openBotTarget(entry, sessionId, target, islandEntryId);
+ });
+ }
};
return Object.assign(open, {
locationCommitted: (path: string) => {
diff --git a/apps/desktop/src/renderer/lib/orcaSessionIdentity.ts b/apps/desktop/src/renderer/lib/orcaSessionIdentity.ts
index 63acaaab08..c9a5c670c0 100644
--- a/apps/desktop/src/renderer/lib/orcaSessionIdentity.ts
+++ b/apps/desktop/src/renderer/lib/orcaSessionIdentity.ts
@@ -54,6 +54,7 @@ function loadedBotChatRoute(sessionId: string): string | null {
export async function resolveSessionRoute(
sessionId: string,
session?: Pick<Session, 'orcaRole'> & Partial<Pick<Session, 'source'>> | null,
+ options?: { remote?: boolean },
): Promise<string> {
const targetSession = session ?? (await getSessionFor(sessionId).catch(() => null));
if (!CINDY_MAKE_ENABLED && isCindyMakeSource(targetSession?.source)) return '/cc-agent';
@@ -70,7 +71,7 @@ export async function resolveSessionRoute(
}
// Notifications, task cards and the main sidebar agree on one page per task.
- const botRoute = loadedBotChatRoute(sessionId);
+ const botRoute = options?.remote ? null : loadedBotChatRoute(sessionId);
if (botRoute) return botRoute;
return `/cc-agent/${sessionId}`;
diff --git a/apps/desktop/src/renderer/vite-env.d.ts b/apps/desktop/src/renderer/vite-env.d.ts
index ed534ba393..8469b3eefa 100644
--- a/apps/desktop/src/renderer/vite-env.d.ts
+++ b/apps/desktop/src/renderer/vite-env.d.ts
@@ -3059,7 +3059,7 @@ interface ElectronAPI {
onDeepLinkNavigate: (
callback: (
payload:
- | { type: 'session'; id: string; messageClientId?: string; islandEntryId?: string }
+ | { type: 'session'; id: string; deviceId?: string; messageClientId?: string; islandEntryId?: string }
| { type: 'chat-message'; groupId: string; messageId: string; threadRootId?: string; conversationKind?: 'direct' }
| { type: 'project'; workingDir: string }
| { type: 'new-session'; workingDir: string }
@@ -3080,7 +3080,7 @@ interface ElectronAPI {
* Feishu OAuth 后能继续消费当时的"点击意图"。
*/
takePendingDeepLink: () => Promise<
- | { type: 'session'; id: string; messageClientId?: string; islandEntryId?: string }
+ | { type: 'session'; id: string; deviceId?: string; messageClientId?: string; islandEntryId?: string }
| { type: 'chat-message'; groupId: string; messageId: string; threadRootId?: string; conversationKind?: 'direct' }
| { type: 'project'; workingDir: string }
| { type: 'new-session'; workingDir: string }
diff --git a/docs/dev-rules/protocol-compatibility.md b/docs/dev-rules/protocol-compatibility.md
index 35e04bc09f..4d76e57b89 100644
--- a/docs/dev-rules/protocol-compatibility.md
+++ b/docs/dev-rules/protocol-compatibility.md
@@ -1,5 +1,17 @@
# 跨端协议兼容
+## 任务链接保留所属电脑
+
+任务查询返回可选 `sessionUrl`,沿用 `cindy://session/<id>?device=<deviceId>`。
+桌面外部打开与冷启动缓存的 session payload 新增可选 `deviceId`,Main、preload 和
+Renderer 均保留它。导航先与本机设备 ID 比较;远端链接先登记现有会话 origin,
+再通过原传输层读取,不把相同 ID 的本机伙伴任务当作目标。设备判断沿用入口导航器的
+最新点击判据,迟到结果不覆盖后续点击。没有设备参数的旧链接保持原导航流程。
+不增加 IPC channel、远程授权、重试或连接恢复;离线目标仍由现有传输层报告。
+回滚后新增查询字段可忽略,但旧 Desktop 从外部打开远程链接仍有丢失设备参数的限制。
+回归入口:`deepLink.test.ts`、`deepLinkIslandEntryBridge.test.ts`、
+`botSessionOwners.test.ts`、`orcaSessionIdentity.test.ts`。
+
## 手机经电脑确认群消息已读
群 Remote Resource 投影新增可选 `supportsReadReceipts`,仅云端群声明。