MatchLens：网页关键词匹配度

一个面向 Microsoft Edge 的单文件 UserScript，可由脚本猫（ScriptCat）或 Tampermonkey 直接安装。脚本在当前页面本地分析关键词，给出 0–100 匹配分、逐词解释、相关片段与页面高亮。

主要功能

• 浮动按钮和 Shadow DOM 面板，不易受网页样式干扰
• 中文、英文及中英混合关键词
• 逗号、中文逗号、分号或换行分隔多个关键词
• "精确短语"、-排除词、关键词^2 权重语法
• 标题、页面标题、描述与正文的分层评分
• 精确匹配、可关闭的模糊匹配、逐词命中次数
• 高相关片段排序、点击定位、页面高亮和一键清除
• Alt + Shift + K 快捷开关面板
• 无网络请求；页面内容不会离开浏览器
• 已针对 eur-lex.europa.eu 法规正文页适配：支持 frame 文档和更严格的页面样式策略
• 1.1.0 迭代：CSS Custom Highlight 无损高亮、动态更新、查询历史、JSON 报告复制、多色关键词

在 Edge 中安装

1. 在 Edge 中安装脚本猫或 Tampermonkey。
2. 打开脚本管理器的“新建脚本”页面。
3. 删除模板内容，复制 keyword-match-lens.user.js 的全部内容并保存。
4. 打开任意普通 http:// 或 https:// 网页，刷新一次。
5. 点击右下角紫色 ⌕ 按钮，输入关键词后选择“分析当前页”。

如需分析本地 HTML 文件，请在脚本管理器/Edge 扩展设置中允许访问文件网址。edge://、扩展商店和浏览器内部页面受 Edge 限制，UserScript 无法运行。

如果脚本猫菜单中看到“排除在 eur-lex.europa.eu 上执行”，那是域名排除操作入口；请不要点击它。若之前已经排除，请在脚本设置中移除该域名，再刷新页面。

查询示例

人工智能, 机器学习
"大语言模型" -广告
隐私保护^2, 数据安全
machine learning, model^1.5

• 普通词：按出现位置、频次和字段重要性评分。
• 双引号：作为完整短语处理。
• - 前缀：该词出现时降低总分。
• ^数字：提高或降低该关键词在总分中的权重，范围为 0.1–10。

匹配度含义

总分由逐词命中质量和关键词覆盖率综合得出，并对排除词命中进行扣分：

• 80–100：高度匹配
• 50–79：中度匹配
• 1–49：低度匹配
• 0：未找到

标题和标题标签中的命中权重高于普通正文；同一词多次出现会提升分数，但采用对数收敛，避免关键词堆砌导致虚高。英文和较长词可启用 Levenshtein 模糊匹配。

项目文件

• keyword-match-lens.user.js：可直接安装的最终单文件脚本
• docs/userscript-algorithm.md：UserScript 实际评分算法说明
• docs/competitive-review.md：市面产品与 GitHub 开源方案复盘、后续路线
• userscript-smoke.test.cjs：UserScript 核心逻辑冒烟测试
• .github/workflows/ci.yml：Node 20/22 自动校验
• src/：早期 Manifest V3 扩展原型，仅供继续开发；Edge 日常使用建议优先安装 UserScript

隐私与权限

脚本只申请配置存储和脚本菜单权限，不申请跨域网络权限，也不上传页面文本。所有提取、评分和高亮都在当前标签页内完成。

本地验证

npm run check
npm test