xpinyin：关于文档中「v」和「ü」的说明的一处疑惑？

[Explorer-cc]

在 75766ee 之后的 xpinyin 包中，文档描述为：

其中表述是：

为了输入的方便 ü 可以用 v 代替

按我个人理解，如果用户不需要这个替换，也可以使用不容易输入的「ü」，考虑如下 MWE：

\documentclass{ctexart}
\usepackage{xpinyin}

\begin{document}

\pinyin{nv3}

\pinyin{nü3}

\end{document}

这里似乎不能正常识别到「ü」。是应该修改文档描述，还是我的用法有误呢？

[github-actions]

💬 回答 #1069

你的用法并不是文档当前实现所支持的输入形式。这里的说明是：在需要输入拼音 ü（文档示例写作 \{"u}）时，可以用 ASCII 字符 v 代替；它不是在承诺 \pinyin 会把任意直接输入的 Unicode 字符 ü 当作拼音韵母解析。

因此请使用：

\pinyin{nv3}

\pinyin 的解析器会识别数字声调，并在 l 或 n 后把 v 转换为 ü；实现中的 v 替换逻辑见 xpinyin.dtx 第 1049–1060 行，带声调的 v 处理见第 1116–1125 行。当前回归测试也明确覆盖了 nv3、lv1 等写法。

所以，这更像是文档表述不够明确：建议补充“v 是输入 ü 的替代写法，直接输入 Unicode ü 目前不作为同义输入处理”。

---

由 codex / gpt-5.6-sol 生成；本流程只分析，不自动修改代码。