codex-endpoint-switcher 1.3.1 → 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.1",
+  "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

@@ -14,10 +14,35 @@
     <div class="page-shell">
       <section id="authGate" class="auth-gate">
         <div class="auth-card panel">
+          <section class="auth-hero-card">
+            <p class="eyebrow">CODEX ENDPOINT SWITCHER</p>
+            <h1 class="auth-hero-title">登录后直接进入连接控制台</h1>
+            <p class="auth-hero-copy">
+              连接切换、账号同步、远端拉取都绑定到同一账号空间里，进入后即可直接管理。
+            </p>
+
+            <div class="auth-highlight-list">
+              <article class="auth-highlight-item">
+                <span class="auth-highlight-label">登录后可用</span>
+                <strong>推送当前连接</strong>
+                <p>把本机 URL、Key、备注同步到账号空间。</p>
+              </article>
+              <article class="auth-highlight-item">
+                <span class="auth-highlight-label">同步能力</span>
+                <strong>合并或覆盖拉取</strong>
+                <p>在不同设备之间快速恢复同一套连接配置。</p>
+              </article>
+              <article class="auth-highlight-item">
+                <span class="auth-highlight-label">固定服务</span>
+                <strong>自动连接账号同步服务</strong>
+                <p>这里只需要输入账号和密码，不需要再配置服务地址。</p>
+              </article>
+            </div>
+          </section>
+
           <div class="auth-form-card">
             <div class="panel-header auth-panel-header">
               <div>
-                <p class="eyebrow">CODEX ENDPOINT SWITCHER</p>
                 <p class="panel-kicker">Account Access</p>
                 <h2>账号登录</h2>
               </div>
@@ -84,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

@@ -101,27 +101,87 @@ code {
 }
 
 .auth-card {
-  width: min(560px, 100%);
+  width: min(980px, 100%);
   min-height: auto;
-  padding: 20px;
+  padding: 22px;
   border-radius: 36px;
-  display: block;
+  display: grid;
+  grid-template-columns: minmax(0, 1.04fr) minmax(360px, 0.96fr);
+  gap: 18px;
+  align-items: stretch;
   background:
     radial-gradient(circle at top left, rgba(216, 97, 53, 0.18), transparent 34%),
     radial-gradient(circle at bottom right, rgba(46, 139, 139, 0.16), transparent 32%),
     rgba(255, 249, 243, 0.9);
 }
 
+.auth-hero-card,
 .auth-form-card {
   display: grid;
   align-content: center;
   gap: 14px;
-  padding: 14px;
+  padding: 20px;
   border-radius: 30px;
   background: rgba(255, 252, 248, 0.82);
   border: 1px solid rgba(47, 36, 30, 0.08);
 }
 
+.auth-hero-card {
+  background:
+    radial-gradient(circle at top left, rgba(216, 97, 53, 0.18), transparent 32%),
+    linear-gradient(165deg, rgba(255, 250, 245, 0.96), rgba(248, 239, 232, 0.9));
+  gap: 18px;
+}
+
+.auth-hero-title {
+  margin: 0;
+  font-size: clamp(2rem, 3.2vw, 3rem);
+  line-height: 1.02;
+  font-family: "Bahnschrift", "Microsoft YaHei UI", sans-serif;
+  letter-spacing: 0.01em;
+}
+
+.auth-hero-copy {
+  margin: 0;
+  max-width: 34rem;
+  color: var(--muted);
+  font-size: 0.98rem;
+  line-height: 1.75;
+}
+
+.auth-highlight-list {
+  display: grid;
+  gap: 12px;
+}
+
+.auth-highlight-item {
+  display: grid;
+  gap: 6px;
+  padding: 14px 16px;
+  border-radius: 22px;
+  border: 1px solid rgba(47, 36, 30, 0.08);
+  background: rgba(255, 255, 255, 0.6);
+}
+
+.auth-highlight-label {
+  color: var(--accent-deep);
+  font-size: 0.76rem;
+  font-weight: 700;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+}
+
+.auth-highlight-item strong {
+  font-size: 1.08rem;
+}
+
+.auth-highlight-item p {
+  margin: 0;
+  color: var(--muted);
+  line-height: 1.55;
+  font-size: 0.9rem;
+}
+
 .auth-panel-header {
   margin-bottom: 0;
 }
@@ -130,6 +190,10 @@ code {
   margin-top: 0;
 }
 
+.auth-form-card .panel-header {
+  margin-bottom: 4px;
+}
+
 .auth-form .field-hint,
 .auth-status {
   margin-top: 2px;
@@ -214,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);
@@ -488,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;
@@ -529,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);
@@ -585,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;
@@ -742,6 +863,11 @@ input[readonly] {
     height: auto;
   }
 
+  .auth-card {
+    width: min(720px, 100%);
+    grid-template-columns: 1fr;
+  }
+
   .content-grid {
     grid-template-columns: 1fr;
   }
@@ -793,16 +919,40 @@ input[readonly] {
 
   .auth-card {
     width: 100%;
-    padding: 10px;
+    padding: 12px;
     border-radius: 24px;
+    gap: 12px;
   }
 
+  .auth-hero-card,
   .auth-form-card,
   .panel {
     border-radius: 20px;
     padding: 14px;
   }
 
+  .auth-hero-card {
+    gap: 14px;
+  }
+
+  .auth-hero-title {
+    font-size: 1.8rem;
+  }
+
+  .auth-hero-copy {
+    font-size: 0.9rem;
+    line-height: 1.6;
+  }
+
+  .auth-highlight-list {
+    gap: 8px;
+  }
+
+  .auth-highlight-item {
+    padding: 12px;
+    border-radius: 18px;
+  }
+
   .account-hint {
     font-size: 0.82rem;
     line-height: 1.4;
@@ -813,6 +963,7 @@ input[readonly] {
   }
 
   .current-tools button,
+  .update-actions button,
   .action-row button,
   .account-actions-grid button,
   .card-actions button {
@@ -830,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 {
@@ -898,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 {
@@ -907,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;
@@ -925,6 +1091,7 @@ input[readonly] {
   .auth-card {
     min-height: auto;
     padding: 16px;
+    gap: 14px;
   }
 
   .panel {

package/src/web/proxy-server.js

@@ -2,6 +2,147 @@ const http = require("node:http");
 const https = require("node:https");
 const profileManager = require("../main/profile-manager");
 
+const httpAgent = new http.Agent({
+  keepAlive: true,
+});
+
+const httpsAgent = new https.Agent({
+  keepAlive: true,
+});
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function isRetryableTlsError(error) {
+  const code = String(error?.code || "").trim().toUpperCase();
+  const message = String(error?.message || "");
+
+  return (
+    code === "ECONNRESET" ||
+    code === "ETIMEDOUT" ||
+    code === "EPIPE" ||
+    code === "EPROTO" ||
+    message.includes("secure TLS connection was established") ||
+    message.includes("socket hang up")
+  );
+}
+
+function readRequestBody(req) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+
+    req.on("data", (chunk) => {
+      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    });
+
+    req.on("end", () => {
+      resolve(chunks.length ? Buffer.concat(chunks) : Buffer.alloc(0));
+    });
+
+    req.on("error", reject);
+  });
+}
+
+function sendUpstreamRequest({
+  upstreamUrl,
+  requestModule,
+  headers,
+  method,
+  bodyBuffer,
+}) {
+  return new Promise((resolve, reject) => {
+    const upstreamRequest = requestModule.request(
+      upstreamUrl,
+      {
+        method,
+        headers,
+        agent: upstreamUrl.protocol === "https:" ? httpsAgent : httpAgent,
+      },
+      (upstreamResponse) => {
+        resolve(upstreamResponse);
+      },
+    );
+
+    upstreamRequest.setTimeout(12000, () => {
+      upstreamRequest.destroy(new Error("上游请求超时。"));
+    });
+
+    upstreamRequest.on("error", reject);
+
+    if (bodyBuffer?.length) {
+      upstreamRequest.end(bodyBuffer);
+      return;
+    }
+
+    upstreamRequest.end();
+  });
+}
+
+async function forwardWithRetry({
+  upstreamUrl,
+  requestModule,
+  headers,
+  method,
+  bodyBuffer,
+  retryCount = 2,
+}) {
+  let lastError = null;
+
+  for (let attempt = 0; attempt <= retryCount; attempt += 1) {
+    try {
+      return await sendUpstreamRequest({
+        upstreamUrl,
+        requestModule,
+        headers,
+        method,
+        bodyBuffer,
+      });
+    } catch (error) {
+      lastError = error;
+      if (attempt >= retryCount || !isRetryableTlsError(error)) {
+        throw error;
+      }
+
+      await sleep(220 * (attempt + 1));
+    }
+  }
+
+  throw lastError || new Error("代理转发失败。");
+}
+
+async function warmUpCurrentTarget() {
+  const target = await profileManager.getProxyTarget();
+  const upstreamUrl = new URL(target.url);
+  const requestModule = upstreamUrl.protocol === "https:" ? https : http;
+
+  const warmUrl = new URL("/", upstreamUrl);
+
+  await new Promise((resolve, reject) => {
+    const warmRequest = requestModule.request(
+      warmUrl,
+      {
+        method: "HEAD",
+        headers: {
+          authorization: `Bearer ${target.key}`,
+          host: warmUrl.host,
+        },
+        agent: upstreamUrl.protocol === "https:" ? httpsAgent : httpAgent,
+      },
+      (response) => {
+        response.resume();
+        resolve(response.statusCode || 200);
+      },
+    );
+
+    warmRequest.setTimeout(6000, () => {
+      warmRequest.destroy(new Error("预热请求超时。"));
+    });
+    warmRequest.on("error", reject);
+    warmRequest.end();
+  });
+}
+
 function createProxyServer() {
   return http.createServer(async (req, res) => {
     try {
@@ -16,42 +157,28 @@ function createProxyServer() {
       const requestPath = req.url && req.url.startsWith("/") ? req.url : `/${req.url || ""}`;
       const upstreamUrl = new URL(requestPath, upstreamBase);
       const requestModule = upstreamUrl.protocol === "https:" ? https : http;
+      const bodyBuffer = await readRequestBody(req);
       const headers = {
         ...req.headers,
         host: upstreamUrl.host,
         authorization: `Bearer ${target.key}`,
+        "content-length": String(bodyBuffer.length),
       };
 
       delete headers.connection;
-
-      const upstreamRequest = requestModule.request(
+      const upstreamResponse = await forwardWithRetry({
         upstreamUrl,
-        {
-          method: req.method,
-          headers,
-        },
-        (upstreamResponse) => {
-          res.writeHead(upstreamResponse.statusCode || 502, upstreamResponse.headers);
-          upstreamResponse.pipe(res);
-        },
-      );
-
-      upstreamRequest.on("error", (error) => {
-        if (!res.headersSent) {
-          res.writeHead(502, { "Content-Type": "application/json; charset=utf-8" });
-        }
-        res.end(
-          JSON.stringify({
-            ok: false,
-            error: `代理转发失败：${error.message}`,
-          }),
-        );
+        requestModule,
+        headers,
+        method: req.method,
+        bodyBuffer,
       });
 
-      req.pipe(upstreamRequest);
+      res.writeHead(upstreamResponse.statusCode || 502, upstreamResponse.headers);
+      upstreamResponse.pipe(res);
     } catch (error) {
       if (!res.headersSent) {
-        res.writeHead(500, { "Content-Type": "application/json; charset=utf-8" });
+        res.writeHead(502, { "Content-Type": "application/json; charset=utf-8" });
       }
 
       res.end(
@@ -66,4 +193,5 @@ function createProxyServer() {
 
 module.exports = {
   createProxyServer,
+  warmUpCurrentTarget,
 };

package/src/web/server.js

@@ -3,7 +3,8 @@ const { exec } = require("node:child_process");
 const express = require("express");
 const profileManager = require("../main/profile-manager");
 const cloudSyncClient = require("../main/cloud-sync-client");
-const { createProxyServer } = require("./proxy-server");
+const updateService = require("../main/update-service");
+const { createProxyServer, warmUpCurrentTarget } = require("./proxy-server");
 
 function wrapAsync(handler) {
   return async (req, res) => {
@@ -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) => {
@@ -226,6 +236,9 @@ function startServer(options = {}) {
   });
 
   proxyServer.listen(proxyPort);
+  warmUpCurrentTarget().catch(() => {
+    // 预热失败不阻断服务启动，真正请求时仍会走自动重试。
+  });
 
   const controller = {
     webServer,