展开本页目录
开始前准备什么
- 下载本题完整练习包，区分待实现 starter 与作者完成 reference。
- 按README准备本题原生依赖；所有输入均为原创或明确标注的本地fixture。
- 本地练习不需要付费模型Key；真实模型调用未执行，MiniLM题另有明确实际推理说明。
- 准备三十条目
- 生成拼音索引
- 加入多音词典
- 测试首字母
- 检查空命中
- 比较全拼原文
- 保留排序规则
下载本题完整练习工程
原创输入、待完成starter、作者reference及实际运行产物，依README本地准备依赖。
查看启动命令与执行边界
环境要求、具体操作、产物核对与未运行范围。
1. 准备三十条目
列表包含三十条原创名称，有重庆、银行、长沙和带重音的Café。输入数据和预期场景随下载包提供，不使用模型猜每次查询的拼音。
2. 生成拼音索引
用 pinyin-pro 原生库生成无声调全拼和首字母，并为英文做小写与重音规范化。原文索引单独保留，不能把所有信息都替换成拼音。
本地启动与复现
text
cd reference
npm install
npm run build
python3 -m http.server 87873. 加入多音词典
显式配置重庆与银行的词典读音，避免把重和行按错误单字读音拼接。词典只保证本练习条目，需要覆盖更多地名人名时继续扩充输入集。
4. 测试首字母
输入 cq，真实界面命中重庆路线与重庆咖啡。按原文、全拼、首字母三个级别排序，同级再按稳定输入顺序，结果能解释。
5. 检查空命中
输入不存在的组合，列表应变为空，并明确显示零命中。不能在无结果时悄悄保留上一轮列表，否则读者会误以为查询成功。
6. 比较全拼原文
分别输入 yinhang 与 cafe，核对银行两项、带重音与不带重音的两项都能被找到。原文匹配优先，首字母不会压过更精确的原文结果。
7. 保留排序规则
下载原始三十项和实际查询结果。用Cursor扩展时要求加入多音词、重音、空结果与同首字母干扰；作者参考运行了原生库，没有运行Cursor账号生成。
怎样确认已经完成
- cq和yinhang命中指定多音词条，原文/全拼/首字母排序可解释。
- cafe同时命中带重音与不带重音名称。
- 无匹配组合显示零条，原始三十条数据未被改写。
常见问题
中文列表怎么输入拼音或首字母就能搜出来？
预先生成原文、无声调全拼和首字母索引，按匹配精确程度排序，浏览器本地即可完成，不必每次调模型。
重庆、银行这些多音词，拼音搜索怎么不搜错？
给已知词配置词典并加入真实回归输入。本题重庆和银行按指定读音核对，不声称单字默认规则能覆盖所有人名地名。
哪些部分实际运行，哪些需要独立验证？
pinyin-pro实际生成三十条索引，首字母、全拼、多音词典、重音和空结果均在浏览器核对。 目标AI助手账号生成、云平台部署和生产环境不在本次执行范围。