Repository navigation
v2.0.7 - 彻底根治视频总结错位与缓存污染,增加缓存健康自检与时序锁
🐛 缺陷彻底根治与系统稳健性加固 (v2.0.7)
本次更新针对特定视频(如长视频、无外挂字幕视频)出现总结内容与视频主题错位(例如闪存视频出现火锅店猝死总结)、以及脏缓存无法自动淘汰的问题进行了排查与全链路防御加固:
-
缓存有效性与内容一致性健康自检 (
isCachedSummaryValid):- 杜绝“命中 key 即盲信返回”的缺陷,读取缓存时自动进行多重自检:
- 校验
bvid与cid精准匹配; - 校验
highlights要点数组非空且有效; - 视频标题一致性校验:深度比对缓存记录标题与当前页面标题,清洗噪音标记后若存在语义冲突立即废弃;
-
时长覆盖率与截断防范:对于时长
$\ge 10$ 分钟的视频,若总结时间戳仅停留在开篇且覆盖率不足 15%,判定为异常截断脏缓存自动驱逐。
- 校验
- 杜绝“命中 key 即盲信返回”的缺陷,读取缓存时自动进行多重自检:
-
脏缓存主动销毁与启动级自愈体系 (
DELETE_CACHED_SUMMARY):- 新增单视频缓存销毁 RPC,物理删除存储 key 并同步清洗 LRU 缓存索引;
- 在前端遇到自检失效、无官方/AI字幕、解析失败或用户手动重试时,立即触发后台物理销毁,杜绝脏数据滞留;
- Background 启动安装时自动清除受污染的历史残留错位 key。
-
请求令牌单调自增防乱序锁 (
requestIdRef):- 在前端引入请求代币锁,在快速连续切换视频时,所有异步点(解析视频、查缓存、取字幕、LLM 请求)严格校验请求代币,彻底杜绝慢请求覆盖新视频导致的串流与乱序。
-
大模型 Prompt 标题-字幕强相关校验:
- 在大模型系统提示词中增加第 4 条铁律约束:若字幕与标题完全脱节,强制返回错误拒绝生成,并在前端安全拦截。
🧪 自动化测试
- 12 个测试套件,100 项单元测试全部通过 (100% Pass),覆盖缓存淘汰、自检校验、时序乱序及长视频覆盖率判定。