ActivityWatch
ActivityWatch 0.13.2 是面向 Windows、macOS 与 Linux 的开源自动时间记录工具,在本机保存活动窗口、离开状态和可选浏览器标签数据,并通过本地网页查看时间线与分类统计。
适合做什么
ActivityWatch 适合个人复盘应用使用、离开时间和可选的网页活动。它把活动拆成 buckets 和事件,通过本地网页按日期、应用、网站或自定义类别查看时间线。记录的是设备活动信号,不等于工时审批、任务成果或员工绩效;比较时应结合自己的任务清单和手工备注。
常见用法是先观察一周:看会议、编码、阅读、沟通和离开状态的比例,再调整分类规则。分类名称应贴近实际工作,例如“项目 A”“学习阅读”“深度工作”,不要一开始就建立过多宽泛规则。对比周趋势时还要记下假期、外接设备或系统休眠等影响因素。
版本、组件与数据路径
0.13.2 是当前稳定版本,提供 Windows、macOS 与 Linux x86_64 构建;0.14.0b3 属于预发布测试版,试用时应使用独立数据目录。核心桌面程序负责本地服务,窗口 watcher 和 AFK watcher 提供基础事件,浏览器 watcher 则会扩大记录范围。安装后先确认本地网页、数据目录和 REST API 的监听范围,再决定是否增加组件。
隐私与复盘边界
窗口标题、文件名、浏览器标题和 URL 可能包含客户、项目或搜索内容。建议先排除密码管理器、财务系统、私密文档和会议标题,再把本地 API 仅绑定到本机;备份文件应放在访问受限的位置。若用于团队场景,必须明确告知记录范围、保留时间和访问人,不能把活动时长直接当作绩效结论。
维护记录
本页依据 ActivityWatch 0.13.2 与 0.14.0b3 发布、窗口/AFK/浏览器 watcher、本地服务器、REST API、JSON 导出、同步状态与 MPL-2.0 说明复核,检查日期为 2026-08-23。
保存到自己的网盘
打开网盘后可直接获取,也可以先保存到自己的网盘,方便换设备继续使用。
夸克网盘(无需提取码)
推荐将「ActivityWatch」保存到该网盘
百度网盘
将「ActivityWatch」保存到该网盘
ActivityWatch 0.13.2 安装、时间线与隐私设置教程
安装后先用一天测试窗口与离开状态记录,检查时间线中是否出现敏感标题,再决定是否安装浏览器 watcher;正式长期记录前完成排除规则、分类与数据导出备份。
安装前准备
- 明确电脑是否允许记录应用名、窗口标题和键鼠活跃状态;单位设备先获得管理员与隐私政策许可。
- 核对 Windows、macOS 或 Linux x86_64 构建,确保本机时间、时区和休眠设置正确。
- 准备受保护的备份位置;时间记录可能泄露工作内容、文件名和浏览历史,不存入公开同步目录。
安装步骤
- 01
安装 0.13.2 稳定版
Windows 使用安装器或 ZIP,macOS 使用 x86_64 DMG,Linux 选择 AppImage、DEB 或 ZIP;启动后确认托盘组件、本地服务器和默认 watcher 正常。
- 02
检查窗口与 AFK 记录
打开几个无敏感信息的测试应用,工作与离开各几分钟,再在本地网页查看活动、时间线和 AFK 区间,核对时区与应用分类。
- 03
配置排除和可选 watcher
对密码管理器、客户系统、私密文件和会议标题设置排除规则;只有确实需要网站维度统计时才安装浏览器 watcher,并检查其 URL 与标题采集范围。
快速上手
- 01
建立应用与网站分类
先用一周真实记录把常见应用和站点归入工作、沟通、学习或娱乐等类别,不把短期零散标题写成过宽规则。
- 02
对照时间线而非追求满时长
检查会议、离开、后台播放和多窗口切换是否被误判;ActivityWatch 记录的是设备活动信号,不等于可计费工时或任务完成量。
- 03
导出 JSON 并验证恢复资料
定期从本地界面导出完整数据或关键 buckets,备份前关闭写入并记录版本;测试文件能读取后再考虑清理旧数据。
使用建议
- 0.13.2 于 2024-10-05 发布,是截至 2026-08-06 的最新稳定版;0.14.0b3 为 2026-07-28 发布的预发布版。
- 默认组件记录活动窗口和 AFK 状态,浏览器标签、编辑器或其他数据需要额外 watcher;采集越多,隐私暴露面越大。
- 本地网页、REST API 和数据目录都包含详细时间序列,不向局域网或不可信程序开放,也不把未加密备份放入共享目录。
- ActivityWatch 适合自我复盘和趋势分析,不自动理解工作的价值,也不应在未告知情况下用于监控他人。
故障排查与卸载方法
时间线为空或活动应用不更新怎么办?
检查托盘主程序、本地服务器、窗口与 AFK watcher 是否运行,确认系统隐私权限和本机时间;重启前先保留日志,不重复启动多个实例。
记录中出现不应保存的窗口标题怎么办?
立即停止对应 watcher,配置标题排除规则并检查浏览器扩展范围;根据需要删除相关事件和旧备份,之后用测试窗口确认规则确实生效。
- 导出并保护历史数据导出需要保留的 JSON,记录版本、时区和自定义分类,把备份放入加密或访问受限位置并验证可读取。
- 停止 watcher 后卸载先退出托盘程序与所有 watcher,再按平台卸载;只有确认不需要历史记录时才删除数据库、日志与配置目录。
常见问题
ActivityWatch 会把记录自动上传到云端吗?
官方桌面套件的核心设计是在本机服务器中存储和查询数据,用户控制数据。同步仍属于持续开发能力,不能把本地数据库当作已有云备份;启用第三方 watcher、同步目录或自行暴露接口时需要单独评估数据去向。
它会记录哪些敏感信息?
默认 watcher 可记录当前应用与窗口标题、键鼠活动用于判断离开状态;浏览器 watcher 还可记录活动标签标题和 URL。这些内容可能包含文件名、客户名、搜索词或私密站点,使用前应配置排除规则并限制本机访问。
应该安装 0.13.2 还是 0.14.0 测试版?
0.13.2 是当前最新稳定版;截至 2026-08-06,0.14.0b3 属于预发布测试版,新增架构和平台构建仍在验证。需要稳定记录时优先正式版,测试版应使用独立备份并避免直接覆盖唯一数据库。
下载时需要提取码吗?
夸克网盘无需提取码;百度网盘所需的四位提取码会直接显示在下载入口旁。