技能介绍

要解决什么问题

当你需要在聊天或自动化流程里查询 Everhour 里正在跑的计时器、为某个任务补一条工时记录，或者翻查项目和任务清单时，直接操作 API 意味着你得自己管理 API token、拼接请求、处理分页和错误重试。这个技能通过 OOMOL 托管凭证，把 Everhour 的操作收敛成一组预定义动作，你只需要构造符合 schema 的 --data 参数即可。

技能如何工作

核心是 OOMOL 注入凭证 + oo CLI 调用 everhour connector。服务端注入 token，本地永远拿不到原始凭证，这对放在共享环境或 CI 里使用是个实际的安全加分。

关键步骤：

先查契约再构造参数：执行 oo connector schema 拿到权威的输入输出 schema，不要凭感觉拼 payload
运行动作：用 --data 传 JSON（或 @path/to/file.json），留空则发 {}
读取回执：响应结构是 { "data": ..., "meta": { "executionId": "..." } }，执行 ID 在 meta.executionId

覆盖的 12 个动作分三类：

查询类（get_current_timer、get_current_user、get_project、get_task、list_projects、list_project_tasks、list_time_records、list_users、search_tasks）：只读，可直接执行
计时类（start_timer、stop_timer）：改变 Everhour 的计时状态
写入类（create_time_record）：创建一条带时长、日期、可选任务或人员归属的工时记录

适用边界与注意点

写操作要确认：create_time_record、start_timer、stop_timer 这类会改动 Everhour 数据的动作，执行前必须和用户确认具体 payload 与影响
当前没有删除类动作：12 个动作里不包含 delete/remove，所以不必处理破坏性删除，但也不要假设以后永远不会加
首次配置是一次性的：只有命令真的报 auth 或连接错误时才走 oo auth login 或重新连接 Everhour（auth type: API key），不要每次调用都重来一遍
额度耗尽会卡住：遇到 HTTP 402 / OOMOL_INSUFFICIENT_CREDIT 属于账单问题，先充值再重试，不是技术故障

它解决的是「免凭证、免胶水代码地操作 Everhour」，不解决 Everhour 本身的团队管理、报表或计费问题。