这是什么

脚本技能包是一份给 AI 助手使用的「写脚本说明书」：它把 WeMod 脚本引擎的真实模型 （节点、动作、条件、变量表达式、执行语义）整理成一份自包含手册，并附带可导入的样例与一个离线校验器。 把技能包交给支持读取文件的 AI 助手（例如 Codex），你描述需求，它就能产出可直接导入 WeMod 运行的脚本。

关键点：技能包运行时零源码依赖——写脚本所需的字段名、枚举值与语义都内嵌在手册里， 不需要 WeMod 源码就能写脚本、跑校验、交付成品。

技能包已以 MIT 协议开源（对外版本去掉了涉及具体平台的样例）： github.com/vaesiqi/wemod-script-author

包含什么

| 内容 | 说明 | |---|---| | SKILL.md | 主技能文档：交付流程、完整动作与节点模型、变量表达式、自查清单（自包含） | | examples/ | 可直接导入的完整样例脚本（视觉条件、循环重试、条件分支、子流程复用等） | | tools/validate-script.mjs | 离线校验器（Node 运行，不依赖 Android 或源码） |

最短使用路径

1. 读手册：先看 SKILL.md 的「定位与边界」「动作表」「变量」「自查清单」几节； 2. 看样例：对照 examples/ 里的完整脚本，理解真实结构； 3. 写脚本：让 AI 按需求产出脚本 JSON（也可以自己写）； 4. 离线预检：

校验器会检查 JSON 语法、必填字段、枚举值、引用完整性、控制台变量类型，以及触控路径节点的坐标双写。 零错误再交付。 5. 导入手机：把文件后缀改成 .axs，用文件管理器打开（或在 App 内导入）。

> ⚠️ 完整导入必须走 .axs 文件：编辑器里的「粘贴 JSON」只插入节点， > 不带控制台变量、设置与虚拟控件等顶层配置。

          
               node tools/validate-script.mjs 你的脚本.axs
          
        

校验器会拦住的常见坑

| 坑 | 说明 | |---|---| | 控制台变量默认值写成数字 | 模型要求字符串，.axs 严格导入会直接报「格式不正确」 | | 循环次数省略或 ≤ 0 | repeat 节点的 times 必须大于 0（无限循环要用配置项，不是节点次数） | | 枚举拼写错误 | 作用域、比较运算符、失败策略、命中规则等都是固定枚举值 | | 跳转 / 事件引用的目标不存在 | 引用的标签、节点 id、子流程名必须真实存在，否则执行期才报错 | | 多颜色 / 多模板 | 用列表 + 匹配模式（任意 / 全部 / 满足 N 条），并给出所需匹配数 | | OCR 是行级匹配 | 关键词必须与目标内容在同一识别行内才命中；跨行取值请取整段文本再自行解析 | | 单指 / 多指手势坐标 | 每个路径节点都要同时给像素值与百分比值，只写像素换分辨率会偏 |

能力边界（先对照再动手）

需要更高权限的动作用 Shizuku（或 root）。

• 脚本在手机端运行，能力上限 = 动作模型 + 变量表达式 + 运行时代码；不存在的接口写出来也跑不动。
• 节点查找类动作依赖无障碍服务；视觉类动作依赖屏幕录制；
• 涉及支付、账号安全、隐私内容或不可逆操作时请谨慎，脚本不适合替代用户做高风险决策。
• WeMod 是脚本自动化工具，不提供破解、绕过安全检测或外挂功能，技能包同样不覆盖此类用法。