refactor: 完成 0.4.0 版本更新

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

src/heurams/kernel/puzzles/base.py

@@ -0,0 +1,16 @@
+# base.py
+from heurams.services.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+class BasePuzzle:
+    """谜题基类"""
+
+    def refresh(self):
+        logger.debug("BasePuzzle.refresh 被调用（未实现）")
+        raise NotImplementedError("谜题对象未实现 refresh 方法")
+
+    def __str__(self):
+        logger.debug("BasePuzzle.__str__ 被调用")
+        return f"谜题: {type(self).__name__}"