工时统计指南
最后更新 · 内容随产品迭代同步，界面差异以实际为准
工时系统帮你记录「每个任务、每天花了多少时间」，并自动汇总成项目工时统计、偏差分析和可下载的报表。工时功能默认关闭，由项目创建者 / 负责人手动开启。
开启工时功能
- 进入项目，打开项目设置（项目名旁的 ⚙️ 图标）；
- 勾选 开启工时统计，确定。
开启后：任务详情出现「工时」区块，项目概览出现「工时统计」卡片；老项目默认关闭，不影响原有任务。
截图待补：项目概览的「工时统计」卡片（本期工时/预估/参与人数/偏差率四数字）——建议文件名
timesheet-card.png
三个填工时的入口
入口 1：周工时表（推荐，主力录入）
位置：项目概览 → 工时统计卡 → 我的周工时表。打开后是一个周历网格：行是任务，列是本周一到周日，每个格子直接填当天该任务投入的小时数。
- 填写：点格子输入数字（如 3.5，支持 0.5 步进），回车或点别处自动保存，Esc 放弃；
- 删除：清空格子再点别处即删除当天记录；
- 工具条：项目下拉只看某项目；‹ 本周 › 切换周；「本周计划 / 全部任务」切换任务范围；支持按任务名 / 项目名搜索；
- 周末格子浅色底、今天列蓝色描边，右上角显示本周合计；点任务名可直接打开任务详情。
入口 2：任务详情工时区块
打开任意任务详情，下半部分即「工时」区块：
- 预估工时：计划花多少小时（仅任务负责人 / 项目管理者可改）；
- 实际工时：已记录工时自动累加；
- 添加工时记录：日期 + 工时 + 可选描述，每条可删除（仅本人记录可删）；
- 父任务额外显示「含子任务累计」。
入口 3：完成任务时顺手填
在完成任务的确认弹窗中：本次工时（选填）会累加到实际工时；任务还没设过预估时会同时出现预估工时补填项。留空也能完成任务——工时是可选的。
预估工时与偏差率
工时系统最有价值的分析是「计划 vs 实际」的偏差：
| 指标 | 含义 |
|---|---|
| 预估工时 | 你计划花多少时间（填在任务详情） |
| 实际工时 | 真实记录的小时数 |
| 偏差率 | (实际 − 预估) / 预估，正值超支、负值节省 |
| 预估覆盖率 | 如 12/30 (40%)：有多少任务填了预估 |
预估要填在叶子任务上（父任务预估会单独计入总计，父子都填会重复）。偏差率只在「有预估的任务」上计算——覆盖率过低时显示「—」是系统在诚实告诉你「数据不够」，补填后自然恢复。
看项目工时统计
- 工时统计卡（项目概览）：随周期选择（今天/本周/本月/本季/本年/全部）联动，显示本期工时、预估工时、参与人数、工时偏差率，附成员工时排行；
- 工时详细统计（卡片右上 ⛶ 全屏）：趋势图按天/月/季/年聚合、按任务与成员工时明细、可排序可下钻；
- 导出 Excel 报表：含 4 个工作表——工时明细、人员汇总、任务汇总、工时趋势。
谁能看到什么
工时数据始终是个人的——你看到的数字都是你自己记录的。区别只在「能看到哪些任务行」：
| 角色 | 周工时表可见任务 |
|---|---|
| 普通参与者 | 仅自己负责的任务 |
| 项目负责人 / 创建者 | 自己管辖项目的全部任务（便于统筹 / 代记） |
| 系统管理员 | 全部工时已开启项目的全部任务 |
即使是管理员，在别人任务上记的工时也记在自己名下；团队整体分布看工时统计卡 / 全屏统计 / Excel 报表。
常见问题
偏差率显示「—」？
预估覆盖率不足（<50%）。补填任务预估后自动恢复。
周工时表找不到某个任务？
默认只显示「本周计划内 + 未完成」的任务。切到「全部任务」或用搜索框；已完成的任务除非本周已有记录，否则不显示。
完成任务时填的工时和周工时表冲突吗？
不冲突。完成时填的会累加到实际工时；周工时表格子以「当天该任务总工时」为准（覆盖），两者都汇总到任务实际工时，不会重复计算。
关掉工时功能后数据会丢吗？
不会。关闭只是隐藏界面、禁止新录入，已记录数据保留，重新开启即恢复。
快速上手 3 步
- 项目设置 → 勾选「开启工时统计」；
- 项目概览 → 工时卡 → 我的周工时表 → 在网格里填本周每天的任务工时；
- （可选）任务详情填预估工时 → 工时卡自动出偏差率 → 全屏统计导出 Excel。