dsh-github-flow 0.6.0 → 0.7.1

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.d.ts

@@ -10,7 +10,7 @@
  *
  * 【内容与代码同步的纪律】
  * 本文件里出现的工具数量、action 数量、Tab 名称、按钮文案，全部以当前代码为准：
- * 工具矩阵 = src/main.ts 的 18 处 ctx.tools.register；
+ * 工具矩阵 = src/main.ts 的 19 处 ctx.tools.register；
  * Tab 布局 = src/client.ts 的 TAB_DEFS 与 src/ui/workspace-panel.ts 的四个标签；
  * 若后续增删工具或 Tab，必须同步改这里，否则用户会照着过时说明去找不存在的入口。
  */

package/lib/ui/help-modal.js

@@ -10,7 +10,7 @@
  *
  * 【内容与代码同步的纪律】
  * 本文件里出现的工具数量、action 数量、Tab 名称、按钮文案，全部以当前代码为准：
- * 工具矩阵 = src/main.ts 的 18 处 ctx.tools.register；
+ * 工具矩阵 = src/main.ts 的 19 处 ctx.tools.register；
  * Tab 布局 = src/client.ts 的 TAB_DEFS 与 src/ui/workspace-panel.ts 的四个标签；
  * 若后续增删工具或 Tab，必须同步改这里，否则用户会照着过时说明去找不存在的入口。
  */
@@ -49,7 +49,7 @@ export function GithubHelpModal(props) {
         { id: "quickstart", label: "🚀 3分钟极速上手" },
         { id: "prompts", label: "🤖 Agent 提示词实战" },
         { id: "panels", label: "🖥️ 两大界面操作图解" },
-        { id: "tools", label: "🧰 18 大工具速查" },
+        { id: "tools", label: "🧰 19 大工具速查" },
         { id: "faq", label: "🔑 常见自愈排错" },
     ];
     // 2. 渲染各 Tab 独立视图
@@ -78,7 +78,7 @@ export function GithubHelpModal(props) {
                 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)));
             }), 
             // 能力总览：让用户三秒钟知道这插件到底能干什么，而不是去翻 README
-            h("div", { className: "dsh-github-help-card", style: { marginTop: "4px" } }, h("div", { className: "dsh-github-help-title", style: { marginBottom: "8px" } }, "📦 能力总览：18 大工具 · 103 个业务动作 · 2 套可视化工作台"), h("div", { style: { fontSize: "12px", lineHeight: "1.8", color: "var(--dsw-alias-label-secondary, #8b949e)" } }, "Agent 侧可直接调用 18 个 github_* 工具（PR 审查合并、Issue 任务流转、Actions 排障、免 clone 读文件、发版交付、Secrets 管理、Skills 生态、标签与规则集、构建缓存、Gist、跨仓待办大盘、Copilot 智能体、Discussions、Projects v2、Codespaces、运行时遥测与元指南）。", h("br"), "人类侧在每个会话右侧栏拥有 5 个 Tab（Git / 未提交 / PR / Issues / Actions），在最左侧 Octocat 入口拥有 4 个标签的全景驾驶舱。")));
+            h("div", { className: "dsh-github-help-card", style: { marginTop: "4px" } }, h("div", { className: "dsh-github-help-title", style: { marginBottom: "8px" } }, "📦 能力总览：19 大工具 · 106 个业务动作 · 2 套可视化工作台"), h("div", { style: { fontSize: "12px", lineHeight: "1.8", color: "var(--dsw-alias-label-secondary, #8b949e)" } }, "Agent 侧可直接调用 19 个 github_* 工具（PR 审查合并、Issue 任务流转、Actions 排障、免 clone 读文件、发版交付、Secrets 管理、Skills 生态、标签与规则集、构建缓存、Gist、跨仓待办大盘、Copilot 智能体、Discussions、Projects v2、Codespaces、运行时遥测与元指南）。", h("br"), "人类侧在每个会话右侧栏拥有 5 个 Tab（Git / 未提交 / PR / Issues / Actions），在最左侧 Octocat 入口拥有 4 个标签的全景驾驶舱。PR / Issue / Actions 的卡片点击都能在线查看详情——Actions 看到的是 job / step 树与失败步骤，失败时还能按需拉一段日志，不用切浏览器。")));
         }
         if (activeTab === "prompts") {
             var promptCards = [
@@ -92,7 +92,7 @@ export function GithubHelpModal(props) {
                     title: "🚨 场景二：CI / Actions 门禁报错秒级排查与自动修复",
                     desc: "构建挂了不用在网页反复翻几十页日志，直接吩咐 Agent 定位报错步骤并就地改代码。",
                     prompt: "检查当前仓库最近一次 CI 失败的原因，精确定位报错步骤并帮我尝试修复代码",
-                    aiAction: "Agent 自动调用失败日志探测工具，秒级提取具体挂掉的构建步骤输出，精准定位语法/单测异常并就地修改本地代码。",
+                    aiAction: "Agent 会调 github_task(action:'diagnose_ci') 或 github_run(action:'log_failed')：先定位失败 job/step，再按框架锚点萃取日志（pytest / node / Go / tsc / npm），最后汇总疑似相关文件。日志被截断时它会明确告诉你「总数未知」，不要当成「就这些失败」。",
                 },
                 {
                     title: "📌 场景三：早会与每日任务待办盘点",
@@ -160,21 +160,25 @@ 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：最近工作流运行记录与触发方式，失败时给出可直接交给 Agent 的诊断指引；",
+                        "Actions Tab：最近工作流运行记录与触发方式；点击卡片在线查看本次运行的 job / step 树（每步结论与耗时，失败步骤高亮，默认展开第一个失败 job），失败时可按需提取日志锚点片段（一次最多 3 个失败 job、服务端批次预算 90 秒）；",
                         "动静解耦架构：修改本地代码只定向查询本地 .git 核心元数据（耗时仅 5ms），绝对不发起远端网络请求，杜绝网络风暴。",
                     ],
                 },
                 {
-                    title: "3. 两个弹窗的通用操作习惯",
+                    title: "3. 详情弹窗的通用操作习惯",
                     items: [
-                        "PR / Issue 弹窗都支持：按 Esc 或点击遮罩关闭、右上角「📋 复制链接」、「↗ 浏览器打开」直达 GitHub；",
+                        "PR / Issue / Actions 三个弹窗都支持：按 Esc 或点击遮罩关闭、右上角「GitHub ↗」直达官方页面；",
+                        "文件 Diff 弹窗可以叠在提交详情之上：Esc 或点遮罩先关 Diff，再按一次才关提交详情；弹窗内可「📋 复制 Diff」原文或「📄 在 DSH 中打开」查看文件源码；",
+                        "Diff 弹窗对正文里的 `---` / `+++` 不会误判成文件头（按 hunk 解析），重命名文件按新路径展示、二进制文件给明确提示；",
                         "列表卡片上的「GitHub ↗」按钮是独立的浏览器外跳入口，点它不会触发弹窗（已做事件隔离）；",
                         "PR 弹窗的文件区可拖拽分隔条调宽、双击或点 ◀ 折叠；布局偏好会记在本地，下次打开保持原样；",
-                        "长评论默认折叠（显示「⌄ 展开全部」），PR/Issue 正文默认展开——避免一屏被一段超长文字占满。",
+                        "长评论默认折叠（显示「⌄ 展开全部」），PR/Issue 正文默认展开——避免一屏被一段超长文字占满；",
+                        "Actions 弹窗按 job 折叠/展开步骤，默认展开第一个失败 job；「📄 提取失败日志」只在存在失败时出现，点一次拉一次（慢链路不做自动重试，失败可手动重试）；",
+                        "日志片段是按失败锚点萃取过的——看到的是「失败块 + 上下文」或尾部 200 行，不是完整日志；要全文请点「GitHub ↗」。",
                     ],
                 },
             ].map(function (sec, idx) {
@@ -188,7 +192,7 @@ export function GithubHelpModal(props) {
                     items: [
                         { name: "github_pr", desc: "PR 全生命周期：列表/详情/diff/checks/create/merge/review/ready/update_branch/revert/preview/checkout，含行级评论与附件上传" },
                         { name: "github_issue", desc: "Issue 任务流转：list/view/create/comment/edit/close/reopen/develop/transfer/pin/lock/delete/status，含截图查看 view_images" },
-                        { name: "github_run", desc: "Actions 排障：list/view/log_failed（失败步骤日志秒级提取）/rerun/cancel/trigger/download 与 workflow 启停" },
+                        { name: "github_run", desc: "Actions 排障：list、view（run + job/step 树）、log_failed（失败步骤日志秒级提取）/rerun/cancel/trigger/download 与 workflow 启停" },
                         { name: "github_repo", desc: "仓库元数据、免 clone 读文件（read_file/read_dir）、跨仓检索（code/issues/prs/commits）、Fork 同步" },
                     ],
                 },
@@ -222,7 +226,7 @@ export function GithubHelpModal(props) {
                     ],
                 },
             ];
-            return h("div", null, h("div", { className: "dsh-github-help-desc", style: { fontSize: "13px", marginBottom: "14px" } }, "18 个 Agent 工具、合计 103 个业务动作（不含元指南的 21 个查询主题与 api 逃生门的 4 个 HTTP method）。你不必记住工具名——直接用自然语言描述目标，Agent 会自己挑工具。下表用于你了解能力边界，以及排查「为什么 Agent 说做不到」："), toolGroups.map(function (g, gi) {
+            return h("div", null, h("div", { className: "dsh-github-help-desc", style: { fontSize: "13px", marginBottom: "14px" } }, "19 个 Agent 工具、合计 106 个业务动作（不含元指南的 22 个查询主题与 api 逃生门的 4 个 HTTP method）。你不必记住工具名——直接用自然语言描述目标，Agent 会自己挑工具。下表用于你了解能力边界，以及排查「为什么 Agent 说做不到」："), toolGroups.map(function (g, gi) {
                 return h("div", { key: gi, className: "dsh-github-help-card" }, h("div", { className: "dsh-github-help-title", style: { marginBottom: "8px" } }, g.group), g.items.map(function (t, ti) {
                     return h("div", { key: ti, style: { display: "flex", gap: "10px", alignItems: "flex-start", padding: "5px 0", borderTop: ti === 0 ? "none" : "1px solid var(--dsw-alias-border-l1, rgba(255,255,255,0.06))" } }, h("code", {
                         style: {
@@ -262,6 +266,14 @@ export function GithubHelpModal(props) {
                     q: "Q6: 为什么改了代码，插件界面要重启 DSH 才生效？",
                     a: "如果你是在开发这个插件本身：后端 HTTP 路由是在插件 `apply()` 时一次性注册到宿主的 WebServer 上的，`pnpm run build` 只更新磁盘产物，不会给已运行的进程热注册新路由。改完代码需重启 DSH 才能挂上新端点。\n若只是普通使用，请忽略此条——正常升级走一键升级即可。",
                 },
+                {
+                    q: "Q7: Actions 弹窗里点「提取失败日志」很久没反应，或报超时？",
+                    a: "GitHub 的日志接口是「先打包再下载」，实测单次 4–40 秒，走代理时还可能被直接重置——这是上游链路特性，不是插件卡死。当前实现有三道闸：\n- 服务端单 job 上限 60 秒、整批总预算 90 秒；超预算的 job 会明确列出「未拉取，可单独重试」，不会静默丢掉；\n- 客户端 100 秒自动中止，避免按钮永远停在「正在下载日志…」；\n- 失败后弹窗内给「🔁 重试」，不做自动重试（重试会把等待时间叠加）。\n急的话点右上角「GitHub ↗」看完整日志，或让 Agent 调 `github_task(action:'diagnose_ci', run_id:'…')` 直接拿结论包。",
+                },
+                {
+                    q: "Q8: 为什么 Actions 弹窗只能看 3 个失败 job 的日志？",
+                    a: "一次点击串行拉 3 个 job 已经是 60–90 秒量级；矩阵构建下失败 job 可能有十几个，全拉会把一次点击变成几分钟。当前策略：只取前 3 个失败 job，并在按钮下方明示「共 N 个，其余请到 GitHub 查看」。需要逐个深挖时，让 Agent 用 `github_run(action:'log_failed', run_id:'…')` 或 `github_task(action:'diagnose_ci')` 分批处理更合适。",
+                },
             ];
             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));

package/lib/ui/issue-modal.js

@@ -1,3 +1,4 @@
+import { issueStateBadge } from '../shared/state-badges.js';
 /**
  * GitHub 关闭原因的状态语义映射。
  * 实测 `stateReason` 取值域：COMPLETED / NOT_PLANNED / REOPENED / ''（空串）。
@@ -201,11 +202,14 @@ export function IssueDetailModal(props) {
     var stateBadge = function (d) {
         if (!d)
             return null;
-        var isOpen = String(d.state).toUpperCase() === "OPEN";
+        // 状态→色调来自 shared/state-badges（与右侧栏 / CLI 输出同一份映射）
+        var b = issueStateBadge(d.state);
+        if (!b)
+            return null;
         return h("span", {
-            className: "dsh-github-badge " + (isOpen ? "dsh-badge-green" : "dsh-badge-red"),
+            className: "dsh-github-badge dsh-badge-" + b.tone,
             style: { fontSize: "10px", padding: "1px 6px", flexShrink: 0 },
-        }, isOpen ? "OPEN" : "CLOSED");
+        }, b.label);
     };
     /**
      * 元数据条：只渲染真实存在的字段。

package/lib/ui/pr-modal.js

@@ -1,3 +1,4 @@
+import { prStateBadge } from '../shared/state-badges.js';
 /**
  * 可折叠的 Markdown 内容块。
  *
@@ -336,18 +337,36 @@ export function PrDetailModal(props) {
         },
     }, data ? `#${data.number} ${data.title}` : `PR #${prNumber}`), data
         ? h("span", {
+            // 色调来自 shared/state-badges（与右侧栏 / CLI 输出同一份映射）；
+            // 文案保持原样（Draft 用大驼峰、其余直接展示 GitHub 原始 state）。
+            // 未知状态沿用旧实现的绿色兜底（旧代码的 else 分支就是 green）。
             className: "dsh-github-badge " +
-                (data.isDraft
-                    ? "dsh-badge-yellow"
-                    : data.state === "MERGED"
-                        ? "dsh-badge-purple"
-                        : data.state === "CLOSED"
-                            ? "dsh-badge-red"
-                            : "dsh-badge-green"),
+                (function () {
+                    var b = prStateBadge(data.state, data.isDraft);
+                    return "dsh-badge-" + (b && b.tone !== "neutral" ? b.tone : "green");
+                })(),
             style: { fontSize: "10px", padding: "1px 6px" },
         }, data.isDraft ? "Draft" : data.state)
         : null), data
-        ? h("div", { style: { fontSize: "11px", color: "var(--dsw-alias-label-secondary, #656d76)", display: "flex", gap: "6px", alignItems: "center", flexWrap: "wrap" } }, h("span", null, `👤 @${data.author.login}`), data.createdAt ? h("span", null, `· 提单于 ${formatRelativeTime(data.createdAt)}`) : null, h("span", { style: { fontFamily: "monospace", opacity: 0.85 } }, `(${data.headRefName} → ${data.baseRefName})`))
+        ? h("div", { style: { fontSize: "11px", color: "var(--dsw-alias-label-secondary, #656d76)", display: "flex", gap: "6px", alignItems: "center", flexWrap: "wrap" } }, h("span", null, `👤 @${data.author.login}`), data.createdAt ? h("span", null, `· 提单于 ${formatRelativeTime(data.createdAt)}`) : null, h("span", { style: { fontFamily: "monospace", opacity: 0.85 } }, `(${data.headRefName} → ${data.baseRefName})`), 
+        /*
+         * 审查锚点：分支名会移动，SHA 不会。
+         * 点开这个弹窗时先看这一枚 chip，就能确认「我看到的是不是最新一次推送」；
+         * title 里放完整 SHA，方便复制去精确引用。老服务端没有该字段时不渲染。
+         */
+        typeof data.headRefOid === "string" && data.headRefOid.length >= 7
+            ? h("span", {
+                title: `headRefOid: ${data.headRefOid}`,
+                style: {
+                    fontFamily: "monospace",
+                    fontSize: "10px",
+                    padding: "1px 6px",
+                    borderRadius: "10px",
+                    border: "1px solid var(--dsw-alias-border-l2, rgba(31,35,40,0.15))",
+                    opacity: 0.9,
+                },
+            }, `🔖 ${data.headRefOid.slice(0, 7)}`)
+            : null)
         : null)), h("div", { style: { display: "flex", alignItems: "center", gap: "6px", flexShrink: 0 } }, data?.url
         ? h("button", {
             className: "dsh-github-btn-sm",
@@ -390,7 +409,10 @@ export function PrDetailModal(props) {
                 }, `💬 描述与讨论 (${data.comments ? data.comments.length : 0})`), h("button", {
                     className: `dsh-github-pr-tab-btn ${activeTab === "files" ? "active" : ""}`,
                     onClick: () => setActiveTab("files"),
-                }, `📁 变动文件 (${data.files ? data.files.length : 0} 文件 · +${data.additions || 0} / -${data.deletions || 0})`)), 
+                }, 
+                // 截断时显示 N/M：M 来自 changedFiles（权威总数），N 是 gh 实际返回的条数。
+                // 只显示 N 会让「被截断」看起来像「就这么多」——这是 cli/cli#12522 的静默截断。
+                `📁 变动文件 (${data.files ? data.files.length : 0}${data.filesTruncated && data.changedFiles ? '/' + data.changedFiles : ''} 文件 · +${data.additions || 0} / -${data.deletions || 0})${data.filesTruncated ? ' ⚠️' : ''}`)), 
                 // Tab 1: 描述与讨论
                 activeTab === "conversation"
                     ? h("div", { className: "dsh-github-modal-body dsh-github-pr-conversation-pane" }, 
@@ -461,7 +483,9 @@ export function PrDetailModal(props) {
                                 onClick: toggleFilePane,
                                 style: { padding: "2px 8px", fontSize: "10px", flexShrink: 0 },
                                 title: "展开左侧文件列表",
-                            }, `📁 文件列表 (${(data.files && data.files.length) || 0})`)
+                            }, 
+                            // 折叠态同样要透出截断事实（N/M），否则展开前的第一眼就被骗了
+                            `📁 文件列表 (${(data.files && data.files.length) || 0}${data.filesTruncated && data.changedFiles ? '/' + data.changedFiles : ''})`)
                             : null, h("span", { style: { fontFamily: "monospace", fontWeight: 600, fontSize: "11px", overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" } }, selectedFilePath), data.fileDiffs && data.fileDiffs[selectedFilePath]
                             ? h("button", {
                                 className: "dsh-github-btn-sm",
@@ -469,7 +493,9 @@ export function PrDetailModal(props) {
                                 style: { padding: "2px 8px", fontSize: "10px" },
                             }, copied ? "✓ 已复制" : "📋 复制文件 Diff")
                             : null), h("div", { style: { flex: 1, overflowY: "auto", minHeight: 0 } }, 
-                        // 截断警告必须显式呈现：否则用户会把「拿不到 diff」误读成「代码没改动」
+                        // 两种「看不到 diff」的原因必须分开说，否则用户不知道该做什么：
+                        // ① diffTruncated：整段 diff 被输出阈值裁掉（去 GitHub 看完整内容）
+                        // ② diffIncomplete：这个文件在清单里但没取到切片（换一个文件/重试）
                         data.diffTruncated
                             ? h("div", {
                                 style: {
@@ -483,6 +509,19 @@ export function PrDetailModal(props) {
                                     color: "var(--dsw-alias-state-attention-primary, #9a6700)",
                                 },
                             }, "⚠️ 该 PR 的 diff 体量过大已触达输出上限，部分文件可能无法展示差异。可点击右上角「↗ 浏览器打开」查看完整内容。")
+                            : null, data.diffIncomplete
+                            ? h("div", {
+                                style: {
+                                    margin: "8px",
+                                    padding: "8px 12px",
+                                    borderRadius: "6px",
+                                    fontSize: "11px",
+                                    lineHeight: 1.5,
+                                    background: "rgba(210, 153, 34, 0.12)",
+                                    border: "1px solid rgba(210, 153, 34, 0.35)",
+                                    color: "var(--dsw-alias-state-attention-primary, #9a6700)",
+                                },
+                            }, "⚠️ 有文件未能取到 diff 正文（二进制、重命名或超出切片范围）。这些文件显示为空不代表没有改动，请到 GitHub 核对。")
                             : null, data.fileDiffs && data.fileDiffs[selectedFilePath]
                             ? renderDiffContent(data.fileDiffs[selectedFilePath])
                             : renderDiffContent(""), 

package/lib/ui/run-modal.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Actions run / job / step 的耗时格式化（导出以便单测直接覆盖）。
+ *
+ * 为什么不用 formatRelativeTime：那个函数答的是「发生在多久前」，这里是「跑了多久」；
+ * 而且 run → job → step 三层共用同一套精度规则（<60s → `12s`、<60m → `3m20s`、
+ * 其余 `1h05m`），分钟/秒补零才能让三层的列宽稳定对齐。
+ * 任一端缺失或不可解析一律返回空串：排队中/已跳过的 job 没有 startedAt/completedAt，
+ * 硬算只会渲染出「0s」这种假精确值，比不显示更误导。
+ */
+export declare function formatRunDuration(startISO?: string, endISO?: string): string;
+export interface RunDetailModalProps {
+    runId: number;
+    repoNameWithOwner?: string;
+    cwd?: string | null;
+    onClose: () => void;
+    showToast?: (msg: string) => void;
+}
+/**
+ * Actions Run 详情弹窗（只读：run 元信息 + job/step 树 + 失败日志片段）。
+ *
+ * 单列纵向：run 的信息天然是「job 列表 + 一条日志流」的阅读顺序，没有需要并排
+ * 对照的第二个信息源（PR 才有 diff 双栏）。
+ * 日志刻意渲染成 <pre> 原文而不是 markdown-lite：原始日志里的 `#`、`|`、`---`
+ * 是 shell 注释、表格与 diff 分隔符，交给 Markdown 解析会把堆栈与 diff 撕碎。
+ */
+export declare function RunDetailModal(props: RunDetailModalProps): any;