白泽智译 VerbaFlow

基于阿里云通义千问翻译模型的智能 Excel 批量翻译工具

English • 功能特点 • 安装 • 使用 • 更新日志

当前版本：v3.3

---

基于阿里云通义千问翻译模型（qwen-mt-turbo）的Excel文件批量翻译工具，支持智能上下文参考功能。

📜 许可证

白泽智译 (VerbaFlow) 是基于阿里云通义千问翻译模型开发的智能翻译工具，采用 GNU General Public License v3.0 (GPL-3.0) 许可证发布。

本产品包含多个采用其他开源许可证的第三方组件。详情请参见 NOTICE 文件。

✨ 功能特点

• 批量翻译：支持Excel文件第一列文本的批量翻译
• 智能上下文：在单次任务中使用翻译记忆库提供上下文参考，提升翻译一致性
• 多语言支持：支持多种语言互译，自动检测源语言
• 进度显示：实时显示翻译进度和状态
• 结果导出：自动生成包含原文和译文的Excel文件
• 配置保存：保存API密钥和语言设置

🎯 新功能：领域参考翻译

核心特性

• 智能领域匹配：根据待翻译文本智能匹配最相关的领域词汇
• 总体背景说明：用户可以输入翻译的总体背景，帮助AI理解翻译场景
• 领域词汇管理：支持Excel文件导入领域词汇（原词、翻译词、背景提示）
• 动态词汇选择：只选择与当前文本最相关的领域词汇，避免信息过载

智能匹配算法

使用基于关键词的相似度计算：

• 关键词提取：使用jieba分词和正则表达式提取中英文关键词
• Jaccard相似度：计算文本关键词与领域词汇关键词的重叠度
• 阈值过滤：只选择相似度高于阈值的领域词汇
• 智能排序：按相关性得分排序，选择最相关的词汇

使用示例

1. 准备领域词汇文件：创建包含三列的Excel文件（原词、翻译词、背景提示）
2. 设置翻译背景：在"总体背景说明"中输入翻译场景描述
3. 加载领域词汇：选择领域词汇文件并启用功能
4. 智能翻译：系统会自动匹配相关词汇并应用到翻译中

示例领域词汇

原词    | 翻译词           | 背景提示
铁匠    | Blacksmith      | 铁匠，年长男性
锻造    | Forging         | 金属加工工艺
铁砧    | Anvil           | 铁匠铺工具
淬火    | Quenching       | 热处理工艺

🧠 智能上下文翻译

核心特性

• 任务级记忆：翻译记忆仅在单次任务中有效，任务结束后自动清除
• 相关性匹配：基于编辑距离、关键词匹配、包含关系和长度相似性智能选择相关翻译
• 动态更新：每完成一条翻译就更新记忆库，为后续翻译提供参考
• 内存管理：自动限制记忆库大小，避免API请求过大

相关性算法

使用多维度评分机制：

• 编辑距离相似度 (40%)：基于字符串相似程度
• 包含关系评分 (30%)：文本相互包含程度
• 关键词匹配 (20%)：关键词重叠度
• 长度相似性 (10%)：文本长度相近程度

📦 安装要求

pip install -r requirements.txt

🚀 使用方法

1. 设置API密钥：

   • 获取阿里云百炼API密钥
   • 在界面中输入并保存API密钥

2. 选择文件：

   • 点击"浏览"选择要翻译的Excel文件
   • 确保Excel文件第一列包含要翻译的文本

3. 配置翻译选项：

   • 选择源语言和目标语言
   • 勾选"启用智能上下文"（推荐）

4. 开始翻译：

   • 点击"开始翻译"按钮
   • 等待翻译完成

5. 查看结果：

   • 翻译完成后会自动保存结果
   • 结果文件名为：原文件名_翻译结果.xlsx

📁 文件结构

VerbaFlow/
├── main.py                    # 主程序入口
├── main_window.py            # 主窗口界面
├── translator.py             # 翻译核心模块
├── translation_memory.py     # 翻译记忆模块
├── domain_vocabulary.py      # 领域词汇模块
├── excel_handler.py          # Excel文件处理
├── config_manager.py         # 配置管理
├── language_codes.py         # 语言代码定义
├── logo.png                  # 项目 Logo
├── welcome-cover.png         # 欢迎页图片
├── requirements.txt          # 依赖包列表
└── README.md                 # 项目说明

⚠️ 注意事项

• API密钥需要有效且有余额
• Excel文件第一列必须包含要翻译的文本
• 建议启用智能上下文功能以获得更好的翻译一致性
• 单次任务中的翻译记忆会在任务结束后自动清除
• 批量节流策略：每两条请求间隔 0.1 秒（可在 config.json 中配置）

📦 打包为桌面应用（macOS .app）

本项目已适配打包运行路径，打包后的应用会将用户配置持久化到 ~/Library/Application Support/白泽智译/config.json，避免 .app 包内不可写的问题。

🚀 快速打包（推荐）

使用一键打包脚本，自动完成图标创建、应用打包和 DMG 生成：

./build_macos.sh

脚本会自动完成以下步骤：

1. 🎨 将 logo.png 转换为符合 macOS 风格的圆角矩形图标（.icns）
2. 🧹 清理旧的构建文件
3. 📦 使用 PyInstaller 打包应用
4. 💿 生成 DMG 安装包

打包完成后会生成：

• dist/白泽智译.app - macOS 应用程序
• dist/VerbaFlow_v3.3.dmg - DMG 安装包
• build_assets/app_icon.icns - macOS 风格图标

📝 手动打包步骤

如果需要手动控制打包过程：

1. 环境准备

pip install -r requirements.txt
pip install pyinstaller Pillow

2. 创建 macOS 风格图标

python3 create_macos_icon.py

这会将 logo.png 转换为带圆角和透明边缘的 macOS 风格图标，符合 Apple 设计规范：

• 圆角半径：22.37%（Apple 标准）
• 透明边距：10%
• 支持多种分辨率（16px 到 1024px）

3. 执行打包

pyinstaller \
  --name "白泽智译" \
  --windowed --noconsole \
  --icon "build_assets/app_icon.icns" \
  --add-data "config.json:." \
  --add-data "logo.png:." \
  --add-data "welcome-cover.png:." \
  --hidden-import "PyQt6.sip" \
  --hidden-import "PyQt6.QtCore" \
  --hidden-import "PyQt6.QtGui" \
  --hidden-import "PyQt6.QtWidgets" \
  --osx-bundle-identifier "com.verbaflow.translator" \
  main.py

4. 生成 DMG 安装包

hdiutil create -volname "白泽智译" \
  -srcfolder dist/白泽智译.app \
  -ov -format UDZO \
  dist/VerbaFlow_v3.3.dmg

📱 首次启动与安全性

• 如果被系统拦截，右键应用选择"打开"或在系统设置中允许打开来自未认证开发者的应用

⚙️ 配置与日志

• 用户配置文件路径：~/Library/Application Support/白泽智译/config.json
• 日志目录：~/Library/Application Support/白泽智译/logs
• 程序会自动创建所需目录

❓ 常见问题

• 图标问题：确保 logo.png 存在且为正方形图片
• 依赖缺失：运行 pip install Pillow 安装图像处理库
• 体积较大：正常现象（pandas/openpyxl/scikit-learn 等依赖较重）
• Qt 模块错误：打包命令中已包含所需的隐藏导入参数

🪟 Windows 打包指南

本项目同样支持 Windows 平台的打包，提供便携版和安装程序两种分发方式。

🚀 快速打包（推荐）

便携版打包

使用一键打包脚本，自动完成图标创建、应用打包和压缩包生成：

build_windows.bat

完整打包（包含安装程序）

如果安装了 NSIS，可以创建专业的 Windows 安装程序：

build_windows_installer.bat

脚本会自动完成以下步骤：

1. 🎨 将 logo.png 转换为 Windows 风格图标（.ico）
2. 🧹 清理旧的构建文件
3. 📦 使用 PyInstaller 打包应用
4. 📦 生成便携版压缩包
5. 🏗️ 创建 NSIS 安装程序（可选）

打包完成后会生成：

• dist/白泽智译/ - Windows 应用程序目录
• dist/VerbaFlow_v3.3_Windows_Portable.zip - 便携版压缩包
• dist/VerbaFlow_v3.3_Setup.exe - Windows 安装程序（需要 NSIS）
• build_assets/app_icon.ico - Windows 风格图标

📝 手动打包步骤

如果需要手动控制打包过程：

1. 环境准备

pip install -r requirements.txt
pip install pyinstaller Pillow

2. 创建 Windows 风格图标

python create_windows_icon.py

这会将 logo.png 转换为多尺寸的 Windows 风格图标：

• 支持多种分辨率（16px 到 256px）
• 大尺寸图标带轻微阴影效果
• 符合 Windows 设计规范

3. 执行打包

pyinstaller ^
  --name "白泽智译" ^
  --windowed ^
  --noconsole ^
  --icon "build_assets\app_icon.ico" ^
  --add-data "config.json;." ^
  --add-data "logo.png;." ^
  --add-data "welcome-cover.png;." ^
  --hidden-import "PyQt6.sip" ^
  --hidden-import "PyQt6.QtCore" ^
  --hidden-import "PyQt6.QtGui" ^
  --hidden-import "PyQt6.QtWidgets" ^
  main.py

4. 创建安装程序（可选）

如果安装了 NSIS：

makensis installer.nsi

🎯 分发方式选择

• 便携版压缩包：适合个人用户，解压即用
• 安装程序：适合企业部署，自动创建快捷方式
• 程序目录：适合开发测试，直接运行

⚙️ 配置与日志

• 用户配置文件路径：%USERPROFILE%\AppData\Local\白泽智译\config.json
• 日志目录：%USERPROFILE%\AppData\Local\白泽智译\logs
• 程序会自动创建所需目录

💻 系统要求

• Windows 10/11 (64位)
• 内存：4GB+ 推荐
• 磁盘空间：500MB+
• 网络连接（用于 API 调用）

❓ Windows 常见问题

• 杀毒软件误报：PyInstaller 打包的程序可能被误报，添加信任即可
• 缺少 MSVC 运行库：安装 Microsoft Visual C++ Redistributable
• 图标显示异常：确保 logo.png 为正方形且分辨率足够
• NSIS 未找到：从官网下载安装 NSIS 后重新运行脚本

📝 更新日志

最新版本 v3.3 (2025-12-22)

重大更新

• 🎯 项目重命名为"白泽智译 (VerbaFlow)"
• 🎨 添加欢迎页图片和新的 macOS 风格圆角图标
• 🚀 完整的 macOS 打包系统，包含一键打包脚本
• 🔧 修复了打包应用无法启动的问题（日志系统路径问题）
• 📚 完整的打包文档和使用指南

新增功能

• 🖼️ 符合 Apple 设计规范的圆角矩形图标（22.37% 圆角半径）
• 📦 一键打包脚本 build_macos.sh
• 🎨 自动图标生成脚本 create_macos_icon.py
• 📋 完整的文档系统（BUILD_GUIDE.md, QUICK_START.md 等）
• 💿 自动 DMG 安装包生成

问题修复

• ✅ 修复打包应用启动失败问题
• ✅ 日志系统现在使用用户目录而不是应用包内目录
• ✅ 配置文件正确保存到 ~/Library/Application Support/白泽智译/
• ✅ 更新了所有文件中的应用名称

v3.2 (2025-11-14)

新增功能

• 🎨 项目 Logo 和可视化展示
• 🌐 中英文 README 相互切换功能
• 📋 开源许可证文件（GPL-3.0）和 NOTICE 文件
• ⚙️ 领域词汇匹配参数可视化配置（10个可配置参数）
• 💾 最大记忆数量可视化配置

改进优化

• 优化界面交互体验
• 代码清理和文档完善

📖 查看完整更新日志：CHANGELOG.md