使用帮助
从第一次划词到每天复习,用几步把遇到的英文慢慢变成自己的词汇。
Beta 公开测试
当前测试版免费使用,直接从官网下载并安装,无需通过 App Store。Beta 表示应用仍在收集真实使用反馈,部分 App 的取词和不同系统版本的兼容性还需要继续完善。
欢迎先用 hello 等普通英文词,走一遍“划词 → 听发音 → 保存 → 打开生词本”的流程,再体验每日复习。遇到问题时,请通过问题反馈告诉我们你的 macOS 版本、使用的 App 和复现步骤。
当前安装包为 0.5.0(构建 2),仅支持 Apple 芯片 Mac;整句翻译需要 macOS 15 或更新版本。后续更新请回到官网下载,替换应用前先退出旧版;重要生词建议按下方说明备份。
第一次使用
- 把应用放入“应用程序”,打开“划词读英语”。它常驻屏幕顶部的菜单栏,不占用 Dock。
- 根据应用提示,在“系统设置 → 隐私与安全性 → 辅助功能”中允许“划词读英语”。
- 回到常用文本 App,划选一个英文单词。出现工具条后,可点“发声”听读,点“翻译”看释义,点“保存”加入生词本。
- 点击菜单栏图标打开生词本,也可开始当天最多 5 个词的轻量复习。
升级时,请先从旧版菜单栏选择“退出”,再替换“应用程序”中的应用。单纯替换应用不会删除生词本。
系统与功能
- 查词、生词本与复习:需要 macOS 13 或更新版本。当前 0.5.0 安装包仅支持 Apple 芯片 Mac(M 系列),不支持 Intel Mac。
- 整句、整段翻译:需要 macOS 15 或更新版本,以及英语和简体中文语言包。建议一次划选不超过 2,000 个字符。
- 发声与慢速跟读:使用系统语音。声音资源由 macOS 管理,部分声音需先下载。
- 怎么记:设备、地区和系统条件允许时使用 Apple 本机模型,否则使用规则拆解;不需要 API Key。
自动划词适用于多数常见文本 App。图片中的文字、部分画布、受保护文本和某些 App 的自绘界面可能无法读取;本版本没有截图识字功能。
常见问题
划选英文后没有工具条
- 点击菜单栏图标,确认应用处于“划词监听中”,而非暂停状态。
- 查看“辅助功能权限”引导,确认系统设置已允许这个版本的应用。首次更换正式签名版本时,系统可能要求重新确认权限。若旧的 Huaxian 记录已开启但应用仍提示未授权,请在系统设置中移除旧记录,重新添加“应用程序”中的 Huaxian.app,再允许并重新打开应用。
- 在“文本编辑”中输入并划选
hello试一下。若这里可用,原 App 可能不提供可读取的选区。 - 在原 App 中主动按
⌘C复制,再从菜单栏选择“查询剪贴板文字”。也可以在生词本中手动添加英文。
中文、网址、乱码或不适合查词的内容会被忽略。不要为了让应用弹窗而复制或分享敏感内容。
整句翻译一直没有结果
先确认系统是 macOS 15 或更新版本,并完成系统弹出的英语与简体中文语言包下载。下载期间需要联网;完成后可重试翻译。若没有出现下载提示,可在系统的“翻译”功能中检查语言资源。较旧系统仍可使用单词查词、朗读与生词本。
为什么发音和之前不同,或者听不到声音
本发行版统一使用 macOS 系统语音,因此音色可能与旧版在线发音不同。听不到声音时,请检查系统音量、静音状态和声音输出设备;也可在系统的语音设置中检查英语声音是否可用。单词卡的慢速跟读适合逐词模仿。
今天没有复习,或者只有几个词
复习每天最多安排 5 个到期词。没有到期词时,显示已完成或暂无待复习是正常情况。先尝试回想,再翻开答案,并按实际情况选择“没记住”“有点印象”或“记住了”;之后的复习日期会根据反馈调整。
“怎么记”显示的是拆词,没有 AI 内容
本机 AI 需要支持的 Mac、系统、地区和 Apple 智能设置。条件不满足时,应用自动使用本地规则,不影响查词和复习。拆词与中文谐音只是入门辅助,请以英文发音和实际语境为准。
系统提示无法打开应用
请核对您下载的版本与官方发行说明,以及它支持的系统和芯片。保留系统提示内容,并通过发行方提供的支持方式反馈;不要关闭 macOS 安全保护。若提示权限不足,请使用应用内“辅助功能权限”引导检查。
生词、备份与删除
从菜单栏选择“打开数据文件夹(含 CSV 备份)”,可以找到“生词本备份.csv”。双击可用表格应用查看,也可以复制到您自己选择的位置保存。副本包含生词、来源 App 和复习信息,请按个人资料保管。
需要完整迁移或备份时,请先退出应用,再复制整个 Huaxian 数据文件夹;只复制 CSV 适合查看词表,应用目前没有 CSV 导入按钮。不要在应用运行时直接修改数据库文件。
删除单个词
在生词本中使用删除操作并确认。列表和 CSV 备份会更新;已生成的助记缓存、旧版音频及您另存的副本不会随之删除。
清除应用数据文件
- 先从应用菜单打开数据文件夹,并备份需要保留的内容。
- 从菜单栏选择“退出”。
- 在 Finder 中确认目标是
~/Library/Application Support/Huaxian/,只将这个Huaxian文件夹移到废纸篓。不要处理整个“Application Support”文件夹。 - 再次打开应用后,会创建空的生词数据。此操作会移除生词、复习进度、助记缓存和留在该目录的旧版音频。清空废纸篓后不能通过应用撤销。
应用的首次使用偏好、系统日志和您另外保留的备份不在上述清理范围内。只把应用移到废纸篓,也不会自动清除数据文件。
反馈问题时提供什么
说明使用的 macOS 版本、应用版本、发生问题的 App,以及“做了什么、期待什么、实际发生什么”。能用 hello 等普通示例重现的问题,无需附上真实私人文字或整个生词本。
联系与反馈
开发与维护:Peace_ai798Lab(hepinga)。
使用问题与隐私政策咨询:在 GitHub 提交反馈(需 GitHub 账号)。请只提交不含私人内容的复现步骤;此入口为公开讨论区。
您的生词与复习数据保存在本机,可以按使用帮助自行管理与删除,无需把数据发送给开发者。
本页不会自动发送信息。主动反馈时,请先检查截图、日志或附件,移除不希望分享的私人内容。