Linear时间追踪功能需Pro/Enterprise订阅，启用后可手动添加或批量导入工时，支持按项目/标签分组生成并导出含明细的CSV报告。
在Linear中开启时间追踪功能，能让你精准记录每个Issue实际消耗的工时，避免靠记忆估算带来的偏差，尤其适用于需要向客户交付工时报告或内部复盘开发效率的场景。
启用时间追踪功能
登录Linear团队工作区后，点击左下角个人头像 → Settings & privacy → Billing & plans → 确认当前订阅为Pro或Enterprise计划。免费版不支持时间追踪功能，【未升级将无法看到Time Tracking选项】。
返回Settings & privacy → Workspace settings → 找到Time tracking区域 → 将Enable time tracking开关设为ON。
为单个Issue手动添加时间记录
打开任意Issue详情页，在右侧面板找到“Time”区块 → 点击“+ Add time”按钮。
在弹出框中输入：时长（支持15m、2h、3.5h等格式）、日期（默认为当天，可手动修改）、备注（可选，建议写清具体做了什么，例如“修复登录页SSO回调异常”）→ 点击Save。
这一步操作起来很简单，直接填完点保存就行；但注意：日期必须早于或等于当前日期，未来日期会被系统拒绝提交。
批量导入历史工时数据
方法一：通过CSV文件导入
准备标准CSV文件，包含三列：issue_id（Linear生成的唯一ID，如lin-12345）、duration（格式如"1h 30m"或"90m"）、date（ISO格式，如"2026-06-15"）→ 进入Workspace settings → Time tracking → 点击“Import time entries” → 上传CSV。
方法二：使用Linear API批量写入
调用POST /time_entries接口，需携带Authorization Bearer token及JSON body，其中每个条目必须含issueId、durationInMinutes、date字段 → 建议先在测试环境验证响应结构，避免因字段缺失导致整批失败。
查看与导出时间报告
第一步：点击左侧导航栏“Reports” → 选择“Time tracking”。
第二步：设置时间范围（默认最近7天）、筛选成员、按Project或Label分组 → 系统实时汇总各Issue耗时。
第三步：点击右上角“Export CSV”，下载完整明细表，含Issue标题、URL、创建人、记录人、总分钟数、日期分布等字段。
导出的CSV不含敏感权限信息，但会暴露所有已记录工时，分享前请确认接收方有对应Issue访问权限。
