弹幕照开,噪音别来。
四个开关:剧透 / 反串黑 / 广告 / 基本盘。还想屏蔽什么,写一句话,点「添加」。在 B 站原页面过滤评论和弹幕。
本仓库是 littlewindy123/jev-bili-filter(MIT,Chromium MV3)的 Firefox 移植版,由 Ray4AI 维护。上游代码与设计原样保留,移植与新增功能见下。
文档:安装 · 签名与自动更新 · Firefox 移植笔记 · 验证记录
| 能力 | 说明 |
|---|---|
| Firefox 140+ 原生支持 | MV3,带 browser_specific_settings.gecko(含 update_url),可直接提交 addons.mozilla.org 自签名分发 |
| 本地关键词 / 豁免词 | 不联网、立即生效、不消耗 API 额度。关键词命中直接屏蔽;豁免词优先于一切规则 |
| 不用 API Key 也能用 | 只配关键词时扩展照常工作(评论、DOM 弹幕、Canvas 弹幕都按关键词过滤) |
| Canvas 弹幕逐条过滤 | 上游只能整层隐藏 Canvas 弹幕;本版在页面世界改写 seg.so 弹幕分片,逐条丢弃命中的弹幕,其余字节原样保留 |
| 拦截记录 + 误判回退 | 设置页列出最近 100 条被屏蔽内容(来源、置信度),一键「加为豁免」 |
| 独立开关 | 评论 / 弹幕分开控制;图标角标显示本页已屏蔽数量 |
| 更省的批量判断 | 规则与视频上下文只在 state 里发一次,每个条目只问一句;实测每条约 180 输入 token(上游约 578,≈3.2× 更省),答案一致 |
| 可观测的用量 | 记录 JEV 请求次数与输入 token,估算花费;设置页可重置 |
Canvas 弹幕(新版播放器默认渲染方式)在旧版里只能整体隐藏。本版会拦截 https://api.bilibili.com/x/v2/dm/web/seg.so 的 fetch 响应,解析 protobuf、问过 JEV 之后把命中的 DanmakuElem 从分片里删掉再交给播放器;无法逐条过滤的传输方式(XHR 等)会自动退回「整体隐藏」,也可以在设置里固定为整体隐藏。
需要 Firefox 140 或更高(ESR 140+ 亦可)。
- 开发/自用临时安装:
about:debugging#/runtime/this-firefox→ 「临时载入附加组件」→ 选择仓库根目录的manifest.json。重启浏览器后失效。 - 长期使用:把
dist/jev-bili-filter-<版本>.zip(也可以直接从 Releases 下载同一个包)提交到 addons.mozilla.org 并选择 「On your own」(自行分发),Mozilla 签名后下载.xpi,在 Firefox 里打开该文件即可安装(详见 docs/AMO.md)。因为清单里写了update_url,之后用scripts/update_manifest.py发布新版本时,Firefox 会自动更新。 - Chrome / Edge:同一份清单同时声明了
service_worker,在 Chrome 121+ 下也能直接载入(会忽略 Firefox 专属字段)。
| 你想做什么 | 操作 |
|---|---|
| 看剧时少点剧透 | 打开「剧透」 |
| 不想看捧杀和反讽招黑 | 打开「反串黑」 |
| 不想被推广打扰 | 打开「广告」 |
| 不想看无条件站队和口号复读 | 打开「基本盘」 |
| 屏蔽某个固定说法 | 设置页 →「关键词」,填「加群购买」,立即生效且不耗额度 |
| 某条被误判 | 设置页 →「拦截记录」→「加为豁免」 |
| 想看自己的偏好 | 面板里输入「屏蔽提前报比赛结果」一句话,点「添加」 |
选好后继续看视频。命中的评论和弹幕自动隐藏,关闭总开关即可恢复。
面板里展开「连接 JEV」,粘贴自己的 TypeSafe 官方 API Key,点「保存并连接」。Key 只保存在本机扩展存储里,不写入源码、日志或本仓库。若 Firefox 没有授予 api.typesafe.ai 的访问权限,设置页里会出现「授权访问 api.typesafe.ai」按钮。
不想花钱也可以只用关键词;添加关键词后扩展会自动开启本地过滤。
TypeSafe 只有 POST /v1/systemone 一个端点:一次请求提交一个 state 和一组 questions,按输入 token 计费、输出免费(jev-latest 折合 $0.042 / 百万 token)。同一请求里的问题并行独立求解,state 只计费一次 —— 所以把「视频上下文 + 规则 + 待判断条目」放进 state、每条只留一句短问题,就是最省的写法(官方 cookbook 里这一步能省 12 倍)。
本版请求形状:
{
"model": "jev-latest",
"state": {
"video": {"title": "...", "description": "...", "video": "/video/BV..."},
"active_filters": ["剧透:...", "广告:..."],
"guidance": "Match meaning, not just keywords. ...",
"entries": [{"id": "item_0", "kind": "comment", "text": "结局主角死了", "parent": ""}]
},
"questions": {
"item_0": {"type": "choice",
"instructions": "Judge only the entry whose id is \"item_0\" in `state.entries`: ...",
"criteria": {"block": "...", "keep": "..."}}
}
}实测(同一批中文样本、同一账号、jev-1.13.0):
| 批次 | 上游 0.1.0(每条问题都带完整规则) | 本版(规则进 state) | 省 |
|---|---|---|---|
| 11 条 | 6,585 token(599/条),860 ms | 2,541 token(231/条),377 ms | 2.6× |
| 48 条 | 27,748 token(578/条),946 ms | 8,645 token(180/条),751 ms | 3.2× |
按 48 条/次估算:约 $0.0076 / 千条(上游约 $0.0243)。再加上三层缓存与去重——本地关键词先判(不花钱)、SHA-256 内容缓存 24 小时、同批并发去重——实际花费还会更低:
- 一批最多 48 条、总字符 12,000(留在 64k/32k 上下文预算内)
- 429/529 按
Retry-After退避,401/402/403 冷却 60 秒,422 视为请求错误不盲目重试 - 设置页显示累计请求次数与输入 token,可随时重置统计
想让花费再降一档,可以把每个条目的 choice 问题换成 noul 是/否问题(实测 132 token/条,样本上答案与 choice 完全一致);本版默认保留 choice,因为上游已验证过它的准确率,且能拿到概率分布。
- 只有评论/弹幕文本、其被回复的父评论、视频标题与简介会发往
api.typesafe.ai做判断;关键词命中的内容留在本机。 - API Key 存在扩展的
storage.local,Chrome 下额外用setAccessLevel('TRUSTED_CONTEXTS')防止网页上下文读取(Firefox 未实现该 API,内容脚本也不会去读 Key)。 - 拦截记录只存本机,最多 100 条,可关闭、可清空。
- 扩展不上报任何遥测。
npm install
npm test # 单元测试(判定、请求形状、protobuf 分片重建)
npm run test:browser # Chromium:弹窗/设置页 UI + Shadow DOM 评论与 DOM 弹幕过滤
npm run test:firefox # Firefox:临时安装 + 本地夹具,验证 MAIN world、:host() 守卫、seg.so 改写
npm run test:live # 可选:用真实 API Key 跑 13 条样本(需 TYPESAFE_API_KEY)
npm run build # dist/jev-bili-filter-<版本>.zip + dist/unpacked/
npm run lint:firefox # web-ext lint(自托管模式)证据文件:docs/browser-test.json、docs/firefox-test.json、docs/live-test.json、docs/*.png。细节见 docs/TESTING.md。
python3 scripts/package.py # 生成提交用的 zip
npx web-ext sign --channel=unlisted \ # 或走 AMO 网页「On your own」
--source-dir dist/unpacked --artifacts-dir dist
python3 scripts/update_manifest.py --xpi dist/*.xpi
git add xpi updates.json && git commit -m "release" && git pushupdates.json 就是清单里 browser_specific_settings.gecko.update_url 指向的文件(本仓库默认指向 raw.githubusercontent.com/Ray4AI/jev-bili-filter/main/updates.json)。Firefox 只在安装时读取一次 update_url,所以这个地址要保持稳定:换仓库或换域名前,先把旧地址继续托管一段时间。
MIT(见 LICENSE)。上游 © 2026 littlewindy123 and Bili Filter contributors;Firefox 移植与新增功能同样以 MIT 发布。JEV / TypeSafe 是 TypeSafe AI 的服务,本项目与 B 站、TypeSafe 均无隶属关系。
