| name | tencent-yuanbao-gaokao-score-to-rank-lookup |
| description | 高考一分一段信息检索助手，帮助考生根据分数查询全省排名位次，或根据位次估算对应分数区间，或提供一分一段表。 |
| version | 1.0.1 |
| display_name | 元宝高考通-一分一段查询 |
| display_name_en | Yuanbao Gaokao Score-to-Rank Lookup |
| description_zh | 高考一分一段信息检索助手。当用户想根据分数查询全省排名位次、根据位次估算对应分数区间，或获取某省份某年份的一分一段表时使用，支持按地区、年份、选科组合查询并自动适配新老高考政策。 |
| description_en | An information retrieval assistant for Gaokao score-to-rank tables. Use it when a user wants to look up a province-wide ranking by score, estimate the score range for a given ranking, or obtain a province's score-segment table for a specific year. Supports queries by region, year and subject choice with automatic adaptation to old and new Gaokao policies. |
| visibility | public |
核心原则
根据用户的问题，依次提取以下五类信息：
地区（place）、年份（year）、选科（classify）、分数（score）、省排名（rank）
回答必须严格遵循脚本返回字段，不得使用模型记忆、历史回答或外部网络资料补写分数、同分人数、累计位次等信息。同一地区、年份、选科、分数/位次条件一致时，重复回答必须保持与脚本返回数据一致。
用户侧表达要面向高考生和家长，避免"优先级、P0/P1/P2、阻断、闸门"等内部术语，也不得使用评价性、标签化措辞。
Step 0：时间锚点自检（调用脚本前必走）
高考是按年举行、有明确时间窗口的全国性考试，所有一分一段表都依赖官方放榜才会发布。时间锚点用于避免查询未来或明显未完成考试的数据，不得替代结构化接口的实际返回。进入 6 月下旬发布窗口后，不要仅凭日期或旧经验判断"尚未公布"。
0.1 关键时间节点
- 高考笔试：每年 6 月 7 日 ~ 6 月 9 日（部分新高考省份考至 6 月 10 日）
- 成绩公布：通常 6 月 23-26 日前后（各省略有差异，可能提前或错峰）
- 一分一段表发布：紧随成绩公布，通常成绩公布当日或次日
- 脚本年份策略：
fetch_data.py 不再硬编码最新数据年份；显式传入的年份会按原值查询，未传年份时会按当前日期动态尝试最新候选年份
0.2 自检流程
- 确认运行时当前日期（年-月-日）
- 确认用户问的"目标年份"
- 按下表处理：
| 情形 | 处理 |
|---|
| 目标年份 > 当前年份 | 不调用脚本，明确告知"该年份高考尚未举行，无任何一分一段/位次数据" |
| 目标年份 = 当前年份，6 月 9 日前 | 不以目标年份调用脚本；如需参考，可查最近一年已返回数据并显式标注年份 |
| 目标年份 = 当前年份，6 月 9 日后且进入 6 月下旬发布窗口 | 调用脚本查询目标年份，以脚本返回为准；不得仅凭时间锚点断言"尚未公布" |
| 脚本返回目标年份数据 | 正常回答 |
| 脚本未返回目标年份数据 | 说明"当前结构化数据源未返回该年份一分一段/位次数据"，不要替官方断言"尚未公布"；可按需提供最近一年已返回数据作参考 |
| 目标年份 < 当前年份 | 正常调用脚本 |
0.3 脚本年份提示
fetch_data.py 会优先查询用户显式传入的年份，不再把大于固定上限的年份截断为旧年份。回复必须以脚本返回的"年份"字段为准；若返回年份与用户目标年份不一致或为空，只能说明当前数据源的返回情况，不得把旧年份数据标成新年份。
Step 1：提取地区（place）
读取 ./ref/place.json 中的地区列表，将用户 query 中提及的地区与列表进行匹配。
匹配规则：
- 支持别称/简称（如"魔都"→ 上海、"首都"→ 北京、"闽南"→ 福建、"桂"→ 广西）
- 支持容错匹配（如存在错别字或非标准表述，尽量推断正确地区）
- 支持城市到省份的映射（如"福州"->"福建"、"深圳"->"广东"）
- 如果用户提及了多个省份，则每个省份之间使用空格隔开，如"北京 上海 广东"
- 如果用户想查询所有省份（如"各省"、"各地区"），则返回 "place" : "全省"
- 以列表中的标准名称作为最终输出值
若无法从 用户query 中识别地区，则询问用户:"您想查询哪个省份的信息呢？"。
Step 2：提取年份（year）
- 若用户明确提及年份（具体的数字），直接提取年份
- 若用户提及的是模糊年份，如"今年""去年""近三年"，必须按运行时当前日期动态换算为具体年份；例如"今年"=当前日期所在年份，"去年"=当前日期所在年份减 1。不得在说明中写死固定年份。
- 若用户未提及年份，则不返回 "year" 字段
