codex-endpoint-switcher 1.3.2 → 1.4.0

package/README.md

@@ -49,6 +49,7 @@ codex-switcher start
 codex-switcher status
 codex-switcher restart
 codex-switcher stop
+codex-switcher check-update
 codex-switcher sync-server
 codex-switcher install-access
 codex-switcher remove-access
@@ -61,6 +62,7 @@ codex-switcher remove-access
 - `status`：查看当前服务状态
 - `restart`：重启本地网页服务
 - `stop`：关闭本地网页服务
+- `check-update`：检查 npm 是否有新版本
 - `sync-server`：启动账号同步服务，服务端使用 SQLite 单文件数据库
 - `install-access`：创建桌面快捷方式和开机启动项
 - `remove-access`：移除桌面快捷方式和开机启动项
@@ -75,7 +77,7 @@ http://localhost:3186
 
 ## 账号配置同步
 
-网页控制台现在支持“服务器地址 + 账号 + 密码”的同步方式。
+网页控制台现在支持“账号 + 密码”的同步方式。
 
 ### 1. 启动同步服务
 
@@ -115,7 +117,6 @@ codex-switcher sync-server
 
 在客户端网页控制台里填写：
 
-- 同步服务器地址
 - 账号
 - 密码
 
@@ -135,6 +136,18 @@ codex-switcher sync-server
 - 拉取前会自动备份本机 `~/.codex/endpoint-presets.json` 和 `~/.codex/endpoint-switcher-state.json`
 - 服务端数据库是 SQLite，部署只需要一个 Node 进程和一个 `.db` 文件
 
+## 版本更新提示
+
+- 控制台打开后会自动检查 npm 最新版本
+- 如果你发布了新版本，其他用户打开控制台后会看到“发现新版本”的提示
+- 用户可以直接复制升级命令执行
+
+也可以用 CLI 手动检查：
+
+```bash
+codex-switcher check-update
+```
+
 ## 更新 npm 包
 
 先进入项目目录：

package/bin/codex-switcher.js

@@ -3,6 +3,7 @@
 const path = require("node:path");
 const { spawn } = require("node:child_process");
 const { handleCommand } = require("../src/web/launcher");
+const updateService = require("../src/main/update-service");
 
 const projectRoot = path.resolve(__dirname, "..");
 const installScriptPath = path.join(projectRoot, "install-web-access.ps1");
@@ -17,6 +18,7 @@ function printUsage() {
   codex-switcher status
   codex-switcher restart
   codex-switcher stop
+  codex-switcher check-update
   codex-switcher sync-server
   codex-switcher install-access
   codex-switcher remove-access
@@ -27,6 +29,7 @@ function printUsage() {
   status          查看服务状态
   restart         重启本地网页服务
   stop            关闭本地网页服务
+  check-update    检查 npm 最新版本
   sync-server     启动账号同步服务（SQLite）
   install-access  创建桌面快捷方式与开机启动项
   remove-access   删除桌面快捷方式与开机启动项
@@ -89,6 +92,24 @@ async function main() {
       await handleCommand(command === "start" ? "ensure" : command);
       return;
     }
+    case "check-update": {
+      const status = await updateService.getUpdateStatus({ force: true });
+      if (status.hasUpdate) {
+        console.log(`发现新版本：${status.latestVersion}`);
+        console.log(`当前版本：${status.currentVersion}`);
+        console.log(`升级命令：${status.upgradeCommand}`);
+        return;
+      }
+
+      if (status.lastError) {
+        console.log(`当前版本：${status.currentVersion}`);
+        console.log(`暂时无法检查更新：${status.lastError}`);
+        return;
+      }
+
+      console.log(`当前已是最新版：${status.currentVersion}`);
+      return;
+    }
     case "sync-server": {
       await runNodeScript(cloudSyncServerPath, ["--experimental-sqlite"]);
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-endpoint-switcher",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "description": "用于切换 Codex URL 和 Key 的本地网页控制台与 npm CLI",
   "main": "src/main/main.js",
   "bin": {

package/src/main/main.js

@@ -2,6 +2,7 @@ const path = require("node:path");
 const { app, BrowserWindow, ipcMain, shell } = require("electron");
 const profileManager = require("./profile-manager");
 const cloudSyncClient = require("./cloud-sync-client");
+const updateService = require("./update-service");
 
 function createWindow() {
   const mainWindow = new BrowserWindow({
@@ -101,6 +102,10 @@ function registerHandlers() {
       closing: true,
     };
   });
+
+  ipcMain.handle("app:updateStatus", async (_event, payload) => {
+    return updateService.getUpdateStatus(payload || {});
+  });
 }
 
 app.whenReady().then(() => {

package/src/main/preload.js

@@ -55,4 +55,7 @@ contextBridge.exposeInMainWorld("codexDesktop", {
   closeApp() {
     return ipcRenderer.invoke("app:close");
   },
+  getUpdateStatus(payload) {
+    return ipcRenderer.invoke("app:updateStatus", payload);
+  },
 });

package/src/main/update-service.js

@@ -0,0 +1,122 @@
+const packageInfo = require("../../package.json");
+
+const REGISTRY_BASE_URL = "https://registry.npmjs.org";
+const SUCCESS_CACHE_TTL_MS = 10 * 60 * 1000;
+const ERROR_CACHE_TTL_MS = 30 * 1000;
+const MAX_RETRY_TIMES = 3;
+
+let cachedStatus = null;
+
+function sleep(timeoutMs) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, timeoutMs);
+  });
+}
+
+function parseVersion(version) {
+  return String(version || "")
+    .trim()
+    .split(".")
+    .map((part) => Number.parseInt(part, 10) || 0);
+}
+
+function compareVersions(left, right) {
+  const leftParts = parseVersion(left);
+  const rightParts = parseVersion(right);
+  const length = Math.max(leftParts.length, rightParts.length);
+
+  for (let index = 0; index < length; index += 1) {
+    const leftValue = leftParts[index] || 0;
+    const rightValue = rightParts[index] || 0;
+
+    if (leftValue > rightValue) {
+      return 1;
+    }
+
+    if (leftValue < rightValue) {
+      return -1;
+    }
+  }
+
+  return 0;
+}
+
+function buildStatus(payload = {}) {
+  const currentVersion = packageInfo.version;
+  const latestVersion = payload.latestVersion || currentVersion;
+  const hasUpdate = compareVersions(latestVersion, currentVersion) > 0;
+
+  return {
+    packageName: packageInfo.name,
+    currentVersion,
+    latestVersion,
+    hasUpdate,
+    checkedAt: new Date().toISOString(),
+    upgradeCommand: `npm install -g ${packageInfo.name}@latest`,
+    releaseUrl: `https://www.npmjs.com/package/${packageInfo.name}`,
+    lastError: payload.lastError || "",
+  };
+}
+
+async function fetchLatestPackageVersion() {
+  let lastError = null;
+
+  for (let attempt = 1; attempt <= MAX_RETRY_TIMES; attempt += 1) {
+    try {
+      const response = await fetch(`${REGISTRY_BASE_URL}/${packageInfo.name}/latest`, {
+        headers: {
+          Accept: "application/json",
+          "User-Agent": `${packageInfo.name}/${packageInfo.version}`,
+        },
+      });
+
+      if (!response.ok) {
+        throw new Error(`npm 仓库请求失败：${response.status}`);
+      }
+
+      const payload = await response.json();
+      const latestVersion = String(payload.version || "").trim();
+      if (!latestVersion) {
+        throw new Error("npm 仓库没有返回可用版本号。");
+      }
+
+      return latestVersion;
+    } catch (error) {
+      lastError = error;
+
+      if (attempt < MAX_RETRY_TIMES) {
+        await sleep(300 * attempt);
+      }
+    }
+  }
+
+  throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+
+async function getUpdateStatus(options = {}) {
+  const force = Boolean(options.force);
+
+  if (
+    !force &&
+    cachedStatus &&
+    Date.now() - new Date(cachedStatus.checkedAt).getTime() <
+      (cachedStatus.lastError ? ERROR_CACHE_TTL_MS : SUCCESS_CACHE_TTL_MS)
+  ) {
+    return cachedStatus;
+  }
+
+  try {
+    const latestVersion = await fetchLatestPackageVersion();
+    cachedStatus = buildStatus({ latestVersion });
+  } catch (error) {
+    cachedStatus = buildStatus({
+      lastError: error instanceof Error ? error.message : String(error),
+    });
+  }
+
+  return cachedStatus;
+}
+
+module.exports = {
+  getUpdateStatus,
+};

package/src/renderer/index.html

@@ -109,6 +109,24 @@
                 <button id="openEndpointStoreButton" class="ghost-button">打开连接数据文件</button>
                 <button id="closeAppButton" class="danger-button">关闭程序</button>
               </div>
+              <section class="update-strip" aria-label="版本更新状态">
+                <div class="update-copy">
+                  <span class="metric-label">版本更新</span>
+                  <strong id="updateSummary">正在检查版本...</strong>
+                  <span id="updateDetail" class="update-detail">
+                    当前版本 -，正在连接 npm 仓库。
+                  </span>
+                  <code id="updateCommand" class="update-command" hidden>
+                    npm install -g codex-endpoint-switcher@latest
+                  </code>
+                </div>
+                <div class="update-actions">
+                  <button id="checkUpdateButton" type="button" class="ghost-button">检查更新</button>
+                  <button id="copyUpdateCommandButton" type="button" class="secondary-button" hidden>
+                    复制升级命令
+                  </button>
+                </div>
+              </section>
               <div class="current-grid">
                 <article class="metric-card">
                   <span class="metric-label">当前备注</span>

package/src/renderer/renderer.js

@@ -3,6 +3,7 @@ const state = {
   endpoints: [],
   paths: null,
   cloud: null,
+  update: null,
 };
 
 function createWebBridge() {
@@ -105,6 +106,15 @@ function createWebBridge() {
         method: "POST",
       });
     },
+    getUpdateStatus(options = {}) {
+      const searchParams = new URLSearchParams();
+      if (options.force) {
+        searchParams.set("force", "1");
+      }
+
+      const query = searchParams.toString();
+      return request(`/api/app/update-status${query ? `?${query}` : ""}`);
+    },
   };
 }
 
@@ -286,6 +296,72 @@ function renderCloudStatus() {
   $("#cloudPullReplaceButton").disabled = !cloud.loggedIn;
 }
 
+function renderUpdateStatus() {
+  const update = state.update;
+  if (!update) {
+    return;
+  }
+
+  const summary = $("#updateSummary");
+  const detail = $("#updateDetail");
+  const command = $("#updateCommand");
+  const copyButton = $("#copyUpdateCommandButton");
+
+  if (!summary || !detail || !command || !copyButton) {
+    return;
+  }
+
+  command.textContent = update.upgradeCommand;
+
+  if (update.hasUpdate) {
+    summary.textContent = `发现新版本 ${update.latestVersion}`;
+    detail.textContent = `当前版本 ${update.currentVersion}，可以直接升级到最新版本。`;
+    command.hidden = false;
+    copyButton.hidden = false;
+    return;
+  }
+
+  if (update.lastError) {
+    summary.textContent = "暂时无法检查更新";
+    detail.textContent = `当前版本 ${update.currentVersion}，原因：${update.lastError}`;
+    command.hidden = true;
+    copyButton.hidden = true;
+    return;
+  }
+
+  summary.textContent = `当前已是最新版 ${update.currentVersion}`;
+  detail.textContent = "npm 包没有检测到更新，可以继续直接使用。";
+  command.hidden = true;
+  copyButton.hidden = true;
+}
+
+async function refreshUpdateStatus(force = false) {
+  const summary = $("#updateSummary");
+  const detail = $("#updateDetail");
+
+  if (summary) {
+    summary.textContent = force ? "正在重新检查版本..." : "正在检查版本...";
+  }
+
+  if (detail) {
+    detail.textContent = "正在连接 npm 仓库，请稍候。";
+  }
+
+  try {
+    state.update = await bridge.getUpdateStatus({ force });
+    renderUpdateStatus();
+  } catch (error) {
+    state.update = {
+      currentVersion: "-",
+      latestVersion: "-",
+      hasUpdate: false,
+      upgradeCommand: "npm install -g codex-endpoint-switcher@latest",
+      lastError: error.message,
+    };
+    renderUpdateStatus();
+  }
+}
+
 function createEndpointCard(endpoint) {
   const card = document.createElement("article");
   card.className = `profile-card ${endpoint.isActive ? "active" : ""}`;
@@ -348,9 +424,18 @@ function createEndpointCard(endpoint) {
   const meta = document.createElement("div");
   meta.className = "profile-meta";
   meta.innerHTML = `
-    <span><strong>URL</strong>${endpoint.url || "-"}</span>
-    <span><strong>Key</strong>${endpoint.maskedKey || "-"}</span>
-    <span><strong>更新时间</strong>${formatDateTime(endpoint.updatedAt)}</span>
+    <div class="profile-meta-item">
+      <span class="profile-meta-label">URL</span>
+      <strong class="profile-meta-value">${endpoint.url || "-"}</strong>
+    </div>
+    <div class="profile-meta-item">
+      <span class="profile-meta-label">Key</span>
+      <strong class="profile-meta-value">${endpoint.maskedKey || "-"}</strong>
+    </div>
+    <div class="profile-meta-item">
+      <span class="profile-meta-label">更新时间</span>
+      <strong class="profile-meta-value">${formatDateTime(endpoint.updatedAt)}</strong>
+    </div>
   `;
 
   card.append(top, meta);
@@ -392,6 +477,7 @@ async function bootstrapConsoleAccess() {
     const cloud = await bridge.getCloudSyncStatus();
     state.cloud = cloud;
     renderCloudStatus();
+    void refreshUpdateStatus();
 
     if (!cloud.loggedIn) {
       applyAccessState(false);
@@ -408,6 +494,7 @@ async function bootstrapConsoleAccess() {
     setStatus("已通过账号校验，连接控制台已解锁。", "success");
   } catch (error) {
     applyAccessState(false);
+    void refreshUpdateStatus();
     setAuthStatus(`登录校验失败：${error.message}`, "error");
   }
 }
@@ -659,6 +746,20 @@ async function handleCloseApp() {
   }
 }
 
+async function handleCopyUpdateCommand() {
+  const command = state.update?.upgradeCommand;
+  if (!command) {
+    return;
+  }
+
+  try {
+    await navigator.clipboard.writeText(command);
+    setStatus("升级命令已复制。", "success");
+  } catch (error) {
+    setStatus(`复制失败：${error.message}`, "error");
+  }
+}
+
 function bindEvents() {
   $("#authForm").addEventListener("submit", (event) => {
     event.preventDefault();
@@ -706,6 +807,10 @@ function bindEvents() {
       handleOpenPath(state.paths.endpointStorePath, " 连接数据文件");
     }
   });
+  $("#checkUpdateButton").addEventListener("click", () => {
+    refreshUpdateStatus(true);
+  });
+  $("#copyUpdateCommandButton").addEventListener("click", handleCopyUpdateCommand);
   $("#closeAppButton").addEventListener("click", handleCloseApp);
   window.addEventListener("keydown", (event) => {
     if (event.key === "Escape" && !$("#endpointModal").hidden) {

package/src/renderer/styles.css

@@ -278,6 +278,57 @@ code {
   margin-bottom: 6px;
 }
 
+.update-strip {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto;
+  gap: 12px;
+  align-items: center;
+  margin-bottom: 6px;
+  padding: 10px 12px;
+  border-radius: var(--radius-md);
+  background: rgba(255, 255, 255, 0.56);
+  border: 1px solid rgba(47, 36, 30, 0.08);
+}
+
+.update-copy {
+  display: grid;
+  gap: 4px;
+  min-width: 0;
+}
+
+.update-copy strong {
+  display: block;
+  font-size: 0.92rem;
+  line-height: 1.25;
+}
+
+.update-detail {
+  color: var(--muted);
+  font-size: 0.8rem;
+  line-height: 1.35;
+}
+
+.update-command {
+  display: inline-flex;
+  width: fit-content;
+  max-width: 100%;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  padding: 0.2rem 0.46rem;
+}
+
+.update-command[hidden] {
+  display: none !important;
+}
+
+.update-actions {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: flex-end;
+  gap: 8px;
+}
+
 .metric-card {
   padding: 14px;
   border-radius: var(--radius-md);
@@ -552,9 +603,9 @@ input[readonly] {
 }
 
 .profiles-list {
-  display: grid;
-  grid-auto-rows: minmax(190px, auto);
-  align-content: start;
+  display: flex;
+  flex-direction: column;
+  align-items: stretch;
   flex: 1 1 auto;
   gap: 14px;
   min-height: 0;
@@ -593,8 +644,9 @@ input[readonly] {
   display: grid;
   grid-template-rows: auto auto;
   gap: 14px;
-  min-height: 100%;
+  min-height: 176px;
   padding: 18px;
+  box-sizing: border-box;
   border-radius: var(--radius-md);
   background: var(--panel-strong);
   border: 1px solid rgba(47, 36, 30, 0.08);
@@ -649,22 +701,27 @@ input[readonly] {
 
 .profile-meta {
   display: grid;
-  grid-template-rows: repeat(3, auto);
-  gap: 8px;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 10px 14px;
   min-height: 0;
-  align-content: start;
+  align-items: start;
 }
 
-.profile-meta span {
+.profile-meta-item {
   display: grid;
   gap: 4px;
+  min-width: 0;
+}
+
+.profile-meta-label {
   color: var(--muted);
   font-size: 0.92rem;
-  min-width: 0;
 }
 
-.profile-meta strong {
+.profile-meta-value {
   color: var(--text);
+  display: block;
+  min-width: 0;
   white-space: nowrap;
   overflow: hidden;
   text-overflow: ellipsis;
@@ -906,6 +963,7 @@ input[readonly] {
   }
 
   .current-tools button,
+  .update-actions button,
   .action-row button,
   .account-actions-grid button,
   .card-actions button {
@@ -923,6 +981,15 @@ input[readonly] {
     gap: 8px;
   }
 
+  .update-strip {
+    grid-template-columns: 1fr;
+    gap: 10px;
+  }
+
+  .update-actions {
+    justify-content: flex-start;
+  }
+
   .current-panel,
   .account-panel,
   .profiles-panel {
@@ -991,8 +1058,14 @@ input[readonly] {
     grid-template-columns: 1fr;
   }
 
+  .update-command {
+    white-space: normal;
+    overflow: visible;
+    text-overflow: clip;
+  }
+
   .profiles-list {
-    grid-auto-rows: auto;
+    gap: 12px;
   }
 
   .profile-card {
@@ -1000,10 +1073,10 @@ input[readonly] {
   }
 
   .profile-meta {
-    grid-template-rows: none;
+    grid-template-columns: 1fr;
   }
 
-  .profile-meta strong {
+  .profile-meta-value {
     white-space: normal;
     overflow: visible;
     text-overflow: clip;

package/src/web/server.js

@@ -3,6 +3,7 @@ const { exec } = require("node:child_process");
 const express = require("express");
 const profileManager = require("../main/profile-manager");
 const cloudSyncClient = require("../main/cloud-sync-client");
+const updateService = require("../main/update-service");
 const { createProxyServer, warmUpCurrentTarget } = require("./proxy-server");
 
 function wrapAsync(handler) {
@@ -179,6 +180,15 @@ function createApp() {
     }),
   );
 
+  app.get(
+    "/api/app/update-status",
+    wrapAsync(async (req) => {
+      return updateService.getUpdateStatus({
+        force: String(req.query.force || "").trim() === "1",
+      });
+    }),
+  );
+
   app.post(
     "/api/open-path",
     wrapAsync(async (req) => {