问题排查
从症状出发，找到导致它的那个设置。
每个功能页都有自己的排查小节。本页是索引：找到症状，点链接过去。
完全没反应
| 你看到的 | 通常是 |
|---|---|
| 某个网站上没有悬浮按钮、没有工具栏、什么都没有 | 该网站被站点控制排除了 |
| 所有网站上都没反应 | 扩展在浏览器的扩展页面里被禁用了 |
| 悬浮按钮在，但点了没用 | 没有已启用的服务商，去 API 提供商看看 |
| 快捷键没反应 | 被别的扩展或网站抢走了，在快捷键里改绑 |
| 右键菜单项点了没用 | 该网站被站点控制排除了。菜单项在被排除的网站上仍会显示，但点击不会有任何效果 |
页面有一部分没被翻译
陪读蛙有意跳过文本的情况比大家以为的多。
- 导航、页眉、页脚保持原文 —— 翻译范围设成了「主内容」。在网页翻译里改。
- 短句保持原文 —— 翻译控制里的小段落过滤设了最小长度。
- 混合语言页面上某些段落保持原文 —— 语言跳过判定它们已经是目标语言了。同一页。
- 控件、canvas 或特殊元素里的文字 —— 内容检测没把它当成文本。针对单站的修正见站点规则。
- 往下滚动时不再出现新译文 —— 预翻译距离，在请求控制里。
译文本身不对
- 某个人名或术语在段落之间变来变去 —— 在术语库里给它固定译法。注意术语库只对 LLM 服务商生效。
- 意思对但读着别扭 —— 换「精翻重写」提示词，或者自己写一个，见自定义提示词。
- 代词和指代关系错了 —— 在网页翻译里打开 AI 智能上下文。
- 返回的是说明、标签或
%%而不是译文 —— 提示词丢了占位符，或者和批量规则冲突。一次请求是怎么拼出来的说明了模型到底被要求做什么。 - 某段译文是空的 —— 模型判定它已经是目标语言了，空译文不渲染任何内容。见一次请求是怎么拼出来的里「判定「无需翻译」」那节。
很慢，或者中途停了
- 慢，或者请求成片失败 —— 在请求控制里降低速率和突发上限。免费档服务商的限制很严。
- 长页面翻到一半停了 —— 同一页：队列重试后放弃了。调小批量大小。
- 本地模型上每次翻译都很慢 —— 反过来，调大批量；本地模型的开销在每次请求上，不在 token 上。
- 改完提示词之后行为变了 —— 编辑提示词会丢弃已缓存的译文，下次阅读会重新请求全部内容。
排版乱了
字幕
- 播放器里没有翻译按钮 —— 这个视频没有 YouTube 暴露给播放器的字幕，或者字幕功能在视频字幕里是关着的。
- 字幕在句子中间被切断 —— 在 AI 分段与字幕额度里打开 AI 智能分段。
- 打开之后字幕和画面对不上了 —— AI 分段会自己重设时间轴；如果漂移比切断更让你困扰，就关掉它。
账号、保存与复习
- 在网站登录后弹窗里还显示 Guest —— 刷新当前页面；扩展是在标签页加载时读取登录态的。
- 没有保存到笔记库的入口 —— 这个自定义 AI 指令没有配置笔记库连接，或者它的服务商不支持结构化输出。见从扩展保存。
- 自定义 AI 指令返回空的或格式错乱的字段 —— 模型对结构化输出支持不好。换一个，或者在服务商提供该选项时关掉推理。
- 助手连不上 MCP —— MCP 需要 Ultra 套餐，见连接。
这里没有匹配的
在配置、同步与备份里不勾选 API 密钥导出配置，附到 GitHub issue 里，或者到 Discord 问。导出文件会说明当前用的是哪些服务商、提示词和规则，这通常就是答案本身。