refactor: 完成 0.4.0 版本更新

完成 0.4.0 版本更新, 为了消除此前提交消息风格不一致与错误提交超大文件的问题, 维持代码统计数据的准确性和提交消息风格的一致性, 重新初始化仓库; 旧的提交历史在 HeurAMS-legacy 仓库(https://gitea.imwangzhiyu.xyz/ajax/HeurAMS-legacy)
2025-12-17 22:31:38 +08:00
commit 16c22cf207
89 changed files with 6112 additions and 0 deletions
--- a/src/heurams/kernel/algorithms/sm2.py
+++ b/src/heurams/kernel/algorithms/sm2.py
@@ -0,0 +1,126 @@
+from .base import BaseAlgorithm
+import heurams.services.timer as timer
+from typing import TypedDict
+from heurams.services.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+class SM2Algorithm(BaseAlgorithm):
+    algo_name = "SM-2"
+
+    class AlgodataDict(TypedDict):
+        efactor: float
+        real_rept: int
+        rept: int
+        interval: int
+        last_date: int
+        next_date: int
+        is_activated: int
+        last_modify: float
+
+    defaults = {
+        "efactor": 2.5,
+        "real_rept": 0,
+        "rept": 0,
+        "interval": 0,
+        "last_date": 0,
+        "next_date": 0,
+        "is_activated": 0,
+        "last_modify": timer.get_timestamp(),
+    }
+
+    @classmethod
+    def revisor(
+        cls, algodata: dict, feedback: int = 5, is_new_activation: bool = False
+    ):
+        """SM-2 算法迭代决策机制实现
+        根据 quality(0 ~ 5) 进行参数迭代最佳间隔
+        quality 由主程序评估
+
+        Args:
+            quality (int): 记忆保留率量化参数
+        """
+        logger.debug(
+            "SM2.revisor 开始, feedback: %d, is_new_activation: %s",
+            feedback,
+            is_new_activation,
+        )
+
+        if feedback == -1:
+            logger.debug("feedback 为 -1, 跳过更新")
+            return
+
+        algodata[cls.algo_name]["efactor"] = algodata[cls.algo_name]["efactor"] + (
+            0.1 - (5 - feedback) * (0.08 + (5 - feedback) * 0.02)
+        )
+        algodata[cls.algo_name]["efactor"] = max(
+            1.3, algodata[cls.algo_name]["efactor"]
+        )
+        logger.debug("更新 efactor: %f", algodata[cls.algo_name]["efactor"])
+
+        if feedback < 3:
+            algodata[cls.algo_name]["rept"] = 0
+            algodata[cls.algo_name]["interval"] = 0
+            logger.debug("feedback < 3, 重置 rept 和 interval")
+        else:
+            algodata[cls.algo_name]["rept"] += 1
+            logger.debug("递增 rept: %d", algodata[cls.algo_name]["rept"])
+
+        algodata[cls.algo_name]["real_rept"] += 1
+        logger.debug("递增 real_rept: %d", algodata[cls.algo_name]["real_rept"])
+
+        if is_new_activation:
+            algodata[cls.algo_name]["rept"] = 0
+            algodata[cls.algo_name]["efactor"] = 2.5
+            logger.debug("新激活, 重置 rept 和 efactor")
+
+        if algodata[cls.algo_name]["rept"] == 0:
+            algodata[cls.algo_name]["interval"] = 1
+            logger.debug("rept=0, 设置 interval=1")
+        elif algodata[cls.algo_name]["rept"] == 1:
+            algodata[cls.algo_name]["interval"] = 6
+            logger.debug("rept=1, 设置 interval=6")
+        else:
+            algodata[cls.algo_name]["interval"] = round(
+                algodata[cls.algo_name]["interval"] * algodata[cls.algo_name]["efactor"]
+            )
+            logger.debug(
+                "rept>1, 计算 interval: %d", algodata[cls.algo_name]["interval"]
+            )
+
+        algodata[cls.algo_name]["last_date"] = timer.get_daystamp()
+        algodata[cls.algo_name]["next_date"] = (
+            timer.get_daystamp() + algodata[cls.algo_name]["interval"]
+        )
+        algodata[cls.algo_name]["last_modify"] = timer.get_timestamp()
+
+        logger.debug(
+            "更新日期: last_date=%d, next_date=%d, last_modify=%f",
+            algodata[cls.algo_name]["last_date"],
+            algodata[cls.algo_name]["next_date"],
+            algodata[cls.algo_name]["last_modify"],
+        )
+
+    @classmethod
+    def is_due(cls, algodata):
+        result = algodata[cls.algo_name]["next_date"] <= timer.get_daystamp()
+        logger.debug(
+            "SM2.is_due: next_date=%d, current_daystamp=%d, result=%s",
+            algodata[cls.algo_name]["next_date"],
+            timer.get_daystamp(),
+            result,
+        )
+        return result
+
+    @classmethod
+    def rate(cls, algodata):
+        efactor = algodata[cls.algo_name]["efactor"]
+        logger.debug("SM2.rate: efactor=%f", efactor)
+        return str(efactor)
+
+    @classmethod
+    def nextdate(cls, algodata) -> int:
+        next_date = algodata[cls.algo_name]["next_date"]
+        logger.debug("SM2.nextdate: %d", next_date)
+        return next_date