清风输入法

主题

安装指南 ​

系统要求 ​

  • Windows 10 或 Windows 11（64 位）
  • macOS 12 及以上（Apple Silicon / Intel，alpha）

选择你的平台

Windows 用户请看下方「方式一 / 方式二」；macOS 用户请直接跳到 macOS 安装。

方式一：安装包（推荐） ​

  1. 从 GitHub Releases 下载最新的安装包 WindInput-x.x.x-Setup.exe
  2. 双击运行安装程序，按照提示完成安装
  3. 安装完成后，按 Win + Space 切换到清风输入法

安装程序会自动完成以下操作：

  • 将程序文件安装到 C:\Program Files\WindInput\
  • 注册 TSF 输入法组件
  • 创建开始菜单快捷方式和卸载入口

自定义路径

安装时支持自定义安装路径。
用户数据目录固定位于 %APPDATA%\WindInput，用于存放词库、配置等个人数据（需要数据随程序走时请使用便携版）。

不要在程序目录存放个人文件

安装版在更新版本时，会先卸载旧版本再安装新版本，安装目录（默认 C:\Program Files\WindInput\）下的所有文件都会被清理后重新写入。
请勿将自定义配置、第三方词库、自定义主题等直接放入安装目录或其中的 data\ 子目录 —— 这些文件会在升级时丢失，对内置文件的修改也会被覆盖。
所有个人化内容请放入下文介绍的用户数据目录，更新时不会被清理。

方式二：便携版 ​

适合 U 盘携带或不想安装到系统的用户。

  1. 从 GitHub Releases 下载 WindInput-x.x.x-Portable.zip
  2. 解压到任意目录
  3. 运行便携版启动器 wind_portable.exe，启动器会自动注册输入法组件和开机启动项，以保证输入法的正常运行

便携版说明

  • 用户数据固定保存在程序目录下的 userdata 目录中，不支持修改
  • 关闭 wind_portable.exe 时会提示是否进行卸载
  • 更新时由于 DLL 锁定问题，建议使用便携版启动器的 部署 → 更新 功能进行更新

macOS 安装 ​

alpha 阶段

macOS 版处于 alpha：未做苹果公证，功能与 Windows 版存在差异，建议有一定动手能力的用户尝试。

  1. 从 GitHub Releases 下载 WindInput-x.x.x-macOS.pkg
  2. 双击运行安装。这是一个 universal 安装包（同时支持 Apple Silicon 与 Intel），内含输入法、后台服务、设置程序三件套
  3. 打开 系统设置 → 键盘 → 文本输入 → 输入法 → 编辑，添加并切换到「清风输入法」（也可用 ⌃Space 或菜单栏输入菜单切换）

安装后：

  • 设置程序位于 ~/Applications/清风输入法设置.app，也可从输入法菜单的「设置…」打开
  • 后台服务随登录自动启动；用户数据与日志路径见下文 用户数据目录

未公证 / Gatekeeper 放行

当前版本未做苹果公证。首次运行安装包、设置程序或后台服务时，macOS 的 Gatekeeper 可能拦截并提示「无法打开，因为无法验证开发者」。放行步骤：

  1. 打开 系统设置 → 隐私与安全性
  2. 滚动到「安全性」区域，找到被拦截的清风输入法组件的提示，点 「仍要打开」
  3. 在弹出的确认框中再次确认

若在「输入法」列表里添加后仍无法切换，通常是首次启用时后台服务被拦截 —— 按上述步骤放行后，注销或重启一次即可。较新版本的 macOS 对未公证输入法的限制更严格，放行流程可能需要重复一到两次。

重新安装请先重启

卸载后若要重装，建议先注销或重启，让系统清除输入法注册缓存，避免出现「设置里已添加、切换列表却没有」的情况。

macOS 卸载 ​

双击 ~/Applications/卸载清风输入法.app，按提示完成。用户词库 / 配置默认保留在 ~/Library/Application Support/WindInput/，不会被删除。

用户数据目录 ​

macOS 路径对照

本站文档中的路径多以 Windows 的 %APPDATA%\WindInput\ 书写。macOS 上的对应位置为：

用途WindowsmacOS
用户数据（漫游）%APPDATA%\WindInput\~/Library/Application Support/WindInput/
缓存 / 日志 / 运行状态%LOCALAPPDATA%\WindInput\~/Library/Application Support/WindInput/（与用户数据同目录，cache\ logs\ 等子目录）
设置程序开始菜单 / 安装目录~/Applications/清风输入法设置.app

macOS 上没有 Windows 的「漫游 / 本机」目录之分，两类数据都在 ~/Library/Application Support/WindInput/ 下；子目录结构与 Windows 完全一致，下文以 Windows 路径为例的说明同样适用，只需替换为上表对应路径。

清风输入法把数据分成系统预置与用户数据两层，用户数据又按「是否应随账户漫游」进一步拆到两个系统目录：

目录角色升级行为
<安装目录>\data\（安装版）
<解压目录>\data\（便携版）		程序自带的系统预置数据，只读升级时随安装包整体替换
%APPDATA%\WindInput\（漫游用户数据）配置、词库、自定义主题/方案等个人化内容升级时不会主动清理，仅卸载时手动选择"删除用户数据"才会删除
%LOCALAPPDATA%\WindInput\（本机数据）词库编译缓存、日志、运行时状态等本机产物升级时不清理；缓存可安全删除，会自动重建

为什么分成漫游 / 本机两处

%APPDATA%（漫游）里放的是换机也想带走的东西；%LOCALAPPDATA%（本机）里放的是与这台机器绑定、可重建的东西。
便携版没有这种拆分：上述两处都指向解压目录下的 userdata\。

同结构覆盖机制

%APPDATA%\WindInput\ 与程序 data\ 目录采用相同的子目录结构。当两侧存在同名文件时，用户数据目录中的文件优先生效（系统短语等个别采用合并策略的文件除外）。
这意味着你可以在漫游目录下放置同名文件来覆盖内置版本，而不需要修改程序目录里的任何文件。

漫游数据目录结构（%APPDATA%\WindInput\） ​

text
%APPDATA%\WindInput\
├── config.toml                       # 用户全局配置（diff 保存，仅含与默认值不同的字段）
├── userdata.redb                     # 用户数据库（自定义词、词频、置顶/删词等，redb 格式）
├── compat.toml                       # 用户自定义的应用兼容性规则
├── schemas\                          # 输入方案与方案级词库
│   ├── pinyin.schema.toml            # 方案配置（覆盖或新增）
│   ├── wubi86.schema.toml
│   ├── my_schema.schema.toml         # 自定义新方案
│   ├── <方案词库>.dict.yaml           # 方案引用的 RIME 词库（YAML 格式）
│   └── <第三方词库文件>               # 方案引用的词库放在同目录
└── themes\                           # 自定义主题
    ├── default\theme.toml            # 覆盖内置主题（可选）
    └── <自定义主题名>\theme.toml      # 新增第三方主题

本机数据目录结构（%LOCALAPPDATA%\WindInput\） ​

text
%LOCALAPPDATA%\WindInput\
├── cache\                            # 词库编译缓存（.wdb），可安全删除，下次自动重建
├── logs\                             # 运行日志
└── state.toml                        # 运行时状态（工具栏位置、上次中英/标点模式等）

放置规则速查 ​

需求放到哪里
调整全局配置通过设置工具修改，或编辑 config.toml
新增第三方输入方案schemas\<方案ID>.schema.toml，并在 config.toml 的 schema.available 中登记
替换/扩充内置方案的词库在 schemas\ 下放置对应词库文件，方案文件中通过 dictionaries 引用
新增自定义主题themes\<主题名>\theme.toml，在设置工具"外观"页面选用
微调内置主题在 themes\ 下创建同名目录与 theme.toml，自动覆盖内置版本
自定义短语通过 设置 → 词库 → 短语 添加（写入 userdata.redb）
应用兼容性规则部分可通过设置修改，或编辑 compat.toml

备份与迁移

漫游目录（%APPDATA%\WindInput\）是完整自包含的——只需备份该目录即可保存所有个人化内容（配置、自定义词、主题、方案）。换机或重装时复制回去即可恢复，不依赖任何注册表项。%LOCALAPPDATA% 下只有缓存/日志/运行状态，无需备份。
也可用设置工具的高级 → 备份与还原一键打包为 .zip 备份包。

卸载 ​

安装版卸载 ​

通过以下任一方式卸载：

  • 打开 Windows 设置 → 应用 → 已安装的应用，搜索"清风输入法"，点击卸载
  • 通过 开始菜单 中的卸载入口
  • 运行安装目录下的卸载工具

注意

卸载时会提示是否删除用户数据，删除后词库、配置等数据将无法恢复，请谨慎选择。

便携版卸载 ​

关闭 wind_portable.exe 时选择卸载即可，之后删除解压目录完成清理。

已知问题 ​

Windows SmartScreen 拦截 ​

由于当前版本没有数字签名，安装时可能触发 Windows SmartScreen 拦截提示。这是正常现象，点击 "更多信息" → "仍要运行" 即可继续安装。

杀毒软件报毒 ​

清风输入法需要注册系统输入法组件，部分安全软件可能会拦截。请在安全软件中允许相关操作，或暂时关闭杀毒软件完成安装。

开始菜单候选框限制 ​

由于缺少数字签名，候选窗口无法显示在开始菜单之上。目前已通过宿主进程代理渲染进行优化，但在开始菜单中候选框暂不支持鼠标操作。

部分游戏中无法使用 ​

由于缺少数字签名，一些网络游戏不会加载未签名的输入法 DLL，导致输入法无法在游戏中启用。

macOS：未公证与系统限制 ​

首次安装 / 启用需要 Gatekeeper 放行，步骤见上文 macOS 安装；后续提供签名 / 公证版本后将改善。macOS 版与 Windows 版在部分功能上存在差异。

安装后配置 ​

安装完成后，推荐进行以下配置：

  1. 使用 Ctrl + Shift + E 选择你偏好的输入方案
  2. 通过 Ctrl + Shift + ] 打开设置工具，调整个性化选项
  3. 阅读基础使用了解日常操作

以上快捷键均为默认值，可在设置工具中自行修改。

macOS 快捷键

以上快捷键默认值在 macOS 上同样适用；macOS 额外支持 ⌘(Command) / ⌥(Option) 作为修饰键。切换到 / 离开清风输入法使用系统的 ⌃Space，而非 Windows 的 Win + Space。