小丑鼠

JokyMouse 开发者文档

小丑鼠 Latest

jokymouse.log API

jokymouse.log 用来把脚本运行中的调试输出写进小丑鼠的运行日志面板。开发者既可以显式调用日志函数,也可以直接使用 print(...)

local log = require("jokymouse.log")

函数

函数签名说明
debuglog.debug(text)写入调试日志
infolog.info(text)写入普通日志
warnlog.warn(text)写入警告日志
errorlog.error(text)写入错误日志

与 print 的关系

  • print(...) 会自动进入运行日志,并按 info 级别记录。
  • JokyMouse 会把最近一次运行日志保留在脚本详情里,方便回看。

推荐写法

普通流程日志:

local log = require("jokymouse.log")

log.info("开始检查领奖按钮")
print("当前账号", account_name)

调试复杂对象时:

local log = require("jokymouse.log")

log.debug("screen size", width, height)
log.debug("ocr hit", hit)

明确的错误与警告:

local log = require("jokymouse.log")

if not hit then
  log.warn("未找到登录按钮")
end

if not token then
  log.error("登录 token 为空")
  jm.exit("登录流程失败,请检查账号状态")
end

说明

  • 日志面板主要用于脚本开发和排查,不适合拿来做大体量数据存储。
  • 如果只是向最终用户提示结果,请优先使用 jokymouse.dialog API
  • 如果日志里包含账号、密码、验证码等敏感信息,请在脚本里自行避免直接打印。