dsh-github-flow 0.7.0 → 0.7.1

package/lib/ui/diff-utils.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Unified diff 的切分与路径归一（纯函数：零 React、零 IO）。
+ *
+ * 为什么单独成模块：提交详情要支持「点文件看该文件的 diff」，而一次 `git show` 拿到的是
+ * 整包 patch，必须在前端按 `diff --git` 边界切段。切分规则（边界、重命名路径、二进制判定）
+ * 是纯逻辑，抽出来才能脱离 DOM 单测；放进组件里就只能靠肉眼看界面。
+ *
+ * 为什么不改成「点一次查一次 `git show <sha> -- <path>`」：`git show --stat` 把重命名显示成
+ * `src/{old => new}.ts`，拿它当 pathspec 必然查不到；带空格/引号的路径同样脆。整包 patch 的
+ * `diff --git a/… b/…` 行才是权威来源，按它切分天然免疫这些形态。
+ */
+export interface PatchSection {
+    /** b 侧路径（重命名后的新路径） */
+    path: string;
+    /** 仅重命名块有值（a 侧旧路径） */
+    oldPath?: string;
+    /** 该文件的完整补丁块（含 diff --git / index / --- / +++ / hunk 全部行） */
+    text: string;
+    isBinary: boolean;
+    additions: number;
+    deletions: number;
+}
+/**
+ * 解析 `diff --git a/<old> b/<new>` 头行。
+ *
+ * 路径含空格时这行本身是有歧义的（`a/a b.txt b/a b.txt`），所以按**最后一个** ` b/` 切：
+ * a 侧取前缀，b 侧取剩余全部——b 侧是我们要的路径，尾部截断不会丢字符。
+ */
+export declare function parseDiffGitLine(line: string): {
+    aPath: string;
+    bPath: string;
+} | null;
+/**
+ * 把 `--stat` 里的重命名写法归一成新路径：
+ * - `src/{old => new}.ts` → `src/new.ts`
+ * - `old/name.ts => new/name.ts` → `new/name.ts`
+ * 非重命名原样返回。
+ */
+export declare function normalizeRenamePath(raw: string): string;
+/**
+ * 按 `diff --git` 边界把整包 patch 切成逐文件块。
+ * 首个 `diff --git` 之前的内容（如 `--format=` 漏配时的提交头）直接丢弃：
+ * 它们不属于任何文件，混进第一段会污染差异渲染。
+ */
+export declare function splitUnifiedPatch(patch: string): PatchSection[];
+/**
+ * 在切好的块里找目标文件。
+ * 匹配优先级：新路径 → 旧路径 → 归一化后的重命名写法（`--stat` 的原始形态）。
+ * 找不到返回 null，由调用方给「该文件在本次提交中无文本差异」的兜底文案。
+ */
+export declare function findPatchSection(sections: PatchSection[], targetPath: string): PatchSection | null;

package/lib/ui/diff-utils.js

@@ -0,0 +1,155 @@
+/**
+ * Unified diff 的切分与路径归一（纯函数：零 React、零 IO）。
+ *
+ * 为什么单独成模块：提交详情要支持「点文件看该文件的 diff」，而一次 `git show` 拿到的是
+ * 整包 patch，必须在前端按 `diff --git` 边界切段。切分规则（边界、重命名路径、二进制判定）
+ * 是纯逻辑，抽出来才能脱离 DOM 单测；放进组件里就只能靠肉眼看界面。
+ *
+ * 为什么不改成「点一次查一次 `git show <sha> -- <path>`」：`git show --stat` 把重命名显示成
+ * `src/{old => new}.ts`，拿它当 pathspec 必然查不到；带空格/引号的路径同样脆。整包 patch 的
+ * `diff --git a/… b/…` 行才是权威来源，按它切分天然免疫这些形态。
+ */
+/**
+ * 解析 `diff --git a/<old> b/<new>` 头行。
+ *
+ * 路径含空格时这行本身是有歧义的（`a/a b.txt b/a b.txt`），所以按**最后一个** ` b/` 切：
+ * a 侧取前缀，b 侧取剩余全部——b 侧是我们要的路径，尾部截断不会丢字符。
+ */
+export function parseDiffGitLine(line) {
+    if (typeof line !== "string" || line.indexOf("diff --git ") !== 0)
+        return null;
+    var rest = line.slice("diff --git ".length);
+    var sep = rest.lastIndexOf(" b/");
+    if (sep < 0)
+        return null;
+    var aPath = rest.slice(0, sep);
+    var bPath = rest.slice(sep + 1); // 保留 "b/" 前缀，与 git 输出一致
+    if (aPath.indexOf("a/") !== 0)
+        return null;
+    return { aPath: aPath.slice(2), bPath: bPath.slice(2) };
+}
+/** 去掉 git 对特殊路径加的引号（core.quotepath=false 后大多数情况不再出现） */
+function unquote(raw) {
+    var s = String(raw == null ? "" : raw).trim();
+    if (s.length >= 2 && s.charAt(0) === '"' && s.charAt(s.length - 1) === '"') {
+        return s.slice(1, -1).replace(/\\(["\\])/g, "$1");
+    }
+    return s;
+}
+/**
+ * 把 `--stat` 里的重命名写法归一成新路径：
+ * - `src/{old => new}.ts` → `src/new.ts`
+ * - `old/name.ts => new/name.ts` → `new/name.ts`
+ * 非重命名原样返回。
+ */
+export function normalizeRenamePath(raw) {
+    var s = unquote(raw);
+    if (s.indexOf("=>") < 0)
+        return s;
+    var brace = s.match(/^(.*)\{([^{}]*)=>\s*([^{}]*)\}(.*)$/);
+    if (brace) {
+        var joined = (brace[1] + brace[3] + brace[4]).replace(/\/{2,}/g, "/");
+        return joined.replace(/^\s+|\s+$/g, "");
+    }
+    var parts = s.split("=>");
+    return parts[parts.length - 1].replace(/^\s+|\s+$/g, "");
+}
+/**
+ * 按 `diff --git` 边界把整包 patch 切成逐文件块。
+ * 首个 `diff --git` 之前的内容（如 `--format=` 漏配时的提交头）直接丢弃：
+ * 它们不属于任何文件，混进第一段会污染差异渲染。
+ */
+export function splitUnifiedPatch(patch) {
+    if (typeof patch !== "string" || !patch)
+        return [];
+    var lines = patch.split("\n");
+    var sections = [];
+    var buf = [];
+    var current = null;
+    /**
+     * 是否已进入第一个 hunk。
+     *
+     * 为什么必须有这个状态位：`--- `/`+++ ` 既是文件头，也可能是**正文**行
+     * （删掉一行 `---` 分隔线的补丁行是 `----`，Markdown 文档里很常见）。
+     * 只按行首前缀判断会把正文行当文件头，导致增删计数与配色全错。
+     * git 的格式保证：文件头只出现在第一个 `@@` 之前，`@@` 之后全是正文字节。
+     */
+    var inHunk = false;
+    var flush = function () {
+        if (current && buf.length > 0) {
+            current.text = buf.join("\n");
+            sections.push(current);
+        }
+        buf = [];
+    };
+    for (var i = 0; i < lines.length; i++) {
+        var line = lines[i];
+        if (line.indexOf("diff --git ") === 0) {
+            flush();
+            var parsed = parseDiffGitLine(line);
+            current = {
+                path: parsed ? unquote(parsed.bPath) : "",
+                oldPath: parsed ? unquote(parsed.aPath) : undefined,
+                text: "",
+                isBinary: false,
+                additions: 0,
+                deletions: 0,
+            };
+            buf.push(line);
+            inHunk = false; // 新文件块：文件头区重新开始
+            continue;
+        }
+        if (!current)
+            continue; // 首个 diff --git 之前的头部：丢弃
+        buf.push(line);
+        if (line.indexOf("@@") === 0) {
+            inHunk = true;
+            continue;
+        }
+        if (!inHunk) {
+            // 文件头区：只解析元信息，**绝不计数**——`+++ b/x` 不是新增行
+            if (line.indexOf("rename from ") === 0 && !current.oldPath) {
+                current.oldPath = unquote(line.slice("rename from ".length));
+            }
+            else if (line.indexOf("rename to ") === 0) {
+                current.path = unquote(line.slice("rename to ".length));
+            }
+            else if (line.indexOf("+++ b/") === 0 && !current.path) {
+                current.path = unquote(line.slice(6));
+            }
+            else if (line.indexOf("Binary files ") === 0 || line.indexOf("GIT binary patch") === 0) {
+                current.isBinary = true;
+            }
+            continue;
+        }
+        // hunk 内：行首 + / - 就是真实增删（`` 不计）
+        if (line.charAt(0) === "+")
+            current.additions++;
+        else if (line.charAt(0) === "-")
+            current.deletions++;
+    }
+    flush();
+    return sections;
+}
+/**
+ * 在切好的块里找目标文件。
+ * 匹配优先级：新路径 → 旧路径 → 归一化后的重命名写法（`--stat` 的原始形态）。
+ * 找不到返回 null，由调用方给「该文件在本次提交中无文本差异」的兜底文案。
+ */
+export function findPatchSection(sections, targetPath) {
+    if (!Array.isArray(sections) || sections.length === 0)
+        return null;
+    var target = unquote(targetPath);
+    if (!target)
+        return null;
+    var want = normalizeRenamePath(target);
+    for (var i = 0; i < sections.length; i++) {
+        if (sections[i].path === target || sections[i].path === want)
+            return sections[i];
+    }
+    for (var j = 0; j < sections.length; j++) {
+        if (sections[j].oldPath && (sections[j].oldPath === target || sections[j].oldPath === want))
+            return sections[j];
+    }
+    return null;
+}

package/lib/ui/file-diff-modal.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 文件 Diff 预览弹窗（未提交清单 / 提交详情共用）。
+ *
+ * 为什么合成一个组件：
+ * 1. 未提交清单原本把整个 section 换成「二级视图」（`activeDiffFile ? 二级视图 : 列表`），
+ *    观感像另开一页；改成弹窗后列表留在原位，返回成本从一次重渲染变成一次 Esc；
+ * 2. 提交详情也要「点文件看 diff」，两处只是**数据来源**不同（一个是 `/api/github/file-diff`，
+ *    一个是整包 patch 切出来的一段），外壳/配色/错误态/复制逻辑完全同构，分两份必然漂移。
+ *
+ * 404 降级保留：桌面端未重启时新路由不存在，先回退到常驻的 `/api/github/action`，
+ * 再不行才显式提示「重启桌面端」——这是 file-diff 链路既有的自愈策略。
+ */
+export declare function FileDiffModal(props: {
+    file: {
+        path: string;
+        status?: string;
+        additions?: number;
+        deletions?: number;
+        isBinary?: boolean;
+    };
+    cwd?: string | null;
+    /** 已有补丁正文（提交详情场景：由整包 patch 切出）；缺省时按未提交路由自行拉取 */
+    diffText?: string | null;
+    /** 顶部副标题（如提交短 SHA） */
+    subtitle?: string | null;
+    /** 附加提示（如补丁被截断） */
+    note?: string | null;
+    loading?: boolean;
+    error?: string | null;
+    zIndex?: number;
+    onClose: () => void;
+    onOpenInDsh?: ((filePath: string) => void) | null;
+}): any;

package/lib/ui/file-diff-modal.js

@@ -0,0 +1,250 @@
+/**
+ * 文件 Diff 预览弹窗（未提交清单 / 提交详情共用）。
+ *
+ * 为什么合成一个组件：
+ * 1. 未提交清单原本把整个 section 换成「二级视图」（`activeDiffFile ? 二级视图 : 列表`），
+ *    观感像另开一页；改成弹窗后列表留在原位，返回成本从一次重渲染变成一次 Esc；
+ * 2. 提交详情也要「点文件看 diff」，两处只是**数据来源**不同（一个是 `/api/github/file-diff`，
+ *    一个是整包 patch 切出来的一段），外壳/配色/错误态/复制逻辑完全同构，分两份必然漂移。
+ *
+ * 404 降级保留：桌面端未重启时新路由不存在，先回退到常驻的 `/api/github/action`，
+ * 再不行才显式提示「重启桌面端」——这是 file-diff 链路既有的自愈策略。
+ */
+export function FileDiffModal(props) {
+    var h = React.createElement;
+    var f = props.file;
+    var selfFetch = props.diffText === undefined || props.diffText === null;
+    var [fetched, setFetched] = React.useState(null);
+    var [fetching, setFetching] = React.useState(selfFetch);
+    var [fetchError, setFetchError] = React.useState(null);
+    var [copied, setCopied] = React.useState(false);
+    React.useEffect(function () {
+        var onKeyDown = function (e) {
+            if (e.key === "Escape" || e.keyCode === 27)
+                props.onClose();
+        };
+        window.addEventListener("keydown", onKeyDown);
+        return function () { window.removeEventListener("keydown", onKeyDown); };
+    }, [props.onClose]);
+    React.useEffect(function () {
+        if (!selfFetch)
+            return;
+        setFetching(true);
+        setFetchError(null);
+        setFetched(null);
+        var run = async function () {
+            var primaryUrl = "/api/github/file-diff?file=" + encodeURIComponent(f.path) + (props.cwd ? "&cwd=" + encodeURIComponent(props.cwd) : "");
+            var readJson = async function (res) {
+                var text = await res.text().catch(function () { return ""; });
+                var json = null;
+                if (text && (text.trim().charAt(0) === "{" || text.trim().charAt(0) === "[")) {
+                    try {
+                        json = JSON.parse(text);
+                    }
+                    catch (e) { }
+                }
+                return { ok: res.ok, status: res.status, text: text, json: json };
+            };
+            try {
+                var p1 = await readJson(await fetch(primaryUrl));
+                if (p1.ok && p1.json && p1.json.ok && p1.json.data) {
+                    setFetched(p1.json.data);
+                    setFetching(false);
+                    return;
+                }
+                // 主路由 404：后端常驻进程还没载入新路由 → 先退到既有 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 readJson(r2);
+                        if (p2.ok && p2.json && p2.json.data) {
+                            setFetched(p2.json.data);
+                            setFetching(false);
+                            return;
+                        }
+                    }
+                    setFetching(false);
+                    setFetchError("后端对比接口未激活 (404)。请重启 DSH 桌面主程序以载入最新对比引擎；您也可点击上方「在 DSH 中打开」直接预览文件源码。");
+                    return;
+                }
+                setFetching(false);
+                setFetchError(p1.json && p1.json.error ? p1.json.error : (p1.text || ("查询差异失败 (HTTP " + p1.status + ")")));
+            }
+            catch (err) {
+                setFetching(false);
+                setFetchError((err && err.message) || "网络请求异常");
+            }
+        };
+        run();
+    }, [f.path, props.cwd, selfFetch]);
+    var diffText = selfFetch ? (fetched && fetched.diff) || "" : String(props.diffText || "");
+    var isBinary = Boolean(props.file.isBinary || (fetched && fetched.isBinary));
+    var additions = props.file.additions !== undefined ? props.file.additions : (fetched ? fetched.additions : undefined);
+    var deletions = props.file.deletions !== undefined ? props.file.deletions : (fetched ? fetched.deletions : undefined);
+    var loading = props.loading === true || (selfFetch && fetching);
+    var error = props.error || (selfFetch ? fetchError : null);
+    var status = String(props.file.status || "");
+    var statusColor = status === "??" ? "var(--dsw-alias-state-success-primary, #1a7f37)"
+        : status.indexOf("D") >= 0 ? "var(--dsw-alias-state-error-primary, #cf222e)"
+            : "var(--dsw-alias-state-attention-primary, #9a6700)";
+    var statusText = status === "??" ? "未跟踪新增"
+        : status.indexOf("D") >= 0 ? "已删除"
+            : status.indexOf("R") >= 0 ? "已重命名"
+                : status ? "已修改" : "";
+    var copyDiff = function () {
+        if (!diffText)
+            return;
+        if (navigator && navigator.clipboard && navigator.clipboard.writeText) {
+            navigator.clipboard.writeText(diffText).then(function () {
+                setCopied(true);
+                setTimeout(function () { setCopied(false); }, 2000);
+            }).catch(function () { });
+        }
+    };
+    var renderLines = function () {
+        var lines = diffText.split("\n");
+        /**
+         * hunk 状态位：`--- ` / `+++ ` 既是文件头，也可能是正文（Markdown 的 `---` 分隔线
+         * 被删时补丁行是 `----`）。只按行首前缀判断会把正文染成灰色小字，且与真实增删不符。
+         * git 保证文件头只出现在第一个 `@@` 之前，据此切分才可靠。
+         */
+        var inHunk = false;
+        return lines.map(function (line, idx) {
+            if (line.indexOf("diff --git") === 0)
+                inHunk = false;
+            var isHunk = line.indexOf("@@") === 0;
+            if (isHunk)
+                inHunk = true;
+            var isAdd = inHunk && !isHunk && line.charAt(0) === "+";
+            var isDel = inHunk && !isHunk && line.charAt(0) === "-";
+            var isHeader = !inHunk && !isHunk;
+            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 || " ");
+        });
+    };
+    return h("div", {
+        className: "dsh-github-modal-overlay",
+        onClick: function (e) {
+            // 叠在提交详情弹窗之上时，遮罩点击必须止住冒泡：
+            // 外层 overlay 的 onClick 是「关闭提交详情」，不拦就会一次点击关掉两层
+            if (e && typeof e.stopPropagation === "function")
+                e.stopPropagation();
+            props.onClose();
+        },
+        style: { zIndex: props.zIndex === undefined ? 100001 : props.zIndex },
+    }, h("div", {
+        className: "dsh-github-modal-dialog",
+        role: "dialog",
+        "aria-label": "文件差异预览",
+        style: { width: "94%", maxWidth: "920px", maxHeight: "88vh", display: "flex", flexDirection: "column", overflow: "hidden" },
+        onClick: function (e) { e.stopPropagation(); },
+    }, 
+    // 头部：状态 + 路径 + 增删统计 + 操作按钮
+    h("div", { className: "dsh-github-modal-header", style: { flexShrink: 0, gap: "8px" } }, h("div", { style: { display: "flex", alignItems: "center", gap: "8px", minWidth: 0, flex: 1 } }, h("h3", { style: { margin: 0, fontSize: "14px", fontWeight: 600, flexShrink: 0 } }, "文件差异"), status
+        ? h("span", {
+            className: "dsh-github-badge",
+            style: { backgroundColor: statusColor + "22", color: statusColor, fontWeight: 600, fontSize: "11px", flexShrink: 0 },
+        }, status + " " + statusText)
+        : null, additions !== undefined && deletions !== undefined
+        ? h("div", { style: { display: "flex", gap: "4px", fontSize: "11px", fontFamily: "monospace", flexShrink: 0 } }, h("span", { style: { color: "var(--dsw-alias-state-success-primary, #1a7f37)", fontWeight: 600 } }, "+" + additions), h("span", { style: { color: "var(--dsw-alias-state-error-primary, #cf222e)", fontWeight: 600 } }, "-" + deletions))
+        : null, props.subtitle
+        ? h("span", { style: { fontSize: "11px", opacity: 0.7, flexShrink: 0, fontFamily: "monospace" } }, props.subtitle)
+        : null), h("div", { style: { display: "flex", alignItems: "center", gap: "6px", flexShrink: 0 } }, diffText
+        ? 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("button", {
+        style: { background: "none", border: "none", cursor: "pointer", fontSize: "18px", color: "var(--dsw-alias-label-secondary, #656d76)", padding: "0 4px" },
+        onClick: props.onClose,
+        title: "关闭 (Esc)",
+    }, "✕"))), 
+    // 正文
+    h("div", {
+        className: "dsh-github-modal-body",
+        style: { padding: "12px 16px 16px", overflowY: "auto", flex: 1, minHeight: 0, display: "flex", flexDirection: "column", gap: "8px", boxSizing: "border-box" },
+    }, 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",
+            flexShrink: 0,
+        },
+        title: f.path,
+    }, f.path), loading
+        ? h("div", { style: { padding: "32px 0", textAlign: "center", opacity: 0.65, fontSize: "12px" } }, "⏳ 正在计算 Git 代码比对差异...")
+        : error
+            ? h("div", {
+                style: {
+                    padding: "12px 14px",
+                    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))
+            : isBinary
+                ? h("div", { style: { padding: "32px 0", textAlign: "center", opacity: 0.8, fontSize: "12px" } }, "📦 该文件为二进制格式（图片或编译产物），无法直接展示文本差异。")
+                : !diffText
+                    ? h("div", { style: { padding: "32px 0", textAlign: "center", opacity: 0.7, fontSize: "12px" } }, "该文件在本次变更中没有可展示的文本差异。")
+                    : h("div", {
+                        className: "dsh-github-inline-diff-view",
+                        style: { display: "flex", flexDirection: "column", gap: "8px", minHeight: "120px" },
+                    }, 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: "62vh",
+                            borderRadius: "6px",
+                            border: "1px solid var(--dsw-alias-border-subtle, rgba(0,0,0,0.08))",
+                            backgroundColor: "var(--dsw-alias-bg-canvas, #ffffff)",
+                        },
+                    }, renderLines())), props.note
+        ? h("div", { style: { fontSize: "11px", color: "var(--dsw-alias-label-secondary, #656d76)", lineHeight: "1.6" } }, "⚠️ " + props.note)
+        : null)));
+}

package/lib/ui/help-modal.js

@@ -160,8 +160,8 @@ export function GithubHelpModal(props) {
                     title: "2. 会话右侧栏面板 (Sidebar Panel) —— 深度协同当前工作区 · 5 个 Tab",
                     items: [
                         "打开入口：位于每个会话工作区的右侧抽屉栏，深度锁定当前会话的物理 Git 仓库；",
-                        "仓库身份与切换：顶部展示当前关联仓库、Fork 血缘行与权限徽章（只读/可写）；若配置了多个 remote，可通过 RepoSelectorDropdown 下拉一键切换基准仓库；", "Git Tab：三段式提交时间线（待推送 / 待拉取 / 最近），默认 15 条、下滑触底自动加载；点任意提交行弹出完整 Commit 详情；",
-                        "未提交 Tab：实时监听本地未提交文件与状态码（?? 新增 / M 修改 / D 删除 / R 重命名），点击文件可就地下钻查看该文件的 Unified Diff；",
+                        "仓库身份与切换：顶部展示当前关联仓库、Fork 血缘行与权限徽章（只读/可写）；若配置了多个 remote，可通过 RepoSelectorDropdown 下拉一键切换基准仓库；", "Git Tab：三段式提交时间线（待推送 / 待拉取 / 最近），默认 15 条、下滑触底自动加载；点任意提交行弹出完整 Commit 详情；提交详情里点「📁 文件变更统计」的任意文件行，可再叠一层该文件的 Unified Diff 预览（Esc 先关 Diff、再关详情）；",
+                        "未提交 Tab：实时监听本地未提交文件与状态码（?? 新增 / M 修改 / D 删除 / R 重命名），点击文件弹出该文件的 Unified Diff 弹窗（清单保留原位，可复制原文或在 DSH 中打开源码）；",
                         "PR Tab：展示全部 PR 并按状态过滤；带三态 CI 门禁、冲突检测、审核判定与 Draft 标示；点击卡片在线唤起 PR 审阅工作台（描述 / 评论 / 文件 Diff 双栏比对）；",
                         "Issues Tab：展示全部 Issue 并按状态过滤；点击卡片在线查看详情（Markdown 正文 / 评论时间线 / 标签色块 / 里程碑 / 关联 PR / 隐藏评论标注）；",
                         "Actions Tab：最近工作流运行记录与触发方式；点击卡片在线查看本次运行的 job / step 树（每步结论与耗时，失败步骤高亮，默认展开第一个失败 job），失败时可按需提取日志锚点片段（一次最多 3 个失败 job、服务端批次预算 90 秒）；",
@@ -169,9 +169,11 @@ export function GithubHelpModal(props) {
                     ],
                 },
                 {
-                    title: "3. 三个详情弹窗的通用操作习惯",
+                    title: "3. 详情弹窗的通用操作习惯",
                     items: [
                         "PR / Issue / Actions 三个弹窗都支持：按 Esc 或点击遮罩关闭、右上角「GitHub ↗」直达官方页面；",
+                        "文件 Diff 弹窗可以叠在提交详情之上：Esc 或点遮罩先关 Diff，再按一次才关提交详情；弹窗内可「📋 复制 Diff」原文或「📄 在 DSH 中打开」查看文件源码；",
+                        "Diff 弹窗对正文里的 `---` / `+++` 不会误判成文件头（按 hunk 解析），重命名文件按新路径展示、二进制文件给明确提示；",
                         "列表卡片上的「GitHub ↗」按钮是独立的浏览器外跳入口，点它不会触发弹窗（已做事件隔离）；",
                         "PR 弹窗的文件区可拖拽分隔条调宽、双击或点 ◀ 折叠；布局偏好会记在本地，下次打开保持原样；",
                         "长评论默认折叠（显示「⌄ 展开全部」），PR/Issue 正文默认展开——避免一屏被一段超长文字占满；",