Vikunja项目：从Todoist迁移任务数据的完整指南

前言

对于使用Todoist的用户来说，当需要迁移到开源任务管理平台Vikunja时，数据迁移是一个关键步骤。本文将详细介绍如何安全、完整地将Todoist中的任务数据迁移到Vikunja平台。

准备工作

在开始迁移前，请确保：

1. 你的Vikunja实例已经部署完成并可公开访问
2. 拥有Todoist账户的管理权限
3. 建议暂时关闭Todoist中的周期性任务设置（迁移完成后可重新启用）

第一步：创建Todoist开发者应用

1. 登录Todoist账户，进入"设置"→"集成"→"开发者"→"构建集成"
2. 点击"创建新应用"
3. 填写应用信息：
   • 应用名称：vikunja
   • 应用服务URL：你的Vikunja实例地址（如https://vikunja.yourdomain.com）

第二步：配置应用参数

创建应用后，需要配置以下关键参数：

• 客户端ID：用于后续Vikunja配置
• 客户端密钥：用于身份验证
• OAuth重定向URL：必须设置为你的Vikunja地址/migrate/todoist
• 确认应用名称和服务URL

配置完成后，点击"保存设置"，然后在"安装"部分选择"为我安装"。

第三步：验证集成

返回Todoist的"设置"→"集成"页面，在"已安装"部分应能看到名为"vikunja"的应用，这表示集成已成功设置。

第四步：配置Vikunja

在Vikunja的部署环境（如docker-compose.yml）中添加以下环境变量：

environment:
  VIKUNJA_MIGRATION_TODOIST_ENABLE: true
  VIKUNJA_MIGRATION_TODOIST_CLIENTID: 你的客户端ID
  VIKUNJA_MIGRATION_TODOIST_CLIENTSECRET: 你的客户端密钥
  VIKUNJA_MIGRATION_TODOIST_REDIRECTURL: 你的重定向URL

配置完成后，重启Vikunja容器使设置生效。

第五步：执行迁移

1. 登录Vikunja网页界面
2. 点击右上角头像，选择"设置"
3. 进入"从其他服务导入"选项
4. 点击Todoist图标开始迁移

迁移过程通常在几秒到几分钟内完成，具体时间取决于任务数量。

迁移后操作

1. 验证所有任务是否完整迁移
2. 确认周期性任务设置（如有需要可重新启用）
3. 建议移除Todoist中的集成应用
4. 从Vikunja配置中删除迁移相关的环境变量

常见问题解决

如果遇到"redirect_uri_not_configured"错误，请检查：

• Todoist开发者控制台中的OAuth重定向URL是否正确
• 该URL是否可公开访问
• URL是否以/migrate/todoist结尾

最佳实践建议

1. 迁移前在Todoist中导出备份
2. 先进行小规模测试迁移
3. 迁移完成后，在Vikunja中检查任务分类和标签是否完整
4. 考虑在非高峰期执行大规模迁移

通过以上步骤，用户可以顺利完成从Todoist到Vikunja的任务数据迁移，享受开源任务管理平台带来的灵活性和可控性。