快速上手:从安装到第一份试卷
PaperX 的主战场是桌面客户端:题库存放在你自己的磁盘,录题、导入、组卷、导出全部在本地完成。本文带你走完第一次使用的完整流程。
第一步:安装桌面客户端
- 打开下载页,按你的系统选择安装包(macOS / Windows) — 前往下载
- macOS:双击挂载镜像,把 PaperX 拖入「应用程序」;首次打开若提示身份验证,右键选「打开」一次即可
- Windows:运行安装程序并按向导完成安装
第二步:登录账号
首次启动会引导你登录:点击登录按钮后,系统会打开浏览器完成认证,成功后自动回到客户端。登录用于云同步、授权与跨设备功能;本地题库功能不依赖登录。
| 登录方式 | 说明 |
|---|---|
| 邮箱验证码登录 | 输入邮箱接收一次性验证码,验证后自动注册或登录,无需密码 |
| Google 登录 | 在浏览器完成第三方授权后自动返回客户端 |
| GitHub 登录 | 在浏览器完成第三方授权后自动返回客户端 |
| 微信扫码登录 | 在浏览器完成第三方授权后自动返回客户端 |
第三步:打开或新建题库
- 题库就是一个普通文件夹(题目以 .tex 文本文件保存),你可以放在任何位置、用任何工具备份
- 首次使用选择「新建题库」并指定一个空文件夹;或直接打开已有的题库文件夹
第四步:录入与导入题目
两条路径:
- 手动录入:在题库面板新建题目,填入题干、选项与答案,支持 LaTeX 公式
- 批量导入:把文件拖入窗口(或点顶部「导入」)。PaperX 格式的 .tex 可直接识别;Markdown / 纯文本 / Word / PDF / 图片需要先配置 AI(PDF 与扫描件还需 OCR)——导入结果先进「收件箱」,逐条审核后入库
AI 与 OCR 密钥在「设置 → AI 集成」里配置,支持 OpenAI 兼容服务商与本地模型(Ollama / LM Studio)。
第五步:组卷与导出
- 在题库中把题目加入「组卷篮」(工具栏或快捷键唤出)
- 进入组卷器调整顺序与分值、选择试卷模板
- 导出 PDF:内置 Typst 排版引擎开箱即用,无需安装 TeX Live 或任何外部编译环境
数据在哪、怎么备份
- 题目与题库:就是题库文件夹本身,复制文件夹即完成备份(也可开启可选的官方云同步)
- AI / OCR 密钥:仅存于系统钥匙串,不上传、不随题库分发
- 应用会自动检查更新;也可以在设置里手动检查。卸载时删除应用即可,题库文件夹不受影响