zerozen

项目概述

零真（ZeroZen）是一款纯本地运行的跨浏览器扩展，把广告弹窗净化与视频下载合二为一：规则引擎负责清除广告与弹窗，AI 识别补足规则覆盖不到的新花样，下载工具箱负责把视频完整保存。它没有服务器、没有账号。

核心能力

• 四层协同净化：网络层 declarativeNetRequest 拦截、外观层 CSS 隐藏移除、弹窗守护与信息流空位回填
• 内置 41 个规则包、7283 条规则，按分组独立开关
• 规则订阅：10 个预设源，支持 Adblock、hosts、纯域名与 JSON 格式
• AI 自主识别：用自填的 OpenAI 兼容接口识别原生广告与假下载按钮，默认关闭
• 点选即规则：Alt+Z 选中页面元素即可生成隐藏、移除或放行规则
• 下载工具箱：视频嗅探、m3u8 解密合并、分片级断点续传与按类型归档
• 阅读模式与纯净浏览，一键进入无干扰阅读
• 内网友好：私网、NAS 与在线文档默认不启用
• 中英文双语支持

适用人群

• 想净化网页广告与弹窗的 Chrome、Firefox、Safari 用户
• 需要下载网页视频的用户
• 注重隐私、偏好纯本地工具的用户

快速上手

1. 下载本仓库或克隆到本地
2. Chrome / Edge / Brave / Arc：打开 chrome://extensions 开启开发者模式并加载 dist/chrome
3. Firefox 128 及更高版本：临时载入 dist/firefox/manifest.json，或安装 dist 中的 xpi
4. Safari（macOS 13 及以上）：执行 npm run build 与 npm run build:safari，在 Xcode 中运行并启用扩展
5. 使用快捷键 Alt+Z 点选元素屏蔽，Alt+A 对当前页进行 AI 识别

核心优势

• 无后端，不收集不上传任何浏览数据，拦截由浏览器 declarativeNetRequest 引擎完成
• 内置规则量大，覆盖国内外众多站点
• AI 识别只发送元素结构化描述，不上传正文、截图与 Cookie
• 功能免费，内置规则包为原创整理

系统要求

• 操作系统：Windows、macOS、Linux（Chrome 105 及以上、Firefox 128 及以上、Safari 需 macOS 13 及以上）
• 支持架构：随浏览器而定
• 额外依赖：构建与 Safari 打包需 Node.js；AI 识别需自备 OpenAI 兼容接口的 Key

注意事项

• 快扫看不到 JS 动态插入的广告，YouTube 视频内广告策略极少数情况会有一瞬画面
• 下载有边界：m3u8 仅支持 AES-128，不支持 SAMPLE-AES 与 DRM，多线程分段上限 2GB
• AI 识别默认关闭，需自行配置 API Key
• Chrome Web Store 版本仍在审核中