开发手册
这一部分写给准备看源码、改规则或提 PR 的人。只需要安装扩展的话，看 使用指南 就够了。
章节
- 架构概览 — 项目目录结构、各模块职责、数据流
- 规则文件格式 —
public/rules/下 JSON 怎么组织，nested groups + defaults 继承 - 检测流程 — 从 webRequest / 页面注入到弹窗渲染走过哪些环节
- 贡献规则 — 怎么往内置规则集合加新技术
- 构建与发布 — 本地构建、打包、签 crx、发布工作流
技术栈概况
项目主体是 Vite 5 + Vue 3 + TypeScript + @crxjs/vite-plugin 2.x。后台脚本是 Manifest V3 ESM service worker，包管理器用 pnpm。
规则放在 public/rules/ 下，按页面规则、响应头规则、WordPress / Drupal 生态等方向拆成多个 JSON 文件。构建时会预处理规则，注入 __hints / __keywordCombined 这类用于匹配加速的字段。
开发常用命令
bash
pnpm install # 装依赖
pnpm run dev # 起 vite dev server，扩展热更
pnpm run build # 构建到 dist/，可加载到 chrome
pnpm run typecheck # vue-tsc 严格类型检查
pnpm run lint # eslint 检查
pnpm run docs:dev # 起本文档站本地预览
pnpm run docs:build # 构建文档静态站dev 模式下，扩展页面支持热更新。改 popup / settings / help 通常会自动刷新；改 src/background/ 或 content script 后，需要到 chrome://extensions/ 手动刷新扩展卡片。
Vue 入口
三个独立 SPA 入口，分别构建，互不干扰：
| 入口 | 文件 | 说明 |
|---|---|---|
| popup | src/ui/popup/index.html | 浏览器右上角点扩展图标弹出的 440px × 600px 小窗 |
| settings | src/ui/settings/index.html | 在 chrome://extensions/ 详情页打开的 options page |
| help | src/ui/help/index.html | 设置页里点「使用说明」打开的独立标签页 |