小狼毫输入法词典扩展包配置指南

词典扩展包的基本概念

小狼毫输入法(Rime)的词典扩展包功能允许用户在不修改核心词典的情况下，通过添加自定义词典包来扩展输入法的词汇量。这种设计既保证了核心词典的稳定性，又为用户提供了灵活的词汇扩展方式。

词典扩展包的配置方法

1. 修改方案配置文件

首先需要在输入法方案的配置文件中指定自定义词典。通常建议在对应的.custom.yaml文件中进行修改，这样可以避免直接修改原始配置文件，便于后续升级维护。

以"朙月拼音"为例，在luna_pinyin.custom.yaml文件中添加以下内容：

patch:
  translator:
    dictionary: my_custom_dict

这里的my_custom_dict就是将要创建的词典名称。

2. 创建词典文件

在同级目录下创建词典文件my_custom_dict.dict.yaml，内容格式如下：

---
name: my_custom_dict
version: "2024.08.23"
sort: by_weight
use_preset_vocabulary: true
import_tables:
  - luna_pinyin
...

# 自定义词汇开始
自定义词汇1	zidingyicihui1
专业术语	zhuanyeshuyu
技术名词	jishumingci

关键参数说明

1. sort: by_weight
   这个参数决定了候选词的排序方式，设置为by_weight表示按词频权重排序。如果不设置此参数，可能会导致候选词排序混乱。

2. use_preset_vocabulary: true
   这个参数控制是否使用预设的词汇处理规则。设置为true可以确保自定义词典能正确处理各种词汇形式。

3. import_tables
   这个列表用于引用其他词典，通常需要包含基础词典(如luna_pinyin)，这样自定义词典才能继承基础词典的所有词汇。

词典扩展包的工作原理

小狼毫输入法的词典系统采用模块化设计：

1. 每个词典扩展包会独立编译生成.bin二进制文件
2. 运行时多个词典可以组合使用
3. 修改单个词典只需重新编译该词典，不影响其他词典

这种设计带来了几个优势：

• 词典包可以独立制作和分发
• 用户可以灵活组合不同的词典包
• 小范围修改词汇时只需更新相关词典包
• 减少了整体编译时间

常见问题解决方案

1. 词典不生效
   确保：

   • 词典文件名与配置中指定的名称一致
   • 文件放置在正确的目录下(通常是用户配置目录)
   • 部署时没有错误提示

2. 候选词排序异常
   检查是否设置了sort: by_weight参数

3. 基础词汇丢失
   确认import_tables中包含了需要的基础词典

最佳实践建议

1. 为不同类型的专业词汇创建不同的词典包，便于管理
2. 定期备份自定义词典
3. 为词典包添加版本信息，便于追踪修改
4. 复杂的专业词汇可以考虑使用多词典组合的方式

通过合理使用词典扩展包功能，用户可以打造出既包含通用词汇又具备专业术语的个性化输入法，满足各种场景下的输入需求。