小狼毫输入法候选框数字标号消失问题分析与解决方案

问题现象

在使用小狼毫输入法（Weasel）0.16.1版本时，用户遇到了候选框中数字标号突然消失的问题。具体表现为：

1. 候选词前的数字序号不再显示
2. 候选框整体尺寸明显缩小
3. 虽然数字标号不显示，但按数字键仍能正常选词上屏

问题原因分析

经过技术排查，发现该问题主要由用户自定义配置文件的语法错误导致。用户采用了错误的配置格式，覆盖了输入法原有的样式设置，具体表现为：

1. 配置文件中使用了多行独立声明的方式，而非正确的层级结构
2. 这种错误写法会覆盖整个style节点，导致默认的label_format等样式参数丢失
3. 算法服务进程异常时也可能触发类似现象，但根本原因仍是配置问题

解决方案

正确配置方法

小狼毫输入法的配置应采用层级结构，使用斜杠(/)连接不同层级的参数。以下是一个正确的配置示例：

style:
  horizontal: true
  font_point: 16
  label_font_point: 12
  label_format: "%s."

错误配置示例

以下写法是错误的，会导致样式参数被覆盖：

style/horizontal: true
style/font_point: 16
style/label_font_point: 12

修复步骤

1. 检查并修正所有自定义配置文件中的语法错误
2. 确保使用正确的层级结构配置样式参数
3. 退出算法服务进程
4. 删除配置文件夹中build目录下的所有文件
5. 重新部署输入法至少两次
6. 重启计算机确保所有更改生效

技术原理

小狼毫输入法的配置系统采用YAML格式，具有严格的层级结构要求。当配置文件中出现语法错误时：

1. 错误的配置会覆盖默认设置
2. 样式参数(label_format等)丢失会导致数字标号不显示
3. 候选框尺寸计算也会受到影响
4. 算法服务可能无法正确解析配置，导致异常

最佳实践建议

1. 修改配置前备份原始文件
2. 使用专业的YAML编辑器避免格式错误
3. 每次只修改少量配置，逐步验证
4. 部署后检查候选框各项功能是否正常
5. 参考官方文档中的配置示例

总结

候选框数字标号消失问题通常由配置错误引起，特别是样式参数的设置不当。通过正确理解小狼毫的配置层级结构，采用标准的YAML语法，可以避免此类问题的发生。对于输入法用户而言，掌握基本的配置语法知识是保证输入法稳定运行的重要前提。