@yangzhe1991/dsh-code-review 0.1.5 → 0.2.1

package/README.md

@@ -11,9 +11,11 @@
 
 The conversation itself stays untouched: when a git diff shows up, a small **"open in new tab"** button appears on the block (a markdown diff code block, or the bash tool row that produced the diff — even while collapsed). One click opens the review page.
 
+When the conversation mentions a **local `.diff` / `.patch` file path**, the path automatically becomes a **view link button** — a path inside backticks gets an inline pill right after it, a bare-text path gets a right-aligned button row under the message. One click opens that file's code review page (the browser cannot read local files, so the plugin host half reads them — absolute paths only, `.diff`/`.patch` suffix only, ≤ 5 MB).
+
 ## Compatibility
 
-- **dsh ≥ 0.1.2-alpha.4** — fully supported since **0.1.5**. The web UI restructure (chat snapshot moved from `useSession((s) => s.chat)` to the session-standard `useChat` hook; markdown code-block DOM wrapped in a `bannerWrap` layer) is handled on both detection paths: markdown diff blocks and collapsed bash tool rows.
+- **dsh ≥ 0.1.2-alpha.4** — fully supported since **0.1.5**. The web UI restructure (chat snapshot moved from `useSession((s) => s.chat)` to the session-standard `useChat` hook; markdown code-block DOM wrapped in a `bannerWrap` layer) is handled on both detection paths: markdown diff blocks and collapsed bash tool rows. Verified against **dsh 0.1.3-alpha.2** since **0.2.1**.
 - **dsh 0.1.0-rc.x** — still supported via the legacy snapshot path.
 
 ## Features
@@ -28,6 +30,7 @@ The conversation itself stays untouched: when a git diff shows up, a small **"op
 - 🎨 **Theme-matched** — the page inherits the DSH theme colors at open time, so light/dark mode stays consistent.
 - 📜 **Full-page scrolling** — no height caps; thousands of lines scroll naturally, and long lines wrap.
 - 💬 **Inline comments** — hover any line number and click to add a comment right on that line (like GitHub reviews). Comments accumulate with a per-line count badge; when done, submit them all at once — as **Looks Good To Me ✓** or **plain comments** — and they are written into the DSH composer as `file:line — comment` lines, ready to send to the agent.
+- 🔗 **One-click local diff paths** — absolute `…/xxx.diff` / `…/xxx.patch` paths mentioned in the conversation become link buttons: backtick-wrapped paths get an inline pill right after them, bare-text paths get a right-aligned button row under the message, and paths listed in bash tool output join the tool row's button row. Clicking opens that file's code review page; on read failure (missing / not a diff / over 5 MB) the button briefly turns red.
 - 🌐 **Bilingual UI** — follows the DSH interface language (official locale service): a Chinese UI gets Chinese buttons and review page, everything else gets English.
 
 ## Screenshots
@@ -42,9 +45,15 @@ The conversation itself stays untouched: when a git diff shows up, a small **"op
 
 1. **Markdown code blocks** in assistant messages — a ```` ```diff ```` / ```` ```patch ```` fence, or any code block whose content looks like a git diff (e.g. pasted inside a `text` fence). The block is **collapsed by default** (just the title row + buttons), with an "expand/collapse" toggle if you want to read the raw text inline.
 2. **Bash tool rows** — when the agent runs `git diff` in a bash tool, the button is added to the tool row (visible even while the row is collapsed; detected from the conversation data, since a collapsed row has no output in the DOM). The terminal card in the details panel gets one too.
+3. **Local diff paths (since 0.2.0)** — absolute `.diff`/`.patch` paths in assistant or user messages:
+   - backtick-wrapped paths (e.g. `` `/Users/me/proj/patch.diff` ``) get an **inline pill button** right after the path;
+   - bare-text paths get a **right-aligned button row under the message** (one pill per path); paths inside reasoning blocks and code blocks are not captured (collapsed by default / have their own button mechanism);
+   - paths listed in bash tool output join the **tool row's button row**.
 
 Streaming output is handled gracefully: the button only appears once the content has been stable for ~1 second, so half-streamed diffs never produce a broken page.
 
+When a path button is clicked, the plugin's host half (a route registered on `webServer`) reads the local file (absolute paths only, `~` expansion, `.diff`/`.patch` suffix, ≤ 5 MB, no CORS), and the browser half renders it into the standalone review page; on read failure the button briefly turns red. **The route registration requires a `dsh web` restart** (the host half registers it at startup); browser-half changes only need a hard refresh.
+
 ## Install (30 seconds)
 
 ```sh
@@ -63,6 +72,8 @@ dsh plugin --profile web add link:/path/to/@yangzhe1991/dsh-code-review
 
 The plugin registers a root-scope `shell.overlay` seat that renders nothing and watches the whole document with a `MutationObserver`. For every `.md-code-block` and `[data-terminal]` element it runs a stability-debounced check; candidates get a small button appended to the block's banner/header (never replacing official nodes, so React's reconciliation stays safe). Collapsed bash tool rows are handled from the data layer: a session-scope seat subscribes to the conversation snapshot and records settled bash results that look like a diff.
 
+Local path chips are split across the two layers: message rows (assistant/user) are probed by the same scanner — backtick-wrapped paths get an inline button inserted right after the `code` element, bare-text paths get a button row appended to the row; paths in bash tool results go through the data layer (same pipeline as the diff buttons). Text nodes are only read, never split (splitting React-managed text nodes would break streaming rendering), so bare-text paths get row-level buttons instead of in-place edits. On click, the browser half first opens a placeholder tab synchronously (beats popup blockers), then fetches `GET /dsh-code-review/diff?path=…` from the host route and navigates the tab to the standalone review page.
+
 Clicking the button synchronously builds a self-contained HTML page (inline styles + inherited theme variables + the two-column content, all HTML-escaped) and opens it via a **Blob URL** — no server route needed, and the synchronous `window.open` inside the click gesture is not popup-blocked. The parser is a pure module (`src/client/diff-parse.ts`, unit-tested in `test/parse.test.mjs`) and supports: multi-file diffs, hunks with line-number tracking, delete/add pairing into changed rows (uneven counts degrade to single-side rows), `` markers, new/deleted/renamed/binary files, bare patches without a `diff --git` header, and commit-message prefixes (`git show` output).
 
 ## Development
@@ -71,6 +82,8 @@ Clicking the button synchronously builds a self-contained HTML page (inline styl
 npm install
 npm run build   # esbuild → lib/index.js (host half) + lib/client.js (browser half)
 node test/parse.test.mjs         # parser + standalone HTML unit tests
+node test/path-detect.test.mjs   # local path-detection regex unit tests
+node test/node-route.test.mjs    # host-half route (read/validation/error codes) tests
 node test/client-smoke.test.mjs  # bundle smoke test (mock __ModuleLoader__)
 ```
 

package/README.zh.md

@@ -11,6 +11,13 @@
 
 聊天窗口本身保持原样:只要出现 git diff,对应块(markdown diff 代码块、或产生 diff 的 bash 工具行——折叠状态也显示)上就自动出现一个**「在新标签页打开」**小按钮,点一下即打开审查页。
 
+对话里提到**本地 .diff / .patch 文件路径**时,路径会自动变成**查看链接按钮**——反引号里的路径原地变成小胶囊按钮,纯文本路径在消息下方补一行按钮;点击直接打开该文件的 Code Review 审查页(浏览器读不了本地文件,由插件宿主侧代读,只读绝对路径、仅限 .diff/.patch 后缀、≤5MB)。
+
+## 兼容性
+
+- **dsh ≥ 0.1.2-alpha.4** — 自 **0.1.5** 起完整支持。Web UI 重构(聊天快照从 `useSession((s) => s.chat)` 迁移到会话标准的 `useChat` hook;markdown 代码块 DOM 包了一层 `bannerWrap` 层)在两条检测路径上均已适配:markdown diff 块与折叠的 bash 工具行。自 **0.2.1** 起在 **dsh 0.1.3-alpha.2** 上验证通过。
+- **dsh 0.1.0-rc.x** — 仍通过旧版快照路径支持。
+
 ## 功能
 
 - ⬅️➡️ **双列并排视图** —— 旧文件在左、新文件在右,两侧各自带行号,类似 GitHub 的 split review。
@@ -23,6 +30,7 @@
 - 🎨 **主题一致** —— 打开时继承 DSH 当前主题色,深浅色模式自动跟随。
 - 📜 **整页滚动** —— 无高度限制,几千行自然滚动,超长行折行显示。
 - 💬 **行内评论** —— 悬停任意行号点击即可在该行提评论(类似 GitHub review),行号旁显示评论数徽章;攒齐后一次性提交 —— 可选 **Looks Good To Me ✓** 或**纯评论**,提交后自动写入 DSH 对话框(`文件名:行号 — 评论` 逐条列出),直接发给 agent。
+- 🔗 **本地路径一键查看** —— 对话里出现 `…/xxx.diff`/`…/xxx.patch` 绝对路径时自动变成链接按钮:反引号内的路径原地变成小胶囊按钮,纯文本路径在消息下方补一行右对齐按钮;bash 工具输出里列出的路径也会出现在工具行按钮排上。点击后打开该文件的 Code Review 页,读取失败(文件不存在/非 diff/超 5MB)时按钮短暂变红提示。
 - 🌐 **中英双语** —— 跟随 DSH 界面语言(官方 locale 服务):中文界面显示中文按钮与审查页,其他语言一律英文。
 
 ## 截图
@@ -37,9 +45,15 @@
 
 1. **assistant 消息里的 markdown 代码块** —— ```` ```diff ```` / ```` ```patch ```` 语言标签,或内容形似 git diff 的任意代码块(比如贴在 `text` 围栏里)。代码块**默认折叠**(只留标题行 + 按钮),带「展开/收起」开关,想看原始文本就内联展开。
 2. **bash 工具行** —— agent 在 bash 工具里跑 `git diff` 后,按钮加在工具行上(折叠状态也可见;折叠行 DOM 里没有输出内容,从会话数据层检测)。详情面板里的终端卡片同样支持。
+3. **本地 diff 路径(0.2.0 起)** —— assistant / 用户消息里出现绝对路径的 `.diff`/`.patch` 文件时:
+   - 反引号内的路径(如 `` `/Users/me/proj/patch.diff` ``)原地变成**内联胶囊按钮**,跟在路径后面;
+   - 纯文本路径在**消息下方补一行右对齐按钮**(多条路径逐个列出);思考块与代码块内的路径不捕获(前者默认折叠、后者已有自身机制);
+   - bash 工具输出里列出的路径加在**工具行按钮排**上。
 
 流式输出有专门处理:内容稳定约 1 秒后按钮才出现,半截 diff 不会产生残缺页面。
 
+点击路径按钮时:插件宿主侧(`webServer` 注册的路由)读取本地文件内容(仅绝对路径、支持 `~` 展开、仅 `.diff`/`.patch` 后缀、≤5MB、不设 CORS),浏览器侧再把内容渲染成独立审查页;读取失败时按钮短暂变红提示。**读取需重启 `dsh web` 才生效**(node 半在宿主启动时注册路由),浏览器半改动硬刷新即可。
+
 ## 安装(30 秒)
 
 ```sh
@@ -58,6 +72,8 @@ dsh plugin --profile web add link:/path/to/@yangzhe1991/dsh-code-review
 
 插件注册一个 root 作用域的 `shell.overlay` 席位,自身渲染 null,用 `MutationObserver` 监听全文档。对每个 `.md-code-block` 和 `[data-terminal]` 元素做「稳定去抖」检测,候选块会在官方 banner/header 上追加一个小按钮(只追加、不改写官方节点,React 协调安全)。折叠的 bash 工具行走数据层:session 作用域组件订阅会话快照,把输出形似 diff 的已落地 bash 结果记录进文本表,扫描器给对应工具行加按钮。
 
+本地路径 chip 的分工:消息行(assistant/用户)由同一扫描器按行探测,反引号内的路径在 code 元素后原地插内联按钮,纯文本路径在行尾追加一排按钮;bash 工具结果里的路径走数据层(与 diff 按钮同一条数据链路)。文本节点只读不拆(对 React 管理的文本节点做拆分会破坏流式渲染),所以纯文本路径不做原地改造。点击后浏览器半先同步开占位窗(防弹窗拦截),再向宿主路由 `GET /dsh-code-review/diff?path=…` 拉取内容,成功即导航到独立审查页。
+
 点击按钮时,**在用户手势内同步**构建自包含 HTML 页面(内联样式 + 继承的主题变量 + 双列内容,全部 HTML 转义),通过 **Blob URL** 打开 —— 不依赖服务器任何路由,同步调用的 `window.open` 也不会被弹窗拦截。解析器是纯模块(`src/client/diff-parse.ts`,`test/parse.test.mjs` 有单测),支持:多文件 diff、带行号跟踪的 hunk、删除/新增配对成变更行(数量不等时多出的行退化为单侧行)、`` 标记、新增/删除/重命名/二进制文件、无 `diff --git` 头的裸 patch、`git show` 的提交说明前缀。
 
 ## 开发
@@ -66,6 +82,8 @@ dsh plugin --profile web add link:/path/to/@yangzhe1991/dsh-code-review
 npm install
 npm run build   # esbuild → lib/index.js(node 半)+ lib/client.js(浏览器半)
 node test/parse.test.mjs         # 解析器 + 独立页 HTML 单测
+node test/path-detect.test.mjs   # 本地路径检测正则单测
+node test/node-route.test.mjs    # node 半路由(读取/校验/错误码)单测
 node test/client-smoke.test.mjs  # bundle 冒烟测试(mock __ModuleLoader__)
 ```
 

package/lib/client.js

@@ -231,6 +231,60 @@ function countStats(files) {
   return { added, removed, files: files.length };
 }
 
+// src/client/diff-path.ts
+var ABS_ALT = "(?<![\\w/])/(?!/)[^\\s]*?\\.(?:diff|patch)";
+var TILDE_ALT = "(?<![\\w/])~/[^\\s]*?\\.(?:diff|patch)";
+var SUFFIX_BOUNDARY = "(?![\\w\\-/]|\\.(?=\\w))";
+var PATH_RE = new RegExp(`(?:${ABS_ALT}|${TILDE_ALT})${SUFFIX_BOUNDARY}`, "gi");
+var WRAPPERS = [
+  ['"', '"'],
+  ["'", "'"],
+  ["`", "`"],
+  ["(", ")"],
+  ["[", "]"],
+  ["{", "}"],
+  ["<", ">"],
+  ["\u300C", "\u300D"],
+  ["\u300E", "\u300F"],
+  ["\uFF08", "\uFF09"],
+  ["\u3010", "\u3011"]
+];
+function unwrap(s) {
+  let t = s;
+  let changed = true;
+  while (changed) {
+    changed = false;
+    for (const [left, right] of WRAPPERS) {
+      if (t.length > left.length + right.length && t.startsWith(left) && t.endsWith(right)) {
+        t = t.slice(left.length, -right.length);
+        changed = true;
+        break;
+      }
+    }
+  }
+  return t;
+}
+function findDiffPaths(text) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const match of text.matchAll(PATH_RE)) {
+    const p = match[0];
+    if (seen.has(p)) continue;
+    seen.add(p);
+    out.push(p);
+  }
+  return out;
+}
+function cleanDiffPath(raw) {
+  const cleaned = unwrap(raw.trim());
+  if (cleaned === "" || !cleaned.startsWith("/") && !cleaned.startsWith("~/")) {
+    return null;
+  }
+  const matches = findDiffPaths(cleaned);
+  if (matches.length !== 1 || matches[0] !== cleaned) return null;
+  return cleaned;
+}
+
 // src/client/diff-highlight.ts
 var KEYWORDS = /* @__PURE__ */ new Set([
   // JS/TS
@@ -739,6 +793,9 @@ var CR_TEXTS = {
     collapse: "\u6536\u8D77",
     expandTitle: "\u5C55\u5F00\u539F\u59CB diff \u6587\u672C",
     collapseTitle: "\u6536\u8D77\u539F\u59CB diff \u6587\u672C",
+    viewPath: "\u67E5\u770B",
+    viewPathTitle: (path) => `\u5728\u72EC\u7ACB\u6807\u7B7E\u9875\u67E5\u770B\u672C\u5730 diff \u6587\u4EF6:${path}`,
+    pathReadFailed: "\u8BFB\u53D6\u5931\u8D25",
     reportLgtmHeader: (count) => `Looks good to me \u2713 \u2014 Code Review \u5171 ${count} \u6761\u8BC4\u8BBA:`,
     reportCommentHeader: (count) => `Code Review \u610F\u89C1,\u5171 ${count} \u6761:`,
     reportLgtmBare: "Looks good to me \u2713",
@@ -766,6 +823,9 @@ var CR_TEXTS = {
     collapse: "Collapse",
     expandTitle: "Show raw diff text",
     collapseTitle: "Hide raw diff text",
+    viewPath: "View",
+    viewPathTitle: (path) => `Open the local diff file in a separate tab: ${path}`,
+    pathReadFailed: "Failed to read",
     reportLgtmHeader: (count) => `Looks good to me \u2713 \u2014 Code Review with ${count} comment${count === 1 ? "" : "s"}:`,
     reportCommentHeader: (count) => `Code Review comments (${count}):`,
     reportLgtmBare: "Looks good to me \u2713",
@@ -1132,6 +1192,41 @@ var BUTTON_CSS = `
   margin-left: auto;
   padding: 4px 12px 7px;
 }
+/* \u672C\u5730\u8DEF\u5F84\u67E5\u770B chip:\u53CD\u5F15\u53F7\u5185\u8054\u5F62\u6001\u4E0E\u6D88\u606F\u7EA7/\u5DE5\u5177\u884C\u5F62\u6001\u5171\u7528,
+ * \u4E3B\u8272\u63CF\u8FB9\u7684\u5C0F\u80F6\u56CA;\u5185\u8054\u5F62\u6001\u66F4\u5C0F\u66F4\u9690\u8EAB,\u4E0D\u62A2\u6B63\u6587\u89C6\u7EBF\u3002 */
+.dsh-cr-pathchip {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  max-width: min(320px, 100%);
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--dsw-alias-state-business-primary, #3b6fe0);
+  background: var(--dsw-alias-bg-base, #ffffff);
+  border: 1px solid var(--dsw-alias-border-l2, #e5e5e7);
+  border-radius: 8px;
+  padding: 1px 8px;
+  cursor: pointer;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  vertical-align: middle;
+}
+.dsh-cr-pathchip:hover {
+  border-color: var(--dsw-alias-state-business-primary, #3b6fe0);
+  background: var(--dsw-alias-bg-layer-1, #f7f7f8);
+}
+.dsh-cr-pathchip[data-error='true'] {
+  color: var(--dsw-alias-state-error-primary, #d92d20);
+  border-color: var(--dsw-alias-state-error-primary, #d92d20);
+}
+/* \u5185\u8054\u5F62\u6001:\u8DDF\u5728 code \u5143\u7D20\u540E,\u4E0D\u6539\u6BB5\u843D\u884C\u9AD8 */
+.dsh-cr-pathchip[data-inline='true'] {
+  margin: 0 2px 0 4px;
+  padding: 0 6px;
+  font-size: 11px;
+  line-height: 16px;
+}
 `;
 function ensureStyle() {
   if (styleInjected || typeof document === "undefined") return;
@@ -1266,10 +1361,156 @@ function removeButtons(host) {
     btn.remove();
   }
   const row = host.querySelector("[data-dsh-cr-row]");
-  if (row instanceof HTMLElement && row.querySelector("[data-dsh-cr-btn], [data-dsh-cr-fold]") === null) {
+  if (row instanceof HTMLElement && row.querySelector("[data-dsh-cr-btn], [data-dsh-cr-fold], [data-dsh-cr-pathchip]") === null) {
     row.remove();
   }
 }
+function basenameOf(path) {
+  const i = path.lastIndexOf("/");
+  return i >= 0 ? path.slice(i + 1) : path;
+}
+function openPathReviewTab(path, chip) {
+  void (async () => {
+    let html;
+    try {
+      const res = await fetch(`/dsh-code-review/diff?path=${encodeURIComponent(path)}`, { cache: "no-store" });
+      if (!res.ok) throw new Error(`http ${res.status}`);
+      const data = await res.json();
+      if (data.ok !== true || typeof data.text !== "string") throw new Error(data.error ?? "bad-response");
+      if (parseGitDiff(data.text).length === 0) throw new Error("not-a-diff");
+      html = buildStandaloneHtml(parseGitDiff(data.text), collectThemeVars(), data.text, detectLang());
+    } catch (err) {
+      console.warn("[dsh-code-review] \u672C\u5730 diff \u8BFB\u53D6\u5931\u8D25:", path, err);
+      markPathChipError(chip);
+      return;
+    }
+    const url = URL.createObjectURL(new Blob([html], { type: "text/html" }));
+    const win = window.open(url, "_blank");
+    if (win !== null) {
+      reviewWindows.add(win);
+      window.setTimeout(() => URL.revokeObjectURL(url), 6e4);
+      return;
+    }
+    const fallback = window.open("", "_blank");
+    if (fallback !== null) {
+      try {
+        fallback.document.open();
+        fallback.document.write(html);
+        fallback.document.close();
+        reviewWindows.add(fallback);
+        return;
+      } catch (err) {
+        console.warn("[dsh-code-review] \u5360\u4F4D\u7A97\u5199\u5165\u5931\u8D25:", path, err);
+        fallback.close();
+      }
+    }
+    markPathChipError(chip);
+  })();
+}
+function markPathChipError(chip) {
+  if (chip === null || !chip.isConnected) return;
+  const texts = CR_TEXTS[detectLang()];
+  const path = chip.dataset.path ?? "";
+  chip.dataset.error = "true";
+  chip.title = texts.pathReadFailed;
+  chip.textContent = texts.pathReadFailed;
+  window.setTimeout(() => {
+    if (!chip.isConnected) return;
+    delete chip.dataset.error;
+    chip.title = texts.viewPathTitle(path);
+    chip.textContent = `${basenameOf(path)} ${texts.viewPath}`;
+  }, 3e3);
+}
+function createPathChip(path, texts, inline) {
+  const chip = document.createElement("button");
+  chip.type = "button";
+  chip.className = "dsh-cr-pathchip";
+  chip.dataset.dshCrPathchip = "";
+  chip.dataset.path = path;
+  if (inline) chip.dataset.inline = "true";
+  chip.textContent = `${basenameOf(path)} ${texts.viewPath}`;
+  chip.title = texts.viewPathTitle(path);
+  chip.addEventListener("click", (event) => {
+    event.stopPropagation();
+    event.preventDefault();
+    openPathReviewTab(path, chip);
+  });
+  return chip;
+}
+function rowPathSig(m) {
+  return JSON.stringify([...m.inline.map((i) => i.path), ...[...m.plain].sort()]);
+}
+function collectRowPathMatches(row) {
+  const inline = [];
+  const plain = [];
+  const inlineSeen = /* @__PURE__ */ new Set();
+  const walker = document.createTreeWalker(row, NodeFilter.SHOW_TEXT, {
+    acceptNode(node2) {
+      const parent = node2.parentElement;
+      if (parent === null) return NodeFilter.FILTER_REJECT;
+      if (parent.closest('[data-variant="think"], .md-code-block, [data-dsh-cr-pathchip], [data-dsh-cr-pathrow]') !== null) {
+        return NodeFilter.FILTER_REJECT;
+      }
+      return NodeFilter.FILTER_ACCEPT;
+    }
+  });
+  let node = walker.nextNode();
+  while (node !== null) {
+    const parent = node.parentElement;
+    if (parent !== null && parent.tagName === "CODE" && !inlineSeen.has(parent)) {
+      const path = cleanDiffPath(parent.textContent ?? "");
+      if (path !== null) {
+        inline.push({ el: parent, path });
+        inlineSeen.add(parent);
+        node = walker.nextNode();
+        continue;
+      }
+    }
+    for (const path of findDiffPaths(node.nodeValue ?? "")) plain.push(path);
+    node = walker.nextNode();
+  }
+  const inlinePaths = new Set(inline.map((i) => i.path));
+  return { inline, plain: [...new Set(plain)].filter((p) => !inlinePaths.has(p)) };
+}
+function removeRowPathChips(row) {
+  for (const chip of row.querySelectorAll("[data-dsh-cr-pathchip]")) chip.remove();
+  for (const container of row.querySelectorAll("[data-dsh-cr-pathrow]")) container.remove();
+}
+function applyRowPathChips(row, matches, texts) {
+  removeRowPathChips(row);
+  for (const { el, path } of matches.inline) {
+    if (!el.isConnected) continue;
+    el.after(createPathChip(path, texts, true));
+  }
+  if (matches.plain.length > 0) {
+    const container = document.createElement("div");
+    container.className = "dsh-cr-row dsh-cr-pathrow";
+    container.dataset.dshCrPathrow = "";
+    for (const path of matches.plain) container.appendChild(createPathChip(path, texts, false));
+    row.appendChild(container);
+  }
+}
+function attachPathChips(host, paths, texts) {
+  for (const chip of host.querySelectorAll("[data-dsh-cr-pathchip]")) {
+    if (!paths.includes(chip.dataset.path ?? "")) chip.remove();
+  }
+  if (paths.length === 0) return;
+  let container = host.querySelector(".dsh-cr-row");
+  if (container === null) {
+    container = document.createElement("div");
+    container.className = "dsh-cr-row";
+    container.dataset.dshCrRow = "";
+    host.appendChild(container);
+  }
+  const existing = /* @__PURE__ */ new Set();
+  for (const chip of container.querySelectorAll("[data-dsh-cr-pathchip]")) {
+    if (chip.dataset.path !== void 0) existing.add(chip.dataset.path);
+  }
+  for (const path of paths) {
+    if (existing.has(path)) continue;
+    container.appendChild(createPathChip(path, texts, false));
+  }
+}
 function findCodeBlockBody(el) {
   const first = el.firstElementChild;
   for (const child of el.children) {
@@ -1342,6 +1583,7 @@ function buttonHostFor(el) {
   return first instanceof HTMLElement ? first : null;
 }
 var pendingTexts = /* @__PURE__ */ new Map();
+var pendingPaths = /* @__PURE__ */ new Map();
 function readToolRoot(data) {
   if (typeof data !== "object" || data === null) return null;
   return data.root ?? null;
@@ -1367,6 +1609,7 @@ function toolResultText(root) {
 }
 function syncDiffToolTexts(sessionId, chat) {
   const found = /* @__PURE__ */ new Map();
+  const foundPaths = /* @__PURE__ */ new Map();
   for (const key of chat.order) {
     const node = chat.nodes.get(key);
     if (node === void 0 || node.kind !== "tool-call") continue;
@@ -1374,13 +1617,18 @@ function syncDiffToolTexts(sessionId, chat) {
     if (root === null || !isSettledToolResult(root)) continue;
     if (root.call === null || root.call.name !== "bash") continue;
     const text = toolResultText(root);
-    if (!isDiffText(text)) continue;
-    found.set(key, text);
+    if (isDiffText(text)) found.set(key, text);
+    const paths = findDiffPaths(text);
+    if (paths.length > 0) foundPaths.set(key, paths);
   }
   for (const [key, entry] of pendingTexts) {
     if (entry.sessionId === sessionId && !found.has(key)) pendingTexts.delete(key);
   }
+  for (const [key, entry] of pendingPaths) {
+    if (entry.sessionId === sessionId && !foundPaths.has(key)) pendingPaths.delete(key);
+  }
   for (const [key, text] of found) pendingTexts.set(key, { sessionId, text });
+  for (const [key, paths] of foundPaths) pendingPaths.set(key, { sessionId, paths });
 }
 function findRowByKey(key) {
   for (const el of document.querySelectorAll("[data-chat-anchor-key]")) {
@@ -1396,10 +1644,19 @@ function attachToolRowButtons() {
     if (!(sample instanceof HTMLElement)) continue;
     ensureButtons(sample, () => pendingTexts.get(key)?.text ?? entry.text, null);
   }
+  for (const [key, entry] of pendingPaths) {
+    const row = findRowByKey(key);
+    if (row === null) continue;
+    const sample = row.querySelector('[data-sample="bash"]');
+    if (!(sample instanceof HTMLElement)) continue;
+    attachPathChips(sample, entry.paths, CR_TEXTS[detectLang()]);
+  }
 }
 var DiffScanner = class {
   constructor() {
     __publicField(this, "states", /* @__PURE__ */ new WeakMap());
+    /** 消息行路径 chip 的行状态(与 BlockState 并列,策略同款:去抖 + 签名)。 */
+    __publicField(this, "pathStates", /* @__PURE__ */ new WeakMap());
     __publicField(this, "observer", null);
     __publicField(this, "scanTimer", null);
     __publicField(this, "safetyTimer", null);
@@ -1431,12 +1688,15 @@ var DiffScanner = class {
       this.scan();
     }, SCAN_DEBOUNCE);
   }
-  /** 全量扫描:数据层工具行按钮 + DOM 候选块。 */
+  /** 全量扫描:数据层工具行按钮 + DOM 候选块 + 消息行路径 chip。 */
   scan() {
     attachToolRowButtons();
     for (const el of document.querySelectorAll(".md-code-block, [data-terminal]")) {
       this.inspect(el);
     }
+    for (const row of document.querySelectorAll("[data-chat-anchor-key]")) {
+      this.inspectPathRow(row);
+    }
   }
   /** 检查一个候选块:内容未变则不动,变了则排去抖,不再形似 diff 则移除按钮。 */
   inspect(el) {
@@ -1514,6 +1774,65 @@ var DiffScanner = class {
       btn.textContent = st.folded ? texts.expand : texts.collapse;
     }
   }
+  /**
+   * 检查一个消息行的本地 diff 路径:
+   * - 工具行(含 data-sample)走数据层,这里跳过;
+   * - 没有路径/不再有路径 → 移除 chip 并清态;
+   * - 签名变更 → 移除旧 chip、排稳定去抖(流式期间 chip 不闪现);
+   * - 签名未变 → 校验已挂 chip 与当前 DOM 是否一致(React 可能重建过
+   *   code 元素),不一致直接重建(内容稳定,不需要再去抖)。
+   */
+  inspectPathRow(row) {
+    if (row.querySelector("[data-sample]") !== null) return;
+    if (!/\.(?:diff|patch)/i.test(row.textContent ?? "")) {
+      removeRowPathChips(row);
+      this.pathStates.delete(row);
+      return;
+    }
+    const matches = collectRowPathMatches(row);
+    const sig = rowPathSig(matches);
+    if (matches.inline.length === 0 && matches.plain.length === 0) {
+      removeRowPathChips(row);
+      this.pathStates.delete(row);
+      return;
+    }
+    const st = this.pathStates.get(row);
+    if (st !== void 0 && st.sig === sig) {
+      if (this.pathChipsConsistent(row, matches)) return;
+      if (st.timer === null) applyRowPathChips(row, matches, CR_TEXTS[detectLang()]);
+      return;
+    }
+    removeRowPathChips(row);
+    if (st !== void 0 && st.timer !== null) clearTimeout(st.timer);
+    const timer = window.setTimeout(() => {
+      const cur = this.pathStates.get(row);
+      if (cur === void 0 || cur.timer !== timer) return;
+      cur.timer = null;
+      const m2 = collectRowPathMatches(row);
+      if (rowPathSig(m2) !== cur.sig) return;
+      applyRowPathChips(row, m2, CR_TEXTS[detectLang()]);
+    }, STABLE_MS);
+    this.pathStates.set(row, { sig, timer });
+  }
+  /** 校验消息行上已挂的 chip 与当前匹配是否一致(数量 + 路径 + 锚点)。 */
+  pathChipsConsistent(row, matches) {
+    const chips = row.querySelectorAll("[data-dsh-cr-pathchip]");
+    if (chips.length !== matches.inline.length + matches.plain.length) return false;
+    const inlineOk = new Set(matches.inline.map((m) => m.path));
+    const plainOk = new Set(matches.plain);
+    for (const chip of chips) {
+      const path = chip.dataset.path ?? "";
+      if (chip.dataset.inline === "true") {
+        if (!inlineOk.has(path)) return false;
+        const sib = chip.previousElementSibling;
+        if (!(sib instanceof HTMLElement) || sib.tagName !== "CODE") return false;
+        if ((sib.textContent ?? "") !== path) return false;
+      } else if (!plainOk.has(path)) {
+        return false;
+      }
+    }
+    return true;
+  }
 };
 var inject = ["slots", "locale"];
 function apply(ctx) {