越南语

rime‑vietnamese‑pinyin 是一套面向 Rime 中州韵引擎的越南语完整输入配方，原生同时支持Telex 、全拼音、拼音首码三种主流输入范式，内置越‑汉对照词库，适合越南语学习者、翻译、外贸从业者。基于开源 Rime 实现，无广告、完全本地离线， Windows 小狼毫、 mac 鼠须管、 Linux fcitx5‑rime 、安卓 Trime 全平台通用。

市面上很多越南语 Rime 方案只单一支持 Telex ，本项目兼顾国内中文使用者习惯，既可以用越南本土标准 Telex 打法，也能使用汉语拼音逻辑输入越南语，候选栏附带中文释义，边输入边查阅词义，兼顾写作与语言学习两大场景。仓库同时附带完整的词库维护工具链， Excel/Web UI 可视化编辑词表，自定义扩充词条非常便捷 GitHub 。

三种输入模式

1. Telex 模式（越南本土标准）

越南国内最通用输入范式，字母后置添加声调与变音符号。输入如vieejt nam输出Việt Nam，完整支持ă â ê ô ơ ư đ等特殊字母以及全部 6 个声调，适配熟悉越南本地键盘习惯的用户。

2. 全拼音模式

类似汉语拼音的拼写方式，直接输入越南语完整读音，候选附带中文释义，适合刚入门、还不熟练 Telex 规则的中文学习者。

3. 拼音首码模式

只输入每个音节首字母，快速检索完整词汇，长词组输入效率高，适合快速打短句。

候选栏支持左右方向键翻页切换，每条越南词条附带简明中文释义对照，写作同时可以查阅词义 GitHub 。

两套 Schema 方案

1. vn.schema.yaml （ vn.dict.yaml ）：主力越南国语字（ Chữ Quốc ngữ）输入， Telex / 拼音 / 首码三模式合一，日常越南语聊天、文档写作首选。
2. vn_han.schema.yaml （ vn_han.dict.yaml ）：增强扩展版本，集成汉字、喃字、中日韩反查能力；依赖 stroke 、 terra‑pinyin 等外部方案，需要提前部署对应字典，适合做文史、喃字相关研究。

词库维护能力

该项目一大特色是配套完整的词库自动化维护工具，普通用户也可以自行扩充、修订词库，无需手写 yaml 码表：

1. Excel 源文件 VietnameseWordList.xlsx A 列为越南语， B 列为中文释义；脚本自动生成拼音、 Telex 编码，导出 Rime dict 词库，只需要维护越南词汇与中文翻译两列即可。
2. Python 转换脚本excel_to_vndict.py：读取 Excel ，自动生成vn.dict.yaml与vn_han.dict.yaml。
3. Web 可视化 UI 工具：启动本地网页服务，浏览器内完成词条搜索、编辑、分页浏览、导入导出；支持导入 TypeTwo 格式词库，自动备份原始 Excel ，降低词库维护门槛。
4. 校验脚本：自动检查 yaml 格式、重复词条，搭配 GitHub Actions 做 CI 自动校验，防止生成损坏词库。

# 启动 Web 词库管理界面 Windows
start_web_ui.bat
# 或命令行
python make_dict/web_ui.py --port 8765

部署教程

1. 下载仓库，复制 4 个核心 yaml 文件到 Rime 用户目录
   • Windows ：%APPDATA%\Rime
   • macOS ：~/Library/Rime
   • Linux ：~/.config/ibus/rime
   • 安卓 Trime ： Rime 资源文件夹
   文件清单：vn.schema.yaml、vn.dict.yaml、vn_han.schema.yaml、vn_han.dict.yaml
2. 修改default.custom.yaml启用方案：

schema_list:
  - schema: vn
  # - schema: vn_han # 需要喃字/多语言反查时启用

3. 输入法托盘执行重新部署，快捷键Ctrl + ~切换到越南拼音方案即可使用。

提示：vn_han汉字反查功能依赖外部字典，如果没有安装对应依赖，反查部分功能会失效，单纯输入越南国语字只需要上面 4 个基础文件。

项目词库来源

• 7184 条越南常用基础字库，附带 Telex 与拼音编码；
• 3600 条基础常用词汇表；
• 可导入 TypeTwo 兼容 JSON 词表扩充；
• 参考已有开源 rime‑vietnamese 、喃字输入法项目语料整理。