从 Toggl 迁移到 OpenTickly

Toggl Track 的数据可以直接导入，不用手动重建。分两步：先导入账号导出的 ZIP，拿到工作区、项目、客户、标签和成员；再导入时间记录 CSV，拿到具体的时间记录。

迁移前准备Copy Anchor Link

1. 创建或登录目标 OpenTickly 账号。
2. 如果是自托管，确认服务器磁盘空间够用。
3. 定一个切换时间，之后就别在 Toggl 里记了，免得两边都有新记录。
4. 记下每个 CSV 对应的工作区和日期范围。

第一步：导出 Toggl 账号数据Copy Anchor Link

打开 Toggl Track 设置，申请导出账号数据。下载 ZIP，里面的文件不要动。

导入后会在 OpenTickly 里新建一个组织：

1. 在 OpenTickly 打开 导入。
2. 输入新组织名称。
3. 选择 Toggl 导出 ZIP。
4. 开始导入，等它提示成功或失败。

导入在后台进行。还没导完的时候，不要重复上传同一个 ZIP。

第二步：导入详细时间记录Copy Anchor Link

在 Toggl 里按需要的日期范围，把详细时间记录导出成 CSV。然后回到 OpenTickly 的 导入 页面：

1. 选择要导入到哪个组织和工作区。
2. 选择一个或多个 CSV 文件。
3. 上传，等每个文件都导完。
4. 要给另一个工作区导入时，先确认选中的是对的工作区。

文件名可以写上工作区和日期范围，比如 consulting-2025-q4.csv，漏了哪段、重复了哪段一眼就能看出来。

核对结果Copy Anchor Link

正式在 OpenTickly 里记时间之前：

• 对比组织和工作区名称。
• 抽查几个客户、项目、标签和成员。
• 在 报表 里挑一天、一周、一个月，和 Toggl 对比总时长。
• 检查正在计时的记录和跨过午夜的记录。
• 抽几条记录，核对是否计费、时长、描述、项目、成员和标签。
• 如果导入失败，先把报错信息复制下来，再重试或提 Issue。

对比报表总时长是最快的检查办法，漏了日期、导错工作区、同一个 CSV 导了两遍，都能看出来。

正式切换Copy Anchor Link

数字对上之后，通知团队以后都在 OpenTickly 里记。Toggl 导出文件和 OpenTickly 的数据库备份先留一段时间，万一要退回去还用得上。

接下来可以看快速上手了解日常用法，或看 API 兼容说明把脚本和集成切过来。

切换前先按备份、恢复与升级做好备份，需要时才能恢复 OpenTickly 实例。如果要把记录导回 Toggl，请看导出数据中的 CSV 整理步骤和限制。