jokymouse.log API
jokymouse.log 用来把脚本运行中的调试输出写进小丑鼠的运行日志面板。开发者既可以显式调用日志函数,也可以直接使用 print(...)。
local log = require("jokymouse.log") 函数
| 函数 | 签名 | 说明 |
|---|---|---|
| debug | log.debug(text) | 写入调试日志 |
| info | log.info(text) | 写入普通日志 |
| warn | log.warn(text) | 写入警告日志 |
| error | log.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。
- 如果日志里包含账号、密码、验证码等敏感信息,请在脚本里自行避免直接打印。