@nextclaw/ui 0.15.4 → 0.15.6

package/src/shared/components/common/brand-header.tsx

@@ -1,10 +1,20 @@
 import type { UpdateSnapshot } from '@nextclaw/shared';
-import { runtimeUpdateManager, useRuntimeUpdateStore } from '@/features/system-status';
+import {
+  runtimeUpdateManager,
+  resolveUpdateReleaseNotesLink,
+  useCurrentVersionReleaseNotesLink,
+  useRuntimeUpdateStore,
+  type ReleaseNotesLink,
+  type RuntimeUpdateBusyAction
+} from '@/features/system-status';
 import { useAppMeta } from '@/shared/hooks/use-app-meta';
-import { type ReactNode, useState } from 'react';
+import type { ReactNode } from 'react';
 import { RuntimeStatusEntry } from '@/app/components/layout/runtime-status-entry';
+import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from '@/shared/components/ui/tooltip';
+import { hostCapabilityManager } from '@/shared/lib/host-capabilities';
 import { t } from '@/shared/lib/i18n';
 import { cn } from '@/shared/lib/utils';
+import { ExternalLink } from 'lucide-react';
 
 type BrandHeaderProps = {
   className?: string;
@@ -14,9 +24,11 @@ type BrandHeaderProps = {
 
 export function BrandHeader({ className, density = 'sidebar', suffix }: BrandHeaderProps) {
   const { data } = useAppMeta();
+  const { supported, busyAction, snapshot } = useRuntimeUpdateStore();
   const productName = data?.name ?? 'NextClaw';
   const productVersion = data?.productVersion?.trim();
   const versionLabel = productVersion ? `v${productVersion}` : null;
+  const releaseNotesLink = useCurrentVersionReleaseNotesLink(productVersion);
   const resolvedSuffix = suffix ?? <RuntimeStatusEntry />;
   const shouldReserveMacWindowControls = typeof window !== 'undefined' && window.nextclawDesktop?.platform === 'darwin';
   const isChromeDensity = density === 'chrome';
@@ -41,9 +53,9 @@ export function BrandHeader({ className, density = 'sidebar', suffix }: BrandHea
           >
             {productName}
           </span>
-          {versionLabel ? <BrandVersionLabel versionLabel={versionLabel} density={density} /> : null}
+          {versionLabel ? <BrandVersionLabel versionLabel={versionLabel} density={density} releaseNotesLink={releaseNotesLink} /> : null}
         </div>
-        <RuntimeUpdateInlineStatus />
+        <RuntimeUpdateInlineStatus supported={supported} busyAction={busyAction} snapshot={snapshot} />
         {resolvedSuffix ? <span className="inline-flex items-center shrink-0">{resolvedSuffix}</span> : null}
       </div>
     </div>
@@ -53,75 +65,143 @@ export function BrandHeader({ className, density = 'sidebar', suffix }: BrandHea
 function BrandVersionLabel({
   versionLabel,
   density,
+  releaseNotesLink,
 }: {
   versionLabel: string;
   density: BrandHeaderProps['density'];
+  releaseNotesLink: ReleaseNotesLink | null;
 }) {
-  const [isTooltipOpen, setIsTooltipOpen] = useState(false);
   const isChromeDensity = density === 'chrome';
-
-  return (
-    <span
-      className="relative min-w-0 flex-1"
-      onMouseEnter={() => setIsTooltipOpen(true)}
-      onMouseLeave={() => setIsTooltipOpen(false)}
-      onFocus={() => setIsTooltipOpen(true)}
-      onBlur={() => setIsTooltipOpen(false)}
+  const triggerClassName = cn(
+    'block min-w-0 flex-1 truncate font-medium text-gray-500 outline-none',
+    isChromeDensity ? 'text-[12px]' : 'text-[12px]',
+    releaseNotesLink && 'cursor-pointer rounded-sm transition-colors hover:text-gray-700 hover:underline focus-visible:ring-2 focus-visible:ring-gray-300'
+  );
+  const tooltip = releaseNotesLink
+    ? [
+        t('desktopUpdatesVersionTooltipCurrent').replace('{version}', versionLabel),
+        t('desktopUpdatesVersionTooltipReleaseNotes').replace('{version}', releaseNotesLink.versionLabel)
+      ].join('\n')
+    : versionLabel;
+  const trigger = releaseNotesLink ? (
+    <button
+      type="button"
+      aria-label={t('desktopUpdatesVersionReleaseNotesLabel').replace('{currentVersion}', versionLabel).replace('{releaseVersion}', releaseNotesLink.versionLabel)}
+      className={cn(triggerClassName, 'border-0 bg-transparent p-0 text-left')}
+      onClick={() => void hostCapabilityManager.openExternalUrl(releaseNotesLink.url)}
     >
-      <span
-        tabIndex={0}
-        aria-label={versionLabel}
-        className={cn(
-          'block min-w-0 truncate font-medium text-gray-500 outline-none',
-          isChromeDensity ? 'text-[12px]' : 'text-[12px]',
-        )}
-      >
-        {versionLabel}
-      </span>
-      {isTooltipOpen ? (
-        <span className="pointer-events-none absolute left-0 top-full z-[var(--z-tooltip)] mt-1 w-max max-w-none whitespace-nowrap rounded-md border bg-popover px-3 py-1.5 text-xs font-medium text-popover-foreground shadow-md">
-          {versionLabel}
-        </span>
-      ) : null}
+      {versionLabel}
+    </button>
+  ) : (
+    <span tabIndex={0} aria-label={versionLabel} className={triggerClassName}>
+      {versionLabel}
     </span>
   );
+
+  return (
+    <TooltipProvider delayDuration={250}>
+      <Tooltip>
+        <TooltipTrigger asChild>{trigger}</TooltipTrigger>
+        <TooltipContent side="bottom" className="max-w-72 whitespace-pre-line text-xs leading-relaxed">{tooltip}</TooltipContent>
+      </Tooltip>
+    </TooltipProvider>
+  );
 }
 
-function RuntimeUpdateInlineStatus() {
-  const { supported, busyAction, snapshot } = useRuntimeUpdateStore();
+function RuntimeUpdateInlineStatus({
+  supported,
+  busyAction,
+  snapshot,
+}: {
+  supported: boolean;
+  busyAction: RuntimeUpdateBusyAction;
+  snapshot: UpdateSnapshot | null;
+}) {
   if (!supported || !snapshot) {
     return null;
   }
-  if (snapshot.status === 'downloading' || snapshot.status === 'blocked' || snapshot.status === 'failed') {
+  const releaseNotesLink = resolveUpdateReleaseNotesLink(snapshot);
+  if (snapshot.status === 'downloading') {
+    return (
+      <RuntimeUpdateInlineGroup>
+        <RuntimeUpdateInlineBadge snapshot={snapshot} />
+        {releaseNotesLink ? <RuntimeUpdateReleaseNotesButton link={releaseNotesLink} tone="amber" /> : null}
+      </RuntimeUpdateInlineGroup>
+    );
+  }
+  if (snapshot.status === 'blocked' || snapshot.status === 'failed') {
     return <RuntimeUpdateInlineBadge snapshot={snapshot} />;
   }
   if (snapshot.status === 'downloaded') {
     return (
-      <button
-        type="button"
-        className="inline-flex h-5 shrink-0 items-center rounded-full bg-emerald-50 px-2 text-[11px] font-semibold leading-none text-emerald-700 ring-1 ring-emerald-100 transition-colors hover:bg-emerald-100 disabled:opacity-70"
-        disabled={busyAction === 'applying'}
-        onClick={() => void runtimeUpdateManager.applyDownloadedUpdate()}
-      >
-        {busyAction === 'applying' ? t('desktopUpdatesInlineApplying') : t('desktopUpdatesInlineReady')}
-      </button>
+      <RuntimeUpdateInlineGroup>
+        <button
+          type="button"
+          className="inline-flex h-5 shrink-0 items-center rounded-full bg-emerald-50 px-2 text-[11px] font-semibold leading-none text-emerald-700 ring-1 ring-emerald-100 transition-colors hover:bg-emerald-100 disabled:opacity-70"
+          disabled={busyAction === 'applying'}
+          onClick={() => void runtimeUpdateManager.applyDownloadedUpdate()}
+        >
+          {busyAction === 'applying' ? t('desktopUpdatesInlineApplying') : t('desktopUpdatesInlineReady')}
+        </button>
+        {releaseNotesLink ? <RuntimeUpdateReleaseNotesButton link={releaseNotesLink} tone="emerald" /> : null}
+      </RuntimeUpdateInlineGroup>
     );
   }
   if (snapshot.status === 'update-available') {
     return (
-      <button
-        type="button"
-        className="inline-flex h-5 shrink-0 items-center rounded-full bg-amber-50 px-2 text-[11px] font-semibold leading-none text-amber-700 ring-1 ring-amber-100 transition-colors hover:bg-amber-100 disabled:opacity-70"
-        disabled={busyAction === 'downloading'}
-        onClick={() => void runtimeUpdateManager.downloadUpdate()}
-      >
-        {busyAction === 'downloading' ? t('desktopUpdatesInlineDownloading') : t('desktopUpdatesInlineDownload')}
-      </button>
+      <RuntimeUpdateInlineGroup>
+        <button
+          type="button"
+          className="inline-flex h-5 shrink-0 items-center rounded-full bg-amber-50 px-2 text-[11px] font-semibold leading-none text-amber-700 ring-1 ring-amber-100 transition-colors hover:bg-amber-100 disabled:opacity-70"
+          disabled={busyAction === 'downloading'}
+          onClick={() => void runtimeUpdateManager.downloadUpdate()}
+        >
+          {busyAction === 'downloading' ? t('desktopUpdatesInlineDownloading') : t('desktopUpdatesInlineDownload')}
+        </button>
+        {releaseNotesLink ? <RuntimeUpdateReleaseNotesButton link={releaseNotesLink} tone="amber" /> : null}
+      </RuntimeUpdateInlineGroup>
     );
   }
   return null;
 }
 
+function RuntimeUpdateInlineGroup({ children }: { children: ReactNode }) {
+  return <span className="inline-flex shrink-0 items-center gap-1">{children}</span>;
+}
+
+function RuntimeUpdateReleaseNotesButton({
+  link,
+  tone,
+}: {
+  link: ReleaseNotesLink;
+  tone: 'amber' | 'emerald';
+}) {
+  const label = t('desktopUpdatesUpdateReleaseNotesLabel').replace('{version}', link.versionLabel);
+  const className = cn(
+    'inline-flex h-5 w-5 shrink-0 items-center justify-center rounded-full text-[11px] ring-1 transition-colors focus-visible:outline-none focus-visible:ring-2',
+    tone === 'emerald'
+      ? 'bg-emerald-50 text-emerald-700 ring-emerald-100 hover:bg-emerald-100 focus-visible:ring-emerald-300'
+      : 'bg-amber-50 text-amber-700 ring-amber-100 hover:bg-amber-100 focus-visible:ring-amber-300'
+  );
+  return (
+    <TooltipProvider delayDuration={250}>
+      <Tooltip>
+        <TooltipTrigger asChild>
+          <button
+            type="button"
+            aria-label={label}
+            className={className}
+            onClick={() => void hostCapabilityManager.openExternalUrl(link.url)}
+          >
+            <ExternalLink className="h-3 w-3" aria-hidden="true" />
+          </button>
+        </TooltipTrigger>
+        <TooltipContent side="bottom" className="text-xs">{label}</TooltipContent>
+      </Tooltip>
+    </TooltipProvider>
+  );
+}
+
 function RuntimeUpdateInlineBadge({ snapshot }: { snapshot: UpdateSnapshot }) {
   if (snapshot.status === 'blocked' || snapshot.status === 'failed') {
     return <RuntimeUpdateIssueIcon snapshot={snapshot} />;
@@ -149,15 +229,21 @@ function RuntimeUpdateIssueIcon({ snapshot }: { snapshot: UpdateSnapshot }) {
     : null;
   const tooltip = [title, rootCause, diagnostic, recoveryCommand].filter(Boolean).join('\n');
   return (
-    <span
-      role="img"
-      aria-label={title}
-      title={tooltip}
-      tabIndex={0}
-      className="inline-flex h-5 w-5 shrink-0 items-center justify-center rounded-full bg-amber-50 text-[13px] font-bold leading-none text-amber-700 ring-1 ring-amber-100"
-    >
-      !
-    </span>
+    <TooltipProvider delayDuration={250}>
+      <Tooltip>
+        <TooltipTrigger asChild>
+          <span
+            role="img"
+            aria-label={title}
+            tabIndex={0}
+            className="inline-flex h-5 w-5 shrink-0 items-center justify-center rounded-full bg-amber-50 text-[13px] font-bold leading-none text-amber-700 ring-1 ring-amber-100 outline-none focus-visible:ring-2 focus-visible:ring-amber-300"
+          >
+            !
+          </span>
+        </TooltipTrigger>
+        <TooltipContent side="bottom" className="max-w-80 whitespace-pre-line break-words text-xs leading-relaxed">{tooltip}</TooltipContent>
+      </Tooltip>
+    </TooltipProvider>
   );
 }
 

package/src/shared/components/path-picker/__tests__/server-path-picker-dialog.test.tsx

@@ -5,6 +5,9 @@ import { setLanguage } from '@/shared/lib/i18n';
 
 const mocks = vi.hoisted(() => ({
   useServerPathBrowse: vi.fn(),
+  useServerPathCreateDirectory: vi.fn(),
+  createDirectory: vi.fn(),
+  resetCreateDirectory: vi.fn(),
   refetch: vi.fn(),
 }));
 
@@ -12,21 +15,75 @@ vi.mock('@/shared/hooks/use-server-path-browse', () => ({
   useServerPathBrowse: mocks.useServerPathBrowse,
 }));
 
+vi.mock('@/shared/hooks/use-server-path-create-directory', () => ({
+  useServerPathCreateDirectory: mocks.useServerPathCreateDirectory,
+}));
+
+type PickerOverrides = {
+  currentPath?: string;
+  defaultWorkspacePath?: string;
+  description?: string;
+  open?: boolean;
+};
+
+const createPickerElement = (overrides?: PickerOverrides) => (
+  <ServerPathPickerDialog
+    open={overrides?.open ?? true}
+    currentPath={overrides?.currentPath ?? '/workspace'}
+    defaultWorkspacePath={overrides?.defaultWorkspacePath}
+    isSaving={false}
+    onOpenChange={() => {}}
+    onConfirm={() => {}}
+    title="选择目录"
+    description={overrides?.description ?? '选择一个目录'}
+    pathLabel="目录"
+    confirmLabel="确定"
+  />
+);
+
+const renderPicker = (overrides?: PickerOverrides) => render(createPickerElement(overrides));
+
 describe('ServerPathPickerDialog', () => {
   beforeEach(() => {
     setLanguage('zh');
     mocks.refetch.mockReset();
+    mocks.refetch.mockResolvedValue(undefined);
+    mocks.createDirectory.mockReset();
+    mocks.createDirectory.mockResolvedValue({ path: '/workspace/new-folder' });
+    mocks.resetCreateDirectory.mockReset();
+    mocks.useServerPathCreateDirectory.mockReturnValue({
+      mutateAsync: mocks.createDirectory,
+      reset: mocks.resetCreateDirectory,
+      isPending: false,
+      error: null,
+    });
     mocks.useServerPathBrowse.mockReturnValue({
       data: {
         currentPath: '/workspace',
         homePath: '/Users/peiwang',
         parentPath: '/',
-        breadcrumbs: [
-          { label: 'workspace', path: '/workspace' },
-        ],
+        breadcrumbs: [{ label: 'workspace', path: '/workspace' }],
         entries: [
-          { name: 'playground', path: '/workspace/playground' },
-          { name: 'nextbot', path: '/workspace/nextbot' },
+          {
+            name: 'playground',
+            path: '/workspace/playground',
+            kind: 'directory',
+            hidden: false,
+          },
+          {
+            name: 'nextbot',
+            path: '/workspace/nextbot',
+            kind: 'directory',
+            hidden: false,
+          },
+        ],
+        locations: [
+          { kind: 'desktop', path: '/Users/peiwang/Desktop' },
+          { kind: 'documents', path: '/Users/peiwang/Documents' },
+          { kind: 'downloads', path: '/Users/peiwang/Downloads' },
+          { kind: 'icloud-drive', path: '/Users/peiwang/Library/Mobile Documents/com~apple~CloudDocs' },
+          { kind: 'applications', path: '/Applications' },
+          { kind: 'volumes', path: '/Volumes' },
         ],
       },
       isLoading: false,
@@ -37,55 +94,248 @@ describe('ServerPathPickerDialog', () => {
 
   it('filters entries inside the current directory', async () => {
     const user = userEvent.setup();
-
-    render(
-      <ServerPathPickerDialog
-        open
-        currentPath="/workspace"
-        isSaving={false}
-        onOpenChange={() => {}}
-        onConfirm={() => {}}
-        title="选择目录"
-        description="选择一个目录"
-        pathLabel="目录"
-        confirmLabel="确定"
-      />
-    );
+    renderPicker();
 
     expect(screen.getByText('playground')).toBeTruthy();
     expect(screen.getByText('nextbot')).toBeTruthy();
 
-    await user.type(screen.getByPlaceholderText('搜索当前目录'), 'play');
+    await user.type(screen.getAllByPlaceholderText('搜索当前目录')[0], 'play');
 
     expect(screen.getByText('playground')).toBeTruthy();
     expect(screen.queryByText('nextbot')).toBeNull();
   });
 
-  it('shows the empty-search hint and keeps the list region scroll-contained', async () => {
+  it('shows server-backed Mac locations and opens sidebar locations with one click', async () => {
     const user = userEvent.setup();
-    render(
-      <ServerPathPickerDialog
-        open
-        currentPath="/workspace"
-        isSaving={false}
-        onOpenChange={() => {}}
-        onConfirm={() => {}}
-        title="选择目录"
-        description="选择一个目录"
-        pathLabel="目录"
-        confirmLabel="确定"
-      />
+    renderPicker();
+
+    expect(screen.getByRole('button', { name: '桌面' })).toBeTruthy();
+    expect(screen.getByRole('button', { name: '文稿' })).toBeTruthy();
+    expect(screen.getByRole('button', { name: '下载' })).toBeTruthy();
+    expect(screen.getByRole('button', { name: 'iCloud 云盘' })).toBeTruthy();
+    expect(screen.getByRole('button', { name: '应用程序' })).toBeTruthy();
+    expect(screen.getByRole('button', { name: '磁盘与卷' })).toBeTruthy();
+
+    await user.click(screen.getByRole('button', { name: '下载' }));
+
+    expect(mocks.useServerPathBrowse).toHaveBeenLastCalledWith({
+      path: '/Users/peiwang/Downloads',
+      enabled: true,
+    });
+  });
+
+  it('keeps the explicit current path when an older home browse result is still visible', () => {
+    mocks.useServerPathBrowse.mockReturnValue({
+      data: {
+        currentPath: '/Users/peiwang',
+        homePath: '/Users/peiwang',
+        parentPath: '/Users',
+        breadcrumbs: [
+          { label: 'Users', path: '/Users' },
+          { label: 'peiwang', path: '/Users/peiwang' },
+        ],
+        entries: [],
+      },
+      isLoading: false,
+      error: null,
+      refetch: mocks.refetch,
+    });
+
+    renderPicker({ currentPath: '/Users/peiwang/.nextclaw/workspace' });
+
+    expect((screen.getByLabelText('目录') as HTMLInputElement).value).toBe(
+      '/Users/peiwang/.nextclaw/workspace',
     );
+    expect(screen.getByText('/Users/peiwang/.nextclaw/workspace')).toBeTruthy();
+  });
+
+  it('starts at the workdir and keeps the canonical address and selected folder aligned', () => {
+    mocks.useServerPathBrowse.mockReturnValue({
+      data: {
+        currentPath: '/Users/peiwang/.nextclaw/workspace',
+        homePath: '/Users/peiwang',
+        parentPath: '/Users/peiwang/.nextclaw',
+        breadcrumbs: [
+          { label: '/', path: '/' },
+          { label: 'Users', path: '/Users' },
+          { label: 'peiwang', path: '/Users/peiwang' },
+          { label: '.nextclaw', path: '/Users/peiwang/.nextclaw' },
+          { label: 'workspace', path: '/Users/peiwang/.nextclaw/workspace' },
+        ],
+        entries: [],
+      },
+      isLoading: false,
+      error: null,
+      refetch: mocks.refetch,
+    });
 
-    await user.type(screen.getByPlaceholderText('搜索当前目录'), 'missing');
+    renderPicker({
+      currentPath: '',
+      defaultWorkspacePath: '~/.nextclaw/workspace',
+      description: undefined,
+    });
 
-    expect(screen.getByText('当前目录下没有匹配结果。')).toBeTruthy();
+    expect(mocks.useServerPathBrowse).toHaveBeenLastCalledWith({
+      path: '~/.nextclaw/workspace',
+      enabled: true,
+    });
+    expect((screen.getByLabelText('目录') as HTMLInputElement).value).toBe(
+      '/Users/peiwang/.nextclaw/workspace',
+    );
+    expect(screen.getByRole('button', { name: 'NextClaw 工作区' })).toBeTruthy();
+    expect(screen.getByText('workspace')).toBeTruthy();
+  });
+
+  it('normalizes a home-relative workdir with Windows separators', () => {
+    mocks.useServerPathBrowse.mockReturnValue({
+      data: {
+        currentPath: 'C:\\Users\\alice\\.nextclaw\\workspace',
+        homePath: 'C:\\Users\\alice',
+        parentPath: 'C:\\Users\\alice\\.nextclaw',
+        breadcrumbs: [
+          { label: 'C:', path: 'C:\\' },
+          { label: 'Users', path: 'C:\\Users' },
+          { label: 'alice', path: 'C:\\Users\\alice' },
+          { label: '.nextclaw', path: 'C:\\Users\\alice\\.nextclaw' },
+          { label: 'workspace', path: 'C:\\Users\\alice\\.nextclaw\\workspace' },
+        ],
+        entries: [],
+        locations: [],
+      },
+      isLoading: false,
+      error: null,
+      refetch: mocks.refetch,
+    });
+
+    renderPicker({ currentPath: '', defaultWorkspacePath: '~/.nextclaw/workspace' });
+
+    expect((screen.getByLabelText('目录') as HTMLInputElement).value).toBe(
+      'C:\\Users\\alice\\.nextclaw\\workspace',
+    );
+    expect(screen.getByText('workspace')).toBeTruthy();
+  });
+
+  it('creates a folder in the current directory and selects it without entering it', async () => {
+    const user = userEvent.setup();
+    renderPicker();
+
+    await user.click(screen.getByRole('button', { name: '新建文件夹' }));
+    await user.type(screen.getByLabelText('文件夹名称'), 'new-folder');
+    await user.click(screen.getByRole('button', { name: '创建' }));
+
+    expect(mocks.createDirectory).toHaveBeenCalledWith({
+      parentPath: '/workspace',
+      name: 'new-folder',
+    });
+    expect(mocks.refetch).toHaveBeenCalledOnce();
+    expect((screen.getByLabelText('目录') as HTMLInputElement).value).toBe(
+      '/workspace/new-folder',
+    );
+    expect((screen.getByRole('button', { name: '后退' }) as HTMLButtonElement).disabled).toBe(
+      true,
+    );
+  });
+
+  it('uses single click to select and double click to enter a folder', async () => {
+    const user = userEvent.setup();
+    renderPicker();
+    const playground = screen.getByRole('option', { name: /playground/ });
+
+    expect(screen.getByText('单击选择，双击进入')).toBeTruthy();
+
+    await user.click(playground);
+
+    expect((screen.getByLabelText('目录') as HTMLInputElement).value).toBe(
+      '/workspace/playground',
+    );
+    expect(mocks.useServerPathBrowse).toHaveBeenLastCalledWith({
+      path: '/workspace',
+      enabled: true,
+    });
+
+    await user.dblClick(playground);
+
+    expect(mocks.useServerPathBrowse).toHaveBeenLastCalledWith({
+      path: '/workspace/playground',
+      enabled: true,
+    });
+    expect((screen.getByRole('button', { name: '后退' }) as HTMLButtonElement).disabled).toBe(
+      false,
+    );
+  });
+
+  it('starts a fresh selection session when the dialog is reopened', async () => {
+    const user = userEvent.setup();
+    const view = renderPicker();
 
+    await user.click(screen.getByRole('option', { name: /playground/ }));
+    expect((screen.getByLabelText('目录') as HTMLInputElement).value).toBe(
+      '/workspace/playground',
+    );
+
+    view.rerender(createPickerElement({ open: false }));
+    view.rerender(createPickerElement());
+
+    expect((screen.getByLabelText('目录') as HTMLInputElement).value).toBe('/workspace');
+    expect((screen.getByRole('button', { name: '后退' }) as HTMLButtonElement).disabled).toBe(
+      true,
+    );
+  });
+
+  it('opens an editable address and records navigation history', async () => {
+    const user = userEvent.setup();
+    renderPicker();
+
+    await user.click(screen.getByRole('button', { name: '编辑地址' }));
+    const addressInput = screen.getByLabelText('地址');
+    await user.clear(addressInput);
+    await user.type(addressInput, '/workspace/playground{Enter}');
+
+    expect((screen.getByLabelText('目录') as HTMLInputElement).value).toBe(
+      '/workspace/playground',
+    );
+    expect((screen.getByRole('button', { name: '后退' }) as HTMLButtonElement).disabled).toBe(
+      false,
+    );
+
+    await user.click(screen.getByRole('button', { name: '后退' }));
+    expect((screen.getByLabelText('目录') as HTMLInputElement).value).toBe('/workspace');
+    expect((screen.getByRole('button', { name: '前进' }) as HTMLButtonElement).disabled).toBe(
+      false,
+    );
+  });
+
+  it('supports arrow selection and Enter navigation from the directory list', async () => {
+    const user = userEvent.setup();
+    renderPicker();
+    const playground = screen.getByRole('option', { name: /playground/ });
+
+    await user.click(playground);
+    await user.keyboard('{ArrowDown}');
+
+    expect((screen.getByLabelText('目录') as HTMLInputElement).value).toBe(
+      '/workspace/nextbot',
+    );
+    await user.keyboard('{Enter}');
+    expect(mocks.useServerPathBrowse).toHaveBeenLastCalledWith({
+      path: '/workspace/nextbot',
+      enabled: true,
+    });
+  });
+
+  it('shows the empty-search hint and keeps the list region scroll-contained', async () => {
+    const user = userEvent.setup();
+    renderPicker();
+
+    await user.type(screen.getAllByPlaceholderText('搜索当前目录')[0], 'missing');
+
+    expect(screen.getByText('当前目录下没有匹配结果。')).toBeTruthy();
     const dialog = screen.getByRole('dialog');
     expect(dialog.className).toContain('overflow-hidden');
-    expect(dialog.className).toContain('sm:h-[42rem]');
-
-    const scrollArea = screen.getByText('当前目录下没有匹配结果。').closest('.overflow-auto');
+    expect(dialog.className).toContain('sm:h-[44rem]');
+    const scrollArea = screen
+      .getByText('当前目录下没有匹配结果。')
+      .closest('.overflow-auto');
     expect(scrollArea?.className).toContain('flex-1');
     expect(scrollArea?.className).toContain('min-h-0');
   });