111 lines
4.3 KiB
Python
111 lines
4.3 KiB
Python
"""行为日志记录模块:简洁记录关键操作,包含耗时信息。"""
|
|
from __future__ import annotations
|
|
|
|
import time
|
|
import logging
|
|
import os
|
|
from typing import Any, Dict, Optional
|
|
from .log_formatter import format_action_log
|
|
from .performance_tracker import PerformanceTracker
|
|
|
|
_perf = PerformanceTracker()
|
|
_logger = logging.getLogger("action_logger")
|
|
if not _logger.handlers:
|
|
_logger.setLevel(logging.INFO)
|
|
|
|
# 添加控制台处理器
|
|
_console_handler = logging.StreamHandler()
|
|
_logger.addHandler(_console_handler)
|
|
|
|
# 添加文件处理器,写入到 actions.log
|
|
try:
|
|
# 获取日志目录
|
|
log_dir = os.path.join(os.path.dirname(os.path.dirname(os.path.dirname(__file__))), "logs")
|
|
os.makedirs(log_dir, exist_ok=True)
|
|
|
|
actions_log_path = os.path.join(log_dir, "actions.log")
|
|
|
|
# 创建轮转文件处理器(使用 SafeRotatingFileHandler 以应对 Windows 上文件被外部程序占用导致的重命名失败)
|
|
import time
|
|
import shutil
|
|
from logging.handlers import RotatingFileHandler
|
|
|
|
class SafeRotatingFileHandler(RotatingFileHandler):
|
|
"""在 rotate 时对 PermissionError 做重试与回退拷贝,减少因外部进程占用文件导致的异常"""
|
|
|
|
def rotate(self, source: str, dest: str) -> None: # type: ignore[override]
|
|
try:
|
|
super().rotate(source, dest)
|
|
return
|
|
except PermissionError:
|
|
# 重试若干次(短等待),常见于文件被短期占用
|
|
for attempt in range(3):
|
|
try:
|
|
time.sleep(0.1 * (attempt + 1))
|
|
super().rotate(source, dest)
|
|
return
|
|
except PermissionError:
|
|
continue
|
|
|
|
# 回退方案:尝试拷贝到目标文件然后截断原文件
|
|
try:
|
|
shutil.copy2(source, dest)
|
|
try:
|
|
with open(source, "w", encoding=getattr(self, "encoding", None) or "utf-8"):
|
|
pass
|
|
except Exception:
|
|
pass
|
|
return
|
|
except Exception:
|
|
try:
|
|
super().rotate(source, dest)
|
|
except Exception:
|
|
return
|
|
|
|
_file_handler = SafeRotatingFileHandler(
|
|
actions_log_path,
|
|
maxBytes=10 * 1024 * 1024, # 10MB
|
|
backupCount=5,
|
|
encoding="utf-8",
|
|
)
|
|
_file_handler.setFormatter(logging.Formatter('%(asctime)s - %(message)s'))
|
|
_logger.addHandler(_file_handler)
|
|
except Exception:
|
|
# 如果文件处理器创建失败,至少保留控制台输出
|
|
pass
|
|
|
|
class ActionLogger:
|
|
def log_operation(self, operation: str, details: Optional[str] = None, **kwargs: Any) -> None:
|
|
elapsed = kwargs.pop("elapsed", None)
|
|
if elapsed is None:
|
|
elapsed = 0.0
|
|
try:
|
|
# 统一保留两位小数,便于日志阅读
|
|
elapsed_val = float(elapsed)
|
|
except Exception:
|
|
elapsed_val = 0.0
|
|
elapsed_rounded = round(elapsed_val, 2)
|
|
|
|
# 标记异常慢的操作(阈值可调整)
|
|
extra = dict(kwargs)
|
|
extra["elapsed_seconds"] = elapsed_rounded
|
|
if elapsed_val >= 10.0:
|
|
extra["slow"] = 1
|
|
|
|
msg = format_action_log(operation, details or "", **extra)
|
|
_logger.info(msg)
|
|
|
|
def log_ocr(self, region: str, result: str, elapsed: Optional[float] = None) -> None:
|
|
self.log_operation("OCR", f"region={region} result={result}", elapsed=elapsed)
|
|
|
|
def log_decision(self, decision: str, elapsed: Optional[float] = None) -> None:
|
|
self.log_operation("Decision", decision, elapsed=elapsed)
|
|
|
|
def log_state_change(self, before: str, after: str, elapsed: Optional[float] = None) -> None:
|
|
self.log_operation("StateChange", f"{before}->{after}", elapsed=elapsed)
|
|
|
|
def log_step(self, name: str, elapsed: Optional[float] = None) -> None:
|
|
self.log_operation("Step", name, elapsed=elapsed)
|
|
|
|
__all__ = ["ActionLogger"]
|