用途
该技能用于掌握与 RescueTime 和 Toggl Track API 的时间追踪集成，实现自动化时间录入、综合报告、生产力分析以及项目/任务归属，从而构建时间管理自动化和仪表盘。
适用场景
资料列出以下应使用时间追踪 API 的场景：
- 自动化时间条目：从脚本、CI/CD 或其他工具记录时间
- 构建生产力仪表盘：聚合时间数据用于分析
- 项目计费：自动追踪可计费工时
- 专注时间分析：理解生产力模式
- 团队时间管理：聚合团队时间数据
- 集成管道：将时间追踪与任务管理器连接
- 自动化报告：以编程方式生成时间报告
- 自定义分析：构建专门的生产力洞察
资料同时列出不应使用时间追踪 API 的场景：
- 简单手动追踪：改用原生应用
- 实时监控：API 存在速率限制
- 侵入式员工监控：存在伦理问题
- 复杂发票：使用专门的计费软件
前置条件
Toggl Track 设置
从 https://track.toggl.com/profile 获取 API token（滚动到 API Token 处）。设置环境变量：
export TOGGL_API_TOKEN="your-api-token"
Toggl 使用 HTTP Basic Auth，token 作为用户名，"api_token" 作为密码，也可以直接使用 token。验证认证：
curl -s -u "$TOGGL_API_TOKEN:api_token"
"https://api.track.toggl.com/api/v9/me" | jq '.fullname'
RescueTime 设置
从 https://www.rescuetime.com/anapi/manage 获取 API Key。设置环境变量：
export RESCUETIME_API_KEY="your-api-key"
验证认证：
curl -s "https://www.rescuetime.com/anapi/data?key=$RESCUETIME_API_KEY&format=json&restrict_kind=overview" | jq
Python 设置
安装依赖：
pip install requests python-dateutil pandas
使用 uv：
uv pip install requests python-dateutil pandas
可选 Toggl SDK：
pip install toggl-python
验证：
python -c "import requests; print('Ready for time tracking integration!')"
主要能力
1. Toggl Track - 时间条目
REST API 支持：获取当前运行的时间条目、获取最近时间条目、按日期范围获取时间条目、启动计时器、停止运行中的时间条目、创建已完成的时间条目、更新时间条目、删除时间条目。
Python 示例提供 TogglClient 类，包含 get_me、get_workspaces、get_current_entry、get_time_entries、start_timer、stop_timer、create_time_entry、update_time_entry、delete_time_entry 等方法。
2. Toggl Track - 项目与客户
REST API 支持：获取工作区项目、创建项目、获取客户、创建客户、获取标签、创建标签。
Python 示例提供 get_projects、create_project、get_clients、create_client 方法。
3. Toggl Track - 报告
Reports API 支持：摘要报告、详细报告、周报告。
Python 示例提供 TogglReports 类，包含 summary_report、detailed_report、weekly_report 方法。
4. RescueTime - 数据检索
REST API 支持获取摘要数据，以及按特定日期范围获取数据。
限制
资料中明确提到：API 存在速率限制，因此不适合实时监控；侵入式员工监控存在伦理问题；复杂发票应使用专门的计费软件。资料未提供收费、价格、平台或效果方面的信息。