快速开始

推荐先把脚本写成本地可运行版本，再考虑发布审核。这样可以把问题切分成两类：脚本逻辑本身是否成立，以及脚本作为商品进入平台后是否具备完整元信息。

最小脚本

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

dialog.notify("开始执行", { type = "info" })

local width, height = screen.size()
jm.move_to(math.floor(width / 2), math.floor(height / 2))
jm.mouse_click("left")
jm.exit("任务已完成")

这份示例已经覆盖了三件最常见的事：加载模块、执行一个最小动作、用正常完成的方式退出脚本。

推荐开发顺序

1. 先让主逻辑在本地稳定跑通。
2. 再补充标题、key、描述、版本和 settings。
3. 最后再考虑发布审核、试用策略和价格设计。

目录与模块习惯

• 主入口使用 require("jokymouse")。
• 系统时间与窗口能力来自 require("jokymouse.system")。
• 提示框能力单独来自 require("jokymouse.dialog")。
• 识字能力单独来自 require("jokymouse.ocr")。
• 屏幕尺寸、取色、找图能力单独来自 require("jokymouse.screen")。
• 如果脚本需要长期运行，循环内部应周期性调用可中断的 API，例如 jm.sleep(...) 或 jm.ensure_running()。

调试建议

• 先把脚本做成能独立跑完的一次性流程，再改成长时间轮询版本。
• 不要一开始就把所有业务分支写进脚本，先把主路径做短、做清楚。
• 遇到需要用户确认的节点，优先用 dialog 模块提示，不要自己模拟复杂弹窗。

继续阅读 运行时模型，可以更清楚地理解哪些 API 会阻塞、哪些 API 可被中断，以及 fork 出来的任务如何回收。