dsh-artifact-linker 0.2.5 → 0.2.7

package/CHANGELOG.md

@@ -1,5 +1,68 @@
 # Changelog
 
+## 0.2.7 — 2026-10-28
+
+### 文档：加上实机截图
+
+README 中英双版各嵌入三张真实运行截图 —— 悬停高亮、右键菜单、复制路径 —— 放在仓库 `docs/` 下。
+
+截图用 `raw.githubusercontent.com` 绝对地址引用，GitHub 与 npm 页面都能正常渲染；`files` 白名单不含 `docs`，所以**图片不进 npm 包体**，包大小不变。
+
+---
+
+## 0.2.6 — 2026-10-28
+
+### 修掉两处「看不见的破窗」
+
+1. **日志里的中文变乱码**
+   `reveal` 失败分支会往 stdout 打一句含中文的说明，日志消费端按 ANSI 解码就成了 `閫€鍑虹爜 1`。现在这条日志全 ASCII，并把真实含义写清楚：explorer 收到 `/select` 后把请求转交给已运行实例、随即退出，**退出码 1 是正常现象**。
+
+2. **正则探针静默失效**
+   `probe-regex.mjs` 还在按 v0.1 的变量名（`EXT_ALT` / `RE_ABS` / `RE_NAME`）切源码。v0.2 把三条正则合并成单个 `RE` 之后锚点全断，探针直接退出 —— 等于这一层守卫早已不存在，只是没人发现。已按 v0.2 结构重写，39 项断言。
+
+### 顺带
+
+- `client.js` 里的 `VERSION` 之前停在 `0.2.0` 没跟版，现与 `package.json` 对齐，并加了一条探针断言 —— 以后再脱节会直接失败。
+- 全部探针回归：**122 项全绿**（正则 39 / 宿主 apply 21 / 端到端 17 / 客户端物化 13 / 裸文件名 10 / 首批靶子 22）。
+
+---
+
+## 0.2.5 — 2026-10-28 · 首个 npm 发布
+
+### 修掉的三个真 bug
+
+| 现象 | 根因 | 修法 |
+|---|---|---|
+| 「季度报告 最终版.pdf」这类带空格的名字点了没反应 | 正则中间段把空白当分隔符，只匹配到末尾的「最终版.pdf」，拿去解析必然失败 | 中间段只排除换行与中文标点，允许空格；后端再加「从左收缩重试」兜底 |
+| 深目录里的产物扫不到 | workspace 索引扫描有深度与条目预算上限，浅层先占满 | 索引改为按需深扫，预算按层分摊 |
+| 多处同名文件点了跳错 | 遇到重名直接放弃 | 加歧义消解：同目录优先，其次最近修改 |
+
+### 交互定稿
+
+- 命中高亮：Codex 风蓝 `rgba(88,166,255,.13)` + `1px dashed` 虚线
+- 左键 = 资源管理器揭示并选中；右键 = 自建三动作菜单；Ctrl / Shift + 左键 = 系统默认程序打开
+
+---
+
+## 0.2.4 — 2026-10-28
+
+- 修 `reveal` 的日志误报：explorer 收到 `/select` 后转交已运行实例并立即退出、**退出码恒为 1**。旧代码把非零码当失败，日志里全是 `Command failed`，把人骗去查一个不存在的 bug。
+
+## 0.2.3 — 2026-10-27
+
+- 命中高亮从黄色实线改为 **Codex 风蓝 + 虚线**（用户反馈「黄色太丑」，追加「最好是虚线」）。
+
+## 0.2.2 — 2026-10-27
+
+- 内部迭代（未单独发布）：菜单文案与图标风格统一。
+
+## 0.2.1 — 2026-10-27
+
+- 修 `reveal` / `open` 静默失败：`execFile` 传单参数 + `windowsHide: true` 让 explorer 不弹窗；改为 `['/select,"<path>"']` + `windowsVerbatimArguments: true`。
+- 修左键抢事件：`preventDefault` / `stopPropagation` 让宿主的侧边栏预览失效；改为延迟派发并检查 `defaultPrevented`。
+
+---
+
 ## 0.2.0 — 2026-10-27
 
 ### 用户实测反馈驱动的重写

package/README.md

@@ -31,6 +31,20 @@ Two halves, one contract.
 
 The host half closes the loop: even when the model only says `result.h5`, the route layer resolves it against the session workspace, then falls back to a shallow recursive basename search, and returns the real absolute path.
 
+## What it looks like
+
+Hover an artifact name and it picks up a Codex-style blue dashed outline — that is the only visual hint, nothing is rewritten in your transcript:
+
+![Hover highlight](https://raw.githubusercontent.com/loyalchiiina/dsh-artifact-linker/main/docs/hover-highlight.png)
+
+Right click for the three actions:
+
+![Context menu](https://raw.githubusercontent.com/loyalchiiina/dsh-artifact-linker/main/docs/context-menu.png)
+
+"Copy file path" puts the real absolute path on your clipboard:
+
+![Copy path](https://raw.githubusercontent.com/loyalchiiina/dsh-artifact-linker/main/docs/copy-path.png)
+
 ## Interaction
 
 Click behaviour is decided by the modifier key — no menu, no first-time setup:

package/README.zh.md

@@ -25,6 +25,20 @@ DSH 里预览器已经能开图片、代码、pdf、office。但**插件、脚
 
 第 1 条管「模型把路径写对」，第 2 条管「用户点得动」。缺前者，路径经常是猜的、点开是死链；缺后者，路径再对也要人去复制。
 
+## 长什么样
+
+悬停到产物名上，会出现 Codex 风格的蓝色虚线框——这是唯一的视觉提示，正文一个字都不会被改写：
+
+![悬停高亮](https://raw.githubusercontent.com/loyalchiiina/dsh-artifact-linker/main/docs/hover-highlight.png)
+
+右键是三个动作：
+
+![右键菜单](https://raw.githubusercontent.com/loyalchiiina/dsh-artifact-linker/main/docs/context-menu.png)
+
+「复制文件路径」把真实绝对路径放进剪贴板：
+
+![复制路径](https://raw.githubusercontent.com/loyalchiiina/dsh-artifact-linker/main/docs/copy-path.png)
+
 ---
 
 ## 交互

package/lib/client.js

@@ -29,7 +29,7 @@ window.__ModuleLoader__.load({
     var exports = module.exports;
 
     var GUARD = "__dshArtifactLinkerV1";
-    var VERSION = "0.2.0";
+    var VERSION = "0.2.7";
     // 路由前缀必须与宿主的 ROUTE_PREFIX 一致；永远根相对，绝不拼宿主 origin
     var ROUTE = "/dsh-artifact-linker";
 

package/lib/index.js

@@ -396,7 +396,9 @@ function launchPath(abs, action, res) {
         if (err.code === "ENOENT" || err.code === "EACCES") {
           console.log("[dsh-artifact-linker] " + action + " FAILED (cannot spawn " + cmd + "): " + String(err.message || err).split("\n")[0]);
         } else {
-          console.log("[dsh-artifact-linker] " + action + " note: " + cmd + " 退出码 " + (err.code == null ? "非零" : err.code) + "，属 explorer 惯例，窗口已正常弹出");
+          // explorer.EXE hands the request to the already-running instance and exits with 1.
+      // Keep this line ASCII-only: log consumers may decode as ANSI and turn CJK into mojibake.
+      console.log("[dsh-artifact-linker] " + action + " note: " + cmd + " exited with code " + (err.code == null ? "non-zero" : err.code) + " (explorer hands off to the running instance; the window opened normally)");
         }
       } catch (e) { }
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-artifact-linker",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "DSH 产物路径联动器：常驻注入「产物路径铁律」让模型输出完整绝对路径，同时把聊天正文里的文件名/路径渲染成一键可点的产物芯片——左键预览、右键在资源管理器揭示、Ctrl 点击强制系统打开。宿主端提供 /resolve /stat /info 只读回环路由（相对路径与裸文件名三源兜底、批量 stat + TTL 缓存），客户端零侵入、不改 React 节点、不接管 markdown 图片语法。解决「产物要打开得先复制路径再粘到文件管理器」的反复割裂。Zero telemetry; loopback-only routes. / Turn declared artifact paths into one-click chips: resident system-prompt rules force absolute paths, the client half renders file names as clickable chips (preview / reveal in Explorer / open with system app), and the host exposes loopback-only /resolve,/stat,/info routes with bare-filename fallback and cached batch stat.",
   "type": "module",
   "main": "lib/index.js",