OpenToggl

OpenToggl 是一款免费、开源且注重隐私的时间追踪服务，旨在成为 Toggl Track 的完美替代方案。它不仅解决了 Toggl 高昂的订阅费用和严格的 API 限制问题，更通过完全兼容 Toggl API 的设计，让用户能够无缝迁移数据，同时享受自托管带来的数据主权和与 AI Agent 的深度集成能力。

为什么选择 OpenToggl？

1. 真正的数据主权与隐私

• 自托管 (Self-Hosted)：你可以将 OpenToggl 部署在自己的家庭服务器、NAS（如群晖、TrueNAS、CasaOS/ZimaOS）或任何 VPS 上。
• 数据私有：所有时间记录数据完全存储在你的控制之下，不再担心第三方云服务的隐私泄露或数据锁定。

2. 为 AI Agent 而生

• 无 API 限制痛点：Toggl 免费版限制每小时仅 30 次 API 调用，这对于高频交互的 AI Agent 来说远远不够。OpenToggl 去除了这一限制，允许 AI 助手自由地记录、查询和分析你的时间数据。
• AI 辅助复盘：结合 toggl-cli，你可以让 AI 帮你自动记录时间、生成周报，甚至应用柳比歇夫时间管理法来分析“时间黑洞”，优化工作效率。

3. 零成本迁移与兼容

• API 完全兼容：OpenToggl 完美兼容 Toggl Track API v9 和 Report API v3。
• 无缝切换：现有的 Toggl 客户端、第三方应用和工作流无需修改即可连接到 OpenToggl。支持数据的导入与导出，实现从 Toggl 到 OpenToggl 的“零损失”迁移。

4. 现代化的多端体验

• PWA 支持：Web UI 采用 Progressive Web App (PWA) 技术，支持在 iOS 和 Android 手机上“添加到主屏幕”，获得接近原生 App 的体验。
• 离线可用： roadmap 中计划支持离线使用，确保在网络不佳时也能记录时间。

核心功能与特性

快速开始：自托管部署

OpenToggl 推荐使用 Docker Compose 进行部署，过程简单快捷。

1. 准备环境

确保你的服务器上已安装 Docker 和 Docker Compose。

2. 创建 docker-compose.yml

参考官方文档创建配置文件，典型配置如下：

version: '3'
services:
  opentoggl:
    image: correctroadh/opentoggl:latest
    ports:
      - "8080:80" # 映射端口
    volumes:
      - ./data:/app/data # 持久化数据
    environment:
      - TZ=Asia/Shanghai # 设置时区
    restart: unless-stopped

3. 启动服务

docker compose up -d

4. 访问与配置

浏览器访问 http://your-server-ip:8080，注册账号并开始使用。

AI 集成示例：配合 toggl-cli

你可以使用社区维护的 toggl-cli 工具，结合 AI 助手自动化时间管理：

1. 安装 CLI：

   # 假设使用 pip 或 go install，具体参考 toggl-cli 仓库
   pip install toggl-cli-opentoggl 
   

2. 配置 API Token：
   在 OpenToggl 后台生成 API Token，并配置到 CLI 中。
3. AI 交互：
   • “帮我记录过去一小时我在写 Python 代码。” -> AI 调用 API 创建时间条目。
   • “总结我本周在项目 A 上花费的时间。” -> AI 调用 Report API 生成摘要。
   • “分析我上周的时间分布，找出效率低下的时段。” -> AI 分析数据并提供建议。

🗺️ 开发路线图 (Roadmap)

• ✅ API 兼容：Track v9 和 Report v3 完全兼容
• 🚧 Web UI：实现与 Toggl Track 网页版一致的用户体验
• 📱 移动端 PWA：优化手机端体验，支持离线记录
• 🔮 OpenToggl Focus：专注模式，类似番茄钟
• 🔮 OpenToggl Plan：时间规划与日程安排功能