logo
0
0
WeChat Login
Akari<2313359870@qq.com>
docs: update README.md

按键计数器 (Key Counter)

一个简单实用的全局按键计数工具,支持自定义按键和组合键,适用于需要统计操作次数的场景。

功能特点

  • 全局热键支持:无需窗口置顶或获取焦点,在任何界面下均可触发计数。
  • 完全自定义按键
    • 支持设置“正确”和“错误”的计数按键。
    • 支持设置“清空”和“撤销”的快捷键。
    • 支持组合键(如 Ctrl+Z, Alt+F1 等)。
  • 防误触设计
    • 统计过程中禁止修改按键设置。
    • 支持“撤销”上一次操作,防止按错。
  • 窗口置顶:可选择让窗口始终保持在屏幕最前端。
  • 小巧便捷:界面简洁,占用资源少。

安装说明

  1. 确保已安装 Python 3.x

  2. 安装项目依赖:

    pip install -r requirements.txt

    注意:程序依赖 tkinter 图形库。Windows 版 Python 通常自带该库。 如果你在 Linux (Ubuntu/Debian) 上运行,可能需要手动安装: sudo apt-get install python3-tk

使用指南

  1. 运行程序:

    python counter.py // sudo .venv/bin/python counter.py
  2. 设置按键

    • 点击对应的“设置按键”按钮。
    • 在弹出的提示框中,按下你想设置的键(支持组合键,如按住 Ctrl 再按 Z,然后松开)。
    • 程序会自动识别并保存设置。
  3. 开始统计

    • 点击“开始统计”按钮。
    • 此时按键设置会被锁定,按下设定好的热键即可增加计数。
  4. 快捷操作

    • 撤销:如果按错了,可以使用“撤销”快捷键(默认 F4)回退上一次计数。
    • 清空:使用“清空”快捷键(默认 F3)将计数重置为 0。

依赖库

  • pynput: 用于监听全局键盘事件。
  • tkinter: 用于构建图形用户界面(Python 标准库)。