refactor(core/utils): 重构装饰器架构与日志追踪逻辑

- 优化 将 trace_step 移至 decorators.py，并引入 ContextVar 实现日志层级缩进。
- 新增 完善 StepTracer 和 action_screenshot 的 Docstrings，明确参数含义。
- 移除 清理了 logger.py
- 优化 main.py 中重复的目录创建逻辑及旧版冗余注释。
- 规范 修正函数命名，提升代码在 BasePage 方案下的复用性。

core/settings.py

@@ -9,35 +9,37 @@
 @date: 2026/1/19 16:54
 @desc: 
 """
-import os
-# core/settings.py
+
 from pathlib import Path
 
 # 项目根目录 (core 的上一级)
 # BASE_DIR = Path(__file__).parent.parent
 BASE_DIR = Path(__file__).resolve().parents[1]  # 获取根路径（绝对路径）
-# print(BASE_DIR)
+
 # --- 目录配置 ---
 OUTPUT_DIR = BASE_DIR / "outputs"
+SCREENSHOT_DIR = OUTPUT_DIR / "screenshots"
 LOG_DIR = OUTPUT_DIR / "logs"
 LOG_BACKUP_DIR = LOG_DIR / "backups"
 ALLURE_TEMP = BASE_DIR / "temp"
 REPORT_DIR = BASE_DIR / "report"
-SCREENSHOT_DIR = OUTPUT_DIR / "screenshots"
-# 确保必要的目录存在
-for folder in [LOG_DIR, LOG_BACKUP_DIR, ALLURE_TEMP, SCREENSHOT_DIR]:
-    folder.mkdir(parents=True, exist_ok=True)
+
+
+# 需要初始化的目录列表 (将在入口文件(mani.py)或 conftest.py 中被调用创建)
+REQUIRED_DIRS = [LOG_DIR, LOG_BACKUP_DIR, ALLURE_TEMP, SCREENSHOT_DIR]
 
 # --- 文件路径 ---
 LOG_SOURCE = LOG_DIR / "pytest.log"
 
 # --- 启动 Appium 最大尝试次数 ---
 MAX_RETRIES = 40
+
 # --- 业务常量 (可选) ---
+APPIUM_SERVER = "http://127.0.0.1:4723"
+
+# --- 核心配置 ---
 IMPLICIT_WAIT_TIMEOUT = 10
 EXPLICIT_WAIT_TIMEOUT = 10
-APPIUM_SERVER = "http://127.0.0.1:4723"
-# --- 核心配置 ---
 APPIUM_HOST = "127.0.0.1"
 APPIUM_PORT = 4723