常见问题

安装

安装后输入法不生效或异常？

若是首次安装后不生效，依次检查：

1. 确保已使用管理员权限安装
2. 确保已在系统语言设置中添加输入法
3. 尝试重启相关应用程序；仍不正常就重启电脑

杀毒软件报毒？

这是误报。 原因有两点，缺一不可：

• 没有数字签名。 清风输入法是免费开源项目，没有购买代码签名证书（年费不菲），因此安装包与程序文件都未经签名。安全软件对无签名程序的信任度天然很低。
• 行为像"注入"。 输入法必须注册系统输入法（TSF）组件，并把自己的 DLL 加载进其他程序的进程中才能工作——这个行为模式与恶意软件的注入手法在特征上高度相似。

「无签名 + 加载进他人进程」正好命中很多安全软件的启发式规则，于是被当作可疑程序拦下，尤其是新版本刚发布、样本还没被各家厂商收录时。

遇到拦截时：

1. 在安全软件中把安装目录及清风输入法相关进程加入信任区 / 白名单，或在安装期间临时关闭防护
2. 如果安装包已被"自动清除"，请重新从官方渠道下载后再安装
3. 如仍有顾虑，核心源码完全公开（除设置应用），可自行审阅并从源码编译

Windows SmartScreen 拦截？

同样是没有数字签名导致的。安装时若弹出"Windows 已保护你的电脑"，点击 "更多信息" → "仍要运行" 即可继续。

候选窗口无法显示在开始菜单之上？

还是数字签名的问题：Windows 要求程序经过签名才能申请 UIAccess 权限，而只有拿到该权限的窗口才能盖在开始菜单之上。目前已通过宿主进程代理渲染进行优化，但在开始菜单中候选框暂不支持鼠标操作。

macOS 提示「无法验证开发者」？

同没有数字签名：macOS 版也未做苹果签名与公证，Gatekeeper 会拦下安装包、设置程序与后台服务。到 系统设置 → 隐私与安全性 → 安全性 找到拦截提示，点「仍要打开」放行。

三个程序各自被拦一次，而提示只显示最近一次，所以要「遇到拦截 → 放行 → 重试」重复几轮。详见 macOS 版 · 放行未签名的程序。

macOS 上标点配对的光标不回到括号中间？

这是「辅助功能」权限没给。 把光标送回两个标点中间要向前台应用发送方向键，macOS 未授权时会静默吞掉——右括号照常补出，光标却停在它后面。

到 系统设置 → 隐私与安全性 → 辅助功能 打开「清风输入法」即可。同一授权还影响命令直通车的 key.* 按键合成、title() 变量与全局热键。升级版本后授权可能失效，把开关关掉再打开一次。详见 macOS 版 · 授权辅助功能。

使用

如何切换中英文？

按 Shift 即可在输入法内切换中英文模式（默认左右 Shift 均可）。也可用系统的 Ctrl + Shift 在不同输入法语言之间切换。切换键可在快捷键设置中自定义。

候选词不显示？

1. 确认已激活输入法
2. 确认清风输入法后台服务正常运行
3. 确认未误启用"隐藏候选窗口"选项

如何切换输入方案？

按 Ctrl + Shift + E 在已启用的方案之间循环切换，也可以通过设置工具选择。

如何输入特殊符号？

使用 zz 系列快捷编码，例如 zzbd（标点）、zzsz（圈数）、zzpy（拼音声调）。完整列表请参阅快捷短语 · zz 系列符号。

如何使用计算器？

在中文模式下按 ;（分号）进入快捷输入模式，然后输入数学表达式，例如 ;1+2*3 → 7。触发键可在设置中自定义。

如何快速输入日期时间？

在拼音模式下直接输入以下系统短语编码：

• date — 日期（多种格式）
• time — 时间
• week — 星期
• datm — 日期时间

也可在快捷输入模式中输入数字日期格式化，如 ;2026.4.24。详见快捷输入。

双拼

如何切换双拼方案？

在方案页 → 选中双拼 → 设置 → 方案参数 → 双拼布局里选，或直接改方案文件 shuangpin.schema.toml 的 [engine.pinyin.shuangpin].layout。内置 8 种：xiaohe（小鹤）、ziranma（自然码）、mspy（微软）、sogou（搜狗）、abc（智能ABC）、ziguang（紫光）、jiajia（拼音加加）、shoudao（首道）。详见拼音方案配置。

双拼可以使用模糊音吗？

可以。模糊音是全局设置，双拼和全拼共享同一份配置——在设置工具「方案 → 拼音方案配置」的模糊音区调整，或编辑 config.toml 的 [schema.pinyin.fuzzy]。

词库与备份

如何备份配置？

推荐使用设置工具的备份与还原：一键把配置、词库数据、用户方案与主题打包为 .zip，还原时可选择范围与合并/替换策略。

也可直接备份 %APPDATA%\WindInput\ 整个目录（含 config.toml、userdata.redb 用户数据库、自定义主题与方案）。%LOCALAPPDATA%\WindInput\ 下只有可重建的缓存/日志/运行状态，无需备份。

配置文件只包含部分字段？

这是正常的。清风输入法采用 diff 保存机制，只保存与系统默认值不同的字段，未修改的字段会自动跟随系统默认值的更新。详见配置文件。

外观

如何切换亮暗主题？

在设置工具的外观页面选择主题风格，设为「跟随系统」即可随系统亮暗自动切换。

如何安装自定义主题？

将主题文件放入 %APPDATA%\WindInput\themes\<主题名>\theme.toml，即可在设置工具中选择。详见外观设置。

状态提示气泡是什么？

状态提示是切换输入状态时在光标处显示的小气泡，显示当前方案、中英文、标点等状态。可在外观设置中配置显示模式与位置。

兼容性与排查

微信中候选框位置不对？

清风输入法内置了微信的兼容性规则，会自动修正候选框定位。如果其他应用也有类似问题，可在 compat.toml 中添加规则。详见配置文件。

密码框里打不出中文？

这是有意设计：检测到密码输入框时会自动强制英文，避免密码经候选窗、编码组合区暴露。离开密码框后自动恢复原来的中英文状态。

如需临时关闭该保护（如某些误判场景），在托盘图标右键菜单 → 高级 → 取消勾选「密码框强制英文」；该开关不持久化，重启输入法后恢复默认开启。

某个应用里输入法没反应，如何排查？

托盘图标右键菜单 → 高级 → 勾选「输入诊断 HUD」，屏幕上会出现一个置顶小浮窗，实时显示当前焦点应用的输入状态与禁用原因（如密码框抑制、应用禁用输入等）。浮窗可拖动，双击可复制内容，便于反馈问题时附上诊断信息。排查完毕后在同一菜单取消勾选即可关闭。

如何报告 Bug？

请在 GitHub Issues 提交问题，包含系统版本、复现步骤和相关日志。

与 Rime / 小狼毫 的关系

清风输入法是基于 Rime / 小狼毫 开发的吗？

不是。清风输入法是完全独立开发的开源输入法，其源码与 Rime / 小狼毫 没有任何关联。

但清风输入法有意兼容了 Rime 的词库格式（.dict.yaml），这意味着你可以直接使用 Rime 生态中丰富的词库资源——包括各类方言、专业领域词库和社区维护的词库包——而无需额外转换，直接复用已有的 Rime 词库生态。