更新记录

1.0.0（2026-07-30）下载此版本

无

平台兼容性

HbuilderX/cli最低兼容版本
不确定

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后，卸载时需手动卸载，详细教程参考：如何手动卸载插件

LinguaLens 考研背单词

LinguaLens 是一个运行在 HBuilderX 右侧面板中的本地考研英语背单词插件。插件内置考研词库，通过“查看释义 + 手动拼写”的方式帮助记忆单词，并自动保存每日学习进度。

功能介绍

内置 1341 个考研英语单词，包含英文、中文释义和音标。
每天安排 50 个新词和 50 个复习词。
每日单词采用固定乱序，同一天关闭后重新打开不会改变顺序。
输入正确的完整单词后自动记录进度并进入下一个单词。
点击英文单词或底部发音按钮，可调用系统英文语音朗读。
完成当天 100 个单词后，可以继续随机学习。
自动记录已学习单词、学习次数、最后学习日期和每日完成情况。
支持导入 JSON、CSV 和 TXT 格式的自定义词库。
支持 HBuilderX 明暗主题，打开面板时会读取当前编辑器主题。
支持折叠学习内容和关闭面板，重新打开后可以继续学习。

安装插件

将整个插件目录复制到 HBuilderX 安装目录的 plugins 文件夹中。

目录结构必须保持如下形式：

HBuilderX/
└─ plugins/
   └─ LinguaLens/
      ├─ package.json
      ├─ extension.js
      ├─ README.md
      ├─ data/
      │  ├─ kaoyan.json
      │  └─ progress.json
      └─ webview/
         └─ index.html

不要多嵌套一层目录，例如：

plugins/LinguaLens/LinguaLens/package.json

复制完成后，完全退出所有 HBuilderX 窗口，然后重新启动 HBuilderX。可以在“工具 → 插件安装 → 已安装插件”中确认是否出现“LinguaLens 考研背单词”。

打开插件

可以使用以下任意方式打开：

按快捷键 Ctrl+Alt+V。
打开任意代码文件，在编辑区域点击鼠标右键，选择“LinguaLens：打开考研背单词”。

macOS 快捷键为 Command+Alt+V。

打开后，HBuilderX 右侧会显示“考研背单词”面板。

使用方法

查看面板中显示的英文单词、音标和中文释义。
在输入框中拼写完整的英文单词。
按 Enter 提交答案。
拼写正确后，插件会立即保存进度并进入下一个单词。
拼写错误时，修改输入内容后再次提交。

点击英文单词或底部扬声器按钮，可以朗读当前单词。

每日学习规则

每天的默认计划为：

类型	数量	说明
新词	50	从尚未学习的词汇中乱序抽取
复习	50	从已经学习过的词汇中乱序抽取
合计	100	完成后仍可继续随机学习

第一次使用时没有历史单词可供复习，因此会先学习 50 个新词，再复习当天学习的这 50 个单词。

同一天生成的任务保持不变。关闭面板、隐藏内容或重启 HBuilderX 后，已经完成的单词不会重复出现在当天未完成任务中。

进度保存

学习进度保存在：

data/progress.json

每次拼写正确后，插件会立即保存：

已经学习过的单词。
每个单词的学习次数。
单词最后学习日期。
每日完成的新词和复习词。
用于计算连续学习天数的每日记录。

更新插件时，请保留原来的 data/progress.json，否则学习进度会被重置。

面板按钮

右上角提供三个操作按钮：

按钮	功能
导入	选择并导入自定义单词库
隐藏	折叠学习内容，再次点击可恢复
关闭	关闭当前面板内容，使用快捷键可重新打开

关闭和隐藏操作不会删除已经保存的学习进度。

导入自定义词库

点击右上角的导入按钮，可以选择 JSON、CSV 或 TXT 文件。导入新词库后，当前学习进度会被重置，避免不同词库的记录相互混淆。

JSON 格式

推荐使用 word、meaning 和 phonetic 字段：

[
  {
    "word": "example",
    "meaning": "n. 例子；实例",
    "phonetic": "ɪɡˈzɑːmpəl"
  },
  {
    "word": "abandon",
    "meaning": "v. 放弃；抛弃",
    "phonetic": "əˈbændən"
  }
]

同时兼容以下字段名：

中文释义：meaning、translation、chinese 或 translations。
音标：phonetic、phone、ukphone 或 usphone。

CSV 格式

第一行建议使用以下表头：

word,meaning,phonetic
example,"n. 例子；实例",ɪɡˈzɑːmpəl
abandon,"v. 放弃；抛弃",əˈbændən

也支持“单词、中文、音标”等中文表头。含有逗号的释义需要使用英文双引号包裹。

TXT 格式

每行表示一个单词，字段顺序为“单词、中文释义、音标”，可以使用制表符、竖线或两个以上空格分隔：

example | n. 例子；实例 | ɪɡˈzɑːmpəl
abandon | v. 放弃；抛弃 | əˈbændən

主题说明

插件打开时会读取 HBuilderX 当前的界面主题，并自动选择明亮或暗黑配色。切换 HBuilderX 主题后，重新打开插件即可应用新主题。

开发调试

使用 HBuilderX 打开插件源代码目录。
按 Ctrl+R 启动插件调试。
在新打开的插件调试窗口按 Ctrl+Alt+V。
修改代码后停止并重新运行插件。

常见问题

已安装插件中可以看到，但无法打开

确认已经完全重启 HBuilderX，并检查 package.json 是否直接位于 plugins/LinguaLens 目录下。打开任意代码文件后，通过编辑区域右键菜单或 Ctrl+Alt+V 打开。

关闭后如何重新打开

再次按 Ctrl+Alt+V，或者通过编辑区域右键菜单执行“LinguaLens：打开考研背单词”。

发音没有声音

发音依赖 Windows 或 macOS 的系统英文语音。请确认系统已经安装英文语音包，并检查系统音量和默认输出设备。

更新插件后进度消失

覆盖插件目录时可能同时覆盖了 data/progress.json。更新前备份该文件，更新后放回原位置即可恢复进度。

导入词库后旧进度消失

这是当前的预期行为。导入新词库会重置进度，防止旧词库记录影响新词库的每日任务。

所有学习数据均保存在本地，不需要登录，也不会上传到网络。