清风输入法Linux 版
Linux 版（预览版）的系统要求、安装与配置、升级卸载，以及与 Windows 版的差异和已知限制
预览版
Linux 版仍是预览版：日常输入已可用，但部分功能尚未移植（见与 Windows 版的差异）， 不同桌面环境下的表现也还在打磨。遇到问题欢迎按反馈问题附上日志。
系统要求
- Ubuntu 22.04 及以上，或 Deepin 25（其他 Debian 系发行版理论可用，未逐一验证）
- x64（amd64）或 ARM64（arm64）
- 目前只提供 Debian 系的
.deb安装包，rpm、Arch 等暂不提供 - 输入法框架 Fcitx5（5.0.14 及以上；安装包会自动拉取依赖）
X11 与 Wayland 会话均可使用，Wayland 下的差异见已知限制。
安装
-
从下载页或 GitHub Releases 获取与机器架构对应的安装包：
WindInput-x.x.x-linux-amd64.deb（x64）或WindInput-x.x.x-linux-arm64.deb（ARM64） -
在终端安装（会自动安装 Fcitx5 等依赖）：
sudo apt install ./WindInput-x.x.x-linux-amd64.deb -
注销并重新登录，让系统加载新装的输入法。
在系统里添加清风输入法
安装包只装程序，不会改动你的输入法配置——是否启用、怎么切换，由你在系统设置里决定：
- 确认系统使用的输入法框架是 Fcitx5（Ubuntu 默认是 IBus，需要在「设置 → 区域与语言 → 管理已安装的语言」里把「键盘输入法系统」改为 Fcitx 5，或运行
im-config选择 Fcitx5；Deepin 25 默认就是 Fcitx5）。改完需要注销重登。 - 打开 Fcitx5 配置（应用菜单里的「Fcitx 5 配置」，或终端运行
fcitx5-configtool），在「输入法」页把「清风输入法」添加到当前输入法组（左侧列表里取消勾选「仅显示当前语言」才能搜到）。 - 用 Fcitx5 的切换热键（默认
Ctrl + Space）切到清风输入法。
KDE Plasma 的 Wayland 会话 0.126 新增
除上面几步外，还要在「系统设置 → 键盘 → 虚拟键盘」里选择 Fcitx 5，然后注销重登。KDE 只把输入法接口交给它自己启动的 Fcitx5，不选这一项，Konsole、Kate、KRunner 这类 Wayland 原生应用里就不显示候选窗。
另外不要设置 QT_IM_MODULE、GTK_IM_MODULE 环境变量（Fcitx5 官方也是这样建议的），否则候选窗可能出现在屏幕左上角。
新开的应用默认不是清风
Fcitx5 默认每个应用各自记住输入法状态，新打开的应用从键盘布局（英文）起步，要再切一次。想让所有应用保持一致，在 Fcitx5 配置的「全局选项」里把「共享输入状态」设为「所有」（Deepin 出厂即是如此）。
想用 Shift 单击切换中英
Fcitx5 出厂把「临时在当前和第一个输入法之间切换」设成了左 Shift，会在清风之前把 Shift 单击截走，「Shift 切换中英」就不生效。这个热键是 Fcitx5 的全局设置、其他输入法也在用，所以不会替你改：需要时到 Fcitx5 配置的「全局选项」里，把它清空或换成别的键。
设置程序
从应用菜单或 Fcitx5 托盘菜单打开「清风输入法设置」，或在输入时按 Ctrl + Shift + ]。
主菜单 0.126 新增
切换方案、全角半角等功能在主菜单里：点 Fcitx5 托盘菜单里的「清风输入法菜单」，菜单会弹在鼠标处；输入时右键候选窗的空白处也能打开。
工具栏与软键盘 0.127 新增
Linux 版也有和 Windows 版一样的悬浮工具栏与软键盘：工具栏可拖动、记住位置，显示内容、纵向排列、自动隐藏、右键与中键菜单都与 Windows 相同；软键盘的各面、点键上屏、长按连出、拖动与位置记忆也一样。点工具栏或软键盘不会抢走输入框的焦点。
- 开关：主菜单里的「显示工具栏」「软键盘」，工具栏上的软键盘格，或热键
Ctrl + Shift + \（工具栏）、Ctrl + Shift + K（软键盘）。热键只在输入法激活时响应 Ctrl + Shift + K不再传给程序：以前这个键原样交给应用，现在用来开关软键盘；应用里要用它，到「按键 → 功能快捷键」把「显示/隐藏软键盘」清空即可- 从旧版升级后要重启 Fcitx5：在桌面终端运行
fcitx5 -rd，或注销重登，工具栏与软键盘才会显示 - 全屏时隐藏工具栏：X11 会话下前台窗口全屏（如视频全屏）时隐藏，退出全屏后恢复；Wayland 会话拿不到前台全屏状态，只是把工具栏放在全屏应用之下，效果是近似的。「主动检测全屏状态」只在 Windows 上有
升级与卸载
- 升级：下载新版安装包，同样用
sudo apt install ./WindInput-…deb覆盖安装，然后注销重登（或在桌面终端运行fcitx5 -rd重启 Fcitx5）。设置程序会检查并提示新版本（「打开下载页」），但不会自动安装——装 .deb 需要管理员权限，由你用 apt 完成。 - 卸载：
sudo apt remove windinput。用户数据保留在下面的目录里，不需要了可以手动删除。清风输入法在 Fcitx5 输入法列表里的条目，可到 Fcitx5 配置里移除。
文件位置
| 用途 | 路径 |
|---|---|
| 用户数据（设置、用户词库与词频、用户方案） | ~/.config/WindInput/ |
| 本机数据（缓存、运行状态） | ~/.local/share/WindInput/ |
| 日志 | ~/.local/share/WindInput/logs/ |
| 程序与内置词库 | /usr/lib/windinput/ |
与 Windows 版的差异
- 没有全局快捷键，快捷键只在输入法激活时响应（工具栏与软键盘 0.127 起已提供，见上文）；
- 主菜单的「高级」里没有「输入诊断 HUD」；
- 「应用兼容性与独立配置」可用（例如给某个应用设默认英文），但不带 Windows 版那些内置的应用兼容规则——它们都是针对 Windows 程序的修正；
- 命令直通车的按键合成只作用于当前输入框所在的应用，桌面级快捷键（如
Super+E）不会触发； - 在线更新只提示、不自动安装（见上文「升级」）。
已知限制
- Wayland 会话下候选窗的位置由桌面合成器决定。 光标位于屏幕底部时，候选窗可能被任务栏遮住；按屏幕位置摆放的提示（Toast、固定位置的状态气泡）不受影响。
- GNOME 的 Wayland 会话（如 Ubuntu 22.04 默认会话）下，候选窗位置不会跟随光标和窗口。 GNOME 没有提供输入法所需的窗口位置信息，请在登录界面选择「Ubuntu on Xorg」会话（X11）使用；Deepin 的 Wayland 会话不受影响。
- KDE Plasma 的 Wayland 会话：0.126 起，Wayland 原生应用（如 Konsole、Kate、KRunner）里也能显示候选窗，但要在「系统设置 → 键盘 → 虚拟键盘」里选择 Fcitx 5 并注销重登；更早的版本这些应用里不显示候选窗，可改用 X11 会话。不论哪个版本，都不要设置
QT_IM_MODULE环境变量，否则候选窗可能出现在屏幕左上角。 - 部分 Chromium 内核浏览器在 Wayland 下无法输入（换用其他输入法也一样）：浏览器以原生 Wayland 方式运行、却没有开启 Wayland 输入法支持时会这样。可在启动参数里加上
--enable-wayland-ime，或改用--ozone-platform=x11启动。 - 跟随光标的状态气泡不能拖动；需要自由摆放时，把气泡位置改为「固定位置」后再拖。
- 软键盘不跟物理 Shift 换层：按住键盘上的 Shift 时面板不切到第二层；点面板上的 Shift 键照常切换。
- Wayland 下工具栏 / 软键盘记住的位置可能跳到默认角：只在显示器缩放与
Xft.dpi不一致（如显示器 150%、Xft.dpi仍是 96），并且在 XWayland 应用与 Wayland 原生应用之间切换焦点时出现。 - 没有窗口合成器的 X11 桌面上，自动隐藏的「悬停原位时重新显示」不起作用：工具栏淡出后鼠标移过去唤不回来，要等切换中英等状态变化时再出现。
对这篇文档有疑问，或发现内容有误？
欢迎到文档仓库提 issue，写明问题时附上本页链接即可。