Clockify Backup Template

工作流名称

Clockify Backup Template

主要功能和亮点

该工作流实现了自动从 Clockify 获取详细的月度时间记录报告，并将报告数据备份到 GitHub 仓库中。它支持备份最近三个月的时间数据，自动判断 GitHub 中对应报告文件是否存在，智能更新已有文件或创建新文件，确保数据的完整性和历史准确性。

解决的核心问题

Clockify 的时间记录数据可能会随着时间发生变更（如标签调整），直接依赖在线数据存在数据丢失或篡改风险。此工作流通过定期备份 Clockify 报告至 GitHub，实现时间数据的版本化存储和安全备份，解决数据持久化和历史追溯问题。

应用场景

• 需要长期保存和管理时间记录数据的自由职业者、团队和企业
• 希望对工作时间数据进行版本控制和历史分析的项目管理者
• 需要自动化备份工作流程，减少手动操作风险的技术团队

主要流程步骤

1. 定时触发（每天5点执行）启动工作流。
2. 获取第一个可用的 Clockify 工作空间ID。
3. 设置备份时间范围（默认最近三个月的每月起止时间）。
4. 针对每个月调用 Clockify 报告 API，获取详细时间条目数据。
5. 检查 GitHub 仓库中对应月份的报告文件是否存在。
6. 如果文件存在，提取并比较新旧数据差异，更新文件内容。
7. 如果文件不存在，直接新建文件保存报告数据。
8. 过滤空报告，避免无效文件生成。
9. 处理可能出现的错误并停止异常流程。

涉及的系统或服务

• Clockify API：获取时间记录及详细报告
• GitHub API：检查、创建及更新报告文件
• n8n 调度触发器：定时执行自动化任务

适用人群或使用价值

该工作流适用于使用 Clockify 进行时间管理且重视数据安全与版本控制的个人及团队。自动化备份确保重要的时间记录数据不会丢失，同时利用 GitHub 进行版本管理，方便后续查询和审计，极大提升时间数据的管理效率和可靠性。