@pls-compile-owo/fisheye 0.8.3 → 0.8.5

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 规范与 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.8.5] - 2026-11-14
+
+### Added
+
+- **片头广告识别**：视频开头 90s 内出现「接广/金主/恰饭/商单/赞助」等强信号弹幕（哪怕 1 条）时，判定 0-60s 为片头广告段（high）。第四个人工真值样本 BV1j6G16dEBF（0-57s 片头广告）暴露的漏报。
+
+## [0.8.4] - 2026-11-14
+
+### Changed
+
+- **广告段检测增强**（三条人工真值样本校准）：
+  - 新增「关键词聚类」信号：广告口播段观众常刷「金主/恰饭/商单」，不依赖密度低谷（42s 短广告常被漏）。
+  - 低置信度段最小长度 60s → 45s（覆盖 40-60s 短广告）。
+  - 密度低谷段延伸进片头/片尾时改为**截断**（原逻辑整段丢弃会连带丢掉中间真实广告）。
+  - 低置信度段向两侧各扩 15s（广告开始前观众还没反应，低密度段偏短）。
+- golden 广告真值样本：BV1WhaA6hE7s / BV1LD421H7u4 / BV1qdb16eEF5（覆盖率分别 100%/90%/100%，0 误报）。
+
 ## [0.8.3] - 2026-11-14
 
 ### Fixed

package/lib/danmaku.mjs

@@ -27,18 +27,50 @@ export function detectAdSegments(danmaku, duration, bucketSec = 30, stepSec = 10
     if (last && d.s - last.to <= stepSec * 2) last.to = d.s + bucketSec
     else spans.push({ from: d.s, to: d.s + bucketSec, count: 0 })
   }
-  const long = spans.filter((x) => x.to - x.from >= 60)
-  if (!long.length) return []
-
   const hits = danmaku.filter((d) => AD_SEGMENT_SIGNAL.test(d.text))
-  const out = long.map((sp) => {
+  // 关键词聚类（补充信号）：广告口播段观众常刷「金主/恰饭/商单」等，且此时弹幕密度
+  // 未必低谷（观众在吐槽广告）——只看密度会漏掉 40-60s 的短广告。
+  const hitTimes = hits.map((h) => h.t).sort((a, b) => a - b)
+  const kwSpans = []
+  for (const tt of hitTimes) {
+    const last = kwSpans[kwSpans.length - 1]
+    if (last && tt - last.to <= 60) last.to = tt
+    else kwSpans.push({ from: tt, to: tt })
+  }
+  const kwCandidates = kwSpans.filter(
+    (s) => s.to - s.from >= 10 && hitTimes.filter((x) => x >= s.from && x <= s.to).length >= 2)
+
+  // 低置信度段的最小长度：45s（覆盖 40-60s 的短广告；更短的段不判，宁漏勿错）
+  const long = spans.filter((x) => x.to - x.from >= 45)
+  if (!long.length && !kwCandidates.length) return []
+
+  // 合并候选：密度低谷段 ∪ 关键词聚类段（重叠或相近的并成一段）
+  const candidates = []
+  for (const sp of [...long, ...kwCandidates]) {
+    const last = candidates.find((c) => sp.from <= c.to + 30 && sp.to >= c.from - 30)
+    if (last) {
+      last.from = Math.min(last.from, sp.from)
+      last.to = Math.max(last.to, sp.to)
+    } else candidates.push({ from: sp.from, to: sp.to })
+  }
+  // 片头广告：视频开头 90s 内出现「接广/金主/恰饭」等强信号弹幕（哪怕只有 1 条），
+  // 视为片头口播广告候选（0 到信号时间+20s）。片头广告常无密度低谷（观众刚到还在刷弹幕）。
+  const STRONG_AD = /金主|恰饭|商单|接广|硬广|软广|赞助/i
+  const headStrong = danmaku.filter((d) => d.t < 90 && STRONG_AD.test(d.text))
+  if (headStrong.length) {
+    // 片头广告通常覆盖整个片头（30-60s 口播），固定 0-60s 段
+    const headEnd = 60
+    if (headEnd > 0) candidates.push({ from: 0, to: headEnd, headAd: true })
+  }
+
+  const out = candidates.map((sp) => {
     const near = hits.filter((h) => h.t >= sp.from - 20 && h.t <= sp.to + 20)
     // dens 是「30s 窗、10s 步长」的滑窗，同一条弹幕会被相邻 3 个桶各计一次。
     // 分母必须用「实际桶数」而不是 (时长/bucketSec)，否则 ratio 虚高约 3 倍
     // （出现 lowDensity = -25% 的负值，因为 ratio > 1）
     const segBuckets = dens.filter((d) => d.s >= sp.from && d.s < sp.to)
     const total = segBuckets.reduce((s, d) => s + d.n, 0)
-    const ratio = total / Math.max(1, segBuckets.length) / median
+    const ratio = segBuckets.length ? total / segBuckets.length / median : 0
     return {
       from: sp.from,
       to: sp.to,
@@ -51,7 +83,16 @@ export function detectAdSegments(danmaku, duration, bucketSec = 30, stepSec = 10
   })
   // 片头/片尾 60s 内的「低置信度」段丢弃：开头结尾弹幕本来就少，不是广告信号。
   // 高置信度（有广告关键词）不受此限——片头口播广告仍是广告。
-  return out.filter((s) => s.confidence === 'high' || (s.from >= 60 && s.to <= duration - 60))
+  // 低置信度段截断到 [60s, duration-60s] 再判定：密度低谷可能延伸进片头/片尾的正常低弹幕区，
+  // 整段丢弃会连带丢掉中间的真实广告（首次真值样本 BV1qdb16eEF5 暴露）。
+  const clamped = out.map((s) => {
+    if (s.confidence === 'high') return s
+    // 向两侧各扩 15s：广告口播开始前观众还没反应，低密度段会比真实广告短
+    const from = Math.max(s.from - 15, 60)
+    const to = Math.min(s.to + 15, duration - 60)
+    return { ...s, from, to, dur: to - from, ts: `${fmt(from)}-${fmt(to)}` }
+  })
+  return clamped.filter((s) => s.confidence === 'high' || s.dur >= 45)
 }
 
 // 按时间桶聚合，找「观众最激动」的时段。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pls-compile-owo/fisheye",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "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": {