docs(xaction): 新增自动化脚本模块文档

data/xaction/catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-08-12 20:29:09",
-  "moduleCount": 149,
+  "generatedAt": "2026-08-13 19:01:10",
+  "moduleCount": 150,
   "legacyMappedModuleCount": 143,
   "migratedLegacyModuleCount": 137,
   "categories": [
@@ -63,7 +63,7 @@
     {
       "key": "Input",
       "name": "键鼠输入",
-      "moduleCount": 1
+      "moduleCount": 2
     }
   ],
   "modules": [
@@ -28712,6 +28712,104 @@
         }
       },
       "sourceFileName": "sys_aiChat_AI 交互对话.md"
+    },
+    {
+      "key": "sys:automationScript",
+      "slug": "automationscript",
+      "legacySlug": "automationscript",
+      "ownsLegacyContent": true,
+      "name": "自动化脚本",
+      "description": "使用 JavaScript 编排鼠标、键盘等桌面自动化操作。",
+      "category": "Input",
+      "categoryName": "键鼠输入",
+      "stepType": "Action",
+      "isRisky": true,
+      "isProOnly": false,
+      "helpLink": "",
+      "inputs": [
+        {
+          "key": "script",
+          "name": "脚本内容",
+          "type": "Text",
+          "defaultValue": "import { mouse, key } from \"quicker\";\n\nmouse.moveTo(100, 200);\nmouse.click();\nkey.press(\"enter\");\n\nexport default mouse.position();",
+          "required": true,
+          "variableMode": "Input",
+          "condition": "",
+          "description": "要执行的桌面自动化 JavaScript。可使用 export default 导出结果。"
+        },
+        {
+          "key": "input",
+          "name": "输入",
+          "type": "Any",
+          "defaultValue": "",
+          "required": false,
+          "variableMode": "UseVarOrInput",
+          "condition": "",
+          "description": "传入脚本的受支持数据。脚本可从 quicker 模块导入 input 读取。"
+        },
+        {
+          "key": "timeoutMs",
+          "name": "超时时间（毫秒）",
+          "type": "Integer",
+          "defaultValue": "30000",
+          "required": false,
+          "variableMode": "Input",
+          "condition": "",
+          "description": "脚本最长运行时间，范围 100 到 120000 毫秒。"
+        },
+        {
+          "key": "restoreMousePosition",
+          "name": "结束后恢复鼠标位置",
+          "type": "Boolean",
+          "defaultValue": "false",
+          "required": false,
+          "variableMode": "Input",
+          "condition": "",
+          "description": "脚本正常结束或失败时恢复开始前的鼠标位置；用户接管或主动取消时不恢复。"
+        },
+        {
+          "key": "stopIfFail",
+          "name": "失败后停止",
+          "type": "Boolean",
+          "defaultValue": "true",
+          "required": false,
+          "variableMode": "Input",
+          "condition": "",
+          "description": "失败后是否停止动作"
+        }
+      ],
+      "outputs": [
+        {
+          "key": "isSuccess",
+          "name": "是否成功",
+          "type": "Boolean",
+          "condition": "",
+          "description": "操作是否成功"
+        },
+        {
+          "key": "result",
+          "name": "结果",
+          "type": "Any",
+          "condition": "",
+          "description": "脚本 export default 导出的受支持值。"
+        },
+        {
+          "key": "errorCode",
+          "name": "错误码",
+          "type": "Text",
+          "condition": "",
+          "description": "稳定的机器可读错误码。"
+        },
+        {
+          "key": "errMessage",
+          "name": "错误消息",
+          "type": "Text",
+          "condition": "",
+          "description": "脚本执行失败时的错误消息。"
+        }
+      ],
+      "selections": {},
+      "sourceFileName": "sys_automationScript_自动化脚本.md"
     }
   ]
 }

data/xaction/changes.json

@@ -1,43 +1,19 @@
 {
   "schemaVersion": 1,
   "baselineCreated": false,
-  "fromGeneratedAt": "2026-08-03 20:08:03",
-  "toGeneratedAt": "2026-08-12 20:29:09",
+  "fromGeneratedAt": "2026-08-12 20:29:09",
+  "toGeneratedAt": "2026-08-13 19:01:10",
   "summary": {
-    "addedModules": 5,
+    "addedModules": 1,
     "removedModules": 0,
     "changedModules": 0
   },
   "addedModules": [
     {
-      "key": "sys:aiText",
-      "name": "AI 文本处理",
-      "slug": "ai-text",
-      "category": "Text"
-    },
-    {
-      "key": "sys:aiVision",
-      "name": "AI 图片理解",
-      "slug": "ai-vision",
-      "category": "Image"
-    },
-    {
-      "key": "sys:aiClassify",
-      "name": "AI 文本分类",
-      "slug": "ai-classify",
-      "category": "Text"
-    },
-    {
-      "key": "sys:aiExtract",
-      "name": "AI 结构化提取",
-      "slug": "ai-extract",
-      "category": "Text"
-    },
-    {
-      "key": "sys:aiChat",
-      "name": "AI 交互对话",
-      "slug": "ai-chat",
-      "category": "Network"
+      "key": "sys:automationScript",
+      "name": "自动化脚本",
+      "slug": "automationscript",
+      "category": "Input"
     }
   ],
   "removedModules": [],

data/xaction/modules/sys_automationScript.json

@@ -0,0 +1,98 @@
+{
+  "key": "sys:automationScript",
+  "slug": "automationscript",
+  "legacySlug": "automationscript",
+  "ownsLegacyContent": true,
+  "name": "自动化脚本",
+  "description": "使用 JavaScript 编排鼠标、键盘等桌面自动化操作。",
+  "category": "Input",
+  "categoryName": "键鼠输入",
+  "stepType": "Action",
+  "isRisky": true,
+  "isProOnly": false,
+  "helpLink": "",
+  "inputs": [
+    {
+      "key": "script",
+      "name": "脚本内容",
+      "type": "Text",
+      "defaultValue": "import { mouse, key } from \"quicker\";\n\nmouse.moveTo(100, 200);\nmouse.click();\nkey.press(\"enter\");\n\nexport default mouse.position();",
+      "required": true,
+      "variableMode": "Input",
+      "condition": "",
+      "description": "要执行的桌面自动化 JavaScript。可使用 export default 导出结果。"
+    },
+    {
+      "key": "input",
+      "name": "输入",
+      "type": "Any",
+      "defaultValue": "",
+      "required": false,
+      "variableMode": "UseVarOrInput",
+      "condition": "",
+      "description": "传入脚本的受支持数据。脚本可从 quicker 模块导入 input 读取。"
+    },
+    {
+      "key": "timeoutMs",
+      "name": "超时时间（毫秒）",
+      "type": "Integer",
+      "defaultValue": "30000",
+      "required": false,
+      "variableMode": "Input",
+      "condition": "",
+      "description": "脚本最长运行时间，范围 100 到 120000 毫秒。"
+    },
+    {
+      "key": "restoreMousePosition",
+      "name": "结束后恢复鼠标位置",
+      "type": "Boolean",
+      "defaultValue": "false",
+      "required": false,
+      "variableMode": "Input",
+      "condition": "",
+      "description": "脚本正常结束或失败时恢复开始前的鼠标位置；用户接管或主动取消时不恢复。"
+    },
+    {
+      "key": "stopIfFail",
+      "name": "失败后停止",
+      "type": "Boolean",
+      "defaultValue": "true",
+      "required": false,
+      "variableMode": "Input",
+      "condition": "",
+      "description": "失败后是否停止动作"
+    }
+  ],
+  "outputs": [
+    {
+      "key": "isSuccess",
+      "name": "是否成功",
+      "type": "Boolean",
+      "condition": "",
+      "description": "操作是否成功"
+    },
+    {
+      "key": "result",
+      "name": "结果",
+      "type": "Any",
+      "condition": "",
+      "description": "脚本 export default 导出的受支持值。"
+    },
+    {
+      "key": "errorCode",
+      "name": "错误码",
+      "type": "Text",
+      "condition": "",
+      "description": "稳定的机器可读错误码。"
+    },
+    {
+      "key": "errMessage",
+      "name": "错误消息",
+      "type": "Text",
+      "condition": "",
+      "description": "脚本执行失败时的错误消息。"
+    }
+  ],
+  "selections": {},
+  "sourceFileName": "sys_automationScript_自动化脚本.md"
+}

data/xaction/param-file-ext.ts

@@ -7,6 +7,7 @@
  */
 export const PARAM_FILE_EXT: Readonly<Record<string, Readonly<Record<string, string>>>> = {
   'sys:jsscript': {script: '.js'},
+  'sys:automationScript': {script: '.js'},
   'sys:csscript': {
     script: '.cs',
     scriptForLp: '.cs',

docs/v2/xaction/index.md

@@ -15,20 +15,20 @@ hide_table_of_contents: true
 第一次编写请从 [怎样学会组合动作](/v2/xaction/guides/how-to-learn) 开始。
 
 <XActionLanding
-  moduleCount={149}
-  generatedAt="2026-08-03 20:08:03"
+  moduleCount={150}
+  generatedAt="2026-08-13 19:01:10"
   counts={{
     Basic: 14,
-    Text: 11,
-    Image: 14,
+    Text: 14,
+    Image: 15,
     Clipboard: 6,
     Flow: 15,
     System: 22,
     Files: 10,
     Compute: 14,
-    Network: 13,
+    Network: 14,
     Ui: 13,
     SoftInteraction: 11,
-    Input: 1,
+    Input: 2,
   }}
 />

docs/v2/xaction/modules/basic/mouse.md

@@ -284,6 +284,11 @@ legacyContentUpdatedAt: "2025-01-20T02:00:01.000Z"
 
 <RelatedDocs
   items={[
+    {
+      href: '/v2/xaction/modules/automationscript',
+      label: '自动化脚本',
+      description: '用 JavaScript 编排坐标、鼠标和键盘操作。',
+    },
     {
       href: '/v2/xaction/modules/searchbmp',
       label: '屏幕找图',

docs/v2/xaction/modules/flow/jsscript.md

@@ -89,6 +89,11 @@ quickerSetVar('动作里的变量名', 新的值);
 
 <RelatedDocs
   items={[
+    {
+      href: '/v2/xaction/modules/automationscript',
+      label: '自动化脚本',
+      description: '使用受限 JavaScript 安全地编排鼠标和键盘操作。',
+    },
     {
       href: '/v2/xaction/modules/csscript',
       label: '运行C#代码',