常见问题
安装相关
1. 如何更新扩展
一般来说，在浏览器商店安装的扩展，浏览器都会自动进行更新，一般情况会在扩展更新之后的一天内进行自动更新，如果你想立刻更新到最新版本的话，可以在浏览器的【扩展管理】页面，打开【开发者模式】，然后点击最上面的【更新】，即可立即更新到商店的最新版本。
2. 沉浸式翻译油猴脚本支持的浏览器
iOS：
- Tamper Monkey 浏览器
-
安装油猴扩展后的 Safari 浏览器，可安装的油猴扩展：
- Userscripts
- Stay ：建议直接在 Stay 自带的商店里搜索沉浸式翻译优化脚本下载（针对 Stay 做了特殊优化）。
Android：
- Firefox 最新版本 ：安装完成后，再安装 Tamper Monkey 扩展。
- X 浏览器 ：安装后，直接打开 沉浸式翻译油猴脚本地址 即可安装。
已知不支持的油猴扩展的浏览器（这类浏览器并没有实现所需的油猴 API）：
- 安卓 Via 浏览器
- iOS Alook 浏览器
3. 在 chrome 上安装插件安装包报错
报错
invalid value for web_accessible_resource[0]
：需要 Chromium 版本大于 88 才能支持 manifest_version 3。
4. 360 浏览器如何安装
只支持 360 极速浏览器 x，记住是带 x 的。如果可以访问谷歌扩展商店，直接可以去那里装。如果访问不了就 手动安装 。
5. Opera 浏览器不生效
在 google.com 等搜索页面不生效，插件显示
请先刷新当前页面，再开始翻译
且刷新页面仍提示该信息：需要在 Opera 插件设置中找到【沉浸式翻译】，开启【允许访问搜索页面结果】选项。
6. 在 iOS 设备上无法启用扩展
如果您在 iOS 设备上无法启用扩展，请按照以下步骤操作：
- 打开【设置】应用
- 滑动并点击【屏幕使用时间】
- 选择【内容和隐私访问限制】
- 点击进入【内容访问限制】
- 选择【网页内容】，并将其设置为【无限制】
如果您不需要使用内容和隐私访问限制的其他功能，您也可以选择直接关闭内容和隐私访问限制：
- 打开【设置】应用
- 选择【屏幕使用时间】
- 禁用【内容和隐私访问限制】
7. Safari 打开设置页面 一直 loading
系统设置 -> safari浏览器-> 高级 -> 网站数据 -> 编辑 找到 immersivetranslate.com 删除
8. iOS18 安装后进入设置页面登录时跳转到空白页面
长按悬浮球点击头像去登录。
9. crx 文件拖拽至浏览器扩展程序，显示文件不存在
需要先解压压缩包，再单独拖CRX文件。
基础翻译相关
1. Youtube, Facebook 等网站主要内容翻了，但是部分侧边栏没法，想翻译全部
为了页面可读性，所以沉浸式默认只翻译主要内容区域。如果想翻译全部区域。
打开悬浮球面板(移动端长按) -> 点击右下角更多 -> 选择全部区域。
2. 手机 App 中不显示悬浮球
-
沉浸式翻译插件为浏览器插件， 只能在浏览器 中运行，无法在其他 app 中使用，不支持其他 App 内部翻译。
-
在哪个浏览器安装插件即可在哪个浏览器使用， 无法跨浏览器 （如在Safari内安装不可以在Chrome内使用插件）
3. iOS 浏览器上点击 YouTube 直接打开 App，无法进入网页翻译
长按 YouTube 链接弹出悬浮窗选择网页打开。
4. 如何关闭自动翻译
- 在 Popup 面板或者设置页面取消。
- 或者通过设置页面修改
5. 暂无权限翻译当前页面
- 浏览器默认页(地址栏无地址)
- 第三方插件页面
- 谷歌插件禁止了谷歌商店页面
6. 如何不显示原文
点击沉浸式翻译图标，打开扩展面板，点击【更多】，【切换到仅译文模式】。
7. 页面出现感叹号
页面出现感叹号，说明翻译服务遇到问题，返回了错误，可以将鼠标移动到感叹号上查看具体错误。
例如：429 错误
这是最常见的错误之一，429 表示请求的频率过快。网页翻译中有非常多的段落需要翻译，尽管我们已经做了极大的优化，包括合并段落，频率控制等等，但是有的时候依然有一些翻译服务不堪重负，返回 429 频率限制的错误，这种时候一般可以暂时切换到其他翻译服务，或者等一会儿再试。
如果你是 Google 服务遇到的 429，一般来说是谷歌针对你的节点做了限流，建议切换节点。
8. 怎么切换翻译源与目标语言
移动端长按悬浮球，电脑端鼠标移动至悬浮球唤出设置，选择其他翻译服务/其他目标语言。
9. 谷歌翻译接口被墙问题
请将
translate.googleapis.com
域名加入到代理规则中。
10. OpenAI 封禁中国地区 API Key 对会员 AI 服务是否有影响
没有影响，产品使用 Azure 企业版 OpenAI，不受 API 地区限制。
11. 彩云翻译报错
点开
?
号的报错信息显示"Unsupported trans_type"。可以手段选择自动检测语言为指定语言。
12. 微信读书无法翻译
因为微信读书针对内容做了特殊处理，防止通过第三方手段获取内容，所以无法翻译。
13. 网页部分内容未翻译
一般是网站管理者通过
translate="no"
或者
notranslate class
来约定翻译插件不翻译这块区域，不过可通过以下方式解决：
- 启用鼠标悬停功能
- 通过鼠标悬停来强制翻译该区域段落内容
14. 触发翻译不生效
其他网站能翻译，就某个网站不能翻译时：
-
如果这个网站访问人比较少
- 建议通过鼠标悬停来翻译段落
- 如果需要翻译整篇网站可以通过 用户规则 适配
-
如果这个网站有很多人用
- 可以先通过鼠标悬停翻译使用
- 在群里呼叫，会稍后安排适配
15. 网页翻译有问题，如何保存网页反馈
需要在网页中右键点击“存储为” 或者 ctrl+s 快捷键，保存选项选择单个文件，最后文件格式为.mht/.mhtml。 然后将文件发送至 [email protected] 。
16. 查看调试日志
- 开启调试日志：打开面板 -> 设置 -> 开发者设置 -> 启用”在控制台打印调试日志“。
- 打开网站的控制台：右键打开审查 -> 右边栏目顶部切换到控制台 -> 执行操作就可以看到日志。
17. 如何关闭悬浮球
- 在当前页隐藏：设置为 【永不翻译该网站】 即可
- 在所有页面隐藏：打开【设置页】-【界面设置】，关闭【在页面上显示悬浮球】即可
18. 鼠标悬停 + 快捷键翻译功能无效
要启用鼠标悬停加快捷键的翻译功能，页面必须首先获得焦点。如果您发现该功能未能触发，请尝试以下步骤：
- 在页面任意位置点击一次，以确保页面获得焦点。
- 再次尝试同时使用鼠标悬停和快捷键进行翻译。
- 如果翻译功能仍然不响应，请确认您的快捷键设置是否正确。
19. 如何更新最新规则
扩展本身会在使用的时候定时同步官方最新对网站适配的规则，你也可以手动同步最新的规则，点击浏览器的沉浸式翻译扩展图标，打开弹窗后扩展会会自动检测最新适配规则并同步，油猴脚本同理。
20. 翻译失败 / 翻译一直转圈
-
查看失败原因
- 如额度达到限制则是会员当月该翻译源额度用尽
- 如翻译显示网络错误请先检查自身节点/网络状态
-
切换翻译源，长按悬浮球选择其他翻译源
21. Pro会员翻译额度与用量如何查询
-
AI翻译（包括OpenAI）500w Token，DeepL 翻译 1500w Token
OpenAI 的定价是基于 token 的，对于英文文本，1个token大约是4个字符或0.75个单词。通常1000个Token约等于750个英文单词或者400~500个汉字。
22. 各 AI 翻译是否共用额度
是的，Openai，Gemini，Claude 共用 AI 翻译 500w token 限额。
视频翻译相关
1. Youtube 字幕设置样式
可以直接点击Youtube 自带的字幕设置， [Options] , 然后就可以调整大小，颜色等。
2. YouTube 双语字幕繁体中文不显示
YouTube 自带机翻字幕，繁体中文会出现格式错误，导致所有字幕在开始的时候弹出一大段字幕，基于此场景建议在【设置】【视频字幕】中开启【使用沉浸式翻译来翻译字幕】选项。
3. Bilibili 如何开启字幕翻译
在翻译 Bilibili 视频字幕时，请按以下步骤操作：
- 先开启 Bilibili 内置字幕，点击播放器右下角的 “字幕” 按钮即可。如果视频没有字幕按钮或字幕内容，则不支持双语字幕。
- 点击播放器中的 “沉浸式翻译” 图标，开启双语字幕功能。
使用时需注意：
- 确保已经开启 Bilibili 的内置字幕。
- 确保沉浸式翻译的目标语言与 Bilibili 内置字幕的语言不同，以触发翻译功能。
4. Netflix 字幕翻译用原始字幕样式
- 进入【 开发者设置 】 找到 【Edit User Rules】