gaokao-assistant

gaokao-cli

通过命令行查询中国高考数据。数据来源：掌上高考 (gaokao.cn)，由中国教育在线运营，隶属于教育部。

前置条件

必须将 gaokao-cli 安装到 ~/.local/bin/gaokao-cli。无需 WebBridge 或浏览器——所有数据均来自公共 CDN JSON API。

命令

1. 列出省份

gaokao-cli provinces

返回全部 31 个省份及其 ID。在其他命令中使用省份名称（例如 北京）或 ID（例如 11）。

2. 分数线（省控线/批次线）

gaokao-cli score-line --province 北京
gaokao-cli score-line --province 北京 --year 2025
gaokao-cli score-line --province 河南 --year 2025 --type 物理类

标志	简写	必填	说明
--province	-p	是	省份名称或 ID
--year	-y	否	年份（默认：最新年份）
--type	-t	否	综合/理科/文科/物理类/历史类

3. 分数段（一分一段表）

# Full table
gaokao-cli score-section --province 北京 --year 2025

# Lookup specific score — returns rank, count, and 同位分 (equivalent scores in prior years)
gaokao-cli score-section --province 天津 --year 2025 --score 650

# Old gaokao provinces with 文理分科
gaokao-cli score-section --province 河南 --year 2024 --type 理科 --score 600

标志	简写	必填	说明
--province	-p	是	省份名称或 ID
--year	-y	否	年份（默认：最新年份）
--type	-t	否	综合/理科/文科/物理类/历史类
--level	-l	否	本科/专科
--score	-s	否	要查询的具体分数

主要功能： 每条记录都包含 appositive_fraction，即往年相同位次对应的分数（同位分），对于跨年对比非常有用。

4. 院校查询

gaokao-cli school --name 清华
gaokao-cli school --985
gaokao-cli school --211 --province 北京
gaokao-cli school --dual-class --province 上海

标志	简写	必填	说明
--name	-n	否	按名称模糊搜索
--province	-p	否	按省份筛选
--985		否	仅限 985 高校
--211		否	仅限 211 高校
--dual-class		否	仅限双一流高校
--level	-l	否	本科或专科

5. 批次改革历史

gaokao-cli batch-history --province 北京
gaokao-cli batch-history   # all provinces

显示各省份合并批次或从文理分科切换到新高考模式的时间。了解这些背景信息对于解读历史分数线至关重要。

输出格式

所有命令均向标准输出输出 JSON：

• 成功：{"ok": true, "data": ...}
• 错误：{"ok": false, "error": {"code": "...", "message": "..."}}

数据覆盖范围

• 中国大陆 31 个省份
• 分数线： 2014–2025 年（因省份而异）
• 一分一段表： 2016–2025 年（因省份而异）
• 院校： 约 2,957 所，包括 985/211/双一流标签

省份科类类型

不同省份采用不同的科类划分方式：

类型	说明	适用省份
综合	综合（3+3 模式）	北京、天津、上海、浙江、山东、海南
物理类/历史类	物理/历史选科（3+1+2 模式）	广东、湖北、湖南、河北、福建、重庆、辽宁、江苏 + 2025 年新增
理科/文科	传统理科/文科	其余省份（随着改革推进，数量逐渐减少）

使用 batch-history 查询各省份切换模式的时间。