双语翻译助手
AI 网页与视频字幕双语翻译 · 使用你自己的 API Key
脚本简介
双语翻译助手 - AI 网页与视频字幕双语翻译 是一款运行在用户脚本管理器中的 AI 翻译工具。它调用你自己配置的 DeepSeek 或 OpenAI 兼容接口，为网页正文、YouTube/HTML5 视频字幕、输入框文本和选中文本提供双语或仅译文显示。API Key 只保存在本地，脚本不接入遥测或统计服务。
功能描述
这个脚本能做什么
网页段落级双语翻译，保留原有链接、按钮、表格和点击区域。
YouTube 与普通 HTML5 视频字幕翻译，支持人工字幕优先和 AI 翻译回退。
输入框三连空格翻译、划词工具栏、悬浮球控制面板。
使用 DeepSeek 官方接口或任意 OpenAI 兼容接口，密钥由你自己管理。
界面截图
网页双语翻译
段落级双语对照，原文完整保留，静态链接和按钮依然可以点击；悬浮球贴边收起，随时唤起。
悬浮球控制面板
在一个面板内切换目标语言和翻译服务、开关 AI 上下文与“仅译文”，并进入视频字幕、输入框翻译和更多设置。
设置与服务
填入 API Key 后点击“测试服务”即可验证密钥、接口地址和模型是否可用；设置面板支持深色主题。
网页翻译
双语 / 仅译文两种模式，可随时切换，无需重新请求翻译。
译文可放在原文下方或上方，支持 20+ 种译文样式（下划线、虚线、高亮、标记、纸张、边框、引用等）。
可调整译文字号与段落间距，自动适配页面深浅色主题。
懒加载翻译：只翻译进入视口的段落，滚动到新内容时自动继续。
自动跟踪 SPA 路由变化和动态插入的内容，新内容会自动翻译。
支持开放 Shadow DOM 页面、display: contents 组件和常见前端框架。
可翻译页面标题、输入框 placeholder、按钮 value 等属性文本。
站点规则：始终翻译、从不翻译、从不翻译指定语言；可设置最小翻译长度。
译文缓存：内存缓存 + 可选本地持久缓存，减少重复请求；持久缓存只保存译文，不保存网页原文。
请求控制：批量大小、并发数、超时时间、重试次数均可配置。
可选择是否把页面标题作为上下文发送给 AI。
YouTube / HTML5 视频字幕
自动读取 YouTube 字幕轨道或页面 timedtext 数据，也支持普通 HTML5 <track> 字幕。
YouTube 上优先使用目标语言的人工字幕；没有人工字幕时自动调用 AI 翻译。
双语 / 仅译文独立于网页模式，可单独切换。
字幕断句合并、句尾标点清理、环境音与音乐描述过滤。
按播放进度懒翻译，可设置 15-300 秒预翻译窗口。
字幕浮层可拖动，位置按站点记忆；可调原文/译文字号、颜色、背景色与透明度、阴影样式。
字幕位置可在原文上方/下方切换，浮层可在视频顶部/底部显示。
YouTube 播放器内提供字幕快捷按钮，可切换模式、下载 VTT/SRT 字幕。
仅在我们的双语字幕实际显示时才隐藏原生字幕；加载失败时自动回退到平台字幕。
支持按站点自动开启或关闭字幕翻译。
输入框翻译
在文本框、搜索框或可编辑区域输入文字后，快速连按三次空格即可翻译。
支持双语或仅译文写回；翻译前会校验输入是否被修改，避免覆盖新输入。
可在开头用 //ja、/en 等语言代码临时指定目标语言。
英文输入可自动转换为中文（可关闭）。
提供加载动画、错误提示和“撤销”操作。
划词工具栏
悬浮球与控制面板
可拖动悬浮球，自动贴边收起，位置和左右侧会记住。
点击可打开翻译面板或直接翻译页面，行为可配置。
面板内可切换目标语言、翻译服务、双语/仅译文、站点规则和 AI 上下文。
关闭悬浮球时可选择“本次会话”“当前站点”或“永久关闭”。
支持透明度、站点黑名单和快捷键 Alt+A 切换整页翻译。
服务与设置
翻译服务：DeepSeek 官方接口，或任意 OpenAI 兼容接口（自定义 URL、模型、请求头）。
默认 DeepSeek 模型为 deepseek-flash，可在设置中修改。
提供“测试服务”按钮，直接验证 Key、地址和模型是否可用。
界面支持 10 种语言：简体中文、繁體中文、English、日本語、한국어、Español、Français、Deutsch、Русский、Português。
目标语言 60+。
支持导出/导入设置；导出时会自动移除 API Key 和自定义请求头。
支持一键清除翻译缓存。
用量统计显示本次会话的 Token 用量与缓存命中情况。
支持浅色、深色和跟随系统主题。
安装与配置
- 安装 Tampermonkey、Violentmonkey 或其他支持
GM_* API 的用户脚本管理器。
- 安装本脚本（在用户脚本管理器中打开该链接即可弹出安装页）。
- 首次运行会自动打开设置；在 DeepSeek 控制台创建 API Key 并填入。
- 如果使用自定义服务，填写接口地址、模型名称，必要时填写自定义请求头 JSON。
- 点击“测试服务”，确认返回译文后即可使用。
隐私说明
API Key 保存在用户脚本管理器的本地存储中（无 GM 存储时回退到 localStorage）。
脚本只会向你配置的翻译接口发送待翻译文本；不会上传浏览记录或页面内容到作者服务器。
不包含遥测、统计、错误上报或广告代码。
本地持久缓存只保存译文；网页原文不会写入持久缓存。
自定义接口需要 @connect * 权限；脚本只会向配置的接口地址和字幕数据地址发起请求。
权限说明
GM_xmlhttpRequest / @connect *：调用你配置的翻译接口，并读取 YouTube 字幕数据。* 用于支持任意自定义接口域名，脚本不会主动访问其他地址。
GM_getValue / GM_setValue / GM_deleteValue：保存设置、译文缓存和标签页翻译状态。
GM_getTab / GM_saveTab：在支持的管理器中记忆当前标签页的翻译意图。
GM_registerMenuCommand：在脚本管理器菜单中提供翻译、字幕、设置等快捷入口。
unsafeWindow：仅在 YouTube 上读取播放器字幕数据并安装字幕监听钩子。
兼容性与限制
适用于桌面版 Chrome、Edge、Firefox 等主流浏览器，需配合支持 GM_* API 的用户脚本管理器使用。
不支持 PDF、EPUB、图片文字、Canvas 绘制文字和硬字幕（烧录在视频画面中的字幕）。
封闭 Shadow DOM、跨域 iframe 内的正文可能无法翻译；嵌入的 YouTube iframe 只启用字幕翻译。
翻译质量取决于所选模型和接口；脚本会尽量保留数字、URL、代码和占位符，但无法保证 100% 不变。
使用你自己的 API Key，产生的费用由你的 API 账户承担。
常见问题
页面没有翻译？ 检查 API Key、接口地址和模型；确认当前站点不在“从不翻译”列表；确认页面语言与目标语言不同；如果开启了懒加载，请滚动页面。
字幕没有出现？ 确认视频本身有字幕轨道；YouTube 可尝试打开一次原生 CC；如果使用人工字幕优先，等待几秒让脚本匹配目标语言轨道。
提示 401/403/429？ Key 无效、权限不足或额度用完，请在服务商控制台检查。
悬浮球不见了？ 可能被“本次会话/当前站点/永久关闭”隐藏，或站点在黑名单中；可通过脚本管理器菜单重新打开设置。
如何切换界面语言？ 设置 → 基本设置 → 界面语言；切换后控制面板会重建。
更新日志
1.1.3
- 修复 ScriptCat 图标显示不完整：网站与扩展都按图标 URL 缓存图片，原 URL 下换成新图不会被重新抓取，导致一直显示最初那张被裁坏的图。现改为新地址
assets/icon-128-v2.png（内容与原图标一致），同时移除多余的 @icon64 声明
1.1.2
提升界面控件的翻译覆盖率：按钮、标签、徽标等短文本现在也会被翻译（例如 GitHub 的 Star / Fork / Branch / Tags / Commits）。
修正译文被插入到视觉隐藏文本中的问题，译文现在始终可见。
忽略纯数字或纯符号的装饰性元素，避免译文里数字重复。
1.1.1
- 补充脚本图标元数据（
@icon / @icon64），ScriptCat、Tampermonkey 的脚本列表会显示应用图标。
1.0.0
首个公开版本。
网页双语/仅译文翻译、懒加载、动态内容、Shadow DOM、站点规则、标题与属性翻译。
YouTube/HTML5 字幕翻译、人工字幕优先、断句合并、环境音过滤、拖动浮层、VTT/SRT 下载。
输入框三连空格翻译、划词工具栏、悬浮球控制面板。
DeepSeek 与 OpenAI 兼容接口、翻译缓存、用量统计、10 种界面语言。
修复内联译文位置切换的空格顺序、字幕下载重复请求、字幕轨道恢复、超时重试判断等问题。
许可证
MIT License。
反馈
欢迎在 Greasy Fork 的脚本页面留言反馈问题或建议。
