作品展示-Gloss用于学习英语的小插件

发布时间 2025-12-02 11:58:40 / 次阅读

这篇文章想简单记录一下我最近写的一个小工具：Gloss。它是一个跑在浏览器里的油猴脚本，用来给网页上的英文（或者中文）加上轻量的词汇注解，主要是为了解决我自己在看英文博客、文档时的一个小痛点。

为什么要做这个小插件？

我平时看英文文章的频率挺高，但有几个很具体的烦恼：

所以我就干脆自己写了个脚本：

Gloss 本质上是一个“给真实网页加一层学习信息”的小插件，而不是一个完整的背单词应用。

安装脚本之后，在任意网页右下角会出现一个小控制条：

页面上如果有标注的词，会以 <ruby> 的形式出现：原文在下方，上面一行小字是译文。这样不会打乱排版，也不会像整段翻译那样破坏阅读体验。

目前 Gloss 主要做了几件事：

智能选词：
- 对中文页面：挑出适合学习英文表达的中文词/短语，给出英文释义。
- 对英文页面：挑出偏难或重要的英文词，给出简短中文释义。
最小词汇数限制：
- 用分词统计页面的词数，如果太短，就不会浪费请求（也避免给一堆碎碎念加注）。
缓存：
- 同一个页面在 7 天内只会请求一次接口，下次打开直接用缓存结果，速度更快，也省钱。
黑名单：
- 可以把不想标注的网站加到黑名单里，或用通配符屏蔽一类站点。
全局词汇本：
- 所有被标注过的词，都会自动进入一个词汇本。
- 可以看到原文、翻译、来源网站、添加时间。
- 支持搜索、筛选“学习中”和“已掌握”。
已掌握标记：
- 在词汇本里点一下「✓ 掌握」，之后这个词就不会再出现在网页标注里。
- 重新分析同一篇文章时，也会尽量跳过这些词，节省 token。
导入 / 导出：
- 词汇本可以一键导出为 CSV 文件，直接丢给 Excel 或别的工具继续加工。
- 也支持从 CSV 导入，方便把以前的生词表迁移进来。

整体思路是：

不强迫你在一个新界面背单词，而是尽量不打扰你阅读，只是顺手帮你把重要的词“记下来”，时间久了会变成你自己的词库。

使用方式非常简单：

安装 Tampermonkey（或兼容的脚本管理扩展）。
在 GreasyFork 安装 Gloss 的脚本：https://greasyfork.org/zh-CN/scripts/557609-gloss-%E6%99%BA%E8%83%BD%E8%AF%8D%E6%B1%87%E6%A0%87%E6%B3%A8。
源码仓库：https://github.com/yunpiao/gloss
打开任意网页，右下角会出现「Gloss」小控制条。
第一次使用：
- 点击齿轮按钮，填上自己的模型 API 地址、Key 和模型名称。
- 根据习惯调整“提取词汇数量”和“最少词汇数”等配置。
回到网页，点击「开始」，等一会儿就会看到文中出现小小的 ruby 标注。

如果你习惯看技术博客、文档，可以只针对英文页面开启自动标注；如果是反向学习英文表达（比如看中文博客，顺手学英文对应说法），也可以只给中文页面开。