codex-endpoint-switcher 1.2.0 → 1.3.1

package/README.md

@@ -48,6 +48,7 @@ codex-switcher open
 codex-switcher start
 codex-switcher status
 codex-switcher restart
+codex-switcher stop
 codex-switcher sync-server
 codex-switcher install-access
 codex-switcher remove-access
@@ -59,6 +60,7 @@ codex-switcher remove-access
 - `start`：仅在后台启动本地网页服务
 - `status`：查看当前服务状态
 - `restart`：重启本地网页服务
+- `stop`：关闭本地网页服务
 - `sync-server`：启动账号同步服务，服务端使用 SQLite 单文件数据库
 - `install-access`：创建桌面快捷方式和开机启动项
 - `remove-access`：移除桌面快捷方式和开机启动项

package/bin/codex-switcher.js

@@ -16,6 +16,7 @@ function printUsage() {
   codex-switcher start
   codex-switcher status
   codex-switcher restart
+  codex-switcher stop
   codex-switcher sync-server
   codex-switcher install-access
   codex-switcher remove-access
@@ -25,6 +26,7 @@ function printUsage() {
   start           仅在后台启动本地网页服务
   status          查看服务状态
   restart         重启本地网页服务
+  stop            关闭本地网页服务
   sync-server     启动账号同步服务（SQLite）
   install-access  创建桌面快捷方式与开机启动项
   remove-access   删除桌面快捷方式与开机启动项
@@ -82,7 +84,8 @@ async function main() {
     case "open":
     case "start":
     case "status":
-    case "restart": {
+    case "restart":
+    case "stop": {
       await handleCommand(command === "start" ? "ensure" : command);
       return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-endpoint-switcher",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "用于切换 Codex URL 和 Key 的本地网页控制台与 npm CLI",
   "main": "src/main/main.js",
   "bin": {
@@ -58,13 +58,13 @@
             "x64"
           ]
         }
-      ],
-      "artifactName": "CodexProfileDesktop-${version}-portable.${ext}"
+      ]
     },
     "portable": {
       "artifactName": "CodexProfileDesktop-${version}-portable.${ext}"
     },
     "nsis": {
+      "artifactName": "CodexProfileDesktop-${version}-installer.${ext}",
       "oneClick": false,
       "allowToChangeInstallationDirectory": true
     }

package/src/main/cloud-sync-client.js

@@ -33,7 +33,7 @@ function getDefaultServerUrl() {
   return normalizeServerUrl(
     process.env.CODEX_SYNC_SERVER_URL ||
       process.env.SYNC_SERVER_PUBLIC_URL ||
-      "http://cd.xdo.icu:18245",
+      "https://codexqh.zhang-fy.top",
   );
 }
 

package/src/main/main.js

@@ -91,6 +91,16 @@ function registerHandlers() {
     const openError = await shell.openPath(targetPath);
     return openError || "";
   });
+
+  ipcMain.handle("app:close", async () => {
+    setTimeout(() => {
+      app.quit();
+    }, 60);
+
+    return {
+      closing: true,
+    };
+  });
 }
 
 app.whenReady().then(() => {

package/src/main/preload.js

@@ -52,4 +52,7 @@ contextBridge.exposeInMainWorld("codexDesktop", {
   openPath(targetPath) {
     return ipcRenderer.invoke("shell:openPath", targetPath);
   },
+  closeApp() {
+    return ipcRenderer.invoke("app:close");
+  },
 });

package/src/renderer/index.html

@@ -62,29 +62,6 @@
       </section>
 
       <div id="appShell" class="app-shell" hidden>
-        <header class="workspace-bar panel">
-          <div class="workspace-main">
-            <div class="workspace-copy">
-              <p class="eyebrow">CODEX ENDPOINT SWITCHER</p>
-              <div class="workspace-title-row">
-                <h1>连接控制台</h1>
-                <div class="hero-badge workspace-badge" id="heroBadge">读取中</div>
-              </div>
-              <p class="workspace-text">
-                这里只管理 <code>备注</code>、<code>URL</code>、<code>Key</code>。切换时只更新
-                Codex 当前使用的 <code>base_url</code> 和 <code>OPENAI_API_KEY</code>。
-              </p>
-            </div>
-
-            <div class="workspace-actions">
-              <button id="refreshButton" class="ghost-button">刷新状态</button>
-              <button id="openCodexRootButton" class="ghost-button">打开 Codex 目录</button>
-              <button id="openEndpointStoreButton" class="ghost-button">打开连接数据文件</button>
-            </div>
-          </div>
-          <div id="statusBox" class="status-box info workspace-status">应用已启动，正在读取当前连接。</div>
-        </header>
-
         <main class="content-grid">
           <div class="left-column">
             <section class="panel current-panel">
@@ -95,6 +72,18 @@
                 </div>
                 <span class="panel-tag" id="activeEndpointTag">未识别</span>
               </div>
+              <div class="current-summary">
+                <p class="current-copy">
+                  这里只管理 <code>备注</code>、<code>URL</code>、<code>Key</code>。切换时只更新
+                  Codex 当前使用的 <code>base_url</code> 和 <code>OPENAI_API_KEY</code>。
+                </p>
+              </div>
+              <div class="current-tools">
+                <button id="refreshButton" class="ghost-button">刷新状态</button>
+                <button id="openCodexRootButton" class="ghost-button">打开 Codex 目录</button>
+                <button id="openEndpointStoreButton" class="ghost-button">打开连接数据文件</button>
+                <button id="closeAppButton" class="danger-button">关闭程序</button>
+              </div>
               <div class="current-grid">
                 <article class="metric-card">
                   <span class="metric-label">当前备注</span>
@@ -112,22 +101,6 @@
                   <span class="metric-label">模型</span>
                   <strong id="currentModel">-</strong>
                 </article>
-                <article class="metric-card metric-card-wide">
-                  <span class="metric-label">当前 URL</span>
-                  <strong id="currentBaseUrl">-</strong>
-                </article>
-                <article class="metric-card metric-card-wide">
-                  <span class="metric-label">热更新模式</span>
-                  <strong id="proxyModeStatus">未开启</strong>
-                  <p class="field-hint" id="proxyModeHint">
-                    当前还是直连模式。开启后，后续同一 Codex 会话可在下一次请求时热更新到新 URL/Key。
-                  </p>
-                  <div class="action-row metric-actions">
-                    <button id="enableProxyModeButton" type="button" class="secondary-button">
-                      开启热更新模式
-                    </button>
-                  </div>
-                </article>
               </div>
             </section>
 
@@ -160,7 +133,7 @@
                   <span class="metric-label">同步服务</span>
                   <strong id="cloudServerStatus">自动连接</strong>
                 </article>
-                <article class="account-inline-card account-inline-card-wide">
+                <article class="account-inline-card">
                   <span class="metric-label">同步记录</span>
                   <strong id="cloudLastSyncStatus">还没有推送或拉取记录</strong>
                 </article>

package/src/renderer/renderer.js

@@ -100,6 +100,11 @@ function createWebBridge() {
         body: JSON.stringify({ targetPath }),
       }).then(() => "");
     },
+    closeApp() {
+      return request("/api/app/close", {
+        method: "POST",
+      });
+    },
   };
 }
 
@@ -109,6 +114,15 @@ function $(selector) {
   return document.querySelector(selector);
 }
 
+function setText(selector, value) {
+  const element = $(selector);
+  if (!element) {
+    return;
+  }
+
+  element.textContent = value;
+}
+
 function formatDateTime(value) {
   if (!value) {
     return "-";
@@ -126,23 +140,18 @@ function formatDateTime(value) {
 }
 
 function setStatus(message, type = "info") {
-  const statusBox = $("#statusBox");
-  if (!statusBox) {
-    return;
-  }
-
-  statusBox.textContent = message;
-  statusBox.className = `status-box ${type}`;
+  void message;
+  void type;
 }
 
 function setAuthStatus(message, type = "info") {
-  const statusBox = $("#authStatusBox");
-  if (!statusBox) {
+  const authStatusElement = $("#authStatusBox");
+  if (!authStatusElement) {
     return;
   }
 
-  statusBox.textContent = message;
-  statusBox.className = `status-box ${type} auth-status`;
+  authStatusElement.textContent = message;
+  authStatusElement.className = `status-box ${type} auth-status`;
 }
 
 function syncFieldValue(selector, value) {
@@ -228,25 +237,11 @@ function renderCurrent() {
     return;
   }
 
-  $("#activeEndpointTag").textContent = current.currentNote || "未识别";
-  $("#currentNote").textContent = current.currentNote || "未识别";
-  $("#currentProvider").textContent = current.provider || "-";
-  $("#currentBaseUrl").textContent = current.currentUrl || "-";
-  $("#currentKeyMasked").textContent = current.currentKeyMasked || "-";
-  $("#currentModel").textContent = current.model || "-";
-  $("#proxyModeStatus").textContent = current.proxyModeEnabled
-    ? `已开启，固定代理：${current.proxyBaseUrl}`
-    : "未开启";
-  $("#proxyModeHint").textContent = current.proxyModeEnabled
-    ? "当前 Codex 只要已经接入本地代理，后续同一会话内切换连接会在下一次请求时热更新。"
-    : "当前还是直连模式。开启后需要把已打开的旧 Codex 会话重开一次；之后同一会话即可热更新。";
-  $("#enableProxyModeButton").disabled = current.proxyModeEnabled;
-  $("#enableProxyModeButton").textContent = current.proxyModeEnabled
-    ? "热更新模式已开启"
-    : "开启热更新模式";
-  $("#heroBadge").textContent = current.currentNote
-    ? `${current.proxyModeEnabled ? "热更新中" : "当前连接"}：${current.currentNote}`
-    : "当前未匹配到已保存连接";
+  setText("#activeEndpointTag", current.currentNote || "未识别");
+  setText("#currentNote", current.currentNote || "未识别");
+  setText("#currentProvider", current.provider || "-");
+  setText("#currentKeyMasked", current.currentKeyMasked || "-");
+  setText("#currentModel", current.model || "-");
 }
 
 function renderCloudStatus() {
@@ -258,22 +253,12 @@ function renderCloudStatus() {
   syncFieldValue("#authUsername", cloud.username);
 
   const accountName = cloud.remoteUser || cloud.username || "-";
-  const serverText = !cloud.serverUrl
-    ? "未配置"
-    : cloud.loggedIn
-      ? "已自动连接"
-      : cloud.lastError
-        ? "连接异常"
-        : "等待登录";
-  const sessionText = !cloud.serverUrl
-    ? "未配置服务器"
-    : cloud.loggedIn
-      ? cloud.tokenExpiresAt
-        ? `已登录 · 到期 ${formatDateTime(cloud.tokenExpiresAt)}`
-        : "已登录"
-      : cloud.hasToken
-        ? "登录态失效，请重新登录"
-        : "未登录";
+  const serverText = cloud.loggedIn ? "已连接" : cloud.lastError ? "连接异常" : "等待登录";
+  const sessionText = cloud.loggedIn
+    ? "已登录"
+    : cloud.hasToken
+      ? "登录态失效，请重新登录"
+      : "未登录";
 
   const syncStatusParts = [];
   if (cloud.lastPushAt) {
@@ -483,29 +468,6 @@ async function handleSwitchEndpoint(id, note) {
   }
 }
 
-async function handleEnableProxyMode() {
-  try {
-    setStatus("正在切到热更新代理模式 ...", "info");
-    const result = await bridge.enableProxyMode();
-    await refreshDashboard(false);
-    if (result.oneTimeRestartRequired) {
-      setStatus(
-        "热更新模式已开启。请把当前已经打开着的旧 Codex 会话重开一次；之后同一会话内即可热更新。",
-        "success",
-      );
-    } else {
-      setStatus("热更新模式已开启。当前会话后续请求可直接热更新到新连接。", "success");
-    }
-  } catch (error) {
-    if (isUnauthorizedError(error)) {
-      await handleAccessRevoked(error.message);
-      return;
-    }
-
-    setStatus(`开启热更新模式失败：${error.message}`, "error");
-  }
-}
-
 function getAuthFormPayload() {
   return {
     username: $("#authUsername").value.trim(),
@@ -684,6 +646,19 @@ async function handleOpenPath(targetPath, label) {
   }
 }
 
+async function handleCloseApp() {
+  const confirmed = window.confirm("确定要关闭当前程序吗？");
+  if (!confirmed) {
+    return;
+  }
+
+  try {
+    await bridge.closeApp();
+  } catch {
+    // 服务关闭过程会中断当前页面请求，这里不再额外提示。
+  }
+}
+
 function bindEvents() {
   $("#authForm").addEventListener("submit", (event) => {
     event.preventDefault();
@@ -712,7 +687,6 @@ function bindEvents() {
     resetForm();
     setStatus("已重置表单，可作为新连接保存。", "info");
   });
-  $("#enableProxyModeButton").addEventListener("click", handleEnableProxyMode);
   $("#cloudLogoutButton").addEventListener("click", handleCloudLogout);
   $("#openSwitchAccountButton").addEventListener("click", handleCloudLogout);
   $("#cloudPushButton").addEventListener("click", handleCloudPush);
@@ -732,6 +706,7 @@ function bindEvents() {
       handleOpenPath(state.paths.endpointStorePath, " 连接数据文件");
     }
   });
+  $("#closeAppButton").addEventListener("click", handleCloseApp);
   window.addEventListener("keydown", (event) => {
     if (event.key === "Escape" && !$("#endpointModal").hidden) {
       closeEndpointModal();

package/src/renderer/styles.css

@@ -61,13 +61,7 @@ code {
 
 .app-shell {
   height: 100%;
-  display: grid;
-  grid-template-rows: auto minmax(0, 1fr);
-  gap: 16px;
-}
-
-.mobile-section-nav {
-  display: none;
+  display: block;
 }
 
 .app-shell[hidden],
@@ -75,7 +69,6 @@ code {
   display: none;
 }
 
-.workspace-bar,
 .panel {
   backdrop-filter: blur(18px);
   -webkit-backdrop-filter: blur(18px);
@@ -93,7 +86,6 @@ code {
   font-weight: 700;
 }
 
-.workspace-copy h1,
 .panel-header h2,
 .profile-heading h3,
 .modal-header h2 {
@@ -143,67 +135,6 @@ code {
   margin-top: 2px;
 }
 
-.workspace-bar {
-  display: grid;
-  gap: 14px;
-  padding: 18px 20px;
-  border-radius: var(--radius-xl);
-  background:
-    linear-gradient(135deg, rgba(255, 252, 248, 0.94), rgba(247, 238, 230, 0.9)),
-    var(--panel);
-}
-
-.workspace-main {
-  display: grid;
-  grid-template-columns: minmax(0, 1fr) auto;
-  gap: 18px;
-  align-items: start;
-}
-
-.workspace-copy h1 {
-  font-size: clamp(1.5rem, 2.2vw, 2.2rem);
-  line-height: 1.05;
-}
-
-.workspace-title-row {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 12px;
-}
-
-.workspace-text {
-  max-width: 760px;
-  margin: 10px 0 0;
-  color: var(--muted);
-  font-size: 0.94rem;
-  line-height: 1.55;
-}
-
-.workspace-actions {
-  display: flex;
-  flex-wrap: wrap;
-  justify-content: flex-end;
-  gap: 10px;
-}
-
-.hero-badge {
-  display: inline-flex;
-  align-items: center;
-  padding: 12px 18px;
-  border-radius: 999px;
-  background: rgba(255, 255, 255, 0.82);
-  border: 1px solid rgba(47, 36, 30, 0.08);
-  color: var(--text);
-  font-weight: 700;
-}
-
-.workspace-badge {
-  flex: 0 0 auto;
-  padding: 10px 14px;
-  white-space: nowrap;
-}
-
 .content-grid {
   display: grid;
   grid-template-columns: 0.84fr 1.16fr;
@@ -216,7 +147,7 @@ code {
 .left-column {
   min-height: 0;
   display: grid;
-  grid-template-rows: minmax(0, 0.9fr) minmax(0, 1.1fr);
+  grid-template-rows: auto minmax(0, 1fr);
   gap: 20px;
   overflow: hidden;
 }
@@ -259,30 +190,28 @@ code {
   font-weight: 700;
 }
 
-.mobile-section-button {
-  height: 40px;
-  padding: 0 14px;
-  border: 1px solid rgba(47, 36, 30, 0.1);
-  border-radius: 999px;
-  background: rgba(255, 255, 255, 0.68);
-  color: var(--text);
-  cursor: pointer;
-  transition:
-    background 0.18s ease,
-    color 0.18s ease,
-    box-shadow 0.18s ease;
+.current-grid {
+  display: grid;
+  grid-template-columns: repeat(4, minmax(0, 1fr));
+  gap: 6px;
 }
 
-.mobile-section-button.is-active {
-  background: linear-gradient(135deg, #d86135, #b1431d);
-  color: #fff;
-  box-shadow: 0 12px 28px rgba(179, 67, 29, 0.24);
+.current-summary {
+  margin-bottom: 6px;
 }
 
-.current-grid {
+.current-copy {
+  margin: 0;
+  color: var(--muted);
+  font-size: 0.84rem;
+  line-height: 1.4;
+}
+
+.current-tools {
   display: grid;
-  grid-template-columns: repeat(4, minmax(0, 1fr));
+  grid-template-columns: repeat(3, minmax(0, 1fr));
   gap: 8px;
+  margin-bottom: 6px;
 }
 
 .metric-card {
@@ -300,30 +229,32 @@ code {
 }
 
 .current-panel .panel-header {
-  margin-bottom: 8px;
+  margin-bottom: 6px;
+}
+
+.current-panel {
+  align-self: start;
+  display: grid;
+  align-content: start;
 }
 
 .current-panel .metric-card {
-  padding: 6px 9px;
+  padding: 5px 8px;
 }
 
 .current-panel .metric-card strong {
-  margin-top: 3px;
-  font-size: 0.9rem;
+  margin-top: 2px;
+  font-size: 0.88rem;
 }
 
 .current-panel .metric-label {
-  font-size: 0.78rem;
+  font-size: 0.76rem;
 }
 
 .current-panel .secondary-button {
   height: 32px;
 }
 
-.metric-card-wide {
-  grid-column: 1 / -1;
-}
-
 .metric-label {
   color: var(--muted);
   font-size: 0.88rem;
@@ -452,7 +383,7 @@ input[readonly] {
 
 .account-inline-grid {
   display: grid;
-  grid-template-columns: 180px minmax(0, 1fr);
+  grid-template-columns: repeat(2, minmax(0, 1fr));
   gap: 8px;
 }
 
@@ -558,16 +489,20 @@ input[readonly] {
 
 .profiles-list {
   display: grid;
+  grid-auto-rows: minmax(190px, auto);
+  align-content: start;
   flex: 1 1 auto;
   gap: 14px;
   min-height: 0;
   overflow: auto;
   padding-right: 6px;
+  padding-bottom: 6px;
 }
 
 .profiles-panel {
   display: flex;
   flex-direction: column;
+  min-height: 0;
   overflow: hidden;
 }
 
@@ -592,11 +527,14 @@ input[readonly] {
 
 .profile-card {
   display: grid;
+  grid-template-rows: auto auto;
   gap: 14px;
+  min-height: 100%;
   padding: 18px;
   border-radius: var(--radius-md);
   background: var(--panel-strong);
   border: 1px solid rgba(47, 36, 30, 0.08);
+  overflow: visible;
 }
 
 .profile-card.active {
@@ -621,6 +559,7 @@ input[readonly] {
 .profile-heading {
   display: grid;
   gap: 8px;
+  min-width: 0;
 }
 
 .profile-badges {
@@ -646,7 +585,10 @@ input[readonly] {
 
 .profile-meta {
   display: grid;
+  grid-template-rows: repeat(3, auto);
   gap: 8px;
+  min-height: 0;
+  align-content: start;
 }
 
 .profile-meta span {
@@ -654,10 +596,14 @@ input[readonly] {
   gap: 4px;
   color: var(--muted);
   font-size: 0.92rem;
+  min-width: 0;
 }
 
 .profile-meta strong {
   color: var(--text);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
 }
 
 .profile-path {
@@ -700,12 +646,6 @@ input[readonly] {
   color: var(--error);
 }
 
-.workspace-status {
-  min-height: 0;
-  padding: 12px 14px;
-  background: rgba(255, 255, 255, 0.72);
-}
-
 .account-panel {
   display: grid;
   gap: 7px;
@@ -787,10 +727,6 @@ input[readonly] {
   margin-top: 0;
 }
 
-#proxyModeHint {
-  display: none;
-}
-
 @media (max-width: 1160px) {
   body {
     overflow: auto;
@@ -806,7 +742,6 @@ input[readonly] {
     height: auto;
   }
 
-  .workspace-main,
   .content-grid {
     grid-template-columns: 1fr;
   }
@@ -816,12 +751,6 @@ input[readonly] {
     overflow: visible;
   }
 
-  #proxyModeHint {
-    display: block;
-  }
-
-  .workspace-title-row,
-  .workspace-actions,
   .panel-header-actions {
     justify-content: flex-start;
   }
@@ -869,28 +798,21 @@ input[readonly] {
   }
 
   .auth-form-card,
-  .workspace-bar,
   .panel {
     border-radius: 20px;
     padding: 14px;
   }
 
-  .workspace-title-row {
-    flex-direction: column;
-    align-items: flex-start;
-  }
-
-  .workspace-text,
   .account-hint {
     font-size: 0.82rem;
     line-height: 1.4;
   }
 
-  .workspace-actions {
-    width: 100%;
+  .current-tools {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
   }
 
-  .workspace-actions button,
+  .current-tools button,
   .action-row button,
   .account-actions-grid button,
   .card-actions button {
@@ -902,6 +824,12 @@ input[readonly] {
     gap: 12px;
   }
 
+  .current-tools {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 8px;
+  }
+
   .current-panel,
   .account-panel,
   .profiles-panel {
@@ -941,6 +869,7 @@ input[readonly] {
   .profile-card {
     gap: 10px;
     padding: 14px;
+    min-height: 0;
   }
 
   .profile-topline {
@@ -964,6 +893,30 @@ input[readonly] {
   }
 }
 
+@media (max-width: 560px) {
+  .current-tools {
+    grid-template-columns: 1fr;
+  }
+
+  .profiles-list {
+    grid-auto-rows: auto;
+  }
+
+  .profile-card {
+    height: auto;
+  }
+
+  .profile-meta {
+    grid-template-rows: none;
+  }
+
+  .profile-meta strong {
+    white-space: normal;
+    overflow: visible;
+    text-overflow: clip;
+  }
+}
+
 @media (max-height: 920px) and (min-width: 1161px) {
   .page-shell {
     padding: 12px;
@@ -974,18 +927,10 @@ input[readonly] {
     padding: 16px;
   }
 
-  .workspace-bar {
-    padding: 16px 18px;
-  }
-
   .panel {
     padding: 16px;
   }
 
-  .workspace-copy h1 {
-    font-size: clamp(1.35rem, 1.8vw, 1.9rem);
-  }
-
   .metric-card {
     padding: 12px;
   }

package/src/web/launcher.js

@@ -9,6 +9,7 @@ const serverEntryPath = path.join(__dirname, "server.js");
 const port = Number(process.env.PORT || 3186);
 const proxyPort = 3187;
 const healthUrl = `http://127.0.0.1:${port}/api/health`;
+const closeUrl = `http://127.0.0.1:${port}/api/app/close`;
 const proxyHealthUrl = `http://127.0.0.1:${proxyPort}/__switcher/health`;
 const consoleUrl = `http://localhost:${port}`;
 
@@ -41,6 +42,44 @@ function requestJson(url, timeoutMs = 1200) {
   });
 }
 
+function postJson(url, timeoutMs = 2000) {
+  return new Promise((resolve, reject) => {
+    const target = new URL(url);
+    const request = http.request(
+      {
+        hostname: target.hostname,
+        port: target.port,
+        path: target.pathname,
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+        },
+      },
+      (response) => {
+        let data = "";
+        response.setEncoding("utf8");
+        response.on("data", (chunk) => {
+          data += chunk;
+        });
+        response.on("end", () => {
+          try {
+            resolve(JSON.parse(data));
+          } catch (error) {
+            reject(error);
+          }
+        });
+      },
+    );
+
+    request.setTimeout(timeoutMs, () => {
+      request.destroy(new Error("请求超时"));
+    });
+
+    request.on("error", reject);
+    request.end("{}");
+  });
+}
+
 /**
  * 检查本地网页服务是否已经可用。
  */
@@ -183,6 +222,65 @@ async function restartServer() {
   return ensureServerRunning();
 }
 
+function killListeningPid(targetPort) {
+  return new Promise((resolve, reject) => {
+    exec(`cmd /c netstat -ano | findstr :${targetPort}`, (error, stdout) => {
+      if (error) {
+        resolve(false);
+        return;
+      }
+
+      const lines = stdout
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+
+      const pids = [...new Set(lines
+        .map((line) => line.split(/\s+/))
+        .filter((parts) => parts[3] === "LISTENING")
+        .map((parts) => Number(parts[4]))
+        .filter((pid) => Number.isFinite(pid)))];
+
+      if (!pids.length) {
+        resolve(false);
+        return;
+      }
+
+      exec(`cmd /c taskkill ${pids.map((pid) => `/PID ${pid}`).join(" ")} /F`, (killError) => {
+        if (killError) {
+          reject(killError);
+          return;
+        }
+
+        resolve(true);
+      });
+    });
+  });
+}
+
+async function stopServer() {
+  if (await checkServerHealth()) {
+    try {
+      await postJson(closeUrl);
+    } catch {
+      // 服务正在退出时，可能来不及返回完整响应，这里继续走兜底检查。
+    }
+
+    await sleep(1000);
+  }
+
+  const webKilled = await killListeningPid(port);
+  const proxyKilled = await killListeningPid(proxyPort);
+
+  return {
+    stopped: true,
+    webKilled,
+    proxyKilled,
+    port,
+    proxyPort,
+  };
+}
+
 async function handleCommand(command) {
   switch (command) {
     case "ensure":
@@ -227,8 +325,13 @@ async function handleCommand(command) {
       console.log(JSON.stringify({ ...result, restarted: true }, null, 2));
       return;
     }
+    case "stop": {
+      const result = await stopServer();
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
     default:
-      throw new Error("不支持的命令。可用命令：ensure、open、status、restart");
+      throw new Error("不支持的命令。可用命令：ensure、open、status、restart、stop");
   }
 }
 
@@ -245,6 +348,7 @@ module.exports = {
   ensureServerRunning,
   handleCommand,
   restartServer,
+  stopServer,
   openBrowser,
   runtimeDir,
   consoleUrl,

package/src/web/server.js

@@ -166,6 +166,19 @@ function createApp() {
     }),
   );
 
+  app.post(
+    "/api/app/close",
+    wrapAsync(async () => {
+      setTimeout(() => {
+        process.emit("codex-switcher:shutdown");
+      }, 80);
+
+      return {
+        closing: true,
+      };
+    }),
+  );
+
   app.post(
     "/api/open-path",
     wrapAsync(async (req) => {
@@ -214,7 +227,7 @@ function startServer(options = {}) {
 
   proxyServer.listen(proxyPort);
 
-  return {
+  const controller = {
     webServer,
     proxyServer,
     close(callback) {
@@ -243,6 +256,15 @@ function startServer(options = {}) {
       proxyServer.close((error) => done(error));
     },
   };
+
+  process.removeAllListeners("codex-switcher:shutdown");
+  process.on("codex-switcher:shutdown", () => {
+    controller.close(() => {
+      process.exit(0);
+    });
+  });
+
+  return controller;
 }
 
 if (require.main === module) {