hledger项目中的Timedot时间单位自定义方案探讨

在时间追踪领域，Pomodoro（番茄工作法）已成为一种广受欢迎的方法。许多用户习惯于以"Pomodoro"为单位来记录时间投入，而非传统的小时或分钟。本文深入探讨了在hledger的timedot格式中实现自定义时间单位的多种技术方案。

当前timedot格式的基本原理

hledger的timedot文件本质上记录的是无单位的数值。默认情况下：

• 一个点(.)表示0.25单位
• 数字直接表示对应数值
• 特殊字母表示时间单位（如m=分钟，h=小时）

现有解决方案分析

方案一：通过主文件包含timedot

通过创建journal主文件来包含timedot文件，并定义单位转换：

D 1.00 pomodoro       ; 定义默认单位
P 0000-01-01 pomodoro 25m  ; 定义转换率
include a.timedot

这种方式的优势在于：

1. 保持了timedot文件的简洁性
2. 利用hledger现有的单位转换功能
3. 支持-V参数自动转换显示单位

方案二：纯数值记录

D 1. pomodoro
P 0000-01-01 pomodoro 25m
include a.timedot

在timedot中直接记录整数：

2024-01-01
task1  1
task1  1

这种方式更直观，但失去了timedot特有的点记法便利性。

技术挑战与边界情况

在实践过程中发现了一些需要注意的技术细节：

1. 单位重定义的影响：当重定义默认单位后，所有时间单位的解释都会相应变化。例如将单位设为25分钟后：

   • "30m"会被解释为12分钟（因为m表示0.5单位）
   • "1d"会被解释为600分钟

2. 格式扩展的可能性：

   • 扩展timeUnits列表支持自定义单位（需硬编码）
   • 引入标记值系统（如"pp"表示两个Pomodoro）

未来改进方向

基于讨论，可能的改进方向包括：

1. 字符扩展方案：

   • 引入新字符(如'单引号)表示1单位
   • 保持.表示0.25单位
   • 形成大小写对应关系（大写=1单位，小写=0.25单位）

2. 格式声明扩展：

   • 在timedot文件中支持类似CHAR = HLEDGERAMT的声明
   • 允许用户自定义字符对应的数值

3. 单位系统重构：

   • 将timeUnits列表移至JournalParser对象
   • 支持通过指令动态添加单位类型

最佳实践建议

对于当前需要记录Pomodoro的用户，推荐采用以下工作流程：

1. 创建主journal文件定义单位和转换率
2. 在包含的timedot文件中使用整数记录
3. 通过脚本或编辑器宏实现快速追加记录

这种方案在保持现有系统稳定性的同时，提供了足够的灵活性来满足特殊计时需求。

总结

hledger的timedot格式为时间追踪提供了简洁高效的记录方式。虽然目前对完全自定义单位的支持有限，但通过巧妙的journal文件配置已经能够实现基本需求。未来的格式扩展需要在保持简洁性和增强灵活性之间找到平衡点，这需要开发者社区的进一步讨论和探索。