用途：为 Advanced Alchemy 设计缓存感知的读写路径与服务。
主要能力：识别可缓存的确定性读取路径；保持查询过滤与加载选项稳定；确保自定义类型构造状态可哈希并兼容语句缓存；使用带明确新鲜度与失效预期的框架级响应缓存。
用法：先确定仓库/服务中的确定性读取路径再加缓存；将缓存视为派生数据而非真值来源；避免缓存依赖隐式 session 状态或非确定性默认值的读取；未确认自定义类型公开构造状态稳定可哈希前不要开启其 cache_ok；将 SQLAlchemy 语句缓存与 HTTP 响应缓存区分处理。示例类型可设置 cache_ok=True，将 lookup 转为有序元组保存。
适用场景：Advanced Alchemy 仓储与服务的读路径优化，Litestar 应用在 Advanced Alchemy 之上的路由级响应缓存。
限制：不要缓存非确定性读取；写路径需使缓存失效、绕过或容忍陈旧读取；需校验重复查询生成稳定 SQL 与参数、自定义类型不产生缓存警告、缓存响应在写入后失效或有新鲜度边界、无个性化或租户特定数据跨缓存键泄漏。相关参考：https://advanced-alchemy.litestar.dev/latest/usage/caching.html 与 https://docs.advanced-alchemy.litestar.dev/latest/reference/types.html。