Skip to content

Conversation

@zerob13
Copy link
Collaborator

@zerob13 zerob13 commented Oct 15, 2025

Summary

  • run prettier so the About page license link handler matches project formatting

Testing

  • pnpm run typecheck

https://chatgpt.com/codex/tasks/task_e_68ef3c697c90832c9b05510572d7dbae

Summary by CodeRabbit

  • New Features

    • About page links (website, GitHub, LICENSE) now open in your default browser for a smoother experience.
    • Improved external link handling with a safe fallback when the app API isn’t available.
  • Tests

    • Added test support for the new external link behavior via a mock API.

@zerob13
Copy link
Collaborator Author

zerob13 commented Oct 15, 2025

fixed #1013

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Oct 15, 2025

Walkthrough

Introduces a new optional openExternal API exposed from the preload to the renderer, wired to Electron’s shell.openExternal. Updates the AboutUsSettings component to route external link clicks through this API with a window.open fallback. Test setup is extended to mock window.api.openExternal. Type declarations updated accordingly.

Changes

Cohort / File(s) Summary
Preload API definition
src/preload/index.d.ts
Adds optional method signature openExternal?(url: string): Promise<void> to Window.api.
Preload implementation
src/preload/index.ts
Imports shell from electron and exposes api.openExternal(url) delegating to shell.openExternal(url).
Renderer settings UI
src/renderer/settings/components/AboutUsSettings.vue
Adds openExternalLink(url) helper. Routes external anchors (website, GitHub, LICENSE) via window.api.openExternal when present; otherwise falls back to window.open with noopener,noreferrer.
Test setup
test/setup.renderer.ts
Extends window.api mock with openExternal: vi.fn().

Sequence Diagram(s)

sequenceDiagram
  autonumber
  participant U as User
  participant V as Renderer (AboutUsSettings)
  participant P as Preload API (window.api)
  participant S as Electron Shell

  U->>V: Click external link
  V->>V: openExternalLink(url)
  alt window.api.openExternal available
    V->>P: openExternal(url)
    P->>S: shell.openExternal(url)
    S-->>P: Promise resolved
    P-->>V: Promise<void>
  else Fallback
    V->>V: window.open(url, "_blank", "noopener,noreferrer")
  end
Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

A hop, a tap, a link I see,
I boop it open—externally!
Through shells I scurry, swift and neat,
Or window pop, a fallback treat.
With whiskers twitching, tests in tow,
I launch the sites—onward we go! 🐇✨

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Title Check ⚠️ Warning The current title indicates a styling update for the About page link handler, but the changeset actually introduces a new openExternal API in the preload script, updates the AboutUsSettings.vue component to use it for external links, and adds corresponding tests, so the title misrepresents the primary functionality changes. Please revise the title to clearly reflect the functional enhancements, for example “feat(preload): add openExternal API and update About page external link handler.”
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch codex/fix-default-browser-launch-for-external-links

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@zerob13 zerob13 merged commit 508b582 into dev Oct 15, 2025
1 of 2 checks passed
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 0225eab and 2a8da71.

📒 Files selected for processing (4)
  • src/preload/index.d.ts (1 hunks)
  • src/preload/index.ts (2 hunks)
  • src/renderer/settings/components/AboutUsSettings.vue (4 hunks)
  • test/setup.renderer.ts (1 hunks)
🧰 Additional context used
📓 Path-based instructions (13)
src/renderer/**/*.{vue,ts,js,tsx,jsx}

📄 CodeRabbit inference engine (.cursor/rules/project-structure.mdc)

渲染进程代码放在 src/renderer

Files:

  • src/renderer/settings/components/AboutUsSettings.vue
src/renderer/**/*.{ts,tsx,vue}

📄 CodeRabbit inference engine (.cursor/rules/vue-shadcn.mdc)

src/renderer/**/*.{ts,tsx,vue}: Use descriptive variable names with auxiliary verbs (e.g., isLoading, hasError).
Use TypeScript for all code; prefer types over interfaces.
Avoid enums; use const objects instead.
Use arrow functions for methods and computed properties.
Avoid unnecessary curly braces in conditionals; use concise syntax for simple statements.

Files:

  • src/renderer/settings/components/AboutUsSettings.vue
src/renderer/**/*.{vue,ts}

📄 CodeRabbit inference engine (.cursor/rules/vue-shadcn.mdc)

Implement lazy loading for routes and components.

Files:

  • src/renderer/settings/components/AboutUsSettings.vue
src/renderer/**/*.{ts,vue}

📄 CodeRabbit inference engine (.cursor/rules/vue-shadcn.mdc)

src/renderer/**/*.{ts,vue}: Use useFetch and useAsyncData for data fetching.
Implement SEO best practices using Nuxt's useHead and useSeoMeta.

Use Pinia for frontend state management (do not introduce alternative state libraries)

Files:

  • src/renderer/settings/components/AboutUsSettings.vue
**/*.{ts,tsx,js,vue}

📄 CodeRabbit inference engine (CLAUDE.md)

Use English for all logs and comments

Files:

  • src/renderer/settings/components/AboutUsSettings.vue
  • test/setup.renderer.ts
  • src/preload/index.ts
  • src/preload/index.d.ts
**/*.{ts,tsx,vue}

📄 CodeRabbit inference engine (CLAUDE.md)

Enable and adhere to strict TypeScript typing (avoid implicit any, prefer precise types)

Use PascalCase for TypeScript types and classes

Files:

  • src/renderer/settings/components/AboutUsSettings.vue
  • test/setup.renderer.ts
  • src/preload/index.ts
  • src/preload/index.d.ts
**/*.{ts,tsx,js,jsx,vue,css,scss,md,json,yml,yaml}

📄 CodeRabbit inference engine (AGENTS.md)

Prettier style: single quotes, no semicolons, print width 100; run pnpm run format

Files:

  • src/renderer/settings/components/AboutUsSettings.vue
  • test/setup.renderer.ts
  • src/preload/index.ts
  • src/preload/index.d.ts
**/*.{ts,tsx,js,jsx,vue}

📄 CodeRabbit inference engine (AGENTS.md)

**/*.{ts,tsx,js,jsx,vue}: Use OxLint for JS/TS code; keep lint clean
Use camelCase for variables and functions
Use SCREAMING_SNAKE_CASE for constants

Files:

  • src/renderer/settings/components/AboutUsSettings.vue
  • test/setup.renderer.ts
  • src/preload/index.ts
  • src/preload/index.d.ts
src/renderer/**/*.vue

📄 CodeRabbit inference engine (AGENTS.md)

Name Vue component files in PascalCase (e.g., ChatInput.vue)

Files:

  • src/renderer/settings/components/AboutUsSettings.vue
**/*.{js,jsx,ts,tsx}

📄 CodeRabbit inference engine (.cursor/rules/development-setup.mdc)

**/*.{js,jsx,ts,tsx}: 使用 OxLint 进行代码检查
Log和注释使用英文书写

Files:

  • test/setup.renderer.ts
  • src/preload/index.ts
  • src/preload/index.d.ts
**/*.{ts,tsx}

📄 CodeRabbit inference engine (.cursor/rules/error-logging.mdc)

**/*.{ts,tsx}: 始终使用 try-catch 处理可能的错误
提供有意义的错误信息
记录详细的错误日志
优雅降级处理
日志应包含时间戳、日志级别、错误代码、错误描述、堆栈跟踪(如适用)、相关上下文信息
日志级别应包括 ERROR、WARN、INFO、DEBUG
不要吞掉错误
提供用户友好的错误信息
实现错误重试机制
避免记录敏感信息
使用结构化日志
设置适当的日志级别

Files:

  • test/setup.renderer.ts
  • src/preload/index.ts
  • src/preload/index.d.ts
test/**/*

📄 CodeRabbit inference engine (CLAUDE.md)

Place unit and integration tests under the test/ directory mirroring project structure

Files:

  • test/setup.renderer.ts
src/preload/**/*.ts

📄 CodeRabbit inference engine (AGENTS.md)

Implement the secure IPC bridge in src/preload/** with contextIsolation enabled and no unsafe APIs exposed

Files:

  • src/preload/index.ts
  • src/preload/index.d.ts
🧬 Code graph analysis (1)
src/preload/index.ts (1)
test/mocks/electron.ts (1)
  • shell (25-27)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: build-check (x64)
🔇 Additional comments (3)
test/setup.renderer.ts (1)

73-73: LGTM!

The mock for openExternal is correctly added and follows the established pattern for other API mocks in the test setup.

src/preload/index.d.ts (1)

12-12: LGTM!

The type declaration is precise and correctly defines the openExternal API as optional with the appropriate signature.

src/renderer/settings/components/AboutUsSettings.vue (1)

18-18: LGTM!

The @click.prevent handlers correctly route external links through the helper function and prevent default browser navigation. The formatting on lines 38-40 appropriately handles the long URL.

Also applies to: 28-28, 38-40

Comment on lines +42 to 44
openExternal: (url: string) => {
return shell.openExternal(url)
}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

Add error handling and logging for shell.openExternal.

The shell.openExternal call can reject if the URL is malformed or the operation fails. According to the coding guidelines, error handling with try-catch, structured logging, and graceful degradation are required.

Apply this diff to add proper error handling:

-  openExternal: (url: string) => {
-    return shell.openExternal(url)
+  openExternal: async (url: string) => {
+    try {
+      await shell.openExternal(url)
+      console.log(`[INFO] Preload: Successfully opened external URL: ${url}`)
+    } catch (error) {
+      console.error('[ERROR] Preload: Failed to open external URL:', {
+        url,
+        error: error instanceof Error ? error.message : String(error),
+        timestamp: new Date().toISOString()
+      })
+      throw error
+    }
   }

As per coding guidelines.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
openExternal: (url: string) => {
return shell.openExternal(url)
}
openExternal: async (url: string) => {
try {
await shell.openExternal(url)
console.log(`[INFO] Preload: Successfully opened external URL: ${url}`)
} catch (error) {
console.error('[ERROR] Preload: Failed to open external URL:', {
url,
error: error instanceof Error ? error.message : String(error),
timestamp: new Date().toISOString()
})
throw error
}
}
🤖 Prompt for AI Agents
In src/preload/index.ts around lines 42 to 44, the openExternal call lacks error
handling; make the function async, wrap the await shell.openExternal(url) in a
try/catch, log a structured error that includes the URL and the caught error
(use the available logger or console.error if no logger is injected), and return
a boolean or rejected promise that indicates failure (e.g., return true on
success, return false on error) so callers can gracefully degrade.

Comment on lines +243 to +249
const openExternalLink = (url: string) => {
if (window.api?.openExternal) {
window.api.openExternal(url)
} else {
window.open(url, '_blank', 'noopener,noreferrer')
}
}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Add error handling for the async openExternal call.

The window.api.openExternal(url) call returns a Promise that can reject if the operation fails. According to the coding guidelines, error handling with try-catch and logging are required to prevent unhandled promise rejections.

Apply this diff to add error handling:

 const openExternalLink = (url: string) => {
   if (window.api?.openExternal) {
-    window.api.openExternal(url)
+    window.api.openExternal(url).catch((error) => {
+      console.error('[ERROR] Renderer: Failed to open external link:', {
+        url,
+        error: error instanceof Error ? error.message : String(error),
+        timestamp: new Date().toISOString()
+      })
+      // Fallback to window.open if openExternal fails
+      window.open(url, '_blank', 'noopener,noreferrer')
+    })
   } else {
     window.open(url, '_blank', 'noopener,noreferrer')
   }
 }

As per coding guidelines.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
const openExternalLink = (url: string) => {
if (window.api?.openExternal) {
window.api.openExternal(url)
} else {
window.open(url, '_blank', 'noopener,noreferrer')
}
}
const openExternalLink = (url: string) => {
if (window.api?.openExternal) {
window.api.openExternal(url).catch((error) => {
console.error('[ERROR] Renderer: Failed to open external link:', {
url,
error: error instanceof Error ? error.message : String(error),
timestamp: new Date().toISOString()
})
// Fallback to window.open if openExternal fails
window.open(url, '_blank', 'noopener,noreferrer')
})
} else {
window.open(url, '_blank', 'noopener,noreferrer')
}
}
🤖 Prompt for AI Agents
In src/renderer/settings/components/AboutUsSettings.vue around lines 243-249,
the openExternal function calls window.api.openExternal(url) which returns a
Promise but currently lacks error handling; make the function async, wrap the
await window.api.openExternal(url) call in a try-catch, log failures (e.g.
console.error with a clear message and the error), and in the catch fallback to
window.open(url, '_blank', 'noopener,noreferrer') so failed async calls don’t
cause unhandled promise rejections.

zerob13 added a commit that referenced this pull request Oct 22, 2025
* style(settings): format about page link handler (#1016)

* style(ollama): format model config handlers (#1018)

* fix: think content scroll issue (#1023)

* fix: remove shimmer for think content

* chore: update screen shot and fix scroll issue

* chore: update markdown renderer

* fix: import button bug and prevent backup overwriting during import (#1024)

* fix(sync): fix import button bug and prevent backup overwriting during import

* fix(sync): fix import button bug and prevent backup overwriting during import

* fix(sync): fix import button bug and prevent backup overwriting during import

* refactor(messageList): refactor message list ui components (#1026)

* feat: remove new thread button, add clean button.

* refactor(messageList): refactor message list ui components

* feat: add configurable fields for chat settings

- Introduced ConfigFieldHeader component for consistent field headers.
- Added ConfigInputField, ConfigSelectField, ConfigSliderField, and ConfigSwitchField components for various input types.
- Created types for field configurations in types.ts to standardize field definitions.
- Implemented useChatConfigFields composable to manage field configurations dynamically.
- Added useModelCapabilities and useModelTypeDetection composables for handling model-specific capabilities and requirements.
- Developed useSearchConfig and useThinkingBudget composables for managing search and budget configurations.

* feat: implement input history management in prompt input

- Added `useInputHistory` composable for managing input history and navigation.
- Implemented methods for setting, clearing, and confirming history placeholders.
- Integrated arrow key navigation for browsing through input history.

feat: enhance mention data handling in prompt input

- Created `useMentionData` composable to aggregate mention data from selected files and MCP resources.
- Implemented watchers to update mention data based on selected files, MCP resources, tools, and prompts.

feat: manage prompt input configuration with store synchronization

- Developed `usePromptInputConfig` composable for managing model configuration.
- Implemented bidirectional sync between local config and chat store.
- Added debounced watcher to reduce updates and improve performance.

feat: streamline TipTap editor operations in prompt input

- Introduced `usePromptInputEditor` composable for managing TipTap editor lifecycle and content transformation.
- Implemented methods for handling mentions, pasting content, and clearing editor content.

feat: handle file operations in prompt input

- Created `usePromptInputFiles` composable for managing file selection, paste, and drag-drop operations.
- Implemented methods for processing files, handling dropped files, and clearing selected files.

feat: manage rate limit status in prompt input

- Developed `useRateLimitStatus` composable for displaying and polling rate limit status.
- Implemented methods for handling rate limit events and computing status icons, classes, and tooltips.

* refactor(artifacts): migrate component logic to composables and update documentation

- Refactor ArtifactDialog.vue to use composables for view mode, viewport size, code editor, and export functionality
- Simplify HTMLArtifact.vue by removing drag-resize logic and using fixed viewport dimensions
- Clean up MermaidArtifact.vue styling and structure
- Update component refactoring guide to reflect new patterns and best practices
- Adjust prompt input composable to allow delayed editor initialization
- Update internationalization files for new responsive label

* fix(lint): unused variables

* fix(format): format code

* CodeRabbit Generated Unit Tests: Add renderer unit tests for components and composables

* feat: implement input history management in chat input component

- Added `useInputHistory` composable for managing input history and placeholder navigation.
- Implemented methods for setting, clearing, and confirming history placeholders.
- Integrated arrow key navigation for cycling through input history.

feat: enhance mention data handling in chat input

- Created `useMentionData` composable to manage mention data aggregation.
- Implemented watchers for selected files and MCP resources/tools/prompts to update mention data.

feat: manage prompt input configuration and synchronization

- Developed `usePromptInputConfig` composable for managing model configuration.
- Implemented bidirectional sync between local config refs and chat store.
- Added debounced watcher to reduce updates to the store.

feat: manage prompt input editor operations

- Introduced `usePromptInputEditor` composable for handling TipTap editor operations.
- Implemented content transformation, mention insertion, and paste handling.
- Added methods for handling editor updates and restoring focus.

feat: handle prompt input files management

- Created `usePromptInputFiles` composable for managing file operations in prompt input.
- Implemented file selection, paste, drag-drop, and prompt files integration.

feat: implement rate limit status management

- Developed `useRateLimitStatus` composable for managing rate limit status display and polling.
- Added methods for retrieving rate limit status icon, class, tooltip, and wait time formatting.

* feat: enhance chat input component with context length management and settings integration

* feat: update model configuration and enhance error handling in providers

* feat: add MCP tools list component and integrate with chat settings
feat: enhance artifact dialog with improved error handling and localization
fix: update Mermaid artifact rendering error handling and localization
fix: improve input settings error handling and state management
fix: update drag and drop composable to handle drag events correctly
fix: update Vitest configuration for better project structure and alias resolution

* fix(i18n): add unknownError translation

---------

Co-authored-by: deepinsect <deepinsect@github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* feat: add Poe provider integration and icon support  (#1028)

* feat: add Poe provider integration and icon support

* chore: format and lint

---------

Co-authored-by: zerob13 <zerob13@gmail.com>

* fix: make auto scroll works (#1030)

* fix: allow settings window links to open externally (#1029)

* fix(settings): allow target blank links

* fix: harden settings window link handling

* feat: enhance GitHub Copilot Device Flow with OAuth token management and API token retrieval (#1021)

* feat: enhance GitHub Copilot Device Flow with OAuth token management and API token retrieval

- Fixed request header for managing OAuth tokens and retrieving API tokens.
- Enhanced model definitions and added new models for better compatibility.

* fix: remove privacy related log

* fix: OAuth 2.0 for slow_down response

* fix: handle lint errors

* fix: provider fetched from publicdb

* fix(githubCopilotProvider): update request body logging format for clarity

* fix(githubCopilotProvider): improve error handling and logging in device flow

* feat(theme): fix message paragraph gap and toolcall block (#1031)

Co-authored-by: deepinsect <deepinsect@github.com>

* fix: scroll to bottom (#1034)

* fix: add debounce for renderer

* feat: add max wait for renderer

* chore(deps): upgrade markdown renderer add worker support

* chore: bump markdown version

* fix(build): use es module worker format (#1037)

* feat: remove function deleteOllamaModel (#1036)

* feat: remove function deleteOllamaModel

* fix(build): use es module worker format (#1037)

---------

Co-authored-by: duskzhen <zerob13@gmail.com>

* perf: update dependencies to use stream-monaco and bump vue-renderer-markdown version (#1038)

* feat(theme): add markdown layout style and table style (#1039)

* feat(theme): add markdown layout style and table style

* fix(lint): remove props

---------

Co-authored-by: deepinsect <deepinsect@github.com>

* feat: support effort and verbosity (#1040)

* chore: bump up version

* feat: add jiekou.ai as LLM provider (#1041)

* feat: add jiekou.ai as LLM provider

* fix: change api type to jiekou

---------

Co-authored-by: zerob13 <zerob13@gmail.com>

* chore: update provider db

---------

Co-authored-by: 韦伟 <xweimvp@gmail.com>
Co-authored-by: Happer <ericted8810us@gmail.com>
Co-authored-by: deepinsect <deepinsect@github.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: cp90 <153345481+cp90-pixel@users.noreply.github.com>
Co-authored-by: Cedric <14017092+douyixuan@users.noreply.github.com>
Co-authored-by: Simon He <57086651+Simon-He95@users.noreply.github.com>
Co-authored-by: yyhhyyyyyy <yyhhyyyyyy8@gmail.com>
Co-authored-by: cnJasonZ <gbdzxalbb@qq.com>
@zerob13 zerob13 deleted the codex/fix-default-browser-launch-for-external-links branch January 6, 2026 12:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants