Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
feat(bots): 理顺伙伴与群聊入口,点开邀请即可加入,私聊可拉伙伴进群 (#6013)
Dash23c15643b93e
diff --git a/apps/desktop/src/main/__tests__/deepLink.test.ts b/apps/desktop/src/main/__tests__/deepLink.test.tsindex 5c94c61cb2..092bc10d44 100644--- a/apps/desktop/src/main/__tests__/deepLink.test.ts+++ b/apps/desktop/src/main/__tests__/deepLink.test.ts@@ -84,9 +84,24 @@ describe('chat invitation handoff', () => {it('recognizes the existing generated link and rejects ambiguous targets', () => {expect(parseDeepLink(link)).toEqual({ type: 'chat-invite', token });expect(parseDeepLink(link.replace('cindy:', 'xdt-maker:'))).toEqual({ type: 'chat-invite', token });- for (const value of [link + '/extra', link + '?token=other', link + '#secret', link + 'a', link.slice(0, -1)]) {- expect(parseDeepLink(value)).toBeNull();+ // A damaged invitation never yields a token, but the click is reported instead of ignored.+ for (const value of [link + '/extra', link + '?token=other', link + '#secret', link + 'a', link.slice(0, -1), 'cindy://chat-invite/']) {+ expect(parseDeepLink(value)).toEqual({ type: 'chat-invite-malformed' });}+ expect(parseDeepLink('cindy://chat-invite')).toBeNull();+ });+ it('queues one malformed-link notice behind valid invitations without logging the link', () => {+ setDeepLinkMainWindow(null);+ const damaged = link.slice(0, -3);+ handleIncomingDeepLink(damaged, 'open-url');+ handleIncomingDeepLink(link, 'open-url');+ handleIncomingDeepLink(damaged + 'x', 'second-instance');+ handleIncomingDeepLink('cindy://session/ordinary-task', 'open-url');+ expect(takePendingDeepLink()).toEqual({ type: 'chat-invite-malformed' });+ expect(takePendingDeepLink()).toEqual({ type: 'chat-invite', token });+ expect(takePendingDeepLink()).toEqual({ type: 'session', id: 'ordinary-task' });+ expect(takePendingDeepLink()).toBeNull();+ expect(JSON.stringify(Object.values(logs).map(log => log.mock.calls))).not.toContain(damaged.slice('cindy://chat-invite/'.length));});it.each(['open-url', 'cold-start-argv', 'second-instance'])('retains %s through login focus and unrelated navigation', source => {setDeepLinkMainWindow(null);diff --git a/apps/desktop/src/main/deepLink.ts b/apps/desktop/src/main/deepLink.tsindex f738af44ce..e359de2b68 100644--- a/apps/desktop/src/main/deepLink.ts+++ b/apps/desktop/src/main/deepLink.ts@@ -3,7 +3,8 @@* ---------------------------------------------------------------------------* URL 形态(scheme 单点在 shared/deepLinkSchemes.ts:生成一律主 scheme cindy://,* 解析主 + 历史 scheme 都认——存量消息里的 xdt-maker:// 老链接不能死):- * cindy://chat-invite/<token> —— 预填群邀请,预览后由用户确认加入+ * cindy://chat-invite/<token> —— 打开群邀请,自动预览后由用户确认加入;+ * 口令残缺时只回报「链接无效」,不带链接内容* cindy://session/<sessionId> —— sessionId 直接是 string id* cindy://project/<urlencoded-workingDir> —— workingDir 全路径 URL-encoded* cindy://settings/providers[?connect=<providerId>] —— 打开设置「模型供应商」页,@@ -67,6 +68,8 @@ export const OPEN_SHARE_FILE_FLAG = '--open-share-file';export type DeepLinkPayload =| { type: 'chat-invite'; token: string }+ /** 点开的群邀请链接口令残缺或被改动:不带任何链接内容,只让 Renderer 明确告知。 */+ | { type: 'chat-invite-malformed' }| { type: 'shared-task-join'; invitation: string; server: string }/** 供应商分享链接:原样交给 Renderer 的申请弹窗,由主进程命令再解析与核对区域。 */| { type: 'provider-share-join'; link: string }@@ -115,7 +118,7 @@ export function parseDeepLink(url: string): DeepLinkPayload | null {const rest = url.slice(prefix.length);if (rest.startsWith('chat-invite/')) {const token = rest.slice('chat-invite/'.length);- return /^[A-Za-z0-9_-]{43}$/.test(token) ? { type: 'chat-invite', token } : null;+ return /^[A-Za-z0-9_-]{43}$/.test(token) ? { type: 'chat-invite', token } : { type: 'chat-invite-malformed' };}// provider/import 是双段精确路径,必须在通用 type/value 解析前消费。if (rest.startsWith('provider/')) {@@ -282,7 +285,7 @@ export function buildFocusDeepLink(source: string): string {// 直接 webContents.send,不进 pendinglet pendingDeepLink: DeepLinkPayload | null = null;// Invitation targets must survive unrelated navigation and login focus callbacks.-const pendingChatInvitations: Array<Extract<DeepLinkPayload, { type: 'chat-invite' }>> = [];+const pendingChatInvitations: Array<Extract<DeepLinkPayload, { type: 'chat-invite' | 'chat-invite-malformed' }>> = [];let mainWindowRef: BrowserWindow | null = null;export function setDeepLinkMainWindow(win: BrowserWindow | null): void {@@ -440,8 +443,9 @@ function dispatchDeepLink(payload: DeepLinkPayload, shouldFocus = true): void {}const win = mainWindowRef;const windowReady = win && !win.isDestroyed() && win.webContents && !win.webContents.isLoading();- if (payload.type === 'chat-invite') {- if (!pendingChatInvitations.some(invitation => invitation.token === payload.token)) {+ if (payload.type === 'chat-invite' || payload.type === 'chat-invite-malformed') {+ if (!pendingChatInvitations.some(invitation => invitation.type === payload.type+ && (payload.type === 'chat-invite-malformed' || (invitation.type === 'chat-invite' && invitation.token === payload.token)))) {pendingChatInvitations.push(payload);}if (shouldFocus) focusMainWindow();diff --git a/apps/desktop/src/main/maker-ipc/__tests__/chatServer.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/chatServer.test.tsindex bb8cea44fc..fee7ac0ec3 100644--- a/apps/desktop/src/main/maker-ipc/__tests__/chatServer.test.ts+++ b/apps/desktop/src/main/maker-ipc/__tests__/chatServer.test.ts@@ -1378,6 +1378,12 @@ describe('Chat Server directed sends', () => {return entry === 'thread' ? service.chatServer!.reply({ ...input, rootId }) : service.sendMessage(input);};+ it('maps each owned Chat Server actor back to its local teammate for entry points outside group settings', async () => {+ const result = await service.chatServer!.ownedBots();+ expect(result).toMatchObject({ ok: true });+ expect(result.ok && result.bots.some(bot => bot.botId === 'local-bot' && typeof bot.actorId === 'string')).toBe(true);+ });+it.each(['main', 'thread'])('rejects a selected bot that left before the %s send instead of posting empty mentions', async entry => {await service.chatServer!.ownedBots();members[1]!.state = 'left';diff --git a/apps/desktop/src/main/maker-ipc/__tests__/chatServerInvitations.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/chatServerInvitations.test.tsindex 00ca0d28f1..b543fe7807 100644--- a/apps/desktop/src/main/maker-ipc/__tests__/chatServerInvitations.test.ts+++ b/apps/desktop/src/main/maker-ipc/__tests__/chatServerInvitations.test.ts@@ -83,6 +83,34 @@ describe('Chat Server invitation contract', () => {reusable = flag;expect(await service.chatServer!.createInvite({ groupId, clientId })).toEqual({ ok: false, errorCode: 'CHAT_RESPONSE_INVALID' });});+ it('previews and accepts the public page link through this account’s own Chat Server with only the token', async () => {+ const page = `https://device-link.other-region.example/chat-invite/join#${token}?app=cindycn`;+ fixture.urls.length = 0;+ expect((await service.chatServer!.previewInvite({ link: `邀请你加入群聊:${page}` })).ok).toBe(true);+ const accepted = vi.fn(() => ({ body: { groupId } }));+ const original = fixture.handle.getMockImplementation()!;+ fixture.handle.mockImplementation((route, ...rest) => route === '/invite-links/accept' ? accepted() : original(route, ...rest));+ expect(await service.chatServer!.acceptInvite({ link: page, clientId })).toEqual({ ok: true, groupId });+ expect(fixture.handle).toHaveBeenCalledWith('/invite-links/preview', 'POST', { token }, expect.anything());+ expect(fixture.handle).toHaveBeenCalledWith('/invite-links/accept', 'POST', { token, operationId: clientId }, expect.anything());+ // The link's host is never a request target, and the token never enters a URL.+ expect(fixture.urls.every(url => url.startsWith('https://chat.cindy.app/'))).toBe(true);+ expect(fixture.urls.some(url => url.includes(token))).toBe(false);+ });+ it.each([+ `https://relay.example.test/chat-invite/join?t=1#${token}`,+ `https://[email protected]/chat-invite/join#${token}`,+ `https://relay.example.test/chat-invite/join#${token}?app=other`,+ `https://relay.example.test/chat-invite/join#${token}#more`,+ `ftp://relay.example.test/chat-invite/join#${token}`,+ `cindy://chat-invite/${token.slice(1)}`,+ ])('rejects %s before contacting the service and without echoing the token', async input => {+ for (const result of [await service.chatServer!.previewInvite({ link: input }), await service.chatServer!.acceptInvite({ link: input, clientId })]) {+ expect(result).toEqual({ ok: false, errorCode: 'INVALID_INPUT' });+ expect(JSON.stringify(result)).not.toContain(token.slice(1));+ }+ expect(fixture.handle.mock.calls.some(([route]) => String(route).startsWith('/invite-links/'))).toBe(false);+ });it('preserves server denial and never accepts an invitation during preview', async () => {fixture.handle.mockImplementation(route => route === '/invite-links/preview'? { status: 404, body: { error: { code: 'INVITATION_NOT_FOUND' } } } : { body: [] });diff --git a/apps/desktop/src/main/maker-ipc/chatServer.ts b/apps/desktop/src/main/maker-ipc/chatServer.tsindex 8c3d7e28e5..b86ef2e2fc 100644--- a/apps/desktop/src/main/maker-ipc/chatServer.ts+++ b/apps/desktop/src/main/maker-ipc/chatServer.ts@@ -6,6 +6,7 @@ import { getClientEndpoint } from '../clientEndpointsService.js';import { readFile as readMedia } from '../cindy-media/blobStore.js';import { getAccessToken, refresh } from '../authManager.js';import { retryAfterDeadline } from '@cindy/auth-client';+import { parseChatInvitationToken } from '@cindy/device-link';import { existsSync, readFileSync } from 'node:fs';import { request as httpRequest } from 'node:http';import { request as httpsRequest } from 'node:https';@@ -1278,9 +1279,9 @@ function createChatServer(local: BotGroupChatService, deps: BotGroupChatServiceDtry { return { ok: true as const, ...await fn() }; }catch (error) { return { ok: false as const, errorCode: error instanceof z.ZodError ? 'INVALID_INPUT' : error instanceof Error ? error.message : 'REQUEST_FAILED' }; }};- const inviteToken = (link: string) => z.string().regex(/^[A-Za-z0-9_-]{43}$/).parse(- z.string().max(100).parse(link).trim().replace(/^cindy:\/\/chat-invite\//, ''),- );+ // Bare token, cindy://chat-invite/<token> or the public https page link; only the token+ // reaches this account's own Chat Server. An unreadable link is INVALID_INPUT.+ const inviteToken = (link: string) => z.string().regex(/^[A-Za-z0-9_-]{43}$/).parse(parseChatInvitationToken(link) ?? '');// Null is the server's non-expiring contract; omitted/invalid dates are never// treated as permanent links. Older servers keep their dated, single-use links.const inviteExpiry = z.string().refine(value => Number.isFinite(Date.parse(value))).nullable();@@ -1294,7 +1295,7 @@ function createChatServer(local: BotGroupChatService, deps: BotGroupChatServiceD}const operationId = z.string().min(8).max(160).regex(/^[a-zA-Z0-9_.:-]+$/);const chatServer: ChatServerApi = {- ownedBots: () => result(async () => { await register(); return { bots: actors.filter(a => a.kind === 'bot' && localBot(a.id)?.status === 'active').map(a => ({ actorId: a.id, name: a.name })) }; }),+ ownedBots: () => result(async () => { await register(); return { bots: actors.flatMap(a => { const bot = a.kind === 'bot' ? localBot(a.id) : undefined; return bot?.status === 'active' ? [{ actorId: a.id, botId: bot.id, name: a.name }] : []; }) }; }),refreshProfile: () => result(async () => {await api('/profile/refresh', 'POST'); profileRefreshedAt = Date.now();for (const roomId of rooms.keys()) changed(roomId);diff --git a/apps/desktop/src/preload/preload.ts b/apps/desktop/src/preload/preload.tsindex 36ff986801..ef28085c2a 100644--- a/apps/desktop/src/preload/preload.ts+++ b/apps/desktop/src/preload/preload.ts@@ -3795,6 +3795,7 @@ contextBridge.exposeInMainWorld('electronAPI', {| { type: 'provider-import'; importId: string }| { type: 'shared-task-join'; invitation: string; server: string }| { type: 'chat-invite'; token: string }+ | { type: 'chat-invite-malformed' }| { type: 'settings'; tab: 'voice-input' | 'providers'; connect?: string },) => void,): (() => void) =>@@ -3836,6 +3837,8 @@ contextBridge.exposeInMainWorld('electronAPI', {});} else if (p.type === 'chat-invite' && typeof p.token === 'string' && /^[A-Za-z0-9_-]{43}$/.test(p.token)) {callback({ type: 'chat-invite', token: p.token });+ } else if (p.type === 'chat-invite-malformed') {+ callback({ type: 'chat-invite-malformed' });} else if (p.type === 'shared-task-join' && typeof p.invitation === 'string' && /^[A-Za-z0-9_-]{43}$/.test(p.invitation) && typeof p.server === 'string' && p.server.length <= 2048) {callback({ type: 'shared-task-join', invitation: p.invitation, server: p.server });} else if (@@ -3876,6 +3879,7 @@ contextBridge.exposeInMainWorld('electronAPI', {| { type: 'provider-import'; importId: string }| { type: 'shared-task-join'; invitation: string; server: string }| { type: 'chat-invite'; token: string }+ | { type: 'chat-invite-malformed' }| { type: 'settings'; tab: 'voice-input' | 'providers'; connect?: string }| null> => ipcRenderer.invoke('deep-link:take-pending'),diff --git a/apps/desktop/src/renderer/components/layout/MainLayout.tsx b/apps/desktop/src/renderer/components/layout/MainLayout.tsxindex d963c8ded7..1d083b9d3c 100644--- a/apps/desktop/src/renderer/components/layout/MainLayout.tsx+++ b/apps/desktop/src/renderer/components/layout/MainLayout.tsx@@ -1,5 +1,5 @@import { drainPendingDeepLinks } from '@/lib/pendingDeepLinks';-import { ChatInviteHost, requestChatInvite } from '@/features/bots/ChatInviteHost';+import { ChatInviteHost, reportMalformedChatInvite, requestChatInvite } from '@/features/bots/ChatInviteHost';import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';import { buildSharedTaskInvitationLink } from '@cindy/device-link';import { JoinSharedTaskDialog } from '@/features/device-link/JoinSharedTaskDialog';@@ -640,6 +640,7 @@ export function MainLayout() {| { type: 'provider-import'; importId: string }| { type: 'shared-task-join'; invitation: string; server: string }| { type: 'chat-invite'; token: string }+ | { type: 'chat-invite-malformed' }| { type: 'provider-share-join'; link: string }| { type: 'settings'; tab: 'voice-input' | 'providers' | 'billing'; connect?: string; intent?: 'topup' },) => {@@ -647,6 +648,10 @@ export function MainLayout() {requestChatInvite(payload.token);return;}+ if (payload.type === 'chat-invite-malformed') {+ reportMalformedChatInvite();+ return;+ }if (payload.type === 'provider-share-join') {requestProviderShareJoin(payload.link);return;@@ -711,7 +716,7 @@ export function MainLayout() {useEffect(() => {const unsubscribe = window.electronAPI.onDeepLinkNavigate((payload) => {- if (payload.type === 'chat-invite') {+ if (payload.type === 'chat-invite' || payload.type === 'chat-invite-malformed') {void pullChatInvitations();return;}diff --git a/apps/desktop/src/renderer/features/bots/BotAddToGroupMenu.tsx b/apps/desktop/src/renderer/features/bots/BotAddToGroupMenu.tsxnew file mode 100644index 0000000000..aa8d646831--- /dev/null+++ b/apps/desktop/src/renderer/features/bots/BotAddToGroupMenu.tsx@@ -0,0 +1,134 @@+/**+ * The private chat's way into group chat: start a new group with this teammate+ * already picked, or bring them into a group you are in. It reuses the group+ * creation dialog and the same member invitation the group settings use, so the+ * server's membership rules stay the only authority. The private chat itself is+ * untouched — group lanes never carry its history.+ */+import { useRef, useState } from 'react';+import { MessagesSquare, UserPlus, Users } from 'lucide-react';+import { useNavigate } from 'react-router-dom';+import { useTranslation } from 'react-i18next';++import {+ DropdownMenu,+ DropdownMenuContent,+ DropdownMenuItem,+ DropdownMenuLabel,+ DropdownMenuSub,+ DropdownMenuSubContent,+ DropdownMenuSubTrigger,+ DropdownMenuTrigger,+} from '@/components/ui/dropdown-menu';+import { WINDOW_NO_DRAG_STYLE } from '@/components/layout/windowDrag';+import { getDataOwnerGeneration, isDataOwnerGenerationCurrent } from '@/contexts/dataOwnerGeneration';+import { toast } from '@/lib/toast';+import { BotGroupCreateDialog, isSelectable } from './BotGroupCreateDialog';+import { refreshBotGroups, useBotGroupList } from './botGroupStore';+import { useBotProfiles } from './botStore';+import { chatErrorKey } from './chatError';++const key = (name: string) => `bots.groupChat.addFromChat.${name}`;+const groupRoute = (id: string) => `/bots/groups/${encodeURIComponent(id)}`;++export function BotAddToGroupMenu({ botId }: { botId: string }) {+ const { t } = useTranslation();+ const navigate = useNavigate();+ const bot = useBotProfiles().find(profile => profile.id === botId);+ const { groups } = useBotGroupList();+ const [creating, setCreating] = useState(false);+ const [menuOpen, setMenuOpen] = useState(false);+ const [busy, setBusy] = useState(false);+ const busyRef = useRef(false);+ const trigger = useRef<HTMLButtonElement>(null);+ // A paused, disabled or archived teammate cannot join anything: no entry rather than a dead one.+ if (!bot || !isSelectable(bot)) return null;+ const joinable = groups.filter(group => group.serverBacked && !group.archived+ && !group.members.some(member => member.botId === botId));++ async function addTo(groupId: string, groupName: string) {+ if (busyRef.current) return;+ busyRef.current = true; setBusy(true);+ const owner = getDataOwnerGeneration();+ const failed = (code: string) => { if (isDataOwnerGenerationCurrent(owner)) toast.error(t(chatErrorKey(code))); };+ try {+ const api = window.electronAPI.maker.chatServer;+ const owned = await api.ownedBots();+ if (!isDataOwnerGenerationCurrent(owner)) return;+ if (!owned.ok) { failed(owned.errorCode); return; }+ const actorId = owned.bots.find(candidate => candidate.botId === botId)?.actorId;+ if (!actorId) { toast.error(t(key('unavailable'), { name: bot!.name })); return; }+ const result = await api.manage({ groupId, action: { type: 'member', actorId, action: 'invite' } });+ if (!isDataOwnerGenerationCurrent(owner)) return;+ if (!result.ok) { failed(result.errorCode); return; }+ refreshBotGroups();+ toast.success(t(key('added'), { name: bot!.name, group: groupName }), {+ // Long enough to reach the action; hover and focus pause it further.+ duration: 6000,+ // The toast outlives this account: after a switch its group belongs to someone else.+ action: { label: t(key('openGroup')), onClick: () => { if (isDataOwnerGenerationCurrent(owner)) navigate(groupRoute(groupId)); } },+ });+ } catch {+ failed('REQUEST_FAILED');+ } finally {+ busyRef.current = false; setBusy(false);+ }+ }++ const label = t(key('triggerFor'), { name: bot.name });+ return (+ <>+ {/* busyRef flips before focus returns to the trigger, so a repeated Enter cannot reopen+ the menu while the previous addition is still pending. */}+ <DropdownMenu open={menuOpen} onOpenChange={open => {+ if (open && busyRef.current) return;+ if (open) refreshBotGroups();+ setMenuOpen(open);+ }}>+ <DropdownMenuTrigger asChild>+ <button+ ref={trigger}+ type="button"+ aria-label={label}+ title={label}+ disabled={busy}+ className="flex h-7 w-7 shrink-0 items-center justify-center rounded-full text-[var(--text-tertiary)] hover:bg-[var(--surface-hover)] hover:text-[var(--text-primary)] disabled:opacity-50"+ style={WINDOW_NO_DRAG_STYLE}+ >+ <UserPlus size={15} />+ </button>+ </DropdownMenuTrigger>+ <DropdownMenuContent align="end" onCloseAutoFocus={event => { if (creating) event.preventDefault(); }}>+ <DropdownMenuItem onSelect={() => setCreating(true)}>+ <Users size={14} className="mr-2" />+ {t(key('newGroup'))}+ </DropdownMenuItem>+ {joinable.length > 0 ? (+ <DropdownMenuSub>+ <DropdownMenuSubTrigger>+ <MessagesSquare size={14} className="mr-2" />+ {t(key('existingGroup'))}+ </DropdownMenuSubTrigger>+ <DropdownMenuSubContent className="max-h-72 max-w-64 overflow-y-auto">+ {/* Name both sides of the action before it runs: this teammate, into that group. */}+ <DropdownMenuLabel className="truncate">{t(key('addTo'), { name: bot.name })}</DropdownMenuLabel>+ {joinable.map(group => (+ <DropdownMenuItem key={group.id} disabled={busy} onSelect={() => void addTo(group.id, group.name)}>+ <span className="min-w-0 truncate">{group.name}</span>+ </DropdownMenuItem>+ ))}+ </DropdownMenuSubContent>+ </DropdownMenuSub>+ ) : null}+ </DropdownMenuContent>+ </DropdownMenu>+ {creating ? (+ <BotGroupCreateDialog+ initialBotIds={[botId]}+ onOpenChange={open => { if (!open) { setCreating(false); trigger.current?.focus(); } }}+ onCreated={id => { setCreating(false); navigate(groupRoute(id)); }}+ />+ ) : null}+ </>+ );+}diff --git a/apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx b/apps/desktop/src/renderer/features/bots/BotCreateMenu.tsxindex 21c8121637..1cf5756e29 100644--- a/apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx+++ b/apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx@@ -1,16 +1,17 @@import { Button } from '@/components/ui/button';-import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger } from '@/components/ui/dropdown-menu';-import { Bot, Plus, Users } from 'lucide-react';+import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger } from '@/components/ui/dropdown-menu';+import { Bot, Link2, Plus, Users } from 'lucide-react';import { useRef, useState } from 'react';import { useNavigate } from 'react-router-dom';import { BotRosterView } from './BotRosterView';import { BotGroupCreateDialog } from './BotGroupCreateDialog';+import { ChatInviteDialog } from './ChatInviteDialog';import { useTranslation } from 'react-i18next';export function BotCreateMenu({ compact = false, label }: { compact?: boolean; label?: string }) {const { t } = useTranslation();const navigate = useNavigate();- const [dialog, setDialog] = useState<'bot' | 'group' | null>(null);+ const [dialog, setDialog] = useState<'bot' | 'group' | 'join' | null>(null);const trigger = useRef<HTMLButtonElement>(null);return (@@ -52,6 +53,13 @@ export function BotCreateMenu({ compact = false, label }: { compact?: boolean; l<Users size={14} className="mr-2" />{t('bots.groupChat.create.title')}</DropdownMenuItem>+ {/* Clicking an invitation opens it directly; this is the fallback when the link+ arrived as plain text that the sending app did not make clickable. */}+ <DropdownMenuSeparator />+ <DropdownMenuItem onSelect={() => setDialog('join')}>+ <Link2 size={14} className="mr-2" />+ {t('bots.list.joinWithLink')}+ </DropdownMenuItem></DropdownMenuContent></DropdownMenu>)}@@ -67,6 +75,12 @@ export function BotCreateMenu({ compact = false, label }: { compact?: boolean; lonCreated={id => { setDialog(null); navigate(`/bots/groups/${encodeURIComponent(id)}`); }}/>) : null}+ {dialog === 'join' ? (+ <ChatInviteDialog+ onClose={() => { setDialog(null); trigger.current?.focus(); }}+ onJoined={id => navigate(`/bots/groups/${encodeURIComponent(id)}`)}+ />+ ) : null}</>);}diff --git a/apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx b/apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsxindex 85911d7bd1..c0d9d0c460 100644--- a/apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx+++ b/apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx@@ -28,14 +28,18 @@ function pickableBots(bots: readonly BotProfile[]): BotProfile[] {.sort((a, b) => a.createdAt - b.createdAt || a.id.localeCompare(b.id));}-function isSelectable(bot: BotProfile): boolean {+/** Whether a teammate can join a group right now (shared with entry points outside this dialog). */+export function isSelectable(bot: BotProfile): boolean {return (bot.status ?? 'active') === 'active' && bot.enabled !== false;}export function BotGroupCreateDialog({+ initialBotIds = [],onOpenChange,onCreated,}: {+ /** Preselected teammates, e.g. the one whose private chat started this group. */+ initialBotIds?: readonly string[];onOpenChange: (open: boolean) => void;onCreated: (groupId: string) => void;}) {@@ -51,7 +55,7 @@ export function BotGroupCreateDialog({}, []);const minMembers = serverBacked ? 0 : BOT_GROUP_MIN_MEMBERS;const [name, setName] = useState('');- const [selectedIds, setSelectedIds] = useState<string[]>([]);+ const [selectedIds, setSelectedIds] = useState<string[]>(() => initialBotIds.slice(0, BOT_GROUP_MAX_MEMBERS));const [nameError, setNameError] = useState(false);const [membersError, setMembersError] = useState(false);const [submitError, setSubmitError] = useState<string | null>(null);diff --git a/apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx b/apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsxindex 9258fe494c..6fd1c6082a 100644--- a/apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx+++ b/apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx@@ -8,7 +8,8 @@* right end of the bar — because "click the name" is the discoverable one and* "the gear is on the right" is the learned one. Local teammates also get a* permanent way into their workbench here: the sidebar tab can be closed, and- * nothing else reopens it.+ * nothing else reopens it — plus the IM-style "add people" entry that turns+ * this chat into a group or brings the teammate into one.*/import { useMemo } from 'react';import { LayoutGrid, Settings2 } from 'lucide-react';@@ -18,6 +19,7 @@ import { useTranslation } from 'react-i18next';import { WINDOW_NO_DRAG_STYLE } from '@/components/layout/windowDrag';import { useRegisterContentHeader } from '../feature-context';import { openBotWorkbenchTab } from '@/features/right-sidebar/lib/openBotWorkbenchTab';+import { BotAddToGroupMenu } from './BotAddToGroupMenu';import { BotAvatar } from './BotAvatar';import { isCindyDeviceBot } from './cindyDeviceRoster';import { CindyHeaderDevicePicker } from './CindyDevicePicker';@@ -32,6 +34,8 @@ export interface BotChatIdentity {name: string;avatar?: string | null;avatarColor?: string | null;+ /** Only the teammate's own canonical private chat (not channel routes or read-only history) can start a group. */+ canonicalChat?: boolean;}export function BotSessionContentHeader({ bot }: { bot: BotChatIdentity }) {@@ -67,6 +71,7 @@ export function BotSessionContentHeader({ bot }: { bot: BotChatIdentity }) {{bot.deviceName}</span>) : null}+ {bot.canonicalChat && !bot.deviceId ? <BotAddToGroupMenu botId={bot.id} /> : null}{!bot.deviceId && bot.sessionId ? (<buttontype="button"diff --git a/apps/desktop/src/renderer/features/bots/BotSessionView.tsx b/apps/desktop/src/renderer/features/bots/BotSessionView.tsxindex bec9364ac9..e1146ccae4 100644--- a/apps/desktop/src/renderer/features/bots/BotSessionView.tsx+++ b/apps/desktop/src/renderer/features/bots/BotSessionView.tsx@@ -107,6 +107,12 @@ function BotSessionGateView() {: gateIdentity,[gateIdentity, liveName, liveAvatar, liveAvatarColor],);+ // A read-only demoted copy offers no add-to-group entry, like its settings.+ const canonicalChat = gate.kind === 'ready' && gate.isCanonical && !shadowed;+ const chatIdentity = useMemo(+ () => (gateIdentity ? { ...(identity ?? gateIdentity), canonicalChat } : null),+ [gateIdentity, identity, canonicalChat],+ );useEffect(() => {let cancelled = false;@@ -269,7 +275,7 @@ function BotSessionGateView() {<div className="min-h-0 flex-1"><CCAgentSessionViewbotMentions={gate.mentions}- botIdentity={identity ?? gate.identity}+ botIdentity={chatIdentity ?? gate.identity}botUnreadBoundaryAt={gate.unreadBoundaryAt}onBotReadThrough={gate.isCanonical ? onReadThrough : undefined}{...(readOnly ? { readOnly: true } : {})}diff --git a/apps/desktop/src/renderer/features/bots/BotsSidebar.tsx b/apps/desktop/src/renderer/features/bots/BotsSidebar.tsxindex b9f8504937..f8c9631dae 100644--- a/apps/desktop/src/renderer/features/bots/BotsSidebar.tsx+++ b/apps/desktop/src/renderer/features/bots/BotsSidebar.tsx@@ -60,7 +60,6 @@ import { refreshBotGroups, useBotGroupList } from './botGroupStore';import { BOT_GROUP_SETTINGS_PARAM } from './botGroupPresentation';import { chatErrorKey } from './chatError';import { subscribeBotReadState, getBotLastReadAtMap } from './botReadState';-import { ChatJoinButton } from './ChatServerControls';import { isBotGroupLaneSession, withoutBotGroupLanes } from './botGroupLane';import {botListSubtitle,@@ -554,7 +553,6 @@ function BotsSidebarContent() {{showHidden ? <EyeOff size={15} /> : <Eye size={15} />}</button>) : null}- <ChatJoinButton onJoined={id => navigate(`/bots/groups/${encodeURIComponent(id)}`)} /><BotCreateMenu /></span></div>diff --git a/apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsx b/apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsxindex 7656314413..e2c24fdf2c 100644--- a/apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsx+++ b/apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsx@@ -13,8 +13,16 @@ import { chatErrorKey } from './chatError';const key = (name: string) => `bots.groupChat.server.${name}`;const api = () => window.electronAPI.maker.chatServer;-export function ChatInviteDialog({ groupId, initialLink = '', onClose, onJoined }: { groupId?: string; initialLink?: string; onClose: () => void; onJoined?: (id: string) => void }) {+/**+ * Without `groupId` this joins a group: either from a clicked invitation+ * (`initialLink`, previewed immediately, no paste field) or from a pasted link.+ * `malformedLink` reports a clicked link whose token could not be read.+ */+export function ChatInviteDialog({ groupId, initialLink = '', malformedLink = false, onClose, onJoined }: {+ groupId?: string; initialLink?: string; malformedLink?: boolean; onClose: () => void; onJoined?: (id: string) => void;+}) {const { t, i18n } = useTranslation();+ const fromLink = !groupId && (Boolean(initialLink) || malformedLink);const [link, setLink] = useState(initialLink);const [expiresAt, setExpiresAt] = useState<string | null | undefined>();const [reusable, setReusable] = useState<boolean | undefined>();@@ -23,13 +31,18 @@ export function ChatInviteDialog({ groupId, initialLink = '', onClose, onJoinedconst [revokeUnsupported, setRevokeUnsupported] = useState(false);const [now, setNow] = useState(Date.now());const [preview, setPreview] = useState<ChatInvitePreview | null>(null);- const [error, setError] = useState('');- const [busy, setBusy] = useState(false);+ const [error, setError] = useState(() => malformedLink ? t(key('malformedInvite')) : '');+ // The server said this invitation cannot be used; asking it again will not help.+ const [unusable, setUnusable] = useState(malformedLink);+ const [busy, setBusy] = useState(fromLink && !malformedLink);const busyRef = useRef(false);const mounted = useRef(true);const operation = useRef(crypto.randomUUID());const revokeOperation = useRef(crypto.randomUUID());useEffect(() => { mounted.current = true; return () => { mounted.current = false; }; }, []);+ // A clicked link already expresses the intent to look (once, on open); joining still+ // needs the explicit accept.+ useEffect(() => { if (fromLink && !malformedLink) void run(); }, []);const expiry = groupId ? expiresAt : preview?.expiresAt;const expired = typeof expiry === 'string' && Date.parse(expiry) <= now;useEffect(() => {@@ -53,6 +66,9 @@ export function ChatInviteDialog({ groupId, initialLink = '', onClose, onJoinedbusyRef.current = true; setBusy(true); setError('');const owner = getDataOwnerGeneration();const current = () => mounted.current && isDataOwnerGenerationCurrent(owner);+ // Reading an invitation is side-effect free; a result discarded for an older owner+ // generation is simply read again for the current one instead of leaving the dialog loading.+ const reading = action === 'main' && !groupId && !preview;try {if (action === 'copy') {if (expired || (typeof expiry === 'string' && Date.parse(expiry) <= Date.now()) || revoked || !link) return;@@ -80,16 +96,19 @@ export function ChatInviteDialog({ groupId, initialLink = '', onClose, onJoined} else if (!preview) {const result = await api().previewInvite({ link });if (!current()) return;- if (!result.ok) { setError(t(chatErrorKey(result.errorCode))); return; }+ if (!result.ok) {+ setUnusable(chatErrorKey(result.errorCode) === key('invalidInvite'));+ setError(t(chatErrorKey(result.errorCode))); return;+ }+ // Already a member: the invitation's only remaining purpose is to open the group.+ if (result.joined) { onJoined?.(result.groupId); onClose(); return; }setPreview(result); setNow(Date.now());- } else if (preview.joined) {- onJoined?.(preview.groupId); onClose();} else {if (expired || (typeof expiry === 'string' && Date.parse(expiry) <= Date.now())) return;const result = await api().acceptInvite({ link, clientId: operation.current });if (!current()) return;if (!result.ok) {- if (['INVITATION_NOT_FOUND', 'INVITATION_UNAVAILABLE'].includes(result.errorCode)) setPreview(null);+ if (['INVITATION_NOT_FOUND', 'INVITATION_UNAVAILABLE'].includes(result.errorCode)) { setPreview(null); setUnusable(fromLink); }setError(t(chatErrorKey(result.errorCode))); return;}refreshBotGroups(); onJoined?.(result.groupId); onClose();@@ -104,19 +123,24 @@ export function ChatInviteDialog({ groupId, initialLink = '', onClose, onJoinedif (mounted.current) {setBusy(false);if (action === 'revoke') setRevokeConfirm(false);+ if (reading && !isDataOwnerGenerationCurrent(owner)) void run();}}}const title = t(key(groupId ? 'invite' : 'join'));- return <Dialog.Root open onOpenChange={open => !busyRef.current && !open && onClose()}>+ // Reading a clicked invitation changes nothing, so it never traps the user; accepting,+ // creating and revoking still hold the dialog until their result is known.+ const locked = () => busyRef.current && !(fromLink && !preview);+ return <Dialog.Root open onOpenChange={open => !open && !locked() && onClose()}><Dialog.Portal><Dialog.Overlay className="modal-scrim fixed inset-0 z-[70]" /><Dialog.Content onPointerDownOutside={e => e.preventDefault()}- onEscapeKeyDown={e => { if (e.isComposing || e.keyCode === 229 || busyRef.current) e.preventDefault(); }}+ onEscapeKeyDown={e => { if (e.isComposing || e.keyCode === 229 || locked()) e.preventDefault(); }}className="modal-panel fixed inset-0 z-[71] m-auto flex h-fit max-h-[85vh] w-[min(460px,calc(100vw-32px))] flex-col gap-4 p-5 outline-none"><Dialog.Title className="text-18 font-medium text-[var(--confirm-title)]">{title}</Dialog.Title>- <Dialog.Description className="text-13 leading-normal text-[var(--confirm-desc)]">{t(key(groupId ? 'inviteDescription' : 'joinDescription'))}</Dialog.Description>- {(!groupId || link) && <Input aria-label={t(key('inviteLink'))} value={link} readOnly={!!groupId} disabled={busy || revoked}+ <Dialog.Description className="text-13 leading-normal text-[var(--confirm-desc)]">{t(key(groupId ? 'inviteDescription' : fromLink ? 'linkDescription' : 'joinDescription'))}</Dialog.Description>+ {!fromLink && (!groupId || link) && <Input aria-label={t(key('inviteLink'))} value={link} readOnly={!!groupId} disabled={busy || revoked}placeholder={t(key('pasteLink'))} onChange={value => { setLink(value); setPreview(null); setError(''); operation.current = crypto.randomUUID(); }} />}+ {fromLink && !preview && !error && <p role="status" className="text-13 leading-normal text-[var(--text-secondary)]">{t(key('loadingInvite'))}</p>}{preview && <div className="space-y-1 rounded-lg bg-[var(--surface-elevated)] p-3"><p className="text-15 font-medium text-[var(--text-primary)]">{preview.name}</p><p className="text-13 text-[var(--text-secondary)]">{t(key('invitedBy'), { name: preview.inviterName })}</p>@@ -125,12 +149,12 @@ export function ChatInviteDialog({ groupId, initialLink = '', onClose, onJoined{groupId && link && !revoked && !expired && !canRevoke && <p className="text-13 leading-normal text-[var(--text-secondary)]">{t(key('revokeUnsupported'))}</p>}{error && <p role="alert" className="text-13 text-[var(--error-fg)]">{error}</p>}<div className="flex flex-wrap justify-end gap-2">- <Button variant="secondary" palette="confirmation" size="lg" disabled={busy} onClick={onClose}>{t('bots.close')}</Button>+ <Button variant="secondary" palette="confirmation" size="lg" disabled={busy && !(fromLink && !preview)} onClick={onClose}>{t('bots.close')}</Button>{groupId && link && !revoked && !expired && <Button variant="secondary" palette="confirmation" size="lg" disabled={busy || !canRevoke} onClick={() => setRevokeConfirm(true)}>{t(key('revokeLink'))}</Button>}{groupId && link && !expired && !revoked? <Button variant="cta" palette="confirmation" size="lg" loading={busy} onClick={() => void run('copy')}>{t(key('copyLink'))}</Button>- : <Button variant="cta" palette="confirmation" size="lg" loading={busy} disabled={!groupId && (!link.trim() || (expired && !preview?.joined))} onClick={() => void run()}>- {t(key(groupId ? 'createLink' : preview ? (preview.joined ? 'openGroup' : 'accept') : 'previewInvite'))}+ : (!fromLink || preview || (error && !unusable)) && <Button variant="cta" palette="confirmation" size="lg" loading={busy} disabled={!groupId && (!link.trim() || expired)} onClick={() => void run()}>+ {t(key(groupId ? 'createLink' : preview ? 'accept' : fromLink ? 'retryInvite' : 'previewInvite'))}</Button>}</div></Dialog.Content>diff --git a/apps/desktop/src/renderer/features/bots/ChatInviteHost.tsx b/apps/desktop/src/renderer/features/bots/ChatInviteHost.tsxindex cb329312cd..e9d09f34d4 100644--- a/apps/desktop/src/renderer/features/bots/ChatInviteHost.tsx+++ b/apps/desktop/src/renderer/features/bots/ChatInviteHost.tsx@@ -6,6 +6,8 @@ import { ChatInviteDialog } from './ChatInviteDialog';// in memory through login/owner remounts; every new dialog re-previews as the// current account and still requires explicit acceptance.let pending: readonly string[] = [];+/** Stands in for a clicked link whose token was unreadable; never a valid 43-character token. */+const MALFORMED = 'malformed';const listeners = new Set<() => void>();const getSnapshot = () => pending;const subscribe = (listener: () => void) => {@@ -13,12 +15,21 @@ const subscribe = (listener: () => void) => {return () => { listeners.delete(listener); };};-export function requestChatInvite(token: string): void {- if (!/^[A-Za-z0-9_-]{43}$/.test(token) || pending.includes(token)) return;- pending = [...pending, token];+function enqueue(entry: string): void {+ if (pending.includes(entry)) return;+ pending = [...pending, entry];for (const listener of listeners) listener();}+export function requestChatInvite(token: string): void {+ if (/^[A-Za-z0-9_-]{43}$/.test(token)) enqueue(token);+}++/** A clicked invitation link was truncated or altered: say so instead of ignoring the click. */+export function reportMalformedChatInvite(): void {+ enqueue(MALFORMED);+}+function dismiss(token: string): void {pending = pending.filter(value => value !== token);for (const listener of listeners) listener();@@ -28,6 +39,7 @@ function dismiss(token: string): void {export function ChatInviteHost() {const [token] = useSyncExternalStore(subscribe, getSnapshot);const navigate = useNavigate();+ if (token === MALFORMED) return <ChatInviteDialog key={token} malformedLink onClose={() => dismiss(token)} />;return token ? <ChatInviteDialog key={token} initialLink={`cindy://chat-invite/${token}`}onClose={() => dismiss(token)}onJoined={id => navigate(`/bots/groups/${encodeURIComponent(id)}`)} /> : null;diff --git a/apps/desktop/src/renderer/features/bots/ChatServerControls.tsx b/apps/desktop/src/renderer/features/bots/ChatServerControls.tsxindex de2411464b..ae43aa98a2 100644--- a/apps/desktop/src/renderer/features/bots/ChatServerControls.tsx+++ b/apps/desktop/src/renderer/features/bots/ChatServerControls.tsx@@ -1,5 +1,5 @@import { chatErrorKey } from './chatError';-import { useEffect, useRef, useState } from 'react';+import { useRef, useState } from 'react';import { ChatInviteDialog } from './ChatInviteDialog';import { UserPlus } from 'lucide-react';import { useTranslation } from 'react-i18next';@@ -69,23 +69,13 @@ export function ChatMessageActions({ groupId, shareScope, message, align = messa);}-function InviteControl({ groupId, onJoined }: { groupId?: string; onJoined?: (id: string) => void }) {+/** Group owners and admins create or revoke invitation links from the group header. */+export function ChatInviteButton({ groupId }: { groupId: string }) {const { t } = useTranslation();const [open, setOpen] = useState(false);- const title = t(key(groupId ? 'invite' : 'join'));+ const title = t(key('invite'));return <><Tip text={title}><button type="button" className={iconClass} style={WINDOW_NO_DRAG_STYLE} aria-label={title} onClick={() => setOpen(true)}><UserPlus size={16} /></button></Tip>- {open && <ChatInviteDialog groupId={groupId} onClose={() => setOpen(false)} onJoined={onJoined} />}+ {open && <ChatInviteDialog groupId={groupId} onClose={() => setOpen(false)} />}</>;}-export const ChatInviteButton = InviteControl;-export function ChatJoinButton({ onJoined }: { onJoined: (id: string) => void }) {- const [enabled, setEnabled] = useState(false);- useEffect(() => {- let disposed = false;- const read = () => { void window.electronAPI?.maker?.chatServer?.status().then(status => { if (!disposed) setEnabled(status.enabled); }).catch(() => undefined); };- read(); const timer = setInterval(read, 3000);- return () => { disposed = true; clearInterval(timer); };- }, []);- return enabled ? <InviteControl onJoined={onJoined} /> : null;-}diff --git a/apps/desktop/src/renderer/features/bots/__tests__/BotAddToGroupMenu.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/BotAddToGroupMenu.test.tsxnew file mode 100644index 0000000000..40ae3de564--- /dev/null+++ b/apps/desktop/src/renderer/features/bots/__tests__/BotAddToGroupMenu.test.tsx@@ -0,0 +1,156 @@+// @vitest-environment jsdom+import { act, cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';+import { afterEach, beforeEach, expect, it, vi } from 'vitest';+import { setDataOwnerGeneration } from '@/contexts/dataOwnerGeneration';++const mocks = vi.hoisted(() => ({+ profiles: [] as unknown[], groups: [] as unknown[], navigate: vi.fn(), refresh: vi.fn(),+ ownedBots: vi.fn(), manage: vi.fn(), success: vi.fn(), error: vi.fn(), createDialog: vi.fn(),+}));+vi.mock('react-i18next', () => ({ useTranslation: () => ({ t: (key: string, values?: object) => values ? `${key}:${JSON.stringify(values)}` : key }) }));+vi.mock('react-router-dom', () => ({ useNavigate: () => mocks.navigate }));+vi.mock('../botStore', () => ({ useBotProfiles: () => mocks.profiles }));+vi.mock('../botGroupStore', () => ({ useBotGroupList: () => ({ groups: mocks.groups, loaded: true }), refreshBotGroups: mocks.refresh }));+vi.mock('@/lib/toast', () => ({ toast: { success: mocks.success, error: mocks.error } }));+vi.mock('../BotGroupCreateDialog', async importOriginal => ({+ ...await importOriginal<typeof import('../BotGroupCreateDialog')>(),+ BotGroupCreateDialog: (props: { initialBotIds?: string[]; onCreated: (id: string) => void }) => {+ mocks.createDialog(props.initialBotIds);+ return <div role="dialog"><button type="button" onClick={() => props.onCreated('new-room')}>create</button></div>;+ },+}));++const { BotAddToGroupMenu } = await import('../BotAddToGroupMenu');+const k = (name: string) => `bots.groupChat.addFromChat.${name}`;+const teammate = (overrides = {}) => ({ id: 'bot-1', name: '小可', status: 'active', enabled: true, avatar: '', avatarColor: 'violet', createdAt: 1, sessions: [], ...overrides });+const group = (id: string, name: string, overrides = {}) => ({ id, name, serverBacked: true, archived: false, members: [], replyMode: 'all', speakingMode: 'auto', organizerBotId: null, ...overrides });+const trigger = `${k('triggerFor')}:${JSON.stringify({ name: '小可' })}`;+const openMenu = () => fireEvent.keyDown(screen.getByRole('button', { name: trigger }), { key: 'Enter' });+const openExisting = () => fireEvent.keyDown(screen.getByRole('menuitem', { name: k('existingGroup') }), { key: 'ArrowRight' });++beforeEach(() => {+ vi.clearAllMocks();+ setDataOwnerGeneration('owner-a');+ mocks.profiles = [teammate()];+ mocks.groups = [+ group('room-a', '产品组'),+ group('room-member', '已在群', { members: [{ botId: 'bot-1', name: '小可', avatar: '', avatarColor: 'violet', status: 'active' }] }),+ group('room-archived', '已归档', { archived: true }),+ group('room-local', '旧本地群', { serverBacked: false }),+ ];+ mocks.ownedBots.mockResolvedValue({ ok: true, bots: [{ actorId: 'actor-1', botId: 'bot-1', name: '小可' }] });+ mocks.manage.mockResolvedValue({ ok: true });+ Object.defineProperty(window, 'electronAPI', { configurable: true, value: { maker: { chatServer: { ownedBots: mocks.ownedBots, manage: mocks.manage } } } });+});+afterEach(cleanup);++it.each([+ ['paused', { status: 'paused' }],+ ['turned off', { enabled: false }],+ ['archived', { status: 'archived' }],+])('offers no entry for a %s teammate', (_label, overrides) => {+ mocks.profiles = [teammate(overrides)];+ render(<BotAddToGroupMenu botId="bot-1" />);+ expect(screen.queryByRole('button', { name: /triggerFor/ })).toBeNull();+});++it('offers no entry for a teammate that is not on this computer', () => {+ render(<BotAddToGroupMenu botId="remote-bot" />);+ expect(screen.queryByRole('button', { name: /triggerFor/ })).toBeNull();+});++it('starts a new group with this teammate preselected and opens it', () => {+ render(<BotAddToGroupMenu botId="bot-1" />);+ openMenu();+ expect(mocks.refresh).toHaveBeenCalled();+ fireEvent.click(screen.getByRole('menuitem', { name: k('newGroup') }));+ expect(mocks.createDialog).toHaveBeenCalledWith(['bot-1']);+ fireEvent.click(screen.getByRole('button', { name: 'create' }));+ expect(mocks.navigate).toHaveBeenCalledWith('/bots/groups/new-room');+ expect(mocks.manage).not.toHaveBeenCalled();+});++it('lists only shared groups the teammate can still join and adds it through the member invitation', async () => {+ render(<BotAddToGroupMenu botId="bot-1" />);+ openMenu(); openExisting();+ const items = (await screen.findAllByRole('menuitem')).map(item => item.textContent);+ expect(items).toContain('产品组');+ for (const hidden of ['已在群', '已归档', '旧本地群']) expect(items).not.toContain(hidden);+ // Before anything runs, the submenu names who is being added; each row names where.+ expect(screen.getByText(`${k('addTo')}:${JSON.stringify({ name: '小可' })}`)).toBeTruthy();+ await act(async () => { fireEvent.click(screen.getByRole('menuitem', { name: '产品组' })); });+ expect(mocks.manage).toHaveBeenCalledExactlyOnceWith({ groupId: 'room-a', action: { type: 'member', actorId: 'actor-1', action: 'invite' } });+ expect(mocks.refresh).toHaveBeenCalled();+ expect(mocks.success).toHaveBeenCalledWith(`${k('added')}:${JSON.stringify({ name: '小可', group: '产品组' })}`, expect.objectContaining({ action: expect.any(Object) }));+ mocks.success.mock.calls[0][1].action.onClick();+ expect(mocks.navigate).toHaveBeenCalledWith('/bots/groups/room-a');+});++it('ignores the success toast’s open action once the account has changed', async () => {+ render(<BotAddToGroupMenu botId="bot-1" />);+ openMenu(); openExisting();+ await act(async () => { fireEvent.click(await screen.findByRole('menuitem', { name: '产品组' })); });+ const { onClick } = mocks.success.mock.calls[0][1].action;+ setDataOwnerGeneration('owner-b');+ onClick();+ expect(mocks.navigate).not.toHaveBeenCalled();+});++it('hides the existing-group choice when there is nowhere left to add the teammate', () => {+ mocks.groups = [mocks.groups[1]];+ render(<BotAddToGroupMenu botId="bot-1" />);+ openMenu();+ expect(screen.getByRole('menuitem', { name: k('newGroup') })).toBeTruthy();+ expect(screen.queryByRole('menuitem', { name: k('existingGroup') })).toBeNull();+});++it.each([+ ['FORBIDDEN', 'bots.groupChat.server.notAllowed'],+ ['ROLE_REQUIRED', 'bots.groupChat.server.notAllowed'],+ ['REQUEST_TIMEOUT', 'bots.groupChat.server.requestFailed'],+])('explains a refused addition (%s) without claiming success', async (errorCode, message) => {+ mocks.manage.mockResolvedValue({ ok: false, errorCode });+ render(<BotAddToGroupMenu botId="bot-1" />);+ openMenu(); openExisting();+ await act(async () => { fireEvent.click(await screen.findByRole('menuitem', { name: '产品组' })); });+ expect(mocks.error).toHaveBeenCalledWith(message);+ expect(mocks.success).not.toHaveBeenCalled();+});++it('says the teammate is unavailable when Chat Server has no identity for it, without inviting anyone else', async () => {+ mocks.ownedBots.mockResolvedValue({ ok: true, bots: [{ actorId: 'actor-2', botId: 'bot-2', name: 'Other' }] });+ render(<BotAddToGroupMenu botId="bot-1" />);+ openMenu(); openExisting();+ await act(async () => { fireEvent.click(await screen.findByRole('menuitem', { name: '产品组' })); });+ expect(mocks.manage).not.toHaveBeenCalled();+ expect(mocks.error).toHaveBeenCalledWith(`${k('unavailable')}:${JSON.stringify({ name: '小可' })}`);+});++it('does not reopen the menu or add again while an addition is pending', async () => {+ let finish!: (value: unknown) => void;+ mocks.manage.mockReturnValue(new Promise(resolve => { finish = resolve; }));+ render(<BotAddToGroupMenu botId="bot-1" />);+ openMenu(); openExisting();+ fireEvent.click(await screen.findByRole('menuitem', { name: '产品组' }));+ await waitFor(() => expect(mocks.manage).toHaveBeenCalledTimes(1));+ openMenu();+ expect(screen.queryByRole('menuitem')).toBeNull();+ await act(async () => finish({ ok: true }));+ expect(mocks.manage).toHaveBeenCalledTimes(1);+ expect(mocks.success.mock.calls[0][1].duration).toBeGreaterThanOrEqual(5000);+ openMenu();+ expect(screen.getByRole('menuitem', { name: k('newGroup') })).toBeTruthy();+});++it('drops the result of an addition that finished after the account changed', async () => {+ let finish!: (value: unknown) => void;+ mocks.manage.mockReturnValue(new Promise(resolve => { finish = resolve; }));+ render(<BotAddToGroupMenu botId="bot-1" />);+ openMenu(); openExisting();+ fireEvent.click(await screen.findByRole('menuitem', { name: '产品组' }));+ await waitFor(() => expect(mocks.manage).toHaveBeenCalled());+ setDataOwnerGeneration('owner-b');+ await act(async () => finish({ ok: true }));+ expect(mocks.success).not.toHaveBeenCalled();+ expect(mocks.error).not.toHaveBeenCalled();+});diff --git a/apps/desktop/src/renderer/features/bots/__tests__/BotGroupCreateDialog.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/BotGroupCreateDialog.test.tsxindex 88a99be334..b17a9415f6 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/BotGroupCreateDialog.test.tsx+++ b/apps/desktop/src/renderer/features/bots/__tests__/BotGroupCreateDialog.test.tsx@@ -112,6 +112,18 @@ describe('BotGroupCreateDialog', () => {expect(onCreated).not.toHaveBeenCalled();});+ it('starts with the private-chat teammate already picked and still lets the user change it', async () => {+ const onCreated = vi.fn();+ render(<BotGroupCreateDialog initialBotIds={['c']} onOpenChange={vi.fn()} onCreated={onCreated} />);+ expect(checkbox('Bot c').getAttribute('aria-checked')).toBe('true');+ expect(checkbox('Bot a').getAttribute('aria-checked')).toBe('false');+ fireEvent.change(screen.getByRole('textbox'), { target: { value: '新项目' } });+ fireEvent.click(checkbox('Bot a'));+ fireEvent.click(screen.getByRole('button', { name: 'bots.groupChat.create.submit' }));+ await waitFor(() => expect(onCreated).toHaveBeenCalledWith('g-new'));+ expect(mocks.createBotGroup).toHaveBeenCalledWith({ name: '新项目', botIds: ['a', 'c'] });+ });+it('closes from Cancel', () => {const { onOpenChange } = renderDialog();fireEvent.click(screen.getByRole('button', { name: 'bots.cancel' }));diff --git a/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteDialog.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteDialog.test.tsxindex fff4025a0a..74c5baf817 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteDialog.test.tsx+++ b/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteDialog.test.tsx@@ -52,7 +52,7 @@ describe('invitation validity', () => {it('disables acceptance for expired previews', async () => {mocks.previewInvite.mockResolvedValue({ ok: true, groupId: 'room', name: 'Room', inviterName: 'Host', expiresAt: '2000-01-01T00:00:00Z', joined: false });render(<ChatInviteDialog initialLink={link} onClose={vi.fn()} />);- await act(async () => fireEvent.click(screen.getByRole('button', { name: k('previewInvite') })));+ await screen.findByText('Room');expect(screen.getByRole('status').textContent).toBe(k('expiredLink'));expect((screen.getByRole('button', { name: k('accept') }) as HTMLButtonElement).disabled).toBe(true);expect(mocks.acceptInvite).not.toHaveBeenCalled();@@ -161,12 +161,13 @@ describe('invitation validity', () => {it('discards a stale reusable preview when the server reports an expired or revoked link on acceptance', async () => {mocks.acceptInvite.mockResolvedValue({ ok: false, errorCode: 'INVITATION_NOT_FOUND' });render(<ChatInviteDialog initialLink={link} onClose={vi.fn()} />);- await act(async () => fireEvent.click(screen.getByRole('button', { name: k('previewInvite') })));+ await screen.findByRole('button', { name: k('accept') });expect(screen.getByRole('status').textContent).toBe(k('reusableLink'));await act(async () => fireEvent.click(screen.getByRole('button', { name: k('accept') })));expect(screen.queryByRole('status')).toBeNull();expect(screen.getByRole('alert').textContent).toBe(k('invalidInvite'));- expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(link);+ expect(screen.queryByRole('button', { name: k('accept') })).toBeNull();+ expect(mocks.previewInvite).toHaveBeenCalledTimes(1);});it('does not show permanent validity when a response omits the reusable flag', async () => {mocks.createInvite.mockResolvedValue({ ok: true, link, expiresAt: null });diff --git a/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteHost.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteHost.test.tsxindex 24d7c43196..e6e94f61b2 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteHost.test.tsx+++ b/apps/desktop/src/renderer/features/bots/__tests__/ChatInviteHost.test.tsx@@ -3,7 +3,7 @@ import { StrictMode } from 'react';import { act, cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';import { MemoryRouter, useLocation } from 'react-router-dom';import { afterEach, beforeEach, expect, it, vi } from 'vitest';-import { ChatInviteHost, requestChatInvite } from '../ChatInviteHost';+import { ChatInviteHost, reportMalformedChatInvite, requestChatInvite } from '../ChatInviteHost';import { setDataOwnerGeneration } from '@/contexts/dataOwnerGeneration';const api = vi.hoisted(() => ({ previewInvite: vi.fn(), acceptInvite: vi.fn() }));@@ -17,7 +17,7 @@ function Location() { return <p data-testid="location">{useLocation().pathname}<function mount() {return render(<StrictMode><MemoryRouter><ChatInviteHost /><Location /></MemoryRouter></StrictMode>);}-async function preview() { await act(async () => { fireEvent.click(screen.getByRole('button', { name: k('previewInvite') })); }); }+async function retry() { await act(async () => { fireEvent.click(screen.getByRole('button', { name: k('retryInvite') })); }); }beforeEach(() => {vi.clearAllMocks();setDataOwnerGeneration('owner-a');@@ -33,14 +33,15 @@ afterEach(async () => {cleanup();});-it('keeps an invitation until the authenticated host mounts and requires preview plus explicit acceptance', async () => {+it('keeps an invitation until the authenticated host mounts, previews it without a paste field and requires explicit acceptance', async () => {requestChatInvite(token);mount();- expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(link);- expect(api.previewInvite).not.toHaveBeenCalled();+ expect(screen.queryByRole('textbox')).toBeNull();+ expect(screen.getByRole('status').textContent).toBe(k('loadingInvite'));+ expect(screen.getByRole('button', { name: 'bots.close' }).hasAttribute('disabled')).toBe(false);+ await screen.findByText('Invited group');+ expect(api.previewInvite).toHaveBeenCalledExactlyOnceWith({ link });expect(api.acceptInvite).not.toHaveBeenCalled();- await preview(); await screen.findByText('Invited group');- expect(api.previewInvite).toHaveBeenCalledWith({ link });act(() => requestChatInvite(token));expect(screen.getAllByRole('dialog')).toHaveLength(1);expect(api.previewInvite).toHaveBeenCalledTimes(1);@@ -51,71 +52,132 @@ it('keeps an invitation until the authenticated host mounts and requires preview});it.each([- ['INVITATION_NOT_FOUND', 'invalidInvite'],- ['INVITATION_UNAVAILABLE', 'invalidInvite'],['FORBIDDEN', 'notAllowed'],['AUTH_REQUIRED', 'loginRequired'],['HOST_NOT_READY', 'requestFailed'],-])('retains the target after %s and allows retry once the service is ready', async (errorCode, message) => {+])('retains the target after %s and reloads it on request', async (errorCode, message) => {api.previewInvite.mockResolvedValueOnce({ ok: false, errorCode });- requestChatInvite(token); mount(); await preview();+ requestChatInvite(token); mount();expect((await screen.findByRole('alert')).textContent).toBe(k(message));- expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(link);+ expect(screen.queryByRole('button', { name: k('accept') })).toBeNull();+ await retry(); await screen.findByText('Invited group');+ expect(api.previewInvite).toHaveBeenLastCalledWith({ link });expect(api.acceptInvite).not.toHaveBeenCalled();- await preview(); await screen.findByText('Invited group');});-it('opens an already joined group without accepting again', async () => {+it.each(['INVITATION_NOT_FOUND', 'INVITATION_UNAVAILABLE', 'INVALID_INPUT'])('explains an unusable invitation (%s) without offering to accept or reload it', async errorCode => {+ api.previewInvite.mockResolvedValueOnce({ ok: false, errorCode });+ requestChatInvite(token); mount();+ expect((await screen.findByRole('alert')).textContent).toBe(k('invalidInvite'));+ expect(screen.queryByRole('button', { name: k('accept') })).toBeNull();+ expect(screen.queryByRole('button', { name: k('retryInvite') })).toBeNull();+ fireEvent.click(screen.getByRole('button', { name: 'bots.close' }));+ expect(screen.queryByRole('dialog')).toBeNull();+ expect(api.acceptInvite).not.toHaveBeenCalled();+});++it('opens an already joined group directly without accepting again', async () => {api.previewInvite.mockResolvedValue({ ok: true, groupId: 'room', name: 'Invited group', inviterName: 'Host', joined: true });- requestChatInvite(token); mount(); await preview(); await screen.findByText('Invited group');- fireEvent.click(screen.getByRole('button', { name: k('openGroup') }));- expect(screen.getByTestId('location').textContent).toBe('/bots/groups/room');+ requestChatInvite(token); mount();+ await waitFor(() => expect(screen.getByTestId('location').textContent).toBe('/bots/groups/room'));+ expect(screen.queryByRole('dialog')).toBeNull();+ expect(api.acceptInvite).not.toHaveBeenCalled();+});++it('reports a malformed clicked link once, without contacting the service', async () => {+ reportMalformedChatInvite(); reportMalformedChatInvite();+ mount();+ expect(screen.getAllByRole('dialog')).toHaveLength(1);+ expect(screen.getByRole('alert').textContent).toBe(k('malformedInvite'));+ expect(screen.queryByRole('textbox')).toBeNull();+ expect(screen.queryByRole('button', { name: k('retryInvite') })).toBeNull();+ expect(api.previewInvite).not.toHaveBeenCalled();+ fireEvent.click(screen.getByRole('button', { name: 'bots.close' }));+ expect(screen.queryByRole('dialog')).toBeNull();+});++it('lets the user dismiss an invitation while it is still loading', async () => {+ api.previewInvite.mockReturnValueOnce(new Promise(() => undefined));+ requestChatInvite(token); mount();+ await waitFor(() => expect(api.previewInvite).toHaveBeenCalledTimes(1));+ fireEvent.click(screen.getByRole('button', { name: 'bots.close' }));+ expect(screen.queryByRole('dialog')).toBeNull();+});++it('reads the invitation again when the same account moved to a newer data generation mid-request', async () => {+ let finish!: (result: unknown) => void;+ api.previewInvite.mockReturnValueOnce(new Promise(resolve => { finish = resolve; }));+ requestChatInvite(token); mount();+ await waitFor(() => expect(api.previewInvite).toHaveBeenCalledTimes(1));+ setDataOwnerGeneration('owner-a');+ await act(async () => finish({ ok: true, groupId: 'stale-room', name: 'Stale result', inviterName: 'Old', joined: false }));+ expect(screen.queryByText('Stale result')).toBeNull();+ await screen.findByText('Invited group');+ expect(api.previewInvite).toHaveBeenCalledTimes(2);+ expect(api.previewInvite).toHaveBeenLastCalledWith({ link });expect(api.acceptInvite).not.toHaveBeenCalled();});it('discards an old account preview while preserving its target through account selection', async () => {let finish!: (result: unknown) => void;api.previewInvite.mockReturnValueOnce(new Promise(resolve => { finish = resolve; }));- requestChatInvite(token); const view = mount(); await preview();- view.unmount(); setDataOwnerGeneration('owner-b'); mount();- await act(async () => finish({ ok: true, groupId: 'old-room', name: 'Private old result', joined: false }));+ requestChatInvite(token); const view = mount();+ await waitFor(() => expect(api.previewInvite).toHaveBeenCalledTimes(1));+ view.unmount(); setDataOwnerGeneration('owner-b');+ api.previewInvite.mockReturnValueOnce(new Promise(() => undefined));+ mount();+ await act(async () => finish({ ok: true, groupId: 'old-room', name: 'Private old result', inviterName: 'Old', joined: false }));expect(screen.queryByText('Private old result')).toBeNull();- expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(link);expect(screen.queryByRole('button', { name: k('accept') })).toBeNull();- await preview(); await screen.findByText('Invited group');+ // The new account previews the same target afresh.+ expect(api.previewInvite).toHaveBeenCalledTimes(2);+ expect(api.previewInvite).toHaveBeenLastCalledWith({ link });expect(api.acceptInvite).not.toHaveBeenCalled();});it('queues a second invite without replacing the current confirmation and reuses the id on retry', async () => {api.acceptInvite.mockResolvedValueOnce({ ok: false, errorCode: 'REQUEST_TIMEOUT' });- requestChatInvite(token); mount(); await preview(); await screen.findByText('Invited group');+ requestChatInvite(token); mount(); await screen.findByText('Invited group');act(() => requestChatInvite('b'.repeat(43)));+ expect(api.previewInvite).toHaveBeenCalledTimes(1);fireEvent.click(screen.getByRole('button', { name: k('accept') }));await screen.findByRole('alert');fireEvent.click(screen.getByRole('button', { name: k('accept') }));- await waitFor(() => expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(`cindy://chat-invite/${'b'.repeat(43)}`));+ await waitFor(() => expect(api.previewInvite).toHaveBeenLastCalledWith({ link: `cindy://chat-invite/${'b'.repeat(43)}` }));expect(api.acceptInvite.mock.calls[0][0].clientId).toBe(api.acceptInvite.mock.calls[1][0].clientId);});-it.each(['INVITATION_NOT_FOUND', 'FORBIDDEN'])('keeps the dialog when acceptance is rejected after preview: %s', async errorCode => {- api.acceptInvite.mockResolvedValue({ ok: false, errorCode });- requestChatInvite(token); mount(); await preview();+it('keeps the dialog without an accept button when the invitation became unusable after preview', async () => {+ api.acceptInvite.mockResolvedValue({ ok: false, errorCode: 'INVITATION_NOT_FOUND' });+ requestChatInvite(token); mount(); await screen.findByText('Invited group');fireEvent.click(screen.getByRole('button', { name: k('accept') }));- await screen.findByRole('alert');+ expect((await screen.findByRole('alert')).textContent).toBe(k('invalidInvite'));expect(screen.getByTestId('location').textContent).toBe('/');- expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(link);+ expect(screen.queryByRole('button', { name: k('accept') })).toBeNull();+ expect(screen.queryByRole('button', { name: k('retryInvite') })).toBeNull();+});++it('keeps the confirmation when acceptance is refused for this account', async () => {+ api.acceptInvite.mockResolvedValue({ ok: false, errorCode: 'FORBIDDEN' });+ requestChatInvite(token); mount(); await screen.findByText('Invited group');+ fireEvent.click(screen.getByRole('button', { name: k('accept') }));+ expect((await screen.findByRole('alert')).textContent).toBe(k('notAllowed'));+ expect(screen.getByTestId('location').textContent).toBe('/');+ expect(screen.getByText('Invited group')).toBeTruthy();+ expect(screen.getByRole('button', { name: k('accept') })).toBeTruthy();});it('ignores an old account acceptance result after logout and preserves a fresh confirmation for the new account', async () => {let finish!: (result: unknown) => void;api.acceptInvite.mockReturnValueOnce(new Promise(resolve => { finish = resolve; }));- requestChatInvite(token); const view = mount(); await preview();+ requestChatInvite(token); const view = mount(); await screen.findByText('Invited group');const accept = screen.getByRole('button', { name: k('accept') });fireEvent.click(accept); fireEvent.click(accept);expect(api.acceptInvite).toHaveBeenCalledTimes(1);+ expect(screen.getByRole('button', { name: 'bots.close' }).hasAttribute('disabled')).toBe(true);view.unmount(); setDataOwnerGeneration('owner-b'); mount();await act(async () => finish({ ok: true, groupId: 'old-room' }));expect(screen.getByTestId('location').textContent).toBe('/');- expect(screen.queryByRole('button', { name: k('accept') })).toBeNull();- expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(link);+ await screen.findByText('Invited group');+ expect(api.acceptInvite).toHaveBeenCalledTimes(1);});diff --git a/apps/desktop/src/renderer/features/bots/__tests__/ChatServerControls.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/ChatServerControls.test.tsxindex bc9ceb2032..dbee91d28f 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/ChatServerControls.test.tsx+++ b/apps/desktop/src/renderer/features/bots/__tests__/ChatServerControls.test.tsx@@ -3,7 +3,8 @@ import { StrictMode, type ReactNode } from 'react';import { act, cleanup, createEvent, fireEvent, render as renderUI, screen, waitFor, within } from '@testing-library/react';import { Tooltip } from '@/components/ui/tooltip';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';-import { ChatInviteButton, ChatJoinButton, ChatMessageActions } from '../ChatServerControls';+import { ChatInviteButton, ChatMessageActions } from '../ChatServerControls';+import { ChatInviteDialog } from '../ChatInviteDialog';import { ChatThreadPanel } from '../ChatThreadPanel';import type { BotGroupDetail, BotGroupMessageView } from '../../../../shared/botGroupChat';import { shareSelectionStore } from '@/components/chat/shareSelectionStore';@@ -212,10 +213,10 @@ describe('chat interaction controls', () => {expect(group.messages[0].reactions?.[0].me).toBe(true);});- it('shows invitation preview first; only explicit acceptance joins', async () => {+ it('shows a pasted invitation preview first; only explicit acceptance joins', async () => {const joined = vi.fn();- render(<StrictMode><ChatJoinButton onJoined={joined} /></StrictMode>);- fireEvent.click(await screen.findByRole('button', { name: k('join') }));+ render(<StrictMode><ChatInviteDialog onClose={vi.fn()} onJoined={joined} /></StrictMode>);+ expect(mocks.previewInvite).not.toHaveBeenCalled();fireEvent.change(screen.getByRole('textbox', { name: k('inviteLink') }), { target: { value: 'cindy://chat-invite/test' } });fireEvent.click(screen.getByRole('button', { name: k('previewInvite') }));await screen.findByText('Invited group');diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botGroupSidebar.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/botGroupSidebar.test.tsxindex c659828f08..5270703fb5 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/botGroupSidebar.test.tsx+++ b/apps/desktop/src/renderer/features/bots/__tests__/botGroupSidebar.test.tsx@@ -107,6 +107,11 @@ vi.mock('../BotGroupCreateDialog', () => ({vi.mock('../BotRosterView', () => ({BotRosterView: () => <div role="dialog">create-teammate-dialog</div>,}));+vi.mock('../ChatInviteDialog', () => ({+ ChatInviteDialog: ({ groupId, initialLink, onJoined }: { groupId?: string; initialLink?: string; onJoined?: (id: string) => void }) =>+ <div role="dialog"><span>{`join-dialog:${groupId ?? ''}:${initialLink ?? ''}`}</span>+ <button type="button" onClick={() => onJoined?.('joined-room')}>joined</button></div>,+}));vi.mock('../BotGenerationLabel', () => ({BotGenerationLabel: ({ sessionId }: { sessionId?: string }) => <span>{`generation:${sessionId}`}</span>,}));@@ -528,6 +533,22 @@ describe('BotsSidebar group chats', () => {expect(screen.getByRole('dialog').textContent).toBe('create-group-dialog');});+ it('keeps only the plus menu in the header and offers pasting an invitation as a separate fallback', async () => {+ await renderSidebar();+ expect(screen.queryByRole('button', { name: 'bots.groupChat.server.join' })).toBeNull();+ fireEvent.keyDown(screen.getByRole('button', { name: 'bots.list.createMenu' }), { key: 'Enter' });+ expect(screen.getAllByRole('menuitem').map(item => item.textContent)).toEqual([+ 'bots.list.createTeammate', 'bots.groupChat.create.title', 'bots.list.joinWithLink',+ ]);+ expect(screen.getAllByRole('separator')).toHaveLength(1);+ fireEvent.click(screen.getByRole('menuitem', { name: 'bots.list.joinWithLink' }));+ expect(screen.getByRole('dialog').textContent).toContain('join-dialog::');+ expect(screen.queryByText('create-group-dialog')).toBeNull();+ expect(screen.queryByText('create-teammate-dialog')).toBeNull();+ fireEvent.click(screen.getByRole('button', { name: 'joined' }));+ expect(mocks.navigate).toHaveBeenCalledWith('/bots/groups/joined-room');+ });+it('opens teammate creation from the same plus menu', async () => {await renderSidebar();fireEvent.keyDown(screen.getByRole('button', { name: 'bots.list.createMenu' }), { key: 'Enter' });diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botNavigation.test.ts b/apps/desktop/src/renderer/features/bots/__tests__/botNavigation.test.tsindex 3a38a47c51..1f2860af1f 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/botNavigation.test.ts+++ b/apps/desktop/src/renderer/features/bots/__tests__/botNavigation.test.ts@@ -166,7 +166,9 @@ describe('Bot task route recovery', () => {expect(source).toContain('window.electronAPI.localDb.bots.list(');expect(source).toContain('lastReadAtByBotId: { [botId]: lastReadAt }');expect(source).toContain('botMentions={gate.mentions}');- expect(source).toContain('botIdentity={identity ?? gate.identity}');+ expect(source).toContain('botIdentity={chatIdentity ?? gate.identity}');+ // The live identity is wrapped with canonicalChat so only the main private chat offers add-to-group.+ expect(source).toContain('{ ...(identity ?? gateIdentity), canonicalChat }');expect(source).toContain('botUnreadBoundaryAt={gate.unreadBoundaryAt}');});diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botSessionContentHeader.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/botSessionContentHeader.test.tsxindex 9bf200621c..9d253c3f8c 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/botSessionContentHeader.test.tsx+++ b/apps/desktop/src/renderer/features/bots/__tests__/botSessionContentHeader.test.tsx@@ -71,6 +71,17 @@ describe('BotSessionContentHeader', () => {expect(view.container.innerHTML).toBe(originalHeader);});+ it('offers add-to-group only in an active local teammate’s canonical private chat', () => {+ deviceData.local = [localCindy];+ const view = render(<BotSessionContentHeader bot={{ ...localCindy, canonicalChat: true }} />);+ expect(screen.getByRole('button', { name: 'bots.groupChat.addFromChat.triggerFor' })).toBeTruthy();+ // Channel routes and read-only history reuse this header without the canonical flag.+ view.rerender(<BotSessionContentHeader bot={localCindy} />);+ expect(screen.queryByRole('button', { name: 'bots.groupChat.addFromChat.triggerFor' })).toBeNull();+ view.rerender(<BotSessionContentHeader bot={{ ...localCindy, canonicalChat: true, deviceId: 'cloud', deviceName: 'Cloud' }} />);+ expect(screen.queryByRole('button', { name: 'bots.groupChat.addFromChat.triggerFor' })).toBeNull();+ });+it('keeps the device label and opens settings for a sole remote Cindy', () => {deviceData.remote = [remoteCindy];deviceData.pathname = '/bots/remote/cloud/cindy-default';diff --git a/apps/desktop/src/renderer/features/bots/__tests__/botSessionRead.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/botSessionRead.test.tsxindex d3512a5220..fec3f2de04 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/botSessionRead.test.tsx+++ b/apps/desktop/src/renderer/features/bots/__tests__/botSessionRead.test.tsx@@ -23,9 +23,9 @@ vi.mock('react-router-dom', () => ({useParams: () => mocks.params,}));vi.mock('@/features/cc-agent/CCAgentSessionView', () => ({- CCAgentSessionView: ({ botUnreadBoundaryAt, onBotReadThrough, readOnly }: { botUnreadBoundaryAt?: number | null; onBotReadThrough?: (at: number) => void; readOnly?: boolean }) => {+ CCAgentSessionView: ({ botUnreadBoundaryAt, onBotReadThrough, readOnly, botIdentity }: { botUnreadBoundaryAt?: number | null; onBotReadThrough?: (at: number) => void; readOnly?: boolean; botIdentity?: { canonicalChat?: boolean } }) => {mocks.read = onBotReadThrough;- return <div data-testid="chat" data-unread-boundary={botUnreadBoundaryAt ?? ''} data-readonly={readOnly ? 'yes' : 'no'} />;+ return <div data-testid="chat" data-unread-boundary={botUnreadBoundaryAt ?? ''} data-readonly={readOnly ? 'yes' : 'no'} data-canonical-chat={String(botIdentity?.canonicalChat)} />;},}));@@ -92,6 +92,8 @@ describe('Bot conversation read position', () => {it('waits for a rendered reply rather than marking a mounted chat read to wall-clock time', async () => {const view = render(<BotSessionView />);await waitFor(() => expect(view.getByTestId('chat')).toBeTruthy());+ // Private-chat actions (add to group) belong to the canonical chat only.+ expect(view.getByTestId('chat').dataset.canonicalChat).toBe('true');expect(getBotLastReadAt('bot-1')).toBeNull();act(() => mocks.read?.(3_000));expect(getBotLastReadAt('bot-1')).toBe(3_000);@@ -114,6 +116,7 @@ describe('Bot conversation read position', () => {installElectronApi({ ...readyBot, sessions: [{ id: 'session-1', kind: 'chat', role: 'history', status: 'active' }] });const view = render(<BotSessionView />);await waitFor(() => expect(view.getByTestId('chat')).toBeTruthy());+ expect(view.getByTestId('chat').dataset.canonicalChat).toBe('false');expect(mocks.read).toBeUndefined();expect(getBotLastReadAt('bot-1')).toBe(5_000);});@@ -135,6 +138,7 @@ describe('a demoted copy', () => {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');+ expect(view.getByTestId('chat').dataset.canonicalChat).toBe('false');});it('keeps an ordinary companion writable', async () => {@@ -142,5 +146,6 @@ describe('a demoted copy', () => {await waitFor(() => expect(view.getByTestId('chat')).toBeTruthy());expect(view.queryByTestId('shadow-banner')).toBeNull();expect(view.getByTestId('chat').getAttribute('data-readonly')).toBe('no');+ expect(view.getByTestId('chat').dataset.canonicalChat).toBe('true');});});diff --git a/apps/desktop/src/renderer/features/bots/__tests__/chatInviteBrowserHandoff.test.tsx b/apps/desktop/src/renderer/features/bots/__tests__/chatInviteBrowserHandoff.test.tsxindex 1586f5c41d..df42712213 100644--- a/apps/desktop/src/renderer/features/bots/__tests__/chatInviteBrowserHandoff.test.tsx+++ b/apps/desktop/src/renderer/features/bots/__tests__/chatInviteBrowserHandoff.test.tsx@@ -6,7 +6,7 @@ import { MemoryRouter } from 'react-router-dom';import { afterEach, expect, it, vi } from 'vitest';import type { BrowserWindow } from 'electron';import { drainPendingDeepLinks } from '@/lib/pendingDeepLinks';-import { ChatInviteHost, requestChatInvite } from '../ChatInviteHost';+import { ChatInviteHost, reportMalformedChatInvite, requestChatInvite } from '../ChatInviteHost';import { handleIncomingDeepLink, setDeepLinkMainWindow, takePendingDeepLink } from '../../../../main/deepLink';vi.mock('electron', () => ({ app: { focus: vi.fn() }, BrowserWindow: class {} }));@@ -51,9 +51,11 @@ it.each(['darwin', 'win32', 'linux'].flatMap(platform => [false, true].map(alrea() => false,);const acceptInvite = vi.fn();- Object.defineProperty(window, 'electronAPI', { configurable: true, value: { maker: { chatServer: { acceptInvite } } } });+ const previewInvite = vi.fn(() => new Promise(() => undefined));+ Object.defineProperty(window, 'electronAPI', { configurable: true, value: { maker: { chatServer: { acceptInvite, previewInvite } } } });const receive = (payload: { type: string; token?: string }) => {if (payload.type === 'chat-invite' && payload.token) requestChatInvite(payload.token);+ if (payload.type === 'chat-invite-malformed') reportMalformedChatInvite();};const pull = () => drainPendingDeepLinks(async () => takePendingDeepLink(), receive);const connect = () => bridge.onDeepLinkNavigate(() => void pull());@@ -86,7 +88,7 @@ it.each(['darwin', 'win32', 'linux'].flatMap(platform => [false, true].map(alrea}render(<MemoryRouter><ChatInviteHost /></MemoryRouter>);expect(screen.getAllByRole('dialog')).toHaveLength(1);- expect((screen.getByRole('textbox') as HTMLInputElement).value).toBe(anchor.href);+ expect(previewInvite).toHaveBeenCalledExactlyOnceWith({ link: anchor.href });expect(acceptInvite).not.toHaveBeenCalled();expect(takePendingDeepLink()).toBeNull();// Malformed events must not be forwarded by preload.@@ -94,3 +96,29 @@ it.each(['darwin', 'win32', 'linux'].flatMap(platform => [false, true].map(alreafireEvent.click(screen.getByRole('button', { name: 'bots.close' }));expect(screen.queryByRole('dialog')).toBeNull();});++it('turns a truncated clicked invitation into an explicit notice through preload and the pending queue', async () => {+ let listener: ((payload: unknown) => void) | undefined;+ const bridge = new Function('fanOutDeepLinkNavigate', 'isDeepLinkProviderConnectId', `${compiled}; return bridge;`)(+ (callback: (payload: unknown) => void) => { listener = callback; return () => { listener = undefined; }; },+ () => false,+ );+ const previewInvite = vi.fn();+ Object.defineProperty(window, 'electronAPI', { configurable: true, value: { maker: { chatServer: { previewInvite } } } });+ const pull = () => drainPendingDeepLinks(async () => takePendingDeepLink(), (payload: { type: string }) => {+ if (payload.type === 'chat-invite-malformed') reportMalformedChatInvite();+ });+ const win = { isDestroyed: () => false, isMinimized: () => false, isVisible: () => true,+ setAlwaysOnTop: vi.fn(), moveTop: vi.fn(), focus: vi.fn(),+ webContents: { isLoading: () => false, send: (_channel: string, payload: unknown) => listener?.(payload) },+ } as unknown as BrowserWindow;+ setDeepLinkMainWindow(win);+ bridge.onDeepLinkNavigate(() => void pull());+ await act(async () => { handleIncomingDeepLink(`cindy://chat-invite/${'truncated'.padEnd(30, 'a')}`, 'open-url'); });+ render(<MemoryRouter><ChatInviteHost /></MemoryRouter>);+ expect(screen.getByRole('alert').textContent).toBe('bots.groupChat.server.malformedInvite');+ expect(previewInvite).not.toHaveBeenCalled();+ expect(takePendingDeepLink()).toBeNull();+ fireEvent.click(screen.getByRole('button', { name: 'bots.close' }));+ expect(screen.queryByRole('dialog')).toBeNull();+});diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.jsonindex 1aa63e3594..a8d4bf9061 100644--- a/apps/desktop/src/renderer/i18n/locales/en/common.json+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json@@ -8756,6 +8756,7 @@"list": {"createMenu": "Create","createTeammate": "New teammate",+ "joinWithLink": "Enter Invite Link…","startChat": "Start the conversation","selectChat": "Select a teammate or group chat to start chatting","typing": "Typing…",@@ -9172,6 +9173,15 @@"files": {"openFailed": "Couldn’t open the file. It may have been moved or deleted."},+ "addFromChat": {+ "triggerFor": "Add {{name}} to a Group Chat",+ "addTo": "Add {{name}} to",+ "newGroup": "New Group Chat…",+ "existingGroup": "Add to Existing Group",+ "added": "Added {{name}} to “{{group}}”",+ "openGroup": "Open Group",+ "unavailable": "{{name}} can’t join a group chat right now"+ },"server": {"quoteReply": "Quote reply","startTopic": "Start a thread",@@ -9200,8 +9210,11 @@"copied": "Invitation link copied","createLink": "Create invitation link","accept": "Accept and join",- "openGroup": "Open group","previewInvite": "Preview invitation",+ "linkDescription": "Once you join, you become a member and can read the group’s chat history.",+ "loadingInvite": "Loading invitation…",+ "retryInvite": "Reload Invitation",+ "malformedInvite": "This invitation link is incomplete or malformed. Ask the person who invited you for a new link.","invalidInvite": "This invitation is invalid, used, expired or revoked. Request a new link.","notAllowed": "This account does not have permission. Check your account or contact the group owner.","loginRequired": "Sign in to your account and try again.",diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.jsonindex a5e42bfb1a..95a1a18756 100644--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json@@ -8719,6 +8719,7 @@"list": {"createMenu": "新規作成","createTeammate": "パートナーを作成",+ "joinWithLink": "招待リンクを入力…","startChat": "会話を始める","selectChat": "パートナーやグループチャットを選んで、会話を始めましょう","typing": "入力中…",@@ -9135,6 +9136,15 @@"files": {"openFailed": "ファイルを開けませんでした。移動または削除された可能性があります"},+ "addFromChat": {+ "triggerFor": "{{name}} をグループチャットに追加",+ "addTo": "{{name}} の追加先",+ "newGroup": "グループチャットを作成…",+ "existingGroup": "既存のグループに追加",+ "added": "{{name}} を「{{group}}」に追加しました",+ "openGroup": "グループを開く",+ "unavailable": "{{name}} は現在グループチャットに参加できません"+ },"server": {"quoteReply": "引用して返信","startTopic": "スレッドを作成",@@ -9163,8 +9173,11 @@"copied": "招待リンクをコピーしました","createLink": "招待リンクを作成","accept": "承諾して参加",- "openGroup": "グループを開く","previewInvite": "招待を確認",+ "linkDescription": "参加するとメンバーになり、チャット履歴を閲覧できます。",+ "loadingInvite": "招待を読み込んでいます…",+ "retryInvite": "招待を再読み込み",+ "malformedInvite": "招待リンクが不完全か、形式が正しくありません。招待した人に新しいリンクを依頼してください。","invalidInvite": "招待が無効、使用済み、期限切れ、または無効化されています。新しいリンクを取得してください。","notAllowed": "このアカウントに権限がありません。アカウントを確認するか、グループ管理者に連絡してください。","loginRequired": "ログインしてから再試行してください。",diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.jsonindex 4523238f17..b1dd02f6bf 100644--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json@@ -8719,6 +8719,7 @@"list": {"createMenu": "새로 만들기","createTeammate": "새 파트너",+ "joinWithLink": "초대 링크 입력…","startChat": "대화 시작하기","selectChat": "파트너 또는 그룹 채팅을 선택해 대화를 시작하세요","typing": "입력 중…",@@ -9135,6 +9136,15 @@"files": {"openFailed": "파일을 열지 못했습니다. 이동되었거나 삭제되었을 수 있습니다"},+ "addFromChat": {+ "triggerFor": "{{name}}을(를) 그룹 채팅에 추가",+ "addTo": "{{name}} 추가할 그룹",+ "newGroup": "그룹 채팅 만들기…",+ "existingGroup": "기존 그룹에 추가",+ "added": "{{name}}을(를) \"{{group}}\"에 추가했습니다",+ "openGroup": "그룹 열기",+ "unavailable": "{{name}}은(는) 지금 그룹 채팅에 참여할 수 없습니다"+ },"server": {"quoteReply": "인용 답글","startTopic": "스레드 만들기",@@ -9163,8 +9173,11 @@"copied": "초대 링크를 복사했습니다","createLink": "초대 링크 만들기","accept": "수락하고 참여",- "openGroup": "그룹 열기","previewInvite": "초대 확인",+ "linkDescription": "참여하면 그룹 구성원이 되어 대화 기록을 볼 수 있습니다.",+ "loadingInvite": "초대를 불러오는 중…",+ "retryInvite": "초대 다시 불러오기",+ "malformedInvite": "초대 링크가 불완전하거나 형식이 올바르지 않습니다. 초대한 사람에게 새 링크를 요청하세요.","invalidInvite": "유효하지 않거나 사용, 만료 또는 취소된 초대입니다. 새 링크를 받으세요.","notAllowed": "현재 계정에 권한이 없습니다. 계정을 확인하거나 그룹 소유자에게 문의하세요.","loginRequired": "현재 계정에 로그인한 후 다시 시도하세요.",diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.jsonindex 7938047253..60cc217afe 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json@@ -8719,6 +8719,7 @@"list": {"createMenu": "新建","createTeammate": "新建伙伴",+ "joinWithLink": "输入邀请链接…","startChat": "开始对话","selectChat": "选择伙伴或群聊,开始对话","typing": "正在输入…",@@ -9135,6 +9136,15 @@"files": {"openFailed": "文件没能打开,可能已被移动或删除"},+ "addFromChat": {+ "triggerFor": "将 {{name}} 添加到群聊",+ "addTo": "将 {{name}} 添加到",+ "newGroup": "发起群聊…",+ "existingGroup": "添加到已有群聊",+ "added": "已将 {{name}} 加入「{{group}}」",+ "openGroup": "打开群聊",+ "unavailable": "{{name}} 暂时无法加入群聊"+ },"server": {"quoteReply": "引用回复","startTopic": "创建话题",@@ -9163,8 +9173,11 @@"copied": "邀请链接已复制","createLink": "生成邀请链接","accept": "接受并加入",- "openGroup": "打开群聊","previewInvite": "查看邀请",+ "linkDescription": "确认后你会成为群成员,可阅读群聊记录。",+ "loadingInvite": "正在读取邀请…",+ "retryInvite": "重新读取邀请",+ "malformedInvite": "邀请链接不完整或格式不对,请向邀请人重新获取链接。","invalidInvite": "邀请无效、已使用、已过期或已撤销,请获取新的邀请链接。","notAllowed": "当前账号没有权限,请检查账号或联系群主。","loginRequired": "请先登录当前账号,再重试。",diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.jsonindex ef76f7d9f6..c4ad7c08bc 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json@@ -8719,6 +8719,7 @@"list": {"createMenu": "新增","createTeammate": "新增夥伴",+ "joinWithLink": "輸入邀請連結…","startChat": "開始對話","selectChat": "選擇夥伴或群聊,開始對話","typing": "正在輸入…",@@ -9135,6 +9136,15 @@"files": {"openFailed": "檔案沒能開啟,可能已被移動或刪除"},+ "addFromChat": {+ "triggerFor": "將 {{name}} 新增至群聊",+ "addTo": "將 {{name}} 新增至",+ "newGroup": "發起群聊…",+ "existingGroup": "新增至現有群聊",+ "added": "已將 {{name}} 加入「{{group}}」",+ "openGroup": "開啟群組",+ "unavailable": "{{name}} 暫時無法加入群聊"+ },"server": {"quoteReply": "引用回覆","startTopic": "建立話題",@@ -9163,8 +9173,11 @@"copied": "已複製邀請連結","createLink": "產生邀請連結","accept": "接受並加入",- "openGroup": "開啟群組","previewInvite": "查看邀請",+ "linkDescription": "確認後你會成為群組成員,可閱讀群聊記錄。",+ "loadingInvite": "正在讀取邀請…",+ "retryInvite": "重新讀取邀請",+ "malformedInvite": "邀請連結不完整或格式不正確,請向邀請人重新取得連結。","invalidInvite": "邀請無效、已使用、已過期或已撤銷,請取得新的邀請連結。","notAllowed": "目前帳號沒有權限,請檢查帳號或聯絡群主。","loginRequired": "請先登入目前帳號,再重試。",diff --git a/apps/desktop/src/renderer/lib/pendingDeepLinks.ts b/apps/desktop/src/renderer/lib/pendingDeepLinks.tsindex 4928f8e8d6..979082d528 100644--- a/apps/desktop/src/renderer/lib/pendingDeepLinks.ts+++ b/apps/desktop/src/renderer/lib/pendingDeepLinks.ts@@ -10,5 +10,5 @@ export async function drainPendingDeepLinks<T extends { type: string }>(do {payload = await take();if (payload) receive(payload);- } while (payload?.type === 'chat-invite');+ } while (payload?.type === 'chat-invite' || payload?.type === 'chat-invite-malformed');}diff --git a/apps/desktop/src/renderer/vite-env.d.ts b/apps/desktop/src/renderer/vite-env.d.tsindex a43ca20a6e..dfabcb7065 100644--- a/apps/desktop/src/renderer/vite-env.d.ts+++ b/apps/desktop/src/renderer/vite-env.d.ts@@ -2923,6 +2923,7 @@ interface ElectronAPI {| { type: 'provider-import'; importId: string }| { type: 'shared-task-join'; invitation: string; server: string }| { type: 'chat-invite'; token: string }+ | { type: 'chat-invite-malformed' }| { type: 'provider-share-join'; link: string }| { type: 'settings'; tab: 'voice-input' | 'providers' | 'billing'; connect?: string; intent?: 'topup' },) => void,@@ -2942,6 +2943,7 @@ interface ElectronAPI {| { type: 'provider-import'; importId: string }| { type: 'shared-task-join'; invitation: string; server: string }| { type: 'chat-invite'; token: string }+ | { type: 'chat-invite-malformed' }| { type: 'provider-share-join'; link: string }| { type: 'settings'; tab: 'voice-input' | 'providers' | 'billing'; connect?: string; intent?: 'topup' }| nulldiff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.mdindex ffc4f5fc39..ce6c526897 100644--- a/docs/design-rules/design-inventory.md+++ b/docs/design-rules/design-inventory.md@@ -18,7 +18,7 @@| `desktop.auth.add-account` | desktop | 添加账号 | hash `/add-account`(ProtectedRoute → AddAccountLoginPage) | AddAccountLoginPage | apps/desktop/src/renderer/components/login/AddAccountLoginPage.tsx, apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 || `desktop.auth.legacy-migration` | desktop | 首登数据迁移弹窗 | App 顶层挂载 LegacyMigrationDialog(仅主窗;main 检测到旧版 userData 经 `legacy-migration:state` 驱动) | LegacyMigrationDialog | apps/desktop/src/renderer/components/auth/LegacyMigrationDialog.tsx | 8 | 0 | 2 || `desktop.auth.login` | desktop | 登录页 | hash `/login`(GuestRoute → LoginPage) | LoginBrandStage, LoginCaptchaOverlay, LoginControls, LoginPage | apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 |-| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊 / 群聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊、伙伴群聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentOnOtherDeviceContext.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/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/botGroupComposerChrome.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/useBotGroupMentionPicker.tsx, 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 | 483 |+| `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/BotAddToGroupMenu.tsx, 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/botGroupComposerChrome.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/useBotGroupMentionPicker.tsx, 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 | 484 || `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 |diff --git a/docs/dev-rules/protocol-compatibility.md b/docs/dev-rules/protocol-compatibility.mdindex 2b2af9200a..abb2ec8039 100644--- a/docs/dev-rules/protocol-compatibility.md+++ b/docs/dev-rules/protocol-compatibility.md@@ -22,6 +22,20 @@ Gateway 边界对整块报价校验,非法或无有效币种即整体省略,模型快照投影,成功刷新缺字段会移除旧展示;没有新权限、数据库迁移或独立价格缓存。两端可独立升级,完整展示需两端支持。字段只用于报价展示,不参与账单或调用授权。+## 群聊邀请公开链接++device-link-server 的公开页 `<deviceLinkBase>/chat-invite/join#<token>[?app=cindy|cindycn|cindydev]`+与 Desktop 粘贴解析共用同一规则:口令为 43 位 base64url,只放在 fragment;URL 无 query、无用户信息;+fragment 只允许一个闭集 `app` 提示,不允许额外 `#` / `?` 段;协议为 https,仅本机回环地址允许 http。+页面在电脑上唤起既有 `cindy://chat-invite/<token>`,手机不唤起。客户端解析见+`packages/device-link/src/chatInvitation.ts`(`parseChatInvitationToken`),继续接受裸口令与+`cindy://chat-invite/<token>`;链接主机只校验形状,从不作为请求地址,也不据此切换 Chat Server+或登录区域,口令只以请求正文发给当前账号的 Chat Server。++发布顺序:先发布接受 https 粘贴的客户端,并保留「伙伴 → + → 输入邀请链接…」;sh-dev、sh-prod、+sgp-prod 都部署该页面后,才把 `createInvite` 生成的链接切换为 https。旧客户端点击 https 链接+经页面转到 `cindy://` 仍可用,但粘贴 https 链接需要新版客户端。Chat Server API 不变。+## 手机直连群的设置管理现有 `bot-group-chat` 数据可选追加 `supportsSettingsManagement`。仅服务器群的新版 Hostdiff --git a/docs/product-rules/bot-group-chat.md b/docs/product-rules/bot-group-chat.mdindex 789cb1ec2e..95108a9196 100644--- a/docs/product-rules/bot-group-chat.md+++ b/docs/product-rules/bot-group-chat.md@@ -22,7 +22,16 @@- **群是独立的对象**,不是某位伙伴的主任务,也不是普通任务。它与伙伴私聊在侧栏同一列表,保留显式置顶,其余按最新消息排序;群有新消息时向前排列,不另设「群聊」分组,也不进入左侧任务列表。- 顶部统一用一个加号提供「新建伙伴」和「新建群聊」,搜索同时覆盖伙伴与群聊。+ 顶部统一用一个加号提供「新建伙伴」和「新建群聊」两个创建入口,分隔线下另有「输入邀请链接…」作为手动加群的后备;+ 不再常驻单独的加群按钮。搜索同时覆盖伙伴与群聊。+- **私聊右上角可以把伙伴带进群**:本机可用伙伴的私聊头部有「添加到群聊」:「发起群聊…」打开新建群聊并预选该伙伴;+ 「添加到已有群聊」只列出你已加入、未归档、该伙伴尚未在内的服务端群,沿用群设置「邀请我的伙伴」的成员邀请,+ 权限以服务端为准(已加入成员可带入自己的伙伴),失败如实提示。子菜单先写明「将 某伙伴 添加到」,每行是目标群名;+ 添加进行中菜单不能再次打开,成功提示带「打开群聊」,切换账号后旧提示不再导航。原私聊保持不变,私聊记录不会带进群。+ 覆盖范围:Desktop 中本机且可用(未暂停、未关闭、未归档)伙伴的主私聊,包括本机 Cindy;+ 同一头部也用于渠道会话与只读历史任务,这两处不显示该入口;+ 其他电脑上的伙伴私聊(`/bots/remote/…`)不显示,因为建群与群设置的候选都只来自本机伙伴(`ownedBots` 只映射本机 Profile),+ 该伙伴的群执行由所在电脑负责。Desktop 目前没有人与人的单聊界面;Mobile 不在本次范围。- **群未读包括其他人和伙伴的消息**:自己的消息不新增未读。打开群且前台读到末尾才清除;停在旧记录处或窗口在后台时,保留新消息的提醒。- **消息操作复用统一组件**:复制、分享、引用回复、创建话题、表情回应与时间使用现有消息操作栏,@@ -472,13 +481,24 @@ Desktop 群聊只对 `TOKEN_EXPIRED`、`INVALID_TOKEN`、`AUTH_REQUIRED` 的 401### Desktop 群邀请深链续接群邀请沿用创建接口生成的 `cindy://chat-invite/<token>`,由主进程校验并暂存目标。-登录、账号选择与本地数据库就绪后,在主窗口复用邀请预览与确认弹窗;点击链接不自动加入。+登录、账号选择与本地数据库就绪后,在主窗口打开邀请弹窗并**自动读取邀请**(不显示粘贴框),+展示群名与邀请人;点击链接不自动加入,仍须点「接受并加入」。读取中可随时关闭;接受进行中不可关闭。重复打开同一待处理邀请只保留一份,不覆盖正在确认的另一邀请。账号切换仅保留邀请目标,-新账号重新预览,旧账号的异步结果不得导航或清除待处理邀请。失败保留链接供重试;-已加入时显示「打开群聊」,不重复调用接受接口。邀请只在本次应用运行的内存中保留,+新账号重新预览,旧账号的异步结果不得导航或清除待处理邀请。+同一账号数据代次在读取中更新时,作废旧结果并按当前代次重新读取,不停留在读取中。+读取结果:已是成员时直接打开该群并关闭弹窗,不调用接受接口;服务端判定无效、已用、过期或撤销时+说明原因,只留「关闭」;账号无权、未登录或服务暂不可用时说明原因并提供「重新读取邀请」。+口令残缺或被改动的链接(如聊天软件截断)不带任何链接内容地回报为「邀请链接不完整或格式不对」,+不访问服务端、不进入日志。邀请只在本次应用运行的内存中保留,不写路由、日志或持久存储,关闭弹窗或成功处理后清除。-本段只描述 Desktop 已有应用协议的消费,不声明存在 HTTPS 落地页或 Mobile 加群入口。-实现见 `main/deepLink.ts`、`renderer/features/bots/ChatInviteHost.tsx`;离线浏览器转交回归见+侧栏不常驻加群按钮;链接在发送方应用里不可点击时,从伙伴列表加号菜单的「输入邀请链接…」粘贴,+预览与确认规则相同。该后备在 HTTPS 邀请落地页上线后再评估是否保留。+「输入邀请链接…」也接受公开页链接 `https://…/chat-invite/join#<token>`,只取口令,交给当前账号的 Chat Server;+规则与页面一致,见 [跨端协议兼容 · 群聊邀请公开链接](../dev-rules/protocol-compatibility.md)。+「复制邀请链接」仍生成 `cindy://chat-invite/<token>`,三个环境部署公开页后再切换。+本段不声明公开页已部署,也不新增 Mobile 加群入口。+实现见 `main/deepLink.ts`、`renderer/features/bots/ChatInviteHost.tsx`、`ChatInviteDialog.tsx`;+回归见 `ChatInviteHost.test.tsx`、`deepLink.test.ts`,离线浏览器转交(含残缺链接)见`chatInviteBrowserHandoff.test.tsx`,原生系统唤起仍需相应平台验收。### Desktop 群邀请链接的有效期与撤销diff --git a/packages/device-link/src/__tests__/chatInvitation.test.ts b/packages/device-link/src/__tests__/chatInvitation.test.tsnew file mode 100644index 0000000000..11453066f1--- /dev/null+++ b/packages/device-link/src/__tests__/chatInvitation.test.ts@@ -0,0 +1,66 @@+import { describe, expect, it } from 'vitest';+import { CHAT_INVITATION_PATH, parseChatInvitationToken } from '../chatInvitation.js';++const token = 'Ab0_-'.repeat(8) + 'xyz';+const page = `https://relay.example.test${CHAT_INVITATION_PATH}#${token}`;++describe('chat invitation links', () => {+ it('keeps accepting bare tokens and the existing custom-scheme link', () => {+ expect(token).toHaveLength(43);+ expect(parseChatInvitationToken(token)).toBe(token);+ expect(parseChatInvitationToken(` cindy://chat-invite/${token}\n`)).toBe(token);+ });++ it('reads the token from the public page link, with or without a build hint, and from shared text', () => {+ for (const input of [+ page,+ `${page}?app=cindy`, `${page}?app=cindycn`, `${page}?app=cindydev`,+ `https://relay.example.test/prefix${CHAT_INVITATION_PATH}#${token}`,+ `http://localhost:3000${CHAT_INVITATION_PATH}#${token}`,+ `http://127.0.0.1:3000${CHAT_INVITATION_PATH}#${token}`,+ `http://[::1]:3000${CHAT_INVITATION_PATH}#${token}`,+ `http://[::1]${CHAT_INVITATION_PATH}#${token}?app=cindydev`,+ `本机预览:http://[::1]:3000${CHAT_INVITATION_PATH}#${token}。`,+ `Local preview: http://[::1]:3000${CHAT_INVITATION_PATH}#${token}.`,+ `[本机](http://[::1]:3000${CHAT_INVITATION_PATH}#${token})`,+ `邀请你加入群聊:${page}`, `Join us: ${page}.`, `「${page}」`, `[群聊](${page})`,+ ]) expect(parseChatInvitationToken(input)).toBe(token);+ // The secret lives only in the fragment, never in the HTTP request.+ const url = new URL(page);+ expect(url.pathname + url.search).not.toContain(token);+ });++ it.each([+ ['a query string', `https://relay.example.test${CHAT_INVITATION_PATH}?token=${token}#${token}`],+ ['the token in the query', `https://relay.example.test${CHAT_INVITATION_PATH}?${token}`],+ ['the token in the path', `https://relay.example.test${CHAT_INVITATION_PATH}/${token}`],+ ['user info', `https://user:[email protected]${CHAT_INVITATION_PATH}#${token}`],+ ['plain http to a public host', `http://relay.example.test${CHAT_INVITATION_PATH}#${token}`],+ ['plain http to a public IPv6 host', `http://[2001:db8::1]${CHAT_INVITATION_PATH}#${token}`],+ ['two loopback IPv6 invitation links', `http://[::1]:3000${CHAT_INVITATION_PATH}#${token} https://[::1]${CHAT_INVITATION_PATH}#${token}`],+ ['IPv6 user info', `https://user@[::1]${CHAT_INVITATION_PATH}#${token}`],+ ['an IPv6 link with a query', `http://[::1]:3000${CHAT_INVITATION_PATH}?t=1#${token}`],+ ['an unknown app hint', `${page}?app=other`],+ ['a redirect hint', `${page}?redirect=https://evil.example.test`],+ ['two fragment parameters', `${page}?app=cindy?app=cindycn`],+ ['an extra fragment segment', `${page}#again`],+ ['a short token', page.slice(0, -1)],+ ['a long token', `${page}a`],+ ['a non-base64url token', page.slice(0, -1) + '='],+ ['a different page', `https://relay.example.test/shared-task/join#${token}`],+ ['another custom scheme', `cindycn://chat-invite/${token}`],+ ['a legacy custom scheme', `xdt-maker://chat-invite/${token}`],+ ['javascript', `javascript:alert(1)//${CHAT_INVITATION_PATH}#${token}`],+ ['an uppercase scheme', page.replace('https', 'HTTPS')],+ ['two invitation links', `${page} ${page.replace('relay', 'other')}`],+ ['a truncated custom link', `cindy://chat-invite/${token.slice(0, 20)}`],+ ['empty text', ' '],+ ])('rejects %s', (_label, input) => {+ expect(parseChatInvitationToken(input)).toBeNull();+ });++ it('rejects non-string and oversized input', () => {+ expect(parseChatInvitationToken(undefined as unknown as string)).toBeNull();+ expect(parseChatInvitationToken(`${page} ${'x'.repeat(8192)}`)).toBeNull();+ });+});diff --git a/packages/device-link/src/chatInvitation.ts b/packages/device-link/src/chatInvitation.tsnew file mode 100644index 0000000000..22fb37c0d6--- /dev/null+++ b/packages/device-link/src/chatInvitation.ts@@ -0,0 +1,44 @@+/**+ * Chat Server group invitations. The public page keeps the token in the fragment —+ * `<deviceLinkBase>/chat-invite/join#<token>[?app=cindy|cindycn|cindydev]` — and desktop+ * opens `cindy://chat-invite/<token>`. Only the token is used: the client always asks its+ * own Chat Server, so a link's host is checked for shape and never becomes a request target+ * or a reason to switch servers or regions. Rules match the page's own validation.+ */+export const CHAT_INVITATION_PATH = '/chat-invite/join';+const TOKEN = /^[A-Za-z0-9_-]{43}$/;+const CUSTOM_SCHEME_PREFIX = 'cindy://chat-invite/';+const LOOPBACK = new Set(['localhost', '127.0.0.1', '[::1]']);++/**+ * Accept a bare token, the existing `cindy://chat-invite/<token>` link, or one public page+ * link in shared text. Anything else (query, user info, extra fragment segments, unknown+ * app hint, other schemes, several invitation links) is null.+ */+export function parseChatInvitationToken(input: string): string | null {+ if (typeof input !== 'string' || input.length > 8192) return null;+ const text = input.trim();+ if (TOKEN.test(text)) return text;+ if (text.startsWith(CUSTOM_SCHEME_PREFIX)) {+ const token = text.slice(CUSTOM_SCHEME_PREFIX.length);+ return TOKEN.test(token) ? token : null;+ }+ // Trailing sentence punctuation is not part of a link; it can never complete a token.+ // Brackets end a link (Markdown `[text](url)`) except around an IPv6 host such as `[::1]`.+ const links = text.match(/https?:\/\/(?:\[[0-9A-Fa-f:.]+\])?[^\s<>"',。!?、()「」“”‘’[\])]+/g)+ ?.map((link) => link.replace(/[.,;!]+$/, ''))+ .filter((link) => {+ try { return new URL(link).pathname.endsWith(CHAT_INVITATION_PATH); } catch { return false; }+ });+ if (links?.length !== 1) return null;+ try {+ const url = new URL(links[0]);+ if (url.username || url.password || url.search) return null;+ if (url.protocol !== 'https:' && !(url.protocol === 'http:' && LOOPBACK.has(url.hostname))) return null;+ const [token, hint, extra] = url.hash.slice(1).split('?');+ if (extra !== undefined || (hint !== undefined && !/^app=(cindy|cindycn|cindydev)$/.test(hint))) return null;+ return TOKEN.test(token) ? token : null;+ } catch {+ return null;+ }+}diff --git a/packages/device-link/src/index.ts b/packages/device-link/src/index.tsindex d16bb621fc..888464433d 100644--- a/packages/device-link/src/index.ts+++ b/packages/device-link/src/index.ts@@ -42,6 +42,7 @@ export * from "./sharedTaskInvitation.js";export * from "./sharedTaskProbe.js";export * from "./providerShareApi.js";export * from "./providerShareInvitation.js";+export * from "./chatInvitation.js";export * from "./providerShareCatalog.js";export * from "./providerShareEnvelope.js";export * from "./providerGroup.js";diff --git a/packages/maker-shared/src/botGroupChat.ts b/packages/maker-shared/src/botGroupChat.tsindex a92c6f6b4f..328bbc27f5 100644--- a/packages/maker-shared/src/botGroupChat.ts+++ b/packages/maker-shared/src/botGroupChat.ts@@ -554,7 +554,8 @@ export type ChatGroupAction =| { type: 'archive'; archived: boolean; expectedRevision: number };export interface ChatServerApi {manage(input: { groupId: string; action: ChatGroupAction }): Promise<ChatServerResult<Record<never, never>>>;- ownedBots(): Promise<ChatServerResult<{ bots: Array<{ actorId: string; name: string }> }>>;+ /** `botId` is the local teammate id behind each Chat Server actor. */+ ownedBots(): Promise<ChatServerResult<{ bots: Array<{ actorId: string; botId?: string; name: string }> }>>;refreshProfile(): Promise<ChatServerResult<Record<never, never>>>;status(): Promise<{ enabled: boolean; connected: boolean }>;thread(input: { groupId: string; rootId: string; before?: number; sourceMessageIds?: string[] }): Promise<ChatServerResult<{