保存宿主视觉模型已转写并确认的单道题，分配不可变编号并初始化 FSRS。不要把未确认的 OCR 猜测写入题库。幂等键用于安全重试。

按固定编号精确读取错题；需要分析学习轨迹时可包含完整复习历史。

按文本、编号、学科、标签、题型、状态或到期时间查询。默认按当前周卷优先级排序，返回各评分分量和原因。

修正 OCR 文本、标签等内容。必须传入读取时获得的 expected_version，冲突时重新读取，编号不会改变。

追加一次真实复习结果并更新 FSRS。incorrect=做错/空白，partial=部分正确或提示后正确，correct=独立正确，easy=明确轻松，skipped=只记录跳过且不改调度。普通答对应使用 correct，不要自动判为 easy。

仅在用户明确要求提高或降低某编号优先级时调用。delta 为 -5..-1 或 1..5；影响按 14 天半衰期衰减，不会篡改 FSRS 或伪造复习。若用户说又做错了，应调用 record_review。

将题目标为 active、mastered 或 archived。归档不会删除题目、编号、修订或复习历史。

冻结所选题目的当前版本并生成仅含题目的 A4 错题复习卷。scheduled 模式选择已到期、未来 horizon_days 内到期或有人工提升的题；生成试卷本身不会更新 FSRS。

按 export_id 获取导出状态、文件路径、资源 URI、大小和 SHA-256。

列出历史导出文件及其是否仍存在，不会改变题目调度状态。

删除指定导出及其 PDF 文件，但不会修改题目、FSRS 或优先级。

返回活动、已掌握、已归档、当前到期和七天内到期数量及学科分布。