用途
gaokao-assistant（命令行工具 gaokao-cli）用于在命令行中查询中国高考（Chinese college entrance exam）相关数据。数据来源为掌上高考（gaokao.cn），由中国教育在线（China Education Online）运营，隶属教育部。所有数据来自公开的 CDN JSON API，无需 WebBridge 或浏览器。
前置条件
gaokao-cli 必须安装在 ~/.local/bin/gaokao-cli。
主要能力
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. 一分一段表
完整表格
gaokao-cli score-section --province 北京 --year 2025
查询特定分数——返回位次、人数及同位分
gaokao-cli score-section --province 天津 --year 2025 --score 650
文理分科的老高考省份
gaokao-cli score-section --province 河南 --year 2024 --type 理科 --score 600
参数：--province/-p（必填）、--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 # 全部省份
显示各省合并批次或从文理分科切换到新高考模式的时间。这是解读历史分数线的必要背景。
输出格式
所有命令向 stdout 输出 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 查看某省份何时切换模式。
适用场景
适用于需要查询高考省控线、一分一段表位次、同位分、院校信息（含 985/211/双一流筛选）以及批次改革历史的用户，尤其是进行跨年分数比较和录取参考的场景。
限制
- 需预先安装 gaokao-cli 至 ~/.local/bin/gaokao-cli。
- 数据覆盖范围因省份和年份而异（省控线 2014–2025，一分一段表 2016–2025）。
- 其他功能、收费、价格、平台或效果信息暂未提供。