<!-- capability_id: cap.xinhua-dictionary.xinhua-hanzi-lookup | revision: 1 | status: active -->
汉字查检(xinhua-hanzi-lookup)
R — 原文(数据实态)
> 【6644】了 le(汉字册·全本 txt 行 362218)
> 部首:乙 笔画:2
> 释义:
> 了〈助〉 le
> 用在动词或形容词后,表示完成
> ……
> 了liǎo
> ⒈懂得,明白~然。明~。~如指掌。
> ⒉结束,完毕此事已~。没完没~。
(来源:汉字册【6644】;同形态另见【12961】行、【15212】着)
I — 自述
本能力回答"一个汉字"的问题:怎么读、几画、什么部首、什么意思。数据底座是汉字册 word.json(16,142 条 / 14,809 个唯一字)。核心骨架有三条,都是这套数据特有的:
- 多音字是"双轨表示":pinyin 字段只存头读音,其余读音以「字+拼音」子块内嵌在 explanation 正文里(「着」一条含 zhe/zhao/zhāo/zhuó 四节)。要拿全读音必须同时看 pinyin 与 explanation 内嵌子块;另有 1,332 个字(多为生僻字)存在两条字段值不同的条目(如"裞"存 ā/shuì 两条),按字聚合后合并输出。
- 部首缺失是常态:56%(9,044 条)radicals 为空串。查不到部首要明说"数据源未收录",禁止猜测补造。
- 拼音是脏的:混入 IPA 字符 ɡ(U+0261)/ɑ(U+0251)(3,167 条,其中 646 条以此开头),取首字母/排序/等值比较前必须归一,否则静默漏检。
A1 — 数据中的实例
- 「了」:条目头只标 le;释义内返回 le(助词)与 liǎo(懂得/结束)两节,各带组词。→ 只数条目会答"1 个读音",错。
- 「行」:单条目含 hang(道路义)/ háng(量词)/ xíng(出行义)三分节,附《说文》书证。→ 完整读音集须从释义分节提取。
- 「嗄」:pinyin=á,explanation 内嵌 á/shà/a/xià 四读——单条内最多读音分节的形态。
A2 — 未来触发
场景:①"某字怎么读/拼音是什么";②"某字几画/什么部首";③"某字什么意思";④多音字辨析("了有几个读音");⑤文本里遇到生僻字。
语言信号:怎么读、拼音、几画、笔画、部首、什么意思、多音字、读音(how to pronounce / stroke count / radical / pinyin of …)。
与相邻能力的区分:查词语释义 → xinhua-ciyu-lookup;查成语 → xinhua-idiom-lookup;要英文对译或逐义项古书证 → 路由入口的"字册深档"卡;字在词语里且词语册无注音 → 跨册反查卡。
E — 可执行步骤
- 定位数据:
<skill目录>/data/word.json(7 字段:word/oldword/strokes/pinyin/radicals/explanation/more)。 - 匹配:对查询字做 IPA 归一无关(字是汉字直接等值匹配);若用户给的是拼音,先 ɡ→g、ɑ→a 归一再去调比对。
- 聚合:按字取全部条目(1 或 2 条);从 explanation 按「字+拼音」子块(兼容 ⒈ 与 1. 两种编号)提取内嵌读音分节,与 pinyin 头读音合并成 {读音: [义项+组词]} 映射。
- 输出档案:拼音(全部读音)/ 部首(缺失则明说)/ 笔画 / 释义。释义超长(最长 1,221 字)时先给要点再展开。
- 判停:字不在字表 → 检查是否异体字形(絶/緑/録 等,走质量闸映射,见 B)→ 仍无则降级为"数据源未收录该字",禁止猜音。
B — 边界
- 本数据是社区整理集合(chinese-xinhua),不是商务印书馆官方《新华字典》,释义深浅与收词范围均不等同官方,仅宜轻量查检/学习用途;权威场景应提示用户查官方辞书。
- 部首 56% 缺失——"按部首查字"只能覆盖有部首的 7,098 条。
- oldword 字段有对位噪声("锕"挂"録"),不可当异体字反查主键。
- 单字查询一律字册优先;词语册的 332 条单字条目无注音,仅作补充释义。
- 释义文本引号可能不完整(右引号多于左引号 6,371 条),展示时按原文并声明体例,不要"修复"。