Warning
本项目目前处于一个极度危险的状态,待重构。
原一个基于 Go 的刷题工具,专为福州大学政治选择题设计,默认支持毛概和习概两门课程的选择题练习,同时支持自定义题库等功能。
- 📚 多种答题模式(速刷、答题、错题回顾)
- 🎓 支持毛概、习概以及自定义题库
- 📊 详细的答题统计和错题管理
- 💾 本地数据持久化,支持多用户
- 🚀 单文件部署,跨平台支持
- 🌐 响应式 Web 界面
- 🐱 萌化的界面设计和交互体验
- 毛概选择题:题库来源于2025上半学年康老师,包含9个章节的选择题
- 习概选择题:题库来源于2024下半学年李老师的题库,合计101道选择题,并新增来自2025下半学年杨老师的题目,合计269道选择题;章节划分为导论加17个章节(共18章节)。出题老师(仅列姓氏)包括林、王、阮、潘、杨、钱、罗、黄
- 自定义
- 内置题库:支持毛概、习概等课程题库。
- 多种练习模式:速刷、答题、错题回顾。
- 错题本:按课程 / 自定义题库分别记录,不会混在一起。
- 多用户本地数据:每个用户的记录、错题、设置独立保存。
- 快捷键:支持 A-E 选项、Enter、方向键、Esc,并可在设置中自定义。
- 手机访问:电脑运行后,可在同一局域网内用手机浏览器访问练习。
- 自定义题库:支持新建/编辑课程、章节、题目、选项和答案。
- JSON 导入:可直接粘贴符合格式的 JSON 题库导入为自定义题库。
- AI 生成题库:支持 OpenAI 兼容接口,把文字材料生成选择题后保存到自定义题库。
从 Releases 下载对应平台的可执行文件:
- Windows:
Meow-Politics-Helper-windows-amd64.exe - Windows ARM64:
Meow-Politics-Helper-windows-arm64.exe - Linux:
Meow-Politics-Helper-linux-amd64 - Linux ARM64:
Meow-Politics-Helper-linux-arm64 - macOS Intel:
Meow-Politics-Helper-darwin-amd64 - macOS Apple Silicon:
Meow-Politics-Helper-darwin-arm64
下载后直接运行即可。Windows 用户通常双击 .exe,程序启动后会自动打开浏览器页面。
在首页进入“自定义题库管理”,可以:
- 新建自定义课程和章节。
- 手动增删改题目、选项、正确答案。
- 把 JSON 题库粘贴导入。
- 使用 AI API 根据文字材料生成题目。
JSON 导入支持标准数组格式,题目字段建议包含:
[
{
"question_number": "AI-001",
"question_type": "单选题",
"question_text": "题干文本",
"options": {"A": "选项A", "B": "选项B", "C": "选项C", "D": "选项D"},
"correct_answer": "A"
}
]AI 生成功能使用 OpenAI 兼容接口,需要在页面中填写:
- Base URL,例如
https://api.openai.com/v1或兼容网关地址。 - API Path,默认
/chat/completions。 - API Key。
- Model。
DeepSeek 或第三方网关请使用服务商实际支持的模型名。例如某些 DeepSeek 网关只接受 deepseek-v4-pro 或 deepseek-v4-flash,传入不支持的模型名会返回 400。
API Key 只保存在本机 user_data/<用户名>/ai_config.json,不会上传到项目服务器。本项目是本地工具,请自行保护好电脑上的用户数据目录。
当前版本暂不开放文件上传解析。PDF、DOCX、图片识别会作为未来计划处理;现在请先把材料文字复制到输入框,或在外部工具生成 JSON 后使用“导入题库(粘贴 JSON)”。
AI 生成的题目建议人工检查。不同第三方 API 或模型网关可能存在忽略材料、返回无关内容、模型名不兼容等问题。
程序运行后,在页面中打开“手机访问”即可看到局域网地址。手机和电脑需要连接到同一个网络;如果打不开,请检查防火墙或网络隔离设置。
用户数据默认保存在项目运行目录下的 user_data/:
- 用户配置和练习记录。
- 错题本。
- 自定义题库。
- AI API 配置。
发版或分享程序时,不要把自己的 user_data/ 一起打包。
需要 Go 环境。
go test ./...
go build -o Meow-Politics-Helper.exe .构建后运行生成的可执行文件即可。
本项目使用 MIT License,详见 LICENSE。
欢迎通过 GitHub Issues 反馈问题或建议:
🎉 祝学习愉快!