前言
在日常办公、学习、科研场景中，我们几乎每天都要和外文内容打交道：英文技术文档、海外学术论文、外文网页资讯、海外软件界面说明……面对陌生词汇和长句，传统翻译方式往往让人头疼：
- 网页翻译插件：只能在浏览器内使用，PDF、Word、桌面软件里的文本无法覆盖，兼容性差
- 独立翻译软件：复制文本、切换窗口、粘贴翻译，频繁打断阅读思路，流程繁琐
- 在线翻译网站：加载慢、有广告，重复查询还要反复操作，效率极低
有没有一款轻量无广告、全场景兼容、一键触发、几乎不打断阅读的划词翻译工具？答案就是基于 Python 开发的 SnapTranslate 2.0：主打“选中文本 + 按下快捷键”即可秒出翻译，完美适配 Windows，让外文阅读回归专注，真正实现“所见即所译”。
更重要的是：2.0 不是只做翻译。它在保留“极简划词翻译体验”的基础上，新增了三项关键创新点，让工具从“翻译器”进化为“学习闭环”：
- 本地生词本（
vocab.json）：翻译完可以一键收录，长期积累个人词库 - 生词复习程序（
vocab_review.py）：卡片式复习 + 熟练度评分 + 多种排序模式 - 接入 DeepSeek API 自动生成例句：为每个词条补全“英文例句 + 中文整句翻译”，帮助真正掌握，而不是只记释义
一、效果演示：一键划词，翻译秒现
SnapTranslate 2.0 的核心体验就是无感知翻译，尽量不打断阅读节奏。
1）核心操作流程
打开任意软件（浏览器、PDF 阅读器、Word、记事本、代码编辑器等） → 选中外文文本（单词、短语、长句均可） → 按下快捷键 Ctrl + L → 瞬间完成翻译。
2）双端展示效果
（1）鼠标悬浮弹窗（就近提示）
翻译结果会以置顶半透明悬浮窗形式出现在鼠标附近：深色护眼、自动换行适配长句、自动隐藏，不遮挡原文。悬浮窗内同步显示原文 + 译文，对照更直观。
（2）主界面日志记录（历史回溯）
主界面的日志区域会自动保存每一次翻译记录，带时间戳：原文与译文分色显示，支持滚动查看与一键清空，方便回溯与整理。
3）2.0 新增：一键收录生词本（学习闭环的第一步）
这是 2.0 的关键升级之一。翻译弹出的悬浮窗里直接提供 “收录生词本” 按钮：
- 点击即可把当前词条写入本地
vocab.json - 写入前会检查是否已存在，避免重复收录
- 不需要再“复制到笔记软件/表格”，积累效率非常高
二、SnapTranslate 2.0 的创新点：从“翻译工具”升级为“掌握工具”
很多翻译工具解决的是“看懂”，但解决不了“掌握”。2.0 的创新点就在于把生词沉淀 + 复习强化 + 语境例句串成闭环。
创新点 1：本地生词本 vocab.json（可沉淀、可备份、可二次开发）
2.0 引入了结构化的本地词库 vocab.json，每个词条都会保存：
word：原词/短语meaning：释义（通常来自当次翻译结果）example：英文例句（可空）example_zh：例句中文翻译（可空）score：熟练度（0～100）reviews：复习次数
你拥有的是你自己的词库文件：可备份、可同步、可自己写脚本分析，完全不被平台绑定。
创新点 2：生词复习程序 vocab_review.py（评分系统 + 排序模式）
2.0 新增独立复习程序 vocab_review.py，不是“展示词表”，而是面向复习设计：
- 卡片式复习：默认只显示词条，点击才展开释义与例句
- 三档自评：认识 / 模糊 / 不认识
- 熟练度评分：每次自评都会更新
score，并写回 JSON - 顺序可选：随机 / 得分低→高 / 得分高→低
- 低→高：优先背薄弱项（更接近真正复习）
- 高→低：适合“热身”或“巩固熟词”
- 例句中词条会加粗显示，强化“在语境中记忆”的效果
创新点 3：接入 DeepSeek API，自动生成例句（让词条真正“可掌握”）
背单词最难的一步是：把词放进语境。手动写例句太慢，网上找例句又零碎。
2.0 的做法是：在复习界面提供按钮，一键调用 DeepSeek 批量补全例句：
- 对
example或example_zh为空的词条 - DeepSeek 一次生成：英文例句 + 该例句的中文整句翻译
- 自动写回
vocab.json，形成“释义 + 语境 + 译文”的完整学习材料
这一步让 SnapTranslate 2.0 从“翻译器”升级为“掌握工具”：你不再只是知道意思，而是能在真实语境里理解、复述、运用。
三、完整使用指南：从零到一，轻松上手
1）安装依赖
在项目目录执行：
pip install -r requirements.txt
2）运行划词翻译主程序
python main.py
- 选中文字 → Ctrl + L 翻译
- 悬浮窗点 收录生词本 写入
vocab.json - 主界面可选择翻译源：MyMemory（免梯备选）/ Google gtx
3）运行复习程序 + DeepSeek 例句生成
python vocab_review.py
- 复习：认识 / 模糊 / 不认识，自动记分
- 生成例句：点击按钮调用 DeepSeek 批量补全
- API Key：可放在同目录
api_key.txt（首行），或在界面输入保存
4）重置评分（无 UI）
如果想重新开始一轮复习：
python reset_vocab_scores.py
或指定词表路径：
python reset_vocab_scores.py "D:\path\to\vocab.json"
四、原理简述（面向想学习/二开的同学）
1）全局热键：Windows API（真正全局）
通过 ctypes 调用 RegisterHotKey 注册 Ctrl+L，再用 GetMessageW 消息循环捕获触发事件。优势是：不需要切换窗口，工具在后台也能响应。
2）抓取选中文本：模拟 Ctrl+C + 读取剪贴板
工具无法直接读取选区，因此采用通用方案：模拟 Ctrl+C，读取剪贴板，再做文本清洗（去换行、多空格等）。
3）翻译后端可切换：Google / MyMemory
- Google gtx：无需 key，但网络可达性因环境而异
- MyMemory：免 key，国内常更友好，但有免费额度限制
2.0 的价值在于：把“可用性”做进产品体验里，而不是让用户自己去折腾。
4）学习闭环：词库 → 复习评分 → 例句生成
main.py负责快速翻译与一键收录vocab_review.py负责复习、评分与排序- DeepSeek 负责补全语境例句（英例句 + 中译）
结语：2.0 的目标是“更像工具”，而不是“更像软件”
SnapTranslate 1.x 解决了“翻译快”的问题；而 2.0 的创新点是把“翻译”扩展成“掌握”：
- 翻译后顺手收录
- 词库可持续积累
- 有复习系统与评分
- 用 DeepSeek 自动补全例句与译文，把词放进语境
如果你也想把外文阅读从“频繁查词”升级为“边读边掌握”，SnapTranslate 2.0 值得一试。
