huanfeng / WindInput

清风输入法 (WindInput) 
 轻量、快速、可定制的开源中文输入法
 官网 ·
 下载 ·
 使用文档 ·
 更新日志 
## 特性
- **专为五笔和码表输入方案设计** — 五笔 86、五笔拼音混输，同时提供全拼和双拼
- **方案驱动** — 通过方案文件灵活定义输入行为
- **图形设置** — 配套设置工具，配置可视化调整，修改即时生效
- **亮暗主题** — 支持亮色和暗色主题，可随系统自动切换
- **轻量运行** — Rust 实现，资源占用低，启动迅速
- **跨平台** — 同一套核心引擎，支持 Windows 10/11、macOS 12+ 与 Linux（Fcitx5，预览版）
## 安装
前往 windinput.com/download 下载对应平台的安装包：
- **Windows 10/11（64 位）** — 安装版或便携版，安装后按 `Win + Space` 切换到清风输入法
- **macOS 12+** — `.pkg` 通用安装包（Apple Silicon / Intel），安装后在
 「系统设置 → 键盘 → 文本输入 → 编辑」中添加清风输入法，再从输入法菜单切换
- **Linux（预览版）** — `.deb` 安装包（amd64 / arm64，Ubuntu 22.04+、Debian 系发行版），以
 Fcitx5 输入法引擎的形式工作；`sudo apt install ./WindInput-*.deb` 安装后，在「Fcitx5 配置」中
 把清风输入法加入输入法列表。系统输入法框架需为 Fcitx5，KDE Plasma 等桌面的额外设置与已知限制见
 wind_linux/README.md
Windows 版的程序文件与安装包已做数字签名；SmartScreen 需要下载量积累信誉，新版本发布初期
仍可能拦截，按提示「更多信息 → 仍要运行」继续即可。macOS 版尚未做苹果签名与公证，被
Gatekeeper 拦下时到「系统设置 → 隐私与安全性」放行。
## 文档
完整的使用说明、配置参考和常见问题都在文档站：**windinput.com/docs**
## 仓库范围
本仓库包含清风输入法的核心部分：
| 组件 | 技术 | 职责 |
|------|------|------|
| `wind_input` | Rust | 核心服务：输入引擎、词库、候选管理、UI 渲染、IPC（跨平台） |
| `wind_tsf` | C++ | Windows TSF 输入法框架接口，键盘事件捕获 |
| `wind_macos` | Swift | macOS IMKit 输入法客户端 |
| `wind_linux` | C++ | Linux Fcitx5 addon（预览版，见 wind_linux/README.md） |
发布版安装包还需要以下配套项目，它们在各自的独立仓库中维护：
| 仓库 | 技术 | 职责 | 开源状态 |
|------|------|------|----------|
| wind-installer | Rust | Windows 安装器与卸载器（清单驱动的通用打包器） | 已开源 |
| wind-portable | Rust | Windows 便携版（绿色版）启动器，免安装就地运行 | 已开源 |
| wind-ui-rust | Rust | 跨平台轻量 GUI 库，安装器 / 便携版 / 设置程序的界面基础 | 已开源 |
| wind-setting | Rust | 图形设置程序 | 已开源 |
其中 wind-installer 与 wind-portable 只用于 Windows；macOS 的 `.pkg` 安装包由本仓库的
`scripts/mac/dev.sh pkg` 直接打包，Linux 的 `.deb` 由 `scripts/linux/package-deb.sh` 打包，均无需额外仓库。
这些配套项目都是可选的：与本仓库放在同级目录时构建脚本会一并构建，缺失则自动跳过，
核心输入法本身可独立构建和运行。完整成品请从下载页获取。
wind-installer 与 wind-portable 通过 crates.io 上发布的 `windui` 使用 GUI 库，无需本地检出
wind-ui-rust；只有 wind-setting 是 path 依赖（`windui = { path = "../wind-ui-rust" }`），
构建它时才需要把 wind-ui-rust 一并放到同级目录。
## 从源码构建
- **Windows**：Rust stable + Visual Studio 2022（C++ 桌面开发）+ CMake，运行 `.\scripts\dev.ps1`
- **macOS**：Rust stable + Xcode（Swift 5.9+），运行 `scripts/mac/dev.sh`
- **Linux（交叉编译 Windows 产物）**：`scripts/dev.sh`
- **Linux（Fcitx5 前端，预览版）**：构建、安装与已知限制见 wind_linux/README.md
构建脚本会自动下载第三方词库数据并生成完整的数据目录。详细说明见
贡献指南。
## 参与贡献
欢迎贡献代码、报告 Bug 或提出建议！请阅读 贡献指南。
> 首次提交 PR 需要签署 贡献者许可协议 (CLA)。
## 致谢
清风输入法在设计与实现过程中参考了许多优秀的开源输入法项目，
它们的思路、文档与源码为本项目提供了重要的指引，在此一并致谢：
- **RIME 中州韵输入法引擎**（librime）
 — 方案与词库格式、候选排序与整句解码模型的主要参考；其
 小狼毫 Weasel 是 Windows TSF 集成语义的对照实现，
 鼠须管 Squirrel 是 macOS IMKit 架构的参考
- **Fcitx5**（libime）
 — 拼音解码（不完整拼音、超长词惩罚）与用户词频模型的重要参考；
 fcitx5-macos 为 macOS 端的打包与输入源注册细节提供了对照
- **极点五笔** — 五笔输入的交互习惯与功能来源；
 五笔 86 码表数据来自其 Rime 移植版
 rime-wubi86-jidian
- **白霜拼音 rime-frost** — 拼音词库与语言模型的数据来源
- **pinyin-data** — 汉字读音数据来源
- **OpenCC** — 简繁转换词典数据来源
- **Windows Classic Samples** 与
 TSF 官方文档
 — Windows 输入法框架实现参考
上述项目均为独立作品，本项目仅作实现参考，未复制其源代码；
数据来源部分适用各自的许可证条款，详见 NOTICE.md。
## 许可证
本项目源代码自 v0.127.0 起采用 GNU 通用公共许可证第 3 版或更高版本（GPL-3.0-or-later）。
v0.127.