Niri 项目中输入法候选窗口定位异常问题分析

在 Wayland 桌面环境下的 Niri 合成器项目中，用户报告了一个关于输入法候选窗口定位异常的问题。该问题表现为当使用支持 text-input 协议的输入法时，候选窗口会错误地覆盖在文本输入位置上方，而不是预期中显示在输入位置下方。

问题现象

用户在使用不同应用程序时观察到了两种异常表现：

1. 基础定位错误：在 Alacritty（基于 winit）和 Firefox（GTK）中，输入法候选窗口的左上角被错误地定位在文本插入位置，导致候选内容直接遮挡正在输入的文字。

2. 历史位置残留：在 Firefox 中还观察到另一个相关现象——当开始输入新词时，候选窗口会出现在之前输入词的位置，而不是当前光标位置。

值得注意的是，在 Neovide（同样基于 winit）中候选窗口却能正常显示在输入位置下方，这表明问题可能与不同客户端实现方式有关。

技术背景

在 Wayland 协议体系中，输入法支持通过 text-input 协议实现。该协议允许客户端（应用程序）与输入法之间交换文本输入相关的信息，包括：

• 光标位置
• 文本输入区域
• 输入法弹出窗口的定位提示

合成器负责根据这些信息正确定位输入法提供的候选窗口。理想情况下，合成器应该：

1. 接收客户端提供的文本输入位置信息
2. 考虑窗口装饰、缩放等因素进行坐标转换
3. 将输入法候选窗口定位在合适位置（通常是输入位置下方）

问题根源分析

根据技术讨论，这个问题可能源于多个层面的因素：

1. 合成器处理逻辑：Niri 可能没有正确处理客户端提供的文本输入位置信息，或者在坐标转换时存在偏差。

2. 协议实现差异：不同客户端（winit、GTK）可能以不同方式实现 text-input 协议，导致合成器接收到的位置信息不一致。

3. 输入法交互：输入法期望的定位方式与实际合成器提供的定位方式存在差异。

解决方案方向

从技术讨论中可以看出，这个问题可能需要 Smithay（Niri 使用的底层库）层面的修改才能彻底解决。可能的修复方向包括：

1. 改进 text-input 协议的位置处理逻辑
2. 增强坐标转换的准确性
3. 考虑不同客户端实现的差异，增加兼容性处理

用户影响

这个问题直接影响使用输入法进行文字输入的用户体验，特别是在中文、日文等需要频繁使用输入法候选的场景下。错误的定位会导致：

• 候选窗口遮挡正在输入的文字
• 用户无法直观看到已输入内容
• 输入效率下降

总结

Niri 合成器中输入法候选窗口定位异常是一个典型的 Wayland 协议实现问题，涉及到合成器、客户端和输入法三方的交互。虽然在某些客户端（如 Neovide）中能正常工作，但在多数情况下仍需要底层改进。这类问题的解决往往需要深入理解 Wayland 协议栈和合成器架构，是 Wayland 生态系统成熟过程中常见的挑战之一。