fix

src/heurams/kernel/particles/atom.py

@@ -12,6 +12,9 @@ from heurams.services.logger import get_logger
 
 logger = get_logger(__name__)
 
+class AtomRegister_runtime(TypedDict):
+    locked: bool # 只读锁定标识符
+    min_rate: int # 最低评分
 
 class AtomRegister(TypedDict):
     nucleon: Nucleon
@@ -23,7 +26,7 @@ class AtomRegister(TypedDict):
     orbital: Orbital
     orbital_path: pathlib.Path
     orbital_fmt: str
-    runtime: dict
+    runtime: AtomRegister_runtime
 
 
 class Atom:
@@ -51,6 +54,7 @@ class Atom:
             "orbital": None,
             "orbital_path": None,  # 允许设置为 None, 此时使用 nucleon 文件内的推荐配置
             "orbital_fmt": "toml",
+            "runtime": {"locked": False, "min_rate": 0x3f3f3f3f}
         }
         self.do_eval()
         logger.debug("Atom 初始化完成")
@@ -65,6 +69,38 @@ class Atom:
             logger.error("尝试链接不受支持的键: '%s'", key)
             raise ValueError("不受支持的原子元数据链接操作")
 
+    def minimize(self, rating):
+        """效果等同于 self.registry['runtime']['min_rate'] = min(rating, self.registry['runtime']['min_rate'])
+
+        Args:
+            rating (int): 评分
+        """
+        self.registry['runtime']['min_rate'] = min(rating, self.registry['runtime']['min_rate'])
+    
+    def lock(self, locked = -1):
+        """锁定, 效果等同于 self.registry['runtime']['locked'] = locked 或者返回是否锁定
+        """
+        if locked == 1:
+            self.registry['runtime']['locked'] = True
+            return 1
+        elif locked == 0:
+            self.registry['runtime']['locked'] = False
+            return 1
+        elif locked == -1:
+            return self.registry['runtime']["locked"]
+        return 0
+
+    def revise(self):
+        """执行最终评分
+        PuzzleWidget 的 handler 除了测试, 严禁直接执行 Electron 的 revisor 函数, 否则造成逻辑混乱
+        """
+        if self.registry["runtime"]["locked"]:
+            logger.debug(f"允许总评分: {self.registry['runtime']['min_rate']}")
+            self.registry["electron"].revisor(self.registry['runtime']["min_rate"])
+        else:
+            logger.debug("禁止总评分")
+
+
     def do_eval(self):
         """
         执行并以结果替换当前单元的所有 eval 语句
@@ -85,13 +121,17 @@ class Atom:
                 # 如果无法获取配置或元数据，使用空字典
                 logger.debug("无法获取配置或元数据，使用空字典")
                 pass
-            try:                
+            try:
                 eval_value = eval(s)
                 if isinstance(eval_value, (list, dict)):
                     ret = eval_value
                 else:
                     ret = str(eval_value)
-                logger.debug("eval 执行成功: '%s' -> '%s'", s, str(ret)[:50] + '...' if len(ret) > 50 else ret)
+                logger.debug(
+                    "eval 执行成功: '%s' -> '%s'",
+                    s,
+                    str(ret)[:50] + "..." if len(ret) > 50 else ret,
+                )
             except Exception as e:
                 ret = f"此 eval 实例发生错误: {e}"
                 logger.warning("eval 执行错误: '%s' -> %s", s, e)
@@ -117,16 +157,16 @@ class Atom:
 
         # 如果 nucleon 存在且有 do_eval 方法，调用它
         nucleon = self.registry["nucleon"]
-        if nucleon is not None and hasattr(nucleon, 'do_eval'):
+        if nucleon is not None and hasattr(nucleon, "do_eval"):
             nucleon.do_eval()
             logger.debug("已调用 nucleon.do_eval")
-        
+
         # 如果 electron 存在且其 algodata 包含 eval 字符串，遍历它
         electron = self.registry["electron"]
-        if electron is not None and hasattr(electron, 'algodata'):
+        if electron is not None and hasattr(electron, "algodata"):
             traverse(electron.algodata, eval_with_env)
             logger.debug("已处理 electron algodata eval")
-        
+
         # 如果 orbital 存在且是字典，遍历它
         orbital = self.registry["orbital"]
         if orbital is not None and isinstance(orbital, dict):
@@ -173,7 +213,9 @@ class Atom:
         raise KeyError(f"不支持的键: {key}")
 
     def __setitem__(self, key, value):
-        logger.debug("Atom.__setitem__: key='%s', value type: %s", key, type(value).__name__)
+        logger.debug(
+            "Atom.__setitem__: key='%s', value type: %s", key, type(value).__name__
+        )
         if key in self.registry:
             self.registry[key] = value
             logger.debug("键 '%s' 已设置", key)