# AI 用例落盘（AI_SAVE_CASES）：请求/响应留档

识别错误排查困难的核心原因：无法复现"当时 AI 看到了什么"——输入（TMDB 缓存、文件名、目录链）在下次运行时可能已变化，AI 响应更无法回放。决定：新增 `AI_SAVE_CASES`（默认 false），开启后每次 AI 批量请求的**输入 JSON**（`build_ai_input_json` 产物）与**原始响应**分别存 `$CACHE_DIR/media_organizer/ai_cases/<序号>_<时间戳>_{request,response}.json`。

**边界语义**：① 输入不含 API 密钥（key 只出现在 HTTP Authorization 头，不进请求体）——留档无泄密风险；② 响应存**原始文本**（非 JSON 响应也留档——排查"模型到底输出了什么"正是用例价值所在）；③ 干运行不写（零持久化副作用，与全项目约定一致）；④ 序号复用 `AI_CALL_COUNT`（可对回批次数）；⑤ 与 `--list-cache` 无关（`media_organizer/` 学习数据区，不随 `--refresh-cache` 清除）；⑥ 用例是防幻觉学习（特典 keymap 等）的候选数据源——AI 判断 + 用户最终确认结果成对存档后，可用于校准。

**Considered Options**: 不落盘（原状）——识别错误无法复盘，反馈只能靠截图；只存响应——缺输入侧无法重建上下文；日志级别全量打（DEBUG）——日志轮转会清掉，且与运行日志混杂。