refactor: 完成 0.4.0 版本更新

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

src/heurams/kernel/reactor/__init__.py

@@ -0,0 +1,11 @@
+from .states import PhaserState, ProcessionState
+from .procession import Procession
+from .fission import Fission
+from .phaser import Phaser
+from heurams.services.logger import get_logger
+
+logger = get_logger(__name__)
+
+__all__ = ["PhaserState", "ProcessionState", "Procession", "Fission", "Phaser"]
+
+logger.debug("反应堆模块已加载")

src/heurams/kernel/reactor/fission.py

@@ -0,0 +1,43 @@
+import heurams.kernel.particles as pt
+import heurams.kernel.puzzles as puz
+import random
+from .states import PhaserState
+from heurams.services.logger import get_logger
+
+
+class Fission:
+    """裂变器: 单原子调度展开器"""
+
+    def __init__(self, atom: pt.Atom, phase=PhaserState.RECOGNITION):
+        self.logger = get_logger(__name__)
+        self.atom = atom
+        # print(f"{phase.value}")
+        self.orbital_schedule = atom.registry["orbital"]["schedule"][phase.value]  # type: ignore
+        self.orbital_puzzles = atom.registry["orbital"]["puzzles"]
+        # print(self.orbital_schedule)
+        self.puzzles = list()
+        for item, possibility in self.orbital_schedule:  # type: ignore
+            print(f"ad:{item}")
+            self.logger.debug(f"开始处理 orbital 项: {item}")
+            if not isinstance(possibility, float):
+                possibility = float(possibility)
+            while possibility > 1:
+                self.puzzles.append(
+                    {
+                        "puzzle": puz.puzzles[self.orbital_puzzles[item]["__origin__"]],
+                        "alia": item,
+                    }
+                )
+                possibility -= 1
+            if random.random() <= possibility:
+                self.puzzles.append(
+                    {
+                        "puzzle": puz.puzzles[self.orbital_puzzles[item]["__origin__"]],
+                        "alia": item,
+                    }
+                )
+            print(f"ok:{item}")
+            self.logger.debug(f"orbital 项处理完成: {item}")
+
+    def generate(self):
+        yield from self.puzzles

src/heurams/kernel/reactor/phaser.py

@@ -0,0 +1,50 @@
+# 移相器类定义
+
+import heurams.kernel.particles as pt
+from .states import PhaserState, ProcessionState
+from .procession import Procession
+from heurams.services.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+class Phaser:
+    """移相器: 全局调度阶段管理器"""
+
+    def __init__(self, atoms: list[pt.Atom]) -> None:
+        logger.debug("Phaser.__init__: 原子数量=%d", len(atoms))
+        new_atoms = list()
+        old_atoms = list()
+        self.state = PhaserState.UNSURE
+        for i in atoms:
+            if not i.registry["electron"].is_activated():
+                new_atoms.append(i)
+            else:
+                old_atoms.append(i)
+        logger.debug("新原子数量=%d, 旧原子数量=%d", len(new_atoms), len(old_atoms))
+        self.processions = list()
+        if len(old_atoms):
+            self.processions.append(
+                Procession(old_atoms, PhaserState.QUICK_REVIEW, "初始复习")
+            )
+            logger.debug("创建初始复习 Procession")
+        if len(new_atoms):
+            self.processions.append(
+                Procession(new_atoms, PhaserState.RECOGNITION, "新记忆")
+            )
+            logger.debug("创建新记忆 Procession")
+        self.processions.append(Procession(atoms, PhaserState.FINAL_REVIEW, "总体复习"))
+        logger.debug("创建总体复习 Procession")
+        logger.debug("Phaser 初始化完成, processions 数量=%d", len(self.processions))
+
+    def current_procession(self):
+        logger.debug("Phaser.current_procession 被调用")
+        for i in self.processions:
+            i: Procession
+            if not i.state == ProcessionState.FINISHED:
+                self.state = i.phase
+                logger.debug("找到未完成的 Procession: phase=%s", i.phase)
+                return i
+        self.state = PhaserState.FINISHED
+        logger.debug("所有 Procession 已完成, 状态设置为 FINISHED")
+        return 0

src/heurams/kernel/reactor/procession.py

@@ -0,0 +1,73 @@
+import heurams.kernel.particles as pt
+from .states import PhaserState, ProcessionState
+from heurams.services.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+class Procession:
+    """队列: 标识单次记忆流程"""
+
+    def __init__(self, atoms: list, phase: PhaserState, name: str = ""):
+        logger.debug(
+            "Procession.__init__: 原子数量=%d, phase=%s, name='%s'",
+            len(atoms),
+            phase.value,
+            name,
+        )
+        self.atoms = atoms
+        self.queue = atoms.copy()
+        self.current_atom = atoms[0]
+        self.cursor = 0
+        self.name = name
+        self.phase = phase
+        self.state: ProcessionState = ProcessionState.RUNNING
+        logger.debug("Procession 初始化完成, 队列长度=%d", len(self.queue))
+
+    def forward(self, step=1):
+        logger.debug("Procession.forward: step=%d, 当前 cursor=%d", step, self.cursor)
+        self.cursor += step
+        if self.cursor == len(self.queue):
+            self.state = ProcessionState.FINISHED
+            logger.debug("Procession 已完成")
+        else:
+            self.state = ProcessionState.RUNNING
+        try:
+            logger.debug("cursor 更新为: %d", self.cursor)
+            self.current_atom = self.queue[self.cursor]
+            logger.debug("当前原子更新为: %s", self.current_atom.ident)
+            return 1  # 成功
+        except IndexError as e:
+            logger.debug("IndexError: %s", e)
+            self.state = ProcessionState.FINISHED
+            logger.debug("Procession 因索引错误而完成")
+            return 0
+
+    def append(self, atom=None):
+        if atom == None:
+            atom = self.current_atom
+        logger.debug("Procession.append: atom=%s", atom.ident if atom else "None")
+        if self.queue[len(self.queue) - 1] != atom or len(self) <= 1:
+            self.queue.append(atom)
+            logger.debug("原子已追加到队列, 新队列长度=%d", len(self.queue))
+        else:
+            logger.debug("原子未追加（重复或队列长度<=1）")
+
+    def __len__(self):
+        length = len(self.queue) - self.cursor
+        logger.debug("Procession.__len__: 剩余长度=%d", length)
+        return length
+
+    def process(self):
+        logger.debug("Procession.process: cursor=%d", self.cursor)
+        return self.cursor
+
+    def total_length(self):
+        total = len(self.queue)
+        logger.debug("Procession.total_length: %d", total)
+        return total
+
+    def is_empty(self):
+        empty = len(self.queue)
+        logger.debug("Procession.is_empty: %d", empty)
+        return empty

src/heurams/kernel/reactor/states.py

@@ -0,0 +1,20 @@
+from enum import Enum, auto
+from heurams.services.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+class PhaserState(Enum):
+    UNSURE = "unsure"
+    QUICK_REVIEW = "quick_review"
+    RECOGNITION = "recognition"
+    FINAL_REVIEW = "final_review"
+    FINISHED = "finished"
+
+
+class ProcessionState(Enum):
+    RUNNING = auto()
+    FINISHED = auto()
+
+
+logger.debug("状态枚举定义已加载")