（13000期）kimai-time-tracking – 企业级开源工时追踪管家

企业级开源工时追踪管家 基于 Kimai 开源时间追踪平台的完整 API 集成方案，支持工时记录、项目管理、发票生成等全流程，助力团队高效追踪与分析工作时间。 使用说明 核心用法 Kimai Time Tracking Skill 提供了 Kimai 开源时间追踪软件的完整 REST API 封装，通过 kimaicli.py 命令行工具实现全功能操作。核心工作流包括三大场景：快速计时（启动/停止/重启计时器）、数据管理（客户-项目-活动层级创建与维护）、以及导出开票（标记导出状态、生成发票）。用户可通过环境变量配置 KIMAIBASEURL 和 KIMAIAPI_TOKEN 完成认证，支持 JSON、表格、CSV 三种输出格式，所有列表操作自动处理分页。 显著优点 功能完整性：覆盖 Kimai 全部核心实体（timesheets/customers/projects/activities/teams/invoices/users），支持从个人计时到团队权限管理的全场景。 安全设计：删除操作强制确认并展示级联影响，API Token 通过 Bearer 头部传输且不记录，文件导出权限限制为 600。 零依赖：仅使用 Python 标准库，无第三方包引入，部署简单且规避供应链风险。 工作流友好：recent 命令快速复用最近工作组合，，duplicate 支持条目复制，，--dry-run 便于测试验证。 来源可信：来自 openclaw 组织（2,353 Stars），代码规范且文档详尽。 潜在缺点与局限性 网络依赖：必须连接 Kimai 服务器，无法离线使用。 学习成本：需理解 Kimai 的实体关系（客户→项目→活动层级）才能高效使用。 权限配置复杂：不同操作需申请不同 API 权限，管理员需仔细规划角色。 自动化风险：--force 参数可跳过删除确认，误用可能导致数据丢失。 无内置缓存：每次查询均实时请求 API，高频操作可能影响性能。 适合的目标群体 使用 Kimai 进行工时管理的开发团队、咨询公司、自由职业者 需要自动化工时报表和发票生成的财务/运营人员 希望将时间追踪集成到 CI/CD 或内部工具链的技术团队 多项目管理场景下的团队负责人和项目经理 使用风险 数据级联删除：删除客户会级联删除其下所有项目、活动和工时记录，确认提示需仔细阅读。 Token 泄露风险：API Token 权限较大，环境变量配置不当可能导致未授权访问。 服务器信任：所有数据发送至配置的 Kimai 服务器，需确保 BASE_URL 指向可信实例。 并发冲突：若 Kimai 配置禁止重叠工时，同时启动多个计时器会返回 409 冲突错误。 原始说明 Complete Kimai time-tracking API integration. Manage timesheets, customers, projects, activities, teams, invoices and exports via REST API. Supports time tracking workflows, reporting, and administrative operations. Keywords - kimai, zeiterfassung, timesheet, tracking, project, customer, activity, invoice, export, timer, stunden