dsh-github-flow 0.2.1 → 0.3.0

package/README.en.md

@@ -72,7 +72,7 @@ dsh plugin --profile web add dsh-github-flow
 
 ## 🤖 Core Agent Tools: Equipping Agents with Native GitHub Powers
 
-Consolidates scattered GitHub endpoints into **9 core domain tools**, featuring **Token Budget Protection (default 24KB intelligent truncation)**, **High-density Native Markdown Rendering (70%+ list output token reduction)** and **Zero-argument CWD auto-binding**.
+Consolidates scattered GitHub endpoints into **9 core domain tools (76+ actions covering PR/Issue/Actions workflow governance/clone-free file reads/secrets & variables)**, featuring **Token Budget Protection (default 24KB intelligent truncation)**, **High-density Native Markdown Rendering (70%+ list output token reduction)** and **Zero-argument CWD auto-binding**.
 
 ### 1. `github_pr`: Pull Request Lifecycle & Automated Code Review
 > **Example Agent Prompts**:
@@ -91,6 +91,9 @@ Consolidates scattered GitHub endpoints into **9 core domain tools**, featuring
   * `status`: 🆕 Inspect merge conflict status (`CLEAN` / `CONFLICT`) for the current branch's PR;
   * `review`: Submit code reviews (`APPROVE`, `REQUEST_CHANGES`, `COMMENT`);
   * `merge`: Merge pull requests (`squash` / `merge` / `rebase`, optional `delete_branch`; requires `confirm: true`);
+  * `ready`: 🆕 Toggle Draft ↔ Ready (`undo: true` converts back to Draft — fully reversible);
+  * `revert`: 🆕 Create a revert commit (generates a new revert PR on the remote; requires `confirm: true`);
+  * `update_branch`: 🆕 Sync the latest base-branch commits into the PR branch — the self-healing action for "branch is out-of-date" CI gate failures;
   * `view_images`: 🆕 Download PR discussion screenshots (body + comments; `image_urls` targeting with budget-overflow resume list).
 
 ---
@@ -106,6 +109,10 @@ Consolidates scattered GitHub endpoints into **9 core domain tools**, featuring
   * `list`: View recent workflow runs and conclusions (`branch` / `status: failure` filters to pin down broken builds);
   * `view`: Inspect jobs and steps for a specific run ID;
   * `trigger`: 🆕 Manually dispatch `workflow_dispatch` workflows to verify fixes immediately;
+  * `workflow_list`: 🆕 List workflows (active only by default; `all: true` includes disabled — when diagnosing "why didn't my workflow run", the disabled state itself is the answer);
+  * `workflow_view`: 🆕 Workflow details (locate by name/ID/filename, with recent runs);
+  * `workflow_enable` / `workflow_disable`: 🆕 Toggle workflows (disable explicitly warns "the next trigger will fail silently");
+  * `download`: 🆕 Download build artifacts to a plugin-managed directory (isolated per repo and run, returns file manifest; older gh versions get a security upgrade note);
   * `rerun`: Re-trigger failed CI runs;
   * `cancel`: Cancel in-progress workflows.
 
@@ -126,6 +133,11 @@ Consolidates scattered GitHub endpoints into **9 core domain tools**, featuring
   * `develop`: 🆕 Create a linked development branch from an issue and check it out locally;
   * `comment`: Append debugging updates or notes;
   * `close` (requires `confirm: true`) / `reopen`: Manage issue lifecycle states;
+  * `delete`: 🆕 **Permanently delete** an issue (requires `confirm: true`; the number is gone forever and comments are destroyed — fundamentally different from close, which can be reopened);
+  * `transfer`: 🆕 Transfer an issue to another repository (requires `confirm: true`; original URL 301-redirects, ownership cannot be silently reverted);
+  * `pin` / `unpin`: 🆕 Toggle issue pinning (reversible state flag);
+  * `lock` / `unlock`: 🆕 Lock/unlock conversation (`lock_reason` supports off_topic/resolved/spam/too_heated);
+  * `status`: 🆕 Account-level assigned-issues panel (Assigned / Mentioning sections);
   * `view_images`: 🆕 Download issue attachment screenshots (body + comments; `image_urls` targeting with resume list).
 
 ---
@@ -141,7 +153,10 @@ Consolidates scattered GitHub endpoints into **9 core domain tools**, featuring
   * `readme`: 🆕 Read repository README raw content (branch-selectable; relative-path screenshots auto-resolved and downloaded);
   * `sync`: 🆕 One-click fork sync with upstream to fix stale-fork CI gate failures;
   * `search_code`: Search code symbols in current or specified repositories;
-  * `search_repos`: Search open-source GitHub repositories globally.
+  * `search_repos`: Search open-source GitHub repositories globally;
+  * `search_issues` / `search_prs` / `search_commits`: 🆕 Global search over issues / PRs / commits (qualifiers go inline in the query, e.g. `repo:o/r state:open`; commits require search text);
+  * `read_file`: 🆕 **Clone-free single-file read at any path** (native on gh ≥2.95; older versions auto-degrade to the contents API with an explicit degraded-path note; binary files are rejected with `github_api` guidance);
+  * `read_dir`: 🆕 Clone-free directory listing (dirs first + file sizes, same degradation path).
 
 ---
 
@@ -166,15 +181,17 @@ Consolidates scattered GitHub endpoints into **9 core domain tools**, featuring
 
 ---
 
-### 7. `github_secret`: CI/CD Secrets Management 🆕
+### 7. `github_secret`: CI/CD Secrets & Variables Management 🆕
 > **Example Agent Prompts**:
 > - *"Update the NPM_TOKEN secret for this repository."*
 > - *"Show which secrets are configured for this repo."*
+> - *"Set the DEPLOY_ENV variable to staging and read it back to confirm."*
 
 * **Supported Actions**:
-  * `list`: Show secret names and update times (the GitHub API never exposes secret values);
+  * `list`: Show secret/variable names and update times (the GitHub API never exposes secret values);
   * `set`: Set/update secret values — **passed via subprocess stdin, never on the command line (ps-safe), never echoed in output**;
   * `delete` (requires `confirm: true`): Remove a secret.
+  * Switch to **Actions plaintext variables** via `kind: 'variable'`: `set` passes the value directly as a flag and `get` can echo it back (that's the design difference from secrets — secrets are encrypted GitHub-side after write and physically unreadable); the two security semantics are physically isolated in the rendering layer.
   * Supports repository / organization (`org`) / environment (`env`) scopes across `actions` / `codespaces` / `dependabot` / `agents` apps.
 
 ---
@@ -232,14 +249,23 @@ Access via the GitHub icon in the main left navigation:
 </p>
 
 ### 2. Session Right Sidebar Panel (Workspace Drawer)
-Located in the right drawer of every chat workspace:
-* **Context Auto-Binding**: Automatically locks onto the active Git repository;
-* **Freshness Pill Alignment**: Compact indicator `[📦 Local Snapshot (2m ago)]` with live `[🔄 Refresh]` button, 100% aligned with global rules;
-* **PR Status Pills**: Live PR inspection with CI checks and review badges;
-* **Workspace Open Issues List**: Direct issue task review with author badges and external links;
-* **Latest Actions Pipeline**: Real-time CI workflow status tracking;
+Located in the right drawer of every chat workspace, seamlessly bridging your local Git workspace with remote GitHub repositories:
+* **Context Auto-Binding**: Automatically locks onto the active Git repository of the current session;
+* **Freshness Pill Alignment**: Compact indicator `[📦 Local Snapshot (2m ago)]` with live `[🔄 Refresh]` button, 100% aligned with global rules for an instant 0ms first render;
 * **Quick Action Grid**: Open repo in browser, jump to Issues/PRs, create PRs with one click;
-* **⚙️ Full Settings Access**: The sidebar offers its own settings button reusing the same settings modal as the cockpit (all four sections: Sync / Proxy / Update Source / About) — no need to switch back to the main page.
+* **Five Mutually Exclusive Tabs**: Compact tabbed navigation directly below the quick action grid, reducing vertical scrolling:
+  * **Git Records (`Git`)** (Default tab):
+    * Branch & Remote Sync: Real-time branch indicator (e.g. `master`) with tracking sync status (`✓ Up to date` or `↑N to push` / `↓N to pull`);
+    * Three-Section Commit View: Unpushed commits (ahead of remote), unpulled commits (behind remote), and recent commit history;
+    * 15 commits displayed by default, with **infinite scroll loading** when scrolling to the bottom (with live `15 / 74` progress counter and click trigger);
+    * Latest Release badge (`🏷️ v0.2.1`) anchored in the top right with hover details and direct release link;
+    * **Commit Detail Modal**: Click any commit row to open a clean modal dialog centered within the right sidebar (scoped inside drawer boundaries without overflowing full-screen), featuring smooth vertical scrolling, full 40-char SHA, author email, date, multi-line commit message body, and file diff stat table (`--stat`); pure local 0ms instant display, closable via `Esc`, close button, or backdrop click;
+  * **Uncommitted Changes (`📁 Uncommitted (N)`)**: Full-width list of uncommitted files with color-coded status codes (`??` untracked, `M` modified, `D` deleted, `R` renamed) and change counts;
+  * **Pull Requests (`🔀 PR (N)`)**: Open PR inspection with 3-state CI check rollup (`✅ CI Passed` / `❌ CI Failed` / `⏳ CI Pending`), merge conflict detection, review decisions (`✔ Approved` / `✋ Changes Requested` / `👀 Review Required`), Draft pills, and humanized relative timestamps;
+  * **Workspace Issues (`📋 Issues (N)`)**: Direct issue task review with assignees, labels, and category pills;
+  * **Actions Pipeline (`⚡ Actions (N)`)**: Real-time CI workflow status tracking with trigger event badges (`push`/`schedule`/`manual`/`PR`), relative time, and self-healing diagnostic notes for failed runs (embedding `run_id` for Agent one-click log inspection);
+* **Official Git Vector Icon**: High-definition Git diamond vector icon (`#1296db` SVG) across all Git and branch labels;
+* **⚙️ Full Settings Access**: Dedicated settings button reusing the same settings modal as the cockpit (all four sections: Sync / Proxy / Update Source / About) — no need to switch back to the main page.
 
 <p align="center">
   <img src="./docs/images/2.png" alt="Session Right Sidebar Panel" width="100%" />
@@ -348,6 +374,7 @@ Works out of the box, with optional tweaks in `cordis.patch.yml` or your profile
         defaultListLimit: 20      # Default list size for pr/issue/run/release/skill queries
         cacheTtlMs: 15000         # Repository overview cache TTL (default 15s)
         checkUpdate: true         # Enable automatic update checks (default true)
+        agentEnvInjection: true   # Inject AI_AGENT=dsh identity into gh (auto agent-friendly output on gh ≥2.99; false restores native gh behavior)
         updateCheckIntervalMs: 86400000 # Check interval in ms (default 24h)
         registryUrl: ''           # Custom private npm registry URL
         proxyUrl: ''              # Preset proxy default (e.g. 'http://127.0.0.1:7890'; only applies before the cockpit setting is saved — UI setting takes precedence)

package/README.md

@@ -10,7 +10,7 @@
 
 <p align="center">
   <b>让 DeepSeek Harness Agent 拥有操作 GitHub 的原生手和脚，为人机协作打造沉浸式 GitHub 工作台。</b><br>
-  原生复用宿主机 <code>gh</code> CLI 安全登录凭据，告别 Personal Access Token 泄露；深度打通本地 Git 工作区与云端仓库协作，兼具 <b>9 大领域 Agent 核心工具</b>、<b>人类 Slash 快捷指令</b>、<b>Web UI 全景工作台</b> 与 <b>一键自动跨平台无缝升级</b>。
+  原生复用宿主机 <code>gh</code> CLI 安全登录凭据，告别 Personal Access Token 泄露；深度打通本地 Git 工作区与云端仓库协作，兼具 <b>9 大领域 Agent 核心工具（76+ action，覆盖 PR/Issue/Actions 工作流治理/免 clone 读取任意文件/密钥与变量管理）</b>、<b>人类 Slash 快捷指令</b>、<b>Web UI 全景工作台</b> 与 <b>一键自动跨平台无缝升级</b>。
 </p>
 
 <p align="center">
@@ -91,6 +91,9 @@ dsh plugin --profile web add dsh-github-flow
   * `status`：🆕 查看当前分支关联 PR 的合并冲突状态（`CLEAN` / `CONFLICT`）；
   * `review`：提交代码审查意见（`APPROVE`, `REQUEST_CHANGES`, `COMMENT`）；
   * `merge`：自动执行合并（支持 `squash` / `merge` / `rebase`，可指定 `delete_branch`；需 `confirm: true` 二次确认）；
+  * `ready`：🆕 Draft ↔ Ready 切换（附 `undo: true` 可转回 Draft，完整可逆）；
+  * `revert`：🆕 创建反向提交（远端生成新 revert PR，需 `confirm: true`）；
+  * `update_branch`：🆕 将基准分支最新提交同步进 PR 分支——「分支落后需更新」CI 门禁失败的自愈动作；
   * `view_images`：🆕 下载 PR 讨论截图（正文+评论，支持 `image_urls` 精准提取与触顶续传清单）。
 
 ---
@@ -106,6 +109,10 @@ dsh plugin --profile web add dsh-github-flow
   * `list`：查看当前仓库的 Workflow 运行历史与结论（支持 `branch` / `status: failure` 快速锁定失败构建）；
   * `view`：查看指定 run_id 的详细阶段（Jobs & Steps）；
   * `trigger`：🆕 主动触发 `workflow_dispatch` 工作流（提交修复后立即验证远端 CI）；
+  * `workflow_list`：🆕 工作流清单查询（默认仅 active；`all: true` 含 disabled——排查「工作流为何不跑」时 disabled 状态本身就是答案）；
+  * `workflow_view`：🆕 工作流详情（名称/ID/文件名定位，含最近运行记录）；
+  * `workflow_enable` / `workflow_disable`：🆕 启停工作流（disable 会显式警告「下次 trigger 将静默失败」）；
+  * `download`：🆕 下载构建产物到插件管理目录（按仓库与 run 隔离，返回文件清单；低版本 gh 附安全升级提示）；
   * `rerun`：重新触发失败的 CI 运行；
   * `cancel`：取消在途的工作流。
 
@@ -126,6 +133,11 @@ dsh plugin --profile web add dsh-github-flow
   * `develop`：🆕 从 Issue 一键切出关联开发分支并本地检出，打通「读需求 → 写代码」闭环；
   * `comment`：在指定 Issue 中追加排查进展或评论；
   * `close`（需 `confirm: true`）/ `reopen`：开启或关闭 Issue；
+  * `delete`：🆕 **物理删除** Issue（需 `confirm: true`；编号永久消失、评论湮灭不可恢复——与 close 可 reopen 有本质区别，拦截级别更高）；
+  * `transfer`：🆕 跨仓库迁移 Issue（需 `confirm: true`；原 URL 301 重定向，归属不可静默撤回）；
+  * `pin` / `unpin`：🆕 置顶/取消置顶（可逆状态位）；
+  * `lock` / `unlock`：🆕 锁定/解锁对话（`lock_reason` 支持 off_topic/resolved/spam/too_heated）；
+  * `status`：🆕 账号维度的分配议题面板（Assigned / Mentioning 分段）；
   * `view_images`：🆕 下载 Issue 报障截图（正文+评论全量提取，支持 `image_urls` 按 URL 精准提取，触顶自动返回续传清单）。
 
 ---
@@ -141,7 +153,10 @@ dsh plugin --profile web add dsh-github-flow
   * `readme`：🆕 读取仓库 README 原文（支持指定分支，相对路径截图自动解析下载）；
   * `sync`：🆕 一键拉平 Fork 仓库与上游主干，解决贡献开源项目时 Fork 落后导致 CI 门禁失败；
   * `search_code`：跨仓库或当前仓库检索特定代码符号；
-  * `search_repos`：跨全站检索 GitHub 开源仓库。
+  * `search_repos`：跨全站检索 GitHub 开源仓库；
+  * `search_issues` / `search_prs` / `search_commits`：🆕 全站检索 Issue / PR / 提交记录（限定符直接写进 query，如 `repo:o/r state:open`；commits 必须含搜索文本）；
+  * `read_file`：🆕 **免 clone 读取任意路径单文件**（gh ≥2.95 直连，低版本自动降级 contents API 并显式标注降级链路；二进制文件拒绝并引导 `github_api`）；
+  * `read_dir`：🆕 免 clone 列出目录清单（dir 置顶 + 文件大小，降级链路同上）。
 
 ---
 
@@ -166,15 +181,17 @@ dsh plugin --profile web add dsh-github-flow
 
 ---
 
-### 7. `github_secret`：CI/CD 部署密钥安全管理 🆕
+### 7. `github_secret`：CI/CD 密钥与变量管理 🆕
 > **典型对话指令**：
 > - *"帮我把新的 NPM_TOKEN 更新到当前仓库的 Secrets 里"*
 > - *"看一下这个仓库配了哪些密钥"*
+> - *"把 DEPLOY_ENV 变量设为 staging，并回读确认"*
 
 * **支持操作 (`action`)**：
-  * `list`：查看密钥名称清单（仅名称与更新时间，GitHub API 设计上不允许读取密文）；
+  * `list`：查看密钥/变量名称清单（仅名称与更新时间，GitHub API 设计上不允许读取密文）；
   * `set`：设置/更新密钥值——**密文经子进程标准输入传递，绝不出现在命令行参数（防 `ps` 窃取），输出永不回显**；
   * `delete`（需 `confirm: true`）：删除密钥。
+  * 支持 `kind: 'variable'` 切换到 **Actions 明文变量**：`set` 走参数直传、`get` 可回显值（这正是变量与密钥的设计区别——secret 写入后 GitHub 侧加密，物理不可读取）；两类对象的安全语义在渲染层物理隔离。
   * 支持仓库 / 组织 (`org`) / 环境 (`env`) 三级作用域与 `actions` / `codespaces` / `dependabot` / `agents` 应用归属。
 
 ---
@@ -231,14 +248,23 @@ dsh plugin --profile web add dsh-github-flow
 </p>
 
 ### 2. 会话右侧栏工作区面板 (Session Workspace Panel)
-位于每个对话工作区的右侧抽屉栏：
-* **当前仓库上下文绑定**：自动锁定当前会话的 Git 仓库，无需选择；
+位于每个对话工作区的右侧抽屉栏，深度联动本地 Git 状态与远程 GitHub 仓库：
+* **当前仓库上下文绑定**：自动锁定当前会话的物理 Git 仓库，展示远程关联与认证账号；
 * **数据新鲜度胶囊对齐**：标题旁紧凑呈现 `[📦 本地快照 (2分钟前)]` 与 `[🔄 刷新]` 按钮，与主页规则 100% 保持一致，首屏 0ms 瞬间直出；
-* **PR 门禁状态药丸**：展示当前开放 PR，悬停查看 Checks 结果与审核意见；
-* **当前仓库 Open Issues 列表**：直接在侧边栏审查待办任务并提供直达链接；
-* **最新 Actions 构建流水线**：实时关注 CI 状态；
 * **快捷操作网格**：一键在浏览器打开仓库、直达 Issues/PRs、一键创建 PR；
-* **⚙️ 完整设置入口**：右侧栏同样提供设置按钮，与主页复用同一设置弹窗（数据同步 / 网络代理 / 更新设置 / 关于 四分区完整可用），无需切回主页调整。
+* **五大 Tab 布局响应式互斥切换**：快捷操作下方采用紧凑 Tab 架构，内容区互斥展示、大幅降低纵向滚动需求：
+  * **Git 记录 (`Git`)**（默认首屏）：
+    * 分支与同步状态：展示当前分支（如 `master`）与远程同步快照（`✓ 与远程同步` 或 `↑N 待 push` / `↓N 待 pull`）；
+    * 三段式提交视图：待推送提交（本地领先）、待拉取提交（远程领先）及最近提交列表；
+    * 默认展示 15 条，支持**向下滑动触底自动分页加载**（伴随 `15 / 74` 实时进度提示与点击后备）；
+    * 右上角锚定最新发布 Release 徽章（`🏷️ v0.2.1`），悬停查看发布时间与预发布标示，点击直达；
+    * **提交详情模态弹窗**：点击任意提交记录行，在右侧栏内局部居中弹出（与设置弹窗同构，不全屏越界），内置上下滑动区域，完整展示 40 位 SHA、提交者姓名邮箱、日期、多行详细正文说明与文件变更统计（`--stat`），纯本地 0ms 秒开，支持按 `Esc` 或点击遮罩随时关闭；
+  * **未提交清单 (`📁 未提交 (N)`)**：展示工作区未提交的文件清单，状态码色彩区分（`??` 新增、`M` 修改、`D` 删除、`R` 重命名）与变更总数；
+  * **拉取请求 (`🔀 PR (N)`)**：展示当前开放 PR，带有三态 CI 门禁（`✅ CI 通过` / `❌ CI 失败` / `⏳ CI 运行中`）、冲突检测、审核判定（`✔ 已批准` / `✋ 需修改` / `👀 待审查`）、Draft 草稿标示与人性化相对时间；
+  * **仓库议题 (`📋 Issues (N)`)**：直接在侧边栏审查待办任务，支持指派者、标签与多维状态药丸；
+  * **构建流水线 (`⚡ Actions (N)`)**：实时关注工作流 CI 状态，展示触发方式（`push`/`定时`/`手动`/`PR`）、相对时间与失败构建的 Agent 自愈诊断指引（嵌入 run_id）；
+* **全库统一 Git 官方矢量图标**：采用标准 Git 菱形分支官方矢量组件（`#1296db` SVG），全面统一各处 Git 标识；
+* **⚙️ 完整设置入口**：右侧栏提供设置按钮，与主页复用同一设置弹窗（数据同步 / 网络代理 / 更新设置 / 关于 四分区完整可用），无需切回主页调整。
 
 <p align="center">
   <img src="./docs/images/2.png" alt="右侧栏工作区面板" width="100%" />
@@ -347,6 +373,7 @@ dsh plugin --profile web add dsh-github-flow
         defaultListLimit: 20      # 列表类查询默认返回条数（pr/issue/run/release/skill 通用）
         cacheTtlMs: 15000         # 单仓库概览缓存时长（毫秒，默认 15 秒）
         checkUpdate: true         # 是否开启新版本自动检查提示（默认开启；false 时熔断自动探测，显式升级不受限）
+        agentEnvInjection: true   # 向 gh 注入 AI_AGENT=dsh 识别信号（gh ≥2.99 自动适配 Agent 输出；false 恢复 gh 原生行为）
         updateCheckIntervalMs: 86400000 # 检查更新间隔（毫秒，默认 24 小时）
         registryUrl: ''           # 自定义私有 npm 镜像地址（留空走「更新设置」所选源，界面设置优先）
         proxyUrl: ''              # 代理地址预置默认值（如 'http://127.0.0.1:7890'；仅未在驾驶舱设置过时生效，界面设置优先）

package/docs/UPGRADE-NOTES.md

@@ -10,8 +10,8 @@
 
 | # | 文件 | 位置 | 当前值 | 说明 |
 |---|---|---|---|---|
-| 1 | [package.json](../package.json) | 第 3 行 `"version": "0.2.1"` | `0.2.1` | npm 发布版本、CI 取版来源 |
-| 2 | [src/version.ts](../src/version.ts) | 第 9 行 `CURRENT_PLUGIN_VERSION = '0.2.1'` | `'0.2.1'` | 运行时版本比较基准（假横幅的教训来源） |
+| 1 | [package.json](../package.json) | 第 3 行 `"version": "0.3.0"` | `0.3.0` | npm 发布版本、CI 取版来源 |
+| 2 | [src/version.ts](../src/version.ts) | 第 9 行 `CURRENT_PLUGIN_VERSION = '0.3.0'` | `'0.3.0'` | 运行时版本比较基准（假横幅的教训来源） |
 
 **两处必须同值**。`pnpm run build` 会硬校验（[scripts/build.mjs](../scripts/build.mjs) 的
 `assertVersionConsistency`），不一致直接构建失败——但不要依赖拦截，发版前手动核对。
@@ -41,28 +41,28 @@
 | # | 机制 | 说明 |
 |---|---|---|
 | 9 | CI 取版（.github/workflows/npm-publish.yml:62） | `VERSION=$(node -p "require('./package.json').version")`——从 package.json 读，无硬编码 |
-| 10 | Git tag | `git tag v0.2.1` 手动打，值必须 = package.json 版本（tag 与 package.json 不一致时：CI 发布的 npm 版本以 package.json 为准，GitHub Release 标题以 tag 为准，出现两者错位） |
+| 10 | Git tag | `git tag v0.3.0` 手动打，值必须 = package.json 版本（tag 与 package.json 不一致时：CI 发布的 npm 版本以 package.json 为准，GitHub Release 标题以 tag 为准，出现两者错位） |
 
 ## 五、发版完整流程（含版本修改）
 
 ```powershell
 # 1. 改版本（两处同值）
-#    package.json  → "version": "0.2.1"
-#    src/version.ts → CURRENT_PLUGIN_VERSION = '0.2.1'
+#    package.json  → "version": "0.3.0"
+#    src/version.ts → CURRENT_PLUGIN_VERSION = '0.3.0'
 
 # 2. 文档已用占位符（npm-publish-guide 示例、README 安装命令），发版无需改文档版本号
 
 # 3. 构建（版本一致性校验在此拦截漏改）+ 全量测试
 pnpm run build
-pnpm test    # 9 阶段全绿
+pnpm test    # 11 阶段全绿
 
 # 4. 本机 e2e（必须先重启 DSH 桌面进程——Node 模块缓存，软链重建不注入运行中进程）
-#    重启后验证：GET /api/github/check-update 的 currentVersion = 0.2.1
+#    重启后验证：GET /api/github/check-update 的 currentVersion = 0.3.0
 
 # 5. 提交 + 打 tag + 推送（tag 值 = package.json 版本）
 git add -A
-git commit -m "chore(release): v0.2.1"
-git tag v0.2.1
+git commit -m "chore(release): v0.3.0"
+git tag v0.3.0
 git push origin master --tags
 #    CI（npm-publish.yml）自动：构建→发布 npm→创建 GitHub Release
 

package/docs/architecture.md

@@ -20,8 +20,10 @@
 │     │               GitHubService (ctx.github 原生服务)             │        │
 │     │   - checkAuth(cwd)      - getRepoMetadata(cwd)               │        │
 │     │   - run<T>(args, opts)  [execFile 数组隔离 + 24KB 智能截断]     │        │
-│     │                                                              │        │
-│     │   - UpdateChecker (源可选探测 + 24h 缓存 + Fail-Safe)        │        │
+│     │   - runGuarded({minVersion,fallback})  [gh 版本守卫降级链]      │        │
+│     │   - getGhVersion() [30s TTL 缓存·只存成功值]                    │        │
+│     │   - AI_AGENT=dsh 注入 [gh 官方 agent 识别·可配置开关]            │        │
+│     │   - UpdateChecker (源可选探测 + 24h 缓存 + Fail-Safe)          │        │
 │     │   - UpgradeManager (跨平台自适应 + 互斥锁 + macOS PATH 补全)   │        │
 │     │   - spawnWithStdin (密文通道: spawn+stdin.end + kill 超时)   │        │
 │     └──────┬───────────────────────┬────────────────────────┬──────┘        │
@@ -30,15 +32,22 @@
 │  ┌──────────────────┐    ┌──────────────────┐    ┌───────────────────────┐  │
 │  │  9 大 Agent 工具  │    │  人类 Slash 指令 │    │   Host HTTP WebServer │  │
 │  │  (defineTool DSL)│    │  /gh status      │    │ (Effect Disposer 清理)│  │
-│  │  - pr            │    │  /gh upgrade     │    │ - /api/github/overview│  │
-│  │  - issue         │    │  /gh help        │    │ - /api/github/action  │  │
-│  │  - run           │    └──────────────────┘    │ - /api/github/refresh │  │
-│  │  - repo          │                            │ - /check-update (并行)│  │
-│  │  - api (逃生门)  │                            │ - /upgrade (一键自动) │  │
-│  │  - release       │                            │ - /update-settings    │  │
-│  │  - secret (stdin)│                            │ - /proxy (全局代理)   │  │
-│  │  - skill         │                            │ - /auth (轻量探针)    │  │
-│  │  - help (元指南) │                            └──────────┬────────────┘  │
+│  │  - pr (+ready·   │    │  /gh upgrade     │    │ - /api/github/overview│  │
+│  │    revert·update)│    │  /gh help        │    │ - /api/github/action  │  │
+│  │  - issue (+delete│    └──────────────────┘    │ - /api/github/refresh │  │
+│  │    ·transfer·pin·│                            │ - /check-update (并行)│  │
+│  │    lock·status)  │                            │ - /upgrade (一键自动) │  │
+│  │  - run (+workflow│                            │ - /update-settings    │  │
+│  │    系列·download)│  (workflow_enable/disable │  │ - /proxy (全局代理)   │  │
+│  │  - repo (+search │   启停·list/view·download) │ - /auth (轻量探针)    │  │
+│  │    三域+read_    │                            └──────────┬────────────┘  │
+│  │    file &read_dir)│                                       │               │
+│  │  - api (逃生门)  │   (search 三域=issues/prs/commits；     │               │
+│  │  - release       │    read_file/read_dir 免clone读取)      │               │
+│  │  - secret (stdin │                                        │               │
+│  │    +variable 域) │                                        │               │
+│  │  - skill         │                                        │               │
+│  │  - help (元指南) │                                        │               │
 │  └────────┬─────────┘                                       │               │
 │           │                                                 │               │
 │           ▼                                                 │               │
@@ -55,15 +64,15 @@
 │                                                                             │
 │   ┌──────────────────────────────────┐    ┌─────────────────────────────┐   │
 │   │       全局驾驶舱 (Main Slot)      │    │  右侧栏面板 (Right Sidebar)  │   │
-│   │   - 账号全局所有 GitHub 仓库      │    │  - 当前会话工作区关联仓库   │   │
-│   │   - 本地工作区矩阵透视           │    │  - PR 列表与 CI Checks 药丸 │   │
-│   │   - 三维待办 Issues (药丸筛选)   │    │  - 仓库 Open Issues 任务列表│   │
-│   │   - 用户提单 / 分配待办 / 我发起 │    │  - 快捷操作网格 (直达入口)   │   │
-│   │   - 顶部升级通知横幅 (Banner)    │    │  - 紧凑微型升级指示条       │   │
-│   │   - 动态数据新鲜度胶囊与 SWR 缓存│    │  - 本地快照胶囊 (对齐规则)  │   │
-│   │   - 四分区设置弹窗 (同步/代理/   │    │  - ⚙️ 完整设置入口 (复用    │   │
-│   │     更新源/关于)                │    │     主页同一弹窗组件)       │   │
-│   │   - 「插件」身份徽章 (关于直达)  │    │  - 「插件」身份徽章 (直达)  │   │
+│   │   - 账号全局所有 GitHub 仓库      │    │  - 五 Tab 互斥 (Git/未提交/ │   │
+│   │   - 本地工作区矩阵透视           │    │    PR/Issues/Actions)       │   │
+│   │   - 三维待办 Issues (药丸筛选)   │    │  - Git 记录与分支同步全景   │   │
+│   │   - 用户提单 / 分配待办 / 我发起 │    │  - 提交详情居中弹窗 (可滑动)│   │
+│   │   - 顶部升级通知横幅 (Banner)    │    │  - 下滑自动分页加载更多     │   │
+│   │   - 动态数据新鲜度胶囊与 SWR 缓存│    │  - 快捷操作网格与设置入口   │   │
+│   │   - 四分区设置弹窗 (同步/代理/   │    │  - 官方标准 Git 矢量图标    │   │
+│   │     更新源/关于)                │    │  - 「插件」身份徽章 (直达)  │   │
+│   │   - 「插件」身份徽章 (关于直达)  │    │                             │   │
 │   └──────────────────────────────────┘    └─────────────────────────────┘   │
 └─────────────────────────────────────────────────────────────────────────────┘
 ```
@@ -86,11 +95,19 @@
 - 所有的 `gh` 查询原生采用 `--json <fields>` 结构化投影；
 - 对长文本输出（如大型 PR 的完整 `diff`、CI 失败步骤日志）设置安全截断阈值（默认 24KB），采用码点安全切割与二分查找字节截断，保留头尾关键上下文并添加显式截断标记，杜绝撑爆模型上下文；
 - 列表与详情输出经独立 Markdown 渲染引擎（`src/renderers/markdown.ts`）转化为高密度表格与卡片（带状态徽章、可点击超链接与竖线转义防护），实测 20 条 PR 列表输出压缩 70%+ Token；
-- 所有 Agent 工具的输出统一经过归一化，列表自动打包为 `{ items, count }`，标量打包为 `{ result }`，100% 严丝合缝契合 DSH 工具网关模式约束。
+- 所有 Agent 工具的输出统一经过归一化，列表自动打包为 `{ items, count }`，标量打包为 `{ result }`，100% 严丝合缝契合 DSH 工具网关模式约束；
+- **gh 版本守卫降级链（runGuarded）**：preview 命令与新特性按 `minVersion` 门槛路由——版本达标直通主命令、不足走 `fallback` 降级链路（结果携带 `degraded/degradedReason` 结构化标注，**降级不是静默的**，渲染层对 degraded 结果显式追加链路说明）、无降级时报错附平台升级指引；版本探测自身失败 fail-open 直通（守卫是路由优化不是安全边界）。版本比较采用数值分段（杜绝 `'2.96.0' > '2.100.0'` 字典序陷阱），探测结果 30s TTL 缓存且只缓存成功值；
+- **AI_AGENT 识别信号注入**：每次 gh 子进程启动注入 `AI_AGENT=dsh`（gh detect.go 最高优先级通用信号）——gh ≥2.99 自动切换 text-only spinner、≥2.100 命令误用时打印完整 help（模型可据此自我纠正）、telemetry 归因到 dsh；旧版 gh 忽略该变量零副作用。经 `agentEnvInjection` 配置开关（默认开启）可恢复 gh 原生行为。
 
 ### 2.3.1 高危操作确认与敏感值安全通道 (Safety Confirmation & Secret stdin Channel)
-- 不可逆写操作（`merge` / `close` / `release delete` / clobber 覆盖上传 / `secret delete` / `skill install`）强制要求 `confirm: true` 显式参数，未确认时仅返回影响评估卡片，不产生任何远端或本地副作用；
-- 密钥明文仅经子进程标准输入传递（`spawnWithStdin` 通道：`spawn` + `stdin.end(data)` 半关闭写入——`execFile` 的 `input` 选项在实测环境从不真正写入管道，密文通道此前从未生效过），全程不出现在命令行参数、进程列表与工具输出中；渲染层对 secret 输出采用独立实现，从结构上隔离「绝不渲染 value 字段」这条安全红线。
+- 不可逆写操作（`merge` / `close` / `issue delete`（物理删除）/ `issue transfer`（跨仓库迁移）/ `pr revert`（远端创建反向 PR）/ `release delete` / clobber 覆盖上传 / `secret delete` / `skill install`）强制要求 `confirm: true` 显式参数，未确认时仅返回影响评估卡片，不产生任何远端或本地副作用；
+- 密钥明文仅经子进程标准输入传递（`spawnWithStdin` 通道：`spawn` + `stdin.end(data)` 半关闭写入——`execFile` 的 `input` 选项在实测环境从不真正写入管道，密文通道此前从未生效过），全程不出现在命令行参数、进程列表与工具输出中；渲染层对 secret 输出采用独立实现，从结构上隔离「绝不渲染 value 字段」这条安全红线。secret 与 variable（CI 明文，get 可回显）的渲染走**两个物理独立的函数**——安全语义靠函数边界而非同一函数的分支隔离，防未来重构互相污染。
+
+### 2.3.2 产物落盘纪律 (Artifact Download Discipline)
+- **目录固定派生，永不暴露路径参数**：构建产物下载（`run download` 等）的落盘目录由插件从 `~/.dsh/data/dsh-github-flow/artifacts/<owner>/<repo>/<run_id>/` 三级固定派生，不向调用方暴露任何目录参数——这是 GHSA-39wj-f2f4-978v（gh <2.102 符号链接路径穿越）的核心防线：用户无法注入 `../` 或符号链接目标，攻击面收敛到唯一一个 `mkdirSync(recursive)` 调用点，且目录天然按仓库与 run 隔离、可整体清理；
+- **低版本安全提示而非硬拒绝**：gh <2.102 时下载仍可执行（受控仓库场景是合理需求），但返回值携带 `securityNote` 升级指引；需要自定义落盘位置的场景显式引导经 `github_api` 手动拉取；
+- **下载后零本地符号化操作**：插件对落盘产物仅做递归枚举（相对路径 + 大小清单），不执行链接、移动或执行类操作。
+未来任何新增下载类能力（如 gist 资产）必须引用本节纪律，而非各自重述。
 
 ### 2.4 原生浅色/深色主题自适应与快捷操作网格
 - 全面对齐 DSH 官方 DSW 语义设计变量，基于 `body[data-ds-dark-theme]` 驱动无闪烁双模式切换；
@@ -160,3 +177,16 @@
   - 全部前端数据链路 fetch 绑定 `AbortController`（45s 兜底；登录探测 10s）——代理劫持回环地址等极端场景下用户得到明确超时出口，绝不永久转圈（未安装 gh 用户的刷新卡死修复）；
   - 后端 `gh` 探测毫秒级返回 ENOENT/安装引导，前端安装引导卡（AuthGuideCard）承载唤起终端（stdio ignore，无 profile）等自愈出口。
 
+### 2.10 右侧栏五 Tab 互斥与本地 Git 状态全景架构 (Right Sidebar Tabs & Local Git Engine)
+- **五 Tab 响应式互斥布局**：
+  - 将右侧栏原本纵向堆叠的 PR / Issues / Actions / Git 状态与未提交清单彻底重构成水平紧凑 Tab（Git / 未提交 / PR / Issues / Actions），默认激活 Git 记录页，首屏高度收敛 60% 以上；
+  - 纯函数渲染约束与 DOM 级状态：`renderGithubRepoView` 坚守零 React Hooks 约束，激活态通过 `data-active-tab` 挂载在 DOM 容器上；根组件通过 `useEffect([data])` 与 `applyTabState` 联动，在 SWR 后台拉新完成触发重渲染时，自动重置回用户选择的 Tab，彻底解决后台数据刷新拽回默认 Tab 的缺陷。
+- **三段式提交日志与本地 0ms 秒开**：
+  - 本地领先（待 push）、远程领先（待 pull，快照口径）与最近提交历史；
+  - 采用 ASCII 单元/记录控制符（`%x1e` / `%x1f`）结构化解析 `git log`，一次性提取 fullSha、author、email、date、多行 body 说明与 `--stat` 文件改动统计，首屏 0ms 纯本地呈现，零网络失败风险；
+  - 默认展示 15 条，通过右侧栏容器 `onScroll` 触底（<80px）与点击双重触发向后分页拉取，伴随实时进度计数（如 `15 / 74`）。
+- **内嵌模态弹窗 (CommitDetailModal)**：
+  - 复用设置弹窗架构（`.dsh-github-modal-overlay` + `.dsh-github-modal-dialog`），挂载在右侧栏容器内部，天然受限于右侧栏边界居中，彻底消除传统 `<dialog>` 顶层穿透全屏居中的越界问题；
+  - 弹窗外框限制 `max-height: 84vh; overflow: hidden;`，正文区域 `flex: 1; min-height: 0; overflow-y: auto;`，完美支持上下滑动浏览数十行详细正文与修改文件统计，支持 Esc 键与点击遮罩随手退出。
+- **全库统一 Git 官方矢量图标**：全量替换各处的植物/字符符号为标准 Git 菱形分支官方矢量组件（`#1296db` SVG）。
+

package/docs/npm-publish-guide.md

@@ -66,9 +66,20 @@ git push origin master --tags
 **推送完成后**：
 - GitHub Actions 会在 5 秒内自动感知到 `v0.1.1` 标签被创建；
 - 启动 Ubuntu runner，全自动执行：
-  `检出代码 ➔ 安装 pnpm ➔ 安装依赖 ➔ pnpm run build (编译 + 清理) ➔ 产物完整性校验 ➔ 带 Provenance 签名发布到 npm ➔ 自动创建并发布对应 GitHub Release`；
+  `检出代码 ➔ 安装 pnpm ➔ 安装依赖 ➔ pnpm run build (编译 + 清理) ➔ 产物完整性校验 ➔ pnpm pack 打离线包 ➔ 带 Provenance 签名发布到 npm ➔ 自动创建并发布对应 GitHub Release（含离线安装包资产）`；
 - 约 1 分钟后，npm 官网版本与 GitHub 仓库 Releases 页面同步更新！
 
+### Release 离线安装包资产
+
+每个 Release 会附带两个资产文件（与 npm 发布包**内容同源**：同一份 lib/ 构建产物，按 package.json `files` 字段打包）：
+
+| 资产 | 用途 |
+| :--- | :--- |
+| `dsh-github-flow-<版本>.tgz` | **离线/免构建安装包**：下载后执行 `dsh plugin --profile <名称> add ./dsh-github-flow-<版本>.tgz` 直接安装，无需网络与本地构建。适用场景：pnpm ≥ 10 从 Git 安装的构建授权拦截、npm 镜像同步滞后 24h（Q3 场景的零等待替代）、内网/离线环境分发 |
+| `dsh-github-flow-<版本>.tgz.sha256` | 下载完整性校验（`sha256sum -c` / `Get-FileHash` 比对），供应链信任基线 |
+
+> 注：Release 页 GitHub 自动生成的 `Source code (zip/tar.gz)` 是**源码快照**（TypeScript 源码，不可直接安装）；`.tgz` 资产才是**编译产物包**（lib/ 已构建），两者用途不同。
+
 ---
 
 ## 2. 安全机制与 Provenance 产物溯源

package/lib/api/routes-overview.js

@@ -43,6 +43,9 @@ export function registerOverviewRoutes(deps, executor, cacheMap, globalCache, ch
                 let pullRequests = [];
                 let issues = [];
                 let runs = [];
+                // 面板增强信息载体（git 状态/Release 锚定/分支 PR——全部可选字段，
+                // 进缓存与快照时旧消费方零破坏，渲染层 ?. 兜底）
+                const freshExtras = {};
                 if (repo && auth.loggedIn) {
                     // 并发拉取当前文件夹仓库的 PRs、Issues 和 Runs
                     const [prsRes, issuesRes, runsRes] = await Promise.all([
@@ -65,6 +68,34 @@ export function registerOverviewRoutes(deps, executor, cacheMap, globalCache, ch
                     }
                     if (runsRes.ok && Array.isArray(runsRes.data))
                         runs = runsRes.data;
+                    // 面板信息增强（三路并行，全部失败静默——可选装饰信息不阻塞主流程）：
+                    // 1. git 本地状态：纯本地毫秒级（remote-tracking 快照），零网络
+                    // 2. Release 锚定：gh release view，无 Release 仓库是常态非错误
+                    // 3. 当前分支↔PR 关联：pr status -c，无 PR 分支同样静默
+                    const [gitStatus, releaseInfo, branchPr] = await Promise.all([
+                        executor.getLocalGitStatus(cwd).catch(() => null),
+                        executor.run(['release', 'view', '--json', 'tagName,isPrerelease,isDraft,publishedAt,url', '-R', repo.nameWithOwner], { cwd, timeoutMs: 8_000 }).then((r) => (r.ok && r.data && !r.data.isDraft ? r.data : null)).catch(() => null),
+                        executor.run(['pr', 'status', '-c', '--json', 'number,title,state,url,isDraft', '-R', repo.nameWithOwner], { cwd, timeoutMs: 8_000 }).then((r) => {
+                            // 实测键集：{ createdBy: [...], needsReview: [...] }——「当前分支
+                            // 关联 PR」按优先级取 createdBy（自己发起）→ needsReview（待审）。
+                            // 不传 rawText：executor 对含 --json 的命令自动解析出 data——
+                            // rawText 模式 data 恒 undefined 会让本功能静默失效（审查抓到的真实 Bug）
+                            if (!r.ok || !r.data)
+                                return null;
+                            const createdBy = Array.isArray(r.data?.createdBy) ? r.data.createdBy : [];
+                            const needsReview = Array.isArray(r.data?.needsReview) ? r.data.needsReview : [];
+                            return createdBy[0] || needsReview[0] || null;
+                        }).catch(() => null),
+                    ]);
+                    freshExtras.gitStatus = gitStatus;
+                    freshExtras.releaseInfo = releaseInfo;
+                    freshExtras.branchPr = branchPr;
+                    // 4. git 提交记录三段（领先/落后/最近）：依赖 gitStatus.hasUpstream 守卫，
+                    // 在并行波次之后串行补（本地毫秒级，无感知延迟）——放进第一波会因
+                    // Promise.all 参数在调用时求值而引用未解构的 gitStatus（恒 undefined）
+                    freshExtras.commitLog = await executor
+                        .getGitCommitLog(cwd, gitStatus ? gitStatus.hasUpstream : false)
+                        .catch(() => null);
                 }
                 const issueStats = calculateIssueStats(issues);
                 const freshData = {
@@ -76,6 +107,7 @@ export function registerOverviewRoutes(deps, executor, cacheMap, globalCache, ch
                     runs,
                     lastUpdated: new Date().toISOString(),
                     updateInfo: checker.getQuickStatus(),
+                    ...freshExtras,
                 };
                 cacheMap.set(cwd, freshData, now);
                 sendJson(res, 200, { ok: true, data: freshData, fromCache: false, cwd });
@@ -124,7 +156,7 @@ export function registerOverviewRoutes(deps, executor, cacheMap, globalCache, ch
                     const issueFields = 'number,title,repository,author,assignees,labels,url,updatedAt';
                     const queryResults = await Promise.allSettled([
                         executor.run(['repo', 'list', '--limit', '20', '--json', 'name,nameWithOwner,description,defaultBranchRef,isPrivate,stargazerCount,updatedAt,url'], { timeoutMs: 8_000 }),
-                        executor.run(['search', 'prs', '--author=@me', '--state=open', '--limit', '10', '--json', 'number,title,repository,url,updatedAt'], { timeoutMs: 8_000 }),
+                        executor.run(['search', 'prs', '--author=@me', '--state=open', '--limit', '10', '--json', 'number,title,repository,url,updatedAt,isDraft'], { timeoutMs: 8_000 }),
                         executor.run(['search', 'issues', '--owner=@me', '--state=open', '--sort=updated', '--limit', '15', '--json', issueFields], { timeoutMs: 8_000 }),
                         executor.run(['search', 'issues', '--assignee=@me', '--state=open', '--sort=updated', '--limit', '15', '--json', issueFields], { timeoutMs: 8_000 }),
                         executor.run(['search', 'issues', '--author=@me', '--state=open', '--sort=updated', '--limit', '15', '--json', issueFields], { timeoutMs: 8_000 }),
@@ -195,6 +227,9 @@ export function registerOverviewRoutes(deps, executor, cacheMap, globalCache, ch
                     // 每次网络往返都要秒级，5 个工作区就足以把该端点拖到 20 秒。
                     workspaceMatrix = await mapLimit(wsEntries, WORKSPACE_PROBE_CONCURRENCY, async (ws) => {
                         const hasGit = hasGitDir(ws.path);
+                        // git 状态与身份识别同为纯本地探测（remote-tracking 快照零网络），
+                        // 挂进同一 mapLimit 有界并发——不新增并发维度，不碰性能红线
+                        const gitStatus = hasGit ? await executor.getLocalGitStatus(ws.path).catch(() => null) : null;
                         return {
                             id: ws.id,
                             title: ws.title || basenameSafe(ws.path),
@@ -202,6 +237,7 @@ export function registerOverviewRoutes(deps, executor, cacheMap, globalCache, ch
                             hasGit,
                             repo: hasGit ? executor.getRepoIdentityFromLocal(ws.path) || undefined : undefined,
                             sessionCount: ws.sessionIds.length,
+                            ...(gitStatus ? { gitStatus } : {}),
                         };
                     });
                 }
@@ -224,4 +260,71 @@ export function registerOverviewRoutes(deps, executor, cacheMap, globalCache, ch
             }
         },
     });
+    // 3. 单条提交详情（Git 记录页点击行的惰性查询——弹窗打开时才发起，
+    //    不进 overview 缓存：低频单查 + git show 本地毫秒级，无缓存必要）
+    bindRoute({
+        kind: 'exact',
+        path: '/api/github/commit-detail',
+        handler: async (req, res) => {
+            if (req.method !== 'GET') {
+                sendJson(res, 405, { ok: false, message: '仅支持 GET 请求' });
+                return;
+            }
+            try {
+                const url = new URL(req.url || '', 'http://127.0.0.1');
+                let cwd = url.searchParams.get('cwd') || undefined;
+                const sessionId = url.searchParams.get('sessionId');
+                if (!cwd && sessionId) {
+                    cwd = findWorkspacePathBySession(sessionId) || undefined;
+                }
+                if (!cwd) {
+                    cwd = findMostRecentWorkspacePath() || undefined;
+                }
+                const sha = url.searchParams.get('sha') || '';
+                // sha 形态校验双保险（executor 内还有一道）：路由层先拦明显恶意值
+                if (!/^[0-9a-f]{4,40}$/i.test(sha)) {
+                    sendJson(res, 400, { ok: false, error: '非法 sha（仅接受 4-40 位十六进制）' });
+                    return;
+                }
+                const detail = await executor.getGitCommitDetail(cwd, sha);
+                if (detail === null) {
+                    sendJson(res, 404, { ok: false, error: '未找到该提交（可能不在当前仓库）' });
+                    return;
+                }
+                sendJson(res, 200, { ok: true, detail });
+            }
+            catch (err) {
+                sendJson(res, 500, { ok: false, error: err.message || '查询提交详情失败' });
+            }
+        },
+    });
+    // 4. 分页获取最近提交记录（Git 记录页下滑触底自动加载或点击加载更多）
+    bindRoute({
+        kind: 'exact',
+        path: '/api/github/git-log',
+        handler: async (req, res) => {
+            if (req.method !== 'GET') {
+                sendJson(res, 405, { ok: false, message: '仅支持 GET 请求' });
+                return;
+            }
+            try {
+                const url = new URL(req.url || '', 'http://127.0.0.1');
+                let cwd = url.searchParams.get('cwd') || undefined;
+                const sessionId = url.searchParams.get('sessionId');
+                if (!cwd && sessionId) {
+                    cwd = findWorkspacePathBySession(sessionId) || undefined;
+                }
+                if (!cwd) {
+                    cwd = findMostRecentWorkspacePath() || undefined;
+                }
+                const limit = Math.min(Math.max(1, Number(url.searchParams.get('limit')) || 15), 50);
+                const skip = Math.max(0, Number(url.searchParams.get('skip')) || 0);
+                const result = await executor.getGitRecentLog(cwd, limit, skip);
+                sendJson(res, 200, { ok: true, data: result });
+            }
+            catch (err) {
+                sendJson(res, 500, { ok: false, error: err.message || '获取提交记录失败' });
+            }
+        },
+    });
 }