Mini Trans

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(如部分人机验证、支付控件)也不会被读取或改写。

目录

本页内容

  1. 浏览器受限页面
  2. 平台与系统限制
  3. 功能范围说明