简介面向Android应用开发与本地化人员MediaTek String Translation ToolSTT是一款能显著简化字符串资源筛选与翻译流程的辅助工具适用于应用及框架层多语言项目帮助用户告别逐条检索的繁琐操作。该工具可直接读取Android工程的strings.xml等资源文件通过关键字过滤与批量替换减少人工校对负担也对自定义资源格式提供了一定的兼容支持。压缩包共11个文件以8个jar依赖库为主涵盖POI、SQLite、XML解析等关键组件另配有一个Windows批处理脚本、一个Linux/macOS Shell脚本以及一份PDF版用户手册整体仅11.41MB轻量易部署。目前已有227人学习浏览适合Android本地化工程师、测试人员及项目管理者使用。资源附带官方用户手册从环境配置到操作逻辑均有清晰说明同时整合跨平台启动脚本开箱即可运行可显著提升多语言版本的管理效率。 最近把一直在用的翻译小工具更新到了 v3.1511.01顺手打成了 exe 再压成 zip 丢到网盘里给几个朋友用。这个版本从内到外都换了一遍翻译引擎换成了国产的几个免费接口词库导入加了 CSV 支持剪贴板监听也重写了最关键是终于用 PyInstaller 把 Python 脚本完整打包成了独立 exe不再要求本机装 Python 环境。如果你也想要一个免安装、双击就能跑的离线翻译工具或者你正在纠结怎么把自己写的工具干净地打包成 exe zip 分发给别人这篇应该能省你不少事。我把从功能设计到打包发布的整个链路包括踩过的坑、被各种奇葩问题折磨后的排查思路都整理出来了。1. 为什么要坚持做成 exe zip 的绿色分发方式1.1 免安装的便携性才是用户真正需要的很多人以为做个工具交给别人用最重要的功能强大其实不然。我发过两版需要安装的版本用反馈来看大家最怕三件事一是安装包捆绑了各种看不懂的服务二是装在 C 盘怕垃圾太多三是换台电脑就得重新装一遍。TranslationTools 本身是个轻量工具没有任何需要注册系统服务的组件也没必要往注册表里写东西做成 zip 压缩包反而最省心。解压就能用用不惯直接删文件夹系统干干净净。实际上 exe zip 这种方案在 Windows 生态里很常见像很多便携版软件都是这个套路。它的真正优势在于用户可以把它放在 U 盘、移动硬盘里甚至在别人电脑上临时解压用完一删。我自己平时就是放到一个专门放绿色小工具的目录用 EveryThing 一搜就能找到比装到 Program Files 然后从开始菜单找快捷方式快多了。1.2 相比安装版和在线工具它吃了哪头亏又占了哪头便宜先算算床。安装版最大的好处是它能把环境配好比如 VC 运行库、.NET 框架它可以在静默时自动处理。但 TranslationTools 是一个 Python 写的工具打包成 exe 后其实不需要额外运行环境了所以安装包那套覆盖运行时的逻辑完全是多余的。在线翻译工具也用过但它最大的问题在于每次都要打开网页而且如果数据敏感往公网一传心里总会虚。本地离线翻译、批量翻译、术语管理这些东西在线工具做不好或者要收费。exe zip 的短板也明显杀软容易误报解压时如果不看提示容易点错还有某些 Windows 系统会拦掉“来自其他计算机”的文件。但只要处理得当这些问题都能克服。我最看重的是它对用户足够透明对作者也足够省事——改一个文件、重新压一次包就行不需要走安装包制作流程。2. TranslationTools v3.1511.01 的三大核心模块拆解2.1 多引擎聚合翻译怎么做到“离线也能翻基础词句”这个版本内置了三个翻译源第一是本地词库引擎第二是百度翻译的免费接口第三是腾讯翻译君。为什么要三个而不是一个原因很简单本地词库离线零延迟但覆盖范围只有常用词和术语集百度免费接口稳定但每分钟有请求次数限制腾讯偶尔延迟低不过风控玄学随缘。三个一起上就能够在不同场景下自动切换。具体实现上我设计了一个优先级链先查本地词库命中就直接返回没命中再走在线接口。在线接口又做了一层健康度检查如果某个接口连续 5 次超时自动标记为不可用把流量切到另一个。这样最大的好处是就算断网了工具也能完成基本的常用词翻译不会白屏报错。我测试过在完全断网环境下一个 2 万词的本地词库加上术语表小说里的高频词覆盖率大概在 65% 左右日常对话能到 80%。2.2 剪贴板监听的实现细节这里才是坑最多的剪贴板监听是这个工具最重要的功能之一。很多人问为什么不用全局快捷键呼出然后手动输词因为翻译这件事最自然的动作其实是复制。看到一段英文顺手 CtrlC工具就得能弹出翻译结果。v3.1511.01 里我把监听逻辑从轮询改成了事件驱动——监听系统剪贴板更新消息而不是每隔几百毫秒去读一次数据。前者响应速度快资源占用低后者容易漏东西还会 CPU 飙升。这里有几个关键点需要注意必须在剪贴板内容只有文本时才触发翻译图片和文件复制了就不要弹窗。我通过判断剪贴板格式列表里是否包含 CF_UNICODETEXT 来做过滤同时记录上一次内容哈希只有内容变化超过 200ms 才认为是新复制防止用户在同一段文本上复制两次却重复翻译。另外关掉剪贴板监听按钮以后必须彻底释放剪贴板句柄否则其他软件复制文件会卡顿。这个 bug 在上一版被用户骂过这次专门重写了资源释放逻辑。2.3 术语库和批量导出是拿来做专业文档翻译的底气如果你只是偶尔翻译个词用这个工具感觉功能平平。但它让我离不开的真正核心是术语库同步和批量导入。我平时会做一些英文技术文档的翻译有些产品名词、缩写和固定译法在通用翻译引擎里经常翻得乱七八糟。TranslationTools 支持 CSV 和 JSON 格式的术语导入每条术语可以带优先级命中术语时优先使用术语表里的内容再拼接句子其余部分的翻译。比如 “SQL injection attack” 这个词组如果没有术语表百度会直接翻成“SQL注入攻击”但我的术语表里定义的是“结构化查询语言注入攻击”这样最终结果就是后者。批量翻译时会自动读取 txt、srt 或 Excel 里的一列内容逐条翻译保留原格式输出。srt 字幕文件还能自动对齐时间轴这对字幕组的朋友来说算是一个小惊喜。3. 从 Python 脚本到 exe 再到 zip打包全流程实操3.1 PyInstaller 打包参数怎么选最终产物至少小三分一我一开始用默认参数直接打包出来的 exe 有 42MB解压后 80 多 MB被吐槽太胖。后来试了 UPX 压缩再配合 --exclude-module 排除掉不用的模块最终控制在 27MB。这个优化空间非常大。命令行是这样的pyinstaller --noconfirm --onefile --console --name TranslationTools \ --iconassets/translator.ico \ --add-data assets;assets \ --add-data terms;terms \ --exclude-module PyQt5 \ --exclude-module numpy \ --exclude-module pandas \ translation_app.py有几个参数我要重点说明。--onefile 会把所有东西打成一个单文件缺点是最初启动会慢一点因为它要先解压到临时目录但好处是给别人的时候只有一个文件不会出现漏发 dll 的情况。--console 是保留控制台窗口方便打印日志和调试给普通用户用的话建议换成 --noconsole 让窗口隐藏。如果你用 PyQt5 或 Tkinter 界面记得把对应的数据文件加入 --add-data否则图标和资源会全没了。还有一个容易被忽略的是虚拟环境。一定不要在系统 Python 环境下直接打包因为会把一堆无关的包都给带进来。我新建了 venv只安装 requests、pyperclip 等几个真正用到的依赖这样打包体积会小很多也能减少杀软误报的几率。3.2 杀软误报和“缺少 DLL”怎么办这两件事是连在一起的杀软误报几乎是每个 exe 工具作者都会遇到的问题。PyInstaller 打包出来的程序因为加了加壳、压缩行为上很像木马的特征。加上如果你的 Python 版本比较老或者你用了 UPX 压缩误报率更高。我处理的办法是关闭 UPX 压缩用高版本 Python 3.11 打包然后下载微软的代码签名工具 SignTool.exe申请一个免费的证书来签名。虽然免费证书只能签测试用但签名之后Defender 基本就不叫了SmartScreen 也不再每次提示“未知发布者”。至于“找不到 DLL”的报错多半不是真的缺 DLL而是系统缺少 VC 运行库或者你的程序用了某个第三方库的 native 扩展。最常见的是 Visual C Redistributable。最简单的根治办法是静态链接或者在打包配置里的 Analysis 中把需要动态库一并打入。我在项目里用到了 pyperclip 和 tkintertkinter 在打包时偶尔会漏 tcl/tk 数据文件导致启动报 _tkinter.TclError这个时候要加上 --add-data 把本地 Python 目录下的 tcl 文件夹一起打进去。3.3 压缩成 zip 的目录结构为什么不能把 exe 直接扔根目录打包出的 exe 不能直接裸奔就丢到 zip 里那样用户体验很差。我习惯做一层“包内文件夹”结构大概是这样TranslationTools_v3.1511.01/ ├── TranslationTools.exe ├── config/ │ ├── settings.json │ └── terms.csv ├── log/ │ └── translator.log ├── README.txt └── license.txt把 exe 和配置分开是为了避免用户每次解压覆盖整个文件夹时把自己的配置和术语表冲掉。版本升级时用户更希望保留自己积累的词库和设置。所以我会在启动时检查 config 目录是否存在如果不存在就自动生成默认配置只在用户自己没建 config 时才创建。这样用户更新版本时可以直接把新 exe 覆盖到旧文件夹数据不受影响。压缩格式我推荐用标准 zip别用 7z 或 rar。因为 Windows 自带资源管理器就能解压不需要额外装软件。4. 使用过程中最常被问到的七个问题4.1 为什么解压后双击 exe 没有反应这个问题排在所有反馈的第一位。大部分情况不是软件坏了而是根本没解压完全。有些人直接在压缩包预览窗口里双击 exe 运行这样虽然能启动但由于系统把临时解压路径设到了只读的临时目录config 和日志文件都没法写入程序就会异常退出且没有任何提示。正确做法是先完整解压到本地磁盘然后进入文件夹再双击运行。另外如果解压出来的是多个文件千万别“只挑 exe 拿走”缺少 config 和资源文件一样跑不起来。我建议用户固定放到一个目录比如 D:\GreenTools\TranslationTools这样以后升级也方便。4.2 在线接口报错或翻译结果空白多半是 key 过期了v3.1511.01 内置的百度翻译接口用的是我申请的个人免费版 key每天有 5000 次额度每分钟限制 60 次。如果你把它当主力翻译工具一天翻几百个长句很容易撞到限额。撞到之后的表现不是报错而是返回一个空结果或者“请求超时”。所以在界面上我加了一个状态指示器显示当前可用翻译源。如果遇到空白结果先去设置里检查接口配置改成自己的 key或者切到腾讯翻译君的接口就能继续用。这个版本的接口配置是明文写在 settings.json 里的你自己申请的话填入即可不影响其他人使用。4.3 术语表为什么偶尔不生效术语不生效的最常见原因是编码不对。我的术语表支持 UTF-8 with BOM 和 UTF-8 两种但用户在 Windows 上用记事本另存为的时候有时候会存成 ANSI 编码导致中文字符直接乱码匹配失败。另外术语表里每一行必须是“原文,译文”的格式多了空格或引号就会解析错误。我建议用 Excel 编辑好 CSV 后另存为 CSV UTF-8 格式再导入。如果你用的是 JSON 格式注意字符串必须加双引号我见过有人改成了单引号死活导入不进去。作为一名强迫症作者我在新版本里加了导入校验出错时会高亮标记失败行方便你定位。4.4 软件被 Windows Defender 隔离怎么办这个前面提过但仍然要单独列出来。如果你是从网盘下载的Windows 可能会给文件打上“来自网络”标记Zone.Identifier这会导致杀软更容易关注到它。解压之后在文件上右键“属性”如果看到“解除锁定”勾选项记得勾选并确定然后再运行。如果已经被隔离了建议先彻底删除下载的压缩包重新解压一次。千万不要在隔离区直接恢复那样残留的恶意软件扫描缓存还可能在下次运行时再次报毒。我在 README 里也写了这段话但很多人不看。4.5 同一段文本复制两次为什么不弹翻译这是设计使然。v3.1511.01 里加入了“重复内容忽略”机制避免你复制一段长文本后又复制一次相同内容导致弹窗反复横跳。如果你确实需要重新翻译同一段内容可以把目标文本后面加个空格再复制或者点击托盘图标里的“手动翻译”按钮粘贴进去。有一些用户反馈这样操作“多此一举”但我觉得这个是利大于弊的尤其是复制代码时很多人会无意识连续复制多次弹窗太频繁会崩溃。如果你想改成每次都弹在 settings.json 里把 ignore_duplicate 改成 false 即可。4.6 zip 压缩包被加密破解的传闻是真的吗不是真的但也不是假的。网传“zip 无视密码直接解压”的办法只适用于传统的“ZipCrypto”加密文件头有 0x9E 标志以及弱口令情况。如果压缩时用了 AES-256 加密并且密码足够复杂目前基本没有暴力破解的可能。所以如果你是分发者即使压缩包设了密码也要把密码单独私发给用户别放进文件名或说明文档里如果你是使用者忘了密码最好的办法是回忆或找管理员要别抱太大希望。顺带提一句百事牛的密码恢复工具本质上也是暴力破解耗时很长不推荐。4.7 怎么验证自己下载的确实是官方原版我给每个版本的 zip 都生成了 SHA-256 校验值放在发布页面和压缩包内的 README.txt 里面。你下载后在 PowerShell 里输入Get-FileHash -Path .\TranslationTools_v3.1511.01.zip -Algorithm SHA256对比一下输出值和官方给出的值如果一致说明文件没有被二次篡改。这个方法同样适用于其他软件分发场景尤其现在很多人习惯在网盘里互传文件中间只要换过一手就有可能被添加东西。养成校验哈希的习惯能避开很多坑。5. 新版本打磨过程中的一些碎碎念说实话做到 v3.1511.01 这里我对“工具型软件”的理解已经和早期完全不一样了。以前总想加功能什么 OCR、整页翻译、朗读能塞多少塞多少后来发现用户真正高频使用的就那三四个核心操作。把剪贴板监听做好把术语库做灵活把打包做轻巧很多问题迎刃而解。如果你也想做类似的分发我强烈建议保留一个最小可用版本只留核心功能剩下的通过配置扩展。这样你的 exe 不会越做越肥用户上手也不会被一堆按钮吓跑。而且我越来越认同一件事工具类软件的作者最重要的不是炫技而是让用户在最短时间内解决掉眼前的问题。翻译这件事尤其如此越快、越准、越省事用户体验就越好。后面我可能会再出一个绿色版把 OCR 识图也加进来但那又是另一个话题了。本文还有配套的精品资源点击获取