@nextclaw/ui 0.13.12 → 0.13.13

package/src/features/marketplace/components/marketplace-page.tsx

@@ -42,6 +42,7 @@ import {
   MarketplaceCuratedSceneView,
   MarketplaceCuratedShelves,
 } from "@/features/marketplace/components/curated-shelves/marketplace-curated-shelves";
+import { MarketplaceExternalSkillSourceAction } from "@/features/marketplace/components/marketplace-external-skill-source-action";
 import { useMarketplaceCuratedSceneRoute } from "@/features/marketplace/hooks/use-marketplace-curated-scene-route";
 import { t } from "@/shared/lib/i18n";
 import { PageLayout } from "@/app/components/layout/page-layout";
@@ -73,6 +74,8 @@ function getMarketplaceCopyKeys() {
     emptyData: "marketplaceNoSkills",
     emptyInstalled: "marketplaceNoInstalledSkills",
     installedCountSuffix: "marketplaceInstalledSkillsCountSuffix",
+    allSkills: "marketplaceAllSkills",
+    refreshingResults: "marketplaceRefreshingResults",
   };
 }
 
@@ -201,6 +204,12 @@ export function MarketplacePage(props: MarketplacePageProps = {}) {
   };
   const showListSkeleton =
     skeletonState.showCatalog || skeletonState.showInstalled;
+  const isRefreshingList =
+    scope === "all" &&
+    !showListSkeleton &&
+    Boolean(itemsQuery.data) &&
+    itemsQuery.isFetching &&
+    !itemsQuery.isFetchingNextPage;
 
   const listSummary = useMemo(() => {
     if (scope === "installed") {
@@ -424,23 +433,27 @@ export function MarketplacePage(props: MarketplacePageProps = {}) {
     <PageLayout className="flex h-full min-h-0 flex-col pb-0">
       {!curatedSceneRoute.isSceneRoute && (
         <>
-          <Tabs
-            tabs={[
-              { id: "all", label: t(copyKeys.tabMarketplace) },
-              {
-                id: "installed",
-                label: t(copyKeys.tabInstalled),
-                count: installedQuery.data?.total ?? 0,
-              },
-            ]}
-            activeTab={scope}
-            onChange={(value) => setScope(value as ScopeType)}
-            className="mb-3"
-          />
+          <div className="mb-3 flex items-start justify-between gap-3 border-b border-gray-200/60">
+            <Tabs
+              tabs={[
+                { id: "all", label: t(copyKeys.tabMarketplace) },
+                {
+                  id: "installed",
+                  label: t(copyKeys.tabInstalled),
+                  count: installedQuery.data?.total ?? 0,
+                },
+              ]}
+              activeTab={scope}
+              onChange={(value) => setScope(value as ScopeType)}
+              className="mb-0 flex-1 border-b-0"
+            />
+            <MarketplaceExternalSkillSourceAction />
+          </div>
 
           <FilterPanel
             scope={scope}
             searchText={searchText}
+            isRefreshing={isRefreshingList}
             searchPlaceholder={t(copyKeys.searchPlaceholder)}
             sort={sort}
             onSearchTextChange={setSearchText}
@@ -457,9 +470,16 @@ export function MarketplacePage(props: MarketplacePageProps = {}) {
               <h3 className="text-[14px] font-semibold text-gray-900">
                 {scope === "installed"
                   ? t(copyKeys.sectionInstalled)
-                  : language.startsWith("zh") ? "全部技能" : "All Skills"}
+                  : t(copyKeys.allSkills)}
               </h3>
-              <span className="text-[12px] text-gray-500">{listSummary}</span>
+              <div className="flex items-center gap-2 text-[12px] text-gray-500">
+                {isRefreshingList && (
+                  <span className="font-medium text-primary">
+                    {t(copyKeys.refreshingResults)}
+                  </span>
+                )}
+                <span>{listSummary}</span>
+              </div>
             </div>
           )}
 
@@ -515,11 +535,13 @@ export function MarketplacePage(props: MarketplacePageProps = {}) {
               title={
                 scope === "installed"
                   ? t(copyKeys.sectionInstalled)
-                  : language.startsWith("zh") ? "全部技能" : "All Skills"
+                  : t(copyKeys.allSkills)
               }
               summary={listSummary}
+              refreshingLabel={t(copyKeys.refreshingResults)}
               showTitle={curatedSceneRoute.showShelves}
               showListSkeleton={showListSkeleton}
+              isRefreshing={isRefreshingList}
               skeletonCardCount={SKELETON_CARD_COUNT}
               allItems={allItems}
               installedEntries={installedEntries}

package/src/features/marketplace/components/mcp/mcp-marketplace-page.tsx

@@ -288,6 +288,7 @@ export function McpMarketplacePage() {
             <FilterPanel
               scope={scope === "catalog" ? "all" : "installed"}
               searchText={searchText}
+              isRefreshing={false}
               searchPlaceholder={t("marketplaceMcpSearchPlaceholder")}
               sort={sort}
               onSearchTextChange={setSearchText}

package/src/features/marketplace/hooks/use-marketplace.test.tsx

@@ -0,0 +1,109 @@
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { renderHook, waitFor } from "@testing-library/react";
+import type { ReactNode } from "react";
+import { useMarketplaceItems } from "@/features/marketplace/hooks/use-marketplace";
+import type { MarketplaceListView } from "@/shared/lib/api";
+
+const mocks = vi.hoisted(() => ({
+  fetchMarketplaceItems: vi.fn(),
+}));
+
+vi.mock("@/shared/lib/api", async () => {
+  const actual = await vi.importActual("@/shared/lib/api");
+  return {
+    ...(actual as object),
+    fetchMarketplaceItems: mocks.fetchMarketplaceItems,
+  };
+});
+
+function createMarketplaceList(name: string): MarketplaceListView {
+  return {
+    total: 1,
+    page: 1,
+    pageSize: 20,
+    totalPages: 1,
+    sort: "relevance",
+    items: [
+      {
+        id: name,
+        slug: name,
+        type: "skill",
+        name,
+        summary: name,
+        summaryI18n: { en: name },
+        tags: [],
+        author: "NextClaw",
+        install: {
+          kind: "marketplace",
+          spec: `@nextclaw/${name}`,
+          command: `nextclaw skills install @nextclaw/${name}`,
+        },
+        updatedAt: "2026-06-08T00:00:00.000Z",
+      },
+    ],
+  };
+}
+
+function createWrapper() {
+  const queryClient = new QueryClient({
+    defaultOptions: {
+      queries: {
+        retry: false,
+      },
+    },
+  });
+
+  return function Wrapper({ children }: { children: ReactNode }) {
+    return (
+      <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
+    );
+  };
+}
+
+describe("useMarketplaceItems", () => {
+  beforeEach(() => {
+    mocks.fetchMarketplaceItems.mockReset();
+  });
+
+  it("keeps previous marketplace items while search results refresh", async () => {
+    let resolveSearch:
+      | ((value: MarketplaceListView) => void)
+      | undefined;
+    mocks.fetchMarketplaceItems
+      .mockResolvedValueOnce(createMarketplaceList("Initial Skill"))
+      .mockReturnValueOnce(
+        new Promise<MarketplaceListView>((resolve) => {
+          resolveSearch = resolve;
+        }),
+      );
+
+    const { result, rerender } = renderHook(
+      ({ q }: { q?: string }) =>
+        useMarketplaceItems({
+          type: "skill",
+          q,
+          sort: "relevance",
+          pageSize: 20,
+        }),
+      {
+        initialProps: {},
+        wrapper: createWrapper(),
+      },
+    );
+
+    await waitFor(() => {
+      expect(result.current.data?.items[0]?.name).toBe("Initial Skill");
+    });
+
+    rerender({ q: "search" });
+
+    expect(result.current.data?.items[0]?.name).toBe("Initial Skill");
+    expect(result.current.isFetching).toBe(true);
+
+    resolveSearch?.(createMarketplaceList("Search Skill"));
+
+    await waitFor(() => {
+      expect(result.current.data?.items[0]?.name).toBe("Search Skill");
+    });
+  });
+});

package/src/features/marketplace/hooks/use-marketplace.ts

@@ -38,7 +38,7 @@ export function useMarketplaceItems(params: MarketplaceListParams) {
       }
 
       const previousType = 'type' in previousParams ? previousParams.type : undefined;
-      return previousType === params.type && hasSameMarketplaceListIdentity(
+      return previousType === params.type && hasSameMarketplaceListSurface(
         previousParams as MarketplaceListParams,
         params
       )
@@ -56,14 +56,12 @@ export function useMarketplaceItems(params: MarketplaceListParams) {
   };
 }
 
-function hasSameMarketplaceListIdentity(
+function hasSameMarketplaceListSurface(
   previousParams: MarketplaceListParams,
   nextParams: MarketplaceListParams
 ): boolean {
-  return previousParams.q === nextParams.q
-    && previousParams.tag === nextParams.tag
+  return previousParams.tag === nextParams.tag
     && previousParams.scene === nextParams.scene
-    && previousParams.sort === nextParams.sort
     && previousParams.pageSize === nextParams.pageSize;
 }
 

package/src/features/side-dock/components/side-dock.test.tsx

@@ -110,4 +110,29 @@ describe('SideDock', () => {
 
     expect(screen.getByText('D')).toBeTruthy();
   });
+
+  it('renders emoji icons as visual dock icons instead of small text labels', () => {
+    const manager = {
+      openItem: vi.fn(),
+      unpinItem: vi.fn(),
+    } as unknown as SideDockManager;
+    const docBrowserManager = new DocBrowserManager();
+    useSideDockStore.getState().setPinnedItems([
+      {
+        createdAt: '2026-06-02T00:00:00.000Z',
+        icon: { type: 'text', value: '🎨' },
+        id: 'pinned-panel-app-palette',
+        label: 'Palette App',
+        target: { type: 'right-panel-resource', uri: 'nextclaw://panel-app/palette' },
+      },
+    ]);
+
+    render(
+      <DocBrowserProvider manager={docBrowserManager}>
+        <SideDock manager={manager} />
+      </DocBrowserProvider>,
+    );
+
+    expect(screen.getByText('🎨').className).toContain('text-[20px]');
+  });
 });

package/src/features/side-dock/components/side-dock.tsx

@@ -34,11 +34,24 @@ const SIDE_DOCK_ICON_COMPONENTS: Record<SideDockIconName, LucideIcon> = {
   'service-apps': AppWindow,
 };
 
+const SIDE_DOCK_EMOJI_ICON_PATTERN = /^\p{Extended_Pictographic}(?:\uFE0F|\uFE0E)?(?:\u200D\p{Extended_Pictographic}(?:\uFE0F|\uFE0E)?)*$/u;
+
+function isSideDockEmojiIcon(value: string): boolean {
+  return SIDE_DOCK_EMOJI_ICON_PATTERN.test(value.trim());
+}
+
 function SideDockItemIconView({ icon }: { icon: SideDockItemIcon }) {
   if (icon.type === 'url') {
     return <img src={icon.url} alt="" className="h-5 w-5 rounded object-cover" />;
   }
   if (icon.type === 'text') {
+    if (isSideDockEmojiIcon(icon.value)) {
+      return (
+        <span className="flex h-7 w-7 items-center justify-center text-[20px] leading-none" aria-hidden="true">
+          {icon.value}
+        </span>
+      );
+    }
     return (
       <span className="max-w-7 truncate text-center text-[13px] font-semibold leading-none" aria-hidden="true">
         {icon.value}

package/src/features/system-status/components/desktop-update-config.tsx

@@ -8,6 +8,7 @@ import { Switch } from '@/shared/components/ui/switch';
 import { PageHeader, PageLayout } from '@/app/components/layout/page-layout';
 import { formatDateTime, t } from '@/shared/lib/i18n';
 import { cn } from '@/shared/lib/utils';
+import { hostCapabilityManager } from '@/shared/lib/host-capabilities';
 import { Download, ExternalLink, RefreshCw, RotateCw } from 'lucide-react';
 
 const STATUS_LABEL_KEYS: Record<string, string> = {
@@ -249,7 +250,7 @@ export function DesktopUpdateConfig() {
             <RotateCw className={cn('mr-2 h-4 w-4', isApplying && 'animate-spin')} />
             {t('runtimeUpdatesApplyNow')}
           </Button>
-          {snapshot.releaseNotesUrl ? <Button variant="ghost" onClick={() => window.open(snapshot.releaseNotesUrl ?? '', '_blank', 'noopener,noreferrer')}><ExternalLink className="mr-2 h-4 w-4" />{t('desktopUpdatesReleaseNotes')}</Button> : null}
+          {snapshot.releaseNotesUrl ? <Button variant="ghost" onClick={() => void hostCapabilityManager.openExternalUrl(snapshot.releaseNotesUrl ?? '')}><ExternalLink className="mr-2 h-4 w-4" />{t('desktopUpdatesReleaseNotes')}</Button> : null}
         </CardContent>
       </Card>
     </PageLayout>

package/src/platforms/desktop/types/desktop-update.types.ts

@@ -52,6 +52,14 @@ export type DesktopWindowControlAction = 'minimize' | 'toggle-maximize' | 'close
 
 export type DesktopWindowStateSnapshot = { isMaximized: boolean };
 
+export type DesktopOpenExternalUrlResult =
+  | { opened: true }
+  | { opened: false; reason: 'unsupported-url' | 'popup-blocked' | 'bridge-failed' };
+
+export type DesktopHostBridge = {
+  openExternalUrl: (url: string) => Promise<DesktopOpenExternalUrlResult>;
+};
+
 export type NextClawDesktopBridge = {
   platform: string;
   version: string;
@@ -69,6 +77,7 @@ export type NextClawDesktopBridge = {
   setLocalePreference?: (language: DesktopUiLanguagePreference | null) => Promise<DesktopUiLanguagePreference | null>;
   controlWindow?: (action: DesktopWindowControlAction) => Promise<void>;
   getWindowState?: () => Promise<DesktopWindowStateSnapshot>;
+  host?: DesktopHostBridge;
   onWindowStateChanged?: (listener: (snapshot: DesktopWindowStateSnapshot) => void) => () => void;
   onUpdateStateChanged: (listener: (snapshot: DesktopUpdateSnapshot) => void) => () => void;
 };

package/src/shared/components/config/provider-form.tsx

@@ -51,7 +51,7 @@ import {
 import { ProviderModelsSection } from './provider-models-section';
 import type { PillSelectOption } from '@/shared/components/provider-pill-selector';
 import { ProviderStatusBadge } from '@/shared/components/provider-status-badge';
-
+import { hostCapabilityManager } from '@/shared/lib/host-capabilities';
 type ProviderFormProps = {
   providerName?: string;
   onProviderDeleted?: (providerName: string) => void;
@@ -488,7 +488,7 @@ export function ProviderForm({ providerName, onProviderDeleted }: ProviderFormPr
       }
       setAuthSessionId(result.sessionId);
       setAuthStatusMessage(`${t('providerAuthOpenPrompt')}${result.userCode}${t('providerAuthOpenPromptSuffix')}`);
-      window.open(result.verificationUri, '_blank', 'noopener,noreferrer');
+      await hostCapabilityManager.openExternalUrl(result.verificationUri);
       scheduleProviderAuthPoll(result.sessionId, result.intervalMs);
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);

package/src/shared/components/doc-browser/managers/doc-browser.manager.ts

@@ -19,6 +19,11 @@ import {
 } from '@/shared/components/doc-browser/utils/doc-browser-url.utils';
 import { DefaultDocBrowserRouteResolver } from '@/shared/components/doc-browser/utils/doc-browser-route-resolver.utils';
 import { useDocBrowserStore } from '@/shared/components/doc-browser/stores/doc-browser.store';
+import {
+  filterNavigationHistoryEntries,
+  pushNavigationHistoryEntry,
+  stepNavigationHistory,
+} from '@/shared/lib/navigation-history';
 
 const defaultDocBrowserRouteResolver = new DefaultDocBrowserRouteResolver();
 
@@ -74,15 +79,15 @@ function pushActiveHistory(
   state: DocBrowserState,
   entry: DocBrowserActiveHistoryEntry,
 ): DocBrowserState {
-  const current = state.activeHistory[state.activeHistoryIndex];
-  if (current && areActiveHistoryEntriesEquivalent(routeResolver, current, entry)) {
-    return state;
-  }
-  const activeHistory = [...state.activeHistory.slice(0, state.activeHistoryIndex + 1), entry];
+  const activeHistory = pushNavigationHistoryEntry(
+    { entries: state.activeHistory, index: state.activeHistoryIndex },
+    entry,
+    (current, next) => areActiveHistoryEntriesEquivalent(routeResolver, current, next),
+  );
   return {
     ...state,
-    activeHistory,
-    activeHistoryIndex: activeHistory.length - 1,
+    activeHistory: [...activeHistory.entries],
+    activeHistoryIndex: activeHistory.index,
   };
 }
 
@@ -366,29 +371,35 @@ export class DocBrowserManager {
 
   readonly goBack = (): void => {
     this.setSnapshot((prev) => {
-      if (prev.activeHistoryIndex <= 0) {
-        return prev;
-      }
-      const activeHistoryIndex = prev.activeHistoryIndex - 1;
-      const entry = prev.activeHistory[activeHistoryIndex];
-      if (!entry) {
+      const step = stepNavigationHistory(
+        { entries: prev.activeHistory, index: prev.activeHistoryIndex },
+        'back',
+      );
+      if (!step) {
         return prev;
       }
-      return restoreActiveHistoryEntry(this.routeResolver, { ...prev, activeHistoryIndex }, entry);
+      return restoreActiveHistoryEntry(this.routeResolver, {
+        ...prev,
+        activeHistory: [...step.history.entries],
+        activeHistoryIndex: step.history.index,
+      }, step.entry);
     });
   };
 
   readonly goForward = (): void => {
     this.setSnapshot((prev) => {
-      if (prev.activeHistoryIndex >= prev.activeHistory.length - 1) {
-        return prev;
-      }
-      const activeHistoryIndex = prev.activeHistoryIndex + 1;
-      const entry = prev.activeHistory[activeHistoryIndex];
-      if (!entry) {
+      const step = stepNavigationHistory(
+        { entries: prev.activeHistory, index: prev.activeHistoryIndex },
+        'forward',
+      );
+      if (!step) {
         return prev;
       }
-      return restoreActiveHistoryEntry(this.routeResolver, { ...prev, activeHistoryIndex }, entry);
+      return restoreActiveHistoryEntry(this.routeResolver, {
+        ...prev,
+        activeHistory: [...step.history.entries],
+        activeHistoryIndex: step.history.index,
+      }, step.entry);
     });
   };
 
@@ -417,20 +428,16 @@ export class DocBrowserManager {
         tabs: nextTabs,
         activeTabId: nextActiveId,
       };
-      const activeHistory = nextState.activeHistory.filter((entry) => entry.tabId !== tabId);
-      const activeHistoryBeforeIndex = nextState.activeHistory
-        .slice(0, nextState.activeHistoryIndex + 1)
-        .filter((entry) => entry.tabId !== tabId);
       const nextActiveTab = nextTabs.find((tab) => tab.id === nextActiveId) ?? nextTabs[0];
+      const activeHistory = filterNavigationHistoryEntries(
+        { entries: nextState.activeHistory, index: nextState.activeHistoryIndex },
+        (entry) => entry.tabId !== tabId,
+        createDocBrowserActiveHistoryEntry(nextActiveTab),
+      );
       const reconciledState = {
         ...nextState,
-        activeHistory: activeHistory.length > 0
-          ? activeHistory
-          : [createDocBrowserActiveHistoryEntry(nextActiveTab)],
-        activeHistoryIndex: Math.min(
-          Math.max(0, activeHistoryBeforeIndex.length - 1),
-          Math.max(0, activeHistory.length - 1),
-        ),
+        activeHistory: [...activeHistory.entries],
+        activeHistoryIndex: activeHistory.index,
       };
       return prev.activeTabId === tabId
         ? pushActiveHistory(this.routeResolver, reconciledState, createDocBrowserActiveHistoryEntry(nextActiveTab))

package/src/shared/components/ui/action-link.tsx

@@ -1,5 +1,5 @@
 import { cn } from '@/shared/lib/utils';
-import { ArrowRight } from 'lucide-react';
+import { ArrowRight, ExternalLink } from 'lucide-react';
 
 interface ActionLinkProps {
     label: string;
@@ -7,6 +7,12 @@ interface ActionLinkProps {
     onClick?: () => void;
 }
 
+interface ExternalActionLinkProps {
+    label: string;
+    className?: string;
+    onClick: () => void;
+}
+
 /**
  * Unified action link with arrow indicator.
  * Used in card footers for "Configure →", "Enable →", etc.
@@ -25,3 +31,19 @@ export function ActionLink({ label, className, onClick }: ActionLinkProps) {
         </span>
     );
 }
+
+export function ExternalActionLink({ label, className, onClick }: ExternalActionLinkProps) {
+    return (
+        <button
+            type="button"
+            className={cn(
+                'inline-flex h-7 shrink-0 items-center gap-1.5 rounded-md px-1.5 text-[13px] font-medium text-primary transition-colors hover:text-primary-hover focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2',
+                className
+            )}
+            onClick={onClick}
+        >
+            <ExternalLink className="h-3.5 w-3.5" />
+            {label}
+        </button>
+    );
+}

package/src/shared/lib/host-capabilities/host-capability.manager.test.ts

@@ -0,0 +1,50 @@
+import { HostCapabilityManager } from "@/shared/lib/host-capabilities";
+
+describe("HostCapabilityManager", () => {
+  it("uses the desktop host bridge when available", async () => {
+    const openExternalUrl = vi.fn(async () => ({ opened: true as const }));
+    const manager = new HostCapabilityManager(() => ({
+      open: vi.fn(),
+      nextclawDesktop: {
+        host: { openExternalUrl }
+      }
+    } as unknown as Window));
+
+    await expect(manager.openExternalUrl("https://skillhub.cn")).resolves.toEqual({ opened: true });
+    expect(openExternalUrl).toHaveBeenCalledWith("https://skillhub.cn/");
+  });
+
+  it("falls back to window.open outside the desktop host", async () => {
+    const open = vi.fn(() => ({ closed: false }));
+    const manager = new HostCapabilityManager(() => ({
+      open
+    } as unknown as Window));
+
+    await expect(manager.openExternalUrl("https://skillhub.cn")).resolves.toEqual({ opened: true });
+    expect(open).toHaveBeenCalledWith("https://skillhub.cn/", "_blank", "noopener,noreferrer");
+  });
+
+  it("reports unsupported URLs without opening them", async () => {
+    const open = vi.fn();
+    const manager = new HostCapabilityManager(() => ({
+      open
+    } as unknown as Window));
+
+    await expect(manager.openExternalUrl("javascript:alert(1)")).resolves.toEqual({
+      opened: false,
+      reason: "unsupported-url"
+    });
+    expect(open).not.toHaveBeenCalled();
+  });
+
+  it("reports popup-blocked when the web fallback cannot open a window", async () => {
+    const manager = new HostCapabilityManager(() => ({
+      open: vi.fn(() => null)
+    } as unknown as Window));
+
+    await expect(manager.openExternalUrl("https://skillhub.cn")).resolves.toEqual({
+      opened: false,
+      reason: "popup-blocked"
+    });
+  });
+});

package/src/shared/lib/host-capabilities/host-capability.manager.ts

@@ -0,0 +1,62 @@
+export type OpenExternalUrlFailureReason =
+  | "unsupported-url"
+  | "popup-blocked"
+  | "bridge-failed";
+
+export type OpenExternalUrlResult =
+  | { opened: true }
+  | { opened: false; reason: OpenExternalUrlFailureReason };
+
+type HostWindow = Pick<Window, "open"> & {
+  nextclawDesktop?: {
+    host?: {
+      openExternalUrl?: (url: string) => Promise<OpenExternalUrlResult>;
+    };
+  };
+};
+
+export class HostCapabilityManager {
+  constructor(private readonly getWindow = (): HostWindow | null => {
+    return typeof window === "undefined" ? null : window;
+  }) {}
+
+  openExternalUrl = async (rawUrl: string): Promise<OpenExternalUrlResult> => {
+    const url = normalizeExternalHttpUrl(rawUrl);
+    if (!url) {
+      return { opened: false, reason: "unsupported-url" };
+    }
+
+    const hostWindow = this.getWindow();
+    if (!hostWindow) {
+      return { opened: false, reason: "bridge-failed" };
+    }
+
+    try {
+      const desktopOpen = hostWindow.nextclawDesktop?.host?.openExternalUrl;
+      if (desktopOpen) {
+        return await desktopOpen(url);
+      }
+      const openedWindow = hostWindow.open(url, "_blank", "noopener,noreferrer");
+      if (!openedWindow) {
+        return { opened: false, reason: "popup-blocked" };
+      }
+      return { opened: true };
+    } catch {
+      return { opened: false, reason: "bridge-failed" };
+    }
+  };
+}
+
+export const hostCapabilityManager = new HostCapabilityManager();
+
+function normalizeExternalHttpUrl(rawUrl: string): string | null {
+  try {
+    const url = new URL(rawUrl);
+    if (url.protocol !== "https:" && url.protocol !== "http:") {
+      return null;
+    }
+    return url.toString();
+  } catch {
+    return null;
+  }
+}

package/src/shared/lib/host-capabilities/index.ts

@@ -0,0 +1 @@
+export * from './host-capability.manager';

package/src/shared/lib/i18n/README.md

@@ -1,7 +1,20 @@
 # i18n owner
 
-This directory temporarily keeps domain label owner modules next to the i18n runtime entrypoint.
+This module owns the NextClaw UI language runtime and locale catalogs.
 
-## 目录预算豁免
+## 文案维护方式
 
-- 原因：i18n 文案正在从单一超大 `index.ts` 逐步拆到领域 owner 文件，当前新增 cron 文案先落到独立 owner，避免继续膨胀入口文件；后续应迁移为每个语言独立 JSON，由 runtime 统一加载。
+- User-visible labels live in `locales/<locale>/*.json`.
+- `index.ts` only owns catalog assembly, formatting helpers, and the stable `t(key)` API.
+- Keep current flat keys when moving existing labels; semantic nested keys can migrate by domain during future feature work.
+- When adding or editing copy, update both `zh-CN` and `en-US`.
+
+## 验证
+
+Run:
+
+```bash
+node scripts/smoke/i18n/nextclaw-ui-i18n-check.mjs
+```
+
+The check verifies that both locales have the same JSON files, the same message keys, and matching `{placeholder}` names.