hiroi-sora / Umi-OCR

OCR software, free and offline. 开源、免费的离线OCR软件。支持截屏/批量导入图片,PDF文档识别,排除水印/页眉页脚,扫描/生成二维码。内置多国语言库。
MIT License
23.48k stars 2.39k forks source link

快捷键增强工具 Hotkeys enhancement plugin / 解决Umi-OCR按键失效、被覆盖、优先级低等问题 #402

Open hiroi-sora opened 4 months ago

hiroi-sora commented 4 months ago

English (Google Translate)


目前,出于兼容性考虑, Umi-OCR 内部的快捷键机制,使用 pynput 库作为键盘驱动。Umi会监听普通按键事件,并自己维护一个事件列表。

这套机制的稳定性较好,不易引发恶性Bug。但缺点是系统优先级较低。如果系统中有别的软件注册了相同快捷键,它们可能优先“吞掉”按键事件,导致Umi无法接收到该事件。或者,在触发Umi的同时,依然触发了别的软件。技术上暂时难以解决此问题。

如果遇到此问题,你可以尝试:

  1. 尽量不设定重复的快捷键。
  2. 以管理员权限启动 Umi-OCR 。
  3. 如下文所示,使用 快捷键增强工具

HotkeysCMD

👆 我写了个小工具,可以通过快捷键发送命令行指令,从而控制 Umi-OCR 的截图等行为。基于 AutoHotkey ,拥有很强的健壮性,能在绝大多数情况下正确接收到快捷键。

它跟 Quicker 等工具的某些功能相似,但更轻量(1.2MB),后台运行几乎不占用资源。

将它与 Umi-OCR 相结合:

  1. 建议使用 Umi-OCR 的最新版本,以免旧版本的某些Bug影响快捷键传递。
  2. 下载 HotkeysCMD.exe
  3. 放在 Umi-OCR.exe 的同级目录下。(也可以放在任意位置,但是需要修改后续的指令路径。)
  4. 首次运行 HotkeysCMD.exe ,会在同目录生成一个 HotkeysCMD_KeyMap.txt
  5. 修改该配置文件为:
    F3 umi-ocr --clipboard
    F4 umi-ocr --screenshot
    AutoStart

    上述配置文件表示:

保存 txt 后,再次点击 HotkeysCMD.exe 启动,即可。(为了设置开机自启,可能会向你请求管理员权限。)

你可以根据 HotkeysCMD 文档 修改快捷键组合,根据 Umi-OCR 命令行手册 修改指令。