@yfwu2020/dsh-selection-explain 0.10.4 → 0.10.6

package/scripts/test-mic-build.mjs

@@ -1,146 +0,0 @@
-/**
- * 「就地编译探针」：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/scripts/test-mic-idle.mjs

@@ -1,158 +0,0 @@
-/**
- * 麦克风探针的生命周期：划词即启动 → 没人看就停 → 再划词再启动。
- *
- * 为什么单测它：探针是个常驻原生进程（每秒读 4 次 CoreAudio），原来一旦启动就留到插件卸载 ——
- * 而插件装着的绝大多数时间没人划词，等于白跑。现在跟着页面的轮询走：
- * 页面只在"有选区 / 卡片开着"时轮询，探针也就只在那时活着。
- *
- * 验三条：
- *   ① 有人来问才起（之前一直没人问 → 不起）；
- *   ② 一直有人问 → **不会**停（划词期间不能抖）；
- *   ③ 没人问满 MIC_IDLE_MS → 停，且状态回落 available=false（不假装还在听）；
- *   ④ 停了之后再来问 → 能重新起（micStarted 必须复位，否则第二次永远起不来）。
- *
- * 用法：node scripts/test-mic-idle.mjs
- */
-import { createServer } from 'node:http'
-import { mkdtemp, readFile, rm } from 'node:fs/promises'
-import { tmpdir } from 'node:os'
-import { join } from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-// ⚠️ 这个功能**只在 macOS 上有**：探针读的是 CoreAudio（宿主在非 darwin 上直接报
-// available=false，见 src/index.ts 的平台门禁）。别的平台上这些用例必然全红 ——
-// 与真浏览器冒烟同一套约定：**跑不了就 SKIP、退出码 0**，别把发布流水线卡在一台
-// 没有这个能力的机器上（2026-10-10 实测：ubuntu CI 上 6/7 条红，v0.9.1 那次 CI 之后
-// 才把本用例加进 npm test 链，所以这是第一次真跑到 Linux 上）。
-if (process.platform !== 'darwin') {
-  console.log('SKIP  麦克风探针是 macOS 专属（宿主在非 darwin 上直接报 available=false）—— 本机跳过')
-  process.exit(0)
-}
-
-const dir = await mkdtemp(join(tmpdir(), 'dsh-mic-idle-'))
-const logPath = join(dir, 'probe.log')
-// ⚠️ 环境变量必须在 **import 之前** 设好：宿主那几个常量是在模块求值时读的，
-// 而 ESM 的 import 会被提升到测试体之前 —— 直接 import 的话，这里的赋值就晚了。
-process.env.DSH_SEL_FAKE_PROBE_LOG = logPath
-process.env.DSH_SEL_MIC_PROBE = fileURLToPath(new URL('./fixtures/fake-mic-probe.sh', import.meta.url))
-process.env.DSH_SEL_MIC_IDLE_MS = '150'
-process.env.DSH_SEL_MIC_CHECK_MS = '40'
-const { apply } = await import('../lib/index.js')
-
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
-const logText = async () => {
-  try {
-    return await readFile(logPath, 'utf8')
-  } catch {
-    return ''
-  }
-}
-const starts = async () => ((await logText()).match(/start/g) || []).length
-const stops = async () => ((await logText()).match(/stop/g) || []).length
-
-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)
-    },
-  },
-}
-
-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 : ''}`)
-  }
-}
-
-try {
-  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 ask = async () => (await fetch(`${origin}/selection-explain/api/mic`)).json()
-
-  // ① 没人问的时候，探针不该存在
-  await sleep(120)
-  check('没人来问 → 探针不启动', (await starts()) === 0, 'start 次数=' + (await starts()))
-
-  // ② 有人问 → 起
-  const first = await ask()
-  await sleep(120)
-  check(
-    '第一次来问 → 探针启动，且状态是 available',
-    first.ok === true && first.available === true && (await starts()) === 1,
-    `available=${first.available} start=${await starts()}`,
-  )
-
-  check(
-    '探针以约定的采样间隔启动（--watch 125：发现"开麦"的延迟减半）',
-    (await logText()).includes('--watch 125'),
-    JSON.stringify((await logText()).split('\n')[0]),
-  )
-
-  // ③ 一直有人问 → 不停（划词期间不能抖）
-  for (let i = 0; i < 5; i += 1) {
-    await ask()
-    await sleep(40)
-  }
-  check('持续有人问 → 探针不重启也不停', (await starts()) === 1 && (await stops()) === 0, `start=${await starts()} stop=${await stops()}`)
-
-  // ④ 没人问满 IDLE → 停
-  await sleep(600)
-  check('没人问满 MIC_IDLE_MS → 探针停掉', (await stops()) === 1, 'stop 次数=' + (await stops()))
-
-  // ⑤ 再来问 → 能重新起（micStarted 必须被复位，否则第二次永远起不来）
-  const again = await ask()
-  await sleep(160)
-  check(
-    '再划词 → 探针重新启动',
-    again.available === true && (await starts()) === 2,
-    `available=${again.available} start 次数=${await starts()}`,
-  )
-
-  server.close()
-} finally {
-  for (const dispose of disposers) {
-    try {
-      dispose()
-    } catch {
-      /* 忽略 */
-    }
-  }
-  await sleep(400)
-  const after = await stops()
-  check('插件卸载 → 探针被停掉', after >= 1, 'stop 次数=' + after)
-  await rm(dir, { recursive: true, force: true })
-}
-
-console.log(`\n麦克风探针生命周期：${passed} 通过 / ${failed} 失败`)
-process.exit(failed ? 1 : 0)

package/scripts/test-model-follow.mjs

@@ -1,193 +0,0 @@
-/** Model following regressions: execute the client functions against real HTTP responses. */
-import assert from 'node:assert/strict'
-import { readFileSync } from 'node:fs'
-import { createServer } from 'node:http'
-import { resolve } from 'node:path'
-import { test } from 'node:test'
-
-const source = readFileSync(resolve(process.argv[2] || 'src/client/index.js'), 'utf8')
-
-// Extract executable functions, never assert on their spelling or implementation.
-function functionSource(name) {
-  const start = source.indexOf('function ' + name + '(')
-  assert.ok(start >= 0, 'Missing client function: ' + name)
-  let depth = 0
-  for (let i = source.indexOf('{', start); i < source.length; i += 1) {
-    const ch = source[i]
-    if (ch === '{') depth += 1
-    else if (ch === '}' && --depth === 0) return source.slice(start, i + 1)
-    else if (ch === "'" || ch === '"' || ch === '`') {
-      for (i += 1; i < source.length; i += 1) {
-        if (source[i] === '\\') i += 1
-        else if (source[i] === ch) break
-      }
-    } else if (ch === '/' && source[i + 1] === '/') {
-      while (i < source.length && source[i] !== '\n') i += 1
-    } else if (ch === '/' && source[i + 1] === '*') {
-      i = source.indexOf('*/', i) + 1
-    }
-  }
-  throw new Error('Unclosed function: ' + name)
-}
-
-function currentSession(services) {
-  return new Function('ctx', functionSource('currentSessionId') + '; return currentSessionId()')({
-    get: (name) => services[name],
-  })
-}
-
-test('reads the current session from the modern DSH session binding, not catalog.current', () => {
-  assert.equal(currentSession({
-    uiSession: { adapter: { current: { getSnapshot: () => ({ key: 'session-a', props: { sessionId: 'session-a' } }) } } },
-    sessions: { list: { getSnapshot: () => ({ ids: ['session-a'], byId: {}, phase: 'ready', projectionsBySession: {} }) } },
-  }), 'session-a')
-})
-
-test('an absent modern binding cannot revive a stale legacy current session', () => {
-  assert.equal(currentSession({
-    uiSession: { adapter: { current: { getSnapshot: () => ({ key: undefined, props: { sessionId: undefined } }) } } },
-    sessions: { list: { getSnapshot: () => ({ current: 'stale-session' }) } },
-  }), '')
-})
-
-test('supports older DSH runtimes without the session binding service', () => {
-  assert.equal(currentSession({ sessions: { list: { getSnapshot: () => ({ current: 'legacy-session' }) } } }), 'legacy-session')
-})
-
-const server = createServer((req, res) => {
-  const id = new URL(req.url, 'http://localhost').searchParams.get('sessionId')
-  const send = () => {
-    res.setHeader('content-type', 'application/json')
-    res.end(JSON.stringify({ ok: true, current: { provider: 'provider', model: id }, models: [{ provider: 'provider', model: id }] }))
-  }
-  // A finishes after B, reproducing a switch while A's catalog is loading.
-  setTimeout(send, id === 'session-a' ? 40 : 0)
-})
-await new Promise((done) => server.listen(0, '127.0.0.1', done))
-const origin = 'http://127.0.0.1:' + server.address().port
-
-function catalogClient(currentId) {
-  return new Function('MODELS', 'fetch', 'currentSessionId', 'panelOrCurrentSessionId', `
-    var modelCatalog = { at: 0, items: [], current: null, stages: null, loading: false, pending: null, error: '', leakyOff: [], sessionId: null }
-    var modelCatalogRequestSeq = 0
-    ${functionSource('loadModelCatalog')}
-    return { load: loadModelCatalog, snapshot: () => modelCatalog }
-  `)(origin + '/models', fetch, () => currentId, () => currentId)
-}
-
-try {
-  await test('catalog requests use the panel session even after navigation to another session', async () => {
-    const client = catalogClient('session-b')
-    const result = await client.load(true, 'session-a')
-    assert.equal(result.current.model, 'session-a')
-    assert.equal(result.sessionId, 'session-a')
-  })
-
-  await test('concurrent catalogs for different sessions cannot share or overwrite each other', async () => {
-    const client = catalogClient('session-a')
-    const a = client.load(true, 'session-a')
-    const b = client.load(true, 'session-b')
-    const [resultA, resultB] = await Promise.all([a, b])
-    assert.equal(resultA.current.model, 'session-a')
-    assert.equal(resultB.current.model, 'session-b')
-    assert.equal(client.snapshot().current.model, 'session-b')
-    const cachedB = await client.load(false, 'session-b')
-    assert.equal(cachedB.current.model, 'session-b')
-  })
-} finally {
-  server.closeAllConnections()
-  await new Promise((done) => server.close(done))
-}
-
-await test('legacy follow-up model cannot override the model used by first and second rounds', async () => {
-  const ts = await import('typescript')
-  const host = readFileSync(resolve('src/index.ts'), 'utf8')
-  const start = host.indexOf('  const resolveRoute = (')
-  const end = host.indexOf('  /** 分钟级限流。 */', start)
-  const js = ts.default.transpileModule(host.slice(start, end), { compilerOptions: { target: ts.default.ScriptTarget.ES2022 } }).outputText
-  const config = { provider: 'shared', model: 'chosen', chatProvider: 'legacy', chatModel: 'wrong' }
-  const route = new Function('config', 'modelCache', 'ctx', 'captured', js + '; return resolveRoute')(config, { items: [] }, { get: () => null }, null)
-  assert.deepEqual(route(undefined, null, false), { provider: 'shared', model: 'chosen' })
-  assert.deepEqual(route(undefined, null, true), { provider: 'shared', model: 'chosen' })
-  config.provider = ''; config.model = ''
-  assert.deepEqual(route(undefined, { provider: 'session', model: 'current' }, true), { provider: 'session', model: 'current' })
-})
-
-await test('first and second rounds use the same selected model without borrowing follow-up effort', () => {
-  const payload = new Function('state', 'document', 'location', 'panelOrCurrentSessionId', 'selectionKind', functionSource('buildPayload') + '; return buildPayload')(
-    { modelChoice: { provider: 'shared', model: 'chosen' }, effort: 'max' }, { title: 'test' }, { href: 'http://local' }, () => 'session', () => 'text')
-  for (const stage of ['translation', 'detail']) {
-    const body = payload('text', 'context', 'label', false, stage)
-    assert.equal(body.provider, 'shared')
-    assert.equal(body.model, 'chosen')
-    assert.equal(body.effort, undefined)
-  }
-})
-
-function settingsClient(send) {
-  return new Function('fetch', `
-    var SETTINGS = '/settings', settingsSpec = {}, settingsSaving = false, settingsResetting = false,
-        settingsSaveRequest = null, settingsSaveSeq = 0, settingsSaveTimer = 0,
-        settingsLive = {provider: 'p', model: 'old'}, settingsSaved = {provider: 'p', model: 'old'},
-        settingsByKey = {}, state = {}, bridgeOn = true, EFFORT_KEY = 'effort', scheduled = 0, MAX_SELECTION = 4000;
-    var settingsNoteText = {textContent: ''}, settingsNote = {setAttribute: function(){}};
-    function renderSettingsNote(note) { settingsNoteText.textContent = note === 'error' ? '保存失败，改动未生效' : note }
-    function settingsDirtyCount() { return Object.keys(settingsLive).filter(k => settingsLive[k] !== settingsSaved[k]).length }
-    function scheduleSettingsSave() { scheduled++ }
-    function paintModelPick(){} function repaintModelMenu(){} function setControlValue(){}
-    function updateSettingDependencies(){} function syncComposerModel(){ state.modelChoice = settingsLive.model ? {provider: settingsLive.provider, model: settingsLive.model} : null }
-    function refreshModelRow(){} function paintModelPill(){} function writeStore(){} function applyPillPrefs(){} function scheduleBridgeScan(){}
-    ${functionSource('applySelectionLimit')}
-    ${functionSource('applyServerValues')}
-    ${functionSource('flushSettingsSave')}
-    ${functionSource('resetSettings')}
-    return { edit(model) { settingsLive.model = model }, save: flushSettingsSave, reset: resetSettings,
-      snapshot() { return {live: {...settingsLive}, saved: {...settingsSaved}, scheduled, resetting: settingsResetting, choice: state.modelChoice} } }
-  `)(send)
-}
-
-await test('a slow save preserves a newer model choice and schedules its save', async () => {
-  let finish
-  const client = settingsClient(() => new Promise(resolve => { finish = resolve }))
-  client.edit('first')
-  const pending = client.save()
-  client.edit('second')
-  finish({json: async () => ({ok: true, values: {provider: 'p', model: 'first'}})})
-  await pending
-  assert.equal(client.snapshot().live.model, 'second')
-  assert.equal(client.snapshot().saved.model, 'first')
-  assert.equal(client.snapshot().choice.model, 'second')
-  assert.equal(client.snapshot().scheduled, 1)
-})
-
-await test('reset waits for an active save before clearing the shared model', async () => {
-  let finish; const requests = []
-  const client = settingsClient((url, init) => {
-    const body = JSON.parse(init.body); requests.push(body)
-    if (!body.reset) return new Promise(resolve => { finish = resolve })
-    return Promise.resolve({json: async () => ({ok: true, values: {provider: '', model: '', chatReasoningEffort: 'high'}})})
-  })
-  client.edit('changed'); const pending = client.save(); client.reset()
-  await Promise.resolve()
-  assert.equal(requests.length, 1)
-  finish({json: async () => ({ok: true, values: {provider: 'p', model: 'changed'}})})
-  await pending
-  for (let i = 0; i < 20 && client.snapshot().resetting; i++) await new Promise(resolve => setTimeout(resolve, 0))
-  assert.equal(requests.length, 2)
-  assert.equal(requests[1].reset, true)
-  assert.equal(client.snapshot().live.model, '')
-  assert.equal(client.snapshot().choice, null)
-})
-
-await test('reset also clears a value normalized by the in-flight save', async () => {
-  let finish
-  const client = settingsClient((url, init) => JSON.parse(init.body).reset
-    ? Promise.resolve({json: async () => ({ok: true, values: {provider: '', model: ''}})})
-    : new Promise(resolve => { finish = resolve }))
-  client.edit(' padded '); const pending = client.save(); client.reset()
-  finish({json: async () => ({ok: true, values: {provider: 'p', model: 'padded'}})})
-  await pending
-  for (let i = 0; i < 20 && client.snapshot().resetting; i++) await new Promise(resolve => setTimeout(resolve, 0))
-  assert.equal(client.snapshot().live.model, '')
-  assert.equal(client.snapshot().scheduled, 0)
-})