You need to enable JavaScript to run this app. MacOS下Python OCR工具如何实现无焦点时的全局热键触发
优惠活动
大模型
产品
解决方案
定价
更多

MacOS下Python OCR工具如何实现无焦点时的全局热键触发

全局热键实现方案

你当前基于rumps开发的macOS菜单栏OCR工具,rumps自带的菜单项快捷键仅在应用处于前台时生效,要实现任意应用下按下热键都能触发OCR流程,可按以下方案改造:

  • 抽出原有OCR核心逻辑为独立通用函数,同时适配菜单点击、热键触发两种入口
  • 使用pynput库实现macOS级全局热键监听,该库和rumps的菜单栏主循环兼容性良好
  • 将热键监听设为后台守护线程运行,避免阻塞rumps的事件循环
  • 补充系统权限配置,否则全局热键无法被捕获

步骤1:安装依赖

pip install pynput

步骤2:改造后完整代码

#!/Library/Frameworks/Python.framework/Versions/3.9/bin/python3

import pytesseract
from PIL import Image
import os
import rumps
import pyperclip
from pynput import keyboard
import tempfile

# 抽出OCR核心逻辑,供两种触发入口共用
def run_ocr():
    # 使用临时路径替代桌面路径,避免残留文件
    tmp_capture = os.path.join(tempfile.gettempdir(), 'ocr_capture.png')
    try:
        # 调用系统交互式截图
        os.system(f'screencapture -i {tmp_capture}')
        # 用户按ESC取消截图时直接退出
        if not os.path.exists(tmp_capture):
            return
        # OCR识别
        img = Image.open(tmp_capture)
        text = pytesseract.image_to_string(img)
        # 复制到剪贴板
        pyperclip.copy(text)
        # 弹出结果窗口
        rumps.Window(message='OCR Capture', default_text=text, title='Text Copied').run()
    finally:
        # 无论成功/失败都清理临时截图文件
        if os.path.exists(tmp_capture):
            os.remove(tmp_capture)

# 保留原有菜单点击触发逻辑
@rumps.clicked('OCR (⌘⇧O)')
def ocr_menu(sender):
    run_ocr()

# -------------------------- 全局热键配置 --------------------------
# 自定义热键为 Cmd + Shift + O,可自行修改组合
HOTKEY_COMBO = '<cmd>+<shift>+o'

def on_hotkey_trigger():
    # 热键触发时调用OCR逻辑
    run_ocr()

# 初始化热键监听规则
hotkey = keyboard.HotKey(
    keyboard.HotKey.parse(HOTKEY_COMBO),
    on_hotkey_trigger
)

# 按键事件处理回调
def for_canonical(callback):
    return lambda k: callback(listener.canonical(k))

# 开启后台守护线程运行热键监听,避免阻塞rumps主循环
listener = keyboard.Listener(
    on_press=for_canonical(hotkey.press),
    on_release=for_canonical(hotkey.release)
)
listener.daemon = True
listener.start()
# ----------------------------------------------------------------

# 初始化菜单栏应用
app = rumps.App('OCR', menu=[
    'OCR (⌘⇧O)',
    None
])
app.run()

关键注意事项

  • 系统权限配置:首次运行脚本时,需打开「系统设置 -> 隐私与安全性」,分别在「辅助功能」和「输入监控」列表中,勾选运行该脚本的载体(如Python解释器、后续打包生成的.app文件),否则全局热键无法被系统捕获
  • 热键自定义:修改HOTKEY_COMBO变量即可更换热键组合,推荐使用带修饰键的低冲突组合(如<cmd>+<alt>+o)避免和其他应用快捷键冲突
  • 异常兼容:代码已加临时文件清理、用户取消截图的兼容逻辑,不会因异常残留文件或崩溃

内容的提问来源于stack exchange,提问作者Jerryhuhu25

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 20:45:04