From adc991cc2a6333fb35a06d8187c51674bf00edc1 Mon Sep 17 00:00:00 2001
From: Bob Lee <liwenbo628@gmail.com>
Date: Fri, 6 Nov 2026 19:07:54 +0800
Subject: [PATCH 1/3] feat(settings): choose the default browser for
 conversation links

---
 src/web-ui/README.md                          | 13 ++++
 src/web-ui/README.zh-CN.md                    | 10 +++
 src/web-ui/src/app/scenes/settings/AGENTS.md  | 10 +++
 .../tools/BrowserLinkSettingsSection.tsx      | 30 +++++++++
 .../pages/tools/DeviceControlSettingsPage.tsx |  2 +
 .../app/scenes/settings/settingsRegistry.ts   |  5 ++
 .../services/browserLinkPreference.test.ts    | 36 ++++++++++
 .../config/services/browserLinkPreference.ts  | 33 +++++++++
 .../markdown/MarkdownRenderer.test.tsx        | 67 +++++++++++++++++++
 .../markdown/MarkdownRenderer.tsx             |  7 +-
 .../src/locales/en-US/settings/runtime.json   |  7 ++
 .../src/locales/zh-CN/settings/runtime.json   |  7 ++
 .../src/locales/zh-TW/settings/runtime.json   |  7 ++
 13 files changed, 233 insertions(+), 1 deletion(-)
 create mode 100644 src/web-ui/src/app/scenes/settings/pages/tools/BrowserLinkSettingsSection.tsx
 create mode 100644 src/web-ui/src/infrastructure/config/services/browserLinkPreference.test.ts
 create mode 100644 src/web-ui/src/infrastructure/config/services/browserLinkPreference.ts

diff --git a/src/web-ui/README.md b/src/web-ui/README.md
index a44744cf6c..0692e01892 100644
--- a/src/web-ui/README.md
+++ b/src/web-ui/README.md
@@ -24,6 +24,19 @@ Numbered tab selection, reopening a closed tab and layout shortcuts also stay
 with their owning canvas. Recording a new binding in Settings captures the key
 without executing the existing command.
 
+## Opening web links
+
+In **Settings → Tools → Browser & desktop control → Web links**, choose whether
+conversation links open in the **Built-in browser** or the **System default
+browser**. The choice applies immediately and is saved on this device, including
+while viewing remote workspaces or switching peers. Existing installs keep the
+built-in default until you change it.
+
+Right-click a link to choose either browser for that click. Modifier-clicks
+continue to open the external browser; supported PR/MR links keep their review
+panel behavior. This preference does not change the browser used by agent
+browser control, or the separate mobile/IM and headless dispatch surfaces.
+
 ## Creating a project
 
 The sidebar's add button opens two clickable cards without footer actions.
diff --git a/src/web-ui/README.zh-CN.md b/src/web-ui/README.zh-CN.md
index dc2a3c6c29..e163f20d33 100644
--- a/src/web-ui/README.zh-CN.md
+++ b/src/web-ui/README.zh-CN.md
@@ -21,6 +21,16 @@
 数字切换标签、重新打开标签和布局快捷键也只作用于当前画布。
 在设置页录入新快捷键时，按键用于录入，不会执行原有命令。
 
+## 打开网页链接
+
+在 **设置 → 工具 → 浏览器与桌面控制 → 网页链接** 中，选择对话中的链接默认使用
+**内置浏览器** 还是 **系统默认浏览器**。修改立即生效并保存在当前设备；查看远程
+工作区或切换 Peer 设备时沿用此偏好。未设置时继续使用内置浏览器。
+
+右键点击链接仍可为单次打开选择浏览器。按住修饰键点击仍使用外部浏览器；支持的
+PR/MR 链接保留评审面板入口。此设置不改变智能体浏览器控制所用的浏览器，也不
+影响独立的移动端、IM 或无界面派发任务。
+
 ## 创建项目
 
 左侧导航的新增按钮展示两张可点击卡片，首层不设底部操作按钮。
diff --git a/src/web-ui/src/app/scenes/settings/AGENTS.md b/src/web-ui/src/app/scenes/settings/AGENTS.md
index 3d989950bd..d48ef4f01f 100644
--- a/src/web-ui/src/app/scenes/settings/AGENTS.md
+++ b/src/web-ui/src/app/scenes/settings/AGENTS.md
@@ -44,6 +44,16 @@ pnpm --dir src/web-ui run test:run src/infrastructure/config/components/common/S
 
 Follow the parent guide for `check:web`, i18n, and Appearance registration checks.
 
+For the controller-local web link preference, persistence and explicit browser actions:
+
+```bash
+pnpm --dir src/web-ui run test:run src/infrastructure/config/services/browserLinkPreference.test.ts src/infrastructure/markdown/MarkdownRenderer.test.tsx src/infrastructure/api/service-api/SystemAPI.test.ts src/app/scenes/settings/settingsRegistry.test.ts src/infrastructure/config/components/common/SettingsControlSizing.test.ts
+```
+
+The link preference remains editable independently of host control status. These
+storage/DOM fixtures cover remote workspace metadata and simulated Peer switches;
+they do not establish native browser opening, live remote scenarios, or visual fidelity.
+
 For keyboard shortcut recording, command suppression, IME and capture lifetime:
 
 ```bash
diff --git a/src/web-ui/src/app/scenes/settings/pages/tools/BrowserLinkSettingsSection.tsx b/src/web-ui/src/app/scenes/settings/pages/tools/BrowserLinkSettingsSection.tsx
new file mode 100644
index 0000000000..a6d2cb5e4b
--- /dev/null
+++ b/src/web-ui/src/app/scenes/settings/pages/tools/BrowserLinkSettingsSection.tsx
@@ -0,0 +1,30 @@
+import { useStore } from 'zustand';
+import { Select } from '@openbitfun/ui';
+import { useI18n } from '@/infrastructure/i18n';
+import { ConfigPageRow, ConfigPageSection } from '@/infrastructure/config/components/common';
+import { browserLinkPreferenceStore } from '@/infrastructure/config/services/browserLinkPreference';
+
+export default function BrowserLinkSettingsSection() {
+  const { t } = useI18n('settings/runtime');
+  const target = useStore(browserLinkPreferenceStore, state => state.target);
+  const setTarget = useStore(browserLinkPreferenceStore, state => state.setTarget);
+
+  return (
+    <ConfigPageSection title={t('browserLinks.sectionTitle')}>
+      <ConfigPageRow label={t('browserLinks.defaultTarget')} description={t('browserLinks.description')} align="center">
+        <Select
+          size="sm"
+          aria-label={t('browserLinks.defaultTarget')}
+          value={target}
+          options={[
+            { value: 'builtin', label: t('browserLinks.builtin') },
+            { value: 'external', label: t('browserLinks.external') },
+          ]}
+          onValueChange={value => {
+            if (value === 'builtin' || value === 'external') setTarget(value);
+          }}
+        />
+      </ConfigPageRow>
+    </ConfigPageSection>
+  );
+}
diff --git a/src/web-ui/src/app/scenes/settings/pages/tools/DeviceControlSettingsPage.tsx b/src/web-ui/src/app/scenes/settings/pages/tools/DeviceControlSettingsPage.tsx
index 55ace0fb71..e891e7be71 100644
--- a/src/web-ui/src/app/scenes/settings/pages/tools/DeviceControlSettingsPage.tsx
+++ b/src/web-ui/src/app/scenes/settings/pages/tools/DeviceControlSettingsPage.tsx
@@ -35,6 +35,7 @@ import {
 import React, { useCallback, useEffect, useRef, useState } from 'react';
 import { useTranslation } from 'react-i18next';
 import { SettingsPage } from '../shared/SettingsPage';
+import BrowserLinkSettingsSection from './BrowserLinkSettingsSection';
 const log = createLogger('DeviceControlSettingsPage');
 
 const IS_TAURI_DESKTOP = typeof window !== 'undefined' && '__TAURI__' in window;
@@ -538,6 +539,7 @@ const DeviceControlSettingsPage: React.FC = () => {
 
   return (
     <SettingsPage pageId="tools.desktop-control" className="openbitfun-runtime-settings" data-openbitfun-component="runtime-settings" data-openbitfun-part="root" data-openbitfun-view="browser-desktop-control">
+      <BrowserLinkSettingsSection />
       {loadError ? (
         <ConfigRetryState message={t('loading.failed')} retryLabel={t('loading.retry')} onRetry={() => void loadPageData()} />
       ) : isLoading ? (
diff --git a/src/web-ui/src/app/scenes/settings/settingsRegistry.ts b/src/web-ui/src/app/scenes/settings/settingsRegistry.ts
index f554b85ae2..95cc841c70 100644
--- a/src/web-ui/src/app/scenes/settings/settingsRegistry.ts
+++ b/src/web-ui/src/app/scenes/settings/settingsRegistry.ts
@@ -407,6 +407,7 @@ export const SETTINGS_PAGE_MANIFESTS: readonly SettingsPageManifest[] = [
     descriptionKey: 'navigation.pages.browserDesktopControl.description',
     keywords: [
       'browser', 'cdp', 'chrome', 'edge', 'remote debugging', 'connection',
+      'links', 'built-in browser', 'external browser',
       'desktop', 'computer use', 'accessibility', 'screen capture', 'mouse', 'keyboard',
     ],
     namespaces: ['settings', 'settings/runtime'],
@@ -414,6 +415,10 @@ export const SETTINGS_PAGE_MANIFESTS: readonly SettingsPageManifest[] = [
       phrase('settings/runtime', 'computerUse.sectionTitle'),
       phrase('settings/runtime', 'computerUse.accessibility'),
       phrase('settings/runtime', 'computerUse.screenCapture'),
+      phrase('settings/runtime', 'browserLinks.sectionTitle'),
+      phrase('settings/runtime', 'browserLinks.defaultTarget'),
+      phrase('settings/runtime', 'browserLinks.builtin'),
+      phrase('settings/runtime', 'browserLinks.external'),
       phrase('settings/runtime', 'browserControl.sectionTitle'),
       phrase('settings/runtime', 'browserControl.preferredBrowser'),
       phrase('settings/runtime', 'browserControl.autoConnectOnStartup'),
diff --git a/src/web-ui/src/infrastructure/config/services/browserLinkPreference.test.ts b/src/web-ui/src/infrastructure/config/services/browserLinkPreference.test.ts
new file mode 100644
index 0000000000..c5928ac672
--- /dev/null
+++ b/src/web-ui/src/infrastructure/config/services/browserLinkPreference.test.ts
@@ -0,0 +1,36 @@
+import { describe, expect, it, vi } from 'vitest';
+import { BROWSER_LINK_TARGET_STORAGE_KEY, createBrowserLinkPreferenceStore } from './browserLinkPreference';
+
+function storage(value: string | null = null) {
+  let saved = value;
+  return { getItem: () => saved, setItem: vi.fn((_key: string, next: string) => { saved = next; }) };
+}
+
+describe('controller browser link preference', () => {
+  it.each([null, '', 'builtin', 'future-target'])('reads an older or unknown record %j without rewriting it', value => {
+    const persisted = storage(value);
+    expect(createBrowserLinkPreferenceStore(persisted).getState().target).toBe('builtin');
+    expect(persisted.getItem()).toBe(value);
+    expect(persisted.setItem).not.toHaveBeenCalled();
+  });
+
+  it('round-trips both choices across window restarts', () => {
+    const persisted = storage();
+    createBrowserLinkPreferenceStore(persisted).getState().setTarget('external');
+    expect(persisted.setItem).toHaveBeenCalledWith(BROWSER_LINK_TARGET_STORAGE_KEY, 'external');
+    const reopened = createBrowserLinkPreferenceStore(persisted);
+    expect(reopened.getState().target).toBe('external');
+    reopened.getState().setTarget('builtin');
+    expect(createBrowserLinkPreferenceStore(persisted).getState().target).toBe('builtin');
+  });
+
+  it('keeps links usable when storage cannot be read or written', () => {
+    const store = createBrowserLinkPreferenceStore({
+      getItem: () => { throw Error('unavailable'); },
+      setItem: () => { throw Error('unavailable'); },
+    });
+    expect(store.getState().target).toBe('builtin');
+    store.getState().setTarget('external');
+    expect(store.getState().target).toBe('external');
+  });
+});
diff --git a/src/web-ui/src/infrastructure/config/services/browserLinkPreference.ts b/src/web-ui/src/infrastructure/config/services/browserLinkPreference.ts
new file mode 100644
index 0000000000..39d2d318d6
--- /dev/null
+++ b/src/web-ui/src/infrastructure/config/services/browserLinkPreference.ts
@@ -0,0 +1,33 @@
+import { createStore } from 'zustand/vanilla';
+
+export type BrowserLinkTarget = 'builtin' | 'external';
+export const BROWSER_LINK_TARGET_STORAGE_KEY = 'openbitfun:browserLinkTarget';
+
+type PreferenceStorage = Pick<Storage, 'getItem' | 'setItem'>;
+
+function controllerStorage(): PreferenceStorage | undefined {
+  try { return typeof window === 'undefined' ? undefined : window.localStorage; }
+  catch { return undefined; }
+}
+
+/** Link presentation belongs to the controller, independent of the selected host. */
+export function createBrowserLinkPreferenceStore(storage = controllerStorage()) {
+  let saved: string | null | undefined;
+  try { saved = storage?.getItem(BROWSER_LINK_TARGET_STORAGE_KEY); }
+  catch { /* Keep link opening usable when storage is unavailable. */ }
+
+  return createStore<{
+    target: BrowserLinkTarget;
+    setTarget: (target: BrowserLinkTarget) => void;
+  }>((set) => ({
+    // Existing installs keep their behavior; unknown records are left intact.
+    target: saved === 'external' ? 'external' : 'builtin',
+    setTarget: target => {
+      try { storage?.setItem(BROWSER_LINK_TARGET_STORAGE_KEY, target); }
+      catch { /* Retain the selection for this window when persistence fails. */ }
+      set({ target });
+    },
+  }));
+}
+
+export const browserLinkPreferenceStore = createBrowserLinkPreferenceStore();
diff --git a/src/web-ui/src/infrastructure/markdown/MarkdownRenderer.test.tsx b/src/web-ui/src/infrastructure/markdown/MarkdownRenderer.test.tsx
index 51bb1a3114..95b432b533 100644
--- a/src/web-ui/src/infrastructure/markdown/MarkdownRenderer.test.tsx
+++ b/src/web-ui/src/infrastructure/markdown/MarkdownRenderer.test.tsx
@@ -21,6 +21,7 @@ import type { PeerHostCapabilities } from '@/infrastructure/peer-device/PeerConn
 import { useFlowChatHttpLinkClick } from '@/flow_chat/components/modern/useFlowChatHttpLinkClick';
 import { FlowTextBlock } from '@/flow_chat/components/FlowTextBlock';
 import { captureFlowChatSelection } from '@/flow_chat/selection/flowChatSelection';
+import { browserLinkPreferenceStore, BROWSER_LINK_TARGET_STORAGE_KEY } from '@/infrastructure/config/services/browserLinkPreference';
 
 /** The chat session's workspace record; content opened from chat links is routed by its ID. */
 const SESSION_WORKSPACE = vi.hoisted(() => ({
@@ -194,6 +195,7 @@ describe('Markdown file links', () => {
     (globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
 
     activateSurface('local');
+    browserLinkPreferenceStore.setState({ target: 'builtin' });
     flowChatStore.setState(state => ({ ...state, sessions: new Map(), activeSessionId: null }));
     useContentResourceStore.setState({ resources: {} });
     resetSceneStoreForTest();
@@ -225,6 +227,8 @@ describe('Markdown file links', () => {
     });
     activateSurface('local');
     container.remove();
+    browserLinkPreferenceStore.setState({ target: 'builtin' });
+    localStorage.removeItem(BROWSER_LINK_TARGET_STORAGE_KEY);
     flowChatStore.setState(state => ({ ...state, sessions: new Map(), activeSessionId: null }));
     useContentResourceStore.setState({ resources: {} });
     resetSceneStoreForTest();
@@ -733,6 +737,69 @@ Second paragraph.
     }
   });
 
+  it.each(['local', 'linux-peer'])('uses the current browser preference without remounting links on %s', async surface => {
+    container.className = 'openbitfun-session-scene modern-flowchat-container';
+    activateSurface(surface);
+    openSessionHost();
+    const url = 'https://example.com/docs';
+    await act(async () => root.render(<MarkdownRenderer content={`[Example](${url})`} />));
+    const link = container.querySelector<HTMLAnchorElement>('a')!;
+
+    act(() => browserLinkPreferenceStore.getState().setTarget('external'));
+    await act(async () => link.click());
+    expect(mocks.openExternal).toHaveBeenCalledExactlyOnceWith(url);
+    expect(useAgentCanvasStore.getState().primaryGroup.tabs).toHaveLength(0);
+
+    act(() => browserLinkPreferenceStore.getState().setTarget('builtin'));
+    expect(container.querySelector('a')).toBe(link);
+    await act(async () => link.click());
+    expect(mocks.openExternal).toHaveBeenCalledTimes(1);
+    expect(useAgentCanvasStore.getState().primaryGroup.tabs[0].content).toMatchObject({
+      type: 'browser', data: { url },
+    });
+  });
+
+  it('retains the controller preference across selected device changes', async () => {
+    container.className = 'openbitfun-session-scene modern-flowchat-container';
+    browserLinkPreferenceStore.getState().setTarget('external');
+    const url = 'https://example.com/docs';
+    await act(async () => root.render(<MarkdownRenderer content={`[Example](${url})`} />));
+    for (const surface of ['local', 'linux-peer', 'local']) {
+      await act(async () => activateSurface(surface));
+      await act(async () => container.querySelector<HTMLAnchorElement>('a')!.click());
+    }
+    expect(mocks.openExternal.mock.calls).toEqual([[url], [url], [url]]);
+    expect(useAgentCanvasStore.getState().primaryGroup.tabs).toHaveLength(0);
+  });
+
+  it.each(['builtin', 'external'] as const)('keeps both explicit context menu choices with the %s default', async target => {
+    container.className = 'openbitfun-session-scene modern-flowchat-container';
+    openSessionHost();
+    browserLinkPreferenceStore.getState().setTarget(target);
+    const url = 'https://example.com/docs';
+    await act(async () => root.render(<MarkdownRenderer content={`[Example](${url})`} />));
+    act(() => container.querySelector('a')!.dispatchEvent(new MouseEvent('contextmenu', {
+      bubbles: true, cancelable: true,
+    })));
+    const items = mocks.showContextMenu.mock.calls[0][1] as MenuItem[];
+    const context = mocks.showContextMenu.mock.calls[0][2];
+    await act(async () => items.find(item => item.id === 'markdown-open-in-browser')!.onClick?.(context));
+    expect(mocks.openExternal).toHaveBeenCalledExactlyOnceWith(url);
+    act(() => items.find(item => item.id === 'markdown-open-in-built-in-browser')!.onClick?.(context));
+    expect(useAgentCanvasStore.getState().primaryGroup.tabs[0].content).toMatchObject({
+      type: 'browser', data: { url },
+    });
+    expect(browserLinkPreferenceStore.getState().target).toBe(target);
+  });
+
+  it('opens links outside conversations externally even with the built-in default', async () => {
+    const url = 'https://example.com/docs';
+    await act(async () => root.render(<MarkdownRenderer content={`[Example](${url})`} />));
+    await act(async () => container.querySelector<HTMLAnchorElement>('a')!.click());
+    expect(mocks.openExternal).toHaveBeenCalledExactlyOnceWith(url);
+    expect(useAgentCanvasStore.getState().primaryGroup.tabs).toHaveLength(0);
+  });
+
   it('commits a browser view and explicitly reveals its inline host', async () => {
     container.className = 'openbitfun-session-scene modern-flowchat-container';
     openSessionHost();
diff --git a/src/web-ui/src/infrastructure/markdown/MarkdownRenderer.tsx b/src/web-ui/src/infrastructure/markdown/MarkdownRenderer.tsx
index d41a1b4f7f..5cd054499c 100644
--- a/src/web-ui/src/infrastructure/markdown/MarkdownRenderer.tsx
+++ b/src/web-ui/src/infrastructure/markdown/MarkdownRenderer.tsx
@@ -29,6 +29,7 @@ import { contextMenuController } from '@/shared/context-menu-system/core/Context
 import { ContextType, type CustomContext, type MenuItem } from '@/shared/context-menu-system/types';
 import { createTab, openFileInBestTarget } from '@/shared/utils/tabUtils';
 import { isHtmlFilePath, openHtmlFileInExternalBrowser } from '@/shared/utils/htmlFilePreview';
+import { browserLinkPreferenceStore } from '@/infrastructure/config/services/browserLinkPreference';
 import { createLogger } from '@/shared/utils/logger';
 import type { LineRange } from '@/shared/editor/LineRange';
 import {
@@ -1568,7 +1569,11 @@ const MarkdownSurface = React.memo<MarkdownRendererProps & { thinking?: boolean;
                 return;
               }
               const hasExternalOpenModifier = e.metaKey || e.ctrlKey || e.shiftKey || e.altKey;
-              if (canOpenInBuiltInBrowser(e.currentTarget) && !hasExternalOpenModifier) {
+              if (
+                browserLinkPreferenceStore.getState().target === 'builtin' &&
+                canOpenInBuiltInBrowser(e.currentTarget) &&
+                !hasExternalOpenModifier
+              ) {
                 handleOpenBuiltInBrowserLink(hrefValue);
                 return;
               }
diff --git a/src/web-ui/src/locales/en-US/settings/runtime.json b/src/web-ui/src/locales/en-US/settings/runtime.json
index 366854b780..7e083225fd 100644
--- a/src/web-ui/src/locales/en-US/settings/runtime.json
+++ b/src/web-ui/src/locales/en-US/settings/runtime.json
@@ -196,6 +196,13 @@
       "generic": "Full desktop control is not available on this system."
     }
   },
+  "browserLinks": {
+    "sectionTitle": "Web links",
+    "defaultTarget": "Open links by default in",
+    "description": "Choose the browser for web links clicked in conversations. Applies only to this device; the context menu still lets you choose for each link.",
+    "builtin": "Built-in browser",
+    "external": "System default browser"
+  },
   "browserControl": {
     "sectionTitle": "Browser control",
     "sectionDescription": "Allow agents to inspect and interact with browser pages after connecting",
diff --git a/src/web-ui/src/locales/zh-CN/settings/runtime.json b/src/web-ui/src/locales/zh-CN/settings/runtime.json
index bb1c2dc92e..27884970da 100644
--- a/src/web-ui/src/locales/zh-CN/settings/runtime.json
+++ b/src/web-ui/src/locales/zh-CN/settings/runtime.json
@@ -196,6 +196,13 @@
       "generic": "当前系统无法使用完整的桌面控制功能。"
     }
   },
+  "browserLinks": {
+    "sectionTitle": "网页链接",
+    "defaultTarget": "默认打开方式",
+    "description": "选择点击对话中的网页链接时使用的浏览器。仅对当前设备生效，右键菜单仍可单独选择。",
+    "builtin": "内置浏览器",
+    "external": "系统默认浏览器"
+  },
   "browserControl": {
     "sectionTitle": "浏览器控制",
     "sectionDescription": "连接后，智能体可查看并操作浏览器页面",
diff --git a/src/web-ui/src/locales/zh-TW/settings/runtime.json b/src/web-ui/src/locales/zh-TW/settings/runtime.json
index 020c32eaf9..f1b44fc74b 100644
--- a/src/web-ui/src/locales/zh-TW/settings/runtime.json
+++ b/src/web-ui/src/locales/zh-TW/settings/runtime.json
@@ -196,6 +196,13 @@
       "generic": "目前系統無法使用完整的桌面控制功能。"
     }
   },
+  "browserLinks": {
+    "sectionTitle": "網頁連結",
+    "defaultTarget": "預設開啟方式",
+    "description": "選擇點擊對話中的網頁連結時使用的瀏覽器。僅對目前裝置生效，右鍵選單仍可單獨選擇。",
+    "builtin": "內建瀏覽器",
+    "external": "系統預設瀏覽器"
+  },
   "browserControl": {
     "sectionTitle": "瀏覽器控制",
     "sectionDescription": "連線後，智能體可查看及操作瀏覽器頁面",

From 25b1b402fdaed8cd394fd6069e7b47e941272a2a Mon Sep 17 00:00:00 2001
From: Bob Lee <liwenbo628@gmail.com>
Date: Fri, 6 Nov 2026 19:14:23 +0800
Subject: [PATCH 2/3] fix(links): support web clients and sync browser
 preferences across windows

---
 src/web-ui/README.md                          |  2 +
 src/web-ui/README.zh-CN.md                    |  2 +
 src/web-ui/src/app/scenes/settings/AGENTS.md  |  2 +-
 .../tools/BrowserLinkSettingsSection.tsx      |  3 +-
 .../app/scenes/settings/settingsRegistry.ts   |  1 +
 .../api/service-api/SystemAPI.test.ts         | 28 +++++++++++++
 .../api/service-api/SystemAPI.ts              | 12 +++++-
 .../services/browserLinkPreference.test.ts    | 40 ++++++++++++++++++-
 .../config/services/browserLinkPreference.ts  | 16 +++++++-
 .../src/locales/en-US/settings/runtime.json   |  3 +-
 .../src/locales/zh-CN/settings/runtime.json   |  3 +-
 .../src/locales/zh-TW/settings/runtime.json   |  3 +-
 12 files changed, 106 insertions(+), 9 deletions(-)

diff --git a/src/web-ui/README.md b/src/web-ui/README.md
index 0692e01892..e7add3f996 100644
--- a/src/web-ui/README.md
+++ b/src/web-ui/README.md
@@ -31,6 +31,8 @@ conversation links open in the **Built-in browser** or the **System default
 browser**. The choice applies immediately and is saved on this device, including
 while viewing remote workspaces or switching peers. Existing installs keep the
 built-in default until you change it.
+In a Web deployment, the external option opens a new tab in the current browser.
+Changes also synchronize to other open pages sharing this device's local storage.
 
 Right-click a link to choose either browser for that click. Modifier-clicks
 continue to open the external browser; supported PR/MR links keep their review
diff --git a/src/web-ui/README.zh-CN.md b/src/web-ui/README.zh-CN.md
index e163f20d33..34b4f558e0 100644
--- a/src/web-ui/README.zh-CN.md
+++ b/src/web-ui/README.zh-CN.md
@@ -26,6 +26,8 @@
 在 **设置 → 工具 → 浏览器与桌面控制 → 网页链接** 中，选择对话中的链接默认使用
 **内置浏览器** 还是 **系统默认浏览器**。修改立即生效并保存在当前设备；查看远程
 工作区或切换 Peer 设备时沿用此偏好。未设置时继续使用内置浏览器。
+Web 部署中，外部选项为「当前浏览器（新标签页）」。共享本机存储的其他已打开页面
+也会同步使用新选择。
 
 右键点击链接仍可为单次打开选择浏览器。按住修饰键点击仍使用外部浏览器；支持的
 PR/MR 链接保留评审面板入口。此设置不改变智能体浏览器控制所用的浏览器，也不
diff --git a/src/web-ui/src/app/scenes/settings/AGENTS.md b/src/web-ui/src/app/scenes/settings/AGENTS.md
index d48ef4f01f..5ec15670ac 100644
--- a/src/web-ui/src/app/scenes/settings/AGENTS.md
+++ b/src/web-ui/src/app/scenes/settings/AGENTS.md
@@ -51,7 +51,7 @@ pnpm --dir src/web-ui run test:run src/infrastructure/config/services/browserLin
 ```
 
 The link preference remains editable independently of host control status. These
-storage/DOM fixtures cover remote workspace metadata and simulated Peer switches;
+storage/DOM fixtures cover cross-window preference updates, remote workspace metadata and simulated Peer switches;
 they do not establish native browser opening, live remote scenarios, or visual fidelity.
 
 For keyboard shortcut recording, command suppression, IME and capture lifetime:
diff --git a/src/web-ui/src/app/scenes/settings/pages/tools/BrowserLinkSettingsSection.tsx b/src/web-ui/src/app/scenes/settings/pages/tools/BrowserLinkSettingsSection.tsx
index a6d2cb5e4b..639b1e3700 100644
--- a/src/web-ui/src/app/scenes/settings/pages/tools/BrowserLinkSettingsSection.tsx
+++ b/src/web-ui/src/app/scenes/settings/pages/tools/BrowserLinkSettingsSection.tsx
@@ -1,6 +1,7 @@
 import { useStore } from 'zustand';
 import { Select } from '@openbitfun/ui';
 import { useI18n } from '@/infrastructure/i18n';
+import { isTauriRuntime } from '@/infrastructure/runtime';
 import { ConfigPageRow, ConfigPageSection } from '@/infrastructure/config/components/common';
 import { browserLinkPreferenceStore } from '@/infrastructure/config/services/browserLinkPreference';
 
@@ -18,7 +19,7 @@ export default function BrowserLinkSettingsSection() {
           value={target}
           options={[
             { value: 'builtin', label: t('browserLinks.builtin') },
-            { value: 'external', label: t('browserLinks.external') },
+            { value: 'external', label: t(isTauriRuntime() ? 'browserLinks.external' : 'browserLinks.browserTab') },
           ]}
           onValueChange={value => {
             if (value === 'builtin' || value === 'external') setTarget(value);
diff --git a/src/web-ui/src/app/scenes/settings/settingsRegistry.ts b/src/web-ui/src/app/scenes/settings/settingsRegistry.ts
index 95cc841c70..669a942537 100644
--- a/src/web-ui/src/app/scenes/settings/settingsRegistry.ts
+++ b/src/web-ui/src/app/scenes/settings/settingsRegistry.ts
@@ -419,6 +419,7 @@ export const SETTINGS_PAGE_MANIFESTS: readonly SettingsPageManifest[] = [
       phrase('settings/runtime', 'browserLinks.defaultTarget'),
       phrase('settings/runtime', 'browserLinks.builtin'),
       phrase('settings/runtime', 'browserLinks.external'),
+      phrase('settings/runtime', 'browserLinks.browserTab'),
       phrase('settings/runtime', 'browserControl.sectionTitle'),
       phrase('settings/runtime', 'browserControl.preferredBrowser'),
       phrase('settings/runtime', 'browserControl.autoConnectOnStartup'),
diff --git a/src/web-ui/src/infrastructure/api/service-api/SystemAPI.test.ts b/src/web-ui/src/infrastructure/api/service-api/SystemAPI.test.ts
index ef352e0f77..eb5e7d59b9 100644
--- a/src/web-ui/src/infrastructure/api/service-api/SystemAPI.test.ts
+++ b/src/web-ui/src/infrastructure/api/service-api/SystemAPI.test.ts
@@ -6,6 +6,8 @@ const copyTextToClipboardMock = vi.hoisted(() => vi.fn());
 const controllerInvoke = vi.hoisted(() => vi.fn());
 const localVersion = vi.hoisted(() => vi.fn());
 const openUrlMock = vi.hoisted(() => vi.fn());
+const isTauriRuntimeMock = vi.hoisted(() => vi.fn(() => true));
+vi.mock('@/infrastructure/runtime', () => ({ isTauriRuntime: isTauriRuntimeMock }));
 vi.mock('@tauri-apps/plugin-opener', () => ({ openUrl: openUrlMock }));
 vi.mock('@tauri-apps/api/core', () => ({ invoke: controllerInvoke }));
 vi.mock('@tauri-apps/api/app', () => ({ getVersion: localVersion }));
@@ -30,6 +32,7 @@ describe('SystemAPI', () => {
     controllerInvoke.mockReset();
     localVersion.mockReset();
     openUrlMock.mockReset();
+    isTauriRuntimeMock.mockReturnValue(true);
   });
 
   afterEach(() => {
@@ -45,6 +48,31 @@ describe('SystemAPI', () => {
     expect(controllerInvoke).not.toHaveBeenCalled();
   });
 
+  it('opens web-client links synchronously in a controller tab without desktop or peer calls', async () => {
+    isTauriRuntimeMock.mockReturnValue(false);
+    const open = vi.fn();
+    vi.stubGlobal('window', { open });
+    const url = 'https://example.com/docs';
+    const opened = systemAPI.openExternal(url);
+    expect(open).toHaveBeenCalledExactlyOnceWith(url, '_blank', 'noopener,noreferrer');
+    await opened;
+    expect(openUrlMock).not.toHaveBeenCalled();
+    expect(invokeMock).not.toHaveBeenCalled();
+    expect(controllerInvoke).not.toHaveBeenCalled();
+  });
+
+  it.each(['javascript:alert(1)', 'data:text/html,test', 'file:///private/file', '/relative-path'])(
+    'rejects unsupported web-client URL %s', async url => {
+      isTauriRuntimeMock.mockReturnValue(false);
+      const open = vi.fn();
+      vi.stubGlobal('window', { open });
+      await expect(systemAPI.openExternal(url)).rejects.toThrow('Failed to open external URL');
+      expect(open).not.toHaveBeenCalled();
+      expect(openUrlMock).not.toHaveBeenCalled();
+      expect(invokeMock).not.toHaveBeenCalled();
+    },
+  );
+
   it.each([true, false])('allows explicit update checks with DEV=%s', async development => {
     vi.stubEnv('DEV', development);
     const response = {
diff --git a/src/web-ui/src/infrastructure/api/service-api/SystemAPI.ts b/src/web-ui/src/infrastructure/api/service-api/SystemAPI.ts
index 5958162d8b..7ab1bd2f19 100644
--- a/src/web-ui/src/infrastructure/api/service-api/SystemAPI.ts
+++ b/src/web-ui/src/infrastructure/api/service-api/SystemAPI.ts
@@ -4,6 +4,7 @@ import { api } from './ApiClient';
 import { createTauriCommandError } from '../errors/TauriCommandError';
 import { copyTextToClipboard } from '@/shared/utils/textSelection';
 import { openUrl } from '@tauri-apps/plugin-opener';
+import { isTauriRuntime } from '@/infrastructure/runtime';
 import { createLogger } from '@/shared/utils/logger';
 import { productControlAPI } from './ProductControlAPI';
 import {
@@ -158,7 +159,16 @@ export class SystemAPI {
    
   async openExternal(url: string): Promise<void> {
     try {
-      await openUrl(url);
+      if (isTauriRuntime()) {
+        await openUrl(url);
+      } else {
+        const protocol = new URL(url).protocol;
+        if (!['http:', 'https:', 'mailto:', 'tel:'].includes(protocol) || typeof window === 'undefined') {
+          throw new Error('This URL cannot be opened in the web client');
+        }
+        // Open synchronously within the click gesture, on the controller browser.
+        window.open(url, '_blank', 'noopener,noreferrer');
+      }
     } catch (error) {
       log.error('Failed to open external URL', { url, error });
       throw new Error(`Failed to open external URL: ${error}`);
diff --git a/src/web-ui/src/infrastructure/config/services/browserLinkPreference.test.ts b/src/web-ui/src/infrastructure/config/services/browserLinkPreference.test.ts
index c5928ac672..1f2114dd7a 100644
--- a/src/web-ui/src/infrastructure/config/services/browserLinkPreference.test.ts
+++ b/src/web-ui/src/infrastructure/config/services/browserLinkPreference.test.ts
@@ -1,5 +1,6 @@
-import { describe, expect, it, vi } from 'vitest';
-import { BROWSER_LINK_TARGET_STORAGE_KEY, createBrowserLinkPreferenceStore } from './browserLinkPreference';
+// @vitest-environment jsdom
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { BROWSER_LINK_TARGET_STORAGE_KEY, browserLinkPreferenceStore, createBrowserLinkPreferenceStore } from './browserLinkPreference';
 
 function storage(value: string | null = null) {
   let saved = value;
@@ -7,6 +8,12 @@ function storage(value: string | null = null) {
 }
 
 describe('controller browser link preference', () => {
+  afterEach(() => {
+    vi.restoreAllMocks();
+    localStorage.removeItem(BROWSER_LINK_TARGET_STORAGE_KEY);
+    browserLinkPreferenceStore.setState({ target: 'builtin' });
+  });
+
   it.each([null, '', 'builtin', 'future-target'])('reads an older or unknown record %j without rewriting it', value => {
     const persisted = storage(value);
     expect(createBrowserLinkPreferenceStore(persisted).getState().target).toBe('builtin');
@@ -33,4 +40,33 @@ describe('controller browser link preference', () => {
     store.getState().setTarget('external');
     expect(store.getState().target).toBe('external');
   });
+
+  it('follows the latest choice from another window without writing it back', () => {
+    localStorage.setItem(BROWSER_LINK_TARGET_STORAGE_KEY, 'external');
+    const write = vi.spyOn(Storage.prototype, 'setItem');
+    window.dispatchEvent(new StorageEvent('storage', {
+      storageArea: localStorage, key: BROWSER_LINK_TARGET_STORAGE_KEY, newValue: 'builtin',
+    }));
+    expect(browserLinkPreferenceStore.getState().target).toBe('external');
+    expect(write).not.toHaveBeenCalled();
+
+    localStorage.removeItem(BROWSER_LINK_TARGET_STORAGE_KEY);
+    window.dispatchEvent(new StorageEvent('storage', { storageArea: localStorage, key: null }));
+    expect(browserLinkPreferenceStore.getState().target).toBe('builtin');
+    expect(write).not.toHaveBeenCalled();
+  });
+
+  it('ignores unrelated keys and session storage events', () => {
+    browserLinkPreferenceStore.setState({ target: 'external' });
+    window.dispatchEvent(new StorageEvent('storage', { storageArea: localStorage, key: 'other-preference' }));
+    window.dispatchEvent(new StorageEvent('storage', { storageArea: sessionStorage, key: BROWSER_LINK_TARGET_STORAGE_KEY }));
+    expect(browserLinkPreferenceStore.getState().target).toBe('external');
+  });
+
+  it('preserves the current choice when a cross-window refresh cannot read storage', () => {
+    browserLinkPreferenceStore.setState({ target: 'external' });
+    vi.spyOn(Storage.prototype, 'getItem').mockImplementation(() => { throw Error('unavailable'); });
+    window.dispatchEvent(new StorageEvent('storage', { storageArea: localStorage, key: BROWSER_LINK_TARGET_STORAGE_KEY }));
+    expect(browserLinkPreferenceStore.getState().target).toBe('external');
+  });
 });
diff --git a/src/web-ui/src/infrastructure/config/services/browserLinkPreference.ts b/src/web-ui/src/infrastructure/config/services/browserLinkPreference.ts
index 39d2d318d6..6a841ba089 100644
--- a/src/web-ui/src/infrastructure/config/services/browserLinkPreference.ts
+++ b/src/web-ui/src/infrastructure/config/services/browserLinkPreference.ts
@@ -30,4 +30,18 @@ export function createBrowserLinkPreferenceStore(storage = controllerStorage())
   }));
 }
 
-export const browserLinkPreferenceStore = createBrowserLinkPreferenceStore();
+const storage = controllerStorage();
+export const browserLinkPreferenceStore = createBrowserLinkPreferenceStore(storage);
+
+if (typeof window !== 'undefined' && storage) {
+  const onStorage = (event: StorageEvent) => {
+    if (event.storageArea !== storage || (event.key !== null && event.key !== BROWSER_LINK_TARGET_STORAGE_KEY)) return;
+    try {
+      // Read the latest value: an older queued event must not undo a newer choice.
+      const saved = storage.getItem(BROWSER_LINK_TARGET_STORAGE_KEY);
+      browserLinkPreferenceStore.setState({ target: saved === 'external' ? 'external' : 'builtin' });
+    } catch { /* Preserve the current choice if storage is temporarily unavailable. */ }
+  };
+  window.addEventListener('storage', onStorage);
+  import.meta.hot?.dispose(() => window.removeEventListener('storage', onStorage));
+}
diff --git a/src/web-ui/src/locales/en-US/settings/runtime.json b/src/web-ui/src/locales/en-US/settings/runtime.json
index 7e083225fd..b4d2373e50 100644
--- a/src/web-ui/src/locales/en-US/settings/runtime.json
+++ b/src/web-ui/src/locales/en-US/settings/runtime.json
@@ -201,7 +201,8 @@
     "defaultTarget": "Open links by default in",
     "description": "Choose the browser for web links clicked in conversations. Applies only to this device; the context menu still lets you choose for each link.",
     "builtin": "Built-in browser",
-    "external": "System default browser"
+    "external": "System default browser",
+    "browserTab": "Current browser (new tab)"
   },
   "browserControl": {
     "sectionTitle": "Browser control",
diff --git a/src/web-ui/src/locales/zh-CN/settings/runtime.json b/src/web-ui/src/locales/zh-CN/settings/runtime.json
index 27884970da..94116a4d8f 100644
--- a/src/web-ui/src/locales/zh-CN/settings/runtime.json
+++ b/src/web-ui/src/locales/zh-CN/settings/runtime.json
@@ -201,7 +201,8 @@
     "defaultTarget": "默认打开方式",
     "description": "选择点击对话中的网页链接时使用的浏览器。仅对当前设备生效，右键菜单仍可单独选择。",
     "builtin": "内置浏览器",
-    "external": "系统默认浏览器"
+    "external": "系统默认浏览器",
+    "browserTab": "当前浏览器（新标签页）"
   },
   "browserControl": {
     "sectionTitle": "浏览器控制",
diff --git a/src/web-ui/src/locales/zh-TW/settings/runtime.json b/src/web-ui/src/locales/zh-TW/settings/runtime.json
index f1b44fc74b..18a9ba7b6d 100644
--- a/src/web-ui/src/locales/zh-TW/settings/runtime.json
+++ b/src/web-ui/src/locales/zh-TW/settings/runtime.json
@@ -201,7 +201,8 @@
     "defaultTarget": "預設開啟方式",
     "description": "選擇點擊對話中的網頁連結時使用的瀏覽器。僅對目前裝置生效，右鍵選單仍可單獨選擇。",
     "builtin": "內建瀏覽器",
-    "external": "系統預設瀏覽器"
+    "external": "系統預設瀏覽器",
+    "browserTab": "目前瀏覽器（新分頁）"
   },
   "browserControl": {
     "sectionTitle": "瀏覽器控制",

From 63fff913b59e6c5b1bb15bedc29f239896065af4 Mon Sep 17 00:00:00 2001
From: Bob Lee <liwenbo628@gmail.com>
Date: Fri, 6 Nov 2026 19:33:54 +0800
Subject: [PATCH 3/3] test(settings): scope browser controls and cover offline
 link preferences

---
 src/web-ui/src/app/scenes/settings/AGENTS.md  |  2 +-
 .../pages/shared/RuntimeSettings.test.tsx     | 41 ++++++++++++++++---
 2 files changed, 37 insertions(+), 6 deletions(-)

diff --git a/src/web-ui/src/app/scenes/settings/AGENTS.md b/src/web-ui/src/app/scenes/settings/AGENTS.md
index 5ec15670ac..09f0eb7083 100644
--- a/src/web-ui/src/app/scenes/settings/AGENTS.md
+++ b/src/web-ui/src/app/scenes/settings/AGENTS.md
@@ -47,7 +47,7 @@ Follow the parent guide for `check:web`, i18n, and Appearance registration check
 For the controller-local web link preference, persistence and explicit browser actions:
 
 ```bash
-pnpm --dir src/web-ui run test:run src/infrastructure/config/services/browserLinkPreference.test.ts src/infrastructure/markdown/MarkdownRenderer.test.tsx src/infrastructure/api/service-api/SystemAPI.test.ts src/app/scenes/settings/settingsRegistry.test.ts src/infrastructure/config/components/common/SettingsControlSizing.test.ts
+pnpm --dir src/web-ui run test:run src/infrastructure/config/services/browserLinkPreference.test.ts src/infrastructure/markdown/MarkdownRenderer.test.tsx src/infrastructure/api/service-api/SystemAPI.test.ts src/app/scenes/settings/settingsRegistry.test.ts src/app/scenes/settings/pages/shared/RuntimeSettings.test.tsx src/infrastructure/config/components/common/SettingsControlSizing.test.ts
 ```
 
 The link preference remains editable independently of host control status. These
diff --git a/src/web-ui/src/app/scenes/settings/pages/shared/RuntimeSettings.test.tsx b/src/web-ui/src/app/scenes/settings/pages/shared/RuntimeSettings.test.tsx
index ae4b5a2306..0adcbe110e 100644
--- a/src/web-ui/src/app/scenes/settings/pages/shared/RuntimeSettings.test.tsx
+++ b/src/web-ui/src/app/scenes/settings/pages/shared/RuntimeSettings.test.tsx
@@ -5,6 +5,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import DeviceControlSettingsPage from '../tools/DeviceControlSettingsPage';
 import ExecutionSettingsPage from '../ai/ExecutionSettingsPage';
 import WorkspaceSearchSection from '../development/WorkspaceSearchSection';
+import { BROWSER_LINK_TARGET_STORAGE_KEY, browserLinkPreferenceStore } from '@/infrastructure/config/services/browserLinkPreference';
 
 const mocks = vi.hoisted(() => {
   Object.defineProperty(window, '__TAURI__', { configurable: true, value: {} });
@@ -55,10 +56,15 @@ let status = { ...readyStatus };
 let container: HTMLDivElement;
 let root: Root;
 const button = (label: string) => Array.from(container.querySelectorAll('button')).find(el => el.textContent === label || el.getAttribute('aria-label') === label)!;
+const selectFor = (label: string) => Array.from(container.querySelectorAll('[data-openbitfun-part="row"]'))
+  .find(row => row.querySelector('[data-openbitfun-part="rowLabel"]')?.textContent === label)
+  ?.querySelector<HTMLSelectElement>('select') ?? null;
 const render = async () => { await act(async () => root.render(<DeviceControlSettingsPage />)); };
 
 beforeEach(() => {
   mocks.workspace = null;
+  browserLinkPreferenceStore.setState({ target: 'builtin' });
+  localStorage.removeItem(BROWSER_LINK_TARGET_STORAGE_KEY);
   (globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
   status = { ...readyStatus };
   mocks.getConfig.mockReset().mockResolvedValue(null);
@@ -122,7 +128,12 @@ describe('Tool execution concurrency settings', () => {
     expect(mocks.error).toHaveBeenCalledWith('messages.saveFailed: Host rejected the concurrency setting');
   });
 });
-afterEach(async () => { await act(async () => root.unmount()); container.remove(); });
+afterEach(async () => {
+  await act(async () => root.unmount());
+  container.remove();
+  browserLinkPreferenceStore.setState({ target: 'builtin' });
+  localStorage.removeItem(BROWSER_LINK_TARGET_STORAGE_KEY);
+});
 
 describe('Browser and desktop control settings', () => {
   it('keeps detailed host permissions in the standard compact settings rows', async () => {
@@ -171,7 +182,7 @@ describe('Browser and desktop control settings', () => {
   });
   it('localizes the browser choice and puts the single connect action next to connection status', async () => {
     await render();
-    expect(container.querySelector('option')?.textContent).toBe('browserControl.defaultBrowser');
+    expect(selectFor('browserControl.preferredBrowser')?.querySelector('option')?.textContent).toBe('browserControl.defaultBrowser');
     const connect = button('browserControl.connect');
     expect(connect.closest('[data-openbitfun-part="row"]')?.textContent).toContain('browserControl.status');
     expect(container.textContent).toContain('browserControl.readyNotConnected');
@@ -220,7 +231,7 @@ describe('Browser and desktop control settings', () => {
     });
     mocks.setConfig.mockImplementation(async () => { order.push('save'); });
     await render();
-    const select = container.querySelector('select')!;
+    const select = selectFor('browserControl.preferredBrowser')!;
     await act(async () => {
       select.value = 'edge';
       select.dispatchEvent(new Event('change', { bubbles: true }));
@@ -237,7 +248,7 @@ describe('Browser and desktop control settings', () => {
   it('keeps the selected browser visible while connected and disconnects through the existing command', async () => {
     status.cdpAvailable = true;
     await render();
-    expect(container.querySelector('select')?.disabled).toBe(true);
+    expect(selectFor('browserControl.preferredBrowser')?.disabled).toBe(true);
     expect(container.textContent).toContain('browserControl.connected');
     expect(container.textContent).toContain('Chrome · 3');
     await act(async () => button('browserControl.disconnect').click());
@@ -261,7 +272,27 @@ describe('Browser and desktop control settings', () => {
     await render();
     expect(container.textContent).toContain('computerUse.peerUnsupported');
     expect(container.textContent).toContain('browserControl.peerUnsupported');
-    expect(container.querySelector('select')).toBeNull();
+    expect(selectFor('browserControl.preferredBrowser')).toBeNull();
+    expect(selectFor('browserLinks.defaultTarget')?.disabled).toBe(false);
+  });
+
+  it('saves the controller link preference while host configuration is unavailable', async () => {
+    mocks.getConfig.mockRejectedValue(new Error('Host is offline'));
+    await render();
+    expect(container.textContent).toContain('loading.failed');
+    const select = selectFor('browserLinks.defaultTarget')!;
+    expect(select.disabled).toBe(false);
+    expect(select.value).toBe('builtin');
+    mocks.invoke.mockClear();
+
+    await act(async () => {
+      select.value = 'external';
+      select.dispatchEvent(new Event('change', { bubbles: true }));
+    });
+    expect(browserLinkPreferenceStore.getState().target).toBe('external');
+    expect(localStorage.getItem(BROWSER_LINK_TARGET_STORAGE_KEY)).toBe('external');
+    expect(mocks.setConfig).not.toHaveBeenCalled();
+    expect(mocks.invoke).not.toHaveBeenCalled();
   });
 });