floattrans

项目概述

浮译 FloatTrans 是一款 macOS 菜单栏实时翻译工具。它读取当前应用中支持辅助功能的文本输入框，按设定的语言方向翻译，并把结果放在一个低打扰的浮动框里，不需要复制粘贴，也不需要额外的快捷键。

一边打字，译文就静静出现在旁边。

主要功能

• 多语言方向：源语言与目标语言可分别选择中文、英语、日语、俄语、韩语、法语、德语与西班牙语
• 双引擎：可选用 macOS 本地翻译，也可切换到大语言模型 API
• 多模型故障切换：兼容 OpenAI 兼容接口、Claude、DeepSeek、GLM 与自定义端点，多个模型可排序并在超时后自动切换
• 安全保存密钥：API 密钥存入 macOS 钥匙串，偏好设置只保存非敏感配置
• 翻译历史：默认不记录，可选保留 1 天到永久，支持确认后清空并导出 Markdown 或 Excel
• 浮动框控制：最多保留 3 个浮动框，支持替换上一句或向下堆叠，自动换行与高度自适应
• 显示位置与外观：支持右上角、底部居中与右下角，可调边距、字号与自动隐藏时间
• 快捷键：可配置翻译、替换原文、复制译文与朗读的快捷键，朗读语音随目标语言切换
• 应用排除：可把不希望被读取的应用加入排除名单

适用人群

• 经常需要中译英或其他语言互译的办公用户
• 在浏览器、编辑器与聊天软件间频繁切换的用户
• 关注隐私、希望本地翻译的用户

快速上手

1. 下载 DMG 并把 FloatTrans.app 拖入应用程序目录
2. 首次打开后按引导前往「系统设置 → 隐私与安全性 → 辅助功能」开启浮译
3. 在设置 → 翻译中选择源语言与目标语言，缺语言包时点击下载并等待完成
4. 如需 API 翻译，切换到「大语言模型 API」并填写地址、密钥与模型名称
5. 在支持辅助功能的输入框里输入所选源语言，停止输入片刻后即显示译文
6. 需要写回或复制译文时，在设置里开启「替换原文」或「复制译文」并使用对应快捷键

核心优势

• 不打断输入：无需复制粘贴或切换窗口，译文自动出现
• 本地优先：可选系统本地翻译，文本不出本机
• 模型自由：多家大模型接口都能接入，并支持超时自动切换
• 密钥安全：密钥存入系统钥匙串，不写入偏好设置

系统要求

项目	要求
操作系统	macOS 15 或更高版本
权限	辅助功能权限
本地翻译	对应语言对的系统翻译语言包

注意事项

• 不同应用对辅助功能接口的支持程度不同，自绘控件或未暴露文本元素的应用可能无法读取
• 分发版本默认未公证，首次打开需要右键选择打开
• 使用大语言模型翻译时，输入内容会发送到所选服务商
• 更换应用路径或签名后，可能需要在辅助功能中重新授权