dsh-github-flow 0.2.0 → 0.2.1

package/lib/client.js

@@ -290,6 +290,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 +1092,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);
@@ -1106,6 +1179,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 +1241,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 +1307,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 +1326,8 @@ body[data-ds-dark-theme] .dsh-github-radio {
                         }
                     })
                         .catch(function () {
+                        clearTimeout(probeTimer);
+                        setToastMsg("❌ 检测超时或后端不可达，请稍后重试");
                         onRefresh();
                     });
                 },
@@ -1289,7 +1389,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 +1414,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 +1472,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 +1526,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 +1605,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) {
             var auth = data ? data.auth : null;
             var repo = data ? data.repo : null;
             var prs = (data && data.pullRequests) || [];
@@ -1485,11 +1615,19 @@ 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));
             // 仓库基础卡片
             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)
@@ -1776,10 +1914,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 +1927,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 +1941,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 +1962,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 +1993,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]);
@@ -1890,8 +2041,56 @@ 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 containerRef = React.useRef(null);
+            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), 
+            // 弹窗一：插件徽标触发的「关于」单页展示
+            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");
+                },
+            }));
         }
         // 2. 右侧栏 Tab 标题组件
         function GithubRightbarTitle() {
@@ -1907,22 +2106,51 @@ 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")));
         }
-        // 全景驾驶舱「⚙️ 设置」模态弹窗组件：左侧分区导航（数据同步 / 网络代理）+ 右侧内容区。
+        // 全景驾驶舱「⚙️ 设置」模态弹窗组件：左侧分区导航（数据同步 / 网络代理 / 更新设置 / 关于）+ 右侧内容区。
         // 为什么改多分区：弹窗承载能力从单一「同步偏好」扩展为多项插件设置（后续可继续加），
         // 单页滚动堆叠会让用户找不到入口；分区导航让每项设置拥有独立心智空间与保存动作。
+        // 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 +2188,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 +2328,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 +2359,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 +2476,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 +2503,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 +2529,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 +2541,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 +2578,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 +2624,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 +2668,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 +2693,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 +2706,7 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 : null;
             var settingsModalEl = h(GlobalSyncSettingsModal, {
                 isOpen: isSettingsModalOpen,
+                initialSection: settingsInitialSection,
                 onClose: () => {
                     setIsSettingsModalOpen(false);
                     // 弹窗内可能刚保存过代理配置，关闭时同步刷新标题栏徽章
@@ -2358,7 +2724,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",
@@ -2468,7 +2834,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 +2866,7 @@ body[data-ds-dark-theme] .dsh-github-radio {
                         id: "dsh-github-flow",
                         kind: "github",
                         priority: "plugin",
+                        // 标题保持简洁，身份由面板内徽标标注（Tab 体系不支持内嵌徽标元素）
                         title: () => "GitHub 仓库",
                         guide: [
                             {
@@ -2507,7 +2874,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,
                             },
                         ],