Wakatime
Overview
Wakatime 是一个用于追踪编程时间的工具，可以记录你在不同项目、语言、编辑器中的编码时间。这个技能可以查询 WakaTime 的统计数据，包括时间范围、项目、语言、类别、编辑器和机器的明细。
Quick Start
# 健康检查
python3 scripts/wakatime_query.py health
# 查询项目列表
python3 scripts/wakatime_query.py projects
# 查询今日状态
python3 scripts/wakatime_query.py status-bar
# 查询最近 7 天的统计
python3 scripts/wakatime_query.py stats last_7_days
# 查询昨天（Asia/Shanghai）
python3 scripts/wakatime_query.py summaries --range yesterday --timezone Asia/Shanghai
# 查询特定日期范围
python3 scripts/wakatime_query.py summaries --start 2026-03-18 --end 2026-03-18
Config
Required
- WAKATIME_API_KEYWakaTime API key
Environment Example
export WAKATIME_API_KEY="your-api-key-here"
Commands
health
快速健康检查，验证 API 连接是否正常。
projects
查询项目列表，返回前 20 个项目及其统计数据。
status-bar
查询今日状态条，显示今日编码时间和活动状态。
all-time-since
查询自账号创建以来的全部统计数据。
stats <range>
查询特定时间范围的统计数据，支持以下命名范围：
last_7_days、last_30_days、last_6_months、last_year、all_time
summaries [options]
查询指定日期范围的汇总数据，支持以下选项：
时间范围选择
--start YYYY-MM-DD：开始日期（包含）--end YYYY-MM-DD：结束日期（包含）--range <preset>：预设范围yesterday：昨天today：今天last_7_days：最近 7 天last_30_days：最近 30 天all_time：全部时间
筛选条件
--project <name>：按项目筛选--branches <comma>：按分支筛选（逗号分隔）--timezone <tz>：指定时区（如Asia/Shanghai）--timeout <seconds>：API 查询超时时间
示例
# 查询昨天（Asia/Shanghai）
python3 scripts/wakatime_query.py summaries --range yesterday --timezone Asia/Shanghai
# 查询最近 30 天
python3 scripts/wakatime_query.py stats last_30_days
# 查询特定项目在最近 7 天的数据
python3 scripts/wakatime_query.py summaries --range last_7_days --project myproject
# 查询特定日期
python3 scripts/wakatime_query.py summaries --start 2026-03-01 --end 2026-03-15
Output
所有命令返回 JSON 格式数据，包含：
grand_total：总统计（时间、小时、文本）projects：项目列表（按总时间排序）languages：语言列表（按总时间排序）categories：类别列表（Browsing、Coding、Writing Docs 等）editors：编辑器列表（VS Code、IntelliJ IDEA 等）machines：机器列表dependencies：依赖包列表
Notes
- 所有请求使用 HTTP Basic Auth，
Authorization: Basic <base64(api_key)> - 只读操作，不会修改任何数据
- 时区参数影响
--range预设的日期边界 - 对于预设范围（如
yesterday、today），建议配合--timezone使用以确保日期计算正确
Troubleshooting
常见问题
- 认证失败：检查
WAKATIME_API_KEY是否正确 - 连接超时：尝试增加
--timeout参数
调试
在命令中添加 -d 或 --debug 打印 HTTP 请求详情。