Skip to content

About

浏览器增强工具集(MV3):X 的隐私遮罩与一键屏蔽,按站点独立开关。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

NetKit

浏览器增强工具集(Chrome / Edge · Manifest V3)——针对具体网站开发额外功能,功能与开关都按网站独立管理。 目前内置 X.com / Twitter 的两个增强功能,无服务端、无数据采集。

页面内效果:隐私遮罩 + 一键屏蔽按钮

功能

1. 隐私遮罩(mask)

投屏、录屏、公开场合下,一键遮住页面上的登录账号信息。三种模式:

模式 效果 适用场景
模糊 对账号区域做模糊处理 默认,保留页面观感
遮块 用纯色块覆盖,可选黑 / 灰 / 白 需要完全不可辨识
替换 覆盖为中性色块 + ··· 视觉最干净,不显突兀
  • 不阻断交互:遮罩只是视觉遮挡,被遮的账号按钮仍然可以点击,不需要「先关遮罩才能切账号」
  • 覆盖范围:默认遮左侧边栏的账号切换按钮与移动端底栏的个人入口;其他位置的账号信息(发帖框头像、个人主页头部等)可在设置页的「附加遮罩区域」里填 CSS 选择器补齐
  • 全局快捷键:Alt + Shift + M 直接切换遮罩(默认值,可在 chrome://extensions/shortcuts 改),不用打开弹窗

设置页(浅色)    设置页(深色)

2. 一键屏蔽(quickblock)

在每条内容卡片的「更多」(···)按钮旁注入一个一键屏蔽按钮:

  • 点击后自动完成 打开菜单 → 点击屏蔽
  • 默认保留原生的二次确认弹窗,可以在设置里改成「点击即完成」
  • 跳过确认时,屏蔽完成后页面左下角会给出 「已屏蔽 @xxx · 撤销」 提示,点撤销自动走一遍取消屏蔽
  • 按钮的 tooltip 会带上对方账号(一键屏蔽 @xxx),和 X 自己的「···」在静息态下也有明显的明暗差异
  • 只依赖 X 的 data-testid 定位,不使用随机类名

站点列表

扩展弹窗的首页是「已增强的网站」列表,点进去才是该网站的功能设置;功能只对当前标签页所属的网站开放,不相关的网站会置灰并说明原因。 只注册了一个站点时,弹窗会直接进入该站点的设置页(返回按钮仍可回到列表)。

已增强网站列表

安装

目前通过「加载已解压的扩展程序」安装。

git clone https://github.com/oxyuan/chrome-netkit-plugin.git
  1. 打开 chrome://extensions(Edge 为 edge://extensions)
  2. 打开右上角 开发者模式
  3. 点击 加载已解压的扩展程序,选择刚才 clone 下来的目录
  4. 打开或刷新 x.com / twitter.com

修改代码后:在扩展管理页点刷新即可,不需要手动刷新 X 页面——弹窗会自动检测页面脚本是否失效并重新注入(见下文)。

使用

  1. 点击工具栏上的 NetKit 图标
  2. 在「已增强的网站」里点进 X / Twitter(只注册了一个站点时会直接进入)
  3. 右上角开关是该网站的总开关;下面的卡片分别是隐私遮罩与一键屏蔽
  4. 设置即时生效,无需刷新页面;设置页顶部会显示「设置已生效」,说明页面脚本已经连上
  5. 只想快速开关遮罩时,直接按 Alt + Shift + M

权限与隐私

权限 用途
storage 保存设置(chrome.storage.sync)
activeTab 读取当前标签页地址,判断是否属于已增强的网站
scripting 页面脚本失效时重新注入(见「页面脚本自修复」)
https://x.com/*、https://twitter.com/* 仅在这两个域名注入脚本
  • 不含任何分析与上报代码,不产生任何网络请求,不读取页面内容
  • 设置存放在浏览器自身的同步存储里,卸载扩展即消失

项目结构

.
├── manifest.json          # MV3 清单
├── background.js          # Service Worker:只处理全局快捷键切换遮罩
├── content.js             # 隐私遮罩:标记账号区域,切换 hv-blur / hv-block / hv-replace
├── twitter-block.js       # 一键屏蔽:注入并驱动屏蔽按钮
├── styles.css             # 注入到页面的样式(遮罩 + 按钮 + 页面内提示条)
├── popup/
│   ├── popup.html         # 两级页面:站点列表 / 单站点设置
│   ├── popup.css          # 单色设计系统(浅色 / 深色自适应)
│   └── popup.js           # 状态管理、存储读写、页面脚本握手
├── gen_icons.js           # 零依赖图标生成脚本
├── icons/                 # 生成的图标
├── test/                  # 零依赖冒烟测试(假 DOM 里真跑脚本)
└── docs/                  # 截图

存储结构

所有配置挂在 chrome.storage.sync 的 sites 键下,按网站分组:

{
  sites: {
    'x.com': {
      enabled: true,
      style: 'blur',          // blur | block | replace
      blockColor: 'black',    // black | gray | white
      blockConfirm: true,     // true = 保留原生确认弹窗
      maskExtra: '',          // 附加遮罩选择器,每行一个
    }
  }
}
  • enabled 是站点级总开关(该网站的全部增强功能),没有跨站点的全局开关
  • 旧版(1.3.0 之前)的全局扁平配置会在首次打开弹窗时自动迁移
  • chrome.storage.sync 单键上限 8KB,写入失败时弹窗底部会显示「保存失败:…」,不会静默丢弃

页面脚本自修复

扩展刷新或更新后,已经打开的页面里跑的还是旧 content script,而它留下的 <html> class 会一直生效——现象就是「设置怎么点都不生效,页面永远停在模糊」。

因此弹窗打开时会做一次握手:发 NK_PING → 没有响应或版本号不一致 → 用 chrome.scripting 重新注入 styles.css + 两个 content script;仍失败则在设置页顶部提示并给出一键刷新按钮。

两个 content script 不使用「已加载就 return」的一次性守卫——同一个扩展的 isolated world 在同一标签页里是复用的,那种守卫会让重新注入变成空操作。改为重入式:

window.__nkMask?.teardown?.();   // 先断开上一实例的 observer / 定时器
// 再重新初始化
window.__nkMask = { version, alive, teardown };

版本号只有 manifest.json 一处,脚本里通过 chrome.runtime.getManifest().version 读取,不需要手工同步。 NK_PING 由 content.js 单独应答,并在响应里汇报一键屏蔽模块是否还活着({ ok, v, mask, block }),避免只探到半个脚本。

开发

无构建步骤,克隆下来即可加载调试。

# 重新生成图标(零依赖,仅用 Node 内置 zlib 手写 PNG)
node gen_icons.js

# 跑冒烟测试(零依赖,在假 DOM 里真跑 content script 与 popup)
node test/run.mjs

测试文件:

  • test/fake-dom.mjs —— 极简 DOM 桩(零依赖,不引 jsdom)
  • test/content-smoke.mjs —— 遮罩标记/状态切换/附加选择器/一键屏蔽与撤销/按钮被 React 冲掉后重注入/重入式自修复
  • test/popup-smoke.mjs —— 渲染路径、默认值映射、交互写入、页面脚本握手与自修复、非目标站点的降级展示

改动 content script / popup 的交互逻辑后请顺手跑一遍,这两份用例把「重入式自修复」「菜单项限定在 Dropdown 内」「开关正向映射」这些容易回退的约束固定下来了。

新增一个网站的增强功能

  1. 在 popup/popup.js 的 SITES 注册表加一条:{ key, name, hosts, features }
  2. 在 popup/popup.html 里加上对应的 [data-feature] 卡片
  3. 写对应的 content script 与样式,并在 manifest.json 里补上 matches / host_permissions
  4. 新脚本必须用 IIFE 包裹,并在开头 window.__nkXxx?.teardown?.(),用重入式而非一次性守卫

已知限制

  • Chrome 弹窗的圆角与透明背景由浏览器控制,扩展无法修改,只能靠「内容不贴边 + 大圆角卡片」实现柔和观感
  • X 前端随时可能调整 DOM,定位全部依赖 data-testid,失效时需要跟进(菜单定位已优先限定在 [data-testid="Dropdown"] 内,容器改版时会退回全局查找)
  • 默认遮罩目标是 X 的侧边栏账号按钮与移动端底栏个人入口;发帖框头像、个人主页头部等位置没有稳定的 data-testid,需要用「附加遮罩区域」自行补选择器
  • 仅在 Chromium 系浏览器(Chrome / Edge)验证
  • 从 1.3.x 升到 1.4.x 时,页面里旧脚本的 observer 无法被拆除(旧版没有 teardown 接口),它会空转到页面刷新为止;因为它的 chrome.* 已失效、不再响应配置变更,所以不会有可见影响,刷新一次页面即彻底干净

English

NetKit is a small Manifest V3 browser extension that enhances specific websites — each site gets its own features and its own on/off switch, with no global toggle.

Built-in enhancements for X.com / Twitter:

  • Privacy mask — blur, solid-color block (black/gray/white), or a neutral ··· cover for your logged-in account area, so it stays hidden while screen sharing. Configurable per site, plus extra CSS selectors for other account areas, and a global Alt + Shift + M toggle. The mask is purely visual: masked elements stay clickable.
  • Quick block — injects a one-click block button next to every post's "more" (···) button, keeping the native confirmation dialog by default, with an undo toast when confirmation is skipped.

No build step, no network requests, no telemetry. Load the folder unpacked from chrome://extensions. Settings live in chrome.storage.sync under a sites key.

License

MIT

About

浏览器增强工具集(MV3):X 的隐私遮罩与一键屏蔽,按站点独立开关。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages