清风输入法 v0.129.0

更新说明

⚠️ 破坏性变更！此版本重构了候选注释的设置项，旧的配置将会失效，不会自动迁移，请自行备份候选注释的配置项。

⚠️ 此版本修改了 TSF 端与按键转发表，升级后部分按键相关功能需要重启系统才会生效。

✨ 新功能

• 候选注释功能重构：新增「注释分配」、「注释模板」和「注释切换」，按模式、方案、类型逐层配置，支持快速切换默认/详细模式（设置 → 外观 → 候选注释，详见文档）
• 增加设置界面自定义精简：设置页里用不到的功能，支持自行隐藏（1.设置中底栏右键菜单 → 界面细节中进行开启）
• 随包内置中→英、英→中释义注释词库，可直接用在候选注释里（设置 → 外观 → 候选注释）
• 通配符与剪贴板反查可并查未启用的扩展词库，命中项注释前带 * 标记（默认关，设置 → 输入 →「通配与反查含扩展词库」）
• 增加拼音音节分隔符设置，可换成空格或留空，只改显示（设置 → 外观 → 候选排版）
• 拼音增加整句语法模型总开关（设置 → 方案设置 → 拼音）
• 增加命令短语前缀匹配开关与最少键入位数（设置 → 输入 → 命令短语）
• 全局自定义按键的组合键增加 Backspace、Delete、Insert、Esc、Home、End、PageUp、PageDown 与方向键，如 Shift+Backspace 撤销上屏（设置 → 按键）
• 按键自定义新增 caret_left / caret_right（可配 macOS 式光标编辑）与 toggle_tip（键盘开关悬停提示），空闲态可绑定 F1–F12，翻页键支持按键级策略覆盖（设置 → 按键）
• 状态提示增加默认位置设置（光标下方 / 光标上方，设置 → 外观）
• 直通命令新增 ime.reload()，重载用户配置

⚡ 优化改进

• 方案页新增「双拼」卡，可直接选择双拼布局
• 「快捷短语」改称「命令短语」，与「快捷输入」区分
• 设置里指定的候选字重，现在覆盖主题中的全部字重
• 拼音、混输方案级按键的字母键可作引导键（用于拼音中的 u/v 模式）
• 混输下符号通配键放在首位时也作通配
• 展开态候选窗宽度随当前内容收放

🐛 问题修复

• 修正切换中英后快捷加词会话残留，英文状态下吞掉 Ctrl+- 等宿主快捷键的问题
• 修正 GNOME Wayland 下候选窗光标位置折算错误的问题

📌 其他说明

• 候选注释的旧配置键不再自动迁移，自定义过注释模板的用户升级后需到「设置 → 外观 → 候选注释」重新配置
• 快捷输入出厂不再显示注释
• 感谢所有在论坛和 GitHub 上反馈问题、提出建议的用户

下载

版本	适用场景
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

---

变更记录（121 个提交，v0.128.0 → v0.129.0）

新功能

• compat: 拼音音节分隔符支持按应用覆盖 (a4fd15f)
• settings: 定制隐藏新增 feature:shuangpin_layout (11da932)
• reverse: 命令栏剪贴板反查补查未启用扩展词库，码前加 * (834f0c7)
• codetable: 行内通配并查未启用扩展词库，命中注释加 * 标明 (92231be)
• ui: ui.candidate.syllable_separator 拼音音节分隔符可换可留空，只改显示 (e393b78)
• phrase: input.phrase.prefix_match 开关取代 min_prefix=0，空码补全兜底不受其管 (cf22f97)
• keys: caret_right 末尾动作可选（上屏 / 高亮下移 / 开关悬停提示） (9a7318a)
• phrase: input.phrase.min_prefix = 0 关闭短语前缀列举 (31aa3e4)
• keys: toggle_tip 绑在 → 上时光标未到末尾仍右移光标 (89c5fce)
• cmdbar: 新增 ime.reload() 重载用户配置 (169f533)
• keys: 拼音 / 混输方案级 key_actions 的字母键不再让位，空缓冲即引导 (37cf063)
• keys: key_actions 支持空闲态裸 F1–F12 (ff2ac8e)
• status: 状态提示泡加默认位置（光标下方 / 上方），跟随光标时自动避让候选窗 (7740f59)
• comment: 功能键切换键支持按住 (65fb131)
• comment: 拆字只给码表用户——全局详细态改「拼音 · 英文」，混输详细态显式拆字 · 拼音 (474532e)
• comment: 切换键可选「无」与 F1–F12，切换方式去掉 off；快捷输入出厂不显示注释 (0df685f)
• comment: 取消注释旧键迁移；切换键出厂改 F1 (1fc3cc0)
• comment: 全部内置模板写上说明 (b92bff1)
• comment: 编码模板带说明，名字改成说出显示什么 (bc2421f)
• comment: 编码来源三开关并入注释分配，内置模板改名并补码表编码、双拼编码 (64e8395)
• macos: 组字中如实上报 Ctrl 按下与松开 (31a9658)
• linux: 组字中如实上报 Ctrl 按下与松开 (de4913f)
• tsf: 候选显示时如实上报 Ctrl 按下与松开；WM_HOTKEY 作废待判单击 (363dee2)
• comment: 候选显示时 Ctrl 如实上报由服务端判单击，Ctrl 切换键支持按住 (10a18d8)
• comment: 模板预览样例扩成中英各三个，previewTemplate 加 sample 入参与 samples 列表 (a038ce4)
• config: 迁移出的注释模板用可读名，旧串等于内置文本时复用内置 id (408c9d3)
• comment: 改为横排为主，竖排没写时同本行横排；出厂分配与迁移改写横排格 (cc3c5db)
• comment: Windows 上 Alt 切换注释改由全局键盘钩子判定，松开前补屏蔽键压住菜单栏 (d970bc8)
• comment: 服务端按切换键判定，Ctrl 单击切换注释、Alt 按左右过滤 (cb30c5f)
• comment: alt_switch 拆为 switch_key / switch_mode，hold 仅配 Alt (96eba91)
• comment-dicts: 丢弃 AI 释义里拼音化的专名；新增 lint-ai 与 zh-en --pinyin (68e3d6a)
• comment-dicts: ai_fill 加 --extra-rule，追加提示词规则并纳入批次目录哈希 (6950e49)
• comment-dicts: refine 改喂未裁剪义项（export-full），词性集提示词与解析一致，批次目录绑定输入哈希 (28ae4a2)
• comment-dicts: 释义脚本按新选词口径改造——plan 子命令、词性义项重整、离线批次后端 (e2d8299)
• webdata: comment.library 供设置端注释总表 (7fc7ae1)
• comment: 随包内置 en_zh / zh_en 注释词库挂载 (41fe35b)
• comment: 注释两态的按键动词与 ime.toggle/set("comment") (339bab4)
• platform: 组字中转发 Alt 供注释切换 (7ad2847)
• comment: 组字中单击/按住 Alt 切换注释详细态 (1a554d3)
• comment: 默认/详细两态，临时翻转随候选窗关闭复位 (73e265a)
• config: 旧注释模板键自动迁入 [ui.comment]，方案文件注释配置作废 (93d35d9)
• config: 注释模板按模式→方案→类型→全局逐层解析 (74da277)
• config: 新增 [ui.comment] 与出厂 system.comments.toml (9b59ed3)
• coordinator: 首单元读法支持双拼——显示拼音、查询用击键 (65268e5)
• coordinator: 手机端拼音「首单元读法」取代光标式中间修正；光标机制改为默认关的开关 (7e8f6ef)
• keys: 会话动作 toggle_tip，键盘开关高亮候选的悬停提示 (52ca36d)
• keys: 会话态按键表收 F1–F12，Shift+Backspace 绑命令加用例钉住 (63ffa34)
• coordinator: 手机端拼音中间修正——光标限定查询、按音节左移、音节视图与备选拼写 (8d1fa37)
• input: 移动端英文方案组码中，数字进编码缓冲而不是选候选 (438661c)
• assoc: 移动端联想态退格、回车、二三候选键默认放行，清组合后真正透传 (6ef23ca)
• input: 手动分隔符 auto 在两个键都被占时夺取 ', 双拼与五笔整句可断词 (6d8d90e)
• pinyin: 整句语法模型加总开关 enabled，桌面出厂备好 weight/model (c6c0660)
• keys: 会话动作新增 caret_left / caret_right，方向键可选 macOS 式编辑（GH#234） (f66964f)
• keys: 翻页键「翻不动」策略支持按键级覆盖（page_key_overrides） (583f408)

问题修复

• compat: 应用级分隔符选项顺序与文案对齐全局：单引号/空格/间隔号/不显示 (3f475f1)
• linux: 失焦时补报按住中的 Ctrl 松开，并复位单击与 Alt 记账 (4823150)
• tsf: 线程失焦时补报吃掉的功能键松开并清记账 (09e76d6)
• 审查补丁——组字时会话 F 键优先、悬停提示不带 * 码、分隔符光标按 UTF-16、影子层小表加锁序与上限 (271aeca)
• ui: 鼠标点选 / CapsLock 钩子 / 悬停提示推出的组合区也换音节分隔符 (da9251c)
• keys: 裸 F1–F12 绑的动作英文模式归宿主，切换中英的动词除外 (fa8efd5)
• theme: 用户字重直接覆盖主题所有节点（含状态）的字重，不再兜底保留加粗 (5483695)
• theme: 用户字重压过主题基态的加粗，选中等更粗的状态才保留强调 (7b05eb0)
• wildcard: 混输下符号通配键首位也作通配，字母键仍按拼音 (94a6678)
• keys: toggle_tip / caret_right 移光标后同步宿主组合区插入符 (2e250d4)
• addword: 切中英时结束快捷加词会话，英文态不再吞 Ctrl+- 等宿主快捷键 (e597c0f)
• build: 发版数据门禁加中英释义注释词库 (448fc46)
• comment: 快捷输入通配格 mode.mix，自建快捷输入也有编码；旧客户端写退役键可覆盖分配 (8c76e51)
• comment: 变基后跟上 main 的正确拼音提示——变量说明改新口径，提示用例改走注释分配 (8e6845c)
• macos: Ctrl 按设备位分左右，同侧再按下丢掉残留，如实上报帧带 CapsLock 位 (a1fc9e0)
• tsf: 丢了松开的 Ctrl 残留不再吞掉下一次按下，失焦清记账；WM_HOTKEY 入口即作废待判单击 (57d4b6f)
• comment: 如实上报的 Ctrl 按下一律重新起算；设计稿与计划注明按住已不限 Alt (047ff5a)
• comment: 预览样例你好的小鹤双拼改为 nihc；sample 非字符串报错；切换键相关注释与设计稿示例跟上新键 (977f730)
• comment: 迁移命名给内置 quick_mix 用「旧版·快捷输入」，文档注释归位 (afa9bc4)
• comment: Alt 钩子只在前台属于活动客户端进程时认领，注明已知边角 (4e4289c)
• comment: 内置释义库只能按 id 取，裸 ${dict} / ${dict_all} 不查 (bcdc6fb)
• comment-dicts: 批次目录哈希含模式与方向、PROMPT 按真实方向生成；提示词加词汇/短语碎片/专名口径 (a4fa894)
• comment: system.comments.toml 缺失或损坏时用内置副本，用户模板不得占用 none/inherit (d600062)
• build: dev.ps1 找 Python 的返回值被展开成字符串，释义生成出错只警告 (a6bc71e)
• comment: cmdbar 可开关未登记的内置注释库，同 id 手工项不再与内置项重复 (d0c7173)
• platform: 联想窗里也转发 Alt，TSF 缓存回包不串键、不重发 (fc234ad)
• comment: Alt 事件带粘滞修饰位即不算单击，失焦与不适用时清掉残留判定态 (6117390)
• comment: 顶码、顶屏进模式、联想窗里起新组合时注释翻转同样复位 (fed6203)
• config: 迁出自定义全局注释模板时，出厂中间层同名格写 inherit (0eb298a)
• ui: 展开态候选窗宽度跟随当前可见内容，不再只增不减 (a809df7)
• input: 手动分隔符 auto 不再在桌面夺取 ', 只在移动端夺取 (e2b3e38)
• linux: GNOME Wayland 下按 RelRect/前端折光标到 X11 (#241) (a99a7ad)
• pinyin: 老配置只写 weight+model 时不被出厂 enabled=false 盖住 (a308358)
• misread: 误读表解析先规整行尾，补上行尾守卫的函数级豁免 (97a5fdc)

重构

• tsf: 删去组字中 Alt 转发，Alt 改由服务端钩子判定；屏蔽键 0x9F 一律放行 (4d8e8ad)
• comment: 协调器改由 CommentLibrary 解析注释模板 (a4f02b5)

其他变更

• skill: 发版说明致谢改通用感谢语，新功能自身的收口修复不列 (35ec61e)
• 清掉 clippy 告警 (fa11ce4)
• linux: deb 门禁加中英释义注释词库体积检查 (07d5b61)
• 登记混输符号通配键首位作通配 (06da2d3)
• 「快捷短语」改称「命令短语」（注释与设计稿） (5bfa0f9)
• design: 空闲态 F 键与字母引导键按拍板口径更新 (180e138)
• comment: 中英释义的原始释义冻结进仓，构建不再下载 ECDICT / CC-CEDICT (0680794)
• design: 空闲态功能键与字母引导键规划 (3f4a687)
• comment: 原位跳转按钮改名「去设置」 (d0e150b)
• comment: 编码来源三处原位保留下拉，写注释分配 (24602a5)
• comment: 编码来源三开关并入注释分配，内置模板重命名并补码表编码、双拼编码 (2b5679e)
• comment: 设置端二次修订——分配改为全局加覆盖列表，模板串多行、标识可改、插入变量弹层 (89ab537)
• design: 修订计划追加 Ctrl 按住与候选显示时如实上报 (89200a4)
• comment: 设计稿 §3/§9 与迁移用例注释改为横排为主的说法 (5536997)
• hotkey: 注释切换键登记处如实写明 SESSION 位对修饰键不起闸门作用 (c3ad20c)
• design: 修订计划追加预览样例扩组 (4127815)
• design: 候选注释真机反馈修订——切换键可选 Ctrl/Alt、横排为主、设置端拆成独立对话框 (c64bbfb)
• design: 释义词库定为随包内置 (182027e)
• design: 释义数据生成完成，补实测条目数与体积 (97a3cb9)
• comment: 英→中与 CEDICT 释义重整为「词性. 常用义」，统一一行一个词性 (b93b3e1)
• comment-dicts: 三套构建脚本接入 refined 源数据（en_zh_refined / zh_en_cedict_refined，可无） (c473064)
• comment: AI 补齐中→英释义——通用词频≥100 与五笔独有词，碎片与无通行英文名的专名留空 (b8e8a8f)
• design: 释义取词范围与专名口径（短语碎片留空、专名不拼音化） (83e2b0f)
• design: 释义补齐口径定为通用词频≥100 加五笔前一万，AI 统一取常用义并带词性 (2677112)
• design: 注释模板设计稿按实施结果更新 (47e214f)
• data: 释义词库生成接入 Windows/mac 构建，ECDICT 固定提交 (47a2daa)
• data: 中英释义注释词库生成脚本 (b443507)
• @sgnay has signed the CLA in #268 (765292c)
• @Kovisun has signed the CLA in #260 (5053553)
• keys: 预置文件补 page_key_overrides 出厂默认与说明 (e726ccd)
• codetable: 钉住用户词两类权重与主库 default_weight 的位次关系（GH#248） (af5c9fa)

完整对比