Wakapi项目数据清理与维护指南

数据清理需求背景

在使用自托管的时间追踪工具Wakapi时，长期积累的项目数据可能会包含一些不再需要的记录。特别是对于从2015-2016年开始使用Wakatime并迁移数据的用户，系统中可能存在大量过时或无效的项目信息。这些冗余数据不仅占用存储空间，还可能影响系统性能和数据统计的准确性。

当前解决方案的技术实现

目前Wakapi尚未提供图形界面删除特定项目或心跳数据的功能，但可以通过直接操作数据库来实现数据清理。以下是详细的技术实现方案：

1. 删除特定项目的心跳数据

执行SQL语句删除指定项目的所有心跳记录：

DELETE FROM heartbeats WHERE project = '项目名称';

2. 清理汇总缓存数据

由于Wakapi会缓存汇总数据以提高查询性能，删除基础数据后需要同步清理缓存：

-- 清空汇总主表
DELETE FROM summaries WHERE true;

-- 清空汇总项表
DELETE FROM summary_items WHERE true;

-- 清除用户首次心跳记录
DELETE FROM key_string_values WHERE key = 'first_heartbeats_用户名';

注意：在MySQL中，key是保留字，需要使用反引号转义：

DELETE FROM key_string_values WHERE `key` = 'first_heartbeats_用户名';

3. 重新生成数据汇总

完成数据库操作后，需要在Wakapi管理界面执行以下操作：

1. 进入"设置" -> "危险区域"
2. 点击"清除并重新生成汇总数据"

对于包含数万条心跳记录的系统，此过程可能需要30分钟或更长时间完成。

技术注意事项

1. 数据一致性：直接操作数据库存在风险，建议先备份数据库
2. 性能影响：大规模数据删除和汇总重建会显著增加系统负载
3. 时间消耗：数据量越大，处理时间越长，应考虑在低峰期操作
4. 用户隔离：多用户系统中，操作前应确认SQL条件准确限定目标用户

未来功能展望

Wakapi开发团队已认识到此需求的重要性，相关功能已在开发计划中。预期未来版本将提供：

• 图形化界面选择删除特定项目或时间段数据
• 更高效的数据清理和重建机制
• 操作前预览和确认功能
• 批量处理能力

对于需要频繁维护数据的用户，建议关注项目更新动态，及时升级到包含官方数据管理功能的版本。