feat(settings): add auto-launch on system startup feature

Implement auto-launch functionality with proper state synchronization
and error handling across Windows, macOS, and Linux platforms.

Key changes:
- Add auto_launch module using auto-launch crate 0.5
- Define typed errors (AutoLaunchPathError, AutoLaunchEnableError, etc.)
- Sync system state with settings.json on app startup
- Only call system API when auto-launch state actually changes
- Add UI toggle in Window Settings panel
- Add i18n support for auto-launch settings (en/zh)

Implementation details:
- Settings file (settings.json) is the single source of truth
- On startup, system state is synced to match settings.json
- Error handling uses Rust type system with proper error propagation
- Frontend optimized to avoid unnecessary system API calls

Platform support:
- Windows: HKEY_CURRENT_USER registry modification
- macOS: AppleScript-based launch item (configurable to Launch Agent)
- Linux: XDG autostart desktop file

src/components/settings/WindowSettings.tsx

@@ -19,6 +19,13 @@ export function WindowSettings({ settings, onChange }: WindowSettingsProps) {
         </p>
       </header>
 
+      <ToggleRow
+        title={t("settings.launchOnStartup")}
+        description={t("settings.launchOnStartupDescription")}
+        checked={!!settings.launchOnStartup}
+        onCheckedChange={(value) => onChange({ launchOnStartup: value })}
+      />
+
       <ToggleRow
         title={t("settings.minimizeToTray")}
         description={t("settings.minimizeToTrayDescription")}

src/hooks/useSettings.ts

@@ -126,6 +126,7 @@ export function useSettings(): UseSettingsResult {
       const previousClaudeDir = sanitizeDir(data?.claudeConfigDir);
       const previousCodexDir = sanitizeDir(data?.codexConfigDir);
       const previousGeminiDir = sanitizeDir(data?.geminiConfigDir);
+      const previousAutoLaunch = data?.launchOnStartup ?? false;
 
       const payload: Settings = {
         ...settings,
@@ -139,6 +140,20 @@ export function useSettings(): UseSettingsResult {
 
       await settingsApi.setAppConfigDirOverride(sanitizedAppDir ?? null);
 
+      // 如果开机自启状态改变，调用系统 API
+      if (payload.launchOnStartup !== previousAutoLaunch) {
+        try {
+          await settingsApi.setAutoLaunch(payload.launchOnStartup);
+        } catch (error) {
+          console.error("Failed to update auto-launch:", error);
+          toast.error(
+            t("settings.autoLaunchFailed", {
+              defaultValue: "设置开机自启失败",
+            }),
+          );
+        }
+      }
+
       try {
         if (payload.enableClaudePluginIntegration) {
           await settingsApi.applyClaudePluginConfig({ official: false });

src/hooks/useSettingsForm.ts

@@ -82,6 +82,7 @@ export function useSettingsForm(): UseSettingsFormResult {
       minimizeToTrayOnClose: data.minimizeToTrayOnClose ?? true,
       enableClaudePluginIntegration:
         data.enableClaudePluginIntegration ?? false,
+      launchOnStartup: data.launchOnStartup ?? false,
       claudeConfigDir: sanitizeDir(data.claudeConfigDir),
       codexConfigDir: sanitizeDir(data.codexConfigDir),
       language: normalizedLanguage,
@@ -101,6 +102,7 @@ export function useSettingsForm(): UseSettingsFormResult {
             showInTray: true,
             minimizeToTrayOnClose: true,
             enableClaudePluginIntegration: false,
+            launchOnStartup: false,
             language: readPersistedLanguage(),
           } as SettingsFormState);
 
@@ -135,6 +137,7 @@ export function useSettingsForm(): UseSettingsFormResult {
         minimizeToTrayOnClose: serverData.minimizeToTrayOnClose ?? true,
         enableClaudePluginIntegration:
           serverData.enableClaudePluginIntegration ?? false,
+        launchOnStartup: serverData.launchOnStartup ?? false,
         claudeConfigDir: sanitizeDir(serverData.claudeConfigDir),
         codexConfigDir: sanitizeDir(serverData.codexConfigDir),
         language: normalizedLanguage,

src/i18n/locales/en.json

@@ -166,6 +166,9 @@
     "languageOptionEnglish": "English",
     "windowBehavior": "Window Behavior",
     "windowBehaviorHint": "Configure window minimize and Claude plugin integration policies.",
+    "launchOnStartup": "Launch on Startup",
+    "launchOnStartupDescription": "Automatically run CC Switch when system starts",
+    "autoLaunchFailed": "Failed to set auto-launch",
     "minimizeToTray": "Minimize to tray on close",
     "minimizeToTrayDescription": "When checked, clicking the close button will hide to system tray, otherwise the app will exit directly.",
     "enableClaudePluginIntegration": "Apply to Claude Code extension",

src/i18n/locales/zh.json

@@ -166,6 +166,9 @@
     "languageOptionEnglish": "English",
     "windowBehavior": "窗口行为",
     "windowBehaviorHint": "配置窗口最小化与 Claude 插件联动策略。",
+    "launchOnStartup": "开机自启",
+    "launchOnStartupDescription": "随系统启动自动运行 CC Switch",
+    "autoLaunchFailed": "设置开机自启失败",
     "minimizeToTray": "关闭时最小化到托盘",
     "minimizeToTrayDescription": "勾选后点击关闭按钮会隐藏到系统托盘，取消则直接退出应用。",
     "enableClaudePluginIntegration": "应用到 Claude Code 插件",

src/lib/api/settings.ts

@@ -107,4 +107,12 @@ export const settingsApi = {
     }
     await invoke("open_external", { url });
   },
+
+  async setAutoLaunch(enabled: boolean): Promise<boolean> {
+    return await invoke("set_auto_launch", { enabled });
+  },
+
+  async getAutoLaunchStatus(): Promise<boolean> {
+    return await invoke("get_auto_launch_status");
+  },
 };

src/types.ts

@@ -101,6 +101,8 @@ export interface Settings {
   geminiConfigDir?: string;
   // 首选语言（可选，默认中文）
   language?: "en" | "zh";
+  // 是否开机自启
+  launchOnStartup?: boolean;
   // Claude 自定义端点列表
   customEndpointsClaude?: Record<string, CustomEndpoint>;
   // Codex 自定义端点列表