refactor: 完成 0.4.0 版本更新

完成 0.4.0 版本更新, 为了消除此前提交消息风格不一致与错误提交超大文件的问题, 维持代码统计数据的准确性和提交消息风格的一致性, 重新初始化仓库; 旧的提交历史在 HeurAMS-legacy 仓库(https://gitea.imwangzhiyu.xyz/ajax/HeurAMS-legacy)

src/heurams/services/timer.py

@@ -0,0 +1,31 @@
+# 时间服务
+from heurams.context import config_var
+import time
+from heurams.services.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+def get_daystamp() -> int:
+    """获取当前日戳(以天为单位的整数时间戳)"""
+    time_override = config_var.get().get("daystamp_override", -1)
+    if time_override != -1:
+        logger.debug("使用覆盖的日戳: %d", time_override)
+        return int(time_override)
+
+    result = int((time.time() + config_var.get().get("timezone_offset")) // (24 * 3600))
+    logger.debug("计算日戳: %d", result)
+    return result
+
+
+def get_timestamp() -> float:
+    """获取 UNIX 时间戳"""
+    # 搞这个类的原因是要支持可复现操作
+    time_override = config_var.get().get("timestamp_override", -1)
+    if time_override != -1:
+        logger.debug("使用覆盖的时间戳: %f", time_override)
+        return float(time_override)
+
+    result = time.time()
+    logger.debug("获取当前时间戳: %f", result)
+    return result