更新记录

1.1.0（2025-11-21） 下载此版本

• [新增] 支持暗黑模式

1.0.0（2025-11-21） 下载此版本

• 初始版本

平台兼容性

HBuilderX插件通用注意事项

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

# word-assistant

单词助手，一款面向 HBuilderX 的词汇学习与复习插件。主打轻量、顺手、随时练习，帮助你在工作间隙巩固词汇。

项目亮点

• 无需离开 HBuilderX：在熟悉的环境中练词，不打断工作流
• 两种练习节奏：列表批量浏览，复习卡片专注巩固
• 友好空态：明确提示下一步操作，不再迷路
• 轻松自定义：暗色主题与密度切换，适配你的习惯

使用说明

列表模式

• 关键词搜索：在顶部输入框输入关键词即可筛选
• 状态筛选：选择“全部/已掌握/待复习/生词”等状态
• 重置筛选：没有匹配结果时一键回到默认
• 管理单词：支持删除与更新，便于维护词库

复习模式

• 逐张练习：每次专注一个单词，查看释义与例句
• 标记反馈：点击“再练/良好/容易”为该词打标签
• 无可复习时：显示“暂无可复习的单词”，可返回列表或点击“刷新”

插件配置

在 HBuilderX 的设置中搜索“Word Assistant”即可看到以下配置项：

• word-assistant.defaultTargetLang

  • 类型：string
  • 默认值：zh-CN
  • 说明：默认的翻译目标语言（当前为中文）

• word-assistant.storagePath

  • 类型：string
  • 默认值：''（留空使用默认路径）
  • 说明：单词本的本地存储路径（JSON 文件）。默认存储在用户主目录下的 .word-assistant 文件夹，例如：/Users/你的用户名/.word-assistant/collection.json

• word-assistant.baidu.appId

  • 类型：string
  • 默认值：''
  • 说明：百度翻译 API 的 App ID，用于选中文本的翻译

• word-assistant.baidu.apiKey

  • 类型：string
  • 默认值：''
  • 说明：百度翻译 API 的 Key，与 appId 配合使用

提示：上述密钥仅保存在本地设置中，不会被上传。未配置密钥时，翻译相关能力不可用或受限。