鼠须管输入法皮肤配置与macOS黑白模式适配问题解析

鼠须管(Squirrel)作为一款优秀的开源输入法框架，在macOS平台上广受欢迎。近期有用户反馈在v1.0.1版本后，输入法皮肤会跟随系统的黑白模式自动切换，这给希望保持统一视觉风格的用户带来了困扰。

问题现象

当用户在macOS 14.5系统中使用鼠须管v1.0.1版本时，发现输入法界面会随着系统外观模式(light/dark)的变化而自动改变配色方案。具体表现为：

• 系统为浅色模式时，输入法显示浅色皮肤
• 系统切换为深色模式时，输入法自动变为深色皮肤

技术背景

macOS从10.14(Mojave)开始引入了系统级的深色模式支持，应用程序可以通过NSAppearance API获取当前系统的外观模式。鼠须管v1.0.1版本开始，为了更好地融入macOS系统生态，增加了对系统外观模式变化的响应能力。

解决方案

对于希望固定输入法皮肤风格的用户，可以通过以下两种方式实现：

1. 显式指定两种模式下的皮肤方案

在squirrel.custom.yaml配置文件中，同时设置style/color_scheme和style/color_scheme_dark为相同的皮肤方案：

patch:
  style/color_scheme: your_scheme_name
  style/color_scheme_dark: your_scheme_name

这种方式明确告诉输入法无论在何种系统外观模式下都使用指定的皮肤方案。

2. 仅指定基础皮肤方案（未来可能支持）

理论上，如果只设置style/color_scheme而不设置style/color_scheme_dark，输入法应该在两种系统外观模式下都使用基础皮肤方案。但目前版本尚未实现这一逻辑，需要等待后续更新。

皮肤配置建议

在自定义皮肤时，建议考虑以下几点：

1. 确保配色在不同亮度环境下都有良好的可读性
2. 适当调整候选词高亮颜色以提高辨识度
3. 可以针对明暗模式分别优化，提供最佳用户体验

总结

鼠须管输入法对macOS系统外观模式的支持是一项提升用户体验的改进，同时也为开发者提供了更灵活的皮肤配置选项。用户可以根据自己的需求，通过合理配置squirrel.custom.yaml文件来控制输入法的视觉表现。随着项目的持续发展，未来可能会提供更加智能的皮肤适配方案。