清风输入法 v0.13.1-alpha

---

通知

此版本为 Go 开发版本的最后一版，新版本将会使用 Rust 开发，所有的配置文件格式都将发生变更，不再兼容。请自行进行备份！

✏️ 更新说明

✨ 新增

• 增加 e2e 测试框架，减少迭代时问题回归
• 增加 URL 输入模式

🔧 优化

• 重构多输入模式的融合逻辑
• 快捷模式默认融合英文
• 扩展词库不带权重时，按词库的引用顺序确定优先级
• 导入导出方案时支持 wdb 词库

🐛 修正

• 修正方案管理删除方案不生效的问题
• 修正混输歧义顶码在一些场景下不生效的问题
• 修正设置中的字体列表会有多项重复的问题
• 修正 macOS 下 Command + C/V 不工作的问题
• 修正默认的扩展词库从来源继承的一些错误

变更记录

新功能

• dict: 按词库声明顺序排列无权重候选
• setting: 导出方案支持 wdb-only 词库
• addword: 新增独立加词快捷键并修复加词窗布局
• candidate: 取消单字候选不可删除/隐藏的限制
• coordinator: 模式路径慢请求相位埋点——拆出 mode_pinyin_cands / mode_dispatch
• coordinator: 统一夺取回退机制（决策器持有）+ 接入 URL
• settings: URL 输入模式进配置模板 + 设置页选项
• coordinator: URL 临时输入模式——前缀夺取的独占处理器
• coordinator: 决策器翻默认——decider_enabled 默认 true（生产路径）
• coordinator: 快捷模式融合 F5——启用源 eager 加载（英文/生僻字词库）
• coordinator: 快捷模式融合 F3——extraCandidates 融合钩子（默认字节等价）
• coordinator: 快捷模式融合 F2——生僻字/英文候选 Provider（未接线）
• config: 快捷模式融合 F1——AlphaProviders 各源开关配置
• coordinator: 融合框架 S4——消灭 quickInputPinyinMode，拼音降为 Provider 取源
• coordinator: 融合框架 S3——临时拼音候选 Provider（未接线）
• coordinator: 融合框架 S2——date/calc/number 抽成候选 Provider
• coordinator: 融合框架 S1——Provider 接口 + 分段合并器
• coordinator: special 触发收口进决策器
• coordinator: 决策器全接管四模式内部按键——流水线 host 状态机
• coordinator: 输入处理器流水线地基（决策器骨架 + 影子运行 + temp_pinyin）

Bug 修复

• e2e: ConfigureSchema 选项替代修改生产 schema 默认值
• e2e: 启用拼音方案词频以修复 CI TestLearningFreqRecorded
• e2e: 修复 TestLearningFreqRecorded——两级异步导致词频 Count 恒为 0
• coordinator: macOS ⌘ 组合键透传，修复 Command+C/V 复制粘贴失效
• setting: 修复方案删除不生效及字体列表重复项
• mixed: naap 等退化解析全码也参与歧义顶码上屏
• dictgen: extra 词库非法编码容错修正
• ci: 预生成 wdat 消除 E2E golden 不一致
• coordinator: 收口审查修复——链外 clearState 后 host 回填 + 清理
• coordinator: URL 多键夺取——退格删回前缀边界仍能回退正常输入流
• coordinator: 拼音模式无候选时 preedit 合并为原始输入
• special: 快符空格选首候选 + =/- 优先翻页

重构

• dictcache: 移除 TOML+TSV 词库格式，dictsource 收敛为 YAML-only
• coordinator: applyEngineDiff 引擎层副作用单点化（I3）
• coordinator: engine_default 正常输入进决策器链
• coordinator: 退役 decider-off——决策器成唯一键事件路径
• coordinator: z 键混合回退迁入统一夺取回退机制
• coordinator: temp_english 导航分解——四模式链分解收官
• coordinator: quick_input 导航分解——navKeyHandler 翻页谓词参数化 + 双上下文
• coordinator: 导航 handler 泛化为通用 navKeyHandler——接入 special
• coordinator: KeyHandler 链分解试点——temp_pinyin 导航抽成链上 handler
• coordinator: z 首次触发仲裁收编进决策器
• coordinator: 融合框架 S1 审查精修 + 同步 AGENTS.md
• coordinator: 统一宿主卸载清理 + 抽取共享候选导航

其他变更

• test(e2e): 换稳定测试输入消除词典版本漂移
• test(e2e): 稳定 golden 候选排序 + 词频测试按文本定位候选
• 为 e2e golden 文件固定 LF 行尾
• 修复 E2E 测试因缺失 build_debug/data 失败
• test(e2e): 补 z 键回退 golden——覆盖决策器 judgeZFallback/CompHot 路径
• test(e2e): 决策器 A/B 开关——golden 在 decider 开/关下复跑验证等价
• coordinator: 融合框架 S5 收尾——设计文档校准到落地状态
• test(e2e): 用户词库自定义词可观测 golden
• test(e2e): 双拼与混输方案核心转换 golden
• test(e2e): 词频记录管线回归 + 同步 flush API；清理 OpenUserStore 死字段
• test(e2e): 四态接管模式多场景补充 + 中英文切换 golden
• test(e2e): 引导键特殊模式多场景 golden + 注册表目录注入

---

安装

系统要求

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

Windows 安装

安装包（推荐）

1. 下载下方 WindInput-x.x.x-Setup.exe 安装包
2. 双击运行安装程序，按提示完成安装
3. 安装完成后，按 Win + Space 或 Ctrl + Shift 切换到清风输入法即可使用

便携版

1. 下载下方 WindInput-x.x.x-Portable.zip
2. 解压到任意目录（如 D:\Software\WindInput）
3. 运行 wind_portable.exe 启动输入法

便携版数据保存在程序所在目录，适合 U 盘携带或多环境使用。

提示：由于当前版本没有数字签名，安装时 Windows 安全中心（SmartScreen）可能会弹出拦截提示。点击「更多信息」→「仍要运行」即可继续安装。

macOS 安装（alpha）

1. 下载下方 WindInput-x.x.x-macOS.pkg（universal，含输入法、后台服务、设置程序三件套）
2. 双击运行安装，按提示完成
3. 到「系统设置 → 键盘 → 文本输入 → 输入法」添加并切换到「清风输入法」（也可用 ⌃Space 切换）

卸载：双击 ~/Applications/卸载清风输入法.app。

提示：macOS 版未做苹果公证，首次安装/启用可能需要在「系统设置 → 隐私与安全性」中点「仍要打开」放行；macOS 26 (Tahoe) 对未公证输入法限制更强。重新安装前建议先注销或重启，以清除系统输入法注册缓存。

注意事项

• 本项目目前处于 alpha 阶段，主要面向感兴趣的爱好者和早期测试用户
• 功能和配置文件格式可能在后续版本中发生变化
• 升级后如遇异常，请尝试删除配置目录 %APPDATA%\WindInput\ 以恢复默认配置

反馈与交流

使用中遇到问题或有功能建议，欢迎通过以下方式联系：

• GitHub Issues：提交问题或建议
• QQ 交流群：1085293418

清风输入法 v0.13.0-alpha

---

✏️ 更新说明

✨ 新增

• 配置文件改为 TOML 格式，旧配置会自动转换（除主题和词库文件外）
• 增加切换到清风输入法的快捷键设置（默认：Ctrl+Shift+[）
• 增加智能符号功能，快速输入2次中文符号转英文
• 自定义符号映射支持英文半角的设置，支持空格键的设置
• 增加码表方案以 wdb 词库文件替代 yaml 文件的支持

🔧 优化

• 增强 Host Render 模式的能力，在系统搜索中可以进行基础的鼠标操作
• 优化混输模式下长编码无匹配时不再拆分显示
• 优化闲置时的内存占用

🐛 修正

• 修正 mintty/putty 下 Shift 无法切换中英文的问题
• 修正混输方案没有加载扩展词库的问题
• 修正有时快速切换应用输入的第一个字母会以英文上屏的问题
• 修正多方案词库被加载多份的问题

变更记录

新功能

• input: 自定义符号映射四状态+空格映射+清空修复
• dict: wdb-only 词库分发模式
• setting: 方案与短语导入导出统一 TOML + 修复导出遗漏拆字/关联词库
• config: schema 方案与系统短语迁移至 TOML（词库保持 YAML）
• setting: 配置目录默认路径按钮 + Windows 路径显示修正 + 懒挂载优化
• input: 智能符号模式——连按两次中文标点转英文
• host-render: 状态提示气泡接入宿主渲染
• host-render: tooltip 接入宿主渲染 + 多 host 窗口基础设施
• host-render: 宿主进程候选框宿主渲染 + 鼠标交互
• tsf: 启动日志升级——将宿主进程名合并至 INFO 级
• hotkey: 本地热键直接进入临时拼音/特殊输入模式
• hotkey: 新增「切换到本输入法」per-app 快捷键
• hotkey: Windows 全局热键一键切换到本输入法
• config: 设置前端 v1 key 迁移 + 中期审查修复（切片 3）
• config: v1 配置结构重排 + 三态统一 + v0→v1 迁移（切片 1+2 Go 侧）
• config: 配置版本机制与 map 层迁移链骨架（切片 0）
• engine: 引擎 LRU 驱逐 + 空闲 Working Set 修剪
• config: 配置文件由 YAML 迁移至 TOML（桥接式编解码）

Bug 修复

• mixed: 混输加载主方案扩展词库——孙燕姿等扩展词不再打不出
• ui: 修复 COM vtable 访问的 unsafe.Pointer 误用
• tsf: mintty 等终端 Shift 切换无效——OnTestKeyUp 未调 OnKeyUp
• host-render: 受限宿主(微软商店)band 回退 + 建窗失败上报
• host-render: 修复同 PID 多实例候选渲染两层、只隐一个
• focus: 焦点切换首次按键模式竞态——FocusGained 同步路径预推送模式标志
• mixed: 混输码长内多音节拼音补齐音节分段显示
• cmdbar: 修复配置重构后 config.set/toggle/applySection 键路径错误
• build: 修复 build_all.ps1 中文编码在 Windows PowerShell 下的解析错误
• config: TOML 写出省略空中间表头
• setting: 终审修复——tooltip 重置深拷贝防默认值缓存污染
• dict: WdatReader 接入强关注册表，修复重建缓存后拼音生成失败
• dict: mmap reader 进程级共享，消除多方案重复映射
• tsf: 协议解析边界检查改减法形式防整型回绕
• bridge: push pipe 出站统一走队列并加写超时
• config: 异步保存改用深拷贝，消除共享 map 并发 panic

重构

• naming: 统一按键/配置 key/枚举字面量为生成常量与具名常量
• 清理死代码与陈旧契约

其他变更

• 修改默认配置的说明内容
• diag(tsf): 补 Shift 切换被拦截时的诊断日志
• config: 配置体系重构设计文档与实现计划

---

安装

系统要求

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

Windows 安装

安装包（推荐）

1. 下载下方 WindInput-x.x.x-Setup.exe 安装包
2. 双击运行安装程序，按提示完成安装
3. 安装完成后，按 Win + Space 或 Ctrl + Shift 切换到清风输入法即可使用

便携版

1. 下载下方 WindInput-x.x.x-Portable.zip
2. 解压到任意目录（如 D:\Software\WindInput）
3. 运行 wind_portable.exe 启动输入法

便携版数据保存在程序所在目录，适合 U 盘携带或多环境使用。

提示：由于当前版本没有数字签名，安装时 Windows 安全中心（SmartScreen）可能会弹出拦截提示。点击「更多信息」→「仍要运行」即可继续安装。

macOS 安装（alpha）

1. 下载下方 WindInput-x.x.x-macOS.pkg（universal，含输入法、后台服务、设置程序三件套）
2. 双击运行安装，按提示完成
3. 到「系统设置 → 键盘 → 文本输入 → 输入法」添加并切换到「清风输入法」（也可用 ⌃Space 切换）

卸载：双击 ~/Applications/卸载清风输入法.app。

提示：macOS 版未做苹果公证，首次安装/启用可能需要在「系统设置 → 隐私与安全性」中点「仍要打开」放行；macOS 26 (Tahoe) 对未公证输入法限制更强。重新安装前建议先注销或重启，以清除系统输入法注册缓存。

注意事项

• 本项目目前处于 alpha 阶段，主要面向感兴趣的爱好者和早期测试用户
• 功能和配置文件格式可能在后续版本中发生变化
• 升级后如遇异常，请尝试删除配置目录 %APPDATA%\WindInput\ 以恢复默认配置

反馈与交流

使用中遇到问题或有功能建议，欢迎通过以下方式联系：

• GitHub Issues：提交问题或建议
• QQ 交流群：1085293418

清风输入法 v0.12.0-alpha

---

✏️ 更新说明

✨ 新增

• 新增特殊码表模式的支持，可自定义快符模式/生僻字模式
• 设置增加 --web 参数，进入不依赖 WebView2 的纯 web 模式（部分依赖桌面的功能会无法使用）

🔧 优化

• 命令直通车增加切换工具栏，主题，设置项的功能

🐛 修正

• 修正 macOS 下阴影双重渲染的问题
• 修正 macOS 下设置版本号显示不正确的问题

🔩 其他

• 系统短语增加几个命令直通车新增功能

变更记录

新功能

• cmdbar: setting.web 支持及 config.get/set/toggle 命令实现
• setting: Web 形态服务端安全加固
• special-mode: 引导键自定义码表特殊模式核心
• special-mode: 配置与数据层基础（自定义码表前置件）

Bug 修复

• cmdbar: 修复工具栏切换和主题循环命令直通车
• setting: 修复词库管理页在桌面端整页空白
• build_mac: 设置应用注入版本号并修复 BOM 未剥离
• dev_mac: 全链路透传 $VARIANT 给设置应用（构建/安装/模块/卸载）
• theme: 绕过 yaml.v3 对泛型类型 Unmarshaler 接口检测的缺陷
• macos: 软件阴影存在时动态禁用系统窗口阴影，消除黑边

重构

• setting: 文件对话框统一走 Web 安全包装

其他变更

• special-mode: 自定义码表特殊模式设计与实施计划

---

安装

系统要求

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

Windows 安装

安装包（推荐）

1. 下载下方 WindInput-x.x.x-Setup.exe 安装包
2. 双击运行安装程序，按提示完成安装
3. 安装完成后，按 Win + Space 或 Ctrl + Shift 切换到清风输入法即可使用

便携版

1. 下载下方 WindInput-x.x.x-Portable.zip
2. 解压到任意目录（如 D:\Software\WindInput）
3. 运行 wind_portable.exe 启动输入法

便携版数据保存在程序所在目录，适合 U 盘携带或多环境使用。

提示：由于当前版本没有数字签名，安装时 Windows 安全中心（SmartScreen）可能会弹出拦截提示。点击「更多信息」→「仍要运行」即可继续安装。

macOS 安装（alpha）

1. 下载下方 WindInput-x.x.x-macOS.pkg（universal，含输入法、后台服务、设置程序三件套）
2. 双击运行安装，按提示完成
3. 到「系统设置 → 键盘 → 文本输入 → 输入法」添加并切换到「清风输入法」（也可用 ⌃Space 切换）

卸载：双击 ~/Applications/卸载清风输入法.app。

提示：macOS 版未做苹果公证，首次安装/启用可能需要在「系统设置 → 隐私与安全性」中点「仍要打开」放行；macOS 26 (Tahoe) 对未公证输入法限制更强。重新安装前建议先注销或重启，以清除系统输入法注册缓存。

注意事项

• 本项目目前处于 alpha 阶段，主要面向感兴趣的爱好者和早期测试用户
• 功能和配置文件格式可能在后续版本中发生变化
• 升级后如遇异常，请尝试删除配置目录 %APPDATA%\WindInput\ 以恢复默认配置

反馈与交流

使用中遇到问题或有功能建议，欢迎通过以下方式联系：

• GitHub Issues：提交问题或建议
• QQ 交流群：1085293418

清风输入法 v0.11.5-alpha

---

✏️ 更新说明

✨ 新增

• 增加混输模式顶码歧义串的模式开关

🔧 优化

• 优化生成词库缓存时的内存占用，避免低内存时服务容易被杀的问题
• 优化嵌入编码时，进入临时拼音时显示提示
• 缩短速度统计的时间周期
• 优化配置文件不合法时的异常处理，减少输入法无法使用的情况
• 优化安装时的一些表现和杀进程方式

🐛 修正

• 修正混输模式下z键输入拼音的错误

变更记录

新功能

• dictcache: 低内存环境下词库生成采用省内存路径，降低生成期内存峰值
• mode-trigger: 模式激活键支持正在输入时顶码上屏并进入模式
• mixed: 顶码歧义开关默认关闭+设置项+热更新生效，并统一混输配置推导
• updater: 支持 macOS .pkg 更新检查与 R2 分发
• mixed: 顶码歧义串按整音节+终止全码裁决，加 topcode_override_pinyin 开关

Bug 修复

• installer: 杀进程改用 taskkill 异步重试+PowerShell 兜底，避免卡死进程拖垮安装
• service: 补充 darwin 平台 isInstallerRunning 桩，修复 macOS 构建
• config: 解析失败时自愈回写+容错保存，避免坏配置导致输入法不可用
• mode-hint: 嵌入编码下进入模式时显示模式徽标提示
• installer: 安装卸载期间防止服务被 DLL 重拉，移除重启提示弹窗
• stats: 缩短活跃时间阈值与速度统计下限
• temp-pinyin: 混输模式下禁止 z 键回退临时拼音

其他变更

• retrospective: 新增低内存词库生成内存优化分析复盘
• retrospective: 新增模式激活优先级回落链复盘

---

安装

系统要求

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

Windows 安装

安装包（推荐）

1. 下载下方 WindInput-x.x.x-Setup.exe 安装包
2. 双击运行安装程序，按提示完成安装
3. 安装完成后，按 Win + Space 或 Ctrl + Shift 切换到清风输入法即可使用

便携版

1. 下载下方 WindInput-x.x.x-Portable.zip
2. 解压到任意目录（如 D:\Software\WindInput）
3. 运行 wind_portable.exe 启动输入法

便携版数据保存在程序所在目录，适合 U 盘携带或多环境使用。

提示：由于当前版本没有数字签名，安装时 Windows 安全中心（SmartScreen）可能会弹出拦截提示。点击「更多信息」→「仍要运行」即可继续安装。

macOS 安装（alpha）

1. 下载下方 WindInput-x.x.x-macOS.pkg（universal，含输入法、后台服务、设置程序三件套）
2. 双击运行安装，按提示完成
3. 到「系统设置 → 键盘 → 文本输入 → 输入法」添加并切换到「清风输入法」（也可用 ⌃Space 切换）

卸载：双击 ~/Applications/卸载清风输入法.app。

提示：macOS 版未做苹果公证，首次安装/启用可能需要在「系统设置 → 隐私与安全性」中点「仍要打开」放行；macOS 26 (Tahoe) 对未公证输入法限制更强。重新安装前建议先注销或重启，以清除系统输入法注册缓存。

注意事项

• 本项目目前处于 alpha 阶段，主要面向感兴趣的爱好者和早期测试用户
• 功能和配置文件格式可能在后续版本中发生变化
• 升级后如遇异常，请尝试删除配置目录 %APPDATA%\WindInput\ 以恢复默认配置

反馈与交流

使用中遇到问题或有功能建议，欢迎通过以下方式联系：

• GitHub Issues：提交问题或建议
• QQ 交流群：1085293418

清风输入法 v0.11.4-alpha

---

✏️ 更新说明

✨ 新增

• 新增 windinput:// URL Schema 一键导入
• 设置的关于页，新增官网入口
• 设置增加 Web 编辑器的入口

🔧 优化

• 混输模式限制拼音的前缀匹配以提高性能
• 优化主题文件导入时覆盖时不需要二次选择文件

🐛 修正

• 修正一些场景顶码上屏首候选与 UI 候选框不一致的问题
• 修正候选项移动引起的翻页不会自动加载后续页内容的问题

🔩 其他

• 修改“上方显示时反转布局”的默认值以保证习惯

变更记录

新功能

• dict: 词库导入格式选择页新增 UTF-8 编码要求提示
• setting: 新增 windinput:// URL Schema 一键导入
• about: 新增官网入口横幅
• appearance: Web编辑器连接改为三态下拉，新增主题工具入口

Bug 修复

• singleton: 修复跨完整性级别时设置弹出第二个窗口
• protocol: 协议导入改为幂等取出，消除冷启动重复弹框
• mixed: 混输全码清空在码表拼音双空时正确触发
• theme: 修复文件导入冲突确认时重复弹出文件选择框的问题，新增导入成功 toast 提示
• pager: 下键/TAB 逐项移动翻页时触发分级加载
• mixed: 顶码上屏首候选与 UI 候选框严格一致

重构

• dict: 彻底移除拼音 wdb 支持，统一走 DAT

性能优化

• dict: 简拼查询改为精确长度匹配，消除短简拼卡顿

其他变更

• candidate: 候选数量分档设计（基础档+扩展档+统一对接）
• release: NSIS 安装失败时提前失败并重试
• mixed: 明确 ProtectTopN 仅纯码表路径生效（方案 B）

---

安装

系统要求

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

Windows 安装

安装包（推荐）

1. 下载下方 WindInput-x.x.x-Setup.exe 安装包
2. 双击运行安装程序，按提示完成安装
3. 安装完成后，按 Win + Space 或 Ctrl + Shift 切换到清风输入法即可使用

便携版

1. 下载下方 WindInput-x.x.x-Portable.zip
2. 解压到任意目录（如 D:\Software\WindInput）
3. 运行 wind_portable.exe 启动输入法

便携版数据保存在程序所在目录，适合 U 盘携带或多环境使用。

提示：由于当前版本没有数字签名，安装时 Windows 安全中心（SmartScreen）可能会弹出拦截提示。点击「更多信息」→「仍要运行」即可继续安装。

macOS 安装（alpha）

1. 下载下方 WindInput-x.x.x-macOS.pkg（universal，含输入法、后台服务、设置程序三件套）
2. 双击运行安装，按提示完成
3. 到「系统设置 → 键盘 → 文本输入 → 输入法」添加并切换到「清风输入法」（也可用 ⌃Space 切换）

卸载：双击 ~/Applications/卸载清风输入法.app。

提示：macOS 版未做苹果公证，首次安装/启用可能需要在「系统设置 → 隐私与安全性」中点「仍要打开」放行；macOS 26 (Tahoe) 对未公证输入法限制更强。重新安装前建议先注销或重启，以清除系统输入法注册缓存。

注意事项

• 本项目目前处于 alpha 阶段，主要面向感兴趣的爱好者和早期测试用户
• 功能和配置文件格式可能在后续版本中发生变化
• 升级后如遇异常，请尝试删除配置目录 %APPDATA%\WindInput\ 以恢复默认配置

反馈与交流

使用中遇到问题或有功能建议，欢迎通过以下方式联系：

• GitHub Issues：提交问题或建议
• QQ 交流群：1085293418

清风输入法 v0.11.3-alpha

---

✏️ 更新说明

✨ 新增

• 设置新增重新生成词库缓存的功能
• 新增候选窗在上方时逆序显示的功能
• 增加完全隐藏翻页栏的功能

🐛 修正

• 修正中文下大写在一些应用中无法输入的问题

变更记录

新功能

• dict: 新增词库缓存重新生成功能并预构建已启用方案缓存
• ui: 支持翻页栏完全隐藏
• settings: 新增「上方显示时反转布局」设置选项

Bug 修复

• ui: 为 darwin stub 补充 SetFlipLayoutWhenAbove 方法
• tsf: 中文大写下字母键源头透传，修复部分应用无法输入字母

重构

• config: 拆分 pager_display_mode 为两个独立字段

其他变更

• test(theme): 更新 V3 golden 快照以包含 HidePager 字段

---

安装

系统要求

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

Windows 安装

安装包（推荐）

1. 下载下方 WindInput-x.x.x-Setup.exe 安装包
2. 双击运行安装程序，按提示完成安装
3. 安装完成后，按 Win + Space 或 Ctrl + Shift 切换到清风输入法即可使用

便携版

1. 下载下方 WindInput-x.x.x-Portable.zip
2. 解压到任意目录（如 D:\Software\WindInput）
3. 运行 wind_portable.exe 启动输入法

便携版数据保存在程序所在目录，适合 U 盘携带或多环境使用。

提示：由于当前版本没有数字签名，安装时 Windows 安全中心（SmartScreen）可能会弹出拦截提示。点击「更多信息」→「仍要运行」即可继续安装。

macOS 安装（alpha）

1. 下载下方 WindInput-x.x.x-macOS.pkg（universal，含输入法、后台服务、设置程序三件套）
2. 双击运行安装，按提示完成
3. 到「系统设置 → 键盘 → 文本输入 → 输入法」添加并切换到「清风输入法」（也可用 ⌃Space 切换）

卸载：双击 ~/Applications/卸载清风输入法.app。

提示：macOS 版未做苹果公证，首次安装/启用可能需要在「系统设置 → 隐私与安全性」中点「仍要打开」放行；macOS 26 (Tahoe) 对未公证输入法限制更强。重新安装前建议先注销或重启，以清除系统输入法注册缓存。

注意事项

• 本项目目前处于 alpha 阶段，主要面向感兴趣的爱好者和早期测试用户
• 功能和配置文件格式可能在后续版本中发生变化
• 升级后如遇异常，请尝试删除配置目录 %APPDATA%\WindInput\ 以恢复默认配置

反馈与交流

使用中遇到问题或有功能建议，欢迎通过以下方式联系：

• GitHub Issues：提交问题或建议
• QQ 交流群：1085293418

清风输入法 v0.11.2-alpha

---

✏️ 更新说明

✨ 新增

• 主题导入功能增强
• 主题架构增强：增加窗口阴影支持
• 升级检测增加官网渠道，国内访问更顺畅

🔧 优化

• 去除主题渲染中的一些硬编码配置（现有主题可能会有轻微的变化）
• 优化大写锁定时的按键处理，提高兼容性

🐛 修正

• 修正临时拼音进入后直接切换英文时，候选窗口不隐藏的问题
• 修正模式快捷键按两次输入原符号时没有遵循符号映射的问题
• 修正混输模式下，一些情况顶码上屏的不是第一个候选的问题
• 修正主题的一些细节渲染问题

🔩 其他

变更记录

新功能

• theme: 主题导入新增从链接下载功能
• updater: 新增升级渠道配置，默认走官网 CDN
• theme: ThemeMeta 新增 description 和 tags 字段用于主题发布
• shadow: toast/status/tooltip 同步支持 blur+spread 投影
• shadow: 候选窗支持 blur+spread 浮动投影，画布扩展后以内容尺寸定位
• shadow: 实现 blur/spread 模糊扩散阴影（微信输入法浮起效果）
• theme: 背景图/覆盖层定位升级——anchor/offset(dp+百分比)/size + 裁到边框盒
• theme: footer_bar margin 补横排——内联翻页包容器承载
• theme: margin 升为通用盒模型能力——各流式子节点接线 + 能力声明同步
• theme: 文本叶子 padding 忠实生效 + preedit 边框补齐 + text/comment 盒能力声明
• theme: 状态态补齐背景渐变 + 覆盖层支持（几何仍冻结避免跳动）
• theme: 用 SVG 矢量图取代内置字符翻页箭头

Bug 修复

• coordinator: 中文大写模式非全角下字母键透传宿主，修复 CAD 快捷键失效
• coordinator: 临时模式触发键二次按下时符号转换未走自定义映射
• coordinator: 临时拼音/英文模式激活后未输入字符切换模式时候选窗不隐藏
• shadow: 修正 blur pad 计算——3-sigma 公式覆盖完整模糊梯度
• pager: 横排分页器与候选列表间距改由 footer_bar.margin.left 控制
• test: 重烤竖排几何指纹 golden——序号去硬编码3dp偏置 + L/R margin 全量生效
• index: 去除竖排圆圈序号的硬编码 3dp 定位偏置
• index-margin: 竖排序号 L/R margin 全量生效
• theme: 主题导入/推送改用 meta.name 唯一性校验替代目录名校验
• ui: 边框改 even-odd 填充环，修复中心描边 AA 致的粗细不均
• engine: 混输顶码上屏未应用 Shadow pin 导致候选调整失效
• theme: mergeViewNode 修复 PrevChar/NextChar 两处 bug
• theme: base 主题 ViewImage.Ref 相对路径随继承错位
• theme: menu.item 边框 color/width 生效 + 清除 sc(N*scale) 双重缩放

重构

• ui: 翻页箭头改用 Unicode 字符，支持主题 prev_char/next_char 定制
• theme: 横竖候选窗共用 buildCandidateItem，差异收敛为 3 参数

其他变更

• theme: 重落 capabilities.json(state_geometry) + 继承语义审计文档
• theme: 补齐 state_geometry 能力键 + 编辑器消费契约文档

---

安装

系统要求

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

Windows 安装

安装包（推荐）

1. 下载下方 WindInput-x.x.x-Setup.exe 安装包
2. 双击运行安装程序，按提示完成安装
3. 安装完成后，按 Win + Space 或 Ctrl + Shift 切换到清风输入法即可使用

便携版

1. 下载下方 WindInput-x.x.x-Portable.zip
2. 解压到任意目录（如 D:\Software\WindInput）
3. 运行 wind_portable.exe 启动输入法

便携版数据保存在程序所在目录，适合 U 盘携带或多环境使用。

提示：由于当前版本没有数字签名，安装时 Windows 安全中心（SmartScreen）可能会弹出拦截提示。点击「更多信息」→「仍要运行」即可继续安装。

macOS 安装（alpha）

1. 下载下方 WindInput-x.x.x-macOS.pkg（universal，含输入法、后台服务、设置程序三件套）
2. 双击运行安装，按提示完成
3. 到「系统设置 → 键盘 → 文本输入 → 输入法」添加并切换到「清风输入法」（也可用 ⌃Space 切换）

卸载：双击 ~/Applications/卸载清风输入法.app。

提示：macOS 版未做苹果公证，首次安装/启用可能需要在「系统设置 → 隐私与安全性」中点「仍要打开」放行；macOS 26 (Tahoe) 对未公证输入法限制更强。重新安装前建议先注销或重启，以清除系统输入法注册缓存。

注意事项

• 本项目目前处于 alpha 阶段，主要面向感兴趣的爱好者和早期测试用户
• 功能和配置文件格式可能在后续版本中发生变化
• 升级后如遇异常，请尝试删除配置目录 %APPDATA%\WindInput\ 以恢复默认配置

反馈与交流

使用中遇到问题或有功能建议，欢迎通过以下方式联系：

• GitHub Issues：提交问题或建议
• QQ 交流群：1085293418

清风输入法 v0.11.1-alpha

---

✏️ 更新说明

✨ 新增

• 主题功能增加 Web 编辑器的对接
• 主题功能增加打开目录，删除主题的功能
• 主题渲染引擎进行一些增强：支持矢量图，支持渐变，支持一些状态配置

🔧 优化

• 调整设置的左栏按钮
• 设置的保存和重置根据实际状态配置可用性

🐛 修正

• 修正设置搜索栏的暗色模式表现
• 修正设置的滚动条暗色模式表现

变更记录

新功能

• setting: 主题列表支持删除外部主题 + 打开用户主题目录
• theme: P7-E 渐变填充落地（linear/radial 全链路渲染）
• theme: 主题能力声明 schema + 间距字段/菜单 padding 渲染补全
• setting: 侧边栏按钮按页面状态动态禁用
• setting: 侧边栏「恢复本页」「重新加载」并排各占一半
• debug: 候选右键"调试复制"子菜单增加"复制 Tooltip"
• setting: 主题在线推送在线编辑服务(ThemeServer)
• theme: 候选文字/序号/注释状态外观统一可配（默认/选中/悬停 × 背景/边框/字体/颜色）
• theme: view 颜色字段支持内联 {light,dark}（ColorRef）
• theme: 主题图片支持矢量图(SVG)+ 单色染色，翻页箭头可换图/配色

Bug 修复

• theme: colors.primary 支持 {light,dark} map 形态
• setting: 修复方案设置修改后保存按钮不响应的问题
• setting: 方案内部设置改动统一走「保存设置」而非即时写后端
• setting: 修复暗色模式下滚动条及零散硬编码颜色问题
• setting: 修复搜索栏在暗色模式下背景/边框/文字颜色异常

其他变更

• test(theme): 渐变填充测试 + 文档补全（接 5a25a43）
• theme: 主题在线推送设计与实现计划

---

安装

系统要求

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

Windows 安装

安装包（推荐）

1. 下载下方 WindInput-x.x.x-Setup.exe 安装包
2. 双击运行安装程序，按提示完成安装
3. 安装完成后，按 Win + Space 或 Ctrl + Shift 切换到清风输入法即可使用

便携版

1. 下载下方 WindInput-x.x.x-Portable.zip
2. 解压到任意目录（如 D:\Software\WindInput）
3. 运行 wind_portable.exe 启动输入法

便携版数据保存在程序所在目录，适合 U 盘携带或多环境使用。

提示：由于当前版本没有数字签名，安装时 Windows 安全中心（SmartScreen）可能会弹出拦截提示。点击「更多信息」→「仍要运行」即可继续安装。

macOS 安装（alpha）

1. 下载下方 WindInput-x.x.x-macOS.pkg（universal，含输入法、后台服务、设置程序三件套）
2. 双击运行安装，按提示完成
3. 到「系统设置 → 键盘 → 文本输入 → 输入法」添加并切换到「清风输入法」（也可用 ⌃Space 切换）

卸载：双击 ~/Applications/卸载清风输入法.app。

提示：macOS 版未做苹果公证，首次安装/启用可能需要在「系统设置 → 隐私与安全性」中点「仍要打开」放行；macOS 26 (Tahoe) 对未公证输入法限制更强。重新安装前建议先注销或重启，以清除系统输入法注册缓存。

注意事项

• 本项目目前处于 alpha 阶段，主要面向感兴趣的爱好者和早期测试用户
• 功能和配置文件格式可能在后续版本中发生变化
• 升级后如遇异常，请尝试删除配置目录 %APPDATA%\WindInput\ 以恢复默认配置

反馈与交流

使用中遇到问题或有功能建议，欢迎通过以下方式联系：

• GitHub Issues：提交问题或建议
• QQ 交流群：1085293418

清风输入法 v0.11.0-alpha

---

✏️ 更新说明

✨ 新增

• 底层主题架构重构，支持更自由的定制（注意主题格式发生变化，旧的自定义主题需手动迁移）
• 设置增加搜索功能
• 新增 macOS 平台支持（暂不做过多支持）

🔧 优化

• 截图时将候选窗的图片复制到剪切板
• 优化密码框输入的兼容性
• 重构设置的保存功能，减少选项无法正确保存的问题

🐛 修正

• 修正状态提示开启全角时，切换为宋体的问题
• 修正外观设置中的页码显示方式有时不生效的问题
• 修正统计英文的开关无法正确保存的问题

🔩 其他

• 开发文档进行更新

变更记录

新功能

• theme: 菜单项高亮背景圆角 + 翻页页码/箭头颜色可配
• toolbar: L2 几何进 schema，工具栏几何主题可覆盖
• setting: 设置窗口跳转导航式搜索
• theme: 主题 schema v3 重构（结构归一 + 亮暗统一）
• theme: P8 切片6 — status/tooltip/menu/toast 背景图与 layers 横切
• macos: dev_mac.sh 增加 pkg 安装包入口并修复 di/du 变体透传
• theme: P8 切片5 — Toast 从 gg 直绘迁移到 View 盒模型引擎
• theme: P8 切片3 — 菜单几何 View 化 + 修复 hover 高亮溢出圆角边框
• theme: P8 切片0-2 — 其它窗口几何 View 化地基 + status/tooltip 盒模型
• macos: 密码框/敏感字段自动抑制中文输入
• setting: 新增配置增量 diff 纯函数 diffConfigToItems
• win: 密码框/敏感字段自动抑制中文输入
• macos: forwarder 接入字号/字号跟随主题/候选序号标签
• theme: 临时拼音模式徽标字体纳入 views.mode_label 相对配置，移除 IndexFontSize 残余魔法
• theme: 候选窗字体改为相对主字号偏移配置，移除字号派生魔法
• theme: 候选窗渲染向旧效果对齐 + 几何字段支持 px/dp 单位
• theme: P7 候选窗 schema 补全 — 字体/图层/states/暗色位图
• theme: P6 Behavior 接入 + 候选窗 views 统一
• theme: P4 其它窗口迁移盒模型 View + 颜色 YAML 化
• theme: P2 候选窗 views schema + 颜色 YAML 化
• ui: P0/P1 盒模型 View 渲染引擎 — 横竖排候选窗
• theme: v2.5 schema 地基 + 候选窗字段清理
• macos: 智能成对编辑落地 (光标回退/跳过 + 英文模式配对)
• macos: IPC 超时自愈重连 + 固定证书签名授权持久
• macos: 命令直通车按键模拟 + clip.paste + 平台短语
• macos: 命令直通车 proc 包 darwin 实现 (open/run/shell)
• macos: Toast 接入 + debug/release 双版本共存与设置分离
• macos: 系统输入源菜单接入 + 菜单栏指示器设置开关
• macos: 顶栏状态菜单复用统一菜单树, 与候选框右键菜单一致
• macos: 三件套 .pkg 安装器与卸载器
• macos: 后台服务安装为中文名「清风输入法服务」
• setting: macOS 设置应用显示为「清风输入法设置」
• macos: IME 应用图标与中文名
• hotkey: macOS 打通 ⌘/⌥ 修饰键并统一默认值
• config: macOS 数据/日志目录路径适配 (~/Library/Logs)
• setting: 按平台隐藏 Windows 专属项并禁用 macOS 更改数据目录
• macos: 模式切换状态提示气泡移植
• macos: 候选悬停 Tooltip 移植 (编码/拼音/拆字字根)
• macos: 候选框统一菜单完整移植 (方案/简繁/全角/标点/主题/设置/关于)
• macos: 候选复制实装 (pbcopy) + 候选框空白处右键主菜单
• macos: 候选框右键菜单 (置顶/移动/删除/恢复默认/复制) + 按候选状态禁用
• macos: updater 按平台选发布资源 + 设置 app 构建脚本
• macos: 候选框主题应用 + 暗色模式适配
• macos: 设置界面 (wind_setting) macOS 移植 + 指示器设置入口
• macos: 修饰键单击切换模式 (Shift/Ctrl tap)
• macos: 菜单栏输入模式指示器 (NSStatusItem)
• macos: 候选框字体回退链 + 彩色 emoji 渲染 + 修 LSBackgroundOnly
• macos: 候选框鼠标悬停高亮 + 翻页按钮点击
• macos: WindInputDemo 升级为自包含 IME 测试台
• macos: 候选框 HiDPI 渲染 (Retina 2x)
• macos: 候选框鼠标点击选词
• macos: 架构适配 — darwin forwarder 接入真 ui.Renderer
• macos: 菜单栏图标 + 部署脚本完善
• macos: IMKit .app 候选框接入 + SHM reader + Demo
• macos: 架构适配 — darwin POSIX SHM host render + 输入闭环
• macos: composition/commit/caret 代码层实装 + 测试
• macos: register 进程常驻 + Tahoe Notarization 限制记录
• macos: IMKit .app 完整化 — bundleID + CLI 子命令 + 部署/签名工具链
• macos: IMKit .app 骨架 (swift build 出 WindInput.app)
• macos: wind_macos SwiftPM 骨架 + 构建/冒烟脚本
• ui: 新增 Manager.Events() 反向事件通道
• uicmd: 新增平台无关的 UI 命令/事件数据模型

Bug 修复

• macos: forwarder_darwin 适配主题 schema v3
• theme: P8 切片6 圆角渲染修复 — 菜单边框透明 + status/tooltip/toast 深色毛边
• viewbox: 竖排候选项补回圆角，与横排一致
• macos: build.sh 打包 v2.5 主题共享零件 _layouts/_palettes
• ui: 状态泡含全半角符号时中文不再回退宋体
• theme: 候选项上下 padding 独立生效，不再被均摊
• theme: preedit 上下 padding + index 左右 padding 完全生效
• theme: 候选行高由 item 上下 padding 决定，移除 max(32,base*1.8) 派生魔法
• win: 候选框光标定位增加坐标越界保护
• theme: 候选窗背景完整遵循 window.padding 四边(修对称化逻辑错误)
• macos: 修复 darwin cmd/service 编译错误（Manager 接口/主题 API 滞后）
• ui: 修复 pager_display_mode 启动后/macOS 不生效
• menu: 恢复统一菜单中误删的重载配置/重启服务项
• theme: 模式徽标套用 mode_label 的 margin/padding，消除与输入编码重叠
• ui: 其它窗口 View-builder 补 windows build tag 修复 darwin 编译
• macos: 服务重启后 .app 自动重连, 不再卡死需手动重启前端
• macos: build.sh 非 universal 分支锁 CGO_ENABLED=0
• macos: IME 输入连接自愈, 修复装后/重启首次激活只能英文
• macos: 候选框遵循 inline_preedit 并清理失焦残留编码
• macos: 候选框 push 订阅断线自动重连
• macos: 候选框限制在屏幕可见区内
• macos: 无本平台安装包时不报更新
• macos: darwin writeKeyResult nil 应透传而非 Consumed
• ui: 截图功能适配 ui 平台拆分

重构

• toolbar: L1 几何单一真相源，删按钮坐标线性公式
• theme: 清理 v2.5/v2.6 残留，统一 v3 命名 + 归档历史文档
• setting: 全局保存改为按 key 增量提交并并入 stats
• theme: P5 统一 ResolvedV25 — 退役 adapter/ResolvedTheme
• macos: 脚本迁移到 scripts_mac/ 并重构 dev_mac 菜单
• ui: 渲染层跨平台解耦 + 新增 darwin 系统字体目录
• ui: Manager 命令通道迁移到 uicmd.Command

其他变更

• 更新开发/贡献文档并补充 macOS 说明
• theme: P8 收尾 — 标记其它窗口几何 View 化完成（toolbar 延后）
• setting: 增量保存设计与计划
• test(setting): 引入 vitest 前端测试基础设施
• test(ci): 主题/几何测试在环境前提缺失时 skip 而非 fail
• ui: 补充统一菜单双端(Win/darwin)处理注意事项
• @ feat(theme): 内置主题显式声明 pager 行为 + msime 窗口圆角微调
• ui: 清理 rebase 产生的 AGENTS.md 跨平台文件重复行
• theme: v2.6 候选窗 schema 冻结声明 + 评估报告 + 契约
• test(proc): 修复 Windows 上 go vet 报 ErrUnsupportedPlatform 未定义
• test(bridge): 修复 darwin UDS 测试 socket 路径超长导致的失败
• test(config): 修正 datadir/schema_overrides 测试的平台假设
• README 与发布说明增加 macOS 基础说明
• macos: GitHub Actions universal .pkg 构建与发布
• macos: 更新 AGENTS.md (pkg 安装器/图标/--from/中文名)
• build(macos): 修复输入法不显示并加固用户域安装与部署/构建脚本
• macos: 代码整洁度清理
• 整理跨平台 AGENTS.md (合并架构与 macOS 说明去重)
• gitignore: 屏蔽 wind_macos/ SwiftPM 构建产物 (.build/.swiftpm/Package.resolved)
• 补 macOS IMKit 工程开发计划 + 协议速查, 为后续 macOS 开发做完整 ramp-up
• 文档化 macOS 移植设计与构建指南, 更新模块 AGENTS.md
• 清理代码注释中的跨平台移植里程碑编号 (PR-1~7/PR-A)
• build: 打通 darwin 全包编译
• build(bridge): 按平台隔离 bridge, 新增 darwin Unix Domain Socket server
• test(ui): 补齐命令通道/事件/快照关键路径单测
• build(ui): 按平台隔离 ui 包, 新增 darwin Manager 实现

---

安装

系统要求

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

Windows 安装

安装包（推荐）

1. 下载下方 WindInput-x.x.x-Setup.exe 安装包
2. 双击运行安装程序，按提示完成安装
3. 安装完成后，按 Win + Space 或 Ctrl + Shift 切换到清风输入法即可使用

便携版

1. 下载下方 WindInput-x.x.x-Portable.zip
2. 解压到任意目录（如 D:\Software\WindInput）
3. 运行 wind_portable.exe 启动输入法

便携版数据保存在程序所在目录，适合 U 盘携带或多环境使用。

提示：由于当前版本没有数字签名，安装时 Windows 安全中心（SmartScreen）可能会弹出拦截提示。点击「更多信息」→「仍要运行」即可继续安装。

macOS 安装（alpha）

1. 下载下方 WindInput-x.x.x-macOS.pkg（universal，含输入法、后台服务、设置程序三件套）
2. 双击运行安装，按提示完成
3. 到「系统设置 → 键盘 → 文本输入 → 输入法」添加并切换到「清风输入法」（也可用 ⌃Space 切换）

卸载：双击 ~/Applications/卸载清风输入法.app。

提示：macOS 版未做苹果公证，首次安装/启用可能需要在「系统设置 → 隐私与安全性」中点「仍要打开」放行；macOS 26 (Tahoe) 对未公证输入法限制更强。重新安装前建议先注销或重启，以清除系统输入法注册缓存。

注意事项

• 本项目目前处于 alpha 阶段，主要面向感兴趣的爱好者和早期测试用户
• 功能和配置文件格式可能在后续版本中发生变化
• 升级后如遇异常，请尝试删除配置目录 %APPDATA%\WindInput\ 以恢复默认配置

反馈与交流

使用中遇到问题或有功能建议，欢迎通过以下方式联系：

• GitHub Issues：提交问题或建议
• QQ 交流群：1085293418

清风输入法 v0.10.11-alpha

✏️ 更新说明

✨ 新增

• 新增输入法 UI 窗口截图功能，便于主题开发对比

🔧 优化

• 优化拼音 nüe/lüe 支持 nue/lue 形式输入
• 优化窗口带透明时的字体渲染不合理

🐛 修正

• 修正简入繁出开关保存后被重置
• 修正拼音 wdat 缓存可能不是最新的问题

变更记录

新功能

• setting: 新增输入法界面截图快捷键配置，支持设为全局
• ui: 新增 UI 窗口截图功能，便于主题开发对比

Bug 修复

• setting: 修复简入繁出开关保存后被重置
• pinyin: nüe/lüe 支持 nue/lue 形式输入
• ui: 文字渲染统一为合法预乘 alpha，修正半透明背景上文字偏亮发虚
• schema: 预生成拼音 wdat 前先验证主词库文件存在

---

安装

系统要求

• Windows 10 / 11（64 位）

安装方式

安装包（推荐）

1. 下载下方 WindInput-x.x.x-Setup.exe 安装包
2. 双击运行安装程序，按提示完成安装
3. 安装完成后，按 Win + Space 或 Ctrl + Shift 切换到清风输入法即可使用

便携版

1. 下载下方 WindInput-x.x.x-Portable.zip
2. 解压到任意目录（如 D:\Software\WindInput）
3. 运行 wind_portable.exe 启动输入法

便携版数据保存在程序所在目录，适合 U 盘携带或多环境使用。

提示：由于当前版本没有数字签名，安装时 Windows 安全中心（SmartScreen）可能会弹出拦截提示。点击「更多信息」→「仍要运行」即可继续安装。

注意事项

• 本项目目前处于 alpha 阶段，主要面向感兴趣的爱好者和早期测试用户
• 功能和配置文件格式可能在后续版本中发生变化
• 升级后如遇异常，请尝试删除配置目录 %APPDATA%\WindInput\ 以恢复默认配置

反馈与交流

使用中遇到问题或有功能建议，欢迎通过以下方式联系：

• GitHub Issues：提交问题或建议
• QQ 交流群：1085293418