release(desktop): v0.1.6 with header update badge and versioned downloads

joohw · cursoragent · joohw · commit 0e6745fe160b · 2026-05-28T20:07:11.000+08:00
Poll for desktop updates every 10 minutes, show a header install button only when an update is available, download from versioned R2 paths to avoid CDN stale latest artifacts, and tighten Windows title bar drag handling.

Co-authored-by: Cursor &lt;cursoragent@cursor.com&gt;
diff --git a/electron/desktop-update.js b/electron/desktop-update.js
@@ -6,7 +6,7 @@ const path = require("node:path");
 const { spawn } = require("node:child_process");
 const { URL } = require("node:url");
 
-const DEFAULT_DOWNLOAD_BASE = "https://downloads.clovapi.com/desktop/latest";
+const DEFAULT_DOWNLOAD_ROOT = "https://downloads.clovapi.com/desktop";
 const DEFAULT_LATEST_URL = "https://downloads.clovapi.com/desktop/latest.txt";
 
 const INSTALLER_BY_PLATFORM = {
@@ -42,8 +42,20 @@ function latestDesktopUrl() {
   return String(process.env.CLOVAPI_DESKTOP_LATEST_URL || DEFAULT_LATEST_URL).trim();
 }
 
-function downloadBaseUrl() {
-  return String(process.env.CLOVAPI_DESKTOP_DOWNLOAD_BASE || DEFAULT_DOWNLOAD_BASE).replace(/\/+$/, "");
+function desktopDownloadRoot() {
+  const override = String(process.env.CLOVAPI_DESKTOP_DOWNLOAD_ROOT || "").trim();
+  if (override) return override.replace(/\/+$/, "");
+  const legacyBase = String(process.env.CLOVAPI_DESKTOP_DOWNLOAD_BASE || "").trim().replace(/\/+$/, "");
+  if (legacyBase.endsWith("/latest")) {
+    return legacyBase.slice(0, -"/latest".length);
+  }
+  return DEFAULT_DOWNLOAD_ROOT;
+}
+
+function normalizeTag(value) {
+  const trimmed = String(value || "").trim();
+  if (!trimmed) return "";
+  return trimmed.startsWith("v") ? trimmed : `v${trimmed}`;
 }
 
 function installerFileName(platform = process.platform) {
@@ -54,8 +66,12 @@ function installerFileName(platform = process.platform) {
   return name;
 }
 
-function installerDownloadUrl(platform = process.platform) {
-  return `${downloadBaseUrl()}/${installerFileName(platform)}`;
+function installerDownloadUrl(versionTag, platform = process.platform) {
+  const tag = normalizeTag(versionTag);
+  if (!tag) {
+    throw new Error("Desktop version tag is required.");
+  }
+  return `${desktopDownloadRoot()}/${tag}/${installerFileName(platform)}`;
 }
 
 function fetchText(url, timeoutMs = 15_000) {
@@ -158,7 +174,7 @@ async function checkDesktopUpdate(currentVersion) {
     latest_version: latest,
     latest_tag: latestTag,
     up_to_date: upToDate,
-    download_url: upToDate ? "" : installerDownloadUrl(),
+    download_url: upToDate ? "" : installerDownloadUrl(latestTag),
     installer_name: installerFileName(),
   };
 }
@@ -183,19 +199,22 @@ function launchInstaller(installerPath) {
 }
 
 async function downloadAndLaunchDesktopUpdate() {
+  const latestTag = await fetchLatestDesktopVersion();
   const fileName = installerFileName();
-  const url = installerDownloadUrl();
+  const url = installerDownloadUrl(latestTag);
   const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "clovapi-desktop-update-"));
   const installerPath = path.join(tmpDir, fileName);
   await downloadFile(url, installerPath);
   launchInstaller(installerPath);
-  return { ok: true, path: installerPath, url };
+  return { ok: true, path: installerPath, url, latest_tag: latestTag };
 }
 
 module.exports = {
   compareVersions,
   isNewerVersion,
   normalizeVersion,
+  normalizeTag,
+  desktopDownloadRoot,
   installerDownloadUrl,
   fetchLatestDesktopVersion,
   checkDesktopUpdate,
diff --git a/electron/desktop-update.test.js b/electron/desktop-update.test.js
@@ -1,7 +1,12 @@
 const assert = require("node:assert/strict");
 const test = require("node:test");
 
-const { compareVersions, isNewerVersion, normalizeVersion } = require("./desktop-update");
+const {
+  compareVersions,
+  installerDownloadUrl,
+  isNewerVersion,
+  normalizeVersion,
+} = require("./desktop-update");
 
 test("normalizeVersion strips leading v", () => {
   assert.equal(normalizeVersion("v0.1.3"), "0.1.3");
@@ -20,3 +25,14 @@ test("isNewerVersion detects newer desktop releases", () => {
   assert.equal(isNewerVersion("0.1.3", "0.1.3"), false);
   assert.equal(isNewerVersion("0.1.2", "0.1.3"), false);
 });
+
+test("installerDownloadUrl uses versioned desktop path", () => {
+  assert.equal(
+    installerDownloadUrl("v0.1.5", "win32"),
+    "https://downloads.clovapi.com/desktop/v0.1.5/clovapi-desktop-windows-x64.exe",
+  );
+  assert.equal(
+    installerDownloadUrl("0.1.5", "darwin"),
+    "https://downloads.clovapi.com/desktop/v0.1.5/clovapi-desktop-darwin-universal.dmg",
+  );
+});
diff --git a/electron/package-lock.json b/electron/package-lock.json
diff --git a/electron/package.json b/electron/package.json
@@ -1,7 +1,7 @@
 {
   "name": "clovapi-switcher",
   "private": true,
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "ClovAPI Switcher desktop app",
   "main": "main.js",
   "type": "commonjs",
diff --git a/electron/ui/src/App.svelte b/electron/ui/src/App.svelte
@@ -9,12 +9,15 @@
   import SettingsPanel from "./components/SettingsPanel.svelte";
   import ProfileDialog from "./components/ProfileDialog.svelte";
   import ModelDialog from "./components/ModelDialog.svelte";
+  import { Button } from "$lib/components/ui/button/index.js";
   import { Toaster } from "$lib/components/ui/sonner/index.js";
+  import ArrowUpIcon from "@lucide/svelte/icons/arrow-up";
   import { i18n, t } from "./lib/i18n";
-  import { initApp, setActiveTab, store, type TabId } from "./lib/store.svelte";
+  import { initApp, installAppUpdate, setActiveTab, store, type TabId } from "./lib/store.svelte";
   import { isElectronRenderer } from "./lib/constants";
 
   const inElectron = isElectronRenderer();
+  const showAppUpdateBadge = $derived(inElectron && store.appUpdateAvailable);
 
   onMount(() => {
     void initApp();
@@ -46,6 +49,9 @@
         settings: t("tabs.settings"),
       },
       browserBanner: t("toast.profilesBridgeBrowser"),
+      updateBadge: t("app.updateBadge", {
+        latest: store.appLatestVersion || store.appVersion || "?",
+      }),
     };
   });
 </script>
@@ -56,12 +62,35 @@
   </div>
 {/if}
 
+{#if inElectron}
+  <div class="electron-titlebar-drag-region" aria-hidden="true"></div>
+{/if}
+
 <main
   class="mx-auto flex min-h-svh w-full max-w-3xl flex-col px-5 py-5 {inElectron ? 'electron-window-chrome' : ''}"
 >
-  <header class="mb-5 shrink-0 {inElectron ? 'electron-titlebar-drag' : ''}">
-    <h1 class="text-lg font-semibold tracking-tight">ClovAPI Switcher</h1>
-    <p class="mt-1 text-xs text-muted-foreground">{copy.subtitle}</p>
+  <header class="mb-5 shrink-0 select-none {inElectron ? 'pt-4' : ''}">
+    <div class="flex items-center justify-between gap-3">
+      <div class="min-w-0 flex-1 {inElectron ? 'electron-titlebar-drag' : ''}">
+        <h1 class="text-lg font-semibold tracking-tight">ClovAPI Switcher</h1>
+        <p class="mt-1 text-xs text-muted-foreground">{copy.subtitle}</p>
+      </div>
+      {#if showAppUpdateBadge}
+        <div class="electron-no-drag shrink-0">
+          <Button
+            variant="default"
+            size="icon-sm"
+            class="rounded-full"
+            aria-label={copy.updateBadge}
+            title={copy.updateBadge}
+            disabled={store.appUpdating}
+            onclick={() => void installAppUpdate()}
+          >
+            <ArrowUpIcon />
+          </Button>
+        </div>
+      {/if}
+    </div>
   </header>
 
   <Tabs.Root value={store.activeTab} onValueChange={onTabChange} class="flex min-h-0 flex-1 flex-col gap-4">
diff --git a/electron/ui/src/app.css b/electron/ui/src/app.css
@@ -100,9 +100,23 @@
     padding-top: env(titlebar-area-height, 32px);
   }
 
+  .electron-titlebar-drag-region {
+    position: fixed;
+    top: env(titlebar-area-y, 0);
+    left: env(titlebar-area-x, 0);
+    width: env(titlebar-area-width, 100%);
+    height: env(titlebar-area-height, 32px);
+    -webkit-app-region: drag;
+    z-index: 20;
+  }
+
   .electron-titlebar-drag {
     -webkit-app-region: drag;
   }
+
+  .electron-no-drag {
+    -webkit-app-region: no-drag;
+  }
 }
 
 [data-sonner-toaster] {
diff --git a/electron/ui/src/lib/components/ui/tabs/tabs-list.svelte b/electron/ui/src/lib/components/ui/tabs/tabs-list.svelte
@@ -2,7 +2,7 @@
 	import { tv, type VariantProps } from "tailwind-variants";
 
 	export const tabsListVariants = tv({
-		base: "rounded-lg p-[3px] group-data-horizontal/tabs:h-8 data-[variant=line]:rounded-none group/tabs-list text-muted-foreground inline-flex w-fit items-center justify-center group-data-[orientation=vertical]/tabs:h-fit group-data-[orientation=vertical]/tabs:flex-col",
+		base: "select-none rounded-lg p-[3px] group-data-horizontal/tabs:h-8 data-[variant=line]:rounded-none group/tabs-list text-muted-foreground inline-flex w-fit items-center justify-center group-data-[orientation=vertical]/tabs:h-fit group-data-[orientation=vertical]/tabs:flex-col",
 		variants: {
 			variant: {
 				default: "cn-tabs-list-variant-default bg-muted",
diff --git a/electron/ui/src/lib/components/ui/tabs/tabs-trigger.svelte b/electron/ui/src/lib/components/ui/tabs/tabs-trigger.svelte
@@ -13,7 +13,7 @@
 	bind:ref
 	data-slot="tabs-trigger"
 	class={cn(
-		"gap-1.5 rounded-md border border-transparent px-1.5 py-0.5 text-sm font-medium has-data-[icon=inline-end]:pr-1 has-data-[icon=inline-start]:pl-1 [&_svg:not([class*='size-'])]:size-4 focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:outline-ring text-foreground/60 hover:text-foreground data-[state=active]:text-foreground dark:text-muted-foreground dark:hover:text-foreground dark:data-[state=active]:text-foreground relative inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center whitespace-nowrap transition-all group-data-[orientation=vertical]/tabs:w-full group-data-[orientation=vertical]/tabs:justify-start focus-visible:ring-[3px] focus-visible:outline-1 disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0",
+		"select-none gap-1.5 rounded-md border border-transparent px-1.5 py-0.5 text-sm font-medium has-data-[icon=inline-end]:pr-1 has-data-[icon=inline-start]:pl-1 [&_svg:not([class*='size-'])]:size-4 focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:outline-ring text-foreground/60 hover:text-foreground data-[state=active]:text-foreground dark:text-muted-foreground dark:hover:text-foreground dark:data-[state=active]:text-foreground relative inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center whitespace-nowrap transition-all group-data-[orientation=vertical]/tabs:w-full group-data-[orientation=vertical]/tabs:justify-start focus-visible:ring-[3px] focus-visible:outline-1 disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0",
 		"group-data-[variant=line]/tabs-list:bg-transparent group-data-[variant=line]/tabs-list:data-[state=active]:bg-transparent",
 		"after:bg-foreground after:absolute after:opacity-0 after:transition-opacity group-data-[orientation=horizontal]/tabs:after:inset-x-0 group-data-[orientation=horizontal]/tabs:after:bottom-[-5px] group-data-[orientation=horizontal]/tabs:after:h-0.5 group-data-[orientation=vertical]/tabs:after:inset-y-0 group-data-[orientation=vertical]/tabs:after:-right-1 group-data-[orientation=vertical]/tabs:after:w-0.5 group-data-[variant=line]/tabs-list:data-[state=active]:after:opacity-100",
 		className
diff --git a/electron/ui/src/lib/i18n/locales/en.ts b/electron/ui/src/lib/i18n/locales/en.ts
@@ -1,6 +1,7 @@
 const en = {
   app: {
     subtitle: "Manage local Agent APIs in one place — ClaudeCli / CodexCli subscriptions supported",
+    updateBadge: "Install update v{latest}",
   },
   tabs: {
     cli: "CLI",
diff --git a/electron/ui/src/lib/i18n/locales/zh.ts b/electron/ui/src/lib/i18n/locales/zh.ts
@@ -3,6 +3,7 @@ import type { MessageTree } from "./en";
 const zh = {
   app: {
     subtitle: "一键管理本地所有 Agent 的 API，支持 ClaudeCli / CodexCli 订阅",
+    updateBadge: "安装更新 v{latest}",
   },
   tabs: {
     cli: "CLI",
diff --git a/electron/ui/src/lib/store/desktop-update.ts b/electron/ui/src/lib/store/desktop-update.ts
@@ -9,21 +9,62 @@ type DesktopUpdateDetail = {
   up_to_date?: boolean;
 };
 
-export async function checkAppUpdate() {
+type CheckAppUpdateOptions = {
+  silent?: boolean;
+};
+
+const APP_UPDATE_CHECK_INTERVAL_MS = 600_000;
+
+let appUpdateTimer: ReturnType<typeof setInterval> | null = null;
+
+function applyAppUpdateDetail(detail: DesktopUpdateDetail, silent: boolean) {
+  if (detail.up_to_date) {
+    store.appUpdateAvailable = false;
+    store.appLatestVersion = "";
+    if (!silent) {
+      store.appUpdateCheck = {
+        status: "pass",
+        summary: t("proxy.updateUpToDate"),
+        detail: "",
+        testedAt: Date.now(),
+      };
+    }
+    return;
+  }
+
+  store.appUpdateAvailable = true;
+  store.appLatestVersion = detail.latest_version || "";
+  if (!silent) {
+    store.appUpdateCheck = {
+      status: "pass",
+      summary: t("proxy.updateAvailable", { latest: detail.latest_version || "?" }),
+      detail: "",
+      testedAt: Date.now(),
+    };
+  }
+}
+
+export async function checkAppUpdate(options: CheckAppUpdateOptions = {}) {
+  const silent = options.silent === true;
   if (isElectronDev()) return;
-  if (store.appUpdateCheck?.status === "testing" || store.appUpdating) return;
+  if (store.appUpdating) return;
+  if (!silent && store.appUpdateCheck?.status === "testing") return;
 
   const bridge = window.clovapiDesktop;
   if (!bridge?.checkUpdate) {
-    toast.error(t("toast.appUpdateUnsupported"));
+    if (!silent) {
+      toast.error(t("toast.appUpdateUnsupported"));
+    }
     return;
   }
 
-  store.appUpdateCheck = {
-    status: "testing",
-    summary: t("common.testing"),
-    detail: "",
-  };
+  if (!silent) {
+    store.appUpdateCheck = {
+      status: "testing",
+      summary: t("common.testing"),
+      detail: "",
+    };
+  }
 
   try {
     const result = await bridge.checkUpdate();
@@ -32,43 +73,41 @@ export async function checkAppUpdate() {
     if (!result?.ok) {
       store.appUpdateAvailable = false;
       store.appLatestVersion = "";
-      store.appUpdateCheck = {
-        status: "fail",
-        summary: result?.error || t("toast.appUpdateCheckFailed"),
-        detail: "",
-      };
+      if (!silent) {
+        store.appUpdateCheck = {
+          status: "fail",
+          summary: result?.error || t("toast.appUpdateCheckFailed"),
+          detail: "",
+        };
+      }
       return;
     }
 
-    if (detail.up_to_date) {
-      store.appUpdateAvailable = false;
-      store.appLatestVersion = "";
+    applyAppUpdateDetail(detail, silent);
+  } catch (error) {
+    store.appUpdateAvailable = false;
+    store.appLatestVersion = "";
+    if (!silent) {
       store.appUpdateCheck = {
-        status: "pass",
-        summary: t("proxy.updateUpToDate"),
+        status: "fail",
+        summary: error instanceof Error ? error.message : t("toast.appUpdateCheckFailed"),
         detail: "",
-        testedAt: Date.now(),
       };
-      return;
     }
+  }
+}
 
-    store.appUpdateAvailable = true;
-    store.appLatestVersion = detail.latest_version || "";
-    store.appUpdateCheck = {
-      status: "pass",
-      summary: t("proxy.updateAvailable", { latest: detail.latest_version || "?" }),
-      detail: "",
-      testedAt: Date.now(),
-    };
-  } catch (error) {
-    store.appUpdateAvailable = false;
-    store.appLatestVersion = "";
-    store.appUpdateCheck = {
-      status: "fail",
-      summary: error instanceof Error ? error.message : t("toast.appUpdateCheckFailed"),
-      detail: "",
-    };
+export function startAppUpdatePolling() {
+  if (isElectronDev()) return;
+  if (appUpdateTimer) {
+    clearInterval(appUpdateTimer);
+    appUpdateTimer = null;
   }
+
+  void checkAppUpdate({ silent: true });
+  appUpdateTimer = setInterval(() => {
+    void checkAppUpdate({ silent: true });
+  }, APP_UPDATE_CHECK_INTERVAL_MS);
 }
 
 export async function installAppUpdate() {
diff --git a/electron/ui/src/lib/store/init.ts b/electron/ui/src/lib/store/init.ts
diff --git a/electron/ui/src/lib/store/store.svelte.ts b/electron/ui/src/lib/store/store.svelte.ts
diff --git a/scripts/r2-publish.sh b/scripts/r2-publish.sh

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "clovapi-switcher",`
`3`	`3`	`"private": true,`
`4`		`- "version": "0.1.5",`
	`4`	`+ "version": "0.1.6",`
`5`	`5`	`"description": "ClovAPI Switcher desktop app",`
`6`	`6`	`"main": "main.js",`
`7`	`7`	`"type": "commonjs",`