WindInput v0.127.0 配置指南：方案选择、词库分库与升级排查

WindInput v0.127.0 配置指南：方案选择、词库分库与升级排查

清风输入法 WindInput 面向五笔和码表方案，也支持全拼、双拼与五笔拼音混输。配置时容易混淆的并非功能名称，而是对象：系统输入源、当前方案、用户词库、词频和候选规则，各有不同入口。本文按首次启用、日常配置、升级迁移三个阶段说明 v0.127.0 的主要操作。

一、区分系统安装与方案启用

Windows 10/11 的 64 位系统可使用安装版或便携版。标准安装会注册 TSF 输入法组件，并创建快捷方式、卸载入口等。安装完成后按 Win + Space 切换到清风输入法；切换系统输入法和在清风内部切换五笔、拼音，是两个层次。

便携版需要运行解压目录内的 wind_portable.exe，由启动器管理输入法组件等部署事项。不要只运行或复制核心服务文件，就把服务已启动当成系统已经具备可选输入法。目录中的程序与数据应保持原有关系。

macOS 使用 12+ 系统的通用 .pkg，覆盖 Apple Silicon 和 Intel，安装后在系统设置的键盘、文本输入配置里添加清风输入法。该包未经 Apple 公证，首次安装可能遇到系统验证提示，应结合实际提示处理，不能据此推断所有应用的输入兼容性。

Linux 提供 amd64、arm64 的 Debian 包，面向 Ubuntu 22.04+ 和 Debian 系，定位仍是 Fcitx5 预览版。以当前目录的包为例，安装命令为：

sudo apt install ./WindInput-0.127.0-linux-amd64.deb

ARM64 设备应换成对应架构文件。系统输入法框架需为 Fcitx5，随后在 Fcitx5 配置中添加“清风输入法”。命令安装成功只完成包管理这一层，不代表输入法已加入当前使用列表。

二、从当前方案开始配置

在 Windows 的功能主菜单中进入“输入方案”，先选与既有习惯相符的方案。五笔 86 负责码表输入，五笔拼音混输结合码表和拼音，全拼与双拼则对应不同的拼音输入方式。混输沿用用户已有的五笔与拼音习惯，选择它是为了在同一输入过程中利用两种匹配路径，减少临时找字时的方案切换。

设置工具的“方案”页可管理启用列表与排序。Ctrl + Shift + E 默认按启用顺序循环，若有多套很少使用的方案，先调整列表，避免每次切换经过无关项目。打开设置的默认快捷键是 Ctrl + Shift + ]。

需要特别区分全局行为与方案参数。同类方案的上屏、调频等行为有全局配置；方案文件保存引擎类型、词库列表等固定参数，支持的项还可做方案级覆盖。某个设置同时影响多套码表方案时，先看自己改的是全局默认，还是某个方案的独立覆盖。

第一次验证基本输入，可在普通文本框中依次检查：编码是否出现候选、空格是否上屏首选、数字键能否选择、Esc 是否取消、Shift 能否切换中英文。这些都是默认交互，已有自定义绑定时应对照实际配置。先完成最小输入链，再开额外功能，排查范围会更清楚。

候选窗上方显示输入编码，下方显示候选词与编码提示，选词时可对照文字后的字母。图中拍摄版本未标明，外观仅作参考；新增候选展开的开关请在下文所列设置入口查找。

三、用户词库、词频和候选调整各改什么

“设置 → 词库 → 用户词库”用于管理自己的词条。v0.127.0 支持新建分库或从文件导入分库，并允许在主词库与分库之间移动词条。按项目、专业领域拆开后，可以分别启停，减少维护时需要手动挑选的范围。

例如将临时项目的术语放进单独分库，项目期间启用，结束后停用。停用保留文件和词条，删除会移除资料，两者不应互相替代。导入文件需要使用 UTF-8；编码不正确时，应先在文本编辑器中另存为 UTF-8，再重新导入。

临时词库对应自动学习的暂存词，词频对应使用次数等记录，候选调整则用于人为指定显示行为。排查一个词“不出现”或“总排第一”时，不宜只盯用户词库。词条是否存在、相关分库是否启用、是否有隐藏或置顶规则，是不同的问题。

在候选词上右键可进行相应调整；候选窗空白处右键打开的则是功能主菜单。前者处理当前词，后者处理方案、主题和功能入口。右键菜单不符合预期时，先确认鼠标落点，而不是先怀疑安装异常。

四、把新版候选功能作为可选配置

候选展开默认关闭，入口是“设置 → 外观 → 候选排版”。开启后，翻页键可将候选窗原地展开为多行，并提供全部、单字、词组、生僻、符号分类。适合需要集中查看较多候选的情况，不必为了升级而强制开启。

码表整句输入也在本版加入，但标注为实验性，出厂关闭，需在方案设置中开启。它和五笔拼音混输不是同一个概念：混输是匹配路径的组合，整句是码表方案的另一种输入能力。只想让拼音补上忘记的五笔编码，不需要把实验整句功能一起打开。

如果调整后出现意外结果，可以先回到明确修改过的项，核对启用条件与所属方案，再观察普通文本框中的行为。一次同时改按键、候选布局和方案，无法从结果判断是哪一个开关引起变化。

五、升级的重点是数据格式与组件加载

v0.127.0 把用户词、临时词、词频、短语、候选调整等数据迁移到用户目录下的 data 文本文件。首次启动自动处理旧数据库，旧文件保留为 userdata.redb.legacy。升级前应先在设置中备份，或复制整个用户目录。

Windows 安装版默认用户目录为 %APPDATA%\WindInput，便携版为 userdata\。个人配置、主题和词库放在用户数据目录，避免与安装目录混放，因为升级可能清理重写程序目录。安装器的数据目录仅首次安装可选，升级时置灰不等于数据丢失，应先看它显示的实际目录。

文本化后可以从词库窗选择“编辑文件”，在编辑器修改后点“完成并加载”。绕过该入口直接改文件，则要刷新词库页或重启服务。配置与导入导出文本都要求 UTF-8，不能把 ANSI 保存的文件直接视为正确输入。

学习数据在停止操作约三十秒后写回，注销和关机前也会保存。需要复制用户目录时，先结束正在进行的输入，让数据写回；文本文件可复制，不等于多设备同时改写已经具备自动解决冲突的能力。

旧版本无法读取新格式。回退到 0.126.0 要保留旧数据库，并按发行说明在旧版首次启动前恢复原文件名；恢复的是升级时刻的数据。没有备份时，不应随意删掉新旧数据文件尝试恢复。

Windows 本版还改动了 TSF 组件，升级后应重启系统，让浏览器、聊天工具等进程重新加载新版组件。Linux 升级后可重启 Fcitx5：

fcitx5 -rd

也可以重新登录。Wayland 还受合成器支持条件影响，本次发行说明仅列 treeland 实测，不能据包已安装就承诺 GNOME、KDE 全部可用。

六、反馈时提供可定位的信息

若仍遇到问题，记录系统、架构、所用方案、具体应用，以及触发操作，比“输入法不能用”更便于定位。本版设置的高级页可以打包日志到桌面；发行说明建议附日志、用户目录的 meta.toml 和 data 文件清单，不要求附词库内容。涉及个人输入数据时，应按需要提供最小资料。

源码自 v0.127.0 起采用 GPL-3.0-or-later，旧版的许可不能直接套到新版，词库资源也适用各自声明。对普通用户，最实用的配置顺序仍是：确认输入源、选对方案、验证默认按键，再整理词库与可选功能。

GitHub 仓库：https://github.com/huanfeng/WindInput

下载与获取

• 百度网盘:https://pan.baidu.com/s/1oVW3cR4E78aUY5ZmdsPvaQ?pwd=mni4 提取码:mni4
• 夸克网盘:https://pan.quark.cn/s/0fbdb2db8a7c