dsh-github-flow 0.6.0 → 0.7.1

package/lib/types.d.ts

@@ -36,6 +36,22 @@ export interface PluginConfig {
      * 注意：放在 Cordis Config 意味着修改此项会触发插件 reload（静态默认值，可接受）。
      */
     proxyUrl?: string;
+    /**
+     * 工具档位：控制注册给模型的工具数量（默认不填 = `full`，18 个全量，零破坏）。
+     *
+     * 三种预设 `core`（5 个）/ `ci`（7 个）/ `maintain`（8 个），也可直接写工具名
+     * （如 `['github_pr','github_release']`）混用。未知名字会 console.warn 一次后忽略。
+     * 存在的理由：18 个工具的 schema 常驻约 24,000 字符，等于每轮对话都在为用不到的工具付费。
+     */
+    toolsets?: string[];
+    /**
+     * 只读档位（默认 false）。
+     *
+     * 硬语义，不做运行时判断：写 action 在**注册期**就从 `enum` 里被剔除，模型连
+     * 「可以写」都看不到，宿主参数校验会直接拒绝。`github_api`（端点与 method 均可任意，
+     * 无法降级）在只读模式下整体剔除。
+     */
+    read_only?: boolean;
 }
 /** 数据同步与自动化感知偏好配置 */
 export interface SyncSettings {
@@ -245,6 +261,24 @@ export interface GitLocalStatus {
         path: string;
     }>;
 }
+/**
+ * 工作区干净度闸门结果（`executor.ensureCleanWorkspace`）。
+ *
+ * 为什么要有 `reason: 'unknown'`：`getLocalGitStatus()` 在 git 不可用或非仓库时返回 null。
+ * 旧实现用 `if (gitSt && gitSt.dirtyCount > 0)` 判断，null 时表达式为假 → 闸门静默放行。
+ * 安全闸门不能因为「读不到状态」而失效，所以这里把「读不到」与「干净」显式区分开。
+ */
+export type WorkspaceCleanResult = {
+    ok: true;
+    dirtyCount: 0;
+    samples: string[];
+} | {
+    ok: false;
+    reason: 'dirty' | 'unknown';
+    dirtyCount: number;
+    samples: string[];
+    error: string;
+};
 /** 单条提交记录（结构化解析） */
 export interface GitCommitEntry {
     sha: string;
@@ -276,7 +310,7 @@ export interface PrItem {
     number: number;
     title: string;
     state: 'OPEN' | 'CLOSED' | 'MERGED';
-    author: {
+    author?: {
         login: string;
         avatarUrl?: string;
     };
@@ -361,6 +395,15 @@ export interface PrDetailData {
     };
     headRefName: string;
     baseRefName: string;
+    /**
+     * 分支尖端的 commit SHA。
+     *
+     * 为什么必须透出：分支名会移动（force-push / 新提交），拿它当审查锚点等于
+     * 「我审的到底是哪一版」永远说不清。SHA 是不可移动的事实源，也是行级评注
+     * 写入时 `commit_id` 的取值来源。
+     */
+    headRefOid?: string;
+    baseRefOid?: string;
     headRepoOwner?: string;
     body: string;
     reviewDecision?: string;
@@ -391,6 +434,25 @@ export interface PrDetailData {
      * 静默展示「该文件无差异」会让用户误以为代码没改动——必须显式提示。
      */
     diffTruncated?: boolean;
+    /**
+     * PR 实际变更的文件总数（来自 `gh pr view --json changedFiles`）。
+     *
+     * 为什么必须与 `files.length` 分开：`gh pr view --json files` 在 100 条处
+     * **静默截断**（cli/cli#12522），`files.length` 只是「返回了几条」。
+     * 把两者混为一谈，界面就会把「被截断」说成「就这么多」。
+     */
+    changedFiles?: number;
+    /** `files` 清单是否被 gh 的 100 条上限截断（`files.length < changedFiles`） */
+    filesTruncated?: boolean;
+    /**
+     * 是否有文件**没拿到 diff 正文**（该文件在 `files` 里但 `fileDiffs` 无对应切片）。
+     *
+     * 与 `diffTruncated` 是并列而非同一概念：
+     * - `diffTruncated`：整个 diff 输出被阈值裁掉（原因在传输层）；
+     * - `diffIncomplete`：清单里有这个文件、但切片里没有它（原因在数据缺失）。
+     * 两者处置不同（一个是「去看完整 diff」，一个是「这个文件没取到」），不能合并。
+     */
+    diffIncomplete?: boolean;
 }
 /**
  * Issue 分类维度契约：
@@ -535,6 +597,93 @@ export interface WorkflowRunItem {
     url: string;
     createdAt: string;
 }
+/**
+ * 单次 Run 里的一个 job 步骤（`gh run view --json jobs` 实测字段）。
+ *
+ * 为什么只有这四个时间/状态字段：step 在 GitHub 上**没有独立 URL**（锚点是页面内
+ * `#step:` 片段，API 不返回），也没有自己的一行日志入口。UI 因此只能展示
+ * 「序号 + 名称 + 结论 + 耗时」，任何「点击某步看日志」的交互都做不到——
+ * 日志的最小粒度是 job。
+ */
+export interface RunStepItem {
+    number: number;
+    name: string;
+    status: string;
+    conclusion?: string;
+    startedAt?: string;
+    completedAt?: string;
+}
+/** 单次 Run 里的一个 job（数据库 ID 即 check-run ID，可用于注解/日志端点） */
+export interface RunJobItem {
+    databaseId: number;
+    name: string;
+    status: string;
+    conclusion?: string;
+    startedAt?: string;
+    completedAt?: string;
+    /** 该 job 在 GitHub 的页面地址；step 级别没有对应 URL */
+    url?: string;
+    steps: RunStepItem[];
+}
+/**
+ * Run 完整详情契约（供 RunDetailModal 在线查看消费）。
+ *
+ * 与 PrDetailData / IssueDetailData 的关键差异：这里**不携带日志正文**。
+ * 日志动辄几十 MB 且实测单次拉取 4–40 秒还会被代理掐断，挂在详情上会让
+ * 弹窗首屏被慢链路拖死；日志走独立的 /run-logs 通道按需拉取。
+ */
+export interface RunDetailData {
+    runId: number;
+    /** 重跑次数（>1 时 UI 显示「第 N 次尝试」） */
+    attempt?: number;
+    name: string;
+    displayTitle?: string;
+    status: string;
+    conclusion?: string;
+    event?: string;
+    headBranch?: string;
+    headSha?: string;
+    url: string;
+    createdAt: string;
+    startedAt?: string;
+    updatedAt: string;
+    workflowName?: string;
+    jobs: RunJobItem[];
+    /**
+     * 失败口径只算一次。
+     * 为什么在服务端算：UI 与将来的其它消费方（Agent 摘要、测试）必须同一口径，
+     * 三处各写一遍 `conclusion === 'failure'` 迟早出现「卡片说 1 个失败、弹窗说 2 个」。
+     */
+    failedJobs: number;
+    failedSteps: number;
+    /** gh 版本过低触发过字段降级（供排查，不弹错） */
+    fieldsDegraded?: boolean;
+}
+/** 失败日志按需拉取的结果（一 job 一块，单 job 失败不拖垮整体） */
+export interface RunLogExcerptData {
+    runId: number;
+    jobs: Array<{
+        jobId: number;
+        jobName: string;
+        /** 锚点萃取后的纯文本片段（含尾部回退与显式截断声明） */
+        excerpt: string;
+        truncated: boolean;
+    }>;
+    /** 拉取失败但可重试的 job；UI 必须显式展示，不能静默当成「没有失败日志」 */
+    errors?: Array<{
+        jobName: string;
+        error: string;
+    }>;
+    /**
+     * job 名称未能从详情树解析（服务端详情降级/失败）。
+     *
+     * 为什么必须透出：此时 jobName 会退化成 `job #<id>`，属于用户可见的降级。
+     * 本仓纪律是「降级必须显式」——让界面能说一句「名称未取到」，
+     * 而不是让人以为这个 job 本来就叫 `job #111`。
+     */
+    namesUnavailable?: boolean;
+    fetchedAt: string;
+}
 export interface GitHubOverviewData {
     auth: AuthStatus;
     repo?: RepoMetadata;
@@ -590,6 +739,30 @@ export interface GitHubOverviewData {
     prsTruncated?: boolean;
     /** 单仓库 Issue 列表是否触及条数上限（语义同 prsTruncated） */
     issuesTruncated?: boolean;
+    /** Actions 运行列表是否还有更多（语义同 prsTruncated；右侧栏分页用） */
+    runsTruncated?: boolean;
+    /** 仓库全部 PR 数（含 open/merged/closed） */
+    prTotal?: number;
+    /** 处于 open 的 PR 数 */
+    prOpenTotal?: number;
+    /** 已合并的 PR 数 */
+    prMergedTotal?: number;
+    /** 已关闭的 PR 数（GitHub 语义：含已合并） */
+    prClosedTotal?: number;
+    /** 仓库全部 Issue 数（不含 PR——用 `is:issue` 限定符区分） */
+    issueTotal?: number;
+    /** 处于 open 的 Issue 数 */
+    issueOpenTotal?: number;
+    /** 已关闭的 Issue 数 */
+    issueClosedTotal?: number;
+    /**
+     * Actions 运行总数。
+     *
+     * 来源是 REST `GET /repos/{owner}/{repo}/actions/runs?per_page=1` 的 `total_count`
+     * ——GitHub GraphQL 没有 workflow runs 连接，拿不到 totalCount。
+     * 同样与分页解耦：`runs.length` 只是已加载条数。
+     */
+    runTotal?: number;
 }
 export interface UserRepoItem {
     name: string;
@@ -662,6 +835,15 @@ export interface GlobalOverviewData {
      * 「列表到此为止」与「数据没取到」。
      */
     prsTruncated?: boolean;
+    /** Issues 三路检索是否任一触及上限（有更多可加载） */
+    issuesTruncated?: boolean;
+    prTotal?: number;
+    /** 账号 open PR 数 */
+    prOpenTotal?: number;
+    /** 账号已合并 PR 数 */
+    prMergedTotal?: number;
+    /** 账号已关闭 PR 数（GitHub 语义：含已合并） */
+    prClosedTotal?: number;
     lastUpdated: string;
     error?: string;
     /** 网络是否发生异常（超时、连接拒绝、代理阻断等） */

package/lib/ui/commit-modal.js

@@ -1,3 +1,5 @@
+import { FileDiffModal } from './file-diff-modal.js';
+import { splitUnifiedPatch, findPatchSection, normalizeRenamePath } from './diff-utils.js';
 /**
  * 提交详情模态弹窗组件（与设置弹窗同构）
  */
@@ -8,14 +10,76 @@ export function CommitDetailModal(props) {
     var h = React.createElement;
     var [fetchedDetail, setFetchedDetail] = React.useState(null);
     var [fetchingDetail, setFetchingDetail] = React.useState(false);
+    /**
+     * 点某个文件后的 diff 预览状态。
+     *
+     * 为什么补丁要懒加载而不是随弹窗一起取：多数时候用户只想看提交说明，
+     * 大提交的整包 patch 可以到几百 KB；只在真的点开某个文件时才拉一次，且整个
+     * 弹窗生命周期内复用同一份 patch（点第二个文件零延迟）。
+     */
+    var [patchState, setPatchState] = React.useState(null);
+    var [patchLoading, setPatchLoading] = React.useState(false);
+    var [patchError, setPatchError] = React.useState(null);
+    var [selectedFile, setSelectedFile] = React.useState(null);
+    var loadPatch = function () {
+        if (patchState || patchLoading)
+            return;
+        setPatchLoading(true);
+        setPatchError(null);
+        var url = "/api/github/commit-diff?sha=" + encodeURIComponent(c.sha) + (props.cwd ? "&cwd=" + encodeURIComponent(props.cwd) : "");
+        fetch(url)
+            .then(function (r) {
+            if (r.status === 404) {
+                setPatchLoading(false);
+                setPatchError("后端未提供提交补丁接口 (404)。请重启 DSH 桌面主程序以载入最新对比引擎。");
+                return null;
+            }
+            return r.json().catch(function () { return null; });
+        })
+            .then(function (j) {
+            if (!j)
+                return;
+            setPatchLoading(false);
+            if (j.ok && j.data && typeof j.data.patch === "string") {
+                setPatchState({ patch: j.data.patch, truncated: Boolean(j.data.truncated) });
+            }
+            else {
+                setPatchError((j && j.error) || "获取提交补丁失败");
+            }
+        })
+            .catch(function (err) {
+            setPatchLoading(false);
+            setPatchError("网络请求异常：" + ((err && err.message) || "未知错误"));
+        });
+    };
+    var openFileDiff = function (f) {
+        setSelectedFile(f);
+        loadPatch();
+    };
     React.useEffect(function () {
         var onKeyDown = function (e) {
-            if (e.key === "Escape" || e.keyCode === 27)
+            if (e.key === "Escape" || e.keyCode === 27) {
+                // 逐层关闭：先收内层 diff 预览，再按一次才关整个提交详情
+                if (selectedFile) {
+                    setSelectedFile(null);
+                    return;
+                }
                 props.onClose();
+            }
         };
         window.addEventListener("keydown", onKeyDown);
         return function () { window.removeEventListener("keydown", onKeyDown); };
-    }, [props.onClose]);
+    }, [props.onClose, selectedFile]);
+    /**
+     * 换提交时清空上一份补丁与选中文件。
+     * 当前调用方在关闭时卸载组件（状态自然复位），但组件一旦被复用（不 key、不卸载），
+     * 残留的 patch 会把 A 提交的差异套到 B 提交的文件路径上——这类错配极难排查，先兜住。
+     */
+    React.useEffect(function () {
+        setPatchState(null);
+        setPatchError(null);
+        setSelectedFile(null);
+    }, [c.sha]);
     React.useEffect(function () {
         setFetchedDetail(null);
         if (c.body || c.stat)
@@ -39,6 +103,13 @@ export function CommitDetailModal(props) {
     var parsedStat = React.useMemo(() => {
         return effectiveStat && typeof parseGitStatText === "function" ? parseGitStatText(effectiveStat) : null;
     }, [effectiveStat]);
+    /**
+     * 切段结果必须缓存：大提交的整包 patch 可达 400k 字符，而本组件在弹窗生命周期里
+     * 会因 selectedFile / patchError 等状态多次重渲染——每次重渲染都重新切一遍是纯浪费。
+     */
+    var patchSections = React.useMemo(function () {
+        return patchState ? splitUnifiedPatch(patchState.patch) : [];
+    }, [patchState]);
     return h("div", {
         className: "dsh-github-modal-overlay",
         onClick: props.onClose,
@@ -142,6 +213,18 @@ export function CommitDetailModal(props) {
                 return h("div", {
                     key: idx,
                     className: "dsh-github-stat-row",
+                    // 可点击 + 可键盘操作：文件行是入口而不是纯展示，缺 aria/键盘会让
+                    // 只用 Tab 的人根本发现不了「能点开看 diff」
+                    role: "button",
+                    tabIndex: 0,
+                    "aria-label": "查看 " + f.path + " 的差异",
+                    onClick: function () { openFileDiff(f); },
+                    onKeyDown: function (e) {
+                        if (e.key === "Enter" || e.key === " " || e.keyCode === 13 || e.keyCode === 32) {
+                            e.preventDefault();
+                            openFileDiff(f);
+                        }
+                    },
                     style: {
                         display: "flex",
                         alignItems: "center",
@@ -151,8 +234,10 @@ export function CommitDetailModal(props) {
                         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",
+                        cursor: "pointer",
+                        userSelect: "none",
                     },
-                    title: f.path + (f.isBinary ? " (二进制文件)" : ` (+${f.additions}, -${f.deletions})`),
+                    title: f.path + (f.isBinary ? " (二进制文件)" : ` (+${f.additions}, -${f.deletions})`) + "\n点击查看该文件的代码改动",
                 }, h("div", {
                     style: {
                         fontFamily: "ui-monospace, SFMono-Regular, SF Mono, Menlo, Consolas, monospace",
@@ -193,6 +278,7 @@ export function CommitDetailModal(props) {
                                 style: { display: "flex", gap: "1px", marginLeft: "2px", alignItems: "center" },
                             }, ...diffBlocks)
                             : null,
+                        h("span", { key: "chev", style: { opacity: 0.4, marginLeft: "2px", fontSize: "12px" }, "aria-hidden": "true" }, "›"),
                     ]));
             }))
             : h("pre", {
@@ -215,5 +301,23 @@ export function CommitDetailModal(props) {
         ? (fetchingDetail
             ? h("div", { style: { fontSize: "12px", opacity: 0.7, padding: "8px 0" } }, "⏳ 正在获取详细变更说明…")
             : h("div", { style: { fontSize: "11px", opacity: 0.6, fontStyle: "italic", padding: "6px 0" } }, "（该提交未包含多行正文；重启 DSH 桌面端可同步最新格式并直接呈现变更统计）"))
-        : null)));
+        : null)), 
+    // 内层 diff 预览：作为 overlay 的兄弟节点而非 dialog 的子节点，
+    // 这样它是独立的一层遮罩（zIndex 更高），点遮罩只关它自己
+    selectedFile
+        ? h(FileDiffModal, {
+            file: selectedFile,
+            cwd: props.cwd,
+            // 传字符串而不是 null：null 会被组件当成「未提供正文 → 自己去拉未提交 diff」
+            diffText: (findPatchSection(patchSections, normalizeRenamePath(selectedFile.path)) || { text: "" }).text,
+            subtitle: String(c.fullSha || c.sha || "").slice(0, 7),
+            loading: patchLoading,
+            error: patchError,
+            note: patchState && patchState.truncated
+                ? "该提交差异过大，预览只覆盖补丁被截断前的文件；其余文件请用命令行查看。"
+                : null,
+            zIndex: 100001,
+            onClose: function () { setSelectedFile(null); },
+        })
+        : null);
 }

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;