MathBank开始使用
从下载到保存第一道题，跟着四步完成。
第一次使用只需要下载、启动、配置一个平台，再导入三道样例题。LaTeX、绘图和组卷导出可以之后再设置。
01 选择系统，下载软件
请选择你准备安装 MathBank 的电脑系统。下载的是完整软件包，不是 GitHub 的 Source code 源码包。
Windows 便携版
内置 Python 和运行组件，无需另行安装 Python。
MathBank-Windows-x64.zip完整解压后，双击「启动题库系统.bat」。首次启动请耐心等候。
macOS 版
请先安装 Python 3.10 或更高版本 ↗。启动器会自动准备独立运行环境，首次准备需要联网。
MathBank-macOS.zip完整解压后，双击「启动题库系统.command」。如果提示 Python 缺失，请先完成安装再重试。
下载失败，或不知道应该点哪个文件？
02 解压后，通过启动器打开
完整解压到一个固定文件夹
把整个 ZIP 解压出来，再进入解压后的文件夹。不要在压缩包预览中直接运行启动文件，也不要只单独拖出启动器。
双击启动文件，等待网页打开
Windows 点击 启动题库系统.bat；macOS 点击 启动题库系统.command。不要直接打开软件文件夹里的 index.html。
03 配置一个 AI 平台
在本地软件中打开「系统设置」，只填写你准备使用的平台。还没有平台账号时，可以先从 API 配置指南开始。
还没有平台账号时，可以先从硅基流动开始：一份 Key 配合不同任务的模型即可完成入门。把「试卷智能拆解模型」设为 Qwen/Qwen3.8-27B；要识别截图或扫描 PDF，再把「默认公式识图模型」设为 Qwen/Qwen3-VL-8B-Instruct，两项的平台都选硅基流动。
想使用 DeepSeek 系列时，优先参考DeepSeek 官网配置。首次不必同时配置所有模型。先跟着硅基流动配置步骤获取 Key，再用三题样例验证。已有其他平台账号，也可以继续使用原来的平台。
04 导入三题样例，保存第一道题
我们准备了 3 道原创题：单选、填空、带配图的解答题各一道。先关闭自动生成解答，把注意力放在公式、题目边界和图片归属上。
- 打开软件「导入中心」，选择
mathbank-starter.docx。 - 首次先关闭「自动生成解答」，点击「开始解析」，等待提取与 AI 拆题完成。
- 完成后查看 Word 提取报告与公式待核对提示，再在「拆解结果审查」中检查是否有 3 道独立题目；第三题的图应保留在第三题里。
- 修正不准确的题型、分类或内容，选择「导入此题」或「导入选中题目」。出现查重提示时先人工核对。
- 回到「题库管理」，找到刚保存的题目，确认题干与配图。
样例导入后，应该看到什么？
共 3 题：第一题是二次函数最小值单选题；第二题是集合交集填空题；第三题包含两个小问与一幅 y = x² 坐标图。图片不能变成第四题，也不能归到第二题。
关闭自动生成解答后，答案为空是正常的。若之后生成解析，可核对：第 1 题选 B，最小值为 1；第 2 题为 {2, 4}；第 3 题 f(−1)=1、f(2)=4，a=±2。
此样例已检查 Word 排版、公式与配图；AI 拆解结果仍需在你配置的平台上实际验证。
我的第一次使用清单
勾选进度仅保存在当前浏览器，可以随时取消。
怎么正确退出？
先保存当前编辑，再使用软件的电源按钮或「关闭题库」，等待服务停止提示。关闭浏览器标签页，不代表后台题库服务已经退出。更新前尤其需要完成这一步。
开发者：从源码安装
已有 Python 3.10+ 和 Git 的用户，可以参照项目 README获取源码。在独立 Python 环境安装依赖，按 README 的启动方式运行。普通使用优先选择上方的软件包。