fix: centralize auth controls in system settings

WuShengXi · WuShengXi · commit 2d004917f2b1 · 2026-06-06T15:56:33.000+08:00
diff --git a/README.md b/README.md
@@ -11,7 +11,7 @@
 - 支持按调用次数轮换、按错误次数轮换、手动切换账号。
 - OpenAI 兼容接口：`/v1/chat/completions`、`/v1/completions`、`/v1/responses`、`/v1/models`。
 - Gemini 原生接口：生成、流式生成、Gems、Deep Research、文件上传、媒体结果索引。
-- 管理端控制台：请求看板、账户设置、授权登录、授权 Cookie 诊断、Gems、Deep Research、媒体生成和媒体结果。
+- 管理端控制台：请求看板、账户设置、系统设置集中授权、授权 Cookie 诊断、Gems、Deep Research、媒体生成和媒体结果。
 - 服务器部署可开启管理员登录，保护网页控制台和管理接口；外部调用继续使用 API Key。
 - 媒体生成支持 `image`、`video`、`audio` 模式；生成结果会保存索引，并尽量缓存到本地，避免 Gemini 原始链接过期后无法查看。
 - 自用保护：图片/视频/音频生成会记录尝试和冷却状态，媒体额度错误或上游 2xx 但没有产出媒体时默认冷却 5 小时，避免额度异常时反复请求。
@@ -316,16 +316,16 @@ python scripts/smoke_deploy.py --base-url http://localhost:7860 --api-key sk-you
 
 ## 添加账号
 
-推荐使用管理端的“网页授权”：
+推荐使用管理端“系统设置”里的“网页授权”：
 
 1. 打开 `http://localhost:7860`
-2. 进入“账户设置”
+2. 进入“系统设置”
 3. 点击“网页授权”
 4. 在弹出的 noVNC 浏览器中登录 Google/Gemini
 5. 回到管理端点击“检查授权状态”
 6. 看到“已发现 Gemini 登录 Cookie”后，再点击“保存授权 Cookie”
 
-如果“检查授权状态”提示还没有发现 `__Secure-1PSID`，说明容器内授权浏览器还没有完成 Google/Gemini 登录，或当前页面不在有效登录态。此时不要反复保存，先回到 noVNC 授权浏览器完成登录，再重新检查。诊断接口只返回是否发现 Cookie、Cookie 数量、当前页面 URL 等摘要，不会返回 Cookie 明文。
+如果“检查授权状态”提示还没有发现 `__Secure-1PSID`，说明容器内授权浏览器还没有完成 Google/Gemini 登录，或当前页面不在有效登录态。此时不要反复保存，先回到 noVNC 授权浏览器完成登录，再重新检查。诊断接口只返回是否发现 Cookie、Cookie 数量、当前页面 URL 等摘要，不会返回 Cookie 明文。保存授权 Cookie 成功后，管理端会自动关闭授权界面和后端授权会话。
 
 也可以复制示例文件后导入：
 
@@ -862,7 +862,8 @@ curl http://localhost:7860/v1/gemini/stream \
 - `Gems`：查看、创建、更新、删除自定义 system prompt。
 - `Deep Research`：创建研究计划、启动、轮询状态和查看结果。
 - `媒体结果`：上方生成图片/视频/音频，下方查看媒体历史和缓存/代理链接。
-- `账户设置`：调整轮换策略、授权操作、检查授权 Cookie 状态、导入/导出/验证/切换账号，并可手动解除账号媒体冷却。
+- `账户设置`：调整轮换策略、导入/导出/验证/切换账号，并可手动解除账号媒体冷却。
+- `系统设置`：生成外部 API Key、配置对象存储，并集中进行网页授权、授权 Cookie 诊断和保存。
 
 请求日志会记录输出类型、任务/请求 id、媒体数量和错误信息；媒体生成完成后会回填实际 `media_count`，方便在看板里判断图片、视频或音频是否真正产出。早期没有 `job_id/request_id` 的历史日志无法可靠关联媒体结果，会保留原始计数。
 
diff --git a/scripts/smoke_deploy.py b/scripts/smoke_deploy.py
@@ -499,6 +499,18 @@ def _require_admin_ui(body: str) -> None:
     _require("外部调用未就绪" in body, "admin UI missing readiness diagnostic copy")
     _require("网页授权" in body, "admin UI missing web authorization action")
     _require("检查授权状态" in body, "admin UI missing auth cookie diagnostics action")
+    _require(
+        "网页授权集中在系统设置中操作" in body,
+        "admin UI auth controls are not centralized in system settings",
+    )
+    _require(
+        "data-panel-action=\"system-auth\"" in body,
+        "admin UI missing system settings auth navigation action",
+    )
+    _require(
+        "data-panel-action=\"auth\"" not in body,
+        "admin UI still exposes direct auth actions outside system settings",
+    )
     _require("gemini-3.1-pro" in body, "admin UI missing gemini-3.1-pro model option")
     _require("gemini-3.5-flash" in body, "admin UI missing gemini-3.5-flash model option")
     _require(
diff --git a/src/gemini_webapi/server/static/index.html b/src/gemini_webapi/server/static/index.html
@@ -693,19 +693,6 @@ <h2>媒体结果</h2>
               <span class="hint">设置为 0 表示关闭对应自动切换；429/503 和鉴权错误仍会保护性切换。</span>
             </div>
           </section>
-          <section>
-            <div class="section-head"><h2>授权操作</h2><button id="saveAuthBtn" class="primary">保存授权 Cookie</button></div>
-            <div class="content stack">
-              <div class="notice">点击“网页授权”会启动容器内浏览器，并在新界面打开 noVNC。登录完成后回到这里保存 Cookie。</div>
-              <div class="row button-row">
-                <button id="reopenAuthBtn">打开授权界面</button>
-                <button id="reloadAuthBtn">刷新授权浏览器</button>
-                <button id="diagnoseAuthBtn">检查授权状态</button>
-                <button id="closeAuthBtn">关闭授权会话</button>
-              </div>
-              <div id="authDiagnoseBox" class="hint">授权浏览器启动后，可先检查是否已经拿到 Gemini Cookie，再保存到账户池。</div>
-            </div>
-          </section>
         </div>
         <section>
           <div class="section-head"><h2>账户池</h2><button id="refreshAccountsBtn">刷新</button></div>
@@ -717,7 +704,6 @@ <h2>媒体结果</h2>
               <button id="validateCurrentBtn">验证当前</button>
               <button id="validateAllBtn">验证全部</button>
               <button id="manualOpenBtn">手动添加</button>
-              <button id="authOpenBtn" class="primary">网页授权</button>
             </div>
             <div id="accountList" class="account-grid"></div>
           </div>
@@ -755,6 +741,15 @@ <h2>系统设置</h2>
             <label>Public URL<input id="objectStoragePublicUrl" placeholder="https://cdn.example.com/media"></label>
           </div>
           <div class="stack">
+            <div class="notice">网页授权集中在系统设置中操作：启动授权浏览器后，在 noVNC 里完成 Google/Gemini 登录，检查到 Cookie 后保存到账户池。保存完成会自动关闭授权界面。</div>
+            <div class="row button-row">
+              <button id="authOpenBtn" class="primary">网页授权</button>
+              <button id="reloadAuthBtn">刷新授权浏览器</button>
+              <button id="diagnoseAuthBtn">检查授权状态</button>
+              <button id="saveAuthBtn">保存授权 Cookie</button>
+              <button id="closeAuthBtn">关闭授权会话</button>
+            </div>
+            <div id="authDiagnoseBox" class="hint">授权浏览器启动后，可先检查是否已经拿到 Gemini Cookie，再保存到账户池。</div>
             <div class="split">
               <label>Access Key ID<input id="objectStorageAccessKey" autocomplete="off"></label>
               <label>Secret Access Key<input id="objectStorageSecretKey" type="password" autocomplete="new-password" placeholder="保存后会脱敏显示"></label>
@@ -993,7 +988,7 @@ <h2>系统设置</h2>
     }
     function readinessReasonText(reason) {
       const map = {
-        no_accounts: "还没有授权 Gemini 账户，请到“账户设置”使用网页授权或手动添加 Cookie。",
+        no_accounts: "还没有授权 Gemini 账户，请到“系统设置”使用网页授权，或到“账户设置”手动添加 Cookie。",
         no_available_accounts: "账户都已停用或过期，请重新验证、启用或重新授权。",
         readiness_error: "调用就绪检查失败，请检查外部 API Key、管理员会话或服务状态。",
       };
@@ -1021,7 +1016,7 @@ <h2>系统设置</h2>
             </div>
           </div>
           <div class="diagnostic-actions">
-            <button data-panel-action="auth">网页授权</button>
+            <button data-panel-action="system-auth">去系统设置授权</button>
             <button data-panel-action="validate-all">验证全部账户</button>
           </div>
         </div>`;
@@ -1101,10 +1096,10 @@ <h2>系统设置</h2>
           <div class="diagnostic">
             <div>
               <div class="diagnostic-title">当前没有可用账户</div>
-              <div class="hint">请添加 Cookie，或使用网页授权重新登录 Gemini。</div>
+              <div class="hint">请到系统设置完成网页授权，或手动添加 Cookie。</div>
             </div>
             <div class="diagnostic-actions">
-              <button class="primary" data-panel-action="auth">网页授权</button>
+              <button class="primary" data-panel-action="system-auth">去系统设置授权</button>
               <button data-panel-action="validate-all">验证全部账户</button>
             </div>
           </div>`;
@@ -1138,7 +1133,7 @@ <h2>系统设置</h2>
             </div>
           </div>
           <div class="diagnostic-actions">
-            ${current.expired ? `<button class="primary" data-panel-action="auth">重新网页授权</button>` : ""}
+            ${current.expired ? `<button class="primary" data-panel-action="system-auth">去系统设置重新授权</button>` : ""}
             <button data-panel-action="validate-current">验证当前</button>
             <button data-panel-action="validate-all">验证全部</button>
           </div>
@@ -1353,14 +1348,17 @@ <h2>系统设置</h2>
       $(infoId).textContent = "";
       setMsg("已清空参考附件");
     }
-
-    document.querySelectorAll("nav button").forEach(btn => btn.onclick = () => {
+    function activateTab(tabId) {
+      const btn = document.querySelector(`nav button[data-tab="${tabId}"]`);
+      if (!btn) return;
       document.querySelectorAll("nav button").forEach(b => b.classList.toggle("active", b === btn));
-      document.querySelectorAll(".view").forEach(v => v.classList.toggle("active", v.id === btn.dataset.tab));
-      if (btn.dataset.tab === "gems") refreshGems().catch(e => setMsg(e.message));
-      if (btn.dataset.tab === "media") refreshMedia().catch(e => setMsg(e.message));
-      if (btn.dataset.tab === "system") refreshSystemSettings().catch(e => setMsg(e.message));
-    });
+      document.querySelectorAll(".view").forEach(v => v.classList.toggle("active", v.id === tabId));
+      if (tabId === "gems") refreshGems().catch(e => setMsg(e.message));
+      if (tabId === "media") refreshMedia().catch(e => setMsg(e.message));
+      if (tabId === "system") refreshSystemSettings().catch(e => setMsg(e.message));
+    }
+
+    document.querySelectorAll("nav button").forEach(btn => btn.onclick = () => activateTab(btn.dataset.tab));
     document.body.onclick = event => {
       const close = event.target.closest("[data-close-modal]");
       if (close) closeModal(close.dataset.closeModal);
@@ -1632,8 +1630,9 @@ <h2>系统设置</h2>
       const btn = event.target.closest("button[data-panel-action]");
       if (!btn) return;
       const action = btn.dataset.panelAction;
-      if (action === "auth") {
-        await startAuth().catch(e => setMsg(e.message));
+      if (action === "system-auth") {
+        activateTab("system");
+        setMsg("请在系统设置中完成网页授权。");
         return;
       }
       if (action === "validate-current") {
@@ -1654,6 +1653,11 @@ <h2>系统设置</h2>
       if (!state.authWindow) throw new Error("浏览器阻止了弹窗，请允许此站点打开新窗口。");
       $("authDiagnoseBox").textContent = "授权浏览器已打开。登录完成后点击“检查授权状态”，确认 Cookie 可用后再保存。";
     }
+    async function closeAuthSession() {
+      await api("/v1/auth/session", { method: "DELETE" });
+      if (state.authWindow && !state.authWindow.closed) state.authWindow.close();
+      state.authWindow = null;
+    }
     async function diagnoseAuth() {
       const data = await api("/v1/auth/diagnose");
       const ok = Boolean(data.has_secure_1psid);
@@ -1666,20 +1670,24 @@ <h2>系统设置</h2>
       return data;
     }
     $("authOpenBtn").onclick = () => startAuth().catch(e => setMsg(e.message));
-    $("reopenAuthBtn").onclick = () => startAuth().catch(e => setMsg(e.message));
     $("reloadAuthBtn").onclick = () => api("/v1/auth/press", { method: "POST", body: JSON.stringify({ key: "F5" }) }).catch(e => setMsg(e.message));
     $("diagnoseAuthBtn").onclick = () => diagnoseAuth().catch(e => {
       $("authDiagnoseBox").textContent = `无法检查授权状态：${e.message}`;
       setMsg(e.message);
     });
-    $("closeAuthBtn").onclick = async () => { await api("/v1/auth/session", { method: "DELETE" }); if (state.authWindow && !state.authWindow.closed) state.authWindow.close(); };
+    $("closeAuthBtn").onclick = async () => {
+      await closeAuthSession();
+      $("authDiagnoseBox").textContent = "授权会话已关闭。";
+    };
     $("authSaveConfirmBtn").onclick = async () => {
       try {
         const data = await api("/v1/auth/save", { method: "POST", body: JSON.stringify({ name: $("authSaveName").value || null }) });
         closeModal("authSaveModal");
         await refreshAll();
+        await closeAuthSession().catch(() => {});
         const savedText = data.saved ? `授权 Cookie 已保存到账户池 #${data.account_id}，当前共 ${data.account_count ?? (data.accounts || []).length} 个账户。` : "授权 Cookie 未确认保存。";
-        setMsg(data.validation?.valid ? `${savedText} 验证通过。` : `${savedText} 但验证失败：${data.validation?.message || "请稍后重新验证。"}`);
+        $("authDiagnoseBox").textContent = `${savedText} 授权界面已关闭。`;
+        setMsg(data.validation?.valid ? `${savedText} 验证通过，授权界面已关闭。` : `${savedText} 但验证失败：${data.validation?.message || "请稍后重新验证。"} 授权界面已关闭。`);
       } catch (error) {
         $("authSaveDiagnose").textContent = `保存失败：${error.message}。请先点击“检查授权状态”，确认已发现 __Secure-1PSID。`;
         setMsg(error.message);
diff --git a/tests/test_smoke_deploy.py b/tests/test_smoke_deploy.py
@@ -1195,6 +1195,8 @@ def fake_urlopen(request, timeout):
                     <title>Gemini API 管理端</title>
                     <div id="readinessPanel">外部调用未就绪</div>
                     <strong id="metricReadiness">未知</strong>
+                    <div>网页授权集中在系统设置中操作</div>
+                    <button data-panel-action="system-auth">去系统设置授权</button>
                     <button>网页授权</button>
                     <button>检查授权状态</button>
                     <option value="gemini-3.1-pro">gemini-3.1-pro</option>
@@ -1237,6 +1239,8 @@ def fake_urlopen(request, timeout):
                     <title>Gemini API 管理端</title>
                     <div id="readinessPanel">外部调用未就绪</div>
                     <strong id="metricReadiness">未知</strong>
+                    <div>网页授权集中在系统设置中操作</div>
+                    <button data-panel-action="system-auth">去系统设置授权</button>
                     <button>网页授权</button>
                     <button>检查授权状态</button>
                     <option value="gemini-3.1-pro">gemini-3.1-pro</option>
