Skip to content
zzzzzsfPublic

About

Windows 本地按键、KPS、Token、TPS 与打字价值统计工具,支持自由布局和逐键配置。

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Keyflow

Windows 本地按键、Token、TPS 与打字价值统计工具,基于 KeysPerSecond 的按键状态和紧凑小组件理念开发。

Keyflow 图标

下载与安装

支持 Windows 10(1809 及以上)/ Windows 11 x64。到本仓库的 Releases 下载最新预览版:

  • Setup.exe 安装版:当前用户安装,包含开始菜单、可选桌面快捷方式与卸载入口,无需管理员权限。卸载保留用户数据。
  • Portable.zip 便携版:解压整个目录,双击 Keyflow/Keyflow.exe。内含 portable.flag,数据保存到程序旁 Data,可整目录迁移。升级时保留原有 Data。
  • Source.zip:对应版本项目源码与构建资源;SHA256SUMS.txt 用于核对文件完整性。

均自带 .NET、Node 与词表,运行无需联网。当前没有代码签名,Windows 可能提示未知发布者。详细功能和限制见 发布说明,数据处理见 隐私说明。

便携版不会自动复制旧安装数据。需要迁移时,先退出程序,将 %LOCALAPPDATA%\Keyflow 的 settings.json、sessions.json 复制到便携版 Data。若希望便携包继续使用原来的用户数据目录,移除 portable.flag 即可。原有无标记的免安装目录继续使用原数据路径。

使用

发布目录:Keyflow/。双击 Keyflow.exe,点击「开始统计」。发布包携带 .NET 与 Node 运行时,无需安装 Java、Python 或 Node。整个目录需要保留,不能只移动 exe。

  • 全局按键统计:按键次数、实时 KPS、峰值;默认同一次按住不重复计数。
  • 内置打字区:中文输入法提交后统计;中英混合、代码、emoji 均使用真实分词。
  • 模型:GPT-4o/o200k_base、GPT-4/3.5/cl100k_base、Qwen 2.5、DeepSeek V3。四个 Tokenizer 同时对比,精确版本见 tokenizer/models/manifest.json。
  • 定价:偏好设置中为当前模型设置每百万输出 Token 的单价,支持 CNY/USD。只是玩家自定义价值,不调用 API、不产生模型账单。
  • 会话:点击「新会话」保存汇总并重新开始。历史记录可导出 CSV。每 5 秒自动保存汇总,正常退出也保存。
  • 悬浮小组件:按键方块、KPS、TPS、Token、价值与小曲线;经典黑底方框模式、置顶、拖动、缩放、透明度、鼠标穿透。
快捷键 功能
Ctrl+Alt+F8 开始 / 暂停
Ctrl+Alt+F9 显示 / 隐藏悬浮组件
Ctrl+Alt+F10 关闭鼠标穿透

文本与速度口径

输出 Token 是人的文本产出按选定词表编码的数量,不是调用模型生成的数量。不添加 BOS/EOS、聊天模板或工具调用开销。每个文本控件及每段已完成输入独立分词;当前段编辑后完整重算,避免逐字符累加导致的 BPE 误差。输入框清空(发送或手动清空)后保留上一段的贡献,下一段继续相加。例如第一段 10 Token,清空后再输入 20 Token,本次产出为 30;已完成原文分词后立即压缩为各模型数字,不长期保留已完成原文。

TPS 默认是最近 5 秒净打字 Token 增长 / 5,最低为 0。删除、替换和分词合并会改变净产出。粘贴计入 Token 和价值,但默认排除速度;逐字符追踪来源,删除粘贴内容不会扣减正常打字的速度。可以在设置中改变未来粘贴的处理方式。切换模型会使用各段保存的分词数字与当前文本重新核算本次产出、清空速度窗口,当前会话按最终选择的模型与单价保存。

跨应用采集(兼容模式)

首页勾选「跨应用 Token 采集」,再点击「开始统计」。默认采集范围为所有可访问的编辑框;在偏好设置取消「采集所有应用」后,可使用进程名列表(不含 .exe,逗号分隔)。跨应用采集开关默认关闭,原有开关状态会保留。首页直接显示采集范围、当前来源及无法采集的原因。「最近一次跨应用状态」保留时间与外部应用状态,回到 Keyflow 后仍可查看;不保存输入原文。

使用 Windows UI Automation 访问当前焦点的可编辑控件,已有内容只作基线,只计采集后的新增文字;编辑和删除会更新本次采集文本。密码框、只读控件、未允许的应用均跳过。应用未提供可访问文本时,明确提示且仅统计按键,不按字数猜测 Token。

兼容模式约每 180 毫秒采样,持续输入时也更新,不再等待停手。焦点变化会唤醒采集,并尝试读取前一个控件的最后一次变化。先聚焦编辑框,再开始输入;不能保证所有软件、输入法、网页自定义编辑器都支持。极快输入后立即关闭控件仍可能丢失变化,鼠标粘贴无法可靠区分,按快捷键粘贴后同一个采样间隔内的其他输入也可能被归为粘贴。内置打字区是准确提交和粘贴识别的推荐方式。暂停期间不采集,恢复时重新建立外部基线。每轮采集最多 32 个外部控件,每个控件最多 200,000 个 UTF-16 单元。

本地数据

同一数据目录只允许一个程序实例运行。读取到损坏或异常的数据时,程序会先保存 *.recovery-*.bak 原件副本再修复;无法安全备份时阻止覆盖。尚未完成的新编辑不会使已成功核算的会话贡献失效。性能与正确性修复及复测说明见 修复记录,合成性能复测可运行 node --expose-gc scripts/audit-performance.mjs。

没有云端接口和后台上传。分词在本地子进程内完成,词表随包离线提供。原始文本只在内存中,重启后不恢复。安装版在 %LOCALAPPDATA%/Keyflow/ 中保存 settings.json 与 sessions.json,包含设置与汇总统计;有 portable.flag 时保存到程序旁 Data。KEYFLOW_DATA_DIR 优先覆盖数据目录,测试数据使用独立路径。

开发

需要 .NET 10 SDK、Node.js 22+、Windows 10/11 x64。

npm ci
# 已包含固定词表;只有主动更新词表才需要联网运行 npm run models
dotnet build src/Keyflow.Desktop
dotnet run --project src/Keyflow.Desktop
npm test
dotnet run --project tests/Keyflow.Core.Tests
dotnet build tests/Keyflow.Integration -m:1
dotnet run --project tests/Keyflow.Integration --no-build
dotnet build tests/Keyflow.DesktopFlow -m:1
dotnet run --project tests/Keyflow.DesktopFlow --no-build
powershell -ExecutionPolicy Bypass -File scripts/publish.ps1
# 需要 Inno Setup;制作安装版、便携版、源码包与校验文件
powershell -ExecutionPolicy Bypass -File scripts/release.ps1

发布流程见 RELEASING.md,参与开发见 CONTRIBUTING.md。

32 组分词参考值由官方 Python tiktoken / Rust tokenizers 独立生成,检查完整 Token ID;tests/reference-tokenizers.py 用于重新生成。统计测试包含去重、窗口边界、暂停、删除、基线、Unicode 和粘贴来源。tests/CaptureFixture 提供合成文本和密码框用于跨应用验证。

许可证与来源

GPL-3.0-or-later。保留 Roan Hofland 与 Mroumi 中文分支的来源归属,详见 LICENSE 和 THIRD-PARTY-NOTICES.md。项目不是上游官方版本。

按键累计保存

首页「本次按键」统计当前会话;「累计按键 · 所有会话」汇总历史和当前会话,点击「新会话」不会清除累计。展开「各按键累计次数」查看 A、Space 等单键统计;悬浮窗顶部显示累计总数,按键提示显示该键累计次数。仅在开始统计后计数。

按键总数和单键明细每 5 秒自动写入 %LOCALAPPDATA%/Keyflow/sessions.json,正常退出也会保存,重新打开后自动读取。异常断电或强制结束可能丢失最近尚未保存的几秒。旧版会话总数会自动纳入累计;旧版未保存单键明细,因此无法补回旧会话的单键次数,界面会提示这一点。保存的是次数,不记录按键顺序或输入原文。

目录约定

  • Keyflow/:唯一正式运行目录,双击其中的 Keyflow.exe。
  • artifacts/Keyflow.zip、artifacts/Keyflow-source.zip:最新程序包与源码包,每次打包覆盖更新。
  • artifacts/build/:构建中间产物;artifacts/qa/:隔离测试数据、截图与验证资料。
  • src/、tests/、scripts/、tokenizer/:源码、测试、脚本及分词资源。

原有无便携标记的程序,个人统计继续保存在 %LOCALAPPDATA%/Keyflow/。新的便携发行包使用 Data,两种模式独立,不自动合并统计。

全键盘预设

偏好设置 → 悬浮小组件 →「键盘布局预设」,可选择「全键盘 · 标准 104 键」或原来的「精简 · ASDF JKL + Space」。默认使用全键盘,选择会保存。经典黑底风格与键盘布局独立,可组合使用。

全键盘包含 F1–F12、主键区、左右修饰键、导航/方向区和数字小键盘。键帽显示累计次数,鼠标提示显示完整数值;快速点击短暂保留高亮。主 Enter 和小键盘 Enter 独立计数,NumLock 关闭时数字小键盘保持物理位置。全局计数不受布局影响;只有开始统计后才计数。Fn 等未发送标准 Windows 按键事件的硬件键无法单独识别。

全键盘窗口会按屏幕可用空间限制缩放,仍支持置顶、拖动、透明度和穿透。统计 Token 需要可读取的文字,按键高亮并不代表目标应用已提供文本;请查看首页采集状态。

如果按键数增长而其他软件的 Token 始终为 0,先确认首页已勾选「跨应用 Token 采集」,并点击「开始统计」。选择「所有可访问的编辑框」,或将目标应用加入允许列表;先聚焦输入框,再新增文字。回到 Keyflow 查看「最近一次跨应用状态」可保留目标应用的采集原因。

累计 Token 与自由布局

小组件默认的「累计 TOKENS」= 所有已核算历史会话 + 本次产出。发送、清空输入框、新会话与重启均保留已保存的累计;每 5 秒与正常退出保存。旧记录按当时保存的模型计入,无法恢复旧版本已经丢弃的文字。当前尚未清空的段落仍按实际编辑与分词校准,删除或替换该段可减少当前段数量;清空后视为一段完成,不会再被后续段覆盖。跨应用仍受 UIA 采样范围限制,未被采样到的瞬时文本无法补回。主面板同时展示本次与累计数字。

点击小组件右上角「✎」、右键菜单,或偏好设置 → 悬浮小组件 →「自由编辑布局与外观」。

  • 拖动预览中的区块改变位置,拖右下角绿色柄缩放;也可填写精确坐标、宽高。
  • 自由添加累计/本次 Token、累计/本次按键、KPS、TPS、累计/本次价值、时长、状态、标题或自定义文字;显示/隐藏、复制、移除、调整层级。
  • 修改标签、字号、单独文字颜色;画布宽高、背景/文字/高亮/边框色、字体、圆角、键名字号、键帽次数字号均可设定。可隐藏操作按钮与键帽次数。键盘和曲线各支持一个区块,指标与文字可添加多个,总计最多 60 个区块。
  • 全键盘、精简、纯数据预设可重新开始;经典方角样式仍保留。整体透明度、缩放、置顶和穿透继续使用主面板设置。
  • 预览使用示例数字,点「保存并应用」后生效;取消保留原布局。布局可导出 JSON 并再次导入,重启后恢复。

编辑器右侧新增「逐键设置」:点击预览中的键帽或列表选择单键,独立设置显示/隐藏、键名、坐标、宽高、键名与次数字号、次数显示,以及文字、背景、高亮和边框颜色。留空跟随默认或全局外观;位置与大小以标准键为单位,移动到原键盘范围外会自动扩大键盘画布并适配区块。

支持按键名或编号搜索,按字母键、符号、修饰控制、功能、导航方向、小键盘分组,批量显示/隐藏当前筛选结果。隐藏保留原位置,预览用淡红色标出,仍可选中恢复;也可恢复单键或全部按键默认。主 Enter 与小键盘 Enter、左右修饰键分别设置。全键盘和精简预设均支持逐键配置,旧布局默认保留全部原有按键。隐藏只改变显示,不影响全局计数与历史数据;配置随「保存并应用」、取消、重启和布局 JSON 一起处理。切换到工具栏的其他预设会重置自定义布局与逐键设置。

累计价值仅相加相同币种的历史价值和本次价值,不自动换汇;历史单价保留当时设置。

About

Windows 本地按键、KPS、Token、TPS 与打字价值统计工具,支持自由布局和逐键配置。

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages