Lichess盲棋模式下行列扫描顺序异常问题分析

在Lichess国际象棋平台中，盲棋模式是为视障玩家设计的重要辅助功能。近期发现该模式下使用扫描命令(s命令)时，行列扫描顺序存在随机性问题，影响了视障玩家对棋盘状态的认知效率。

问题现象

当玩家在盲棋模式下使用扫描命令时，例如输入"s e"扫描e列，理想情况下系统应该按照固定顺序(从a到h或从1到8)依次播报棋子信息。然而实际运行中，系统会以随机顺序播报该列或行的棋子，导致玩家难以在脑海中构建准确的棋盘布局。

技术背景

Lichess的盲棋模式实现依赖于Web Accessibility API(ARIA)和语音合成技术。扫描命令的核心逻辑是通过遍历棋盘数据结构，提取指定行列的棋子信息，然后通过语音接口输出。在底层实现上，这涉及到棋盘数据结构的遍历顺序和语音队列的管理。

问题根源

通过分析源代码发现，问题出在扫描命令处理函数中。原始实现直接遍历了棋盘的数据结构，但没有对遍历结果进行排序处理。由于现代JavaScript引擎中对象属性的遍历顺序不保证稳定，导致每次扫描时棋子信息的获取顺序可能不同。

解决方案

修复方案主要包含以下关键点：

1. 在遍历棋盘数据结构后，显式对结果按照行列坐标进行排序
2. 对于列扫描，确保按照数字顺序(1-8)播报
3. 对于行扫描，确保按照字母顺序(a-h)播报
4. 保持空方格的跳过逻辑不变

核心修复代码在棋盘扫描模块中添加了排序逻辑，确保输出顺序的一致性。例如对于列扫描，会先将获取到的棋子信息按照Y坐标升序排列后再送入语音队列。

影响评估

该问题对视障玩家的游戏体验影响较大。在修复前，玩家需要花费额外精力记忆和整理随机顺序的棋子信息，增加了认知负荷。修复后，玩家可以按照标准棋盘坐标顺序接收信息，显著提高了构建心理棋盘模型的效率。

技术启示

这个案例提醒我们，在实现辅助功能时，不仅要考虑功能的可用性，还需要关注使用体验的优化。特别是对视障用户而言，信息的呈现顺序和一致性往往比视觉用户更加重要。在涉及数据遍历的场景下，开发者不应依赖语言或运行时的隐式顺序，而应该显式控制输出顺序。