✨ feat(hook): 增强认证钩子和运行时缓存管理 (#2106)

* ✨ feat(hook): 增强认证钩子和运行时缓存管理
```
♻ refactor(hook): 移除未使用的配置项并优化缓存设置

移除 AUTH_HOOKS_CONCURRENCY_LIMIT 配置项，该配置项不再使用

✨feat(auth_ban): 简化缓存配置并添加实体参数支持

将 BAN_CACHE_TTL 相关配置从动态配置改为常量定义，
移除复杂的 TTL 值转换逻辑，并为 auth_ban 函数添加可选的
entity 参数以支持外部传入实体信息

♻ refactor(auth_limit): 移除未使用的配置依赖

移除 AUTH_LIMIT_NOTICE_CD 配置项，直接使用常量值 2
作为限制通知冷却时间

📦 依赖更新: update playwright dependency to version 1.57.0 in pyproject.toml and requirements.txt
```

* ✨ feat(auth_checker): 增强插件模块处理和预过滤逻辑，支持用户插件兼容性

* ✨ feat(http_utils): 添加内容缓存机制以优化HTTP响应处理

* ✨ feat(cache): 添加群组插件设置视图缓存类型并更新相关逻辑

* ✨ feat(renderer): 优化渲染引擎，增加内存缓存管理和HTML文档处理逻辑

* ✨ feat(sign_in): 添加好感度排行和好感度总排行命令

* ✨ feat(renderer): 增强浏览器实例管理和模板预处理，支持历史 include 语法兼容

* ✨ feat(renderer): 优化 Playwright 环境检查逻辑，增加结果缓存以提高性能

* ✨ feat(renderer): 增强模板文件渲染策略，优化资产加载路径处理

* 🚨 auto fix by pre-commit hooks

* ✨ feat(log): 增加日志内容安全序列化，避免超长 base64 等污染日志
✨ feat(log_sanitizer): 添加对嵌入超长 base64/data URI 的清理功能
✨ feat(auth_checker): 添加 Alconna 快捷方式缓存检查，优化路由匹配逻辑

* feat(renderer): 添加渲染结果内存缓存功能以优化性能
feat(help): 实现帮助菜单图像缓存机制
feat(sign_in): 更新HTML卡片生成以支持动画禁用和剪裁
feat(superuser): 在启动时预热超级用户帮助缓存
feat(theme): 优化主题管理器的资源解析缓存

* 🚨 auto fix by pre-commit hooks

* feat(renderer): 增加全页面视口最大宽度限制并优化内容尺寸计算

---------

Co-authored-by: ATTomatoo <1126160939@qq.com>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: HibiKier <45528451+HibiKier@users.noreply.github.com>

zhenxun/services/avatar_service.py

@@ -4,6 +4,7 @@
 提供一个统一的、带缓存的头像获取服务，支持多平台和可配置的过期策略。
 """
 
+from collections import OrderedDict
 import os
 from pathlib import Path
 import time
@@ -47,10 +48,12 @@ class AvatarService:
     一个集中式的头像缓存服务，提供L1（内存）和L2（文件）两级缓存。
     """
 
+    _MEMORY_CACHE_MAX_ITEMS = 2000
+
     def __init__(self):
         self.cache_path = (DATA_PATH / "cache" / "avatars").resolve()
         self.cache_path.mkdir(parents=True, exist_ok=True)
-        self._memory_cache: dict[str, Path] = {}
+        self._memory_cache: OrderedDict[str, Path] = OrderedDict()
 
     def _get_cache_path(self, platform: str, identifier: str) -> Path:
         """
@@ -79,8 +82,11 @@ class AvatarService:
 
         cache_key = f"{platform}-{identifier}"
         if not force_refresh and cache_key in self._memory_cache:
-            if self._memory_cache[cache_key].exists():
-                return self._memory_cache[cache_key]
+            cached_path = self._memory_cache[cache_key]
+            if cached_path.exists():
+                self._memory_cache.move_to_end(cache_key)
+                return cached_path
+            self._memory_cache.pop(cache_key, None)
 
         local_path = self._get_cache_path(platform, identifier)
         ttl_seconds = Config.get_config("avatar_cache", "TTL_DAYS", 7) * 86400
@@ -90,6 +96,9 @@ class AvatarService:
                 file_mtime = os.path.getmtime(local_path)
                 if time.time() - file_mtime < ttl_seconds:
                     self._memory_cache[cache_key] = local_path
+                    self._memory_cache.move_to_end(cache_key)
+                    while len(self._memory_cache) > self._MEMORY_CACHE_MAX_ITEMS:
+                        self._memory_cache.popitem(last=False)
                     return local_path
             except FileNotFoundError:
                 pass
@@ -102,6 +111,9 @@ class AvatarService:
 
         if await AsyncHttpx.download_file(avatar_url, local_path):
             self._memory_cache[cache_key] = local_path
+            self._memory_cache.move_to_end(cache_key)
+            while len(self._memory_cache) > self._MEMORY_CACHE_MAX_ITEMS:
+                self._memory_cache.popitem(last=False)
             return local_path
         else:
             logger.warning(f"下载头像失败: {avatar_url}", "AvatarService")
@@ -126,6 +138,22 @@ class AvatarService:
                 except FileNotFoundError:
                     continue
 
+        if self._memory_cache:
+            stale_keys = []
+            for key, cached_path in self._memory_cache.items():
+                if not cached_path.exists():
+                    stale_keys.append(key)
+                    continue
+                try:
+                    if now - os.path.getmtime(cached_path) > ttl_seconds:
+                        stale_keys.append(key)
+                except OSError:
+                    stale_keys.append(key)
+            for key in stale_keys:
+                self._memory_cache.pop(key, None)
+            while len(self._memory_cache) > self._MEMORY_CACHE_MAX_ITEMS:
+                self._memory_cache.popitem(last=False)
+
         logger.info(
             f"头像缓存清理完成，共删除 {deleted_count} 个过期文件。", "AvatarService"
         )