Dark Reader 暗黑模式扩展:从安装到调参的完整流程 Dark Reader 暗黑模式扩展从安装到调参的完整流程【免费下载链接】darkreaderDark Reader Chrome and Firefox extension项目地址: https://gitcode.com/gh_mirrors/da/darkreaderDark Reader 是一款 MIT 开源的浏览器扩展它会分析任意网页的结构与配色自动为该页面生成一套深色主题用来缓解长时间夜间浏览带来的视觉疲劳。它支持 Chrome、Firefox、Edge、Safari 与 Thunderbird代码完全开放。读完本文你可以独立完成安装与启用、按站点调整亮度和对比度、挑选预设配色方案并了解如何从源码构建出最新的扩展。它到底做了什么一套配色引擎加三个模块理解 Dark Reader关键是想清楚谁在决定颜色。它并不是简单地把白色反成黑色而是先分析页面里每个元素的背景、文字与图片再按你选择的主题引擎重新计算颜色。源码 src/generators/theme-engines.ts 里一共定义了四种引擎cssFilter、svgFilter、staticTheme 和 dynamicTheme。其中 dynamicTheme动态主题会逐条重写网页 CSS效果最完整也是默认值cssFilter滤镜模式用整页滤镜一次性转换速度最快但细节稍弱staticTheme静态主题则用一组固定的深色变量替换整站配色观感统一。这些引擎由三层代码协作驱动src/background/ 负责扩展的生命周期与消息分发是扩展的大脑src/inject/ 是真正被注入网页、执行颜色转换的脚本而 src/defaults.ts 集中存放了所有默认参数——亮度 100、对比度 100、灰度 0、色度 0默认引擎为 dynamicTheme并默认对所有站点启用。两条上手路径装完直接可用最省事的路线是在浏览器扩展商店搜索 Dark Reader 安装装好后打开任意浅色网页页面会自动变暗无需任何操作。点击工具栏图标即可打开控制面板里面就是亮度、对比度、灰度、色度四个滑块拖动时页面会实时刷新预览。想限定作用范围时在面板里把激活方式从所有站点改成以下站点只勾选你需要的网站即可。按需配置从源码构建如果你想体验最新代码或做二次开发可以先克隆仓库再构建git clone https://gitcode.com/gh_mirrors/da/darkreader cd darkreader npm install npm run build构建要求 Node.js 15 及以上。完成后会在build/release/下得到darkreader-chrome.zip供 Chromium 系浏览器和darkreader-firefox.xpi供 Firefox用浏览器的加载已解压扩展方式安装即可。改行为前建议先读 src/background/ 与 src/inject/ 两个目录。调优速查按目标选参数想要更暗亮度brightness控制整体明暗取值范围 50–150默认 100。夜间环境把它降到 75–90屏幕的光感会明显减弱。如果页面偏亮、细节被白底淹没再往上加。文字更清晰对比度contrast同样在 50–150 之间调节用来拉开文字与背景的差距。当文字发虚、边缘模糊时把它调到 95 以上通常会有明显改善。页面更安静灰度grayscale与色度sepia都从 0 到 100。灰度让彩色元素变淡广告、横幅抢眼时适当加高内容区会更安静色度加一层暖黄调适合喜欢纸感、想进一步降低蓝光感的人。 参数按站点独立保存改某网站时只点该站点面板的保存设置其他站点不受影响全站默认共用上面这套主题。想直接换一整套协调的配色可以到配色方案下拉里选例如 Catppuccin深色背景 #1e1e2e、文字 #cdd6f4、Dracula、GitHub Modern、Nord、Tokyo Night 等它们都定义在 src/config/color-schemes.drconf深色与浅色两套变量会同时生效。常见问题某页面图片发灰、颜色失真多数是因为动态主题把图片也当背景处理。可以试着调高亮度或把该站点临时切到滤镜模式对比效果。打开某网站完全没有变暗先确认该站点没有被排除在启用列表外把它加入以下站点即可。在线文档Google Docs、SharePoint、OneDrive 等效果不对这类站点默认就被配置为使用滤镜模式见 src/defaults.ts 里的filterModeSites建议沿用默认别手动改回动态主题。网站本身已是深色却被二次变暗Dark Reader 默认开启检测页面原生深色主题detectDarkTheme会识别并避免二次转换若看到双重变暗先确认这项没被关掉。⚠️ 想在 Firefox 上对受限页面生效需要在 设置 → 高级 里启用受限页面选项并按仓库 README 的说明修改 Firefox 的 about:config 偏好项后再刷新页面。同步站点修复默认是关闭的新修复随每个版本一起分发要手动开启需先在扩展图标的 Dev tools → Advanced 中启用新设计预览再到 设置 → 高级 打开 Synchronize sites fixes。更底层的修复规则存放在 src/config/dynamic-theme-fixes.config 等文件中随版本更新。延伸仓库根目录的 README 写了构建、站点修复与受限页面的完整步骤是最直接的一手资料。官网的 help 页面汇总了大部分常见问题遇到细节可以先在这里找答案。关注扩展商店的版本更新即可拿到新站点修复与兼容性改进。【免费下载链接】darkreaderDark Reader Chrome and Firefox extension项目地址: https://gitcode.com/gh_mirrors/da/darkreader创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考