wxOcr

KO | EN

gitlite — search

#javascript #llm #go #machine-learning #rust #deep-learning #windows #awesome #cli #kubernetes #vue #mcp #ios #open-source

(★ 12)

一个基于微信OCR引擎的文字识别工具，支持截图识别、本地图片识别，提供了友好的图形界面和HTTP接口。

wxOcr Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 微信OCR工具

一个基于微信OCR引擎的文字识别工具，支持截图识别、本地图片识别，提供了友好的图形界面和HTTP接口。

## 功能特点

### 核心功能
- 截图识别：支持快捷键触发截图并识别文字
- 本地图片识别：支持打开本地图片进行识别
- 实时预览：左侧显示图片，右侧显示识别结果
- HTTP接口：提供API接口供其他程序调用

### 辅助功能
- 自动复制：可选择自动复制识别结果到剪贴板
- 自动保存：可选择自动保存识别结果到文件
- 截图保存：可选择是否保存截图到本地
- 状态提示：识别过程中显示状态提示
- 系统托盘：支持最小化到系统托盘
- 开机启动：支持设置开机自动启动

### 快捷键支持
- 截图识别：默认 Ctrl+Q
- 打开图片：默认 Ctrl+O
- 打开设置：默认 Ctrl+P
- 支持自定义快捷键

## 安装说明

### 环境要求
- Windows 7/10/11
- Python 3.6+
- wxPython 4.2.0+
- Flask 2.0.0+
- keyboard 0.13.5+

### 从源码安装

1. 克隆仓库
```bash
git clone https://github.com/yourusername/wx-ocr-tool.git
cd wx-ocr-tool
```

2. 创建虚拟环境（推荐）
```bash
python -m venv venv

# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate
```

3. 安装依赖
```bash
pip install -r requirements.txt
```

4. 运行程序
```bash
python main.py
```

### 使用打包版本

1. 从 [Releases](https://github.com/yourusername/wx-ocr-tool/releases) 下载最新版本
2. 解压到任意目录
3. 运行 `WxOcrTool.exe`

## 使用说明

### 图形界面使用
1. 截图识别
   - 点击"截图识别"按钮或使用快捷键(默认Ctrl+Q)
   - 鼠标选择要识别的区域（鼠标显示为十字形）
   - 松开鼠标完成识别
   - 识别结果会显示在右侧文本框中

2. 本地图片识别
   - 点击"选择图片"按钮或使用快捷键(默认Ctrl+O)
   - 选择要识别的图片文件（支持 jpg, png, bmp 格式）
   - 等待识别完成
   - 识别结果会显示在右侧文本框中

3. 设置选项（Ctrl+P 打开）
   - 常规设置
     * 自动复制识别结果到剪贴板
     * 自动保存识别结果到文件
     * 显示OCR识别状态
     * 最小化到系统托盘
     * 开机自动启动（需要管理员权限）
   - 截图设置
     * 保存截图到本地
     * 自定义截图保存路径
   - 快捷键设置
     * 自定义所有功能的快捷键
     * 支持组合键（Ctrl/Alt/Shift）

4. 系统托盘功能
   - 左键单击：切换窗口显示状态
   - 左键双击：显示主窗口
   - 右键菜单：
     * 显示主窗口
     * 打开设置
     * 退出程序

### HTTP接口使用

程序启动后会在本地5000端口提供HTTP服务。

1. 触发截图识别
```bash
curl http://127.0.0.1:5000/screenshot
```
响应示例：
```json
{
    "code": 200,
    "message": "截图指令已发送",
    "success": true
}
```

2. 获取服务状态
```bash
curl http://127.0.0.1:5000/status
```
响应示例：
```json
{
    "code": 200,
    "message": "服务正常运行",
    "success": true,
    "data": {
        "server": "running",
        "window_visible": true
    }
}
```

### 状态码说明
- 200: 成功
- 400: 请求错误
- 500: 服务器错误

## 目录结构
```
├── main.py           # 主程序入口
├── view.py          # 主窗口界面
├── server.py        # HTTP服务
├── shot.py          # 截图功能
├── settings_dialog.py # 设置对话框
├── requirements.txt  # 依赖列表
├── README.md        # 说明文档
├── img/             # 图片目录
│   └── icon.png     # 程序图标
├── results/         # 识别结果目录
└── app.log          # 日志文件
```

## 常见问题

1. 快捷键不响应
   - 检查是否与其他程序快捷键冲突
   - 尝试重新设置快捷键
   - 检查是否以管理员权限运行（某些系统需要）

2. 识别失败
   - 检查网络连接
   - 确保图片清晰可读
   - 查看日志文件获取详细错误信息
   - 尝试重新启动程序

3. HTTP服务启动失败
   - 检查端口5000是否被占用
   - 尝试修改端口号
   - 查看日志文件获取详细错误信息

4. 系统托盘图标不显示
   - 检查img目录下是否存在icon.png
   - 检查系统托盘区域是否已满
   - 尝试重启程序

5. 开机自启动设置失败
   - 确保以管理员权限运行程序
   - 检查杀毒软件是否阻止注册表修改
   - 查看错误提示信息

## 更新日志

### v2.0.0 (2024-01-20)
- 添加HTTP接口支持
- 添加系统托盘功能
- 优化状态提示显示
- 添加全局快捷键支持
- 改进错误处理和日志记录
- 优化截图体验
- 添加更多设置选项
- 添加开机自启动功能

### v1.0.0 (2023-12-25)
- 基础OCR识别功能
- 截图和本地图片支持
- 基本设置选项
- 首次发布

## 开发计划
- [ ] 批量识别功能
- [ ] OCR引擎选择
- [ ] 识别语言选择
- [ ] 结果格式优化
- [ ] 界面主题切换
- [ ] 识别区域记忆
- [ ] 历史记录功能
- [ ] 导出功能增强

wxOcr

wxOcr Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

wxOcr

wxOcr Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README