@yfwu2020/dsh-selection-explain 0.10.2 → 0.10.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yfwu2020/dsh-selection-explain",
-  "version": "0.10.2",
+  "version": "0.10.4",
   "description": "DSH 划词解读：选中文字浮出按钮，点击弹窗流式显示专业中英翻译 + 该文字在当前上下文中的含义详解",
   "type": "module",
   "main": "./lib/index.js",
@@ -43,7 +43,7 @@
   "scripts": {
     "build": "bash scripts/build.sh",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "node scripts/test-filters.mjs && node scripts/test-prompt.mjs && node scripts/test-model-follow.mjs && node scripts/test-bridge.mjs && node scripts/smoke-bridge.mjs && node scripts/smoke-panel.mjs && node scripts/test-escape-focus.mjs && node scripts/test-effort-retry.mjs && node scripts/test-effort-map.mjs && node scripts/test-client.mjs && node scripts/test-settings-host.mjs && node scripts/test-settings-behavior.mjs && node scripts/test-route-cache.mjs && node scripts/test-transcript.mjs && node scripts/test-guard.mjs && node scripts/test-settings.mjs && node scripts/test-format.mjs && node scripts/test-speech.mjs && node scripts/test-mic-idle.mjs && node scripts/smoke-voice.mjs",
+    "test": "node scripts/test-filters.mjs && node scripts/test-prompt.mjs && node scripts/test-model-follow.mjs && node scripts/test-bridge.mjs && node scripts/smoke-bridge.mjs && node scripts/smoke-panel.mjs && node scripts/test-escape-focus.mjs && node scripts/test-effort-retry.mjs && node scripts/test-effort-map.mjs && node scripts/test-client.mjs && node scripts/test-settings-host.mjs && node scripts/test-settings-behavior.mjs && node scripts/test-route-cache.mjs && node scripts/test-transcript.mjs && node scripts/test-guard.mjs && node scripts/test-settings.mjs && node scripts/test-format.mjs && node scripts/test-speech.mjs && node scripts/test-mic-idle.mjs && node scripts/test-mic-build.mjs && node scripts/smoke-voice.mjs",
     "test:effort": "node scripts/test-effort-retry.mjs",
     "test:effort-map": "node scripts/test-effort-map.mjs",
     "test:transcript": "node scripts/test-transcript.mjs",

package/scripts/smoke-panel.mjs

@@ -1504,8 +1504,57 @@ async function main() {
     hook.open('模型菜单勾选', '', '菜单冒烟')
     await waitFor(function () { return hook.state().phase === 'done' }, 8000)
     await hook.loadModels(true)
+    var modelNodes = hook.modelNodes()
+    // DSH 按属性判定弹层，不检查 CSS 可见性（Issue #1）。
+    var modalSelector = '[role="dialog"][aria-modal="true"], [role="menu"]'
+    function modelMenuOwnsShortcuts() {
+      return Array.from(document.querySelectorAll(modalSelector)).includes(modelNodes.menu)
+    }
+    function checkModelMenuClosed(reason) {
+      check(reason + '：模型菜单不再占用 DSH 快捷键',
+        !modelMenuOwnsShortcuts() && modelNodes.menu.getAttribute('data-open') !== '1' &&
+          modelNodes.pill.getAttribute('aria-expanded') === 'false')
+    }
+    checkModelMenuClosed('初始收起')
+    // 官方 useModalLayer 在 document 冒泡阶段处理 Esc；插件 capture 必须让行。
+    function checkHostEscapeFirst(target, label) {
+      var hostSettings = document.createElement('div')
+      hostSettings.setAttribute('role', 'dialog')
+      hostSettings.setAttribute('aria-modal', 'true')
+      hostSettings.setAttribute('data-shortcut-modal', 'settings')
+      var hostInput = document.createElement('input')
+      hostSettings.appendChild(hostInput)
+      document.body.appendChild(hostSettings)
+      function dismissHost(event) {
+        if (event.key !== 'Escape' || event.defaultPrevented) return
+        event.preventDefault()
+        hostSettings.remove()
+      }
+      document.addEventListener('keydown', dismissHost)
+      try {
+        var event = new KeyboardEvent('keydown', { key: 'Escape', bubbles: true, cancelable: true })
+        ;(target || hostInput).dispatchEvent(event)
+        check(label + '：Esc 到达官方浮层并只关闭官方设置',
+          event.defaultPrevented && !hostSettings.isConnected && panel.style.display === 'flex')
+      } finally {
+        document.removeEventListener('keydown', dismissHost)
+        hostSettings.remove()
+      }
+    }
+    var escapeModeFrame = document.createElement('div')
+    escapeModeFrame.setAttribute('data-dsh-full-view', '')
+    escapeModeFrame.setAttribute('data-dsh-active-floating-window', 'explanation')
+    for (var fullViewMode of [false, true]) {
+      if (fullViewMode) document.body.appendChild(escapeModeFrame)
+      var modeLabel = fullViewMode ? '完整视图' : '普通分栏'
+      checkHostEscapeFirst(null, modeLabel + '／焦点在官方设置')
+      checkHostEscapeFirst(document.querySelector('.dsh-sel-askbox'), modeLabel + '／焦点仍在解读输入框')
+    }
+    escapeModeFrame.remove()
     hook.openModel()
     await sleep(120)
+    check('模型菜单展开时占用 DSH 快捷键',
+      modelMenuOwnsShortcuts() && modelNodes.pill.getAttribute('aria-expanded') === 'true')
     var menu = hook.modelNodes().menu
     var rows = Array.prototype.slice.call(menu.querySelectorAll('.dsh-sel-pickerrow'))
     check('模型菜单列出 3 个模型（含同名 id 的另一 provider）', rows.length === 3, String(rows.length))
@@ -1529,7 +1578,24 @@ async function main() {
     var rowBox = onRows[0] ? onRows[0].getBoundingClientRect() : null
     check('打勾那一行仍是单行（高度不超过 30px，没折成两行）',
       !!rowBox && rowBox.height <= 30, rowBox ? Math.round(rowBox.height) + 'px' : '没找到那一行')
+
+    checkHostEscapeFirst(modelNodes.menu, '模型菜单仍展开')
+    check('官方设置关闭时保留插件模型菜单', modelNodes.menu.getAttribute('data-open') === '1')
+
+    clickOn(modelNodes.pill)
+    checkModelMenuClosed('再次点击胶囊')
+    hook.openModel()
+    modelNodes.menu.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape', bubbles: true }))
+    checkModelMenuClosed('按 Esc')
+    hook.openModel()
+    document.getElementById('docp').dispatchEvent(new MouseEvent('mousedown', { bubbles: true }))
+    checkModelMenuClosed('点击菜单外部')
+    hook.openModel()
+    clickOn(modelNodes.menu.querySelector('.dsh-sel-pickerrow'))
+    checkModelMenuClosed('选择模型')
+    hook.openModel()
     hook.close() // 关窗会顺手收起模型菜单
+    checkModelMenuClosed('关闭解读面板')
     await sleep(30)
   }
 

package/scripts/test-escape-focus.mjs

@@ -7,12 +7,14 @@ const start = source.indexOf('      var offKeyDown = listen(document,')
 const end = source.indexOf('\n\n      var offSettingsOpen', start)
 assert.ok(start >= 0 && end > start)
 const ask = {}, historyInput = {}, outside = {}, expandedChat = { closest: selector => selector.startsWith('[data-dsh-floating-chat]') ? {} : null }, compactChat = { closest: () => null }, nativeMenu = { closest: selector => selector.startsWith('[role=') ? {} : null }
-let handler, fullView = true, calls = [], activeWindow = null, chatExpanded = true
+let handler, fullView = true, calls = [], activeWindow = null, chatExpanded = true, hostModalOpen = false
 const context = vm.createContext({
   panelOpen: true, settingsOpen: false,
   panel: { contains: node => node === ask },
   historyList: { contains: node => node === historyInput },
-  document: { querySelector: selector => selector === '[data-dsh-full-view]' && fullView
+  document: { querySelector: selector => selector === '[role="dialog"][aria-modal="true"]'
+    ? hostModalOpen ? {} : null
+    : selector === '[data-dsh-full-view]' && fullView
     ? { getAttribute: () => activeWindow }
     : selector.startsWith('[data-dsh-floating-chat]') && chatExpanded ? {} : null },
   listen(target, type, callback, capture) { assert.equal(type, 'keydown'); assert.equal(capture, true); handler = callback },
@@ -27,7 +29,22 @@ function escape(target, extra = {}) {
   const event = { key: 'Escape', target, ...extra, preventDefault() { calls.push('prevent') }, stopPropagation() { calls.push('stop') } }
   handler(event)
 }
-function reset() { calls = []; activeWindow = null; chatExpanded = true; context.panelOpen = true; context.settingsOpen = false; context.settingsByKey = {}; context.captureRow.getAttribute = () => '0' }
+function reset() { calls = []; activeWindow = null; chatExpanded = true; hostModalOpen = false; context.panelOpen = true; context.settingsOpen = false; context.settingsByKey = {}; context.captureRow.getAttribute = () => '0' }
+for (const mode of [true, false]) {
+  for (const target of [ask, historyInput, outside, expandedChat]) {
+    reset(); fullView = mode; hostModalOpen = true; activeWindow = 'explanation'
+    escape(target)
+    assert.deepEqual(calls, [], '官方模态设置浮层优先消费 Esc，不受视图模式、焦点或最后操作窗口影响')
+    assert.equal(context.panelOpen, true)
+  }
+}
+reset(); fullView = true; hostModalOpen = true; context.settingsOpen = true; escape(ask)
+assert.deepEqual(calls, [], '官方设置打开时不关闭插件设置抽屉')
+assert.equal(context.settingsOpen, true)
+reset(); hostModalOpen = true; context.captureRow.getAttribute = () => '1'; escape(ask)
+assert.deepEqual(calls, [], '官方设置打开时不取消插件录音')
+hostModalOpen = false; escape(ask)
+assert.deepEqual(calls, ['prevent', 'stop', 'voice'], '官方设置退出后，下一次 Esc 恢复插件的内层退出顺序')
 reset(); activeWindow = 'chat'; escape(ask)
 assert.deepEqual(calls, [], '最后点击聊天后，即使键盘仍在解读输入框，也让聊天先退出')
 reset(); activeWindow = 'explanation'; escape(expandedChat)
@@ -63,4 +80,22 @@ for (const target of [ask, historyInput]) {
 }
 reset(); fullView = false; escape(outside)
 assert.equal(context.panelOpen, false, '普通分栏保留解读原来的全局 Esc 行为')
-console.log('PASS focused Esc: independent windows, IME, nested settings, voice, history and split-mode behavior')
+
+// 语音卡另有一个更早注册的 capture 监听，也必须给官方浮层让出 Esc。
+const panelHandler = handler
+const voiceStart = source.indexOf('      var offVoiceEscape = listen(document,')
+const voiceEnd = source.indexOf('\n      }, true)', voiceStart) + '\n      }, true)'.length
+assert.ok(voiceStart >= 0 && voiceEnd > voiceStart)
+context.vcardState = { open: true, suppress: false }
+context.closeVCard = () => { calls.push('vcard'); context.vcardState.open = false }
+new vm.Script(source.slice(voiceStart, voiceEnd)).runInContext(context)
+const voiceHandler = handler
+handler = panelHandler
+reset(); hostModalOpen = true
+voiceHandler({ key: 'Escape', preventDefault() { calls.push('prevent') }, stopPropagation() { calls.push('stop') } })
+assert.deepEqual(calls, [], '官方设置打开时，语音卡不抢先消费 Esc')
+assert.equal(context.vcardState.open, true)
+hostModalOpen = false
+voiceHandler({ key: 'Escape', preventDefault() { calls.push('prevent') }, stopPropagation() { calls.push('stop') } })
+assert.deepEqual(calls, ['prevent', 'stop', 'vcard'], '官方设置退出后，Esc 可以关闭语音卡')
+console.log('PASS focused Esc: host modals, independent windows, IME, nested settings, voice, history and split-mode behavior')

package/scripts/test-mic-build.mjs

@@ -0,0 +1,146 @@
+/**
+ * 「就地编译探针」：npm / Release 装下来的包里**没有** `lib/native/mic-probe`
+ * —— CI 跑在 ubuntu 上，`build.sh` 里那一步会被跳过（日志原话：
+ * "跳过原生探针（非 macOS 或没有 clang）"），所以包里只有 `native/mic-probe.c` 源码。
+ *
+ * 后果（2026-10-11 用户实测）：从 npm 装到别的 Mac 上，豆包开麦永远不弹卡 ——
+ * host 直接报 `probe-missing`。修法是第一次有人问麦克风时**用 clang 现场编一份**，
+ * 按源码 hash 缓存进数据目录。
+ *
+ * 这条用例就复现"装包的机器"：把随包的二进制**暂时挪开**、数据目录指向一个全新的
+ * DSH_HOME，然后问一次 /mic —— 应该 available:true，而且编出来的二进制真能跑（--once）。
+ *
+ * 只在 macOS + 有 clang 时有意义；其它平台 SKIP（与真浏览器冒烟同一套约定：跑不了就跳过）。
+ *
+ * 用法：node scripts/test-mic-build.mjs
+ */
+import { createServer } from 'node:http'
+import { existsSync } from 'node:fs'
+import { mkdtemp, readdir, rename, rm } from 'node:fs/promises'
+import { spawnSync } from 'node:child_process'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+if (process.platform !== 'darwin' || spawnSync('clang', ['--version']).status !== 0) {
+  console.log('SKIP  就地编译探针是 macOS 专用（且需要 clang）—— 本机跳过')
+  process.exit(0)
+}
+
+const root = fileURLToPath(new URL('..', import.meta.url))
+const packaged = join(root, 'lib/native/mic-probe')
+const stash = packaged + '.probe-build-test'
+const home = await mkdtemp(join(tmpdir(), 'dsh-mic-build-'))
+// 数据目录与"注入了假探针"那条路都要避开：前者要全新，后者要显式删除（否则测不到编译）
+process.env.DSH_HOME = home
+delete process.env.DSH_SEL_MIC_PROBE
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+let passed = 0
+let failed = 0
+function check(label, ok, detail) {
+  if (ok) {
+    passed += 1
+    console.log(`PASS  ${label}${detail ? ' — ' + detail : ''}`)
+  } else {
+    failed += 1
+    console.log(`FAIL  ${label}${detail ? ' — ' + detail : ''}`)
+  }
+}
+
+let moved = false
+if (existsSync(packaged)) {
+  await rename(packaged, stash)
+  moved = true
+}
+
+const routes = new Map()
+const disposers = []
+const ctx = {
+  llm: { listProviders: () => [] },
+  get: () => undefined,
+  on: () => () => {},
+  effect: (fn) => {
+    const dispose = fn()
+    disposers.push(dispose)
+    return dispose
+  },
+  logger: { info() {}, warn() {} },
+  webServer: {
+    register: (route) => {
+      routes.set(route.path, route.handler)
+      return () => routes.delete(route.path)
+    },
+  },
+}
+
+try {
+  // ⚠️ 必须在"挪开二进制"之后才 import：探针路径是在模块求值时算的
+  const { apply } = await import('../lib/index.js')
+  apply(ctx, {})
+  const server = createServer((req, res) => {
+    const handler = routes.get(new URL(req.url, 'http://localhost').pathname)
+    if (!handler) {
+      res.writeHead(404)
+      res.end()
+      return
+    }
+    Promise.resolve(handler(req, res)).catch(() => {
+      if (!res.headersSent) res.writeHead(500)
+      res.end()
+    })
+  })
+  await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve))
+  const origin = 'http://127.0.0.1:' + server.address().port
+  const dataDir = join(home, 'selection-explain')
+
+  check('（前提）装包的样子：随包的二进制不在，只剩源码', !existsSync(packaged) && existsSync(join(root, 'native/mic-probe.c')), '')
+
+  const payload = await (await fetch(`${origin}/selection-explain/api/mic`)).json()
+  check(
+    '装包的机器上第一次问麦克风 → 就地编出来，状态是 available（不再 probe-missing）',
+    payload.ok === true && payload.available === true && payload.reason === '',
+    JSON.stringify({ available: payload.available, reason: payload.reason }),
+  )
+
+  const files = existsSync(dataDir) ? await readdir(dataDir) : []
+  const compiled = files.filter((f) => /^mic-probe-[0-9a-f]{8}$/.test(f))
+  check(
+    '编出来的探针按源码 hash 缓存进数据目录（源码改了会自然重建）',
+    compiled.length === 1,
+    JSON.stringify(files),
+  )
+
+  if (compiled.length === 1) {
+    const run = spawnSync(join(dataDir, compiled[0]), ['--once'], { encoding: 'utf8', timeout: 20_000 })
+    let parsed = null
+    try {
+      parsed = JSON.parse(String(run.stdout || '').trim().split('\n').pop() || 'null')
+    } catch {
+      /* 保持 null */
+    }
+    check(
+      '编出来的二进制真能跑（--once 输出一行合法 JSON）',
+      run.status === 0 && !!parsed && typeof parsed.capturing === 'boolean',
+      JSON.stringify({ status: run.status, stdout: String(run.stdout || '').trim().slice(0, 80) }),
+    )
+  } else {
+    check('编出来的二进制真能跑（--once 输出一行合法 JSON）', false, '没有找到编出来的探针')
+  }
+
+  server.close()
+} finally {
+  for (const dispose of disposers) {
+    try {
+      dispose()
+    } catch {
+      /* 忽略 */
+    }
+  }
+  await sleep(300)
+  if (moved) await rename(stash, packaged)
+  await rm(home, { recursive: true, force: true })
+}
+
+console.log(`\n探针就地编译：${passed} 通过 / ${failed} 失败`)
+process.exit(failed ? 1 : 0)

package/src/client/index.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/src/index.ts

@@ -12,9 +12,9 @@
  */
 import { createHash } from 'node:crypto'
 import { lookup } from 'node:dns/promises'
-import { spawn } from 'node:child_process'
+import { spawn, spawnSync } from 'node:child_process'
 import type { ChildProcess } from 'node:child_process'
-import { existsSync } from 'node:fs'
+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'
@@ -133,9 +133,83 @@ const MIC_IDLE_CHECK_MS = Number(process.env.DSH_SEL_MIC_CHECK_MS || 5000)
  */
 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: string | null = null
+let micProbeReason = ''
+
+/** 插件自己的数据目录（历史 / 记忆 / 就地编译出来的探针都放这儿）。 */
+function pluginDataDir(): string {
+  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(): string {
+  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）。
@@ -151,12 +225,13 @@ function ensureMicProbe(): void {
     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