突破语言壁垒：Saladict-Desktop 开源划词翻译神器全攻略
项目地址: https://gitcode.com/gh_mirrors/sa/saladict-desktop 项目概述
Saladict-Desktop（沙拉查词桌面版）是一款功能强大的开源划词翻译工具，聚合了众多词典资源，支持 Windows、Mac 和 Linux 三大操作系统。该项目基于 GitHub 加速计划，提供了高效、便捷的翻译体验，特别适合学术研究、跨境阅读等场景。
根据 src/saladict/_locales/zh_CN/messages.json 定义，Saladict 的核心功能包括：
- 多语言划词翻译（中英日韩法德西语等）
- 多词典聚合查询
- 网页翻译功能
- 生词本管理
- PDF 文档浏览与翻译
项目采用现代前端技术栈构建，主要代码结构包括：
- 主进程管理：src/main/WindowManager.ts
- 渲染进程界面：src/renderer/src/pages/Panel/index.tsx
- 词典核心功能：src/saladict/
- 国际化支持：src/saladict/_locales/
安装与配置
环境准备
Saladict-Desktop 支持以下操作系统：
- Windows 7 及以上
- macOS 10.12 及以上
- Linux (Ubuntu 16.04+, Fedora 24+, Debian 9+)
源码编译安装
-
克隆项目仓库：
git clone https://gitcode.com/gh_mirrors/sa/saladict-desktop cd saladict-desktop -
安装依赖：
npm install # 或使用 pnpm pnpm install -
开发模式运行：
npm run dev -
打包构建：
npm run build
构建后的可执行文件将位于 dist 目录下，根据不同操作系统生成对应的安装包。
基础配置界面
成功安装后，首次启动会进入配置界面。通过设置页面可以：
- 选择默认词典
- 配置快捷键
- 设置翻译语言方向
- 自定义界面主题
配置文件存储在 src/common/config.ts 中，高级用户可以直接修改该文件进行高级配置。
核心功能详解
划词翻译
Saladict-Desktop 提供了灵活的划词翻译功能，支持多种触发方式：
- 鼠标划词：选中文本后自动或手动触发翻译
- 快捷键触发：默认
Ctrl+Shift+E(Windows/Linux) 或Cmd+Shift+E(Mac) - 右键菜单：通过右键菜单选择"沙拉查词"
划词功能的核心实现位于 src/saladict/assets/content.0352e950.js 和 src/saladict/assets/selection.420695b7.js 文件中。
词典聚合与切换
Saladict-Desktop 聚合了众多主流词典，包括但不限于：
| 词典名称 | 特点 | 适用场景 |
|---|---|---|
| 某词典 | 中英互译权威 | 日常翻译 |
| 谷歌翻译 | 多语种支持 | 小语种翻译 |
| 剑桥词典 | 学术词汇 | 学术研究 |
| 韦氏词典 | 美式英语 | 英语学习 |
| 百度翻译 | 中文特色 | 中文相关 |
用户可以通过设置界面调整词典优先级，或在翻译面板中快速切换不同词典。
快捷键系统
Saladict-Desktop 提供了丰富的快捷键支持，主要包括：
Ctrl+Shift+E：划词翻译开关Ctrl+Shift+I：即时翻译开关Ctrl+Shift+C：搜索剪贴板内容Ctrl+Shift+P：打开PDF翻译Ctrl+Shift+Q：打开快速搜索
完整的快捷键列表和自定义方法可在设置页面查看和修改。
搜索面板
搜索面板是 Saladict 的核心交互界面，集成了词典查询、历史记录和生词本功能。
搜索面板的实现代码位于 src/renderer/src/pages/Panel/index.tsx，通过 iframe 嵌入方式加载词典内容，提供了流畅的用户体验。
高级功能
情景模式切换
Saladict-Desktop 支持多情景模式，用户可以根据不同使用场景快速切换配置：
- 学术研究模式：优先显示专业词典
- 日常阅读模式：优化常用词汇翻译
- 语言学习模式：增强例句和语法解释
- 编程模式：针对技术术语优化
通过快捷键 Ctrl+Shift+[1-5] 可以快速切换不同模式，也可以在 src/saladict/manifest.json 中自定义更多模式。
生词本与学习记录
Saladict 提供了内置的生词本功能，可以：
- 一键添加生词
- 按记忆曲线复习
- 导出学习记录
- 生成单词卡
生词本数据存储在本地 IndexedDB 中，通过 src/saladict/assets/dexie.e0cbbdaa.js 进行数据库管理，确保数据安全和高效访问。
PDF 阅读与翻译
Saladict-Desktop 内置 PDF 阅读器，支持直接在应用内打开 PDF 文件并进行划词翻译。该功能基于 PDF.js 实现，相关代码位于 src/saladict/assets/pdf/ 目录下。
使用方法：
- 通过快捷键
Ctrl+Shift+P打开 PDF 阅读器 - 选择需要阅读的 PDF 文件
- 划词即可触发翻译
常见问题解决方案
划词功能失效
如果划词翻译功能突然失效，可以尝试以下解决方案：
-
检查 Saladict 是否被禁用：
- 打开设置界面
- 确认"启用划词翻译"选项已勾选
-
重启应用：
# 命令行重启（开发模式） npm run dev -
检查冲突软件： 某些屏幕取词或快捷键工具可能与 Saladict 冲突，尝试关闭其他类似软件。
词典加载失败
当特定词典无法加载时：
- 检查网络连接：部分词典需要联网访问
- 清除缓存：设置 → 高级 → 清除缓存
- 手动更新词典：设置 → 词典管理 → 更新词典
词典加载逻辑主要在 src/saladict/assets/background.20148fa5.js 中实现，可通过开发者工具查看具体错误信息。
快捷键冲突
如果发现快捷键无法使用或与其他软件冲突：
- 打开设置 → 快捷键
- 点击需要修改的快捷键
- 按下新的按键组合
- 点击"应用"保存设置
快捷键配置存储在 src/common/config.ts 中，高级用户可以直接修改配置文件自定义更多快捷键。
性能优化建议
对于低配置电脑，可通过以下方式提升性能：
- 减少同时启用的词典数量
- 关闭动画效果：设置 → 外观 → 关闭动画
- 降低更新频率：设置 → 高级 → 减少更新检查频率
- 清理历史记录：设置 → 隐私 → 清除历史数据
开发与扩展
项目架构
Saladict-Desktop 采用 Electron 框架构建，基于以下架构设计：
主进程代码位于 src/main/ 目录，负责窗口管理和系统集成；渲染进程代码位于 src/renderer/ 目录，负责用户界面；词典核心功能位于 src/saladict/ 目录。
贡献代码
如果你想为 Saladict-Desktop 贡献代码，可以从以下方面入手：
- 修复已知 issues
- 添加新词典支持
- 优化性能
- 改进 UI/UX
开发前请阅读 README.md 了解开发规范和提交指南。
自定义词典开发
Saladict 支持添加自定义词典，需要实现以下步骤：
- 创建词典配置文件
- 实现查询接口
- 注册词典到主程序
详细开发文档和示例可参考 src/saladict/assets/fanyi.default.2.0/ 目录下的默认词典实现。
总结与展望
Saladict-Desktop 作为一款开源划词翻译工具，通过聚合多词典资源和提供丰富功能，为用户提供了高效的翻译体验。其核心优势在于：
- 多平台支持和良好的兼容性
- 丰富的词典资源和查询选项
- 高度可定制的用户界面
- 活跃的开发社区和持续更新
目前项目正在开发 v3 版本，将带来更多新特性和性能优化。根据 README.md 显示，开发团队计划在新版本中：
- 重构核心架构
- 提升启动速度
- 优化内存占用
- 添加更多 AI 辅助功能
如果你在使用过程中遇到问题或有功能建议，欢迎通过项目仓库提交 issue 或参与讨论。
相关资源
- 项目源码：src/
- 官方文档：README.md
- 图标资源：static/icons/
- 开发配置：configs/
- 构建脚本：scripts/
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
