English Helper

Windows 本地英语取词助手 MVP：选中英文文本后按全局快捷键，读取选中文本，调用 DeepSeek API 解释，并可保存到本地 JSON 词库/句子库用于复习。

功能列表

• Ctrl+Shift+E：解释当前选中的英文单词、短语或句子
• 自动模拟 Ctrl+C 读取当前选中文本——目前版本仅支持这一种选中方式
• 使用简单规则判断 word / phrase / sentence
• 调用 DeepSeek Chat Completions API，要求模型返回 JSON
• tkinter 置顶解释窗口
• Ctrl+Enter：保存当前解释结果
• 本地 JSON 存储，自动去重
• JSON 文件不存在时自动创建
• JSON 损坏时自动备份并创建新文件
• Ctrl+Shift+R：打开复习窗口
• 复习支持 认识 1 / 模糊 2 / 不认识 3
• 复习按 level 0-7 的间隔队列安排，到 level 7 后标记 success=true，之后仅 10% 概率抽查
• 15 天、30 天、60 天档默认分别加入 ±1、±3、±7 天随机抖动，避免同一批词总是聚在同一天
• 毕业词抽查时支持 删除 4，会直接从本地 JSON 删除该条记录
• 写入 logs/app.log

安装依赖

建议使用 Python 3.10 或更高版本。

pip install keyboard pyperclip pyautogui requests

UI 使用 Python 自带的 tkinter。Windows 官方 Python 安装包通常已包含 tkinter；如果你的 Python 环境缺少 tkinter，请重新安装官方 Python，并勾选 Tcl/Tk 相关组件。

配置 DeepSeek API Key

打开 config.json，把：

"api_key": "PUT_YOUR_DEEPSEEK_API_KEY_HERE"

替换为你的 DeepSeek API Key。

默认 API 配置：

{
  "base_url": "https://api.deepseek.com",
  "model": "deepseek-chat",
  "timeout_seconds": 20
}

如果希望换用其它大语言模型进行翻译，请手动修改modules\api_client.py

如何运行

在项目目录中运行：

python a.py

如果 config.json 不存在，程序会自动创建模板文件，并提示你填写 API Key。

快捷键说明

快捷键	功能
Ctrl+Shift+E	读取当前选中文本并解释
Ctrl+Enter	保存当前解释结果
Ctrl+Shift+R	打开复习窗口
Esc	关闭当前解释窗口或复习窗口

快捷键都可以在 config.json 的 hotkeys 字段中修改。

数据保存位置

• 单词和短语：data/vocab.json
• 句子：data/sentences.json
• 日志：logs/app.log

保存前会按原文去重。单词、短语和句子第一版都使用忽略大小写的比较方式。

常见问题

按快捷键没有反应

先查看 logs/app.log。keyboard 在部分 Windows 环境可能需要管理员权限才能稳定监听全局快捷键，可以尝试用管理员权限运行终端。

提示未读取到选中文本

请先用鼠标选中英文内容，再按 Ctrl+Shift+E。值得注意的是某些程序不支持标准复制行为。

提示填写 API Key

请确认 config.json 中的 api.api_key 已替换为真实 DeepSeek API Key，且不是模板值。

API 返回解析失败

程序会先尝试解析标准 JSON，再尝试提取 json ... 代码块，最后尝试提取第一个 { 到最后一个 }。如果仍失败，解释窗口会展示原始返回内容，并在日志中记录。

JSON 文件损坏

程序会把损坏文件备份为类似 vocab.bak.20260506_203000.json 的文件，然后创建新的空 JSON 文件。