彻底清除 Outlook 网页版伪装成邮件的广告块(含外层空白容器)、修正广告造成的虚假未读计数、隐藏右侧广告提示栏。不依赖随机类名,适配 SPA 与虚拟滚动。
彻底清除 Outlook 网页版伪装成邮件的广告块(含外层空白容器)、修正广告造成的虚假未读计数、隐藏右侧广告提示栏。不依赖随机类名,适配 SPA 与虚拟滚动。
一个 ScriptCat用户脚本,用于清除 Outlook 网页版里伪装成正常邮件的广告条目,以及它带来的一系列副作用。
单文件实现,全部逻辑在
main.js,无外部依赖、无构建步骤。
| 问题 | 表现 | 本脚本的处理 |
|---|---|---|
| 广告伪装成邮件 | 发件人「Microsoft Outlook」、主题「升级帐户」、右上角标「广告」,混在收件箱列表里 | 隐藏整行 |
| 隐藏后仍有空白块 | 广告行外面套了 4~5 层容器,只隐藏内层会留下一段占位高度 | 逐层向上隐藏所有「只含广告」的包装容器 |
| 未读计数虚高 | 广告被计入未读,文件夹树显示虚假的「1」 | 从 title 解析未读数并扣掉本页广告条数,徽标归零并隐藏 |
| 右侧广告提示栏 | 「你似乎正在使用广告阻止程序…」+ 追踪像素 | 整块隐藏 |
右侧广告栏和追踪像素(c.live.com/c.gif)也在清除范围内。
main.js 的全部内容粘贴进去并保存启用。脚本在以下域名自动运行,无需手动触发:
outlook.live.com *.outlook.live.com
outlook.office.com outlook.office365.com
outlook.mail.microsoft.com
依赖的 GM API:GM_getValue、GM_setValue、GM_registerMenuCommand、GM_unregisterMenuCommand、GM_notification。若某个 API 未注入,存储会自动降级到 localStorage、菜单会静默跳过,拦截逻辑照常工作。运行时机为 document-start。
⚠️ 升级覆盖安装时:ScriptCat 里已有的旧脚本不会自动更新,必须把新代码覆盖粘贴到原来那条脚本上并保存,再刷新页面。
OWA 的类名(Ogt7j、dOD_h、t4nii 等)是构建时随机生成的,每次发版都会变,因此脚本完全不依赖类名,只用内容特征:
img[src*="ads-olk-icon"](或 /images/ads-),与界面语言无关。/assets/ads/ 图标、adbarmetrochoice.svg,以及「广告阻止程序 / 广告选择」文案。[role="treeitem"] 的 title="…(N 个未读)" 与「未读」辅助文本。行定位:头像列与发件人/广告标签列是兄弟节点,从特征节点向上冒泡,「发件人文本第一次出现的祖先」就是最小的一整行;再叠加规模校验(文本 ≤200 字、节点 ≤200 个),确保不会把整个邮件列表判成广告行。
消除空白块:从广告行根开始逐层向上,只要该层的其他子节点都是空文本或广告短语,就一并隐藏,最多 8 层;一旦遇到真实邮件或列表容器立即停止。如果广告位里后来被 React 插入了真实邮件,外层容器会自动恢复显示(自内向外处理,规避祖先先判定的陷阱)。
运行调度:MutationObserver 监听 childList 与 src 属性变化(覆盖 SPA 切文件夹、虚拟滚动、图片懒加载),80ms 节流合并扫描,另有每 3 秒一次的深度轮询兜底。iframe 里只执行拦截,不重复注册菜单和弹通知。
在 ScriptCat 扩展菜单里可以看到以下命令:
| 菜单项 | 作用 |
|---|---|
| 暂停拦截 / 恢复拦截 | 暂停时恢复所有已隐藏的元素和未读数 |
| 切换为「物理移除」/「隐藏」 | 切换 DOM 处理方式,默认隐藏 |
| 修正未读计数:开 / 关 | 关闭时把 title 与徽标还原成服务器原值 |
| 清除右侧广告栏:开 / 关 | 单独控制侧栏清理 |
| 自动点击广告删除按钮:开 / 关 | 默认关闭,见下方说明 |
| 输出拦截统计 | 累计拦截行数、清除栏数、模拟删除次数、本页广告条数 |
| 调试日志:开 / 关 | 在控制台打印每次命中的元素与判断依据 |
所有开关会持久化保存(键前缀 oab_),刷新页面后保持。
首次安装的默认值在 main.js 顶部 DEFAULTS,之后以菜单里的持久化值为准。想改默认值可直接编辑:
| 字段 | 默认值 | 说明 |
|---|---|---|
enabled |
true |
是否启用拦截 |
mode |
'hide' |
hide = display:none;remove = 从 DOM 移除 |
fixUnread |
true |
修正虚假未读计数 |
hideSideAds |
true |
清除右侧广告栏与追踪像素 |
autoDismiss |
false |
模拟点击广告自带的「删除」按钮 |
pollInterval |
3000 |
兜底轮询间隔(毫秒),0 表示关闭 |
debug |
false |
调试日志 |
其他可调常量:MAX_UP(找行最大上溯层数,12)、MAX_CLIMB(折叠包装最大层数,8)、DEBOUNCE(扫描节流,80ms)、AD_ICON / AD_LABEL / SIDE_ICON / SIDE_TEXT(识别特征)。
remove() 由 React 管理的行节点,后续 diff 时可能触发 removeChild 报错。隐藏模式已把整块连同外壳全部设为不可见,视觉上没有空白。确需真删节点可在菜单切换,但物理移除后切回隐藏,已删的行要等页面重新渲染才会回来。data-oab-title-raw / data-oab-title-fixed 记录原始值,React 覆盖 title 后会自动重算且不重复扣减。只处理收件箱(data-folder-name="收件箱" / Inbox 或 title 以之开头)。title="删除",可让服务端也把广告从未读中移除。请自行确认后再启用。data-oab-ad(广告行)、data-oab-box(外壳)、data-oab-panel(侧栏)、data-oab-badge(徽标)等属性,方便在 DevTools 里核对脚本命中了哪一层。| 现象 | 建议 |
|---|---|
| 还有残留空白块 | 在 DevTools 里搜 data-oab-ad,看标记落在哪一层、外层还剩几层没被折叠;把运行后的 DOM 片段发出来,通常调 MAX_CLIMB 或 climbAndHide 的判定即可 |
| 页面内容被误隐藏 | 先在菜单「暂停拦截」确认能否恢复,再开「调试日志」查看命中的候选容器 |
| 未读数没变 | 确认「修正未读计数」为开;title 需为「N 个未读」或「N unread」格式 |
| 广告完全没被识别 | 微软可能更换了广告图标 URL,兜底文案通道通常仍生效;可顺手更新 AD_ICON 常量 |
| 想确认脚本在跑 | 控制台会输出启动信息;菜单「输出拦截统计」可看计数 |
node --check main.js
项目本身没有运行时依赖。回归测试使用 jsdom 按真实抓取的 DOM 层级构造夹具(含多层外壳、两处收件箱树节点、右侧广告栏),覆盖:空白容器逐层隐藏、真实邮件零误伤、React 覆盖后未读重算、真实未读与广告混合、容器插入真实邮件后恢复、物理移除模式、各开关单独关闭。测试依赖装在系统临时目录,不在本仓库内。
MIT