fix(工时): 按中国工作日历统计正常耗时

docs/workflow.md

@@ -233,3 +233,10 @@ Implementation convention:
 - 非工作日只提示，不阻止保存；调休工作日按工作日提示。
 - 测试用例计划测试时间字段为 `plannedTestAt`；Bug 计划修复时间字段为 `plannedFixAt`。
 - 测试轮次复制用例时保留计划测试时间、AI 预估和执行预估，清空实际执行记录。
+
+## 工时统计口径
+
+- 正常任务耗时使用 `calcWorkHours` / `calcActualElapsedHours`，按中国工作日历和 9:00-12:00、13:00-18:00 工作时段计算。
+- 法定节假日和周末不计入正常任务耗时；调休上班日计入正常任务耗时。
+- AI 预估工时和手填执行预估工时本身是小时数，不再按日期过滤；只有从计划起止时间自动推导的执行预估会按工作日历计算。
+- 加班记录使用 `overtime.calcDuration`，按加班单开始/结束时间直接计算，不受节假日过滤。