Mini Trans 做不到的事
Mini Trans 作为浏览器扩展运行在网页上下文中,受限于浏览器安全模型和平台能力,存在以下明确的功能边界。安装或排查问题前可以先了解这些限制。
浏览器受限页面
基于浏览器安全策略,扩展内容脚本只注入到常规的 http:// 和 https:// 网页中,以下页面无法使用网页翻译、划词翻译、悬浮球或快捷键:
- 浏览器内置页面,如
chrome://settings、edge://extensions、about:addons、about:config; - 浏览器扩展商店,如 Chrome 应用商店、Microsoft Edge 加载项、Firefox 附加组件商店;
- 新建标签页或空白页(
chrome://newtab、about:blank); - 未显式授权访问本地文件时的
file://本地 HTML 或本地 PDF 页面。
遇到这些页面时,点击扩展图标或按下 ⌥AltS 等快捷键不会在页面中产生翻译效果,这是浏览器本身的限制。
平台与系统限制
不同浏览器提供的底层 API 不同,导致部分功能存在平台差异:
- macOS Safari:要求 macOS 上的 Safari 18.4 或更高版本。Safari 不支持
chrome.identity授权接口,因此 Google Drive 云同步在 Safari 上不可用(可使用 WebDAV 或 JSON 导入导出);此外 Safari 也没有 Chrome/Edge 的浏览器内置端侧 AI 翻译器。 - Safari 快捷键修改:受 Safari 自身限制,从 Safari 26 起才支持在「Safari → 设置 → 扩展」中修改浏览器快捷键;Safari 18.4—25 版本可在 Mini Trans 设置 › 外观 › 快捷键中使用内置的「双击快捷键」和「功能快捷键」。
- 浏览器内置 AI:仅支持桌面版 Chrome 138+ 与 Edge 148+,Firefox 和 Safari 均不提供该本地模型接口。
- 移动端浏览器:当前主要面向桌面端浏览器及 macOS Safari 设计。
功能范围说明
- 视频双语字幕:目前仅支持 YouTube 网页播放器,暂不支持其他视频网站。
- 内置免费服务与自带密钥:微软、谷歌、Yandex 与浏览器内置 AI 开箱即用;DeepL、Azure Translator、Google Cloud Translation、百度翻译以及 OpenAI、DeepSeek、Gemini、Claude 等云端 AI 服务需要你自行在对应平台申请并填写 API Key(Ollama 可在本地运行,无需密钥)。
- 页面内受保护的输入框与编辑器:网页终端(如 xterm.js)与专业代码编辑器(如 CodeMirror、Monaco、Ace)以及只读输入框不会显示 AI 写作小圆点,因为这些控件无法安全地写回改写后的文本;加密或封闭的 Shadow DOM(如部分人机验证、支付控件)也不会被读取或改写。