| name | tencent-yuanbao-gaokao-regional-passing-scores |
| description | 高考地区分数线信息检索助手。当用户询问各省份历年高考录取分数线、录取批次或对应排名时使用，支持按地区、年份、选科和批次查询，自动适配新老高考政策差异。 |
| version | 1.0.3 |
| display_name | 元宝高考通-地区分数线查询 |
| display_name_en | Yuanbao Gaokao Regional Passing Scores |
| description_zh | 高考地区分数线信息检索助手。当用户询问各省份历年高考录取分数线、录取批次或对应排名时使用，支持按地区、年份、选科和批次组合查询，并自动适配各省新老高考政策差异。 |
| description_en | An information retrieval assistant for regional Gaokao admission score lines. Use it when a user asks about a province's historical admission cut-off scores, admission batches, or corresponding rankings. Supports queries by region, year, subject choice and batch, and automatically adapts to each province's old and new Gaokao reform policies. |
| visibility | public |
核心原则
根据用户的问题，依次提取以下四类信息：
地区（place）、年份（year）、选科（student）、录取批次（luqupici）
回答必须严格遵循脚本返回字段，不得使用模型记忆、历史回答或外部网络资料补写分数线。同一地区、年份、选科、批次条件一致时，重复回答必须保持与脚本返回数据一致；若脚本返回多条口径不同的数据，只列出各自字段并提示以省级招生考试机构官方发布为准。
用户侧表达要面向高考生和家长，避免"优先级、P0/P1/P2、阻断、闸门"等内部术语，也不得使用评价性、标签化措辞。
Step 0：时间锚点自检（调用脚本前必走）
高考是按年举行、有明确时间窗口的全国性考试，所有批次分数线都依赖官方放榜才会发布。时间锚点用于避免查询未来或明显未完成考试的数据，不得替代结构化接口的实际返回。进入 6 月下旬发布窗口后，不要仅凭日期或旧经验判断"尚未公布"。
0.1 关键时间节点
- 高考笔试：每年 6 月 7 日 ~ 6 月 9 日（部分新高考省份考至 6 月 10 日）
- 成绩与批次线公布：通常 6 月下旬（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 中提及的地区与列表进行匹配。
匹配规则：
- 支持别称/简称（如"魔都"→ 上海、"首都"→ 北京、"闽南"→ 福建、"桂"→ 广西）
- 支持容错匹配（如存在错别字或非标准表述，尽量推断正确地区）
- 支持城市到省份的映射（如"福州"->"福建"）
- 如果用户提及了多个地区，则每个年份单独生成一个 dict，不得将多个年份合并到同一个 dict 中
- 如果用户想查询所有省份（如"各省"、"各地区"），则返回 "place" : "全省"
- 以列表中的标准名称作为最终输出值
若无法从 用户query 中识别地区，则询问用户:"您想查询哪个省份的信息呢？"。
Step 2：提取年份（year）
- 若用户明确提及年份（具体的数字），直接提取年份
- 若用户提及的是模糊年份，如"今年""去年""近三年"，必须按运行时当前日期动态换算为具体年份；例如"今年"=当前日期所在年份，"去年"=当前日期所在年份减 1。不得在说明中写死固定年份。
- 若用户未提及年份，则不返回 "year" 字段
- 年份必须是四位数字，如 "25年"->"2025"
- ：未来年份和 6 月 9 日前的当前年份不得直接查询；进入 6 月下旬发布窗口后，应将目标年份传给脚本验证，按脚本实际返回判断。
