用途：通过 HTTPS 调用 https://api.clockify.me/api/v1 管理 Clockify 时间追踪，不要假设本地存在 clockify_tracker 二进制文件。
认证与配置：请求使用 X-Api-Key 头，POST 使用 Content-Type: application/json。API key 按优先级解析：环境变量 CLOCKIFY_API_KEY；CLOCKIFY_API_KEY_FILE 指向的文件；shell 配置文件（~/.zshrc、~/.zprofile、~/.bashrc、~/.bash_profile、~/.profile）中的赋值；prefs 文件中的 api_key。均未找到则请用户粘贴。不得回显或记录密钥。环境变量包括 CLOCKIFY_API_KEY、CLOCKIFY_API_KEY_FILE、CLOCKIFY_PREFS_PATH（默认 ~/.clockify-prefs.json）、CLOCKIFY_TZ_OFFSET（整数小时 UTC 偏移）。
主要能力与用法：GET /workspaces 列出工作区；GET /workspaces/{workspaceId}/projects?page-size=5000 列出项目；POST /workspaces/{workspaceId}/time-entries 创建条目，字段含必填 start（ISO 8601 UTC，如 2025-03-25T12:00:00.000Z）、description，可选 billable、end（省略则为进行中）、projectId。用户给本地 HH:mm 时按 tzOffset 换算为 UTC，并序列化为带 Z 的 UTC 时间；多天范围每天各发一次 POST，未给年份默认当年。
日志模式：由“use logs / from work logs / usa los logs / auto-fill from logs”等触发。流程：读取 prefs；首次运行问活跃仓库与对应 Clockify 项目并解析项目 ID；询问时间范围；读取 ~/.work-log/YYYY-MM-DD.md，解析 ## HH:MM - … (branch) 头提取根仓库名；确认时间段（默认 09:00–17:00）；选择时区；将仓库映射到项目，未知仓库批量询问一次；按项目拆分多项目日的小时数；生成两句摘要；以编号列表预览并确认后逐条创建条目；成功后询问或按 auto_cleanup 删除已处理日志，仅全部发布成功的文件才删除。prefs 文件需合并写入而非整体替换。
限制：非成功状态需读取响应体调整（无效 ID、权限、格式错误），官方参考为 Clockify API 文档。资料未提供更多错误码细节、本地时间推断的自动能力、其他端点或计费与价格信息。