常见问题
安装
安装后输入法不生效？
- 确保已使用管理员权限安装
- 确保已在系统语言设置中添加输入法
- 尝试重启相关应用程序
杀毒软件报毒？
清风输入法需要注册系统输入法组件，部分安全软件可能会拦截。请在安全软件中允许相关操作，或暂时关闭杀毒软件完成安装。
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.toml 中修改 [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.toml 中添加规则。详见兼容性配置。
首字符候选窗反应慢？
为避免首字符触发 composition 时候选窗"先错位再跳动"，默认会短暂等待宿主回传真实光标坐标。如果某个应用本身光标就稳定，可在托盘右键菜单选择 高级 → 为 <进程名> 启用即时候选，跳过这次等待，让候选窗即时出现。详见即时候选。
某个应用候选窗每次都跑到屏幕角落？
部分应用上报的光标坐标长期落在错误位置（角落、原点等）。可以在托盘右键菜单选择 高级 → 为 <进程名> 启用固定候选位置，把候选窗手动拖到合适位置后即被持久化记忆，下次出现仍在该位置；支持多显示器与分辨率变化时自动 clamp 到可见区域。详见固定候选位置。
如何报告 Bug？
请在 GitHub Issues 提交问题，包含系统版本、复现步骤和相关日志。
与 Rime / 小狼毫 的关系
清风输入法是基于 Rime / 小狼毫 开发的吗？
不是。清风输入法是完全独立开发的开源输入法，其源码与 Rime / 小狼毫 没有任何关联。
但清风输入法有意兼容了 Rime 的词库格式（.dict.yaml），这意味着你可以直接使用 Rime 生态中丰富的词库资源——包括各类方言、专业领域词库和社区维护的词库包——而无需额外转换，直接复用已有的 Rime 词库生态。