用途：通过 Pipa 通用智能体工具记录（generic agent utility records）实现 Toggl 风格的时间追踪，用于开始、停止、切换、查看、补录、更新、归档或汇总工时。仅使用 time_tracking/time_entry 记录，不使用 Clockify、Toggl、截图、工资单、发票、生产力评分、被动活动重建或 /v1/time-tracking/* 包装端点。
主要能力：支持 start（开始计时）、switch（切换工作）、stop（停止当前计时）、current（查询正在运行）、backfill（补录过去时间）、review（查看/汇总条目）、update/archive（更新/删除/取消/归档）、top-up（购买积分）。
使用方式：需先加载凭据 PIPA_API_BASE_URL、PIPA_API_KEY、PIPA_EMAIL、PIPA_USER_TIMEZONE，别名 PIPA_FOLLOW_UP_API_KEY、PIPA_FOLLOW_UP_EMAIL 可映射，规范值优先。查找顺序为网关注入值、环境变量、仓库本地 .pipa/credentials、用户全局 ~/.pipa/credentials；隐藏路径需直接读取，不能依赖 glob。凭据文件为 dotenv 格式。API 仅使用 GET/POST /v1/agent-utility-records、GET/PATCH/DELETE /v1/agent-utility-records/:id、POST /v1/key/email-code/start、POST /v1/key/email-code/verify、POST /v1/topups/checkout-sessions。认证头为 Authorization: Bearer ${PIPA_API_KEY}。
限制：同一用户仅允许一个未归档的 running 条目；running 需 started_at 且省略 ended_at，completed 需 started_at 与 ended_at 且 ended_at >= started_at；删除即归档，非硬删除。不支持工资单、发票、截图、被动重建、外部追踪器同步、重复计时器、自动空闲检测。无法直接查询积分余额，除非允许的响应包含 credits_remaining。时间追踪费用为 10 Pipa 积分/30 天，无自动续费。缺失事实暂未提供。