Wakapi项目：如何从Wakatime导入JSON格式的心跳数据

在开发者工具生态中，Wakapi作为Wakatime的开源替代方案，为用户提供了本地化部署的时间追踪解决方案。本文将详细介绍如何将Wakatime导出的JSON格式心跳数据迁移至Wakapi系统。

数据迁移背景

许多从Wakatime迁移到Wakapi的用户面临一个共同挑战：Wakapi官方提供的Python脚本仅支持CSV格式数据导入，而Wakatime默认导出的数据格式为JSON。这种格式差异导致直接导入变得困难，特别是当用户已经无法访问原始Wakatime账户时。

解决方案分析

针对这一问题，社区开发者提出了一种基于Node.js的解决方案。该方案通过解析Wakatime导出的两种JSON文件（日常统计数据和心跳数据），并将其转换为Wakapi API兼容的格式进行批量导入。

关键技术实现

1. 数据解析：

   • 读取并解析Wakatime导出的JSON文件
   • 提取机器名称映射关系（将UUID转换为可读名称）
   • 处理每日心跳数据记录

2. 数据转换：

   • 根据文件路径识别操作系统和编辑器类型
   • 构建符合Wakapi API要求的数据结构
   • 处理特殊字段如分支、语言、项目等信息

3. 批量导入：

   • 使用Fetch API发送HTTP请求
   • 实现错误处理和日志记录
   • 确保数据完整性和导入进度跟踪

实现细节

核心转换逻辑通过分析文件路径来确定开发环境和工具信息。例如：

• Windows系统下的WebStorm项目路径
• Linux系统下的项目路径
• 其他常见开发工具和环境的识别

对于每一条心跳记录，脚本会构建包含以下信息的请求体：

• 实体路径和分支信息
• 编程语言和项目名称
• 时间戳和操作类型
• 代码行数变化等详细指标

注意事项

1. 导入前应确保Wakapi服务端配置正确
2. 建议先在测试环境验证导入脚本
3. 大规模导入时需考虑API速率限制
4. 保留原始数据和导入日志以备核查

替代方案

对于熟悉Python的用户，也可以考虑修改官方提供的CSV导入脚本，使其支持JSON格式解析。这种方法可能更适合与现有Wakapi生态系统集成。

通过这种数据迁移方案，用户可以完整保留在Wakatime中的开发活动记录，确保时间追踪数据的连续性，同时享受Wakapi提供的隐私保护和自定义功能优势。