KeyStats 5 个最实用设置:里程碑通知、开机自启、鼠标距离校准等隐藏功能详解

原创2026-10-11 14:06:231,367 阅读

KeyStats 5 个最实用设置:里程碑通知、开机自启、鼠标距离校准等隐藏功能详解

KeyStats 是一款轻量级的 macOS/Windows 键盘与鼠标统计菜单栏工具,能记录每日按键数、鼠标点击、移动距离和滚动距离。但很多新手只用它看了数字就关掉,却不知道设置面板里藏着几个"改变体验"的功能:里程碑通知、开机自启、鼠标距离校准、动态图标颜色、按应用统计。这篇文章带你一次性摸清这 5 个最实用设置,全部来自项目源码,无需猜测。


1️⃣ 里程碑通知:每天按到 1 万次键盘,系统会提醒你

KeyStats 的"里程碑通知"指的是:当你当天的按键数或点击数每跨越一个阈值倍数(如每 5000 次)时,弹出一条统计提醒通知,相当于给你的输入量打了卡。

怎么设置:

  1. 打开设置面板(macOS 版在菜单栏图标菜单中进入"设置")
  2. 在"通知"区块打开"开启统计通知"开关
  3. 分别设置"按键通知阈值"和"点击通知阈值"(范围 0–1,000,000,步进 100)
  4. 阈值为 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 米"才真正有物理意义。

校准流程(只需一次):

  1. 在设置面板点击"鼠标距离校准"按钮
  2. 准备一把 10cm 的标尺
  3. 按任意键开始记录 → 沿标尺直线移动鼠标 10cm → 再按任意键结束
  4. 应用实时显示移动的像素数,完成后自动计算并更新换算系数

技术原理(一句话版): 应用用你移动的像素数反推出"每像素实际长度",存为一个校准系数,之后所有距离统计都用这个系数换算。

📌 源码参考: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 个设置逐项过一遍,你的菜单栏统计工具才算真正"用起来"了 📊

登录后查看全文
keyStats