@pls-compile-owo/fisheye 0.7.2 → 0.8.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 本项目遵循 [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
+
+纯文档同步版本（功能与 0.7.2 一致）。
+
+- README 新增「自检」专节：selftest 检查项、输出标记（[OK]/[--]/[!!]）、--deep 说明。
+
 ## [0.7.2] - 2026-11-14
 
 ### Docs

package/README.en.md

@@ -79,6 +79,16 @@ node fisheye.mjs clean [--target out] [--yes]     # clean artifacts
 `auto --resume` reuses existing grids and skips frame extraction; `--force` re-runs everything.
 Optional integrations: whisper.cpp (audio), tesseract (OCR), yt-dlp (any URL), and `mcp-video-server.js` (MCP tools, needs `npm i @modelcontextprotocol/sdk zod`).
 
+## Self-check
+
+```bash
+node fisheye.mjs selftest        # dependencies / credentials / APIs / optional tools / disk
+node fisheye.mjs selftest --deep # plus frame-extraction and subtitle-band probes
+```
+
+Marks: `[OK]` pass, `[--]` skipped (optional tool missing / no data), `[!!]` failed.
+Failures print fix hints at the end.
+
 ## Docs
 
 - `docs/DESIGN.md` — design rationale

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 机器翻译），
@@ -283,6 +285,25 @@ node fisheye.mjs clean                    # 预览将清理的缓存/产物（dr
 node fisheye.mjs clean --target out --yes # 实际删除 out/
 ```
 
+## 自检
+
+```bash
+node fisheye.mjs selftest        # 快速检查依赖 / 凭证 / API / 可选组件 / 磁盘
+node fisheye.mjs selftest --deep # 额外做抽帧 + 字幕带实测（需缓存视频）
+```
+
+检查项：
+
+| 类别 | 检查内容 |
+|---|---|
+| 基础 | Node 版本、ffmpeg、python（可选）、analyze_subs.py |
+| 环境 | 输出目录可写、B站 凭证、缓存目录、磁盘剩余 |
+| API | 视频 API、弹幕 API、官方字幕 API（含翻译轨） |
+| 可选组件 | 音频转写（whisper）、OCR（tesseract）、yt-dlp |
+
+输出标记：`[OK]` 通过、`[--]` 跳过（可选依赖未装/无数据）、`[!!]` 失败。
+失败时末尾会打印修复提示；`--deep` 会额外实测抽帧与字幕带检测。
+
 ## MCP server（可选）
 
 `mcp-video-server.js` 把 fisheye 包装成 [MCP](https://modelcontextprotocol.io/)（Model Context Protocol）工具，让支持 MCP 的 agent 环境（DSH / Claude Code / Cursor 等）**不必自己拼命令行**就能看视频。

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.2",
+  "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": {