智能翻译助手 (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 (越南语)
• ภาษาไทย (泰语)
• हिन्दी (印地语)
• العربية (阿拉伯语)
• 及更多...

🚀 快速开始

安装

1. 确保已安装ScriptCat浏览器扩展
2. 从ScriptCat安装脚本
3. 刷新任意网页即可看到悬浮球

基础使用

单击悬浮球

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

拖拽悬浮球

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

双击悬浮球（需开启）

快速开关翻译功能

⚙️ 配置说明

基础设置

界面设置

高级设置

翻译服务

• 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.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反馈或留言。我们会及时回复并解决问题！