Kando菜单系统新增指针位置变量功能解析

在桌面自动化工具Kando的最新更新中，开发团队为Run Command菜单类型引入了一项颇具实用性的功能改进——指针位置变量支持。这项改进使得用户在编写交互脚本时能够获取菜单激活时的鼠标坐标位置，为自动化操作提供了更精确的控制能力。

功能背景与应用场景

传统桌面自动化脚本经常面临一个典型问题：当通过菜单触发脚本时，鼠标位置可能已经发生变化，导致基于坐标的操作无法准确定位目标元素。Kando此次更新完美解决了这一痛点，使得以下场景成为可能：

1. 基于坐标的UI元素交互（如自动点击特定位置）
2. 区域截图或OCR识别
3. 窗口相对位置计算
4. 多显示器环境下的精确定位

技术实现细节

Kando通过引入四组模板变量实现了这一功能：

• {{pointer_x}}：菜单激活时鼠标的X坐标
• {{pointer_y}}：菜单激活时鼠标的Y坐标
• {{app_name}}：当前聚焦的应用程序名称
• {{window_name}}：当前聚焦的窗口标题

这些变量可以直接嵌入到命令字符串中，系统会在执行前自动替换为实际值。例如用户可配置如下命令：

/path/to/click_tool --x {{pointer_x}} --y {{pointer_y}} --window "{{window_name}}"

设计考量与优势

相比最初提议的"返回鼠标位置"方案，最终实现的模板变量方式具有明显优势：

1. 灵活性：允许开发者自由决定如何使用坐标值
2. 可组合性：可与其他变量（如窗口名称）组合使用
3. 非侵入性：不会改变实际的鼠标位置
4. 跨平台兼容：适用于各种桌面环境

典型使用示例

假设我们需要开发一个自动测试工具，在特定位置点击后验证UI响应：

#!/bin/bash
# 获取Kando传入的参数
X_POS=$1
Y_POS=$2
TARGET_WINDOW=$3

# 移动鼠标到原始位置
xdotool mousemove $X_POS $Y_POS
# 执行点击操作
xdotool click 1
# 验证UI变化
# ...

然后在Kando中配置命令为：

/path/to/test_script.sh {{pointer_x}} {{pointer_y}} "{{window_name}}"

技术前瞻

这项改进为Kando开辟了更多可能性：

1. 可扩展更多上下文变量（如屏幕分辨率、活动显示器等）
2. 支持相对坐标计算（基于窗口位置）
3. 实现坐标记录与回放功能
4. 增强游戏自动化能力

对于需要精确定位的自动化任务，这项功能将显著提升Kando的实用性和可靠性，使开发者能够构建更复杂、更精确的桌面自动化解决方案。