release(desktop): v0.1.3 with dev startup fixes and settings version split

Fix Windows dev Electron launch so preload bridges inject reliably, split Settings into desktop app vs core version rows, and improve dev lifecycle (port cleanup, dev-only userData, quit-on-close).

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: joohw

electron/README.md

@@ -39,7 +39,7 @@ npm install
 npm run dev
 ```
 
-Development runs Vite on port 31873 and Electron with `ELECTRON_DEV=1`.
+Development runs Vite on `http://127.0.0.1:31873` and Electron with `ELECTRON_DEV=1`. **Use the Electron window that opens automatically** — do not open the Vite URL in a browser (the UI will not work there). Closing the Electron window in dev mode quits the app and stops Vite (via `scripts/dev.mjs`). If `Port 31873 is already in use` persists, run `npm run dev` again — the script tries to free the port automatically.
 
 Production-style (built UI):
 

electron/config-paths.js

@@ -24,6 +24,10 @@ function electronUserDataDir() {
   return path.join(configDir(), "desktop");
 }
 
+function electronDevUserDataDir() {
+  return path.join(configDir(), "desktop-dev");
+}
+
 function callLogsDBPath() {
   return path.join(logsDir(), "call-logs.sqlite");
 }
@@ -33,5 +37,6 @@ module.exports = {
   cliBinPath,
   logsDir,
   electronUserDataDir,
+  electronDevUserDataDir,
   callLogsDBPath,
 };

electron/main.js

@@ -11,17 +11,26 @@ const {
   resolveClovapiExecutable: resolveBundledClovapiExecutable,
 } = require("./clovapi-exec");
 const { buildTrayMenuModel, isValidTrayTab, trayStatusSummary, trayTooltip } = require("./tray-menu");
-const { cliBinPath, electronUserDataDir } = require("./config-paths");
+const { cliBinPath, electronDevUserDataDir, electronUserDataDir } = require("./config-paths");
 const { sanitizeForIpc } = require("./ipc-utils");
 
+const isElectronDev =
+  process.env.ELECTRON_DEV === "1" || process.argv.includes("--clovapi-dev");
+
 // Overlay scrollbars float above content instead of reserving layout width (Windows/Linux).
 app.commandLine.appendSwitch("enable-features", "OverlayScrollbar,FluentOverlayScrollbar");
 app.setName("ClovAPI Switcher");
 
-fs.mkdirSync(electronUserDataDir(), { recursive: true });
-app.setPath("userData", electronUserDataDir());
+const electronDataDir = isElectronDev ? electronDevUserDataDir() : electronUserDataDir();
+fs.mkdirSync(electronDataDir, { recursive: true });
+app.setPath("userData", electronDataDir);
+
+if (isElectronDev) {
+  app.commandLine.appendSwitch("disk-cache-dir", path.join(electronDataDir, "cache"));
+  app.commandLine.appendSwitch("disable-gpu-shader-disk-cache");
+}
 
-const gotSingleInstanceLock = app.requestSingleInstanceLock();
+const gotSingleInstanceLock = isElectronDev ? true : app.requestSingleInstanceLock();
 if (!gotSingleInstanceLock) {
   app.quit();
 }
@@ -338,15 +347,26 @@ function createWindow() {
     icon: windowIconPath(),
     title: "ClovAPI Switcher",
     webPreferences: {
-      preload: path.join(__dirname, "preload.js"),
+      preload: path.resolve(__dirname, "preload.js"),
       contextIsolation: true,
-      nodeIntegration: false
-    }
+      nodeIntegration: false,
+      sandbox: false,
+    },
   });
+  if (isElectronDev) {
+    mainWindow.webContents.on("preload-error", (_event, preloadPath, error) => {
+      emitOutput("stderr", `[dev] preload failed (${preloadPath}): ${error?.message || error}\n`);
+    });
+  }
   forceLightModeForWindow(mainWindow);
 
   mainWindow.on("close", (event) => {
     if (quitting) return;
+    if (isElectronDev) {
+      quitting = true;
+      app.quit();
+      return;
+    }
     event.preventDefault();
     hideMainWindow();
   });
@@ -361,9 +381,27 @@ function createWindow() {
     void updateTrayMenu();
   });
 
-  const devUrl = process.env.ELECTRON_DEV === "1" ? process.env.VITE_DEV_SERVER_URL || "http://localhost:31873" : "";
+  const devUrl = isElectronDev ? process.env.VITE_DEV_SERVER_URL || "http://127.0.0.1:31873" : "";
   if (devUrl) {
     void mainWindow.loadURL(devUrl);
+    mainWindow.webContents.once("did-finish-load", () => {
+      void (async () => {
+        try {
+          const hasProfiles = await mainWindow.webContents.executeJavaScript(
+            "Boolean(window.clovapiProfiles?.load)",
+            true,
+          );
+          emitOutput("system", `[dev] preload bridge profiles=${hasProfiles}\n`);
+          if (!hasProfiles) {
+            emitOutput("stderr", "[dev] preload bridge missing — restart npm run dev\n");
+          }
+        } catch (error) {
+          const message = error instanceof Error ? error.message : String(error);
+          emitOutput("stderr", `[dev] bridge check failed: ${message}\n`);
+        }
+        mainWindow.webContents.openDevTools({ mode: "detach" });
+      })();
+    });
   } else {
     void mainWindow.loadFile(path.join(__dirname, "ui-dist", "index.html"));
   }
@@ -554,6 +592,8 @@ function stopRunningProcess() {
   }
 }
 
+ipcMain.handle("app:version", () => app.getVersion());
+
 ipcMain.handle("cli:run", async (_event, payload) => {
   if (runningProcess) {
     return { ok: false, error: "A command is already running." };
@@ -1043,7 +1083,9 @@ if (gotSingleInstanceLock) {
   app.whenReady().then(async () => {
     nativeTheme.themeSource = "light";
     createWindow();
-    createTray();
+    if (!isElectronDev) {
+      createTray();
+    }
     watchCoreDevBinary();
     try {
       await proxyManager.autostartIfAllowed();

electron/package.json

@@ -1,14 +1,14 @@
 {
   "name": "clovapi-switcher",
   "private": true,
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "ClovAPI Switcher desktop app",
   "main": "main.js",
   "type": "commonjs",
   "scripts": {
     "dev:ui": "vite --config ui/vite.config.mjs",
     "prepare:cli:dev": "node scripts/prepare-dev-cli.mjs",
-    "dev": "concurrently -k \"npm run dev:ui\" \"wait-on tcp:31873 && cross-env ELECTRON_DEV=1 electron .\"",
+    "dev": "node scripts/dev.mjs",
     "build:ui": "vite build --config ui/vite.config.mjs",
     "build:icons": "node scripts/build-icons.mjs",
     "build:mac": "npm run build:ui && npm run build:icons && electron-builder --mac dmg",