浏览器增强工具集(Chrome / Edge · Manifest V3)——针对具体网站开发额外功能,功能与开关都按网站独立管理。 目前内置 X.com / Twitter 的两个增强功能,无服务端、无数据采集。
投屏、录屏、公开场合下,一键遮住页面上的登录账号信息。三种模式:
| 模式 | 效果 | 适用场景 |
|---|---|---|
| 模糊 | 对账号区域做模糊处理 | 默认,保留页面观感 |
| 遮块 | 用纯色块覆盖,可选黑 / 灰 / 白 | 需要完全不可辨识 |
| 替换 | 覆盖为中性色块 + ··· |
视觉最干净,不显突兀 |
- 不阻断交互:遮罩只是视觉遮挡,被遮的账号按钮仍然可以点击,不需要「先关遮罩才能切账号」
- 覆盖范围:默认遮左侧边栏的账号切换按钮与移动端底栏的个人入口;其他位置的账号信息(发帖框头像、个人主页头部等)可在设置页的「附加遮罩区域」里填 CSS 选择器补齐
- 全局快捷键:
Alt + Shift + M直接切换遮罩(默认值,可在chrome://extensions/shortcuts改),不用打开弹窗
在每条内容卡片的「更多」(···)按钮旁注入一个一键屏蔽按钮:
- 点击后自动完成 打开菜单 → 点击屏蔽
- 默认保留原生的二次确认弹窗,可以在设置里改成「点击即完成」
- 跳过确认时,屏蔽完成后页面左下角会给出 「已屏蔽 @xxx · 撤销」 提示,点撤销自动走一遍取消屏蔽
- 按钮的 tooltip 会带上对方账号(
一键屏蔽 @xxx),和 X 自己的「···」在静息态下也有明显的明暗差异 - 只依赖 X 的
data-testid定位,不使用随机类名
扩展弹窗的首页是「已增强的网站」列表,点进去才是该网站的功能设置;功能只对当前标签页所属的网站开放,不相关的网站会置灰并说明原因。 只注册了一个站点时,弹窗会直接进入该站点的设置页(返回按钮仍可回到列表)。
目前通过「加载已解压的扩展程序」安装。
git clone https://github.com/oxyuan/chrome-netkit-plugin.git- 打开
chrome://extensions(Edge 为edge://extensions) - 打开右上角 开发者模式
- 点击 加载已解压的扩展程序,选择刚才 clone 下来的目录
- 打开或刷新
x.com/twitter.com
修改代码后:在扩展管理页点刷新即可,不需要手动刷新 X 页面——弹窗会自动检测页面脚本是否失效并重新注入(见下文)。
- 点击工具栏上的 NetKit 图标
- 在「已增强的网站」里点进 X / Twitter(只注册了一个站点时会直接进入)
- 右上角开关是该网站的总开关;下面的卡片分别是隐私遮罩与一键屏蔽
- 设置即时生效,无需刷新页面;设置页顶部会显示「设置已生效」,说明页面脚本已经连上
- 只想快速开关遮罩时,直接按
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 内」「开关正向映射」这些容易回退的约束固定下来了。
- 在
popup/popup.js的SITES注册表加一条:{ key, name, hosts, features } - 在
popup/popup.html里加上对应的[data-feature]卡片 - 写对应的 content script 与样式,并在
manifest.json里补上matches/host_permissions - 新脚本必须用 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.*已失效、不再响应配置变更,所以不会有可见影响,刷新一次页面即彻底干净
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 globalAlt + Shift + Mtoggle. 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.



