Skip to content

Repository files navigation

SnapDict

macOS AI 翻译词典 | AI-Powered Dictionary for macOS

快捷键呼出翻译面板,AI 智能助记,单词本复习,语音朗读,墨水屏推送

Release License macOS Swift

翻译面板 单词本 设置
翻译面板 单词本 设置

功能特性

  • 流式翻译 — 翻译结果逐步渲染,无需等待完整响应,所见即所得
  • 短句翻译 — 支持中英短句和片段翻译,自动识别输入类型,面板宽度自适应
  • 快捷键翻译 — 全局快捷键呼出翻译面板,支持中英互译
  • 自动获取选中文字 — 开启后按快捷键自动抓取其他应用中选中的文字并查词,无需手动输入
  • AI 智能助记 — 基于 DeepSeek AI 生成词根词缀分析和联想记忆法
  • 拼写纠正 — 自动检测拼写错误,支持自动纠正或手动选择
  • 单词本 — 收藏生词,随时复习
  • TTS 语音朗读 — 集成豆包语音合成,支持自然语音朗读
  • 墨水屏推送 — 定时推送单词卡片到墨水屏设备,支持文本和图片模式,可配置抖动算法
  • 菜单栏常驻 — 轻量运行,不占用 Dock 栏

安装

  1. 从 Releases 下载最新的 DMG 文件
  2. 打开 DMG,将 SnapDict 拖入 Applications 文件夹
  3. 终端执行 sudo xattr -r -d com.apple.quarantine /Applications/SnapDict.app
  4. 打开 SnapDict

快速开始

  1. 启动后在菜单栏找到 SnapDict 图标
  2. 进入设置,填入 DeepSeek API Key
  3. 使用快捷键 Cmd+Shift+E 唤起翻译面板(可自定义)
  4. 输入单词即可获取翻译、助记和例句

配置

服务 用途 必需
DeepSeek API 翻译、助记、例句生成 ✅
豆包 TTS 语音合成 ❌
墨水屏设备 (TRSS) 单词推送 ❌

从源码构建

要求:macOS 15.0+、Xcode 16.0+、Swift 6.0

# 安装 XcodeGen
brew install xcodegen

# 克隆并构建
git clone https://github.com/zzpuser/SnapDict.git
cd SnapDict
xcodegen generate
open SnapDict.xcodeproj

更新日志

v2.1.0

  • 新增音量放大功能,发音音量最大可调至 500%
  • 调整音量后对已缓存的发音立即生效

v2.0.6

  • 修复豆包语音发音容易卡住且无法自动停止的问题,网络异常时自动超时回退
  • 修复发音播放打断流式翻译加载的问题
  • 因配置存储格式调整,升级后需重新填写豆包语音设置

v2.0.5

  • 修复 TTS 发音播放后动画不自动停止的问题
  • 修复 TTS 播放期间阻断流式翻译加载的问题
  • TTS 音量调节上限扩大到 10 倍

v2.0.4

  • 修复 TTS 播放阻断流式翻译加载的问题
  • 修复 TTS 播放动画不同步的问题

v2.0.3

  • 提高骨架屏对比度,加载占位符更清晰可见
  • 修复短句翻译骨架屏扫光动画未覆盖全宽的问题

v2.0.2

  • 修复流式翻译过程中收藏单词导致释义为空的问题
  • 修复 TTS 播放和音量控制问题

v2.0.1

  • 修复 Chrome 等 Chromium 浏览器无法通过快捷键获取选中文字的问题
  • 修复连续快速取词时翻译面板内容闪动的问题

v2.0.0

流式翻译 & 短句翻译

  • 翻译结果流式渲染,逐步显示翻译、助记、例句,无需等待完整响应
  • 新增短句和片段翻译,自动识别输入类型(单词/短句),面板宽度自适应
  • 短句翻译支持中英互译和语法分析
  • 流式阶段即可使用发音和收藏按钮,无需等待翻译完成
  • 拼写纠错后"仍查询"不存在的词时,显示"未找到该词"空状态并提供纠正建议
  • 设置页辅助功能权限状态自动刷新,授权后无需手动操作即可识别

v1.5.0

  • 修复新电脑安装后收藏按钮状态异常、无法收藏单词的问题
  • SwiftData 数据库改为专属存储路径,避免与其他应用共享默认数据库导致冲突
  • 升级后已有的收藏和缓存数据会自动迁移,无需手动操作

v1.4.0

墨水屏推送策略优化

  • 修复推送总是重复同两个单词的问题
  • 新增「推送顺序」设置项,支持两种模式:
    • 优先低频(默认):加权随机,低频词被选中概率更高,新词不会完全霸占推送队列,所有单词都有机会出现
    • 完全随机:忽略推送次数,从全部候选词中均匀随机选取

v1.3.0

查词体验优化

  • 查词加载中显示骨架屏,模拟最终结果布局,替代单调的加载动画
  • 助记/例句加载中也显示骨架屏占位,带从左到右扫过的闪烁动画
  • 例句区域添加图标,与助记区域风格统一

面板高度自适应

  • 查词 Tab 面板高度根据内容自动调整
  • 单词本/设置 Tab 支持用户手动拖拽调整高度并记忆

安装体验优化

  • DMG 安装页面美化:自定义背景图、图标布局和拖拽箭头引导

修复

  • 修复缓存命中等快速响应场景下面板不展开的问题
  • 修复输入中修改查询时面板塌缩闪烁的问题

v1.2.0

新功能:快捷键自动获取选中文字查词

  • 在任意应用中选中文字后按快捷键,面板自动填入选中内容并触发翻译,省去手动输入步骤
  • 通过 macOS Accessibility API 读取前台应用的选中文字,需在系统设置中授予辅助功能权限
  • 设置页新增"自动获取选中文字"开关(默认关闭),开启时自动引导授权,并实时显示权限状态
  • 无论当前处于哪个 Tab,有选中文字时自动切换到查词页面

墨水屏推送增强

  • 图片推送支持配置抖动算法类型(关闭 / 误差扩散 / 有序抖动)
  • 误差扩散模式下可选择具体的扩散核函数(Floyd-Steinberg、Atkinson 等 10 种)
  • 单词卡片样式优化:提升文字对比度和分隔线清晰度,优化水印显示

v1.1.0

  • 设置页优化:API Key 明文切换、墨水屏推送开关控制
  • 墨水屏推送支持文本和图片两种模式

v1.0.0

  • 首个正式版本

技术栈

  • 语言: Swift 6.0 (Strict Concurrency)
  • 框架: SwiftUI + AppKit
  • 存储: SwiftData
  • AI: DeepSeek API
  • TTS: 豆包语音合成
  • 依赖: HotKey, PartialJSON

License

MIT

About

macOS AI 翻译词典,基于 DeepSeek 提供智能翻译、词根助记、拼写纠正和语音朗读 | AI-powered dictionary app for macOS with translation, mnemonics, and TTS

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages