Catrace

KO | EN

gitlite — search

#python #react #ai #golang #rust #deep-learning #docker #nodejs #awesome #vue #security #openai #ios #mcp

(★ 77)

根据你的真实工作状态提醒休息 / Like a fitness tracker for your computer life.

Catrace Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Catrace</h1>

帮你平衡工作与休息的小工具 
 久坐提醒 · 喝水打卡 · Agent通知

<a href="https://github.com/lanxiuyun/Catrace/releases/latest">
 ⬇️ 点击下载最新版本
 </a>
 &nbsp;&nbsp;|&nbsp;&nbsp;
 <a href="https://lanxiuyun.github.io/Catrace">
 🏠 官网主页
 </a>
 &nbsp;&nbsp;|&nbsp;&nbsp;
 <a href="https://github.com/lanxiuyun/Catrace">
 💖 觉得有用就 star 一下吧~
 </a>

<a href="README_EN.md">English</a> | 中文

![Catrace Dashboard](https://raw.githubusercontent.com/lanxiuyun/Catrace/main/.readme/dashboard.png)

## 它是干嘛的

很多人一坐电脑前就是几个小时，等反应过来已经腰酸背痛了。
Catrace 就是来解决这个问题的——它在后台默默观察你的活动状态，发现你连续工作太久，就会提醒你站起来休息一会儿。

## 它是怎么知道你在忙的

它不会偷拍屏幕，也不读取你在做什么。它只是悄悄看看你的鼠标有没有动、键盘有没有敲。

然后根据一套简单的规则来判断：

- 它也会识别你正在进行屏幕消费的状态（如看视频、听音乐、看直播），即使那段时间键鼠活动不多。Windows 下通过检测系统音频输出并匹配音频输出进程排除列表来判断；macOS / Linux 下此功能暂时未实现。
- 从你今天第一次敲键盘或动鼠标开始，它开始计时。
- 中间去倒杯水、回个消息、发个呆，只要没连续歇够一段时间，它都觉得你还在同一个工作节奏里。
- 只有当你真的停下来、连续好几分钟一动不动，它才认为你在休息，并把这段时间记下来。
- 如果你一口气忙满了一个「工作窗口」（比如 45 分钟），中间一直没歇够，或者休息完又忙满了一个窗口，它就会弹出一条通知，温柔地提醒你：该休息啦。

## 提醒方式

到时间后，Catrace 会通过你选择的方式提醒你休息。支持两种提醒模式：

- **通知提醒** — 屏幕右下角弹出浮动通知卡片，支持多条堆叠显示；每张卡片带「5 分钟后提醒」「10 分钟后提醒」「跳过本次」三个按钮，鼠标悬停暂停倒计时。当你开始休息时，还会追加一个绿色液体球计时器，球内液面随休息进度上升并带有流动动画，显示已连续休息多久、是否达到有效休息时长。Windows 下不抢夺当前输入焦点，文件重命名、输入框编辑时也不会被打断
- **全屏提醒** — 全屏覆盖提醒，可自定义背景图片、适配方式和遮罩透明度，让你不得不停下来休息

你可以设置自己的工作时长和休息判定时长，找到最适合自己的节奏。

## 喝水提醒

除了提醒你站起来休息，Catrace 也可以按你设定的间隔提醒你喝水，防止一忙起来就忘记补水。

- 只在检测到你正在活跃时检查，休息时不会打扰。
- 到点后右下角弹出蓝色喝水 Toast，与 Dashboard 喝水小组件主题统一，点击「已喝水」即可记录一次。
- 在 Dashboard 的喝水小组件里，可以手动加减今日喝水次数，并查看今天的喝水时间轴。

> 只要你开始休息（哪怕只休息了一分钟），提醒就会自动停止，不会在你休息时一直提醒。等你恢复工作了，它才会重新判断。

## 护眼提醒

长时间盯着屏幕眼睛容易干涩疲劳，Catrace 也会按你设定的间隔提醒你看向远处、放松眼睛。

- 只在检测到你正在活跃时检查，休息时不会打扰。
- 到点后右下角弹出绿色护眼 Toast 卡片，25 秒倒计时结束后自动关闭，无需手动处理。
- 卡片上带「稍后 5 分钟」「跳过本次」两个按钮，方便你按自己的节奏来。

## Agent 通知

如果你是 AI 编程的重度用户，Catrace 还能帮你盯着 agent 的一举一动。

- 支持 Claude Code、Codex、Gemini CLI、Kimi 等 agent，安装官方 hook 后即可自动接收状态事件（会话开始、提交提示词、停止、失败、通知等）。
- 每个事件可单独设置显示策略：关闭 / 自动 / 固定（sticky）。
- Claude 的权限请求（PermissionRequest）会弹出卡片，直接在卡片上批准或拒绝，不用再切回终端。
- 设置页可一键安装/卸载各 agent 的 hook，并支持自定义提示音。

## 友链

[![友链 linux.do](https://img.shields.io/badge/LINUX--DO-Community-blue.svg?logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTIwIiBoZWlnaHQ9IjEyMCIgdmlld0JveD0iMCAwIDEyMCAxMjAiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI%2BPGNsaXBQYXRoIGlkPSJhIj48Y2lyY2xlIGN4PSI2MCIgY3k9IjYwIiByPSI0NyIvPjwvY2xpcFBhdGg%2BPGNpcmNsZSBmaWxsPSIjZjBmMGYwIiBjeD0iNjAiIGN5PSI2MCIgcj0iNTAiLz48cmVjdCBmaWxsPSIjMWMxYzFlIiBjbGlwLXBhdGg9InVybCgjYSkiIHg9IjEwIiB5PSIxMCIgd2lkdGg9IjEwMCIgaGVpZ2h0PSIzMCIvPjxyZWN0IGZpbGw9IiNmMGYwZjAiIGNsaXAtcGF0aD0idXJsKCNhKSIgeD0iMTAiIHk9IjQwIiB3aWR0aD0iMTAwIiBoZWlnaHQ9IjQwIi8%2BPHJlY3QgZmlsbD0iI2ZmYjAwMyIgY2xpcC1wYXRoPSJ1cmwoI2EpIiB4PSIxMCIgeT0iODAiIHdpZHRoPSIxMDAiIGhlaWdodD0iMzAiLz48L3N2Zz4%3D&style=flat)](https://linux.do/)

## Contributing

参与开发请参阅 [贡献指南](CONTRIBUTING.md)。

Catrace

Catrace Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Catrace

Catrace Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README