本文介绍一种基于键盘布局映射的拉丁→西里尔转换方法，适用于俄语“键盘音译”（如“ghbdtn”→“привет”），区别于标准音译（transliteration），强调位置对应而非发音对应。
在俄语母语者日常输入中，常使用英文键盘快速拼写俄语单词——并非按发音转写（如 privet → привет），而是依据俄文键盘在QWERTY布局上的物理位置进行映射：例如英文键盘的 G 键位于俄文键盘的 П 键位置，H 对应 Р，B 对应 И……因此 “ghbdtn” 逐键映射即得 “привет”。这种转换称为 keyboard layout transliteration（键盘布局映射），与 unidecode 所做的 phonetic transliteration（语音转写）有本质区别。
⚠️ 注意：unidecode 库并不支持此映射逻辑。其 unidecode('ghbdtn', 'ru') 实际行为是尝试将拉丁字符串解释为近似俄语发音的拉丁拼写（如 privet），再转为西里尔；对无意义的键盘串（如 ghbdtn）通常返回空字符串或原始输入，无法正确实现题目需求。
✅ 正确做法是构建一个俄文键盘布局到英文键盘的双向映射表。以下为完整、可靠、零依赖的实现方案：
def latin_to_cyrillic_keyboard(input_text: str) -> str:
# 俄语键盘（ЙЦУКЕН）在标准QWERTY上的对应关系（小写）
layout_map = {
'q': 'й', 'w': 'ц', 'e': 'у', 'r': 'к', 't': 'е', 'y': 'н', 'u': 'г', 'i': 'ш',
'o': 'щ', 'p': 'з', '[': 'х', ']': 'ъ', 'a': 'ф', 's': 'ы', 'd': 'в', 'f': 'а',
'g': 'п', 'h': 'р', 'j': 'о', 'k': 'л', 'l': 'д', ';': 'ж', "'": 'э', 'z': 'я',
'x': 'ч', 'c': 'с', 'v': 'м', 'b': 'и', 'n': 'т', 'm': 'ь', ',': 'б', '.': 'ю',
'/': '.',
# 大写映射（可选，根据需要扩展）
'Q': 'Й', 'W': 'Ц', 'E': 'У', 'R': 'К', 'T': 'Е', 'Y': 'Н', 'U': 'Г', 'I': 'Ш',
'O': 'Щ', 'P': 'З', '{': 'Х', '}': 'Ъ', 'A': 'Ф', 'S': 'Ы', 'D': 'В', 'F': 'А',
'G': 'П', 'H': 'Р', 'J': 'О', 'K': 'Л', 'L': 'Д', ':': 'Ж', '"': 'Э', 'Z': 'Я',
'X': 'Ч', 'C': 'С', 'V': 'М', 'B': 'И', 'N': 'Т', 'M': 'Ь', '<': 'Б', '>': 'Ю',
'?': '.',
}
return ''.join(layout_map.get(char, char) for char in input_text)
# 示例使用
print(latin_to_cyrillic_keyboard("ghbdtn")) # 输出：привет
print(latin_to_cyrillic_keyboard("roh[eq")) # 输出：спасибо（谢谢）
print(latin_to_cyrillic_keyboard("Hello!")) # 输出：Нелло!（H→Н, e→е, l→л, l→л, o→о；标点保留）? 关键说明：
- 该函数严格按物理键位映射，不依赖语言模型或发音规则；
- 未定义字符（如数字、空格、多数符号）保持原样，确保安全性与可预测性；
- 支持大小写映射，兼顾实际输入场景；
- 无外部依赖，开箱即用，适合嵌入命令行工具、Web API 或桌面应用。
? 进阶建议：若需支持多语言键盘（如乌克兰语、保加利亚语），可封装为配置驱动模式，通过加载不同布局表实现扩展。但对俄语场景，上述映射已覆盖标准 ЙЦУКЕН 布局（含美式键盘适配）。
总结：解决“ghbdtn → привет”类问题，核心在于识别其本质是键盘布局映射，而非语音转写。抛弃 unidecode 等音译库，采用精准的字符级查表法，才能获得稳定、高效、符合用户直觉的转换结果。
