自动翻译助手 （Auto Translation Assistant） 详细说明
- 简介
自动翻译助手 是一款功能强大的 Tampermonkey 用户脚本，能够将任何网页内容实时翻译成您指定的目标语言。 它提供了两种翻译引擎（微软 Edge 内置引擎和微软 API 引擎），并具备可移动、可缩放的悬浮控制面板，支持白名单管理、忽略特定元素、自定义术语、译文颜色和显示模式等高级功能。 脚本采用独立样式设计，兼容暗色模式，且支持移动端触摸操作。
· 版本：2.5.3
· 作者：Eray
· 适用环境：任何现代浏览器（需安装 Tampermonkey 或 Violentmonkey）
· 开源协议：Apache-2.0
- 主要功能
功能模块 描述
双引擎支持 可选择“微软 Edge”引擎（基于浏览器内置翻译）或“微软 API”引擎（直接调用微软翻译接口）
网站白名单 添加到白名单的网站将始终自动翻译，不受全局开关影响
专用翻译引擎 可为特定网站单独指定翻译引擎，覆盖全局设置
可移动悬浮窗 提供完整的设置面板，支持拖拽移动、右下角调整大小（PC端），移动端支持触摸拖拽和尺寸滑块
译文显示模式 微软 API 引擎支持“单显”（替换原文）和“双显”（原文+译文并排）两种模式
颜色自定义 可自定义译文文字颜色和背景高亮色（仅微软 API 引擎）
忽略规则 按 CSS 类名或 ID 跳过特定元素，避免翻译干扰
自定义术语 定义特定词汇的翻译规则（如“百度=baidu”），保证专有名词翻译准确
动态内容监听 自动监听 DOM 变化，翻译 AJAX 加载的新内容
划词翻译 鼠标选中文本后自动弹出翻译（PC端）
缓存机制 缓存已翻译内容，提升重复翻译性能
暗色模式适配 自动检测系统暗色模式并调整面板样式
快捷键菜单 在 Tampermonkey 菜单中添加“开启/关闭翻译”、“白名单管理”、“打开设置”等选项
安装方法
安装用户脚本管理器
在浏览器中安装 Tampermonkey（推荐）或 Violentmonkey。
安装自动翻译助手
· 访问脚本原始发布地址（如 GreasyFork 或 GitHub），点击安装；
· 或新建用户脚本，将本脚本完整复制进去并保存。
确认脚本已启用
在浏览器工具栏的 Tampermonkey 图标中，应能看到“自动翻译助手”处于启用状态。
访问任意网页
脚本会自动加载，右下角会出现可拖动的悬浮按钮（⚙️），点击即可打开设置面板。
- 使用指南
4.1 悬浮控制面板
· 打开/关闭：点击页面右下角的齿轮图标（⚙️）即可切换面板显示。
· 移动：按住面板顶部的标题栏（显示“✨ 自动翻译助手”）拖动。
· 调整大小（PC）：将鼠标移到面板右下角，出现双向箭头后拖动。
· 关闭：点击标题栏右侧的“✕”按钮。
4.2 基础设置
选项 说明
源语言 网页的原始语言（默认为英语），用于提高翻译准确度。
目标语言 您希望翻译成的语言（如简体中文、繁体中文、日语等）。
全局翻译引擎 选择默认使用的翻译引擎：“微软 Edge”或“微软 API”。
专用引擎（当前网站） 为当前域名单独指定引擎，留空则使用全局引擎。点击“保存”后立即生效。
4.3 白名单管理
· 白名单中的网站总是自动翻译，不受全局“开启自动翻译”开关的限制。
· 添加：通过 Tampermonkey 菜单（浏览器扩展图标中）选择“☆ 添加到白名单”。
· 删除：在设置面板的白名单区域，点击每个域名旁边的“删除”按钮；或点击“清空白名单”一键清空。
· 折叠/展开：白名单超过 3 个条目时会自动折叠，点击“展开全部”可查看完整列表。
4.4 微软 API 专用设置（仅当使用微软 API 引擎时生效）
设置项 说明
显示模式 “单显”直接用译文替换原文；“双显”保留原文并在下方/后方显示译文（原文颜色较暗，译文有自定义颜色）。
译文颜色 可通过色板快速选择预设颜色，或手动输入十六进制颜色代码（如 #0066cc）并点击“应用”。 背景高亮色会自动生成半透明版本。
4.5 高级设置（点击“⚙️ 高级设置”展开）
设置项 说明
忽略Class 输入要跳过的元素的 CSS 类名，多个用英文逗号分隔（例如 no-translate,comment）。
忽略ID 输入要跳过的元素的 ID，多个用逗号分隔。
自定义术语 每行一个“原文=译文”规则，例如 JavaScript=JS 或 Coca-Cola=可口可乐。
鼠标划词翻译（仅PC） 开启后，选中网页文本会自动显示翻译气泡。
动态内容监听 开启后自动翻译通过 AJAX 加载的新内容（例如无限滚动、单页应用）。
缓存优化 开启后已翻译过的文本会缓存，再次出现时直接使用，减少 API 调用。
清除缓存 清空所有翻译缓存。
重置所有 将所有配置恢复为默认值，并刷新页面。
4.6 移动端特殊操作
· 窗口大小调整：在设置面板底部增加了“窗口大小调整”折叠区，可通过滑块实时调整悬浮窗的宽度和高度。
· 触摸拖拽：直接拖动面板标题栏即可移动位置。
- 翻译引擎详解
5.1 微软 Edge 引擎 （client.edge）
· 原理：使用浏览器内置的翻译功能（与 Edge 浏览器的“翻译此页”相同）。
· 优点：速度极快，无需额外认证，稳定可靠。
· 缺点：不支持显示模式切换、颜色自定义，也不支持双显。
· 适用场景：日常浏览，对样式无特殊要求的用户。
5.2 微软 API 引擎 (microsoft)
· 原理：通过微软认知服务翻译 API 进行实时翻译，需要联网获取 token。
· 优点：
· 支持单显/双显模式；
· 可自定义译文颜色和背景；
· 翻译质量与微软官方一致。
· 缺点：首次加载需获取 token，可能略微延迟； 且频繁翻译可能触发请求限制。
· 适用场景：需要双语对照、或对译文样式有个性化要求的用户。
注意：切换引擎后脚本会自动重置当前页面的翻译，并以新引擎重新翻译。
- 自定义选项详解
6.1 忽略规则（忽略 classes/IDS）
· 用于跳过页面中的某些固定元素（如导航栏、广告、代码块）。
· 示例：
·忽略 Class：advertisement， sidebar， footer
·忽略 ID：comment-section， related-posts
6.2 自定义术语（Custom Terms）
· 格式：每行 原文=译文，支持正则表达式（高级用户）。
· 示例：
机器学习=机器学习
深度学习=深度学习
AI=人工智能
6.3 颜色自定义（仅微软 API）
· 支持十六进制颜色码（如 #ff4757）。
· 背景色自动取相同颜色的半透明版本（opacity 0.1）。
· 双显模式下：原文为灰色，译文为自定义颜色；单显模式下：译文直接替换原文并显示自定义颜色。
注意事项
脚本加载时机：脚本在 document-start 运行，确保尽早注入，不影响页面渲染。
权限要求：需要 GM_setValue、GM_getValue 存储配置； 需要 GM_xmlhttpRequest 连接微软 API 域名； 需要 GM_addStyle 注入样式。
微软 API 引擎的 token 有效期：token 约 10 分钟过期，脚本会自动重新获取，无需用户干预。
双显模式布局：双显模式下译文和原文会以块级方式堆叠（移动端可能影响阅读），可切换回单显。
翻译大段文本：微软 API 单次请求文本长度限制约为 5000 字符，脚本会自动分块翻译。
与其他翻译扩展的冲突：建议暂时关闭其他翻译工具，以免样式或功能冲突。
白名单与全局开关的关系：白名单优先级高于全局开关。若网站已加入白名单，即使全局关闭，页面仍会自动翻译。
- 常见问题
Q1：点击“微软 API”后页面没有翻译？
· A：检查网络连接，确保能访问 edge.microsoft.com 和 api-edge.cognitive.microsofttranslator.com。 部分网络环境可能被屏蔽，可切换至“微软 Edge”引擎。
Q2：双显模式下原文和译文挤在一起怎么办？
· A：可以在高级设置的“自定义样式”中手动添加 CSS（未来版本可能增加此选项）。 目前可通过切换至“单显”模式解决。
Q3：为什么某些动态加载的内容没有被翻译？
· A：确保“动态内容监听”已开启。 如果仍无效，可能是目标元素被 ignoredClasses 或 ignoredIds 过滤了，请检查规则。
Q4：如何暂时禁用当前页面的翻译而不影响其他网站？
· A：点击浏览器扩展图标，在 Tampermonkey 菜单中取消勾选“自动翻译助手”脚本（或使用脚本内置菜单中的“关闭自动翻译”）。 若要保留脚本但仅禁用翻译，可点击“❌ 关闭自动翻译”。
Q5：颜色自定义后双显模式的原文也被染色了？
· A：不会。 双显模式下原文始终是灰色（#888），只有译文应用自定义颜色。 如果出现异常，请检查是否启用了其他覆盖样式的扩展。
Q6：移动端面板无法完全显示？
· A：面板最大尺寸限制为 90vw 和 80vh，且可手动调整大小。 如果内容溢出，请尝试通过“窗口大小调整”滑块增大面板尺寸，或旋转手机屏幕。
Q7：微软 API 引擎提示“获取认证 token 失败”？
· A：可能是网络问题或微软服务暂时不可用。 稍后重试，或切换至 Edge 引擎。
- 更新日志（2.5.3 版本主要改进）
· 新增：微软 API 引擎的“双显模式”，支持原文和译文同时显示，原文无删除线且颜色较暗。
· 新增：译文颜色自定义功能（色板 + 手动输入），背景高亮自动适配。
· 新增：网站专用引擎设置，可为不同网站单独指定翻译引擎。
· 优化：白名单 UI 折叠显示（超过 3 个域名自动收起），提升面板简洁性。
· 优化：切换引擎时自动禁用旧翻译，恢复原文，避免残留样式。
· 修复：微软 API 引擎 token 过期后自动重试的机制。
· 修复：移动端面板尺寸保存和恢复的逻辑。
· 兼容：更好的暗色模式样式支持。
- 版权与许可
· 本脚本使用 Apache License 2.0 开源。
· 基于 i18n-jsautotranslate 开发，感谢原作者。
· 微软翻译服务的使用遵循微软的相关条款，本脚本仅提供技术调用，不对翻译内容负责。
结语：自动翻译助手旨在为全球用户提供无障碍的网页阅读体验。 如有任何建议或问题，欢迎在 GitHub 仓库提交 issue。 祝您使用愉快！ ✨
