SeerExam

SeerExam 1.1.0 is a local-first, reusable workflow for producing and auditing Chinese high-school mathematics exam solutions and grading reports.

Each exam can produce two primary deliverables:

• 专用全解析: a verified main solution plus genuinely different transfer and enrichment methods.
• 学生答题分析与提升方案: faithful transcription, itemized scoring, correction, diagnosis, and the complete original answer card at the end.

The PDF artifact route is deliberately single-path:

LaTeX source
  -> XeLaTeX twice
  -> PDF text audit
  -> full-page rendering
  -> contact-sheet and high-risk-page inspection
  -> exact SHA-256 release manifest

Privacy boundary

This public repository contains reusable source code, templates, tests, and documentation only. Real exam instances, student answer cards, handwriting, grades, operational manifests, and local handoff snapshots remain local and are ignored by Git.

Never force-add files from exams/<exam-id>/, manifests/*.json, or docs/HANDOFF.md to a public clone. Use synthetic data in tests and examples. GitHub releases for this repository are source-only.

Requirements

• Python 3.10 or newer
• Windows PowerShell 5.1 or PowerShell 7
• pytest and Pillow for development checks
• XeLaTeX for PDF compilation
• Poppler commands pdftotext and pdftoppm for audit and rendering

Quick start

git clone https://github.com/Taurusxw/SeerExam.git
Set-Location SeerExam
python -m pip install pytest pillow
python scripts/audit_project.py
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/init_exam.ps1 `
  -ExamId 2026-summer-04 `
  -ExamTitle "2026年暑期数学第四次测试" `
  -StudentName "示例学生"

The initializer publishes exams/<exam-id>/ only after both workspaces are completely copied, substituted, and checked.

Layout

SeerExam/
  docs/                 rules, architecture, development, and release records
  templates/            fixed solution and grading templates
  scripts/              initialization, build, audit, hashing, and health tools
  exams/                local private exam instances; only README.md is public
  manifests/            local operational receipts; only README.md is public
  tests/                 synthetic governance and audit tests

Start with docs/DOC_INDEX.md. Historical material is evidence, not an active template; initialize new work from templates/.

Validation

python scripts/audit_project.py
python -m pytest -q

Compiling a real exam additionally requires the full source, mathematical, rendering, and visual-inspection gates documented in docs/RULES.md.

License

SeerExam-owned material is released under the MIT License. Bundled ElegantBook class files remain under LPPL-1.3c-or-later; see THIRD_PARTY_NOTICES.md.

Contributions and security reports are covered by CONTRIBUTING.md and SECURITY.md.