dsh-github-flow 0.1.7 → 0.2.0

package/lib/client.js

@@ -5,6 +5,10 @@ window.__ModuleLoader__.load({
         var exports = module.exports;
         Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
         var React = require("react");
+        // 面板样式（内联维护）：DSH 客户端加载器以经典脚本语义执行本产物（build.mjs 剥除
+        // export 声明即为佐证），模块级 import 在该语境是 SyntaxError。曾尝试把 CSS 拆为
+        // 独立模块经 import 引入，导致 DSH 重启时客户端加载崩溃并触发插件批量卸载——
+        // 已回滚。样式与组件的分离改由「同文件内分区注释」维持，不再跨文件。
         var GITHUB_PANEL_CSS = `
 /* ==========================================================================
    DSH GitHub Flow - 主题自适应样式系统 (Light / Dark 动态联动)
@@ -804,6 +808,265 @@ body[data-ds-dark-theme] .dsh-github-steps-list {
   margin-top: 10px;
   line-height: 1.4;
 }
+
+/* 16. 设置弹窗 (Settings Modal)：左侧分区导航 + 右侧内容区 */
+.dsh-github-modal-overlay {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: rgba(0, 0, 0, 0.45);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 99999;
+  backdrop-filter: blur(2px);
+}
+.dsh-github-modal-dialog {
+  width: 92%;
+  max-width: 640px;
+  max-height: 86vh;
+  display: flex;
+  flex-direction: column;
+  background: var(--dsw-alias-bg-base, #ffffff);
+  border: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  border-radius: 12px;
+  box-shadow: 0 16px 32px rgba(0, 0, 0, 0.18);
+  padding: 0;
+  box-sizing: border-box;
+  overflow: hidden;
+  color: var(--dsw-alias-label-primary, #1f2328);
+  font-family: var(--dsw-font-family, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif);
+}
+body[data-ds-dark-theme] .dsh-github-modal-dialog {
+  background: var(--dsw-alias-bg-layer-2, #1e1e22);
+  border-color: var(--dsw-alias-border-l1, #30363d);
+  box-shadow: 0 16px 36px rgba(0, 0, 0, 0.45);
+}
+/* 弹窗头部（标题 + 关闭） */
+.dsh-github-modal-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 18px 22px 14px;
+  border-bottom: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  flex-shrink: 0;
+}
+body[data-ds-dark-theme] .dsh-github-modal-header {
+  border-bottom-color: var(--dsw-alias-border-l1, #30363d);
+}
+/* 分区导航 + 内容 双栏骨架：窄屏（<560px）自动折叠为顶部横向页签 */
+.dsh-github-modal-body {
+  display: flex;
+  min-height: 0;
+  flex: 1;
+}
+.dsh-github-settings-nav {
+  flex-shrink: 0;
+  width: 148px;
+  padding: 14px 10px;
+  border-right: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  box-sizing: border-box;
+}
+body[data-ds-dark-theme] .dsh-github-settings-nav {
+  border-right-color: var(--dsw-alias-border-l1, #30363d);
+}
+.dsh-github-settings-nav-item {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 10px;
+  border-radius: 6px;
+  border: none;
+  background: none;
+  cursor: pointer;
+  font-size: 13px;
+  text-align: left;
+  color: var(--dsw-alias-label-secondary, #656d76);
+  transition: background 0.12s ease, color 0.12s ease;
+}
+.dsh-github-settings-nav-item:hover {
+  background: var(--dsw-alias-bg-layer-1, #f6f8fa);
+  color: var(--dsw-alias-label-primary, #1f2328);
+}
+.dsh-github-settings-nav-item.active {
+  background: rgba(9, 105, 218, 0.1);
+  color: var(--dsw-alias-link, #0969da);
+  font-weight: 600;
+}
+body[data-ds-dark-theme] .dsh-github-settings-nav-item:hover {
+  background: rgba(240, 246, 252, 0.06);
+  color: var(--dsw-alias-label-primary, #f0f6fc);
+}
+body[data-ds-dark-theme] .dsh-github-settings-nav-item.active {
+  background: rgba(88, 166, 255, 0.15);
+  color: #58a6ff;
+}
+.dsh-github-settings-content {
+  flex: 1;
+  min-width: 0;
+  padding: 18px 22px 20px;
+  overflow-y: auto;
+  box-sizing: border-box;
+}
+@media (max-width: 560px) {
+  .dsh-github-modal-body {
+    flex-direction: column;
+  }
+  .dsh-github-settings-nav {
+    width: 100%;
+    flex-direction: row;
+    border-right: none;
+    border-bottom: 1px solid var(--dsw-alias-border-l2, #d0d7e0);
+    overflow-x: auto;
+  }
+  body[data-ds-dark-theme] .dsh-github-settings-nav {
+    border-bottom-color: var(--dsw-alias-border-l1, #30363d);
+  }
+  .dsh-github-settings-nav-item {
+    white-space: nowrap;
+  }
+}
+/* 弹窗底部操作条 */
+.dsh-github-modal-footer {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+  padding: 14px 22px;
+  border-top: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  flex-shrink: 0;
+}
+body[data-ds-dark-theme] .dsh-github-modal-footer {
+  border-top-color: var(--dsw-alias-border-l1, #30363d);
+}
+.dsh-github-radio-card {
+  display: flex;
+  align-items: flex-start;
+  gap: 10px;
+  padding: 10px 12px;
+  border-radius: 8px;
+  border: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  margin-bottom: 8px;
+  cursor: pointer;
+  transition: all 0.15s ease;
+  background: var(--dsw-alias-bg-layer-1, #f6f8fa);
+}
+.dsh-github-radio-card:hover {
+  border-color: var(--dsw-alias-link, #0969da);
+}
+.dsh-github-radio-card.active {
+  border-color: var(--dsw-alias-link, #0969da);
+  background: rgba(9, 105, 218, 0.08);
+}
+body[data-ds-dark-theme] .dsh-github-radio-card {
+  background: var(--dsw-alias-bg-base, #161b22);
+  border-color: var(--dsw-alias-border-l1, #30363d);
+}
+body[data-ds-dark-theme] .dsh-github-radio-card.active {
+  border-color: #58a6ff;
+  background: rgba(88, 166, 255, 0.12);
+}
+
+/* 下拉菜单及选项在深色/浅色模式下的精准适配 */
+.dsh-github-select {
+  width: 100%;
+  padding: 8px 12px;
+  border-radius: 6px;
+  border: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  background: var(--dsw-alias-bg-base, #ffffff);
+  color: var(--dsw-alias-label-primary, #1f2328);
+  font-size: 13px;
+  outline: none;
+  cursor: pointer;
+  box-sizing: border-box;
+  color-scheme: light;
+  transition: border-color 0.15s ease, box-shadow 0.15s ease;
+}
+.dsh-github-select:focus {
+  border-color: var(--dsw-alias-link, #0969da);
+  box-shadow: 0 0 0 3px rgba(9, 105, 218, 0.15);
+}
+.dsh-github-select option {
+  background-color: #ffffff;
+  color: #1f2328;
+  padding: 6px 10px;
+}
+body[data-ds-dark-theme] .dsh-github-select {
+  border-color: var(--dsw-alias-border-l1, #30363d);
+  background: var(--dsw-alias-bg-layer-2, #1e1e22);
+  color: var(--dsw-alias-label-primary, #f0f6fc);
+  color-scheme: dark;
+}
+body[data-ds-dark-theme] .dsh-github-select:focus {
+  border-color: #58a6ff;
+  box-shadow: 0 0 0 3px rgba(88, 166, 255, 0.2);
+}
+body[data-ds-dark-theme] .dsh-github-select option {
+  background-color: #1e1e22;
+  color: #f0f6fc;
+}
+
+/* 代理设置弹窗的文本输入框（浅色/深色双模式，设计变量对齐 select 保持视觉一致） */
+.dsh-github-input {
+  padding: 7px 12px;
+  border-radius: 6px;
+  border: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  background: var(--dsw-alias-bg-base, #ffffff);
+  color: var(--dsw-alias-label-primary, #1f2328);
+  font-size: 13px;
+  outline: none;
+  box-sizing: border-box;
+  color-scheme: light;
+  transition: border-color 0.15s ease, box-shadow 0.15s ease;
+}
+.dsh-github-input:focus {
+  border-color: var(--dsw-alias-link, #0969da);
+  box-shadow: 0 0 0 3px rgba(9, 105, 218, 0.15);
+}
+.dsh-github-input::placeholder {
+  color: var(--dsw-alias-label-tertiary, #8c959f);
+}
+body[data-ds-dark-theme] .dsh-github-input {
+  border-color: var(--dsw-alias-border-l1, #30363d);
+  background: var(--dsw-alias-bg-layer-2, #1e1e22);
+  color: var(--dsw-alias-label-primary, #f0f6fc);
+  color-scheme: dark;
+}
+body[data-ds-dark-theme] .dsh-github-input:focus {
+  border-color: #58a6ff;
+  box-shadow: 0 0 0 3px rgba(88, 166, 255, 0.2);
+}
+
+/* 缓存信息展示框 */
+.dsh-github-cache-info-box {
+  padding: 10px 12px;
+  border-radius: 6px;
+  background: var(--dsw-alias-bg-layer-1, #f6f8fa);
+  border: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  margin-bottom: 20px;
+  font-size: 12px;
+  color: var(--dsw-alias-label-secondary, #656d76);
+  transition: all 0.15s ease;
+}
+body[data-ds-dark-theme] .dsh-github-cache-info-box {
+  background: var(--dsw-alias-bg-base, #161b22);
+  border-color: var(--dsw-alias-border-l1, #30363d);
+  color: var(--dsw-alias-label-secondary, #8c8c8c);
+}
+
+/* 单选框点强调色 */
+.dsh-github-radio {
+  accent-color: var(--dsw-alias-link, #0969da);
+  cursor: pointer;
+  margin-top: 3px;
+}
+body[data-ds-dark-theme] .dsh-github-radio {
+  accent-color: #58a6ff;
+}
 `;
         function injectStyles() {
             var styleId = "dsh-plugin-github-styles";
@@ -949,7 +1212,25 @@ body[data-ds-dark-theme] .dsh-github-steps-list {
                 }, "🌐 官网安装包 (.msi/.pkg)")
                 : null, h("button", {
                 className: "dsh-github-action-btn",
-                onClick: onRefresh,
+                onClick: function () {
+                    setToastMsg("正在快速检测登录状态...");
+                    fetch("/api/github/auth?force=true")
+                        .then(function (res) { return res.json(); })
+                        .then(function (json) {
+                        if (json && json.ok && json.auth && json.auth.loggedIn) {
+                            setToastMsg("✅ 已识别到 GitHub CLI 登录态，正在拉取数据...");
+                            clearStoredGlobalOverview();
+                            onRefresh();
+                        }
+                        else {
+                            setToastMsg("⚠️ 暂未检测到登录凭据，请在终端执行 gh auth login 完成授权");
+                            onRefresh();
+                        }
+                    })
+                        .catch(function () {
+                        onRefresh();
+                    });
+                },
                 title: "重新检测登录与安装状态"
             }, "🔄 刷新状态")), toastMsg
                 ? h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-link, #0969da)", marginTop: "8px" } }, `ℹ️ ${toastMsg}`)
@@ -957,14 +1238,254 @@ body[data-ds-dark-theme] .dsh-github-steps-list {
                 ? "💡 提示：使用包管理器安装完成后，若未立即识别，可重启 DeepSeek Harness 应用刷新系统环境变量 PATH。"
                 : "💡 提示：凭证由官方 GitHub CLI 加密保存在操作系统安全凭据库中，授权完毕切回本窗口将自动识别刷新。"));
         }
+        // 通用升级通知与一键升级卡片组件（自适应右侧栏紧凑模式与全景大面板模式）
+        function UpgradeNotificationCard(props) {
+            var updateInfo = props.updateInfo;
+            var isRightbar = Boolean(props.isRightbar);
+            if (!updateInfo || !updateInfo.hasUpdate)
+                return null;
+            var storageKey = "dsh_dismissed_update_" + (updateInfo.latestVersion || "latest");
+            var [dismissed, setDismissed] = React.useState(function () {
+                try {
+                    return localStorage.getItem(storageKey) === "true";
+                }
+                catch (e) {
+                    return false;
+                }
+            });
+            var [status, setStatus] = React.useState("idle"); // 'idle' | 'upgrading' | 'success' | 'failed'
+            var [msg, setMsg] = React.useState("");
+            // 窗口切回或切 Tab 重挂载时，主动对齐后端实际的升级状态，防止状态丢失
+            React.useEffect(function () {
+                fetch("/api/github/upgrade-status")
+                    .then(function (res) { return res.json(); })
+                    .then(function (json) {
+                    if (json && json.ok && json.data) {
+                        if (json.data.state === "upgrading") {
+                            setStatus("upgrading");
+                            setMsg("正在拉取最新版本（约需 5~15 秒）...");
+                        }
+                        else if (json.data.state === "success") {
+                            setStatus("success");
+                            setMsg(json.data.message || "升级成功！已安装最新依赖。");
+                        }
+                    }
+                })
+                    .catch(function () { });
+            }, []);
+            if (dismissed)
+                return null;
+            var handleUpgrade = async function () {
+                if (status === "upgrading")
+                    return;
+                setStatus("upgrading");
+                setMsg("正在拉取最新版本（约需 5~15 秒）...");
+                try {
+                    var res = await fetch("/api/github/upgrade", { method: "POST" });
+                    var json = await res.json().catch(function () { return {}; });
+                    if (res.ok && json.ok) {
+                        setStatus("success");
+                        setMsg(json.message || "升级成功！已安装最新依赖。");
+                    }
+                    else {
+                        setStatus("failed");
+                        setMsg(json.message || "升级命令执行失败，请在宿主终端手动执行。");
+                    }
+                }
+                catch (err) {
+                    setStatus("failed");
+                    setMsg("无法连接后端执行升级: " + (err.message || err));
+                }
+            };
+            var handleDismiss = function () {
+                try {
+                    localStorage.setItem(storageKey, "true");
+                }
+                catch (e) { }
+                setDismissed(true);
+            };
+            var handleCopy = function () {
+                var cmd = updateInfo.upgradeCommand || "pnpm dsh plugin add dsh-github-flow@latest";
+                if (navigator.clipboard) {
+                    navigator.clipboard.writeText(cmd);
+                    alert("已复制升级命令到剪贴板：\n" + cmd);
+                }
+                else {
+                    prompt("请复制升级命令：", cmd);
+                }
+            };
+            var handleReload = function () {
+                window.location.reload();
+            };
+            var h = React.createElement;
+            // 1. 右侧栏紧凑型模式
+            if (isRightbar) {
+                return h("div", {
+                    className: "dsh-github-upgrade-strip",
+                    style: {
+                        padding: "10px 12px",
+                        marginBottom: "12px",
+                        borderRadius: "8px",
+                        background: status === "success"
+                            ? "var(--dsw-alias-state-success-subtle, rgba(46, 160, 67, 0.12))"
+                            : "var(--dsw-alias-bg-module-platform, rgba(9, 105, 218, 0.08))",
+                        border: "1px solid " + (status === "success"
+                            ? "var(--dsw-alias-state-success-border, rgba(46, 160, 67, 0.35))"
+                            : "var(--dsw-alias-border-l2, rgba(9, 105, 218, 0.25))"),
+                        fontSize: "12px",
+                    },
+                }, h("div", { style: { display: "flex", alignItems: "center", justifyContent: "space-between", marginBottom: "6px" } }, h("span", { style: { fontWeight: 600, color: "var(--dsw-alias-label-primary, #1f2328)" } }, status === "success" ? "🎉 升级完成" : "🚀 发现新版 v" + updateInfo.latestVersion), h("button", {
+                    onClick: handleDismiss,
+                    title: "不再提醒此版本",
+                    style: { background: "none", border: "none", cursor: "pointer", color: "var(--dsw-alias-label-tertiary, #8c8c8c)", fontSize: "14px", padding: 0 },
+                }, "✕")), h("div", { style: { fontSize: "11px", color: "var(--dsw-alias-label-secondary, #656d76)", marginBottom: "8px", lineHeight: "1.4" } }, msg || (status === "success"
+                    ? "需重启 DSH 服务彻底生效后端工具，或刷新网页预览新界面。"
+                    : "当前: v" + updateInfo.currentVersion + "，推荐升级以获取最新功能。")), h("div", { style: { display: "flex", gap: "6px", flexWrap: "wrap" } }, status === "success"
+                    ? h("button", {
+                        className: "dsh-github-btn-sm",
+                        onClick: handleReload,
+                        style: { flex: 1, justifyContent: "center", background: "#2ea043", color: "#fff", borderColor: "#2ea043" },
+                    }, "🔄 刷新页面")
+                    : h("button", {
+                        className: "dsh-github-btn-sm",
+                        disabled: status === "upgrading",
+                        onClick: handleUpgrade,
+                        style: {
+                            flex: 1,
+                            justifyContent: "center",
+                            background: "var(--dsw-alias-link, #0969da)",
+                            color: "#fff",
+                            borderColor: "var(--dsw-alias-link, #0969da)",
+                            opacity: status === "upgrading" ? 0.7 : 1,
+                        },
+                    }, status === "upgrading" ? "升级中..." : "⚡ 一键升级"), h("button", {
+                    className: "dsh-github-btn-sm",
+                    onClick: handleCopy,
+                    style: { fontSize: "11px", padding: "4px 8px" },
+                }, "📋 复制命令")));
+            }
+            // 2. 全景驾驶舱大面板横幅模式
+            return h("div", {
+                className: "dsh-github-upgrade-banner",
+                style: {
+                    display: "flex",
+                    alignItems: "center",
+                    justifyContent: "space-between",
+                    padding: "12px 18px",
+                    marginBottom: "16px",
+                    borderRadius: "8px",
+                    background: status === "success"
+                        ? "linear-gradient(90deg, rgba(46, 160, 67, 0.15) 0%, rgba(9, 105, 218, 0.12) 100%)"
+                        : "linear-gradient(90deg, rgba(9, 105, 218, 0.12) 0%, rgba(137, 87, 229, 0.12) 100%)",
+                    border: "1px solid " + (status === "success" ? "rgba(46, 160, 67, 0.35)" : "rgba(9, 105, 218, 0.3)"),
+                    fontSize: "13px",
+                },
+            }, h("div", { style: { display: "flex", alignItems: "center", gap: "10px" } }, h("span", { style: { fontSize: "20px" } }, status === "success" ? "🎉" : "🚀"), h("div", null, h("div", { style: { fontWeight: 600, color: "var(--dsw-alias-label-primary, #1f2328)" } }, status === "success"
+                ? "升级完成！新版本 v" + updateInfo.latestVersion + " 已写入"
+                : "发现 dsh-github-flow 新版本 v" + updateInfo.latestVersion + "（当前版本: v" + updateInfo.currentVersion + "）"), h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginTop: "2px" } }, msg || (status === "success"
+                ? "💡 提示：DSH 后端驻留了旧版内存，需重启 DSH 服务彻底生效后端工具；若仅预览界面改动可先刷新网页。"
+                : "包含最新 GitHub 工具特性与性能优化，点击右侧可一键自动升级。")))), h("div", { style: { display: "flex", alignItems: "center", gap: "8px", flexShrink: 0 } }, status === "success"
+                ? h("button", {
+                    className: "dsh-github-btn-sm",
+                    onClick: handleReload,
+                    style: { background: "#2ea043", color: "#fff", borderColor: "#2ea043", padding: "6px 14px", fontWeight: 600 },
+                }, "🔄 立即刷新页面")
+                : h("button", {
+                    className: "dsh-github-btn-sm",
+                    disabled: status === "upgrading",
+                    onClick: handleUpgrade,
+                    style: {
+                        background: "var(--dsw-alias-link, #0969da)",
+                        color: "#fff",
+                        borderColor: "var(--dsw-alias-link, #0969da)",
+                        padding: "6px 14px",
+                        fontWeight: 600,
+                        opacity: status === "upgrading" ? 0.7 : 1,
+                    },
+                }, status === "upgrading" ? "正在自动升级中..." : "⚡ 一键自动升级"), h("button", {
+                className: "dsh-github-btn-sm",
+                onClick: handleCopy,
+                style: { padding: "6px 12px" },
+            }, "📋 复制命令"), h("button", {
+                onClick: handleDismiss,
+                title: "不再提醒此版本",
+                style: { background: "none", border: "none", cursor: "pointer", color: "var(--dsw-alias-label-tertiary, #8c8c8c)", fontSize: "16px", padding: "0 4px" },
+            }, "✕")));
+        }
+        // 数据新鲜度与同步状态微标组件 (自适应全景大面板与右侧栏紧凑模式)
+        function SyncStatusBadge(props) {
+            var syncStatus = props.syncStatus;
+            var lastSyncedAt = props.lastSyncedAt;
+            var isRightbar = Boolean(props.isRightbar);
+            var text = "";
+            var bg = "rgba(101, 109, 118, 0.1)";
+            var color = "var(--dsw-alias-label-secondary, #656d76)";
+            var formatTimeAgo = function (ts) {
+                if (!ts)
+                    return "刚刚";
+                var diffSec = Math.floor((Date.now() - ts) / 1000);
+                if (diffSec < 60)
+                    return "刚刚";
+                var diffMin = Math.floor(diffSec / 60);
+                if (diffMin < 60)
+                    return diffMin + "分钟前";
+                var diffHour = Math.floor(diffMin / 60);
+                if (diffHour < 24)
+                    return diffHour + "小时前";
+                var diffDay = Math.floor(diffHour / 24);
+                return diffDay + "天前";
+            };
+            if (syncStatus === "syncing") {
+                text = isRightbar ? "⏳ 同步中..." : "⏳ 后台同步中...";
+                bg = "rgba(9, 105, 218, 0.12)";
+                color = "var(--dsw-alias-link, #0969da)";
+            }
+            else if (syncStatus === "fresh") {
+                var timeStr = lastSyncedAt ? new Date(lastSyncedAt).toLocaleTimeString() : "";
+                text = "✅ " + (isRightbar ? "最新" : "已是最新") + (timeStr ? " (" + timeStr + ")" : "");
+                bg = "rgba(46, 160, 67, 0.12)";
+                color = "var(--dsw-alias-state-success, #2ea043)";
+            }
+            else if (syncStatus === "cached") {
+                text = "📦 本地快照 (" + formatTimeAgo(lastSyncedAt) + ")";
+                bg = "rgba(101, 109, 118, 0.12)";
+                color = "var(--dsw-alias-label-secondary, #656d76)";
+            }
+            else if (syncStatus === "failed") {
+                text = isRightbar ? "⚠️ 同步超时" : "⚠️ 同步超时，已保留本地缓存";
+                bg = "rgba(207, 34, 46, 0.1)";
+                color = "var(--dsw-alias-state-error-primary, #cf222e)";
+            }
+            if (!text)
+                return null;
+            return React.createElement("span", {
+                className: "dsh-github-sync-badge",
+                style: {
+                    fontSize: isRightbar ? "10px" : "11px",
+                    padding: isRightbar ? "2px 6px" : "3px 8px",
+                    borderRadius: "12px",
+                    background: bg,
+                    color: color,
+                    marginLeft: isRightbar ? "6px" : "10px",
+                    fontWeight: 500,
+                    display: "inline-flex",
+                    alignItems: "center",
+                    whiteSpace: "nowrap",
+                },
+            }, text);
+        }
         // 渲染 GitHub 仓库信息与操作视图的核心函数
-        function renderGithubRepoView(h, data, loading, error, onRefresh, isRightbar = false) {
+        function renderGithubRepoView(h, data, loading, error, onRefresh, isRightbar = false, updateInfo = null, syncStatus = "", lastSyncedAt = 0) {
             var auth = data ? data.auth : null;
             var repo = data ? data.repo : null;
             var prs = (data && data.pullRequests) || [];
             var issues = (data && data.issues) || [];
             var runs = (data && data.runs) || [];
-            var headerEl = h("div", { className: "dsh-github-header" }, h("div", { className: "dsh-github-title" }, renderOctocatBadge(isRightbar ? 26 : 30), h("h2", null, isRightbar ? "GitHub 仓库" : "GitHub 工作台")), h("button", {
+            var effectiveUpdateInfo = updateInfo || data?.updateInfo;
+            var upgradeBannerEl = effectiveUpdateInfo && effectiveUpdateInfo.hasUpdate
+                ? h(UpgradeNotificationCard, { updateInfo: effectiveUpdateInfo, isRightbar })
+                : null;
+            var headerEl = h("div", { className: "dsh-github-header" }, h("div", { className: "dsh-github-title" }, renderOctocatBadge(isRightbar ? 26 : 30), h("h2", null, isRightbar ? "GitHub 仓库" : "GitHub 工作台"), syncStatus ? h(SyncStatusBadge, { syncStatus, lastSyncedAt, isRightbar }) : null), h("button", {
                 className: "dsh-github-refresh-btn",
                 onClick: onRefresh,
                 disabled: loading,
@@ -1075,23 +1596,212 @@ body[data-ds-dark-theme] .dsh-github-steps-list {
             var authGuideEl = !auth?.loggedIn
                 ? h(AuthGuideCard, { auth, onRefresh, isRightbar })
                 : null;
-            return [headerEl, authGuideEl, repoCardEl, actionsBarEl, prSectionEl, issueSectionEl, runSectionEl].filter(Boolean);
+            return [headerEl, upgradeBannerEl, authGuideEl, repoCardEl, actionsBarEl, prSectionEl, issueSectionEl, runSectionEl].filter(Boolean);
+        }
+        // 全局持久化缓存与偏好配置键名
+        var GLOBAL_OVERVIEW_CACHE_KEY = "dsh_github_global_overview_snapshot_v1";
+        var SYNC_SETTINGS_STORAGE_KEY = "dsh_github_sync_settings_v1";
+        // 同步策略收敛为两态：'swr'（打开秒开旧数据+后台静默拉新）| 'manual'（仅手动刷新）。
+        // 旧的第三态 'interval'（前端 setInterval 轮询）已删除：浏览器对后台标签页节流
+        // 定时器、组件卸载即销毁，该模式在真实环境几乎从不按承诺工作（停留短于间隔则
+        // 永不触发）；其「打开即新鲜」的诉求由 SWR 挂载自愈覆盖，「持续同步」点刷新即可。
+        var DEFAULT_SYNC_SETTINGS = {
+            strategy: "swr", // 'swr' | 'manual'
+        };
+        function getLocalSyncSettings() {
+            try {
+                var raw = localStorage.getItem(SYNC_SETTINGS_STORAGE_KEY);
+                if (!raw)
+                    return DEFAULT_SYNC_SETTINGS;
+                var parsed = JSON.parse(raw);
+                var merged = Object.assign({}, DEFAULT_SYNC_SETTINGS, parsed);
+                // 旧版本迁移：曾选过 'interval' 的用户自动回落 SWR（最接近原意图），
+                // 并立即覆写存储防止每次读取都走迁移分支。
+                if (merged.strategy === "interval") {
+                    merged.strategy = "swr";
+                    saveLocalSyncSettings(merged);
+                }
+                return merged;
+            }
+            catch (e) {
+                return DEFAULT_SYNC_SETTINGS;
+            }
+        }
+        function saveLocalSyncSettings(settings) {
+            try {
+                localStorage.setItem(SYNC_SETTINGS_STORAGE_KEY, JSON.stringify(settings));
+                // 跨组件事件通知：确保主页设置被修改后，右侧栏及所有实例即时同步新规则
+                if (typeof window !== "undefined") {
+                    window.dispatchEvent(new CustomEvent("dsh-github-sync-settings-change", { detail: settings }));
+                }
+            }
+            catch (e) { }
+        }
+        function getStoredGlobalOverview() {
+            try {
+                var raw = localStorage.getItem(GLOBAL_OVERVIEW_CACHE_KEY);
+                if (!raw)
+                    return null;
+                var parsed = JSON.parse(raw);
+                // 毒丸缓存自愈清洗：如果缓存中的快照显示「未登录」或未就绪，立即将其从 localStorage 彻底抹除！
+                if (!parsed || !parsed.data || !parsed.data.auth || !parsed.data.auth.loggedIn) {
+                    localStorage.removeItem(GLOBAL_OVERVIEW_CACHE_KEY);
+                    return null;
+                }
+                if (typeof parsed.savedAt === "number") {
+                    return parsed;
+                }
+                return null;
+            }
+            catch (e) {
+                return null;
+            }
+        }
+        function saveStoredGlobalOverview(data) {
+            // 毒丸拦截守卫：绝不持久化存储未登录状态、空数据或异常快照！
+            if (!data || !data.auth || !data.auth.loggedIn) {
+                return;
+            }
+            try {
+                localStorage.setItem(GLOBAL_OVERVIEW_CACHE_KEY, JSON.stringify({
+                    data: data,
+                    savedAt: Date.now(),
+                }));
+            }
+            catch (e) { }
+        }
+        function clearStoredGlobalOverview() {
+            try {
+                localStorage.removeItem(GLOBAL_OVERVIEW_CACHE_KEY);
+                // 彻底清空所有右侧栏工作区历史快照，确保全局一致
+                if (typeof localStorage !== "undefined") {
+                    for (var i = localStorage.length - 1; i >= 0; i--) {
+                        var k = localStorage.key(i);
+                        if (k && k.indexOf("dsh_github_rightbar_snapshot_") === 0) {
+                            localStorage.removeItem(k);
+                        }
+                    }
+                }
+                if (typeof window !== "undefined") {
+                    window.dispatchEvent(new CustomEvent("dsh-github-cache-cleared"));
+                }
+            }
+            catch (e) { }
+        }
+        function getCacheStorageMeta() {
+            try {
+                var raw = localStorage.getItem(GLOBAL_OVERVIEW_CACHE_KEY);
+                if (!raw)
+                    return { exists: false, sizeKb: 0, savedAt: 0 };
+                var parsed = JSON.parse(raw);
+                var sizeKb = Math.round((raw.length * 2) / 1024 * 10) / 10;
+                return { exists: true, sizeKb: sizeKb, savedAt: parsed?.savedAt || 0 };
+            }
+            catch (e) {
+                return { exists: false, sizeKb: 0, savedAt: 0 };
+            }
+        }
+        // 右侧栏专属本地持久化快照工具
+        function getRightbarStorageKey(cwd) {
+            var safe = (cwd || "default").replace(/[^a-zA-Z0-9_-]/g, "_");
+            return "dsh_github_rightbar_snapshot_" + safe;
+        }
+        function getStoredRightbarSnapshot(cwd) {
+            try {
+                var key = getRightbarStorageKey(cwd);
+                var raw = localStorage.getItem(key);
+                if (!raw)
+                    return null;
+                var parsed = JSON.parse(raw);
+                // 毒丸拦截：若快照未登录，物理删除
+                if (!parsed || !parsed.data || !parsed.data.auth || !parsed.data.auth.loggedIn) {
+                    localStorage.removeItem(key);
+                    return null;
+                }
+                return { data: parsed.data, savedAt: typeof parsed.savedAt === "number" ? parsed.savedAt : 0 };
+            }
+            catch (e) {
+                return null;
+            }
+        }
+        function saveStoredRightbarData(cwd, data) {
+            if (!data || !data.auth || !data.auth.loggedIn)
+                return;
+            try {
+                var key = getRightbarStorageKey(cwd);
+                localStorage.setItem(key, JSON.stringify({
+                    data: data,
+                    savedAt: Date.now(),
+                }));
+            }
+            catch (e) { }
         }
         // 1. 右侧栏专属视图 (Right Sidebar Tab Body)
         function GithubRightbarBody(props) {
-            var [loading, setLoading] = React.useState(true);
-            var [data, setData] = React.useState(null);
-            var [error, setError] = React.useState(null);
-            // 核心：直接从会话 Props 拿到真实物理工作区路径！
+            var sessionId = props ? props.sessionId : null;
             var cwd = null;
-            if (props && props.useSessions && props.sessionId) {
+            if (props && typeof props.useSessions === "function" && sessionId) {
                 try {
-                    cwd = props.useSessions((sessions) => sessions?.byId?.[props.sessionId]?.cwd);
+                    cwd = props.useSessions((sessions) => sessions?.byId?.[sessionId]?.cwd) || null;
                 }
                 catch (e) { }
             }
+            // 核心原则：右侧栏与全景主页使用同一套在“主页-设置”中配置的缓存与刷新规则事实源
+            var initialSettings = React.useMemo(() => getLocalSyncSettings(), []);
+            var [syncSettings, setSyncSettings] = React.useState(initialSettings);
+            // SWR 秒开机制：初始数据直接从本地快照读取，0ms 瞬间展示！
+            var initialSnapshot = React.useMemo(() => getStoredRightbarSnapshot(cwd), [cwd]);
+            var [data, setData] = React.useState(initialSnapshot?.data || null);
+            var [syncStatus, setSyncStatus] = React.useState(initialSnapshot ? "cached" : "loading");
+            var [lastSyncedAt, setLastSyncedAt] = React.useState(initialSnapshot?.savedAt || 0);
+            var [loading, setLoading] = React.useState(false);
+            var [error, setError] = React.useState(null);
+            var [updateInfo, setUpdateInfo] = React.useState(null);
+            // 跨组件事件监听：当主页修改了同步设置或清空缓存时，右侧栏即时无感对齐
+            React.useEffect(function () {
+                var onSettingsChange = function (e) {
+                    if (e && e.detail) {
+                        setSyncSettings(e.detail);
+                    }
+                };
+                var onCacheCleared = function () {
+                    setData(null);
+                    setLastSyncedAt(0);
+                    setSyncStatus("loading");
+                };
+                window.addEventListener("dsh-github-sync-settings-change", onSettingsChange);
+                window.addEventListener("dsh-github-cache-cleared", onCacheCleared);
+                return function () {
+                    window.removeEventListener("dsh-github-sync-settings-change", onSettingsChange);
+                    window.removeEventListener("dsh-github-cache-cleared", onCacheCleared);
+                };
+            }, []);
+            // gh 数据拉取完毕后，闲时 1.5 秒异步检测升级，绝对不抢占主业务首屏资源
+            React.useEffect(() => {
+                if (!data)
+                    return;
+                var timer = setTimeout(function () {
+                    fetch("/api/github/check-update")
+                        .then(function (res) { return res.json(); })
+                        .then(function (json) {
+                        if (json && json.ok && json.data) {
+                            setUpdateInfo(json.data);
+                        }
+                    })
+                        .catch(function () { });
+                }, 1500);
+                return function () { clearTimeout(timer); };
+            }, [data]);
+            // 遵循全局规则的数据拉取核心函数 (仅依赖标量 cwd 与 sessionId，坚决去除 props 引用依赖，彻底终结死循环)
             var loadData = React.useCallback(async (forceRefresh = false) => {
-                setLoading(true);
+                // 规则执行：若主页设置为「纯手动模式 (manual)」，且非用户点击强制刷新，且本地已有数据，坚决不打后台网络！
+                if (!forceRefresh && syncSettings.strategy === "manual" && data) {
+                    return;
+                }
+                if (forceRefresh || !data) {
+                    setLoading(true);
+                }
+                setSyncStatus(data ? "syncing" : "loading");
                 setError(null);
                 try {
                     if (forceRefresh) {
@@ -1099,8 +1809,8 @@ body[data-ds-dark-theme] .dsh-github-steps-list {
                     }
                     var url = "/api/github/overview";
                     var params = [];
-                    if (props && props.sessionId) {
-                        params.push("sessionId=" + encodeURIComponent(props.sessionId));
+                    if (sessionId) {
+                        params.push("sessionId=" + encodeURIComponent(sessionId));
                     }
                     if (cwd) {
                         params.push("cwd=" + encodeURIComponent(cwd));
@@ -1111,39 +1821,77 @@ body[data-ds-dark-theme] .dsh-github-steps-list {
                     var res = await fetch(url);
                     if (!res.ok) {
                         var errText = await res.text().catch(() => "");
-                        setError(`后端服务未就绪 (${res.status}): ${errText || res.statusText}`);
+                        var msg = `后端服务未就绪 (${res.status}): ${errText || res.statusText}`;
+                        if (data) {
+                            setSyncStatus("failed");
+                        }
+                        else {
+                            setError(msg);
+                        }
                         return;
                     }
                     var json = await res.json();
                     if (json.ok && json.data) {
                         setData(json.data);
+                        saveStoredRightbarData(cwd, json.data); // 写入持久化快照
+                        setLastSyncedAt(Date.now());
+                        setSyncStatus("fresh");
+                        if (json.data.updateInfo) {
+                            setUpdateInfo(json.data.updateInfo);
+                        }
+                    }
+                    else if (data) {
+                        setSyncStatus("failed");
                     }
                     else {
                         setError(json.error || "获取状态失败");
                     }
                 }
                 catch (err) {
-                    setError(err.message || "网络异常");
+                    if (data) {
+                        setSyncStatus("failed");
+                    }
+                    else {
+                        setError(err.message || "网络异常");
+                    }
                 }
                 finally {
                     setLoading(false);
                 }
-            }, [cwd, props]);
+            }, [cwd, sessionId, data, syncSettings.strategy]);
+            // 挂载与策略调度：与主页规则 100% 保持一致。
+            // SWR 分支不判 data：挂载 300ms 后台静默拉新，昨天的持久化快照当场自愈——
+            // 「打开就能看到最新」是 SWR 的定义，不依赖用户停留时长。
             React.useEffect(() => {
-                loadData(false);
-            }, [loadData]);
-            // 窗口切回自动探测自愈
+                if (syncSettings.strategy === "swr") {
+                    var timer = setTimeout(function () { loadData(false); }, 300);
+                    return function () { clearTimeout(timer); };
+                }
+                else if (!data) {
+                    loadData(false);
+                }
+            }, [cwd, sessionId, syncSettings.strategy]);
+            // （原定时轮询调度已随 'interval' 策略一并移除：前端 setInterval 受浏览器
+            //  后台节流且随组件卸载销毁，无法兑现「定时自动更新」承诺）
+            // 窗口切回自动探测自愈：优先轻量快速探针，检测到已登录立即自愈
             React.useEffect(() => {
                 var onFocus = () => {
                     if (!data?.auth?.loggedIn) {
-                        loadData(false);
+                        fetch("/api/github/auth?force=true")
+                            .then(function (res) { return res.json(); })
+                            .then(function (json) {
+                            if (json && json.ok && json.auth && json.auth.loggedIn) {
+                                loadData(true);
+                            }
+                        })
+                            .catch(function () { });
                     }
                 };
                 window.addEventListener("focus", onFocus);
                 return () => window.removeEventListener("focus", onFocus);
             }, [data, loadData]);
             var h = React.createElement;
-            return h("div", { className: "dsh-github-rightbar-container" }, ...renderGithubRepoView(h, data, loading, error, () => loadData(true), true));
+            return h("div", { className: "dsh-github-rightbar-container" }, ...renderGithubRepoView(h, data, loading, error, () => loadData(true), true, updateInfo, syncStatus, lastSyncedAt));
         }
         // 2. 右侧栏 Tab 标题组件
         function GithubRightbarTitle() {
@@ -1164,76 +1912,467 @@ body[data-ds-dark-theme] .dsh-github-steps-list {
                 className: "dsh-github-icon-inner" + (active ? " active" : "")
             }, renderOctocat(18, "currentColor")));
         }
+        // 全景驾驶舱「⚙️ 设置」模态弹窗组件：左侧分区导航（数据同步 / 网络代理）+ 右侧内容区。
+        // 为什么改多分区：弹窗承载能力从单一「同步偏好」扩展为多项插件设置（后续可继续加），
+        // 单页滚动堆叠会让用户找不到入口；分区导航让每项设置拥有独立心智空间与保存动作。
+        function GlobalSyncSettingsModal(props) {
+            if (!props.isOpen)
+                return null;
+            // ---- 当前激活分区：sync（数据同步）/ proxy（网络代理）----
+            var [activeSection, setActiveSection] = React.useState("sync");
+            var [strategy, setStrategy] = React.useState(props.currentSettings.strategy || "swr");
+            var [cacheMeta, setCacheMeta] = React.useState(getCacheStorageMeta());
+            var [clearTip, setClearTip] = React.useState("");
+            // ---- 网络代理分区状态 ----
+            // 打开弹窗时从后端拉取真实代理状态（权威源是 proxy.json 而非 localStorage），
+            // 避免多窗口/外部手改文件导致的 UI 与实际生效配置漂移。
+            var [proxyEnabled, setProxyEnabled] = React.useState(false);
+            var [proxyUrl, setProxyUrl] = React.useState("");
+            var [proxyNoProxy, setProxyNoProxy] = React.useState("localhost,127.0.0.1");
+            var [proxyApplyNpm, setProxyApplyNpm] = React.useState(true);
+            var [proxyBusy, setProxyBusy] = React.useState(false);
+            var [proxyMsg, setProxyMsg] = React.useState(null);
+            var [proxyProbe, setProxyProbe] = React.useState(null);
+            React.useEffect(function () {
+                if (!props.isOpen)
+                    return;
+                fetch("/api/github/proxy")
+                    .then(function (r) { return r.json(); })
+                    .then(function (j) {
+                    if (j && j.ok && j.state) {
+                        setProxyEnabled(Boolean(j.state.config && j.state.config.url));
+                        setProxyUrl((j.state.config && j.state.config.url) || "");
+                        setProxyNoProxy((j.state.config && j.state.config.noProxy) || "localhost,127.0.0.1");
+                        setProxyApplyNpm(j.state.config ? j.state.config.applyToPackageManager !== false : true);
+                        if (j.state.lastProbe)
+                            setProxyProbe(j.state.lastProbe);
+                    }
+                })
+                    .catch(function () { });
+            }, [props.isOpen]);
+            // 键盘 Escape 快捷关闭支持
+            React.useEffect(function () {
+                var onKeyDown = function (e) {
+                    if (e.key === "Escape" || e.keyCode === 27) {
+                        props.onClose();
+                    }
+                };
+                window.addEventListener("keydown", onKeyDown);
+                return function () { window.removeEventListener("keydown", onKeyDown); };
+            }, [props.onClose]);
+            var h = React.createElement;
+            var handleSave = function () {
+                var updated = {
+                    strategy: strategy,
+                };
+                saveLocalSyncSettings(updated);
+                props.onSave(updated);
+                props.onClose();
+            };
+            var handleClear = function () {
+                clearStoredGlobalOverview();
+                props.onClearCache();
+                setCacheMeta({ exists: false, sizeKb: 0, savedAt: 0 });
+                setClearTip("本地缓存已彻底清空！");
+                setTimeout(function () { setClearTip(""); }, 2000);
+            };
+            // 代理保存：POST 后端后立即全局生效（gh 子进程/升级链路 env + npm 探测 dispatcher）。
+            // 保存成功即提示「无需重启」，与「设置完成之后全局生效」的语义对齐。
+            var handleProxySave = function () {
+                setProxyBusy(true);
+                setProxyMsg(null);
+                fetch("/api/github/proxy", {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify({
+                        url: proxyEnabled ? proxyUrl.trim() : "",
+                        noProxy: proxyNoProxy,
+                        applyToPackageManager: proxyApplyNpm,
+                    }),
+                })
+                    .then(function (r) { return r.json(); })
+                    .then(function (j) {
+                    setProxyBusy(false);
+                    if (j && j.ok) {
+                        setProxyMsg({
+                            kind: "ok",
+                            text: j.state && j.state.config && j.state.config.url
+                                ? "🌐 代理已保存并全局生效（驾驶舱 / 右侧栏 / Agent 工具 / 升级链路），无需重启"
+                                : "已切换为系统默认网络（直连或系统环境代理），无需重启",
+                        });
+                        if (j.state && j.state.lastProbe)
+                            setProxyProbe(j.state.lastProbe);
+                    }
+                    else {
+                        setProxyMsg({ kind: "err", text: (j && j.message) || "保存失败" });
+                    }
+                })
+                    .catch(function (e) {
+                    setProxyBusy(false);
+                    setProxyMsg({ kind: "err", text: "网络请求失败: " + (e && e.message ? e.message : e) });
+                });
+            };
+            // 连通性探测：验证经当前配置访问 GitHub API 的可达性（2.5s 超时由后端控制）
+            var handleProxyProbe = function () {
+                setProxyBusy(true);
+                setProxyMsg(null);
+                fetch("/api/github/proxy/probe", { method: "POST" })
+                    .then(function (r) { return r.json(); })
+                    .then(function (j) {
+                    setProxyBusy(false);
+                    if (j && j.ok && j.probe) {
+                        setProxyProbe(j.probe);
+                        setProxyMsg(j.probe.ok
+                            ? { kind: "ok", text: "✅ GitHub API 可达 (" + j.probe.latencyMs + "ms)" }
+                            : { kind: "err", text: "❌ " + (j.probe.error || "探测失败") });
+                    }
+                    else {
+                        setProxyMsg({ kind: "err", text: (j && j.message) || "探测失败" });
+                    }
+                })
+                    .catch(function (e) {
+                    setProxyBusy(false);
+                    setProxyMsg({ kind: "err", text: "探测请求失败: " + (e && e.message ? e.message : e) });
+                });
+            };
+            return h("div", { className: "dsh-github-modal-overlay", onClick: props.onClose }, h("div", {
+                className: "dsh-github-modal-dialog",
+                onClick: function (e) { e.stopPropagation(); },
+            }, 
+            // 弹窗头部：标题 + 关闭按钮
+            h("div", { className: "dsh-github-modal-header" }, h("h3", { style: { margin: 0, fontSize: "16px", fontWeight: 600 } }, "⚙️ 设置"), h("button", {
+                style: { background: "none", border: "none", cursor: "pointer", fontSize: "18px", color: "var(--dsw-alias-label-secondary, #656d76)" },
+                onClick: props.onClose,
+            }, "✕")), 
+            // 双栏骨架：左侧分区导航 + 右侧内容区（窄屏自动折叠为横向页签）
+            h("div", { className: "dsh-github-modal-body" }, h("div", { className: "dsh-github-settings-nav" }, h("button", {
+                className: "dsh-github-settings-nav-item" + (activeSection === "sync" ? " active" : ""),
+                onClick: function () { setActiveSection("sync"); },
+            }, "🔄 数据同步"), h("button", {
+                className: "dsh-github-settings-nav-item" + (activeSection === "proxy" ? " active" : ""),
+                onClick: function () { setActiveSection("proxy"); },
+            }, "🌐 网络代理")), h("div", { className: "dsh-github-settings-content" }, activeSection === "sync" ? h("div", null, h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginBottom: "14px", lineHeight: "1.5" } }, "配置 GitHub 全景驾驶舱的数据拉取节奏。启用秒开模式可利用本地持久化缓存消除每次打开时的漫长等待。"), 
+            // 刷新策略选择
+            h("div", { style: { marginBottom: "16px" } }, h("div", { style: { fontSize: "13px", fontWeight: 600, marginBottom: "8px" } }, "数据刷新策略"), 
+            // 策略 A: SWR 秒开
+            h("div", {
+                className: "dsh-github-radio-card" + (strategy === "swr" ? " active" : ""),
+                onClick: function () { setStrategy("swr"); },
+            }, h("input", { type: "radio", className: "dsh-github-radio", checked: strategy === "swr", readOnly: true }), h("div", null, h("div", { style: { fontWeight: 600, fontSize: "13px" } }, "⚡ 秒开展示旧数据 (SWR, 强烈推荐)"), h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginTop: "2px" } }, "打开驾驶舱立即展示上次本地缓存（0ms秒开），后台静默同步最新状态。"))), 
+            // 策略 B: 纯手动刷新
+            h("div", {
+                className: "dsh-github-radio-card" + (strategy === "manual" ? " active" : ""),
+                onClick: function () { setStrategy("manual"); },
+            }, h("input", { type: "radio", className: "dsh-github-radio", checked: strategy === "manual", readOnly: true }), h("div", null, h("div", { style: { fontWeight: 600, fontSize: "13px" } }, "📋 仅在手动点击时拉取 (Manual Only)"), h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginTop: "2px" } }, "打开只浏览本地缓存，绝不自动触发后台 gh 进程，最省电、最省资源；想更新时点击「🔄 刷新」即可。")))
+            // （第三种「定时自动轮询」策略已移除：前端定时器受浏览器后台节流且随
+            //  组件卸载销毁，无法兑现定时更新承诺；SWR 挂载自愈已覆盖「打开即新鲜」）
+            ), 
+            // 本地缓存信息与清理
+            h("div", {
+                className: "dsh-github-cache-info-box",
+            }, h("div", { style: { display: "flex", justifyContent: "space-between", alignItems: "center" } }, h("span", null, cacheMeta.exists
+                ? `📦 本地缓存: 约 ${cacheMeta.sizeKb} KB (上次保存: ${new Date(cacheMeta.savedAt).toLocaleTimeString()})`
+                : "📦 暂无本地持久化缓存"), cacheMeta.exists ? h("button", {
+                className: "dsh-github-btn-sm",
+                style: { padding: "3px 8px", fontSize: "11px", color: "var(--dsw-alias-state-error-primary, #cf222e)" },
+                onClick: handleClear,
+            }, "🗑️ 清空缓存") : null), clearTip ? h("div", { style: { color: "var(--dsw-alias-state-success, #2ea043)", marginTop: "4px", fontWeight: 500 } }, clearTip) : null)) : h("div", null, 
+            // 🌐 网络代理分区：设置保存即全局生效（驾驶舱/右侧栏/Agent 工具/升级链路），
+            // 未启用时回落系统环境代理或直连（「默认走系统设置」语义）。
+            h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginBottom: "14px", lineHeight: "1.5" } }, "设置后插件的 GitHub 数据链路（本页面、右侧栏、Agent 工具调用、版本升级）全部经代理访问；未启用时默认使用系统环境代理或直连。保存后立即生效，无需重启。"), h("label", { style: { display: "flex", alignItems: "center", gap: "8px", marginBottom: "10px", cursor: "pointer", fontSize: "13px" } }, h("input", {
+                type: "checkbox",
+                checked: proxyEnabled,
+                onChange: function (e) { setProxyEnabled(Boolean(e.target.checked)); },
+            }), "启用代理"), proxyEnabled ? h("div", null, h("div", { style: { fontSize: "12px", marginBottom: "4px" } }, "代理地址"), h("input", {
+                className: "dsh-github-input",
+                style: { width: "100%", boxSizing: "border-box", padding: "6px 10px", fontSize: "13px", marginBottom: "10px" },
+                placeholder: "http://127.0.0.1:7890 或 socks5h://127.0.0.1:1080（DNS 由代理解析）",
+                value: proxyUrl,
+                onChange: function (e) { setProxyUrl(e.target.value); },
+            }), h("div", { style: { fontSize: "12px", marginBottom: "4px" } }, "NO_PROXY 排除列表（逗号分隔，localhost 与 127.0.0.1 强制包含）"), h("input", {
+                className: "dsh-github-input",
+                style: { width: "100%", boxSizing: "border-box", padding: "6px 10px", fontSize: "12px", marginBottom: "10px" },
+                value: proxyNoProxy,
+                onChange: function (e) { setProxyNoProxy(e.target.value); },
+            }), h("label", { style: { display: "flex", alignItems: "center", gap: "8px", marginBottom: "8px", cursor: "pointer", fontSize: "12px" } }, h("input", {
+                type: "checkbox",
+                checked: proxyApplyNpm,
+                onChange: function (e) { setProxyApplyNpm(Boolean(e.target.checked)); },
+            }), "同时应用于 npm 版本探测与一键升级")) : null, 
+            // 操作与反馈行：探测/保存按钮 + 结果胶囊
+            h("div", { style: { display: "flex", alignItems: "center", gap: "8px", flexWrap: "wrap" } }, h("button", {
+                className: "dsh-github-btn-sm",
+                style: { padding: "5px 12px", fontSize: "12px" },
+                disabled: proxyBusy || !proxyEnabled,
+                onClick: handleProxyProbe,
+                title: "经当前配置探测 GitHub API 连通性（约 2.5 秒）",
+            }, "🧪 测试连通性"), h("button", {
+                className: "dsh-github-btn-sm",
+                style: {
+                    padding: "5px 14px",
+                    fontSize: "12px",
+                    background: "var(--dsw-alias-link, #0969da)",
+                    color: "#ffffff",
+                    borderColor: "var(--dsw-alias-link, #0969da)",
+                    fontWeight: 600,
+                },
+                disabled: proxyBusy,
+                onClick: handleProxySave,
+            }, proxyBusy ? "处理中..." : "💾 保存并全局应用"), proxyProbe ? h("span", {
+                style: {
+                    fontSize: "12px",
+                    fontWeight: 500,
+                    color: proxyProbe.ok ? "var(--dsw-alias-state-success, #2ea043)" : "var(--dsw-alias-state-error-primary, #cf222e)",
+                },
+                title: proxyProbe.error || "",
+            }, proxyProbe.ok ? "✅ " + proxyProbe.latencyMs + "ms" : "❌ 探测失败") : null), proxyMsg ? h("div", {
+                style: {
+                    marginTop: "8px",
+                    fontSize: "12px",
+                    lineHeight: "1.5",
+                    color: proxyMsg.kind === "ok"
+                        ? "var(--dsw-alias-state-success, #2ea043)"
+                        : proxyMsg.kind === "err"
+                            ? "var(--dsw-alias-state-error-primary, #cf222e)"
+                            : "var(--dsw-alias-label-secondary, #656d76)",
+                },
+            }, proxyMsg.text) : null))), 
+            // 底部操作条：sync 分区提供主保存动作；proxy 分区有自己的「保存并全局应用」，
+            // 底部统一为「完成」关闭弹窗，避免两个保存按钮的语义冲突。
+            h("div", { className: "dsh-github-modal-footer" }, activeSection === "sync" ? h("button", {
+                className: "dsh-github-btn-sm",
+                style: {
+                    padding: "6px 16px",
+                    background: "var(--dsw-alias-link, #0969da)",
+                    color: "#ffffff",
+                    borderColor: "var(--dsw-alias-link, #0969da)",
+                    fontWeight: 600,
+                },
+                onClick: handleSave,
+            }, "保存同步设置") : null, h("button", {
+                className: "dsh-github-btn-sm",
+                style: { padding: "6px 14px" },
+                onClick: props.onClose,
+            }, activeSection === "sync" ? "取消" : "完成"))));
+        }
         function GithubWorkspacePanel() {
-            var [loading, setLoading] = React.useState(true);
-            var [data, setData] = React.useState(null);
+            // 1. 读取本地偏好配置与历史持久化快照 (0ms 纯内存读取)
+            var initialSettings = React.useMemo(() => getLocalSyncSettings(), []);
+            var initialSnapshot = React.useMemo(() => getStoredGlobalOverview(), []);
+            var [syncSettings, setSyncSettings] = React.useState(initialSettings);
+            var [data, setData] = React.useState(initialSnapshot?.data || null);
+            var [loading, setLoading] = React.useState(!initialSnapshot);
+            var [syncStatus, setSyncStatus] = React.useState(initialSnapshot ? "cached" : "loading");
+            var [lastSyncedAt, setLastSyncedAt] = React.useState(initialSnapshot?.savedAt || 0);
+            var [isSettingsModalOpen, setIsSettingsModalOpen] = React.useState(false);
             var [error, setError] = React.useState(null);
+            var [updateInfo, setUpdateInfo] = React.useState(null);
             var [activeTab, setActiveTab] = React.useState("workspaces"); // 'workspaces' | 'repos' | 'mywork'
             var [searchQuery, setSearchQuery] = React.useState("");
             var [issueFilter, setIssueFilter] = React.useState("all"); // 'all' | 'reported' | 'assigned' | 'created'
+            // 代理生效状态（标题栏 🌐 徽章数据源）：挂载时读一次 + 弹窗关闭时刷新
+            //（保存发生在弹窗内，关闭时机足以让徽章与最新配置对齐，无需轮询）
+            var [proxyActive, setProxyActive] = React.useState(null);
+            var refreshProxyBadge = React.useCallback(function () {
+                fetch("/api/github/proxy")
+                    .then(function (r) { return r.json(); })
+                    .then(function (j) {
+                    if (j && j.ok && j.state && j.state.config) {
+                        setProxyActive({ enabled: Boolean(j.state.config.url), url: j.state.config.url || "" });
+                    }
+                    else {
+                        setProxyActive({ enabled: false, url: "" });
+                    }
+                })
+                    .catch(function () { });
+            }, []);
+            React.useEffect(function () { refreshProxyBadge(); }, [refreshProxyBadge]);
+            // gh 业务数据就绪后，闲时 1.5 秒异步静默检测升级，绝不影响首屏
+            React.useEffect(() => {
+                if (!data)
+                    return;
+                var timer = setTimeout(function () {
+                    fetch("/api/github/check-update")
+                        .then(function (res) { return res.json(); })
+                        .then(function (json) {
+                        if (json && json.ok && json.data) {
+                            setUpdateInfo(json.data);
+                        }
+                    })
+                        .catch(function () { });
+                }, 1500);
+                return function () { clearTimeout(timer); };
+            }, [data]);
             var loadData = React.useCallback(async (forceRefresh = false) => {
+                // 如果是纯手动模式，且非显式强制刷新，且本地已有旧数据，直接跳过后台拉取
+                if (!forceRefresh && syncSettings.strategy === "manual" && data) {
+                    return;
+                }
                 setLoading(true);
+                setSyncStatus(data ? "syncing" : "loading");
                 setError(null);
-                // 全局驾驶舱要 spawn 十几次 gh，冷启动可能超过 10 秒。
-                // 不设显式超时的话浏览器会抛一个与真实原因无关的网络错误，
-                // 早先这里会把所有失败都归因成「后端服务未就绪或接口不存在」——归因错误比没有报错更糟。
                 var controller = new AbortController();
                 var timedOut = false;
-                var timer = setTimeout(function () { timedOut = true; controller.abort(); }, 30000);
+                var timer = setTimeout(function () { timedOut = true; controller.abort(); }, 45000);
                 try {
                     if (forceRefresh)
                         await fetch("/api/github/refresh", { method: "POST" }).catch(() => { });
                     var res = await fetch("/api/github/global-overview", { signal: controller.signal });
                     if (!res.ok) {
                         var errText = await res.text().catch(() => "");
-                        setError(`获取全局数据失败（HTTP ${res.status}）${errText ? ": " + errText : ""}`);
+                        var failMsg = `获取全局数据失败（HTTP ${res.status}）${errText ? ": " + errText : ""}`;
+                        if (data) {
+                            // 容灾保障：有本地旧数据时绝不红屏崩溃，平滑降级展示离线快照
+                            setSyncStatus("failed");
+                        }
+                        else {
+                            setError(failMsg);
+                        }
                         return;
                     }
                     var json = await res.json();
                     if (json.ok && json.data) {
                         setData(json.data);
-                        // 工作区矩阵单独失败时不能静默：否则界面显示「暂无工作区」，把故障伪装成空状态
+                        saveStoredGlobalOverview(json.data); // 写入持久化快照
+                        setLastSyncedAt(Date.now());
+                        setSyncStatus("fresh");
+                        if (json.data.updateInfo) {
+                            setUpdateInfo(json.data.updateInfo);
+                        }
                         if (json.data.workspaceError) {
                             setError("工作区列表读取失败：" + json.data.workspaceError);
                         }
                     }
                     else {
-                        setError(json.error || "获取全局数据失败");
+                        if (data) {
+                            setSyncStatus("failed");
+                        }
+                        else {
+                            setError(json.error || "获取全局数据失败");
+                        }
                     }
                 }
                 catch (err) {
-                    if (timedOut || err.name === "AbortError") {
-                        setError("获取超时（30 秒）：本机 gh 命令响应过慢，通常是网络或工作区数量较多所致。可稍后重试，或减少同时打开的工作区。");
+                    if (data) {
+                        // 后台网络故障时，旧数据依然完整可用
+                        setSyncStatus("failed");
                     }
                     else {
-                        setError("无法连接后端服务：" + (err.message || err));
+                        if (timedOut || err.name === "AbortError") {
+                            setError("获取超时（30 秒）：本机 gh 命令响应过慢，通常是网络或工作区数量较多所致。可稍后重试，或减少同时打开的工作区。");
+                        }
+                        else {
+                            setError("无法连接后端服务：" + (err.message || err));
+                        }
                     }
                 }
                 finally {
                     clearTimeout(timer);
                     setLoading(false);
                 }
-            }, []);
-            React.useEffect(() => { loadData(false); }, [loadData]);
-            // 窗口切回自动探测自愈
+            }, [data, syncSettings]);
+            // 挂载加载调度：SWR 模式下初次延迟 300ms 后台平滑发起静默同步。
+            // 无论本地是否有旧快照都拉：昨天的持久化快照在挂载后 300ms 内自愈，
+            // 「打开驾驶舱即新鲜」由 SWR 定义本身保证，而非依赖用户停留或手动刷新。
+            React.useEffect(() => {
+                if (syncSettings.strategy === "swr") {
+                    var timer = setTimeout(function () { loadData(false); }, 300);
+                    return function () { clearTimeout(timer); };
+                }
+                else if (!data) {
+                    loadData(false);
+                }
+            }, [syncSettings.strategy]);
+            // （原定时轮询调度已随 'interval' 策略一并移除）
+            // 窗口切回自动探测自愈：优先轻量快速探针，检测到已登录立即自愈
             React.useEffect(() => {
                 var onFocus = () => {
                     if (!data?.auth?.loggedIn) {
-                        loadData(false);
+                        fetch("/api/github/auth?force=true")
+                            .then(function (res) { return res.json(); })
+                            .then(function (json) {
+                            if (json && json.ok && json.auth && json.auth.loggedIn) {
+                                clearStoredGlobalOverview();
+                                loadData(true);
+                            }
+                        })
+                            .catch(function () { });
                     }
                 };
                 window.addEventListener("focus", onFocus);
                 return () => window.removeEventListener("focus", onFocus);
             }, [data, loadData]);
             var h = React.createElement;
-            var headerEl = h("div", { className: "dsh-github-header" }, h("div", { className: "dsh-github-title" }, renderOctocatBadge(32), h("h2", null, "GitHub 全景驾驶舱")), h("button", {
+            var headerEl = h("div", { className: "dsh-github-header" }, h("div", { className: "dsh-github-title" }, renderOctocatBadge(32), h("h2", null, "GitHub 全景驾驶舱"), h(SyncStatusBadge, { syncStatus, lastSyncedAt }), 
+            // 代理生效徽章：启用时可见，hover 展示代理地址，让用户随时确认「当前确实在走代理」
+            proxyActive && proxyActive.enabled
+                ? h("span", {
+                    style: {
+                        display: "inline-flex",
+                        alignItems: "center",
+                        gap: "4px",
+                        fontSize: "11px",
+                        fontWeight: 500,
+                        padding: "2px 8px",
+                        borderRadius: "999px",
+                        background: "rgba(9, 105, 218, 0.1)",
+                        border: "1px solid rgba(9, 105, 218, 0.35)",
+                        color: "var(--dsw-alias-link, #0969da)",
+                        cursor: "default",
+                    },
+                    title: "插件网络代理已启用: " + proxyActive.url + "（GitHub 数据链路与工具调用经此代理；点击 ⚙️ 可修改）",
+                }, "🌐 代理")
+                : null), h("div", { style: { display: "flex", alignItems: "center", gap: "8px" } }, h("button", {
                 className: "dsh-github-refresh-btn",
                 onClick: () => loadData(true),
                 disabled: loading,
-            }, loading ? "刷新中..." : "🔄 刷新全局数据"));
+            }, loading ? "同步中..." : "🔄 刷新全局数据"), h("button", {
+                className: "dsh-github-btn-sm",
+                onClick: () => setIsSettingsModalOpen(true),
+                title: "配置数据同步节奏、本地缓存与网络代理",
+                style: { padding: "6px 12px" },
+            }, "⚙️ 设置")));
             if (loading && !data) {
                 return h("div", { className: "dsh-github-panel" }, headerEl, h("div", { className: "dsh-github-empty" }, "正在加载全局 GitHub 账号与工作区数据..."));
             }
+            var effectiveUpdateInfo = updateInfo || data?.updateInfo;
+            var upgradeBannerEl = effectiveUpdateInfo && effectiveUpdateInfo.hasUpdate
+                ? h(UpgradeNotificationCard, { updateInfo: effectiveUpdateInfo, isRightbar: false })
+                : null;
+            var settingsModalEl = h(GlobalSyncSettingsModal, {
+                isOpen: isSettingsModalOpen,
+                onClose: () => {
+                    setIsSettingsModalOpen(false);
+                    // 弹窗内可能刚保存过代理配置，关闭时同步刷新标题栏徽章
+                    refreshProxyBadge();
+                },
+                currentSettings: syncSettings,
+                onSave: (newSettings) => {
+                    setSyncSettings(newSettings);
+                },
+                onClearCache: () => {
+                    setSyncStatus("loading");
+                    setData(null);
+                    setLastSyncedAt(0);
+                },
+            });
+            // 错误拦截阻断：若无本地数据且请求失败，直接呈现错误卡片，杜绝把接口异常伪装成「未安装 CLI」
+            if (!data && error) {
+                return h("div", { className: "dsh-github-panel" }, headerEl, upgradeBannerEl, h("div", {
+                    style: {
+                        padding: "24px",
+                        borderRadius: "8px",
+                        background: "rgba(248, 81, 73, 0.08)",
+                        border: "1px solid rgba(248, 81, 73, 0.3)",
+                        margin: "16px 0",
+                        textAlign: "center",
+                    },
+                }, h("div", { style: { fontSize: "16px", fontWeight: 600, color: "#f85149", marginBottom: "8px" } }, "⚠️ 后端服务加载异常"), h("div", { style: { fontSize: "13px", color: "var(--dsw-alias-label-secondary, #656d76)", marginBottom: "16px" } }, error), h("button", {
+                    className: "dsh-github-btn-sm",
+                    onClick: () => loadData(true),
+                    style: { padding: "6px 18px", background: "var(--dsw-alias-link, #0969da)", color: "#ffffff", borderColor: "var(--dsw-alias-link, #0969da)" },
+                }, "🔄 重新请求")), settingsModalEl);
+            }
             var auth = data ? data.auth : null;
             var userRepos = (data && data.userRepos) || [];
             var workspaceMatrix = (data && data.workspaceMatrix) || [];
@@ -1329,7 +2468,7 @@ body[data-ds-dark-theme] .dsh-github-steps-list {
                     })));
                 }
             }
-            return h("div", { className: "dsh-github-panel" }, headerEl, errorEl, statsCardsEl, authGuideEl, tabsEl, contentEl);
+            return h("div", { className: "dsh-github-panel" }, headerEl, upgradeBannerEl, errorEl, statsCardsEl, authGuideEl, tabsEl, contentEl, settingsModalEl);
         }
         var inject = ["slots", "sidebarRightTabs", "sessions", "layout", "theme"];
         function apply(ctx) {