常见问题
安装
安装后输入法不生效？
- 确保已使用管理员权限安装
- 确保已在系统语言设置中添加输入法
- 尝试重启相关应用程序
杀毒软件报毒？
清风输入法需要注册系统输入法组件，部分安全软件可能会拦截。请在安全软件中允许相关操作，或暂时关闭杀毒软件完成安装。
Windows SmartScreen 拦截？
由于当前版本没有数字签名，安装时可能触发 Windows SmartScreen 拦截。点击 "更多信息" → "仍要运行" 即可继续。
候选窗口无法显示在开始菜单之上？
由于缺少数字签名，候选窗口无法显示在开始菜单之上。目前已通过宿主进程代理渲染进行优化，但在开始菜单中候选框暂不支持鼠标操作。
使用
如何切换中英文？
按 Ctrl + Shift 即可切换中英文模式。默认左右 Shift 均可，可在快捷键设置中自定义。
候选词不显示？
- 确认已激活输入法
- 确认 wind_input 服务正常运行
- 确认未误启用"隐藏候选窗口"选项
如何切换输入方案？
按 Ctrl + Shift + E 在已启用的方案之间循环切换，也可以通过设置工具选择。
如何输入特殊符号？
使用 zz 系列快捷编码，例如 zzbd（标点）、zzsz（圈数）、zzpy（拼音声调）。完整列表请参阅快捷键参考。
如何使用计算器？
在中文模式下按 ;（分号）进入快捷输入模式，然后输入数学表达式，例如 ;1+2*3 → 7。触发键可在设置中自定义。
如何快速输入日期时间？
在拼音模式下直接输入以下系统短语编码：
date— 日期（多种格式）time— 时间week— 星期datm— 日期时间
也可在快捷输入模式中输入数字日期格式化，如 ;2026.4.24。
详见基础使用。
双拼
如何切换双拼方案？
在方案配置文件 shuangpin.schema.yaml 中修改 engine.pinyin.shuangpin.layout，或通过设置工具修改。支持：xiaohe、ziranma、mspy、sogou、abc、ziguang。
双拼可以使用模糊音吗？
可以。双拼和全拼共享相同的模糊音配置，通过设置工具的"模糊音"页面调整，或编辑方案文件的 engine.pinyin.fuzzy。
词库与备份
如何备份配置？
在设置工具的"词库"页面使用"完整备份"功能，或直接备份 %APPDATA%\WindInput\ 整个目录。
配置文件只包含部分字段？
这是正常的。清风输入法采用 diff 保存机制，只保存与系统默认值不同的字段，未修改的字段会自动跟随系统默认值的更新。详见配置加载机制。
外观
如何切换亮暗主题？
在设置工具的外观页面选择主题风格，或配置 ui.theme_style: "system" 跟随系统自动切换。
如何安装自定义主题？
将主题 YAML 文件放入 %APPDATA%\WindInput\themes\<主题名>\theme.yaml，即可在设置工具中选择。详见自定义主题。
状态指示器是什么？
状态指示器是输入光标处显示的小窗口，显示当前中英文、标点等状态。可在外观设置中配置。
其他
微信中候选框位置不对？
清风输入法内置了微信的兼容性规则，会自动修正候选框定位。如果其他应用也有类似问题，可在 compat.yaml 中添加规则。详见兼容性配置。
如何报告 Bug？
请在 GitHub Issues 提交问题，包含系统版本、复现步骤和相关日志。