普贤教程 › 包参考

pinyin 包

中文拼音（常用字子集）

项	值
包名	`pinyin`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`pinyin.px`
分类	`文本与中文处理`
文件数 / 行数	`1 / 135`

安装与引入

bash

pxpkg init          # 首次
pxpkg add pinyin@0.2.0
pxpkg install

import pinyin

所属分类教程：文本与中文处理

公开接口

函数	参数
`py_lookup`	`ch`
`py_convert`	`s`
`py_convert_list`	`s`

其余 4 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`py_dict`
`py_first_letters`	`s`
`py_has_pinyin`	`ch`
`py_count`	`s`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/pinyin —— 中文拼音（常用字子集）
------------------------------------------------------------
纯函数库（无 IO、无状态），编译（px build）与解释（px run）双模式一致。
py_lookup("中")       → Ok("zhong") | Err（未收录字符）
py_convert("中国")    → "zhong guo"（字级，逐字转拼音，空格分隔）
py_convert_list("你好") → Ok([{ch, py}, ...])
约定：
- 无音调小写拼音；多音字取最常用读书音（如 的→de、长系多音字不收）
- 未收录汉字/非汉字字符原样保留（"abc中"→"abc zhong"）
词表：常用字子集（无生僻字），供 slug/id/拼音首字母等轻量场景。
============================================================
词表数据："字:拼音" 逗号分隔；每行一组，便于阅读与增补