@pls-compile-owo/fisheye 0.3.0 → 0.7.1

package/test/audio.test.mjs

@@ -0,0 +1,23 @@
+// audio 模块单测：能力探测（不依赖本机是否装 whisper，环境无关）
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { audioCaps, findWhisper } from '../lib/audio.mjs'
+
+test('audioCaps：返回稳定的能力描述结构', () => {
+  const caps = audioCaps()
+  assert.equal(typeof caps, 'object')
+  assert.equal(typeof caps.available, 'boolean')
+  assert.equal(typeof caps.reason, 'string')
+  assert.equal(typeof caps.summary, 'string')
+  if (caps.available) {
+    assert.ok(caps.whisper)
+    assert.ok(caps.cmd)
+  } else {
+    assert.ok(caps.hint)
+  }
+})
+
+test('findWhisper：无可用 whisper 时返回 null 或合法对象（不抛错）', () => {
+  const r = findWhisper({ ffmpeg: null, env: {} })
+  assert.ok(r === null || (r && typeof r.cmd === 'string'))
+})

package/test/batch.test.mjs

@@ -0,0 +1,212 @@
+// batch 模块单测：批量清单解析 / 串行与并发执行 / 汇总报告
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { parseBatchList, runBatch, formatBatchReport } from '../lib/batch.mjs'
+
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+
+test('parseBatchList：混合清单分类（BV / 文件 / URL / 空行 / 注释 / 非法行）', () => {
+  const input = String.raw`
+# 今晚要跑的一批
+BV1ziWP6qENy
+
+C:\videos\a.mp4
+./clips/b.mkv
+https://www.bilibili.com/video/BV1xx411c7mD
+video.webm
+D:/movies/c.mov
+这不是视频
+`
+  const { items, errors } = parseBatchList(input)
+  assert.deepEqual(items, [
+    { kind: 'bv', value: 'BV1ziWP6qENy' },
+    { kind: 'file', value: String.raw`C:\videos\a.mp4` },
+    { kind: 'file', value: './clips/b.mkv' },
+    { kind: 'url', value: 'https://www.bilibili.com/video/BV1xx411c7mD' },
+    { kind: 'file', value: 'video.webm' },
+    { kind: 'file', value: 'D:/movies/c.mov' }
+  ])
+  assert.equal(errors.length, 1)
+  assert.equal(errors[0].raw, '这不是视频')
+  // 行号按物理行算（1-based），空行 / 注释行也占行号
+  const expectedLine = input.split(/\r?\n/).findIndex((line) => line.trim() === '这不是视频') + 1
+  assert.equal(errors[0].line, expectedLine)
+  assert.match(errors[0].reason, /无法识别/)
+})
+
+test('parseBatchList：数组输入、trim 与 # 注释行', () => {
+  const { items, errors } = parseBatchList([
+    '  BV1ziWP6qENy  ',
+    '# 注释',
+    '',
+    '   ',
+    '../up/c.mkv'
+  ])
+  assert.deepEqual(items, [
+    { kind: 'bv', value: 'BV1ziWP6qENy' },
+    { kind: 'file', value: '../up/c.mkv' }
+  ])
+  assert.deepEqual(errors, [])
+})
+
+test('parseBatchList：空输入 / 纯注释返回空清单', () => {
+  assert.deepEqual(parseBatchList(''), { items: [], errors: [] })
+  assert.deepEqual(parseBatchList([]), { items: [], errors: [] })
+  assert.deepEqual(parseBatchList('# only\n\n  # comments'), { items: [], errors: [] })
+})
+
+test('parseBatchList：非视频扩展名的路径算 file，纯文本词进 errors', () => {
+  const { items, errors } = parseBatchList(['notes.txt', String.raw`C:\docs\readme.txt`, 'BV1ziWP6qENy-x'])
+  assert.deepEqual(items, [{ kind: 'file', value: String.raw`C:\docs\readme.txt` }])
+  assert.equal(errors.length, 2)
+  assert.deepEqual(errors.map((e) => e.raw), ['notes.txt', 'BV1ziWP6qENy-x'])
+})
+
+test('parseBatchList：非法 input 类型不抛错，进 errors', () => {
+  const { items, errors } = parseBatchList(42)
+  assert.deepEqual(items, [])
+  assert.equal(errors.length, 1)
+  assert.equal(errors[0].line, 0)
+})
+
+test('runBatch：concurrency=1 串行执行，结果按输入顺序', async () => {
+  const order = []
+  let active = 0
+  let peak = 0
+  const summary = await runBatch([1, 2, 3], async (n) => {
+    active++
+    peak = Math.max(peak, active)
+    order.push(n)
+    await sleep(5)
+    active--
+    return n * 10
+  })
+  assert.deepEqual(order, [1, 2, 3])
+  assert.equal(peak, 1) // 串行：任意时刻只有一个在跑
+  assert.equal(summary.total, 3)
+  assert.equal(summary.ok, 3)
+  assert.equal(summary.failed, 0)
+  assert.deepEqual(summary.results.map((r) => r.item), [1, 2, 3])
+  assert.deepEqual(summary.results.map((r) => r.result), [10, 20, 30])
+  for (const row of summary.results) {
+    assert.equal(row.ok, true)
+    assert.equal(typeof row.ms, 'number')
+    assert.ok(row.ms >= 0)
+  }
+})
+
+test('runBatch：单个失败不中断整体，失败项带 error', async () => {
+  const summary = await runBatch(['a', 'b', 'c'], async (item) => {
+    if (item === 'b') throw new Error('炸了')
+    return item.toUpperCase()
+  })
+  assert.equal(summary.total, 3)
+  assert.equal(summary.ok, 2)
+  assert.equal(summary.failed, 1)
+  assert.deepEqual(summary.results.map((r) => r.ok), [true, false, true])
+  assert.equal(summary.results[1].item, 'b')
+  assert.match(summary.results[1].error, /炸了/)
+  assert.equal(summary.results[2].result, 'C') // 失败之后仍继续执行
+})
+
+test('runBatch：concurrency=2 时并发度不超过 2，结果顺序不变', async () => {
+  const items = [1, 2, 3, 4, 5]
+  let active = 0
+  let peak = 0
+  const summary = await runBatch(items, async (n) => {
+    active++
+    peak = Math.max(peak, active)
+    await sleep(20)
+    active--
+    return n
+  }, { concurrency: 2 })
+  assert.equal(peak, 2) // 两个 worker 各自跑，不会超过上限
+  assert.equal(summary.ok, 5)
+  assert.equal(summary.failed, 0)
+  // 后完成的项不会把结果顺序打乱
+  assert.deepEqual(summary.results.map((r) => r.item), items)
+  assert.deepEqual(summary.results.map((r) => r.result), items)
+})
+
+test('runBatch：onItem 在每项开始前回调（进度用）', async () => {
+  const events = []
+  const summary = await runBatch(['a', 'b'], async (item) => {
+    events.push(`run:${item}`)
+    return item
+  }, {
+    concurrency: 1,
+    onItem: (item, index) => { events.push(`item:${index}:${item}`) }
+  })
+  assert.deepEqual(events, ['item:0:a', 'run:a', 'item:1:b', 'run:b'])
+  assert.equal(summary.ok, 2)
+})
+
+test('runBatch：空列表直接返回零统计，不调用 runner', async () => {
+  let called = 0
+  const summary = await runBatch([], async () => { called++ })
+  assert.deepEqual(summary, { results: [], total: 0, ok: 0, failed: 0 })
+  assert.equal(called, 0)
+})
+
+test('runBatch：非法 concurrency 回落为串行，参数类型错误抛 TypeError', async () => {
+  const summary = await runBatch([1, 2], async (n) => n, { concurrency: 0 })
+  assert.equal(summary.ok, 2)
+  await assert.rejects(() => runBatch([], 'not a function'), TypeError)
+  await assert.rejects(() => runBatch('not an array', async () => {}), TypeError)
+})
+
+test('formatBatchReport：含总数 / 成功 / 失败 / 耗时 / 失败明细', () => {
+  const summary = {
+    total: 3,
+    ok: 2,
+    failed: 1,
+    results: [
+      { item: { kind: 'bv', value: 'BV1ziWP6qENy' }, ok: true, result: {}, ms: 1000 },
+      { item: { kind: 'file', value: String.raw`C:\videos\a.mp4` }, ok: false, error: '找不到文件', ms: 20 },
+      { item: { kind: 'url', value: 'https://example.com/v.mp4' }, ok: true, result: {}, ms: 800 }
+    ]
+  }
+  const report = formatBatchReport(summary)
+  assert.match(report, /共 3 条/)
+  assert.match(report, /成功 2 条/)
+  assert.match(report, /失败 1 条/)
+  assert.match(report, /1\.8s/) // 1000 + 20 + 800 ms
+  assert.match(report, /失败明细/)
+  assert.match(report, /\[file\] C:\\videos\\a\.mp4/)
+  assert.match(report, /找不到文件/)
+  // 失败明细只列失败项：成功的 BV 不出现在报告里
+  assert.ok(!report.includes('[bv] BV1ziWP6qENy'))
+})
+
+test('formatBatchReport：全部成功时不打印失败明细', () => {
+  const report = formatBatchReport({
+    total: 2,
+    ok: 2,
+    failed: 0,
+    results: [
+      { item: { kind: 'bv', value: 'BV1ziWP6qENy' }, ok: true, ms: 300 },
+      { item: { kind: 'bv', value: 'BV1xx411c7mD' }, ok: true, ms: 200 }
+    ]
+  })
+  assert.match(report, /失败 0 条/)
+  assert.ok(!report.includes('失败明细'))
+  assert.match(report, /500ms/)
+})
+
+test('parseBatchList + runBatch + formatBatchReport：全流程', async () => {
+  const { items, errors } = parseBatchList(String.raw`BV1ziWP6qENy
+坏行
+C:\v.mp4`)
+  assert.equal(items.length, 2)
+  assert.equal(errors.length, 1)
+  const summary = await runBatch(items, async (item) => {
+    if (item.kind === 'file') throw new Error('文件不存在')
+    return item.value
+  })
+  assert.equal(summary.total, 2)
+  assert.equal(summary.ok, 1)
+  assert.equal(summary.failed, 1)
+  const report = formatBatchReport(summary)
+  assert.match(report, /共 2 条/)
+  assert.match(report, /文件不存在/)
+})

package/test/bili.test.mjs

@@ -0,0 +1,70 @@
+// bili 模块单测：官方字幕选轨（纯函数，不联网）
+// 「外文视频只转写不翻译」的修复核心在 pickSubtitleTracks：
+// 主轨保留原文，同时把中文轨（B站 l2 机器翻译）单独挑出来给 translated。
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { pickSubtitleTracks, clean, keyOf, UA, MIXIN_TAB } from '../lib/bili.mjs'
+
+const en = { lan: 'en-US', lan_doc: '英语', subtitle_url: '//aisubtitle.hdslb.com/en.json' }
+const zh = { lan: 'zh-CN', lan_doc: '中文翻译', subtitle_url: '//aisubtitle.hdslb.com/zh.json' }
+
+test('pickSubtitleTracks：外文主轨 + 中文翻译轨', () => {
+  const t = pickSubtitleTracks([en, zh])
+  assert.equal(t.main.lan, 'en-US')
+  assert.equal(t.translate.lan, 'zh-CN')
+})
+
+test('pickSubtitleTracks：只有中文轨 → 主轨中文、翻译 null', () => {
+  const zhOnly = { lan: 'ai-zh', lan_doc: '中文（AI）', subtitle_url: '//x/zh.json' }
+  const t = pickSubtitleTracks([zhOnly])
+  assert.equal(t.main.lan, 'ai-zh')
+  assert.equal(t.translate, null)
+})
+
+test('pickSubtitleTracks：空数组 → null', () => {
+  assert.equal(pickSubtitleTracks([]), null)
+})
+
+test('pickSubtitleTracks：外文无中文翻译 → 翻译 null', () => {
+  const ja = { lan: 'ja-JP', lan_doc: '日语', subtitle_url: '//x/ja.json' }
+  const t = pickSubtitleTracks([ja])
+  assert.equal(t.main.lan, 'ja-JP')
+  assert.equal(t.translate, null)
+})
+
+test('pickSubtitleTracks：多条中文轨仍只取一条（ai-zh 优先）', () => {
+  const t = pickSubtitleTracks([en, { lan: 'zh-Hans', lan_doc: '简体中文' }, { lan: 'ai-zh', lan_doc: '中文（AI）' }])
+  assert.equal(t.main.lan, 'en-US')
+  assert.equal(t.translate.lan, 'ai-zh')
+})
+
+test('pickSubtitleTracks：preferZh=false 中文当主轨、不产生翻译', () => {
+  const t = pickSubtitleTracks([en, zh], false)
+  assert.equal(t.main.lan, 'zh-CN')
+  assert.equal(t.translate, null)
+})
+
+test('pickSubtitleTracks：忽略无 lan 的脏项；全脏 → null', () => {
+  const t = pickSubtitleTracks([{ subtitle_url: '//x' }, null, en, zh])
+  assert.equal(t.main.lan, 'en-US')
+  assert.equal(t.translate.lan, 'zh-CN')
+  assert.equal(pickSubtitleTracks([{ subtitle_url: '//x' }, null]), null)
+})
+
+// —— 既有纯函数测试（0.5.0 起）——
+test('clean：去除 WBI 禁止字符', () => {
+  assert.equal(clean("a!b'c(d)e*f"), 'abcdef')
+  assert.equal(clean('plain123'), 'plain123')
+})
+
+test('keyOf：从 URL 提取文件名（去扩展名）', () => {
+  assert.equal(keyOf('https://example.com/path/file.txt'), 'file')
+  assert.equal(keyOf('https://a.b/c/d/e.f.js'), 'e.f')
+})
+
+test('UA 与 MIXIN_TAB 常量存在', () => {
+  assert.equal(typeof UA, 'string')
+  assert.ok(UA.includes('Mozilla'))
+  assert.ok(Array.isArray(MIXIN_TAB))
+  assert.equal(MIXIN_TAB.length, 64)
+})

package/test/budget.test.mjs

@@ -0,0 +1,63 @@
+// budget 模块单测：token 估算 / 环境变量覆盖 / 模型系数
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { estimateTokens, tokensPerUnit, modelFactor, COST } from '../lib/budget.mjs'
+
+const ENV_KEYS = ['FISHEYE_TOKENS_PER_GRID', 'FISHEYE_TOKENS_PER_SUBS', 'FISHEYE_TOKENS_PER_FINE', 'FISHEYE_TOKEN_MODEL']
+function withEnv(overrides, fn) {
+  const saved = {}
+  for (const k of ENV_KEYS) { saved[k] = process.env[k]; delete process.env[k] }
+  Object.assign(process.env, overrides)
+  try { return fn() } finally {
+    for (const k of ENV_KEYS) {
+      if (saved[k] === undefined) delete process.env[k]; else process.env[k] = saved[k]
+    }
+  }
+}
+
+test('默认值：grid/subs/fine = 1200/1000/1300', () => {
+  withEnv({}, () => {
+    assert.equal(estimateTokens('grid'), 1200)
+    assert.equal(estimateTokens('subs'), 1000)
+    assert.equal(estimateTokens('fine'), 1300)
+    assert.equal(estimateTokens('fine', 3), 3900)
+  })
+})
+
+test('COST 默认表与旧版一致', () => {
+  assert.deepEqual({ ...COST }, { grid: 1200, subs: 1000, fine: 1300 })
+})
+
+test('环境变量覆盖单张成本', () => {
+  withEnv({ FISHEYE_TOKENS_PER_GRID: '1500', FISHEYE_TOKENS_PER_SUBS: '900' }, () => {
+    assert.equal(estimateTokens('grid'), 1500)
+    assert.equal(estimateTokens('subs', 2), 1800)
+  })
+})
+
+test('FISHEYE_TOKEN_MODEL：qwen/gemini/数字', () => {
+  withEnv({ FISHEYE_TOKEN_MODEL: 'qwen' }, () => {
+    assert.ok(modelFactor() > 1)
+    assert.ok(estimateTokens('grid') > 1200)
+  })
+  withEnv({ FISHEYE_TOKEN_MODEL: 'gemini' }, () => {
+    assert.ok(modelFactor() < 1)
+  })
+  withEnv({ FISHEYE_TOKEN_MODEL: '2' }, () => {
+    assert.equal(modelFactor(), 2)
+    assert.equal(estimateTokens('grid'), 2400)
+  })
+})
+
+test('非法模型名回退 1.0；未知 kind 抛错', () => {
+  withEnv({ FISHEYE_TOKEN_MODEL: 'nonsense-model' }, () => {
+    assert.equal(modelFactor(), 1.0)
+  })
+  assert.throws(() => estimateTokens('unknown-kind'))
+})
+
+test('count 非正/非有限 → 0', () => {
+  assert.equal(estimateTokens('grid', 0), 0)
+  assert.equal(estimateTokens('grid', -5), 0)
+  assert.equal(estimateTokens('grid', Number.NaN), 0)
+})

package/test/env.test.mjs

@@ -0,0 +1,35 @@
+// env 模块单测：工具探测（onPath / resolveTool）
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import os from 'node:os'
+import { onPath, resolveTool } from '../lib/env.mjs'
+
+test('onPath：Windows 的 where 命令存在', () => {
+  if (process.platform === 'win32') {
+    assert.equal(onPath('where'), true)
+  } else {
+    assert.equal(onPath('which'), true)
+  }
+})
+
+test('onPath：不存在的命令返回 false', () => {
+  assert.equal(onPath('definitely-not-a-real-command-xyz-123'), false)
+})
+
+test('resolveTool：环境变量优先', () => {
+  const saved = process.env.FISHEYE_TEST_TOOL
+  process.env.FISHEYE_TEST_TOOL = os.tmpdir()
+  try {
+    const r = resolveTool('FISHEYE_TEST_TOOL', 'testTool', [], 'nonexistent-cmd-xyz')
+    assert.ok(r)
+    assert.equal(r.cmd, os.tmpdir())
+    assert.match(r.from, /环境变量/)
+  } finally {
+    if (saved === undefined) delete process.env.FISHEYE_TEST_TOOL; else process.env.FISHEYE_TEST_TOOL = saved
+  }
+})
+
+test('resolveTool：全部找不到返回 null', () => {
+  const r = resolveTool('FISHEYE_TEST_TOOL_MISSING', 'missingTool', [os.tmpdir() + '\\no-such-exe.exe'], 'no-such-cmd-xyz-456')
+  assert.equal(r, null)
+})

package/test/frame.test.mjs

@@ -0,0 +1,35 @@
+// frame 模块单测：广告剔除 / 取帧时间点选择（纯函数部分）
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { subtractAds, pickTimes } from '../lib/frame.mjs'
+
+test('subtractAds：无广告返回整段', () => {
+  assert.deepEqual(subtractAds(0, 100, []), [{ a: 0, b: 100 }])
+})
+
+test('subtractAds：中间广告被剔除', () => {
+  const out = subtractAds(0, 100, [{ from: 40, to: 60 }])
+  assert.deepEqual(out, [{ a: 0, b: 40 }, { a: 60, b: 100 }])
+})
+
+test('subtractAds：整段都是广告 → 空', () => {
+  assert.deepEqual(subtractAds(0, 100, [{ from: -5, to: 105 }]), [])
+})
+
+test('pickTimes：返回 n 个递增时间点', () => {
+  const r = pickTimes(0, 100, 9, [], [])
+  assert.ok(r && Array.isArray(r.times))
+  assert.equal(r.times.length, 9)
+  for (let i = 1; i < r.times.length; i++) assert.ok(r.times[i] > r.times[i - 1])
+  for (const t of r.times) assert.ok(t >= 0 && t <= 100)
+})
+
+test('pickTimes：时间点不落在广告段内', () => {
+  const r = pickTimes(0, 100, 9, [], [{ from: 20, to: 80 }])
+  assert.ok(r && Array.isArray(r.times))
+  for (const t of r.times) assert.ok(t <= 20 || t >= 80, `time ${t} 落在广告段内部`)
+})
+
+test('pickTimes：整段广告返回 null', () => {
+  assert.equal(pickTimes(0, 100, 9, [], [{ from: -1, to: 101 }]), null)
+})

package/test/i18n.test.mjs

@@ -0,0 +1,45 @@
+// i18n 模块单测：语言切换与文案回退
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { getLang, t } from '../lib/i18n.mjs'
+
+function withLang(value, fn) {
+  const saved = process.env.FISHEYE_LANG
+  if (value === undefined) delete process.env.FISHEYE_LANG; else process.env.FISHEYE_LANG = value
+  try { return fn() } finally {
+    if (saved === undefined) delete process.env.FISHEYE_LANG; else process.env.FISHEYE_LANG = saved
+  }
+}
+
+test('默认中文', () => {
+  withLang(undefined, () => {
+    assert.equal(getLang(), 'zh')
+    assert.ok(t('usage').startsWith('用法'))
+  })
+})
+
+test('FISHEYE_LANG=en 英文', () => {
+  withLang('en', () => {
+    assert.equal(getLang(), 'en')
+    assert.ok(t('usage').startsWith('Usage'))
+  })
+})
+
+test('en-US 归一化为 en', () => {
+  withLang('en-US', () => assert.equal(getLang(), 'en'))
+})
+
+test('未知语言回退中文', () => {
+  withLang('fr', () => assert.equal(getLang(), 'zh'))
+})
+
+test('占位符替换', () => {
+  withLang(undefined, () => {
+    const s = t('err.unknownStage', { stage: 'foo' })
+    assert.ok(s.includes('foo'))
+  })
+})
+
+test('缺失 key 原样返回（不抛错）', () => {
+  assert.equal(t('no.such.key.here'), 'no.such.key.here')
+})

package/test/ocr.test.mjs

@@ -0,0 +1,89 @@
+// ocr 模块单测：能力探测结构（环境无关）+ 有 tesseract 时实测一张自带文字的小图
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { findTesseract, ocrCaps, ocrImage } from '../lib/ocr.mjs'
+
+const HERE = path.dirname(fileURLToPath(import.meta.url))
+const SAMPLE = path.join(HERE, 'ocr-sample.png')
+
+test('ocrCaps：结构完整、字段类型正确', () => {
+  const caps = ocrCaps()
+  assert.equal(typeof caps.available, 'boolean')
+  assert.equal(typeof caps.reason, 'string')
+  assert.equal(typeof caps.summary, 'string')
+  assert.ok(caps.summary.includes('OCR：'))
+  assert.ok(caps.summary.includes(caps.available ? '可用' : '不可用'))
+  assert.ok(caps.hint === null || typeof caps.hint === 'string')
+  assert.ok(caps.cmd === null || typeof caps.cmd === 'string')
+  assert.ok(caps.binDir === null || typeof caps.binDir === 'string')
+  assert.ok(caps.tessdata === null || typeof caps.tessdata === 'string')
+  assert.ok(caps.version === null || typeof caps.version === 'string')
+  assert.ok(Array.isArray(caps.langs))
+  for (const l of caps.langs) assert.equal(typeof l, 'string')
+  // 可用时必须能指到真实 cmd，且语言包列表非空
+  if (caps.available) {
+    assert.ok(caps.cmd && fs.existsSync(caps.cmd))
+    assert.ok(caps.langs.length > 0)
+  }
+})
+
+test('ocrCaps：探测异常也不抛（env 为怪值）', () => {
+  const caps = ocrCaps({ env: { FISHEYE_TESSERACT: 123 } })
+  assert.equal(typeof caps.available, 'boolean')
+  assert.equal(typeof caps.summary, 'string')
+})
+
+test('findTesseract：返回 null 或合法对象（环境无关）', () => {
+  const t = findTesseract()
+  if (t === null) return // 没装 tesseract 的机器上这是合法结果
+  assert.equal(typeof t.cmd, 'string')
+  assert.ok(fs.existsSync(t.cmd), `cmd 应该存在：${t.cmd}`)
+  assert.equal(
+    path.basename(t.cmd).toLowerCase(),
+    process.platform === 'win32' ? 'tesseract.exe' : 'tesseract',
+  )
+  assert.equal(typeof t.binDir, 'string')
+  assert.ok(fs.existsSync(t.binDir))
+  assert.ok(t.tessdata === null || typeof t.tessdata === 'string')
+  if (t.tessdata) assert.ok(fs.existsSync(t.tessdata))
+})
+
+test('findTesseract：FISHEYE_TESSERACT 指向不存在的文件时优雅回退', () => {
+  const t = findTesseract({ env: { ...process.env, FISHEYE_TESSERACT: path.join(HERE, 'no-such-dir', 'tesseract.exe') } })
+  assert.ok(t === null || (typeof t.cmd === 'string' && fs.existsSync(t.cmd)))
+})
+
+test('findTesseract：FISHEYE_TESSERACT 可指向安装目录', () => {
+  const real = findTesseract()
+  if (!real) return // 环境无关：没装就跳过
+  const t = findTesseract({ env: { ...process.env, FISHEYE_TESSERACT: real.binDir } })
+  assert.ok(t)
+  assert.equal(t.cmd.toLowerCase(), real.cmd.toLowerCase())
+})
+
+test('ocrImage：图片不存在时返回 null', () => {
+  const r = ocrImage(path.join(HERE, 'no-such-image.png'), { quiet: true })
+  assert.equal(r, null)
+})
+
+test('ocrImage：实测识别 test/ocr-sample.png 里的 HELLO 123', (t) => {
+  const caps = ocrCaps()
+  if (!caps.available) {
+    t.skip('本机没有可用的 tesseract')
+    return
+  }
+  if (!fs.existsSync(SAMPLE)) {
+    t.skip('缺少 test/ocr-sample.png')
+    return
+  }
+  const r = ocrImage(SAMPLE, { lang: 'eng', quiet: true })
+  assert.ok(r, 'tesseract 可用时应该识别出文本')
+  assert.equal(typeof r.text, 'string')
+  assert.match(r.text, /HELLO/i)
+  assert.match(r.text, /123/)
+  assert.equal(typeof r.cmd, 'string')
+  assert.equal(r.lang, 'eng')
+})