@pls-compile-owo/fisheye 0.7.3 → 0.8.0

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 规范与 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.8.0] - 2026-11-14
+
+### Changed
+
+- **auto 默认策略**：无官方字幕时自动尝试 whisper 转写（比抽帧省 token），转写成功则跳过字幕带；用 `--no-audio` 或环境变量 `FISHEYE_AUTO_AUDIO=0` 关闭。`--audio` 保留为显式请求。
+
+### Fixed
+
+- 转写成功后不再多余生成烧录字幕带图。
+
 ## [0.7.3] - 2026-11-14
 
 ### Docs

package/README.md

@@ -232,6 +232,8 @@ node fisheye.mjs transcribe BV1xxx [--lang zh]
 模型放 `~/.dsh/surfcore/whisper/`（`ggml-*.bin`）或用 `FISHEYE_WHISPER_MODEL` 指定。
 转写文本落 `out/<BV>-audio-transcript.txt`。
 
+> **默认策略**：`auto` 发现视频没有官方字幕时，会自动尝试 whisper 转写（口播/播客类比抽帧省 token）；转写文本作为台词源，跳过烧录字幕带。不想用加 `--no-audio` 或设 `FISHEYE_AUTO_AUDIO=0`。
+
 ### 字幕翻译
 
 外文视频（英文/日文等）的官方字幕会同时读取 B站 的**中文翻译轨**（l2 机器翻译），

package/fisheye.mjs

@@ -162,7 +162,8 @@ try {
       num(opt('budget', 20000), 'budget', { min: 2000, max: 200000 }),
       { density: d === null ? null : num(d, 'density', { min: 0.5, max: 60 }), page, from, to,
         useDanmakuFrames: !argv.includes('--no-danmaku-frames'),
-        audio: argv.includes('--audio'), audioLang: opt('lang', null),
+        audio: argv.includes('--audio') ? true : (argv.includes('--no-audio') ? false : undefined),
+        audioLang: opt('lang', null),
         resume: argv.includes('--resume'), force: argv.includes('--force') })
   } else if (stage === 'refine') {
     await stageRefine(bvid, { template: argv.includes('--template'), decisions: opt('decisions', null) })

package/lib/i18n.mjs

@@ -19,7 +19,7 @@ const MESSAGES = {
   zh: {
     // —— 用法帮助 ——
     usage: `用法:
-  node fisheye.mjs auto <BV> [--budget 20000] [--density 6] [--audio]  ← 推荐：自动规划并铺网（--audio 无字幕转写 / --resume 断点续跑）
+  node fisheye.mjs auto <BV> [--budget 20000] [--density 6] [--audio]  ← 推荐：自动规划并铺网（无字幕自动转写；--no-audio 关闭 / --resume 断点续跑）
   node fisheye.mjs refine <BV> --template                         ← 生成精读决策模板
   node fisheye.mjs refine <BV> --decisions <file.json>            ← 按模型判断精读
   node fisheye.mjs refine <BV>                                    ← 几何兜底（零 token）
@@ -79,7 +79,7 @@ const MESSAGES = {
 
   en: {
     usage: `Usage:
-  node fisheye.mjs auto <BV> [--budget 20000] [--density 6] [--audio]  # recommended: auto-plan and build grids (--audio transcribe / --resume resume)
+  node fisheye.mjs auto <BV> [--budget 20000] [--density 6] [--audio]  # recommended: auto-plan and build grids (auto-transcribe when no subtitles; --no-audio disables)
   node fisheye.mjs refine <BV> --template                         # generate a refine decision template
   node fisheye.mjs refine <BV> --decisions <file.json>            # refine using model decisions
   node fisheye.mjs refine <BV>                                    # geometric fallback (zero tokens)

package/lib/stages.mjs

@@ -534,7 +534,9 @@ export async function stageAuto(bvid, budget, opts = {}) {
     if (officialRaw) {
       console.log(`[字幕] 官方字幕质量差（平均有效 ${officialRaw.avgEff} 字/行、去重率 ${officialRaw.uniqueRatio}）——疑为音乐/音效噪声，不采用`)
     }
-    if (opts.audio === true) {
+    // 默认策略：无官方字幕时尝试 whisper 转写（比抽帧省 token）；--no-audio 或 FISHEYE_AUTO_AUDIO=0 关闭
+    const wantAudio = opts.audio !== false && process.env.FISHEYE_AUTO_AUDIO !== '0'
+    if (wantAudio) {
       const caps = audioCaps()
       console.log(`[音频] ${caps.summary}`)
       if (!caps.available) {
@@ -670,7 +672,7 @@ export async function stageAuto(bvid, budget, opts = {}) {
   } else {
     manifest = await stageGrid(bvid, chunk, '3x3', pre)
   }
-  if (hasSubs) await stageSubs(bvid, subsRows, 'auto', { mp4, view, bandResult, scenes, range, page: pageNo })
+  if (hasSubs && !transcript) await stageSubs(bvid, subsRows, 'auto', { mp4, view, bandResult, scenes, range, page: pageNo })
 
   // 7. 精读建议 = 几何规则（画面变化剧烈）+ 弹幕热区（观众反应最激烈）
   // 两个信号互补：几何只看像素，弹幕看人的反应；合并后按时间排序、同一时刻只留一个

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pls-compile-owo/fisheye",
-  "version": "0.7.3",
+  "version": "0.8.0",
   "description": "Token-budget-aware video understanding for AI agents: official subtitles -> burned-in subtitle band -> danmaku highlights -> adaptive keyframe grids -> targeted refine.",
   "type": "module",
   "bin": {