dsh-artifact-linker 0.3.9 → 0.4.2

package/CHANGELOG.md

@@ -1,5 +1,87 @@
-# Changelog
-
+# Changelog
+
+## 0.4.2 — 2026-10-30
+
+### 改：识别层重写为「存在性驱动」——不再靠扩展名/排除字符集猜边界，任意绝对路径、任意文件名都能打开
+
+病根：0.4.1 仍是「正则按扩展名 + 排除字符集猜文件边界」。而 Windows 合法文件名字符几乎覆盖所有可见字符（括号、`【】`、中文标点、含空格、无扩展名、名字里带 `.数字`），排除法必然有漏；每漏一类就得再打一次补丁，不可收敛。真正的文件边界只有**磁盘真实存在性**能裁决。
+
+### 改（`lib/client.js` 识别层 + `lib/index.js` 解析层）
+
+| 位置 | 旧 | 新 |
+|---|---|---|
+| 客户端识别（`hitAt`） | 用带扩展名+排除字符集的正则猜文件边界 | 新增绝对路径通道：`ABS_ANCHOR`（盘符 `X:\` 或 UNC `\\host\share\`）锁定起点 → 贪心截到**本行行尾**，不再猜扩展名；返回 `absStart` 供精确高亮；识别层不去尾（真实文件可能以 `)` `】` `。` 结尾） |
+| 高亮（`onMove`） | 用整块 rect | 命中后用后端返回的真实文件名 `rec.abs.length` 收窄精确高亮 |
+| 宿主解析（`resolveAcross`） | 整串 → 从左按空白剥 | ⓪原样整串精确 stat（救「文件名真以 (2024) 结尾」）→ 整串 tryAll → ①从右逐字符收缩 `shrinkRightAbs`（**不跨最后一个路径分隔符**、下界 `lastSep+2`、只做绝对精确 stat，避免砍成父目录/同名误报，`source:"absolute-shrunk"`）→ ②从左按空白剥兜底 |
+| `VERSION` | `0.4.1` | `0.4.2` |
+
+### 验证（探针 `probe_v042.cjs`，复刻真实 resolveAcross + shrinkRightAbs + clientHitAt）
+
+- 24 项断言全 PASS / 0 FAIL；`node --check` 双文件 exit 0；无 BOM。
+- 覆盖：上轮 146 字 `inratio1.8D` 原样命中、路径紧跟中文说明（无空格）、路径+空格+说明、文件名含 `(最终)【v2】`、无扩展名 `README`、多级 `.cas.h5`+说明、文件名真以 `(2024)` 结尾(+说明)、前置说明词、**防误报（不存在文件不退化成父目录 `D:\a`）**、正文假路径不命中、相对裸名不误判；`hitAt` 取全路径吃到行尾、`absStart` 指向盘符、行尾不跨行、无盘符不进入绝对通道、无扩展名绝对路径可识别。
+- 回归：host `/resolve` 契约未变；旧版识别不到的路径变可识别，已能识别的仍可识别。
+
+## 0.4.1 — 2026-10-30
+
+### 修：目录名里带「.数字/字母」（如 `inratio1.8D`）时，路径芯片只识别到该级目录、后半段文件丢失
+
+病根：`lib/client.js` 路径识别正则的中间段是**非贪婪**匹配（`{1,200}?` 后紧跟一个点），一遇到目录名里的点（`.../7-VTD-qianzhuijiao15-19-inratio1.8D/...`）就当作文件扩展名边界，把 `inratio1.8D` 里的 `.8D` 误判成扩展名 → 路径被截断在 `...inratio1.8D`（第 3 级目录），其后的 `comparison\...\*.png` 全部丢失，表现为用户所说「只能选到上几级的路径」。
+
+### 改（`lib/client.js` 三处 + `VERSION`）
+
+| 位置 | 旧 | 新 |
+|---|---|---|
+| RE 末尾前瞻 | 只排除字母数字下划线 | 增加两条排除：①扩展名后紧跟路径分隔符（斜杠/反斜杠）②扩展名后又接「点+扩展名」段。强迫正则跨过目录名里的伪扩展名，一路吃到真正的文件扩展名 |
+| 中间段长度上限 | `{1,200}?` | `{1,1024}?` |
+| `hitAt` 取词窗口 | 鼠标前后各 200 字 | 鼠标前后各 1024 字（长路径整体落入匹配窗口） |
+| `VERSION` 常量 | `0.4.0` | `0.4.1` |
+
+### 验证（从真实修复文件提取 RE + hitAt 窗口探针）
+
+- 用户路径 146 字 `...inratio1.8D\comparison\...\VTD-...-静压.png` → 整段匹配；hitAt 鼠标落在偏移 0/20/74/90/120/146 均返回完整路径
+- 不退化：`data.cas.h5` / `a.tar.gz` / `case.dat.h5` / 带空格中文名 `季度报告 最终版.pdf` / UNC 路径
+- 多点目录 `2024.10.30\file.png`、`run.v1.3.2d\a.png` 均完整（旧版会截断）
+- 不误报：散文 `版本 v1.2 已发布` → 无匹配
+- `node --check` 通过；文件无 BOM
+
+## 0.4.0 — 2026-10-30
+
+### 改：彻底去掉扩展名白名单，所有文件类型都能识别、都能走侧边栏预览
+
+病根：旧版有两张手写白名单——`PREVIEWABLE`（决定右键菜单里「在侧边栏预览」显不显示）和 `EXT`（决定正文里哪段文字算文件名）。两者都是**对宿主渲染能力的静态猜测**，问题一样：
+
+1. 宿主每加一个渲染器就得回来补一次清单，漏一次就表现为「正文里明明有文件名，右键毫无反应」；
+2. 用户装了 `dsh-video-preview` / `@huanlin/...-audio` 这类插件后宿主能力早变了，白名单却停在旧结论上 —— 于是 **mp4 / mp3 / wav 右键完全没有预览入口**，本次就是这条报上来的。
+
+### 三处改动
+
+| 位置 | 旧 | 新 |
+|---|---|---|
+| `PREVIEWABLE` | 正则白名单，`canPreview` 为 false 就不 push 菜单项 | **整条删除**，「在侧边栏预览」对所有类型无条件显示 |
+| `EXT` | 手写约 130 项扩展名数组，拼进 `RE` | **整条删除**，改为通用扩展名匹配 + `EXEC_EXT` 可执行体黑名单 |
+| 预览点击反馈 | 成功/失败无区分 | 成功 `toast("已在侧边栏打开（.xxx）")`，失败 `toast("侧边栏打不开 .xxx，可改用「用默认程序打开」")` |
+
+新的识别规则：**任意 1–12 位扩展名都算候选**，字母开头或数字开头都收（`7z` / `3mf` / `3gp` 这类数字开头的真实格式以前被漏掉）。唯一还刻意排除的是可执行体 / 系统二进制（`EXEC_EXT`：`exe msi msp mst dll sys com scr cpl ocx drv vxd efi so dylib ko elf`）——正文里出现 `xxx.exe` 九成是命令输出或报错原文，而「用默认程序打开」对它们等于**直接运行**，误点代价太大。
+
+### 误报怎么兜：不靠白名单，靠存在性闸门
+
+候选片段必须先在宿主 `/resolve` 真的解析到磁盘文件，才会变成可点目标。所以散文里的 `e.g.` / `v1.2` / `Node.js` 即使被正则当成候选也没关系：解析不到就静默，用户完全看不出它曾被识别过。这比维护一张永远追不上现实的清单可靠得多。
+
+### 验证
+
+新增 `_verify/test-ext-regex.mjs`，36 项断言全过：
+- 旧白名单已支持的（`mp4`/`mp3`/`wav`/`pdf`/`xlsx`/`md`/`py`/`cas.h5`/`dat.h5`/带空格文件名）不退化；
+- 旧白名单漏掉的（`mov`/`mkv`/`webm`/`flac`/`m4a`/`7z`/`heic`/`avif`/`mcap`/`parquet`/`3mf`/`usdz`/任意未知扩展名）现在都能命中；
+- 可执行体（`exe`/`msi`/`dll`/`sys`/`so`/`dylib`/`ko`/`elf`/`com`/`scr`/`ocx`/`cpl`）全部不命中。
+
+### 顺手修
+
+`lib/client.js` 的 `VERSION` 常量一直停在 `0.3.8`，落后 `package.json` 两个版本，现统一为 `0.4.0`。
+
+### 已知代价（用户已明确接受）
+
+极少数类型点「在侧边栏预览」会得到一句「打不开」。这是刻意的取舍：宁可点了没反应，也不要靠限制类型来回避未来的 bug —— 这样侧边栏以后补了什么能力，本插件零改动自动跟上。
+
 ## 0.3.9 — 2026-10-29
 
 ### 修：插件市场看不到下载量 / 版本号 / 搜不到

package/README.en.md

@@ -55,7 +55,7 @@ Click behaviour is decided by the modifier key — no first-time setup:
 
 | Item | What it does |
 | --- | --- |
-| **Preview in sidebar** | Opens the file in DSH's built-in right sidebar — the same route as clicking a file link in chat. That viewer handles PDF, Word, Excel, PowerPoint, Markdown, plain text, CSV, images, audio and video; an extension it cannot render is redirected to the default app instead of showing a blank pane |
+| **Preview in sidebar** | Opens the file in DSH's built-in right sidebar — the same route as clicking a file link in chat. **Since 0.4.0 this menu item is shown for every file type**, with no extension filtering: whatever viewer claims the address renders it (PDF / Word / Excel / PowerPoint / Markdown / plain text / CSV / images, plus audio and video once plugins such as video-preview / audio-preview are installed); anything unclaimed falls back to plain text or the default app. The trade-off is that a rare type may answer with a plain "the sidebar cannot open this" — accepted on purpose, so future viewer capabilities are picked up with zero changes here |
 | **Open with default app** | Hands the file to the OS association (Explorer / Excel / VLC / …) |
 | **Reveal in Explorer** | Opens the containing folder and selects the file |
 | **Save as…** | Copies the file to a location you pick |

package/README.md

@@ -51,7 +51,7 @@ DSH 里预览器已经能开图片、代码、pdf、office。但**插件、脚
 
 | 菜单项 | 作用 |
 |---|---|
-| **在侧边栏预览** | 在 DSH 内置右侧边栏里打开，和聊天里点文件链接是同一条通道。该查看器支持 PDF、Word、Excel、PowerPoint、Markdown、纯文本、CSV、图片、音视频；它渲染不了的扩展名会**自动改走默认程序**，不会给你一个空白面板 |
+| **在侧边栏预览** | 在 DSH 内置右侧边栏里打开，和聊天里点文件链接是同一条通道。**0.4.0 起对所有文件类型一律显示这一项**，不再按扩展名筛：能认领的查看器就渲染（PDF / Word / Excel / PowerPoint / Markdown / 纯文本 / CSV / 图片，装了 video-preview / audio-preview 等插件后还有音视频），认领不了的宿主会退回纯文本或默认程序。副作用是极少数类型点下去可能只得到一句「侧边栏打不开」——这是刻意接受的代价，为的是以后侧边栏补了新能力，本插件零改动自动跟上 |
 | **用默认程序打开** | 交给系统关联（资源管理器 / Excel / 播放器……） |
 | **在文件夹中显示** | 打开所在目录并选中该文件 |
 | **另存为…** | 复制到你指定的位置 |
@@ -146,10 +146,10 @@ GET http://127.0.0.1:<port>/dsh-artifact-linker/info
 
 | 症状 | 原因与处置 |
 |---|---|
-| 正文文件名不可点 | ① `clientChips` 被置 false；② 扩展名不在白名单（本插件只认已知产物扩展名，避免把 `C:\Windows` 之类误标成产物）；③ 客户端 bundle 没重载——**Ctrl+R 不重载客户端 bundle，必须完全重启 DSH** |
+| 正文文件名不可点 | ① `clientChips` 被置 false；② 扩展名是可执行体（`exe`/`msi`/`dll`/`sys`/`so` 等，这是**唯一**仍刻意不认的一类，见 `lib/client.js` 的 `EXEC_EXT`）；③ 客户端 bundle 没重载——**Ctrl+R 不重载客户端 bundle，必须完全重启 DSH** |
 | 点开提示「解析不到绝对路径」 | 裸文件名不在 workspace 内，且 `allowOutside: false`。先确认文件真实路径，再决定是否放宽 |
 | 点开提示「文件已不存在」 | 路径是真的，文件被删/移了。清单里该行会打上删除线 |
-| 点产物名没反应 | ① 文件不在候选 base 下（访问宿主 `/info` 看 `bases`）；② 扩展名不在白名单（`lib/client.js` 的 `EXT`）；③ 直接看 `/resolve?p=<名字>` 返回的 `reason` |
+| 点产物名没反应 | ① 文件不在候选 base 下（访问宿主 `/info` 看 `bases`）；② 直接看 `/resolve?p=<名字>` 返回的 `reason`。**0.4.0 起不再有扩展名白名单**，任何字母或数字开头的扩展名都会被识别为候选（`7z`/`3mf` 这类数字开头的也算），误报由「必须先真实解析到磁盘文件」这道存在性闸门兜掉 |
 | 右键没出本插件菜单 | 该处文字没解析成文件（同上）；**对非产物右键本来就不接管**，出的是宿主原生菜单。0.3.3 起会先确认文件存在——不存在的片段既不画虚线也不接管右键 |
 | 日志里出现 N 份相同输出 | 热重载堆叠了多个实例。**Ctrl+R 无效，必须完全重启 DSH**；同时确认 `window.__dshArtifactLinkerV1.dispose()` 守卫在 |
 

package/lib/client.js

@@ -29,7 +29,7 @@ window.__ModuleLoader__.load({
     var exports = module.exports;
 
     var GUARD = "__dshArtifactLinkerV1";
-    var VERSION = "0.3.8";
+    var VERSION = "0.4.2";
     // 路由前缀必须与宿主的 ROUTE_PREFIX 一致；永远根相对，绝不拼宿主 origin
     var ROUTE = "/dsh-artifact-linker";
 
@@ -61,11 +61,21 @@ window.__ModuleLoader__.load({
       return sessionFileAddress(sessionId, normalized);
     }
 
-    // 侧边栏 documentpreview 真正能渲染的类型（读官方 README 得出，不是猜的）：
-    //   md/代码/纯文本 → 分页文本；pdf → PDF.js；图片 → 完整字节；
-    //   xlsx/xls/csv/tsv → 浏览器内只读表格；doc/docx/ppt/pptx → 本地转 PDF
-    // 音视频与压缩包没有注册渲染器，走「不支持预览」空状态，所以干脆不显示这一项。
-    var PREVIEWABLE = /^(pdf|docx?|pptx?|xls[xm]?|csv|tsv|md|markdown|txt|log|json|ya?ml|ini|toml|xml|html?|png|jpe?g|gif|webp|bmp|tiff?|svg|py|js|mjs|cjs|ts|tsx|ipynb|ps1|sh|cas|dat|h5|hsf|cxa|trn|rfile|plt|flprj|jou|set|out)$/i;
+    // 🔴 「在侧边栏预览」不再有类型白名单（2026-10-30 用户明确要求）。
+    //
+    // 旧版这里有一张 PREVIEWABLE 白名单，只放「宿主 documentpreview 当时能渲染」的
+    // 扩展名，音视频/压缩包被排除，右键它们根本没有预览入口。那个设计错在：
+    //   1) 白名单是**对宿主渲染能力的静态猜测**。宿主每加一个渲染器就得回来改一次；
+    //      用户装了 video-preview / audio-preview 这类插件后宿主能力早变了，
+    //      白名单却停在旧结论上 → 视频、mp3、wav 右键毫无入口（本次的直接病根）。
+    //   2) 「能不能渲染」本就不该由客户端猜。判定方是宿主
+    //      sidebarRight.openResource：能认领就渲染，认领不了它自己退回默认程序。
+    //
+    // 现在的契约：**菜单项对所有类型一律显示，点了才见真章**。
+    //   openInSidebar 返回 true  → toast「已在侧边栏打开」
+    //   openInSidebar 返回 false → toast「侧边栏打不开这个文件（.xxx）」
+    // 这样以后侧边栏补了什么能力，本插件零改动自动跟上，不会被旧白名单漏掉。
+    // 代价：极少数类型点了会得到一句「打不开」——用户已明确接受。
 
     function extOf(p) {
       var base = String(p).split(/[\\/]/).pop() || "";
@@ -74,24 +84,29 @@ window.__ModuleLoader__.load({
     }
 
 
-    // 产物扩展名白名单。刻意**不含 exe/msi/dll** 之类可执行体：
-    // 正文里出现这些名字多半是命令输出/报错文本，不是「要打开看的产物」。
-    var EXT = [
-      "pdf", "docx?", "xlsx?", "pptx?", "csv", "tsv",
-      "png", "jpe?g", "gif", "webp", "bmp", "tiff?", "svg",
-      "zip", "7z", "rar", "gz", "tar",
-      "log", "txt", "md", "json", "ya?ml", "ini", "toml", "xml", "html?",
-      "py", "js", "mjs", "cjs", "ts", "tsx", "ipynb", "ps1", "sh",
-      "cas", "dat", "h5", "hsf", "cxa", "trn", "rfile", "plt", "flprj", "jou", "set", "out",
-      "scdocx?", "pmdb", "unv", "msh", "stp", "step", "igs", "iges", "dwg", "dxf", "inp",
-      // 音频/视频：合成音频（YuE、TTS、音色克隆）与录屏导出很常见，
-      // 之前不在白名单里，用户右键 audio.flac 就完全没反应。
-      "flac", "wav", "mp3", "m4a", "aac", "ogg", "opus", "wma", "amr",
-      "mp4", "mkv", "mov", "avi", "webm", "wmv", "flv", "m4v"
-    ].join("|");
+    // ── 正文里「长得像文件名」的判定 ────────────────────────────────────────
+    //
+    // 🔴 2026-10-30 起**不再维护扩展名白名单**（用户明确要求：所有文件类型都要能识别、
+    // 都能走侧边栏预览）。旧版是一张手写清单，问题是它永远追不上现实：
+    //   新格式（heic / avif / mcap / parquet / 3mf / usdz…）每出现一个就得回来补一次，
+    //   漏掉的表现就是「正文里明明有文件名，右键毫无反应」——本次音视频/压缩包
+    //   的抱怨就是这么来的。
+    //
+    // 现在的规则：**任意 1–8 位、以字母开头的扩展名都算**，只用一个黑名单挡掉
+    // 可执行体与系统二进制。为什么只挡这些：
+    //   * 正文里出现 xxx.exe / xxx.dll 九成是命令输出、报错原文、依赖清单，
+    //     不是「要打开看的产物」；
+    //   * 「用默认程序打开」对它们等于**直接运行**，误点代价太大。
+    // 真要放开，把下面对应的词删掉即可。
+    //
+    // 误报怎么兜？——不靠白名单，靠**存在性闸门**：候选片段必须先在宿主
+    // /resolve 真的解析到磁盘文件，才会变成可点目标（见下方 verify()）。
+    // 所以把 e.g. / v1.2 这种散文里的点号误当成扩展名也没关系：解析不到就静默，
+    // 用户完全看不出它曾被识别过。这比维护一张永远不全的清单可靠得多。
+    var EXEC_EXT = /^(exe|msi|msp|mst|dll|sys|com|scr|cpl|ocx|drv|vxd|efi|so|dylib|ko|elf)$/i;
 
     // 一段文本里「像产物路径」的片段：
-    //   可选的前缀（盘符 或 UNC）+ 中间任意非分隔字符 + 点 + 白名单扩展名
+    //   可选的前缀（盘符 或 UNC）+ 中间任意非分隔字符 + 点 + 扩展名
     //   + 可选的多级尾巴（Fluent 的 xxx.cas.h5 / xxx.dat.h5 必须整体吃掉，
     //     否则会被截成 xxx.cas 去撞一个不存在的文件 → 点了没反应）
     // 末尾 (?![A-Za-z0-9_]) 防止 package.lock / a.python 这种半截匹配。
@@ -104,8 +119,14 @@ window.__ModuleLoader__.load({
     //   解析必然失败 → 点上去毫无反应。这是「带空格文件名点了没反应」的真正根因。）
     var RE = new RegExp(
       "(?:[A-Za-z]:[\\\\/]|\\\\\\\\[^\\\\/\\s]+[\\\\/][^\\\\/\\s]+)?" +
-      "[^\\t\\r\\n`\"'<>|*?（）()【】\\[\\]{}，；、]{1,200}?\\." +
-      "(?:" + EXT + ")(?:\\.[A-Za-z0-9]{1,6})*(?![A-Za-z0-9_])",
+      "[^\\t\\r\\n`\"'<>|*?（）()【】\\[\\]{}，；、]{1,1024}?\\." +
+      // 扩展名两种写法都收：
+      //   字母开头 1–12 位（pdf / mp4 / catproduct / properties…）
+      //   数字开头 2–12 位（7z / 3mf / 3gp / 8bf…）—— 必须 ≥2 位，否则
+      //   散文里的 v1.2 会贡献一个「扩展名 2」，虽然最后也会被存在性闸门静默掉，
+      //   但没必要让它进候选池。
+      "([A-Za-z][A-Za-z0-9_]{0,11}|[0-9][A-Za-z0-9_]{1,11})" +
+      "(?:\\.[A-Za-z0-9]{1,12})*(?![A-Za-z0-9_\\\\/]|\\.[A-Za-z0-9])",
       "gi"
     );
     // URL 里天然带 .png/.pdf，全部要排除，否则网页链接会被当成文件产物。
@@ -187,11 +208,50 @@ window.__ModuleLoader__.load({
       var text = range.startContainer.nodeValue || "";
       if (!text) return null;
       var off = range.startOffset;
-      var from = Math.max(0, off - 200);
-      var to = Math.min(text.length, off + 200);
+      var from = Math.max(0, off - 1024);
+      var to = Math.min(text.length, off + 1024);
       var win = text.slice(from, to);
       var rel = off - from;
       var urls = urlRanges(win);
+
+      // ★ 绝对路径通道（v0.4.2）：只要鼠标位置左侧有「盘符 X:\ 或 UNC \\host\share\」起点，
+      //   就从该起点一路**贪心吃到本行行尾**，不再用「扩展名 + 排除字符集」去猜边界。
+      //   这样任何名称都敢认：带空格、带 ()（）[]【】{}、中文标点、无扩展名、超长、
+      //   目录名里带点（inratio1.8D / 2024.10.30）全都不影响 —— 真正的边界交给宿主
+      //   resolveAcross 的「原样 stat → 从右逐字符收缩（不跨分隔符）」按真实磁盘裁决。
+      //   识别层刻意**不做 cleanRaw 去尾**：真实文件也可能以 ) 】 。 结尾，不能被误剥。
+      var ABS_ANCHOR = /(?:[A-Za-z]:[\\/]|\\\\[^\\/\r\n]+[\\/][^\\/\r\n]+[\\/]?)/g;
+      var lastStart = -1;
+      var ma;
+      ABS_ANCHOR.lastIndex = 0;
+      while ((ma = ABS_ANCHOR.exec(win))) {
+        if (ma.index > rel) break;            // 只看鼠标左侧（含）的起点
+        lastStart = ma.index;
+      }
+      if (lastStart >= 0) {
+        var nl = win.indexOf("\n", lastStart);
+        var lineEnd = nl < 0 ? win.length : nl;
+        if (rel <= lineEnd) {
+          var seg = win.slice(lastStart, lineEnd).replace(/\s+$/, "");
+          if (seg && seg.length >= 4 && !inRanges(urls, lastStart, lastStart + seg.length)) {
+            var exts = seg.match(/\.[A-Za-z0-9]{1,12}/g) || [];
+            var isExec = false;
+            for (var ei = 0; ei < exts.length; ei++) {
+              if (EXEC_EXT.test(exts[ei].slice(1))) { isExec = true; break; }
+            }
+            if (!isExec) {
+              return {
+                raw: seg,
+                rect: rectFor(range.startContainer, from + lastStart, from + lineEnd),
+                node: range.startContainer,
+                absStart: from + lastStart
+              };
+            }
+          }
+        }
+      }
+
+      // ── 兜底：裸文件名 / 相对路径（无盘符），仍用扩展名形状识别，交后端 ①②③ 兜 ──
       var m;
       RE.lastIndex = 0;
       while ((m = RE.exec(win))) {
@@ -199,6 +259,9 @@ window.__ModuleLoader__.load({
         var e = m.index + m[0].length;
         if (rel < s || rel > e) continue;         // 鼠标必须落在这个片段上
         if (inRanges(urls, s, e)) continue;       // URL 里的 .png 不算
+        // 可执行体黑名单：这是唯一还刻意不认的类型（理由见上方 EXEC_EXT 注释）。
+        // 多级后缀取第一段判断，xxx.exe.bak 也算可执行体，宁可漏认不误点。
+        if (m[1] && EXEC_EXT.test(m[1])) continue;
         var raw = cleanRaw(m[0]);
         if (!raw || raw.length < 4) continue;
         return { raw: raw, rect: rectFor(range.startContainer, from + s, from + e) };
@@ -379,11 +442,13 @@ window.__ModuleLoader__.load({
       // 文案要说人话：「资源管理器」这个词很多用户不认识，改成「文件夹窗口」。
       // 顺序按「最常做的动作」排，并用 "sep" 占位分成三组：
       //   看（侧边栏预览 / 打开 / 定位）→ 搬运（另存为 / 复制文件 / 复制路径）→ 喂给 AI（添加到对话框）
-      // 侧边栏预览只对宿主真能渲染的类型出现：音视频、压缩包在侧边栏里只有
-      // 「不支持预览」空状态，摆一个点了白点的入口不如不摆。
-      var canPreview = PREVIEWABLE.test(extOf(abs));
+      //
+      // 🔴 「在侧边栏预览」对所有文件类型**无条件出现**（2026-10-30 用户明确要求）。
+      // 旧版按 PREVIEWABLE 白名单决定显不显示，音视频/压缩包因此完全没有入口。
+      // 现在一律显示，点下去由宿主 sidebarRight.openResource 决定能不能认领：
+      // 认领得了就渲染，认领不了 openInSidebar 返回 false，我们照实提示「打不开」。
       var items = [];
-      if (canPreview) items.push(["preview", "在侧边栏预览", "在右侧边栏里直接看，不用切出去"]);
+      items.push(["preview", "在侧边栏预览", "在右侧边栏里直接看，不用切出去；这个类型如果侧边栏渲染不了会如实提示"]);
       items.push(["open", "用默认程序打开", "按文件类型用对应软件打开：PDF 用阅读器、表格用 Excel 那类"]);
       items.push(["reveal", "在文件夹中显示", "打开 Windows 文件夹窗口，并选中这个文件"]);
       items.push(["sep", "", ""]);
@@ -420,8 +485,10 @@ window.__ModuleLoader__.load({
 
             // ① 侧边栏预览 —— 纯客户端，走宿主导航入口
             if (action === "preview") {
-              if (openInSidebar(abs)) toast("已在侧边栏打开");
-              else toast("侧边栏打不开这个文件");
+              // 对所有类型都尝试，成败照实说。带扩展名，用户才知道是哪个类型没成。
+              var pext = extOf(abs);
+              if (openInSidebar(abs)) toast("已在侧边栏打开" + (pext ? "（." + pext + "）" : ""));
+              else toast("侧边栏打不开" + (pext ? " ." + pext : "这个文件") + "，可改用「用默认程序打开」");
               return;
             }
 
@@ -641,7 +708,14 @@ window.__ModuleLoader__.load({
           if (disposed) return;
           if (!rec.ok) { setCursor(""); hideHover(); return; }
           setCursor("pointer");
-          drawHover(hit.rect);
+          // 绝对路径通道可能把「路径 + 尾随说明」整段当候选，粗略 rect 会盖到说明文字上。
+          // 命中后按宿主返回的真实 abs 长度把高亮收窄到路径本身（起点对齐，abs 是候选的前缀）。
+          var rr = hit.rect;
+          if (hit.node && rec.abs) {
+            var precise = rectFor(hit.node, hit.absStart, hit.absStart + rec.abs.length);
+            if (precise) rr = precise;
+          }
+          drawHover(rr);
         });
       }, 150);
     }

package/lib/index.js

@@ -260,14 +260,51 @@ function resolveAcross(raw, extraBase, allowOutside) {
     return best;
   }
 
+  var rawTrim = String(raw || "").trim();
+
+  // 只对绝对路径做「精确 stat」的小工具：不走 basename 反查，避免把目录/同名文件误认。
+  function statAbsExact(s) {
+    if (!looksAbsolute(s)) return null;
+    var abs = pathResolve(s);
+    if (!allowOutside) {
+      var okb = false;
+      for (var bi = 0; bi < bases.length; bi++) { try { if (isInside(bases[bi], abs)) { okb = true; break; } } catch (e) { } }
+      if (!okb) return null;
+    }
+    var st = statOne(abs);
+    if (!st.exists) return null;
+    return { ok: true, raw: s, abs: abs, exists: true, kind: st.kind, size: st.size, mtimeMs: st.mtimeMs, source: "absolute" };
+  }
+
+  // ⓪ 原样整串精确 stat（不经 cleanRaw）：真实文件名允许以 ) 】 。 结尾、也允许带空格中文，
+  //    cleanRaw 会误剥这些尾部，所以先拿 raw 原样撞一次，命中即用。
+  var exact = statAbsExact(rawTrim);
+  if (exact) return exact;
+
   var first = tryAll(raw);
   if (first && first.ok) return first;
   var best = first;
 
-  // 🔴 从左收缩重试（配合客户端正则允许空格的做法）
-  // 客户端为了支持「带空格的文件名」，现在会把左边几个词一起吞进候选，
-  // 于是「详见 报告.pdf」这种会整串送过来。这里先按整串试，不行就剥掉最左一段再试，
-  // 直到只剩纯文件名。这样既保住空格文件名，又不会因为多吞了几个词就解析不到。
+  // ① 绝对路径：从右逐字符收缩，**不跨过最后一个路径分隔符**（避免把文件名砍光后退化成父目录误报）。
+  //    专治「路径后紧跟中文说明/尾部标点且中间无空格」：D:\a\b.png这个图 → D:\a\b.png。
+  function shrinkRightAbs(s) {
+    var t = String(s || "").trim();
+    if (!looksAbsolute(t)) return null;
+    var lastSep = Math.max(t.lastIndexOf("\\"), t.lastIndexOf("/"));
+    var lowBound = lastSep + 2;                 // 最后一个文件名至少保留 1 个字符
+    var limit = Math.min(t.length, 600);
+    for (var cut = t.length - 1; cut >= lowBound && (t.length - cut) <= limit; cut--) {
+      var cand = t.slice(0, cut);
+      var o = statAbsExact(cand);
+      if (o && o.ok) { o.raw = cand; o.shrunkFrom = s; o.source = "absolute-shrunk"; return o; }
+    }
+    return null;
+  }
+  var shrunkAbs = shrinkRightAbs(rawTrim);
+  if (shrunkAbs && shrunkAbs.ok) return shrunkAbs;
+  if (!best && shrunkAbs) best = shrunkAbs;
+
+  // ② 从左按空白剥（前置说明词 + 空格 + 路径）
   var segs = String(raw || "").trim().split(/\s+/);
   for (var j = 1; j < segs.length; j++) {
     var shrunk = segs.slice(j).join(" ");

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "dsh-artifact-linker",
-    "version": "0.3.9",
+    "version": "0.4.2",
     "description":  "DSH 产物路径联动器：常驻注入「产物路径铁律」让模型输出完整绝对路径，同时把聊天正文里的文件名/路径渲染成一键可点的产物芯片——左键预览、右键菜单可打开/定位/另存为/复制文件/复制路径/添加到对话框。宿主端提供回环只读路由与 /saveas /copyfile 两个文件搬运动作（Shell COM 揭示、WinForms 保存对话框、CF_HDROP 剪贴板），客户端零侵入、不改 React 节点、不接管 markdown 图片语法。解决「产物要打开得先复制路径再粘到文件管理器」的反复割裂。/ Turn declared artifact paths into one-click chips: resident system-prompt rules force absolute paths, the client half renders file names as clickable chips, and the right-click menu offers open / reveal in Explorer / save-as / copy-file / copy-path / insert-into-composer. Host routes are loopback-only; zero telemetry.",
     "type":  "module",
     "main":  "lib/index.js",
@@ -64,4 +64,4 @@
                              "@deepseek-ai/cordis":  "^4.0.2",
                              "@deepseek-ai/dsh":  "\u003e=0.2.1-rc.3"
                          }
-}
+}