MathBank使用指南
v3.1.0GitHub下载软件
MATHBANK HANDBOOK / 01

开始使用

从下载到保存第一道题,跟着四步完成。

本页目录
i
先完成一次小任务

下载、启动、配置一个平台,再导入三道样例题。LaTeX、绘图和组卷导出可以之后再设置。

01 选择系统,下载软件

选择安装 MathBank 的电脑系统,下载对应的完整软件包。

这里提供的是已正式发布的 V3.1.0。已于 2026-11-18 核对 GitHub 正式附件;相关变化见版本与功能范围。

Windows 10 / 11 · x64

Windows 便携版

内置 Python 和运行组件,无需另行安装 Python。

MathBank-Windows-x64.zip

完整解压后,双击「启动题库系统.bat」。首次启动请耐心等候。

macOS · 需要 Python 3.10+

macOS 版

请先安装 Python 3.10 或更高版本 ↗。启动器会自动准备独立运行环境,首次准备需要联网。

MathBank-macOS.zip

完整解压后,双击「启动题库系统.command」。如果提示 Python 缺失,请先完成安装再重试。

下载失败,或不知道应该点哪个文件?

打开该版本发布页面,在 Assets 区域找到 MathBank-Windows-x64.zip 或 MathBank-macOS.zip,不要下载 Source code 源码包。

GitHub 也打不开时,检查网络或到QQ 交流群询问官方获取方式。ZIP 不完整或无法解压时,删除后重新下载。不要使用来源不明、附带密钥的安装包。

02 解压后,通过启动器打开

1

完整解压到一个固定文件夹

把整个 ZIP 解压出来,再进入解压后的文件夹。不要在压缩包预览中直接运行启动文件,也不要只单独拖出启动器。

2

双击启动文件,等待网页打开

Windows 点击 启动题库系统.bat;macOS 点击 启动题库系统.command。不要直接打开软件文件夹里的 index.html。

应该看到:浏览器打开 MathBank 工作台,界面显示「题库就绪」。浏览器是操作界面,服务运行在你自己的电脑上。
没有打开或一直等待?查看启动排查 →
项目 README 真实截图,v2.3.0 界面;展示题目为原创示例。 新安装的题库可以是空的,截图中的题目不是预装内容。

03 配置一个 AI 平台

!
使用 API 前,先充值

先在所选服务商账户中小额充值,并确认余额已到账,再配置和调用模型。创建 API Key 不等于已有可用额度;查看充值与创建 Key 的步骤 →

在软件中打开「系统设置」。新手可先按硅基流动配置步骤获取 Key,将「试卷智能拆解模型」的平台选为硅基流动、模型设为 Qwen/Qwen3.8-27B。

千问 Qwen/Qwen3.8-27B 与 deepseek-ai/DeepSeek-V4.1-Flash 可二选一,每项只填一个模型 ID;上面的示例采用千问。首次导入 Word 先配拆题,识别截图或扫描 PDF 时再配置识图模型。已有其他平台账号也可继续使用。

成功标准:完成下一步三题样例的 AI 拆解。「设置保存成功」只说明配置已保存,不能证明模型能调用。
旧版没有这些模型,或想了解思考开关?

v3.0.0 已内置 Qwen/Qwen3.8-27B 和 deepseek-ai/DeepSeek-V4.1-Flash,可直接选择。旧版没有相应型号时,选择硅基流动,点击模型旁「+」添加完整 ID;旧版不能据此保证自动关闭思考。

v3.0.0 已为新 Flash 的识图、拆题、分类关闭思考;旧版仅添加模型 ID,不能保证调用参数也已适配。效果、速度与费用建议见两款模型说明。

04 导入三题样例,保存第一道题

样例含 3 道原创题:单选、填空、带配图的解答题各一道。先检查拆题结果,再尝试生成解答。

  1. 打开「导入中心」,选择 mathbank-starter.docx。
  2. 首次保持「自动生成 AI 解答与详细解析」关闭;「自动核对疑点」可以保留默认开启。点击「开始解析」,等待提取与拆题完成。
  3. 查看 Word 提取报告和公式提示。在「拆解结果审查」中确认共 3 道题,第三题的图仍属于第三题。
  4. 修正题型、分类或内容后,点击「导入此题」或「导入选中题目」。出现查重提示时先核对。
  5. 回到「题库管理」,找到已保存的题目,确认题干与配图。
样例导入后,应该看到什么?

共 3 题:第一题是二次函数最小值单选题;第二题是集合交集填空题;第三题包含两个小问与一幅 y = x² 坐标图。图片不能变成第四题,也不能归到第二题。

关闭自动生成解答后,答案为空是正常的。若之后生成解析,可核对:第 1 题选 B,最小值为 1;第 2 题为 {2, 4};第 3 题 f(−1)=1、f(2)=4,a=±2。

此样例已检查 Word 排版、公式与配图;AI 拆解结果仍需在你配置的平台上实际验证。

下载文件的实际页面预览

手头只有 PDF,也可直接使用智能图文提取导入配图。提取说明按需展开查看,无需逐题勾选确认后才能导入。

我的第一次使用清单

已完成 0 / 4 步

勾选进度仅保存在当前浏览器,可以随时取消。

怎么正确退出?

先保存当前编辑,再使用软件的电源按钮或「关闭题库」,等待服务停止提示。关闭浏览器标签页,不代表后台题库服务已经退出。更新前尤其需要完成这一步。

软件里也能查常见问题吗?

可以。MathBank 工作区内提供「QA · 常见问题」,支持按分类浏览和关键词搜索。遇到安装、API、导入或组卷问题,可以先在软件内搜索;本帮助网站继续提供更完整的上手路径与排查说明。

开发者:从源码安装

已有 Python 3.10+ 和 Git 的用户,可以参照项目 README获取源码。在独立 Python 环境安装依赖,按 README 的启动方式运行。普通使用优先选择上方的软件包。

GeoGebra 动态演示:本地开发预览

截至 2026-11-18,以下动态演示及体验界面尚未进入 GitHub 主分支或 V3.1.0 正式下载包。下载正式包后没有这些入口属于正常情况;可先使用已发布的题库、组卷和 TikZ 绘图功能。

题库本地开发版。上方的 V3.1.0 便携包按正式发布功能使用。

在「题库管理」找到试题,从题目详情点击「动态演示」。演示页显示当前题干与配图,可在顶部输入题库显示的题号跳转。桌面上可将左侧栏收成图标栏,给画板留出更多空间。首次使用先安装 GeoGebra 离线组件,再点击「生成 GGB」。

也可以直接点「手动作图」打开空白画板。在已有演示上点「作图」,按类别添加圆弧、圆锥曲线、函数或参数曲线,空间题可添加球与空间曲线。可在图上点选构造所需的对象,或输入表达式;手动操作不需要模型。点「修改构图」后,图上选中的对象会高亮,点大小、线型、线宽及可调构造参数都可手动修改。「专注画板」暂时收起题干。

生成和 AI 局部修改显示阶段进度与已用时间。默认跟随高级绘图设置,支持的 GPT 配置还可选「快速试绘」。离散分支使用按钮,连续参数使用滑块;如果有关系未通过画板核对,可带核对结果重新生成。

题干没有可构图内容时,生成按钮不可用。生成过程中可取消。生成后可点「修改构图」,选择对象调整样式、辅助构造参数,或交给 AI 局部修改。拖动控制点或滑块后,对照完整题干和「题设核对」检查图中的几何关系。需要留存时点击「保存到本题」,下次打开会恢复上次保存的构图和动点位置,仍能继续编辑。完整备份会一并保存演示,对外分享可另行下载 .ggb。已有答案解析时,左侧题干下可展开「参考答案」,也可把解析文字发给绘图模型作参考。立体题使用原生三维画板,右键拖动旋转、滚轮缩放。有明确截面构造时,从「查看截面」观察单个凸多面体的截面真形;移动切平面后会更新,也可查看二面角等题目所需的辅助平面图。带题图的试题要求模型支持图像输入,画板操作可离线完成。

搜索使用指南

输入问题或关键词,查找对应的操作步骤。

图片预览