# 使用教程

> 交流反馈：QQ 频道 [MT阅读器](https://pd.qq.com/s/8yqstquyx?b=9)、QQ 群 **1080302768**、[Discord](https://discord.gg/qxfC2kqfr)

---

## 翻译主流程

### 1. 导入漫画

<img src="./mangaku-screenshot.jpg" alt="漫画库页面" width="45%" />

在漫画库页面操作：

- 点击右下角 **＋** 创建文件夹，进入后添加漫画图片
- 点击 **「从漫画文件夹导入」** 直接导入整个文件夹
  - 若目录下有多章子文件夹，会自动创建合集并导入为子章节
  - 若目录直接包含图片，按单本漫画导入
- 点击 **「从 CBZ/ZIP/PDF 导入」** 可直接导入压缩包
- **图片文件名需与阅读顺序一致**（如 `1.jpg`, `2.jpg`），否则页码会乱

### 2. 配置 API

<img src="./setting-screenshot.jpg" alt="设置页面" width="45%" />

软件需自备 API。如果还没有，先看：[API 获取指南](./API获取指南.md)。

在设置页填写：

1. **API 地址** —— OpenAI 兼容接口通常填到 `/v1` 或服务商给出的上级地址即可；软件会自动补全 `/chat/completions`，点击「获取模型列表」时会自动补全 `/models`
2. **API Key** —— 妥善保管，勿泄露
3. **模型名称** —— 须与供应商提供的完全一致，可直接从官网复制或点击「获取模型列表」选择

填写完成即返回漫画库。

### 3. 翻译

<img src="./translator-screenshot.jpg" alt="翻译页面" width="45%" />

1. 在文件夹内点击 **「翻译文件夹」**
2. 等待翻译完成，或预处理结束后点击 **「开始阅读」** 边翻边看

> 条漫请在文件夹的「阅读设置」中将阅读方式切换为「条漫滚动」。
> 全文速译下页数较多（>50）时，建议分批上传或关闭全文速译并调高 API 超时。

### 4. 阅读与调整

- **拖动气泡** 可调整位置，软件会自动保存
- **双击图片** 进入/退出放大模式
- **切换页面**：在漫画库文件夹中点击对应图片文件名即可跳转
- **单页重译**：回到漫画库 → 长按该图片 → 点击「重译」
- **大量重译**：关闭「全文速译」后全部重译，或删除漫画换更强模型
- **补缺文字区域**：右上角编辑按钮 → 加号新建空白气泡 → 拖到文字区域 → 绿勾退出
- **全文速译太慢**：关闭「全文速译」即可改用逐页并发翻译
- **气泡太挡画面**：在设置中调整游离气泡透明度
- **翻译文风不佳**：在设置的翻译文风设定中自定义，可让 AI 忽略奇怪符号

---

## 悬浮窗翻译

在漫画库页点击 **「悬浮窗翻译」**，按提示授予悬浮窗和屏幕捕获权限，并在启动时选择本次使用的翻译语言。右侧出现悬浮球后：

| 操作 | 效果 |
|------|------|
| 单击悬浮球 | 识别并翻译当前屏幕文本 |
| 双击悬浮球 | 清除所有气泡 |
| 长按悬浮球 | 弹出菜单 |

长按菜单选项：

- **编辑模式**：悬浮层拦截触摸，可拖移气泡、长按删除、点击「新增气泡」后框选区域手动补框。确认后自动补翻新增气泡。
- **划屏翻译**：不自动检测，直接进入编辑模式由用户框选。
- **退出**：关闭悬浮窗。

编辑结果仅限当前会话，再次单击识别或退出后重置。无识别结果时先检查屏幕捕获授权和 API 配置。

---

## 其它设置

### OCR 设置

在设置页点击「OCR 设置」：

- **开启本地 OCR**：离线模式，使用内置引擎
- **关闭本地 OCR**：在线 API OCR，需填写 API 地址/Key/模型
- API OCR 做多语言翻译时不受日/英文选项限制，只需模型支持该语言
- OCR 超时可调高「OCR API 超时（秒）」范围 30–1200

#### 百度 API OCR

软件支持百度 OCR，在百度开发平台的产品名称为 **「通用文字识别（标准含位置版）」**。接入时 API 格式选择「百度 AI」，并将百度开发平台获取的 API Key 和 Secret Key 填入对应字段。

百度 OCR 支持的语言代码：

| 代码 | 语言 |
|------|------|
| CHN_ENG | 中英文混合 |
| ENG | 英文 |
| JAP | 日语 |
| KOR | 韩语 |
| FRE | 法语 |
| SPA | 西班牙语 |
| POR | 葡萄牙语 |
| GER | 德语 |
| ITA | 意大利语 |
| RUS | 俄语 |

### 多供应商调度

启用后可让多个供应商按权重分担翻译请求。并发数控制的是总并发上限，系统在限额内分配。

### 自定义请求参数

参数默认作用于主供应商，也可单独指定给附加供应商。同一供应商内参数键不可重复。

### 悬浮窗翻译设置

独立配置悬浮窗专用 API 地址/Key/模型，留空时回退主设置。

- **VL 直翻**：将气泡截图直接交给视觉模型翻译，需多模态模型。可设置 VL 翻译线程数。
- **校对模式**：每次识别后自动进入编辑模式。
- **自动清除气泡**：翻页时自动关闭气泡。

---

## 小技巧

- **导出漫画**：文件夹内支持导出 CBZ、PDF 或纯图片，默认路径为文档目录下的 `manga-translate`。
- **清除翻译缓存**：直接清除应用缓存即可清空悬浮窗等翻译缓存。
- **关闭译名处理加速**：关闭「全文速译」后可单独关闭「译名处理」，保留已有译名上下文同时减少额外处理。
- **合集内导入子章节**：进入合集后点击「导入子章节」，支持多选勾选或单个导入，同名/空目录自动跳过。

---

## 赞赏码

![赞赏码](./reward_qrcode.png)
