picfly 0.1.0

图片工具：截图上传图床、OCR 文字识别，支持全局热键

picfly

开源图片工具集，支持截图上传图床、OCR 文字识别，通过全局热键快速调用。

功能特性

• 截图上传：框选屏幕区域截图，自动上传至 PicLab 图床，返回图片链接
• 粘贴上传：将剪贴板中的图片（或图片 URL）上传至图床
• OCR 截图识别：框选屏幕区域，调用白描 OCR 识别文字
• OCR 粘贴板识别：识别剪贴板中的图片文字
• 全局热键：后台运行，随时通过热键触发功能

安装

pip install picfly

环境变量配置

使用前需配置以下环境变量：

PicLab 图床（截图/粘贴上传）

变量名	必填	说明
PICLAB_BASE_URL	✅	上传接口地址
PICLAB_API_KEY	✅	Bearer Token 认证密钥
PICLAB_VERIFY_SSL	❌	设为 false 跳过证书校验
PICLAB_TIMEOUT	❌	请求超时时间（秒），默认 30
PICLAB_USE_SYSTEM_PROXY	❌	设为 true 使用系统代理

OCR（文字识别）

变量名	必填	说明
BAIMIAO_BASE_URL	✅	OCR 服务地址
BAIMIAO_API_KEY	✅	API 密钥

使用方法

命令行启动

picfly

Python 代码调用

from picfly import main

main()

热键说明

启动后，程序在后台监听以下热键：

热键	功能
F8 + 9	截图上传
F8 + 0	粘贴上传
F8 + -	OCR 截图识别
F8 + =	OCR 粘贴板识别
F8 + ESC	退出程序

模块说明

工具类

from picfly.utils import PicLabUploader, BaimiaoApiClient

# 图床上传
uploader = PicLabUploader()
result = uploader.upload("path/to/image.png")  # 本地文件
result = uploader.upload("https://example.com/image.png")  # 远程 URL
result = uploader.upload(image_bytes)  # 二进制数据

# OCR 识别
ocr = BaimiaoApiClient()
text = ocr.recognize("path/to/image.png")
text = ocr.recognize(pil_image)  # PIL Image 对象
text = ocr.recognize(image_bytes)  # 二进制数据

截图选择器

from picfly.utils import RegionSelector

selector = RegionSelector()
image = selector.select()  # 返回 PIL Image 或 None

系统要求

• 操作系统：Windows 10/11
• Python：3.9+

依赖

• requests - HTTP 请求
• Pillow - 图像处理
• pynput - 全局热键监听
• pyperclip - 剪贴板操作
• plyer - Windows 桌面通知

许可证

MIT License

作者

mofanx - [e-mail]