4. 时间追踪基础：手动记录工时、批量录入工时、编辑与删除工时记录

时间追踪是Tempo复盘与证据留存的基石。本章聚焦于Tempo中四种最核心的工时操作：手动单条记录、批量录入、编辑已有记录以及删除错误或冗余记录。掌握这些基础操作，能确保你在复盘时拥有干净、准确的时间数据源。

4.1 手动记录工时：单条精准录入

手动记录适用于临时任务、突发支持或需要精确到分钟的场景。操作路径通常为：项目面板 → 工作日志 → 记录工时。

4.2 批量录入工时：高效处理重复场景

当需要为同一任务连续多天录入工时，或为多个子任务分配相同时间时，批量录入可大幅提升效率。Tempo提供两种批量模式：

• 按日期批量：选定一个任务，一次性录入多天的工时（如过去一周每天1h）。
• 按任务批量：选定多个任务，为每个任务录入相同或不同的工时，一次性提交。

// 批量录入示例（Tempo REST API 简化示意）
POST /rest/tempo-timesheets/4/worklogs/bulk
{
  "worklogs": [
    {
      "issueKey": "PROJ-123",
      "timeSpentSeconds": 3600,
      "startDate": "2025-03-18",
      "description": "每日站会"
    },
    {
      "issueKey": "PROJ-123",
      "timeSpentSeconds": 3600,
      "startDate": "2025-03-19",
      "description": "每日站会"
    }
  ]
}

4.3 编辑与删除工时记录

错误记录必须及时修正，否则会污染复盘数据。编辑和删除操作需遵循以下原则：

4.4 工时操作流程总览

下图展示了从记录到修正的完整闭环，帮助你在日常操作中建立清晰的流程意识。

4.5 操作对比与选择策略

不同场景下选择哪种录入方式，直接影响效率和数据质量。下表给出了明确的决策依据：