ms-vite-plugin 1.4.59 → 1.4.61

package/dist/luaObfuscator/splitStrings.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.splitStrings=p;const u=require("./visit");function a(e){let r={type:"StringLiteral",value:e[0]};for(let n=1;n<e.length;n+=1)r={type:"BinaryExpr",op:"..",left:r,right:{type:"StringLiteral",value:e[n]}};return{type:"ParenExpr",exp:r}}function o(e,r){if(e.length<4)return[e];const n=r%2+2,t=Math.max(1,Math.ceil(e.length/n)),l=[];for(let i=0;i<e.length;i+=t)l.push(e.slice(i,i+t));return l}function p(e,r){let n=0;(0,u.mapChunk)(e,t=>{if(t.type!=="StringLiteral"||t.encoded||t.value.length<4)return t;n+=1;const l=o(t.value,r+n);return l.length<2?t:a(l)})}

package/dist/luaObfuscator/strings.d.ts

@@ -0,0 +1,4 @@
+import type { Chunk } from "./ast";
+import { createFoldMixParams, foldDecrypt, foldEncrypt, type FoldMixParams } from "./cipher";
+export declare function encryptStrings(chunk: Chunk, seed: number): void;
+export { createFoldMixParams, foldDecrypt, foldEncrypt, type FoldMixParams, };

package/dist/luaObfuscator/strings.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.foldEncrypt=exports.foldDecrypt=exports.createFoldMixParams=void 0,exports.encryptStrings=y;const a=require("./cipher");Object.defineProperty(exports,"createFoldMixParams",{enumerable:!0,get:function(){return a.createFoldMixParams}}),Object.defineProperty(exports,"foldDecrypt",{enumerable:!0,get:function(){return a.foldDecrypt}}),Object.defineProperty(exports,"foldEncrypt",{enumerable:!0,get:function(){return a.foldEncrypt}});const u=require("./parser"),i=require("./visit"),o="__d";function d(t,l){let e=2166136261^l;for(let r=0;r<t.length;r+=1)e=Math.imul(e^t.charCodeAt(r),16777619);return e>>>0||1}function p(t,l,e){const r=(0,a.foldEncrypt)(t,l,e);return{type:"CallExpr",callee:{type:"NameExpr",name:o},args:[{type:"StringLiteral",value:r,encoded:!0},{type:"NumberLiteral",raw:String(e),value:e}]}}function y(t,l){const e=(0,a.createFoldMixParams)(l);let r=0;(0,i.mapChunk)(t,n=>n.type!=="StringLiteral"||n.encoded||n.value.length===0?n:(r+=1,p(n.value,e,d(n.value,r))));const c=(0,u.parseLua)((0,a.emitFoldDecoderLua)(e,o));t.body.unshift(...c.body)}

package/dist/luaObfuscator/visit.d.ts

@@ -0,0 +1,5 @@
+import type { Chunk, Expression, FuncExpr, Statement } from "./ast";
+export declare function mapExp(exp: Expression, fn: (e: Expression) => Expression): Expression;
+export declare function mapFunc(fnExpr: FuncExpr, fn: (e: Expression) => Expression): void;
+export declare function mapStats(stats: Statement[], fn: (e: Expression) => Expression): void;
+export declare function mapChunk(chunk: Chunk, fn: (e: Expression) => Expression): void;

package/dist/luaObfuscator/visit.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.mapExp=s,exports.mapFunc=b,exports.mapStats=o,exports.mapChunk=p;function s(r,e){switch(r.type){case"UnaryExpr":r.arg=s(r.arg,e);break;case"BinaryExpr":r.left=s(r.left,e),r.right=s(r.right,e);break;case"FuncExpr":b(r,e);break;case"TableExpr":for(const a of r.fields)a.kind==="index"&&(a.key=s(a.key,e)),a.value=s(a.value,e);break;case"IndexExpr":r.object=s(r.object,e),r.index=s(r.index,e);break;case"MemberExpr":r.object=s(r.object,e);break;case"CallExpr":r.callee=s(r.callee,e),r.args=r.args.map(a=>s(a,e));break;case"MethodCallExpr":r.object=s(r.object,e),r.args=r.args.map(a=>s(a,e));break;case"ParenExpr":r.exp=s(r.exp,e);break;default:break}return e(r)}function b(r,e){o(r.body.body,e)}function o(r,e){for(const a of r)switch(a.type){case"DoStat":o(a.body.body,e);break;case"WhileStat":a.cond=s(a.cond,e),o(a.body.body,e);break;case"RepeatStat":o(a.body.body,e),a.cond=s(a.cond,e);break;case"IfStat":for(const c of a.clauses)c.cond=s(c.cond,e),o(c.body.body,e);a.elseBody&&o(a.elseBody.body,e);break;case"ForNumStat":a.start=s(a.start,e),a.end=s(a.end,e),a.step&&(a.step=s(a.step,e)),o(a.body.body,e);break;case"ForInStat":a.exps=a.exps.map(c=>s(c,e)),o(a.body.body,e);break;case"FuncStat":b(a.func,e);break;case"LocalFuncStat":b(a.func,e);break;case"LocalStat":a.exps&&(a.exps=a.exps.map(c=>s(c,e)));break;case"AssignStat":a.vars=a.vars.map(c=>s(c,e)),a.exps=a.exps.map(c=>s(c,e));break;case"CallStat":a.exp=s(a.exp,e);break;case"ReturnStat":a.exps=a.exps.map(c=>s(c,e));break;default:break}}function p(r,e){o(r.body,e)}

package/dist/luaObfuscator/vmEmit.d.ts

@@ -0,0 +1,2 @@
+import type { Proto } from "./compiler";
+export declare function emitVm(root: Proto): string;

package/dist/luaObfuscator/vmEmit.js

@@ -0,0 +1,281 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.emitVm=j;const p=require("./cipher"),d=require("./minify"),s=require("./opcodes");function h(e){let n=2166136261^e.code.length;return n=Math.imul(n,16777619)^e.consts.length,n>>>0}function b(e,n,l){if(e.t==="nil")return"nil";if(e.t==="bool")return e.v?"true":"false";if(e.t==="num")return e.raw;const a=(0,p.foldEncrypt)(e.v,n,l);return`D(${(0,d.escapeLuaString)(a)},${l})`}function u(e,n,l,a){const i=e.code.map((t,o)=>{const r=e.ops[o];return`{${n[r]},${t[1]},${t[2]},${t[3]}}`}).join(","),c=e.consts.map((t,o)=>b(t,l,a+o*131>>>0||1)).join(","),R=e.protos.map((t,o)=>u(t,n,l,a+(o+1)*4099>>>0)).join(","),f=e.upvals.map(t=>`{${t.inStack?1:0},${t.index}}`).join(",");return`{p={${i}},k={${c}},t={${R}},u={${f}},n=${e.numparams},v=${e.isVararg?"true":"false"}}`}function j(e){const n=h(e)||1,l=(0,s.shuffleOpcodes)(n),a=(0,p.createFoldMixParams)(n),i=s.OPCODE_NAMES.join(","),c=s.OPCODE_NAMES.map(f=>String(l[f])).join(","),R=u(e,l,a,n);return`(function()
+${(0,p.emitFoldDecoderLua)(a,"D")}
+local ${i}=${c}
+local function G(u)
+  if u.R then
+    return u.R[u.i]
+  end
+  return u.v
+end
+local function S(u,x)
+  if u.R then
+    u.R[u.i]=x
+  else
+    u.v=x
+  end
+end
+local function C(u)
+  if u.R then
+    u.v=u.R[u.i]
+    u.R=nil
+    u.i=nil
+  end
+end
+local function V(P,U,A)
+  local R={}
+  local K=P.k
+  local code=P.p
+  local top=0
+  local pc=1
+  local open={}
+  for i=1,P.n do
+    R[i]=A[i]
+  end
+  local VA={}
+  if P.v then
+    for i=P.n+1,A.n do
+      VA[#VA+1]=A[i]
+    end
+  end
+  local function rk(x)
+    if x<0 then
+      return K[-x]
+    end
+    return R[x]
+  end
+  while true do
+    local i=code[pc]
+    if not i then
+      return
+    end
+    local op=i[1]
+    local a=i[2]
+    local b=i[3]
+    local c=i[4]
+    pc=pc+1
+    if op==MOVE then
+      R[a]=R[b]
+    elseif op==LOADK then
+      R[a]=K[b]
+    elseif op==LOADBOOL then
+      R[a]=b~=0
+    elseif op==LOADNIL then
+      R[a]=nil
+    elseif op==GETGLOBAL then
+      R[a]=_ENV[K[b]]
+    elseif op==SETGLOBAL then
+      _ENV[K[b]]=R[a]
+    elseif op==GETTABLE then
+      R[a]=R[b][rk(c)]
+    elseif op==SETTABLE then
+      R[a][rk(b)]=rk(c)
+    elseif op==NEWTABLE then
+      R[a]={}
+    elseif op==SELF then
+      R[a+1]=R[b]
+      R[a]=R[b][rk(c)]
+    elseif op==ADD then
+      R[a]=R[b]+R[c]
+    elseif op==SUB then
+      R[a]=R[b]-R[c]
+    elseif op==MUL then
+      R[a]=R[b]*R[c]
+    elseif op==DIV then
+      R[a]=R[b]/R[c]
+    elseif op==IDIV then
+      R[a]=R[b]//R[c]
+    elseif op==MOD then
+      R[a]=R[b]%R[c]
+    elseif op==POW then
+      R[a]=R[b]^R[c]
+    elseif op==BAND then
+      R[a]=R[b]&R[c]
+    elseif op==BOR then
+      R[a]=R[b]|R[c]
+    elseif op==BXOR then
+      R[a]=R[b]~R[c]
+    elseif op==SHL then
+      R[a]=R[b]<<R[c]
+    elseif op==SHR then
+      R[a]=R[b]>>R[c]
+    elseif op==UNM then
+      R[a]=-R[b]
+    elseif op==BNOT then
+      R[a]=~R[b]
+    elseif op==NOT then
+      R[a]=not R[b]
+    elseif op==LEN then
+      R[a]=#R[b]
+    elseif op==CONCAT then
+      R[a]=R[b]..R[c]
+    elseif op==JMP then
+      pc=pc+b
+    elseif op==EQ then
+      local eq=R[a]==R[b]
+      local want=c==0
+      if eq==want then
+        pc=pc+1
+      end
+    elseif op==LT then
+      local lt=R[a]<R[b]
+      local want=c==0
+      if lt==want then
+        pc=pc+1
+      end
+    elseif op==LE then
+      local le=R[a]<=R[b]
+      local want=c==0
+      if le==want then
+        pc=pc+1
+      end
+    elseif op==TEST then
+      -- C=0\uFF1A\u771F\u5219\u8DF3\u8FC7 JMP\uFF1BC=1\uFF1A\u5047\u5219\u8DF3\u8FC7\uFF08or\uFF09\u3002\u4E0D\u7528 and/or\uFF0C\u65B9\u4FBF\u518D\u7F16\u8BD1\u3002
+      local take=false
+      if c==0 then
+        if R[a] then
+          take=true
+        end
+      else
+        if not R[a] then
+          take=true
+        end
+      end
+      if take then
+        pc=pc+1
+      end
+    elseif op==CALL then
+      local n=b
+      local args={}
+      local an=n
+      if n<0 then
+        an=0
+        local last=top
+        if last<a then
+          last=a
+        end
+        for j=a+1,last do
+          an=an+1
+          args[an]=R[j]
+        end
+      else
+        for j=1,n do
+          args[j]=R[a+j]
+        end
+      end
+      local rets=table.pack(R[a](table.unpack(args,1,an)))
+      if c==0 then
+      elseif c<0 then
+        for j=1,rets.n do
+          R[a+j-1]=rets[j]
+        end
+        top=a+rets.n-1
+      else
+        for j=1,c do
+          R[a+j-1]=rets[j]
+        end
+        top=a+c-1
+      end
+    elseif op==RETURN then
+      for _,u in pairs(open) do
+        C(u)
+      end
+      if b==0 then
+        return
+      end
+      if b<0 then
+        return table.unpack(R,a,top)
+      end
+      return table.unpack(R,a,a+b-1)
+    elseif op==FORPREP then
+      R[a]=R[a]-R[a+2]
+      pc=pc+b
+    elseif op==FORLOOP then
+      R[a]=R[a]+R[a+2]
+      local idx=R[a]
+      local lim=R[a+1]
+      local step=R[a+2]
+      local cont=false
+      if step>=0 then
+        if idx<=lim then
+          cont=true
+        end
+      else
+        if idx>=lim then
+          cont=true
+        end
+      end
+      if cont then
+        R[a+3]=idx
+        pc=pc+b
+      end
+    elseif op==TFORCALL then
+      local rets=table.pack(R[a](R[a+1],R[a+2]))
+      for j=1,b do
+        R[a+2+j]=rets[j]
+      end
+    elseif op==TFORLOOP then
+      if R[a+3]~=nil then
+        R[a+2]=R[a+3]
+      else
+        pc=pc+b
+      end
+    elseif op==CLOSURE then
+      local Q=P.t[b]
+      local nu={}
+      for j=1,#Q.u do
+        local sp=Q.u[j]
+        if sp[1]==1 then
+          local rg=sp[2]
+          if not open[rg] then
+            open[rg]={R=R,i=rg}
+          end
+          nu[j]=open[rg]
+        else
+          nu[j]=U[sp[2]]
+        end
+      end
+      R[a]=function(...)
+        return V(Q,nu,table.pack(...))
+      end
+    elseif op==VARARG then
+      if b<0 then
+        for j=1,#VA do
+          R[a+j-1]=VA[j]
+        end
+        top=a+#VA-1
+      else
+        for j=1,b do
+          R[a+j-1]=VA[j]
+        end
+      end
+    elseif op==SETLIST then
+      for j=1,c do
+        R[a][j]=R[b+j-1]
+      end
+    elseif op==GETUPVAL then
+      R[a]=G(U[b])
+    elseif op==SETUPVAL then
+      S(U[b],R[a])
+    elseif op==CLOSE then
+      if open[a] then
+        C(open[a])
+        open[a]=nil
+      end
+      local v=R[a]
+      if type(v)=="table" then
+        local mt=getmetatable(v)
+        local cl=v.close
+        if not cl then
+          if mt then
+            cl=mt.__close
+          end
+        end
+        if cl then
+          pcall(cl,v)
+        end
+      end
+    end
+  end
+end
+V(${R},{},table.pack())
+end)()`}

package/dist/luaObfuscator/wrapInFunction.d.ts

@@ -0,0 +1,2 @@
+import type { Chunk } from "./ast";
+export declare function wrapInFunction(chunk: Chunk): void;

package/dist/luaObfuscator/wrapInFunction.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.wrapInFunction=t;function t(e){const r=e.body;e.body=[{type:"CallStat",exp:{type:"CallExpr",callee:{type:"ParenExpr",exp:{type:"FuncExpr",params:[],vararg:!0,body:{type:"Block",body:r}}},args:[{type:"VarargExpr"}]}}]}

package/docs/AGENTS.md

@@ -13,7 +13,7 @@
 - Lua 项目使用 Lua 文档与写法。
 - 不要混用 JavaScript、Python 与 Lua API。
 - Lua 只提供英文方法，没有中文别名。
-- Lua 模块通过 `require("device")` 加载；`Sleep`、`StartThread`、`logd` / `logi` / `logw` / `loge` 等是裸全局。
+- Lua 宿主模块是内置全局表（如 `device`），不要 `require`；`Sleep`、`StartThread`、`logd` / `logi` / `logw` / `loge` 等是裸全局。
 - 不要把快点JS Python 脚本当成普通 CPython 脚本。
 - 不要对快点JS Python 脚本运行 `python -m py_compile`、`py_compile` 或类似 CPython 编译校验。
 - 不要创建、保留或同步 `__pycache__`、`.pyc` 作为项目改动。

package/docs/SKILL.md

@@ -20,7 +20,7 @@ description: 快点JS专用开发助手。用于快点JS项目开发、本地 AP
 - Lua 项目使用 Lua 文档与写法。
 - 不要混用 JavaScript、Python 与 Lua API。
 - Lua 只提供英文方法，没有中文别名。
-- Lua 模块通过 `require("device")` 加载；`Sleep`、`StartThread`、`logd` / `logi` / `logw` / `loge` 等是裸全局。
+- Lua 宿主模块是内置全局表（如 `device`），不要 `require`；`Sleep`、`StartThread`、`logd` / `logi` / `logw` / `loge` 等是裸全局。
 - Lua 用户模块请用 `require("foo")` / `require("lib.bar")`。Release 打包默认会把 `scripts` 下除 `main.lua` 外的用户 `.lua` 合并进单个 `main.lua`；不要用 `dofile` / `loadfile` 按路径加载这些文件。
 - 文档未确认的能力必须明确说明无法确认，并给出保守方案。
 - 快点JS Python 脚本不使用 CPython 编译校验；不要运行 `python -m py_compile`、`py_compile` 或类似命令。

package/docs/api/hid.md

@@ -289,6 +289,27 @@ function setJitterValue(value: number): void;
 hid.setJitterValue(5);
 ```
 
+### setActionDelay - 设置动作延迟
+
+设置连续点击/滑动之间的等待毫秒。不调用时用固件默认（相对 200ms / 绝对 100ms）。
+
+```typescript
+function setActionDelay(milliseconds: number): boolean;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `milliseconds` | number | 是 | `-1` | `0` 关闭，`>0` 覆盖毫秒，`-1` 恢复默认 |
+
+**示例:**
+
+```javascript
+hid.setActionDelay(0);
+hid.click(100, 200);
+hid.click(300, 400);
+```
+
 ## 基础触摸操作
 
 ### click - 点击操作

package/docs/apicn/hid.md

@@ -289,6 +289,27 @@ function 设置抖动值(抖动值: 数字): 无返回值;
 $HID.设置抖动值(5);
 ```
 
+### 设置动作延迟
+
+设置连续点击/滑动之间的等待毫秒。不调用时用固件默认（相对 200ms / 绝对 100ms）。
+
+```typescript
+function 设置动作延迟(毫秒: 数字): 布尔值;
+```
+
+**参数:**
+| 参数 | 类型 | 必需 | 默认值 | 描述 |
+| ---- | ---- | ---- | ------ | ---- |
+| `毫秒` | 数字 | 是 | `-1` | `0` 关闭，`>0` 覆盖毫秒，`-1` 恢复默认 |
+
+**示例:**
+
+```javascript
+$HID.设置动作延迟(0);
+$HID.点击(100, 200);
+$HID.点击(300, 400);
+```
+
 ## 基础触摸操作
 
 ### 点击

package/docs/apilua/action.md

@@ -1,5 +1,7 @@
 # 动作模块 (Action)
 
+模块表是内置全局 `action`，直接调用即可。不要 `require` 宿主模块。
+
 动作模块提供了丰富的触摸和按键操作功能，包括点击、滑动、长按滑动、返回首页、多点触摸等动作。
 
 **注意事项**
@@ -26,7 +28,6 @@ function setJitterValue(value) end
 **示例：**
 
 ```lua
-local action = require("action")
 -- 设置抖动值为5像素
 action.setJitterValue(5)
 ```
@@ -61,7 +62,6 @@ function click(x, y, duration, jitter) end
 **示例：**
 
 ```lua
-local action = require("action")
 -- 基础点击
 local success = action.click(100, 100, 20, false)
 if success then
@@ -105,7 +105,6 @@ function clickRandom(x1, y1, x2, y2, duration) end
 **示例：**
 
 ```lua
-local action = require("action")
 -- 在指定矩形区域内随机点击
 action.clickRandom(100, 100, 200, 200, 20)
 -- 在更大区域内随机点击
@@ -145,7 +144,6 @@ function doubleClick(x, y, duration, interval, jitter) end
 **示例：**
 
 ```lua
-local action = require("action")
 -- 基础双击
 local success = action.doubleClick(100, 100, 20, 20, false)
 if success then
@@ -190,7 +188,6 @@ function doubleClickRandom(x1, y1, x2, y2, duration, interval) end
 **示例：**
 
 ```lua
-local action = require("action")
 -- 在指定矩形区域内随机双击
 action.doubleClickRandom(100, 100, 200, 200, 20, 20)
 -- 慢速随机双击
@@ -232,7 +229,6 @@ function swipe(startX, startY, endX, endY, duration, jitter, steps) end
 **示例：**
 
 ```lua
-local action = require("action")
 -- 基础滑动（从左到右）
 action.swipe(100, 300, 400, 300, 500, false, 10)
 -- 向上滑动（滚动页面）
@@ -286,7 +282,6 @@ function pressAndSwipe(startX, startY, endX, endY, touch_down_duration, touch_mo
 **示例：**
 
 ```lua
-local action = require("action")
 -- 拖拽元素
 action.pressAndSwipe(
   100,
@@ -350,7 +345,6 @@ function swipeCurve(startX, startY, midX, midY, endX, endY, duration) end
 **示例：**
 
 ```lua
-local action = require("action")
 -- 基础曲线滑动
 action.swipeCurve(100, 100, 200, 150, 300, 200, 1000)
 -- 弧形向上滑动
@@ -391,7 +385,6 @@ function input(text) end
 **示例：**
 
 ```lua
-local action = require("action")
 -- 输入文本
 local success = action.input("hello 快点JS")
 if success then
@@ -418,7 +411,6 @@ function inputSimple(text) end
 **示例：**
 
 ```lua
-local action = require("action")
 local success = action.inputSimple("hello_123")
 if success then
   print("成功输入文本")
@@ -448,7 +440,6 @@ function backspace(count) end
 **示例：**
 
 ```lua
-local action = require("action")
 -- 删除最后一个字符
 local success = action.backspace()
 if success then
@@ -477,7 +468,6 @@ function enter() end
 **示例：**
 
 ```lua
-local action = require("action")
 -- 调用回车
 local success = action.enter()
 if success then
@@ -503,7 +493,6 @@ function homeScreen() end
 **示例：**
 
 ```lua
-local action = require("action")
 -- 返回主屏幕
 local success = action.homeScreen()
 if success then
@@ -541,7 +530,6 @@ function pressButton(button) end
 **示例：**
 
 ```lua
-local action = require("action")
 -- 按下 Home 键
 action.pressButton("home")
 -- 调高音量
@@ -568,7 +556,6 @@ function sendKey(key) end
 **示例：**
 
 ```lua
-local action = require("action")
 action.sendKey({ "COMMAND", "c" })
 action.sendKey({ 0xe3, 0x06 })
 action.sendKey({ HidKey.COMMAND, "v" })
@@ -585,7 +572,6 @@ function w3cActions(json) end
 **示例：**
 
 ```lua
-local action = require("action")
 action.w3cActions({
   actions = {
     {
@@ -618,7 +604,6 @@ function createBuilder() end
 **示例：**
 
 ```lua
-local action = require("action")
 -- 创建构建器
 local builder = action.createBuilder()
 ```
@@ -650,7 +635,6 @@ function addPointer(id) end
 **示例：**
 
 ```lua
-local action = require("action")
 local builder = action.createBuilder()
 -- 添加第一个手指
 local pointer1 = builder:addPointer(1)
@@ -685,7 +669,6 @@ function singleTap(x, y, duration) end
 **示例：**
 
 ```lua
-local action = require("action")
 local builder = action.createBuilder()
 -- 快速单点点击
 builder:singleTap(100, 100, 50):execute()
@@ -718,7 +701,6 @@ function multiTap(points, duration) end
 **示例：**
 
 ```lua
-local action = require("action")
 local builder = action.createBuilder()
 -- 多点同时点击
 local points = { { x = 100, y = 100 },
@@ -753,7 +735,6 @@ function execute() end
 **示例：**
 
 ```lua
-local action = require("action")
 local builder = action.createBuilder()
 -- 执行构建的动作
 local success = builder
@@ -888,7 +869,6 @@ function done() end
 ### 单指滑动
 
 ```lua
-local action = require("action")
 -- 单指从左到右滑动
 local builder = action.createBuilder()
 builder
@@ -904,7 +884,6 @@ builder
 ### 双指缩放（放大）
 
 ```lua
-local action = require("action")
 -- 双指从中心向外扩展
 local builder = action.createBuilder()
 builder
@@ -926,7 +905,6 @@ builder
 ### 双指缩放（缩小）
 
 ```lua
-local action = require("action")
 -- 双指从外向中心收缩
 local builder = action.createBuilder()
 builder
@@ -948,7 +926,6 @@ builder
 ### 双指旋转
 
 ```lua
-local action = require("action")
 -- 双指围绕中心点旋转
 local builder = action.createBuilder()
 local centerX = 200,
@@ -976,7 +953,6 @@ builder
 ### 长按拖拽
 
 ```lua
-local action = require("action")
 -- 长按后拖拽元素
 local builder = action.createBuilder()
 builder
@@ -993,7 +969,6 @@ builder
 ### 复杂手势组合
 
 ```lua
-local action = require("action")
 -- 先点击，再滑动，最后双击
 local builder = action.createBuilder()
 -- 第一步：单击

package/docs/apilua/appleocr.md

@@ -1,5 +1,7 @@
 # AppleOCR 模块
 
+模块表是内置全局 `appleocr`，直接调用即可。不要 `require` 宿主模块。
+
 AppleOCR 模块基于 Apple Vision 框架，提供原生的光学字符识别（OCR）功能。该模块利用 iOS 系统内置的机器学习能力，无需额外模型文件，具有高效、准确的特点。
 
 <span style="color: red;">此模块仅支持 iOS 系统。</span>
@@ -95,8 +97,6 @@ function recognizeAbs(input, x, y, ex, ey, languages) end
 **示例:**
 
 ```lua
-local appleocr = require("appleocr")
-local action = require("action")
 local absResults = appleocr.recognizeAbs("screen", 100, 100, 500, 300)
 if #absResults > 0 then
   action.click(absResults[1].centerX, absResults[1].centerY)
@@ -141,8 +141,6 @@ function recognizeNumbersAbs(input, x, y, ex, ey) end
 **示例:**
 
 ```lua
-local appleocr = require("appleocr")
-local action = require("action")
 local absNumberResults = appleocr.recognizeNumbersAbs("screen", 100, 100, 500, 300)
 if #absNumberResults > 0 then
   action.click(absNumberResults[1].centerX, absNumberResults[1].centerY)
@@ -191,8 +189,6 @@ function findTextAbs(input, texts, x, y, ex, ey, languages, exactMatch) end
 **示例:**
 
 ```lua
-local appleocr = require("appleocr")
-local action = require("action")
 local absHits = appleocr.findTextAbs("screen", { "开始" }, 100, 100, 500, 400)
 if #absHits > 0 then
   action.click(absHits[1].centerX, absHits[1].centerY)

package/docs/apilua/cloud.md

@@ -1,5 +1,7 @@
 # 云控模块 (Cloud)
 
+模块表是内置全局 `cloud`，直接调用即可。不要 `require` 宿主模块。
+
 云控模块用于在主脚本中使用内置云控 WebSocket 连接。脚本可以主动连接云控服务器、判断连接状态、断开连接、上报事件数据，并监听服务器事件数据。
 
 ## 注意事项
@@ -64,7 +66,6 @@ function connect(url, deviceNo) end
 **示例**
 
 ```lua
-local cloud = require("cloud")
 local accepted = cloud.connect("wss = //example.com/control", "device-001")
 print("云控连接请求:", accepted)
 ```
@@ -85,7 +86,6 @@ function isConnected() end
 **示例**
 
 ```lua
-local cloud = require("cloud")
 if cloud.isConnected() then
   cloud.report("status", { value = "ready" })
 end
@@ -102,7 +102,6 @@ function disconnect() end
 **示例**
 
 ```lua
-local cloud = require("cloud")
 cloud.disconnect()
 ```
 
@@ -131,7 +130,6 @@ function report(event, data) end
 **示例**
 
 ```lua
-local cloud = require("cloud")
 local ok = cloud.report("taskFinished", {
   taskId = "A-1001",
   success = true,
@@ -147,7 +145,6 @@ print("上报结果:", ok)
 `data` 的 key 必须使用云控端已经配置好的设备总览自定义字段名。上报了云控端未配置的多余字段时，协议仍可发送，但云控端设备总览不会显示这些字段。
 
 ```lua
-local cloud = require("cloud")
 cloud.report("cloud = status", {
   taskName = "巡检任务",
   progress = 80,
@@ -174,7 +171,6 @@ function onEvent(callback) end
 **示例**
 
 ```lua
-local cloud = require("cloud")
 cloud.onEvent(function(event, data)
   if event == "startTask" then
     print("任务参数:", data)