refactor: 完成 0.4.0 版本更新

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

src/heurams/interface/shim.py

@@ -0,0 +1,36 @@
+"""Kernel 操作辅助函数库"""
+
+import random
+import heurams.kernel.particles as pt
+import heurams.kernel.puzzles as pz
+import heurams.interface.widgets as pzw
+from typing import TypedDict
+
+staging = {}  # 细粒度缓存区, 是 ident -> quality 的封装
+
+
+def report_to_staging(atom: pt.Atom, quality):
+    staging[atom.ident] = min(quality, staging[atom.ident])
+
+
+def clear():
+    staging = dict()
+
+
+def deploy_to_electron():
+    for atom_ident, quality in staging.items():
+        if pt.atom_registry[atom_ident].registry["electron"].is_activated:
+            pt.atom_registry[atom_ident].registry["electron"].revisor(quality=quality)
+        else:
+            pt.atom_registry[atom_ident].registry["electron"].revisor(
+                quality=quality, is_new_activation=True
+            )
+    clear()
+
+
+puzzle2widget = {
+    pz.RecognitionPuzzle: pzw.Recognition,
+    pz.ClozePuzzle: pzw.ClozePuzzle,
+    pz.MCQPuzzle: pzw.MCQPuzzle,
+    pz.BasePuzzle: pzw.BasePuzzleWidget,
+}