> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 沉浸式翻译

> 浏览器双语对照阅读扩展集成指南

# 沉浸式翻译

沉浸式翻译是一款优秀的浏览器翻译扩展，支持网页双语对照阅读。通过集成 API易，您可以使用强大的 AI 模型获得更准确、更自然的翻译效果。

## 快速安装

### 支持的浏览器

* Chrome / Edge / Brave
* Firefox
* Safari

### 安装步骤

1. 访问对应浏览器的扩展商店
2. 搜索"沉浸式翻译"或"Immersive Translate"
3. 点击安装并添加到浏览器

或访问 [官网](https://immersive-translate.owenyoung.com/) 获取安装链接。

## 配置 API易

### 1. 打开设置

点击浏览器工具栏的扩展图标，选择"设置"。

### 2. 配置翻译服务

1. 在左侧菜单选择"翻译服务"
2. 找到"OpenAI"服务
3. 点击"管理"或"设置"
4. 选择"自定义 API Key"

### 3. 填写配置

* **APIKEY**：输入您的 API易 密钥
* **自定义 API 接口地址**：`https://api.apiyi.com/v1/chat/completions`
* **自定义模型**：`gpt-3.5-turbo`（可选）

## 核心功能

### 网页翻译

#### 自动翻译

1. 访问外文网页
2. 扩展自动检测语言
3. 点击翻译按钮开始

#### 手动翻译

1. 点击工具栏扩展图标
2. 选择"翻译本页"
3. 等待翻译完成

### 翻译模式

#### 双语对照（推荐）

* 保留原文格式
* 译文显示在原文下方
* 便于对照学习

#### 仅译文

* 完全替换原文
* 适合快速阅读
* 可随时切换回双语

### 划词翻译

1. 选中需要翻译的文本
2. 点击出现的翻译按钮
3. 在弹窗中查看翻译结果

## 高级设置

### 自定义提示词

针对不同内容类型的提示词：

#### 技术文档

```text theme={null}
作为技术文档翻译专家，请：
1. 保留所有技术术语的原文
2. 在括号中提供中文解释  
3. 保持代码和命令的原始格式
```

#### 学术论文

```text theme={null}
作为学术翻译专家，请：
1. 使用学术规范的表达方式
2. 保留引用格式
3. 准确翻译专业术语
```

#### 文学作品

```text theme={null}
作为文学翻译专家，请：
1. 保持原文的文学美感
2. 注意文化背景的转换
3. 保留修辞手法的效果
```

### 翻译规则

设置特定网站的翻译行为：

1. 进入"翻译规则"设置
2. 添加网站域名
3. 选择行为：
   * 总是翻译
   * 从不翻译
   * 智能判断

### 样式定制

自定义译文显示样式：

```css theme={null}
/* 译文字体 */
.immersive-translate-target {
    font-family: "Microsoft YaHei", sans-serif;
    font-size: 14px;
    color: #333;
}

/* 译文背景 */
.immersive-translate-target-wrapper {
    background-color: #f5f5f5;
    padding: 5px;
    margin: 5px 0;
    border-radius: 3px;
}
```

## 特色功能

### PDF 翻译

支持在线 PDF 文档翻译：

* 保持 PDF 格式
* 支持双语对照
* 可复制译文

### 视频字幕翻译

支持主流视频网站：

* YouTube
* Netflix
* Bilibili

配置方法：

1. 开启"视频字幕翻译"
2. 选择字幕显示方式
3. 调整字幕样式

### 电子书翻译

支持 EPUB 电子书：

1. 上传 EPUB 文件
2. 选择翻译设置
3. 下载双语版本

### 输入框翻译

在网页输入框中实时翻译：

1. 在输入框输入文本
2. 按快捷键触发翻译
3. 查看翻译建议

## 快捷键

常用快捷键（可自定义）：

| 功能      | 默认快捷键     |
| ------- | --------- |
| 翻译/显示原文 | `Alt + T` |
| 切换翻译模式  | `Alt + M` |
| 翻译选中文本  | `Alt + S` |
| 打开设置    | `Alt + O` |

## 模型选择建议

### 按内容类型选择

<Card title="查看翻译场景模型推荐" icon="star" href="/api-capabilities/model-info">
  查看最新的模型推荐，了解适合不同翻译场景和内容类型的最佳模型选择，包括技术文档、学术论文、文学作品等。
</Card>

<Info>
  **为什么不在此列出具体模型？**

  AI 模型更新迭代速度非常快，为了确保您获取最准确的模型推荐信息，我们统一在 [模型推荐页面](/api-capabilities/model-info) 维护最新的模型列表、性能数据和使用建议。
</Info>

### 性能与质量平衡

根据文本长度和内容类型，可以在沉浸式翻译的设置中灵活选择合适的模型，以达到翻译质量和成本的最佳平衡。

## 性能优化

### 缓存设置

* 开启翻译缓存
* 设置缓存时长：24小时
* 定期清理缓存

### 批量翻译

* 调整批量大小：5-10 段落
* 设置合理并发数：2-3
* 优化长文本处理

### 触发条件

* 最小翻译长度：10 个字符
* 忽略特定元素：导航菜单、广告
* 延迟翻译：200ms

## 常见问题

### 翻译失败

**可能原因：**

* API 密钥无效
* 网络连接问题
* 页面结构特殊

**解决方案：**

1. 验证 API 密钥
2. 检查网络连接
3. 尝试刷新页面
4. 查看浏览器控制台错误

### 翻译速度慢

**优化方法：**

1. 使用更快的模型
2. 减少单次翻译文本量
3. 开启缓存功能
4. 检查网络延迟

### 格式错乱

**处理方式：**

1. 尝试不同翻译模式
2. 调整译文显示设置
3. 针对特定网站自定义规则
4. 反馈问题给开发者

## 最佳实践

### 1. 阅读体验优化

* 选择合适的字体和大小
* 调整译文颜色对比度
* 设置舒适的行间距
* 使用护眼模式

### 2. 学习辅助

* 开启双语对照模式
* 使用划词翻译查询生词
* 导出翻译内容复习
* 添加笔记和标注

### 3. 工作效率

* 设置常访问网站规则
* 自定义专业领域提示词
* 使用快捷键提高速度
* 批量处理文档

### 4. 成本控制

* 合理选择翻译模型
* 设置翻译长度限制
* 利用缓存减少重复翻译
* 监控 API 使用量

## 高级技巧

### 自定义翻译脚本

使用 JavaScript 增强功能：

```javascript theme={null}
// 自动检测并翻译特定内容
if (document.querySelector('.article-content')) {
    window.immersiveTranslate.translate({
        selector: '.article-content',
        fromLang: 'auto',
        toLang: 'zh-CN'
    });
}
```

### 集成其他工具

与其他工具配合使用：

* **Readwise**：保存翻译的精彩内容
* **Notion**：导出翻译笔记
* **Anki**：制作单词卡片

### 开发者模式

参与翻译改进：

1. 开启调试模式
2. 提供翻译反馈
3. 贡献翻译语料
4. 参与开源开发

## 故障排除指南

### 扩展无法加载

1. 检查浏览器版本兼容性
2. 禁用其他冲突扩展
3. 清除浏览器缓存
4. 重新安装扩展

### 翻译结果不显示

1. 检查网页是否支持翻译
2. 确认翻译服务配置正确
3. 查看是否被广告拦截器阻止
4. 尝试其他翻译服务

### 内存占用过高

1. 定期清理翻译缓存
2. 减少同时翻译的页面数
3. 调整批量翻译设置
4. 关闭不必要的标签页

需要更多帮助？请查看 [详细集成文档](/scenarios/translation/immersive)。