gaokao-assistant

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

gaokao-cli

Query Chinese college entrance exam (高考) data from the command line. Data source: 掌上高考 (gaokao.cn), operated by China Education Online (中国教育在线), under the Ministry of Education.

从命令行查询中国高考（大学入学考试）数据。数据来源：掌上高考（gaokao.cn），由教育部下属的中国教育在线运营。

Prerequisites

前置条件

gaokao-cli

must be installed at

~/.local/bin/gaokao-cli

. No WebBridge or browser required — all data comes from public CDN JSON APIs.

gaokao-cli

必须安装在

~/.local/bin/gaokao-cli

路径下。无需WebBridge或浏览器——所有数据均来自公开CDN JSON API。

Commands

命令

1. List provinces

1. 列出省份

bash

gaokao-cli provinces

Returns all 31 provinces with IDs. Use province names (e.g.

北京

) or IDs (e.g.

) in other commands.

bash

gaokao-cli provinces

返回所有31个省份及其ID。在其他命令中可使用省份名称（如

北京

）或ID（如

）。

2. Score lines (省控线/批次线)

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

bash

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

Flag	Short	Required	Description
`--province`	`-p`	Yes	Province name or ID
`--year`	`-y`	No	Year (default: latest)
`--type`	`-t`	No	综合/理科/文科/物理类/历史类

bash

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. Score section (一分一段表)

3. 一分一段表

bash

undefined

bash

undefined

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


| Flag | Short | Required | Description |
|------|-------|----------|-------------|
| `--province` | `-p` | Yes | Province name or ID |
| `--year` | `-y` | No | Year (default: latest) |
| `--type` | `-t` | No | 综合/理科/文科/物理类/历史类 |
| `--level` | `-l` | No | 本科/专科 |
| `--score` | `-s` | No | Specific score to lookup |

**Key feature:** Each entry includes `appositive_fraction` — equivalent scores in previous years for the same rank (同位分), invaluable for cross-year comparison.

gaokao-cli score-section --province 河南 --year 2024 --type 理科 --score 600


| 参数 | 缩写 | 是否必填 | 描述 |
|------|-------|----------|-------------|
| `--province` | `-p` | 是 | 省份名称或ID |
| `--year` | `-y` | 否 | 年份（默认：最新年份） |
| `--type` | `-t` | 否 | 综合/理科/文科/物理类/历史类 |
| `--level` | `-l` | 否 | 本科/专科 |
| `--score` | `-s` | 否 | 要查询的特定分数 |

**核心功能：** 每条记录包含`appositive_fraction`——对应排名在往年的等效分数（同位分），这对跨年份对比至关重要。

4. School search (院校查询)

4. 院校查询

bash

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

Flag	Short	Required	Description
`--name`	`-n`	No	Fuzzy name search
`--province`	`-p`	No	Filter by province
`--985`		No	985 universities only
`--211`		No	211 universities only
`--dual-class`		No	双一流 universities only
`--level`	`-l`	No	本科 or 专科

bash

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. Batch reform history (批次改革历史)

5. 批次改革历史

bash

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

Shows when provinces merged batches or switched from 文理分科 to new gaokao model. Essential context for interpreting historical score lines.

bash

gaokao-cli batch-history --province 北京
gaokao-cli batch-history   # 所有省份

展示各省合并批次或从文理分科切换至新高考模式的时间。这是解读历史分数线的重要背景信息。

Output format

输出格式

All commands output JSON to stdout:

Success:
```
{"ok": true, "data": ...}
```

Error:

{"ok": false, "error": {"code": "...", "message": "..."}}

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

成功：
```
{"ok": true, "data": ...}
```

错误：

{"ok": false, "error": {"code": "...", "message": "..."}}

Data coverage

数据覆盖范围

31 provinces across mainland China
Score lines: 2014–2025 (varies by province)
一分一段表: 2016–2025 (varies by province)
Schools: ~2,957 institutions including 985/211/双一流 tags

31个省份：覆盖中国大陆所有省份
分数线：2014–2025年（不同省份覆盖范围略有差异）
一分一段表：2016–2025年（不同省份覆盖范围略有差异）
院校：约2957所院校，包含985/211/双一流标签

Province subject types

省份选考类型

Different provinces use different subject classification:

Type	Description	Used by
综合	Comprehensive (3+3 model)	北京, 天津, 上海, 浙江, 山东, 海南
物理类/历史类	Physics/History track (3+1+2 model)	广东, 湖北, 湖南, 河北, 福建, 重庆, 辽宁, 江苏 + 2025新增
理科/文科	Traditional Science/Arts	Remaining provinces (shrinking as reform spreads)

Use

batch-history

to check when a province switched models.

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

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

可使用

batch-history

命令查询省份切换模式的时间。