输入法 IME 差分提交

中文输入是移植应用的硬门槛：桌面应用的文本输入逻辑与移动输入法的组合输入模型差异很大。这篇讲输入法差分提交的原理与实现要点。

▍问题的本质
桌面应用期望：按键即字符，编辑框内容实时完整。移动输入法实际：用户输入经过组合过程（拼音串、候选词、上屏），期间内容是中间态，确认后才最终提交。两边的模型不同，必须有一层桥把输入法的差分行为翻译成应用能理解的事件流：组合期文本（预编辑串）、候选确认、最终提交、删除回退。

▍桥的职责
一，组合期：把预编辑串作为带格式的临时内容呈现（下划线标记），不进应用文档模型——直接进模型会导致确认后替换逻辑错乱。二，提交期：最终文本以提交事件进应用，按应用的光标位置插入。三，同步期：应用的光标移动、选区变化要回传输入法（输入法需要知道光标位置来定位候选框）。四，取消期：用户放弃输入，预编辑内容要整体撤下。

▍框架层的接入点
各框架有现成的输入法抽象：Qt 的输入法事件与属性接口、GTK 的预编辑信号、WebView 的组合事件。移植时把系统输入法回调桥到框架对应接口，而不是自己造组合逻辑。真实工程的教训一族：外壳层把组合事件丢弃导致文本进不了文档模型；输入框收起后再点不弹（焦点状态没同步）；工具栏误触发键盘（焦点策略不当）。

▍验收要点
四种场景必须过：拼音整句输入、中途删除、光标中插、切换输入法。再加一个压力场景：大文本粘贴（会触发输入法框架的风暴路径，有真实案例因此性能崩塌）。都要在真机输入法（不止一种第三方输入法）上测。

▍建议
输入法桥独立成模块并自带调试日志开关（组合、提交、光标三类事件全记录），出现疑难杂症时打开开关看事件流，问题多半一眼可见。

更多真实移植案例，欢迎到 apps 板块翻看 56 篇《鸿蒙PC适配全记录》系列实录。