@allbluecn/web-app 0.23.2 → 0.23.4

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

@@ -0,0 +1,221 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+
+// 本地文件助手 · 对话区（桌面本地优先 P3-B5）：useChat 直连 Pro desktop 域
+// AgentService 的 `POST /prompt`（AG-UI SSE）。
+// - connection：lib/desktop-agent/connection 包装——每次 connect 懒取 appInfo 的
+//   agentPort/agentToken（backend 重启换端口/令牌后下一问即用新值），引用稳定。
+// - threadId：mount 级稳定值（useChat 1.0 起必填，变化即重建 ChatClient）。B4 端点
+//   每次 POST 新建 pi 会话，threadId 仅作 run 归属回显——一期不保留多轮上下文，
+//   输入区常驻提示告知。
+// - cwd：经 forwardedProps 进 RunAgentInput.forwardedProps（端点 extractCwd 取值位，
+//   服务端再按 workspaces.json 复核授权）；父级以 key={cwd} 让每个目录一份会话。
+// - 消息：user 气泡 / assistant Markdown + 工具调用折叠卡（同 toolCallId 的
+//   tool-result 已由 processor 挂到 tool-call part.output，不重复渲染）；pi 对
+//   user / toolResult 消息也发 message_start/end，processor 会建空 assistant 消息，
+//   渲染层跳过（B3B4 报告疑虑 3）。
+// - 输入：Enter 发送 / Shift+Enter 换行 / 输入法组合中的 Enter 不发送。
+// - 中止：运行中发送按钮换成「中止」+ 应用热键 agent-abort（Mod+.，T23 声明即绑定，
+//   仅运行中 enabled）。
+import { useEffect, useMemo, useRef, useState, type KeyboardEvent, type UIEvent } from 'react'
+import { useChat } from '@tanstack/ai-react'
+import type { UIMessage } from '@tanstack/ai-client'
+import { useAppHotkeys, useHotkey } from '@tanstack/react-hotkeys'
+import { ArrowUp, CircleAlert, FolderSearch, Loader2, MessageSquareText, Square } from 'lucide-react'
+import { AgentToolCard, type AgentToolResultPart } from '@/components/desktop-agent/agent-tool-card'
+import { MarkdownContent } from '@/components/harness/ai-message/components/markdown-content'
+import { ShortcutBadge } from '@/components/hotkeys/shortcut-badge'
+import { Empty, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle } from '@/components/ui/empty'
+import {
+  InputGroup,
+  InputGroupAddon,
+  InputGroupButton,
+  InputGroupTextarea,
+} from '@/components/ui/input-group'
+import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip'
+import { createDesktopAgentConnection } from '@/lib/desktop-agent/connection'
+import { describeDesktopAgentError } from '@/lib/desktop-agent/errors'
+import { formatAppHotkeyForBadge } from '@/lib/hotkeys/registry'
+import { m } from '@/paraglide/messages.js'
+
+/** 距底部小于该值视为「贴底」：新内容到达时自动滚到底；用户上翻阅读时不打断 */
+const STICK_TO_BOTTOM_PX = 80
+
+/** 有可见内容：user 有正文；assistant 有非空正文或工具调用（空消息对跳过） */
+function hasVisibleContent(message: UIMessage): boolean {
+  return message.parts.some((part) =>
+    part.type === 'text' ? part.content.trim() !== '' : part.type === 'tool-call',
+  )
+}
+
+function AgentMessage({ message }: { message: UIMessage }) {
+  if (message.role === 'user') {
+    const text = message.parts.map((part) => (part.type === 'text' ? part.content : '')).join('')
+    return (
+      <div className="flex justify-end" data-testid="agent-message" data-role="user">
+        <div className="max-w-xl rounded-2xl rounded-br-sm bg-primary px-3.5 py-2 text-sm whitespace-pre-wrap text-primary-foreground">
+          {text}
+        </div>
+      </div>
+    )
+  }
+  const results = new Map<string, AgentToolResultPart>()
+  for (const part of message.parts) {
+    if (part.type === 'tool-result') results.set(part.toolCallId, part)
+  }
+  return (
+    <div className="flex flex-col gap-2 text-sm" data-testid="agent-message" data-role="assistant">
+      {message.parts.map((part, index) => {
+        if (part.type === 'text') {
+          // parts 流式只追加不重排，index key 稳定
+          return part.content.trim() === '' ? null : (
+            <MarkdownContent key={index} content={part.content} skipCodeHighlighting />
+          )
+        }
+        if (part.type === 'tool-call') {
+          return <AgentToolCard key={part.id || index} part={part} result={results.get(part.id)} />
+        }
+        return null
+      })}
+    </div>
+  )
+}
+
+export interface AgentChatProps {
+  /** 当前工作目录（授权清单选中项）；null = 尚未授权/选择，输入禁用 */
+  cwd: string | null
+  /** 运行态变化通知父级（运行中锁定目录切换）；须传稳定引用（如 setState） */
+  onRunningChange?: (running: boolean) => void
+}
+
+export function AgentChat({ cwd, onRunningChange }: AgentChatProps) {
+  const [connection] = useState(() => createDesktopAgentConnection())
+  const [threadId] = useState(() => crypto.randomUUID())
+  const forwardedProps = useMemo(() => ({ cwd: cwd ?? '' }), [cwd])
+  const { messages, sendMessage, stop, isLoading, error } = useChat({ connection, threadId, forwardedProps })
+
+  const [input, setInput] = useState('')
+  const scrollRef = useRef<HTMLDivElement>(null)
+  const stickToBottomRef = useRef(true)
+
+  // 声明即绑定：agent-abort 单一来源 lib/hotkeys/registry.ts
+  const hk = useAppHotkeys()
+  useHotkey(hk['agent-abort'], () => stop(), { enabled: isLoading })
+
+  useEffect(() => {
+    onRunningChange?.(isLoading)
+  }, [isLoading, onRunningChange])
+  // 运行中被卸载（离开页面）：解除父级锁定
+  useEffect(() => () => onRunningChange?.(false), [onRunningChange])
+
+  const visible = useMemo(() => messages.filter(hasVisibleContent), [messages])
+
+  useEffect(() => {
+    const el = scrollRef.current
+    if (el && stickToBottomRef.current) el.scrollTop = el.scrollHeight
+  }, [visible, isLoading])
+
+  const onScroll = (event: UIEvent<HTMLDivElement>) => {
+    const el = event.currentTarget
+    stickToBottomRef.current = el.scrollHeight - el.scrollTop - el.clientHeight < STICK_TO_BOTTOM_PX
+  }
+
+  const canSend = cwd !== null && input.trim() !== '' && !isLoading
+
+  const submit = () => {
+    if (!canSend) return
+    const text = input.trim()
+    setInput('')
+    stickToBottomRef.current = true
+    // 失败由 useChat error 态渲染（describeDesktopAgentError），这里只吞 unhandledrejection
+    Promise.resolve(sendMessage(text)).catch(() => {})
+  }
+
+  const onKeyDown = (event: KeyboardEvent<HTMLTextAreaElement>) => {
+    if (event.key !== 'Enter' || event.shiftKey || event.nativeEvent.isComposing) return
+    event.preventDefault()
+    submit()
+  }
+
+  return (
+    <section className="flex min-h-0 flex-1 flex-col overflow-hidden rounded-xl border bg-card">
+      <div className="flex items-center gap-2 border-b px-4 py-2.5 text-xs text-muted-foreground">
+        <FolderSearch className="size-3.5 shrink-0" />
+        <span className="min-w-0 truncate" data-testid="agent-chat-cwd">
+          {cwd ? m.agent_desktop_chatCwd({ path: cwd }) : m.agent_desktop_chatNoWorkspace()}
+        </span>
+      </div>
+
+      <div ref={scrollRef} onScroll={onScroll} className="min-h-0 flex-1 overflow-y-auto overscroll-contain px-4 py-4">
+        {visible.length === 0 && !isLoading ? (
+          <Empty className="h-full">
+            <EmptyHeader>
+              <EmptyMedia variant="icon">
+                <MessageSquareText />
+              </EmptyMedia>
+              <EmptyTitle>{m.agent_desktop_chatEmptyTitle()}</EmptyTitle>
+              <EmptyDescription>{m.agent_desktop_chatEmptyHint()}</EmptyDescription>
+            </EmptyHeader>
+          </Empty>
+        ) : (
+          <div className="mx-auto flex w-full max-w-3xl flex-col gap-5">
+            {visible.map((message) => (
+              <AgentMessage key={message.id} message={message} />
+            ))}
+            {isLoading && (
+              <div className="flex items-center gap-2 text-sm text-muted-foreground" data-testid="agent-chat-thinking">
+                <Loader2 className="size-4 animate-spin" />
+                {m.agent_desktop_chatThinking()}
+              </div>
+            )}
+          </div>
+        )}
+      </div>
+
+      {error && (
+        <div
+          role="alert"
+          className="mx-4 mb-2 flex items-start gap-2 rounded-lg border border-destructive/40 bg-destructive/5 px-3 py-2 text-xs text-destructive"
+        >
+          <CircleAlert className="mt-0.5 size-3.5 shrink-0" />
+          <span className="min-w-0 wrap-break-word">{describeDesktopAgentError(error)}</span>
+        </div>
+      )}
+
+      <div className="border-t p-3">
+        <InputGroup>
+          <InputGroupTextarea
+            value={input}
+            onChange={(event) => setInput(event.target.value)}
+            onKeyDown={onKeyDown}
+            disabled={cwd === null}
+            placeholder={cwd ? m.agent_desktop_chatPlaceholder() : m.agent_desktop_chatNoWorkspace()}
+            className="max-h-40"
+          />
+          <InputGroupAddon align="block-end">
+            <span className="min-w-0 truncate text-xs font-normal">{m.agent_desktop_chatIndependentHint()}</span>
+            {isLoading ? (
+              <Tooltip>
+                <TooltipTrigger
+                  render={<InputGroupButton variant="outline" size="sm" className="ml-auto" onClick={() => stop()} />}
+                >
+                  <Square className="fill-current" />
+                  {m.agent_desktop_chatStop()}
+                </TooltipTrigger>
+                <TooltipContent>
+                  <ShortcutBadge keys={formatAppHotkeyForBadge(hk['agent-abort'].hotkey)} />
+                </TooltipContent>
+              </Tooltip>
+            ) : (
+              <InputGroupButton variant="default" size="sm" className="ml-auto" disabled={!canSend} onClick={submit}>
+                <ArrowUp />
+                {m.agent_desktop_chatSend()}
+              </InputGroupButton>
+            )}
+          </InputGroupAddon>
+        </InputGroup>
+      </div>
+    </section>
+  )
+}

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

@@ -0,0 +1,185 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+
+// 本地文件助手 · 工具调用折叠卡（桌面本地优先 P3-B5）：pi 只读四件套的每次调用
+// 渲染为一张默认折叠的卡——头部「工具 + 目标 + 计数」，展开后列出文件名（ls /
+// find）、命中行（grep：文件:行号 + 行内容）或文件内容（read）。风格对齐 hextaui
+// AI 分组 / 站内 components/ai/tool-cards（rounded-lg border bg-muted/40 text-xs +
+// 折叠头），折叠用 shadcn Collapsible（Base UI）。解析逻辑在 lib/desktop-agent/tool-result。
+import { useState } from 'react'
+import type { UIMessage } from '@tanstack/ai-client'
+import {
+  ChevronRight,
+  FileSearch,
+  FileText,
+  Folder,
+  FolderTree,
+  Loader2,
+  Search,
+  Wrench,
+  type LucideIcon,
+} from 'lucide-react'
+import { Badge } from '@/components/ui/badge'
+import { Collapsible, CollapsibleContent, CollapsibleTrigger } from '@/components/ui/collapsible'
+import {
+  extractAgentToolText,
+  parseAgentToolArgs,
+  summarizeAgentTool,
+  type AgentToolKind,
+  type AgentToolSummary,
+} from '@/lib/desktop-agent/tool-result'
+import { cn } from '@/lib/utils'
+import { m } from '@/paraglide/messages.js'
+
+type MessagePart = UIMessage['parts'][number]
+export type AgentToolCallPart = Extract<MessagePart, { type: 'tool-call' }>
+export type AgentToolResultPart = Extract<MessagePart, { type: 'tool-result' }>
+
+const KIND_ICON: Record<AgentToolKind, LucideIcon> = {
+  read: FileText,
+  grep: Search,
+  find: FileSearch,
+  ls: FolderTree,
+  other: Wrench,
+}
+
+// 文案在渲染时解析（paraglide 按当前 locale）；非导出函数保 Fast Refresh 纯组件边界
+function titleOf(summary: AgentToolSummary, toolName: string): string {
+  const target = summary.target ?? '…'
+  switch (summary.kind) {
+    case 'read':
+      return m.agent_desktop_toolRead({ target })
+    case 'grep':
+      return m.agent_desktop_toolGrep({ target })
+    case 'find':
+      return m.agent_desktop_toolFind({ target })
+    case 'ls':
+      return m.agent_desktop_toolLs({ target })
+    default:
+      return m.agent_desktop_toolOther({ name: toolName })
+  }
+}
+
+function countOf(summary: AgentToolSummary): string | null {
+  if (summary.empty) return summary.kind === 'ls' ? m.agent_desktop_toolEmptyDir() : m.agent_desktop_toolNoMatches()
+  if (summary.total === 0) return null
+  switch (summary.kind) {
+    case 'grep':
+      return m.agent_desktop_toolCountHits({ count: summary.total })
+    case 'ls':
+    case 'find':
+      return m.agent_desktop_toolCountFiles({ count: summary.total })
+    default:
+      return m.agent_desktop_toolCountLines({ count: summary.total })
+  }
+}
+
+function ToolEntries({ summary }: { summary: AgentToolSummary }) {
+  const hidden = summary.total - summary.entries.length
+  return (
+    <div className="flex flex-col gap-1.5">
+      {summary.kind === 'read' || summary.kind === 'other' ? (
+        <pre className="max-h-60 overflow-auto rounded bg-background p-2 font-mono whitespace-pre-wrap break-all text-foreground">
+          {summary.entries.map((entry) => (entry.kind === 'text' ? entry.text : '')).join('\n')}
+        </pre>
+      ) : (
+        <ul className="flex max-h-60 flex-col gap-0.5 overflow-auto font-mono">
+          {summary.entries.map((entry, index) =>
+            entry.kind === 'hit' ? (
+              <li key={index} className="flex min-w-0 gap-2 rounded px-1.5 py-0.5 hover:bg-background">
+                <span className="shrink-0 text-muted-foreground">{`${entry.path}:${entry.line}`}</span>
+                <span className="min-w-0 truncate">{entry.text}</span>
+              </li>
+            ) : entry.kind === 'file' ? (
+              <li key={index} className="flex min-w-0 items-center gap-1.5 rounded px-1.5 py-0.5 hover:bg-background">
+                {entry.path.endsWith('/') ? (
+                  <Folder className="size-3 shrink-0 text-muted-foreground" />
+                ) : (
+                  <FileText className="size-3 shrink-0 text-muted-foreground" />
+                )}
+                <span className="min-w-0 truncate">{entry.path}</span>
+              </li>
+            ) : null,
+          )}
+        </ul>
+      )}
+      {hidden > 0 && <p className="text-muted-foreground">{m.agent_desktop_toolMore({ count: hidden })}</p>}
+    </div>
+  )
+}
+
+export interface AgentToolCardProps {
+  part: AgentToolCallPart
+  /** 同 toolCallId 的 tool-result part（output 缺席时的内容回落 + 错误原文） */
+  result?: AgentToolResultPart
+}
+
+export function AgentToolCard({ part, result }: AgentToolCardProps) {
+  const [open, setOpen] = useState(false)
+  const isError = part.state === 'error' || result?.state === 'error'
+  const settled = isError || part.output !== undefined || (result !== undefined && result.state !== 'streaming')
+  const text = settled ? extractAgentToolText(part.output, result?.content) : null
+  const summary = summarizeAgentTool(part.name, parseAgentToolArgs(part), isError ? null : text)
+  const errorText = isError ? (result?.error ?? text) : null
+  const expandable = isError ? Boolean(errorText) : summary.entries.length > 0
+  const count = settled && !isError ? countOf(summary) : null
+  const Icon = KIND_ICON[summary.kind]
+  const expanded = open && expandable
+
+  return (
+    <Collapsible
+      open={expanded}
+      onOpenChange={setOpen}
+      disabled={!expandable}
+      data-tool={part.name}
+      className={cn(
+        'rounded-lg border text-xs',
+        isError ? 'border-destructive/40 bg-destructive/5' : 'border-border bg-muted/40',
+      )}
+    >
+      <CollapsibleTrigger
+        data-testid="agent-tool-card-trigger"
+        className="flex w-full items-center gap-2 px-2.5 py-2 text-left"
+      >
+        <ChevronRight
+          className={cn(
+            'size-3.5 shrink-0 text-muted-foreground transition-transform',
+            expanded && 'rotate-90',
+            !expandable && 'opacity-0',
+          )}
+        />
+        <Icon className="size-3.5 shrink-0 text-muted-foreground" />
+        <span className="min-w-0 flex-1 truncate font-medium">{titleOf(summary, part.name)}</span>
+        {!settled && (
+          <span className="flex shrink-0 items-center gap-1 text-muted-foreground">
+            <Loader2 className="size-3 animate-spin" />
+            {m.agent_desktop_toolRunning()}
+          </span>
+        )}
+        {isError && (
+          <Badge variant="destructive" className="shrink-0">
+            {m.agent_desktop_toolError()}
+          </Badge>
+        )}
+        {summary.truncated && (
+          <Badge variant="outline" className="shrink-0">
+            {m.agent_desktop_toolTruncated()}
+          </Badge>
+        )}
+        {count && <span className="shrink-0 text-muted-foreground">{count}</span>}
+      </CollapsibleTrigger>
+      <CollapsibleContent>
+        <div className="border-t px-2.5 py-2">
+          {isError ? (
+            <pre className="max-h-60 overflow-auto font-mono whitespace-pre-wrap break-all text-destructive">
+              {errorText}
+            </pre>
+          ) : (
+            <ToolEntries summary={summary} />
+          )}
+        </div>
+      </CollapsibleContent>
+    </Collapsible>
+  )
+}

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

@@ -0,0 +1,176 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+
+// 本地文件助手 · 授权目录卡（桌面本地优先 P3-B5）：agent 只能读取这里列出的目录。
+// - 添加：desktopBridge.pickDirectory（main 侧原生目录对话框，选中即写入
+//   userData/agent/workspaces.json 并返回规范化绝对路径；取消返回 null）——
+//   renderer 无法注入任意路径，授权入口只有这一个（B1 授权模型）。
+// - 清单：react-query 工厂 desktopAgentWorkspacesQueryOptions（listWorkspaces）。
+// - 撤销：removeWorkspace；增删成功后按 DESKTOP_AGENT_QUERY_KEY 前缀 invalidate。
+// - 单选当前工作目录（对话 cwd）；运行中由父级锁定（disabled），避免中途换目录。
+// - 门控：useDesktopAgentPresence（含 agentPort 装配判定 + 冷启动有界重试）+
+//   isAgentWorkspaceSupported（B1 三方法）双条件，与侧栏入口/页面同源；presence
+//   为 pending（探测/重试中）时按加载态渲染，absent（终态）才提示升级。
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'
+import { FolderOpen, FolderPlus, Loader2, X } from 'lucide-react'
+import { Button } from '@/components/ui/button'
+import { Card, CardAction, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+import { Empty, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle } from '@/components/ui/empty'
+import { Label } from '@/components/ui/label'
+import { RadioGroup, RadioGroupItem } from '@/components/ui/radio-group'
+import { Skeleton } from '@/components/ui/skeleton'
+import { toast } from '@/components/ui/toast'
+import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip'
+import { getDesktopBridge } from '@/lib/desktop-bridge-types'
+import { isAgentWorkspaceSupported } from '@/lib/desktop-agent/availability'
+import { useDesktopAgentPresence } from '@/lib/desktop-agent/use-desktop-agent-presence'
+import { DESKTOP_AGENT_QUERY_KEY, desktopAgentWorkspacesQueryOptions } from '@/lib/queries/desktop-agent'
+import { cn } from '@/lib/utils'
+import { m } from '@/paraglide/messages.js'
+
+/** 路径末段作为目录显示名（POSIX / Windows 分隔符均可） */
+function folderNameOf(path: string): string {
+  return path.split(/[\\/]/).filter(Boolean).at(-1) ?? path
+}
+
+export interface AgentWorkspaceCardProps {
+  /** 当前选中的工作目录（对话 cwd） */
+  selected: string | null
+  onSelect: (path: string) => void
+  /** 运行中锁定切换与撤销 */
+  disabled?: boolean
+}
+
+export function AgentWorkspaceCard({ selected, onSelect, disabled = false }: AgentWorkspaceCardProps) {
+  const queryClient = useQueryClient()
+  // 门控口径与侧栏入口/页面同源（presence 已含 agentPort：agent 未装配即不可用），
+  // 再叠加 B1 三方法检查——旧壳（无目录授权 IPC）同样整卡降级为升级提示。
+  const presence = useDesktopAgentPresence()
+  const supported = presence === 'present' && isAgentWorkspaceSupported()
+  const workspacesQuery = useQuery({ ...desktopAgentWorkspacesQueryOptions(), enabled: supported })
+
+  const addMutation = useMutation({
+    mutationFn: async () => (await getDesktopBridge()?.pickDirectory?.()) ?? null,
+    onSuccess: async (picked) => {
+      if (!picked) return // 用户取消对话框
+      await queryClient.invalidateQueries({ queryKey: DESKTOP_AGENT_QUERY_KEY })
+      onSelect(picked)
+    },
+    onError: () => {
+      toast.error(m.agent_desktop_workspaceAddFailed())
+    },
+  })
+
+  const removeMutation = useMutation({
+    mutationFn: async (path: string) => {
+      await getDesktopBridge()?.removeWorkspace?.(path)
+    },
+    onSuccess: () => queryClient.invalidateQueries({ queryKey: DESKTOP_AGENT_QUERY_KEY }),
+    onError: () => {
+      toast.error(m.agent_desktop_workspaceRemoveFailed())
+    },
+  })
+
+  const workspaces = workspacesQuery.data ?? []
+  const loadingBody = (
+    <div className="flex flex-col gap-2">
+      <Skeleton className="h-12 w-full" />
+      <Skeleton className="h-12 w-full" />
+    </div>
+  )
+
+  let body: React.ReactNode
+  if (presence === 'pending') {
+    // 门控探测 / 冷启动有界重试中：按加载态渲染，不提前报「请升级客户端」
+    body = loadingBody
+  } else if (!supported) {
+    body = <p className="text-sm text-muted-foreground">{m.agent_desktop_workspaceUnsupported()}</p>
+  } else if (workspacesQuery.isPending) {
+    body = loadingBody
+  } else if (workspacesQuery.isError) {
+    body = <p className="text-sm text-destructive">{m.agent_desktop_workspaceLoadFailed()}</p>
+  } else if (workspaces.length === 0) {
+    body = (
+      <Empty className="border p-6">
+        <EmptyHeader>
+          <EmptyMedia variant="icon">
+            <FolderOpen />
+          </EmptyMedia>
+          <EmptyTitle>{m.agent_desktop_workspaceEmpty()}</EmptyTitle>
+          <EmptyDescription>{m.agent_desktop_workspaceEmptyHint()}</EmptyDescription>
+        </EmptyHeader>
+      </Empty>
+    )
+  } else {
+    body = (
+      <RadioGroup
+        value={selected ?? ''}
+        onValueChange={(value) => {
+          if (typeof value === 'string' && value !== '') onSelect(value)
+        }}
+        disabled={disabled}
+        className="gap-2"
+      >
+        {workspaces.map((path, index) => {
+          const id = `desktop-agent-workspace-${index}`
+          const checked = path === selected
+          return (
+            <div
+              key={path}
+              className={cn(
+                'flex items-center gap-3 rounded-lg border px-3 py-2 transition-colors',
+                checked ? 'border-primary/60 bg-primary/5' : 'hover:border-primary/30',
+              )}
+            >
+              <RadioGroupItem value={path} id={id} />
+              <Label htmlFor={id} className="min-w-0 flex-1 cursor-pointer flex-col items-start gap-1">
+                <span className="w-full truncate text-sm font-medium">{folderNameOf(path)}</span>
+                <span className="w-full truncate text-xs font-normal text-muted-foreground">{path}</span>
+              </Label>
+              <Tooltip>
+                <TooltipTrigger
+                  render={
+                    <Button
+                      variant="ghost"
+                      size="icon-sm"
+                      aria-label={m.agent_desktop_workspaceRemove()}
+                      disabled={disabled || removeMutation.isPending}
+                      onClick={() => removeMutation.mutate(path)}
+                    />
+                  }
+                >
+                  <X />
+                </TooltipTrigger>
+                <TooltipContent>{m.agent_desktop_workspaceRemove()}</TooltipContent>
+              </Tooltip>
+            </div>
+          )
+        })}
+      </RadioGroup>
+    )
+  }
+
+  return (
+    <Card className="gap-4">
+      <CardHeader>
+        <CardTitle>{m.agent_desktop_workspaceTitle()}</CardTitle>
+        <CardDescription>{m.agent_desktop_workspaceDescription()}</CardDescription>
+        {supported && (
+          <CardAction>
+            <Button
+              variant="outline"
+              size="sm"
+              disabled={addMutation.isPending}
+              onClick={() => addMutation.mutate()}
+            >
+              {addMutation.isPending ? <Loader2 className="animate-spin" /> : <FolderPlus />}
+              {m.agent_desktop_workspaceAdd()}
+            </Button>
+          </CardAction>
+        )}
+      </CardHeader>
+      <CardContent>{body}</CardContent>
+    </Card>
+  )
+}

package/src/components/layout/sidebar-03/__tests__/user-menu-anonymous.test.tsx

@@ -19,6 +19,10 @@ vi.mock('@/components/ui/sidebar', () => ({
 }))
 vi.mock('@/components/ui/toast', () => ({ toast: { success: vi.fn(), error: vi.fn() } }))
 vi.mock('@/server/serverFns/auth/session', () => ({ logoutRemoteFn: vi.fn() }))
+// A9：user-menu 反向转移登出链路新增 import——拦住 serverFn 模块图（勿真触
+// desktop-bootstrap/@allbluecn/database 模块级单例，照本文件 session mock 先例）
+vi.mock('@/server/serverFns/sync/transfer', () => ({ reverseTransferOwnershipFn: vi.fn() }))
+vi.mock('@/lib/desktop-bridge-types', () => ({ getDesktopBridge: () => null }))
 vi.mock('@/components/shared-kit', () => ({
   UserAvatar: ({ name }: { name?: string }) => <div data-testid="avatar">{name}</div>,
 }))

package/src/components/layout/sidebar-03/app-sidebar.tsx

@@ -32,7 +32,7 @@ import { NavKnowledge } from "@/components/layout/sidebar-03/nav-knowledge";
 import { NavWorkspace } from "@/components/layout/sidebar-03/nav-workspace";
 import { UserMenu } from "@/components/layout/sidebar-03/user-menu";
 import { AnimatedThemeToggler } from '@/components/magicui/animated-theme-toggler'
-import { workspaceRoutes } from "@/config/sidebar-routes";
+import { desktopAgentRoute, workspaceRoutes } from "@/config/sidebar-routes";
 import type { Route } from "@/config/sidebar-routes";
 import { PresenceAvatarStack } from "@/components/layout/sidebar-03/presence-avatar-stack";
 import { SidebarSearchTrigger } from "@/components/layout/sidebar-03/nav-search-trigger"
@@ -40,6 +40,7 @@ import { NavSecondary } from "@/components/layout/sidebar-03/nav-secondary"
 import { PluginNavItems } from '@/components/plugin-slots/plugin-nav-items'
 import { isDesktopEdition } from "@/lib/edition-desktop";
 import { getDesktopBridge } from "@/lib/desktop-bridge-types";
+import { useDesktopAgentPresence } from "@/lib/desktop-agent/use-desktop-agent-presence";
 
 // presence 渲染工厂（§8.2 消费者两文件之一）：nav-main 按 route.id 查
 // MODULE_ROUTES 得 module key 后回调；module 级单例 map，identity 稳定。
@@ -47,10 +48,16 @@ const routes: Route[] = workspaceRoutes.map((route) => ({
   ...route,
   presence: (module: string) => <PresenceAvatarStack module={module} />,
 }));
+// 桌面壳追加本地文件助手入口（P3-B5）：module 级常量保 identity 稳定
+const routesWithDesktopAgent: Route[] = [...routes, desktopAgentRoute];
 
 export function DashboardSidebar() {
   const { state } = useSidebar();
   const isCollapsed = state === "collapsed";
+  // 本地文件助手入口门控（与 /_nav/agent 路由同源判定）：SSR / hydration 首帧恒
+  // pending（不渲染该项，首帧一致），挂载后桌面壳恢复；云 Web / OSS 恒不可见
+  const desktopAgentPresence = useDesktopAgentPresence();
+  const navRoutes = desktopAgentPresence === "present" ? routesWithDesktopAgent : routes;
   // 桌面壳（Electron hiddenInset）：红绿灯悬浮在窗口左上角，顶栏重排为
   // 「第一行红绿灯让位 + 右侧按钮组（整行可拖动窗口）、第二行 logo」。
   // web/云端 SaaS 布局不变（isDesktopEdition 为构建期常量，死分支消除）。
@@ -149,7 +156,7 @@ export function DashboardSidebar() {
         )}
       </SidebarHeader>
       <SidebarContent className="gap-4 px-2 py-4">
-        <DashboardNavigation routes={routes} />
+        <DashboardNavigation routes={navRoutes} />
         <NavWorkspace />
         <NavKnowledge />
         <PluginNavItems />