refresh-cache 是 agentic-analytics 的数据缓存重建技能，用途是清空当前配置客户的本地数据湖，再重新拉取一个新的 60 天窗口，使下一次报告基于干净数据运行。删除前它总会提供更轻量的 update-cache 替代方案，因为多数想“刷新”的人其实只想要最新数据，而非完全清空。
流程分两步：第一步删除，运行 scripts/refresh_cache.py，仅用标准库、离线安全，不触网，清除 lake root 与 catalog；若 bucket.json 缺失则以非零退出，这是唯一失败模式。第二步重新拉取，运行 scripts/db/pull_parsely_dpl.py，需要新的 AWS SSO 认证；该脚本增量且幂等，清除后会一次性拉取完整 60 天窗口并重建 dpl_events 目录视图。重新拉取失败时会明确告知数据湖已空，下次报告运行或重跑本流程会再次填充。
使用前需解析插件根目录并加载 bucket 配置（~/.config/agentic-analytics/bucket.json，含 bucket、profile、cache_dir）。若文件缺失，应先运行 init 流程。删除是破坏性且不可逆的，必须先确认；确认后应简洁：告知、运行、停止，不逐行叙述脚本输出。删除始终作用于整个 dpl/events/ 子树，不按站点限定；即使后续重新拉取用 --site 限定，删除范围也不变。若只想补齐或修复单站点数据，应改用 update-cache，它从不删除。DuckDB catalog 也会被清除，报告可重新生成。升级旧版本时还会清理旧 gz-JSON 缓存和临时工作目录。