# 题有据 **Repository Path**: csckx/question-bank-card ## Basic Information - **Project Name**: 题有据 - **Description**: 题有据：免费开源的 Windows 本地数学题库软件。试卷拍照、PDF、Word 导入，AI 自动切题识别，逐题对照原卷核对后入库，支持搜索、组卷打印。适合中小学数学老师。 - **Primary Language**: Python - **License**: AGPL-3.0 - **Default Branch**: main - **Homepage**: https://github.com/CEHNICA/question-bank-card - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2026-10-27 - **Last Updated**: 2026-10-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

题有据

每一道题，都能回到原卷。

装在自己电脑上的数学试题整理工具：把 PDF、Word 和手机拍的试卷，变成逐题核对过、能搜索、能组卷的题库。

_{关键词：数学题库软件 · 免费组卷 · 错题整理 · 试卷识别与切题 · PDF / Word / 拍照转题库 · 中小学老师 · 本地运行 · 开源免费}

![题有据逐题核对工作台](docs/assets/screenshots/review-workspace.webp) ## 这是什么老师手里总有一摞试卷：扫描的 PDF、别人发来的 Word、用手机拍的照片，上面常常还有学生的作答和红笔批改。想把这些题收进自己的题库，以后能搜、能挑、能组一份新卷子，最费劲的一步是把题目一道道敲进电脑：分式、根号、上下标、几何符号，还有配图。题有据把这件事分成两半： - **机器做得快的**：认版面、切出每一道题、看着截图把题目读成文字和公式、挑出配图、标出没把握的地方。 - **必须有人把关的**：对照原卷截图确认每一道题，错了就改，对了就打勾。可以是你自己，也可以是你信任的 AI 助手。AI 打的勾单独标出来，等你抽查。打过勾的题才进入正式题库。每一道入库的题都带着它在原卷上的截图、谁核对的、改过什么。所以叫“题有据”。它是一个本地软件：服务只在你自己的电脑上运行（`127.0.0.1`），题库、原卷和密钥都存在本机。读题时会用到你自己申请的第三方服务，这些服务都可以选免费的，见[完全免费的配法](#完全免费的配法)。 ## 一份试卷是怎么变成题库的 ``` 导入原卷 → 切题 → 读题（两次识读 + MinerU 旁证）→ 逐题核对 → 入库 → 搜索、选题、组卷打印 ``` 1. **导入**：拖进 PDF、Word，或几张照片（合成一份试卷）；也可以复制文件后直接粘贴。一本书或讲义选“一本书 / 讲义”，长资料在本机按页分片，失败的分片可以单独重跑。 2. **切题**：[MinerU](https://mineru.net) 识别整页版面和文字，题有据在本机按题号切出每道题在原卷上的范围，并找出可能是配图的地方。 3. **读题**：看图模型把每道题的截图读成文字，公式写成 LaTeX，表格写成文字表，学生手写和批改按要求忽略。每道题都和 MinerU 自己认出的文字逐字比对；对不上就请另一个模型独立再读一遍，有分歧的地方逐处裁定。 4. **核对**：每道题一张题卡，左边原卷截图，右边读出来的题面。 - **绿卡**：两次识读一致，或与 MinerU 的文字一致。这不等于读对了，仍要你按自己的标准确认。 - **黄卡**：有疑点，比如两次读法不同、可能漏图、配图冲突、有看不清的字。疑点会直接写在卡上。 - **红卡**：没读出来，需要改字或重读。改字时边打字边排版预览；截图范围不对就拖框调整；配图可以重新框选，分页切开的表格或图可以拼成一张。 5. **入库**：打过勾的题入库，生成可追溯的版本。之后改了内容再入库，会成为新版本。 6. **用起来**：在正式题库里按关键词、题型、来源搜题，放进试题篮，预览排版后打印成新试卷。审核时主要用键盘： | 按键 | 作用 | | --- | --- | | `J` / `K` | 下一张 / 上一张（跳到已通过、收起的题时自动展开，可在设置里关） | | `Enter` | 通过并跳到下一张 | | `Space` | 放大对照原卷 | | `E` / `R` / `F` | 改字 / 调整范围 / 配图 | | `O` / `Shift`+`O` | 展开或收起这张已通过的题 / 全部展开或收起 | | `N` | 下一张需核对的卡 | | `U` | 撤销通过 | | `Z` / `L` / `Q` | 专注（其余题暗下来）/ 放大镜 / 全屏 | | `?` | 全部快捷键 | ## 为什么值得信任 - **不假装百分之百正确**：AI 用来提速，不替你下结论。识读一致的绿卡也要经过确认才入库，没把握的地方会标黄并说明原因。 - **两种引擎互相印证**：看图模型的结果要和 MinerU 的文字逐字比对，模型“顺手改正”原卷错字、漏字、添字，都会被发现。 - **配图有检查**：题目说“如图”却没有配图、多出不属于这道题的图，都会提醒；明确冲突的题不能直接通过。 - **AI 和人分开记**：AI 助手打的勾显示成“××已通过 · 待你核对”，题库里标着“AI 审核”，可以只看人工核对过的。AI 不能撤销你的通过，也不能改你已经通过的题。 - **出问题不丢活**：某个服务限流或当天额度用完，题会交给另一家接着读；一家都用不了时，题卡先用 MinerU 的初稿，不会整份变红。 - **数据在本机**：服务只监听 `127.0.0.1`；密钥用 Windows DPAPI 加密，网页进程拿不到原文，也不会写进题库、日志或备份。 ## 适合谁 - 想把手头的试卷、讲义整理成自己的题库，并且在意每道题都和原卷一致的数学老师和教研组。 - 不想付费，但愿意花几分钟注册两个免费服务的人。 - 想让豆包等 AI 助手替自己跑完“上传、核对、入库”的人。目前只支持 Windows 10/11。题目以数学为主，其他学科也能用，但没有专门调过。 ## 看看实际界面以下画面使用虚构演示资料，不包含真实学生信息、私人试卷或 API 凭据。想自己试一遍，可以下载仓库内的 [原创三页演示卷](docs/demo/tiyouju-demo-paper.pdf)；生成方法与字体许可证见 [演示资料说明](docs/demo/README.md)。 ### 一题一卡，原卷与文字放在一起核对 ![逐题核对工作台：左侧原卷，右侧识读文字](docs/assets/screenshots/review-workspace.webp) ### 整题适屏，也能拖动和缩放看细节 ![放大对照：原卷与题面并排显示](docs/assets/screenshots/compare-view.webp) ### 审核完成后，进入正式题库与试题篮 ![正式题库、搜索与试题篮](docs/assets/screenshots/library-and-basket.webp) ### 选题后预览并打印试卷 ![组卷与打印预览](docs/assets/screenshots/paper-preview.webp) ## 安装与使用 ### 推荐：Windows 安装版 1. 打开 [Releases](https://github.com/CEHNICA/question-bank-card/releases/latest)，下载最新的 `TiYouJu-Setup-*.exe`。 2. 完成安装后，从桌面或开始菜单打开“题有据”。 3. 首次处理资料时，按提示填写自己的 API 凭据。可以完全免费，见下面“完全免费的配法”。 4. 上传资料，等待处理完成，再逐题对照原卷确认。 ### 完全免费的配法在“设置 → 常用 → 填写或更换密钥”里填： | 服务 | 要不要 | 免费额度 | 申请 | | --- | --- | --- | --- | | MinerU | 必填，切题用 | 每天 1000 页；Token 14 天过期一次，过期了重新生成 | [mineru.net](https://mineru.net/apiManage/token) | | 魔搭 | 推荐，看图读题 | 每天几百次，读得准；要绑定阿里云账号，支付宝扫码实名 | [modelscope.cn](https://www.modelscope.cn/my/myaccesstoken) | - 实测（2026 年 10 月 1 日）：魔搭读一份 19 道题的试卷用了 1 分半，18 道识读一致，准确度和付费的 MiniMax 相当。每天的免费额度大约够读 4–6 份卷子。 - 当天额度用完时，还没读的题先用 MinerU 识别的初稿（标黄），可以直接对照原卷改字，或者第二天点“重新识读”。 - MiniMax、硅基流动是付费服务。已经有的照常填，MiniMax 仍然优先读题；某一家用不了时自动换另一家。硅基流动目前没有能读题的免费模型。 - 连看图读题的服务也不想注册：在“设置 → 读题模型”里把“谁来读题”选成 **AI 助手读题**。这样只要 MinerU：题卡先用 MinerU 识别的文字做初稿（标黄、注明“初稿”），再让豆包等 AI 助手对照原卷截图逐题核对，或者你自己核对。 > 当前发布包可能尚未进行商业代码签名，Windows SmartScreen 因此可能显示风险提醒。请只从本仓库的 Releases 下载，并用发布页提供的 SHA-256 校验值核对文件。 ### 让 AI 助手帮你用可以让豆包、Claude、Codex、Trae 这类能在电脑上运行命令的 AI 助手，替你安装、处理试卷。对它说： > 请帮我安装并使用题有据：https://github.com/CEHNICA/question-bank-card ，先读仓库里的 AGENTS.md。然后帮我处理这份试卷：D:\试卷\期中.pdf - **一键安装或升级**： ```powershell irm https://github.com/CEHNICA/question-bank-card/releases/latest/download/install.ps1 | iex ``` 它会下载最新版、核对 SHA-256、备份题库，然后静默安装。 - **命令行 `tiyouju.exe`**：和题有据装在一起。上传、等它读完、看每道题的原卷截图和文字、改字、配图、打勾、入库、查题库，都能做。`tiyouju.exe mcp` 把同样的能力做成 MCP 服务器，给支持 MCP 的 AI 用。用法见 [AGENTS.md](AGENTS.md) 和 [skills/tiyouju/SKILL.md](skills/tiyouju/SKILL.md)。 - **AI 通过和人工通过分开记**：AI 打的勾显示成“××已通过 · 待你核对”。你点一下题号左边的方框，它就变成你的通过。审核页有“AI 通过”筛选；题库里标着“AI 审核”，可以只看人工核对过的。 - **AI 不碰密钥**：密钥由你在“设置 → 常用”里填写。删除题卡、撤回入库这类操作不开放给命令行。 - 读题用的是你在软件里填的密钥（可以全用免费的）。选了“AI 助手读题”时，看图核对这一步由 AI 助手自己来做，花的是它自己的免费额度。 ### 从源码运行需要 Windows 10/11 x64、Python 3.12；Node.js 仅用于运行前端测试。 ```powershell git clone https://github.com/CEHNICA/question-bank-card.git cd question-bank-card py -3.12 .\start_question_bank.py ``` 首次运行会创建本地虚拟环境并安装锁定依赖。服务随后在 `http://127.0.0.1:8768` 打开。 ## 支持的工作方式 - PDF、Word 和多张图片导入；界面聚焦时也可以复制文件后直接粘贴上传。 - PDF 单次解析遵守 MinerU 的 600 页上限；教材/讲义默认按 100 页在本机稳定分片，超长试卷按硬上限分片。 - 任务可以重命名并同步更新题目来源；失败任务可以删除，失败分片可以续跑。 - MinerU、MiniMax、魔搭和硅基流动均支持最多 8 个账号组成的本机账号池。某一家暂时用不了（限流、额度用完、服务出错），这道题自动交给另一家已填密钥的服务。 - 多个 MinerU 账号可并行解析不同分片；图像模型账号可同时承载多个识读请求，多个账号叠加。MiniMax 每个账号同时读几道跟会员档位有关，在“设置 → 常用 → MiniMax 会员档位”里选（Plus 3–4、Max 4–5、Ultra 6–7、按量付费 6–8；不确定就选“自动摸索”，从 3 道起逐步加到最多 8 道）；遇到限流会自动放慢，限流过去再慢慢加回来。 - 每道题先用 MinerU 自己识别的文字做独立旁证：与视觉模型逐字一致就不再重复识读；有出入时再请复核模型，并用 MinerU 文字逐处裁定分歧。 - 正式题库支持搜索、试题篮和组卷打印。 ## API 与隐私边界题有据是本地应用，但**处理新资料并非完全离线**。请在上传前了解资料会发送到哪里。 | 服务 | 用途 | 是否必需 | | --- | --- | --- | | MinerU | 解析上传的原卷；长资料先在本机分片，再发送相应分片 | 处理新原卷时需要 | | 魔搭、MiniMax、硅基流动 | 对切出的题目截图进行识读和交叉复核 | 至少填一家；选“AI 助手读题”时都不需要 | | 你使用的 AI 助手（豆包等） | 通过 `tiyouju` 读取题卡文字和原卷截图，用来核对 | 只在你让 AI 助手操作时 | - “忽略手写”是一项识读要求，不会在发送前擦除姓名、答案或批改痕迹。处理含有个人信息的材料前，请先取得适当授权，并核对各 API 服务的数据政策。 - API 凭据使用 Windows DPAPI 加密，只能由当前 Windows 用户解密；网页进程只知道“是否配置”和账号数量，不会收到密钥原文。 - 同一家服务有多个账号时，在“设置 → 常用 → 填写或更换密钥”里一起粘贴，用英文分号 `;` 隔开（每家最多 8 个）。无效、过期或额度耗尽的账号会在本次运行中隔离；限流账号会进入冷却，由其他可用账号接手。 - 服务默认只监听 `127.0.0.1`。当前版本没有面向公网的账号、认证和权限系统，请勿直接暴露到局域网或互联网。 - 用户数据库、原卷、日志和备份属于私密资料。它们已被 `.gitignore` 排除，但提交或公开分发前仍应自行复核。源码运行时，数据位于仓库的 `backend/` 下；安装版数据位于 `%LOCALAPPDATA%\QuestionBankCard\`。卸载程序不会自动删除用户数据。 ## 开发与测试

展开完整测试命令

```powershell py -3.12 -m venv backend\.venv backend\.venv\Scripts\python.exe -m pip install -r backend\requirements.lock.txt backend\.venv\Scripts\python.exe -m unittest test_launcher test_backup test_app_window test_credential_dialog test_packaging Push-Location backend ..\backend\.venv\Scripts\python.exe manage.py test core Pop-Location node --test frontend\test_*.js ``` 测试使用虚构数据和模拟响应，不会调用付费模型。

如需让 MiniMax 充当辅助测试员，请使用 [MiniMax 辅助只读测试指南](docs/MINIMAX_READONLY_TESTING.md)。该流程固定为项目工作区零写入，不调用项目 API，也不能代替人工对照原卷终审。

展开 Windows 安装包构建说明

安装 Inno Setup 7 后，在项目根目录执行： ```powershell powershell -NoProfile -ExecutionPolicy Bypass -File .\packaging\build.ps1 -Version 1.9.1 ``` 完整说明见 [packaging/README.md](packaging/README.md)。构建流程会审计最终目录；如发现数据库、原卷、日志、备份或凭据，会立即失败。

欢迎提交 Issue 和 Pull Request。请先阅读 [参与贡献说明](CONTRIBUTING.md)；报告安全问题请按 [SECURITY.md](SECURITY.md) 私下联系。不要在 Issue、截图或测试样本中附带真实试卷、学生信息、数据库、日志或 API 密钥。 ## 许可证第一方源代码采用 [GNU Affero General Public License v3.0](LICENSE)，SPDX 标识为 `AGPL-3.0-only`。Copyright © 2026 CEHNICA and contributors. 第三方组件保留各自许可证；摘要见 [第三方组件说明](packaging/THIRD_PARTY_NOTICES.txt)，完整文本见 [THIRD_PARTY_LICENSES](THIRD_PARTY_LICENSES/README.md)。其中 PyMuPDF 采用 AGPLv3 / Artifex 商业双许可，KaTeX 采用 MIT 许可证。本项目按“原样”提供，不附带任何担保。本说明不构成法律意见。