Struct IconCacheService 

pub struct IconCacheService { /* private fields */ }

图标缓存服务，提供 L1 内存缓存 + L2 文件缓存的原子操作原语。 本服务是纯缓存工具，不知道图标如何提取，也不知道 IconRequest/CacheLevel 等业务语义。 业务逻辑由 IconExtractor trait 的默认实现提供，本服务仅提供存取能力。

Implementations

impl IconCacheService

pub fn new(cache_dir: String) -> Self

创建图标缓存服务实例。 参数：cache_dir - L2 文件缓存目录路径。 返回：初始化后的 IconCacheService（尚未扫描 L2 缓存，需调用 init()）。

pub fn init(&self)

初始化缓存服务，扫描 L2 文件缓存目录填充 cached_file_hashes。 参数：无。 返回：无。 特性：必须在 new() 之后、首次缓存操作之前调用。

pub async fn preload_l1(&self)

预载 L2 文件缓存到 L1 内存。 参数：无。 返回：无。 特性：并行读取，全部完成后返回；失败条目静默跳过（查询路径会回退到按需读 L2）。

pub fn get_l1(&self, key: &str) -> Option<Vec<u8>>

从 L1 内存缓存获取数据。 参数：key - 缓存键（文件名，如 “abc123.webp”）。 返回：命中返回 Some(数据)，未命中返回 None。

pub fn set_l1(&self, key: &str, data: Vec<u8>)

写入 L1 内存缓存。 参数：key - 缓存键；data - 图标 WebP 数据。 返回：无。

pub fn clear_l1(&self)

清空 L1 内存缓存。 参数：无。 返回：无。

pub fn remove_l1(&self, key: &str)

移除 L1 内存缓存中的指定键（用于图标覆盖后强制刷新缓存）。 参数：key - 缓存键（文件名，如 “abc123.webp”）。 返回：无。

pub fn contains_l2(&self, key: &str) -> bool

检查 L2 文件缓存中是否包含指定键。 参数：key - 缓存键（文件名）。 返回：存在返回 true。

pub async fn get_l2(&self, key: &str) -> Option<Vec<u8>>

从 L2 文件缓存读取数据。 参数：key - 缓存键（文件名）。 返回：成功返回 Some(数据)，失败或不存在返回 None。

pub async fn set_l2(&self, key: &str, data: Vec<u8>)

异步写入 L2 文件缓存。 参数：key - 缓存键（文件名）；data - 图标 WebP 数据。 返回：无。 特性：写入操作在后台线程执行，不阻塞调用方；同时更新 cached_file_hashes。

pub fn update_cache_dir(&self, new_cache_dir: &str)

更新图标缓存目录路径，同时清空 L1 内存缓存并重新扫描 L2。 参数：new_cache_dir - 新的图标文件缓存目录路径。 返回：无。