android-midscene-automation 0.1.32 → 0.1.34

package/src/appium-recorder/AppiumPage.vue

@@ -9,6 +9,10 @@ import DevicePreviewPanel from '../components/device/DevicePreviewPanel.vue';
 import LoopSettings from './components/LoopSettings.vue';
 import BreakLoopSettings from './components/BreakLoopSettings.vue';
 import VisualChangeEndPicker from './components/VisualChangeEndPicker.vue';
+import PresetVariables from './components/PresetVariables.vue';
+import VariableExtractionSettings from './components/VariableExtractionSettings.vue';
+import ScriptParameterSettings from './components/ScriptParameterSettings.vue';
+import { validateVariables, validateExtraction, validateReturns, type TestVariable } from './variables';
 import { defaultLoopConfig, enclosingLoops, breakLoopTarget, validateLoop, validateLoopSteps } from './bounded-loop';
 import {
   clearAppiumDeviceAppData,
@@ -20,6 +24,7 @@ import {
   launchAppiumDeviceApp,
   replayAppiumScript,
   saveAppiumScript,
+  saveVariables,
   stopAppiumReplay,
   tapAppiumDevice,
 } from './api';
@@ -66,7 +71,7 @@ import type {
   AppiumVisualChangeRegion,
 } from './types';
 
-type NodeStepType = 'tap' | 'input' | 'assertExists' | 'waitFor';
+type NodeStepType = 'tap' | 'input' | 'waitFor';
 type BranchName = 'yes' | 'no';
 type LegacyFlow = NonNullable<AppiumRecordedStep['flow']> & { scope?: string };
 type SwipeGesture = NonNullable<AppiumRecordedStep['swipe']>;
@@ -86,10 +91,10 @@ const historyScript = shallowRef<{ id: string; name: string } | null>(null);
 const AUTO_TREE_REFRESH_INTERVAL_MS = 1800;
 
 const insertableRecorderActions: RecorderAction[] = [
+  'extractVariable',
   'delay',
   'tap',
   'input',
-  'assertExists',
   'waitFor',
   'tapIfExists',
   'inputIfExists',
@@ -117,7 +122,6 @@ const insertableRecorderActions: RecorderAction[] = [
   'breakLoop',
   'clearAppData',
   'waitDisappear',
-  'assertText',
   'longPress',
   'pinch',
   'noop',
@@ -164,7 +168,7 @@ const selectedScriptId = shallowRef('');
 const newScriptDialogVisible = shallowRef(false);
 const newScriptRevision = shallowRef(0);
 const storedWorkbenchTab = window.localStorage.getItem(WORKBENCH_TAB_STORAGE_KEY);
-const activeWorkbenchTab = shallowRef<'recording' | 'scripts'>(storedWorkbenchTab === 'scripts' ? 'scripts' : 'recording');
+const activeWorkbenchTab = shallowRef<'recording' | 'scripts' | 'variables'>(storedWorkbenchTab === 'scripts' ? 'scripts' : storedWorkbenchTab === 'variables' ? 'variables' : 'recording');
 const steps = shallowRef<AppiumRecordedStep[]>([]);
 const aiRecognitionTestStep = shallowRef<AppiumRecordedStep | null>(null);
 const flowClipboard = shallowRef<FlowClipboard | null>(null);
@@ -174,6 +178,7 @@ const replayOutput = shallowRef('');
 const replayOutputDialogVisible = shallowRef(false);
 const linkedScriptDialogVisible = shallowRef(false);
 const linkedScriptTargetId = shallowRef('');
+const linkedParameters = reactive<AppiumRecordedStep>({ id: 'link-parameters', type: 'runScript', label: '', parameters: [], returns: [] });
 const linkedScriptInsertIndex = shallowRef<number | undefined>();
 const linkedScriptBranchTarget = shallowRef<BranchTarget | null>(null);
 const linkedScriptExpectedActivity = shallowRef('');
@@ -214,6 +219,7 @@ const form = reactive({
   appPackage: '',
   appActivity: '',
 });
+const scriptVariables = shallowRef<TestVariable[]>([]);
 
 const savedDraftSnapshot = shallowRef('');
 const currentDraftSnapshot = computed(() => JSON.stringify({
@@ -221,6 +227,7 @@ const currentDraftSnapshot = computed(() => JSON.stringify({
   appPackage: form.appPackage,
   appActivity: form.appActivity,
   steps: steps.value,
+  variables: scriptVariables.value,
 }));
 const flowClipboardCount = computed(() => flowClipboard.value?.steps.length || 0);
 const hasUnsavedChanges = computed(() => currentDraftSnapshot.value !== savedDraftSnapshot.value);
@@ -229,6 +236,16 @@ function markDraftSaved() {
   savedDraftSnapshot.value = currentDraftSnapshot.value;
 }
 
+function onVariablesSaved(id: string, variables: TestVariable[]) {
+  const script = scripts.value.find(item => item.id === id);
+  if (script) script.variables = variables;
+  if (id && selectedScriptId.value === id) {
+    // 仅更新变量的已保存基线，不把尚未保存的节点标记为已保存。
+    const snapshot = JSON.parse(savedDraftSnapshot.value);
+    savedDraftSnapshot.value = JSON.stringify({ ...snapshot, variables });
+  }
+}
+
 function warnBeforeUnload(event: BeforeUnloadEvent) {
   if (!props.active || !hasUnsavedChanges.value) return;
   event.preventDefault();
@@ -462,7 +479,6 @@ function createStep(type: NodeStepType, node: AppiumNode): AppiumRecordedStep {
   const labelMap = {
     tap: '点击',
     input: '输入',
-    assertExists: '断言存在',
     waitFor: '等待出现',
   };
   return {
@@ -475,7 +491,7 @@ function createStep(type: NodeStepType, node: AppiumNode): AppiumRecordedStep {
       ? [{ strategy: 'xpath', value: node.xpath, unique: true, matchCount: 1 }]
       : undefined,
     fallback: node.bounds ? { strategy: 'bounds', centerX: node.bounds.centerX, centerY: node.bounds.centerY } : undefined,
-    timeoutMs: type === 'assertExists' || type === 'waitFor' ? 10000 : undefined,
+    timeoutMs: type === 'waitFor' ? 10000 : undefined,
     pageBefore: currentPageSnapshot(node),
     snapshot: {
       text: node.text,
@@ -1126,11 +1142,15 @@ function openLinkedScriptDialog(index?: number, branchTarget?: BranchTarget) {
     return;
   }
   linkedScriptTargetId.value = compatibleLinkableScripts.value[0]?.id || '';
+  linkedParameters.parameters = [];
+  linkedParameters.returns = [];
   linkedScriptInsertIndex.value = index;
   linkedScriptDialogVisible.value = true;
 }
 
 function addLinkedScriptStep() {
+  try { validateVariables(linkedParameters.parameters); validateReturns(linkedParameters.returns); }
+  catch (error) { ElMessage.error(String(error)); return; }
   const script = scripts.value.find((item) => item.id === linkedScriptTargetId.value);
   if (!script) {
     ElMessage.warning('请选择要连接的脚本');
@@ -1151,7 +1171,7 @@ function addLinkedScriptStep() {
     return;
   }
   insertStep(
-    createRunScriptStep(script),
+    { ...createRunScriptStep(script), parameters: JSON.parse(JSON.stringify(linkedParameters.parameters || [])), returns: JSON.parse(JSON.stringify(linkedParameters.returns || [])) },
     linkedScriptInsertIndex.value,
     linkedScriptBranchTarget.value || undefined,
   );
@@ -1368,7 +1388,7 @@ async function addAction(
     if (result) return insertStep({ ...step }, index, branchTarget);
     return;
   }
-  if (action === 'tap' || action === 'input' || action === 'assertExists' || action === 'waitFor') {
+  if (action === 'tap' || action === 'input' || action === 'waitFor') {
     return addStep(action, index, branchTarget);
   }
   if (action === 'keyBack') {
@@ -1491,6 +1511,22 @@ async function addAction(
   }
   const node = getSelectedNode();
   if (!node) return;
+  if (action === 'extractVariable') {
+    const step = reactive<AppiumRecordedStep>({ ...createNodeActionStep('extractVariable', '提取变量', node), extractVariable: { name: '', attribute: 'text', sensitive: false }, flow: { nodeKind: 'action' } });
+    const result = await ElMessageBox({
+      title: '提取组件到变量',
+      message: h(ElForm, { labelPosition: 'top' }, () => h(VariableExtractionSettings, { step, onUpdate: patch => Object.assign(step, patch) })),
+      showCancelButton: true, confirmButtonText: '添加', cancelButtonText: '取消',
+      beforeClose: (action, _instance, done) => {
+        if (action === 'confirm') {
+          try { validateExtraction(step.extractVariable); } catch (error) { ElMessage.error(String(error)); return; }
+        }
+        done();
+      },
+    }).catch(() => null);
+    if (result) return insertStep(JSON.parse(JSON.stringify(step)), index, branchTarget);
+    return;
+  }
   if (action === 'checkboxState' || action === 'radioButtonState' || action === 'checkedState') {
     const controlName = nativeControlName(action);
     if (!matchesNativeControl(action, node.className) || node.checkable !== true) {
@@ -1588,14 +1624,6 @@ async function addAction(
   if (action === 'waitDisappear') {
     return insertStep(createNodeActionStep('waitDisappear', '等待元素消失', node, { timeoutMs: 10000 }), index, branchTarget);
   }
-  if (action === 'assertText') {
-    const input = await ElMessageBox.prompt('请输入要断言的文本', '断言文本', {
-      inputValue: node.text,
-      confirmButtonText: '添加',
-      cancelButtonText: '取消',
-    }).catch(() => null);
-    if (input?.value) return insertStep(createNodeActionStep('assertText', '断言文本', node, { value: input.value }), index, branchTarget);
-  }
 }
 
 async function addBranchAction(index: number, branch: BranchName, action: RecorderAction) {
@@ -1643,6 +1671,7 @@ async function saveOnActivityChange() {
       appActivity: pending.beforeActivity || form.appActivity,
       deviceId: selectedDeviceId.value,
       steps: steps.value,
+      variables: scriptVariables.value,
     });
     await loadScripts();
     pendingNavigation.value = null;
@@ -1714,7 +1743,7 @@ async function editInputStep(index: number) {
 }
 
 function setActiveWorkbenchTab(tab: string | number) {
-  const nextTab = tab === 'scripts' ? 'scripts' : 'recording';
+  const nextTab = tab === 'scripts' ? 'scripts' : tab === 'variables' ? 'variables' : 'recording';
   activeWorkbenchTab.value = nextTab;
   window.localStorage.setItem(WORKBENCH_TAB_STORAGE_KEY, nextTab);
 }
@@ -1726,6 +1755,7 @@ function loadScript(script: AppiumRecordedScript) {
   form.name = script.name;
   form.appPackage = script.appPackage;
   form.appActivity = script.appActivity;
+  scriptVariables.value = JSON.parse(JSON.stringify(script.variables || []));
   if (script.deviceId && script.deviceId !== selectedDeviceId.value) {
     void switchDevice(script.deviceId);
   }
@@ -1742,6 +1772,8 @@ function loadSelectedScript() {
 }
 
 function resetCurrentScript() {
+  void saveVariables('/api/appium-recorder/variables?draft=1', []).catch(() => ElMessage.error('变量草稿清理失败'));
+  scriptVariables.value = [];
   flowClipboard.value = null;
   selectedScriptId.value = '';
   form.name = '';
@@ -1753,7 +1785,7 @@ function resetCurrentScript() {
 
 function requestNewScript() {
   if (newScriptDisabled.value) return;
-  if (selectedScriptId.value || form.name.trim() || steps.value.length) {
+  if (selectedScriptId.value || form.name.trim() || steps.value.length || scriptVariables.value.length) {
     newScriptDialogVisible.value = true;
     return;
   }
@@ -1808,6 +1840,7 @@ async function duplicateScript(script: AppiumRecordedScript) {
   try {
     const payload = await saveAppiumScript({
       name: createDuplicateScriptName(script.name),
+      variables: script.variables || [],
       appPackage: script.appPackage,
       appActivity: script.appActivity,
       deviceId: script.deviceId,
@@ -1939,8 +1972,10 @@ async function importScriptFile(event: Event) {
 
 async function saveScript() {
   if (!ensureAppPackageSelected()) return false;
+  const wasNew = !selectedScriptId.value;
   saving.value = true;
   try {
+    validateVariables(scriptVariables.value);
     const payload = await saveAppiumScript({
       id: selectedScriptId.value || undefined,
       name: form.name,
@@ -1948,9 +1983,11 @@ async function saveScript() {
       appActivity: form.appActivity,
       deviceId: selectedDeviceId.value,
       steps: steps.value,
+      variables: scriptVariables.value,
     });
     await loadScripts();
     selectedScriptId.value = payload.script.id;
+    if (wasNew) void saveVariables('/api/appium-recorder/variables?draft=1', []).catch(() => ElMessage.error('变量草稿清理失败'));
     markDraftSaved();
     ElMessage.success('Appium 脚本已保存');
     return true;
@@ -2192,6 +2229,9 @@ watch(
             </div>
           </el-tab-pane>
 
+          <el-tab-pane label="预设变量" name="variables" lazy>
+            <PresetVariables :key="`${selectedScriptId}:${newScriptRevision}`" v-model:variables="scriptVariables" :script-id="selectedScriptId" :script-name="form.name" :disabled="recordingBusy || saving" @saved="onVariablesSaved" />
+          </el-tab-pane>
           <el-tab-pane label="脚本列表" name="scripts">
             <div class="appium-script-list">
               <div class="appium-script-list__toolbar">
@@ -2365,6 +2405,7 @@ watch(
             </el-button>
           </div>
         </el-form-item>
+        <ScriptParameterSettings :step="linkedParameters" @update="Object.assign(linkedParameters, $event)" />
       </el-form>
       <template #footer>
         <el-button @click="closeLinkedScriptDialog">取消</el-button>

package/src/appium-recorder/api.ts

@@ -1,6 +1,26 @@
 import { APP_BASE } from '../api';
 import type { AppiumRecordedScript, AppiumRecordedStep } from './types';
 import type { AiRecognitionResult } from './ai-recognition';
+import type { TestVariable } from './variables';
+
+// 队列跨组件挂载保留，切换脚本或清空草稿时仍按编辑顺序写入。
+const variableWrites = new Map<string, Promise<unknown>>();
+export function saveVariables(url: string, variables: TestVariable[]) {
+  const body = JSON.stringify({ variables });
+  const task = (variableWrites.get(url) || Promise.resolve()).catch(() => {}).then(async () => {
+    return readJson<{ variables: TestVariable[] }>(await fetch(url, {
+      method: 'PUT', headers: { 'Content-Type': 'application/json' }, body, keepalive: true,
+    }));
+  });
+  variableWrites.set(url, task);
+  void task.finally(() => { if (variableWrites.get(url) === task) variableWrites.delete(url); }).catch(() => {});
+  return task;
+}
+
+export async function loadVariables(url: string) {
+  await variableWrites.get(url)?.catch(() => {});
+  return readJson<{ variables: TestVariable[] }>(await fetch(url));
+}
 
 async function readJson<T>(response: Response) {
   const payload = (await response.json().catch(() => ({}))) as T & {
@@ -56,6 +76,7 @@ export async function testAiRecognition(input: { deviceId: string; prompt: strin
 }
 
 export function saveAppiumScript(input: {
+  variables?: import('./variables').TestVariable[];
   id?: string;
   name: string;
   appPackage: string;
@@ -105,7 +126,7 @@ type ReplayStreamEvent =
   | { type: 'error'; message: string };
 
 export async function replayAppiumScript(
-  input: { id: string; deviceId?: string },
+  input: { id: string; deviceId?: string; parameters?: import('./variables').TestVariable[] },
   onOutput?: (line: string) => void,
 ) {
   const response = await fetch(`${APP_BASE}/api/appium-recorder/scripts/${encodeURIComponent(input.id)}/replay`, {
@@ -114,7 +135,7 @@ export async function replayAppiumScript(
       'Content-Type': 'application/json',
       Accept: 'application/x-ndjson',
     },
-    body: JSON.stringify({ deviceId: input.deviceId }),
+    body: JSON.stringify({ deviceId: input.deviceId, parameters: input.parameters }),
   });
   if (!response.ok || !response.body) return readJson<ReplayResult>(response);
 

package/src/appium-recorder/components/FlowStepEditor.vue

@@ -10,6 +10,8 @@ import LongPressSettings from './LongPressSettings.vue';
 import StageLogSettings from './StageLogSettings.vue';
 import LoopSettings from './LoopSettings.vue';
 import BreakLoopSettings from './BreakLoopSettings.vue';
+import VariableExtractionSettings from './VariableExtractionSettings.vue';
+import ScriptParameterSettings from './ScriptParameterSettings.vue';
 
 type FlowKind = 'action' | 'condition' | 'assertion';
 type SwipeGesture = NonNullable<AppiumRecordedStep['swipe']>;
@@ -77,6 +79,20 @@ function patchSwipe(patch: Partial<SwipeGesture>) {
   });
 }
 
+function patchTapCoordinate(axis: 'centerX' | 'centerY', value: number | undefined) {
+  if (value === undefined || !Number.isFinite(value)) return;
+  const fallback = {
+    ...props.step.fallback,
+    strategy: 'bounds' as const,
+    centerX: props.step.fallback?.centerX ?? 0,
+    centerY: props.step.fallback?.centerY ?? 0,
+    [axis]: Math.max(0, Math.round(value)),
+  };
+  // 仅同步自动生成的名称，保留用户自定义的节点名称。
+  patchStep({ fallback, ...(/^点击坐标 \d+,\d+$/.test(props.step.label)
+    ? { label: `点击坐标 ${fallback.centerX},${fallback.centerY}` } : {}) });
+}
+
 function patchVisualChange(patch: Partial<VisualChangeConfig>) {
   patchStep({
     visualChange: normalizeVisualChangeConfig({
@@ -109,7 +125,7 @@ function patchSelector(patch: Partial<AppiumSelector>) {
   patchStep({
     selector: { ...props.step.selector!, ...patch },
     // 修改元素目标后，不能继续优先使用录制时的备用 XPath。
-    ...(props.step.type === 'longPress' || isNativeStateCondition(props.step) ? { selectorChain: undefined } : {}),
+    ...(props.step.type === 'longPress' || props.step.type === 'extractVariable' || isNativeStateCondition(props.step) ? { selectorChain: undefined } : {}),
   });
 }
 </script>
@@ -137,7 +153,7 @@ function patchSelector(patch: Partial<AppiumSelector>) {
         <el-form-item label="节点类型">
           <el-select
             :model-value="defaultKind()"
-            :disabled="disabled || isBooleanCondition(step) || step.type === 'log' || step.type === 'openGallery' || step.type === 'endFlow' || step.type === 'loop' || step.type === 'breakLoop'"
+            :disabled="disabled || isBooleanCondition(step) || step.type === 'extractVariable' || step.type === 'log' || step.type === 'openGallery' || step.type === 'endFlow' || step.type === 'loop' || step.type === 'breakLoop'"
             @update:model-value="patchFlow({ nodeKind: $event as FlowKind })"
           >
             <el-option label="操作" value="action" />
@@ -157,7 +173,17 @@ function patchSelector(patch: Partial<AppiumSelector>) {
         </el-form-item>
       </div>
       <LongPressSettings v-if="step.type === 'longPress'" :step="step" :disabled="disabled" @update="patchStep" />
+      <div v-if="step.type === 'coordinateTap'" class="appium-flow-editor__grid">
+        <el-form-item label="坐标 X">
+          <el-input-number :model-value="step.fallback?.centerX ?? 0" :disabled="disabled" :min="0" :max="99999" :precision="0" controls-position="right" aria-label="坐标 X" @update:model-value="patchTapCoordinate('centerX', $event)" />
+        </el-form-item>
+        <el-form-item label="坐标 Y">
+          <el-input-number :model-value="step.fallback?.centerY ?? 0" :disabled="disabled" :min="0" :max="99999" :precision="0" controls-position="right" aria-label="坐标 Y" @update:model-value="patchTapCoordinate('centerY', $event)" />
+        </el-form-item>
+      </div>
       <StageLogSettings v-if="step.type === 'log'" :step="step" :disabled="disabled" @update="patchStep" />
+      <VariableExtractionSettings v-if="step.type === 'extractVariable'" :step="step" :disabled="disabled" @update="patchStep" />
+      <ScriptParameterSettings v-if="step.type === 'runScript'" :step="step" :disabled="disabled" @update="patchStep" />
       <LoopSettings v-if="step.type === 'loop'" :step="step" :disabled="disabled" @update="patchStep" />
       <BreakLoopSettings v-if="step.type === 'breakLoop'" :step="step" :steps="steps" :disabled="disabled" @update="patchStep" />
       <TextClickSettings v-if="step.type === 'textClick'" :step="step" :disabled="disabled" @update="patchStep" />

package/src/appium-recorder/components/NestedConditionBranches.vue

@@ -44,6 +44,7 @@ type InsertAction =
   | 'waitDisappear'
   | 'waitActivity'
   | 'runScript'
+  | 'extractVariable'
   | 'noop'
   | 'log'
   | 'visualChangeStart'
@@ -89,6 +90,7 @@ const actionGroups: Array<{ title: string; actions: Array<{ type: InsertAction;
     actions: [
       { type: 'tap', label: '录制点击' },
       { type: 'input', label: '录制输入' },
+      { type: 'extractVariable', label: '提取变量' },
       { type: 'clearInput', label: '清空输入' },
       { type: 'coordinateTap', label: '点击坐标' },
       { type: 'longPress', label: '长按' },
@@ -120,8 +122,6 @@ const actionGroups: Array<{ title: string; actions: Array<{ type: InsertAction;
       { type: 'clearIfExists', label: '存在则清空' },
       { type: 'backIfExists', label: '存在则返回' },
       { type: 'waitFor', label: '等待出现' },
-      { type: 'assertExists', label: '断言存在' },
-      { type: 'assertText', label: '断言文本' },
       { type: 'waitDisappear', label: '等待元素消失' },
       { type: 'waitActivity', label: '等待 Activity' },
       { type: 'visualChangeStart', label: '检测画面变化开始' },

package/src/appium-recorder/components/PresetVariables.vue

@@ -0,0 +1,109 @@
+<script setup lang="ts">
+import { onBeforeUnmount, onMounted, ref } from 'vue';
+import { QuestionFilled } from '@element-plus/icons-vue';
+import { loadVariables, saveVariables } from '../api';
+import VariableTable from './VariableTable.vue';
+import { validateVariables, type TestVariable } from '../variables';
+const props = defineProps<{ variables: TestVariable[]; disabled?: boolean; scriptName: string; scriptId: string }>();
+const emit = defineEmits<{ 'update:variables': [TestVariable[]]; saved: [string, TestVariable[]] }>();
+const globals = ref<TestVariable[]>([]);
+const busy = ref(false);
+const loaded = ref(false);
+const error = ref('');
+const status = ref({ global: '', private: '' });
+const invalid = ref({ global: false, private: false });
+const revisions = { global: 0, private: 0 };
+let mounted = true;
+onBeforeUnmount(() => { mounted = false; });
+const privateUrl = props.scriptId ? `/api/appium-recorder/variables?scriptId=${encodeURIComponent(props.scriptId)}` : '/api/appium-recorder/variables?draft=1';
+async function load() {
+  busy.value = true; error.value = '';
+  try {
+    globals.value = (await loadVariables('/api/appium-recorder/variables')).variables; loaded.value = true;
+    if (props.scriptId || !props.variables.length) {
+      const variables = (await loadVariables(privateUrl)).variables;
+      if (mounted) emit('update:variables', variables);
+    }
+  } catch (cause) { error.value = String(cause); }
+  finally { busy.value = false; }
+}
+function update(scope: 'global' | 'private', values: TestVariable[]) {
+  if (scope === 'global') globals.value = values;
+  else emit('update:variables', values);
+  const revision = ++revisions[scope];
+  let variables: TestVariable[];
+  try {
+    variables = validateVariables(values);
+  } catch (cause) {
+    status.value[scope] = cause instanceof Error ? cause.message : String(cause);
+    invalid.value[scope] = true;
+    return;
+  }
+  invalid.value[scope] = false;
+  status.value[scope] = '正在保存…';
+  // 同一作用域串行写入，慢响应不能覆盖后一次编辑；不锁定输入框。
+  void (async () => {
+    try {
+      await saveVariables(scope === 'global' ? '/api/appium-recorder/variables' : privateUrl, variables);
+      if (scope === 'private') emit('saved', props.scriptId, variables);
+      if (revision === revisions[scope]) status.value[scope] = scope === 'private' && !props.scriptId ? '草稿已自动保存' : '已自动保存';
+    } catch (cause) {
+      if (revision === revisions[scope]) {
+        status.value[scope] = cause instanceof Error ? cause.message : String(cause);
+        invalid.value[scope] = true;
+      }
+    }
+  })();
+}
+onMounted(load);
+</script>
+
+<template>
+  <div class="preset-variables">
+    <section class="preset-variables__section" aria-label="全局变量">
+      <div class="preset-variables__title">
+        <h3>全局变量</h3>
+      <el-tooltip placement="bottom-end" effect="light" :show-after="150">
+        <template #content>
+          <div class="preset-variables__help">
+            <strong>如何使用预设变量</strong>
+            <p>全局变量可在所有脚本中使用；私有变量仅在当前脚本中使用，同名时优先使用私有变量。</p>
+            <p>编辑后自动保存，变量值可以为空字符串。新脚本的私有变量先保存为草稿，首次保存脚本时归入该脚本。</p>
+            <p>使用 <code v-pre>{{变量名}}</code> 在输入、判断、定位、日志中引用，例如 <code v-pre>{{account}}</code>。变量名使用字母、数字和下划线，不能以数字开头。</p>
+            <p>敏感值在日志和报告中脱敏，导出时清空敏感值；密码、令牌等名称自动标记为敏感，也可手动勾选。</p>
+            <p>含敏感变量的运行不保存截图或 Appium 原始日志。本地变量非加密存储。</p>
+          </div>
+        </template>
+        <el-button class="preset-variables__help-button" :icon="QuestionFilled" text aria-label="预设变量使用说明" />
+      </el-tooltip>
+      </div>
+        <el-alert v-if="error" :title="error" type="error" :closable="false" /><el-button v-if="error" @click="load">重新加载</el-button>
+        <VariableTable :model-value="globals" :disabled="disabled || busy || !loaded" @update:model-value="update('global', $event)">
+          <span class="preset-variables__status" :class="{ 'is-error': invalid.global }" role="status">{{ status.global }}</span>
+        </VariableTable>
+    </section>
+    <section class="preset-variables__section" aria-label="当前脚本私有变量">
+        <div class="preset-variables__title"><h3>当前脚本私有变量</h3></div>
+        <div class="preset-variables__script">{{ scriptName || '未命名脚本' }}</div>
+        <VariableTable :model-value="variables" :disabled="disabled || busy" @update:model-value="update('private', $event)">
+          <span class="preset-variables__status" :class="{ 'is-error': invalid.private }" role="status">{{ status.private }}</span>
+        </VariableTable>
+    </section>
+  </div>
+</template>
+
+<style scoped>
+.preset-variables { padding: 12px 16px; overflow: auto; }
+.preset-variables__help-button { width: 28px; height: 28px; padding: 0; font-size: 16px; }
+.preset-variables__section { padding: 16px 0 22px; }
+.preset-variables__section:first-child { padding-top: 0; }
+.preset-variables__section + .preset-variables__section { border-top: 1px solid var(--el-border-color-lighter); }
+.preset-variables__title { display: flex; align-items: center; gap: 8px; margin-bottom: 12px; }
+.preset-variables__title h3 { margin: 0; font-size: 14px; font-weight: 600; }
+.preset-variables__script { font-size: 12px; color: var(--el-text-color-secondary); margin: -5px 0 12px; overflow-wrap: anywhere; }
+.preset-variables__help { width: min(340px, calc(100vw - 64px)); font-size: 13px; line-height: 1.7; overflow-wrap: anywhere; }
+.preset-variables__help p { margin: 8px 0 0; }
+.preset-variables__help code { color: var(--el-color-primary); }
+.preset-variables__status { font-size: 12px; color: var(--el-text-color-secondary); overflow-wrap: anywhere; }
+.preset-variables__status.is-error { color: var(--el-color-danger); }
+</style>

package/src/appium-recorder/components/RecordedSteps.vue

@@ -61,6 +61,7 @@ const insertActionGroups: FlowActionGroup[] = [
     actions: [
       { type: 'tap', label: '录制点击' },
       { type: 'input', label: '录制输入' },
+      { type: 'extractVariable', label: '提取变量' },
       { type: 'clearInput', label: '清空输入' },
       { type: 'coordinateTap', label: '点击坐标' },
       { type: 'longPress', label: '长按' },
@@ -93,8 +94,6 @@ const insertActionGroups: FlowActionGroup[] = [
       { type: 'clearIfExists', label: '存在则清空' },
       { type: 'backIfExists', label: '存在则返回' },
       { type: 'waitFor', label: '等待出现' },
-      { type: 'assertExists', label: '断言存在' },
-      { type: 'assertText', label: '断言文本' },
       { type: 'waitDisappear', label: '等待元素消失' },
       { type: 'waitActivity', label: '等待 Activity' },
       { type: 'visualChangeStart', label: '检测画面变化开始节点' },

package/src/appium-recorder/components/ScriptParameterSettings.vue

@@ -0,0 +1,31 @@
+<script setup lang="ts">
+import { Delete, Plus } from '@element-plus/icons-vue';
+import VariableTable from './VariableTable.vue';
+import type { AppiumRecordedStep } from '../types';
+import type { ScriptReturn } from '../variables';
+const props = defineProps<{ step: AppiumRecordedStep; disabled?: boolean }>();
+const emit = defineEmits<{ update: [Partial<AppiumRecordedStep>] }>();
+function update(index: number, patch: Partial<ScriptReturn>) {
+  emit('update', { returns: (props.step.returns || []).map((item, i) => i === index ? { ...item, ...patch } : item) });
+}
+</script>
+
+<template>
+  <el-form-item label="传入子脚本参数"><VariableTable :model-value="step.parameters || []" :disabled="disabled" @update:model-value="emit('update', { parameters: $event })" /></el-form-item>
+  <el-form-item label="返回值映射">
+    <div class="return-mappings">
+      <div v-for="(item, index) in step.returns || []" :key="index" class="return-row">
+        <el-input :model-value="item.name" placeholder="子脚本变量名" aria-label="子脚本返回变量" :disabled="disabled" @update:model-value="update(index, { name: String($event) })" />
+        <span>→</span>
+        <el-input :model-value="item.target" placeholder="当前脚本变量名" aria-label="返回目标变量" :disabled="disabled" @update:model-value="update(index, { target: String($event) })" />
+        <el-tooltip content="删除映射"><el-button :icon="Delete" text :disabled="disabled" aria-label="删除返回映射" @click="emit('update', { returns: step.returns!.filter((_, i) => i !== index) })" /></el-tooltip>
+      </div>
+      <el-button :icon="Plus" :disabled="disabled" size="small" @click="emit('update', { returns: [...(step.returns || []), { name: '', target: '' }] })">新增返回映射</el-button>
+    </div>
+  </el-form-item>
+</template>
+
+<style scoped>
+.return-mappings { width: 100%; }
+.return-row { display: grid; grid-template-columns: minmax(0, 1fr) 15px minmax(0, 1fr) 30px; gap: 5px; align-items: center; margin-bottom: 8px; }
+</style>

package/src/appium-recorder/components/VariableExtractionSettings.vue

@@ -0,0 +1,17 @@
+<script setup lang="ts">
+import type { AppiumRecordedStep } from '../types';
+import { sensitiveVariableName, type VariableExtraction } from '../variables';
+const props = defineProps<{ step: AppiumRecordedStep; disabled?: boolean }>();
+const emit = defineEmits<{ update: [Partial<AppiumRecordedStep>] }>();
+function update(patch: Partial<VariableExtraction>) {
+  emit('update', { extractVariable: { name: '', attribute: 'text', ...props.step.extractVariable, ...patch } });
+}
+</script>
+
+<template>
+  <el-form-item label="保存到当前脚本变量"><el-input :model-value="step.extractVariable?.name || ''" :disabled="disabled" aria-label="提取变量名" @update:model-value="update({ name: String($event) })" /></el-form-item>
+  <el-form-item label="组件属性"><el-select :model-value="step.extractVariable?.attribute || 'text'" :disabled="disabled" filterable allow-create default-first-option aria-label="提取组件属性" @update:model-value="update({ attribute: String($event) })">
+    <el-option v-for="name in ['text', 'content-desc', 'checked', 'selected', 'enabled', 'resource-id', 'class']" :key="name" :label="name" :value="name" />
+  </el-select></el-form-item>
+  <el-form-item label="敏感变量"><el-checkbox :model-value="step.extractVariable?.sensitive || sensitiveVariableName(step.extractVariable?.name || '')" :disabled="disabled || sensitiveVariableName(step.extractVariable?.name || '')" @update:model-value="update({ sensitive: Boolean($event) })" /></el-form-item>
+</template>

package/src/appium-recorder/components/VariableTable.vue

@@ -0,0 +1,43 @@
+<script setup lang="ts">
+import { Delete, Plus, CopyDocument } from '@element-plus/icons-vue';
+import { ElMessage } from 'element-plus';
+import { sensitiveVariableName, type TestVariable } from '../variables';
+const props = defineProps<{ modelValue: TestVariable[]; disabled?: boolean }>();
+const emit = defineEmits<{ 'update:modelValue': [TestVariable[]] }>();
+function update(index: number, patch: Partial<TestVariable>) {
+  emit('update:modelValue', props.modelValue.map((item, i) => i === index ? { ...item, ...patch } : item));
+}
+async function copy(name: string) {
+  try { await navigator.clipboard.writeText(`{{${name}}}`); ElMessage.success('已复制变量引用'); }
+  catch { ElMessage.error('复制失败'); }
+}
+</script>
+
+<template>
+  <div class="variable-table">
+    <el-table :data="modelValue" empty-text="暂无变量" size="small">
+      <el-table-column label="变量名" min-width="110"><template #default="{ row, $index }"><el-input :model-value="row.name" :disabled="disabled" aria-label="变量名" @update:model-value="update($index, { name: String($event) })" /></template></el-table-column>
+      <el-table-column label="值" min-width="125"><template #default="{ row, $index }"><el-input :model-value="row.value" :type="row.sensitive || sensitiveVariableName(row.name) ? 'password' : 'text'" :show-password="row.sensitive || sensitiveVariableName(row.name)" :disabled="disabled" aria-label="变量值" @update:model-value="update($index, { value: String($event) })" /></template></el-table-column>
+      <el-table-column label="敏感" width="65"><template #default="{ row, $index }"><el-checkbox :model-value="row.sensitive || sensitiveVariableName(row.name)" :disabled="disabled || sensitiveVariableName(row.name)" aria-label="敏感变量" @update:model-value="update($index, { sensitive: Boolean($event) })" /></template></el-table-column>
+      <el-table-column label="操作" width="76"><template #default="{ row, $index }"><div class="variable-table__actions">
+        <el-tooltip content="复制引用"><el-button :icon="CopyDocument" text size="small" :disabled="!row.name" aria-label="复制变量引用" @click="copy(row.name)" /></el-tooltip>
+        <el-tooltip content="删除变量"><el-button :icon="Delete" text size="small" :disabled="disabled" aria-label="删除变量" @click="emit('update:modelValue', modelValue.filter((_, i) => i !== $index))" /></el-tooltip>
+      </div></template></el-table-column>
+    </el-table>
+    <div class="variable-table__footer">
+      <el-button :icon="Plus" :disabled="disabled" size="small" @click="emit('update:modelValue', [...modelValue, { name: '', value: '', sensitive: false }])">新增变量</el-button>
+      <slot />
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.variable-table { min-width: 0; }
+.variable-table__footer { display: flex; align-items: center; justify-content: space-between; gap: 8px; flex-wrap: wrap; margin-top: 12px; }
+.variable-table__actions { display: flex; align-items: center; gap: 2px; }
+.variable-table__actions :deep(.el-button) { width: 26px; height: 28px; padding: 0; }
+.variable-table :deep(.el-table th.el-table__cell) { background: var(--el-fill-color-light); color: var(--el-text-color-secondary); font-size: 12px; padding: 7px 0; }
+.variable-table :deep(.el-table td.el-table__cell) { padding: 8px 0; }
+.variable-table :deep(.el-table .cell) { padding: 0 8px; }
+.variable-table :deep(.el-button + .el-button) { margin-left: 0; }
+</style>