dsh-artifact-linker 0.3.7 → 0.3.8

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.3.8 — 2026-10-29
+
+### 修：「在文件夹中显示」有时不给定位
+
+`SelectItem` 一直是能选中的，问题是它**不会把窗口带到最前**。于是结果取决于调用瞬间的窗口状态：该目录没窗口时 Explore 会新建一个、天然在前，看着正常；但如果该目录早已开着窗口（尤其同时开着好几个），选中会落在后台那个窗口上——用户眼前没有反应，观感就是「打开了但没定位」。
+
+实测证据：日志一直写 `reveal selected via shell COM` 成功，而同一目录当时开着 7 个资源管理器窗口，选中确实落在 `hwnd=34688214`，但前台是别的程序；直接 `SetForegroundWindow` 返回 `False`（Windows 前台锁），焦点纹丝不动。
+
+三处改动：
+
+1. **抢焦点**：先 `AttachThreadInput` 到当前前台线程，再 `BringWindowToTop` + `SetForegroundWindow`，最后 detach；窗口最小化时先 `ShowWindow(SW_RESTORE)`。
+2. **校验判据收紧**：原来只看 `SelectedItems().Count >= 1`，窗口里本来就选着别的东西就会假阳性；改为逐项比对**选中的文件名是否等于目标文件**。
+3. **选窗优先前台**：同目录有多个窗口时，优先选「Explore 之前就在前台的那个」，避免把选中扔到用户没在看的窗口。
+
+退出码也随之细化：`0` = 选中且已在前台（用户真看得见），`6` = 选中成功但没抢到前台（可 alt-tab 找到）。
 ## 0.3.7 — 2026-10-29
 
 ### 改：README 主文件改为中文

package/lib/client.js

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

package/lib/index.js

@@ -390,20 +390,55 @@ function psLiteral(s) {
 }
 
 function revealViaShellCom(abs, done) {
+  // 「在文件夹中显示」为什么**有时**失效 —— 完整根因链（2026-10-29 实测）：
+  //
+  //   SelectItem 能把文件选中，但它**不会**把窗口带到最前。于是结果取决于当时的窗口状态：
+  //     · 该目录本来没窗口   → Explore 新建窗口，新窗口天然在前，选中可见  ✅
+  //     · 该目录窗口就在前台 → 选中立即可见                              ✅
+  //     · 该目录窗口在后台   → 选中生效但被别的窗口盖住                  ❌ 看着像没定位
+  //     · 该目录开过多个窗口 → Explore 复用其中一个（未必是用户在看那个）❌ 选在别处
+  //
+  //   实测证据：日志写「reveal selected via shell COM」成功，但同一目录当时开着 7 个窗口，
+  //   选中落在 hwnd=34688214，而前台是微信；直接 SetForegroundWindow 返回 False
+  //   （Windows 前台锁），必须先 AttachThreadInput 到当前前台线程才抢得到焦点。
+  //
+  // 所以这里做三件事：优先选「前台那个窗口」、按「选中的就是目标文件」校验、
+  // 抢焦点并回读确认前台。
   var lines = [
     "$ErrorActionPreference = 'Stop'",
     "$dir = " + psLiteral(dirname(abs)),
     "$nm = " + psLiteral(basename(abs)),
+    "$sig = '[DllImport(\"user32.dll\")] public static extern bool SetForegroundWindow(IntPtr h);' + " +
+      "'[DllImport(\"user32.dll\")] public static extern IntPtr GetForegroundWindow();' + " +
+      "'[DllImport(\"user32.dll\")] public static extern bool IsIconic(IntPtr h);' + " +
+      "'[DllImport(\"user32.dll\")] public static extern bool ShowWindow(IntPtr h, int n);' + " +
+      "'[DllImport(\"user32.dll\")] public static extern bool BringWindowToTop(IntPtr h);' + " +
+      "'[DllImport(\"user32.dll\")] public static extern uint GetWindowThreadProcessId(IntPtr h, out uint pid);' + " +
+      "'[DllImport(\"user32.dll\")] public static extern bool AttachThreadInput(uint a, uint b, bool f);' + " +
+      "'[DllImport(\"kernel32.dll\")] public static extern uint GetCurrentThreadId();'",
+    "try { Add-Type -MemberDefinition $sig -Name U -Namespace RevealWin -ErrorAction Stop } catch { }",
+    // 记住 Explore 之前谁在前台 —— 若它本来就是目标目录，就别把用户从别的窗口里拽走。
+    "$fgBefore = [IntPtr]::Zero",
+    "try { $fgBefore = [RevealWin.U]::GetForegroundWindow() } catch { }",
     "$sh = New-Object -ComObject Shell.Application",
     // Explore 是唯一能可靠「把窗口摆到用户眼前」的入口。
-    // SHOpenFolderAndSelectItems 能选中却不弹窗（它复用已有窗口，没有就什么都不显示），
-    // 所以开窗这一步必须交给 Explore，选中的事再交给 SelectItem。
+    // SHOpenFolderAndSelectItems 能选中却不弹窗（复用已有窗口，没有就什么都不显示），
+    // 所以开窗这一步交给 Explore，选中的事交给 SelectItem。
     "$sh.Explore($dir)",
+    // 选窗策略：先挑「前台那个且目录匹配」的；没有就挑任一目录匹配的。
     "$w = $null",
+    "$wFg = $null",
     "for ($i = 0; $i -lt 60; $i++) {",
+    "  $w = $null; $wFg = $null",
     "  foreach ($x in @($sh.Windows())) {",
-    "    try { if ($x.Document.Folder.Self.Path -eq $dir) { $w = $x; break } } catch { }",
+    "    try {",
+    "      if ($x.Document.Folder.Self.Path -eq $dir) {",
+    "        if (-not $w) { $w = $x }",
+    "        if ([IntPtr]$x.HWND -eq $fgBefore) { $wFg = $x; break }",
+    "      }",
+    "    } catch { }",
     "  }",
+    "  if ($wFg) { $w = $wFg; break }",
     "  if ($w) { break }",
     "  Start-Sleep -Milliseconds 100",
     "}",
@@ -418,13 +453,40 @@ function revealViaShellCom(abs, done) {
     "if (-not $it) { exit 3 }",
     // 29 = SVSI_SELECT(1) | SVSI_DESELECTOTHERS(4) | SVSI_ENSUREVISIBLE(8) | SVSI_FOCUSED(16)。
     // 旧代码只传 1，在某些窗口状态下静默无效；带上 ENS|FOCUSED 才保证滚到可视区并高亮。
-    // 循环校验 SelectedItems()，选中了才 exit 0 —— 不靠「脚本没报错」自欺。
+    "$okName = $false",
     "for ($i = 0; $i -lt 25; $i++) {",
     "  $w.Document.SelectItem($it, 29)",
     "  Start-Sleep -Milliseconds 120",
-    "  if (@($w.Document.SelectedItems()).Count -ge 1) { exit 0 }",
+    // 判据必须是「选中的就是目标文件」，不能只看 SelectedItems() 有没有值 ——
+    // 窗口里本来就选着别的东西时，旧的判据会假阳性（真实事故）。
+    "  $okName = $false",
+    "  foreach ($s in @($w.Document.SelectedItems())) { if ($s.Name -eq $nm) { $okName = $true; break } }",
+    "  if ($okName) { break }",
     "}",
-    "exit 4",
+    "if (-not $okName) { exit 4 }",
+    // ── 抢焦点 ────────────────────────────────────────────────────────────
+    // 直接 SetForegroundWindow 会被前台锁拒绝（返回 False，焦点纹丝不动），
+    // 必须先 AttachThreadInput 到当前前台线程，共享输入队列后才能改前台。
+    "$h = [IntPtr]$w.HWND",
+    "$fgOk = $false",
+    "try {",
+    "  if ([RevealWin.U]::IsIconic($h)) { [void][RevealWin.U]::ShowWindow($h, 9) }",
+    "  $fg = [RevealWin.U]::GetForegroundWindow()",
+    "  if ($fg -ne $h) {",
+    "    $fgPid = 0",
+    "    $fgT = [RevealWin.U]::GetWindowThreadProcessId($fg, [ref]$fgPid)",
+    "    $me = [RevealWin.U]::GetCurrentThreadId()",
+    "    if ($fgT -ne 0 -and $fgT -ne $me) { [void][RevealWin.U]::AttachThreadInput($me, $fgT, $true) }",
+    "    [void][RevealWin.U]::BringWindowToTop($h)",
+    "    [void][RevealWin.U]::SetForegroundWindow($h)",
+    "    if ($fgT -ne 0 -and $fgT -ne $me) { [void][RevealWin.U]::AttachThreadInput($me, $fgT, $false) }",
+    "  }",
+    "  Start-Sleep -Milliseconds 150",
+    "  $fgOk = ([RevealWin.U]::GetForegroundWindow() -eq $h)",
+    "} catch { }",
+    // exit 0 = 选中且已在前台（用户确实看得见）；exit 6 = 选中了但没抢到前台（仍可用 alt-tab 找到）。
+    "if ($fgOk) { exit 0 }",
+    "exit 6",
   ];
   runPwshEncoded(lines, { timeout: 30000 }, done);
 }
@@ -542,12 +604,19 @@ function launchPath(abs, action, res) {
   // Windows 的 reveal 走 Shell COM，不经过 explorer 命令行（原因见 revealViaShellCom 上方注释）
   if (process.platform === "win32" && action === "reveal") {
     revealViaShellCom(abs, function (err) {
+      var code = err && err.code != null ? Number(err.code) : (err ? null : 0);
       if (!err) {
-        try { console.log("[dsh-artifact-linker] reveal selected via shell COM -> " + abs); } catch (e) { }
+        try { console.log("[dsh-artifact-linker] reveal selected & focused (exit 0) -> " + abs); } catch (e) { }
+        return;
+      }
+      // exit 6 = 选中成功但没抢到前台（窗口仍被别的程序盖着）。此时**不要**再降级开一次文件夹，
+      // 否则会多开一个窗口，反而更乱；只要如实记下来，让用户能 alt-tab 找到。
+      if (code === 6) {
+        try { console.log("[dsh-artifact-linker] reveal selected but window stayed in background (exit 6, foreground lock) -> " + abs); } catch (e) { }
         return;
       }
-      // 降级：COM 没成时至少把父目录打开，避免「完全没反应」
-      try { console.log("[dsh-artifact-linker] reveal COM failed (" + (err.code == null ? "exit-or-timeout" : err.code) + "); falling back to opening the folder"); } catch (e) { }
+      // 其余失败：至少把父目录打开，避免「完全没反应」
+      try { console.log("[dsh-artifact-linker] reveal COM failed (exit " + (code == null ? "unknown" : code) + "); falling back to opening the folder -> " + abs); } catch (e) { }
       var fb = execFile("explorer.exe", [isDir ? abs : dirname(abs)], {}, function () { });
       if (fb && typeof fb.unref === "function") fb.unref();
     });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "dsh-artifact-linker",
-    "version":  "0.3.7",
+    "version": "0.3.8",
     "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",