@yfwu2020/dsh-selection-explain 0.10.2 → 0.10.4

package/README.md

@@ -8,7 +8,7 @@ DSH 中的翻译、上下文解读与语音追问。
 
 [快速安装](#install) · [语音输入](#voice) · [功能一览](#read) · [使用与设置](#settings)
 
-`DSH 插件` · `v0.10.2` · `MIT`
+`DSH 插件` · `v0.10.3` · `MIT`
 
 </div>
 
@@ -103,11 +103,11 @@ dsh plugin --profile web add @yfwu2020/dsh-selection-explain
 <details>
 <summary>安装 Release 构建包</summary>
 
-将下载的 `.tgz` 放到当前目录，以 v0.10.2 为例：
+将下载的 `.tgz` 放到当前目录，以 v0.10.3 为例：
 
 ```bash
 mkdir -p ~/.dsh/plugins/dsh-selection-explain
-tar -xzf yfwu2020-dsh-selection-explain-0.10.2.tgz -C ~/.dsh/plugins/dsh-selection-explain --strip-components=1
+tar -xzf yfwu2020-dsh-selection-explain-0.10.3.tgz -C ~/.dsh/plugins/dsh-selection-explain --strip-components=1
 dsh plugin --profile web add ~/.dsh/plugins/dsh-selection-explain
 ```
 
@@ -159,6 +159,10 @@ dsh plugin --profile web remove @yfwu2020/dsh-selection-explain
 
 聊天与解读可以同时打开。与 `dsh-full-view` **0.1.6**、`dsh-recent-sessions` **0.2.3** 配合时，`Esc` 先退出最后操作的小窗；点击两窗之外后先退解读，再按一次收起聊天。此次调整需一起更新两个插件，未改变 Harness 的公共浮层或设置。
 
+### 快捷键与 Esc 层级（0.10.3）
+
+模型菜单收起后不再被 DSH 识别为弹层，避免设置等快捷键失效。官方设置等模态浮层打开时，`Esc` 优先交给官方浮层处理，保留解读小窗、插件设置抽屉、模型菜单和语音卡；官方浮层关闭后，再按 `Esc` 继续退出插件层级。
+
 ## 数据与使用范围
 
 选中文字、必要的前后文，以及开启的会话背景会交给你配置的模型。可在设置中关闭会话背景或工具调用。

package/lib/client.js

@@ -2648,7 +2648,7 @@ window.__ModuleLoader__.load({
       modelPill.appendChild(modelPillTier)
       modelPill.appendChild(el('span', 'dsh-sel-picker-caret', '▼'))
       var modelMenu = el('div', 'dsh-sel-pickermenu')
-      modelMenu.setAttribute('role', 'menu')
+      // role 随开合同步：DSH 按 [role="menu"] 判定弹层，不检查 CSS 可见性。
 
       // ── 录音行（与主会话 ui-voice-input 同一套结构）──
       //   [✕ 取消] [实时波形 / 状态文案] [■ 停止 或 行内动作] …… [↑ 发送（原位不动）]
@@ -9484,6 +9484,7 @@ window.__ModuleLoader__.load({
        */
       var offVoiceEscape = listen(document, 'keydown', function (event) {
         if (event.key !== 'Escape' || !vcardState.open || event.defaultPrevented) return
+        if (document.querySelector('[role="dialog"][aria-modal="true"]')) return
         event.preventDefault()
         event.stopPropagation()
         vcardState.suppress = true
@@ -9936,11 +9937,13 @@ window.__ModuleLoader__.load({
 
       function closeModelMenu() {
         modelMenu.setAttribute('data-open', '0')
+        modelMenu.removeAttribute('role')
         modelPill.setAttribute('aria-expanded', 'false')
       }
 
       function openModelMenu() {
         modelMenu.setAttribute('data-open', '1')
+        modelMenu.setAttribute('role', 'menu')
         modelPill.setAttribute('aria-expanded', 'true')
         renderModelMenu()
         loadModelCatalog(false).then(function () {
@@ -9962,7 +9965,7 @@ window.__ModuleLoader__.load({
         event.stopPropagation() // 菜单内部点击不要触发"点到外面"
       })
       var offModelKeys = listen(modelMenu, 'keydown', function (event) {
-        if (event.key === 'Escape') closeModelMenu()
+        if (event.key === 'Escape' && !document.querySelector('[role="dialog"][aria-modal="true"]')) closeModelMenu()
       })
 
       // —— 网页模式开关 ——
@@ -10140,6 +10143,9 @@ window.__ModuleLoader__.load({
 
       var offKeyDown = listen(document, 'keydown', function (event) {
         if (event.key !== 'Escape' || !panelOpen || event.defaultPrevented || event.isComposing || event.keyCode === 229) return
+        // 官方模态浮层的 Esc 在冒泡阶段处理；capture 不消费，先让官方设置等浮层退出。
+        // 插件面板和设置抽屉是非模态 dialog，不带 aria-modal，不会命中这里。
+        if (document.querySelector('[role="dialog"][aria-modal="true"]')) return
         // 完整视图记录最后点击/操作的小窗；不能只看可能停在另一窗的键盘焦点。
         var fullViewFrame = document.querySelector('[data-dsh-full-view]')
         if (fullViewFrame) {

package/lib/index.js

@@ -12,8 +12,8 @@
  */
 import { createHash } from 'node:crypto';
 import { lookup } from 'node:dns/promises';
-import { spawn } from 'node:child_process';
-import { existsSync } from 'node:fs';
+import { spawn, spawnSync } from 'node:child_process';
+import { chmodSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
 import { mkdir, readFile, stat, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join, resolve, sep } from 'node:path';
@@ -89,8 +89,81 @@ const MIC_IDLE_CHECK_MS = Number(process.env.DSH_SEL_MIC_CHECK_MS || 5000);
  * 原生探针会把区间夹在 50~5000ms 之间（见 native/mic-probe.c）。
  */
 const MIC_WATCH_MS = Number(process.env.DSH_SEL_MIC_WATCH_MS || 125);
-/** 探针路径：lib/native/mic-probe（与编译产物 lib/index.js 同级；测试可注入假的）。 */
-const MIC_PROBE = process.env.DSH_SEL_MIC_PROBE || fileURLToPath(new URL('native/mic-probe', import.meta.url));
+/** 探针二进制：随包构建出来的那个（与编译产物 lib/index.js 同级；测试可注入假的）。 */
+const MIC_PROBE = fileURLToPath(new URL('native/mic-probe', import.meta.url));
+/** 探针源码：发布包里**一定有它**（`files` 含 native/），二进制则不一定（见下）。 */
+const MIC_PROBE_SRC = fileURLToPath(new URL('../native/mic-probe.c', import.meta.url));
+/** 解析结果缓存：'' = 解析过了但没有可用探针（reason 说明为什么）。 */
+let micProbeResolved = null;
+let micProbeReason = '';
+/** 插件自己的数据目录（历史 / 记忆 / 就地编译出来的探针都放这儿）。 */
+function pluginDataDir() {
+    return join(process.env.DSH_HOME ?? join(homedir(), '.dsh'), 'selection-explain');
+}
+/**
+ * 找到探针二进制 —— 找不到就**现场编一份**。
+ *
+ * 为什么必须运行时编译：CI 跑在 ubuntu 上，`build.sh` 里的原生探针那一步会被跳过
+ * （日志原话："跳过原生探针（非 macOS 或没有 clang）"），于是 npm / Release 装下来的包里
+ * **只有 `native/mic-probe.c` 源码、没有 `lib/native/mic-probe`** —— macOS 用户装上就是
+ * `probe-missing`，豆包开麦永远不弹卡（2026-10-11 用户在另一台 Mac 上实测到的就是这个）。
+ *
+ * 顺序：环境变量覆盖（测试用）→ 随包构建的 → 数据目录里按**源码 hash** 缓存的那份
+ * （没有就 clang 编一次；源码改了就自然重建）→ 都没有则如实报原因。
+ * 编译失败不算致命：其余功能一律不受影响（和"没装识别服务"一个待遇）。
+ */
+function resolveMicProbe() {
+    if (micProbeResolved !== null)
+        return micProbeResolved;
+    const override = process.env.DSH_SEL_MIC_PROBE;
+    if (override) {
+        micProbeResolved = existsSync(override) ? override : '';
+        if (!micProbeResolved)
+            micProbeReason = 'probe-missing';
+        return micProbeResolved;
+    }
+    if (existsSync(MIC_PROBE)) {
+        micProbeResolved = MIC_PROBE;
+        return micProbeResolved;
+    }
+    if (!existsSync(MIC_PROBE_SRC)) {
+        micProbeResolved = '';
+        micProbeReason = 'probe-missing';
+        return micProbeResolved;
+    }
+    let tag = 'v1';
+    try {
+        tag = createHash('sha1').update(readFileSync(MIC_PROBE_SRC)).digest('hex').slice(0, 8);
+    }
+    catch {
+        /* 读不了源码就按固定名缓存 */
+    }
+    const built = join(pluginDataDir(), `mic-probe-${tag}`);
+    if (existsSync(built)) {
+        micProbeResolved = built;
+        return micProbeResolved;
+    }
+    try {
+        mkdirSync(pluginDataDir(), { recursive: true });
+        const result = spawnSync('clang', ['-O2', '-framework', 'CoreAudio', '-framework', 'CoreFoundation', MIC_PROBE_SRC, '-o', built], { timeout: 60_000 });
+        if (result.status === 0 && existsSync(built)) {
+            try {
+                chmodSync(built, 0o755);
+            }
+            catch {
+                /* 权限位设不上也还能试跑 */
+            }
+            micProbeResolved = built;
+            return micProbeResolved;
+        }
+    }
+    catch {
+        /* 下面统一给失败原因 */
+    }
+    micProbeResolved = '';
+    micProbeReason = 'probe-build-failed';
+    return micProbeResolved;
+}
 /**
  * 懒启动探针（第一次有人来问才 spawn）。
  *
@@ -106,12 +179,13 @@ function ensureMicProbe() {
         micState.reason = 'not-macos';
         return;
     }
-    if (!existsSync(MIC_PROBE)) {
-        micState.reason = 'probe-missing';
+    const probe = resolveMicProbe();
+    if (!probe) {
+        micState.reason = micProbeReason || 'probe-missing';
         return;
     }
     try {
-        const child = spawn(MIC_PROBE, ['--watch', String(MIC_WATCH_MS)], {
+        const child = spawn(probe, ['--watch', String(MIC_WATCH_MS)], {
             stdio: ['ignore', 'pipe', 'ignore'],
         });
         micChild = child;