键迹 · KeyTrace

一款轻量、克制、隐私优先的 Windows 每日打字统计工具。
看见每天写下的痕迹，而不是记录你写了什么。

下载 Windows 版 · 从源码运行 · 反馈问题

---

为什么是键迹

很多打字统计工具记录得太多。键迹只关心两个数字：今天按下了多少个有效按键，以及当前软件允许检测到多少个新增汉字。

安静驻留	每日可视化	本地优先
关闭窗口后留在系统托盘，不打断工作	今日目标、7 天趋势、28 天热力图	SQLite 数据库保存在本机，不上传统计数据

功能一览

功能	说明
有效按键	统计字母、数字、标点、空格、回车、退格等输入按键
可检测汉字	单独计算当前可访问编辑框中新增的汉字数量
今日概览	实时数字、目标进度、连续记录、近 7 天日均和累计按键
历史记录	最近 28 天热力图、每日明细和 CSV 导出
系统集成	登录 Windows 后自动启动，关闭窗口后驻留系统托盘
随时控制	可以暂停、继续或彻底退出统计

工作方式

flowchart LR
    A[物理键盘事件] --> B[过滤修饰键与软件注入]
    B --> C[有效按键日计数]
    D[当前可访问编辑框] --> E[比较前后汉字数量]
    E --> F[可检测汉字日计数]
    C --> G[(本机 SQLite)]
    F --> G

Loading

键迹不会构建输入内容日志。按键监听只判断事件是否应该计数；中文统计读取当前编辑框并计算数量后立即丢弃文字，只在内存中保留该编辑框的上一次汉字数量。

下载与使用

前往 Releases 下载 KeyTrace.exe，双击即可运行，无需安装 Python。

Note

程序目前没有商业代码签名。Windows 或安全软件可能在首次运行时显示未知发布者提示；你也可以按照下方步骤从源码运行或自行构建。

应用数据默认保存在：

%LOCALAPPDATA%\KeyTrace\keytrace.db

从源码运行

环境要求：Windows 10/11、Python 3.10 或更高版本，以及随 Python 安装的 Tk。

git clone https://github.com/Yh-C12138/KeyTrace.git
cd KeyTrace
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python app.py

构建单文件程序

.\build.ps1

构建脚本会创建独立环境、安装 PyInstaller，并生成 dist\KeyTrace.exe。目标电脑不需要预装 Python。

隐私边界

不写入磁盘	本地保存
具体键位、文字内容、窗口标题、应用名称、网站、剪贴板、输入时间点	每日有效按键总数、每日可检测汉字总数、每日目标和应用设置

• 软件模拟注入的按键默认排除。
• 中文统计依赖目标软件通过 Windows UI Automation 暴露编辑框内容。
• 常见输入框通常可用；终端、游戏和自绘编辑器可能无法检测。
• 粘贴或程序写入造成的新增汉字也可能被计入。
• 键迹自身不需要联网，也不会上传统计数据。

开发与测试

python -m unittest discover -s tests -v

项目保持小而直接：

keytrace/
├── app.py                    # 应用生命周期
├── keyboard_hook.py          # 全局有效按键监听
├── chinese_text_tracker.py   # 可检测汉字统计
├── storage.py                # SQLite 聚合数据
├── tray.py                   # 系统托盘
└── ui.py                     # Tkinter 界面

参与贡献

欢迎提交 Issue 或 Pull Request。涉及计数逻辑的修改请同时补充测试；涉及中文检测的修改请说明测试过的软件和输入场景。

开源许可

本项目采用 MIT License。

_{用数字记录节奏，不用内容交换隐私。}