KeyStats：轻量级 macOS 菜单栏键鼠统计工具，记录每日键盘敲击与鼠标使用情况

🧩 KeyStats 是什么？

KeyStats 是一款 macOS 原生菜单栏应用，专为习惯追踪键鼠使用数据的用户设计。无需复杂配置，安装后即可在菜单栏实时查看当日键盘敲击次数与鼠标点击总数，并提供详细面板展示鼠标移动距离与页面滚动情况。所有统计均在本地完成，不上传、不存云，既实用又保护隐私。

🚀 主要功能亮点

• 键盘敲击统计：精确记录每天的按键次数
• 鼠标点击统计：左键与右键分开统计，数据一目了然
• 鼠标移动距离：追踪鼠标全天的移动总长
• 滚动行为统计：记录页面滚动的总像素
• 菜单栏显示：无需打开应用，即可在顶部状态栏查看数据
• 详细面板：点击图标查看完整数据明细
• 自动重置机制：每日零点清空，便于日常追踪
• 数据本地持久化：重启系统后仍保留统计结果

🧠 技术实现与系统要求

• 支持系统：macOS 13 Ventura 及以上版本
• 开发语言：Swift 5.0
• 核心框架：AppKit、CoreGraphics
• 事件监听：使用 CGEvent.tapCreate 捕捉全局键鼠事件
• 数据存储：基于 UserDefaults 本地保存
• 运行方式：纯菜单栏模式（LSUIElement = true）

🔐 隐私与权限说明

KeyStats 不会记录你具体按下的哪个键、输入的文字或点击的坐标，仅统计行为频次。所有数据完全本地保存，不涉及任何网络传输。

首次使用需授权“辅助功能权限”，流程如下：

1. 运行应用，弹出权限提示
2. 点击“打开系统设置”
3. 在“隐私与安全性” > “辅助功能”中勾选 KeyStats
4. 授权后即可自动开始统计

未授予权限时，应用将无法收集任何数据。

📊 使用说明示意

菜单栏数据显示示例：

1,236
  487

• 上方数字表示当天键盘敲击总数
• 下方数字表示当天鼠标点击总数（左+右）
• 数字自动格式化，如：1.2K, 1.0M
• 点击图标可展开详细统计面板

🔧 操作选项

• 手动重置统计数据
• 退出应用程序

📦 安装方式

下载地址：网盘

GitHub地址：https://github.com/debugtheworldbot/keyStats