喵题生成器 heshengtao/exameow

简体中文 ·繁體中文 · English ·日本語 · 한국어 · Español · Français · Deutsch · Русский · العربية

Live Demo · Download · Docker Hub

Exameow 是什么？

Exameow（过了喵） 是开源 AI 出题工具，几秒就能把学习资料变成考试级题目。上传 PDF、Word 文档、PowerPoint 幻灯片、图片或文本，AI 读懂内容，按你的需求生成单选题、判断题、填空题和简答题。

别的 AI 出题工具要注册账号、要订阅，还会把你的数据传到云端。Exameow 不一样：本地优先，注重隐私。题库、练习记录、错题历史都留在你的设备上。桌面端和移动端 App 配上你自己的 OpenAI 兼容 API key（OpenAI、DeepSeek、Qwen、GLM 或任意自托管模型），完全离线也能用。

面向老师和培训师，Exameow 内置在线考试中继：从本地题库发布考试，分享 6 位数字码，学生用任意浏览器加入。即时判分、教师看板、防滥用保护一应俱全。一条 Docker 命令即可自托管整套服务。

在线演示

在线试用：exam.superagentparty.com

演示站跑在 Cloudflare Workers 上，用的是免费 Workers AI 额度：
- ⏳ 每日配额有限 — Cloudflare 的免费 AI 额度每天重置
- 📄 上下文窗口限制 — 大文档会被截断，以适配模型的上下文窗口

想无限使用，可以用 Docker 自托管，或者用桌面端/移动端应用搭配你自己的 API key。

功能

✨ AI 出题 — 上传文件，拿到考题

Exameow 能解析 10+ 种文件格式的学习资料 — PDF、DOCX、XLSX、PPTX、EPUB、ODT、TXT、CSV、HTML 和图片（PNG/JPG/WEBP/GIF/BMP）。上传单个文件，或一次拖入多个文件。AI 按 5 种题型出题：单选、多选、判断、填空、简答。可控制每种题型的数量、难度（简单/中等/困难）、输出语言，以及按主题/章节筛选。大文档会自动拆分、分批生成并去重。兼容任何 OpenAI 兼容 API — OpenAI、DeepSeek、Qwen、GLM，或直接用演示站内置的免费 Cloudflare AI。结果可导出为 XLSX 或 CSV。

- 丰富的输入格式 — PDF、DOCX、XLSX、PPTX、EPUB、ODT、TXT、CSV、HTML、图片（PNG/JPG/WEBP/GIF/BMP），以及任意文本/代码文件；支持多文件上传与拖放
- 5 种题型 — 单选、多选、判断、填空、简答，每种题型可单独控制数量
- 精细控制 — 难度（简单/中等/困难）、输出语言、按主题/章节筛选
- 智能分批 — 大文档自动拆分、分批生成并去重
- 任何 OpenAI 兼容 API — OpenAI、DeepSeek、Qwen、GLM 等；或直接用演示站内置的免费 Cloudflare AI
- 导出 — XLSX（桌面端、移动端和自托管 Docker 会嵌入题目图片）、CSV（仅文本）和 Word 试卷。Cloudflare 版本仅支持文本。

📚 练习模式 — 更聪明地学，而不是更辛苦地学

把生成的题目变成互动学习会话。可以顺序练习、随机打乱题目和选项，或参加自动生成试卷的限时模拟考试。错题会自动记录并复习 — 连续答对几次后，题目会从错题列表中清除。可在考试模式（盲答）和闪卡模式（显示答案）之间切换。简答题由 AI 对照参考答案评分，支持手动重新评分。通过 XLSX/CSV 导入导出题库，支持智能列映射。

- 顺序练习 — 按顺序刷完题库
- 随机练习 — 打乱题目和选项，记得更牢
- 模拟考试 — 从任意题库自动生成随机试卷，题型数量可配置
- 错题复习 — 记录错题，只练做错的题，随着进步看着它们被清除
- 考试 / 闪卡模式 — 盲答，或翻看题目并显示答案
- AI 评分 — 简答题由 AI 对照参考答案评分，并给出反馈；支持手动重新评分
- 题库管理 — 从 XLSX/CSV 导入题库，智能映射列名；随时导出。XLSX 每个字段对应一列图片（Stem image、Option A image … Option H image），因此题干和每个选项都能各自带图，桌面端、移动端和自托管 Docker 均可用；CSV 导出时会提示图片被省略。
- 章节练习 — 在 CSV/XLSX 中加一列 Chapter；名称相同的题目自动归为一组。练习前可选择一个或多个章节，也包括未归章的题目。没有章节的题库照常可用。
- AI 章节标注 — 生成新题时打开可选开关，即可使用源章节或知识点主题。该开关默认关闭，复用现有的生成请求。

📝 在线考试 — 发布考试并邀请学生

从多个本地题库组卷，按题型配置题目数量和分值。设置标题、开始时间和考试时长。分享 6 位数字码或考试链接——学生用任意设备的浏览器即可加入，无需安装 App。本地倒计时到点自动交卷，保证考试公平；刷新页面进度不丢。客观题在交卷时由服务端评分，答案和解析即时显示。教师面板按分数排序展示结果，可逐题下钻查看。考试数据 7 天后自动删除，保护隐私。防滥用：每个 IP 每天最多发布 20 场；学生一键举报，累计 3 个不同 IP 的举报即自动暂停该考试。Docker 镜像完全自包含——在线考试中继跑在 SQLite 上，对演示站点零依赖。

- 从题库发起考试 — 从多个本地题库组卷，按题型设置题目数量和分值；设置标题、开始时间和时长
- 6 位数字码 + 考试链接 — 学生用任意设备浏览器加入，无需安装 App
- 限时会话 — 本地倒计时，到点自动交卷；刷新页面进度不丢（从上次中断处继续）
- 即时评分 — 客观题由服务端评分，交卷后显示答案和解析；结果保存在本地，随时可回看
- 教师面板 — 按分数排序展示结果，可逐题下钻；结果本地缓存，考试结束后只拉取一次；教师可随时删除考试（立即阻止学生进入并清除结果）
- 隐私优先的中继 — 考试数据存放在 Cloudflare D1，最多 7 天后自动删除；交卷前绝不向学生下发答案
- 防滥用 — 每个 IP 每天最多发布 20 场；学生一键举报，累计 3 个不同 IP 的举报即自动暂停考试；管理员可在 #/admin 页面审核、恢复或删除
- 完全自托管 — Docker 镜像内置同一套考试中继（SQLite），对演示站点零依赖；设置 ADMIN_TOKEN 保护管理页（默认 pass，首次访问 #/admin 时必须修改）

🔍 搜索模式 — 快速找答案

输入或粘贴题目，搜索本地题库；可选 AI 作答，提供解析。拍照搜索用设备端 OCR 从相机或上传图片中识别题目（处理全在你浏览器本地完成，不上传任何内容）。摄像头实时搜索把摄像头对准屏幕或纸张，AI 实时盯住匹配题目。录屏搜索让你在任意窗口上画一个捕获框 — AI 监控该区域，在浮动浮层里显示答案（Windows/macOS/Linux/Android；iOS 因系统限制不可用）。

- 文本搜索 — 输入或粘贴题目，在本地题库中查找匹配，可选 AI 作答
- 拍照搜索 — 拍下或上传题目照片；设备端 OCR（在你浏览器本地运行，不上传）
- 摄像头实时搜索 — 把摄像头对准屏幕/纸张；AI 实时盯住并匹配题目
- 录屏搜索 — 在任意窗口上画一个捕获框；AI 监控并实时匹配题目，答案显示在浮动浮层（Windows / macOS / Linux / Android；iOS 因系统限制不可用）

🤖 MCP — 让其他 AI 宿主驱动 Exameow

Exameow 内置 Model Context Protocol 服务器。连接任意 MCP 客户端，它就能读取你的题库、从文档生成题目、运行练习、判分、导出 CSV/XLSX、发布在线考试 — 你能看到界面同步更新。

- 一个端点，三种形态 — 桌面端 http://127.0.0.1:5274/mcp，移动端 http://<phone-ip>:5274/mcp，自托管时 http://<host>:3000/mcp
- 28 个工具 — 解析、生成、作答、判分、解析、导出、网页搜索、题库/练习/错题管理、连续辅导（next_question）、考试发布与界面导航
- exameow 命令行 — 内置轻量 MCP 客户端（status / start / tools / call），给只有 shell 的宿主用
- AI 技能 — 一条命令把 SKILL.md 装进你智能体的技能目录，教会任意宿主生成题目、一次一题辅导你
- 本地免密钥 — 回环请求无需 token；局域网/远程客户端仍需 bearer token

把下面这段粘进任意 AI 客户端的聊天框，它就会自己连上：

Connect to the Exameow MCP server: use the Streamable HTTP transport, name it exameow, and point it at http://127.0.0.1:5274/mcp. This is a loopback address, so no authentication is needed. Then call tools/list to confirm the available tools.

或者用内置命令行：

exameow status
exameow call generate_exam --json '{"source":{"path":"/abs/notes.pdf"},"params":{"count":10},"save_to_bank":true}'
安装方式、完整工具列表、命令行和技能：MCP.md。

🧠 AI 技能 —— 让任何 harness 都能出题和辅导

Exameow 附带一个技能（skills/exameow），教 AI 智能体通过 MCP 驱动正在运行的应用：从文档生成题目、保存题库、开始练习、批改答案、讲解和讨论，然后用 next_question 一次推进一道题。它跑在内置 MCP 服务器上，所以任何支持 Agent Skills 的 harness 都能直接接入。

方式一 · 用命令行安装

npx skills add heshengtao/exameow

方式二 · 让你的智能体来装

Install this Skill: https://github.com/heshengtao/exameow

源码直达：skills/exameow。

🧩 DeepSeek Harness 插件 —— 每日学习页

配套插件 exameow-dsh-habit 在侧边栏自动化任务下方加一个原生每日学习页，包含每日目标、连续天数、XP、七日视图，还有一条持久的 DSH 提醒，到点把你拉回 Exameow。

让你的 AI 来装：

Install this plugin: https://github.com/heshengtao/exameow-dsh-habit

🌐 跨平台与隐私 —— 数据在你手里，设备在你手里

Exameow 支持 Windows、macOS、Linux、Android 和 Web（iOS 需自行构建）。Web 版用一条 Docker 命令即可部署。所有题库、练习记录和错题历史都存在本地 —— 除非你主动使用在线考试中继，否则不会上传到任何服务器。桌面端 API 密钥用 AES-256-GCM 加密。界面自动识别系统语言（中文/英文），一键切换。

- 桌面与移动端 —— Windows、macOS、Linux、Android（iOS 自行构建）
- 自托管 Web —— 一条 Docker 命令部署
- 本地优先 —— 题库、练习记录和错题都留在你的设备上；桌面端 API 密钥用 AES-256-GCM 加密
- 双语界面 —— 自动识别系统语言（中文 / 英文），一键切换

安装

各平台的预编译安装包都在 GitHub Releases 页面。

平台支持

| 平台 | 状态 | 下载 |
| Windows | ✅ 支持 | .msi 安装包 / 免安装 .zip |
| macOS（Apple Silicon / Intel） | ✅ 支持 | .dmg（去除隔离属性的方法见发布说明） |
| Linux（x86_64 / ARM64） | ✅ 支持 | .AppImage / .deb |
| Android（ARM64） | ✅ 支持 | .apk |
| iOS | ⚠️ 需自行构建 | 见下方说明 |
| Web / Docker（自托管） | ✅ 支持 | Docker 镜像 |
关于 iOS： Apple 开发者证书每年 $99，所以暂时不提供预构建的 iOS 包——你需要自己用 Xcode 构建（pnpm tauri ios build）。如果后续捐款够付证书费，会在 GitHub Releases 上发布官方签名的 iOS 构建。

Docker（自托管）

git clone https://github.com/heshengtao/exameow.git
cd exameow

Build frontend
cd frontend && pnpm install && pnpm build && cd ..

Configure AI provider
export AI_ENDPOINT=https://api.openai.com/v1
export AI_API_KEY=sk-your-key-here
export AI_MODEL=gpt-4o

Build and run
docker compose up -d --build

打开 http://localhost:3000。

🔐 管理员 token（在线考试管理必需）： http://localhost:3000/#/admin 的管理页受 ADMIN_TOKEN 保护。不设置的话，默认是 pass，首次登录会强制你改掉它，改完才能做其他操作。想跳过这一步，就在启动时设置：

ADMIN_TOKEN=your-strong-token docker compose up -d --build

改过的 token 会持久化在 exameow-data 卷（/app/data/admin_token.txt）里，容器重启后依然有效。考试数据（SQLite）也存在同一个卷里。

Docker（预构建镜像）

docker pull ailm32442/exameow:latest
docker run -d -p 3000:3000 \
-e AI_ENDPOINT=https://api.openai.com/v1 \
-e AI_API_KEY=sk-your-key-here \
-e AI_MODEL=gpt-4o \
-e ADMIN_TOKEN=your-strong-token \
-v exameow-data:/app/data \
ailm32442/exameow:latest

不设置 ADMIN_TOKEN 时默认是 pass，首次访问 /#/admin 必须改掉。

环境变量

| 变量 | 默认值 | 说明 |
| AI_ENDPOINT | https://api.openai.com/v1 | 兼容 OpenAI 的 API 端点 |
| AI_API_KEY | — | 你的 AI API key |
| AI_MODEL | gpt-4o | 默认使用的模型 |
| PORT | 3000 | 服务器监听端口 |
| STATIC_DIR | /app/static | 静态文件目录 |
| ADMIN_TOKEN | pass | 管理页 token；pass 会强制你在首次登录 /#/admin 时修改 |
| EXAM_DB_PATH | /app/data/exameow.db | 在线考试中继的 SQLite 路径 |
| ADMIN_TOKEN_FILE | /app/data/admin_token.txt | 修改后的管理员 token 持久化位置 |
| MCP_ENABLED | true | 在 /mcp 暴露 MCP 端点 |
| MCP_TOKEN | — | MCP 客户端使用的 Bearer token |
| MCP_TOKEN_FILE | /app/data/mcp_token.txt | 生成的 MCP token 存放位置 |
| RUST_LOG | info | 日志级别 |

API 端点

| 方法 | 路径 | 说明 |
| GET | /api/models | 列出可用的 AI 模型 |
| POST | /api/generate | 上传文件并生成考题 |
| GET | /api/export | 把题目导出为 CSV |
| POST | /api/export/xlsx | 把题目导出为 XLSX |
| POST | /api/config/save | 保存 AI 配置 |
| GET | /api/config/load | 加载已保存的 AI 配置 |
| POST | /mcp | MCP JSON-RPC 端点（Bearer token） |

生成试题

curl -X POST http://localhost:3000/api/generate \
-F "file=@study-material.pdf" \
-F 'params={"question_types":["single_choice","multi_choice"],"count":10,"difficulty":"medium","language":"Chinese"}'

架构

Exameow 采用三后端架构，共用一个 Vue 3 前端。同一个 SPA 在运行时自动识别平台，路由到对应后端：

- Tauri（桌面/移动端）：src-tauri/ 里的 Rust 命令直接调用 Rust 核心库
- Cloudflare Workers：workers/ 里的 TypeScript 调用 Cloudflare AI + D1，实现在线考试中转
- Axum（自托管/Docker）：packages/server/ 里的 Rust HTTP 服务器，用 SQLite 做考试中转

核心逻辑（文件解析、AI 客户端、试题生成、导出）放在共享的 packages/core/ Rust crate 里，Workers 路径另有一份 TypeScript 实现。

常见问题

如何从 PDF 生成试题？

在演示站或桌面应用里拖拽上传 PDF。选择题型（单选、多选、判断、填空、简答），设置题目数量和难度，然后点生成。AI 读取你的文档，几秒内出题。结果可导出为 XLSX 或 CSV。

Exameow 真的免费吗？

真的。Exameow 基于 Apache 2.0 开源，完全免费。没有付费方案，没有企业版，没有功能阉割。演示站提供免费 AI 生成（受 Cloudflare 免费套餐的每日额度限制）。桌面/移动端应用需要你自己的 AI API key，费用直接付给 AI 服务商——Exameow 从不向你收费。

能离线使用 Exameow 吗？

能。桌面和移动端应用完全离线可用。题库、练习记录、错题历史都存在本地。只有调用 AI API 生成试题时才需要联网。

Exameow 支持哪些 AI 模型？

任何 OpenAI 兼容的 API 都能用：OpenAI（GPT-4o、GPT-4、GPT-3.5）、DeepSeek、Qwen、GLM，以及通过 Ollama 或类似工具自托管的模型。演示站上还可以用内置的免费 Cloudflare AI。

在线考试功能怎么用？

老师从本地题库发布考试，生成 6 位数字码。学生用这个码或分享链接，从任意浏览器加入。考试计时，到点自动交卷。客观题即时判分。考试数据 7 天后自动删除。自托管用户通过 Docker 获得同样的中转服务。

我的数据私密吗？

私密。默认情况下，所有数据（题库、练习记录、API key）都留在你的设备上。API key 用 AES-256-GCM 加密。唯一例外是在线考试数据，会临时存放在 Cloudflare D1（7 天自动删除）或你自托管的 SQLite 里。

开发

Rust server
cargo run -p exameow-server

Frontend dev server
cd frontend && pnpm dev

Tauri desktop app
pnpm tauri dev
项目结构

exameow/
├── frontend/ # Vue 3 SPA
├── packages/
│ ├── core/ # Rust shared library (AI, parser, export, config)
│ ├── server/ # Axum HTTP server
│ └── shared/ # TypeScript shared types
├── src-tauri/ # Tauri desktop + mobile app
├── workers/ # Cloudflare Workers (Hono)
├── scripts/ # Build and deploy scripts
├── Dockerfile
└── docker-compose.yml

免责声明

- 本项目是开源学习工具，仅用于个人学习、教学和内部培训。
- AI 生成内容不保证准确。 题目和分析可能有错，使用前请先核对。因使用生成内容产生的后果，作者不承担任何责任。
- 用户生成内容（UGC）由发布者自行负责。 不要用在线考试功能存储或传播违法、侵权或敏感内容。运营方可删除违规内容，不另行通知。举报渠道：① 每个考试页面内置的举报按钮——同一场考试被 3 个及以上不同 IP 举报后，链接会自动锁定并禁止访问，等待管理员审核；② GitHub Issues。核实违规的会下架；误封的考试可由管理员恢复。
- 演示站点（exam.superagentparty.com）是免费公共服务，不保证可用性和数据持久化（考试数据最多保留 7 天）。重要内容请自行备份。
- 使用本项目即表示你接受所有相关风险，并同意遵守所在地区的法律。

支持

请给我们点个 star！
⭐ 你的支持是我们前进的动力！

欢迎打赏！

ko-fi

关注我们

加入社区如果对项目有疑问或遇到问题，欢迎加入我们的社区。

1. QQ 群：931057213（已满）/ 902882342（二群）

2. Discord：Discord 链接

贡献者

许可证

Apache-2.0

第三方许可证本项目使用了第三方开源软件。完整依赖清单、对应许可证及许可证 URL 见 THIRD_PARTY_LICENSES.csv。