- name
- zhongkao-exam-search
- description
- 搜索并下载全国各地中考真题试卷。触发词：中考真题、中考试卷、中考英语、中考数学、中考语文、中考物理、中考化学、真题下载、历年中考、中考备考、中考复习、湖南中考、长沙中考、北京中考、上海中考、各省中考真题下载
- description_zh
- 搜索并下载全国各地中考真题试卷，支持各科各省各年份
- description_en
- Search and download Zhongkao (Chinese high school entrance exam) test papers across China
- version
- 1.0.0
中考真题检索 Skill
搜索并下载全国各地中考真题试卷（中考/初中学业水平考试），支持各科、各省、各年份。从多个免费来源自动搜索、下载、验证试卷文件。
工作流程
第1步：明确需求
确认以下信息：
- 省份/城市：如"湖南长沙"、"北京"、"上海"
- 科目：语文、数学、英语、物理、化学、道德与法治、历史、地理、生物
- 年份：如 2021-2025
- 是否需要答案：含答案 vs 原卷版
第2步：搜索资源
按来源优先级搜索（详见 references/sources.md）：
| 优先级 | 来源 | 适用范围 | 可靠度 |
|---|---|---|---|
| 1 | 中考网 (zhongkao.com) | 全科 | ⭐⭐⭐ |
| 2 | 中学英语网 (trjlseng.com) | 仅英语 | ⭐⭐⭐ |
| 3 | 第一试卷网 (shijuan1.com) | 全科 | ⭐⭐ |
| 4 | 中学学科网 (zxzyw.cn) | 全科 | ⭐⭐ |
| 5 | 无忧考网 (51test.net) | 全科 | ⭐ |
| 6 | 社交媒体（小红书/微信公众号） | 全科 | ⭐ |
搜索方法：
# 使用搜索脚本获取各来源的搜索关键词和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 "湖南长沙" "英语"验证脚本自动检查：
- 文件大小（≥50KB）
- 文件格式与扩展名一致性
- docx内容关键词（"考试"、"注意事项"、学科关键词）
- 是否为扫描嵌入版
- HTML重定向检测（防止下载到登录页）
⚠️ 验证不通过禁止上传到知识库！
第5步：整理与交付
- 统一文件命名：
{年份}年{省份}{城市}中考{科目}真题.{扩展名} - 如有答案：
{年份}年{省份}{城市}中考{科目}真题(含答案).{扩展名} - 记录来源网站和下载链接
- 如需上传到IMA知识库，使用ima-skill的上传流程
质量红线
| 级别 | 规则 |
|---|---|
| 🔴 禁止 | 用搜索片段拼凑试卷 |
| 🔴 禁止 | 上传未经验证的文件 |
| 🔴 禁止 | 用AI编造/补全题目内容 |
| 🟡 警告 | 扫描嵌入版docx文件较大是正常的 |
| 🟡 警告 | 图片版试卷清晰度可能不足 |
踩坑经验
- 2024年湖南统一命题：中考网只提供图片版无下载版，免费PDF/DOCX极难获取
- IMA不支持ZIP：上传ZIP会报错，需逐个文件上传
- IMA无删除API：上传错误文件需在客户端手动删除
- 中学英语网：部分资源需要注册登录，但注册免费
- 中考网移动版：m.zhongkao.com有时比www版更容易获取下载链接