ai-code-switcher 0.1.20__tar.gz → 0.1.22__tar.gz

{ai_code_switcher-0.1.20 → ai_code_switcher-0.1.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-code-switcher
-Version: 0.1.20
+Version: 0.1.22
 Summary: Switch AI coding tool profiles and launch the correct CLI
 License: MIT
 Requires-Python: >=3.9
@@ -94,6 +94,11 @@ The supported AI CLIs are:
 - OpenAI Codex: `@openai/codex`
 - Grok: `@xai-official/grok`
 
+`code-ai upgrade` also refreshes the Grok binary in each login profile's
+credentials directory. Grok stores a separate binary under `GROK_HOME/bin`, so
+updating only the global npm package can leave a login profile running an old
+version. Restart running Grok sessions after upgrading.
+
 ## Profiles and configuration
 
 Profiles are stored in `~/.code-ai/config.yaml`. Use API mode when the profile
@@ -169,7 +174,7 @@ code-ai roll-claude-buddy claude-api --type legendary
 ## Desktop launcher
 
 The optional desktop launcher provides a graphical interface for detected
-Claude, ChatGPT, and Codex desktop apps. It is supported on Windows and macOS.
+Claude and Codex desktop apps. It is supported on Windows and macOS.
 
 ```bash
 python -m pip install "ai-code-switcher[desktop]"

{ai_code_switcher-0.1.20 → ai_code_switcher-0.1.22}/README.md

@@ -81,6 +81,11 @@ The supported AI CLIs are:
 - OpenAI Codex: `@openai/codex`
 - Grok: `@xai-official/grok`
 
+`code-ai upgrade` also refreshes the Grok binary in each login profile's
+credentials directory. Grok stores a separate binary under `GROK_HOME/bin`, so
+updating only the global npm package can leave a login profile running an old
+version. Restart running Grok sessions after upgrading.
+
 ## Profiles and configuration
 
 Profiles are stored in `~/.code-ai/config.yaml`. Use API mode when the profile
@@ -156,7 +161,7 @@ code-ai roll-claude-buddy claude-api --type legendary
 ## Desktop launcher
 
 The optional desktop launcher provides a graphical interface for detected
-Claude, ChatGPT, and Codex desktop apps. It is supported on Windows and macOS.
+Claude and Codex desktop apps. It is supported on Windows and macOS.
 
 ```bash
 python -m pip install "ai-code-switcher[desktop]"

{ai_code_switcher-0.1.20 → ai_code_switcher-0.1.22}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ai-code-switcher"
-version = "0.1.20"
+version = "0.1.22"
 description = "Switch AI coding tool profiles and launch the correct CLI"
 readme = {file = "README.md", content-type = "text/markdown"}
 license = {text = "MIT"}

{ai_code_switcher-0.1.20 → ai_code_switcher-0.1.22}/src/ai_code_switcher.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-code-switcher
-Version: 0.1.20
+Version: 0.1.22
 Summary: Switch AI coding tool profiles and launch the correct CLI
 License: MIT
 Requires-Python: >=3.9
@@ -94,6 +94,11 @@ The supported AI CLIs are:
 - OpenAI Codex: `@openai/codex`
 - Grok: `@xai-official/grok`
 
+`code-ai upgrade` also refreshes the Grok binary in each login profile's
+credentials directory. Grok stores a separate binary under `GROK_HOME/bin`, so
+updating only the global npm package can leave a login profile running an old
+version. Restart running Grok sessions after upgrading.
+
 ## Profiles and configuration
 
 Profiles are stored in `~/.code-ai/config.yaml`. Use API mode when the profile
@@ -169,7 +174,7 @@ code-ai roll-claude-buddy claude-api --type legendary
 ## Desktop launcher
 
 The optional desktop launcher provides a graphical interface for detected
-Claude, ChatGPT, and Codex desktop apps. It is supported on Windows and macOS.
+Claude and Codex desktop apps. It is supported on Windows and macOS.
 
 ```bash
 python -m pip install "ai-code-switcher[desktop]"

ai_code_switcher-0.1.22/src/code_ai/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.22"

{ai_code_switcher-0.1.20 → ai_code_switcher-0.1.22}/src/code_ai/cli.py

@@ -1,3 +1,4 @@
+import os
 import sys
 import subprocess
 from typing import Optional, List
@@ -291,19 +292,41 @@ UPGRADE_PACKAGES = [
 ]
 
 
+def _run_npm(args, env):
+    # On Windows, npm is a .cmd file, need to use shell=True or npm.cmd
+    if sys.platform == "win32":
+        return subprocess.run("npm " + " ".join(args), shell=True, env=env)
+    return subprocess.run(["npm"] + args, env=env)
+
+
 def upgrade():
     typer.echo("Upgrading claude, codex, grok CLI...")
 
-    # On Windows, npm is a .cmd file, need to use shell=True or npm.cmd
-    if sys.platform == "win32":
-        # Use shell=True on Windows for better compatibility
-        cmd = "npm install -g " + " ".join(UPGRADE_PACKAGES)
-        result = subprocess.run(cmd, shell=True)
-    else:
-        result = subprocess.run(
-            ["npm", "install", "-g"] + UPGRADE_PACKAGES,
-        )
-    sys.exit(result.returncode)
+    env = os.environ.copy()
+    env.pop("GROK_HOME", None)
+    result = _run_npm(["install", "-g"] + UPGRADE_PACKAGES, env)
+    if result.returncode:
+        sys.exit(result.returncode)
+
+    # Grok's npm launcher prefers GROK_HOME/bin even when that binary is old.
+    # Re-run its installer in each login home after updating the global package.
+    refreshed = {os.path.normcase(os.path.realpath(os.path.expanduser("~/.grok")))}
+    for name, profile in load_config().get("profiles", {}).items():
+        if (profile.get("type") != "grok" or profile.get("mode") != "login"
+                or not profile.get("credentials_path")):
+            continue
+        home = os.path.expanduser(profile["credentials_path"])
+        normalized_home = os.path.normcase(os.path.realpath(home))
+        if normalized_home in refreshed:
+            continue
+        typer.echo(f"Refreshing Grok CLI for login profile '{name}'...")
+        profile_env = dict(env, GROK_HOME=home)
+        result = _run_npm(["rebuild", "-g", "@xai-official/grok"], profile_env)
+        if result.returncode:
+            typer.echo(f"Failed to refresh Grok CLI for profile '{name}'.", err=True)
+            sys.exit(result.returncode)
+        refreshed.add(normalized_home)
+    sys.exit(0)
 
 
 if __name__ == "__main__":

{ai_code_switcher-0.1.20 → ai_code_switcher-0.1.22}/src/code_ai/desktop/app.py

@@ -37,8 +37,14 @@ def run_gui():
     import webview  # lazy: only needed to actually show the GUI
 
     bridge = LauncherBridge(backend, APP_REGISTRY)
+    # The page fits the window to its content once loaded (bridge.fit_window);
+    # this is just a close first guess so the window does not visibly jump.
     window = webview.create_window(
-        "AI Launcher", url=_ui_url(), js_api=bridge, width=760, height=560,
+        "AI Launcher", url=_ui_url(), js_api=bridge, width=600, height=276,
     )
-    bridge._attach_window(window, webview.OPEN_DIALOG)
+    try:
+        screen_height = int(webview.screens[0].height)
+    except Exception:  # headless / unknown screen: fit_window skips clamping
+        screen_height = None
+    bridge._attach_window(window, webview.OPEN_DIALOG, screen_height=screen_height)
     webview.start(icon=_window_icon_path())

{ai_code_switcher-0.1.20 → ai_code_switcher-0.1.22}/src/code_ai/desktop/apps.py

@@ -26,14 +26,6 @@ APP_REGISTRY: List[AppSpec] = [
         mac_bundle_name="Claude.app",
         mac_bundle_id="com.anthropic.claudefordesktop",
     ),
-    AppSpec(
-        id="chatgpt",
-        display="ChatGPT",
-        win_aumid="OpenAI.ChatGPT-Desktop_2p2nqsd0c76g0!ChatGPT",
-        win_package_family="OpenAI.ChatGPT-Desktop_2p2nqsd0c76g0",
-        mac_bundle_name="ChatGPT.app",
-        mac_bundle_id="com.openai.chat",
-    ),
     AppSpec(
         id="codex",
         display="Codex",

{ai_code_switcher-0.1.20 → ai_code_switcher-0.1.22}/src/code_ai/desktop/bridge.py

@@ -13,17 +13,23 @@ class LauncherBridge:
     native window objects as JS API members.
     """
 
+    # Keep the window clear of the taskbar/dock when it grows to fit content.
+    _SCREEN_MARGIN = 60
+    _MIN_HEIGHT = 200
+
     def __init__(self, backend, apps=APP_REGISTRY):
         self._backend = backend
         self._apps = apps
         self._window = None
         self._open_dialog = 20  # pywebview OPEN_DIALOG; overridden in app.py
+        self._screen_height = None
         self._status = {}
         self._refresh_detection()
 
-    def _attach_window(self, window, open_dialog):
+    def _attach_window(self, window, open_dialog, screen_height=None):
         self._window = window
         self._open_dialog = open_dialog
+        self._screen_height = screen_height
 
     # ---- detection cache ----
     def _refresh_detection(self):
@@ -110,6 +116,44 @@ class LauncherBridge:
         cfg.save_desktop_config(data)
         return {"ok": True}
 
+    # ---- window ----
+    def fit_window(self, payload):
+        """Resize the window so the page content fits without scrolling.
+
+        The page reports its current viewport height (`inner`) and the height
+        its content wants (`wanted`), both in CSS px; the same delta is applied
+        to the outer window so the title bar / borders stay out of the maths.
+        Growth is clamped to the screen and the window is nudged up when it
+        would otherwise run under the taskbar.
+        """
+        if self._window is None:
+            return {"ok": False}
+        try:
+            inner = int(payload.get("inner", 0))
+            wanted = int(payload.get("wanted", 0))
+        except (AttributeError, TypeError, ValueError):
+            return {"ok": False}
+        if inner <= 0 or wanted <= 0:
+            return {"ok": False}
+        try:
+            width, height = self._window.width, self._window.height
+            new_height = height + (wanted - inner)
+            limit = None
+            if self._screen_height:
+                limit = int(self._screen_height) - self._SCREEN_MARGIN
+                new_height = min(new_height, limit)
+            new_height = max(self._MIN_HEIGHT, new_height)
+            if abs(new_height - height) <= 1:
+                return {"ok": True, "height": height}
+            if limit is not None:
+                x, y = self._window.x, self._window.y
+                if y + new_height > limit:
+                    self._window.move(x, max(0, limit - new_height))
+            self._window.resize(width, new_height)
+        except Exception as exc:
+            return {"ok": False, "error": str(exc)}
+        return {"ok": True, "height": new_height}
+
     def pick_app_path(self, app_id):
         if self._window is None:
             return {"ok": False}

ai_code_switcher-0.1.22/src/code_ai/desktop/ui/app.js

@@ -0,0 +1,375 @@
+const api = () => window.pywebview.api;
+let APPS = [];
+let SETTINGS = { check_system_proxy: true, env_vars: {} };
+const APP_SETTINGS = {}; // id -> { env_vars, path }
+let READY = false;
+let lastRefresh = 0;
+
+const GEAR_SVG =
+  `<svg viewBox="0 0 24 24" width="18" height="18" aria-hidden="true">` +
+  `<path fill="currentColor" d="M10.3 2.3h3.4l.4 2.2c.6.2 1.2.5 1.7.9l2.1-.8 1.7 2.9-1.7 1.4c.1.6.2 1.2.2 1.8s-.1 1.2-.2 1.8l1.7 1.4-1.7 2.9-2.1-.8c-.5.4-1.1.7-1.7.9l-.4 2.2h-3.4l-.4-2.2a7 7 0 0 1-1.7-.9l-2.1.8-1.7-2.9 1.7-1.4a7 7 0 0 1-.2-1.8c0-.6.1-1.2.2-1.8L4.4 7.5 6.1 4.6l2.1.8c.5-.4 1.1-.7 1.7-.9l.4-2.2ZM12 9a3 3 0 1 0 0 6 3 3 0 0 0 0-6Z"/>` +
+  `</svg>`;
+
+function esc(s) {
+  return String(s)
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#x27;");
+}
+
+function findApp(id) { return APPS.find((x) => x.id === id); }
+
+async function init() {
+  APPS = await api().list_apps();
+  renderApps();
+  await Promise.all([loadSettings(), ...APPS.map((a) => loadAppSettings(a.id))]);
+  READY = true;
+  lastRefresh = Date.now();
+  fitWindow();
+}
+
+// ---- window fit ----
+// The window is a palette: it is always exactly as tall as its content. The
+// page measures what it needs and the bridge applies the delta to the window.
+function contentHeight() {
+  let h = document.getElementById("foot").offsetHeight;
+  for (const bay of document.querySelectorAll(".bay")) h += bay.offsetHeight;
+  return h;
+}
+
+function fitWindow(extra = 0) {
+  if (!window.pywebview || !api().fit_window) return;
+  const wanted = Math.ceil(contentHeight() + extra);
+  api().fit_window({ inner: window.innerHeight, wanted });
+}
+
+// ---- app bays ----
+function renderApps() {
+  const list = document.getElementById("apps");
+  list.innerHTML = "";
+  for (const a of APPS) {
+    const id = esc(a.id);
+    const name = esc(a.display);
+    const bay = document.createElement("section");
+    bay.className = "bay bay--app";
+    bay.id = `bay-${id}`;
+    bay.innerHTML =
+      `<div class="bay-row">` +
+      `<div class="bay-lamp" aria-hidden="true"><span class="lamp"></span></div>` +
+      `<div class="bay-copy">` +
+      `<h2 class="bay-name">${name}</h2>` +
+      `<p class="bay-status" id="status-${id}"></p>` +
+      `</div>` +
+      `<div class="bay-actions">` +
+      `<button class="btn btn--key" type="button" id="btn-launch-${id}" data-mode="launch">启动</button>` +
+      `<button class="btn btn--stop" type="button" id="btn-stop-${id}" data-mode="stop">中止</button>` +
+      `<button class="btn btn--key" type="button" id="btn-config-${id}" data-mode="config">选择路径…</button>` +
+      `<button class="gear" type="button" id="gear-${id}" aria-expanded="false" ` +
+      `aria-controls="editor-${id}" aria-label="${name} 专有设置" title="${name} 专有设置">${GEAR_SVG}</button>` +
+      `</div>` +
+      `</div>` +
+      `<div class="editor" id="editor-${id}" inert>` +
+      `<div class="editor-inner"><div class="editor-body">` +
+      `<div class="field">` +
+      `<div class="field-head"><span class="field-label">应用路径</span>` +
+      `<span class="field-hint">默认自动检测，也可以手动指定可执行文件</span></div>` +
+      `<div class="path-row"><code class="path-value" id="path-${id}"></code>` +
+      `<button class="btn btn--small" type="button" id="pick-${id}">选择…</button></div>` +
+      `</div>` +
+      `<div class="field">` +
+      `<div class="field-head"><span class="field-label">专有环境变量</span>` +
+      `<span class="field-hint">只在启动 ${name} 时注入，与通用变量同名时以这里为准</span></div>` +
+      `<div class="env-list" id="env-${id}"></div>` +
+      `<button class="add-row" type="button" id="add-${id}">添加变量</button>` +
+      `</div>` +
+      `<div class="editor-actions">` +
+      `<button class="btn" type="button" id="cancel-${id}">取消</button>` +
+      `<button class="btn btn--solid" type="button" id="save-${id}">保存</button>` +
+      `</div>` +
+      `</div></div>` +
+      `</div>`;
+    list.appendChild(bay);
+    updateBay(a.id, a.found, a.running);
+    document.getElementById(`btn-launch-${a.id}`).onclick = () => onAction(a.id, "launch");
+    document.getElementById(`btn-stop-${a.id}`).onclick = () => onAction(a.id, "stop");
+    document.getElementById(`btn-config-${a.id}`).onclick = () => onAction(a.id, "config");
+    document.getElementById(`gear-${a.id}`).onclick = () => toggleEditor(a.id);
+    document.getElementById(`pick-${a.id}`).onclick = () => onAction(a.id, "config");
+    document.getElementById(`add-${a.id}`).onclick = () => addEnvRow(`env-${a.id}`);
+    document.getElementById(`cancel-${a.id}`).onclick = () => setEditorOpen(a.id, false);
+    document.getElementById(`save-${a.id}`).onclick = () => saveAppSettings(a.id);
+  }
+}
+
+const BAY_ERRORS = {}; // id -> { msg, timer }
+
+// A failed launch/stop is reported in the bay's own status line, next to the
+// key that was pressed, and clears itself after a few seconds.
+function setBayError(id, msg) {
+  const cur = BAY_ERRORS[id];
+  if (cur) clearTimeout(cur.timer);
+  BAY_ERRORS[id] = msg ? {
+    msg,
+    timer: setTimeout(() => { delete BAY_ERRORS[id]; rerenderBay(id); }, 6000),
+  } : undefined;
+  rerenderBay(id);
+}
+
+function rerenderBay(id) {
+  const a = findApp(id);
+  if (a) updateBay(id, a.found, a.running);
+}
+
+function statusText(a) {
+  const s = APP_SETTINGS[a.id];
+  const n = s ? Object.keys(s.env_vars || {}).length : 0;
+  const vars = n ? ` · ${n} 个专有环境变量` : "";
+  if (!a.found) return "未检测到安装，选择应用路径后即可启动";
+  if (a.running) return "运行中" + vars;
+  return "未运行" + vars;
+}
+
+function updateBay(id, found, running) {
+  const a = findApp(id);
+  if (a) { a.found = found; a.running = running; }
+  const bay = document.getElementById(`bay-${id}`);
+  const status = document.getElementById(`status-${id}`);
+  const launch = document.getElementById(`btn-launch-${id}`);
+  const stop = document.getElementById(`btn-stop-${id}`);
+  const config = document.getElementById(`btn-config-${id}`);
+  if (!bay || !status || !launch || !stop || !config) return;
+  const err = BAY_ERRORS[id];
+  bay.classList.toggle("is-missing", !found);
+  bay.classList.toggle("is-running", !!(found && running));
+  bay.classList.toggle("has-error", !!err);
+  status.textContent = err ? err.msg : statusText(a || { id, found, running });
+  // Status can be stale (no background poll), so both keys stay live once the
+  // app is found; launch always stops-then-starts, hence "重启" while running.
+  launch.hidden = !found;
+  stop.hidden = !found;
+  config.hidden = found;
+  launch.textContent = running ? "重启" : "启动";
+}
+
+async function onAction(id, mode) {
+  if (mode === "config") {
+    const r = await api().pick_app_path(id);
+    if (r && r.ok) {
+      if (APP_SETTINGS[id]) APP_SETTINGS[id].path = r.path;
+      renderPath(id);
+      fitWindow(); // a long path may wrap
+      await refresh();
+    }
+    return;
+  }
+  let r = { ok: true };
+  if (mode === "launch") r = await api().launch_app(id);
+  else if (mode === "stop") r = await api().stop_app(id);
+  await refresh();
+  setBayError(id, r.ok ? "" : (r.error || "操作失败"));
+}
+
+async function refresh() {
+  lastRefresh = Date.now();
+  APPS = await api().list_apps();
+  for (const a of APPS) updateBay(a.id, a.found, a.running);
+}
+
+// No background status push (see bridge history); re-check when the window
+// comes back to the front instead, which is when a stale lamp would be noticed.
+function refreshOnReturn() {
+  if (!READY || document.hidden) return;
+  if (Date.now() - lastRefresh < 1500) return;
+  refresh();
+}
+
+// Confirmations surface in the footer status line rather than an overlay.
+function toast(msg) {
+  const foot = document.getElementById("foot");
+  document.getElementById("toast").textContent = msg;
+  foot.classList.add("has-msg");
+  clearTimeout(toast._timer);
+  toast._timer = setTimeout(() => foot.classList.remove("has-msg"), 2200);
+}
+
+// ---- inline editors ----
+function setEditorOpen(id, open) {
+  const editor = document.getElementById(`editor-${id}`);
+  const gear = document.getElementById(`gear-${id}`);
+  if (!editor || !gear) return;
+  if (open) {
+    // Re-render from the last saved state so a reopened editor never shows
+    // edits that were cancelled.
+    if (id === "common") renderCommon(); else renderAppEditor(id);
+    // Grow the window before the editor unfolds into the new space; the
+    // collapsed editor's scrollHeight is exactly the height it is about to take.
+    fitWindow(editor.firstElementChild.scrollHeight);
+  }
+  editor.classList.toggle("is-open", open);
+  editor.inert = !open;
+  gear.classList.toggle("is-active", open);
+  gear.setAttribute("aria-expanded", open ? "true" : "false");
+  if (open) {
+    // If the screen capped the window, keep the bay being edited in view.
+    const bay = editor.closest(".bay");
+    setTimeout(() => {
+      const panel = bay.closest(".panel");
+      const block = bay.offsetHeight > panel.clientHeight ? "start" : "nearest";
+      bay.scrollIntoView({ block, behavior: "smooth" });
+    }, 300);
+  } else {
+    // Shrink back once the fold animation has finished.
+    setTimeout(fitWindow, 300);
+  }
+}
+
+function toggleEditor(id) {
+  const editor = document.getElementById(`editor-${id}`);
+  setEditorOpen(id, !(editor && editor.classList.contains("is-open")));
+}
+
+function closeAllEditors() {
+  for (const ed of document.querySelectorAll(".editor.is-open")) {
+    setEditorOpen(ed.id.replace(/^editor-/, ""), false);
+  }
+}
+
+// ---- env rows ----
+function renderEnv(containerId, vars) {
+  const c = document.getElementById(containerId);
+  c.innerHTML = "";
+  for (const [k, v] of Object.entries(vars || {})) addEnvRow(containerId, k, v, false);
+}
+
+function addEnvRow(containerId, k = "", v = "", focus = true) {
+  const c = document.getElementById(containerId);
+  const row = document.createElement("div");
+  row.className = "env-row";
+  row.innerHTML =
+    `<input class="k" placeholder="KEY" spellcheck="false" autocomplete="off" value="${esc(k)}">` +
+    `<span class="eq" aria-hidden="true">=</span>` +
+    `<input class="v" placeholder="VALUE" spellcheck="false" autocomplete="off" value="${esc(v)}">` +
+    `<button class="del" type="button" aria-label="删除这个变量" title="删除">` +
+    `<svg viewBox="0 0 24 24" width="14" height="14" aria-hidden="true">` +
+    `<path fill="currentColor" d="M6.4 5 5 6.4 10.6 12 5 17.6 6.4 19 12 13.4 17.6 19 19 17.6 13.4 12 19 6.4 17.6 5 12 10.6 6.4 5Z"/>` +
+    `</svg></button>`;
+  row.querySelector(".del").onclick = () => { row.remove(); fitWindow(); };
+  c.appendChild(row);
+  if (focus) {
+    fitWindow();
+    if (!k) row.querySelector(".k").focus();
+  }
+}
+
+function collectEnv(containerId) {
+  const out = {};
+  for (const row of document.querySelectorAll(`#${containerId} .env-row`)) {
+    const k = row.querySelector(".k").value.trim();
+    const v = row.querySelector(".v").value;
+    if (k) out[k] = v;
+  }
+  return out;
+}
+
+// ---- common settings ----
+async function loadSettings() {
+  SETTINGS = await api().get_settings();
+  renderCommon();
+}
+
+function renderCommon() {
+  document.getElementById("proxy").checked = !!SETTINGS.check_system_proxy;
+  renderEnv("common-env", SETTINGS.env_vars);
+  const n = Object.keys(SETTINGS.env_vars || {}).length;
+  document.getElementById("common-summary").textContent =
+    (SETTINGS.check_system_proxy ? "启动前检查系统代理" : "不检查系统代理") +
+    " · " + (n ? `${n} 个通用环境变量` : "没有通用环境变量");
+}
+
+async function saveSettings() {
+  const payload = {
+    check_system_proxy: document.getElementById("proxy").checked,
+    env_vars: collectEnv("common-env"),
+  };
+  await api().save_settings(payload);
+  SETTINGS = payload;
+  setEditorOpen("common", false);
+  renderCommon();
+  toast("已保存");
+}
+
+// ---- per-app settings ----
+async function loadAppSettings(id) {
+  APP_SETTINGS[id] = await api().get_app_settings(id);
+  renderAppEditor(id);
+  rerenderBay(id);
+}
+
+function renderPath(id) {
+  const el = document.getElementById(`path-${id}`);
+  const s = APP_SETTINGS[id] || {};
+  el.textContent = s.path || "自动检测";
+  el.classList.toggle("is-auto", !s.path);
+}
+
+function renderAppEditor(id) {
+  const s = APP_SETTINGS[id] || { env_vars: {}, path: "" };
+  renderPath(id);
+  renderEnv(`env-${id}`, s.env_vars);
+}
+
+async function saveAppSettings(id) {
+  const env_vars = collectEnv(`env-${id}`);
+  await api().save_app_settings(id, { env_vars });
+  APP_SETTINGS[id] = { ...(APP_SETTINGS[id] || {}), env_vars };
+  setEditorOpen(id, false);
+  rerenderBay(id);
+  toast("已保存");
+}
+
+// ---- wiring ----
+document.addEventListener("DOMContentLoaded", () => {
+  document.getElementById("gear-common").onclick = () => toggleEditor("common");
+  document.getElementById("cancel-common").onclick = () => setEditorOpen("common", false);
+  document.getElementById("add-common").onclick = () => addEnvRow("common-env");
+  document.getElementById("save-settings").onclick = saveSettings;
+  document.addEventListener("keydown", (e) => {
+    if (e.key === "Escape") closeAllEditors();
+  });
+  window.addEventListener("focus", refreshOnReturn);
+  document.addEventListener("visibilitychange", refreshOnReturn);
+});
+
+window.addEventListener("pywebviewready", init);
+
+if (new URLSearchParams(location.search).has("preview")) {
+  document.documentElement.classList.add("preview");
+  APPS = [
+    { id: "claude", display: "Claude", found: true, running: true },
+    { id: "codex", display: "Codex", found: false, running: false },
+  ];
+  const appSettings = {
+    claude: { env_vars: { ANTHROPIC_BASE_URL: "https://api.example.com" }, path: "" },
+    codex: { env_vars: {}, path: "" },
+  };
+  window.pywebview = {
+    api: {
+      list_apps: async () => APPS,
+      get_settings: async () => ({
+        check_system_proxy: true,
+        env_vars: { HTTP_PROXY: "http://127.0.0.1:7890", HTTPS_PROXY: "http://127.0.0.1:7890" },
+      }),
+      save_settings: async () => ({ ok: true }),
+      get_app_settings: async (id) => appSettings[id],
+      save_app_settings: async () => ({ ok: true }),
+      pick_app_path: async () => ({ ok: false }),
+      fit_window: async () => ({ ok: true }),
+      launch_app: async (id) =>
+        id === "claude" ? { ok: true } : { ok: false, error: "系统代理未开启，已取消启动" },
+      stop_app: async () => ({ ok: true }),
+    },
+  };
+  document.addEventListener("DOMContentLoaded", init);
+}