小丑鼠

JokyMouse 开发者文档

小丑鼠 Latest

jokymouse.dialog API

jokymouse.dialog 模块通过 require("jokymouse.dialog") 加载,负责在运行关键节点向用户显示统一的提示框和确认框。

local dialog = require("jokymouse.dialog")

可用函数

函数签名说明
notifydialog.notify(text, opts?)显示提示消息框
confirmdialog.confirm(text, opts?)显示确认框,返回 true / false

notify

dialog.notify("脚本执行完成", {
  title = "小丑鼠",
  type = "info"
})

type 支持:

  • info
  • warn
  • error

confirm

local ok = dialog.confirm("确定继续吗?", {
  title = "确认操作"
})

用户确认时返回 true,取消时返回 false

适合使用的场景

  • 在脚本真正开始前提醒用户做好窗口准备。
  • 在检测到高风险操作前让用户手动确认。

不适合使用的场景

  • 高频循环里的进度播报。
  • 想把 dialog 当成任意自定义窗口系统来使用。
  • 需要文本输入、复杂表单、富文本、图片或多步骤引导。

示例

local jm = require("jokymouse")
local dialog = require("jokymouse.dialog")

dialog.notify("请先把目标窗口切到前台", {
  type = "warn"
})

local ok = dialog.confirm("接下来会开始自动点击,是否继续?")
if not ok then
  jm.exit("用户取消执行")
end

如果脚本还需要读取 settings 或控制输入,请回到 jokymouse API