中考真题检索 Skill

搜索并下载全国各地中考真题试卷（中考/初中学业水平考试），支持各科、各省、各年份。从多个免费来源自动搜索、下载、验证试卷文件。

工作流程

第1步：明确需求

确认以下信息：

• 省份/城市：如"湖南长沙"、"北京"、"上海"
• 科目：语文、数学、英语、物理、化学、道德与法治、历史、地理、生物
• 年份：如 2021-2025
• 是否需要答案：含答案 vs 原卷版

第2步：搜索资源

按来源优先级搜索（详见 references/sources.md）：

搜索方法：

# 使用搜索脚本获取各来源的搜索关键词和URL模式
{baseDir}/scripts/search.sh "湖南长沙" "英语" 2024

然后使用 web_search 工具按输出的 query 字段搜索，获取具体下载页面URL。

第3步：下载文件

从中考网下载（找到页面后提取files.eduuu.com下载链接）：

# 下载文件
python3 {baseDir}/scripts/download.py \
  "https://files.eduuu.com/ohr/2021/06/22/174543_60d1b147d1e67.rar" \
  "/output/2021年湖南长沙中考英语真题.rar"

解压文件：

# ZIP文件
python3 -c "import zipfile; zipfile.ZipFile('文件.zip').extractall('.')"

# RAR文件（需要安装unar: brew install unar）
unar -o /output/dir "文件.rar"

特殊情况（详见 references/edge-cases.md）：

• 全省统一命题：搜索"XX省中考"而非"XX市中考"
• 只有图片版：逐张下载PNG图片
• RAR文件：需安装unar

第4步：验证文件（关键步骤，不可跳过！）

# 验证文件的真实性和完整性
python3 {baseDir}/scripts/verify.py \
  "/path/to/2021年湖南长沙中考英语真题.docx" \
  2021 "湖南长沙" "英语"

验证脚本自动检查：

1. 文件大小（≥50KB）
2. 文件格式与扩展名一致性
3. docx内容关键词（"考试"、"注意事项"、学科关键词）
4. 是否为扫描嵌入版
5. HTML重定向检测（防止下载到登录页）

⚠️ 验证不通过禁止上传到知识库！

第5步：整理与交付

• 统一文件命名：{年份}年{省份}{城市}中考{科目}真题.{扩展名}
• 如有答案：{年份}年{省份}{城市}中考{科目}真题(含答案).{扩展名}
• 记录来源网站和下载链接
• 如需上传到IMA知识库，使用ima-skill的上传流程

质量红线

踩坑经验

• 2024年湖南统一命题：中考网只提供图片版无下载版，免费PDF/DOCX极难获取
• IMA不支持ZIP：上传ZIP会报错，需逐个文件上传
• IMA无删除API：上传错误文件需在客户端手动删除
• 中学英语网：部分资源需要注册登录，但注册免费
• 中考网移动版：m.zhongkao.com有时比www版更容易获取下载链接