Yandex/微软自动翻译脚本详细说明

一、脚本概述

这是一个功能强大的网页翻译脚本，支持使用Yandex翻译和微软翻译引擎自动翻译网页内容。脚本具有智能引擎检测、网站专用引擎设置、颜色自定义、双语显示等多项高级功能，并提供直观的用户界面和快捷键操作。

二、主要功能

1. 双引擎支持

· 微软翻译：高质量的AI翻译，支持批量翻译
· Yandex翻译：特别适合俄语网站，支持自动激活

1. 智能引擎检测

· 自动检测俄语网站和内容
· 根据网站语言智能推荐最佳翻译引擎
· 支持为特定网站设置专用引擎

1. 个性化设置

· 目标语言：支持14种语言，包括简体中文、英语、俄语、日语等
· 显示模式：替换原文模式、双语显示模式
· 颜色自定义：8种预设颜色+自定义颜色，可调整翻译文字颜色
· 翻译提示：可控制是否显示翻译状态提示

1. 白名单管理

· 可为特定网站开启/关闭自动翻译
· 简洁的白名单菜单命令（不显示网址）
· 支持批量管理白名单网站

1. 用户友好界面

· 油猴菜单命令：4个主要命令，快捷键操作
· 设置窗口：直观的设置界面，分类清晰
· 状态提示：翻译状态实时提示
· 防护机制：防止脚本自身被翻译

三、菜单命令详解

菜单命令顺序（从上到下）：

1. 🔵 切换到Yandex翻译 / 🔴 切换到微软翻译
   · 快捷键：Ctrl+Shift+E
   · 功能：在当前使用的引擎之间切换
2. ❌ 关闭自动翻译 / ✅ 开启自动翻译
   · 快捷键：Ctrl+Shift+Y
   · 显示信息：当前引擎、俄语状态、专用引擎状态
   · 功能：启用或禁用当前网站的自动翻译
3. ☆ 添加到白名单 / ⭐ 从白名单中移除
   · 快捷键：Ctrl+Shift+A
   · 特点：简洁显示，不包含网址
   · 功能：将当前网站加入或移出白名单
4. ⚙️ 翻译设置
   · 快捷键：Ctrl+Shift+S
   · 功能：打开完整的设置窗口

其他快捷键：

· Ctrl+Shift+T：立即翻译（仅微软翻译可用）

四、设置窗口详解

设置窗口分为以下几个部分：

1. 当前状态显示

· 显示当前使用的翻译引擎
· 显示是否使用网站专用引擎
· 显示是否检测到俄语内容
· 显示默认引擎设置

1. 翻译状态提示开关

· 控制是否显示"正在翻译页面..."等提示
· 开启后会在翻译时显示状态提示框

1. 网站专用引擎设置

· 可为当前网站设置专用翻译引擎
· 专用引擎会覆盖默认引擎设置
· 支持微软和Yandex两种引擎
· 可清除当前网站的专用引擎设置

1. 目标语言选择

· 14种语言可选，每种语言都有国旗图标
· 点击即可切换目标语言
· 切换语言后会立即重新翻译

1. 翻译文字颜色设置

· 8种预设颜色方案
· 支持自定义颜色（十六进制格式）
· 实时预览颜色效果
· 颜色立即应用到现有翻译

1. 显示模式选择

· 替换原文模式：直接替换原文，点击可恢复
· 双语显示模式：同时显示原文和译文

1. 白名单管理

· 显示当前网站的白名单状态
· 列出所有已添加到白名单的网站
· 支持从白名单中删除单个网站
· 支持一键清除所有白名单

五、使用指南

首次使用：

1. 安装脚本后，首次访问网页时会自动启动翻译
2. 右上角会显示欢迎提示和快捷键信息
3. 默认使用微软翻译引擎，目标语言为简体中文

快速操作：

1. 切换引擎：按 Ctrl+Shift+E 或在油猴菜单中点击第一项
2. 开启/关闭翻译：按 Ctrl+Shift+Y 或在油猴菜单中点击第二项
3. 管理白名单：按 Ctrl+Shift+A 或在油猴菜单中点击第三项
4. 打开设置：按 Ctrl+Shift+S 或在油猴菜单中点击第四项

俄语网站优化：

· 访问俄语网站时，脚本会自动检测并推荐使用Yandex翻译
· 可以在设置中为俄语网站设置专用引擎
· Yandex翻译会自动保持激活状态

颜色自定义：

1. 打开设置窗口
2. 在"翻译文字颜色"部分选择喜欢的颜色
3. 颜色会立即应用到页面上的所有翻译文字
4. 可随时更改颜色，无需重新翻译

六、技术特点

1. 翻译保护机制

· 防止脚本自身的UI元素被翻译
· 保护"Yandex"等关键词不被翻译
· 确保设置界面和菜单命令正常显示

1. 智能文本收集

· 不翻译纯数字和数字+单位（如22M, 100GB）
· 不翻译百分比和纯符号
· 只收集有意义的文本内容
· 优化俄语网站的文本提取

1. 性能优化

· 批量翻译，减少API请求
· 翻译缓存，避免重复翻译
· DOM变化监听，自动更新翻译
· 滚动检测，智能检查新内容

1. 错误处理

· 网络错误自动重试
· 翻译失败时显示状态提示
· 引擎不可用时智能切换

七、兼容性

支持的浏览器：

· 所有支持Tampermonkey/Greasemonkey的浏览器
· Chrome、Firefox、Edge、Safari等

支持的语言：

· 源语言：自动检测（特别优化俄语）
· 目标语言：14种主要语言

支持的网站：

· 绝大多数网页（通过通配符匹配）
· 特别优化俄语网站和论坛

八、注意事项

1. 微软翻译需要网络连接：微软翻译API需要访问外部服务器
2. Yandex翻译可能需要等待：Yandex翻译器加载需要时间
3. 翻译质量：翻译质量取决于引擎，复杂内容可能有偏差
4. 网站兼容性：极少数网站可能因结构特殊导致翻译不完整
5. 性能影响：大量文本的网页翻译可能需要一些时间

九、更新日志

版本 2.24.1

· 优化菜单命令显示顺序
· 简化白名单命令文本（移除网址显示）
· 修复翻译状态提示显示逻辑
· 增强脚本自身防护机制

版本 2.24.0

· 新增翻译状态提示开关
· 优化颜色自定义功能
· 改进俄语网站检测算法
· 增强Yandex翻译稳定性

十、故障排除

常见问题：

1. 翻译不工作
   · 检查网络连接
   · 确认脚本已启用
   · 尝试切换翻译引擎
2. 菜单命令不显示
   · 刷新页面
   · 检查油猴脚本管理器状态
   · 确认脚本已正确安装
3. 颜色设置不生效
   · 清除浏览器缓存
   · 重新应用颜色设置
   · 检查页面是否有其他样式冲突
4. Yandex翻译不激活
   · 等待几秒钟让Yandex加载
   · 切换到微软翻译再切回
   · 检查页面是否允许外部脚本

联系支持：

如遇到无法解决的问题，请提供以下信息：

1. 浏览器版本
2. 脚本管理器版本
3. 出现问题的网址
4. 问题详细描述

十一、隐私说明

· 本脚本仅将文本内容发送给翻译API
· 不收集用户个人信息
· 不记录用户浏览历史
· 所有设置保存在本地

提示：使用过程中如有任何建议或发现bug，欢迎反馈，我们将持续改进脚本功能。