KeyStats 5 个最实用设置:里程碑通知、开机自启、鼠标距离校准等隐藏功能详解
KeyStats 5 个最实用设置:里程碑通知、开机自启、鼠标距离校准等隐藏功能详解
KeyStats 是一款轻量级的 macOS/Windows 键盘与鼠标统计菜单栏工具,能记录每日按键数、鼠标点击、移动距离和滚动距离。但很多新手只用它看了数字就关掉,却不知道设置面板里藏着几个"改变体验"的功能:里程碑通知、开机自启、鼠标距离校准、动态图标颜色、按应用统计。这篇文章带你一次性摸清这 5 个最实用设置,全部来自项目源码,无需猜测。
1️⃣ 里程碑通知:每天按到 1 万次键盘,系统会提醒你
KeyStats 的"里程碑通知"指的是:当你当天的按键数或点击数每跨越一个阈值倍数(如每 5000 次)时,弹出一条统计提醒通知,相当于给你的输入量打了卡。
怎么设置:
- 打开设置面板(macOS 版在菜单栏图标菜单中进入"设置")
- 在"通知"区块打开"开启统计通知"开关
- 分别设置"按键通知阈值"和"点击通知阈值"(范围 0–1,000,000,步进 100)
- 阈值为 0 表示关闭对应通知
它的小细节:
- 通知按"倍数"触发:设置 5000 后,达到 5000、10000、15000……都会各提醒一次,不会刷屏
- macOS 版每次提醒都会去重,同一个里程碑只弹一次
- Windows 版在应用重启后会以当前进度为基准继续判断,不会补发历史通知
📌 源码参考:NotificationManager.swift、StatsManager.cs
💡 实用建议:把它当成"专注力刻度尺"——设一个自己平时日均按键数附近的值,每天收到几条通知,就能直观感受今天的输入量是否异常。
2️⃣ 开机自启:让统计从开机第一秒就开始
统计类工具最怕"忘了启动"。KeyStats 提供一键"开机启动"开关,macOS 首次启动时还会主动询问你是否需要开机启动。
两个平台的实现方式:
| 平台 | 实现机制 | 源码 |
|---|---|---|
| macOS | 系统登录项服务 SMAppService | LaunchAtLoginManager.swift |
| Windows | 写入当前用户的注册表 Run 键 | StartupManager.cs |
注意事项:
- Windows 版在可执行文件路径变化(如升级后目录变了)时会自动修正注册表中的启动路径,无需手动干预
- macOS 版若开关失败,提示前往"系统设置 > 通用 > 登录项"手动启用 KeyStats
- 开机自启 + 里程碑通知组合使用,才是"无感记录一整天输入习惯"的完整方案
3️⃣ 鼠标距离校准:10cm 标尺,让"移动距离"从像素变成真实厘米
这是最容易被忽略的隐藏功能。KeyStats 的鼠标移动距离默认按"像素 → 米"的估算值换算,但不同显示器 DPI、缩放比例差异很大。校准后,你的"今日鼠标移动 1.2 米"才真正有物理意义。
校准流程(只需一次):
- 在设置面板点击"鼠标距离校准"按钮
- 准备一把 10cm 的标尺
- 按任意键开始记录 → 沿标尺直线移动鼠标 10cm → 再按任意键结束
- 应用实时显示移动的像素数,完成后自动计算并更新换算系数
技术原理(一句话版): 应用用你移动的像素数反推出"每像素实际长度",存为一个校准系数,之后所有距离统计都用这个系数换算。
📌 源码参考:MouseDistanceCalibrationViewController.swift、换算系数保存在 StatsManager.swift
⚠️ 如果移动距离过短或未检测到移动,会提示"校准失败",点"重试"再来一次即可。
4️⃣ 动态图标颜色:菜单栏图标会随打字速度变色
这是菜单栏党的最爱。开启后,KeyStats 的菜单栏图标颜色会随你的**近期输入速率(APM,每分钟按键+点击事件数)**实时变化,一眼就能看出自己是不是在"疯狂敲代码":
| APM 区间 | 图标颜色 |
|---|---|
| < 80 | 不着色(保持默认) |
| 80 – 160 | 浅绿 → 绿 |
| 160 – 240 | 黄 → 红 |
| ≥ 240 | 红色(高强度输入) |
两个可调参数:
- 显示方式:整图"图标着色",或只在角落显示一个"状态圆点"(更低调)
- 统计时间窗口(秒):计算 APM 的时间跨度,1–3600 秒可调——窗口越短,颜色变化越灵敏
📌 源码参考:SettingsViewController.swift、颜色逻辑在 MenuBarController.swift
5️⃣ 按应用统计:一眼看出时间都花在哪个 App 上
默认情况下 KeyStats 只记总量。打开"按应用统计"后,它会按 App 分别记录键盘、鼠标点击、滚动数据(仅保存聚合数字,不记录输入内容),并支持按"今天 / 过去7天 / 过去30天 / 全部"查看排名。
适合用来回答这些问题:
- 我一天里到底在 IDE 里敲了多少键?
- 浏览器里是打字多还是滚轮多?
- 这周的工作日 vs 周末输入量分布如何?
📌 源码参考:AppStatsViewController.swift、窗口控制器 AppStatsWindowController.swift
小提示:该功能默认关闭(可在设置中打开)。关闭时打开应用统计窗口会显示"按应用统计已在设置中关闭"。
5 个设置速查表
| 设置项 | 位置 | 一句话价值 | 主要源码 |
|---|---|---|---|
| 里程碑通知 | 设置 > 通知 | 输入量到点就提醒你 | StatsManager.swift |
| 开机自启 | 设置开关 | 开机即统计,不漏一秒 | LaunchAtLoginManager.swift |
| 鼠标距离校准 | 设置 > 数据 | 距离数据贴近真实厘米数 | MouseDistanceCalibrationViewController.swift |
| 动态图标颜色 | 设置 > 统计 | 输入强度一眼可见 | MenuBarController.swift |
| 按应用统计 | 设置开关 | 时间去哪了,数据说了算 | AppStatsViewController.swift |
写在最后
以上功能的具体文案和开关布局以官方设置界面为准,中文文案可参考 Localizable.strings,整体功能清单见 README.md。
KeyStats 的隐私设计也值得了解:它只保存聚合统计,不记录输入的文字内容、按键顺序和具体点击位置,数据默认全部留在本地。把这篇的 5 个设置逐项过一遍,你的菜单栏统计工具才算真正"用起来"了 📊