导入指南
根据文件类型,找到合适的导入方法。
本页目录
选择「智能图文提取」可以提取并放置 PDF 配图;支持直接点击错误插图重新截图替换,部分页面失败时先保留可用题目并按提示补做。PDF 校对结果仅留在当前页面,核对后请及时入库。 查看操作步骤 →
我的文件,应该怎么导入?
左右滑动表格,可查看完整的模型设置。
| 文件类型 | 操作重点 | 关注的模型设置 |
|---|---|---|
| 原始 Word · .docx | 直接提取文字、公式和图片,核对题目边界与原答案 | 试卷智能拆解模型 |
| 特殊公式 Word | 重点检查 MathType、旧式公式和提取说明 | 先查转换结果,再看拆题 |
| 文字型 PDF | 含配图时选智能图文提取,优先利用可靠原文 | 识图 + 拆题;按需要调用 |
| 扫描版 PDF | 含配图时也选智能图文提取,先试少量页面 | 识图 + 拆题 |
| 单题截图 | 题干图、选项图和表格图分别核对 | 默认公式识图模型 |
| LaTeX · .tex | 上传单文件,补齐对应插图;自定义宏须检查转换 | 试卷智能拆解模型 |
| Markdown · .md | 可上传或粘贴源码;配图文件名要与引用一致 | 试卷智能拆解模型;谨慎使用 |
识图和拆题,是两件事
识图:读出文字与公式
字、上下标或表格读错时,先检查原图质量和提取方式,再调整「默认公式识图模型」。
拆题:整理成一道道题
文字完整,但题目被合并、漏掉或拆断时,调整「试卷智能拆解模型」。
PDF 导入会优先保留可靠的原生文字,自动修复可识别的括号、上下标等结构,必要时才做局部或整页识图(即使能复制文字的 PDF,若存在乱码或错排也会调用识图)。识图与拆题均可选择硅基流动的 Qwen/Qwen3.8-27B 或 deepseek-ai/DeepSeek-V4.1-Flash,每项只填一个 ID;新 Flash 作为快速候选可先用少量页面对照,仍需核对题文、公式、表格与配图裁框。版本与思考设置见模型说明。首次调用前,记得先充值并确认余额到账。
单题截图:多图识别与编辑保护
识别单题截图时,系统会分别定位题干、选项和表格中的多幅插图,并尽量放回原来的文字位置。即使关闭 TikZ 重绘,系统仍会自动裁图并做视觉核验;开启 TikZ 后会增加重绘、编译和重绘图核验,失败时自动回退到可用原图。没有可靠裁片时保留待补图位置,可用「手动截图」补入。
V3.1.0:常见平面和凸立体构造可由本地程序计算并生成 TikZ。立体直角标记随图投影。能从实际编译矢量图识别的具名外接圆会按题设过圆点核验。使用预览核对文字标注、连线与图形条件。
晚于 V3.1.0 便携包的主分支源码(4040cf7):带参考图的立体绘图会结合棱线虚实、左右点序和关键线段的水平或竖直方向选择视角,还可借助原图顶点的纸面位置拟合整张立体图的投影。AI 重绘后可自动挪开检测到的独立单字母点名,手工编译会提示压线。请在预览中核对点名、线条和题设条件。
识别期间可以继续编辑,不会丢失修改:如果你在识别过程中修改了当前内容,识别完成后需要手动点击「载入识别结果」才会替换,旧响应不会直接覆盖新编辑;切换题目后,上一题的迟到结果也不会写入当前题目。
Word:先从原始文件开始
- 在「导入中心」选择
.docx文件(旧版.doc请先在 Word 中另存为.docx)。 - 选好「试卷智能拆解模型」,首次保持自动生成解答关闭;「自动核对疑点」可保留默认开启。点击「开始解析」。
- 按需展开提取说明与原文对照,重点核对 MathType、特殊公式、复杂版式和原答案。
- 检查图片归属、选项顺序与公式,修正后选择题目导入,无需逐题勾选来源确认。
来源明确可靠的 Word 题目会优先保留正文、公式、配图和原答案,再由 AI 完成分类;复杂或有疑点的部分才进入拆题流程。导入耗时和用量随文档结构变化,个别文件的节省比例不代表固定保证。
TeX / Markdown:先用小文件验证
可以上传单个 .tex 或 .md 文件,也可以直接粘贴源码。有配图时,在「配套图片(可选)」中选择对应文件,并保持文件名与 \includegraphics 或 Markdown 图片引用一致。
自定义 LaTeX 模板、复杂宏和 Markdown 导入不保证完全兼容(Markdown 支持仍在完善)。建议先用少量完整题目测试,入库前逐题核对题干、公式、图片和答案。若自定义 TeX 反复拆分失败,可先编译成 PDF 再用 PDF 导入。
PDF:先试 1–3 页,再按内容分段
默认上限为 80 页,首次仍建议只试 1–3 页。公式密集或解析很长时,即使未超限,也可能超时或漏题。
- 先填页码范围
1-3,或用逗号选择不连续页,如1-3,5。 - 按完整试卷或小节分批,跨页的题目应把相关页一起选中。
- 排除不需要的封面、目录与长篇解析,检查提取的文字和公式。
- 小样例成功后,再适度增加内容;超时或漏题时优先缩小批次。
默认原文件大小须不超过 30 MB;自定义过容量时,以程序显示的有效上限为准。只选择部分页码不能减小上传文件;超限时,请先另存为较小的 PDF。
PDF:自动提取与放置配图
- 上传 PDF 后,在「PDF 解析策略与范围」中保留「智能图文提取(推荐)」,先选少量完整题目所在的页面。
- 确认识图与拆题模型可用,点击「开始解析」。程序会提取文字、公式与配图,并尝试放到相应题目、选项或表格中。
- 完成后检查题卡中的图片;需要追溯时,展开「提取说明与原文对照」,查看原页及未归位配图。
- 解析完成后,先对照原卷检查图片归属、选项顺序与裁剪范围;漏图可用「手动截图」补充,已有错图可直接点击重新截图替换。 核对后点击「导入此题」或「导入选中题目」保存。
三种 PDF 策略有什么区别?
- 智能图文提取(推荐):同时处理文字、公式与配图。电子版和扫描版含图试卷都优先选它。
- 文字优先:优先提取原生文字与公式,必要时识图补全;配图需要手动补充。
- 全页识图:对所选页面逐页识别文字与公式;配图同样需要手动补充。
智能模式沿用已配置的识图模型,可能增加调用与等待。自动提图不保证每张图的裁剪和归属都正确,图片选项、多幅配图与跨页题尤其需要核对。
V3.1.0 怎样为单份 PDF 选择转录、配图和拆题 API?
智能图文导入可以跟随 API 设置、优先用 MinerU 定位配图,或本次沿用原有定位。选用「MinerU 先 OCR」时,需识图的页先尝试 MinerU;已可靠提取的原生页直接保留,其余页面沿用现行流程。
本次拆题可以跟随系统或选择 API 并填写模型名。300 DPI 为可选的单张整页识图输入,配图证据仍看原页,裁图来自原 PDF。MinerU Token 在 本地 API 设置 中填写,选择相应服务时会提交原 PDF。
点击错误插图,直接重新截图替换
在 PDF 拆题结果中,直接点击裁剪不准的插图即可重新框选替换。若旧版本无此入口,可先用「手动截图」补图,或备份后升级到 V3.1.0。
- 在拆题结果卡的题干或答案与解析预览中,点击需要调整的插图,打开原 PDF 页面。
- 核对弹窗中的旧图与已锁定的替换目标,在原页上拖拽框选正确区域(可切换页码或放大页面)。
- 点击「确认替换此图」,新图会在原位置直接替换点中的那一处,前后文字及其他图片保持不变。
同一张图片在多处出现时,只替换本次点击的位置。取消窗口或裁剪失败时保留原图;只想查看大图,可按住 Cmd(macOS)或 Ctrl(Windows)点击。手动替换复用本地裁剪,不额外调用 AI,也不代表通过了模型视觉核验。
部分失败时,先保留可用结果
长文档解析或批量入库遇到局部异常时,系统会优先保住已完成的题目,避免整卷重来:
- PDF 页面识别部分失败:先保留已确认完整的独立题目;缺页附近的碎片与可能跨页的题目留待补做,不会把缺页前后的内容强行拼接(若选中页全部识别失败则直接报错)。当前页面提供补做入口时,会复用已成功页面继续处理,已校对和已入库的题卡保持不变(补做仍可能调用模型,且不支持跨刷新或重启恢复)。
- 批量入库:合格题可先入库,缺少题型或分类的题目留在工作区并显示逐题原因;疑似重复题仍按原有查重流程确认。
- Word 自动核验:某一批返回格式异常时,仅该批保留原提示,后续独立批次继续核验(服务错误、原文变化或主动取消仍会停止)。
- 网络暂断:页面显示连接中断并自动继续查询原任务进度,不会自动重复上传或重发模型请求;任务过期时保留本页已校对内容。
- 知识点附加说明:无效的可选范围说明会自动忽略并提示,只要知识点编码、主辅角色与原文依据通过校验即可保留;仅有最终答案时仍不会凭空猜测辅助解法。
V3.0.3 的 PDF 局部容错:PDF 页面回复缺少部分配图或完整性说明时,会保留可用正文并提示核对原页;完整拆题回复中个别条目的题干或答案格式无效时,只保留有效题卡,并显示「有 N 项未生成题卡 · 请对照原页检查漏题」。这不是已完整导入的提示,请核对题号、小问及图片后再保存;返回截断或全部题目无效时仍会报错。查看版本与升级说明 →
分类质量档位、单题精细复核与选题精读
以下机制用于主动执行 AI 分类与组卷选题,不会自动改写题库中已有的题目标注:
- 分类质量(快速 / 精细):在「系统设置 → 题目智能分类模型 → 分类质量」中可选择「快速」(默认)或「精细」。精细档会按渠道支持的协议提供更大的思考与输出预算,耗时与用量相应增加,建议先用少量复杂题对照。
- 当前题精细复核:使用快速模式预览分类结果时,若某道题不够理想,可直接点击「本题精细复核」,只对当前题用精细档重算,无需修改全局设置(使用中转 B 的
gemini-3.8-flash-high时保持同一模型别名,仅提高输出预算)。复核失败或取消会保留原快速建议;成功后仍由你确认应用并保存。 - 小问与图片解析核验:混合、嵌套小问和同一问的并列目标(如“求零点和单调区间”只标其一)会触发漏标提示。若解析是图片,系统会在同次请求中转录步骤并注明“图片解析转录,未经独立核验”;仅有最终数值或看不清的图不会作为辅助方法依据。
- Word 元数据容错:当 Word 正文、原答案和图片已可靠提取时,个别题型、难度或附加说明出错只会留待手动选择,不再整卷重抄(来源 ID 冲突或正文被改写仍会停止)。
- AI 组卷长题精读:初筛提供小问纲要,入围长题或带图题按需追加一次同模型全文精读(最多两次请求)。若超预算、缺必要图片或精读失败,会明确说明使用本地规则筛选,不冒充已读完整全文。
高级容量与并发上限怎样调整?
文件大小、图片像素、PDF 页数、文档队列和分类图片容量可按程序目录中 .env.example 所列配置项修改,保存后重启程序生效(超范围或非整数值会回退默认值并提示字段名)。普通 PDF 的 PDF_OCR_CONCURRENCY 可设为 1–12,与辅助核验共享总名额和内存预算。
提高本机上限不会改变模型服务商自身的输入限制;压缩包解压、原生渲染及图片证据另有独立安全保护。建议先试少量完整题目,再按实际需求调整。
AI 选题:按备课要求挑选库内好题
在组卷工作台中,AI 选题可以根据你的备课要求从题库已有题目中挑选合适题目加入试卷草稿(选入后仍需教师检查):
- 在组卷工作台先按教材、知识点、题型、难度或关键词筛选范围,再展开「AI 选题」(已在当前卷面中的题目会自动排除)。V3.1.0 已可按字段添加包含与排除条件。
- 设置题量(1–30 题)并填写具体要求,如复习范围、希望覆盖的考点和难度梯度;要求文字中明确写出的题数优先。
- 按需选择参考库内近期完整高考卷、指定某套参考卷,或关闭参考。参考卷仅用于引导风格与梯度(来源按库内标签识别,不代表官方核验)。
- 查看返回的选题说明、未满足条件与降级提示,核对选入题目的原文与配图后继续编辑试卷。
系统会根据本次要求与范围自动匹配随程序保存的课标选摘,在初筛及按需精读中直接复用,不增加额外操作或模型调用,并在选题说明中附上条目、页码与题文依据(课标材料为随程序保存的选摘,不代表在线核实最新官方版本)。当参考卷不足、候选不足、缺少全文/图片或 AI 不可用时,会明确提示并使用本地规则补选;本地补选不宣称已评估课标契合度。
解析中断或刷新后,先查看任务状态
Word 任务恢复:刷新页面或网络闪断后,返回导入中心先点「重新连接」读取上次进度,避免重复上传。若任务失败或服务重启,只要原文档与任务快照仍可用,就会出现「继续未完成解析」,点击即可复用已成功阶段继续处理剩余部分(恢复出的题卡仍需核对入库;若提示原文档不可用、任务过期或教材目录已变更,请重新上传)。任务恢复不能代替题库完整备份。
PDF 导入结果仅保存在当前页面会话中,不支持刷新页面或重启服务后恢复。解析完成后,请及时检查题卡并点击「导入此题」或「导入选中题目」保存;若当前页部分页面识别失败,请先使用上方的页面内补做入口。
原文对照与自动核对疑点
来源疑点是可按需展开的辅助说明,无需逐题勾选确认,也不会单独阻止导入(题干、分类和查重检查仍正常提示)。
PDF 和 Word 的「自动核对疑点」默认开启:发现疑点时会自动调用识图模型对照原页,尝试修正明确差异并复核(最多 3 轮)。这可能增加等待与费用,且不能代替人工核对;不需要时可随时关闭。「自动生成 AI 解答与详细解析」是另一个独立开关,默认关闭。
用知识点找题,六套教材独立定位
MathBank 将教材位置(这道题放在哪一节)与考查知识点(这道题直接考什么)分开保存。一道题可关联多个知识点并区分主要考查与辅助考查;点击已选知识点名称即可查看主辅设置与标注依据。
- 设置教材位置:在题目编辑器打开「分类信息」,选择册次、章节与小节;无法唯一确定小节时,可保留整章定位。
- 选择知识点:点击「选择知识点」,按本节推荐、全库目录或名称搜索添加;修改教材位置不会清空已选知识点。需要补充目录时,展开「自定义」填写名称与关联即可新增。
- 只应用知识点:在 AI 分类结果中可点击「只应用知识点」,保留当前教材位置与题型,已有标注不会被覆盖(即使教材位置未定,也可先补充有依据的知识点)。
- 筛选与组卷:找题或组卷时支持按“包含任意一个”或“同时包含全部”匹配知识点(默认匹配主要考查,也可勾选包含辅助考查),并与教材章节条件组合筛选。
六套教材自由切换:系统内置人教 A、人教 B、苏教、沪教、北师大、湘教六套教材(在系统设置载入预设后,点击保存配置生效)。每套教材独立保存题目位置,切回时自动恢复原有定位,知识点继续共用;首次切换到新教材时会参考主要知识点自动对照定位,有歧义的题目会标为待细分或待定位供人工核对。
显示题号与稳定 ID:界面显示的连续题号会随题目增删和排序自动更新;而试卷引用、关联题和读取接口始终使用不变的数据库稳定 ID。需要长期引用某道题时请记录其稳定 ID,不要将界面序号当作永久身份。
让 AI 备课工作流读取你的题库
日常录题、搜索和组卷直接在网页完成即可。如果你使用具备本机访问能力的 AI 备课工具,可通过内置的 Agent 只读接口或命令行检索直接从题库取材,无需先导出全库。
- 先发现目录与范围:让工具先读取当前教材、题型和知识点目录,再按知识点、来源和难度分页检索候选题目。
- 按稳定 ID 读取完整题目:根据候选列表返回的稳定 ID,读取完整题干、答案解析、教师评析、标注依据及配图清单(候选摘要不能代替完整原题)。
- 核对后用于备课:结合原题、解法与原图准备教案、例题或分层作业。缺图或待确认项会保持原状提示;需要改编题目时请另存并注明。
命令行检索支持结构化 JSON 输出与分页,无需先启动网页服务;HTTP 接口在 MathBank 服务运行后可用。两者均为只读访问,不会自动生成教案、修改题库或调用模型。请注意:若将读取到的题目与图片发送给外部 AI 服务,相应内容会离开本机。
查看接入指南与最小命令示例
在包含 mathbank/ 和 scripts/ 的程序目录中,使用项目 Python 解释器运行(下方 python3 请按本机环境替换):
python3 -m scripts.search_questions --capabilities --format json
python3 -m scripts.search_questions --catalog --knowledge-query "单调性" --format json -n 10先从目录结果确认知识点编码,再搜索候选;选定后用实际返回的题目 ID,通过 --profile teaching 读取完整材料、--assets 读取图片清单。完整参数、HTTP 路径及取材核对要求见 Agent 只读取题指南。
希望改善识别和拆题效果
先判断问题出在识图还是拆题。若为了节省费用使用了 8B Instruct 或 32B Instruct,识图效果不理想时可换回推荐的 Qwen/Qwen3.8-27B,也可用 Gemini 3.8 Flash、GPT 6.1 Sol 对照同一小样例。各模型的能力、费用与选择建议见模型选择。
导入前,最后核对五件事
- 题目完整:条件、小问与跨页内容有没有遗漏。
- 公式正确:正负号、指数、根号、区间开闭有没有变化。
- 图片归属:题干图、选项图和表格图是否留在正确位置。
- 题型与分类:小节无法唯一确定时,整章定位是否合理;历史或自定义分类是否需要保留。
- 参考答案:原版答案是否完整;AI 补全内容需要教师复核。
若公式内容正确,只是分式大小不统一,可在题干或答案编辑框使用「规范分式」,检查预览后再保存;它不会批量修改已有题目。
样例也失败时,先查 API 和网络;只有某份资料失败时,先查文件格式、内容质量与长度。