智能翻译助手 (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安装脚本
刷新任意网页即可看到悬浮球

基础使用

单击悬浮球

打开控制面板，进行详细设置

拖拽悬浮球

PC端：直接鼠标拖拽
移动端：长按后拖拽

双击悬浮球（需开启）

快速开关翻译功能

⚙️ 配置说明

基础设置

设置项	说明
源语言	当前页面的语言
目标语言	要翻译成的语言
启用翻译	总开关
自动翻译	页面加载时自动翻译

界面设置

设置项	说明
显示悬浮球	显示/隐藏悬浮球
允许超出边缘	允许一半悬浮球超出屏幕
双击开关翻译	快速双击切换开关
悬浮球大小	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

✨更新适配scriptcat

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
问题反馈：GitHub Issues

💡 提示：如果遇到任何问题，欢迎在GitHub反馈或留言。我们会及时回复并解决问题！