工时记录管理

技能简介

通过命令行控制 timesheet.io 的时间追踪功能，支持计时器操作、项目与任务管理、团队标签维护及数据报表导出。

能做什么

• 启动/暂停/停止计时器，自动创建任务记录
• 管理项目：创建、更新、删除及设置计费属性
• 手动录入或修改历史任务的时间与描述
• 按日/周/月生成时间汇总报告
• 导出 Excel 或 CSV 格式工时数据
• 管理团队成员与任务标签分类

使用说明

安装要求

需预先安装 timesheet CLI 工具：

# macOS
brew install timesheet

# Linux
curl -fsSL https://timesheet.io/install.sh | sh

# 验证安装
timesheet --version

配置认证

首次使用需完成身份验证：

# 检查登录状态
timesheet auth status --json

# 交互式登录
timesheet auth login

# 或设置 API 密钥（自动化场景）
export TIMESHEET_API_KEY=ts_your.apikey

基础工作流

1. 查看项目列表获取 ID：timesheet projects list --json
2. 启动计时器：timesheet timer start <project-id>
3. 工作完成后停止并生成任务：timesheet timer stop
4. 查看今日工时：timesheet reports summary --today --json

快速录入历史记录

timesheet tasks create -p <project-id> -s "09:00" -e "17:00" -d "开发工作" --json

导出月度报表

timesheet reports export -f xlsx --this-month

输入与输出

见下方输入与输出表格。

风险提示

• API 密钥需妥善保管，避免硬编码在脚本中
• 网络异常时可能产生重复计时记录，建议定期核对
• 删除项目或任务后数据不可恢复
• 速率限制触发时需等待后重试

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/florianrauscha/timesheet/SKILL.md
来源类型：GitHub 仓库