Shuery
c1ed1795c2
CI / lint + test + build (push) Canceled after 0s
- README 现代化重写：徽章区、特性一览、统一 GitHub 提示块格式、修正版本号与 AI 默认值 - 新增 docs/PROJECT_REPORT.md 学术项目报告（含许可证合规分析与死链修复记录） - 收录 23 份 ADR 架构决策记录与 CONTEXT.md 领域术语表 - 新增开发配置：.editorconfig / .shellcheckrc / .markdownlint-cli2.jsonc - .gitignore 补充 mo_map/、检查报告、编辑器临时文件 - 新增 config.example.json 配置模板（不含真实密钥）
1.4 KiB
1.4 KiB
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）——日志轮转会清掉，且与运行日志混杂。