接口缓存

命中直接返回不回源，降源站压力。显式规则缓存 + 频次驱动自动缓存，晋升前抽样杜绝串号。

「接口缓存」位于检测之后、回源之前：命中直接返回、不回源，显著降源站压力。既支持按规则显式缓存，也支持频次驱动自动缓存热点接口。安全底线是：晋升自动缓存前抽样多次响应，内容不一致（含用户数据）则永不缓存，杜绝把用户 A 的响应返给用户 B。

#全局与显式规则

字段 / 控件	默认 / 示例	说明
`enabled / store`	false / memory	总开关与存储（当前内存）。
`max_entry_bytes`	1 MB	单条可缓存响应上限，超过不缓存（仍正常透传）。
`max_total_mb`	256	内存缓存总量上限，LRU 淘汰。
`respect_cache_control`	true	尊重响应 `Cache-Control: no-store/private/no-cache`。
`shadow`	false	灰度：true = 只统命中率、不真返缓存。
`rules`	[]	显式规则：命中路由按 TTL 缓存（默认只缓存 GET/HEAD；带 Cookie/Authorization 或响应带 Set-Cookie 默认不缓存）。

缓存键已含「站点 + 路径 + 规范化后的 query 参数」——不同请求参数天然分开缓存，无需额外配置。

字段 / 控件	默认 / 示例	说明
`auto.enabled`	false	无需预配规则，热点接口自动缓存。
`hot_threshold / hot_window_seconds`	50 / 10	窗口内访问达此次数即为热点候选。
`consistency_samples`	3	晋升前需连续几次响应字节一致，才认定「非个性化、可缓存」。
`exclude`	/api/order, /admin/, /api/user	敏感 / 个性化路由永不自动缓存。

开启后到缓存监控看命中率与决策事件，确认缓存确实在生效且没缓存错东西。