v3.0.2

MathBank v3.0.2 更新公告

本次更新重点增强 CLI 与 Agent 只读取题能力，让题库更方便地接入 AI 备课工作流，同时改进 AI 组卷、考点标注、文档导入与 PDF 导出体验。

一、重点更新：让 AI 备课工具读取自己的题库

升级命令行检索工具，新增 /api/agent/ 只读接口，支持：

• 按教学目标找题：发现知识点目录，结合教材版本、章节、题型、难度、来源等条件筛选。
• 分步读取材料：先获取候选摘要，再按稳定 ID 读取完整题干、答案解析、教师评析与标注依据。
• 获取配图信息：提供题目图片清单，本地 CLI 可返回经过安全校验的图片路径，方便 AI 结合图文分析。
• 便于自动化衔接：支持 JSON 输出、分页和批量取题，保留原有命令行用法。

可用于“查找专题题目 → 阅读原题、解析和配图 → 编写教案、组织例题与分层练习”的备课流程。读取接口本身不修改题库、不调用 AI；生成的教学改编应与原题明确区分。

二、AI 组卷与考点标注增强

• AI 选题支持 1–30 题及明确的题型数量要求，可参考库内近年高考卷。
• 根据教学主题提供带出处页码的课标选摘依据，长题和图题可按需进一步完整阅读。
• 分类提供快速／精细模式，也可针对当前题进行精细复核。
• 加强多小问覆盖、主要考查目标与辅助方法的证据校验；支持只应用新增知识点，保留已有标注。

精细分类、图像核验与长题精读可能增加模型用量和等待时间，结果仍需教师核对。

三、文档导入与恢复更稳

• PDF 部分页面识别失败时，保留可确认完整的成功题稿，支持显式补做失败页。
• 补做时保留已有题卡中的人工编辑、勾选和处理记录；全部页面失败时明确报错。
• 支持点击 PDF 配图返回原页重新框选，替换对应图片并保留位置与来源证据。
• 改善 Word/PDF 元数据格式容错，减少单批异常影响其他可用结果。

四、检索、排序与导出优化

• 支持使用 #123 精确查找显示序号，避免图片文件名或路径造成检索误命中。
• 显示顺序与稳定题目 ID 分离，独立排序随完整备份保留。
• 改善 PDF 图文分页，能容纳一页的普通图文题尽量保持同页，长题仍可跨页。
• 修复正文部分几何符号的导出字形；发现字体缺字时停止导出，并提供可定位的题号、字段和片段。

五、等待时间与容量配置统一

普通 AI 请求默认等待 15 分钟，文档识别、拆题与来源核验默认等待 30 分钟。上传大小、图片像素、PDF 页数、文档队列和并发容量集中配置，修改后重启生效。

升级提示：请先完整备份并正常关闭服务，按包内说明更新，保留数据库、图片、配置和备份目录。