Repository navigation
更新说明
⚠️ 此版本修改了 TSF 端与按键转发，升级后部分按键相关修复需要重启系统才会生效。
✨ 新功能
- 增加中英文、中文与数字之间自动加空格（默认关闭，设置 → 输入 → 字符与标点，详见文档）
- 增加英文后智能标点（默认关闭，设置 → 输入 → 字符与标点，详见文档）
- 码表整句支持语法模型与多条整句备选（实验性！在「方案设置 → 实验性功能」中开启，详见文档）
- 主题支持异形皮肤与装饰动画，主题包可打包皮肤资源（详见主题文档）
- 翻页键可单独指定翻不动时的行为（设置 → 按键）
- 增加词库缓存策略（默认锁定，设置 → 高级 → 性能与诊断）
- 应用兼容性可设联想时不放占位字符（Excel、WPS 表格默认启用，设置 → 高级 → 应用兼容性与独立配置）
- 命令行
date()支持全部日期$变量（含农历） - Windows 上按住工具栏任意格可拖动工具栏
- Linux GNOME 光标扩展支持 Shell 42–46 与 51
⚡ 优化改进
- 优化系统繁忙时的按键响应，减少候选出现的顿挫
- 中文方案里的英文候选上屏，跟随临时英文的「英文词自动加空格」设置
- 安装、卸载向导里的路径改为显示实际路径
🐛 问题修复
- 修正 ChatGPT 搜索框等网页受控输入框里，编码不进输入缓冲、上屏重复、候选窗位置偏到其它输入框的问题
- 修正快捷加词面板里按 Ctrl+Enter，回车同时被交给软件（聊天窗口误发送）的问题
- 修正候选文字的圆角在不设边框时不生效的问题
- 修正窗口圆角未裁掉底层装饰、装饰从圆角处露出的问题
- 修正按应用记忆中英文状态时，首次进入的软件未被记下的问题
- 修正悬停气泡自行收起后，移回原候选不再出现气泡的问题
- 修正标点顶屏自动配对后光标位置不对的问题
- 修正英文半角标点与原字符相同时，英文状态下按该键被吞的问题
- 修正快捷输入里大写英文、自由英文的历史排序不按英文词频的问题
- 修正命令行
date()遇到单独的%时输入法退出的问题 - 修正拼音整句备选的排序异常，以及备选被同文本的不同切分挤掉的问题
- 修正 macOS 升级后无法打字的问题
- 修正 Linux GNOME 开了字体缩放后候选窗位置偏移的问题
- 修正方案管理里，导入方案包或外部改动后的启用表、按键表被下次保存写回旧值的问题
- 修正方案在线导入的地址校验问题，以及主题导入时可能误删主题目录以外内容的问题
📌 其他说明
- 破坏性变更：移除
keys.overflow.page_key_overrides，不做迁移 - 主题包单个文件不超过 16 MB
- 导入主题时，未指定主题 id 会按显示名自动生成，指定的 id 不合法则报错
- 感谢所有反馈问题、提出建议的用户
下载
| 版本 | 适用场景 |
|---|---|
Windows 安装版 .exe |
推荐。向导式安装、自动配置输入法 |
Windows 便携版 .zip |
免安装，解压即用，适合放 U 盘或绿色使用 |
macOS 安装包 .pkg |
通用二进制，Apple 芯片与 Intel 机型通用 |
Linux 安装包 .deb（测试版） |
Ubuntu 22.04+ / Debian 系（含 Deepin）的 Fcitx5 输入法；linux-amd64（Intel/AMD）与 linux-arm64（ARM）各一个 |
每个安装包都附带同名 .sha256 校验文件，可用于核对下载完整性。
🌏 国内网络建议从 官网下载页 经 CDN 获取同一版本，速度更稳。
⚠️ Windows：安装时若 Windows 安全中心（SmartScreen）拦截，点「更多信息」→「仍要运行」即可继续。SmartScreen 要看下载量积累起来的信誉，新版本发布初期仍可能被拦。
⚠️ macOS：本版本未经 Apple 公证，双击安装包会提示「无法验证开发者」。请改用 右键 →「打开」→「打开」，或在终端执行sudo installer -pkg <安装包路径> -target /。装完后到「系统设置 → 键盘 → 文本输入 → 输入法 → 编辑 → +」里添加「清风输入法」。
⚠️ Linux：先sudo apt install ./<下载的 .deb 文件>，在 Fcitx5 配置的输入法列表里添加「清风输入法」即可使用，无需额外脚本（系统输入法框架须为 Fcitx5；升级只需fcitx5 -rd）。支持 X11 与 Wayland 会话（Wayland 需合成器支持 input-method-v2，目前仅在 treeland 上实测；GNOME / KDE 尚未验证）；其它发行版（Fedora / Arch 等）的包尚未提供。
📖 使用文档 · 问题反馈
🌐 官网 · 📖 使用文档 · 🕘 历史版本 · 🐛 反馈问题 · 💬 QQ 交流群 1085293418
变更记录（134 个提交，v0.130.1 → v0.131.0）
新功能
- theme: theme.renderPreview(s) 由服务端渲染器出主题预览图并缓存 (f41d81b)
- transfer: 主题包支持皮肤资源 (a779ee2)
- scene: 候选窗一次出图 render_candidate (362193e)
- theme: 皮肤装饰事件状态机（打字 / 上屏 / 翻页 / 点击切换动作）与「主题动画」开关 (de08efa)
- theme: 皮肤装饰动画（APNG / GIF / 动态 WebP 循环播放） (a349a63)
- theme: 皮肤装饰缺省 hit = "drag"，按住装饰拖动候选窗 (fbbf37e)
- theme: 皮肤分槽位布局，编码栏 / 候选 / 翻页各自锚定 (6d7bf14)
- theme: 皮肤避让按光标行保护带的像素判断，拉伸带缺省整数次重复 (13ccd82)
- theme: 异形皮肤（多段切片窗体、装饰外扩与穿透、对齐点） (7063e11)
- toolbar: Windows 上按住任意格拖动也能移动，原地点击仍是切换 (3af2e5f)
- linux: GNOME 光标扩展支持 Shell 42–46，按客户端 sf 换算相对光标 (a5ad2e6)
- compat: Excel 出厂联想态不挂占位组合 (f8a46d5)
- compat: WPS 表格（et.exe）出厂联想态不挂占位组合 (96b28d1)
- compat: 联想态可不挂占位组合（assoc_placeholder = "none"） (e41d032)
- compat: 联想态占位字符可按应用单独指定 (2aeb737)
- mobile: 新增 assoc_hold，操作联想候选期间暂停自动隐藏 (c35a22a)
- keys: 翻页动作可带翻不动策略后缀，移除 page_key_overrides (2f035ce)
- linux: 鼠标挪过光标后输入序列记账报不知道 (0a894ca)
- macos: 点过鼠标后输入序列记账报不知道，修正 KeyEvent 帧长测试 (29fae4b)
- input: 汉字后的小键盘数字也补空格 (57a9441)
- mobile: 新增快捷输入候选来源的读写口（quick_mix 的 members） (13a3b24)
- mobile: 新增 press_literal，快捷输入等文本缓冲模式下数字页原样上屏键进缓冲 (b847be5)
- debug: 悬停调试的来源行标出空码组词与逆切分 (1906661)
- input: 中文方案里的英文候选上屏跟随临英的 commit_space (cda1f47)
- codetable: 空码组词 compose_input (f53766c)
- codetable: 整句挂语法模型、词典组词与 N-best (14a4e9b)
- input: 中英/数字间按需补空格，英文后智能标点 (6f8150d)
- protocol: KeyPayload 追加 seqChar，三端记录输入序列末字符 (4dc9301)
- mobile: 门面提供单个方案的设置读写 (9578f16)
- transfer: 方案包导入支持自定义解压后总量上限 (f2bbfdc)
- mobile: 方案包变更后使引擎缓存失效，重扫规则与构造期一致 (942e511)
- mobile: 门面支持方案包导入后刷新已装方案，并暴露 wind-transfer (ab9d686)
- mobile: 触摸键盘的 ; 默认不进快捷输入 (64edd55)
- memory: 词库缓存策略 schema.dict_cache_policy（锁定 / 预加载 / 关闭，出厂锁定），带内存预算 (86d14d0)
- cmdbar: date() 支持全部 $变量 记号，非法格式符报错不再崩溃 (21328bb)
- mobile: press 接口承接按键翻译与自动空格 (6f47580)
问题修复
- theme: 只拦真正的 8.3 短名；覆盖确认报出已有主题的名字 (9f16548)
- theme: 没给 slug 时从显示名派生主题 id，不再直接拒 (d6c5620)
- theme: 导入主题的 id 必须是普通名字，回滚只删本次新建的目录 (f260967)
- coordinator: 改 dict_cache_policy 不再触发无效的全量引擎重建 (d37bc1c)
- dict: 预加载拷不进私有内存时退回普通映射，不再让词库加载失败 (6eb999b)
- config: page_key_overrides 登记为退役键，从用户文件清掉 (68d4fe2)
- tsf: 组字中的 Ctrl/Alt 快捷键改回原生交还宿主，不再重放主键 (b8cc18f)
- tsf: 受控输入框过早终止组合时保留缓冲接着打，候选窗不跟随旧坐标 (c7ceb18)
- ui: 候选文字圆角不再依赖边框（随场景迁入 wind-scene） (9a0443d)
- theme: 预览渲染不抢 UI 线程，缓存与不可信主题加上限 (3f87839)
- transfer: 主题包导出按导入口径自检 (f71842e)
- scene: render_candidate 复用调用方场景、可关软件阴影 (0d6cba2)
- theme: 皮肤事件状态机审查修正（联想不误报退格、缺失片段丢弃、降帧映射取整） (eae7df6)
- service: Windows 主线程栈改为 8 MiB (6a52daf)
- theme: 皮肤字段装箱，避免抬高主题加载链的栈帧 (1c30f55)
- ui: 窗口圆角也裁掉 z<0 图层，底层装饰不再从圆角处露出 (40ca70e)
- state: 按应用记忆在首次进入时记下中英态 (eedd031)
- ui: 候选文字圆角不再依赖边框，默认态只配底色也生效 (a5e34ff)
- ui: 悬停气泡自己收起时清掉悬停，移回原候选能再出气泡 (310f519)
- assoc: 无占位联想会话位的审查修复 (f96bc27)
- tsf: BareAssocMouseClicked 声明挪到 public 区 (f45cb27)
- tsf: 无占位联想期间文档焦点反弹且鼠标刚按过，按用户点击通知服务端收窗 (3fb1194)
- assoc: 无占位联想时候选窗不随远处光标上报飘走，点击挪光标立即收窗 (e52382b)
- linux: GNOME 无扩展折中按 sf 除回预乘的相对光标 (fa81812)
- linux: GNOME 字体缩放不再放大候选窗坐标 (8c8f4f6)
- macos: 注册输入源后立即退出，不再常驻占住 bundle (883d0c1)
- linux: 点回上屏前的位置、点到别行同一列时输入序列记账也作废 (dc94e7e)
- punct: 英半列等于原字符时英文态不再吃键 (180579e)
- mobile: 快捷输入等文本缓冲模式下触摸数字交给引擎，不再顶首选上屏 (e591548)
- input: 开关关着时不改旧行为：mac/Linux 汉字后的数字照旧透传，智能符号不额外解除 (99fd861)
- input: 英文词空格恢复上屏即补，中英空格只管切换处；挪光标改由 DLL 识别 (c89f37d)
- input: 补空格实测修正：挪光标作废、行首不补、英文词连打、汉字后数字 (6801e2f)
- codetable: 整句设置逐键借用读取，方案自带切换键也做冲突体检 (20c259b)
- input: 补空格审查修正：漏记的上屏点、旧客户端兜底、武装串一致 (72f39ce)
- pinyin: N-best 解码按已拼文本去重，备选不再被同文切分挤掉 (bdf132b)
- pinyin: N-best 备选整句不算精确整词，第 1 名不再被降到其后 (d203d1e)
- mobile: 方案覆盖文件写坏时拒绝读改写，不再整份冲掉 (c4adf46)
- linux: 允许 GNOME Shell 51 加载 windinput-caret 扩展 (#291) (9495281)
- store: 空闲回收测试的正向等待放宽到秒级上限 (#286) (565710a)
- mobile: 不补空格的选词入口，commitDirect 不再多出空格 (99256ef)
- tsf: 防止加词面板 Ctrl+Enter 穿透宿主 (e62cf96)
- punct: 修正标点顶屏自动配对的光标回退 (56e94d8)
- coordinator: session 路径也在首帧触发反查索引，长按不再被重渲染打断 (d7298e6)
- coordinator: composing 不被上屏后残留的 preedit 误判，接缝测试改查 token (128d049)
- coordinator: 只改移动端语法配置也重建引擎 (91b92b7)
- engine: 覆盖层在构造时传入，移动端不再重建引擎 (bb1e425)
- quick: Free/大写英文透镜的历史按英文调频排 (461ded6)
- windows: 计划任务启动后抬回 Normal、按键线程提级，消竞争下的候选顿挫 (0e99981)
性能优化
重构
- userdata: user/temp/draft 词库新建时改为码在前 (651fb7b)
- ui: 候选窗生效主题纯函数下沉到 wind-scene (2adb6e8)
- ui: 候选窗场景与皮肤几何迁入 wind_scene::candidate (8b600e4)
- ui: 三处候选窗渲染管线的公共段收进场景 (190b98d)
- ui: 皮肤几何与装饰状态机归入候选窗场景 (41d8aac)
- ui: 候选窗场景构建改为纯数据输入（CandidateScene） (77e78bb)
- ui: View、图片缓存、皮肤与主题资源迁入 wind-scene (f7879fd)
- ui: 脚本切段与颜色区间迁入 wind-scene (927cd10)
- ui: 文字公共类型与 TextBackend 迁入 wind-scene (3cc5769)
- ui: 新建 wind-scene crate 骨架 (59c40d7)
- mobile: 反向通道改收 SessionEvent，不再读取 UiCommand (6b12b8a)
- coordinator: 输出增加中立的 SessionEvent 通道 (ae078d6)
- mobile: 门面显式声明移动 Profile (efcbdbc)
- coordinator: 平台差异改由运行期 InputProfile 决定 (b3e77b2)
其他变更
- webdata: exportPackage 注释改为约束网页出包的落点 (caa6f79)
- config: 门禁清单登记移动端新增的配置加载与资源层拼接点 (7d30978)
- webdata: 主题包导出超条目数的文案随导出前自检更新 (40bc398)
- 皮肤设计稿标出尚未实现的三项 (d297f56)
- ui: 候选窗金样补皮肤、动画、上翻、DPI 与整条管线 (db64ea7)
- wind-scene 抽取方案（P3 分期、金样缺口、wasm 前瞻） (ed66e52)
- 皮肤动画 P5 范围（事件状态机与关闭开关） (71a0741)
- 皮肤动画 P4 范围 (44fc395)
- 皮肤拉伸带需落在外轮廓恒定段 (56d46e6)
- 主题异形皮肤与动画设计稿 (10afed1)
- 联想占位变更登记补上合入区间 (defdbd8)
- 登记联想态可不挂占位组合的候选行为变化 (4aac1bc)
- linux: 构建环境补 gio，GNOME 光标扩展客户端进发布包 (923cccf)
- input: 小键盘运算符的产出须与开关无关 (71a6c3b)
- input: 钉住英文词后标点顶屏不带空格、标点形态跟中文标点状态 (30d0df9)
- codetable: 撤回空码组词 compose_input (5018830)
- codetable: 空码组词覆盖评测（全部 2~4 码空码 + 语料未收词） (9c3caba)
- 空码组词补登记合入号 (6b5cd6e)
- 码表整句增强补登记合入号 (47a9621)
- pinyin: 修正 N-best 用户词对照用例的边界，补登记合入号 (be8f9ae)
- design: 中英/数字间按需补空格与英文后智能标点 (4761f96)
- transfer: 导入上限测试改用 Result::expect，过 clippy ok_expect (c70da4c)
- mac: 状态泡避让断言按 scale 折算高度，Retina 机器上不再误报 (de9c167)
- release: macOS 安装包改在 macos-26 上构建 (e15cee5)
- macOS job 换到 macos-26 (c0a728a)
- design: 日期短语偏移后缀（zzrq+1）设计稿，未实施 (0dea6c1)
- aux_code: Ctrl/Alt 守卫断言跟上「清组合后交还宿主」 (0bfd7c0)
- mobile: 模块头同步新的通道形状 (4471e79)
- core: 首显闸门基线改为事件驱动 (c1983ec)
- core: 事件流基线补首显闸门与坐标透传 (fd6ebcd)
- core: 事件流基线排除冷启动时序并收紧重录开关 (0ab883a)
- core: 录制 UiCommand 与移动端事件流基线 (88c0283)
- @yeruouo has signed the CLA in #295 (41f9a61)
- release-notes: 致谢语不再指明反馈渠道 (601e85c)
Contributors
yeruouo