Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

feat(settings): add the My browser extension right from Settings

Dash836189aca102
diff --git a/apps/desktop/src/main/mcp-integrations/browser-backend/__tests__/open-extension-store.test.ts b/apps/desktop/src/main/mcp-integrations/browser-backend/__tests__/open-extension-store.test.ts
new file mode 100644
index 0000000000..6f88ea68a8
--- /dev/null
+++ b/apps/desktop/src/main/mcp-integrations/browser-backend/__tests__/open-extension-store.test.ts
@@ -0,0 +1,41 @@
+import { describe, expect, it, vi } from 'vitest';
+
+import { RECOMMENDED_PAGE_CONTROL_EXTENSION_STORE_URL } from '../../../../shared/browserBackend.js';
+import { RealProfileError } from '../../browser-real-profile/types.js';
+import { openExtensionStoreInUserBrowser } from '../open-extension-store.js';
+
+// Settings installs the My browser extension from the store page opened in the user's own
+// browser, instead of sending them to the plugin page first.
+describe('openExtensionStoreInUserBrowser', () => {
+ it('opens the store page in the running macOS browser app', async () => {
+ const launch = vi.fn(async () => undefined);
+ const result = await openExtensionStoreInUserBrowser({
+ platform: 'darwin',
+ resolveBrowser: () => ({
+ kind: 'edge',
+ executablePath: '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+ userDataDir: '/u',
+ }),
+ launch,
+ });
+ expect(result).toEqual({ ok: true });
+ expect(launch).toHaveBeenCalledWith('/usr/bin/open', [
+ '-a',
+ '/Applications/Microsoft Edge.app',
+ RECOMMENDED_PAGE_CONTROL_EXTENSION_STORE_URL,
+ ]);
+ });
+
+ it('reports a missing browser so Settings can fall back to the plugin page', async () => {
+ const launch = vi.fn();
+ const result = await openExtensionStoreInUserBrowser({
+ platform: 'win32',
+ resolveBrowser: () => {
+ throw new RealProfileError('NO_CHROMIUM', 'none');
+ },
+ launch,
+ });
+ expect(result).toEqual({ ok: false, error: 'NO_CHROMIUM' });
+ expect(launch).not.toHaveBeenCalled();
+ });
+});
diff --git a/apps/desktop/src/main/mcp-integrations/browser-backend/__tests__/settings-ipc.test.ts b/apps/desktop/src/main/mcp-integrations/browser-backend/__tests__/settings-ipc.test.ts
index 19a52fb0cc..bbaeea5351 100644
--- a/apps/desktop/src/main/mcp-integrations/browser-backend/__tests__/settings-ipc.test.ts
+++ b/apps/desktop/src/main/mcp-integrations/browser-backend/__tests__/settings-ipc.test.ts
@@ -33,6 +33,7 @@ function buildHandlers() {
},
})),
probeSourceRead: vi.fn(() => ({ readable: true })),
+ openExtensionStore: vi.fn(async () => ({ ok: true as const })),
};
return {
trustedEvent,
diff --git a/apps/desktop/src/main/mcp-integrations/browser-backend/open-extension-store.ts b/apps/desktop/src/main/mcp-integrations/browser-backend/open-extension-store.ts
new file mode 100644
index 0000000000..6f38836ff4
--- /dev/null
+++ b/apps/desktop/src/main/mcp-integrations/browser-backend/open-extension-store.ts
@@ -0,0 +1,58 @@
+import { execFile, spawn } from 'node:child_process';
+
+import {
+ RECOMMENDED_PAGE_CONTROL_EXTENSION_STORE_URL,
+ type BrowserExtensionStoreOpenResult,
+} from '../../../shared/browserBackend.js';
+import type { InstalledChromium } from '../browser-real-profile/types.js';
+
+export interface OpenExtensionStoreDeps {
+ platform?: NodeJS.Platform;
+ /** The user's default Chromium browser, else the first installed one; throws when none. */
+ resolveBrowser: () => InstalledChromium;
+ launch?: (file: string, args: string[]) => Promise<void>;
+}
+
+function defaultLaunch(file: string, args: string[]): Promise<void> {
+ if (file === '/usr/bin/open') {
+ return new Promise((resolve, reject) => {
+ execFile(file, args, { timeout: 15_000 }, (error) => (error ? reject(error) : resolve()));
+ });
+ }
+ return new Promise((resolve, reject) => {
+ const child = spawn(file, args, { detached: true, stdio: 'ignore' });
+ child.once('error', reject);
+ child.once('spawn', () => {
+ child.unref();
+ resolve();
+ });
+ });
+}
+
+/**
+ * Open the official Cindy extension's store page in the browser the user actually uses, so
+ * "My browser" can be finished from Settings. The store still asks the user to confirm Add;
+ * Settings notices the connection on its own once the extension is in.
+ */
+export async function openExtensionStoreInUserBrowser(
+ deps: OpenExtensionStoreDeps,
+): Promise<BrowserExtensionStoreOpenResult> {
+ let browser: InstalledChromium;
+ try {
+ browser = deps.resolveBrowser();
+ } catch {
+ return { ok: false, error: 'NO_CHROMIUM' };
+ }
+ const platform = deps.platform ?? process.platform;
+ const launch = deps.launch ?? defaultLaunch;
+ const url = RECOMMENDED_PAGE_CONTROL_EXTENSION_STORE_URL;
+ // On macOS hand the URL to the app bundle so an already running browser opens it as a tab.
+ const appBundle = platform === 'darwin' ? /^(.*?\.app)\//.exec(browser.executablePath)?.[1] : undefined;
+ try {
+ if (appBundle) await launch('/usr/bin/open', ['-a', appBundle, url]);
+ else await launch(browser.executablePath, [url]);
+ return { ok: true };
+ } catch {
+ return { ok: false, error: 'OPEN_FAILED' };
+ }
+}
diff --git a/apps/desktop/src/main/mcp-integrations/browser-backend/settings-ipc.ts b/apps/desktop/src/main/mcp-integrations/browser-backend/settings-ipc.ts
index 7bd9e93b1a..8640feb0a6 100644
--- a/apps/desktop/src/main/mcp-integrations/browser-backend/settings-ipc.ts
+++ b/apps/desktop/src/main/mcp-integrations/browser-backend/settings-ipc.ts
@@ -1,4 +1,5 @@
import type {
+ BrowserExtensionStoreOpenResult,
BrowserBackendHealth,
BrowserBackendRecoveryResult,
BrowserBackendSourceReadAccess,
@@ -34,6 +35,7 @@ interface BrowserBackendIpcDeps<Event> {
getHealth(): Promise<BrowserBackendHealth>;
recover(): Promise<BrowserBackendRecoveryResult>;
probeSourceRead(): BrowserBackendSourceReadAccess;
+ openExtensionStore(): Promise<BrowserExtensionStoreOpenResult>;
}
/** Pure handler factory so trust gates and response contracts stay testable. */
@@ -79,5 +81,9 @@ export function createBrowserBackendIpcHandlers<Event>(deps: BrowserBackendIpcDe
deps.assertTrusted(event);
return deps.probeSourceRead();
},
+ openExtensionStore(event: Event) {
+ deps.assertTrusted(event);
+ return deps.openExtensionStore();
+ },
};
}
diff --git a/apps/desktop/src/main/mcp-integrations/browser.ts b/apps/desktop/src/main/mcp-integrations/browser.ts
index cba7ae0a1c..8528cad7d4 100644
--- a/apps/desktop/src/main/mcp-integrations/browser.ts
+++ b/apps/desktop/src/main/mcp-integrations/browser.ts
@@ -72,6 +72,7 @@ import {
isRealProfileError,
probeOsSourceProfileReadAccess,
readCopiedLoginsCdpPort,
+ resolveSourceBrowserFromOs,
wrapRuntimeWithRealProfile,
wrapRuntimeWithProfileLifecycleQueue,
activeManagedProfileName,
@@ -79,6 +80,7 @@ import {
import { assertTrustedAppRendererEvent } from '../security/trustedAppRenderer.js';
import { createBrowserBackendIpcHandlers } from './browser-backend/settings-ipc.js';
import { readCdpBrowserCommandLine } from './browser-backend/proxy-auth.js';
+import { openExtensionStoreInUserBrowser } from './browser-backend/open-extension-store.js';
import { resolveBrowserScreenshot } from './browserScreenshotResolver.js';
import { compressInlineImage } from './inlineImageCompressor.js';
import { raiseAgentBrowserWindow } from './raise-agent-browser-window.js';
@@ -697,6 +699,8 @@ export function registerBrowserBackendIpc(): void {
getHealth: getBrowserBackendHealth,
recover: recoverActiveBrowserBackend,
probeSourceRead: () => probeOsSourceProfileReadAccess(),
+ openExtensionStore: () =>
+ openExtensionStoreInUserBrowser({ resolveBrowser: () => resolveSourceBrowserFromOs() }),
});
ipcMain.handle('browser-backend:get-state', handlers.getState);
ipcMain.handle('browser-backend:set-kind', handlers.setKind);
@@ -705,6 +709,7 @@ export function registerBrowserBackendIpc(): void {
ipcMain.handle('browser-backend:get-health', handlers.getHealth);
ipcMain.handle('browser-backend:recover', handlers.recover);
ipcMain.handle('browser-backend:probe-source-read', handlers.probeSourceRead);
+ ipcMain.handle('browser-backend:open-extension-store', handlers.openExtensionStore);
ipcMain.handle('rsb-browser-bridge:set-active-session', (_e, payload: unknown) => {
const obj = requireObject(payload, 'set-active-session payload');
diff --git a/apps/desktop/src/preload/preload.ts b/apps/desktop/src/preload/preload.ts
index 0dff6ea503..e516819d32 100644
--- a/apps/desktop/src/preload/preload.ts
+++ b/apps/desktop/src/preload/preload.ts
@@ -6331,6 +6331,10 @@ contextBridge.exposeInMainWorld('electronAPI', {
/** Open-only FDA probe. Returns `{ readable }` — never paths or cookie bytes. */
probeSourceRead: (): Promise<{ readable: boolean }> =>
ipcRenderer.invoke('browser-backend:probe-source-read'),
+ /** Open the official Cindy extension's store page in the user's own browser. */
+ openExtensionStore: (): Promise<
+ import('../shared/browserBackend').BrowserExtensionStoreOpenResult
+ > => ipcRenderer.invoke('browser-backend:open-extension-store'),
},
// electronAPI.codex.* 已退役 —— auth / agent status / usage 全部走 electronAPI.maker.*(agentKind),
diff --git a/apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx b/apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx
index a5bf890719..d1c006278f 100644
--- a/apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx
+++ b/apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx
@@ -477,6 +477,18 @@ export function ComputerUseSection({ workingDir }: ComputerUseSectionProps) {
? `/plugins?ghost=${encodeURIComponent(installedGhostStoragePart(userBrowserPlugin))}`
: '/plugins',
);
+ if (browserBackendHealth?.reason === 'extension-disconnected') {
+ // Open the store page in the user's own browser; the page polls and turns connected once the
+ // extension is added. Without a Chromium browser, the plugin page explains the other routes.
+ setUserBrowserSetupBusy(true);
+ const opened = await window.electronAPI.browserBackend
+ .openExtensionStore?.()
+ .catch(() => null);
+ setUserBrowserSetupBusy(false);
+ if (opened?.ok) toast.success(t('settings.computerUse.browserBackend.userBrowserSetup.storeOpened'));
+ else openPluginPage();
+ return;
+ }
if (browserBackendHealth?.reason !== 'plugin-missing' || userBrowserPlugin?.enabled) {
openPluginPage();
return;
diff --git a/apps/desktop/src/renderer/components/settings/__tests__/ComputerUseSection.browserHealth.test.tsx b/apps/desktop/src/renderer/components/settings/__tests__/ComputerUseSection.browserHealth.test.tsx
index a5c784d2f5..ed77b2cb8b 100644
--- a/apps/desktop/src/renderer/components/settings/__tests__/ComputerUseSection.browserHealth.test.tsx
+++ b/apps/desktop/src/renderer/components/settings/__tests__/ComputerUseSection.browserHealth.test.tsx
@@ -585,4 +585,30 @@ describe('ComputerUseSection browser backend health loading', () => {
await screen.findByRole('switch', { name: 'settings.computerUse.realProfile.toggleAria' }),
).toBeTruthy();
});
+
+ // The extension step finishes in Settings: the store page opens in the user's browser rather
+ // than routing through the plugin page.
+ it('opens the extension store from Settings when only the extension is missing', async () => {
+ const openExtensionStore = vi.fn().mockResolvedValue({ ok: true });
+ Object.assign(window.electronAPI.browserBackend, { openExtensionStore });
+ api.getBackendState.mockResolvedValue({ active: 'user-browser' });
+ api.getBackendHealth.mockResolvedValue({
+ active: 'user-browser',
+ status: 'error',
+ reason: 'extension-disconnected',
+ canRecover: false,
+ });
+
+ render(<ComputerUseSection workingDir="/tmp/project" />);
+ fireEvent.click(
+ await screen.findByRole('button', {
+ name: 'settings.computerUse.browserBackend.userBrowserSetup.installExtension',
+ }),
+ );
+
+ await waitFor(() => expect(openExtensionStore).toHaveBeenCalledTimes(1));
+ expect(api.successToast).toHaveBeenCalledWith(
+ 'settings.computerUse.browserBackend.userBrowserSetup.storeOpened',
+ );
+ });
});
diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.json
index 294d0cd917..ca63b7cd97 100644
--- a/apps/desktop/src/renderer/i18n/locales/en/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json
@@ -5310,17 +5310,18 @@
"description": "Works in the Chrome or Edge you are using, with your existing sign-ins. New pages open in a background window and stay out of your way."
},
"userBrowserSetup": {
- "installPluginTitle": "Step 1: Install the Cindy Chrome plugin",
- "enablePluginTitle": "Step 1: Turn on the Cindy Chrome plugin",
- "installExtensionTitle": "Step 2: Add the Cindy extension to your browser",
+ "installPluginTitle": "Install the Cindy Chrome plugin",
+ "enablePluginTitle": "Turn on the Cindy Chrome plugin",
+ "installExtensionTitle": "Add the Cindy extension to your browser",
"pluginBody": "My browser reaches your Chrome or Edge through the Cindy Chrome plugin and its browser extension. Install the plugin in Cindy first, then follow its prompt to add the extension.",
- "extensionBody": "Add the Cindy extension in Chrome or Edge; this turns to connected on its own once it is in. Already added? Turn it on in the browser’s extension settings, or reload it.",
+ "extensionBody": "Add browser extension opens the Cindy extension’s store page in your browser; choose Add and this turns to connected on its own. Already added? Turn it on in the browser’s extension settings.",
"installPlugin": "Install plugin",
"enablePlugin": "Turn on",
"installExtension": "Add browser extension",
- "updatePluginTitle": "Step 1: Update the Cindy Chrome plugin",
+ "updatePluginTitle": "Update the Cindy Chrome plugin",
"updatePluginBody": "The installed Cindy Chrome plugin is too old for My browser. Update it to the latest version, then follow its prompt to add the extension.",
- "updatePlugin": "Update"
+ "updatePlugin": "Update",
+ "storeOpened": "Opened the Cindy extension page in your browser. Choose Add to Chrome and it connects on its own."
}
},
"android": {
diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.json
index 18051168cf..49a9473d63 100644
--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json
@@ -5278,17 +5278,18 @@
"description": "使用中の Chrome / Edge をそのまま操作し、既存のログインを使います。新しいページはバックグラウンドのウィンドウで開き、邪魔をしません。"
},
"userBrowserSetup": {
- "installPluginTitle": "ステップ 1:Cindy Chrome プラグインをインストール",
- "enablePluginTitle": "ステップ 1:Cindy Chrome プラグインを有効にする",
- "installExtensionTitle": "ステップ 2:ブラウザに Cindy 拡張機能を追加",
+ "installPluginTitle": "Cindy Chrome プラグインをインストール",
+ "enablePluginTitle": "Cindy Chrome プラグインを有効にする",
+ "installExtensionTitle": "ブラウザに Cindy 拡張機能を追加",
"pluginBody": "「自分のブラウザ」は Cindy Chrome プラグインとそのブラウザ拡張機能を通じて Chrome / Edge に接続します。まず Cindy でプラグインをインストールし、案内に従って拡張機能を追加してください。",
- "extensionBody": "Chrome または Edge に Cindy 拡張機能を追加すると、ここは自動的に「接続済み」になります。追加済みの場合は、ブラウザの拡張機能管理で有効にするか、再読み込みしてください。",
+ "extensionBody": "「ブラウザ拡張機能を追加」を押すと、使用中のブラウザで Cindy 拡張機能のストアページが開きます。「追加」を押すと、ここは自動的に「接続済み」になります。追加済みの場合は、ブラウザの拡張機能管理で有効にしてください。",
"installPlugin": "プラグインをインストール",
"enablePlugin": "有効にする",
"installExtension": "ブラウザ拡張機能を追加",
- "updatePluginTitle": "ステップ 1:Cindy Chrome プラグインを更新",
+ "updatePluginTitle": "Cindy Chrome プラグインを更新",
"updatePluginBody": "インストール済みの Cindy Chrome プラグインは古く、「自分のブラウザ」に対応していません。最新版に更新してから、案内に従って拡張機能を追加してください。",
- "updatePlugin": "更新する"
+ "updatePlugin": "更新する",
+ "storeOpened": "ブラウザで Cindy 拡張機能のページを開きました。「Chrome に追加」を押すと自動的に接続されます"
}
},
"android": {
diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.json
index 9ac261f508..2a5f9d273d 100644
--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json
@@ -5278,17 +5278,18 @@
"description": "사용 중인 Chrome 또는 Edge를 기존 로그인 그대로 조작합니다. 새 페이지는 백그라운드 창에서 열려 방해하지 않습니다."
},
"userBrowserSetup": {
- "installPluginTitle": "1단계: Cindy Chrome 플러그인 설치",
- "enablePluginTitle": "1단계: Cindy Chrome 플러그인 켜기",
- "installExtensionTitle": "2단계: 브라우저에 Cindy 확장 추가",
+ "installPluginTitle": "Cindy Chrome 플러그인 설치",
+ "enablePluginTitle": "Cindy Chrome 플러그인 켜기",
+ "installExtensionTitle": "브라우저에 Cindy 확장 추가",
"pluginBody": "내 브라우저는 Cindy Chrome 플러그인과 그 브라우저 확장을 통해 Chrome / Edge에 연결됩니다. 먼저 Cindy에서 플러그인을 설치한 뒤 안내에 따라 확장을 추가하세요.",
- "extensionBody": "Chrome 또는 Edge에 Cindy 확장을 추가하면 이곳이 자동으로 연결됨으로 바뀝니다. 이미 추가했다면 브라우저의 확장 관리에서 켜거나 새로고침하세요.",
+ "extensionBody": "‘브라우저 확장 추가’를 누르면 사용 중인 브라우저에서 Cindy 확장의 스토어 페이지가 열립니다. ‘추가’를 누르면 이곳이 자동으로 연결됨으로 바뀝니다. 이미 추가했다면 브라우저의 확장 관리에서 켜세요.",
"installPlugin": "플러그인 설치",
"enablePlugin": "켜러 가기",
"installExtension": "브라우저 확장 추가",
- "updatePluginTitle": "1단계: Cindy Chrome 플러그인 업데이트",
+ "updatePluginTitle": "Cindy Chrome 플러그인 업데이트",
"updatePluginBody": "설치된 Cindy Chrome 플러그인이 오래되어 내 브라우저를 지원하지 않습니다. 최신 버전으로 업데이트한 뒤 안내에 따라 확장을 추가하세요.",
- "updatePlugin": "업데이트하러 가기"
+ "updatePlugin": "업데이트하러 가기",
+ "storeOpened": "브라우저에서 Cindy 확장 페이지를 열었습니다. ‘Chrome에 추가’를 누르면 자동으로 연결됩니다"
}
},
"android": {
diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
index 2b212e923b..e6cdd02ac1 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json
@@ -5278,17 +5278,18 @@
"description": "直接操作你正在用的 Chrome 或 Edge,沿用你已有的登录。新页面在后台窗口打开,不打扰你。"
},
"userBrowserSetup": {
- "installPluginTitle": "第 1 步:安装 Cindy Chrome 插件",
- "enablePluginTitle": "第 1 步:启用 Cindy Chrome 插件",
- "installExtensionTitle": "第 2 步:把 Cindy 扩展装进浏览器",
+ "installPluginTitle": "安装 Cindy Chrome 插件",
+ "enablePluginTitle": "启用 Cindy Chrome 插件",
+ "installExtensionTitle": "把 Cindy 扩展装进浏览器",
"pluginBody": "「我的浏览器」通过 Cindy Chrome 插件和它的浏览器扩展连接你的 Chrome / Edge。先在 Cindy 里装好插件,再按提示把扩展装进浏览器。",
- "extensionBody": "在 Chrome 或 Edge 里安装 Cindy 扩展,装好后这里会自动变成已连接。已经装过?在浏览器的扩展管理里启用它,或点一下刷新。",
+ "extensionBody": "点「安装浏览器扩展」会在你的浏览器里打开 Cindy 扩展的商店页面,点「添加」后这里会自动变成已连接。已经装过?在浏览器的扩展管理里启用它。",
"installPlugin": "安装插件",
"enablePlugin": "去启用",
"installExtension": "安装浏览器扩展",
- "updatePluginTitle": "第 1 步:更新 Cindy Chrome 插件",
+ "updatePluginTitle": "更新 Cindy Chrome 插件",
"updatePluginBody": "已装的 Cindy Chrome 插件版本较旧,还不支持「我的浏览器」。更新到最新版后,再按提示把扩展装进浏览器。",
- "updatePlugin": "去更新"
+ "updatePlugin": "去更新",
+ "storeOpened": "已在浏览器里打开 Cindy 扩展页面,点「添加至 Chrome」后会自动连接"
}
},
"android": {
diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
index d041e512ff..28df3682fa 100644
--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json
@@ -5278,17 +5278,18 @@
"description": "直接操作你正在用的 Chrome 或 Edge,沿用你已有的登入。新頁面在背景視窗開啟,不打擾你。"
},
"userBrowserSetup": {
- "installPluginTitle": "第 1 步:安裝 Cindy Chrome 插件",
- "enablePluginTitle": "第 1 步:啟用 Cindy Chrome 插件",
- "installExtensionTitle": "第 2 步:把 Cindy 擴充功能裝進瀏覽器",
+ "installPluginTitle": "安裝 Cindy Chrome 插件",
+ "enablePluginTitle": "啟用 Cindy Chrome 插件",
+ "installExtensionTitle": "把 Cindy 擴充功能裝進瀏覽器",
"pluginBody": "「我的瀏覽器」透過 Cindy Chrome 插件和它的瀏覽器擴充功能連接你的 Chrome / Edge。先在 Cindy 裡裝好插件,再依提示把擴充功能裝進瀏覽器。",
- "extensionBody": "在 Chrome 或 Edge 裡安裝 Cindy 擴充功能,裝好後這裡會自動變成已連線。已經裝過?在瀏覽器的擴充功能管理裡啟用它,或點一下重新整理。",
+ "extensionBody": "點「安裝瀏覽器擴充功能」會在你的瀏覽器裡開啟 Cindy 擴充功能的商店頁面,點「新增」後這裡會自動變成已連線。已經裝過?在瀏覽器的擴充功能管理裡啟用它。",
"installPlugin": "安裝插件",
"enablePlugin": "前往啟用",
"installExtension": "安裝瀏覽器擴充功能",
- "updatePluginTitle": "第 1 步:更新 Cindy Chrome 插件",
+ "updatePluginTitle": "更新 Cindy Chrome 插件",
"updatePluginBody": "已安裝的 Cindy Chrome 插件版本較舊,還不支援「我的瀏覽器」。更新到最新版後,再依提示把擴充功能裝進瀏覽器。",
- "updatePlugin": "前往更新"
+ "updatePlugin": "前往更新",
+ "storeOpened": "已在瀏覽器裡開啟 Cindy 擴充功能頁面,點「加到 Chrome」後會自動連線"
}
},
"android": {
diff --git a/apps/desktop/src/renderer/vite-env.d.ts b/apps/desktop/src/renderer/vite-env.d.ts
index fedcc0afdb..e7fd303e83 100644
--- a/apps/desktop/src/renderer/vite-env.d.ts
+++ b/apps/desktop/src/renderer/vite-env.d.ts
@@ -5522,6 +5522,9 @@ interface ElectronAPI {
recover: () => Promise<BrowserBackendRecoveryResult>;
setUseRealProfile: (enabled: boolean) => Promise<{ ok: true; enabled: boolean }>;
probeSourceRead: () => Promise<BrowserBackendSourceReadAccess>;
+ openExtensionStore?: () => Promise<
+ import('../shared/browserBackend').BrowserExtensionStoreOpenResult
+ >;
};
// ── Dialog(v0.6 新增) ────────────────────────────────────────────────────
diff --git a/apps/desktop/src/shared/browserBackend.ts b/apps/desktop/src/shared/browserBackend.ts
index ab4f750ba7..58f0c7b95b 100644
--- a/apps/desktop/src/shared/browserBackend.ts
+++ b/apps/desktop/src/shared/browserBackend.ts
@@ -92,6 +92,14 @@ export type BrowserBackendHealthReason =
*/
export const RECOMMENDED_PAGE_CONTROL_PLUGIN_ID = 'my-browser';
+/** 官方 Cindy 浏览器扩展的 Chrome 网上应用店页面;设置页直接在用户浏览器里打开它安装扩展。 */
+export const RECOMMENDED_PAGE_CONTROL_EXTENSION_STORE_URL =
+ 'https://chromewebstore.google.com/detail/cindy/dmbhhhdijpeaibfeocdcjhfefkgpkeef';
+
+export type BrowserExtensionStoreOpenResult =
+ | { ok: true }
+ | { ok: false; error: 'NO_CHROMIUM' | 'OPEN_FAILED' };
+
export interface BrowserBackendHealth {
active: BrowserBackendKind;
status: 'ready' | 'error';