feat,fix(core,docs): 完善核心模块代码注释并添加架构改进文档

- 为 core 目录下主要模块 (models, context, creator, base_api, exchange, executor) 添加了详细的类和方法 Docstring。
   - 新增 docs/架构改进.md 文件。

core/creator.py

@@ -133,6 +133,15 @@ class CaseGenerator:
 
     @classmethod
     def build_and_register(cls, target_cls: Type[TestTemplateBase], cases_dir: Union[str, Path]):
+        """
+        构建测试用例并注册到目标测试类中。
+
+        遍历指定目录下的用例文件，解析数据，生成测试方法并动态绑定到 target_cls 上。
+
+        Args:
+            target_cls: 目标测试类（通常继承自 TestTemplateBase）。
+            cases_dir: 测试用例文件所在的目录路径。
+        """
         # 1. 通过 Loader 获取数据
         all_cases = CaseDataLoader.get_all_cases(cases_dir)
         for index, case_info in enumerate(all_cases):
@@ -149,7 +158,18 @@ class CaseGenerator:
 
     @staticmethod
     def _create_case_method(title, entity: CaseEntity):
-        """封装具体的 pytest 执行节点"""
+        """
+        封装具体的 pytest 执行节点。
+
+        创建并返回一个闭包函数，该函数包含完整的测试执行逻辑（Allure 设置、日志、执行器调用）。
+
+        Args:
+            title: 测试用例标题。
+            entity: 包含用例数据和上下文的实体对象。
+
+        Returns:
+            function: 可被 pytest 识别和执行的测试方法。
+        """
         case_template = entity.step_data
         context = entity.row_context
         def build_actual_case(instance: TestTemplateBase, execution_context):