自动记录你每天在电脑上做了什么,并按任务分类展示时间分布。后台静默运行,每隔几秒检测一次当前活跃窗口,将使用记录存入本地数据库。你只需打开浏览器,就能看到今天的时间都花在哪里了。
安装依赖:
pip install -r requirements.txt启动:
start.bat然后在浏览器中打开 http://localhost:5000,即可看到仪表盘。
页面顶部始终显示当前活跃窗口的实时信息:
- 进程名(橙色字体):当前前台程序的可执行文件名,例如
Code.exe、chrome.exe - 窗口标题:当前窗口的完整标题,例如
index.html - MyProject - Visual Studio Code - 匹配状态:显示该窗口当前被归类到哪个任务(绿色 ✓),或尚未匹配任何任务(红色 ✗)
这个信息栏是配置关键词时最重要的参考依据——你可以直接看到当前窗口的进程名和标题,然后把其中有代表性的词复制到任务关键词里。
左侧状态指示灯显示追踪是否正常运行,以及当前正在计入哪个任务。
时间范围选择
点击快捷按钮切换查看范围:
- 今天 / 昨天:查看单日记录
- 本周 / 本月:查看更长时间段的汇总
也可以手动填写开始和结束日期,然后点击"刷新"按钮加载数据。
任务列表
列出所有已配置的任务,每个任务显示在当前时间范围内累计的使用时长。
- 点击编辑按钮可修改任务名称、颜色和关键词
- 点击删除按钮可删除任务(历史记录数据不受影响)
- 用鼠标拖拽任务条目可以调整任务在甘特图中的排列顺序,松手后自动保存
主区域以时间轴形式展示每个任务的活跃时间段,每行对应一个任务。
查看详情
将鼠标悬停在任意色块上,会弹出提示框,显示该时间段的:
- 开始时间和结束时间
- 持续时长
- 当时的窗口标题
缩放与导航
- 点击 + / − 按钮放大或缩小时间轴
- 点击 ⊙ 按钮重置缩放,自动适配当前视图宽度
- 点击 ⏱ 现在 按钮,时间轴自动滚动到当前时刻
- 点击 🔍 紧凑 按钮,时间轴自动收缩到只显示有记录的时间段(从最早记录到现在),方便聚焦查看;再次点击恢复全天视图
- 使用键盘
+/-也可以缩放,0重置,R刷新数据
时间粒度
下拉菜单可选择时间轴刻度间隔:5 分钟、15 分钟(默认)、30 分钟、1 小时。
点击右上角+ 添加任务按钮,填写:
- 任务 ID:英文唯一标识,创建后不可修改,例如
coding、meeting - 任务名称:显示在界面上的名称,例如"写代码"、"开会"
- 颜色:从色板中选择一个颜色
- 关键词:用逗号分隔,例如
Code.exe, vscode, github
TaskTracker 通过关键词来判断当前窗口属于哪个任务。每隔几秒,程序会检测当前活跃窗口的进程名和窗口标题,然后逐个任务检查关键词是否出现在其中(不区分大小写)。
如何找到正确的关键词?
查看页面顶部的活跃窗口信息栏:
- 进程名通常是程序的
.exe文件名,例如Code.exe、chrome.exe、WINWORD.EXE - 窗口标题包含文件名、网页标题等更具体的信息,例如
Stack Overflow - Google Chrome
把这些信息中有代表性的部分填入关键词即可。例如:
- 想追踪 VS Code 的使用时间 → 关键词填
Code.exe - 想追踪所有 Chrome 浏览 → 关键词填
chrome.exe - 想只追踪在 YouTube 上的时间 → 关键词填
YouTube(匹配窗口标题)
兜底任务
如果某个任务的关键词列表为空,它会作为"兜底"任务,捕获所有未被其他任务匹配到的窗口。建议保留一个名为"其他"的兜底任务,避免遗漏记录。
修改关键词不影响历史数据
所有原始窗口记录都保存在数据库中,任务分类是在查询时实时计算的。因此,你随时可以修改关键词,历史数据会按新规则重新归类,不会丢失任何记录。
在左侧任务列表中点击任意任务的编辑按钮,可以修改任务名称、颜色和关键词。任务 ID 创建后不可修改。
点击删除按钮后会弹出确认提示。删除任务只会移除任务配置,不会删除历史窗口记录——如果之后重新创建同名任务并配置相同关键词,历史数据仍可被归类回来。
在左侧任务列表中,用鼠标拖拽任务条目左侧的 ⋮⋮ 图标,可以上下移动任务。松手后顺序自动保存,甘特图中的行顺序也会同步更新。
仪表盘每 10 秒自动刷新一次数据,无需手动操作。状态栏每 5 秒更新一次活跃窗口信息。
MIT