README_ZH.md

English | 简体中文

KeyStats - macOS/Windows 键鼠统计菜单栏应用

KeyStats可以统计用户每日的键盘敲击次数、鼠标点击次数、鼠标移动距离和滚动距离。

安装与使用

macOS

方式一：使用 Homebrew 安装

# 订阅 tap
brew tap debugtheworldbot/keystats

# 安装应用
brew install keystats

更新应用：

brew upgrade keystats

方式二：从 GitHub Release 下载

Windows

方式一：使用 Scoop 安装

scoop bucket add keystats https://github.com/debugtheworldbot/scoop-keystats
scoop install keystats

方式二：从 GitHub Release 下载 Windows 版本安装包

无需安装任何依赖：Windows 版本使用 .NET Framework 4.8，Windows 10 (1903+) 和 Windows 11 已预装，开箱即用。如果你的 Windows 10 版本较旧（早于 1903），可以升级系统或手动安装 .NET Framework 4.8。

Linux

下载 Linux 版本

功能特性

• 键盘敲击统计：实时统计每日键盘按键次数
• 鼠标点击统计：分别统计左键和右键点击次数
• 鼠标移动距离：追踪鼠标移动的总距离
• 滚动距离统计：记录页面滚动的累计距离
• 菜单栏显示：核心数据直接显示在菜单栏
• 详细面板：点击菜单栏图标查看完整统计信息
• 每日自动重置：午夜自动重置统计数据
• 数据持久化：应用重启后数据不丢失

系统要求

macOS

• macOS 13.0 (Ventura) 或更高版本

Windows

• Windows 10 (1903+) 或 Windows 11
• 无需安装任何依赖：使用 .NET Framework 4.8（Windows 10/11 已预装，开箱即用）
• 应用大小：约 5-10 MB（轻量级，无需额外运行时）

注意：如果你的 Windows 10 版本较旧（早于 1903），可以：

1. 升级到 Windows 10 1903 或更高版本（推荐）
2. 或手动安装 .NET Framework 4.8：下载链接

首次运行权限设置

macOS

KeyStats 需要辅助功能权限才能监听键盘和鼠标事件。首次运行时：

1. 应用会弹出权限请求对话框
2. 点击"打开系统设置"
3. 在"隐私与安全性" > "辅助功能"中找到 KeyStats
4. 开启 KeyStats 的权限开关
5. 授权后应用将自动开始统计

注意：如果没有授予权限，应用将无法统计任何数据。

重新安装/升级app提示：由于应用未进行签名，每次重新安装后 macOS 不会自动更新辅助功能授权。请先在"隐私与安全性">"辅助功能"中移除 KeyStats 的旧授权，再回到应用点击"获取权限"按钮重新授权即可。

自动更新提示（未签名版本，macOS Ventura+）：首次 Sparkle 自动更新可能失败。请先在“隐私与安全性”>"App 管理"中开启 KeyStats；如果已失败，可点击系统授权通知进入设置打开开关，再点“立即更新”重试。

Windows

Windows 版本无需额外权限设置，应用启动后会自动开始统计。

注意：首次启动时，Windows 可能会弹出安全警告，点击"仍要运行"即可。

隐私说明

KeyStats 仅统计按键和点击的次数，不会记录：

• 具体按下了哪些键
• 输入的文字内容
• 点击的具体位置或应用

所有数据仅存储在本地，不会上传到任何服务器。

Star History

许可证

MIT License