组合动作的调试方法与常见排错

组合动作一步出错、步步不出所料——调试能力决定你写动作的上限。本页汇总官方文档里散落的调试手段。

调试运行

编辑器里可以直接调试运行动作：逐步观察每个步骤的执行情况与变量取值，哪一步行为不符预期一目了然。写完先调试再实装，是最省时间的习惯（见动作编辑器）。

从触发入口进入调试

想调试"从轮盘 / 手势触发"的组合动作，不必先弹面板：轮盘触发时，鼠标停在目标位置上按住右 Shift 再松开，即以调试模式运行该组合动作（普通调试菜单见轮盘菜单的使用一节）。

土办法但好用：弹窗打印

在可疑位置插一个"弹窗提示"模块，把变量内容弹出来看：

• 变量是空 → 上游步骤没取到东西（路径写错？目标窗口没焦点？）；
• 变量有值但结果不对 → 插值拼接、类型转换出了问题；
• 分支走向不符预期 → 在每个分支口各插一个弹窗，看走了哪条。

定位完成后删掉调试弹窗即可。

常见翻车点清单

• 时机：目标窗口还没就绪就模拟按键——加"等待窗口 / 等待时间"模块；
• 焦点：获取选中文本要求目标窗口在前台，弹面板不抢焦点但中间切了窗口就断了；
• 权限：目标软件以管理员运行时，普通权限动作发不过去消息（提权运行的原理见下载安装）；
• 剪贴板冲突：依赖剪贴板的流程会被下载工具、词典软件干扰（官方 FAQ 点名的经典坑，见内存占用与性能说明同一篇 FAQ 的卡顿一节）；
• 编码与格式：文本处理的空格、全半角差异，正则表达式贪婪匹配。

反馈渠道

调试不出、怀疑是软件问题时：右键动作 → 反馈运行情况（直接报给动作作者，见点赞反馈）；软件本体问题走官方 GitHub Issues；查看本地运行日志的方法见官方"查看 LOG 日志"文档。