> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/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://api2.laozhang.ai/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` |

## 模型选择建议

### 按内容类型选择

| 内容类型 | 推荐模型            | 原因     |
| ---- | --------------- | ------ |
| 新闻文章 | gpt-3.5-turbo   | 快速、准确  |
| 技术文档 | gpt-4           | 术语翻译准确 |
| 学术论文 | claude-3-opus   | 理解力强   |
| 文学作品 | claude-3-sonnet | 文采好    |
| 日常网页 | gpt-3.5-turbo   | 成本较低   |

### 性能与质量平衡

```javascript theme={null}
// 智能模型选择示例
const selectModel = (textLength, contentType) => {
  if (textLength < 500) {
    return 'gpt-3.5-turbo'; // 短文本用快速模型
  } else if (contentType === 'technical') {
    return 'gpt-4'; // 技术内容用准确模型
  } else if (contentType === 'creative') {
    return 'claude-3-sonnet'; // 创意内容用文艺模型
  } else {
    return 'gpt-3.5-turbo'; // 默认用经济模型
  }
};
```

## 性能优化

### 缓存设置

* 开启翻译缓存
* 设置缓存时长：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)。