# py-auto-pull

**Repository Path**: xlsocute/py-auto-pull

## Basic Information

- **Project Name**: py-auto-pull
- **Description**: 一个简单又轻量的实时翻译小工具
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2025-06-10
- **Last Updated**: 2025-06-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 多摩喵实时翻译小工具

一个基于PyQt6的开源字幕翻译工具，支持屏幕区域文字识别和实时翻译（多用于漫画或galgame 当然你怎么使用都可以），相较于其他实时字幕翻译器更加轻量化，配置更加简单。

## 📥 下载 （如果需要放到桌面推荐创建快捷方式到桌面或将在桌面创建文件夹，否则部分功能会失效）

### 最新版本
- **Windows 64位**: [Gitee Release页面下载](https://gitee.com/sameki/py-auto-pull/releases)
- **源码**: 直接克隆此仓库

### 使用说明  请认真并仔细阅读本手册！！！
1. 下载exe文件后直接运行即可
2. 首次运行会自动检测并安装Tesseract-OCR
3. 确保已安装所需的语言包,在安装Tesseract-OCR窗口中会有个步骤会询问你是否安装语言包，默认安装英文语言包（英语/日语）

## 功能特点

- 支持选择屏幕区域进行文字识别
 ![setusmei](せつめい画像/setusmei1.png)
- 支持英语和日语识别
- **支持多种OCR服务：**
  - **本地OCR**：基于Tesseract-OCR，无需网络连接
  - **腾讯OCR**：云端识别，准确率更高
  - **百度OCR**：云端识别，支持多语言
- 支持多种翻译API：
  - DeepSeek API（支持自定义提示词）
  - 百度翻译API
  - 腾讯翻译API
  - 阿里翻译API
- 实时显示翻译结果
- 可调整翻译显示窗口的样式（字体颜色、背景颜色、字体大小）
- 支持自动翻译和单次翻译
- 支持复制原文和翻译结果到剪贴板
- 可拖动和调整翻译显示窗口位置
- 支持保存和加载翻译窗口样式设置
- **智能错误处理**：云OCR配置错误时自动回退到本地OCR

## 环境要求

1. Python 3.8或更高版本
2. Tesseract-OCR（本地OCR必需）
   - Windows: 从[这里](https://github.com/UB-Mannheim/tesseract/wiki)下载安装
   - 确保安装时选择需要的语言包（英语和/或日语）

## 安装步骤

1. 安装Python依赖：
```bash
pip install requests PyQt6
```

## 使用方法

1. 运行程序：
   ```bash
   python src/main.py
   ```
2. 或者直接使用```pyinstaller 多摩喵实时翻译小工具.spec```打包
3. 点击"选择区域"按钮选择要翻译的屏幕区域
4. 选择识别语言（英语或日语）
5. **选择OCR服务**（本地OCR/腾讯OCR/百度OCR）
6. 点击"自动翻译"开始实时翻译，或点击"开始翻译"进行单次翻译
7. 可以通过"配置API"按钮设置翻译API和OCR服务的密钥
8. 使用翻译显示窗口的工具栏可以：
   - 调整显示样式（字体颜色、背景颜色、字体大小）
   - 拖动窗口位置
   - 关闭显示窗口

## 配置说明

### OCR服务配置

#### 本地OCR
- 无需配置，基于本地Tesseract-OCR
- 支持英语和日语识别（日语识别基于Tesseract-OCR语言包）需下载
- 无需网络连接，响应速度快

#### 腾讯OCR
1. 在配置对话框中选择"腾讯OCR"
2. 输入您的Secret ID和Secret Key
3. 支持英语(en)、日语(jap)、韩语（kor）识别
4. API申请地址：[腾讯云OCR](https://cloud.tencent.com/product/ocr)

#### 百度OCR
1. 在配置对话框中选择"百度OCR"
2. 输入您的API Key和密钥
3. 支持英语、日语、韩语识别
4. API申请地址：[百度AI开放平台](https://ai.baidu.com/tech/ocr)

### 翻译API配置

#### DeepSeek API
1. 在配置对话框中选择"DeepSeek"
2. 输入您的API密钥
3. 可以自定义系统提示词，用于指导翻译风格
4. API申请地址：[DeepSeek API](https://platform.deepseek.com/)
5. 使用deepseek-chat 翻译内容更信达雅一些，但调用接口时间会比其他翻译平台时间更长，请酌情选择。

#### 百度翻译API
1. 在配置对话框中选择"百度翻译"
2. 输入您的APP ID和密钥
3. API申请地址：[百度翻译开放平台](http://api.fanyi.baidu.com/api/trans/product/desktop)

#### 腾讯翻译API
1. 在配置对话框中选择"腾讯翻译"
2. 输入您的Secret ID和Secret Key
3. API申请地址：[腾讯云机器翻译](https://cloud.tencent.com/product/tmt)

#### 阿里翻译API
1. 在配置对话框中选择"阿里翻译"
2. 输入您的Access Key和Access Secret
3. API申请地址：[阿里云机器翻译](https://www.aliyun.com/product/ai/base_alimt)

## 智能错误处理

### OCR服务错误处理
- **配置缺失**：当云OCR未配置时，自动弹窗提示并切换到本地OCR
- **配置错误**：当云OCR配置错误（如密钥不正确、服务未开通等）时，显示具体错误信息并自动切换到本地OCR
- **网络错误**：当云OCR网络连接失败时，自动回退到本地OCR
- **界面同步**：自动切换时，主窗口的OCR服务选择也会同步更新

### 错误提示类型
- **腾讯OCR错误**：
  - SecretId不正确或不存在
  - SecretKey不正确
  - 服务未开通或权限不足
- **百度OCR错误**：
  - APP ID或密钥不正确
  - access token无效或过期
  - 服务未开通
  - 调用量超限

## 注意事项

- 检测到如果没有安装Tesseract-OCR，则会自动下载Tesseract-OCR
- 先安装Tesseract-OCR，语言包在安装包安装时可以选择是否下载所需语言包！
- 确保已正确安装Tesseract-OCR并配置环境变量
- 确保已安装所需的语言包
- 使用翻译API时需要有效的API密钥
- 使用云OCR服务时需要有效的OCR API密钥
- 翻译窗口的样式设置会自动保存，下次启动时会自动加载
- OCR识别准确率基于本地电脑性能或云服务质量
- 安装PyQt6时需要vc_redist.x64依赖，可从[微软官网下载](https://aka.ms/vs/17/release/vc_redist.x64.exe)
- **云OCR服务需要网络连接，本地OCR无需网络**
- **建议优先使用本地OCR，云OCR作为备选方案**

## 许可证

MIT License