智能翻译助手 (Intelligent Translation Assistant) 文档
📖 简介
智能翻译助手是一个功能强大的网页翻译工具，支持多种语言互译，采用AI翻译引擎，提供精美的界面和丰富的自定义选项。无论是PC端还是移动端，都能获得流畅的翻译体验。
✨ 核心功能
🌐 翻译功能
- 全网页翻译：一键翻译整个页面内容
- 动态内容监听：自动翻译Ajax加载的内容
- 鼠标划词翻译（PC端）：选中文字自动显示翻译
- 属性翻译：支持title、alt、placeholder等属性的翻译
- 缓存优化：内置多层缓存机制，二次访问毫秒级响应
🎨 界面特性
- 悬浮球设计：可拖拽的翻译控制中心
- 控制面板：完整的设置界面
- 深色模式：自动适配系统深色主题
- 移动端优化：支持触摸操作，长按拖拽
- 多种动画效果：流畅的交互动画
⚙️ 高级设置
- 翻译服务：支持Microsoft Edge、gitee AI、SiliconFlow AI等
- 自定义接口：可配置多个翻译API地址
- 忽略规则：按Class/ID排除不需要翻译的元素
- 自定义术语：设置特定词汇的翻译规则
- 性能优化：动态监听、缓存开关
📱 支持的语言
支持100+种语言，包括但不限于：
- 简体中文、繁體中文
- English (英语)
- Español (西班牙语)
- Français (法语)
- Русский (俄语)
- 日本語 (日语)
- 한국어 (韩语)
- Deutsch (德语)
- Italiano (意大利语)
- Tiếng Việt (越南语)
- ภาษาไทย (泰语)
- हिन्दी (印地语)
- العربية (阿拉伯语)
- 及更多...
🚀 快速开始
安装
- 确保已安装ScriptCat浏览器扩展
- 从ScriptCat安装脚本
- 刷新任意网页即可看到悬浮球
基础使用
单击悬浮球
打开控制面板，进行详细设置
拖拽悬浮球
双击悬浮球（需开启）
快速开关翻译功能
⚙️ 配置说明
基础设置
| 设置项 |
说明 |
| 源语言 |
当前页面的语言 |
| 目标语言 |
要翻译成的语言 |
| 启用翻译 |
总开关 |
| 自动翻译 |
页面加载时自动翻译 |
界面设置
| 设置项 |
说明 |
| 显示悬浮球 |
显示/隐藏悬浮球 |
| 允许超出边缘 |
允许一半悬浮球超出屏幕 |
| 双击开关翻译 |
快速双击切换开关 |
| 悬浮球大小 |
30-80px可调 |
| 悬浮球透明度 |
30-100%可调 |
| 面板大小 |
50-120%可调 |
| 面板透明度 |
50-100%可调 |
高级设置
翻译服务
- Microsoft Edge：默认服务，稳定可靠
- gitee AI：国内服务，速度快
- SiliconFlow AI：AI翻译引擎
- 自定义服务：可配置多个API地址
忽略规则
- 忽略的Class：按类名排除元素
- 忽略的ID：按ID排除元素
- 支持多值：用英文逗号分隔
自定义术语
格式示例：
网市场云建站系统=wangmarket CMS
国际化=GuoJiHua
性能优化
- 动态内容监听：监控DOM变化自动翻译
- 缓存优化：缓存翻译结果
- 清除缓存：手动清理
🎯 使用技巧
PC端高级功能
- 鼠标划词翻译：选中文字自动弹出翻译
- 快捷键支持：通过菜单命令快速打开设置
- 精准控制：使用忽略规则排除特定区域
移动端优化
- 触摸友好：长按拖拽，轻点打开
- 震动反馈：拖拽时有轻微震动
- 自适应界面：根据屏幕尺寸调整布局
- 手势支持：支持滑动手势
隐私保护
- 所有设置保存在本地
- 翻译请求直接发送到API服务
- 不收集任何用户数据
- 支持自定义私有翻译服务
🔧 开发调试
全局对象
可通过 window.translateHelper 访问API：
// 配置管理器
window.translateHelper.config
// 翻译管理器
window.translateHelper.translate
// UI管理器
window.translateHelper.ui
手动控制
// 切换语言
translate.changeLanguage('chinese_simplified')
// 启动监听
translate.listener.start()
// 手动执行翻译
translate.execute()
📋 更新日志
v1.3.4
- 修复 URL 语言控制：首次使用可能需要把URL参数从默认的language改成其他参数，如lang
- URL 设置说明已增加简中示例及官方语种列表
- 新增黑/白名单，支持逗号、换行、注释及 exact:、fuzzy:、regex:，默认为空黑名单，可用于设置不翻译的网站或页面
- 所有整页、URL、划词、快捷键和动态翻译入口统一应用网站黑白名单门禁
- 新增全部配置 JSON 导入/导出，包含字段过滤、版本保护、文件类型/大小校验及数值范围校验
- 新增 PC 端专用快捷键，默认启用 Shift+T；输入框内不触发，按一次翻译、再次恢复
v1.3.3
- 修复了 CSP 策略阻止跨域请求等问题：
增加 GM_xmlhttpRequest 的权限。
新增异步跨域翻译请求改走油猴特权通道，绕过 网站 CSP。
整页翻译、划词翻译、GiteeAI、Edge 和自定义服务均可使用该通道。
经测试，目前可在GitHub等 CSP 策略网站上使用该翻译脚本。
v1.3.2
- 将版本号固化到全局配置内，便于后续维护版本更新
- 移除了存在问题的自动识别网页源语言功能
- 修复了官方划词翻译 setDefaultTo() 接口目标语言设置异常问题
划词翻译主要改动：
每次划词请求显式携带设置框中的目标语言，不再依赖或修改整页翻译的translate.to。
启用划词时先完成翻译管理器及源语言初始化。
请求缺少目标语言或接口地址时直接阻止，并显示明确失败提示。
移动端增加 touchend 触发、120ms 选区稳定等待和选区坐标回退。
700ms 内相同选区去重，避免触摸事件和模拟鼠标事件重复调用。
启动整页翻译、关闭划词或修改目标语言时，使未返回的旧划词请求失效。
继续保留官方 setDefaultTo()、selectionTranslate.start() 和唯一的划词目标语言选择框。
v1.3.1
主要改动：
- 划词翻译只保留一个“翻译为”语言框。
- 严格使用官方 setDefaultTo() 与 selectionTranslate.start()。
- 删除划词源语言、语言守卫及内部defaultTo 强制写入。
- 整页翻译时暂停划词；还原原文后自动恢复。
- 关闭划词后立即阻止请求，不依赖不存在的 stop()。
- PC 和移动端均显示入口，并标注实验性、可能无效。
- 自动迁移旧版 selectionTargetLanguage 配置。
- 语言选项由 129 个增加到 137 个，无重复、未删减，实际可用范围仍取决于翻译通道。
- Ajax 后台监听也增加整页生命周期门禁，避免还原后重新触发整页翻译。
v1.3.0
- 划词翻译改进: 划词翻译独立于"启用翻译"总开关运行——只要 PC 端开启了划词翻译，选中文字即自动按当前源语言→目标语言翻译。
- 升级 translate.js 到 4.0.0
- 新增大量自定义功能: 图片翻译、忽略 text/tag、iframe 翻译、整体翻译(whole)、强制翻译本地语种、附加请求参数/headers、自定义标签属性翻译、URL 参数控制、隐藏原文优化、SSE、翻译遮罩层、只翻译指定语种、忽略文字正则等。
v1.2.6
v1.2.2
- ✨ 新增双击悬浮球开关翻译功能
- ✨ 新增鼠标划词翻译（PC端）
- 💄 优化移动端触摸体验
- 🐛 修复若干Bug
v1.2.0
- ✨ 新增自定义术语功能
- ✨ 新增翻译服务选择
- 💄 优化面板UI
- 🚀 提升翻译速度
v1.1.0
- ✨ 新增深色模式支持
- ✨ 新增属性翻译支持
- 📱 优化移动端适配
v1.0.0
- 🎉 首次发布
- ✨ 基础翻译功能
- ✨ 悬浮球拖拽
- ✨ 控制面板
❓ 常见问题
Q: 为什么有些内容没有翻译？
A: 可能原因：
- 元素被忽略规则排除
- 动态加载的内容尚未监听
- 翻译服务暂时不可用
Q: 如何排除特定区域不翻译？
A: 在设置中添加忽略的Class或ID：
- 找到不想翻译的元素
- 复制其class或id
- 添加到忽略列表中
Q: 移动端如何调整悬浮球位置？
A: 长按悬浮球约0.3秒，感觉到震动后即可拖拽。
Q: 翻译速度慢怎么办？
A: 可尝试：
- 开启缓存优化
- 切换到gitee AI等国内服务
- 检查网络连接
Q: 如何恢复默认设置？
A: 在控制面板底部点击"重置所有设置"。
🔗 相关链接
💡 提示：如果遇到任何问题，欢迎在GitHub反馈或留言。我们会及时回复并解决问题！
