dsh-bili-watch 0.3.2 → 0.3.3

package/README.md

@@ -95,6 +95,21 @@ node tools/look.mjs view BV1EPnG6DEJC
 
 正文超过 800 字时，终端仅返回前 400 字摘要 + 落盘路径，全文写入缓存目录。工具层（`bili_watch`）阈值为 2000 字（摘要 800 字）。
 
+## 面板
+
+装进 DSH 后，在插件页点 `dsh-bili-watch` 卡片进详情页，里面有一块面板（不用先进设置），日常操作不用去对话里敲命令：
+
+- **依赖状态**：ffmpeg、yt-dlp、ASR 环境、OCR 环境、转写模型、B 站登录凭证逐项列出是否就绪、实际路径、占用体积。缺的点行末按钮后台装（走内置 `fetch-deps`，体积是估算值，实际以跑完为准）。
+- **扫码登录**：未登录显示「去扫码登录」，已登录是「重新扫码」。二维码在面板里出，手机 B 站扫完自动刷新。凭证存在本机 `$DSH_HOME/bili-watch/credential.json`。
+- **哪些能删**：yt-dlp、转写模型、登录凭证可以直接删；ffmpeg / ASR 环境 / OCR 环境不给删除按钮——环境删了要重跑 `fetch-deps` 装回来，代价比省下的空间大，面板只在旁边标出实际位置。
+- **批量操作**：标题行的「批量下载 / 批量清理」打开勾选清单，删除前会再确认一次。
+- **抽帧缓存**：显示当前占用与文件数，「立即清除」一键清空；不点则按规则自动清理（保留天数、总量上限），超过从最旧的删起。规则存 `deps/cache-config.json`，启动时与打开面板时各查一次。
+- **缓存位置**：默认 `$DSH_HOME/bili-watch/cache`（`$DSH_HOME` 是 DSH 家目录，Windows 下通常是用户目录里的 `.dsh`）。登录凭证是它的兄弟文件，清缓存时别把上一层一起删。换位置用环境变量 `BILI_WATCH_CACHE`，或 `deps/deps-config.json` 里的 `"cache"`；指到还不是缓存根的目录时，插件会在里面建 `bili-watch-cache/`，不会直接拿你的目录当缓存根。
+- **运行时参数**：转写闸门、抽帧张数上限这类常改的放常规组，其余收在「高级设置」里（默认收起），每项都标了范围和「调大/调小会怎样」。
+- **最近一次调用**：显示命令、时间、成败，用来判断上一次是不是卡住了。
+
+0.3.2 起装完重启就是启用状态，不用再去插件页手动打开。
+
 ## 配置
 
 ### 环境变量
@@ -245,6 +260,13 @@ AI 字幕（需登录）
 - 无内置限速，批量调用需自行 sleep
 - 工具名 `bili_watch` 与命令 `/bili` 若与其他插件冲突，后注册者覆盖前者
 
+## 成本
+
+- 字幕接口带一次重试；`text` 最多尝试两次（先匿名，有凭证再试一次）。
+- 抽帧要下载视频（360p）再跑 ffmpeg，`--step` 调大能少抽；脚本另外限了 `-threads 2`，不会把机器吃满。
+- 拼图（`sheet`）和字幕带（`substrip`）把多帧压成一张图给模型看，省 token。
+- 本地转写、OCR 都在本机跑，不上传、不按次计费；只有取 B 站数据的接口走网络。
+
 ## 模块架构
 
 ```mermaid

package/index.js

@@ -12,7 +12,7 @@
 import { spawn, execFileSync } from 'node:child_process'
 import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, rmdirSync, statSync, writeFileSync } from 'node:fs'
 import { tmpdir, homedir } from 'node:os'
-import { dirname, join, relative } from 'node:path'
+import { dirname, join, relative, basename } from 'node:path'
 import { fileURLToPath } from 'node:url'
 // @deepseek-ai/dsh-tools 是可选 peer：桌面版 autoInstallPeers:false，市场安装时不会自动装上。
 // 缺了只少一个 bili_watch 工具，/bili 命令、插件面板与路由照常工作，不能因此整块加载失败。
@@ -199,6 +199,35 @@ function readTuning() {
   for (const k of TUNING_KEYS) out[k] = tuneOne(k, cfg[k])
   return out
 }
+/**
+ * 读 deps-config.json，坏文件先备份再退回默认值（X-16a，2026-10-28 WB-CN N12 §2 头号）。
+ *
+ * 原来两处写入口都是 `try { cur = JSON.parse(readFileSync(p)) } catch {}`：
+ * 解析失败 cur 变 `{}`，下次改**任意一个**参数就整份写回——ffmpeg 路径、cache 目录、
+ * proj、17 项调优参数全被擦掉。单写者就能触发，不需要并发，用户只会看到「配置莫名其妙没了」。
+ *
+ * 现在：文件不存在 → 默认值（正常）；存在但坏了 → 改名成 `.broken-<ts>` 留档 + 默认值 + 一次告警。
+ * 留档而不是直接拒绝写，是因为拒绝写会让面板「保存」一直失败、用户也不知道该改哪个文件。
+ */
+function readDepsCfgFile(p) {
+  let raw
+  try {
+    raw = readFileSync(p, 'utf8')
+  } catch (e) {
+    if (e?.code !== 'ENOENT') cfgWarning = `${basename(p)} 读取失败：${String(e?.message || e)}`
+    return {}
+  }
+  if (!raw.trim()) return {}
+  try {
+    const j = JSON.parse(raw)
+    return (j && typeof j === 'object' && !Array.isArray(j)) ? j : {}
+  } catch (e) {
+    const bak = `${p}.broken-${Date.now()}`
+    try { renameSync(p, bak) } catch {}
+    cfgWarning = `${basename(p)} 解析失败（${String(e?.message || e)}），原文件已备份为 ${basename(bak)}，本次按默认值继续`
+    return {}
+  }
+}
 /**
  * 参数分层专用写入口：一次读盘 → 按白名单改/删 → 整份写回。
  * 不能复用 writeDepsCfg：它是合并写，删键（面板「恢复默认」）在合并写里删不掉。
@@ -206,8 +235,7 @@ function readTuning() {
  */
 function writeTuning(body) {
   const p = join(DEPS, 'deps-config.json')
-  let cur = {}
-  try { cur = JSON.parse(readFileSync(p, 'utf8')) } catch {}
+  let cur = readDepsCfgFile(p)
   if (!cur || typeof cur !== 'object' || Array.isArray(cur)) cur = {}
   if (!body || typeof body !== 'object') return { ok: true, data: cur }
   let touched = false
@@ -510,7 +538,20 @@ function uiCfg() {
   try {
     const raw = JSON.parse(readFileSync(UI_CFG, 'utf8'))
     return { ...DEFAULT_UI_CFG, ...raw }
-  } catch { return { ...DEFAULT_UI_CFG } }
+  } catch (e) {
+    // X-16a 同族（2026-10-28）：原来坏文件静默回默认值，紧接着 writeUiCfg 就把坏文件覆盖掉——
+    // 用户手改坏的 4 个开关再也找不回来。这里先改名留档（rename 后文件就不存在了，不会重复备份）。
+    if (e?.code !== 'ENOENT') {
+      const bak = `${UI_CFG}.broken-${Date.now()}`
+      try {
+        renameSync(UI_CFG, bak)
+        cfgWarning = `ui-config.json 解析失败（${String(e?.message || e)}），原文件已备份为 ${basename(bak)}，本次按默认值继续`
+      } catch (e2) {
+        cfgWarning = `ui-config.json 解析失败（${String(e?.message || e)}）且备份失败（${String(e2?.message || e2)}），本次按默认值继续`
+      }
+    }
+    return { ...DEFAULT_UI_CFG }
+  }
 }
 function writeUiCfg(patch) {
   const cur = uiCfg()
@@ -862,17 +903,21 @@ function cacheCfg() {
   }
 }
 
+// WB-CN N13（2026-10-28）：原来吞异常、无返回值，三处调用都不看结果——「保存规则」写盘失败仍回
+// 200 {ok:true}，与 BLK-02 同族（BLK-02 只修了 tuning 那条）。现在把结果交出去，调用方按失败处理。
 function writeCacheCfg(days, maxMb) {
   try {
     writeFileSync(CACHE_CFG, JSON.stringify({ days, maxMb }), 'utf8')
-  } catch {}
+    return { ok: true }
+  } catch (e) {
+    return { ok: false, why: String(e?.message || e) }
+  }
 }
 
 /** 合并写 deps\deps-config.json（只动指定字段，保留用户原有配置）。失败返回 {ok:false,error}，不抛。 */
 function writeDepsCfg(patch) {
   const p = join(DEPS, 'deps-config.json')
-  let cur = {}
-  try { cur = JSON.parse(readFileSync(p, 'utf8')) } catch {}
+  const cur = readDepsCfgFile(p)
   const next = { ...cur, ...patch }
   try {
     writeFileSync(p, JSON.stringify(next, null, 2), 'utf8')
@@ -1717,10 +1762,11 @@ function apply(ctx) {
               if (req.method === 'POST' && url.pathname === '/api/bili-watch/cache/clear') {
                 const body = await readJsonBody(req)
                 if (Number.isFinite(body?.days) || Number.isFinite(body?.maxMb)) {
-                  writeCacheCfg(
+                  const wc = writeCacheCfg(
                     Number.isFinite(body?.days) ? Math.max(1, body.days) : cacheCfg().days,
                     Number.isFinite(body?.maxMb) ? Math.max(100, body.maxMb) : cacheCfg().maxMb,
                   )
+                  if (!wc.ok) return sendJson(res, 500, { ok: false, why: `清理规则保存失败：${wc.why || '未知错误'}` })
                 }
                 // A7（2026-10-27 批次8）：先查锁再清理——frames 下若有正在跑的抽帧锁，直接拒绝，
                 //   不再像以前那样「先删完再补一句 warning」（锁外删会跟运行中的抽帧抢目录）。
@@ -1779,16 +1825,19 @@ function apply(ctx) {
                 // A2（2026-10-27 批次8）：面板「保存规则」把 days/maxMb POST 到这里，以前被静默丢。
                 //   落到 cache-config.json（与 /cache/clear 同源），不写进 ui-config.json。
                 let rule = null
+                let cacheErr = null
                 if (Number.isFinite(body?.days) && body.days > 0) {
                   const cur = cacheCfg()
                   const days = Math.max(1, Math.floor(body.days))
                   const maxMb = Number.isFinite(body?.maxMb) && body.maxMb > 0 ? Math.max(100, Math.floor(body.maxMb)) : cur.maxMb
-                  writeCacheCfg(days, maxMb)
+                  const wc = writeCacheCfg(days, maxMb)
+                  if (!wc.ok) cacheErr = wc.why || '未知错误'
                   rule = { days, maxMb }
                 } else if (Number.isFinite(body?.maxMb) && body.maxMb > 0) {
                   const cur = cacheCfg()
                   const maxMb = Math.max(100, Math.floor(body.maxMb))
-                  writeCacheCfg(cur.days, maxMb)
+                  const wc = writeCacheCfg(cur.days, maxMb)
+                  if (!wc.ok) cacheErr = wc.why || '未知错误'
                   rule = { days: cur.days, maxMb }
                 }
                 // 参数分层（阶段B）：五个白名单键写进 deps-config.json，表外的键忽略、不报错。
@@ -1799,6 +1848,7 @@ function apply(ctx) {
                   if (!w.ok) tuneErr = w.why || '未知错误'
                 }
                 if (tuneErr) return sendJson(res, 500, { ok: false, why: `参数保存失败：${tuneErr}` })
+                if (cacheErr) return sendJson(res, 500, { ok: false, why: `清理规则保存失败：${cacheErr}` })
                 return sendJson(res, 200, { ok: true, data: { ...next, ...(rule || {}), tuning: readTuning() } })
               }
               sendJson(res, 404, { ok: false, why: 'not found' })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-bili-watch",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "private": false,
   "description": "把 B 站视频读成文本给 DSH agent 用：元数据、评论、弹幕、字幕、本地转写、抽帧 OCR；支持 b23.tv 短链与 av 号，抽帧缓存目录可换。只读命令零依赖。",
   "type": "module",

package/tools/look.mjs

@@ -1031,19 +1031,13 @@ async function grabFrames(bv, { step = 0, outDir, ffmpeg, fresh = false, p: page
           if (base !== f) continue  // 含路径分隔符，拒绝
           try { unlinkSync(join(dir, f)) } catch {}
         }
-      } else if (m0) {
-        // 老 manifest：存在但没有 files 字段——按命名兜底删本工具产物（peek-NN / 纯数字帧 / ${bv}-NN.jpg）
-        const ownRe = new RegExp(`^${bv}-\\d+\\.jpg$`)
-        for (const f of jpgs()) {
-          if (/^peek-\d+\.jpg$/.test(f) || /^\d+\.jpg$/.test(f) || ownRe.test(f)) {
-            try { unlinkSync(join(dir, f)) } catch {}
-          }
-        }
       } else {
-        // A5（2026-10-27 批次8）：连 manifest 都没有——说明这个目录不是本工具跑出来的缓存，
-        //   多半是用户自己的 --out 目录（里面可能放着用户自己的 1.jpg）。绝不能按命名猜着删，
-        //   一个都不碰，只打一行提示。
-        say('没有 manifest，跳过清理（目录里的文件一概不动）')
+        // A5（2026-10-27 批次8）+ X-01（2026-10-28）：没有 manifest，或 manifest 里没有 files 清单，
+        //   都说明「这目录不是本工具这一次跑出来的」——绝不能按文件名猜着删。
+        //   原来老 manifest（有文件、无 files）走命名兜底删 数字.jpg 与 peek-NN.jpg，
+        //   用户的 1.jpg / 2.jpg 正好被第一条命中：`--fresh --out <用户目录>` 实测会把它们删掉。
+        //   想在旧缓存上重抽，删掉整个缓存目录即可；这里一律不碰。
+        say(m0 ? 'manifest 没有 files 清单，跳过清理（目录里的文件一概不动）' : '没有 manifest，跳过清理（目录里的文件一概不动）')
       }
     }