@allbluecn/web-app 0.23.2 → 0.23.4

package/src/components/desktop/sync-indicator.tsx

@@ -5,8 +5,13 @@
 // 桌面同步状态指示器（迁移设计 §3.7 最小 UI）：顶栏小圆点 + 同步状态。
 // 仅 DEPLOY_TARGET=desktop 渲染；云端部署零成本（组件返回 null）。
 // 数据源：desktopBridge.onSyncState（backend parentPort 上报的引擎状态机）。
+// A11 三态徽标：desktopBridge.desktopState 查询 + onDesktopState 订阅（main 侧
+// desktop-state 状态机），展示数据属主三态（guest/transferring/cloud）——位置
+// 跟随既有指示器（本组件扩展，不新造摆放位置），位于同步相位行上方。
 import { useEffect, useState } from "react"
 import { getDesktopBridge } from "@/lib/desktop-bridge-types"
+import type { DesktopStateKind } from "@/lib/desktop-bridge-types"
+import { m } from "@/paraglide/messages.js"
 
 interface SyncState {
   phase: "idle" | "pushing" | "pulling"
@@ -21,8 +26,30 @@ const LABELS: Record<SyncState["phase"], string> = {
   pulling: "拉取中",
 }
 
+// 三态徽标形态（跟随既有 LOCAL 徽标 = 圆点 + 文案）：guest 灰（本地属主）、
+// transferring 琥珀脉冲（转移进行中）、cloud 绿（云属主，与「已同步」同色系）
+const STATE_DOT: Record<DesktopStateKind, string> = {
+  guest: "bg-muted-foreground",
+  transferring: "bg-amber-500 animate-pulse",
+  cloud: "bg-emerald-500",
+}
+
+// 文案在渲染时解析（paraglide 按请求/cookie locale——模块顶层调用会把 locale
+// 固化在 import 时刻，语言切换后不更新）；非导出模块函数保 Fast Refresh 纯组件边界
+function stateLabelOf(kind: DesktopStateKind): string {
+  switch (kind) {
+    case "guest":
+      return m.desktop_state_guest()
+    case "transferring":
+      return m.desktop_state_transferring()
+    case "cloud":
+      return m.desktop_state_cloud()
+  }
+}
+
 export function DesktopSyncIndicator() {
   const [state, setState] = useState<SyncState | null>(null)
+  const [deskState, setDeskState] = useState<DesktopStateKind | null>(null)
   const [mounted, setMounted] = useState(false)
 
   useEffect(() => {
@@ -30,31 +57,53 @@ export function DesktopSyncIndicator() {
     const bridge = getDesktopBridge()
     if (!bridge) return
     const off = bridge.onSyncState((s) => setState(s as SyncState))
-    return off
+    // A11 三态：查询补当前态（页面 reload 后推送事件已错过）+ 订阅变更推送
+    void bridge.desktopState
+      ?.()
+      .then((p) => setDeskState(p.kind))
+      .catch(() => null)
+    const offState = bridge.onDesktopState?.((p) => setDeskState(p.kind))
+    return () => {
+      off()
+      offState?.()
+    }
   }, [])
 
   if (!mounted || !getDesktopBridge()) return null
-  if (!state) return null
+  if (!state && !deskState) return null
 
-  const hasError = state.lastError !== null
-  const busy = state.phase === "pushing" || state.phase === "pulling"
+  const hasError = state?.lastError !== null && state?.lastError !== undefined
+  const busy = state?.phase === "pushing" || state?.phase === "pulling"
   const dotColor = hasError ? "bg-destructive" : busy ? "bg-amber-500 animate-pulse" : "bg-emerald-500"
   const label = hasError
     ? "同步失败"
     : busy
-      ? LABELS[state.phase]
-      : state.pending > 0
+      ? LABELS[state!.phase]
+      : state && state.pending > 0
         ? `待同步 ${state.pending}`
         : LABELS.idle
 
   return (
-    <div
-      className="flex items-center gap-1.5 px-2 py-1 text-xs text-muted-foreground"
-      title={hasError ? `同步失败：${state.lastError}` : `上次同步 ${state.lastSyncedAt ?? "—"}`}
-      data-testid="desktop-sync-indicator"
-    >
-      <span className={`inline-block size-2 rounded-full ${dotColor}`} aria-hidden />
-      <span>{label}</span>
+    <div className="space-y-0.5" data-testid="desktop-sync-indicator">
+      {deskState && (
+        <div
+          className="flex items-center gap-1.5 px-2 py-1 text-xs text-muted-foreground"
+          data-testid="desktop-state-badge"
+          data-desktop-state={deskState}
+        >
+          <span className={`inline-block size-2 rounded-full ${STATE_DOT[deskState]}`} aria-hidden />
+          <span>{stateLabelOf(deskState)}</span>
+        </div>
+      )}
+      {state && (
+        <div
+          className="flex items-center gap-1.5 px-2 py-1 text-xs text-muted-foreground"
+          title={hasError ? `同步失败：${state.lastError}` : `上次同步 ${state.lastSyncedAt ?? "—"}`}
+        >
+          <span className={`inline-block size-2 rounded-full ${dotColor}`} aria-hidden />
+          <span>{label}</span>
+        </div>
+      )}
     </div>
   )
 }

package/src/components/desktop-agent/__tests__/agent-chat.test.tsx

@@ -0,0 +1,194 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+
+// 本地文件助手 · 对话区（桌面本地优先 P3-B5）：useChat 接线（懒取端点的 connection
+// 包装 + 稳定 threadId + forwardedProps.cwd）、消息渲染（空 assistant 消息跳过、
+// 工具调用折叠卡按 toolCallId 关联结果）、输入（Enter 发送 / Shift+Enter /
+// 输入法组合）、中止（按钮 + agent-abort 热键仅运行中生效）、错误文案映射。
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { act, cleanup, fireEvent, render, screen } from '@testing-library/react'
+import { HotkeysProvider } from '@tanstack/react-hotkeys'
+import type { UIMessage } from '@tanstack/ai-client'
+import { TooltipProvider } from '@/components/ui/tooltip'
+import { appHotkeys } from '@/lib/hotkeys/registry'
+import { m } from '@/paraglide/messages.js'
+
+const chat = vi.hoisted(() => ({
+  messages: [] as unknown[],
+  isLoading: false,
+  error: undefined as Error | undefined,
+  sendMessage: vi.fn(async (_text: string) => {}),
+  stop: vi.fn(),
+  options: [] as Array<Record<string, unknown>>,
+}))
+
+vi.mock('@tanstack/ai-react', () => ({
+  useChat: (options: Record<string, unknown>) => {
+    chat.options.push(options)
+    return {
+      messages: chat.messages,
+      isLoading: chat.isLoading,
+      error: chat.error,
+      sendMessage: chat.sendMessage,
+      stop: chat.stop,
+    }
+  },
+}))
+// markdown 渲染器替身（react-markdown/shiki 与本组件行为无关，保测试轻量）
+vi.mock('@/components/harness/ai-message/components/markdown-content', () => ({
+  MarkdownContent: ({ content }: { content: string }) => <div data-testid="markdown">{content}</div>,
+}))
+
+import { AgentChat } from '../agent-chat'
+
+const piResult = (text: string) => ({ content: [{ type: 'text', text }], details: undefined })
+
+function renderChat(props: { cwd?: string | null; onRunningChange?: (running: boolean) => void } = {}) {
+  const ui = (cwd: string | null) => (
+    <HotkeysProvider appHotkeys={appHotkeys}>
+      <TooltipProvider>
+        <AgentChat cwd={cwd} onRunningChange={props.onRunningChange} />
+      </TooltipProvider>
+    </HotkeysProvider>
+  )
+  const cwd = props.cwd === undefined ? '/Users/x/proj' : props.cwd
+  const utils = render(ui(cwd))
+  return { ...utils, rerenderWith: (next: string | null) => utils.rerender(ui(next)) }
+}
+
+beforeEach(() => {
+  chat.messages = []
+  chat.isLoading = false
+  chat.error = undefined
+  chat.options = []
+  chat.sendMessage.mockClear()
+  chat.stop.mockClear()
+})
+
+afterEach(() => cleanup())
+
+describe('AgentChat · useChat 接线', () => {
+  it('connection 为懒取端点的包装（含 connect）、threadId 跨渲染稳定、forwardedProps 携带 cwd', () => {
+    const { rerenderWith } = renderChat({ cwd: '/Users/x/proj' })
+    const first = chat.options[0]!
+    expect(typeof (first.connection as { connect?: unknown }).connect).toBe('function')
+    expect(typeof first.threadId).toBe('string')
+    expect(first.forwardedProps).toEqual({ cwd: '/Users/x/proj' })
+    rerenderWith('/Users/x/proj')
+    const last = chat.options.at(-1)!
+    expect(last.threadId).toBe(first.threadId)
+    expect(last.connection).toBe(first.connection)
+  })
+})
+
+describe('AgentChat · 消息渲染', () => {
+  it('user 气泡 + assistant 正文；pi 回显产生的空 assistant 消息被跳过', () => {
+    chat.messages = [
+      { id: 'u1', role: 'user', parts: [{ type: 'text', content: '列出目录' }] },
+      { id: 'msg-1', role: 'assistant', parts: [] },
+      { id: 'msg-2', role: 'assistant', parts: [{ type: 'text', content: '   ' }] },
+      { id: 'msg-3', role: 'assistant', parts: [{ type: 'text', content: '目录里有 a.txt' }] },
+    ] satisfies UIMessage[]
+    renderChat()
+    expect(screen.getByText('列出目录')).toBeInTheDocument()
+    expect(screen.getByText('目录里有 a.txt')).toBeInTheDocument()
+    const rendered = screen.getAllByTestId('agent-message').map((el) => el.getAttribute('data-role'))
+    expect(rendered).toEqual(['user', 'assistant'])
+  })
+
+  it('工具调用：tool-call 渲染折叠卡，同 toolCallId 的 tool-result 不单独渲染', () => {
+    chat.messages = [
+      { id: 'u1', role: 'user', parts: [{ type: 'text', content: '总结项目' }] },
+      {
+        id: 'msg-2',
+        role: 'assistant',
+        parts: [
+          { type: 'tool-call', id: 'call_ls_1', name: 'ls', arguments: '{"path":"."}', state: 'complete', output: piResult('README.md\nsrc/') },
+          { type: 'tool-result', toolCallId: 'call_ls_1', content: JSON.stringify(piResult('README.md\nsrc/')), state: 'complete' },
+        ],
+      },
+    ] satisfies UIMessage[]
+    renderChat()
+    expect(screen.getAllByTestId('agent-tool-card-trigger')).toHaveLength(1)
+    expect(screen.getByText(m.agent_desktop_toolLs({ target: '.' }))).toBeInTheDocument()
+    expect(screen.getByText(m.agent_desktop_toolCountFiles({ count: 2 }))).toBeInTheDocument()
+  })
+
+  it('空对话：引导空态', () => {
+    renderChat()
+    expect(screen.getByText(m.agent_desktop_chatEmptyTitle())).toBeInTheDocument()
+  })
+})
+
+describe('AgentChat · 输入与发送', () => {
+  it('Enter 发送（trim）并清空输入；Shift+Enter 与输入法组合中的 Enter 不发送', () => {
+    renderChat()
+    const textarea = screen.getByRole('textbox')
+    fireEvent.change(textarea, { target: { value: '  总结这个项目  ' } })
+    fireEvent.keyDown(textarea, { key: 'Enter', shiftKey: true })
+    fireEvent.keyDown(textarea, { key: 'Enter', isComposing: true })
+    expect(chat.sendMessage).not.toHaveBeenCalled()
+    fireEvent.keyDown(textarea, { key: 'Enter' })
+    expect(chat.sendMessage).toHaveBeenCalledWith('总结这个项目')
+    expect(textarea).toHaveValue('')
+  })
+
+  it('发送按钮：空输入禁用，有内容可点', () => {
+    renderChat()
+    const send = screen.getByRole('button', { name: m.agent_desktop_chatSend() })
+    expect(send).toBeDisabled()
+    fireEvent.change(screen.getByRole('textbox'), { target: { value: '找出所有 TODO' } })
+    fireEvent.click(screen.getByRole('button', { name: m.agent_desktop_chatSend() }))
+    expect(chat.sendMessage).toHaveBeenCalledWith('找出所有 TODO')
+  })
+
+  it('无授权目录（cwd=null）：输入禁用 + 引导先选目录', () => {
+    renderChat({ cwd: null })
+    expect(screen.getByRole('textbox')).toBeDisabled()
+    expect(screen.getByTestId('agent-chat-cwd')).toHaveTextContent(m.agent_desktop_chatNoWorkspace())
+  })
+})
+
+describe('AgentChat · 中止（按钮 + agent-abort 热键）', () => {
+  it('运行中：显示中止按钮（替代发送）并调用 stop；思考指示可见', () => {
+    chat.isLoading = true
+    renderChat()
+    expect(screen.queryByRole('button', { name: m.agent_desktop_chatSend() })).toBeNull()
+    fireEvent.click(screen.getByRole('button', { name: m.agent_desktop_chatStop() }))
+    expect(chat.stop).toHaveBeenCalledTimes(1)
+    expect(screen.getByTestId('agent-chat-thinking')).toBeInTheDocument()
+  })
+
+  it('运行中按 Mod+. → stop（声明即绑定：appHotkeys["agent-abort"]）', () => {
+    chat.isLoading = true
+    renderChat()
+    act(() => {
+      fireEvent.keyDown(document.body, { key: '.', code: 'Period', ctrlKey: true })
+    })
+    expect(chat.stop).toHaveBeenCalledTimes(1)
+  })
+
+  it('未运行时 Mod+. 不触发 stop（enabled 门控）', () => {
+    renderChat()
+    act(() => {
+      fireEvent.keyDown(document.body, { key: '.', code: 'Period', ctrlKey: true })
+    })
+    expect(chat.stop).not.toHaveBeenCalled()
+  })
+
+  it('运行态变化通知父级（锁定目录切换用）', () => {
+    const onRunningChange = vi.fn()
+    chat.isLoading = true
+    renderChat({ onRunningChange })
+    expect(onRunningChange).toHaveBeenLastCalledWith(true)
+  })
+})
+
+describe('AgentChat · 错误文案', () => {
+  it('401 令牌失效 → 可读提示（role=alert）', () => {
+    chat.error = Object.assign(new Error('HTTP error! status: 401'), { name: 'StreamHttpError', status: 401 })
+    renderChat()
+    expect(screen.getByRole('alert')).toHaveTextContent(m.agent_desktop_errorUnauthorized())
+  })
+})

package/src/components/desktop-agent/__tests__/agent-tool-card.test.tsx

@@ -0,0 +1,138 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+
+// 本地文件助手 · 工具调用折叠卡（桌面本地优先 P3-B5）：默认折叠，头部展示
+// 「工具 + 目标 + 计数」；展开渲染文件名（ls/find）、命中行（grep）、文件内容
+// （read）；运行中 / 错误 / 空结果 / 截断各态。part 形态取自 TanStack processor
+// 处理 B3 mapper 事件后的真实结果（tool-call part.output = pi AgentToolResult）。
+import { afterEach, describe, expect, it } from 'vitest'
+import type { ComponentProps } from 'react'
+import { cleanup, fireEvent, render, screen } from '@testing-library/react'
+import { m } from '@/paraglide/messages.js'
+import { AgentToolCard } from '../agent-tool-card'
+
+type Part = ComponentProps<typeof AgentToolCard>['part']
+type Result = NonNullable<ComponentProps<typeof AgentToolCard>['result']>
+
+const piResult = (text: string) => ({ content: [{ type: 'text', text }], details: undefined })
+
+function toolCall(name: string, args: Record<string, unknown>, extra: Partial<Part> = {}): Part {
+  return {
+    type: 'tool-call',
+    id: `call-${name}`,
+    name,
+    arguments: JSON.stringify(args),
+    state: 'input-streaming',
+    ...extra,
+  } as Part
+}
+
+const trigger = () => screen.getByTestId('agent-tool-card-trigger')
+
+afterEach(() => cleanup())
+
+describe('AgentToolCard', () => {
+  it('grep 默认折叠：头部「搜索 模式」+ 命中计数，命中行不渲染', () => {
+    render(
+      <AgentToolCard
+        part={toolCall('grep', { pattern: 'TODO' }, {
+          state: 'complete',
+          output: piResult('src/a.ts:12: const TODO = 1\ndocs/b.md:3: TODO: write docs'),
+        })}
+      />,
+    )
+    expect(screen.getByText(m.agent_desktop_toolGrep({ target: 'TODO' }))).toBeInTheDocument()
+    expect(screen.getByText(m.agent_desktop_toolCountHits({ count: 2 }))).toBeInTheDocument()
+    expect(trigger()).toHaveAttribute('aria-expanded', 'false')
+    expect(screen.queryByText('const TODO = 1')).toBeNull()
+  })
+
+  it('grep 展开：命中行渲染「文件:行号」+ 行内容', () => {
+    render(
+      <AgentToolCard
+        part={toolCall('grep', { pattern: 'TODO' }, {
+          state: 'complete',
+          output: piResult('src/a.ts:12: const TODO = 1\ndocs/b.md:3: TODO: write docs'),
+        })}
+      />,
+    )
+    fireEvent.click(trigger())
+    expect(trigger()).toHaveAttribute('aria-expanded', 'true')
+    expect(screen.getByText('src/a.ts:12')).toBeInTheDocument()
+    expect(screen.getByText('const TODO = 1')).toBeInTheDocument()
+    expect(screen.getByText('docs/b.md:3')).toBeInTheDocument()
+  })
+
+  it('ls 展开：文件名列表（目录保留 / 后缀），target 缺省为 .', () => {
+    render(<AgentToolCard part={toolCall('ls', {}, { state: 'complete', output: piResult('README.md\nsrc/') })} />)
+    expect(screen.getByText(m.agent_desktop_toolLs({ target: '.' }))).toBeInTheDocument()
+    expect(screen.getByText(m.agent_desktop_toolCountFiles({ count: 2 }))).toBeInTheDocument()
+    fireEvent.click(trigger())
+    expect(screen.getByText('README.md')).toBeInTheDocument()
+    expect(screen.getByText('src/')).toBeInTheDocument()
+  })
+
+  it('read：tool-call part 无 output 时回落 tool-result part 内容（JSON 串）', () => {
+    render(
+      <AgentToolCard
+        part={toolCall('read', { path: 'notes.md' }, { state: 'input-complete' })}
+        result={{
+          type: 'tool-result',
+          toolCallId: 'call-read',
+          content: JSON.stringify(piResult('# Notes\nhello')),
+          state: 'complete',
+        } as Result}
+      />,
+    )
+    expect(screen.getByText(m.agent_desktop_toolRead({ target: 'notes.md' }))).toBeInTheDocument()
+    expect(screen.getByText(m.agent_desktop_toolCountLines({ count: 2 }))).toBeInTheDocument()
+    fireEvent.click(trigger())
+    expect(screen.getByText(/# Notes/)).toBeInTheDocument()
+  })
+
+  it('运行中（尚无结果）：执行中指示，不可展开', () => {
+    render(<AgentToolCard part={toolCall('find', { pattern: '**/*.ts' })} />)
+    expect(screen.getByText(m.agent_desktop_toolFind({ target: '**/*.ts' }))).toBeInTheDocument()
+    expect(screen.getByText(m.agent_desktop_toolRunning())).toBeInTheDocument()
+    fireEvent.click(trigger())
+    expect(trigger()).toHaveAttribute('aria-expanded', 'false')
+  })
+
+  it('错误态（output-error）：失败徽标，展开显示错误原文', () => {
+    render(
+      <AgentToolCard
+        part={toolCall('read', { path: 'secret.txt' }, { state: 'error', output: piResult('ENOENT: no such file') })}
+      />,
+    )
+    expect(screen.getByText(m.agent_desktop_toolError())).toBeInTheDocument()
+    fireEvent.click(trigger())
+    expect(screen.getByText('ENOENT: no such file')).toBeInTheDocument()
+  })
+
+  it('空结果哨兵：grep 无匹配 → 「无匹配结果」，不可展开', () => {
+    render(
+      <AgentToolCard
+        part={toolCall('grep', { pattern: 'zzz' }, { state: 'complete', output: piResult('No matches found') })}
+      />,
+    )
+    expect(screen.getByText(m.agent_desktop_toolNoMatches())).toBeInTheDocument()
+    fireEvent.click(trigger())
+    expect(trigger()).toHaveAttribute('aria-expanded', 'false')
+  })
+
+  it('pi 截断提示 → 「已截断」徽标；超过展示上限 → 「还有 N 项未显示」', () => {
+    const many = Array.from({ length: 53 }, (_, i) => `f${i}.txt`).join('\n')
+    render(
+      <AgentToolCard
+        part={toolCall('find', { pattern: '*.txt' }, {
+          state: 'complete',
+          output: piResult(`${many}\n\n[1000 results limit reached]`),
+        })}
+      />,
+    )
+    expect(screen.getByText(m.agent_desktop_toolTruncated())).toBeInTheDocument()
+    fireEvent.click(trigger())
+    expect(screen.getByText(m.agent_desktop_toolMore({ count: 3 }))).toBeInTheDocument()
+  })
+})

package/src/components/desktop-agent/__tests__/agent-workspace-card.test.tsx

@@ -0,0 +1,189 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+
+// 本地文件助手 · 授权目录卡（桌面本地优先 P3-B5）：真实 QueryClient + 可控 fake
+// bridge——listWorkspaces 走 queryOptions 工厂；pickDirectory 成功 → invalidate
+// 重取清单 + 选中新目录；取消（null）不动；removeWorkspace 成功 → invalidate；
+// 旧壳（无三方法）降级提示；agent 终态不可用（presence absent）同样降级；门控
+// 探测/重试中（pending）按加载态；IPC 失败 toast。
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
+import { cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react'
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
+import { TooltipProvider } from '@/components/ui/tooltip'
+import { m } from '@/paraglide/messages.js'
+
+const state = vi.hoisted(() => ({
+  bridge: null as unknown,
+  toastError: vi.fn(),
+  presence: 'present' as 'pending' | 'present' | 'absent',
+}))
+
+vi.mock('@/lib/desktop-bridge-types', () => ({
+  getDesktopBridge: () => state.bridge,
+}))
+// 门控判定（agentPort 装配）在 availability 侧的用例见 use-desktop-agent-presence.test.tsx；
+// 本文件固定 presence 值，专注卡片自身的降级/交互。
+vi.mock('@/lib/desktop-agent/use-desktop-agent-presence', () => ({
+  useDesktopAgentPresence: () => state.presence,
+}))
+vi.mock('@/components/ui/toast', () => ({
+  toast: { error: state.toastError, success: vi.fn() },
+}))
+
+import { AgentWorkspaceCard } from '../agent-workspace-card'
+
+function makeBridge(initial: string[]) {
+  let workspaces = [...initial]
+  return {
+    listWorkspaces: vi.fn(async () => [...workspaces]),
+    pickDirectory: vi.fn(async (): Promise<string | null> => null),
+    removeWorkspace: vi.fn(async (path: string) => {
+      workspaces = workspaces.filter((w) => w !== path)
+    }),
+    /** 测试辅助：模拟 main 侧 pickDirectory 写入清单 */
+    authorize(path: string) {
+      workspaces = [...workspaces, path]
+    },
+  }
+}
+
+function renderCard(props: { selected?: string | null; onSelect?: (p: string) => void; disabled?: boolean } = {}) {
+  const client = new QueryClient({ defaultOptions: { queries: { retry: false } } })
+  const onSelect = props.onSelect ?? vi.fn()
+  const { container } = render(
+    <QueryClientProvider client={client}>
+      <TooltipProvider>
+        <AgentWorkspaceCard selected={props.selected ?? null} onSelect={onSelect} disabled={props.disabled} />
+      </TooltipProvider>
+    </QueryClientProvider>,
+  )
+  return { onSelect, container }
+}
+
+beforeEach(() => {
+  state.toastError.mockReset()
+})
+
+afterEach(() => {
+  cleanup()
+  state.bridge = null
+  state.presence = 'present'
+})
+
+describe('AgentWorkspaceCard', () => {
+  it('渲染授权清单：目录名 + 完整路径，当前目录单选选中', async () => {
+    state.bridge = makeBridge(['/Users/x/proj-a', '/Users/x/proj-b'])
+    renderCard({ selected: '/Users/x/proj-b' })
+    expect(await screen.findByText('proj-a')).toBeInTheDocument()
+    expect(screen.getByText('/Users/x/proj-a')).toBeInTheDocument()
+    expect(screen.getByText('proj-b')).toBeInTheDocument()
+    const radios = screen.getAllByRole('radio')
+    expect(radios).toHaveLength(2)
+    expect(radios[1]).toHaveAttribute('aria-checked', 'true')
+    expect(radios[0]).toHaveAttribute('aria-checked', 'false')
+  })
+
+  it('点选其他目录 → onSelect(该路径)', async () => {
+    state.bridge = makeBridge(['/Users/x/proj-a', '/Users/x/proj-b'])
+    const { onSelect } = renderCard({ selected: '/Users/x/proj-a' })
+    await screen.findByText('proj-b')
+    fireEvent.click(screen.getAllByRole('radio')[1]!)
+    await waitFor(() => expect(onSelect).toHaveBeenCalledWith('/Users/x/proj-b'))
+  })
+
+  it('添加目录：pickDirectory 成功 → 清单重取（invalidate）且选中新目录', async () => {
+    const bridge = makeBridge(['/Users/x/proj-a'])
+    bridge.pickDirectory.mockImplementation(async () => {
+      bridge.authorize('/Users/x/new-proj')
+      return '/Users/x/new-proj'
+    })
+    state.bridge = bridge
+    const { onSelect } = renderCard({ selected: '/Users/x/proj-a' })
+    await screen.findByText('proj-a')
+    expect(bridge.listWorkspaces).toHaveBeenCalledTimes(1)
+    fireEvent.click(screen.getByRole('button', { name: m.agent_desktop_workspaceAdd() }))
+    expect(await screen.findByText('new-proj')).toBeInTheDocument()
+    expect(bridge.pickDirectory).toHaveBeenCalledTimes(1)
+    expect(bridge.listWorkspaces).toHaveBeenCalledTimes(2)
+    expect(onSelect).toHaveBeenCalledWith('/Users/x/new-proj')
+  })
+
+  it('取消目录对话框（pickDirectory → null）：不重取、不改选', async () => {
+    const bridge = makeBridge(['/Users/x/proj-a'])
+    state.bridge = bridge
+    const { onSelect } = renderCard({ selected: '/Users/x/proj-a' })
+    await screen.findByText('proj-a')
+    fireEvent.click(screen.getByRole('button', { name: m.agent_desktop_workspaceAdd() }))
+    await waitFor(() => expect(bridge.pickDirectory).toHaveBeenCalledTimes(1))
+    await waitFor(() =>
+      expect(screen.getByRole('button', { name: m.agent_desktop_workspaceAdd() })).not.toBeDisabled(),
+    )
+    expect(bridge.listWorkspaces).toHaveBeenCalledTimes(1)
+    expect(onSelect).not.toHaveBeenCalled()
+  })
+
+  it('撤销授权：removeWorkspace(路径) → 清单重取后该目录消失', async () => {
+    const bridge = makeBridge(['/Users/x/proj-a', '/Users/x/proj-b'])
+    state.bridge = bridge
+    renderCard({ selected: '/Users/x/proj-a' })
+    await screen.findByText('proj-b')
+    fireEvent.click(screen.getAllByRole('button', { name: m.agent_desktop_workspaceRemove() })[1]!)
+    await waitFor(() => expect(screen.queryByText('proj-b')).not.toBeInTheDocument())
+    expect(bridge.removeWorkspace).toHaveBeenCalledWith('/Users/x/proj-b')
+    expect(screen.getByText('proj-a')).toBeInTheDocument()
+  })
+
+  it('空清单：空态提示（引导先添加目录）', async () => {
+    state.bridge = makeBridge([])
+    renderCard()
+    expect(await screen.findByText(m.agent_desktop_workspaceEmpty())).toBeInTheDocument()
+    expect(screen.queryAllByRole('radio')).toHaveLength(0)
+  })
+
+  it('旧壳（无 pickDirectory/listWorkspaces/removeWorkspace）：升级提示，无添加按钮', () => {
+    state.bridge = { appInfo: vi.fn() }
+    renderCard()
+    expect(screen.getByText(m.agent_desktop_workspaceUnsupported())).toBeInTheDocument()
+    expect(screen.queryByRole('button', { name: m.agent_desktop_workspaceAdd() })).toBeNull()
+  })
+
+  it('agent 终态不可用（presence absent）：即使三方法齐备也降级为升级提示，且不发起清单查询', () => {
+    state.presence = 'absent'
+    const bridge = makeBridge(['/Users/x/proj-a'])
+    state.bridge = bridge
+    renderCard()
+    expect(screen.getByText(m.agent_desktop_workspaceUnsupported())).toBeInTheDocument()
+    expect(screen.queryByRole('button', { name: m.agent_desktop_workspaceAdd() })).toBeNull()
+    expect(bridge.listWorkspaces).not.toHaveBeenCalled()
+  })
+
+  it('门控探测 / 冷启动重试中（presence pending）：按加载态渲染，不提前报升级、不查清单', () => {
+    state.presence = 'pending'
+    const bridge = makeBridge(['/Users/x/proj-a'])
+    state.bridge = bridge
+    const { container } = renderCard()
+    expect(screen.queryByText(m.agent_desktop_workspaceUnsupported())).toBeNull()
+    expect(container.querySelectorAll('[data-slot="skeleton"]').length).toBeGreaterThan(0)
+    expect(bridge.listWorkspaces).not.toHaveBeenCalled()
+  })
+
+  it('添加失败（IPC 抛错）→ toast 错误提示', async () => {
+    const bridge = makeBridge(['/Users/x/proj-a'])
+    bridge.pickDirectory.mockRejectedValue(new Error('dialog failed'))
+    state.bridge = bridge
+    renderCard({ selected: '/Users/x/proj-a' })
+    await screen.findByText('proj-a')
+    fireEvent.click(screen.getByRole('button', { name: m.agent_desktop_workspaceAdd() }))
+    await waitFor(() => expect(state.toastError).toHaveBeenCalledWith(m.agent_desktop_workspaceAddFailed()))
+  })
+
+  it('运行中锁定（disabled）：单选与撤销不可操作', async () => {
+    state.bridge = makeBridge(['/Users/x/proj-a', '/Users/x/proj-b'])
+    renderCard({ selected: '/Users/x/proj-a', disabled: true })
+    await screen.findByText('proj-b')
+    for (const btn of screen.getAllByRole('button', { name: m.agent_desktop_workspaceRemove() })) {
+      expect(btn).toBeDisabled()
+    }
+  })
+})