dsh-github-flow 0.4.0 → 0.5.0

package/lib/client.js

@@ -1227,6 +1227,244 @@ color: var(--dsw-alias-state-success, #1a7f37);
 body[data-ds-dark-theme] .dsh-github-branch-item.active {
 color: #3fb950;
 }
+.dsh-github-help-dialog {
+width: 920px;
+max-width: 92vw;
+height: 85vh;
+max-height: 85vh;
+display: flex;
+flex-direction: column;
+border-radius: 12px;
+background: var(--dsw-alias-bg-base, #ffffff);
+border: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+box-shadow: 0 24px 64px rgba(0, 0, 0, 0.22);
+color: var(--dsw-alias-label-primary, #1f2328);
+font-family: var(--dsw-font-family, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif);
+overflow: hidden;
+box-sizing: border-box;
+}
+body[data-ds-dark-theme] .dsh-github-help-dialog {
+background: var(--dsw-alias-bg-layer-2, #1c2128);
+border-color: var(--dsw-alias-border-l1, #30363d);
+color: var(--dsw-alias-label-primary, #f0f6fc);
+box-shadow: 0 24px 64px rgba(0, 0, 0, 0.65);
+}
+.dsh-github-help-header {
+padding: 16px 22px;
+border-bottom: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+display: flex;
+align-items: center;
+justify-content: space-between;
+flex-shrink: 0;
+background: var(--dsw-alias-bg-base, #ffffff);
+}
+body[data-ds-dark-theme] .dsh-github-help-header {
+background: var(--dsw-alias-bg-layer-2, #1c2128);
+border-bottom-color: var(--dsw-alias-border-l1, #30363d);
+}
+.dsh-github-help-nav {
+display: flex;
+gap: 8px;
+padding: 10px 22px;
+background: var(--dsw-alias-bg-module-platform, rgba(9, 105, 218, 0.05));
+border-bottom: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+flex-shrink: 0;
+}
+body[data-ds-dark-theme] .dsh-github-help-nav {
+background: rgba(56, 139, 253, 0.08);
+border-bottom-color: var(--dsw-alias-border-l1, #30363d);
+}
+.dsh-github-help-tab-btn {
+padding: 6px 14px;
+font-size: 13px;
+font-weight: 500;
+border-radius: 6px;
+background: transparent;
+color: var(--dsw-alias-label-secondary, #656d76);
+border: 1px solid transparent;
+cursor: pointer;
+transition: all 0.15s ease;
+}
+body[data-ds-dark-theme] .dsh-github-help-tab-btn {
+color: var(--dsw-alias-label-secondary, #8b949e);
+}
+.dsh-github-help-tab-btn:hover {
+background: rgba(0, 0, 0, 0.05);
+}
+body[data-ds-dark-theme] .dsh-github-help-tab-btn:hover {
+background: rgba(255, 255, 255, 0.08);
+color: #f0f6fc;
+}
+.dsh-github-help-tab-btn.active {
+font-weight: 600;
+background: var(--dsw-alias-link, #0969da);
+color: #ffffff !important;
+border-color: var(--dsw-alias-link, #0969da);
+}
+body[data-ds-dark-theme] .dsh-github-help-tab-btn.active {
+background: #1f6feb;
+border-color: #1f6feb;
+}
+.dsh-github-help-scroll-body {
+flex: 1;
+overflow-y: auto;
+padding: 22px;
+box-sizing: border-box;
+}
+.dsh-github-help-scroll-body::-webkit-scrollbar {
+width: 6px;
+}
+.dsh-github-help-scroll-body::-webkit-scrollbar-thumb {
+background: rgba(0, 0, 0, 0.15);
+border-radius: 3px;
+}
+body[data-ds-dark-theme] .dsh-github-help-scroll-body::-webkit-scrollbar-thumb {
+background: #30363d;
+}
+.dsh-github-help-card {
+padding: 16px 18px;
+margin-bottom: 14px;
+border-radius: 8px;
+background: var(--dsw-alias-bg-module-platform, rgba(9, 105, 218, 0.04));
+border: 1px solid var(--dsw-alias-border-l2, rgba(9, 105, 218, 0.18));
+transition: border-color 0.15s ease;
+}
+body[data-ds-dark-theme] .dsh-github-help-card {
+background: rgba(56, 139, 253, 0.05);
+border-color: rgba(56, 139, 253, 0.18);
+}
+.dsh-github-help-card:hover {
+border-color: rgba(9, 105, 218, 0.35);
+}
+body[data-ds-dark-theme] .dsh-github-help-card:hover {
+border-color: rgba(56, 139, 253, 0.4);
+}
+.dsh-github-prompt-box {
+padding: 10px 14px;
+margin-bottom: 8px;
+border-radius: 6px;
+background: #f6f8fa;
+border: 1px solid #d0d7de;
+font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;
+font-size: 12px;
+line-height: 1.5;
+color: var(--dsw-alias-label-primary, #1f2328);
+word-break: break-all;
+}
+body[data-ds-dark-theme] .dsh-github-prompt-box {
+background: #0d1117;
+border-color: #30363d;
+color: #79c0ff;
+}
+.dsh-github-help-step-badge {
+width: 28px;
+height: 28px;
+border-radius: 50%;
+background: var(--dsw-alias-link, #0969da);
+color: #ffffff;
+display: flex;
+align-items: center;
+justify-content: center;
+font-weight: 700;
+font-size: 14px;
+flex-shrink: 0;
+}
+body[data-ds-dark-theme] .dsh-github-help-step-badge {
+background: #1f6feb;
+box-shadow: 0 0 10px rgba(31, 111, 235, 0.35);
+}
+.dsh-github-help-footer {
+padding: 12px 22px;
+border-top: 1px solid var(--dsw-alias-border-l2, #d0d7de);
+display: flex;
+justify-content: space-between;
+align-items: center;
+background: var(--dsw-alias-bg-base, #ffffff);
+flex-shrink: 0;
+}
+body[data-ds-dark-theme] .dsh-github-help-footer {
+background: var(--dsw-alias-bg-layer-2, #1c2128);
+border-top-color: var(--dsw-alias-border-l1, #30363d);
+}
+.dsh-github-help-title {
+font-weight: 600;
+font-size: 14px;
+color: var(--dsw-alias-label-primary, #1f2328);
+}
+body[data-ds-dark-theme] .dsh-github-help-title {
+color: var(--dsw-alias-label-primary, #f0f6fc);
+}
+.dsh-github-help-desc {
+font-size: 12px;
+color: var(--dsw-alias-label-secondary, #656d76);
+line-height: 1.5;
+}
+body[data-ds-dark-theme] .dsh-github-help-desc {
+color: var(--dsw-alias-label-secondary, #8b949e);
+}
+.dsh-github-dirty-item {
+display: flex;
+align-items: center;
+gap: 8px;
+padding: 4px 6px;
+border-radius: 6px;
+cursor: pointer;
+transition: background-color 0.15s ease;
+user-select: none;
+}
+.dsh-github-dirty-item:hover {
+background: var(--dsw-alias-interactive-bg-hover, rgba(0, 0, 0, 0.05));
+}
+body[data-ds-dark-theme] .dsh-github-dirty-item:hover {
+background: rgba(255, 255, 255, 0.08);
+}
+.dsh-github-dirty-item:active {
+background: var(--dsw-alias-interactive-bg-active, rgba(0, 0, 0, 0.08));
+}
+body[data-ds-dark-theme] .dsh-github-dirty-item:active {
+background: rgba(255, 255, 255, 0.12);
+}
+.dsh-github-inline-diff-view {
+animation: dsh-github-fade-in 0.15s ease-out;
+}
+@keyframes dsh-github-fade-in {
+from { opacity: 0; transform: translateY(2px); }
+to { opacity: 1; transform: translateY(0); }
+}
+body[data-ds-dark-theme] .dsh-github-inline-diff-content {
+background-color: var(--dsw-alias-bg-layer-2, #1c2128) !important;
+border-color: var(--dsw-alias-border-l1, #30363d) !important;
+}
+.dsh-github-stat-list {
+border: 1px solid var(--dsw-alias-border-l2, #e1e4e8);
+background: var(--dsw-alias-bg-module-platform, #f6f8fa);
+}
+body[data-ds-dark-theme] .dsh-github-stat-list {
+border-color: var(--dsw-alias-border-l1, #30363d) !important;
+background: var(--dsw-alias-bg-layer-2, #1c2128) !important;
+}
+.dsh-github-stat-row {
+transition: background-color 0.15s ease;
+}
+.dsh-github-stat-row:hover {
+background: var(--dsw-alias-interactive-bg-hover, rgba(0, 0, 0, 0.04));
+}
+body[data-ds-dark-theme] .dsh-github-stat-row:hover {
+background: rgba(255, 255, 255, 0.06);
+}
+.dsh-github-header-cards-collapsed {
+display: none !important;
+}
+.dsh-github-btn-sm.active {
+background: var(--dsw-alias-state-attention-subtle, rgba(234, 179, 8, 0.15)) !important;
+color: var(--dsw-alias-state-attention-primary, #9a6700) !important;
+border-color: var(--dsw-alias-state-attention-primary, #d29922) !important;
+}
+body[data-ds-dark-theme] .dsh-github-btn-sm.active {
+background: rgba(234, 179, 8, 0.2) !important;
+color: #f0b72f !important;
+border-color: #d29922 !important;
+}
 `;
 function injectStyles() {
     var styleId = "dsh-plugin-github-styles";
@@ -1309,6 +1547,166 @@ function eventLabel(event) {
         return "🔀 PR";
     return e || "";
 }
+/**
+ * 带有阶梯退避重试（Backoff Retry）的通用异步拉取函数
+ *
+ * 核心设计理由与约束：
+ * 1. 应对代理节点不稳定、TLS 握手卡顿、短时网络抖动（半秒至两秒微断流）；
+ * 2. 阶梯退避时序：第 1 次失败等 1s (1000ms)，第 2 次等 2s (2000ms)，第 3 次等 4s (4000ms)，附加 0~200ms Jitter；
+ * 3. 智能区分软硬错误：401/403/404/400 确定性错误坚决不重试，仅在网络超时、不可达、或带有 networkError 时重试；
+ * 4. 严格响应外部 AbortSignal，组件卸载或用户手动打断时立即退出等待，绝无内存泄漏。
+ */
+async function fetchWithRetry(url, options = {}, config = {}) {
+    var maxRetries = config.maxRetries !== undefined ? config.maxRetries : 3;
+    var baseDelayMs = config.baseDelayMs !== undefined ? config.baseDelayMs : 1000;
+    var signal = config.signal || options.signal;
+    var attempt = 0;
+    while (true) {
+        attempt++;
+        var currentRes = null;
+        var currentJson = null;
+        var failureReason = "";
+        var shouldRetry = false;
+        try {
+            if (signal && signal.aborted) {
+                throw new Error("Aborted");
+            }
+            currentRes = await fetch(url, { ...options, signal });
+            // 硬错误守卫：客户端确定性错误（如未授权、权限拒绝、不存在、参数错误）坚决不重试
+            if (currentRes.status === 401 || currentRes.status === 403 || currentRes.status === 404 || currentRes.status === 400) {
+                currentJson = await currentRes.json().catch(() => ({}));
+                return { res: currentRes, json: currentJson };
+            }
+            if (!currentRes.ok) {
+                failureReason = "HTTP " + currentRes.status + " " + currentRes.statusText;
+                shouldRetry = true;
+            }
+            else {
+                currentJson = await currentRes.json().catch(() => null);
+                // 业务层软错误检测（后端返回了 200，但标记了 networkError 或 partialFailure）
+                var isNetworkError = Boolean(currentJson && (currentJson.partialFailure ||
+                    currentJson.data?.partialFailure ||
+                    currentJson.data?.networkError ||
+                    currentJson.data?.auth?.networkError));
+                if (isNetworkError) {
+                    failureReason = currentJson.error || currentJson.data?.networkErrorReason || "云端接口网络抖动";
+                    shouldRetry = true;
+                }
+                else {
+                    // 成功获取完整且无网络错误的数据
+                    return { res: currentRes, json: currentJson };
+                }
+            }
+        }
+        catch (err) {
+            if ((signal && signal.aborted) || err.name === "AbortError") {
+                throw err;
+            }
+            failureReason = err.message || "网络连接中断或超时";
+            shouldRetry = true;
+        }
+        // 判断是否已耗尽重试次数
+        if (!shouldRetry || attempt > maxRetries) {
+            if (currentRes) {
+                return { res: currentRes, json: currentJson || {} };
+            }
+            throw new Error(failureReason || "网络请求失败");
+        }
+        // 计算阶梯退避等待时间：baseDelayMs * 2^(attempt - 1) + Jitter 自适应微扰
+        var exponentialDelay = baseDelayMs * Math.pow(2, attempt - 1);
+        var maxJitter = Math.min(200, Math.floor(exponentialDelay * 0.2));
+        var jitter = Math.floor(Math.random() * (maxJitter + 1));
+        var totalDelay = exponentialDelay + jitter;
+        if (config.onRetry) {
+            config.onRetry(attempt, totalDelay, failureReason);
+        }
+        // 可中断的睡眠等待
+        await new Promise((resolve, reject) => {
+            var timer = setTimeout(resolve, totalDelay);
+            if (signal) {
+                signal.addEventListener("abort", () => {
+                    clearTimeout(timer);
+                    reject(new Error("Aborted"));
+                }, { once: true });
+            }
+        });
+    }
+}
+function parseGitStatText(statText) {
+    if (!statText || typeof statText !== "string")
+        return null;
+    var lines = statText.split("\n");
+    var files = [];
+    var summary = null;
+    for (var i = 0; i < lines.length; i++) {
+        var line = lines[i].trim();
+        if (!line)
+            continue;
+        var summaryMatch = line.match(/(\d+)\s+files?\s+changed(?:,\s+(\d+)\s+insertions?\(\+\))?(?:,\s+(\d+)\s+deletions?\(-\))?/i);
+        if (summaryMatch) {
+            summary = {
+                filesChanged: parseInt(summaryMatch[1], 10),
+                insertions: parseInt(summaryMatch[2] || "0", 10),
+                deletions: parseInt(summaryMatch[3] || "0", 10),
+            };
+            continue;
+        }
+        var pipeIdx = line.indexOf("|");
+        if (pipeIdx > 0) {
+            var left = line.slice(0, pipeIdx).trim();
+            var right = line.slice(pipeIdx + 1).trim();
+            if (left.startsWith('"') && left.endsWith('"') && left.length >= 2) {
+                left = left.slice(1, -1);
+            }
+            if (/^Bin\b/i.test(right)) {
+                files.push({ path: left, total: 0, additions: 0, deletions: 0, isBinary: true, rawRight: right });
+            }
+            else {
+                var numMatch = right.match(/^(\d+)(.*)$/);
+                if (numMatch) {
+                    var total = parseInt(numMatch[1], 10);
+                    var graph = numMatch[2].trim();
+                    var plusCount = 0;
+                    var minusCount = 0;
+                    for (var j = 0; j < graph.length; j++) {
+                        if (graph[j] === "+")
+                            plusCount++;
+                        else if (graph[j] === "-")
+                            minusCount++;
+                    }
+                    var additions = 0;
+                    var deletions = 0;
+                    if (plusCount === 0 && minusCount === 0) {
+                        additions = total;
+                    }
+                    else if (minusCount === 0) {
+                        additions = total;
+                        deletions = 0;
+                    }
+                    else if (plusCount === 0) {
+                        additions = 0;
+                        deletions = total;
+                    }
+                    else {
+                        if (plusCount + minusCount === total) {
+                            additions = plusCount;
+                            deletions = minusCount;
+                        }
+                        else {
+                            var addExact = Math.round((total * plusCount) / (plusCount + minusCount));
+                            additions = addExact;
+                            deletions = Math.max(0, total - addExact);
+                        }
+                    }
+                    files.push({ path: left, total, additions, deletions, isBinary: false });
+                }
+            }
+        }
+    }
+    if (files.length === 0 && !summary)
+        return null;
+    return { files, summary };
+}
 
 // ---- [Bundled: icons.js] ----
 /**
@@ -1500,6 +1898,30 @@ function saveStoredRightbarData(cwd, data) {
     }
     catch (e) { }
 }
+const HEADER_CARDS_STORAGE_KEY = "dsh_github_header_cards_visible_v1";
+/**
+ * 读取右侧栏上方仓库卡片与快捷操作栏的折叠/展开偏好（默认为 true 展开）
+ */
+function getStoredHeaderCardsVisible() {
+    try {
+        var raw = localStorage.getItem(HEADER_CARDS_STORAGE_KEY);
+        if (raw === null || raw === undefined)
+            return true;
+        return raw !== "false";
+    }
+    catch (e) {
+        return true;
+    }
+}
+/**
+ * 持久化保存右侧栏上方仓库卡片与快捷操作栏的展开/折叠偏好
+ */
+function saveStoredHeaderCardsVisible(visible) {
+    try {
+        localStorage.setItem(HEADER_CARDS_STORAGE_KEY, visible ? "true" : "false");
+    }
+    catch (e) { }
+}
 
 // ---- [Bundled: branch-selector.js] ----
 /**
@@ -1882,14 +2304,28 @@ function UpgradeNotificationCard(props) {
             }
             else {
                 setStatus("failed");
-                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);
+                var logText = String(json.log || "");
+                var isAgeViolation = json.errorType === "MINIMUM_RELEASE_AGE_VIOLATION" ||
+                    logText.includes("ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION") ||
+                    logText.includes("minimumReleaseAge") ||
+                    (typeof json.message === "string" && (json.message.includes("24 小时安全保护期") || json.message.includes("防投毒")));
+                if (isAgeViolation) {
+                    // 命中 DSH 内置包管理器 24 小时防投毒策略：收起英文报错堆栈，呈现全中文专业自愈指引
+                    setMsg("🛡️ 触发 DSH 新版本 24 小时安全保护期（npm 供应链防投毒策略）。检测到目标版本刚刚发布未满 24 小时，DSH 内置包管理器暂缓了自动升级以保障系统安全。\n\n" +
+                        "【推荐操作】：\n" +
+                        "1. 立即尝鲜：请先【完全退出关闭 DSH 应用程序】，然后在系统终端执行手动安装命令（点击右侧「📋 复制命令」获取）；\n" +
+                        "2. 稍后升级：无需任何操作，发版满 24 小时后直接在此点击「⚡ 一键自动升级」即可平滑完成。");
+                }
+                else {
+                    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);
                 }
-                setMsg((json.message || "升级命令执行失败，请在宿主终端手动执行。") + logTail);
             }
         }
         catch (err) {
@@ -1918,6 +2354,7 @@ function UpgradeNotificationCard(props) {
         window.location.reload();
     };
     var h = React.createElement;
+    var isAgeViolation = msg.includes("24 小时安全保护期") || msg.includes("防投毒");
     if (isRightbar) {
         return h("div", {
             className: "dsh-github-upgrade-strip",
@@ -1927,13 +2364,17 @@ function UpgradeNotificationCard(props) {
                 borderRadius: "8px",
                 background: status === "success"
                     ? "var(--dsw-alias-state-success-subtle, rgba(46, 160, 67, 0.12))"
-                    : "var(--dsw-alias-bg-module-platform, rgba(9, 105, 218, 0.08))",
+                    : (isAgeViolation
+                        ? "rgba(217, 119, 6, 0.12)"
+                        : "var(--dsw-alias-bg-module-platform, rgba(9, 105, 218, 0.08))"),
                 border: "1px solid " + (status === "success"
                     ? "var(--dsw-alias-state-success-border, rgba(46, 160, 67, 0.35))"
-                    : "var(--dsw-alias-border-l2, rgba(9, 105, 218, 0.25))"),
+                    : (isAgeViolation
+                        ? "rgba(217, 119, 6, 0.35)"
+                        : "var(--dsw-alias-border-l2, rgba(9, 105, 218, 0.25))")),
                 fontSize: "12px",
             },
-        }, h("div", { style: { display: "flex", alignItems: "center", justifyContent: "space-between", marginBottom: "6px" } }, h("span", { style: { fontWeight: 600, color: "var(--dsw-alias-label-primary, #1f2328)" } }, status === "success" ? "🎉 升级完成" : "🚀 发现新版 v" + updateInfo.latestVersion), h("button", {
+        }, h("div", { style: { display: "flex", alignItems: "center", justifyContent: "space-between", marginBottom: "6px" } }, h("span", { style: { fontWeight: 600, color: "var(--dsw-alias-label-primary, #1f2328)" } }, status === "success" ? "🎉 升级完成" : (isAgeViolation ? "🛡️ 处于 24h 安全保护期" : "🚀 发现新版 v" + updateInfo.latestVersion)), h("button", {
             onClick: handleDismiss,
             title: "不再提醒此版本",
             style: { background: "none", border: "none", cursor: "pointer", color: "var(--dsw-alias-label-tertiary, #8c8c8c)", fontSize: "14px", padding: 0 },
@@ -1983,13 +2424,17 @@ function UpgradeNotificationCard(props) {
             borderRadius: "8px",
             background: status === "success"
                 ? "linear-gradient(90deg, rgba(46, 160, 67, 0.15) 0%, rgba(9, 105, 218, 0.12) 100%)"
-                : "linear-gradient(90deg, rgba(9, 105, 218, 0.12) 0%, rgba(137, 87, 229, 0.12) 100%)",
-            border: "1px solid " + (status === "success" ? "rgba(46, 160, 67, 0.35)" : "rgba(9, 105, 218, 0.3)"),
+                : (isAgeViolation
+                    ? "linear-gradient(90deg, rgba(217, 119, 6, 0.15) 0%, rgba(245, 158, 11, 0.12) 100%)"
+                    : "linear-gradient(90deg, rgba(9, 105, 218, 0.12) 0%, rgba(137, 87, 229, 0.12) 100%)"),
+            border: "1px solid " + (status === "success" ? "rgba(46, 160, 67, 0.35)" : (isAgeViolation ? "rgba(217, 119, 6, 0.35)" : "rgba(9, 105, 218, 0.3)")),
             fontSize: "13px",
         },
-    }, h("div", { style: { display: "flex", alignItems: "center", gap: "10px" } }, h("span", { style: { fontSize: "20px" } }, status === "success" ? "🎉" : "🚀"), h("div", null, h("div", { style: { fontWeight: 600, color: "var(--dsw-alias-label-primary, #1f2328)" } }, status === "success"
+    }, h("div", { style: { display: "flex", alignItems: "center", gap: "10px" } }, h("span", { style: { fontSize: "20px" } }, status === "success" ? "🎉" : (isAgeViolation ? "🛡️" : "🚀")), h("div", null, h("div", { style: { fontWeight: 600, color: "var(--dsw-alias-label-primary, #1f2328)" } }, status === "success"
         ? "升级完成！新版本 v" + updateInfo.latestVersion + " 已写入"
-        : "发现 dsh-github-flow 新版本 v" + updateInfo.latestVersion + "（当前版本: v" + updateInfo.currentVersion + "）"), h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginTop: "2px" } }, msg || (status === "success"
+        : (isAgeViolation
+            ? "🛡️ 触发 DSH 新版本 24 小时安全保护期 (供应链防投毒策略)"
+            : "发现 dsh-github-flow 新版本 v" + updateInfo.latestVersion + "（当前版本: v" + updateInfo.currentVersion + "）")), h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary, #656d76)", marginTop: "2px" } }, msg || (status === "success"
         ? "💡 提示：DSH 后端驻留了旧版内存，需重启 DSH 服务彻底生效后端工具；若仅预览界面改动可先刷新网页。"
         : "包含最新 GitHub 工具特性与性能优化，点击右侧可一键自动升级。")))), h("div", { style: { display: "flex", alignItems: "center", gap: "8px", flexShrink: 0 } }, status === "success"
         ? h("button", {
@@ -2021,7 +2466,9 @@ function UpgradeNotificationCard(props) {
                 fontWeight: 600,
             } : {}),
         },
-    }, status === "failed" ? "📋 复制命令手动升级" : "📋 复制命令"), h("button", {
+    }, status === "failed"
+        ? (isAgeViolation ? "📋 复制命令 (需先退出DSH)" : "📋 复制命令手动升级")
+        : "📋 复制命令"), h("button", {
         onClick: handleDismiss,
         title: "不再提醒此版本",
         style: { background: "none", border: "none", cursor: "pointer", color: "var(--dsw-alias-label-tertiary, #8c8c8c)", fontSize: "16px", padding: "0 4px" },
@@ -2189,13 +2636,16 @@ function CommitDetailModal(props) {
     if (!effectiveBody && !effectiveStat && fetchedDetail) {
         effectiveStat = fetchedDetail;
     }
+    var parsedStat = React.useMemo(() => {
+        return effectiveStat && typeof parseGitStatText === "function" ? parseGitStatText(effectiveStat) : null;
+    }, [effectiveStat]);
     return h("div", {
         className: "dsh-github-modal-overlay",
         onClick: props.onClose,
         style: { zIndex: 100000 },
     }, h("div", {
         className: "dsh-github-modal-dialog",
-        style: { width: "94%", maxWidth: "460px", maxHeight: "84vh", display: "flex", flexDirection: "column", overflow: "hidden" },
+        style: { width: "94%", maxWidth: "520px", maxHeight: "86vh", display: "flex", flexDirection: "column", overflow: "hidden" },
         onClick: function (e) { e.stopPropagation(); },
     }, h("div", { className: "dsh-github-modal-header", style: { flexShrink: 0 } }, h("div", { style: { display: "flex", alignItems: "center", gap: "8px" } }, renderGitIcon(15, "#1296db"), h("h3", { style: { margin: 0, fontSize: "14px", fontWeight: 600 } }, "提交详情")), h("button", {
         style: { background: "none", border: "none", cursor: "pointer", fontSize: "18px", color: "var(--dsw-alias-label-secondary, #656d76)", padding: "0 4px" },
@@ -2218,22 +2668,149 @@ function CommitDetailModal(props) {
             },
         }, effectiveBody)
         : null, effectiveStat
-        ? h("div", null, h("div", { style: { fontSize: "11px", fontWeight: 600, marginBottom: "4px", opacity: 0.8 } }, "📁 文件变更统计:"), h("pre", {
-            className: "dsh-github-commit-pre",
+        ? h("div", { style: { display: "flex", flexDirection: "column", gap: "6px" } }, h("div", {
             style: {
+                display: "flex",
+                alignItems: "center",
+                justifyContent: "space-between",
                 fontSize: "11px",
-                lineHeight: "1.5",
-                whiteSpace: "pre-wrap",
-                wordBreak: "break-word",
-                margin: 0,
-                maxHeight: "34vh",
-                overflowY: "auto",
-                padding: "8px 10px",
-                borderRadius: "6px",
-                background: "var(--dsw-alias-bg-module-platform, #f6f8fa)",
-                border: "1px solid var(--dsw-alias-border-l2, #e1e4e8)",
+                fontWeight: 600,
             },
-        }, effectiveStat))
+        }, h("div", { style: { opacity: 0.85, display: "flex", alignItems: "center", gap: "6px" } }, "📁 文件变更统计", parsedStat?.summary
+            ? h("span", { style: { opacity: 0.65, fontWeight: 400 } }, `(${parsedStat.summary.filesChanged} 个文件)`)
+            : parsedStat?.files
+                ? h("span", { style: { opacity: 0.65, fontWeight: 400 } }, `(${parsedStat.files.length} 个文件)`)
+                : null), parsedStat?.summary
+            ? h("div", { style: { display: "flex", gap: "6px", fontFamily: "monospace", fontWeight: 600 } }, parsedStat.summary.insertions > 0
+                ? h("span", {
+                    style: {
+                        color: "var(--dsw-alias-state-success-primary, #1a7f37)",
+                        backgroundColor: "var(--dsw-alias-state-success-subtle, rgba(46,160,67,0.12))",
+                        padding: "1px 6px",
+                        borderRadius: "10px",
+                    },
+                }, `+${parsedStat.summary.insertions}`)
+                : null, parsedStat.summary.deletions > 0
+                ? h("span", {
+                    style: {
+                        color: "var(--dsw-alias-state-error-primary, #cf222e)",
+                        backgroundColor: "var(--dsw-alias-state-error-subtle, rgba(248,81,73,0.12))",
+                        padding: "1px 6px",
+                        borderRadius: "10px",
+                    },
+                }, `-${parsedStat.summary.deletions}`)
+                : null)
+            : null), parsedStat && parsedStat.files && parsedStat.files.length > 0
+            ? h("div", {
+                className: "dsh-github-stat-list",
+                style: {
+                    borderRadius: "6px",
+                    border: "1px solid var(--dsw-alias-border-l2, #e1e4e8)",
+                    background: "var(--dsw-alias-bg-module-platform, #f6f8fa)",
+                    maxHeight: "36vh",
+                    overflowY: "auto",
+                    display: "flex",
+                    flexDirection: "column",
+                },
+            }, parsedStat.files.map(function (f, idx) {
+                var diffBlocks = [];
+                if (!f.isBinary && f.total > 0) {
+                    var totalRatio = f.additions + f.deletions;
+                    var addBlocks = totalRatio > 0 ? Math.round((f.additions / totalRatio) * 5) : 0;
+                    var delBlocks = totalRatio > 0 ? Math.round((f.deletions / totalRatio) * 5) : 0;
+                    if (f.additions > 0 && addBlocks === 0)
+                        addBlocks = 1;
+                    if (f.deletions > 0 && delBlocks === 0)
+                        delBlocks = 1;
+                    while (addBlocks + delBlocks > 5) {
+                        if (addBlocks > delBlocks)
+                            addBlocks--;
+                        else
+                            delBlocks--;
+                    }
+                    var neutralBlocks = Math.max(0, 5 - addBlocks - delBlocks);
+                    for (var bi = 0; bi < addBlocks; bi++) {
+                        diffBlocks.push(h("span", { key: "a" + bi, style: { width: "3px", height: "8px", borderRadius: "1px", backgroundColor: "var(--dsw-alias-state-success-primary, #1a7f37)" } }));
+                    }
+                    for (var bj = 0; bj < delBlocks; bj++) {
+                        diffBlocks.push(h("span", { key: "d" + bj, style: { width: "3px", height: "8px", borderRadius: "1px", backgroundColor: "var(--dsw-alias-state-error-primary, #cf222e)" } }));
+                    }
+                    for (var bk = 0; bk < neutralBlocks; bk++) {
+                        diffBlocks.push(h("span", { key: "n" + bk, style: { width: "3px", height: "8px", borderRadius: "1px", backgroundColor: "var(--dsw-alias-border-subtle, rgba(0,0,0,0.15))" } }));
+                    }
+                }
+                return h("div", {
+                    key: idx,
+                    className: "dsh-github-stat-row",
+                    style: {
+                        display: "flex",
+                        alignItems: "center",
+                        justifyContent: "space-between",
+                        padding: "6px 10px",
+                        fontSize: "11px",
+                        lineHeight: "1.4",
+                        borderBottom: idx < parsedStat.files.length - 1 ? "1px solid var(--dsw-alias-border-subtle, rgba(0,0,0,0.06))" : "none",
+                        gap: "8px",
+                    },
+                    title: f.path + (f.isBinary ? " (二进制文件)" : ` (+${f.additions}, -${f.deletions})`),
+                }, h("div", {
+                    style: {
+                        fontFamily: "ui-monospace, SFMono-Regular, SF Mono, Menlo, Consolas, monospace",
+                        overflow: "hidden",
+                        textOverflow: "ellipsis",
+                        whiteSpace: "nowrap",
+                        flex: 1,
+                        minWidth: 0,
+                        color: "var(--dsw-alias-label-primary, #1f2328)",
+                    },
+                }, f.path), h("div", {
+                    style: {
+                        display: "flex",
+                        alignItems: "center",
+                        gap: "6px",
+                        flexShrink: 0,
+                        fontFamily: "monospace",
+                        fontWeight: 600,
+                    },
+                }, f.isBinary
+                    ? h("span", { style: { opacity: 0.6, fontSize: "10px" } }, "二进制")
+                    : [
+                        f.additions > 0
+                            ? h("span", {
+                                key: "add",
+                                style: { color: "var(--dsw-alias-state-success-primary, #1a7f37)" },
+                            }, `+${f.additions}`)
+                            : null,
+                        f.deletions > 0
+                            ? h("span", {
+                                key: "del",
+                                style: { color: "var(--dsw-alias-state-error-primary, #cf222e)" },
+                            }, `-${f.deletions}`)
+                            : null,
+                        diffBlocks.length > 0
+                            ? h("div", {
+                                key: "bar",
+                                style: { display: "flex", gap: "1px", marginLeft: "2px", alignItems: "center" },
+                            }, ...diffBlocks)
+                            : null,
+                    ]));
+            }))
+            : h("pre", {
+                className: "dsh-github-commit-pre",
+                style: {
+                    fontSize: "11px",
+                    lineHeight: "1.5",
+                    whiteSpace: "pre-wrap",
+                    wordBreak: "break-word",
+                    margin: 0,
+                    maxHeight: "34vh",
+                    overflowY: "auto",
+                    padding: "8px 10px",
+                    borderRadius: "6px",
+                    background: "var(--dsw-alias-bg-module-platform, #f6f8fa)",
+                    border: "1px solid var(--dsw-alias-border-l2, #e1e4e8)",
+                },
+            }, effectiveStat))
         : null, !effectiveBody && !effectiveStat
         ? (fetchingDetail
             ? h("div", { style: { fontSize: "12px", opacity: 0.7, padding: "8px 0" } }, "⏳ 正在获取详细变更说明…")
@@ -2509,7 +3086,7 @@ function GlobalSyncSettingsModal(props) {
                     ? "var(--dsw-alias-state-error-primary, #cf222e)"
                     : "var(--dsw-alias-label-secondary, #656d76)",
         },
-    }, updateMsg.text) : null)) : activeSection === "about" ? h("div", null, 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"))), h("div", {
+    }, updateMsg.text) : null)) : activeSection === "about" ? h("div", null, 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 工作区与云端协作，提供 18 大领域 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"))), h("div", {
         className: "dsh-github-about-star-box",
         style: {
             display: "flex",
@@ -2593,7 +3170,212 @@ function GlobalSyncSettingsModal(props) {
     }, activeSection === "sync" ? "取消" : "完成"))));
 }
 
+// ---- [Bundled: help-modal.js] ----
+/**
+ * 独立沉浸式指南大窗口组件 (Dedicated Large Reader Modal)
+ *
+ * 核心设计理由与交互契约：
+ * 1. 彻底从设置小窗口剥离，打造 920px 宽屏、85vh 高度的沉浸式阅读视界；
+ * 2. 深度适配 DSH 主题系统，全套样式基于 CSS 类与主题变量，支持深色 (data-ds-dark-theme) 与浅色无缝自适应；
+ * 3. 拒绝技术自嗨清单，从用户行动视角组织：3分钟快速上手、Agent实战Prompt、双界面图解与常见排错；
+ * 4. 宽屏卡片排列，配备 Prompt 一键复制到剪贴板与短暂反馈气泡；
+ * 5. 监听键盘 Esc 键与遮罩点击秒关，复制完指令直接回到聊天输入框发送，零打扰、不中断工作流。
+ */
+function GithubHelpModal(props) {
+    if (!props.isOpen)
+        return null;
+    var [activeTab, setActiveTab] = React.useState(props.initialTab || "quickstart");
+    var [copiedIdx, setCopiedIdx] = React.useState(-1);
+    React.useEffect(function () {
+        if (props.isOpen && props.initialTab) {
+            setActiveTab(props.initialTab);
+        }
+    }, [props.isOpen, props.initialTab]);
+    React.useEffect(function () {
+        var onKeyDown = function (e) {
+            if (e.key === "Escape" || e.keyCode === 27) {
+                props.onClose();
+            }
+        };
+        window.addEventListener("keydown", onKeyDown);
+        return function () { window.removeEventListener("keydown", onKeyDown); };
+    }, [props.onClose]);
+    var handleCopy = function (text, idx) {
+        if (navigator.clipboard) {
+            navigator.clipboard.writeText(text);
+            setCopiedIdx(idx);
+            setTimeout(function () { setCopiedIdx(-1); }, 2000);
+        }
+        else {
+            prompt("请复制提示词：", text);
+        }
+    };
+    var h = React.createElement;
+    // 1. 顶部 Tab 导航项
+    var tabs = [
+        { id: "quickstart", label: "🚀 3分钟极速上手" },
+        { id: "prompts", label: "🤖 Agent 提示词实战" },
+        { id: "panels", label: "🖥️ 两大界面操作图解" },
+        { id: "faq", label: "🔑 常见自愈排错" },
+    ];
+    // 2. 渲染各 Tab 独立视图
+    var renderContent = function () {
+        if (activeTab === "quickstart") {
+            return h("div", null, h("div", { className: "dsh-github-help-desc", style: { fontSize: "13px", marginBottom: "16px" } }, "欢迎使用 DSH GitHub Flow！本插件让 DeepSeek Harness Agent 具备直接操作 GitHub 仓库的能力，同时为你提供沉浸式的本地与云端协作工作台。跟着下面 3 步即可快速跑通你的第一个人机协作研发闭环："), [
+                {
+                    step: "1",
+                    title: "确认 GitHub CLI 登录状态",
+                    desc: "本插件直接复用宿主机已有的安全登录态，绝不触碰任何明文 Token。",
+                    actionText: "操作方式：在 DSH 任意聊天框输入 /gh 直接按回车；或查看右侧栏抽屉顶部的账号徽标。若显示未登录，在系统终端执行单行命令 gh auth login 即可完成授权。",
+                },
+                {
+                    step: "2",
+                    title: "打开你的代码仓库",
+                    desc: "在 DSH 中打开任何包含 .git 的项目文件夹，插件将自动毫秒级绑定当前仓库上下文。",
+                    actionText: "无需每次告诉 Agent 仓库叫什么名字，插件底层已自动完成 CWD 工作区绑定，提单与审查均精准面向当前项目。",
+                },
+                {
+                    step: "3",
+                    title: "直接向 Agent 下达工作指令",
+                    desc: "像和资深研发搭档协作一样，在聊天输入框中直接吩咐 Agent 处理日常 GitHub 任务。",
+                    actionText: "初次体验试一试直接对 Agent 说：\n👉 \"查看当前仓库有哪些开放的 PR，总结下改动要点\"",
+                },
+            ].map(function (s, i) {
+                return h("div", { key: i, className: "dsh-github-help-card", style: { display: "flex", gap: "14px", alignItems: "flex-start" } }, h("div", { className: "dsh-github-help-step-badge" }, s.step), h("div", { style: { flex: 1 } }, h("div", { className: "dsh-github-help-title", style: { marginBottom: "4px" } }, s.title), h("div", { className: "dsh-github-help-desc", style: { marginBottom: "6px" } }, s.desc), h("div", { style: { fontSize: "12px", lineHeight: "1.6", whiteSpace: "pre-line", color: "inherit" } }, s.actionText)));
+            }));
+        }
+        if (activeTab === "prompts") {
+            var promptCards = [
+                {
+                    title: "🔀 场景一：自动创建 PR 并发起代码审查",
+                    desc: "本地写完代码或实现新功能后，无需打开浏览器手动点点点，让 Agent 自主完成端到端提单。",
+                    prompt: "帮我把当前分支创建一个 PR，标题简明概括改动要点，附带详细描述",
+                    aiAction: "Agent 自动检查本地当前分支、比对与主干的 diff、推送到远程仓库并创建 GitHub PR，附带优雅的改动说明与关联标记。",
+                },
+                {
+                    title: "🚨 场景二：CI / Actions 门禁报错秒级排查与自动修复",
+                    desc: "构建挂了不用在网页反复翻几十页日志，直接吩咐 Agent 定位报错步骤并就地改代码。",
+                    prompt: "检查当前仓库最近一次 CI 失败的原因，精确定位报错步骤并帮我尝试修复代码",
+                    aiAction: "Agent 自动调用失败日志探测工具，秒级提取具体挂掉的构建步骤输出，精准定位语法/单测异常并就地修改本地代码。",
+                },
+                {
+                    title: "📌 场景三：早会与每日任务待办盘点",
+                    desc: "晨会前或开始工作时，一键拉取名下所有关联事项，做到心中有数。",
+                    prompt: "帮我看看今天在 GitHub 上分配给我的 Issue 待办与等待我评审的 PR，汇总近期动态",
+                    aiAction: "Agent 自动在账号维度跨仓库聚合所有分配给你的议题、等待评审的拉取请求以及提及你的动态，输出整洁紧凑的待办看板。",
+                },
+                {
+                    title: "🛡️ 场景四：代码差异 (Diff) 安全审查与重构建议",
+                    desc: "合并前把好最后一关，让大模型充当资深 Tech Lead 开展多维度代码走查。",
+                    prompt: "审查当前分支与主干的代码差异 (diff)，检查是否存在潜在 Bug 或安全隐患并给出重构建议",
+                    aiAction: "Agent 自动获取改动文件与行级差异，结合工程最佳实践逐项排查边界条件、内存泄漏、空指针与安全漏洞。",
+                },
+                {
+                    title: "💬 场景五：团队方案提案与开源 RFC 研讨",
+                    desc: "需要和团队讨论架构思路或征集想法时，直接将讨论沉淀在 GitHub Discussions 知识库中。",
+                    prompt: "在当前仓库发起一个关于 '优化前端构建性能' 的 RFC 讨论方案",
+                    aiAction: "Agent 自动调用 Discussions 工具在指定分类下发起主题，格式化排版技术方案正文，并返回可供团队直达探讨的链接。",
+                },
+            ];
+            return h("div", null, h("div", { className: "dsh-github-help-desc", style: { fontSize: "13px", marginBottom: "14px" } }, "以下精选了开发者日常研发中最高频的 5 大真实协作场景。点击卡片右侧的「📋 一键复制」按钮，直接粘贴到聊天输入框发给 Agent 即可："), promptCards.map(function (c, idx) {
+                var isCopied = copiedIdx === idx;
+                return h("div", { key: idx, className: "dsh-github-help-card" }, h("div", { style: { display: "flex", alignItems: "center", justifyContent: "space-between", marginBottom: "8px" } }, h("div", { className: "dsh-github-help-title" }, c.title), h("button", {
+                    className: "dsh-github-btn-sm",
+                    onClick: function () { handleCopy(c.prompt, idx); },
+                    style: {
+                        padding: "4px 10px",
+                        fontSize: "12px",
+                        background: isCopied ? "#2ea043" : "var(--dsw-alias-link, #0969da)",
+                        color: "#ffffff",
+                        borderColor: isCopied ? "#2ea043" : "var(--dsw-alias-link, #0969da)",
+                        fontWeight: 600,
+                        transition: "all 0.2s ease",
+                    },
+                }, isCopied ? "✅ 已复制到剪贴板！" : "📋 一键复制 Prompt")), h("div", { className: "dsh-github-help-desc", style: { marginBottom: "10px" } }, c.desc), h("div", { className: "dsh-github-prompt-box" }, `"${c.prompt}"`), h("div", { style: { fontSize: "11px", color: "var(--dsw-alias-state-attention-primary, #d29922)", lineHeight: "1.4" } }, "💡 " + c.aiAction));
+            }));
+        }
+        if (activeTab === "panels") {
+            return h("div", null, h("div", { className: "dsh-github-help-desc", style: { fontSize: "13px", marginBottom: "16px" } }, "插件为人类开发者量身打造了两套互补的可视化工作台，消灭频繁在 VS Code、终端与浏览器切屏的上下文丢失痛点："), [
+                {
+                    title: "1. 全景驾驶舱 (Main Dashboard) —— 掌控全局资产",
+                    items: [
+                        "打开入口：点击 DSH 最左侧主导航栏的 Octocat 猫咪徽标，瞬间全屏展开；",
+                        "SWR 0ms 瞬间秒开：采用本地持久化快照体系，打开界面零转圈、零等待；",
+                        "名下仓库一览：一屏透视名下所有 GitHub 仓库、默认分支与 Star 状态，支持一键切换工作区；",
+                        "三维待办 Issue 矩阵：智能划分「📥 用户提单（反馈到我名下仓库）」、「🎯 指派待办（分配给我）」与「✍️ 我发起的」，一键药丸筛选；",
+                        "全局配置中心：右上方提供数据同步节奏、网络代理与更新源的集中配置弹窗。",
+                    ],
+                },
+                {
+                    title: "2. 会话右侧栏面板 (Sidebar Panel) —— 深度协同当前工作区",
+                    items: [
+                        "打开入口：位于每个会话工作区的右侧抽屉栏，深度锁定当前会话的物理 Git 仓库；",
+                        "未提交改动 (Dirty Tab)：实时监听本地未提交文件列表与改动数量，开发改代码一目了然；",
+                        "分支查看与安全切换：点击分支名称下拉秒级搜索本地/远程分支；具备未提交变更安全拦截，杜绝代码被冲掉；",
+                        "Git 提交时间线 (Git Tab)：清晰三段式呈现待推送（领先）、待拉取（落后）与最近提交，点击任意提交行可弹出 Commit 完整详情弹窗；",
+                        "动静解耦架构：修改本地代码只定向查询本地 .git 核心元数据（耗时仅 5ms），绝对不发起远端网络请求，杜绝网络风暴。",
+                    ],
+                },
+            ].map(function (sec, idx) {
+                return h("div", { key: idx, className: "dsh-github-help-card" }, h("div", { className: "dsh-github-help-title", style: { marginBottom: "8px" } }, sec.title), h("ul", { style: { margin: 0, paddingLeft: "18px", fontSize: "12px", lineHeight: "1.7", color: "var(--dsw-alias-label-secondary, #8b949e)" } }, sec.items.map(function (it, i) { return h("li", { key: i }, it); })));
+            }));
+        }
+        if (activeTab === "faq") {
+            var faqs = [
+                {
+                    q: "Q1: 界面提示「未登录 GitHub」或「Authentication Required」怎么办？",
+                    a: "插件直接复用宿主系统的 GitHub CLI 登录态。请打开系统终端运行命令 `gh auth login`，依次选择 GitHub.com ➔ HTTPS ➔ 网页回车授权，一分钟内即可完成登录。登录完成后刷新界面即可自动识别。",
+                },
+                {
+                    q: "Q2: 提示「缺少权限 (Scope)」或「SCOPE_REQUIRED」怎么办？",
+                    a: "当调用项目看板（Projects v2）或云端开发机（Codespaces）时，GitHub 要求专有的 Token Scope。在系统终端执行对应的一键自愈命令完成增量授权即可（无需重新登录）：\n- 项目看板：`gh auth refresh -s read:project`\n- 云端开发机：`gh auth refresh -h github.com -s codespace`",
+                },
+                {
+                    q: "Q3: 点击一键升级提示「处于 24h 安全保护期 (防投毒策略)」怎么办？",
+                    a: "这是 DSH 官方内置包管理器针对刚发布未满 24 小时新版本的供应链防投毒安全锁机制。\n- 立即体验：请先【完全退出关闭 DSH 应用程序】，然后在系统终端执行复制的手动安装命令；\n- 稍后升级：无需任何操作，新版本发版满 24 小时后，再次点击一键升级即可自动安装。",
+                },
+                {
+                    q: "Q4: 使用代理节点时偶尔出现网络波动怎么办？",
+                    a: "插件内置了 1s ➔ 2s ➔ 4s 的阶梯指数退避重试机制。代理节点若发生短时抖动断流，系统会自动在后台静默发起自愈重试，在节点恢复后瞬间平滑拉取最新数据，不会立刻亮出大红横幅打扰你。同时电脑联网恢复瞬间也会自动触发静默更新。",
+                },
+            ];
+            return h("div", null, h("div", { className: "dsh-github-help-desc", style: { fontSize: "13px", marginBottom: "14px" } }, "常见环境、权限与网络问题的排查与自愈指引："), faqs.map(function (f, idx) {
+                return h("div", { key: idx, className: "dsh-github-help-card" }, h("div", { className: "dsh-github-help-title", style: { marginBottom: "6px", fontSize: "13px" } }, f.q), h("div", { className: "dsh-github-help-desc", style: { lineHeight: "1.6", whiteSpace: "pre-line" } }, f.a));
+            }));
+        }
+        return null;
+    };
+    return h("div", { className: "dsh-github-modal-overlay", onClick: props.onClose }, h("div", {
+        className: "dsh-github-help-dialog",
+        onClick: function (e) { e.stopPropagation(); },
+    }, 
+    // 顶部标题栏
+    h("div", { className: "dsh-github-help-header" }, h("div", { style: { display: "flex", alignItems: "center", gap: "8px" } }, h("span", { style: { fontSize: "20px" } }, "📖"), h("h3", { style: { margin: 0, fontSize: "16px", fontWeight: 600, color: "inherit" } }, "DSH GitHub Flow · 使用指南与实战手册")), h("button", {
+        style: { background: "none", border: "none", cursor: "pointer", fontSize: "18px", color: "var(--dsw-alias-label-secondary, #8b949e)", padding: "0 4px" },
+        onClick: props.onClose,
+        title: "关闭 (Esc)",
+    }, "✕")), 
+    // 顶部四分类 Segment 导航栏
+    h("div", { className: "dsh-github-help-nav" }, tabs.map(function (t) {
+        var isActive = activeTab === t.id;
+        return h("button", {
+            key: t.id,
+            className: "dsh-github-help-tab-btn" + (isActive ? " active" : ""),
+            onClick: function () { setActiveTab(t.id); },
+        }, t.label);
+    })), 
+    // 主内容滚动区
+    h("div", { className: "dsh-github-help-scroll-body" }, renderContent()), 
+    // 底部工具栏
+    h("div", { className: "dsh-github-help-footer" }, h("div", { style: { fontSize: "12px", color: "var(--dsw-alias-label-tertiary, #8c959f)" } }, "💡 提示：按键盘 Esc 键可随时快速关闭大窗口返回会话"), h("button", {
+        className: "dsh-github-btn-sm",
+        style: { padding: "6px 16px", fontWeight: 600 },
+        onClick: props.onClose,
+    }, "关闭窗口"))));
+}
+
 
+        var currentPluginCtx = null;
         /**
          * 按容器记录的 Tab 键应用互斥显示状态（hidden 页 + active 按钮）。
          * 模块级纯 DOM 操作：渲染函数（switchTab 点击路径）与宿主组件的 effect
@@ -2601,6 +3383,11 @@ function GlobalSyncSettingsModal(props) {
          * 重设 hidden/active，用户手动切的 Tab 会被一次后台数据同步拽回默认页。
          */
         function applyTabState(container, tabKey) {
+            container.setAttribute("data-active-tab", tabKey);
+            var rightbar = container.closest(".dsh-github-rightbar-container");
+            if (rightbar) {
+                rightbar.setAttribute("data-active-tab", tabKey);
+            }
             var pages = container.querySelectorAll("[data-tab-page]");
             pages.forEach(function (page) {
                 page.hidden = page.getAttribute("data-tab-page") !== tabKey;
@@ -2612,8 +3399,234 @@ function GlobalSyncSettingsModal(props) {
                 btn.setAttribute("aria-selected", active ? "true" : "false");
             });
         }
-        // 渲染 GitHub 仓库信息与操作视图的核心函数
-        function renderGithubRepoView(h, data, loading, error, onRefresh, isRightbar = false, updateInfo = null, syncStatus = "", lastSyncedAt = 0, onOpenSettings = null, cwd = null, onSelectCommit = null, gitLogPagination = null, onShowToast = null) {
+        /**
+         * 未提交文件原生二级 Git Diff 下钻视图组件（右侧栏内就地渲染，零模态遮罩）
+         */
+        function UncommittedDiffView(props) {
+            var f = props.file;
+            var h = React.createElement;
+            var [diffData, setDiffData] = React.useState(null);
+            var [loading, setLoading] = React.useState(true);
+            var [error, setError] = React.useState(null);
+            var [copied, setCopied] = React.useState(false);
+            React.useEffect(function () {
+                var onKeyDown = function (e) {
+                    if (e.key === "Escape" || e.keyCode === 27) {
+                        props.onBack();
+                    }
+                };
+                window.addEventListener("keydown", onKeyDown);
+                return function () { window.removeEventListener("keydown", onKeyDown); };
+            }, [props.onBack]);
+            React.useEffect(function () {
+                setLoading(true);
+                setError(null);
+                setDiffData(null);
+                var fetchDiff = async function () {
+                    var primaryUrl = "/api/github/file-diff?file=" + encodeURIComponent(f.path) + (props.cwd ? "&cwd=" + encodeURIComponent(props.cwd) : "");
+                    var tryParseResponse = async function (res) {
+                        var text = await res.text().catch(function () { return ""; });
+                        var json = null;
+                        if (text && (text.trim().startsWith("{") || text.trim().startsWith("["))) {
+                            try {
+                                json = JSON.parse(text);
+                            }
+                            catch (e) { }
+                        }
+                        return { ok: res.ok, status: res.status, text: text, json: json };
+                    };
+                    try {
+                        var r1 = await fetch(primaryUrl);
+                        var p1 = await tryParseResponse(r1);
+                        if (p1.ok && p1.json && p1.json.ok && p1.json.data) {
+                            setDiffData(p1.json.data);
+                            setLoading(false);
+                            return;
+                        }
+                        // 若主路由遇到 404 (后端常驻进程未重启)，自动降级请求常驻的 /api/github/action 端点
+                        if (p1.status === 404) {
+                            var r2 = await fetch("/api/github/action", {
+                                method: "POST",
+                                headers: { "Content-Type": "application/json" },
+                                body: JSON.stringify({
+                                    action: "get_file_diff",
+                                    file: f.path,
+                                    cwd: props.cwd || undefined,
+                                }),
+                            }).catch(function () { return null; });
+                            if (r2) {
+                                var p2 = await tryParseResponse(r2);
+                                if (p2.ok && p2.json && p2.json.data) {
+                                    setDiffData(p2.json.data);
+                                    setLoading(false);
+                                    return;
+                                }
+                            }
+                            setLoading(false);
+                            setError("后端对比接口未激活 (404)。请重启 DSH 桌面主程序以载入最新对比引擎；您也可点击上方「在 DSH 中打开」直接预览文件源码。");
+                            return;
+                        }
+                        setLoading(false);
+                        setError(p1.json?.error || p1.text || ("查询差异失败 (HTTP " + p1.status + ")"));
+                    }
+                    catch (err) {
+                        setLoading(false);
+                        setError(err?.message || "网络请求异常");
+                    }
+                };
+                fetchDiff();
+            }, [f.path, props.cwd]);
+            var copyDiff = function () {
+                if (!diffData?.diff)
+                    return;
+                if (navigator?.clipboard?.writeText) {
+                    navigator.clipboard.writeText(diffData.diff).then(function () {
+                        setCopied(true);
+                        setTimeout(function () { setCopied(false); }, 2000);
+                    }).catch(function () { });
+                }
+            };
+            var statusColor = f.status === "??" ? "var(--dsw-alias-state-success-primary, #1a7f37)"
+                : f.status.indexOf("D") >= 0 ? "var(--dsw-alias-state-error-primary, #cf222e)"
+                    : "var(--dsw-alias-state-attention-primary, #9a6700)";
+            var statusText = f.status === "??" ? "未跟踪新增"
+                : f.status.indexOf("D") >= 0 ? "已删除"
+                    : f.status.indexOf("R") >= 0 ? "已重命名"
+                        : "已修改";
+            return h("div", {
+                className: "dsh-github-inline-diff-view",
+                style: {
+                    display: "flex",
+                    flexDirection: "column",
+                    gap: "8px",
+                    minHeight: "260px",
+                    padding: "4px 0",
+                },
+            }, 
+            // 顶部操作与状态栏
+            h("div", {
+                style: {
+                    display: "flex",
+                    alignItems: "center",
+                    justifyContent: "space-between",
+                    flexWrap: "wrap",
+                    gap: "6px",
+                    paddingBottom: "8px",
+                    borderBottom: "1px solid var(--dsw-alias-border-subtle, rgba(0,0,0,0.1))",
+                },
+            }, h("div", { style: { display: "flex", alignItems: "center", gap: "6px" } }, h("button", {
+                className: "dsh-github-btn-sm",
+                style: { padding: "3px 8px", cursor: "pointer", fontWeight: 600, fontSize: "11px" },
+                onClick: props.onBack,
+                title: "返回未提交文件清单 (Esc)",
+            }, "← 返回列表"), h("span", {
+                className: "dsh-github-badge",
+                style: {
+                    backgroundColor: statusColor + "22",
+                    color: statusColor,
+                    fontWeight: 600,
+                    fontSize: "11px",
+                },
+            }, `${f.status} ${statusText}`), diffData && diffData.additions !== undefined
+                ? h("div", { style: { display: "flex", gap: "4px", fontSize: "11px", fontFamily: "monospace" } }, h("span", { style: { color: "var(--dsw-alias-state-success-primary, #1a7f37)", fontWeight: 600 } }, `+${diffData.additions}`), h("span", { style: { color: "var(--dsw-alias-state-error-primary, #cf222e)", fontWeight: 600 } }, `-${diffData.deletions}`))
+                : null), h("div", { style: { display: "flex", alignItems: "center", gap: "6px" } }, diffData?.diff
+                ? h("button", {
+                    className: "dsh-github-btn-sm",
+                    style: { padding: "3px 8px", fontSize: "11px", cursor: "pointer" },
+                    onClick: copyDiff,
+                    title: "复制 Unified Diff 原文",
+                }, copied ? "✓ 已复制" : "📋 复制 Diff")
+                : null, props.onOpenInDsh
+                ? h("button", {
+                    className: "dsh-github-btn-sm",
+                    style: { padding: "3px 8px", fontSize: "11px", cursor: "pointer" },
+                    onClick: function () {
+                        if (props.onOpenInDsh)
+                            props.onOpenInDsh(f.path);
+                    },
+                    title: "在 DSH 侧边栏打开查看该文件完整源码",
+                }, "📄 在 DSH 中打开")
+                : null)), 
+            // 文件路径栏
+            h("div", {
+                style: {
+                    fontSize: "11px",
+                    fontFamily: "monospace",
+                    color: "var(--dsw-alias-label-secondary, #656d76)",
+                    wordBreak: "break-all",
+                    padding: "3px 6px",
+                    backgroundColor: "var(--dsw-alias-bg-subtle, rgba(0,0,0,0.03))",
+                    borderRadius: "4px",
+                },
+                title: f.path,
+            }, f.path), 
+            // Diff 主体内容
+            loading
+                ? h("div", { style: { padding: "32px 0", textAlign: "center", opacity: 0.65, fontSize: "12px" } }, "⏳ 正在计算 Git 代码比对差异...")
+                : error
+                    ? h("div", {
+                        style: {
+                            padding: "16px",
+                            color: "var(--dsw-alias-label-primary, #1f2328)",
+                            fontSize: "12px",
+                            lineHeight: "1.6",
+                            backgroundColor: "var(--dsw-alias-bg-subtle, rgba(0,0,0,0.03))",
+                            borderRadius: "6px",
+                        },
+                    }, h("div", { style: { color: "var(--dsw-alias-state-error-primary, #cf222e)", fontWeight: 600, marginBottom: "6px" } }, `⚠️ ${error}`), h("div", { style: { fontSize: "11px", opacity: 0.75 } }, "💡 提示：重启 DSH 桌面主程序即可激活本地比对路由；在此期间您也可点击上方「📄 在 DSH 中打开」直接预览文件源码。"))
+                    : diffData?.isBinary
+                        ? h("div", { style: { padding: "32px 0", textAlign: "center", opacity: 0.8, fontSize: "12px" } }, "📦 该文件为二进制格式（图片或编译产物），无法直接展示文本差异。")
+                        : h("div", {
+                            className: "dsh-github-inline-diff-content",
+                            style: {
+                                margin: 0,
+                                padding: "4px 0",
+                                fontFamily: "ui-monospace, SFMono-Regular, SF Mono, Menlo, Consolas, monospace",
+                                fontSize: "11px",
+                                lineHeight: "1.5",
+                                overflowX: "auto",
+                                maxHeight: "68vh",
+                                borderRadius: "6px",
+                                border: "1px solid var(--dsw-alias-border-subtle, rgba(0,0,0,0.08))",
+                                backgroundColor: "var(--dsw-alias-bg-canvas, #ffffff)",
+                            },
+                        }, (diffData?.diff || "").split("\n").map(function (line, idx) {
+                            var isAdd = line.startsWith("+") && !line.startsWith("+++");
+                            var isDel = line.startsWith("-") && !line.startsWith("---");
+                            var isHunk = line.startsWith("@@");
+                            var isHeader = line.startsWith("diff --git") || line.startsWith("index ") || line.startsWith("---") || line.startsWith("+++");
+                            var lineStyle = {
+                                display: "flex",
+                                padding: "0 8px",
+                                whiteSpace: "pre",
+                                minWidth: "100%",
+                                boxSizing: "border-box",
+                            };
+                            if (isAdd) {
+                                lineStyle.backgroundColor = "var(--dsw-alias-state-success-subtle, rgba(46,160,67,0.15))";
+                                lineStyle.color = "var(--dsw-alias-state-success-primary, #1a7f37)";
+                            }
+                            else if (isDel) {
+                                lineStyle.backgroundColor = "var(--dsw-alias-state-error-subtle, rgba(248,81,73,0.15))";
+                                lineStyle.color = "var(--dsw-alias-state-error-primary, #cf222e)";
+                            }
+                            else if (isHunk) {
+                                lineStyle.backgroundColor = "var(--dsw-alias-bg-subtle, rgba(0,0,0,0.04))";
+                                lineStyle.color = "var(--dsw-alias-label-secondary, #656d76)";
+                                lineStyle.fontWeight = 600;
+                                lineStyle.margin = "2px 0";
+                            }
+                            else if (isHeader) {
+                                lineStyle.color = "var(--dsw-alias-label-muted, #8c959f)";
+                                lineStyle.fontSize = "10px";
+                            }
+                            else {
+                                lineStyle.color = "var(--dsw-alias-label-primary, #1f2328)";
+                            }
+                            return h("div", { key: idx, style: lineStyle }, line || " ");
+                        })));
+        }
+        function renderGithubRepoView(h, data, loading, error, onRefresh, isRightbar = false, updateInfo = null, syncStatus = "", lastSyncedAt = 0, onOpenSettings = null, cwd = null, onSelectCommit = null, gitLogPagination = null, onShowToast = null, onOpenHelp = null, onOpenFile = null, dirtyPagination = null, activeDiffFile = null, onSelectDiffFile = null, onCloseDiff = null, onOpenInDsh = null, headerCardsVisible = true, onToggleHeaderCards = null) {
             var auth = data ? data.auth : null;
             var repo = data ? data.repo : null;
             var prs = (data && data.pullRequests) || [];
@@ -2637,20 +3650,56 @@ function GlobalSyncSettingsModal(props) {
                     },
                 })
                 : 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 工作台"), renderPluginBadge(h), syncStatus ? h(SyncStatusBadge, { syncStatus, lastSyncedAt, isRightbar }) : null), h("div", { style: { display: "flex", alignItems: "center", gap: "6px" } }, 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" } }, isRightbar && onToggleHeaderCards ? h("button", {
+                className: "dsh-github-btn-sm" + (!headerCardsVisible ? " active" : ""),
+                onClick: onToggleHeaderCards,
+                title: headerCardsVisible ? "收起上方仓库信息与快捷操作栏（增加下方工作区高度）" : "展开上方仓库信息与快捷操作栏",
+                style: {
+                    padding: "4px 8px",
+                    fontSize: "11px",
+                    fontWeight: 600,
+                    display: "inline-flex",
+                    alignItems: "center",
+                    gap: "3px",
+                    cursor: "pointer",
+                },
+                "aria-expanded": headerCardsVisible ? "true" : "false",
+            }, headerCardsVisible ? "🔼 收起" : "🔽 展开") : null, h("button", {
                 className: "dsh-github-refresh-btn",
                 onClick: onRefresh,
                 disabled: loading,
-            }, loading ? "刷新中..." : "🔄 刷新"), onOpenSettings ? h("button", {
+            }, loading ? "刷新中..." : "🔄 刷新"), (onOpenHelp || onOpenSettings) ? h("button", {
+                className: "dsh-github-btn-sm",
+                onClick: () => (onOpenHelp ? onOpenHelp() : (onOpenSettings && onOpenSettings("help"))),
+                title: "打开使用帮助与实战手册大窗口（Esc 可退出）",
+                style: { padding: "4px 8px", fontSize: "12px" },
+            }, "❓") : null, onOpenSettings ? h("button", {
                 className: "dsh-github-btn-sm",
-                onClick: onOpenSettings,
+                onClick: () => onOpenSettings("sync"),
                 title: "配置数据同步节奏、本地缓存、网络代理与插件信息",
                 style: { padding: "4px 10px" },
             }, "⚙️") : null));
             var gitSt = data && data.gitStatus;
             var relInfo = data && data.releaseInfo;
             var branchPr = data && data.branchPr;
-            var repoCardEl = h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title" }, "当前工作区 GitHub 仓库"), h("div", { className: "dsh-github-card-value" }, repo
+            var repoCardEl = h("div", { className: "dsh-github-card" }, h("div", { className: "dsh-github-card-title", style: { display: "flex", justifyContent: "space-between", alignItems: "center" } }, h("span", null, "当前工作区 GitHub 仓库"), repo && repo.stargazerCount !== undefined
+                ? h("a", {
+                    href: `${repo.url}/stargazers`,
+                    target: "_blank",
+                    className: "dsh-github-badge",
+                    style: {
+                        textDecoration: "none",
+                        display: "inline-flex",
+                        alignItems: "center",
+                        gap: "3px",
+                        fontWeight: 600,
+                        fontSize: "11px",
+                        cursor: "pointer",
+                        padding: "1px 6px",
+                    },
+                    title: `当前仓库 Star 数量: ${repo.stargazerCount}（点击前往 GitHub 查看）`,
+                }, "⭐ ", String(repo.stargazerCount))
+                : null), h("div", { className: "dsh-github-card-value" }, repo
                 ? h("a", { href: repo.url, target: "_blank", className: "dsh-github-repo-link" }, repo.nameWithOwner)
                 : h("span", { style: { color: "var(--dsw-alias-state-error-primary, #cf222e)" } }, "未检测到关联的 GitHub 仓库"), repo
                 ? h(BranchSelectorDropdown, {
@@ -2762,25 +3811,86 @@ function GlobalSyncSettingsModal(props) {
                     ? h("a", { className: "dsh-github-item-title", href: branchPr.url, target: "_blank" }, `PR #${branchPr.number} ${branchPr.title}`)
                     : h("span", { className: "dsh-github-item-title" }, `PR #${branchPr.number} ${branchPr.title}`), branchPr.isDraft ? h("span", { className: "dsh-github-badge dsh-badge-yellow" }, "DRAFT") : null)
                 : null);
-            var dirtySectionEl = h("div", { className: "dsh-github-section" }, h("div", { className: "dsh-github-section-header" }, h("h3", null, `📁 未提交清单 (${gitSt ? gitSt.dirtyCount : 0})`)), !gitSt || gitSt.dirtyCount === 0
-                ? h("div", { className: "dsh-github-empty" }, "工作区干净，没有未提交的变更 ✓")
-                : h("div", { style: { fontSize: "12px", lineHeight: "1.9" } }, (gitSt.dirtyFiles || []).map(function (f, i) {
-                    return h("div", { key: i, style: { display: "flex", gap: "8px", padding: "2px 4px", borderRadius: "4px" } }, h("span", {
-                        style: {
-                            minWidth: "24px",
-                            textAlign: "center",
-                            opacity: 0.75,
-                            fontSize: "11px",
-                            fontFamily: "monospace",
-                            color: f.status === "??" ? "var(--dsw-alias-state-success-primary, #1a7f37)"
-                                : f.status.indexOf("D") >= 0 ? "var(--dsw-alias-state-error-primary, #cf222e)"
-                                    : f.status.indexOf("M") >= 0 || f.status.indexOf("R") >= 0 ? "var(--dsw-alias-state-attention-primary, #9a6700)"
-                                        : "inherit",
-                        },
-                    }, f.status === "??" ? "??" : f.status), h("span", { style: { wordBreak: "break-all" } }, f.path));
-                }), gitSt.dirtyCount > (gitSt.dirtyFiles || []).length
-                    ? h("div", { style: { opacity: 0.6, marginTop: "6px" } }, `…共 ${gitSt.dirtyCount} 个变更（仅列前 ${(gitSt.dirtyFiles || []).length}）`)
-                    : null));
+            var baseDirty = (gitSt && gitSt.dirtyFiles) || [];
+            var extraDirty = (dirtyPagination && dirtyPagination.extraDirtyFiles) || [];
+            var allDirtyFiles = [];
+            var seenDirtyPaths = new Set();
+            baseDirty.concat(extraDirty).forEach(function (f) {
+                if (f && f.path && !seenDirtyPaths.has(f.path)) {
+                    seenDirtyPaths.add(f.path);
+                    allDirtyFiles.push(f);
+                }
+            });
+            var visibleDirtyLimit = (dirtyPagination && dirtyPagination.visibleCount) || 15;
+            var displayedDirty = allDirtyFiles.slice(0, visibleDirtyLimit);
+            var totalDirtyCount = gitSt ? gitSt.dirtyCount : allDirtyFiles.length;
+            var hasMoreDirtyToLoad = displayedDirty.length < totalDirtyCount;
+            var dirtyHeaderTitle = gitSt && totalDirtyCount > displayedDirty.length
+                ? `📁 未提交清单 (${displayedDirty.length} / ${totalDirtyCount})`
+                : `📁 未提交清单 (${gitSt ? gitSt.dirtyCount : 0})`;
+            var dirtySectionEl = activeDiffFile
+                ? h(UncommittedDiffView, {
+                    file: activeDiffFile,
+                    onBack: onCloseDiff || (() => { }),
+                    cwd: cwd,
+                    onOpenInDsh: onOpenInDsh,
+                })
+                : h("div", { className: "dsh-github-section" }, h("div", { className: "dsh-github-section-header" }, h("h3", null, dirtyHeaderTitle)), !gitSt || gitSt.dirtyCount === 0
+                    ? h("div", { className: "dsh-github-empty" }, "工作区干净，没有未提交的变更 ✓")
+                    : h("div", { style: { fontSize: "12px", lineHeight: "1.9" } }, displayedDirty.map(function (f, i) {
+                        var statusColor = f.status === "??" ? "var(--dsw-alias-state-success-primary, #1a7f37)"
+                            : f.status.indexOf("D") >= 0 ? "var(--dsw-alias-state-error-primary, #cf222e)"
+                                : f.status.indexOf("M") >= 0 || f.status.indexOf("R") >= 0 ? "var(--dsw-alias-state-attention-primary, #9a6700)"
+                                    : "inherit";
+                        var statusText = f.status === "??" ? "未跟踪新增"
+                            : f.status.indexOf("D") >= 0 ? "已删除"
+                                : f.status.indexOf("R") >= 0 ? "已重命名"
+                                    : "已修改";
+                        return h("div", {
+                            key: f.path || i,
+                            className: "dsh-github-dirty-item",
+                            title: `${f.path} (${statusText} [${f.status}])\n点击查看代码改动对比 (Unified Diff)`,
+                            onClick: function () {
+                                if (typeof onSelectDiffFile === "function") {
+                                    onSelectDiffFile(f);
+                                }
+                            },
+                        }, h("span", {
+                            style: {
+                                minWidth: "24px",
+                                textAlign: "center",
+                                opacity: 0.85,
+                                fontSize: "11px",
+                                fontFamily: "monospace",
+                                color: statusColor,
+                                fontWeight: 600,
+                            },
+                        }, f.status === "??" ? "??" : f.status), h("span", { style: { wordBreak: "break-all", flex: 1, fontSize: "12px" } }, f.path));
+                    }), hasMoreDirtyToLoad
+                        ? h("div", { style: { marginTop: "10px", textAlign: "center" } }, dirtyPagination?.loadingMore
+                            ? h("div", { style: { fontSize: "11px", opacity: 0.75, padding: "6px 0" } }, "⏳ 正在加载更多未提交变更…")
+                            : h("div", {
+                                style: {
+                                    fontSize: "11px",
+                                    opacity: 0.7,
+                                    padding: "6px 0",
+                                    display: "flex",
+                                    alignItems: "center",
+                                    justifyContent: "center",
+                                    gap: "6px",
+                                    cursor: "pointer",
+                                    borderRadius: "4px",
+                                },
+                                title: "向下滑动滚轮或点击加载更多",
+                                onClick: function () {
+                                    if (dirtyPagination && typeof dirtyPagination.onLoadMore === "function") {
+                                        dirtyPagination.onLoadMore();
+                                    }
+                                },
+                            }, h("span", null, "⬇️ 向下滑动自动加载"), h("span", { style: { fontFamily: "monospace" } }, `(${displayedDirty.length} / ${totalDirtyCount})`)))
+                        : totalDirtyCount > 15
+                            ? h("div", { style: { textAlign: "center", fontSize: "11px", opacity: 0.5, padding: "6px 0", marginTop: "8px" } }, `✓ 已加载全部 ${totalDirtyCount} 个未提交变更`)
+                            : null));
             // 快捷操作栏 (仅在检测到关联仓库时展示，未绑定仓库时不展示虚假按钮)
             var actionsBarEl = repo ? h("div", { className: "dsh-github-quick-actions" }, h("button", {
                 className: "dsh-github-action-btn",
@@ -2907,6 +4017,10 @@ function GlobalSyncSettingsModal(props) {
             var switchTab = function (container, tabKey) {
                 container.setAttribute("data-active-tab", tabKey);
                 applyTabState(container, tabKey);
+                var rightbar = container.closest(".dsh-github-rightbar-container");
+                if (rightbar) {
+                    rightbar.setAttribute("data-active-tab", tabKey);
+                }
             };
             var tabsBarEl = h("div", { className: "dsh-github-tabs", style: { marginBottom: "12px" } }, ...TAB_DEFS.map(function (t) {
                 var labelText = t.count !== null ? `${t.label} (${t.count})` : t.label;
@@ -2923,7 +4037,15 @@ function GlobalSyncSettingsModal(props) {
                 }, t.icon ? [t.icon, " ", labelText] : labelText);
             }));
             var tabbedContentEl = h("div", { "data-active-tab": defaultTab }, tabsBarEl, h("div", { "data-tab-page": "prs", hidden: defaultTab !== "prs" }, prSectionEl), h("div", { "data-tab-page": "issues", hidden: defaultTab !== "issues" }, issueSectionEl), h("div", { "data-tab-page": "runs", hidden: defaultTab !== "runs" }, runSectionEl), gitSt ? h("div", { "data-tab-page": "git", hidden: defaultTab !== "git" }, gitSectionEl) : null, gitSt ? h("div", { "data-tab-page": "dirty", hidden: defaultTab !== "dirty" }, dirtySectionEl) : null);
-            return [headerEl, networkAlertBannerEl, upgradeBannerEl, authGuideEl, repoCardEl, actionsBarEl, tabbedContentEl].filter(Boolean);
+            return [
+                headerEl,
+                networkAlertBannerEl,
+                upgradeBannerEl,
+                authGuideEl,
+                headerCardsVisible ? repoCardEl : null,
+                headerCardsVisible ? actionsBarEl : null,
+                tabbedContentEl,
+            ].filter(Boolean);
         }
         // 1. 右侧栏专属视图 (Right Sidebar Tab Body)
         function GithubRightbarBody(props) {
@@ -3025,10 +4147,19 @@ function GlobalSyncSettingsModal(props) {
                     if (params.length > 0) {
                         url += "?" + params.join("&");
                     }
-                    var res = await fetch(url, { signal: controller.signal });
+                    // 接入 1s/2s/4s 阶梯退避重试，平滑吸收代理节点与网络的偶发抖动断流
+                    var { res, json } = await fetchWithRetry(url, {}, {
+                        signal: controller.signal,
+                        maxRetries: 3,
+                        baseDelayMs: 1000,
+                        onRetry: (attempt) => {
+                            setSyncStatus("syncing");
+                            setError(`网络抖动，正在自愈重试 (${attempt}/3)...`);
+                        },
+                    });
                     if (!res.ok) {
-                        var errText = await res.text().catch(() => "");
-                        var msg = `后端服务未就绪 (${res.status}): ${errText || res.statusText}`;
+                        var errText = (typeof json === "string" ? json : JSON.stringify(json)) || res.statusText;
+                        var msg = `后端服务未就绪 (${res.status}): ${errText}`;
                         setSyncStatus("failed");
                         setError(msg);
                         if (forceRefresh) {
@@ -3036,7 +4167,6 @@ function GlobalSyncSettingsModal(props) {
                         }
                         return;
                     }
-                    var json = await res.json();
                     if (json.ok && json.data) {
                         var isFail = Boolean(json.partialFailure ||
                             json.data.partialFailure ||
@@ -3150,6 +4280,34 @@ function GlobalSyncSettingsModal(props) {
                         clearTimeout(cloudTimerRef.current);
                 };
             }, [cwd, sessionId, syncSettings.strategy, syncSettings.cloudSyncIntervalMs, loadData]);
+            // 纯本地 Git 状态局部刷新：只更新未提交改动(Dirty)、分支与提交记录，彻底切断连带远端网络风暴
+            var refreshLocalGit = React.useCallback(async () => {
+                if (!cwd)
+                    return;
+                try {
+                    var res = await fetch("/api/github/local-git-status?cwd=" + encodeURIComponent(String(cwd)));
+                    if (!res.ok)
+                        return;
+                    var json = await res.json().catch(() => null);
+                    if (json && json.ok && json.data) {
+                        setData((prev) => {
+                            if (!prev)
+                                return prev;
+                            var next = {
+                                ...prev,
+                                gitStatus: json.data.gitStatus !== undefined ? json.data.gitStatus : prev.gitStatus,
+                                commitLog: json.data.commitLog !== undefined ? json.data.commitLog : prev.commitLog,
+                                branches: json.data.branches !== undefined ? json.data.branches : prev.branches,
+                            };
+                            saveStoredRightbarData(cwd, next);
+                            return next;
+                        });
+                    }
+                }
+                catch {
+                    // 纯本地静默更新，网络异常或组件卸载不打扰用户
+                }
+            }, [cwd]);
             React.useEffect(() => {
                 if (!syncSettings.localGitWatch || !cwd || !data?.repo)
                     return;
@@ -3169,7 +4327,8 @@ function GlobalSyncSettingsModal(props) {
                             if (aborted)
                                 break;
                             if (json && json.changed) {
-                                loadData(false);
+                                // 仅局部刷新本地未提交文件、分支与提交记录，零网络流量，彻底切断连带远端网络风暴！
+                                refreshLocalGit();
                             }
                         }
                         catch (err) {
@@ -3184,7 +4343,7 @@ function GlobalSyncSettingsModal(props) {
                     aborted = true;
                     watchController.abort();
                 };
-            }, [cwd, data?.repo, syncSettings.localGitWatch, loadData]);
+            }, [cwd, data?.repo, syncSettings.localGitWatch, refreshLocalGit]);
             React.useEffect(() => {
                 var container = containerRef && containerRef.current;
                 if (!container)
@@ -3206,22 +4365,49 @@ function GlobalSyncSettingsModal(props) {
                             .catch(function () { });
                     }
                     else if (syncSettings.localGitWatch && data?.repo) {
-                        loadData(false);
+                        // 聚焦时若开启了本地 Git 监听，仅局部刷新本地状态，杜绝多余远端请求
+                        refreshLocalGit();
                     }
                 };
+                var onOnline = () => {
+                    // 监听网络由断网恢复连接瞬间，自动静默发起一次全量同步，消除离线警告横幅并拉新
+                    loadData(false);
+                };
                 window.addEventListener("focus", onFocus);
-                return () => window.removeEventListener("focus", onFocus);
-            }, [data, loadData, syncSettings.localGitWatch]);
+                window.addEventListener("online", onOnline);
+                return () => {
+                    window.removeEventListener("focus", onFocus);
+                    window.removeEventListener("online", onOnline);
+                };
+            }, [data, loadData, refreshLocalGit, syncSettings.localGitWatch]);
             var [aboutModalOpen, setAboutModalOpen] = React.useState(false);
             var [rightbarModalOpen, setRightbarModalOpen] = React.useState(false);
             var [rightbarModalSection, setRightbarModalSection] = React.useState("sync");
+            var [helpModalOpen, setHelpModalOpen] = React.useState(false);
             var [selectedCommit, setSelectedCommit] = React.useState(null);
             var [extraCommits, setExtraCommits] = React.useState([]);
             var [loadingMore, setLoadingMore] = React.useState(false);
             var [hasMoreCommits, setHasMoreCommits] = React.useState(true);
+            var [visibleDirtyCount, setVisibleDirtyCount] = React.useState(15);
+            var [extraDirtyFiles, setExtraDirtyFiles] = React.useState([]);
+            var [loadingMoreDirty, setLoadingMoreDirty] = React.useState(false);
+            var [hasMoreDirty, setHasMoreDirty] = React.useState(true);
+            var [activeDiffFile, setActiveDiffFile] = React.useState(null);
+            var [headerCardsVisible, setHeaderCardsVisible] = React.useState(() => getStoredHeaderCardsVisible());
+            var toggleHeaderCards = React.useCallback(() => {
+                setHeaderCardsVisible(function (prev) {
+                    var next = !prev;
+                    saveStoredHeaderCardsVisible(next);
+                    return next;
+                });
+            }, []);
             React.useEffect(function () {
                 setExtraCommits([]);
                 setHasMoreCommits(true);
+                setExtraDirtyFiles([]);
+                setVisibleDirtyCount(15);
+                setHasMoreDirty(true);
+                setActiveDiffFile(null);
             }, [cwd, data]);
             var loadMoreCommits = function () {
                 if (loadingMore || !hasMoreCommits)
@@ -3258,22 +4444,136 @@ function GlobalSyncSettingsModal(props) {
                     setLoadingMore(false);
                 });
             };
+            var loadMoreDirtyFiles = function () {
+                if (loadingMoreDirty)
+                    return;
+                var total = data?.gitStatus?.dirtyCount || 0;
+                var baseFiles = data?.gitStatus?.dirtyFiles || [];
+                var loadedCount = baseFiles.length + extraDirtyFiles.length;
+                // 若当前已持有的文件列表中还有未展示的内容，按 15 条步长递增展示窗口（0ms 纯前端瞬时响应）
+                if (visibleDirtyCount < loadedCount) {
+                    setVisibleDirtyCount(function (prev) {
+                        return Math.min(prev + 15, loadedCount);
+                    });
+                    return;
+                }
+                // 若当前已展示数已经达到总数，说明全量全部展示完毕，无需发起请求
+                if (visibleDirtyCount >= total && total > 0) {
+                    setHasMoreDirty(false);
+                    return;
+                }
+                // 仅在当前已知条数小于总数时向后端增量拉取后续条目
+                setLoadingMoreDirty(true);
+                var skip = loadedCount;
+                var limit = 15;
+                var url = "/api/github/uncommitted-files?limit=" + limit + "&skip=" + skip + (cwd ? "&cwd=" + encodeURIComponent(cwd) : "");
+                var fetchWithFallback = async function () {
+                    try {
+                        var r = await fetch(url);
+                        if (r.status === 404) {
+                            // 自动无缝降级走常驻端点 /api/github/action
+                            r = await fetch("/api/github/action", {
+                                method: "POST",
+                                headers: { "Content-Type": "application/json" },
+                                body: JSON.stringify({
+                                    action: "get_uncommitted_files",
+                                    limit: limit,
+                                    skip: skip,
+                                    cwd: cwd || undefined,
+                                }),
+                            });
+                        }
+                        if (!r.ok) {
+                            setLoadingMoreDirty(false);
+                            return;
+                        }
+                        var j = await r.json().catch(function () { return null; });
+                        setLoadingMoreDirty(false);
+                        if (j && j.ok && j.data && Array.isArray(j.data.items)) {
+                            if (j.data.items.length === 0) {
+                                setHasMoreDirty(false);
+                            }
+                            else {
+                                setExtraDirtyFiles(function (prev) {
+                                    return prev.concat(j.data.items);
+                                });
+                                setVisibleDirtyCount(function (prev) {
+                                    return prev + j.data.items.length;
+                                });
+                                if (!j.data.hasMore || (loadedCount + j.data.items.length) >= total) {
+                                    setHasMoreDirty(false);
+                                }
+                            }
+                        }
+                        else {
+                            setHasMoreDirty(false);
+                        }
+                    }
+                    catch (e) {
+                        setLoadingMoreDirty(false);
+                    }
+                };
+                fetchWithFallback();
+            };
             React.useEffect(function () {
                 var el = containerRef && containerRef.current;
                 if (!el)
                     return;
                 var onScroll = function () {
-                    var activeTab = el.getAttribute("data-active-tab");
-                    if (activeTab && activeTab !== "git")
-                        return;
-                    var threshold = 80;
+                    var activeBtn = el.querySelector(".dsh-github-tab-btn.active");
+                    var activeTab = activeBtn ? activeBtn.getAttribute("data-tab-btn") : (el.getAttribute("data-active-tab") || "git");
+                    var threshold = 120;
                     if (el.scrollHeight - el.scrollTop - el.clientHeight < threshold) {
-                        loadMoreCommits();
+                        if (activeTab === "git") {
+                            loadMoreCommits();
+                        }
+                        else if (activeTab === "dirty") {
+                            loadMoreDirtyFiles();
+                        }
+                    }
+                };
+                // 监听鼠标滚轮向下滚事件（即使用户收起卡片导致内容暂未撑出滚动条，只要向下滚轮也能瞬间响应！）
+                var onWheel = function (e) {
+                    if (!e || e.deltaY <= 0)
+                        return;
+                    var activeBtn = el.querySelector(".dsh-github-tab-btn.active");
+                    var activeTab = activeBtn ? activeBtn.getAttribute("data-tab-btn") : (el.getAttribute("data-active-tab") || "git");
+                    var threshold = 120;
+                    var atBottom = (el.scrollHeight - el.scrollTop - el.clientHeight < threshold) || (el.scrollHeight <= el.clientHeight + 40);
+                    if (atBottom) {
+                        if (activeTab === "git") {
+                            loadMoreCommits();
+                        }
+                        else if (activeTab === "dirty") {
+                            loadMoreDirtyFiles();
+                        }
                     }
                 };
                 el.addEventListener("scroll", onScroll, { passive: true });
-                return function () { el.removeEventListener("scroll", onScroll); };
-            }, [data, extraCommits, loadingMore, hasMoreCommits, cwd]);
+                el.addEventListener("wheel", onWheel, { passive: true });
+                return function () {
+                    el.removeEventListener("scroll", onScroll);
+                    el.removeEventListener("wheel", onWheel);
+                };
+            }, [data, extraCommits, loadingMore, hasMoreCommits, cwd, extraDirtyFiles, loadingMoreDirty, hasMoreDirty, visibleDirtyCount, headerCardsVisible]);
+            // 视口充盈智能自适应：当用户点击收起卡片导致页面变矮、未能产生滚动条时，自动将后续条目拉取补齐！
+            React.useEffect(function () {
+                var el = containerRef && containerRef.current;
+                if (!el)
+                    return;
+                var timer = setTimeout(function () {
+                    var activeBtn = el.querySelector(".dsh-github-tab-btn.active");
+                    var activeTab = activeBtn ? activeBtn.getAttribute("data-tab-btn") : (el.getAttribute("data-active-tab") || "git");
+                    if (activeTab === "dirty") {
+                        var total = data?.gitStatus?.dirtyCount || 0;
+                        var hasMore = total > 0 && visibleDirtyCount < total;
+                        if (hasMore && el.scrollHeight <= el.clientHeight + 60) {
+                            loadMoreDirtyFiles();
+                        }
+                    }
+                }, 120);
+                return function () { clearTimeout(timer); };
+            }, [headerCardsVisible, visibleDirtyCount, data]);
             React.useEffect(() => {
                 var onOpenAbout = () => {
                     var el = containerRef && containerRef.current;
@@ -3302,8 +4602,13 @@ function GlobalSyncSettingsModal(props) {
                     window.removeEventListener("dsh-github-open-proxy", onOpenProxy);
                 };
             }, []);
-            var openRightbarSettings = () => {
-                setRightbarModalSection("sync");
+            var openRightbarSettings = (section) => {
+                if (section) {
+                    setRightbarModalSection(section);
+                }
+                else {
+                    setRightbarModalSection("sync");
+                }
                 setRightbarModalOpen(true);
             };
             var h = React.createElement;
@@ -3324,12 +4629,34 @@ function GlobalSyncSettingsModal(props) {
                     },
                 }, h("span", null, toastMsg), h("button", { onClick: () => setToastMsg(null), style: { background: "none", border: "none", cursor: "pointer", color: "inherit", fontSize: "14px" } }, "✕"))
                 : null;
+            var openFileInDsh = function (f) {
+                if (!f || !f.path)
+                    return;
+                try {
+                    var rel = f.path.replace(/\\/g, "/");
+                    var address = "dsh-resource://file/session/" + encodeURIComponent(sessionId || "") + "/" + encodeURIComponent(rel);
+                    var activeCtx = props?.ctx || currentPluginCtx;
+                    if (activeCtx && activeCtx.sidebarRight && typeof activeCtx.sidebarRight.openResource === "function") {
+                        activeCtx.sidebarRight.openResource(address);
+                    }
+                    else {
+                        window.dispatchEvent(new CustomEvent("dsh-open-file", { detail: { path: f.path, cwd: cwd, sessionId: sessionId } }));
+                    }
+                }
+                catch (e) { }
+            };
             return h("div", { className: "dsh-github-rightbar-container", ref: containerRef }, toastEl, ...renderGithubRepoView(h, data, loading, error, () => loadData(true), true, updateInfo, syncStatus, lastSyncedAt, openRightbarSettings, cwd, (c) => setSelectedCommit(c), {
                 extraCommits: extraCommits,
                 loadingMore: loadingMore,
                 hasMore: hasMoreCommits,
                 onLoadMore: loadMoreCommits,
-            }, showToast), h(GlobalSyncSettingsModal, {
+            }, showToast, () => setHelpModalOpen(true), openFileInDsh, {
+                visibleCount: visibleDirtyCount,
+                extraDirtyFiles: extraDirtyFiles,
+                loadingMore: loadingMoreDirty,
+                hasMore: hasMoreDirty,
+                onLoadMore: loadMoreDirtyFiles,
+            }, activeDiffFile, (f) => setActiveDiffFile(f), () => setActiveDiffFile(null), openFileInDsh, headerCardsVisible, toggleHeaderCards), h(GlobalSyncSettingsModal, {
                 isOpen: aboutModalOpen,
                 initialSection: "about",
                 onClose: () => setAboutModalOpen(false),
@@ -3347,6 +4674,9 @@ function GlobalSyncSettingsModal(props) {
                     setLastSyncedAt(0);
                     setSyncStatus("loading");
                 },
+            }), h(GithubHelpModal, {
+                isOpen: helpModalOpen,
+                onClose: () => setHelpModalOpen(false),
             }), selectedCommit
                 ? h(CommitDetailModal, {
                     commit: selectedCommit,
@@ -3374,7 +4704,7 @@ function GlobalSyncSettingsModal(props) {
                 className: "dsh-github-icon-inner" + (active ? " active" : "")
             }, renderOctocat(18, "currentColor")));
         }
-        var inject = ["slots", "sidebarRightTabs", "sessions", "layout", "theme"];
+        var inject = ["slots", "sidebarRightTabs", "sessions", "layout", "theme", "sidebarRight"];
         
 // ---- [Bundled: workspace-panel.js] ----
 /**
@@ -3390,6 +4720,7 @@ function GithubWorkspacePanel() {
     var [lastSyncedAt, setLastSyncedAt] = React.useState(initialSnapshot?.savedAt || 0);
     var [isSettingsModalOpen, setIsSettingsModalOpen] = React.useState(false);
     var [settingsInitialSection, setSettingsInitialSection] = React.useState("sync");
+    var [isHelpModalOpen, setIsHelpModalOpen] = React.useState(false);
     var [error, setError] = React.useState(null);
     var [updateInfo, setUpdateInfo] = React.useState(null);
     var [activeTab, setActiveTab] = React.useState("workspaces");
@@ -3483,9 +4814,18 @@ function GithubWorkspacePanel() {
             if (forceRefresh) {
                 url += "?force=true";
             }
-            var res = await fetch(url, { signal: controller.signal });
+            // 接入 1s/2s/4s 阶梯退避重试，平滑吸收代理节点与网络的偶发抖动断流
+            var { res, json } = await fetchWithRetry(url, {}, {
+                signal: controller.signal,
+                maxRetries: 3,
+                baseDelayMs: 1000,
+                onRetry: (attempt) => {
+                    setSyncStatus("syncing");
+                    setError(`网络抖动，正在自愈重试 (${attempt}/3)...`);
+                },
+            });
             if (!res.ok) {
-                var errText = await res.text().catch(() => "");
+                var errText = (typeof json === "string" ? json : JSON.stringify(json)) || res.statusText;
                 var failMsg = `获取全局数据失败（HTTP ${res.status}）${errText ? ": " + errText : ""}`;
                 setSyncStatus("failed");
                 setError(failMsg);
@@ -3493,7 +4833,6 @@ function GithubWorkspacePanel() {
                     showToast("❌ 刷新失败：" + failMsg);
                 return;
             }
-            var json = await res.json();
             if (json.ok && json.data) {
                 var isFail = Boolean(json.partialFailure ||
                     json.data.partialFailure ||
@@ -3620,8 +4959,16 @@ function GithubWorkspacePanel() {
                     .catch(function () { });
             }
         };
+        var onOnline = () => {
+            // 监听网络由断网恢复连接瞬间，自动静默发起一次全量同步，消除离线警告横幅并拉新
+            loadData(false);
+        };
         window.addEventListener("focus", onFocus);
-        return () => window.removeEventListener("focus", onFocus);
+        window.addEventListener("online", onOnline);
+        return () => {
+            window.removeEventListener("focus", onFocus);
+            window.removeEventListener("online", onOnline);
+        };
     }, [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 全景驾驶舱"), renderPluginBadge(h), h(SyncStatusBadge, { syncStatus, lastSyncedAt }), proxyActive && proxyActive.enabled
@@ -3646,6 +4993,11 @@ function GithubWorkspacePanel() {
         onClick: () => loadData(true),
         disabled: loading,
     }, loading ? "同步中..." : "🔄 刷新全局数据"), h("button", {
+        className: "dsh-github-btn-sm",
+        onClick: () => setIsHelpModalOpen(true),
+        title: "打开使用帮助与实战手册大窗口（Esc 可退出）",
+        style: { padding: "6px 12px" },
+    }, "📖 使用指南"), h("button", {
         className: "dsh-github-btn-sm",
         onClick: openSettingsDefault,
         title: "配置数据同步节奏、本地缓存、网络代理与插件信息",
@@ -3839,11 +5191,15 @@ function GithubWorkspacePanel() {
             },
         })
         : null;
-    return h("div", { className: "dsh-github-panel", ref: panelRef }, toastEl, headerEl, networkAlertBannerEl, upgradeBannerEl, errorEl, statsCardsEl, authGuideEl, tabsEl, contentEl, settingsModalEl);
+    return h("div", { className: "dsh-github-panel", ref: panelRef }, toastEl, headerEl, networkAlertBannerEl, upgradeBannerEl, errorEl, statsCardsEl, authGuideEl, tabsEl, contentEl, settingsModalEl, h(GithubHelpModal, {
+        isOpen: isHelpModalOpen,
+        onClose: () => setIsHelpModalOpen(false),
+    }));
 }
 
 
     function apply(ctx) {
+            currentPluginCtx = ctx;
             if (typeof window !== "undefined" && window.document) {
                 var sweep = () => {
                     document.querySelectorAll(".dsh-github-right-card, .dsh-github-mounted-card, #dsh-github-floating-drawer").forEach((el) => el.remove());