dsh-github-flow 0.2.0 → 0.3.0

package/lib/client.js

@@ -5,6 +5,105 @@ window.__ModuleLoader__.load({
         var exports = module.exports;
         Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
         var React = require("react");
+        // ============================================================
+        // 面板公共工具函数（纯函数，可被单元测试直接覆盖）
+        // ============================================================
+        /**
+         * ISO 时间 → 人性化相对时间（"刚刚"/"N分钟前"/"N小时前"/"N天前"/日期回退）。
+         * 为什么需要：PR/Issue/Run 的时间字段原始 ISO 串在窄面板不可读，相对时间
+         * 一眼判断「还活跃吗」；hover 场景由调用方把绝对时间放进 title。
+         */
+        function formatRelativeTime(iso) {
+            if (!iso || typeof iso !== "string")
+                return "";
+            var t = Date.parse(iso);
+            if (isNaN(t))
+                return "";
+            var diff = Date.now() - t;
+            if (diff < 0)
+                return "刚刚"; // 时钟轻微漂移容错
+            var MIN = 60 * 1000, HOUR = 60 * MIN, DAY = 24 * HOUR;
+            if (diff < MIN)
+                return "刚刚";
+            if (diff < HOUR)
+                return Math.floor(diff / MIN) + "分钟前";
+            if (diff < DAY)
+                return Math.floor(diff / HOUR) + "小时前";
+            if (diff < 7 * DAY)
+                return Math.floor(diff / DAY) + "天前";
+            var d = new Date(t);
+            return d.getFullYear() + "-" + String(d.getMonth() + 1).padStart(2, "0") + "-" + String(d.getDate()).padStart(2, "0");
+        }
+        /**
+         * statusCheckRollup 聚合为单枚举 CI 徽章状态（"pass" | "fail" | "pending" | null）。
+         * 归约顺序刻意 fail > pending > pass：用户扫一眼要看到的是「有没有问题」，
+         * 而非「有多少通过」——一个 fail 淹没在 9 个 pass 里就是漏报。
+         */
+        function rollupCiStatus(checks) {
+            if (!Array.isArray(checks) || checks.length === 0)
+                return null;
+            var hasFail = false, hasPending = false;
+            for (var i = 0; i < checks.length; i++) {
+                var c = checks[i] || {};
+                var status = String(c.status || "").toLowerCase();
+                var conclusion = String(c.conclusion || "").toLowerCase();
+                if (conclusion === "failure" || conclusion === "timed_out" || conclusion === "cancelled")
+                    hasFail = true;
+                else if (conclusion === "success" || conclusion === "skipped" || conclusion === "neutral") { /* 通过族 */ }
+                else if (status === "in_progress" || status === "queued" || conclusion === "pending" || (!conclusion && status))
+                    hasPending = true;
+            }
+            if (hasFail)
+                return "fail";
+            if (hasPending)
+                return "pending";
+            return "pass";
+        }
+        /**
+         * reviewDecision → 展示态（徽章文案与色彩键）。无判定返回 null 不渲染。
+         */
+        function reviewDecisionBadge(decision) {
+            var d = String(decision || "").toUpperCase();
+            if (d === "APPROVED")
+                return { text: "✔ 已批准", kind: "green" };
+            if (d === "CHANGES_REQUESTED")
+                return { text: "✋ 需修改", kind: "red" };
+            if (d === "REVIEW_REQUIRED")
+                return { text: "👀 待审查", kind: "yellow" };
+            return null;
+        }
+        /**
+         * Actions event → 触发方式短标签。
+         */
+        function eventLabel(event) {
+            var e = String(event || "");
+            if (e === "push")
+                return "⇡ push";
+            if (e === "schedule")
+                return "⏰ 定时";
+            if (e === "workflow_dispatch")
+                return "▶ 手动";
+            if (e === "pull_request")
+                return "🔀 PR";
+            return e || "";
+        }
+        /**
+         * 按容器记录的 Tab 键应用互斥显示状态（hidden 页 + active 按钮）。
+         * 模块级纯 DOM 操作：渲染函数（switchTab 点击路径）与宿主组件的 effect
+         * （SWR 重渲染校正路径）共用——后者是必须的：React 重渲染会按 VDOM 初值
+         * 重设 hidden/active，用户手动切的 Tab 会被一次后台数据同步拽回默认页。
+         */
+        function applyTabState(container, tabKey) {
+            var pages = container.querySelectorAll("[data-tab-page]");
+            pages.forEach(function (page) {
+                page.hidden = page.getAttribute("data-tab-page") !== tabKey;
+            });
+            var btns = container.querySelectorAll("[data-tab-btn]");
+            btns.forEach(function (btn) {
+                var on = btn.getAttribute("data-tab-btn") === tabKey;
+                btn.className = "dsh-github-tab-btn" + (on ? " active" : "");
+            });
+        }
         // 面板样式（内联维护）：DSH 客户端加载器以经典脚本语义执行本产物（build.mjs 剥除
         // export 声明即为佐证），模块级 import 在该语境是 SyntaxError。曾尝试把 CSS 拆为
         // 独立模块经 import 引入，导致 DSH 重启时客户端加载崩溃并触发插件批量卸载——
@@ -290,6 +389,40 @@ body[data-ds-dark-theme] .dsh-badge-purple {
   border-color: rgba(163, 113, 247, 0.3);
 }
 
+/* 插件身份徽标：标识界面由第三方插件 dsh-github-flow 提供（非 DSH/GitHub 官方）。
+ * 为什么需要：界面以 GitHub 官方 Octocat 做功能图标，新用户易误认为官方功能；
+ * 徽标点击跳插件仓库，与设置「关于」页形成身份闭环。 */
+.dsh-github-plugin-badge {
+  display: inline-flex;
+  align-items: center;
+  font-size: 10px;
+  font-weight: 500;
+  padding: 1px 7px;
+  border-radius: 10px;
+  line-height: 14px;
+  vertical-align: middle;
+  margin-left: 8px;
+  text-decoration: none !important;
+  background: rgba(125, 133, 144, 0.12);
+  color: #656d76;
+  border: 1px solid rgba(125, 133, 144, 0.25);
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+.dsh-github-plugin-badge:hover {
+  background: rgba(125, 133, 144, 0.2);
+  color: var(--dsw-alias-label-primary, #1f2328);
+}
+body[data-ds-dark-theme] .dsh-github-plugin-badge {
+  background: rgba(139, 148, 158, 0.18);
+  color: #8b949e;
+  border-color: rgba(139, 148, 158, 0.3);
+}
+body[data-ds-dark-theme] .dsh-github-plugin-badge:hover {
+  background: rgba(139, 148, 158, 0.28);
+  color: #f0f6fc;
+}
+
 /* 7.5. 分类筛选药丸栏 */
 .dsh-github-pills {
   display: flex;
@@ -1058,6 +1191,45 @@ body[data-ds-dark-theme] .dsh-github-cache-info-box {
   color: var(--dsw-alias-label-secondary, #8c8c8c);
 }
 
+/* 关于页求 Star 卡片：与 cache-info-box 同款双主题底色（浅色纸面/暗色深底） */
+.dsh-github-about-star-box {
+  padding: 12px 14px;
+  border-radius: 8px;
+  background: var(--dsw-alias-bg-layer-1, #f6f8fa);
+  border: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+}
+body[data-ds-dark-theme] .dsh-github-about-star-box {
+  background: var(--dsw-alias-bg-base, #161b22);
+  border-color: var(--dsw-alias-border-l1, #30363d);
+}
+
+/* 主操作按钮（链接色底）：链接色底 + 白字，暗色用亮蓝（对齐 radio/链接的暗色强调色 58a6ff） */
+.dsh-github-primary-btn {
+  padding: 5px 14px;
+  font-weight: 600;
+  white-space: nowrap;
+  background: var(--dsw-alias-link, #0969da);
+  border-color: var(--dsw-alias-link, #0969da);
+  color: #ffffff;
+}
+.dsh-github-primary-btn:hover {
+  background: var(--dsw-alias-link, #0969da);
+  border-color: var(--dsw-alias-link, #0969da);
+  color: #ffffff;
+  opacity: 0.88;
+}
+body[data-ds-dark-theme] .dsh-github-primary-btn {
+  background: #58a6ff;
+  border-color: #58a6ff;
+  color: #0d1117;
+}
+body[data-ds-dark-theme] .dsh-github-primary-btn:hover {
+  background: #58a6ff;
+  border-color: #58a6ff;
+  color: #0d1117;
+  opacity: 0.88;
+}
+
 /* 单选框点强调色 */
 .dsh-github-radio {
   accent-color: var(--dsw-alias-link, #0969da);
@@ -1067,6 +1239,48 @@ body[data-ds-dark-theme] .dsh-github-cache-info-box {
 body[data-ds-dark-theme] .dsh-github-radio {
   accent-color: #58a6ff;
 }
+
+/* 17. 提交详情原生模态弹窗 (<dialog>) */
+#dsh-github-commit-dialog {
+  max-width: 600px;
+  width: calc(100vw - 48px);
+  border: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  border-radius: 12px;
+  padding: 0;
+  box-sizing: border-box;
+  background: var(--dsw-alias-bg-base, #ffffff);
+  color: var(--dsw-alias-label-primary, #1f2328);
+  box-shadow: 0 16px 36px rgba(0, 0, 0, 0.22);
+  font-family: var(--dsw-font-family, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif);
+}
+#dsh-github-commit-dialog::backdrop {
+  background: rgba(0, 0, 0, 0.45);
+  backdrop-filter: blur(2px);
+}
+body[data-ds-dark-theme] #dsh-github-commit-dialog {
+  background: var(--dsw-alias-bg-layer-2, #1e1e22);
+  border-color: var(--dsw-alias-border-l1, #30363d);
+  color: var(--dsw-alias-label-primary, #ececec);
+  box-shadow: 0 16px 36px rgba(0, 0, 0, 0.5);
+}
+.dsh-github-commit-row {
+  transition: background 0.15s ease;
+}
+.dsh-github-commit-row:hover {
+  background: var(--dsw-alias-interactive-bg-hover, rgba(0, 0, 0, 0.05));
+}
+body[data-ds-dark-theme] .dsh-github-commit-row:hover {
+  background: var(--dsw-alias-interactive-bg-hover, rgba(255, 255, 255, 0.08));
+}
+body[data-ds-dark-theme] .dsh-github-commit-pre {
+  background: var(--dsw-alias-bg-base, #151517) !important;
+  color: #ececec !important;
+  border: 1px solid #30363d !important;
+}
+.dsh-github-dialog-close-btn:hover {
+  background: var(--dsw-alias-interactive-bg-hover, rgba(0, 0, 0, 0.08)) !important;
+  opacity: 1 !important;
+}
 `;
         function injectStyles() {
             var styleId = "dsh-plugin-github-styles";
@@ -1095,6 +1309,18 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 d: "M8 0C3.58 0 0 3.58 0 8C0 11.54 2.29 14.53 5.47 15.59C5.87 15.66 6.02 15.42 6.02 15.21C6.02 15.02 6.01 14.39 6.01 13.72C4 14.09 3.48 13.23 3.32 12.78C3.23 12.55 2.84 11.84 2.5 11.65C2.22 11.5 1.82 11.13 2.49 11.12C3.12 11.11 3.57 11.7 3.72 11.94C4.44 13.15 5.59 12.81 6.05 12.6C6.12 12.08 6.33 11.72 6.56 11.52C4.78 11.32 2.92 10.63 2.92 7.58C2.92 6.71 3.23 5.99 3.74 5.43C3.66 5.23 3.38 4.41 3.82 3.31C3.82 3.31 4.49 3.1 6.02 4.13C6.66 3.95 7.34 3.86 8.02 3.86C8.7 3.86 9.38 3.95 10.02 4.13C11.55 3.09 12.22 3.31 12.22 3.31C12.66 4.41 12.38 5.23 12.3 5.43C12.81 5.99 13.12 6.7 13.12 7.58C13.12 10.65 11.25 11.32 9.47 11.52C9.76 11.77 10.01 12.25 10.01 13C10.01 14.08 10 14.95 10 15.21C10 15.42 10.15 15.67 10.55 15.59C13.71 14.53 16 11.53 16 8C16 3.58 12.42 0 8 0Z"
             }));
         }
+        // Git 官方菱形分支矢量组件 (viewBox 0 0 1024 1024，经典 #1296db 配色)
+        function renderGitIcon(size = 14, color = "#1296db") {
+            return React.createElement("svg", {
+                viewBox: "0 0 1024 1024",
+                width: size,
+                height: size,
+                style: { flexShrink: 0, display: "inline-block", verticalAlign: "middle" }
+            }, React.createElement("path", {
+                fill: color,
+                d: "M943.078 472.342L551.076 80.34c-21.859-21.859-57.626-21.859-79.485 0L79.589 472.342c-21.859 21.859-21.859 57.626 0 79.485l392.002 392.002c21.859 21.859 57.626 21.859 79.485 0l392.002-392.002c21.858-21.858 21.858-57.626 0-79.485z m-249.083 113.12c-37.939 0-68.693-30.755-68.693-68.693a68.532 68.532 0 0 1 4.136-23.521l-86.88-86.88v237.369c21.391 11.639 35.908 34.313 35.908 60.378 0 37.939-30.755 68.693-68.693 68.693s-68.693-30.755-68.693-68.693c0-27.314 15.944-50.903 39.03-61.973v-250.25c-23.022-10.642-39.03-33.879-39.03-60.907 0-7.808 1.401-15.272 3.853-22.243L344.061 207.871l44.159-44.159L490.738 266.23c5.58-1.503 11.418-2.378 17.473-2.378 37.076 0 67.132 30.056 67.132 67.132 0 6.055-0.875 11.893-2.378 17.473l102.241 102.241a68.68 68.68 0 0 1 18.789-2.623c37.939 0 68.693 30.755 68.693 68.693s-30.754 68.694-68.693 68.694z"
+            }));
+        }
         // 现代暗黑与浅色自适应科技风勋章图标
         function renderOctocatBadge(size = 32) {
             return React.createElement("div", {
@@ -1106,6 +1332,24 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 }
             }, renderOctocat(Math.round(size * 0.58), "#ffffff"));
         }
+        // 插件身份徽标（h 工厂注入）：标注界面由第三方插件 dsh-github-flow 提供。
+        // 点击不直接跳仓库，而是派发全局事件打开「设置-关于」弹窗（仓库/协议/Star
+        // 都在里面），由各宿主面板监听并挂载弹窗——避免从任意界面突兀跳浏览器。
+        function renderPluginBadge(h) {
+            return h("button", {
+                className: "dsh-github-plugin-badge",
+                type: "button",
+                title: "本界面由第三方插件 dsh-github-flow 提供（非 DSH / GitHub 官方）。点击查看关于。",
+                onClick: function (e) {
+                    e.stopPropagation();
+                    e.preventDefault();
+                    try {
+                        window.dispatchEvent(new CustomEvent("dsh-github-open-about"));
+                    }
+                    catch (err) { /* 事件派发失败不阻断点击语义 */ }
+                },
+            }, "插件");
+        }
         // 认证与安装引导卡片组件（响应式自适应中央大面板与右侧栏）
         function AuthGuideCard(props) {
             var auth = props ? props.auth : null;
@@ -1150,15 +1394,17 @@ body[data-ds-dark-theme] .dsh-github-radio {
                     });
                     var json = await res.json();
                     if (json.ok) {
-                        setToastMsg("已唤起系统终端，请在弹出窗口中完成操作");
-                        setTimeout(() => setToastMsg(null), 4000);
+                        // 措辞留余地：start 的成败偶受系统会话策略影响，未弹出时用户仍有手动出路
+                        setToastMsg("已唤起系统终端，请在弹出窗口中完成操作；若未弹出，可手动打开终端执行上方命令");
+                        setTimeout(() => setToastMsg(null), 6000);
                     }
                     else {
-                        setToastMsg(json.message || "唤起失败，请在终端手动运行");
+                        // 失败如实展示：后端带回真实原因（如未找到终端/命令失败），并给出手动命令
+                        setToastMsg("❌ " + (json.message || "唤起失败，请手动打开终端执行上方命令"));
                     }
                 }
                 catch (e) {
-                    setToastMsg("无法连接后台服务，请在终端手动运行");
+                    setToastMsg("无法连接后台服务，请手动打开终端执行上方命令");
                 }
                 finally {
                     setLaunching(false);
@@ -1214,9 +1460,14 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 className: "dsh-github-action-btn",
                 onClick: function () {
                     setToastMsg("正在快速检测登录状态...");
-                    fetch("/api/github/auth?force=true")
+                    // 探测超时保护：后端 auth 探针本身 10s 超时，前端同样 10s 兜底——
+                    // 无超时时挂起会让 toast 永远停在"正在检测"且自愈刷新不触发
+                    var probeController = new AbortController();
+                    var probeTimer = setTimeout(function () { probeController.abort(); }, 10000);
+                    fetch("/api/github/auth?force=true", { signal: probeController.signal })
                         .then(function (res) { return res.json(); })
                         .then(function (json) {
+                        clearTimeout(probeTimer);
                         if (json && json.ok && json.auth && json.auth.loggedIn) {
                             setToastMsg("✅ 已识别到 GitHub CLI 登录态，正在拉取数据...");
                             clearStoredGlobalOverview();
@@ -1228,6 +1479,8 @@ body[data-ds-dark-theme] .dsh-github-radio {
                         }
                     })
                         .catch(function () {
+                        clearTimeout(probeTimer);
+                        setToastMsg("❌ 检测超时或后端不可达，请稍后重试");
                         onRefresh();
                     });
                 },
@@ -1289,7 +1542,16 @@ body[data-ds-dark-theme] .dsh-github-radio {
                     }
                     else {
                         setStatus("failed");
-                        setMsg(json.message || "升级命令执行失败，请在宿主终端手动执行。");
+                        // 失败原因透传：后端 log 的末尾几行含真实报错（如 'dsh' 不是内部命令），
+                        // 只给「退出码异常」这类笼统话术用户无从下手
+                        var logTail = "";
+                        if (json.log && typeof json.log === "string") {
+                            var lines = json.log.trim().split("\n").filter(function (l) { return l.trim(); });
+                            if (lines.length > 0) {
+                                logTail = "\n\n📝 日志末尾: " + lines.slice(-4).join(" ⏎ ").slice(0, 400);
+                            }
+                        }
+                        setMsg((json.message || "升级命令执行失败，请在宿主终端手动执行。") + logTail);
                     }
                 }
                 catch (err) {
@@ -1305,7 +1567,9 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 setDismissed(true);
             };
             var handleCopy = function () {
-                var cmd = updateInfo.upgradeCommand || "pnpm dsh plugin add dsh-github-flow@latest";
+                // 兜底命令也必须带 --profile（官方 CLI 必填）——正常路径 upgradeCommand
+                // 由后端按真实 profile 生成，此默认值仅在后端数据缺失时兜底
+                var cmd = updateInfo.upgradeCommand || "dsh plugin --profile desktop add dsh-github-flow@latest";
                 if (navigator.clipboard) {
                     navigator.clipboard.writeText(cmd);
                     alert("已复制升级命令到剪贴板：\n" + cmd);
@@ -1361,7 +1625,17 @@ body[data-ds-dark-theme] .dsh-github-radio {
                     }, status === "upgrading" ? "升级中..." : "⚡ 一键升级"), h("button", {
                     className: "dsh-github-btn-sm",
                     onClick: handleCopy,
-                    style: { fontSize: "11px", padding: "4px 8px" },
+                    style: {
+                        fontSize: "11px",
+                        padding: "4px 8px",
+                        // 失败态高亮：与驾驶舱横幅同一引导逻辑（失败文案指向复制动作）
+                        ...(status === "failed" ? {
+                            background: "var(--dsw-alias-link, #0969da)",
+                            color: "#ffffff",
+                            borderColor: "var(--dsw-alias-link, #0969da)",
+                            fontWeight: 600,
+                        } : {}),
+                    },
                 }, "📋 复制命令")));
             }
             // 2. 全景驾驶舱大面板横幅模式
@@ -1405,8 +1679,17 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 }, status === "upgrading" ? "正在自动升级中..." : "⚡ 一键自动升级"), h("button", {
                 className: "dsh-github-btn-sm",
                 onClick: handleCopy,
-                style: { padding: "6px 12px" },
-            }, "📋 复制命令"), h("button", {
+                style: {
+                    padding: "6px 12px",
+                    // 失败态高亮复制按钮：失败文案引导的动作就是它，视觉权重同步提升
+                    ...(status === "failed" ? {
+                        background: "var(--dsw-alias-link, #0969da)",
+                        color: "#ffffff",
+                        borderColor: "var(--dsw-alias-link, #0969da)",
+                        fontWeight: 600,
+                    } : {}),
+                },
+            }, status === "failed" ? "📋 复制命令手动升级" : "📋 复制命令"), h("button", {
                 onClick: handleDismiss,
                 title: "不再提醒此版本",
                 style: { background: "none", border: "none", cursor: "pointer", color: "var(--dsw-alias-label-tertiary, #8c8c8c)", fontSize: "16px", padding: "0 4px" },
@@ -1475,7 +1758,7 @@ body[data-ds-dark-theme] .dsh-github-radio {
             }, text);
         }
         // 渲染 GitHub 仓库信息与操作视图的核心函数
-        function renderGithubRepoView(h, data, loading, error, onRefresh, isRightbar = false, updateInfo = null, syncStatus = "", lastSyncedAt = 0) {
+        function renderGithubRepoView(h, data, loading, error, onRefresh, isRightbar = false, updateInfo = null, syncStatus = "", lastSyncedAt = 0, onOpenSettings = null, cwd = null, onSelectCommit = null, gitLogPagination = null) {
             var auth = data ? data.auth : null;
             var repo = data ? data.repo : null;
             var prs = (data && data.pullRequests) || [];
@@ -1485,12 +1768,23 @@ body[data-ds-dark-theme] .dsh-github-radio {
             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", {
+            var headerEl = h("div", { className: "dsh-github-header" }, h("div", { className: "dsh-github-title" }, renderOctocatBadge(isRightbar ? 26 : 30), h("h2", null, isRightbar ? "GitHub 仓库" : "GitHub 工作台"), renderPluginBadge(h), syncStatus ? h(SyncStatusBadge, { syncStatus, lastSyncedAt, isRightbar }) : null), h("div", { style: { display: "flex", alignItems: "center", gap: "6px" } }, h("button", {
                 className: "dsh-github-refresh-btn",
                 onClick: onRefresh,
                 disabled: loading,
-            }, loading ? "刷新中..." : "🔄 刷新"));
-            // 仓库基础卡片
+            }, loading ? "刷新中..." : "🔄 刷新"), 
+            // 设置按钮：与全景主页复用同一设置弹窗（传入回调时渲染——目前仅右侧栏）。
+            // 右侧栏此前没有设置入口，用户必须切到主页才能改同步/代理/更新设置。
+            onOpenSettings ? h("button", {
+                className: "dsh-github-btn-sm",
+                onClick: onOpenSettings,
+                title: "配置数据同步节奏、本地缓存、网络代理与插件信息",
+                style: { padding: "4px 10px" },
+            }, "⚙️") : null));
+            // 仓库基础卡片（Tab 化后回归纯身份信息——git/PR/Release 细节移入「Git 记录」Tab 页）
+            var gitSt = data && data.gitStatus;
+            var relInfo = data && data.releaseInfo;
+            var branchPr = data && data.branchPr;
             var repoCardEl = h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title" }, "当前工作区 GitHub 仓库"), h("div", { className: "dsh-github-card-value" }, repo
                 ? h("a", { href: repo.url, target: "_blank", className: "dsh-github-repo-link" }, repo.nameWithOwner)
                 : h("span", { style: { color: "var(--dsw-alias-state-error-primary, #cf222e)" } }, "未检测到关联的 GitHub 仓库"), repo ? h("span", { className: "dsh-github-badge dsh-badge-green" }, repo.defaultBranch) : null), repo && repo.description
@@ -1500,6 +1794,138 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 : null, !repo
                 ? h("div", { className: "dsh-github-card-subtext" }, "若本地已有 git 仓库，请运行 `git remote add github <url>` 或 `git remote add origin <url>` 关联远程仓库。")
                 : null);
+            // ============ 「Git 记录」Tab 页：提交记录 + 本地↔远程差异 ============
+            // 用户核心诉求：具体的提交内容（谁/何时/什么信息）+ 远程与本地的区别。
+            // 三段视图：待推送（本地领先）/ 待拉取（远程领先，快照口径）/ 最近提交；
+            // 分支同步摘要行保留为上下文锚点。
+            var commitLog = data && data.commitLog;
+            var renderCommitRow = function (c, tone) {
+                return h("div", {
+                    style: { display: "flex", alignItems: "baseline", gap: "8px", padding: "3px 6px", fontSize: "12px", cursor: "pointer", borderRadius: "4px" },
+                    className: "dsh-github-commit-row",
+                    // 行级悬浮：完整 subject + 作者 + 时间 + 点击提示
+                    title: `${c.subject}\n— ${c.author} · ${c.relative} · ${c.sha}\n（点击查看提交详情）`,
+                    onClick: function () {
+                        if (typeof onSelectCommit === "function") {
+                            onSelectCommit(c);
+                        }
+                    },
+                }, h("span", {
+                    style: {
+                        fontFamily: "monospace",
+                        fontSize: "11px",
+                        color: tone === "ahead" ? "var(--dsw-alias-state-success-primary, #1a7f37)"
+                            : tone === "behind" ? "var(--dsw-alias-state-attention-primary, #9a6700)"
+                                : "var(--dsw-alias-label-secondary, #656d76)",
+                        flexShrink: 0,
+                    },
+                }, c.sha), 
+                // subject 单行截断：溢出省略号，全文走悬浮与点击弹窗
+                h("span", {
+                    style: {
+                        flex: 1,
+                        minWidth: 0,
+                        overflow: "hidden",
+                        textOverflow: "ellipsis",
+                        whiteSpace: "nowrap",
+                    },
+                }, c.subject), h("span", { style: { fontSize: "11px", color: "var(--dsw-alias-label-secondary, #656d76)", whiteSpace: "nowrap", flexShrink: 0 } }, `${c.author} · ${c.relative}`));
+            };
+            var gitSectionEl = h("div", { className: "dsh-github-section" }, 
+            // section header + Release 右上角小徽章（flex 两端对齐；hover title 显详情，
+            // 点击直达 Release 页——从尾部大块降为角落锚点，节省一整行卡片空间）
+            h("div", { style: { display: "flex", alignItems: "center", justifyContent: "space-between", gap: "8px" } }, h("h3", { style: { margin: 0, display: "flex", alignItems: "center", gap: "6px" } }, renderGitIcon(16, "#1296db"), "Git 记录"), relInfo
+                ? h(relInfo.url ? "a" : "span", {
+                    ...(relInfo.url ? { href: relInfo.url, target: "_blank" } : {}),
+                    className: "dsh-github-badge" + (relInfo.isPrerelease ? " dsh-badge-purple" : " dsh-badge-green"),
+                    style: { fontSize: "10px", textDecoration: "none", flexShrink: 0 },
+                    title: `最新 Release: ${relInfo.tagName}${relInfo.isPrerelease ? "（预发布）" : ""}${formatRelativeTime(relInfo.publishedAt) ? ` · ${formatRelativeTime(relInfo.publishedAt)}发布` : ""}\n点击打开 Release 页`,
+                }, `🏷️ ${relInfo.tagName}`)
+                : null), 
+            // 分支同步摘要（上下文锚点，含快照语义提示）
+            gitSt
+                ? h("div", {
+                    style: { display: "flex", alignItems: "center", gap: "8px", flexWrap: "wrap", fontSize: "13px", marginBottom: "8px" },
+                    title: "ahead/behind 相对上次 git fetch 的快照（非实时）",
+                }, h("span", { style: { fontWeight: 600, display: "inline-flex", alignItems: "center", gap: "5px" } }, renderGitIcon(13, "#1296db"), gitSt.branch), gitSt.hasUpstream
+                    ? h("span", null, `${gitSt.ahead > 0 ? "↑" + gitSt.ahead + " " : ""}${gitSt.behind > 0 ? "↓" + gitSt.behind : ""}${gitSt.ahead === 0 && gitSt.behind === 0 ? "✓ 与远程同步" : ""}`)
+                    : h("span", { style: { opacity: 0.7 } }, "↑? ↓?（无 upstream）"), gitSt.dirtyCount > 0
+                    ? h("span", null, `· ${gitSt.dirtyCount} 文件未提交`)
+                    : h("span", null, "· 工作区干净"))
+                : null, 
+            // 段 1：本地领先远程（待推送的具体提交）
+            commitLog && commitLog.aheadCommits && commitLog.aheadCommits.length > 0
+                ? h("div", { style: { marginBottom: "10px" } }, h("div", { style: { fontSize: "12px", fontWeight: 600, marginBottom: "4px", color: "var(--dsw-alias-state-success-primary, #1a7f37)" } }, `↑ 本地领先远程 ${commitLog.aheadCommits.length} 个提交（待 push）`), commitLog.aheadCommits.map(function (c, i) { return h("div", { key: "a" + i }, renderCommitRow(c, "ahead")); }))
+                : null, 
+            // 段 2：远程领先本地（待拉取的具体提交——上次 fetch 快照口径）
+            commitLog && commitLog.behindCommits && commitLog.behindCommits.length > 0
+                ? h("div", { style: { marginBottom: "10px" } }, h("div", { style: { fontSize: "12px", fontWeight: 600, marginBottom: "4px", color: "var(--dsw-alias-state-attention-primary, #9a6700)" } }, `↓ 远程领先本地 ${commitLog.behindCommits.length} 个提交（待 pull · 快照口径）`), commitLog.behindCommits.map(function (c, i) { return h("div", { key: "b" + i }, renderCommitRow(c, "behind")); }))
+                : null, 
+            // 段 3：最近提交（常态锚定——即使完全同步也有内容可看；支持分页加载更多）
+            (() => {
+                var baseRecent = (commitLog && commitLog.recent) || [];
+                var extraRecent = (gitLogPagination && gitLogPagination.extraCommits) || [];
+                var allRecentCommits = baseRecent.concat(extraRecent);
+                var totalCommits = commitLog && commitLog.totalCount;
+                var loadingMore = Boolean(gitLogPagination && gitLogPagination.loadingMore);
+                var hasMore = Boolean(gitLogPagination && gitLogPagination.hasMore);
+                var onLoadMore = gitLogPagination ? gitLogPagination.onLoadMore : null;
+                if (allRecentCommits.length === 0)
+                    return null;
+                return h("div", null, h("div", { style: { display: "flex", justifyContent: "space-between", alignItems: "center", marginBottom: "6px" } }, h("div", { style: { fontSize: "12px", fontWeight: 600, opacity: 0.85 } }, "🕘 最近提交"), totalCommits
+                    ? h("div", { style: { fontSize: "11px", opacity: 0.6 } }, `${allRecentCommits.length} / ${totalCommits}`)
+                    : null), allRecentCommits.map(function (c, i) { return h("div", { key: "r" + (c.sha || i) }, renderCommitRow(c, "recent")); }), 
+                // 下滑或点击加载更多
+                h("div", { style: { marginTop: "10px", textAlign: "center" } }, loadingMore
+                    ? h("div", { style: { fontSize: "11px", opacity: 0.75, padding: "6px 0" } }, "⏳ 正在加载更多提交…")
+                    : (hasMore && onLoadMore)
+                        ? h("button", {
+                            className: "dsh-github-btn-sm",
+                            style: {
+                                cursor: "pointer",
+                                padding: "4px 14px",
+                                borderRadius: "14px",
+                                border: "1px solid var(--dsw-alias-border-l2, #d0d7de)",
+                                background: "var(--dsw-alias-bg-module-platform, #f6f8fa)",
+                                color: "inherit",
+                                fontSize: "11px",
+                                lineHeight: "1.6",
+                            },
+                            onClick: onLoadMore,
+                        }, `⬇️ 下滑或点击加载更多 (${allRecentCommits.length}${totalCommits ? " / " + totalCommits : ""})`)
+                        : (allRecentCommits.length >= 15)
+                            ? h("div", { style: { fontSize: "11px", opacity: 0.5, padding: "4px 0" } }, `✓ 已加载全部 ${allRecentCommits.length} 条提交`)
+                            : null));
+            })(), !commitLog || ((commitLog.aheadCommits || []).length === 0 && (commitLog.behindCommits || []).length === 0 && (commitLog.recent || []).length === 0)
+                ? h("div", { className: "dsh-github-empty" }, "无提交记录")
+                : null, 
+            // 分支关联 PR 与 Release 锚定（保留）
+            branchPr
+                ? h("div", { className: "dsh-github-item", style: { display: "flex", alignItems: "center", gap: "8px", flexWrap: "wrap", marginTop: "8px" } }, h("span", null, "🔀"), branchPr.url
+                    ? h("a", { className: "dsh-github-item-title", href: branchPr.url, target: "_blank" }, `PR #${branchPr.number} ${branchPr.title}`)
+                    : h("span", { className: "dsh-github-item-title" }, `PR #${branchPr.number} ${branchPr.title}`), branchPr.isDraft ? h("span", { className: "dsh-github-badge dsh-badge-yellow" }, "DRAFT") : null)
+                : null);
+            // ============ 「未提交清单」Tab 页（全宽列表，原 details 折叠平移） ============
+            var dirtySectionEl = h("div", { className: "dsh-github-section" }, h("div", { className: "dsh-github-section-header" }, h("h3", null, `📁 未提交清单 (${gitSt ? gitSt.dirtyCount : 0})`)), !gitSt || gitSt.dirtyCount === 0
+                ? h("div", { className: "dsh-github-empty" }, "工作区干净，没有未提交的变更 ✓")
+                : h("div", { style: { fontSize: "12px", lineHeight: "1.9" } }, (gitSt.dirtyFiles || []).map(function (f, i) {
+                    return h("div", { key: i, style: { display: "flex", gap: "8px", padding: "2px 4px", borderRadius: "4px" } }, h("span", {
+                        style: {
+                            minWidth: "24px",
+                            textAlign: "center",
+                            opacity: 0.75,
+                            fontSize: "11px",
+                            fontFamily: "monospace",
+                            // 状态码配色：?? 新增(绿) / D 删除(红) / M 修改(黄) / 其他中性
+                            color: f.status === "??" ? "var(--dsw-alias-state-success-primary, #1a7f37)"
+                                : f.status.indexOf("D") >= 0 ? "var(--dsw-alias-state-error-primary, #cf222e)"
+                                    : f.status.indexOf("M") >= 0 || f.status.indexOf("R") >= 0 ? "var(--dsw-alias-state-attention-primary, #9a6700)"
+                                        : "inherit",
+                        },
+                    }, f.status === "??" ? "??" : f.status), h("span", { style: { wordBreak: "break-all" } }, f.path));
+                }), gitSt.dirtyCount > (gitSt.dirtyFiles || []).length
+                    ? h("div", { style: { opacity: 0.6, marginTop: "6px" } }, `…共 ${gitSt.dirtyCount} 个变更（仅列前 ${(gitSt.dirtyFiles || []).length}）`)
+                    : null));
             // 快捷操作栏 (方案 1: 官方黄金功能直达)
             var actionsBarEl = h("div", { className: "dsh-github-quick-actions" }, 
             // 1. 浏览器打开仓库主页
@@ -1555,9 +1981,28 @@ body[data-ds-dark-theme] .dsh-github-radio {
             // PR 列表
             var prSectionEl = h("div", { className: "dsh-github-section" }, h("div", { className: "dsh-github-section-header" }, h("h3", null, `🔀 Pull Requests (${prs.length})`)), prs.length === 0
                 ? h("div", { className: "dsh-github-empty" }, "当前无开放中的 PR")
-                : h("div", { className: "dsh-github-list" }, prs.map((pr) => h("div", { key: pr.number, className: "dsh-github-item" }, h("a", { className: "dsh-github-item-title", href: pr.url, target: "_blank" }, `#${pr.number} ${pr.title}`), h("div", { className: "dsh-github-item-meta" }, h("span", null, `${pr.headRefName} → ${pr.baseRefName}`), pr.mergeable === "CONFLICTING"
-                    ? h("span", { className: "dsh-github-badge dsh-badge-red" }, "代码冲突")
-                    : h("span", { className: "dsh-github-badge dsh-badge-green" }, "可合并"))))));
+                : h("div", { className: "dsh-github-list" }, prs.map((pr) => {
+                    // CI 聚合（归约顺序 fail>pending>pass——问题优先于通过）与 Review 判定
+                    var ci = rollupCiStatus(pr.statusCheckRollup);
+                    var rv = reviewDecisionBadge(pr.reviewDecision);
+                    var relTime = formatRelativeTime(pr.updatedAt);
+                    return h("div", { key: pr.number, className: "dsh-github-item" }, h("a", {
+                        className: "dsh-github-item-title",
+                        href: pr.url,
+                        target: "_blank",
+                        title: relTime ? `更新于 ${pr.updatedAt}` : undefined,
+                    }, `${pr.isDraft ? "⚪ " : ""}#${pr.number} ${pr.title}`), h("div", { className: "dsh-github-item-meta" }, h("span", null, `${pr.headRefName} → ${pr.baseRefName}`), pr.mergeable === "CONFLICTING"
+                        ? h("span", { className: "dsh-github-badge dsh-badge-red" }, "代码冲突")
+                        : h("span", { className: "dsh-github-badge dsh-badge-green" }, "可合并"), ci === "fail"
+                        ? h("span", { className: "dsh-github-badge dsh-badge-red" }, "❌ CI 失败")
+                        : ci === "pending"
+                            ? h("span", { className: "dsh-github-badge dsh-badge-yellow" }, "⏳ CI 运行中")
+                            : ci === "pass"
+                                ? h("span", { className: "dsh-github-badge dsh-badge-green" }, "✅ CI 通过")
+                                : null, rv
+                        ? h("span", { className: `dsh-github-badge dsh-badge-${rv.kind}` }, rv.text)
+                        : null, relTime ? h("span", null, relTime) : null));
+                })));
             // 仓库 Issues 列表
             var issueSectionEl = h("div", { className: "dsh-github-section" }, h("div", { className: "dsh-github-section-header" }, h("h3", null, `📋 仓库 Issues (${issues.length})`), repo?.url
                 ? h("a", {
@@ -1588,15 +2033,72 @@ body[data-ds-dark-theme] .dsh-github-radio {
             // Actions 流水线
             var runSectionEl = h("div", { className: "dsh-github-section" }, h("div", { className: "dsh-github-section-header" }, h("h3", null, `⚡ 最近 Actions 流水线 (${runs.length})`)), runs.length === 0
                 ? h("div", { className: "dsh-github-empty" }, "暂无工作流记录")
-                : h("div", { className: "dsh-github-list" }, runs.map((r) => h("div", { key: r.databaseId, className: "dsh-github-item" }, h("a", { className: "dsh-github-item-title", href: r.url, target: "_blank" }, r.name), h("div", { className: "dsh-github-item-meta" }, h("span", null, `分支: ${r.headBranch}`), r.conclusion === "success"
+                : h("div", { className: "dsh-github-list" }, runs.map((r) => h("div", { key: r.databaseId, className: "dsh-github-item" }, h("a", {
+                    className: "dsh-github-item-title",
+                    href: r.url,
+                    target: "_blank",
+                    title: r.createdAt ? `始于 ${r.createdAt}` : undefined,
+                }, r.name), h("div", { className: "dsh-github-item-meta" }, h("span", null, `分支: ${r.headBranch}`), r.event ? h("span", null, eventLabel(r.event)) : null, formatRelativeTime(r.createdAt) ? h("span", null, formatRelativeTime(r.createdAt)) : null, r.conclusion === "success"
                     ? h("span", { className: "dsh-github-badge dsh-badge-green" }, "✓ 成功")
                     : r.conclusion === "failure"
                         ? h("span", { className: "dsh-github-badge dsh-badge-red" }, "✕ 失败")
-                        : h("span", { className: "dsh-github-badge dsh-badge-yellow" }, r.status))))));
+                        : h("span", { className: "dsh-github-badge dsh-badge-yellow" }, r.status)), 
+                // 失败自愈引导：把面板从「展示」升级为「引导 Agent 定位」——
+                // run_id 直接嵌入文案，Agent 看到即可发起 log_failed 调用
+                r.conclusion === "failure"
+                    ? h("div", {
+                        className: "dsh-github-card-subtext",
+                        style: { fontSize: "11px", marginTop: "2px" },
+                    }, `💡 让 Agent 调用 github_run(action:'log_failed', run_id:'${r.databaseId}') 提取失败日志定位原因`)
+                    : null))));
             var authGuideEl = !auth?.loggedIn
                 ? h(AuthGuideCard, { auth, onRefresh, isRightbar })
                 : null;
-            return [headerEl, upgradeBannerEl, authGuideEl, repoCardEl, actionsBarEl, prSectionEl, issueSectionEl, runSectionEl].filter(Boolean);
+            // ============ 内容区 Tab 化（五页互斥，DOM 级状态） ============
+            // 为什么 Tab 状态存 DOM 而非 React state / 模块变量：renderGithubRepoView
+            // 是普通渲染函数（非组件，不能 useState）；模块级可变状态在多宿主双挂载时
+            // 会串扰。data-active-tab 属性挂在每实例容器上，各实例独立记忆各自 Tab。
+            var TAB_DEFS = [
+                { key: "git", label: "Git", count: null, icon: renderGitIcon(13, "#1296db") },
+                { key: "dirty", label: "📁 未提交", count: gitSt ? gitSt.dirtyCount : null },
+                { key: "prs", label: "🔀 PR", count: prs.length },
+                { key: "issues", label: "📋 Issues", count: issues.length },
+                { key: "runs", label: "⚡ Actions", count: runs.length },
+            ].filter(function (t) {
+                // 无 gitStatus（非 Git 工作区/探测失败）时 Git 与未提交两页隐藏——
+                // 数据缺失是常态而非禁用态，隐藏比置灰诚实
+                if ((t.key === "git" || t.key === "dirty") && !gitSt)
+                    return false;
+                return true;
+            });
+            // 默认 Tab：Git 记录（工作区状态是会话最常查的上下文）；非 Git 工作区
+            // 降级为 PR，空 PR + 有 Issue 再降 Issues
+            var defaultTab = gitSt ? "git" : (prs.length === 0 && issues.length > 0 ? "issues" : "prs");
+            var switchTab = function (container, tabKey) {
+                // data-active-tab 是每实例的 Tab 记忆载体（DOM 属性）；互斥显示逻辑
+                // 提升为模块级 applyTabState（与宿主组件的 SWR 校正 effect 共用）
+                container.setAttribute("data-active-tab", tabKey);
+                applyTabState(container, tabKey);
+            };
+            var tabsBarEl = h("div", { className: "dsh-github-tabs", style: { marginBottom: "12px" } }, ...TAB_DEFS.map(function (t) {
+                var labelText = t.count !== null ? `${t.label} (${t.count})` : t.label;
+                return h("button", {
+                    key: t.key,
+                    // React 无受控状态——className 初值按默认 Tab 计算，切换由 switchTab 直接改 DOM
+                    className: "dsh-github-tab-btn" + (t.key === defaultTab ? " active" : ""),
+                    "data-tab-btn": t.key,
+                    style: t.icon ? { display: "inline-flex", alignItems: "center", gap: "5px" } : undefined,
+                    onClick: function (e) {
+                        var container = e.target.closest("[data-active-tab]");
+                        if (container)
+                            switchTab(container, t.key);
+                    },
+                }, t.icon ? [t.icon, " ", labelText] : labelText);
+            }));
+            var tabbedContentEl = h("div", { "data-active-tab": defaultTab }, tabsBarEl, 
+            // 五个页面：hidden 初值按默认 Tab；原三区块内部渲染零改动，仅加包裹属性
+            h("div", { "data-tab-page": "prs", hidden: defaultTab !== "prs" }, prSectionEl), h("div", { "data-tab-page": "issues", hidden: defaultTab !== "issues" }, issueSectionEl), h("div", { "data-tab-page": "runs", hidden: defaultTab !== "runs" }, runSectionEl), gitSt ? h("div", { "data-tab-page": "git", hidden: defaultTab !== "git" }, gitSectionEl) : null, gitSt ? h("div", { "data-tab-page": "dirty", hidden: defaultTab !== "dirty" }, dirtySectionEl) : null);
+            return [headerEl, upgradeBannerEl, authGuideEl, repoCardEl, actionsBarEl, tabbedContentEl].filter(Boolean);
         }
         // 全局持久化缓存与偏好配置键名
         var GLOBAL_OVERVIEW_CACHE_KEY = "dsh_github_global_overview_snapshot_v1";
@@ -1776,10 +2278,10 @@ body[data-ds-dark-theme] .dsh-github-radio {
                     window.removeEventListener("dsh-github-cache-cleared", onCacheCleared);
                 };
             }, []);
-            // gh 数据拉取完毕后，闲时 1.5 秒异步检测升级，绝对不抢占主业务首屏资源
+            // 检查更新与 gh 环境链路（安装/登录/业务数据）零依赖，挂载即并行发起：
+            // 原先门控在 [data] 之后会串行等 5~19 秒，且 gh 冷启动失败时 data 恒空导致横幅永不出。
+            // 仅 300ms 微延迟避让首屏渲染；并发由服务端 inFlightPromise + 24h 缓存合流去重。
             React.useEffect(() => {
-                if (!data)
-                    return;
                 var timer = setTimeout(function () {
                     fetch("/api/github/check-update")
                         .then(function (res) { return res.json(); })
@@ -1789,9 +2291,9 @@ body[data-ds-dark-theme] .dsh-github-radio {
                         }
                     })
                         .catch(function () { });
-                }, 1500);
+                }, 300);
                 return function () { clearTimeout(timer); };
-            }, [data]);
+            }, []);
             // 遵循全局规则的数据拉取核心函数 (仅依赖标量 cwd 与 sessionId，坚决去除 props 引用依赖，彻底终结死循环)
             var loadData = React.useCallback(async (forceRefresh = false) => {
                 // 规则执行：若主页设置为「纯手动模式 (manual)」，且非用户点击强制刷新，且本地已有数据，坚决不打后台网络！
@@ -1803,9 +2305,15 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 }
                 setSyncStatus(data ? "syncing" : "loading");
                 setError(null);
+                // 与全局面板同规格的超时保护：任一 fetch 挂起（如系统代理劫持回环请求）时
+                // 45 秒 abort，loading 必然清除——未安装 gh 的用户能拿到明确的错误出口
+                // 而非永久转圈。此前本函数完全没有 AbortController，挂起即永久 loading。
+                var controller = new AbortController();
+                var timedOut = false;
+                var timer = setTimeout(function () { timedOut = true; controller.abort(); }, 45000);
                 try {
                     if (forceRefresh) {
-                        await fetch("/api/github/refresh", { method: "POST" }).catch(() => { });
+                        await fetch("/api/github/refresh", { method: "POST", signal: controller.signal }).catch(() => { });
                     }
                     var url = "/api/github/overview";
                     var params = [];
@@ -1818,7 +2326,7 @@ body[data-ds-dark-theme] .dsh-github-radio {
                     if (params.length > 0) {
                         url += "?" + params.join("&");
                     }
-                    var res = await fetch(url);
+                    var res = await fetch(url, { signal: controller.signal });
                     if (!res.ok) {
                         var errText = await res.text().catch(() => "");
                         var msg = `后端服务未就绪 (${res.status}): ${errText || res.statusText}`;
@@ -1849,13 +2357,20 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 }
                 catch (err) {
                     if (data) {
+                        // 后台网络故障时，旧数据依然完整可用
                         setSyncStatus("failed");
                     }
                     else {
-                        setError(err.message || "网络异常");
+                        if (timedOut || err.name === "AbortError") {
+                            setError("获取超时（45 秒）：本机 gh 命令响应过慢或网络代理劫持了回环请求。可稍后重试，或在「⚙️ 设置 → 🌐 网络代理」确认代理已放行 127.0.0.1。");
+                        }
+                        else {
+                            setError(err.message || "网络异常");
+                        }
                     }
                 }
                 finally {
+                    clearTimeout(timer);
                     setLoading(false);
                 }
             }, [cwd, sessionId, data, syncSettings.strategy]);
@@ -1873,6 +2388,17 @@ body[data-ds-dark-theme] .dsh-github-radio {
             }, [cwd, sessionId, syncSettings.strategy]);
             // （原定时轮询调度已随 'interval' 策略一并移除：前端 setInterval 受浏览器
             //  后台节流且随组件卸载销毁，无法兑现「定时自动更新」承诺）
+            // Tab 状态校正：SWR 后台同步触发 data 重渲染时，renderGithubRepoView 的
+            // hidden/active 按默认 Tab 重算——用户手动切换的选择会被拽回。此 effect
+            // 在每次 data 变化后按容器记录的 data-active-tab（用户最后选择）重新应用。
+            React.useEffect(() => {
+                var container = containerRef.current;
+                if (!container)
+                    return;
+                var active = container.getAttribute("data-active-tab");
+                if (active)
+                    applyTabState(container, active);
+            }, [data]);
             // 窗口切回自动探测自愈：优先轻量快速探针，检测到已登录立即自愈
             React.useEffect(() => {
                 var onFocus = () => {
@@ -1890,8 +2416,130 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 window.addEventListener("focus", onFocus);
                 return () => window.removeEventListener("focus", onFocus);
             }, [data, loadData]);
+            // 设置弹窗（右侧栏独立实例）：插件徽标 → 直开「关于」分区；⚙️ 按钮 → 默认
+            // 「数据同步」。与全景主页复用同一弹窗组件，同步设置经事件总线实时对齐两侧。
+            var [aboutModalOpen, setAboutModalOpen] = React.useState(false);
+            var [rightbarModalOpen, setRightbarModalOpen] = React.useState(false);
+            var [rightbarModalSection, setRightbarModalSection] = React.useState("sync");
+            var [selectedCommit, setSelectedCommit] = React.useState(null);
+            var [extraCommits, setExtraCommits] = React.useState([]);
+            var [loadingMore, setLoadingMore] = React.useState(false);
+            var [hasMoreCommits, setHasMoreCommits] = React.useState(true);
+            var containerRef = React.useRef(null);
+            // 工作区路径切换或刷新数据时重置分页状态
+            React.useEffect(function () {
+                setExtraCommits([]);
+                setHasMoreCommits(true);
+            }, [cwd, data]);
+            var loadMoreCommits = function () {
+                if (loadingMore || !hasMoreCommits)
+                    return;
+                var baseCount = (data?.commitLog?.recent?.length || 0);
+                var currentCount = baseCount + extraCommits.length;
+                var total = data?.commitLog?.totalCount;
+                if (total !== undefined && currentCount >= total) {
+                    setHasMoreCommits(false);
+                    return;
+                }
+                setLoadingMore(true);
+                var url = "/api/github/git-log?limit=15&skip=" + currentCount + (cwd ? "&cwd=" + encodeURIComponent(cwd) : "");
+                fetch(url)
+                    .then(function (r) { return r.json(); })
+                    .then(function (j) {
+                    setLoadingMore(false);
+                    if (j && j.ok && j.data && Array.isArray(j.data.commits)) {
+                        if (j.data.commits.length === 0) {
+                            setHasMoreCommits(false);
+                        }
+                        else {
+                            setExtraCommits(function (prev) { return prev.concat(j.data.commits); });
+                            if (j.data.totalCount !== undefined && (currentCount + j.data.commits.length) >= j.data.totalCount) {
+                                setHasMoreCommits(false);
+                            }
+                        }
+                    }
+                    else {
+                        setHasMoreCommits(false);
+                    }
+                })
+                    .catch(function () {
+                    setLoadingMore(false);
+                });
+            };
+            // 监听右侧栏容器滚动触底：下滑时自动加载更多提交
+            React.useEffect(function () {
+                var el = containerRef.current;
+                if (!el)
+                    return;
+                var onScroll = function () {
+                    var activeTab = el.getAttribute("data-active-tab");
+                    if (activeTab && activeTab !== "git")
+                        return;
+                    var threshold = 80;
+                    if (el.scrollHeight - el.scrollTop - el.clientHeight < threshold) {
+                        loadMoreCommits();
+                    }
+                };
+                el.addEventListener("scroll", onScroll, { passive: true });
+                return function () { el.removeEventListener("scroll", onScroll); };
+            }, [data, extraCommits, loadingMore, hasMoreCommits, cwd]);
+            React.useEffect(() => {
+                // 多宿主同挂载防叠层：全景主页与右侧栏可能同时在 DOM 中，徽标事件若被
+                // 两处同时响应会出现双层弹窗。只有「自身容器可见」的宿主才响应——
+                // 徽标所在面板必然是用户当前看到的那个。
+                var onOpenAbout = () => {
+                    var el = containerRef.current;
+                    if (!el)
+                        return;
+                    var rect = el.getBoundingClientRect();
+                    var visible = rect.width > 0 && rect.height > 0;
+                    if (visible)
+                        setAboutModalOpen(true);
+                };
+                window.addEventListener("dsh-github-open-about", onOpenAbout);
+                return () => window.removeEventListener("dsh-github-open-about", onOpenAbout);
+            }, []);
+            var openRightbarSettings = () => {
+                setRightbarModalSection("sync");
+                setRightbarModalOpen(true);
+            };
             var h = React.createElement;
-            return h("div", { className: "dsh-github-rightbar-container" }, ...renderGithubRepoView(h, data, loading, error, () => loadData(true), true, updateInfo, syncStatus, lastSyncedAt));
+            return h("div", { className: "dsh-github-rightbar-container", ref: containerRef }, ...renderGithubRepoView(h, data, loading, error, () => loadData(true), true, updateInfo, syncStatus, lastSyncedAt, openRightbarSettings, cwd, (c) => setSelectedCommit(c), {
+                extraCommits: extraCommits,
+                loadingMore: loadingMore,
+                hasMore: hasMoreCommits,
+                onLoadMore: loadMoreCommits,
+            }), 
+            // 弹窗一：插件徽标触发的「关于」单页展示
+            h(GlobalSyncSettingsModal, {
+                isOpen: aboutModalOpen,
+                initialSection: "about",
+                onClose: () => setAboutModalOpen(false),
+                currentSettings: syncSettings,
+                onSave: function () { },
+                onClearCache: function () { setData(null); },
+            }), 
+            // 弹窗二：⚙️ 按钮触发的完整设置（与主页同一弹窗组件，分区可自由切换）
+            h(GlobalSyncSettingsModal, {
+                isOpen: rightbarModalOpen,
+                initialSection: rightbarModalSection,
+                onClose: () => setRightbarModalOpen(false),
+                currentSettings: syncSettings,
+                onSave: function (newSettings) { setSyncSettings(newSettings); },
+                onClearCache: function () {
+                    setData(null);
+                    setLastSyncedAt(0);
+                    setSyncStatus("loading");
+                },
+            }), 
+            // 弹窗三：点击 Git 提交记录行的详情模态弹窗（与设置弹窗同构，在右侧栏容器内天然居中）
+            selectedCommit
+                ? h(CommitDetailModal, {
+                    commit: selectedCommit,
+                    onClose: function () { setSelectedCommit(null); },
+                    cwd: cwd,
+                })
+                : null);
         }
         // 2. 右侧栏 Tab 标题组件
         function GithubRightbarTitle() {
@@ -1907,22 +2555,142 @@ body[data-ds-dark-theme] .dsh-github-radio {
             const active = Boolean(props && props.active);
             return React.createElement("div", {
                 className: "dsh-github-icon" + (active ? " active" : ""),
-                title: "GitHub 全景驾驶舱",
+                title: "GitHub 全景驾驶舱（dsh-github-flow 插件）",
             }, React.createElement("div", {
                 className: "dsh-github-icon-inner" + (active ? " active" : "")
             }, renderOctocat(18, "currentColor")));
         }
-        // 全景驾驶舱「⚙️ 设置」模态弹窗组件：左侧分区导航（数据同步 / 网络代理）+ 右侧内容区。
+        // 提交详情模态弹窗组件（与设置弹窗同构：使用相同的 modal-overlay 与 modal-dialog，
+        // 在右侧栏宿主内天然居中展示，不突破右侧容器边界）。
+        // 数据源优先来自本地 git 预取（c.sha/fullSha/author/date/subject/body/stat，0ms 纯本地秒开），
+        // 缺失时静默向后端拉取 git show 原文补充，弹窗内完整支持上下滚动浏览超长提交说明。
+        function CommitDetailModal(props) {
+            if (!props.commit)
+                return null;
+            var c = props.commit;
+            var h = React.createElement;
+            var [fetchedDetail, setFetchedDetail] = React.useState(null);
+            var [fetchingDetail, setFetchingDetail] = React.useState(false);
+            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]);
+            // 兜底补全机制：若内存中无 body/stat（如 DSH 尚未重启加载新解析逻辑），静默单查
+            React.useEffect(function () {
+                setFetchedDetail(null);
+                if (c.body || c.stat)
+                    return;
+                setFetchingDetail(true);
+                var url = "/api/github/commit-detail?sha=" + encodeURIComponent(c.sha) + (props.cwd ? "&cwd=" + encodeURIComponent(props.cwd) : "");
+                fetch(url)
+                    .then(function (r) { return r.json(); })
+                    .then(function (j) {
+                    setFetchingDetail(false);
+                    if (j && j.ok && j.detail)
+                        setFetchedDetail(j.detail);
+                })
+                    .catch(function () { setFetchingDetail(false); });
+            }, [c.sha, props.cwd]);
+            var effectiveBody = c.body;
+            var effectiveStat = c.stat;
+            if (!effectiveBody && !effectiveStat && fetchedDetail) {
+                effectiveStat = fetchedDetail;
+            }
+            return h("div", {
+                className: "dsh-github-modal-overlay",
+                onClick: props.onClose,
+                style: { zIndex: 100000 },
+            }, h("div", {
+                className: "dsh-github-modal-dialog",
+                style: { width: "94%", maxWidth: "460px", maxHeight: "84vh", display: "flex", flexDirection: "column", overflow: "hidden" },
+                onClick: function (e) { e.stopPropagation(); },
+            }, h("div", { className: "dsh-github-modal-header", style: { flexShrink: 0 } }, h("div", { style: { display: "flex", alignItems: "center", gap: "8px" } }, renderGitIcon(15, "#1296db"), h("h3", { style: { margin: 0, fontSize: "14px", fontWeight: 600 } }, "提交详情")), h("button", {
+                style: { background: "none", border: "none", cursor: "pointer", fontSize: "18px", color: "var(--dsw-alias-label-secondary, #656d76)", padding: "0 4px" },
+                onClick: props.onClose,
+                title: "关闭 (Esc)",
+            }, "✕")), h("div", {
+                className: "dsh-github-modal-body",
+                style: { padding: "16px", overflowY: "auto", flex: 1, minHeight: 0, display: "flex", flexDirection: "column", gap: "12px", boxSizing: "border-box" },
+            }, h("div", { style: { display: "flex", justifyContent: "space-between", alignItems: "center", fontSize: "11px", opacity: 0.85 } }, h("span", { style: { fontFamily: "monospace", fontWeight: 600, userSelect: "all" }, title: "完整 SHA: " + (c.fullSha || c.sha) }, c.fullSha || c.sha), h("span", null, c.relative)), h("div", { style: { fontSize: "13px", fontWeight: 600, color: "var(--dsw-alias-label-primary, #1f2328)", wordBreak: "break-word", lineHeight: "1.45" } }, c.subject), h("div", { style: { fontSize: "11px", color: "var(--dsw-alias-label-secondary, #656d76)" } }, `提交者: ${c.author}${c.email ? ` <${c.email}>` : ""}${c.date ? ` · ${c.date}` : ""}`), effectiveBody
+                ? h("div", {
+                    style: {
+                        fontSize: "12px",
+                        lineHeight: "1.6",
+                        whiteSpace: "pre-wrap",
+                        wordBreak: "break-word",
+                        padding: "10px 12px",
+                        borderRadius: "6px",
+                        background: "var(--dsw-alias-bg-module-platform, #f6f8fa)",
+                        border: "1px solid var(--dsw-alias-border-l2, #e1e4e8)",
+                    },
+                }, effectiveBody)
+                : null, effectiveStat
+                ? h("div", null, h("div", { style: { fontSize: "11px", fontWeight: 600, marginBottom: "4px", opacity: 0.8 } }, "📁 文件变更统计:"), h("pre", {
+                    className: "dsh-github-commit-pre",
+                    style: {
+                        fontSize: "11px",
+                        lineHeight: "1.5",
+                        whiteSpace: "pre-wrap",
+                        wordBreak: "break-word",
+                        margin: 0,
+                        maxHeight: "34vh",
+                        overflowY: "auto",
+                        padding: "8px 10px",
+                        borderRadius: "6px",
+                        background: "var(--dsw-alias-bg-module-platform, #f6f8fa)",
+                        border: "1px solid var(--dsw-alias-border-l2, #e1e4e8)",
+                    },
+                }, effectiveStat))
+                : null, !effectiveBody && !effectiveStat
+                ? (fetchingDetail
+                    ? h("div", { style: { fontSize: "12px", opacity: 0.7, padding: "8px 0" } }, "⏳ 正在获取详细变更说明…")
+                    : h("div", { style: { fontSize: "11px", opacity: 0.6, fontStyle: "italic", padding: "6px 0" } }, "（该提交未包含多行正文；重启 DSH 桌面端可同步最新格式并直接呈现变更统计）"))
+                : null)));
+        }
+        // 全景驾驶舱「⚙️ 设置」模态弹窗组件：左侧分区导航（数据同步 / 网络代理 / 更新设置 / 关于）+ 右侧内容区。
         // 为什么改多分区：弹窗承载能力从单一「同步偏好」扩展为多项插件设置（后续可继续加），
         // 单页滚动堆叠会让用户找不到入口；分区导航让每项设置拥有独立心智空间与保存动作。
+        // initialSection：宿主可指定初始分区——插件徽标点击时直开「关于」，单独展示身份信息。
         function GlobalSyncSettingsModal(props) {
             if (!props.isOpen)
                 return null;
-            // ---- 当前激活分区：sync（数据同步）/ proxy（网络代理）----
-            var [activeSection, setActiveSection] = React.useState("sync");
+            // ---- 当前激活分区：sync / proxy / update / about ----
+            var [activeSection, setActiveSection] = React.useState(props.initialSection || "sync");
             var [strategy, setStrategy] = React.useState(props.currentSettings.strategy || "swr");
             var [cacheMeta, setCacheMeta] = React.useState(getCacheStorageMeta());
             var [clearTip, setClearTip] = React.useState("");
+            // ---- 更新设置分区状态 ----
+            // 打开弹窗时从后端拉取真实模式（权威源是 update-settings.json 而非 localStorage），
+            // 与代理分区同范式：避免多窗口/外部手改文件导致 UI 与实际生效配置漂移。
+            var [updateMode, setUpdateMode] = React.useState("official");
+            var [updateBusy, setUpdateBusy] = React.useState(false);
+            var [updateMsg, setUpdateMsg] = React.useState(null);
+            // ---- 关于分区：当前运行版本号（弹窗打开时轻量拉取，失败静默回落占位）----
+            var [aboutVersion, setAboutVersion] = React.useState(null);
+            React.useEffect(function () {
+                if (!props.isOpen)
+                    return;
+                fetch("/api/github/update-settings")
+                    .then(function (r) { return r.json(); })
+                    .then(function (j) {
+                    if (j && j.ok && j.data && j.data.mode) {
+                        setUpdateMode(j.data.mode);
+                    }
+                })
+                    .catch(function () { });
+                // 版本号：check-update 命中 24h 缓存时零成本；失败静默（关于页显示占位版本）
+                fetch("/api/github/check-update")
+                    .then(function (r) { return r.json(); })
+                    .then(function (j) {
+                    if (j && j.ok && j.data && j.data.currentVersion)
+                        setAboutVersion(j.data.currentVersion);
+                })
+                    .catch(function () { });
+            }, [props.isOpen]);
             // ---- 网络代理分区状态 ----
             // 打开弹窗时从后端拉取真实代理状态（权威源是 proxy.json 而非 localStorage），
             // 避免多窗口/外部手改文件导致的 UI 与实际生效配置漂移。
@@ -1960,6 +2728,55 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 window.addEventListener("keydown", onKeyDown);
                 return function () { window.removeEventListener("keydown", onKeyDown); };
             }, [props.onClose]);
+            // initialSection 同步：弹窗实例常驻（return null 在 hooks 后，不卸载），
+            // useState 初值只在首挂载取一次——宿主切换入口重开时（如齿轮→关→徽标），
+            // 必须显式把 activeSection 对齐到新的 initialSection，否则停留在旧分区。
+            React.useEffect(function () {
+                if (props.isOpen && props.initialSection) {
+                    setActiveSection(props.initialSection);
+                }
+            }, [props.isOpen, props.initialSection]);
+            // 更新源保存：POST 后端（写盘 + 热切换 checker + 立即用新源真探）。
+            // 返回的 probe 结果如实展示：探测失败提示网络问题而非假报「已生效无异常」。
+            var handleUpdateSave = function () {
+                setUpdateBusy(true);
+                setUpdateMsg(null);
+                fetch("/api/github/update-settings", {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify({ mode: updateMode }),
+                })
+                    .then(function (r) { return r.json(); })
+                    .then(function (j) {
+                    setUpdateBusy(false);
+                    if (j && j.ok && j.data) {
+                        var d = j.data;
+                        var text = "";
+                        if (d.mode === "off") {
+                            text = "✅ 已关闭自动检查更新（/gh upgrade 与一键升级仍可用），无需重启";
+                        }
+                        else if (d.probe && d.probe.latestVersion) {
+                            text = "✅ 已切换至" + d.description + "，当前最新版本 v" + d.probe.latestVersion
+                                + (d.probe.hasUpdate ? "（有可用更新）" : "（已是最新）") + "，无需重启";
+                        }
+                        else {
+                            // 探测失败如实告知：设置已生效但新源暂不可达（可能是网络或源同步问题）
+                            text = "✅ 已切换至" + d.description + "，但新源暂时不可达（版本探测失败，稍后会自动重试）；设置已生效，无需重启";
+                        }
+                        if (d.persisted === false) {
+                            text += "；⚠️ 设置写盘失败，重启后需重新选择";
+                        }
+                        setUpdateMsg({ kind: "ok", text: text });
+                    }
+                    else {
+                        setUpdateMsg({ kind: "err", text: (j && j.message) || "保存失败" });
+                    }
+                })
+                    .catch(function (e) {
+                    setUpdateBusy(false);
+                    setUpdateMsg({ kind: "err", text: "网络请求失败: " + (e && e.message ? e.message : e) });
+                });
+            };
             var h = React.createElement;
             var handleSave = function () {
                 var updated = {
@@ -2051,7 +2868,13 @@ body[data-ds-dark-theme] .dsh-github-radio {
             }, "🔄 数据同步"), 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("button", {
+                className: "dsh-github-settings-nav-item" + (activeSection === "update" ? " active" : ""),
+                onClick: function () { setActiveSection("update"); },
+            }, "⬆️ 更新设置"), h("button", {
+                className: "dsh-github-settings-nav-item" + (activeSection === "about" ? " active" : ""),
+                onClick: function () { setActiveSection("about"); },
+            }, "ℹ️ 关于")), 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 秒开
@@ -2076,7 +2899,63 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 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, 
+            }, "🗑️ 清空缓存") : null), clearTip ? h("div", { style: { color: "var(--dsw-alias-state-success, #2ea043)", marginTop: "4px", fontWeight: 500 } }, clearTip) : null)) : activeSection === "update" ? h("div", null, 
+            // ⬆️ 更新设置分区：选择版本检测的 npm 源（或关闭自动检查）。
+            // 检测与升级流量均遵循「🌐 网络代理」分区设置——代理是全局的。
+            h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginBottom: "14px", lineHeight: "1.5" } }, "选择插件新版本检测所用的 npm 源。检测与升级流量均遵循「🌐 网络代理」分区设置：启用 http/https 代理时自动经代理访问；socks5 代理下 npm 检测为直连（gh 与升级子进程链路仍走代理）。无论选择哪个源，安装与升级流程本身不受影响。"), h("div", { style: { marginBottom: "16px" } }, h("div", { style: { fontSize: "13px", fontWeight: 600, marginBottom: "8px" } }, "更新源"), 
+            // 源 A: npm 官方（默认）
+            h("div", {
+                className: "dsh-github-radio-card" + (updateMode === "official" ? " active" : ""),
+                onClick: function () { setUpdateMode("official"); },
+            }, h("input", { type: "radio", className: "dsh-github-radio", checked: updateMode === "official", readOnly: true }), h("div", null, h("div", { style: { fontWeight: 600, fontSize: "13px" } }, "🌍 npm 官方源 (推荐)"), h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginTop: "2px" } }, "版本全球首发最及时，刚发布的新版立即可见；国内直连可能较慢。"))), 
+            // 源 B: 国内镜像
+            h("div", {
+                className: "dsh-github-radio-card" + (updateMode === "mirror" ? " active" : ""),
+                onClick: function () { setUpdateMode("mirror"); },
+            }, h("input", { type: "radio", className: "dsh-github-radio", checked: updateMode === "mirror", readOnly: true }), h("div", null, h("div", { style: { fontWeight: 600, fontSize: "13px" } }, "🇨🇳 国内镜像 (npmmirror)"), h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginTop: "2px" } }, "阿里云镜像，国内访问快；同步存在分钟级延迟，刚发布的新版可能暂时查不到。"))), 
+            // 源 C: 不检查更新
+            h("div", {
+                className: "dsh-github-radio-card" + (updateMode === "off" ? " active" : ""),
+                onClick: function () { setUpdateMode("off"); },
+            }, h("input", { type: "radio", className: "dsh-github-radio", checked: updateMode === "off", readOnly: true }), h("div", null, h("div", { style: { fontWeight: 600, fontSize: "13px" } }, "⛔ 不检查更新"), h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginTop: "2px" } }, "关闭自动检查与新版提示横幅；/gh upgrade 命令与一键升级仍然可用。")))), 
+            // 保存按钮 + 结果反馈（按钮复用 star-btn 的双主题链接色样式：内联色
+            // 会覆盖 btn-sm 暗色规则，且暗色下亮蓝底刺眼——与关于页修复同源）
+            h("div", { style: { display: "flex", alignItems: "center", gap: "8px", flexWrap: "wrap" } }, h("button", {
+                className: "dsh-github-btn-sm dsh-github-primary-btn",
+                disabled: updateBusy,
+                onClick: handleUpdateSave,
+            }, updateBusy ? "验证中..." : "💾 保存并全局应用"), updateMsg ? h("span", {
+                style: {
+                    fontSize: "12px",
+                    lineHeight: "1.5",
+                    color: updateMsg.kind === "ok"
+                        ? "var(--dsw-alias-state-success, #2ea043)"
+                        : updateMsg.kind === "err"
+                            ? "var(--dsw-alias-state-error-primary, #cf222e)"
+                            : "var(--dsw-alias-label-secondary, #656d76)",
+                },
+            }, updateMsg.text) : null)) : activeSection === "about" ? h("div", null, 
+            // ℹ️ 关于分区：项目信息/仓库地址/开源协议/求 Star。纯静态展示，零状态零请求。
+            h("div", { style: { display: "flex", alignItems: "center", gap: "10px", marginBottom: "14px" } }, renderOctocatBadge(40), h("div", null, h("div", { style: { fontSize: "15px", fontWeight: 600 } }, "DSH GitHub Flow"), h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginTop: "2px" } }, "当前版本: v" + (aboutVersion || "…")))), h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginBottom: "14px", lineHeight: "1.6" } }, "让 DeepSeek Harness Agent 拥有操作 GitHub 的原生手脚。原生复用宿主机 gh CLI 安全凭据，深度打通本地 Git 工作区与云端协作，提供 9 大领域 Agent 工具、人类 Slash 指令、Web 全景驾驶舱与一键跨平台升级。"), 
+            // 信息条目
+            h("div", { style: { display: "flex", flexDirection: "column", gap: "8px", marginBottom: "14px" } }, h("div", { style: { display: "flex", alignItems: "center", gap: "8px", fontSize: "12px" } }, h("span", { style: { minWidth: "64px", color: "var(--dsw-alias-label-secondary, #656d76)" } }, "仓库地址"), h("a", { href: "https://github.com/ItQianChen/dsh-github-flow", target: "_blank", rel: "noopener noreferrer", style: { color: "var(--dsw-alias-link, #0969da)" } }, "github.com/ItQianChen/dsh-github-flow")), h("div", { style: { display: "flex", alignItems: "center", gap: "8px", fontSize: "12px" } }, h("span", { style: { minWidth: "64px", color: "var(--dsw-alias-label-secondary, #656d76)" } }, "npm 包"), h("a", { href: "https://www.npmjs.com/package/dsh-github-flow", target: "_blank", rel: "noopener noreferrer", style: { color: "var(--dsw-alias-link, #0969da)" } }, "npmjs.com/package/dsh-github-flow")), h("div", { style: { display: "flex", alignItems: "center", gap: "8px", fontSize: "12px" } }, h("span", { style: { minWidth: "64px", color: "var(--dsw-alias-label-secondary, #656d76)" } }, "开源协议"), h("a", { href: "https://github.com/ItQianChen/dsh-github-flow/blob/master/LICENSE", target: "_blank", rel: "noopener noreferrer", style: { color: "var(--dsw-alias-link, #0969da)" } }, "MIT License"))), 
+            // 求 Star 卡片
+            // 主题兼容：不用内联色——暗色主题的覆盖只能作用于 class 选择器；
+            // 且此前的 canvas-subtle/border-muted 并非宿主真实令牌（全项目无他处使用），
+            // 永远回落亮色值导致暗色下一块刺眼亮底。改用 cache-info-box 同款双主题 class。
+            h("div", {
+                className: "dsh-github-about-star-box",
+                style: {
+                    display: "flex",
+                    alignItems: "center",
+                    gap: "10px",
+                },
+            }, h("span", { style: { fontSize: "18px" } }, "⭐"), h("div", { style: { flex: 1, fontSize: "12px", lineHeight: "1.5" } }, "如果这个插件对你的日常研发有帮助，欢迎到 GitHub 仓库点个 Star 支持一下——你的 Star 是持续迭代的动力！也欢迎提交 Issue 与 PR。"), h("a", {
+                href: "https://github.com/ItQianChen/dsh-github-flow",
+                target: "_blank",
+                rel: "noopener noreferrer",
+                className: "dsh-github-btn-sm dsh-github-primary-btn",
+            }, "🌟 去点 Star"))) : 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", {
@@ -2137,8 +3016,8 @@ body[data-ds-dark-theme] .dsh-github-radio {
                             : "var(--dsw-alias-label-secondary, #656d76)",
                 },
             }, proxyMsg.text) : null))), 
-            // 底部操作条：sync 分区提供主保存动作；proxy 分区有自己的「保存并全局应用」，
-            // 底部统一为「完成」关闭弹窗，避免两个保存按钮的语义冲突。
+            // 底部操作条：sync 分区提供主保存动作；proxy/update 分区有自己的「保存并全局应用」，
+            // 底部统一为「完成」关闭弹窗，避免多个保存按钮的语义冲突。
             h("div", { className: "dsh-github-modal-footer" }, activeSection === "sync" ? h("button", {
                 className: "dsh-github-btn-sm",
                 style: {
@@ -2164,7 +3043,10 @@ body[data-ds-dark-theme] .dsh-github-radio {
             var [loading, setLoading] = React.useState(!initialSnapshot);
             var [syncStatus, setSyncStatus] = React.useState(initialSnapshot ? "cached" : "loading");
             var [lastSyncedAt, setLastSyncedAt] = React.useState(initialSnapshot?.savedAt || 0);
+            // 弹窗开闭 + 初始分区分离：插件徽标点击直开「关于」分区（initialSection=about），
+            // 而齿轮按钮仍默认打开「数据同步」——同一弹窗两种入口语义。
             var [isSettingsModalOpen, setIsSettingsModalOpen] = React.useState(false);
+            var [settingsInitialSection, setSettingsInitialSection] = React.useState("sync");
             var [error, setError] = React.useState(null);
             var [updateInfo, setUpdateInfo] = React.useState(null);
             var [activeTab, setActiveTab] = React.useState("workspaces"); // 'workspaces' | 'repos' | 'mywork'
@@ -2187,10 +3069,9 @@ body[data-ds-dark-theme] .dsh-github-radio {
                     .catch(function () { });
             }, []);
             React.useEffect(function () { refreshProxyBadge(); }, [refreshProxyBadge]);
-            // gh 业务数据就绪后，闲时 1.5 秒异步静默检测升级，绝不影响首屏
+            // 检查更新与 gh 业务数据零依赖，挂载即并行发起（与右侧栏同策略）：
+            // 并发由服务端 inFlightPromise + 24h 缓存合流去重，无请求风暴风险。
             React.useEffect(() => {
-                if (!data)
-                    return;
                 var timer = setTimeout(function () {
                     fetch("/api/github/check-update")
                         .then(function (res) { return res.json(); })
@@ -2200,9 +3081,31 @@ body[data-ds-dark-theme] .dsh-github-radio {
                         }
                     })
                         .catch(function () { });
-                }, 1500);
+                }, 300);
                 return function () { clearTimeout(timer); };
-            }, [data]);
+            }, []);
+            // 插件徽标事件：标题上的「插件」徽标点击 → 直开设置弹窗的「关于」分区。
+            // 可见性守卫：右侧栏与主页可能同挂载，只有自身容器可见的宿主响应（防双层弹窗）。
+            var panelRef = React.useRef(null);
+            React.useEffect(() => {
+                var onOpenAbout = () => {
+                    var el = panelRef.current;
+                    if (!el)
+                        return;
+                    var rect = el.getBoundingClientRect();
+                    if (rect.width > 0 && rect.height > 0) {
+                        setSettingsInitialSection("about");
+                        setIsSettingsModalOpen(true);
+                    }
+                };
+                window.addEventListener("dsh-github-open-about", onOpenAbout);
+                return () => window.removeEventListener("dsh-github-open-about", onOpenAbout);
+            }, []);
+            // 齿轮按钮：默认打开「数据同步」分区（既有语义不变）
+            var openSettingsDefault = () => {
+                setSettingsInitialSection("sync");
+                setIsSettingsModalOpen(true);
+            };
             var loadData = React.useCallback(async (forceRefresh = false) => {
                 // 如果是纯手动模式，且非显式强制刷新，且本地已有旧数据，直接跳过后台拉取
                 if (!forceRefresh && syncSettings.strategy === "manual" && data) {
@@ -2215,8 +3118,10 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 var timedOut = false;
                 var timer = setTimeout(function () { timedOut = true; controller.abort(); }, 45000);
                 try {
+                    // refresh 预置请求必须共享同一 signal：它一旦挂起（如系统代理劫持回环请求），
+                    // 后续 overview fetch 永远执行不到，loading 永不清除——无 gh 用户正是被此卡死。
                     if (forceRefresh)
-                        await fetch("/api/github/refresh", { method: "POST" }).catch(() => { });
+                        await fetch("/api/github/refresh", { method: "POST", signal: controller.signal }).catch(() => { });
                     var res = await fetch("/api/github/global-overview", { signal: controller.signal });
                     if (!res.ok) {
                         var errText = await res.text().catch(() => "");
@@ -2259,7 +3164,7 @@ body[data-ds-dark-theme] .dsh-github-radio {
                     }
                     else {
                         if (timedOut || err.name === "AbortError") {
-                            setError("获取超时（30 秒）：本机 gh 命令响应过慢，通常是网络或工作区数量较多所致。可稍后重试，或减少同时打开的工作区。");
+                            setError("获取超时（45 秒）：本机 gh 命令响应过慢或网络代理劫持了回环请求。可稍后重试，或在「⚙️ 设置 → 🌐 网络代理」确认代理已放行 127.0.0.1。");
                         }
                         else {
                             setError("无法连接后端服务：" + (err.message || err));
@@ -2303,7 +3208,7 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 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(SyncStatusBadge, { syncStatus, lastSyncedAt }), 
+            var headerEl = h("div", { className: "dsh-github-header" }, h("div", { className: "dsh-github-title" }, renderOctocatBadge(32), h("h2", null, "GitHub 全景驾驶舱"), renderPluginBadge(h), h(SyncStatusBadge, { syncStatus, lastSyncedAt }), 
             // 代理生效徽章：启用时可见，hover 展示代理地址，让用户随时确认「当前确实在走代理」
             proxyActive && proxyActive.enabled
                 ? h("span", {
@@ -2328,12 +3233,12 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 disabled: loading,
             }, loading ? "同步中..." : "🔄 刷新全局数据"), h("button", {
                 className: "dsh-github-btn-sm",
-                onClick: () => setIsSettingsModalOpen(true),
-                title: "配置数据同步节奏、本地缓存与网络代理",
+                onClick: openSettingsDefault,
+                title: "配置数据同步节奏、本地缓存、网络代理与插件信息",
                 style: { padding: "6px 12px" },
             }, "⚙️ 设置")));
             if (loading && !data) {
-                return h("div", { className: "dsh-github-panel" }, headerEl, h("div", { className: "dsh-github-empty" }, "正在加载全局 GitHub 账号与工作区数据..."));
+                return h("div", { className: "dsh-github-panel", ref: panelRef }, headerEl, h("div", { className: "dsh-github-empty" }, "正在加载全局 GitHub 账号与工作区数据..."));
             }
             var effectiveUpdateInfo = updateInfo || data?.updateInfo;
             var upgradeBannerEl = effectiveUpdateInfo && effectiveUpdateInfo.hasUpdate
@@ -2341,6 +3246,7 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 : null;
             var settingsModalEl = h(GlobalSyncSettingsModal, {
                 isOpen: isSettingsModalOpen,
+                initialSection: settingsInitialSection,
                 onClose: () => {
                     setIsSettingsModalOpen(false);
                     // 弹窗内可能刚保存过代理配置，关闭时同步刷新标题栏徽章
@@ -2358,7 +3264,7 @@ body[data-ds-dark-theme] .dsh-github-radio {
             });
             // 错误拦截阻断：若无本地数据且请求失败，直接呈现错误卡片，杜绝把接口异常伪装成「未安装 CLI」
             if (!data && error) {
-                return h("div", { className: "dsh-github-panel" }, headerEl, upgradeBannerEl, h("div", {
+                return h("div", { className: "dsh-github-panel", ref: panelRef }, headerEl, upgradeBannerEl, h("div", {
                     style: {
                         padding: "24px",
                         borderRadius: "8px",
@@ -2388,7 +3294,12 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 ? h("span", { className: "dsh-github-badge dsh-badge-green" }, "Active")
                 : !auth?.installed
                     ? h("span", { className: "dsh-github-badge dsh-badge-red" }, "Missing")
-                    : h("span", { className: "dsh-github-badge dsh-badge-yellow" }, "Required"))), h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title" }, "账号云端仓库"), h("div", { className: "dsh-github-card-value" }, `${userRepos.length} 个 Repositories`)), h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title" }, "本地工作区联动"), h("div", { className: "dsh-github-card-value" }, `${workspaceMatrix.length} 个工作区 (${workspaceMatrix.filter((w) => w.repo).length} 个已关联)`)));
+                    : h("span", { className: "dsh-github-badge dsh-badge-yellow" }, "Required"))), h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title" }, "账号云端仓库"), h("div", { className: "dsh-github-card-value" }, `${userRepos.length} 个 Repositories`)), h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title" }, "本地工作区联动"), h("div", { className: "dsh-github-card-value" }, `${workspaceMatrix.length} 个工作区 (${workspaceMatrix.filter((w) => w.repo).length} 个已关联)`)), 
+            // 待办概览卡：issueStats 三分类（数据已有零成本）——第一屏直接呈现工作量，
+            // 无待办时正向反馈「无待办 ✓」而非空白
+            h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title" }, "📥 待处理 Issues"), (data && data.issueStats && (data.issueStats.reported || data.issueStats.assigned || data.issueStats.created))
+                ? h("div", { className: "dsh-github-card-value", style: { fontSize: "14px" } }, `📥 用户提单 ${data.issueStats.reported || 0} · 🎯 分配给我 ${data.issueStats.assigned || 0} · ✍️ 我创建 ${data.issueStats.created || 0}`)
+                : h("div", { className: "dsh-github-card-value" }, "无待办 ✓")));
             // 安装与登录引导组件（未登录或未安装时显式展开）
             var authGuideEl = !auth?.loggedIn
                 ? h(AuthGuideCard, { auth, onRefresh: () => loadData(true), isRightbar: false })
@@ -2400,7 +3311,22 @@ body[data-ds-dark-theme] .dsh-github-radio {
             if (activeTab === 'workspaces') {
                 contentEl = h("div", { className: "dsh-github-list" }, workspaceMatrix.map((ws) => h("div", { key: ws.id, className: "dsh-github-card dsh-github-workspace-card" }, h("div", { style: { display: "flex", flexDirection: "column", gap: "4px" } }, h("div", { className: "dsh-github-ws-title" }, ws.title), h("div", { className: "dsh-github-ws-path" }, ws.path), h("div", { style: { fontSize: "12px", marginTop: "4px", display: "flex", gap: "8px", alignItems: "center" } }, ws.repo
                     ? h("span", { className: "dsh-github-ws-repo-link" }, renderOctocat(13, "currentColor"), `关联远程: ${ws.repo.nameWithOwner} (${ws.repo.defaultBranch})`)
-                    : h("span", { className: "dsh-github-ws-path" }, ws.hasGit ? "本地有 Git，未关联 GitHub 远程" : "本地无 Git 仓库"), ws.repo ? h("span", { className: "dsh-github-badge dsh-badge-green" }, "已关联") : null)), h("div", { style: { display: "flex", gap: "8px" } }, ws.repo
+                    : h("span", { className: "dsh-github-ws-path" }, ws.hasGit ? "本地有 Git，未关联 GitHub 远程" : "本地无 Git 仓库"), ws.repo ? h("span", { className: "dsh-github-badge dsh-badge-green" }, "已关联") : null), 
+                // git 本地状态摘要（ahead/behind 快照语义 + dirty；探测失败/非 Git 不渲染）
+                ws.gitStatus
+                    ? h("div", {
+                        style: { fontSize: "11px", display: "flex", gap: "8px", alignItems: "center", opacity: 0.85 },
+                        title: "ahead/behind 相对上次 git fetch 的快照（非实时）",
+                    }, h("span", { style: { display: "inline-flex", alignItems: "center", gap: "4px" } }, renderGitIcon(12, "#1296db"), ws.gitStatus.branch), ws.gitStatus.hasUpstream
+                        ? h("span", null, `${ws.gitStatus.ahead > 0 ? "↑" + ws.gitStatus.ahead + " " : ""}${ws.gitStatus.behind > 0 ? "↓" + ws.gitStatus.behind : ""}${ws.gitStatus.ahead === 0 && ws.gitStatus.behind === 0 ? "✓ 同步" : ""}`)
+                        : h("span", null, "↑? ↓?"), ws.gitStatus.dirtyCount > 0
+                        ? h("span", null, `${ws.gitStatus.dirtyCount} 文件未提交`)
+                        : h("span", null, "干净"))
+                    : null, ws.gitStatus && ws.gitStatus.dirtyFiles && ws.gitStatus.dirtyFiles.length > 0
+                    ? h("details", { style: { fontSize: "11px" } }, h("summary", { style: { cursor: "pointer", opacity: 0.8 } }, `未提交清单（${ws.gitStatus.dirtyFiles.length}）`), h("div", { style: { padding: "4px 8px", borderRadius: "6px", background: "var(--dsw-alias-bg-module-platform, #f6f8fa)", lineHeight: "1.6", marginTop: "4px" } }, ws.gitStatus.dirtyFiles.map(function (f, i) {
+                        return h("div", { key: i }, h("span", { style: { opacity: 0.7, marginRight: "6px" } }, f.status === "??" ? "??" : f.status), f.path);
+                    })))
+                    : null), h("div", { style: { display: "flex", gap: "8px" } }, ws.repo
                     ? h("a", { className: "dsh-github-btn-sm", href: ws.repo.url, target: "_blank" }, "在 GitHub 打开")
                     : null))));
             }
@@ -2415,7 +3341,9 @@ body[data-ds-dark-theme] .dsh-github-radio {
                         placeholder: "🔍 搜索我的 GitHub 仓库...",
                         value: searchQuery,
                         onChange: (e) => setSearchQuery(e.target.value)
-                    }), h("div", { className: "dsh-github-list" }, filteredRepos.map((r) => h("div", { key: r.nameWithOwner, className: "dsh-github-item" }, h("a", { className: "dsh-github-item-title", href: r.url, target: "_blank" }, r.nameWithOwner), r.description ? h("div", { className: "dsh-github-item-desc" }, r.description) : null, h("div", { className: "dsh-github-item-meta" }, h("span", null, `默认分支: ${r.defaultBranch}`), r.isPrivate ? h("span", { className: "dsh-github-badge dsh-badge-yellow" }, "Private") : h("span", { className: "dsh-github-badge dsh-badge-green" }, "Public"), h("span", null, `⭐ ${r.stargazerCount}`))))));
+                    }), h("div", { className: "dsh-github-list" }, filteredRepos.map((r) => h("div", { key: r.nameWithOwner, className: "dsh-github-item" }, h("a", { className: "dsh-github-item-title", href: r.url, target: "_blank" }, r.nameWithOwner), r.description ? h("div", { className: "dsh-github-item-desc" }, r.description) : null, h("div", { className: "dsh-github-item-meta" }, h("span", null, `默认分支: ${r.defaultBranch}`), r.isPrivate ? h("span", { className: "dsh-github-badge dsh-badge-yellow" }, "Private") : h("span", { className: "dsh-github-badge dsh-badge-green" }, "Public"), h("span", null, `⭐ ${r.stargazerCount}`), formatRelativeTime(r.updatedAt)
+                        ? h("span", { title: `更新于 ${r.updatedAt}` }, `活跃于 ${formatRelativeTime(r.updatedAt)}`)
+                        : null)))));
                 }
             }
             else {
@@ -2448,7 +3376,14 @@ body[data-ds-dark-theme] .dsh-github-radio {
                         className: `dsh-github-pill-btn ${issueFilter === 'created' ? 'active' : ''}`,
                         onClick: () => setIssueFilter('created'),
                     }, `✍️ 我创建的 (${issueStats.created || 0})`));
-                    contentEl = h("div", null, h("h3", { className: "dsh-github-subheading" }, `🔀 我发起的 PR (${myPrs.length})`), myPrs.length === 0 ? h("div", { className: "dsh-github-empty", style: { marginBottom: "16px" } }, "暂无开放中的 PR") : h("div", { className: "dsh-github-list", style: { marginBottom: "16px" } }, myPrs.map((pr) => h("div", { key: pr.number, className: "dsh-github-item" }, h("a", { className: "dsh-github-item-title", href: pr.url, target: "_blank" }, `[${pr.repository?.nameWithOwner || 'Repo'}] #${pr.number} ${pr.title}`)))), h("h3", { className: "dsh-github-subheading" }, `📝 任务与待办 Issues (${filteredIssues.length})`), issuePillsEl, filteredIssues.length === 0 ? h("div", { className: "dsh-github-empty" }, "当前分类下暂无开放中的 Issue") : h("div", { className: "dsh-github-list" }, filteredIssues.map((is) => {
+                    contentEl = h("div", null, h("h3", { className: "dsh-github-subheading" }, `🔀 我发起的 PR (${myPrs.length})`), myPrs.length === 0 ? h("div", { className: "dsh-github-empty", style: { marginBottom: "16px" } }, "暂无开放中的 PR") : h("div", { className: "dsh-github-list", style: { marginBottom: "16px" } }, myPrs.map((pr) => h("div", { key: pr.number, className: "dsh-github-item", style: { display: "flex", alignItems: "center", gap: "8px", flexWrap: "wrap" } }, h("a", {
+                        className: "dsh-github-item-title",
+                        href: pr.url,
+                        target: "_blank",
+                        title: pr.updatedAt ? `更新于 ${pr.updatedAt}` : undefined,
+                    }, `${pr.isDraft ? "⚪ " : ""}[${pr.repository?.nameWithOwner || 'Repo'}] #${pr.number} ${pr.title}`), pr.isDraft ? h("span", { className: "dsh-github-badge dsh-badge-yellow" }, "DRAFT") : null, formatRelativeTime(pr.updatedAt)
+                        ? h("span", { style: { fontSize: "11px", color: "var(--dsw-alias-label-secondary, #656d76)", whiteSpace: "nowrap" } }, formatRelativeTime(pr.updatedAt))
+                        : null))), h("h3", { className: "dsh-github-subheading" }, `📝 任务与待办 Issues (${filteredIssues.length})`), issuePillsEl, filteredIssues.length === 0 ? h("div", { className: "dsh-github-empty" }, "当前分类下暂无开放中的 Issue") : h("div", { className: "dsh-github-list" }, filteredIssues.map((is) => {
                         var cats = is.categories || [];
                         var badges = [];
                         if (cats.includes("reported")) {
@@ -2468,7 +3403,7 @@ body[data-ds-dark-theme] .dsh-github-radio {
                     })));
                 }
             }
-            return h("div", { className: "dsh-github-panel" }, headerEl, upgradeBannerEl, errorEl, statsCardsEl, authGuideEl, tabsEl, contentEl, settingsModalEl);
+            return h("div", { className: "dsh-github-panel", ref: panelRef }, headerEl, upgradeBannerEl, errorEl, statsCardsEl, authGuideEl, tabsEl, contentEl, settingsModalEl);
         }
         var inject = ["slots", "sidebarRightTabs", "sessions", "layout", "theme"];
         function apply(ctx) {
@@ -2500,6 +3435,7 @@ body[data-ds-dark-theme] .dsh-github-radio {
                         id: "dsh-github-flow",
                         kind: "github",
                         priority: "plugin",
+                        // 标题保持简洁，身份由面板内徽标标注（Tab 体系不支持内嵌徽标元素）
                         title: () => "GitHub 仓库",
                         guide: [
                             {
@@ -2507,7 +3443,7 @@ body[data-ds-dark-theme] .dsh-github-radio {
                                 commandId: "workspace.github",
                                 order: 40,
                                 title: () => "GitHub 仓库",
-                                description: () => "查看与操作当前工作区目录下的 GitHub 仓库",
+                                description: () => "查看与操作当前工作区目录下的 GitHub 仓库（由 dsh-github-flow 插件提供）",
                                 icon: GithubArtwork,
                             },
                         ],