Exam Paper Generator - 考试试卷生成器

功能概览

数据目录

所有题库和错题数据存储在 ~/.qclaw/workspace/exam-data/：

• questions/ — 题库JSON文件（按学科命名，如 informatics.json）
• errors/ — 错题记录JSON文件（如 informatics_errors.json）

工作流程

1. 生成试卷PDF

用户说"出一套信息学奥赛试卷"或"组卷"时：

1. 确认参数：学科（默认informatics）、题目数量、难度、知识点范围
2. 运行导出命令生成exam JSON：

```

python -X utf8 /scripts/manage_bank.py export --subject informatics --count 15 --outdir ~/.qclaw/workspace/exam-data

```

1. 运行PDF生成：

```

python -X utf8 /scripts/gen_pdf.py --outdir ~/Desktop

```

1. 确认输出两个PDF：试卷 + 答案

2. 管理题库

• 初始化：python -X utf8 /scripts/manage_bank.py init
• 查看题库：python -X utf8 /scripts/manage_bank.py list --subject informatics
• 添加题目：准备符合格式的JSON文件，然后：

python -X utf8 /scripts/manage_bank.py add

• 随机选题：python -X utf8 /scripts/manage_bank.py random --subject informatics --count 10

3. 错题管理

• 记录错题：python -X utf8 /scripts/manage_bank.py error-add
• 查看错题：python -X utf8 /scripts/manage_bank.py error-list --subject informatics
• 标记已复习：python -X utf8 /scripts/manage_bank.py error-mark

添加新题目

题目JSON格式（添加到题库）：

{
  "subject": "informatics",
  "questions": [
    {
      "id": "info_016",
      "type": "choice",
      "topic": "python",
      "difficulty": 1,
      "text": "题目内容（ ）。",
      "options": ["A. 选项1", "B. 选项2", "C. 选项3", "D. 选项4"],
      "answer": "B",
      "answer_desc": "简短答案",
      "explanation": "解析说明"
    }
  ]
}

题目类型(type)：

• choice — 选择题（需有options字段）
• judgment — 判断题（answer为"✓ 正确"或"✗ 错误"）
• programming_fill — 编程填空题（需有code和fills字段）

知识点(topic)参考：references/informatics.md

扩展新学科

1. 在 exam-data/questions/ 创建新学科JSON（如 math.json）
2. 按相同格式添加题目（id前缀改为学科缩写，如 math_001）
3. 运行 manage_bank.py add math_questions.json 导入
4. 组卷时指定 --subject math

考试格式配置参考：references/exam-formats.md

注意事项

• 所有Python脚本必须用 python -X utf8 运行（Windows编码兼容）
• 生成PDF需要reportlab库（pip install reportlab）
• 题目id不能重复，添加时脚本会自动跳过已存在的id
• 编程填空题的code字段中，< 和 > 会在PDF渲染时自动转义

ClawHub 发布信息

• 版本：1.0.0
• 技能ID：k97dw1dg2h2zae5arhpdnt7281864we0
• 安装：clawhub install exam-paper