@nextclaw/ui 0.26.0 → 0.26.2

package/src/shared/components/ui/context-menu/context-menu.tsx

@@ -8,9 +8,11 @@ import {
   type MouseEvent,
   type ReactElement,
   type ReactNode,
-} from 'react';
-import { createPortal } from 'react-dom';
-import { cn } from '@/shared/lib/utils';
+} from "react";
+import { createPortal } from "react-dom";
+import { cn } from "@/shared/lib/utils";
+import { ContextMenuItems, CONTEXT_MENU_SURFACE_CLASS } from "./context-menu-items";
+export { ContextMenuItems } from "./context-menu-items";
 
 type ContextMenuItemBase = {
   key: string;
@@ -25,15 +27,23 @@ type ContextMenuItemBase = {
 export type ContextMenuItem = ContextMenuItemBase &
   (
     | {
+        children?: never;
         download?: string;
         href: string;
         onSelect?: () => void;
       }
     | {
+        children?: never;
         download?: never;
         href?: never;
         onSelect: () => void;
       }
+    | {
+        children: readonly ContextMenuGroup[];
+        download?: never;
+        href?: never;
+        onSelect?: never;
+      }
   );
 
 export type ContextMenuGroup = {
@@ -42,7 +52,7 @@ export type ContextMenuGroup = {
 };
 
 type ContextMenuPosition = {
-  align: 'start' | 'end';
+  align: "start" | "end";
   x: number;
   y: number;
   trigger: HTMLElement;
@@ -53,10 +63,18 @@ type ContextMenuController = {
   toggleFromButton: (trigger: HTMLElement) => void;
 };
 
-const ContextMenuControllerContext = createContext<ContextMenuController | null>(null);
+const ContextMenuControllerContext =
+  createContext<ContextMenuController | null>(null);
 
 const CONTEXT_MENU_EDGE_GAP = 8;
 
+/** Radix dismisses overlays during capture, before the inner menu handles Escape. */
+export function deferEscapeToNestedMenu(event: KeyboardEvent): boolean {
+  if (!(event.target instanceof Element) || !event.target.closest('[data-menu-escape-owner]')) return false;
+  event.preventDefault();
+  return true;
+}
+
 function ContextMenuSurface({
   groups,
   label,
@@ -70,7 +88,8 @@ function ContextMenuSurface({
 }) {
   const menuRef = useRef<HTMLDivElement | null>(null);
   // Keep modal menus inside the dialog's focus and pointer-event boundary.
-  const portalHost = position.trigger.closest<HTMLElement>('[role="dialog"]') ?? document.body;
+  const portalHost =
+    position.trigger.closest<HTMLElement>('[role="dialog"]') ?? document.body;
   const isModal = portalHost !== document.body;
 
   useLayoutEffect(() => {
@@ -78,124 +97,77 @@ function ContextMenuSurface({
     if (!menu) {
       return;
     }
-    const bounds = isModal ? portalHost.getBoundingClientRect() : { left: 0, top: 0, right: window.innerWidth, bottom: window.innerHeight, height: window.innerHeight };
-    menu.style.maxHeight = `${Math.max(0, bounds.height - CONTEXT_MENU_EDGE_GAP * 2)}px`;
-    const rect = menu.getBoundingClientRect();
-    const preferredLeft = position.align === 'end' ? position.x - rect.width : position.x;
-    const left = Math.max(
-      bounds.left + CONTEXT_MENU_EDGE_GAP,
-      Math.min(preferredLeft, bounds.right - rect.width - CONTEXT_MENU_EDGE_GAP),
-    );
-    const top = Math.max(
-      bounds.top + CONTEXT_MENU_EDGE_GAP,
-      Math.min(position.y, bounds.bottom - rect.height - CONTEXT_MENU_EDGE_GAP),
-    );
-    menu.style.left = `${left - bounds.left}px`;
-    menu.style.top = `${top - bounds.top}px`;
-    menu.querySelector<HTMLElement>('[role="menuitem"]:not(:disabled)')?.focus();
+    const reposition = () => {
+      const bounds = isModal
+        ? portalHost.getBoundingClientRect()
+        : {
+            left: 0,
+            top: 0,
+            right: window.innerWidth,
+            bottom: window.innerHeight,
+            height: window.innerHeight,
+          };
+      menu.style.maxHeight = `${Math.max(0, bounds.height - CONTEXT_MENU_EDGE_GAP * 2)}px`;
+      const rect = menu.getBoundingClientRect();
+      const preferredLeft =
+        position.align === "end" ? position.x - rect.width : position.x;
+      const left = Math.max(
+        bounds.left + CONTEXT_MENU_EDGE_GAP,
+        Math.min(
+          preferredLeft,
+          bounds.right - rect.width - CONTEXT_MENU_EDGE_GAP,
+        ),
+      );
+      const top = Math.max(
+        bounds.top + CONTEXT_MENU_EDGE_GAP,
+        Math.min(
+          position.y,
+          bounds.bottom - rect.height - CONTEXT_MENU_EDGE_GAP,
+        ),
+      );
+      menu.style.left = `${left - bounds.left}px`;
+      menu.style.top = `${top - bounds.top}px`;
+    };
+    reposition();
+    menu
+      .querySelector<HTMLElement>('[role="menuitem"]:not(:disabled)')
+      ?.focus();
+    const observer = new ResizeObserver(reposition);
+    observer.observe(menu);
+    return () => observer.disconnect();
   }, [position, portalHost, isModal]);
 
-  const moveFocus = (direction: 1 | -1) => {
-    const items = Array.from(menuRef.current?.querySelectorAll<HTMLElement>('[role="menuitem"]:not(:disabled)') ?? []);
-    if (items.length === 0) {
-      return;
-    }
-    const currentIndex = items.indexOf(document.activeElement as HTMLElement);
-    const nextIndex = currentIndex < 0 ? 0 : (currentIndex + direction + items.length) % items.length;
-    items[nextIndex]?.focus();
-  };
-
   return createPortal(
     <div
-      className={cn("pointer-events-auto inset-0 z-[var(--z-tooltip)]", isModal ? "absolute" : "fixed")}
+      className={cn(
+        "pointer-events-auto inset-0 z-[var(--z-tooltip)]",
+        isModal ? "absolute" : "fixed",
+      )}
+      data-context-menu-layer=""
       onContextMenu={(event) => event.preventDefault()}
       onPointerDown={() => onClose(true)}
     >
       <div
         ref={menuRef}
         role="menu"
+        data-menu-escape-owner=""
         data-theme-overlay="menu"
         aria-label={label}
-        className={cn("min-w-52 max-w-72 overflow-y-auto rounded-xl border border-border bg-popover p-1 text-popover-foreground shadow-[0_18px_48px_-20px_rgba(15,23,42,0.42)]", isModal ? "absolute" : "fixed")}
+        className={cn(
+          CONTEXT_MENU_SURFACE_CLASS,
+          isModal ? "absolute" : "fixed",
+        )}
         style={{ left: position.x, top: position.y }}
         onPointerDown={(event) => event.stopPropagation()}
         onKeyDown={(event) => {
-          if (event.key === 'Escape') {
+          if (event.key === "Escape") {
             event.preventDefault();
             event.stopPropagation();
             onClose(true);
-          } else if (event.key === 'ArrowDown') {
-            event.preventDefault();
-            moveFocus(1);
-          } else if (event.key === 'ArrowUp') {
-            event.preventDefault();
-            moveFocus(-1);
-          } else if (event.key === 'Home' || event.key === 'End') {
-            event.preventDefault();
-            const items = menuRef.current?.querySelectorAll<HTMLElement>('[role="menuitem"]:not(:disabled)');
-            items?.[event.key === 'Home' ? 0 : items.length - 1]?.focus();
           }
         }}
       >
-        {groups.map((group, groupIndex) => (
-          <div key={group.key} role="group">
-            {groupIndex > 0 ? <div className="my-1 h-px bg-border" /> : null}
-            {group.items.map((item) => {
-              const itemClassName = cn(
-                'flex h-8 w-full items-center gap-2 rounded-lg px-2.5 text-left text-[13px] font-medium outline-none transition-colors',
-                item.destructive
-                  ? 'text-destructive hover:bg-destructive/10 focus-visible:bg-destructive/10'
-                  : 'text-foreground hover:bg-muted focus-visible:bg-muted',
-                'disabled:pointer-events-none disabled:opacity-45',
-              );
-              const content = (
-                <>
-                  {item.icon ? (
-                    <span
-                      className={cn(
-                        'inline-flex h-4 w-4 shrink-0 items-center justify-center',
-                        item.destructive ? 'text-destructive' : 'text-muted-foreground',
-                      )}
-                    >
-                      {item.icon}
-                    </span>
-                  ) : null}
-                  <span className="min-w-0 flex-1 truncate">{item.label}</span>
-                </>
-              );
-              return item.href ? (
-                <a
-                  key={item.key}
-                  role="menuitem"
-                  className={itemClassName}
-                  href={item.href}
-                  download={item.download}
-                  onClick={() => {
-                    item.onSelect?.();
-                    onClose(false);
-                  }}
-                >
-                  {content}
-                </a>
-              ) : (
-                <button
-                  key={item.key}
-                  type="button"
-                  role="menuitem"
-                  disabled={item.disabled}
-                  aria-pressed={item.pressed}
-                  className={itemClassName}
-                  onClick={() => {
-                    item.onSelect?.();
-                    onClose(item.restoreFocus !== false);
-                  }}
-                >
-                  {content}
-                </button>
-              );
-            })}
-          </div>
-        ))}
+        <ContextMenuItems groups={groups} onClose={onClose} />
       </div>
     </div>,
     portalHost,
@@ -208,7 +180,7 @@ export function ContextMenu({
   label,
 }: {
   children: ReactElement<{
-    'data-context-menu-open'?: string;
+    "data-context-menu-open"?: string;
     onContextMenu?: (event: MouseEvent) => void;
   }>;
   groups: readonly ContextMenuGroup[];
@@ -234,7 +206,7 @@ export function ContextMenu({
     }
     const bounds = trigger.getBoundingClientRect();
     setPosition({
-      align: 'end',
+      align: "end",
       x: bounds.right,
       y: bounds.bottom,
       trigger,
@@ -242,7 +214,7 @@ export function ContextMenu({
   };
 
   const child = cloneElement(children, {
-    'data-context-menu-open': position ? '' : undefined,
+    "data-context-menu-open": position ? "" : undefined,
     onContextMenu: (event: MouseEvent) => {
       children.props.onContextMenu?.(event);
       if (event.defaultPrevented || visibleGroups.length === 0) {
@@ -252,7 +224,7 @@ export function ContextMenu({
       const trigger = event.currentTarget as HTMLElement;
       const bounds = trigger.getBoundingClientRect();
       setPosition({
-        align: 'start',
+        align: "start",
         x: event.clientX || bounds.left,
         y: event.clientY || bounds.bottom,
         trigger,
@@ -261,10 +233,17 @@ export function ContextMenu({
   });
 
   return (
-    <ContextMenuControllerContext.Provider value={{ isOpen: Boolean(position), toggleFromButton }}>
+    <ContextMenuControllerContext.Provider
+      value={{ isOpen: Boolean(position), toggleFromButton }}
+    >
       {child}
       {position ? (
-        <ContextMenuSurface groups={visibleGroups} label={label} position={position} onClose={closeMenu} />
+        <ContextMenuSurface
+          groups={visibleGroups}
+          label={label}
+          position={position}
+          onClose={closeMenu}
+        />
       ) : null}
     </ContextMenuControllerContext.Provider>
   );
@@ -274,19 +253,19 @@ export function ContextMenuTrigger({
   children,
 }: {
   children: ReactElement<{
-    'aria-expanded'?: boolean;
-    'aria-haspopup'?: 'menu';
+    "aria-expanded"?: boolean;
+    "aria-haspopup"?: "menu";
     onClick?: (event: MouseEvent) => void;
   }>;
 }) {
   const controller = useContext(ContextMenuControllerContext);
   if (!controller) {
-    throw new Error('ContextMenuTrigger must be rendered inside ContextMenu');
+    throw new Error("ContextMenuTrigger must be rendered inside ContextMenu");
   }
 
   return cloneElement(children, {
-    'aria-expanded': controller.isOpen,
-    'aria-haspopup': 'menu',
+    "aria-expanded": controller.isOpen,
+    "aria-haspopup": "menu",
     onClick: (event: MouseEvent) => {
       children.props.onClick?.(event);
       if (event.defaultPrevented) {

package/src/shared/components/ui/dialog.tsx

@@ -3,6 +3,7 @@ import * as DialogPrimitive from "@radix-ui/react-dialog"
 import { X } from "lucide-react"
 
 import { cn } from "@/shared/lib/utils"
+import { deferEscapeToNestedMenu } from './context-menu/context-menu';
 
 const Dialog = DialogPrimitive.Root
 
@@ -42,6 +43,9 @@ const DialogContent = React.forwardRef<
         className
       )}
       {...props}
+      onEscapeKeyDown={(event) => {
+        if (!deferEscapeToNestedMenu(event)) props.onEscapeKeyDown?.(event);
+      }}
     >
       {children}
       <DialogPrimitive.Close className="absolute right-4 top-4 rounded-lg p-1 opacity-70 transition-all duration-fast hover:bg-[var(--interaction-hover)] hover:text-accent-foreground hover:opacity-100 focus:outline-none focus-visible:ring-1 focus-visible:ring-border disabled:pointer-events-none">

package/src/shared/components/ui/overlays/sheet.tsx

@@ -4,6 +4,7 @@ import { cva, type VariantProps } from "class-variance-authority";
 import { X } from "lucide-react";
 
 import { cn } from "@/shared/lib/utils";
+import { deferEscapeToNestedMenu } from '@/shared/components/ui/context-menu/context-menu';
 
 const Sheet = SheetPrimitive.Root;
 const SheetTrigger = SheetPrimitive.Trigger;
@@ -63,6 +64,9 @@ const SheetContent = React.forwardRef<
       data-theme-overlay="sheet"
       className={cn(sheetVariants({ side }), className)}
       {...props}
+      onEscapeKeyDown={(event) => {
+        if (!deferEscapeToNestedMenu(event)) props.onEscapeKeyDown?.(event);
+      }}
     >
       {children}
       <SheetPrimitive.Close className="absolute right-4 top-4 rounded-lg p-1.5 text-muted-foreground opacity-75 transition-colors hover:bg-muted hover:text-foreground hover:opacity-100 focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-border disabled:pointer-events-none">

package/src/shared/components/ui/popover.tsx

@@ -2,6 +2,8 @@ import * as React from 'react';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
 
 import { cn } from '@/shared/lib/utils';
+import { deferEscapeToNestedMenu } from './context-menu/context-menu';
+import { CONTEXT_MENU_SURFACE_CLASS } from './context-menu/context-menu-items';
 
 const FLOATING_CONTENT_AVAILABLE_HEIGHT_GAP = '2rem';
 
@@ -19,21 +21,25 @@ const PopoverAnchor = PopoverPrimitive.Anchor;
 
 const PopoverContent = React.forwardRef<
   React.ElementRef<typeof PopoverPrimitive.Content>,
-  React.ComponentPropsWithoutRef<typeof PopoverPrimitive.Content>
->(({ className, sideOffset = 8, align = 'start', collisionPadding = 12, style, ...props }, ref) => (
+  React.ComponentPropsWithoutRef<typeof PopoverPrimitive.Content> & { variant?: 'default' | 'menu' }
+>(({ className, variant = 'default', sideOffset = 8, align = 'start', collisionPadding = 12, style, ...props }, ref) => (
   <PopoverPrimitive.Portal>
     <PopoverPrimitive.Content
       ref={ref}
-      data-theme-overlay="popover"
+      data-theme-overlay={variant === 'menu' ? 'menu' : 'popover'}
       sideOffset={sideOffset}
       align={align}
       collisionPadding={collisionPadding}
       className={cn(
         'z-[var(--z-popover,10100)] w-72 overflow-x-hidden overflow-y-auto rounded-2xl border border-border bg-popover p-4 text-popover-foreground shadow-lg animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2',
-        className
+        className,
+        variant === 'menu' && CONTEXT_MENU_SURFACE_CLASS
       )}
       style={{ maxHeight: POPOVER_CONTENT_MAX_HEIGHT, ...style }}
       {...props}
+      onEscapeKeyDown={(event) => {
+        if (!deferEscapeToNestedMenu(event)) props.onEscapeKeyDown?.(event);
+      }}
     />
   </PopoverPrimitive.Portal>
 ));

package/src/shared/lib/i18n/locales/en-US/chat.json

@@ -1,4 +1,5 @@
 {
+  "pageLayoutActions": "Layout and position",
   "pagePinLeft": "Pin to left sidebar",
   "pageUnpinLeft": "Unpin from left sidebar",
   "pageCopyUri": "Copy resource link",
@@ -281,7 +282,12 @@
   "chatHistoryLoadFailed": "Couldn’t load earlier messages",
   "chatHistoryRetry": "Retry",
   "chatProcessSummaryProcessed": "Processed",
-  "chatProcessSummaryToolCalls": "{count} tool calls",
+  "chatProcessSummaryError": "Failed",
+  "chatProcessSummaryStopped": "Stopped",
+  "chatProcessDurationHoursMinutes": "{hours}h {minutes}m",
+  "chatProcessDurationHours": "{hours}h",
+  "chatProcessDurationMinutesSeconds": "{minutes}m {seconds}s",
+  "chatProcessDurationSeconds": "{seconds}s",
   "chatToolPayloadLoading": "Loading details",
   "chatToolPayloadLoadFailed": "Couldn’t load details. Try again",
   "chatToolActivityShowMore": "Show next {count} ({remaining} remaining)",
@@ -692,6 +698,7 @@
   "chatInputVoiceNoDevice": "No microphone was detected. Connect or enable an input device, then check again.",
   "chatInputVoiceDeviceBusy": "The microphone cannot be read. Another app or a system restriction may be preventing access. Close other recording apps, check your input device and retry.",
   "chatInputVoiceServiceDenied": "The browser denied access to speech recognition. Check its speech service settings or organization policy, or use a browser that supports speech recognition.",
+  "chatInputVoiceInsecureContext": "This page is using an insecure HTTP address, so the browser disables microphone access. Configure HTTPS for a VPS; localhost or 127.0.0.1 is available only for access from the same machine.",
   "chatInputVoiceUnsupported": "Speech input is not supported in this browser.",
   "chatInputVoiceNoSpeech": "Could not hear you. Please try again.",
   "chatInputVoiceFailed": "Voice input failed. Please try again.",

package/src/shared/lib/i18n/locales/en-US/core.json

@@ -13,7 +13,9 @@
   "advanced": "Advanced",
   "settings": "Settings",
   "settingsGroupBasic": "Basic Configuration",
-  "settingsGroupAdvanced": "Advanced Configuration",
+  "settingsGroupCommon": "Common Settings",
+  "settingsGroupSecurity": "Security & Privacy",
+  "settingsGroupSystem": "System & Extensions",
   "appearance": "Appearance",
   "keyboardShortcuts": "Keyboard shortcuts",
   "keyboardShortcutsDesktopOnly": "Keyboard shortcuts can be configured on desktop. Use the microphone button on mobile.",

package/src/shared/lib/i18n/locales/en-US/desktop-update.json

@@ -63,6 +63,7 @@
   "desktopUpdatesDownloadProgressUnknown": "Downloading",
   "desktopUpdatesBlockedTitle": "Update Blocked",
   "desktopUpdatesBlockedDescription": "Resolve the current installation requirement before continuing the update.",
+  "desktopUpdatesManualPortableDownload": "Download Latest Portable Edition",
   "desktopUpdatesBlockedRootCause.signature-verification-unavailable": "Root cause: missing update public key; install a configured build or ask the maintainer to set the key.",
   "desktopUpdatesBlockedRootCause.host-too-old": "Root cause: the host is too old for this runtime bundle; upgrade the NextClaw launcher first.",
   "desktopUpdatesBlockedRootCause.unsupported-installation": "Root cause: this installation or update source does not support auto-update; use a configured build.",

package/src/shared/lib/i18n/locales/zh-CN/chat.json

@@ -1,4 +1,5 @@
 {
+  "pageLayoutActions": "布局与位置",
   "pagePinLeft": "固定到左侧页面",
   "pageUnpinLeft": "从左侧页面移除",
   "pageCopyUri": "复制资源链接",
@@ -281,7 +282,12 @@
   "chatHistoryLoadFailed": "较早消息加载失败",
   "chatHistoryRetry": "重试",
   "chatProcessSummaryProcessed": "已处理",
-  "chatProcessSummaryToolCalls": "{count} 次工具调用",
+  "chatProcessSummaryError": "处理失败",
+  "chatProcessSummaryStopped": "已停止",
+  "chatProcessDurationHoursMinutes": "{hours}小时{minutes}分钟",
+  "chatProcessDurationHours": "{hours}小时",
+  "chatProcessDurationMinutesSeconds": "{minutes}分钟{seconds}秒",
+  "chatProcessDurationSeconds": "{seconds}秒",
   "chatToolPayloadLoading": "正在加载详情",
   "chatToolPayloadLoadFailed": "详情加载失败，点击重试",
   "chatToolActivityShowMore": "继续显示 {count} 项（剩余 {remaining} 项）",
@@ -692,6 +698,7 @@
   "chatInputVoiceNoDevice": "没有检测到麦克风。请连接或启用输入设备，再检测重试。",
   "chatInputVoiceDeviceBusy": "麦克风无法读取，可能被其他应用占用或被系统限制。请关闭其他录音应用，检查输入设备后重试。",
   "chatInputVoiceServiceDenied": "浏览器拒绝了语音识别服务。请检查浏览器的语音服务设置或组织策略，或使用支持语音识别的浏览器。",
+  "chatInputVoiceInsecureContext": "当前页面通过不安全的 HTTP 地址打开，浏览器会禁用麦克风。请为 VPS 配置 HTTPS；仅在本机访问时可使用 localhost 或 127.0.0.1。",
   "chatInputVoiceUnsupported": "当前浏览器不支持语音输入。",
   "chatInputVoiceNoSpeech": "没有听清，请再试一次。",
   "chatInputVoiceFailed": "语音输入失败，请重试。",

package/src/shared/lib/i18n/locales/zh-CN/core.json

@@ -3,7 +3,7 @@
   "model": "模型",
   "searchChannels": "搜索渠道",
   "providers": "提供商",
-  "extensions": "Extensions",
+  "extensions": "扩展",
   "channels": "渠道",
   "cron": "定时任务",
   "secrets": "密钥管理",
@@ -13,7 +13,9 @@
   "advanced": "高级",
   "settings": "设置",
   "settingsGroupBasic": "基础配置",
-  "settingsGroupAdvanced": "高级配置",
+  "settingsGroupCommon": "常用设置",
+  "settingsGroupSecurity": "安全与隐私",
+  "settingsGroupSystem": "系统与扩展",
   "appearance": "外观",
   "keyboardShortcuts": "快捷键",
   "keyboardShortcutsDesktopOnly": "请在桌面端配置键盘快捷键。手机可使用麦克风按钮输入。",
@@ -139,15 +141,15 @@
   "providersDefaultDescription": "为你的智能体配置 AI 服务",
   "providersEmptyTitle": "尚未配置提供商",
   "providersEmptyDescription": "添加一个 AI 提供商后即可开始使用。",
-  "extensionsPageTitle": "Extensions 管理",
-  "extensionsPageDescription": "查看已发现的 Extension、能力和当前运行状态。",
+  "extensionsPageTitle": "扩展管理",
+  "extensionsPageDescription": "查看已发现的扩展、能力和当前运行状态。",
   "extensionsRefresh": "刷新",
-  "extensionsLifecycleDescription": "Extension 由运行时按渠道和会话持续关注关系按需启停；这里集中查看全局能力和运行状态。",
-  "extensionsLoading": "正在加载 Extensions…",
-  "extensionsLoadFailed": "Extensions 加载失败。",
+  "extensionsLifecycleDescription": "扩展由运行时按渠道和会话持续关注关系按需启停；这里集中查看全局能力和运行状态。",
+  "extensionsLoading": "正在加载扩展…",
+  "extensionsLoadFailed": "扩展加载失败。",
   "extensionsRetry": "重试",
-  "extensionsEmpty": "暂无已发现的 Extension",
-  "extensionsEmptyDescription": "安装或放置 Extension 后，重新刷新此页面。",
+  "extensionsEmpty": "暂无已发现的扩展",
+  "extensionsEmptyDescription": "安装或放置扩展后，重新刷新此页面。",
   "extensionsTotal": "全部",
   "extensionsRunning": "运行中",
   "extensionsWithObservations": "支持持续关注",

package/src/shared/lib/i18n/locales/zh-CN/desktop-update.json

@@ -63,6 +63,7 @@
   "desktopUpdatesDownloadProgressUnknown": "正在下载",
   "desktopUpdatesBlockedTitle": "更新暂时无法继续",
   "desktopUpdatesBlockedDescription": "当前安装环境需要先处理阻塞项，之后才能继续更新。",
+  "desktopUpdatesManualPortableDownload": "下载最新 Portable Edition",
   "desktopUpdatesBlockedRootCause.signature-verification-unavailable": "根因：缺少更新签名公钥，无法验证更新包来源；请安装包含正确更新配置的新版本，或由维护者配置更新公钥。",
   "desktopUpdatesBlockedRootCause.host-too-old": "根因：当前宿主版本太旧，不满足新运行包的最低宿主版本要求；请先升级 NextClaw 启动器。",
   "desktopUpdatesBlockedRootCause.unsupported-installation": "根因：当前安装形态或更新源配置不支持自动更新；请安装支持自动更新的版本，或由维护者补齐更新源配置。",

package/src/shared/lib/transport/__tests__/browser-realtime-recovery.service.test.ts

@@ -1,12 +1,17 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { BrowserRealtimeRecoveryService } from '@/shared/lib/transport/browser-realtime-recovery.service';
 
 describe('BrowserRealtimeRecoveryService', () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+  });
+
   afterEach(() => {
     vi.restoreAllMocks();
+    vi.useRealTimers();
   });
 
-  it('requests recovery only when the page can actively reconnect', () => {
+  it('requests recovery for every supported foreground lifecycle signal', () => {
     let visibilityState: DocumentVisibilityState = 'hidden';
     vi.spyOn(document, 'visibilityState', 'get').mockImplementation(() => visibilityState);
     const requestRecovery = vi.fn();
@@ -18,11 +23,19 @@ describe('BrowserRealtimeRecoveryService', () => {
 
     visibilityState = 'visible';
     document.dispatchEvent(new Event('visibilitychange'));
+    window.dispatchEvent(new PageTransitionEvent('pageshow', { persisted: true }));
+    window.dispatchEvent(new Event('focus'));
     window.dispatchEvent(new Event('online'));
+    expect(requestRecovery).toHaveBeenCalledTimes(1);
+
+    vi.advanceTimersByTime(250);
+    window.dispatchEvent(new PageTransitionEvent('pageshow', { persisted: true }));
     expect(requestRecovery).toHaveBeenCalledTimes(2);
 
     recovery.stop();
     document.dispatchEvent(new Event('visibilitychange'));
+    window.dispatchEvent(new PageTransitionEvent('pageshow', { persisted: true }));
+    window.dispatchEvent(new Event('focus'));
     expect(requestRecovery).toHaveBeenCalledTimes(2);
   });
 
@@ -39,4 +52,16 @@ describe('BrowserRealtimeRecoveryService', () => {
     recovery.stop();
     recovery.stop();
   });
+
+  it('does not replace the first connection for an ordinary initial pageshow', () => {
+    vi.spyOn(document, 'visibilityState', 'get').mockReturnValue('visible');
+    const requestRecovery = vi.fn();
+    const recovery = new BrowserRealtimeRecoveryService(requestRecovery);
+
+    recovery.start();
+    window.dispatchEvent(new PageTransitionEvent('pageshow', { persisted: false }));
+
+    expect(requestRecovery).not.toHaveBeenCalled();
+    recovery.stop();
+  });
 });

package/src/shared/lib/transport/__tests__/local-transport.service.test.ts

@@ -38,11 +38,13 @@ class MockWebSocket {
 describe('LocalAppTransport browser connection recovery', () => {
   beforeEach(() => {
     MockWebSocket.instances = [];
+    vi.useFakeTimers();
     vi.stubGlobal('WebSocket', MockWebSocket as unknown as typeof WebSocket);
   });
 
   afterEach(() => {
     vi.restoreAllMocks();
+    vi.useRealTimers();
     vi.unstubAllGlobals();
   });
 
@@ -70,6 +72,7 @@ describe('LocalAppTransport browser connection recovery', () => {
 
     expect(MockWebSocket.instances).toHaveLength(2);
     expect(handler).toHaveBeenLastCalledWith({ type: 'connection.open', payload: {} });
+    vi.advanceTimersByTime(250);
     window.dispatchEvent(new Event('online'));
     const secondReplacement = MockWebSocket.instances[2];
     secondReplacement?.open();
@@ -82,4 +85,21 @@ describe('LocalAppTransport browser connection recovery', () => {
     window.dispatchEvent(new Event('online'));
     expect(MockWebSocket.instances).toHaveLength(3);
   });
+
+  it('replaces a frozen connecting socket when the page regains focus', () => {
+    vi.spyOn(document, 'visibilityState', 'get').mockReturnValue('visible');
+    const transport = new LocalAppTransport({ apiBase: 'https://vps.example.com' });
+    const handler = vi.fn();
+    const unsubscribe = transport.subscribe(handler);
+    const frozenSocket = MockWebSocket.instances[0];
+
+    window.dispatchEvent(new Event('focus'));
+
+    expect(frozenSocket?.close).toHaveBeenCalledTimes(1);
+    expect(MockWebSocket.instances).toHaveLength(2);
+    expect(handler).toHaveBeenCalledWith({ type: 'connection.close', payload: {} });
+    MockWebSocket.instances[1]?.open();
+    expect(handler).toHaveBeenLastCalledWith({ type: 'connection.open', payload: {} });
+    unsubscribe();
+  });
 });