dsh-github-flow 0.6.0 → 0.7.0

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/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: "📌 场景三：早会与每日任务待办盘点",
@@ -164,17 +164,19 @@ export function GithubHelpModal(props) {
                         "未提交 Tab：实时监听本地未提交文件与状态码（?? 新增 / M 修改 / D 删除 / R 重命名），点击文件可就地下钻查看该文件的 Unified Diff；",
                         "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 ↗」直达官方页面；",
                         "列表卡片上的「GitHub ↗」按钮是独立的浏览器外跳入口，点它不会触发弹窗（已做事件隔离）；",
                         "PR 弹窗的文件区可拖拽分隔条调宽、双击或点 ◀ 折叠；布局偏好会记在本地，下次打开保持原样；",
-                        "长评论默认折叠（显示「⌄ 展开全部」），PR/Issue 正文默认展开——避免一屏被一段超长文字占满。",
+                        "长评论默认折叠（显示「⌄ 展开全部」），PR/Issue 正文默认展开——避免一屏被一段超长文字占满；",
+                        "Actions 弹窗按 job 折叠/展开步骤，默认展开第一个失败 job；「📄 提取失败日志」只在存在失败时出现，点一次拉一次（慢链路不做自动重试，失败可手动重试）；",
+                        "日志片段是按失败锚点萃取过的——看到的是「失败块 + 上下文」或尾部 200 行，不是完整日志；要全文请点「GitHub ↗」。",
                     ],
                 },
             ].map(function (sec, idx) {
@@ -188,7 +190,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 +224,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 +264,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;