翻译机增强版 - AI翻译支持

huasuiyue
2026-01-05T06:05:26Z

基于原版翻译机的增强版本，新增AI翻译功能（支持LM Studio/OpenAI等），可视化配置界面。支持翻译Twitter/X、YouTube、Facebook、Reddit等主流社交网站。

# 翻译机增强版 - AI翻译支持

## 📖 项目说明

这是基于 [原版翻译机](https://greasyfork.org/zh-CN/scripts/378277) 的增强版本，在保留原有所有翻译引擎的基础上，新增了AI翻译功能和可视化配置界面。

**原作者**: HolynnChen
**增强版本**: huasuiyue

---

## ✨ 新增功能

### 🤖 AI翻译引擎
- ✅ 支持 **LM Studio** 本地AI翻译（完全离线）
- ✅ 支持 **OpenAI** 官方API
- ✅ 理论兼容所有 **OpenAI API格式** 的服务（需自行测试）

### 🎨 可视化配置界面
- ✅ 在控制面板中直接配置AI翻译参数
- ✅ 实时保存配置，无需刷新
- ✅ 选择AI翻译时自动展开配置区域
- ✅ 提供常用配置示例和提示

### 🔒 安全性增强
- ✅ API密钥使用密码框输入，保护隐私
- ✅ 本地服务（LM Studio）无需API密钥
- ✅ 所有翻译不经过中间服务器

---

## 🚀 快速开始

### 安装步骤

1. **安装 Tampermonkey 浏览器扩展**
- [Chrome/Edge](https://chrome.google.com/webstore/detail/tampermonkey/)
- [Firefox](https://addons.mozilla.org/firefox/addon/tampermonkey/)

2. **安装脚本**
- 点击 [这里安装](#) 或手动复制脚本内容到Tampermonkey

3. **配置AI翻译（可选）**
- 访问任意支持的网站
- 点击右上角"译"按钮打开控制面板
- 选择"AI翻译"
- 在展开的配置区域填写API信息

---

## 🔧 AI翻译配置指南

### 方案一：使用 LM Studio（推荐新手）

LM Studio 是免费的本地AI工具，支持多种开源大模型，完全离线运行。

1. **下载并安装 LM Studio**
- 官网: https://lmstudio.ai/
- 支持 Windows / macOS / Linux

2. **加载模型**
- 根据你的需求选择合适的模型
- 本项目作者测试使用：hy-mt1.5-7b

3. **启动本地服务器**
- 点击 LM Studio 左侧的"服务器"标签
- 点击"启动服务器"
- 默认地址：`http://localhost:1234`（端口可自定义）

4. **在脚本中配置**
```
API地址: `http://localhost:1234`（端口可自定义）
API密钥: (留空)
模型名称: hy-mt1.5-7b(其他模型自行测试)
```

**测试配置是否正常**（可选）：
```bash
curl http://localhost:12353/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "hy-mt1.5-7b",
"messages": [{"role": "user", "content": "Hello"}],
"temperature": 0.7
}'
```

### 方案二：使用 OpenAI API

1. **获取API密钥**
- 访问 https://platform.openai.com/api-keys
- 创建新的API密钥

2. **在脚本中配置**
```
API地址: https://api.openai.com/v1/chat/completions
API密钥: sk-xxxxxxxxxxxxxx
模型名称: gpt-3.5-turbo (或 gpt-4)
```

### 方案三：使用其他兼容OpenAI格式的API

理论上支持所有OpenAI API格式的服务（如Azure OpenAI、通义千问、智谱GLM等），但未经测试，请自行配置并测试。

---

## 🌐 支持的网站

| 网站 | 支持内容 | 备注 |
|------|---------|------|
| Twitter/X | 推文、背景信息 | ✅ 完整支持 |
| YouTube | 评论、视频简介、CC字幕、社区 | ✅ 完整支持 |
| Facebook | 帖子、评论 | ✅ 完整支持 |
| Reddit | 标题、内容、评论 | ✅ 完整支持 |
| Discord | 聊天内容 | ✅ 完整支持 |
| Telegram | 聊天内容 | ✅ 完整支持 |
| Instagram | 评论 | ✅ 完整支持 |
| TikTok | 评论 | ✅ 完整支持 |
| GitHub | Issues、Discussions | ✅ 完整支持 |
| Bluesky | 帖子、回复 | ✅ 完整支持 |
| Threads | 帖子 | ✅ 完整支持 |
| Quora | 标题、内容 | ✅ 完整支持 |
| 5ch | 标题、内容 | ✅ 完整支持 |

---

## 🎯 支持的翻译引擎

### 传统翻译引擎（原版功能）
- 谷歌翻译
- 谷歌翻译mobile
- 百度翻译
- 腾讯翻译
- 腾讯AI翻译
- 有道翻译mobile
- 必应翻译
- 彩云小译
- Papago翻译
- 阿里翻译
- 爱词霸翻译
- Deepl翻译

### AI翻译引擎（新增）
- **AI翻译** - 支持LM Studio、OpenAI及所有兼容API

---

## ⚙️ 功能特性

### 基础功能
- ✅ 自动翻译页面内容为简体中文
- ✅ 支持替换式翻译或追加式翻译
- ✅ 自动过滤URL链接
- ✅ 智能跳过中文内容（简体/繁体）
- ✅ 翻译结果缓存，减少重复请求
- ✅ 支持压缩缓存，节省空间

### 界面控制
- ✅ 可拖动的悬浮球控制面板
- ✅ 全屏时自动隐藏悬浮球
- ✅ 显示/隐藏翻译源标识
- ✅ 针对不同内容类型的独立开关

### AI翻译特性
- ✅ 本地AI支持，完全离线翻译
- ✅ 云端AI支持，翻译质量更高
- ✅ 可视化配置界面，无需代码知识
- ✅ 自动检测本地/云端服务

---

## 📝 使用说明

### 基本操作

1. **打开控制面板**
- 点击页面右上角的"译"按钮

2. **选择翻译引擎**
- 在下拉菜单中选择想要使用的翻译引擎
- 选择"AI翻译"会自动展开配置区域

3. **启用/禁用规则**
- 展开"启用规则"查看当前网站的翻译规则
- 取消勾选可以禁用特定内容的翻译

4. **配置选项**
- 不翻译中文（简体/繁体）
- 自动过滤URL
- 显示翻译源
- 全屏时不显示悬浮球
- 替换式翻译
- 压缩缓存

### 右键菜单功能

- **重置控制面板位置** - 将悬浮球恢复到默认位置
- **全局隐藏/展示悬浮球** - 全局控制悬浮球显示
- **配置AI翻译API** - 快速配置AI翻译（也可在控制面板配置）

---

## 🆚 增强版 vs 原版

| 功能 | 原版 | 增强版 |
|-----|------|--------|
| 传统翻译引擎 | ✅ 13个 | ✅ 13个 |
| AI翻译支持 | ❌ | ✅ 支持 |
| 本地AI翻译 | ❌ | ✅ LM Studio |
| 云端AI翻译 | ❌ | ✅ OpenAI等 |
| 可视化配置 | ❌ | ✅ 支持 |
| API密钥管理 | ❌ | ✅ 密码框保护 |
| 配置提示 | ❌ | ✅ 详细提示 |
| 实时保存 | 部分 | ✅ 完整支持 |

---

## 🐛 常见问正确（如：12353）
3. 确认模型已加载（如：hy-mt1.5-7b）
4. API地址格式：`http://localhost:端口/v1/chat/completions`
5. 可使用curl命令测试连接是否正常
A:
- 如果使用LM Studio，确保已启动本地服务器
- 如果使用云端API，检查API密钥是否正确填写
- 本地服务（包含localhost或127.0.0.1）不需要API密钥

### Q: LM Studio连接失败？
A:
1. 确认LM Studio服务器已启动
2. 检查端口是否为1234（默认）
3. 确认模型已加载
4. API地址应为：`http://localhost:1234/v1/chat/completions`

### Q: 翻译速度慢？
A:
- LM Studio: 取决于你的电脑配置和模型大小
- 云端API: 取决于网络状况和API服务商
- 建议启用"压缩缓存"减少重复翻译

### Q: 某些内容没有翻译？
A:
1. 检查"启用规则"中对应内容类型是否开启
2. 检查是否启用了"不翻译中文"
3. 某些动态加载内容可能需要等待

### Q: 如何切换回传统翻译引擎？
A: 在控制面板的下拉菜单中选择其他翻译引擎即可

---

## 💡 技巧与建议

### 翻译质量优化

1. **使用专业模型** - 选择在多语言翻译上表现好的模型
2. **调整温度参数** - 脚本默认0.3，适合翻译场景
3. **启用缓存** - 避免重复翻译相同内容
4. **本地+云端结合** - 日常用LM Studio，重要内容用GPT-4

### 性能优化建议

- 启用"压缩缓存"节省存储空间
- 启用"自动过滤URL"减少无效翻译
- 针对不常用的网站禁用对应规则
- AI翻译响应较慢时可切换传统引擎

---

## 🔄 更新日志

### v1.0.0 (2026-01-05)
- ✨ 新增AI翻译引擎支持
- ✨ 新增LM Studio本地AI集成
- ✨ 新增OpenAI API支持
- ✨ 新增可视化配置界面
- ✨ 新增API密钥密码框保护
- ✨ 新增配置实时保存功能
- ✨ 新增右键菜单快速配置
- 🔧 优化控制面板布局
- 🔧 添加配置提示和示例
- 📝 完善使用文档

---

## 📜 开源协议

本项目基于 MIT 协议开源

**原版作者**: HolynnChen
**增强版本**: huasuiyue

---

## 🙏 致谢

- 感谢 [HolynnChen](https://greasyfork.org/zh-CN/users/192073) 开发的原版翻译机
- 感谢 LM Studio 团队提供优秀的本地AI工具
- 感谢所有开源AI模型的贡献者

---

**享受无障碍的多语言浏览体验！** 🌍✨