用途：为 ActivityWatch 时间追踪工具提供完整参考，涵盖安装配置、watcher 模块、客户端库、API 查询、自定义开发与自动化集成。
主要能力：aw-qt 桌面托盘应用负责自启动、watcher 开关与设置；aw-server 提供 REST API（/api/0/info、/api/0/buckets、/api/0/buckets/{id}/events、/api/0/query）；内置 aw-watcher-window 与 aw-watcher-afk，可选 aw-watcher-web、aw-watcher-vscode、aw-watcher-vim。aw-client 提供 Python、JavaScript、Go、Rust SDK。
使用方式：安装可用 brew install --cask activitywatch；Web UI 与 API 默认在 http://localhost:5600。Python 客户端安装 pip install aw-client，可查询事件、按应用统计时长、导出 CSV。自定义 watcher 通过 create_bucket 与 heartbeat 上报事件。多设备同步用 aw-sync --folder <目录>；分析集成用 activitywatch-exporter 导出到 InfluxDB；AI 集成可配置 activitywatch-mcp。
适用场景：时间追踪数据分析、自定义 watcher 与集成开发、API 查询、多设备同步、Grafana 仪表盘、AI 代理查询。
限制：资料基于 macOS 路径与 v0.13.2，其他平台细节暂未提供；配置项、命令与代码需按实际环境调整。