dsh-github-flow 0.1.8 → 0.2.1

package/lib/client.js

@@ -5,6 +5,10 @@ window.__ModuleLoader__.load({
         var exports = module.exports;
         Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
         var React = require("react");
+        // 面板样式（内联维护）：DSH 客户端加载器以经典脚本语义执行本产物（build.mjs 剥除
+        // export 声明即为佐证），模块级 import 在该语境是 SyntaxError。曾尝试把 CSS 拆为
+        // 独立模块经 import 引入，导致 DSH 重启时客户端加载崩溃并触发插件批量卸载——
+        // 已回滚。样式与组件的分离改由「同文件内分区注释」维持，不再跨文件。
         var GITHUB_PANEL_CSS = `
 /* ==========================================================================
    DSH GitHub Flow - 主题自适应样式系统 (Light / Dark 动态联动)
@@ -286,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;
@@ -805,7 +843,7 @@ body[data-ds-dark-theme] .dsh-github-steps-list {
   line-height: 1.4;
 }
 
-/* 16. 数据同步设置弹窗 (Sync Settings Modal) */
+/* 16. 设置弹窗 (Settings Modal)：左侧分区导航 + 右侧内容区 */
 .dsh-github-modal-overlay {
   position: fixed;
   top: 0;
@@ -820,14 +858,18 @@ body[data-ds-dark-theme] .dsh-github-steps-list {
   backdrop-filter: blur(2px);
 }
 .dsh-github-modal-dialog {
-  width: 90%;
-  max-width: 480px;
+  width: 92%;
+  max-width: 640px;
+  max-height: 86vh;
+  display: flex;
+  flex-direction: column;
   background: var(--dsw-alias-bg-base, #ffffff);
   border: 1px solid var(--dsw-alias-border-l2, #d0d7de);
   border-radius: 12px;
   box-shadow: 0 16px 32px rgba(0, 0, 0, 0.18);
-  padding: 24px;
+  padding: 0;
   box-sizing: border-box;
+  overflow: hidden;
   color: var(--dsw-alias-label-primary, #1f2328);
   font-family: var(--dsw-font-family, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif);
 }
@@ -836,6 +878,105 @@ body[data-ds-dark-theme] .dsh-github-modal-dialog {
   border-color: var(--dsw-alias-border-l1, #30363d);
   box-shadow: 0 16px 36px rgba(0, 0, 0, 0.45);
 }
+/* 弹窗头部（标题 + 关闭） */
+.dsh-github-modal-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 18px 22px 14px;
+  border-bottom: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  flex-shrink: 0;
+}
+body[data-ds-dark-theme] .dsh-github-modal-header {
+  border-bottom-color: var(--dsw-alias-border-l1, #30363d);
+}
+/* 分区导航 + 内容 双栏骨架：窄屏（<560px）自动折叠为顶部横向页签 */
+.dsh-github-modal-body {
+  display: flex;
+  min-height: 0;
+  flex: 1;
+}
+.dsh-github-settings-nav {
+  flex-shrink: 0;
+  width: 148px;
+  padding: 14px 10px;
+  border-right: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  box-sizing: border-box;
+}
+body[data-ds-dark-theme] .dsh-github-settings-nav {
+  border-right-color: var(--dsw-alias-border-l1, #30363d);
+}
+.dsh-github-settings-nav-item {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 10px;
+  border-radius: 6px;
+  border: none;
+  background: none;
+  cursor: pointer;
+  font-size: 13px;
+  text-align: left;
+  color: var(--dsw-alias-label-secondary, #656d76);
+  transition: background 0.12s ease, color 0.12s ease;
+}
+.dsh-github-settings-nav-item:hover {
+  background: var(--dsw-alias-bg-layer-1, #f6f8fa);
+  color: var(--dsw-alias-label-primary, #1f2328);
+}
+.dsh-github-settings-nav-item.active {
+  background: rgba(9, 105, 218, 0.1);
+  color: var(--dsw-alias-link, #0969da);
+  font-weight: 600;
+}
+body[data-ds-dark-theme] .dsh-github-settings-nav-item:hover {
+  background: rgba(240, 246, 252, 0.06);
+  color: var(--dsw-alias-label-primary, #f0f6fc);
+}
+body[data-ds-dark-theme] .dsh-github-settings-nav-item.active {
+  background: rgba(88, 166, 255, 0.15);
+  color: #58a6ff;
+}
+.dsh-github-settings-content {
+  flex: 1;
+  min-width: 0;
+  padding: 18px 22px 20px;
+  overflow-y: auto;
+  box-sizing: border-box;
+}
+@media (max-width: 560px) {
+  .dsh-github-modal-body {
+    flex-direction: column;
+  }
+  .dsh-github-settings-nav {
+    width: 100%;
+    flex-direction: row;
+    border-right: none;
+    border-bottom: 1px solid var(--dsw-alias-border-l2, #d0d7e0);
+    overflow-x: auto;
+  }
+  body[data-ds-dark-theme] .dsh-github-settings-nav {
+    border-bottom-color: var(--dsw-alias-border-l1, #30363d);
+  }
+  .dsh-github-settings-nav-item {
+    white-space: nowrap;
+  }
+}
+/* 弹窗底部操作条 */
+.dsh-github-modal-footer {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+  padding: 14px 22px;
+  border-top: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  flex-shrink: 0;
+}
+body[data-ds-dark-theme] .dsh-github-modal-footer {
+  border-top-color: var(--dsw-alias-border-l1, #30363d);
+}
 .dsh-github-radio-card {
   display: flex;
   align-items: flex-start;
@@ -903,6 +1044,37 @@ body[data-ds-dark-theme] .dsh-github-select option {
   color: #f0f6fc;
 }
 
+/* 代理设置弹窗的文本输入框（浅色/深色双模式，设计变量对齐 select 保持视觉一致） */
+.dsh-github-input {
+  padding: 7px 12px;
+  border-radius: 6px;
+  border: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+  background: var(--dsw-alias-bg-base, #ffffff);
+  color: var(--dsw-alias-label-primary, #1f2328);
+  font-size: 13px;
+  outline: none;
+  box-sizing: border-box;
+  color-scheme: light;
+  transition: border-color 0.15s ease, box-shadow 0.15s ease;
+}
+.dsh-github-input:focus {
+  border-color: var(--dsw-alias-link, #0969da);
+  box-shadow: 0 0 0 3px rgba(9, 105, 218, 0.15);
+}
+.dsh-github-input::placeholder {
+  color: var(--dsw-alias-label-tertiary, #8c959f);
+}
+body[data-ds-dark-theme] .dsh-github-input {
+  border-color: var(--dsw-alias-border-l1, #30363d);
+  background: var(--dsw-alias-bg-layer-2, #1e1e22);
+  color: var(--dsw-alias-label-primary, #f0f6fc);
+  color-scheme: dark;
+}
+body[data-ds-dark-theme] .dsh-github-input:focus {
+  border-color: #58a6ff;
+  box-shadow: 0 0 0 3px rgba(88, 166, 255, 0.2);
+}
+
 /* 缓存信息展示框 */
 .dsh-github-cache-info-box {
   padding: 10px 12px;
@@ -920,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);
@@ -968,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;
@@ -1012,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);
@@ -1076,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();
@@ -1090,6 +1326,8 @@ body[data-ds-dark-theme] .dsh-github-radio {
                         }
                     })
                         .catch(function () {
+                        clearTimeout(probeTimer);
+                        setToastMsg("❌ 检测超时或后端不可达，请稍后重试");
                         onRefresh();
                     });
                 },
@@ -1151,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) {
@@ -1167,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);
@@ -1223,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. 全景驾驶舱大面板横幅模式
@@ -1267,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" },
@@ -1337,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) || [];
@@ -1347,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)
@@ -1463,9 +1739,12 @@ body[data-ds-dark-theme] .dsh-github-radio {
         // 全局持久化缓存与偏好配置键名
         var GLOBAL_OVERVIEW_CACHE_KEY = "dsh_github_global_overview_snapshot_v1";
         var SYNC_SETTINGS_STORAGE_KEY = "dsh_github_sync_settings_v1";
+        // 同步策略收敛为两态：'swr'（打开秒开旧数据+后台静默拉新）| 'manual'（仅手动刷新）。
+        // 旧的第三态 'interval'（前端 setInterval 轮询）已删除：浏览器对后台标签页节流
+        // 定时器、组件卸载即销毁，该模式在真实环境几乎从不按承诺工作（停留短于间隔则
+        // 永不触发）；其「打开即新鲜」的诉求由 SWR 挂载自愈覆盖，「持续同步」点刷新即可。
         var DEFAULT_SYNC_SETTINGS = {
-            strategy: "swr", // 'swr' (秒开展示旧数据，后台静默拉取) | 'manual' (仅手动刷新) | 'interval' (定时轮询)
-            intervalMs: 300000, // 默认 5 分钟 (300,000ms)
+            strategy: "swr", // 'swr' | 'manual'
         };
         function getLocalSyncSettings() {
             try {
@@ -1473,7 +1752,14 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 if (!raw)
                     return DEFAULT_SYNC_SETTINGS;
                 var parsed = JSON.parse(raw);
-                return Object.assign({}, DEFAULT_SYNC_SETTINGS, parsed);
+                var merged = Object.assign({}, DEFAULT_SYNC_SETTINGS, parsed);
+                // 旧版本迁移：曾选过 'interval' 的用户自动回落 SWR（最接近原意图），
+                // 并立即覆写存储防止每次读取都走迁移分支。
+                if (merged.strategy === "interval") {
+                    merged.strategy = "swr";
+                    saveLocalSyncSettings(merged);
+                }
+                return merged;
             }
             catch (e) {
                 return DEFAULT_SYNC_SETTINGS;
@@ -1628,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(); })
@@ -1641,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)」，且非用户点击强制刷新，且本地已有数据，坚决不打后台网络！
@@ -1655,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 = [];
@@ -1670,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}`;
@@ -1701,17 +1993,26 @@ 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]);
-            // 挂载与策略调度：与主页规则 100% 保持一致
+            // 挂载与策略调度：与主页规则 100% 保持一致。
+            // SWR 分支不判 data：挂载 300ms 后台静默拉新，昨天的持久化快照当场自愈——
+            // 「打开就能看到最新」是 SWR 的定义，不依赖用户停留时长。
             React.useEffect(() => {
                 if (syncSettings.strategy === "swr") {
                     var timer = setTimeout(function () { loadData(false); }, 300);
@@ -1721,15 +2022,8 @@ body[data-ds-dark-theme] .dsh-github-radio {
                     loadData(false);
                 }
             }, [cwd, sessionId, syncSettings.strategy]);
-            // 定时轮询调度：与主页完全一致
-            React.useEffect(() => {
-                if (syncSettings.strategy !== "interval" || !syncSettings.intervalMs || syncSettings.intervalMs <= 0)
-                    return;
-                var timer = setInterval(function () {
-                    loadData(false);
-                }, syncSettings.intervalMs);
-                return function () { clearInterval(timer); };
-            }, [syncSettings.strategy, syncSettings.intervalMs, loadData]);
+            // （原定时轮询调度已随 'interval' 策略一并移除：前端 setInterval 受浏览器
+            //  后台节流且随组件卸载销毁，无法兑现「定时自动更新」承诺）
             // 窗口切回自动探测自愈：优先轻量快速探针，检测到已登录立即自愈
             React.useEffect(() => {
                 var onFocus = () => {
@@ -1747,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() {
@@ -1764,19 +2106,78 @@ 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 / update / about ----
+            var [activeSection, setActiveSection] = React.useState(props.initialSection || "sync");
             var [strategy, setStrategy] = React.useState(props.currentSettings.strategy || "swr");
-            var [intervalMs, setIntervalMs] = React.useState(props.currentSettings.intervalMs || 300000);
             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 与实际生效配置漂移。
+            var [proxyEnabled, setProxyEnabled] = React.useState(false);
+            var [proxyUrl, setProxyUrl] = React.useState("");
+            var [proxyNoProxy, setProxyNoProxy] = React.useState("localhost,127.0.0.1");
+            var [proxyApplyNpm, setProxyApplyNpm] = React.useState(true);
+            var [proxyBusy, setProxyBusy] = React.useState(false);
+            var [proxyMsg, setProxyMsg] = React.useState(null);
+            var [proxyProbe, setProxyProbe] = React.useState(null);
+            React.useEffect(function () {
+                if (!props.isOpen)
+                    return;
+                fetch("/api/github/proxy")
+                    .then(function (r) { return r.json(); })
+                    .then(function (j) {
+                    if (j && j.ok && j.state) {
+                        setProxyEnabled(Boolean(j.state.config && j.state.config.url));
+                        setProxyUrl((j.state.config && j.state.config.url) || "");
+                        setProxyNoProxy((j.state.config && j.state.config.noProxy) || "localhost,127.0.0.1");
+                        setProxyApplyNpm(j.state.config ? j.state.config.applyToPackageManager !== false : true);
+                        if (j.state.lastProbe)
+                            setProxyProbe(j.state.lastProbe);
+                    }
+                })
+                    .catch(function () { });
+            }, [props.isOpen]);
             // 键盘 Escape 快捷关闭支持
             React.useEffect(function () {
                 var onKeyDown = function (e) {
@@ -1787,11 +2188,59 @@ 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 = {
                     strategy: strategy,
-                    intervalMs: Number(intervalMs),
                 };
                 saveLocalSyncSettings(updated);
                 props.onSave(updated);
@@ -1804,13 +2253,88 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 setClearTip("本地缓存已彻底清空！");
                 setTimeout(function () { setClearTip(""); }, 2000);
             };
+            // 代理保存：POST 后端后立即全局生效（gh 子进程/升级链路 env + npm 探测 dispatcher）。
+            // 保存成功即提示「无需重启」，与「设置完成之后全局生效」的语义对齐。
+            var handleProxySave = function () {
+                setProxyBusy(true);
+                setProxyMsg(null);
+                fetch("/api/github/proxy", {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify({
+                        url: proxyEnabled ? proxyUrl.trim() : "",
+                        noProxy: proxyNoProxy,
+                        applyToPackageManager: proxyApplyNpm,
+                    }),
+                })
+                    .then(function (r) { return r.json(); })
+                    .then(function (j) {
+                    setProxyBusy(false);
+                    if (j && j.ok) {
+                        setProxyMsg({
+                            kind: "ok",
+                            text: j.state && j.state.config && j.state.config.url
+                                ? "🌐 代理已保存并全局生效（驾驶舱 / 右侧栏 / Agent 工具 / 升级链路），无需重启"
+                                : "已切换为系统默认网络（直连或系统环境代理），无需重启",
+                        });
+                        if (j.state && j.state.lastProbe)
+                            setProxyProbe(j.state.lastProbe);
+                    }
+                    else {
+                        setProxyMsg({ kind: "err", text: (j && j.message) || "保存失败" });
+                    }
+                })
+                    .catch(function (e) {
+                    setProxyBusy(false);
+                    setProxyMsg({ kind: "err", text: "网络请求失败: " + (e && e.message ? e.message : e) });
+                });
+            };
+            // 连通性探测：验证经当前配置访问 GitHub API 的可达性（2.5s 超时由后端控制）
+            var handleProxyProbe = function () {
+                setProxyBusy(true);
+                setProxyMsg(null);
+                fetch("/api/github/proxy/probe", { method: "POST" })
+                    .then(function (r) { return r.json(); })
+                    .then(function (j) {
+                    setProxyBusy(false);
+                    if (j && j.ok && j.probe) {
+                        setProxyProbe(j.probe);
+                        setProxyMsg(j.probe.ok
+                            ? { kind: "ok", text: "✅ GitHub API 可达 (" + j.probe.latencyMs + "ms)" }
+                            : { kind: "err", text: "❌ " + (j.probe.error || "探测失败") });
+                    }
+                    else {
+                        setProxyMsg({ kind: "err", text: (j && j.message) || "探测失败" });
+                    }
+                })
+                    .catch(function (e) {
+                    setProxyBusy(false);
+                    setProxyMsg({ kind: "err", text: "探测请求失败: " + (e && e.message ? e.message : e) });
+                });
+            };
             return h("div", { className: "dsh-github-modal-overlay", onClick: props.onClose }, h("div", {
                 className: "dsh-github-modal-dialog",
                 onClick: function (e) { e.stopPropagation(); },
-            }, h("div", { style: { display: "flex", justifyContent: "space-between", alignItems: "center", marginBottom: "16px" } }, h("h3", { style: { margin: 0, fontSize: "16px", fontWeight: 600 } }, "⚙️ 数据同步与缓存偏好"), h("button", {
+            }, 
+            // 弹窗头部：标题 + 关闭按钮
+            h("div", { className: "dsh-github-modal-header" }, h("h3", { style: { margin: 0, fontSize: "16px", fontWeight: 600 } }, "⚙️ 设置"), h("button", {
                 style: { background: "none", border: "none", cursor: "pointer", fontSize: "18px", color: "var(--dsw-alias-label-secondary, #656d76)" },
                 onClick: props.onClose,
-            }, "✕")), h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginBottom: "14px", lineHeight: "1.5" } }, "配置 GitHub 全景驾驶舱的数据拉取节奏。启用秒开模式可利用本地持久化缓存消除每次打开时的漫长等待。"), 
+            }, "✕")), 
+            // 双栏骨架：左侧分区导航 + 右侧内容区（窄屏自动折叠为横向页签）
+            h("div", { className: "dsh-github-modal-body" }, h("div", { className: "dsh-github-settings-nav" }, h("button", {
+                className: "dsh-github-settings-nav-item" + (activeSection === "sync" ? " active" : ""),
+                onClick: function () { setActiveSection("sync"); },
+            }, "🔄 数据同步"), h("button", {
+                className: "dsh-github-settings-nav-item" + (activeSection === "proxy" ? " active" : ""),
+                onClick: function () { setActiveSection("proxy"); },
+            }, "🌐 网络代理"), h("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 秒开
@@ -1822,18 +2346,10 @@ body[data-ds-dark-theme] .dsh-github-radio {
             h("div", {
                 className: "dsh-github-radio-card" + (strategy === "manual" ? " active" : ""),
                 onClick: function () { setStrategy("manual"); },
-            }, h("input", { type: "radio", className: "dsh-github-radio", checked: strategy === "manual", readOnly: true }), h("div", null, h("div", { style: { fontWeight: 600, fontSize: "13px" } }, "📋 仅在手动点击时拉取 (Manual Only)"), h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginTop: "2px" } }, "打开只浏览本地缓存，绝不自动触发后台 gh 进程，最省电、最省资源。"))), 
-            // 策略 C: 定时轮询
-            h("div", {
-                className: "dsh-github-radio-card" + (strategy === "interval" ? " active" : ""),
-                onClick: function () { setStrategy("interval"); },
-            }, h("input", { type: "radio", className: "dsh-github-radio", checked: strategy === "interval", readOnly: true }), h("div", null, h("div", { style: { fontWeight: 600, fontSize: "13px" } }, "⏱️ 定时自动轮询 (Auto Poll)"), h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginTop: "2px" } }, "驾驶舱打开期间，按照下方设定的时间间隔在后台自动轮询。")))), 
-            // 自动拉取间隔下拉
-            h("div", { style: { marginBottom: "18px" } }, h("div", { style: { fontSize: "13px", fontWeight: 600, marginBottom: "6px" } }, "后台自动拉取间隔"), h("select", {
-                className: "dsh-github-select",
-                value: intervalMs,
-                onChange: function (e) { setIntervalMs(Number(e.target.value)); },
-            }, h("option", { value: 60000 }, "1 分钟 (高频刷新)"), h("option", { value: 300000 }, "5 分钟 (默认推荐)"), h("option", { value: 900000 }, "15 分钟"), h("option", { value: 1800000 }, "30 分钟 (推荐节能)"), h("option", { value: 3600000 }, "1 小时"), h("option", { value: 0 }, "从不自动刷新 (仅手动)"))), 
+            }, h("input", { type: "radio", className: "dsh-github-radio", checked: strategy === "manual", readOnly: true }), h("div", null, h("div", { style: { fontWeight: 600, fontSize: "13px" } }, "📋 仅在手动点击时拉取 (Manual Only)"), h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginTop: "2px" } }, "打开只浏览本地缓存，绝不自动触发后台 gh 进程，最省电、最省资源；想更新时点击「🔄 刷新」即可。")))
+            // （第三种「定时自动轮询」策略已移除：前端定时器受浏览器后台节流且随
+            //  组件卸载销毁，无法兑现定时更新承诺；SWR 挂载自愈已覆盖「打开即新鲜」）
+            ), 
             // 本地缓存信息与清理
             h("div", {
                 className: "dsh-github-cache-info-box",
@@ -1843,13 +2359,126 @@ 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", { style: { display: "flex", justifyContent: "flex-end", gap: "8px" } }, h("button", {
+            }, "🗑️ 清空缓存") : 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", {
+                type: "checkbox",
+                checked: proxyEnabled,
+                onChange: function (e) { setProxyEnabled(Boolean(e.target.checked)); },
+            }), "启用代理"), proxyEnabled ? h("div", null, h("div", { style: { fontSize: "12px", marginBottom: "4px" } }, "代理地址"), h("input", {
+                className: "dsh-github-input",
+                style: { width: "100%", boxSizing: "border-box", padding: "6px 10px", fontSize: "13px", marginBottom: "10px" },
+                placeholder: "http://127.0.0.1:7890 或 socks5h://127.0.0.1:1080（DNS 由代理解析）",
+                value: proxyUrl,
+                onChange: function (e) { setProxyUrl(e.target.value); },
+            }), h("div", { style: { fontSize: "12px", marginBottom: "4px" } }, "NO_PROXY 排除列表（逗号分隔，localhost 与 127.0.0.1 强制包含）"), h("input", {
+                className: "dsh-github-input",
+                style: { width: "100%", boxSizing: "border-box", padding: "6px 10px", fontSize: "12px", marginBottom: "10px" },
+                value: proxyNoProxy,
+                onChange: function (e) { setProxyNoProxy(e.target.value); },
+            }), h("label", { style: { display: "flex", alignItems: "center", gap: "8px", marginBottom: "8px", cursor: "pointer", fontSize: "12px" } }, h("input", {
+                type: "checkbox",
+                checked: proxyApplyNpm,
+                onChange: function (e) { setProxyApplyNpm(Boolean(e.target.checked)); },
+            }), "同时应用于 npm 版本探测与一键升级")) : null, 
+            // 操作与反馈行：探测/保存按钮 + 结果胶囊
+            h("div", { style: { display: "flex", alignItems: "center", gap: "8px", flexWrap: "wrap" } }, h("button", {
                 className: "dsh-github-btn-sm",
-                style: { padding: "6px 14px" },
-                onClick: props.onClose,
-            }, "取消"), h("button", {
+                style: { padding: "5px 12px", fontSize: "12px" },
+                disabled: proxyBusy || !proxyEnabled,
+                onClick: handleProxyProbe,
+                title: "经当前配置探测 GitHub API 连通性（约 2.5 秒）",
+            }, "🧪 测试连通性"), h("button", {
+                className: "dsh-github-btn-sm",
+                style: {
+                    padding: "5px 14px",
+                    fontSize: "12px",
+                    background: "var(--dsw-alias-link, #0969da)",
+                    color: "#ffffff",
+                    borderColor: "var(--dsw-alias-link, #0969da)",
+                    fontWeight: 600,
+                },
+                disabled: proxyBusy,
+                onClick: handleProxySave,
+            }, proxyBusy ? "处理中..." : "💾 保存并全局应用"), proxyProbe ? h("span", {
+                style: {
+                    fontSize: "12px",
+                    fontWeight: 500,
+                    color: proxyProbe.ok ? "var(--dsw-alias-state-success, #2ea043)" : "var(--dsw-alias-state-error-primary, #cf222e)",
+                },
+                title: proxyProbe.error || "",
+            }, proxyProbe.ok ? "✅ " + proxyProbe.latencyMs + "ms" : "❌ 探测失败") : null), proxyMsg ? h("div", {
+                style: {
+                    marginTop: "8px",
+                    fontSize: "12px",
+                    lineHeight: "1.5",
+                    color: proxyMsg.kind === "ok"
+                        ? "var(--dsw-alias-state-success, #2ea043)"
+                        : proxyMsg.kind === "err"
+                            ? "var(--dsw-alias-state-error-primary, #cf222e)"
+                            : "var(--dsw-alias-label-secondary, #656d76)",
+                },
+            }, proxyMsg.text) : null))), 
+            // 底部操作条：sync 分区提供主保存动作；proxy/update 分区有自己的「保存并全局应用」，
+            // 底部统一为「完成」关闭弹窗，避免多个保存按钮的语义冲突。
+            h("div", { className: "dsh-github-modal-footer" }, activeSection === "sync" ? h("button", {
                 className: "dsh-github-btn-sm",
                 style: {
                     padding: "6px 16px",
@@ -1859,7 +2488,11 @@ body[data-ds-dark-theme] .dsh-github-radio {
                     fontWeight: 600,
                 },
                 onClick: handleSave,
-            }, "保存并应用"))));
+            }, "保存同步设置") : null, h("button", {
+                className: "dsh-github-btn-sm",
+                style: { padding: "6px 14px" },
+                onClick: props.onClose,
+            }, activeSection === "sync" ? "取消" : "完成"))));
         }
         function GithubWorkspacePanel() {
             // 1. 读取本地偏好配置与历史持久化快照 (0ms 纯内存读取)
@@ -1870,16 +2503,35 @@ 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'
             var [searchQuery, setSearchQuery] = React.useState("");
             var [issueFilter, setIssueFilter] = React.useState("all"); // 'all' | 'reported' | 'assigned' | 'created'
-            // gh 业务数据就绪后，闲时 1.5 秒异步静默检测升级，绝不影响首屏
+            // 代理生效状态（标题栏 🌐 徽章数据源）：挂载时读一次 + 弹窗关闭时刷新
+            //（保存发生在弹窗内，关闭时机足以让徽章与最新配置对齐，无需轮询）
+            var [proxyActive, setProxyActive] = React.useState(null);
+            var refreshProxyBadge = React.useCallback(function () {
+                fetch("/api/github/proxy")
+                    .then(function (r) { return r.json(); })
+                    .then(function (j) {
+                    if (j && j.ok && j.state && j.state.config) {
+                        setProxyActive({ enabled: Boolean(j.state.config.url), url: j.state.config.url || "" });
+                    }
+                    else {
+                        setProxyActive({ enabled: false, url: "" });
+                    }
+                })
+                    .catch(function () { });
+            }, []);
+            React.useEffect(function () { refreshProxyBadge(); }, [refreshProxyBadge]);
+            // 检查更新与 gh 业务数据零依赖，挂载即并行发起（与右侧栏同策略）：
+            // 并发由服务端 inFlightPromise + 24h 缓存合流去重，无请求风暴风险。
             React.useEffect(() => {
-                if (!data)
-                    return;
                 var timer = setTimeout(function () {
                     fetch("/api/github/check-update")
                         .then(function (res) { return res.json(); })
@@ -1889,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) {
@@ -1904,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(() => "");
@@ -1948,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));
@@ -1960,7 +2636,9 @@ body[data-ds-dark-theme] .dsh-github-radio {
                     setLoading(false);
                 }
             }, [data, syncSettings]);
-            // 挂载加载调度：SWR 模式下初次延迟 300ms 后台平滑发起静默同步
+            // 挂载加载调度：SWR 模式下初次延迟 300ms 后台平滑发起静默同步。
+            // 无论本地是否有旧快照都拉：昨天的持久化快照在挂载后 300ms 内自愈，
+            // 「打开驾驶舱即新鲜」由 SWR 定义本身保证，而非依赖用户停留或手动刷新。
             React.useEffect(() => {
                 if (syncSettings.strategy === "swr") {
                     var timer = setTimeout(function () { loadData(false); }, 300);
@@ -1970,15 +2648,7 @@ body[data-ds-dark-theme] .dsh-github-radio {
                     loadData(false);
                 }
             }, [syncSettings.strategy]);
-            // 定时轮询调度
-            React.useEffect(() => {
-                if (syncSettings.strategy !== "interval" || !syncSettings.intervalMs || syncSettings.intervalMs <= 0)
-                    return;
-                var timer = setInterval(function () {
-                    loadData(false);
-                }, syncSettings.intervalMs);
-                return function () { clearInterval(timer); };
-            }, [syncSettings.strategy, syncSettings.intervalMs, loadData]);
+            // （原定时轮询调度已随 'interval' 策略一并移除）
             // 窗口切回自动探测自愈：优先轻量快速探针，检测到已登录立即自愈
             React.useEffect(() => {
                 var onFocus = () => {
@@ -1998,18 +2668,37 @@ 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 })), h("div", { style: { display: "flex", alignItems: "center", gap: "8px" } }, h("button", {
+            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", {
+                    style: {
+                        display: "inline-flex",
+                        alignItems: "center",
+                        gap: "4px",
+                        fontSize: "11px",
+                        fontWeight: 500,
+                        padding: "2px 8px",
+                        borderRadius: "999px",
+                        background: "rgba(9, 105, 218, 0.1)",
+                        border: "1px solid rgba(9, 105, 218, 0.35)",
+                        color: "var(--dsw-alias-link, #0969da)",
+                        cursor: "default",
+                    },
+                    title: "插件网络代理已启用: " + proxyActive.url + "（GitHub 数据链路与工具调用经此代理；点击 ⚙️ 可修改）",
+                }, "🌐 代理")
+                : null), h("div", { style: { display: "flex", alignItems: "center", gap: "8px" } }, h("button", {
                 className: "dsh-github-refresh-btn",
                 onClick: () => loadData(true),
                 disabled: loading,
             }, loading ? "同步中..." : "🔄 刷新全局数据"), 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
@@ -2017,7 +2706,12 @@ body[data-ds-dark-theme] .dsh-github-radio {
                 : null;
             var settingsModalEl = h(GlobalSyncSettingsModal, {
                 isOpen: isSettingsModalOpen,
-                onClose: () => setIsSettingsModalOpen(false),
+                initialSection: settingsInitialSection,
+                onClose: () => {
+                    setIsSettingsModalOpen(false);
+                    // 弹窗内可能刚保存过代理配置，关闭时同步刷新标题栏徽章
+                    refreshProxyBadge();
+                },
                 currentSettings: syncSettings,
                 onSave: (newSettings) => {
                     setSyncSettings(newSettings);
@@ -2030,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",
@@ -2140,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) {
@@ -2172,6 +2866,7 @@ body[data-ds-dark-theme] .dsh-github-radio {
                         id: "dsh-github-flow",
                         kind: "github",
                         priority: "plugin",
+                        // 标题保持简洁，身份由面板内徽标标注（Tab 体系不支持内嵌徽标元素）
                         title: () => "GitHub 仓库",
                         guide: [
                             {
@@ -2179,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,
                             },
                         ],