清风输入法 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