ms-vite-plugin 1.5.12 → 1.5.14

package/dist/build/luaBundle.js

@@ -1,4 +1,4 @@
-"use strict";var b=exports&&exports.__createBinding||(Object.create?(function(t,e,i,n){n===void 0&&(n=i);var a=Object.getOwnPropertyDescriptor(e,i);(!a||("get"in a?!e.__esModule:a.writable||a.configurable))&&(a={enumerable:!0,get:function(){return e[i]}}),Object.defineProperty(t,n,a)}):(function(t,e,i,n){n===void 0&&(n=i),t[n]=e[i]})),_=exports&&exports.__setModuleDefault||(Object.create?(function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}):function(t,e){t.default=e}),m=exports&&exports.__importStar||(function(){var t=function(e){return t=Object.getOwnPropertyNames||function(i){var n=[];for(var a in i)Object.prototype.hasOwnProperty.call(i,a)&&(n[n.length]=a);return n},t(e)};return function(e){if(e&&e.__esModule)return e;var i={};if(e!=null)for(var n=t(e),a=0;a<n.length;a++)n[a]!=="default"&&b(i,e,n[a]);return _(i,e),i}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.bundleLuaScripts=v;const c=m(require("fs-extra")),d=m(require("path")),w=new Set(["action","ai","appleocr","cloud","config","cryptoUtils","cv","device","dotocr","file","hid","hotupdate","http","image","ime","logger","media","mysql","netcard","node","paddleocr","pip","system","tomatoocr","tts","ui","utils","yolo","yolocls"]),F=new Set(["coroutine","debug","io","math","os","package","string","table","utf8"]);async function v(t){const e=d.join(t,"main.lua");await c.pathExists(e)||(console.error("\u274C \u672A\u627E\u5230 scripts/main.lua\uFF0C\u65E0\u6CD5\u5408\u5E76 Lua"),process.exit(1));const i=await j(t),n=new Map;for(const o of i){const u=p(t,o),l=h(u);if(!l)continue;if(w.has(l)||F.has(l)){const g=w.has(l)?"\u5BBF\u4E3B":"\u6807\u51C6\u5E93";console.warn(`\u26A0\uFE0F \u8DF3\u8FC7 ${u}\uFF1A\u6A21\u5757\u540D ${l} \u4E0E${g}\u5168\u5C40\u540D\u51B2\u7A81\uFF0C\u4E0D\u8981\u5360\u7528\u5BBF\u4E3B\u6216\u6807\u51C6\u5E93\u540D\u79F0`);continue}if(n.has(l))continue;let f=await c.readFile(o,"utf8");f=y(f),n.set(l,{rel:u,source:f})}const a=y(await c.readFile(e,"utf8"));if(n.size===0)return console.log("\u2139\uFE0F Lua \u4EC5\u6709 main.lua\uFF0C\u65E0\u9700\u5408\u5E76"),0;const r=[];r.push("-- KuaiJS Lua bundle: package.preload + main.lua");const s=[...n.keys()].sort((o,u)=>o.localeCompare(u));for(const o of s){const u=n.get(o);r.push(`package.preload[${O(o)}] = function(...)`),r.push(u.source.replace(/\s+$/,"")),r.push("end")}r.push(a.replace(/^\uFEFF/,"")),await c.writeFile(e,`${r.join(`
+"use strict";var g=exports&&exports.__createBinding||(Object.create?(function(t,e,i,n){n===void 0&&(n=i);var a=Object.getOwnPropertyDescriptor(e,i);(!a||("get"in a?!e.__esModule:a.writable||a.configurable))&&(a={enumerable:!0,get:function(){return e[i]}}),Object.defineProperty(t,n,a)}):(function(t,e,i,n){n===void 0&&(n=i),t[n]=e[i]})),j=exports&&exports.__setModuleDefault||(Object.create?(function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}):function(t,e){t.default=e}),m=exports&&exports.__importStar||(function(){var t=function(e){return t=Object.getOwnPropertyNames||function(i){var n=[];for(var a in i)Object.prototype.hasOwnProperty.call(i,a)&&(n[n.length]=a);return n},t(e)};return function(e){if(e&&e.__esModule)return e;var i={};if(e!=null)for(var n=t(e),a=0;a<n.length;a++)n[a]!=="default"&&g(i,e,n[a]);return j(i,e),i}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.bundleLuaScripts=v;const c=m(require("fs-extra")),d=m(require("path")),b=new Set(["action","ai","appleocr","cloud","config","cryptoUtils","cv","device","dotocr","file","hid","hotupdate","http","image","ime","jbdylib","jbshell","jbclear","jbsystem","jbdevice","jbpower","jbvpn","jbdraw","logger","media","mysql","netcard","node","paddleocr","pip","plist","sqlite","system","tomatoocr","tts","ui","utils","yolo","yolocls","zipFile"]),_=new Set(["coroutine","debug","io","math","os","package","string","table","utf8"]);async function v(t){const e=d.join(t,"main.lua");await c.pathExists(e)||(console.error("\u274C \u672A\u627E\u5230 scripts/main.lua\uFF0C\u65E0\u6CD5\u5408\u5E76 Lua"),process.exit(1));const i=await F(t),n=new Map;for(const o of i){const l=p(t,o),u=h(l);if(!u)continue;if(b.has(u)||_.has(u)){const y=b.has(u)?"\u5BBF\u4E3B":"\u6807\u51C6\u5E93";console.warn(`\u26A0\uFE0F \u8DF3\u8FC7 ${l}\uFF1A\u6A21\u5757\u540D ${u} \u4E0E${y}\u5168\u5C40\u540D\u51B2\u7A81\uFF0C\u4E0D\u8981\u5360\u7528\u5BBF\u4E3B\u6216\u6807\u51C6\u5E93\u540D\u79F0`);continue}if(n.has(u))continue;let f=await c.readFile(o,"utf8");f=w(f),n.set(u,{rel:l,source:f})}const a=w(await c.readFile(e,"utf8"));if(n.size===0)return console.log("\u2139\uFE0F Lua \u4EC5\u6709 main.lua\uFF0C\u65E0\u9700\u5408\u5E76"),0;const r=[];r.push("-- KuaiJS Lua bundle: package.preload + main.lua");const s=[...n.keys()].sort((o,l)=>o.localeCompare(l));for(const o of s){const l=n.get(o);r.push(`package.preload[${O(o)}] = function(...)`),r.push(l.source.replace(/\s+$/,"")),r.push("end")}r.push(a.replace(/^\uFEFF/,"")),await c.writeFile(e,`${r.join(`
 `)}
-`,"utf8");for(const o of i)p(t,o)!=="main.lua"&&await c.remove(o);return await $(t),console.log(`\u2705 Lua \u5DF2\u5408\u5E76\u4E3A scripts/main.lua\uFF08${n.size} \u4E2A\u6A21\u5757\uFF09`),n.size}async function j(t){const e=[],i=async n=>{const a=await c.readdir(n,{withFileTypes:!0});for(const r of a){const s=d.join(n,r.name);r.isDirectory()?await i(s):r.isFile()&&r.name.endsWith(".lua")&&e.push(s)}};return await i(t),e.sort((n,a)=>{const r=p(t,n),s=p(t,a),o=h(r)??"",u=h(s)??"";if(o===u&&o){const l=r.endsWith("/init.lua")?1:0,f=s.endsWith("/init.lua")?1:0;return l-f}return r.localeCompare(s)}),e}function h(t){const e=t.replace(/\\/g,"/");if(e!=="main.lua"){if(e.endsWith("/init.lua")){const i=e.slice(0,-9);return i?i.replace(/\//g,"."):"init"}if(e.endsWith(".lua"))return e.slice(0,-4).replace(/\//g,".")}}function p(t,e){return d.relative(t,e).split(d.sep).join("/")}function y(t){let e=t.replace(/^\uFEFF/,"");if(e.startsWith("#!")){const i=e.indexOf(`
+`,"utf8");for(const o of i)p(t,o)!=="main.lua"&&await c.remove(o);return await $(t),console.log(`\u2705 Lua \u5DF2\u5408\u5E76\u4E3A scripts/main.lua\uFF08${n.size} \u4E2A\u6A21\u5757\uFF09`),n.size}async function F(t){const e=[],i=async n=>{const a=await c.readdir(n,{withFileTypes:!0});for(const r of a){const s=d.join(n,r.name);r.isDirectory()?await i(s):r.isFile()&&r.name.endsWith(".lua")&&e.push(s)}};return await i(t),e.sort((n,a)=>{const r=p(t,n),s=p(t,a),o=h(r)??"",l=h(s)??"";if(o===l&&o){const u=r.endsWith("/init.lua")?1:0,f=s.endsWith("/init.lua")?1:0;return u-f}return r.localeCompare(s)}),e}function h(t){const e=t.replace(/\\/g,"/");if(e!=="main.lua"){if(e.endsWith("/init.lua")){const i=e.slice(0,-9);return i?i.replace(/\//g,"."):"init"}if(e.endsWith(".lua"))return e.slice(0,-4).replace(/\//g,".")}}function p(t,e){return d.relative(t,e).split(d.sep).join("/")}function w(t){let e=t.replace(/^\uFEFF/,"");if(e.startsWith("#!")){const i=e.indexOf(`
 `);e=i>=0?e.slice(i+1):""}return e}function O(t){if(!/["\\\n\r]/.test(t))return`"${t}"`;let e="";for(;t.includes(`]${e}]`);)e+="=";return`[${e}[${t}]${e}]`}async function $(t){const e=async i=>{const n=await c.readdir(i,{withFileTypes:!0});let a=!0;for(const r of n){const s=d.join(i,r.name);r.isDirectory()&&await e(s)?await c.remove(s):a=!1}return a};await e(t)}

package/dist/build/scriptProtect.js

@@ -1,4 +1,4 @@
-"use strict";var w=exports&&exports.__createBinding||(Object.create?(function(t,e,n,a){a===void 0&&(a=n);var i=Object.getOwnPropertyDescriptor(e,n);(!i||("get"in i?!e.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return e[n]}}),Object.defineProperty(t,a,i)}):(function(t,e,n,a){a===void 0&&(a=n),t[a]=e[n]})),k=exports&&exports.__setModuleDefault||(Object.create?(function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}):function(t,e){t.default=e}),C=exports&&exports.__importStar||(function(){var t=function(e){return t=Object.getOwnPropertyNames||function(n){var a=[];for(var i in n)Object.prototype.hasOwnProperty.call(n,i)&&(a[a.length]=i);return a},t(e)};return function(e){if(e&&e.__esModule)return e;var n={};if(e!=null)for(var a=t(e),i=0;i<a.length;i++)a[i]!=="default"&&w(n,e,a[i]);return k(n,e),n}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.protectScript=F,exports.createScriptProtectPlugin=Y,exports.createKjstEmbedPlugin=Q,exports.createScriptProtectHelpers=_;const E=C(require("acorn")),p=C(require("crypto")),T=require("magic-string"),D=Buffer.from([126,145,60,165]),M=1,U="x",N=Buffer.from([165,60,145,126]),L=`-----BEGIN PUBLIC KEY-----
+"use strict";var _=exports&&exports.__createBinding||(Object.create?(function(t,e,n,a){a===void 0&&(a=n);var i=Object.getOwnPropertyDescriptor(e,n);(!i||("get"in i?!e.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return e[n]}}),Object.defineProperty(t,a,i)}):(function(t,e,n,a){a===void 0&&(a=n),t[a]=e[n]})),k=exports&&exports.__setModuleDefault||(Object.create?(function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}):function(t,e){t.default=e}),I=exports&&exports.__importStar||(function(){var t=function(e){return t=Object.getOwnPropertyNames||function(n){var a=[];for(var i in n)Object.prototype.hasOwnProperty.call(n,i)&&(a[a.length]=i);return a},t(e)};return function(e){if(e&&e.__esModule)return e;var n={};if(e!=null)for(var a=t(e),i=0;i<a.length;i++)a[i]!=="default"&&_(n,e,a[i]);return k(n,e),n}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.protectScript=G,exports.createScriptProtectPlugin=Y,exports.createKjstEmbedPlugin=Q,exports.createScriptProtectHelpers=w;const P=I(require("acorn")),p=I(require("crypto")),T=require("magic-string"),D=Buffer.from([126,145,60,165]),M=1,U="x",N=Buffer.from([165,60,145,126]),L=`-----BEGIN PUBLIC KEY-----
 MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEArzeAhUUEi4p0AxLYIVJK
 UcXyySzlh8G4TfH/quDXiKVlYlho9v2R1cQKQgFpVuDW8SDyc2iWUTNa8D/NX9LN
 IqcgQP0lyTxuFvevfGOlPt6NDl0nYNqaToK5AvN/F7AcchU9JrNSB4BNEeFRechm
@@ -6,4 +6,4 @@ GL9m5iUY0HCbiOIcbo+rx1GQaqTYCUuZIJttuARYCq0ggoOHjBqMHUKWwdNtJVoe
 PrdRaKzL3CB2gXazQzKUVrlK2vEDEaTvSLJoCym7SkSf/XmxjfEADlcwrqTb01ar
 U8mm9/g5R9q43B8NqlTpGOcs1OpAY5DZW1DDjXhyHBfrPCt82hhmeO/yI0N8vE2m
 MwIDAQAB
------END PUBLIC KEY-----`,S=new Set(["action","$\u52A8\u4F5C","appleOcr","$\u82F9\u679COCR","cloud","$\u4E91\u63A7","config","$\u914D\u7F6E","cryptoUtils","cv","device","$\u8BBE\u5907","dotOcr","$\u70B9\u9635OCR","file","$\u6587\u4EF6","hid","$HID","hidKey","$HID\u6309\u952E","hotUpdate","$\u70ED\u66F4\u65B0","http","$HTTP","image","$\u56FE\u7247","ime","$\u8F93\u5165\u6CD5","logger","$\u65E5\u5FD7","media","$\u5A92\u4F53","mysql","$MySQL\u6570\u636E\u5E93","netCard","$\u5361\u5BC6","paddleOcr","$PaddleOCR","pip","$\u60AC\u6D6E\u7A97","sharedState","$\u5171\u4EAB\u72B6\u6001","system","$\u7CFB\u7EDF","thread","$\u7EBF\u7A0B","tomatoOcr","tts","$\u6587\u5B57\u8F6C\u8BED\u97F3","ui","$\u89C6\u56FE","utils","$\u5DE5\u5177","yolo","$YOLO","yoloCls","$YOLO\u5206\u7C7B"]),I=new Set(["createNodeSelector","$\u521B\u5EFA\u8282\u70B9\u9009\u62E9\u5668","exit","$\u9000\u51FA\u811A\u672C","getAgentFastMode","$\u83B7\u53D6Agent\u5FEB\u901F\u6A21\u5F0F","getAgentTouchMode","$\u83B7\u53D6Agent\u89E6\u63A7\u6A21\u5F0F","getContext","$\u83B7\u53D6\u4E0A\u4E0B\u6587","getCpuAutoThrottle","$\u83B7\u53D6CPU\u81EA\u52A8\u9650\u6D41","getCpuThrottleDelay","$\u83B7\u53D6CPU\u9650\u6D41\u5EF6\u8FDF","importClass","$\u5BFC\u5165\u7C7B","loadDex","$\u52A0\u8F7DDex","logd","$\u6253\u5370\u8C03\u8BD5\u65E5\u5FD7","loge","$\u6253\u5370\u9519\u8BEF\u65E5\u5FD7","logi","$\u6253\u5370\u4FE1\u606F\u65E5\u5FD7","logw","$\u6253\u5370\u8B66\u544A\u65E5\u5FD7","println","$\u6253\u5370","restartScript","$\u91CD\u542F\u811A\u672C","setAgentFastMode","$\u8BBE\u7F6EAgent\u5FEB\u901F\u6A21\u5F0F","setAgentTouchMode","$\u8BBE\u7F6EAgent\u89E6\u63A7\u6A21\u5F0F","setCpuAutoThrottle","$\u8BBE\u7F6ECPU\u81EA\u52A8\u9650\u6D41","setCpuThrottleDelay","$\u8BBE\u7F6ECPU\u9650\u6D41\u5EF6\u8FDF","setExceptionCallback","$\u8BBE\u7F6E\u5F02\u5E38\u505C\u6B62\u56DE\u8C03","setStopCallback","$\u8BBE\u7F6E\u505C\u6B62\u56DE\u8C03","sleep","$\u5EF6\u65F6","takeMeToFront","$APP\u5207\u5165\u524D\u53F0","time","$\u83B7\u53D6\u5F53\u524D\u65F6\u95F4\u6233"]);function b(t){for(;;){const e=`_0x${p.randomBytes(3).toString("hex")}`;if(!t.has(e))return t.add(e),e}}function g(t,e){const n=t.indexOf(e);return n>=0?n:(t.push(e),t.length-1)}function A(t,e){for(let n=e.length-1;n>=0;n-=1)if(e[n].has(t))return!0;return!1}function h(t,e){if(!(!t||typeof t!="object")){if(t.type==="Identifier"){e.add(t.name);return}if(t.type==="AssignmentPattern"){h(t.left,e);return}if(t.type==="RestElement"){h(t.argument,e);return}if(t.type==="ArrayPattern"){for(const n of t.elements||[])h(n,e);return}if(t.type==="ObjectPattern")for(const n of t.properties||[])n.type==="RestElement"?h(n.argument,e):h(n.value,e)}}function K(t){try{return E.parse(t,{allowHashBang:!0,ecmaVersion:"latest",sourceType:"script"})}catch{return E.parse(t,{allowHashBang:!0,ecmaVersion:"latest",sourceType:"module"})}}function O(t,e,n,a){if(!t||typeof t!="object"||typeof t.type!="string")return;let i=0;if(t.type==="FunctionDeclaration"||t.type==="FunctionExpression"||t.type==="ArrowFunctionExpression"){const o=new Set;t.id&&t.id.type==="Identifier"&&o.add(t.id.name);for(const u of t.params||[])h(u,o);n.push(o),i+=1}if(t.type==="CatchClause"&&t.param){const o=new Set;h(t.param,o),n.push(o),i+=1}if(t.type==="VariableDeclaration"){const o=n[n.length-1];for(const u of t.declarations||[])h(u.id,o)}a(t,e,n);for(const o of Object.keys(t)){if(o==="parent"||o==="start"||o==="end"||o==="loc"||o==="range"||o==="raw")continue;const u=t[o];if(Array.isArray(u))for(const s of u)O(s,t,n,a);else u&&typeof u=="object"&&O(u,t,n,a)}for(;i>0;)n.pop(),i-=1}function H(t,e){return!(!e||t.value!=="use strict"||e.type!=="ExpressionStatement")}function j(t){if(!(!t||t.type!=="MemberExpression")){if(t.computed)return t.property?.type==="Literal"&&typeof t.property.value=="string"?t.property.value:void 0;if(t.property?.type==="Identifier")return t.property.name}}function d(t,e){return t^e}function x(t){for(let e=t.length-1;e>0;e-=1){const n=p.randomInt(e+1),a=t[e];t[e]=t[n],t[n]=a}}function R(t){const e=[...S,...I].filter(c=>!t.includes(c));x(e);const n=Math.min(e.length,6+p.randomInt(7)),a=2+p.randomInt(4),i=[];for(let c=0;c<t.length;c+=1)i.push({intern:c,value:t[c]});for(let c=0;c<n;c+=1)i.push({intern:null,value:e[c]});for(let c=0;c<a;c+=1)i.push({intern:null,value:""});x(i);const o=i.map(c=>c.value),u=new Array(t.length).fill(-1),s=[];for(let c=0;c<i.length;c+=1){const y=i[c];y.intern!==null&&(u[y.intern]=c),y.value===""&&s.push(c)}return{values:o,slotOf:u,globalSlots:s}}function q(t){return t.length===0?0:t[p.randomInt(t.length)]}function G(t){const e=Buffer.from(JSON.stringify(t),"utf8"),n=p.randomBytes(32),a=p.randomBytes(16),i=p.createCipheriv("aes-256-cbc",n,a),o=Buffer.concat([i.update(e),i.final()]),u=p.publicEncrypt({key:L,padding:p.constants.RSA_PKCS1_PADDING},n),s=Buffer.alloc(7);D.copy(s,0),s.writeUInt8(M,4),s.writeUInt16BE(u.length,5);const c=Buffer.alloc(4);return c.writeUInt32BE(o.length,0),Buffer.concat([s,u,a,c,o])}function F(t){const e=_();return v(t,e[0],e[1],e[2])}function Y(t){const e=new Set(t),n=t[0],a=t[1],i=t[2];if(!n||!a||!i||e.size!==3)throw new Error("script protect helper names \u65E0\u6548");return{name:"kuaijs-script-protect",apply:"build",renderChunk:{order:"pre",handler(o,u){const s=v(o,n,a,i);return this.emitFile({type:"asset",fileName:u.fileName.replace(/\.js$/i,".kjst"),source:s.table}),{code:s.code,map:null}}}}}function Q(){return{name:"kuaijs-kjst-embed",apply:"build",enforce:"post",generateBundle(t,e){for(const[n,a]of Object.entries(e)){if(a.type!=="asset"||!/\.kjst$/i.test(n))continue;const i=n.replace(/\.kjst$/i,".js"),o=e[i];if(!o||o.type!=="chunk")continue;const u=a.source,s=typeof u=="string"?Buffer.from(u,"binary"):Buffer.from(u),c=Buffer.from(o.code,"utf8"),y=Buffer.alloc(4);y.writeUInt32BE(s.length,0);const B=Buffer.concat([c,s,y,N]);delete e[n],delete e[i],this.emitFile({type:"asset",fileName:i,source:B})}}}}function _(){const t=new Set;return[b(t),b(t),b(t)]}function v(t,e,n,a){const i=[""],o=[],u=K(t);let s=p.randomBytes(2).readUInt16BE(0);s===0&&(s=1),O(u,null,[new Set],(r,l,$)=>{if(r.type==="CallExpression"){const f=r.callee;if(f?.type==="Identifier"){I.has(f.name)&&!A(f.name,$)&&o.push({start:f.start,end:f.end,kind:"nGlobal",a:g(i,f.name)});return}if(f?.type==="MemberExpression"&&f.object?.type==="Identifier"){const m=f.object.name,P=j(f);P&&S.has(m)&&!A(m,$)&&o.push({start:f.start,end:f.end,kind:"nMember",a:g(i,m),b:g(i,P)})}return}if(r.type==="MemberExpression"){if(l?.type==="CallExpression"&&l.callee===r||l?.type==="AssignmentExpression"&&l.left===r||r.object?.type!=="Identifier")return;const f=r.object.name,m=j(r);m&&S.has(f)&&!A(f,$)&&o.push({start:r.start,end:r.end,kind:"p",a:g(i,f),b:g(i,m)});return}if(r.type==="Literal"&&typeof r.value=="string"){if(H(r,l)||l?.type==="Property"&&l.key===r)return;o.push({start:r.start,end:r.end,kind:"s",a:g(i,r.value)});return}r.type==="Property"&&!r.method&&!r.computed&&r.key?.type==="Identifier"&&r.key.name!=="__proto__"&&o.push({start:r.shorthand?r.start:r.key.start,end:r.shorthand?r.end:r.key.end,kind:r.shorthand?"keyShort":"key",a:g(i,r.key.name),ident:r.key.name})});const c=R(i),y=o.map(r=>{const l=c.slotOf[r.a],$=r.b===void 0?0:c.slotOf[r.b];return r.kind==="nGlobal"?{start:r.start,end:r.end,text:`${n}(${d(q(c.globalSlots),s)},${d(l,s)})`}:r.kind==="nMember"?{start:r.start,end:r.end,text:`${n}(${d(l,s)},${d($,s)})`}:r.kind==="p"?{start:r.start,end:r.end,text:`${a}(${d(l,s)},${d($,s)})`}:r.kind==="keyShort"?{start:r.start,end:r.end,text:`[${e}(${d(l,s)})]:${r.ident??""}`}:{start:r.start,end:r.end,text:r.kind==="key"?`[${e}(${d(l,s)})]`:`${e}(${d(l,s)})`}});y.sort((r,l)=>l.start-r.start);const B=new T(t);for(const r of y)r.start===r.end?B.appendLeft(r.start,r.text):B.overwrite(r.start,r.end,r.text);return{code:B.toString(),table:G({s:e,n,p:a,v:c.values,[U]:s}),reservedNames:[e,n,a]}}
+-----END PUBLIC KEY-----`,S=new Set(["action","$\u52A8\u4F5C","ai","$AI","appleOcr","$\u82F9\u679COCR","cloud","$\u4E91\u63A7","config","$\u914D\u7F6E","cryptoUtils","cv","device","$\u8BBE\u5907","dotOcr","$\u70B9\u9635OCR","file","$\u6587\u4EF6","hid","$HID","hidKey","$HID\u6309\u952E","hotUpdate","$\u70ED\u66F4\u65B0","http","$HTTP","image","$\u56FE\u7247","ime","$\u8F93\u5165\u6CD5","jbdylib","jbshell","jbclear","jbsystem","jbdevice","jbpower","jbvpn","jbdraw","logger","$\u65E5\u5FD7","media","$\u5A92\u4F53","mysql","$MySQL\u6570\u636E\u5E93","sqlite","$SQLite\u6570\u636E\u5E93","netCard","$\u5361\u5BC6","paddleOcr","$PaddleOCR","pip","$\u60AC\u6D6E\u7A97","plist","sharedState","$\u5171\u4EAB\u72B6\u6001","system","$\u7CFB\u7EDF","thread","$\u7EBF\u7A0B","tomatoOcr","tts","$\u6587\u5B57\u8F6C\u8BED\u97F3","ui","$\u89C6\u56FE","utils","$\u5DE5\u5177","yolo","$YOLO","yoloCls","$YOLO\u5206\u7C7B","zipFile","$ZIP"]),C=new Set(["createNodeSelector","$\u521B\u5EFA\u8282\u70B9\u9009\u62E9\u5668","exit","$\u9000\u51FA\u811A\u672C","getAgentFastMode","$\u83B7\u53D6Agent\u5FEB\u901F\u6A21\u5F0F","getAgentTouchMode","$\u83B7\u53D6Agent\u89E6\u63A7\u6A21\u5F0F","getContext","$\u83B7\u53D6\u4E0A\u4E0B\u6587","getCpuAutoThrottle","$\u83B7\u53D6CPU\u81EA\u52A8\u9650\u6D41","getCpuThrottleDelay","$\u83B7\u53D6CPU\u9650\u6D41\u5EF6\u8FDF","importClass","$\u5BFC\u5165\u7C7B","loadDex","$\u52A0\u8F7DDex","logd","$\u6253\u5370\u8C03\u8BD5\u65E5\u5FD7","loge","$\u6253\u5370\u9519\u8BEF\u65E5\u5FD7","logi","$\u6253\u5370\u4FE1\u606F\u65E5\u5FD7","logw","$\u6253\u5370\u8B66\u544A\u65E5\u5FD7","println","$\u6253\u5370","restartScript","$\u91CD\u542F\u811A\u672C","setAgentFastMode","$\u8BBE\u7F6EAgent\u5FEB\u901F\u6A21\u5F0F","setAgentTouchMode","$\u8BBE\u7F6EAgent\u89E6\u63A7\u6A21\u5F0F","setCpuAutoThrottle","$\u8BBE\u7F6ECPU\u81EA\u52A8\u9650\u6D41","setCpuThrottleDelay","$\u8BBE\u7F6ECPU\u9650\u6D41\u5EF6\u8FDF","setExceptionCallback","$\u8BBE\u7F6E\u5F02\u5E38\u505C\u6B62\u56DE\u8C03","setStopCallback","$\u8BBE\u7F6E\u505C\u6B62\u56DE\u8C03","sleep","$\u5EF6\u65F6","takeMeToFront","$APP\u5207\u5165\u524D\u53F0","time","$\u83B7\u53D6\u5F53\u524D\u65F6\u95F4\u6233"]);function B(t){for(;;){const e=`_0x${p.randomBytes(3).toString("hex")}`;if(!t.has(e))return t.add(e),e}}function g(t,e){const n=t.indexOf(e);return n>=0?n:(t.push(e),t.length-1)}function j(t,e){for(let n=e.length-1;n>=0;n-=1)if(e[n].has(t))return!0;return!1}function h(t,e){if(!(!t||typeof t!="object")){if(t.type==="Identifier"){e.add(t.name);return}if(t.type==="AssignmentPattern"){h(t.left,e);return}if(t.type==="RestElement"){h(t.argument,e);return}if(t.type==="ArrayPattern"){for(const n of t.elements||[])h(n,e);return}if(t.type==="ObjectPattern")for(const n of t.properties||[])n.type==="RestElement"?h(n.argument,e):h(n.value,e)}}function K(t){try{return P.parse(t,{allowHashBang:!0,ecmaVersion:"latest",sourceType:"script"})}catch{return P.parse(t,{allowHashBang:!0,ecmaVersion:"latest",sourceType:"module"})}}function A(t,e,n,a){if(!t||typeof t!="object"||typeof t.type!="string")return;let i=0;if(t.type==="FunctionDeclaration"||t.type==="FunctionExpression"||t.type==="ArrowFunctionExpression"){const o=new Set;t.id&&t.id.type==="Identifier"&&o.add(t.id.name);for(const l of t.params||[])h(l,o);n.push(o),i+=1}if(t.type==="CatchClause"&&t.param){const o=new Set;h(t.param,o),n.push(o),i+=1}if(t.type==="VariableDeclaration"){const o=n[n.length-1];for(const l of t.declarations||[])h(l.id,o)}a(t,e,n);for(const o of Object.keys(t)){if(o==="parent"||o==="start"||o==="end"||o==="loc"||o==="range"||o==="raw")continue;const l=t[o];if(Array.isArray(l))for(const c of l)A(c,t,n,a);else l&&typeof l=="object"&&A(l,t,n,a)}for(;i>0;)n.pop(),i-=1}function q(t,e){return!(!e||t.value!=="use strict"||e.type!=="ExpressionStatement")}function E(t){if(!(!t||t.type!=="MemberExpression")){if(t.computed)return t.property?.type==="Literal"&&typeof t.property.value=="string"?t.property.value:void 0;if(t.property?.type==="Identifier")return t.property.name}}function d(t,e){return t^e}function v(t){for(let e=t.length-1;e>0;e-=1){const n=p.randomInt(e+1),a=t[e];t[e]=t[n],t[n]=a}}function H(t){const e=[...S,...C].filter(s=>!t.includes(s));v(e);const n=Math.min(e.length,6+p.randomInt(7)),a=2+p.randomInt(4),i=[];for(let s=0;s<t.length;s+=1)i.push({intern:s,value:t[s]});for(let s=0;s<n;s+=1)i.push({intern:null,value:e[s]});for(let s=0;s<a;s+=1)i.push({intern:null,value:""});v(i);const o=i.map(s=>s.value),l=new Array(t.length).fill(-1),c=[];for(let s=0;s<i.length;s+=1){const y=i[s];y.intern!==null&&(l[y.intern]=s),y.value===""&&c.push(s)}return{values:o,slotOf:l,globalSlots:c}}function R(t){return t.length===0?0:t[p.randomInt(t.length)]}function F(t){const e=Buffer.from(JSON.stringify(t),"utf8"),n=p.randomBytes(32),a=p.randomBytes(16),i=p.createCipheriv("aes-256-cbc",n,a),o=Buffer.concat([i.update(e),i.final()]),l=p.publicEncrypt({key:L,padding:p.constants.RSA_PKCS1_PADDING},n),c=Buffer.alloc(7);D.copy(c,0),c.writeUInt8(M,4),c.writeUInt16BE(l.length,5);const s=Buffer.alloc(4);return s.writeUInt32BE(o.length,0),Buffer.concat([c,l,a,s,o])}function G(t){const e=w();return x(t,e[0],e[1],e[2])}function Y(t){const e=new Set(t),n=t[0],a=t[1],i=t[2];if(!n||!a||!i||e.size!==3)throw new Error("script protect helper names \u65E0\u6548");return{name:"kuaijs-script-protect",apply:"build",renderChunk:{order:"pre",handler(o,l){const c=x(o,n,a,i);return this.emitFile({type:"asset",fileName:l.fileName.replace(/\.js$/i,".kjst"),source:c.table}),{code:c.code,map:null}}}}}function Q(){return{name:"kuaijs-kjst-embed",apply:"build",enforce:"post",generateBundle(t,e){for(const[n,a]of Object.entries(e)){if(a.type!=="asset"||!/\.kjst$/i.test(n))continue;const i=n.replace(/\.kjst$/i,".js"),o=e[i];if(!o||o.type!=="chunk")continue;const l=a.source,c=typeof l=="string"?Buffer.from(l,"binary"):Buffer.from(l),s=Buffer.from(o.code,"utf8"),y=Buffer.alloc(4);y.writeUInt32BE(c.length,0);const m=Buffer.concat([s,c,y,N]);delete e[n],delete e[i],this.emitFile({type:"asset",fileName:i,source:m})}}}}function w(){const t=new Set;return[B(t),B(t),B(t)]}function x(t,e,n,a){const i=[""],o=[],l=K(t);let c=p.randomBytes(2).readUInt16BE(0);c===0&&(c=1),A(l,null,[new Set],(r,u,$)=>{if(r.type==="CallExpression"){const f=r.callee;if(f?.type==="Identifier"){C.has(f.name)&&!j(f.name,$)&&o.push({start:f.start,end:f.end,kind:"nGlobal",a:g(i,f.name)});return}if(f?.type==="MemberExpression"&&f.object?.type==="Identifier"){const b=f.object.name,O=E(f);O&&S.has(b)&&!j(b,$)&&o.push({start:f.start,end:f.end,kind:"nMember",a:g(i,b),b:g(i,O)})}return}if(r.type==="MemberExpression"){if(u?.type==="CallExpression"&&u.callee===r||u?.type==="AssignmentExpression"&&u.left===r||r.object?.type!=="Identifier")return;const f=r.object.name,b=E(r);b&&S.has(f)&&!j(f,$)&&o.push({start:r.start,end:r.end,kind:"p",a:g(i,f),b:g(i,b)});return}if(r.type==="Literal"&&typeof r.value=="string"){if(q(r,u)||u?.type==="Property"&&u.key===r)return;o.push({start:r.start,end:r.end,kind:"s",a:g(i,r.value)});return}r.type==="Property"&&!r.method&&!r.computed&&r.key?.type==="Identifier"&&r.key.name!=="__proto__"&&o.push({start:r.shorthand?r.start:r.key.start,end:r.shorthand?r.end:r.key.end,kind:r.shorthand?"keyShort":"key",a:g(i,r.key.name),ident:r.key.name})});const s=H(i),y=o.map(r=>{const u=s.slotOf[r.a],$=r.b===void 0?0:s.slotOf[r.b];return r.kind==="nGlobal"?{start:r.start,end:r.end,text:`${n}(${d(R(s.globalSlots),c)},${d(u,c)})`}:r.kind==="nMember"?{start:r.start,end:r.end,text:`${n}(${d(u,c)},${d($,c)})`}:r.kind==="p"?{start:r.start,end:r.end,text:`${a}(${d(u,c)},${d($,c)})`}:r.kind==="keyShort"?{start:r.start,end:r.end,text:`[${e}(${d(u,c)})]:${r.ident??""}`}:{start:r.start,end:r.end,text:r.kind==="key"?`[${e}(${d(u,c)})]`:`${e}(${d(u,c)})`}});y.sort((r,u)=>u.start-r.start);const m=new T(t);for(const r of y)r.start===r.end?m.appendLeft(r.start,r.text):m.overwrite(r.start,r.end,r.text);return{code:m.toString(),table:F({s:e,n,p:a,v:s.values,[U]:c}),reservedNames:[e,n,a]}}

package/docs/api/ai.md

@@ -12,7 +12,7 @@ AI 模块让脚本直接在手机上调用大模型：看图回答问题、做
 
 模型配置（地址、Key、模型名）直接写在脚本里，脚本开头 `ai.setProvider` 一次即可；脚本停止后配置自动清空，不会存到手机上。
 
-所有方法同步阻塞，失败时返回 `null` / `false`，原因用 `ai.lastError()` 查看。
+所有方法同步阻塞，失败时返回 `undefined` / `false`，原因用 `ai.lastError()` 查看。
 
 ## 快速开始
 
@@ -149,7 +149,7 @@ interface AiMessage {
 ### setProvider - 登记或更新模型供应商。
 
 ```typescript
-function setProvider(config: Partial<AiProvider>): AiProvider | null;
+function setProvider(config: Partial<AiProvider>): AiProvider | undefined;
 ```
 
 **参数：**
@@ -162,7 +162,7 @@ function setProvider(config: Partial<AiProvider>): AiProvider | null;
 
 | 类型         | 描述                                                                            |
 | ------------ | ------------------------------------------------------------------------------- |
-| `AiProvider` | 保存后的完整配置；`protocol` 不是三者之一或缺 `baseUrl` / `model` 时返回 `null` |
+| `AiProvider` | 保存后的完整配置；`protocol` 不是三者之一或缺 `baseUrl` / `model` 时返回 `undefined` |
 
 第一个登记的供应商自动成为默认；`isDefault: true` 会把默认切到它。
 
@@ -240,14 +240,14 @@ ai.getProviders().forEach((p) => logi(`${p.name} -> ${p.model}`));
 ### getDefaultProvider - 获取默认供应商。
 
 ```typescript
-function getDefaultProvider(): AiProvider | null;
+function getDefaultProvider(): AiProvider | undefined;
 ```
 
 **返回值：**
 
 | 类型         | 描述                                  |
 | ------------ | ------------------------------------- |
-| `AiProvider` | 默认供应商；一个都没登记时返回 `null` |
+| `AiProvider` | 默认供应商；一个都没登记时返回 `undefined` |
 
 **示例：**
 
@@ -304,7 +304,7 @@ function removeProvider(id: string): boolean;
 ### ask - 单轮提问，可附带图片。
 
 ```typescript
-function ask(prompt: string, options?: AiOptions): string | null;
+function ask(prompt: string, options?: AiOptions): string | undefined;
 ```
 
 **参数：**
@@ -318,7 +318,7 @@ function ask(prompt: string, options?: AiOptions): string | null;
 
 | 类型     | 描述                                                |
 | -------- | --------------------------------------------------- |
-| `string` | 模型回复文本；失败返回 `null`，原因看 `lastError()` |
+| `string` | 模型回复文本；失败返回 `undefined`，原因看 `lastError()` |
 
 **示例：**
 
@@ -382,7 +382,7 @@ if (!ok && ai.lastError()) loge("请求失败: " + ai.lastError());
 ### extract - 从图片或文本里提取结构化数据。
 
 ```typescript
-function extract(prompt: string, options?: AiOptions): any | null;
+function extract(prompt: string, options?: AiOptions): any | undefined;
 ```
 
 要求模型输出 JSON 并自动解析成对象或数组。`schema` 用来告诉模型你想要的结构。
@@ -398,7 +398,7 @@ function extract(prompt: string, options?: AiOptions): any | null;
 
 | 类型           | 描述                                                      |
 | -------------- | --------------------------------------------------------- |
-| `object/array` | 解析后的数据；模型没有输出合法 JSON 或请求失败返回 `null` |
+| `object/array` | 解析后的数据；模型没有输出合法 JSON 或请求失败返回 `undefined` |
 
 **示例：**
 
@@ -432,14 +432,14 @@ if (pos) action.click(pos.x, pos.y);
 ### chat - 多轮对话。
 
 ```typescript
-function chat(messages: (AiMessage | string)[], options?: AiOptions): string | null;
+function chat(messages: (AiMessage | string)[], options?: AiOptions): string | undefined;
 ```
 
 自己维护完整对话历史时用它；`ask` 是它的单轮封装。模块不记会话，每次都要把到目前为止的消息整表传进来。
 
 图片写在**那一条 user 消息**上，不要用 `options.image`。`options.system` 也不生效，系统提示写成第一条 `{ role: "system", content: "..." }`。
 
-失败返回 `null`：不要把空回复推进历史，否则下一轮变成 `user → assistant(null) → user`，Anthropic 会 400。Anthropic 协议下模块会自动合并连续同角色、并在首条是 assistant 时垫一条占位 user；OpenAI 兼容口更宽松，不必为此改脚本。
+失败返回 `undefined`：不要把空回复推进历史，否则下一轮变成 `user → assistant(null) → user`，Anthropic 会 400。Anthropic 协议下模块会自动合并连续同角色、并在首条是 assistant 时垫一条占位 user；OpenAI 兼容口更宽松，不必为此改脚本。
 
 **参数：**
 
@@ -452,7 +452,7 @@ function chat(messages: (AiMessage | string)[], options?: AiOptions): string | n
 
 | 类型     | 描述                      |
 | -------- | ------------------------- |
-| `string` | 回复文本；失败返回 `null` |
+| `string` | 回复文本；失败返回 `undefined` |
 
 **示例：**
 
@@ -478,7 +478,7 @@ talk("那下一步该点哪里？");
 ### parseJson - 从模型文本里解析 JSON。
 
 ```typescript
-function parseJson(text: string): any | null;
+function parseJson(text: string): any | undefined;
 ```
 
 自动剥掉 Markdown 代码块和前后的解释文字。`extract` 内部就是用它解析；自己用 `ask` 要 JSON 时也可以调它。
@@ -493,7 +493,7 @@ function parseJson(text: string): any | null;
 
 | 类型           | 描述                      |
 | -------------- | ------------------------- |
-| `object/array` | 解析结果；失败返回 `null` |
+| `object/array` | 解析结果；失败返回 `undefined` |
 
 **示例：**
 
@@ -506,14 +506,14 @@ if (obj) logi(obj.fruits.join(", "));
 ### lastError - 最近一次调用失败的原因。
 
 ```typescript
-function lastError(): string | null;
+function lastError(): string | undefined;
 ```
 
 **返回值：**
 
 | 类型     | 描述                                  |
 | -------- | ------------------------------------- |
-| `string` | 错误文案；上一次调用成功时返回 `null` |
+| `string` | 错误文案；上一次调用成功时返回 `undefined` |
 
 常见错误：未登记供应商、Key 错误 / 余额不足（接口返回的原文）、模型不支持图片、图片无效或裁剪越界、超时、模型没有输出 JSON。
 

package/docs/api/config.md

@@ -93,7 +93,7 @@ if (success1 && success2 && success3) {
 ### get - 读取配置项的值。
 
 ```typescript
-function get(key: string): any | null;
+function get(key: string): any | undefined;
 ```
 
 **参数:**
@@ -106,13 +106,13 @@ function get(key: string): any | null;
 
 | 类型          | 描述   |
 | ------------- | ------ |
-| `any \| null` | 配置值 |
+| `any \| undefined` | 配置值 |
 
 **示例:**
 
 ```javascript
 const maxRetries = config.get("maxRetries");
-if (maxRetries !== null) {
+if (maxRetries !== undefined) {
   logi(`最大重试次数: ${maxRetries}`);
 }
 ```

package/docs/api/dotocr.md

@@ -64,7 +64,7 @@ interface OCRChar {
 加载字库是使用点阵识别功能的前提。建议在脚本初始化时加载一次并保存 `fontId`，后续识别时复用，不要每次识别都重新加载。
 
 ```typescript
-function loadFont(fontPath: string): string | null;
+function loadFont(fontPath: string): string | undefined;
 ```
 
 **参数:**
@@ -77,7 +77,7 @@ function loadFont(fontPath: string): string | null;
 
 | 类型             | 描述                                      |
 | ---------------- | ----------------------------------------- |
-| `string \| null` | 加载成功返回字库 ID 字符串，失败返回 null |
+| `string \| undefined` | 加载成功返回字库 ID 字符串，失败返回 undefined |
 
 **示例:**
 

package/docs/api/file.md

@@ -222,7 +222,7 @@ if (deleted) {
 #### readFile - 读取整个文件内容。
 
 ```typescript
-function readFile(path: string): string | null;
+function readFile(path: string): string | undefined;
 ```
 
 **参数:**
@@ -235,13 +235,13 @@ function readFile(path: string): string | null;
 
 | 类型             | 描述                            |
 | ---------------- | ------------------------------- |
-| `string \| null` | 文件内容；失败或不存在返回 null |
+| `string \| undefined` | 文件内容；失败或不存在返回 undefined |
 
 **示例:**
 
 ```javascript
 const content = file.readFile("/path/to/file.txt");
-if (content !== null) {
+if (content !== undefined) {
   logi(`文件内容: ${content}`);
 } else {
   logw("文件不存在或读取失败");
@@ -256,7 +256,7 @@ if (content !== null) {
 - res 目录文件只读，不能修改。
 
 ```typescript
-function readResFile(fileName: string): string | null;
+function readResFile(fileName: string): string | undefined;
 ```
 
 **参数:**
@@ -269,7 +269,7 @@ function readResFile(fileName: string): string | null;
 
 | 类型           | 描述                                    |
 | -------------- | --------------------------------------- |
-| `string\|null` | 文件内容 文件不存在或读取失败 返回 null |
+| `string \| undefined` | 文件内容 文件不存在或读取失败 返回 undefined |
 
 **示例:**
 
@@ -289,7 +289,7 @@ if (config) {
 适用于需要真实文件路径的场景（如模型文件、音视频）。用完后应调用 `cleanupResFile`。
 
 ```typescript
-function getResFile(fileName: string): string | null;
+function getResFile(fileName: string): string | undefined;
 ```
 
 **参数:**
@@ -302,7 +302,7 @@ function getResFile(fileName: string): string | null;
 
 | 类型           | 描述                                      |
 | -------------- | ----------------------------------------- |
-| `string\|null` | 本地文件绝对路径；失败或不存在时返回 null |
+| `string \| undefined` | 本地文件绝对路径；失败或不存在时返回 undefined |
 
 **示例:**
 
@@ -393,7 +393,7 @@ if (appended) {
 #### readLine - 读取文件指定行的内容。
 
 ```typescript
-function readLine(path: string, lineNo: number): string | null;
+function readLine(path: string, lineNo: number): string | undefined;
 ```
 
 **参数:**
@@ -407,13 +407,13 @@ function readLine(path: string, lineNo: number): string | null;
 
 | 类型             | 描述                          |
 | ---------------- | ----------------------------- |
-| `string \| null` | 行内容；失败或不存在返回 null |
+| `string \| undefined` | 行内容；失败或不存在返回 undefined |
 
 **示例:**
 
 ```javascript
 const firstLine = file.readLine("/path/to/file.txt", 1);
-if (firstLine !== null) {
+if (firstLine !== undefined) {
   logi(`第一行内容: ${firstLine}`);
 } else {
   logw("读取失败或行不存在");
@@ -423,7 +423,7 @@ if (firstLine !== null) {
 #### readAllLines - 读取文件所有行内容。
 
 ```typescript
-function readAllLines(path: string): string[] | null;
+function readAllLines(path: string): string[] | undefined;
 ```
 
 **参数:**
@@ -436,13 +436,13 @@ function readAllLines(path: string): string[] | null;
 
 | 类型      | 描述  |
 | --------- | ----- | ----------------------------- |
-| `string[] | null` | 所有行内容数组；失败返回 null |
+| `string[] | undefined` | 所有行内容数组；失败返回 undefined |
 
 **示例:**
 
 ```javascript
 const lines = file.readAllLines("/path/to/file.txt");
-if (lines !== null) {
+if (lines !== undefined) {
   lines.forEach((line, index) => {
     logi(`第${index + 1}行: ${line}`);
   });
@@ -457,7 +457,7 @@ if (lines !== null) {
 function deleteLine(
   path: string,
   line: number,
-  contains: string | null
+  contains?: string
 ): boolean;
 ```
 
@@ -467,7 +467,7 @@ function deleteLine(
 | ---------- | ------ | -------- | ------ | ----------------------------------- |
 | `path`     | string | 是       | -      | 文件路径                            |
 | `line`     | number | 是       | -      | 行号（-1 表示不按行号删除）         |
-| `contains` | string | 否       | null   | 包含的内容（null 表示不按内容删除） |
+| `contains` | string | 否       |        | 包含的内容；省略则不按内容删除 |
 
 **返回值:**
 
@@ -479,7 +479,7 @@ function deleteLine(
 
 ```javascript
 // 删除第3行
-file.deleteLine("/path/to/file.txt", 3, null);
+file.deleteLine("/path/to/file.txt", 3);
 
 // 删除包含"error"的行
 file.deleteLine("/path/to/file.txt", -1, "error");
@@ -493,7 +493,7 @@ file.deleteLine("/path/to/file.txt", 5, "debug");
 #### fileMD5 - 获取文件的 MD5 哈希值。
 
 ```typescript
-function fileMD5(path: string): string | null;
+function fileMD5(path: string): string | undefined;
 ```
 
 **参数:**
@@ -506,7 +506,7 @@ function fileMD5(path: string): string | null;
 
 | 类型             | 描述                      |
 | ---------------- | ------------------------- |
-| `string \| null` | 文件 MD5 值 失败返回 null |
+| `string \| undefined` | 文件 MD5 值 失败返回 undefined |
 
 **示例:**
 

package/docs/api/hid.md

@@ -1122,13 +1122,13 @@ hid.takeMeToFront();
 function currentAppInfo(): {
   name: string;
   bundleId: string;
-} | null;
+} | undefined;
 ```
 
 **返回值:**
 | 类型 | 描述 |
 | ---- | ---- |
-| object \| null | 当前应用信息或 null（如果不可用） |
+| object \| undefined | 当前应用信息或 undefined（如果不可用） |
 
 **返回对象属性:**
 | 属性 | 类型 | 描述 |

package/docs/api/hotUpdate.md

@@ -42,7 +42,7 @@ interface HotUpdateResponse {
   dialog: boolean; // 是否用对话框展示
   msg: string; // 对话框消息
   force: boolean; // 是否强制更新
-  md5?: string; // 更新包MD5值（可选）
+  md5: string | null; // 更新包 MD5；没有时为 null
 }
 ```
 
@@ -56,7 +56,7 @@ interface HotUpdateResponse {
 | `dialog`           | boolean | 是       | -      | 是否用对话框展示      |
 | `msg`              | string  | 是       | -      | 对话框消息            |
 | `force`            | boolean | 是       | -      | 是否强制更新          |
-| `md5`              | string  | 否       | -      | 更新包 MD5 值（可选） |
+| `md5`              | string \| null | 否       | -      | 更新包 MD5；没有时为 `null` |
 
 ## API 参考
 

package/docs/api/http.md

@@ -32,7 +32,7 @@ function request(params: {
   charset: string;
   contentType: string;
   body: string;
-};
+} | undefined;
 ```
 
 **参数：**
@@ -120,7 +120,7 @@ function httpGet(
   params?: Record<string, string>,
   timeout?: number,
   headers?: Record<string, string>,
-): string | null;
+): string | undefined;
 ```
 
 **参数：**
@@ -171,7 +171,7 @@ function httpPost(
   files?: Record<string, string>,
   timeout?: number,
   headers?: Record<string, string>,
-): string | null;
+): string | undefined;
 ```
 
 **参数：**
@@ -219,7 +219,7 @@ function postJSON(
   json?: Record<string, any>,
   timeout?: number,
   headers?: Record<string, string>,
-): string | null;
+): string | undefined;
 ```
 
 **参数：**

package/docs/api/image.md

@@ -24,7 +24,7 @@ function captureScreen(
   y?: number,
   ex?: number,
   ey?: number,
-): string | null;
+): string | undefined;
 ```
 
 **参数：**
@@ -40,7 +40,7 @@ function captureScreen(
 
 | 类型     | 描述                             |
 | -------- | -------------------------------- |
-| `string` | 截图的图片 ID，失败时返回 `null` |
+| `string` | 截图的图片 ID，失败时返回 `undefined` |
 
 **示例：**
 
@@ -73,7 +73,7 @@ if (imageId) {
 ### readImage - 从文件路径或imageId读取图片。
 
 ```typescript
-function readImage(path: string): string | null;
+function readImage(path: string): string | undefined;
 ```
 
 **参数：**
@@ -86,7 +86,7 @@ function readImage(path: string): string | null;
 
 | 类型     | 描述                       |
 | -------- | -------------------------- |
-| `string` | 图片 ID，失败时返回 `null` |
+| `string` | 图片 ID，失败时返回 `undefined` |
 
 **示例：**
 
@@ -186,7 +186,7 @@ if (imageId) {
 ### getSize - 获取图片尺寸。
 
 ```typescript
-function getSize(imageId: string): { width: number; height: number } | null;
+function getSize(imageId: string): { width: number; height: number } | undefined;
 ```
 
 **参数：**
@@ -199,7 +199,7 @@ function getSize(imageId: string): { width: number; height: number } | null;
 
 | 类型             | 描述                                                           |
 | ---------------- | -------------------------------------------------------------- |
-| `object \| null` | 图片尺寸对象，包含 `width` 和 `height` 属性，失败时返回 `null` |
+| `object \| undefined` | 图片尺寸对象，包含 `width` 和 `height` 属性，失败时返回 `undefined` |
 
 **示例：**
 
@@ -881,7 +881,7 @@ function clip(
   y: number,
   ex: number,
   ey: number,
-): string;
+): string | undefined;
 ```
 
 **参数：**
@@ -921,7 +921,7 @@ if (imageId) {
 ### rotateImage - 旋转图片。
 
 ```typescript
-function rotateImage(imageId: string, degree: number): string | null;
+function rotateImage(imageId: string, degree: number): string | undefined;
 ```
 
 **参数：**
@@ -935,7 +935,7 @@ function rotateImage(imageId: string, degree: number): string | null;
 
 | 类型             | 描述                                |
 | ---------------- | ----------------------------------- |
-| `string \| null` | 旋转后的新图片 ID 失败时返回 `null` |
+| `string \| undefined` | 旋转后的新图片 ID 失败时返回 `undefined` |
 
 **示例：**
 
@@ -956,7 +956,7 @@ if (imageId) {
 ### gray - 将图片转换为灰度图。
 
 ```typescript
-function gray(imageId: string): string;
+function gray(imageId: string): string | undefined;
 ```
 
 **参数：**
@@ -988,7 +988,7 @@ if (imageId) {
 ### binaryzation - 将图片进行二值化处理。
 
 ```typescript
-function binaryzation(imageId: string, threshold: number): string;
+function binaryzation(imageId: string, threshold: number): string | undefined;
 ```
 
 **参数：**
@@ -1059,7 +1059,7 @@ if (imageId) {
 ### scanCode - 扫码条码（支持一维码和二维码）
 
 ```typescript
-function scanCode(imageId: string): string | null;
+function scanCode(imageId: string): string | undefined;
 ```
 
 **参数：**
@@ -1072,7 +1072,7 @@ function scanCode(imageId: string): string | null;
 
 | 类型             | 描述                        |
 | ---------------- | --------------------------- |
-| `string \| null` | 扫码结果，失败时返回 `null` |
+| `string \| undefined` | 扫码结果，失败时返回 `undefined` |
 
 **示例：**
 
@@ -1094,7 +1094,7 @@ if (imageId) {
 ### base64ToImage - 将 Base64 字符串转换为图片。
 
 ```typescript
-function base64ToImage(base64: string): string;
+function base64ToImage(base64: string): string | undefined;
 ```
 
 **参数：**
@@ -1127,7 +1127,7 @@ if (imageId) {
 ### toBase64Format - 将图片转换为 Base64 字符串。
 
 ```typescript
-function toBase64Format(imageId: string, format: string, q: number): string;
+function toBase64Format(imageId: string, format: string, q: number): string | undefined;
 ```
 
 **参数：**