SuperAPI AI 工具集

time-tracking

通用与其它

查看项目

更新于 10-16 00:20

技能介绍

用途:通过统一脚本 scripts/track 管理时间追踪,支持 Toggl(默认)与 Clockify 两个服务,覆盖实时计时、工时记录、条目查看与项目标签管理。

主要能力:实时追踪可用 scripts/track start "任务描述" -p "项目名" 启动计时,scripts/track stop 停止,scripts/track current 查看当前条目;切换服务加 -P clockify。手动补录历史条目用 scripts/track create "描述" -p "项目" -s "YYYY-MM-DD HH:MM" -e "YYYY-MM-DD HH:MM",可加 -t "tag1,tag2" 指定标签。管理操作包括 scripts/track delete、scripts/track entries --days 7、scripts/track projects、scripts/track me。项目与标签(仅 Toggl)支持 scripts/track project:create "项目名",可加 -b 标记可计费、--private 设为私有,以及 scripts/track tags。

使用方式:所有操作均通过 scripts/track 执行,运行 scripts/track --help 查看完整用法。项目名称必须完全匹配,可先用 projects 列出可用名称。认证通过 1Password 完成:Toggl 使用 op://Employee/Toggl/api key,Clockify 使用 op://Employee/Clockify/Saved on app.clockify.me/apikey。API 令牌会缓存到 ~/.local/state/steveos/time-tracking/ 24 小时,避免重复弹出 1Password 提示。

缓存管理:scripts/track cache:clear 清除当前服务令牌,scripts/track cache:clear:all 清除全部缓存令牌,适用于在 1Password 中轮换 API 密钥或需要重新认证时。

限制:项目与标签的创建仅支持 Toggl;Clockify 仅支持计时与条目相关操作。项目名称需精确匹配。资料未提供价格、平台支持范围及更多错误处理细节。