android-midscene-automation 0.1.37 → 0.1.39

package/src/appium-recorder/AppiumPage.vue

@@ -1,8 +1,9 @@
 <script setup lang="ts">
 import { computed, h, onMounted, onUnmounted, provide, reactive, shallowRef, watch } from 'vue';
 import { flowBackgroundKey, normalizeFlowBackground } from './flow-appearance';
+import { DEFAULT_NODE_TIMEOUT_MS } from './node-timeout';
 import { ElForm, ElFormItem, ElInputNumber, ElMessage, ElMessageBox, ElOption, ElSelect } from 'element-plus';
-import { Check, CircleClose, CopyDocument, Delete, Document, Download, Edit, Plus, Refresh, Upload, VideoPlay, View, Clock } from '@element-plus/icons-vue';
+import { ArrowDown, Check, CircleClose, CopyDocument, Delete, Document, Download, Edit, Plus, Refresh, Upload, VideoPlay, View, Clock } from '@element-plus/icons-vue';
 import RunHistoryDialog from './RunHistoryDialog.vue';
 import type { AndroidDevice, AppPreset, DeviceAction } from '../types';
 import DevicePreviewPanel from '../components/device/DevicePreviewPanel.vue';
@@ -42,8 +43,6 @@ import NewScriptDialog from './components/NewScriptDialog.vue';
 import VisualChangeDialog from './components/VisualChangeDialog.vue';
 import ImageCheckDialog from './components/ImageCheckDialog.vue';
 import { createImageCheckConfig, validateImageCheck, type ImageCheckConfig } from './image-check';
-import AiRecognitionTestDialog from './components/AiRecognitionTestDialog.vue';
-import { validateAiRecognitionPrompt } from './ai-recognition';
 import {
   createFlowClipboard,
   pasteFlowClipboard,
@@ -95,49 +94,9 @@ const workspaceRef = shallowRef<InstanceType<typeof RecorderWorkspace>>();
 const historyScript = shallowRef<{ id: string; name: string } | null>(null);
 const AUTO_TREE_REFRESH_INTERVAL_MS = 1800;
 
-const insertableRecorderActions: RecorderAction[] = [
-  'extractVariable',
-  'delay',
-  'tap',
-  'input',
-  'waitFor',
-  'tapIfExists',
-  'inputIfExists',
-  'clearIfExists',
-  'backIfExists',
-  'popupCondition',
-  'checkboxState',
-  'checkedState',
-  'radioButtonState',
-  'aiRecognition',
-  'imageCheck',
-  'textClick',
-  'runScript',
-  'keyBack',
-  'keyHome',
-  'keyRecent',
-  'keyPower',
-  'waitActivity',
-  'swipe',
-  'clearInput',
-  'coordinateTap',
-  'launchApp',
-  'stopApp',
-  'openGallery',
-  'endFlow',
-  'loop',
-  'breakLoop',
-  'clearAppData',
-  'waitDisappear',
-  'longPress',
-  'pinch',
-  'noop',
-  'log',
-  'visualChangeStart',
-  'visualChangeEnd',
-];
 const readonlyFlowActionGroups: FlowActionGroup[] = [];
 const readonlyFlowSelectedIndexes: number[] = [];
+const recordReplayVideo = shallowRef(false);
 
 const props = defineProps<{
   aiRecognitionModelConfigured?: boolean;
@@ -177,7 +136,6 @@ const newScriptRevision = shallowRef(0);
 const storedWorkbenchTab = window.localStorage.getItem(WORKBENCH_TAB_STORAGE_KEY);
 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);
 const rawXml = shallowRef('');
 const currentActivity = shallowRef('');
@@ -294,7 +252,7 @@ const recordingBusy = computed(() => (
   || resolvingNavigation.value
   || Boolean(pendingNavigation.value)
 ));
-const recordingLocked = computed(() => recordingBusy.value || scriptActivityMismatch.value);
+const recordingLocked = computed(() => recordingBusy.value || replaying.value);
 const newScriptDisabled = computed(() => saving.value || replaying.value || recordingBusy.value || launchingApp.value || importingScript.value);
 const overlayBounds = computed(() => flattenNodes(tree.value).flatMap((node) => (
   node.bounds ? [{ id: node.id, ...node.bounds }] : []
@@ -510,7 +468,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 === 'waitFor' ? 10000 : undefined,
+    timeoutMs: type === 'waitFor' ? DEFAULT_NODE_TIMEOUT_MS : undefined,
     pageBefore: currentPageSnapshot(node),
     snapshot: {
       text: node.text,
@@ -614,7 +572,7 @@ function createWaitActivityStep(activity: string): AppiumRecordedStep {
     type: 'waitActivity',
     label: `等待 Activity ${activity}`,
     value: activity,
-    timeoutMs: 10000,
+    timeoutMs: DEFAULT_NODE_TIMEOUT_MS,
   };
 }
 
@@ -928,11 +886,6 @@ async function refreshTree() {
 
 async function executeFlowStep(index: number) {
   const step = steps.value[index];
-  if (step?.type === 'aiRecognition') {
-    if (replaying.value || recordingBusy.value) { ElMessage.warning('设备正在执行操作，请稍后测试'); return; }
-    aiRecognitionTestStep.value = { ...step };
-    return;
-  }
   if (!step || (step.type !== 'launchApp' && step.type !== 'clearAppData')) return;
   if (launchingApp.value) return;
   if (!selectedDeviceId.value) {
@@ -976,7 +929,7 @@ async function executeFlowStep(index: number) {
     } else if (scriptActivityMismatch.value) {
       ElMessage.warning(`App 已启动，当前页面仍为 ${currentActivity.value || '-'}`);
     } else {
-      ElMessage.success('已进入脚本绑定页面，编辑锁定已解除');
+      ElMessage.success('已进入脚本绑定页面');
     }
   } catch (error) {
     ElMessage.error(error instanceof Error ? error.message : 'App 操作失败');
@@ -1431,25 +1384,12 @@ async function addAction(
     return;
   }
   if (action === 'aiRecognition') {
-    const input = await ElMessageBox.prompt('识别内容', '添加 AI 识别', {
-      inputType: 'textarea',
-      inputPlaceholder: '例如：检查当前画面有没有显示黑屏',
-      inputValidator: (value) => {
-        try { validateAiRecognitionPrompt(value); return true; }
-        catch (error) { return error instanceof Error ? error.message : '识别内容无效'; }
-      },
-      confirmButtonText: '添加', cancelButtonText: '取消',
-    }).catch(() => null);
-    if (!input) return;
-    return insertStep({
-      id: createStepId(), type: 'aiRecognition', label: 'AI 识别',
-      value: validateAiRecognitionPrompt(input.value), timeoutMs: 60000,
-      flow: { nodeKind: 'condition' },
-    }, index, branchTarget);
+    ElMessage.warning('AI 识别操作已移除，请使用图像判断或原生组件判断');
+    return;
   }
   if (action === 'textClick') {
     const step = reactive<AppiumRecordedStep>({
-      id: createStepId(), type: 'textClick', label: '文字点击', value: '', timeoutMs: 10000,
+      id: createStepId(), type: 'textClick', label: '文字点击', value: '', timeoutMs: DEFAULT_NODE_TIMEOUT_MS,
       flow: { nodeKind: 'condition', textMatch: 'exact' },
     });
     const result = await ElMessageBox({
@@ -1617,7 +1557,7 @@ async function addAction(
       ElMessage.warning(`请选择原生 ${controlName} 元素，当前选中：${node.className || '未知类型'}`);
       return;
     }
-    const step = createNodeActionStep(action, action === 'checkedState' ? '判断勾选' : `判断 ${controlName} 状态`, node, { timeoutMs: 2000 });
+    const step = createNodeActionStep(action, action === 'checkedState' ? '判断勾选' : `判断 ${controlName} 状态`, node, { timeoutMs: DEFAULT_NODE_TIMEOUT_MS });
     if ((!step.selector?.value || step.selector.strategy === 'bounds') && node.xpath) {
       step.selector = { strategy: 'xpath', value: node.xpath };
       step.contextSelector = undefined;
@@ -1633,13 +1573,13 @@ async function addAction(
     return insertStep(step, index, branchTarget);
   }
   if (action === 'popupCondition') {
-    const step = createNodeActionStep('assertExists', '判断存在', node, { timeoutMs: 2000 });
+    const step = createNodeActionStep('assertExists', '判断存在', node, { timeoutMs: DEFAULT_NODE_TIMEOUT_MS });
     const inserted = insertStep({ ...step, flow: { nodeKind: 'condition' } }, index, branchTarget);
     ElMessage.success('已添加判断节点，请在节点面板配置是/否分支');
     return inserted;
   }
   if (action === 'tapIfExists') {
-    return insertStep(createNodeActionStep('tapIfExists', '存在则点击', node, { timeoutMs: 2000 }), index, branchTarget);
+    return insertStep(createNodeActionStep('tapIfExists', '存在则点击', node, { timeoutMs: DEFAULT_NODE_TIMEOUT_MS }), index, branchTarget);
   }
   if (action === 'inputIfExists') {
     const input = await ElMessageBox.prompt('', '存在则输入', {
@@ -1650,16 +1590,16 @@ async function addAction(
     }).catch(() => null);
     if (!input) return;
     return insertStep(
-      createNodeActionStep('inputIfExists', '存在则输入', node, { timeoutMs: 2000, value: input.value }),
+      createNodeActionStep('inputIfExists', '存在则输入', node, { timeoutMs: DEFAULT_NODE_TIMEOUT_MS, value: input.value }),
       index,
       branchTarget,
     );
   }
   if (action === 'clearIfExists') {
-    return insertStep(createNodeActionStep('clearIfExists', '存在则清空', node, { timeoutMs: 2000 }), index, branchTarget);
+    return insertStep(createNodeActionStep('clearIfExists', '存在则清空', node, { timeoutMs: DEFAULT_NODE_TIMEOUT_MS }), index, branchTarget);
   }
   if (action === 'backIfExists') {
-    return insertStep(createNodeActionStep('backIfExists', '存在则返回', node, { timeoutMs: 2000 }), index, branchTarget);
+    return insertStep(createNodeActionStep('backIfExists', '存在则返回', node, { timeoutMs: DEFAULT_NODE_TIMEOUT_MS }), index, branchTarget);
   }
   if (action === 'clearInput') {
     return insertStep(createNodeActionStep('clearInput', '清空输入', node), index, branchTarget);
@@ -1706,7 +1646,7 @@ async function addAction(
     return insertStep({ ...step }, index, branchTarget);
   }
   if (action === 'waitDisappear') {
-    return insertStep(createNodeActionStep('waitDisappear', '等待元素消失', node, { timeoutMs: 10000 }), index, branchTarget);
+    return insertStep(createNodeActionStep('waitDisappear', '等待元素消失', node, { timeoutMs: DEFAULT_NODE_TIMEOUT_MS }), index, branchTarget);
   }
 }
 
@@ -2116,7 +2056,7 @@ async function replayScript() {
   try {
     await pauseAutoTreeRefresh();
     const result = await replayAppiumScript(
-      { id: selectedScript.value.id, deviceId: activeReplayDeviceId.value },
+      { id: selectedScript.value.id, deviceId: activeReplayDeviceId.value, recordVideo: recordReplayVideo.value },
       (line) => {
         replayOutput.value += `${replayOutput.value ? '\n' : ''}${line}`;
       },
@@ -2207,15 +2147,23 @@ watch(
       </el-select>
       <el-button :icon="Plus" :disabled="newScriptDisabled || newScriptDialogVisible" @click="requestNewScript">新建</el-button>
       <el-button :icon="Check" :loading="saving" @click="saveScript">保存</el-button>
-      <el-button
-        type="primary"
-        :icon="VideoPlay"
-        :loading="replaying"
-        :disabled="!selectedScript"
-        @click="replayScript"
-      >
-        回放
-      </el-button>
+      <el-button-group class="replay-button-group">
+        <el-button
+          type="primary"
+          :icon="VideoPlay"
+          :loading="replaying"
+          :disabled="!selectedScript"
+          @click="replayScript"
+        >
+          回放
+        </el-button>
+        <el-popover trigger="click" placement="bottom" :width="260">
+          <template #reference><el-button type="primary" :icon="ArrowDown" :disabled="replaying" aria-label="回放设置" title="回放设置" class="replay-settings-toggle" /></template>
+          <el-tooltip content="使用内置服务端后台录制，无需安装 scrcpy 或 FFmpeg。含敏感变量的运行不录制；分享 HTML 报告时需同时携带 MP4。" placement="bottom" :show-after="300">
+            <el-checkbox v-model="recordReplayVideo" :disabled="replaying">录制回放视频</el-checkbox>
+          </el-tooltip>
+        </el-popover>
+      </el-button-group>
       <el-button
         v-if="replaying"
         type="danger"
@@ -2287,7 +2235,7 @@ watch(
                   v-if="scriptActivityMismatch"
                   class="appium-activity-summary"
                 >
-                  <summary>当前页面与脚本不一致，部分录制操作不可用</summary>
+                  <summary>当前页面与脚本绑定的 Activity 不一致</summary>
                   <div class="appium-activity-lock-alert__details">
                     <div>
                       <strong>脚本绑定</strong>
@@ -2297,7 +2245,7 @@ watch(
                       <strong>当前 Activity</strong>
                       <code>{{ currentActivity || '正在获取' }}</code>
                     </div>
-                    <p>请在录制流程中添加或执行“启动 APP”节点；Activity 匹配后会自动解除编辑锁定。</p>
+                    <p>不影响脚本编辑；如需录制当前页面的组件操作，请确认设备页面及所选组件。</p>
                   </div>
                 </details>
               </section>
@@ -2309,9 +2257,8 @@ watch(
                   :steps="steps"
                   :clipboard-count="flowClipboardCount"
                   :disabled="recordingLocked"
-                  :remove-disabled="recordingBusy"
+                  :remove-disabled="recordingLocked"
                   :merge-disabled="recordingBusy || replaying || saving"
-                  :allowed-locked-actions="scriptActivityMismatch && !recordingBusy ? insertableRecorderActions : []"
                   :launching-step-id="executingAppStepId"
                   @remove="removeStep"
                   @copy="copyFlowNodes"
@@ -2424,16 +2371,11 @@ watch(
       @cancel="newScriptDialogVisible = false"
     />
 
-    <AiRecognitionTestDialog
-      v-if="aiRecognitionTestStep"
-      :step="aiRecognitionTestStep"
-      :device-id="selectedDeviceId"
-      :model-configured="Boolean(aiRecognitionModelConfigured)"
-      @close="aiRecognitionTestStep = null"
-    />
 
     <ImageCheckDialog
       v-if="imageCheckDraft?.imageCheck"
+      :timeout-branch="imageCheckDraft.timeoutBranch"
+      @timeout-branch="imageCheckDraft = { ...imageCheckDraft!, timeoutBranch: $event }"
       :config="imageCheckDraft.imageCheck" :device-id="selectedDeviceId"
       :has-element="Boolean(selectedNode?.bounds)" :editing="imageCheckEditing" :picking="imageCheckPicking"
       @update="updateImageCheck" @close="imageCheckDraft = null; imageCheckPicking = false"
@@ -2624,4 +2566,6 @@ watch(
 .appium-workbench__flow :deep(.appium-recorded-steps-panel) { display: flex; flex-direction: column; flex: 1; min-height: 0; }
 .appium-workbench__flow :deep(.appium-flow-toolbar) { flex: none; margin-bottom: 8px; }
 .appium-workbench__flow :deep(.appium-flow-canvas--vue:not(.appium-flow-canvas--dialog)) { flex: 1; height: auto; min-height: 120px; }
+.replay-button-group { display: inline-flex; flex-shrink: 0; }
+.replay-settings-toggle { padding-inline: 8px; }
 </style>

package/src/appium-recorder/RunHistoryDialog.vue

@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { computed, onMounted, ref } from 'vue';
-import { Delete, Refresh } from '@element-plus/icons-vue';
+import { Delete, Refresh, VideoPlay } from '@element-plus/icons-vue';
 import { ElMessage, ElMessageBox } from 'element-plus';
 import { historyStatistics, type RunSummary, type RunDetail } from './run-history';
 
@@ -16,6 +16,7 @@ const device = ref('');
 const error = ref('');
 const nodeKey = ref('');
 const logQuery = ref('');
+const videoRun = ref<RunSummary>();
 const base = `/api/appium-recorder/scripts/${encodeURIComponent(props.scriptId)}/history`;
 const labels = { passed: '通过', failed: '失败', stopped: '已终止' };
 const versions = computed(() => [...new Set(runs.value.map(run => run.appVersion || '未知'))]);
@@ -49,7 +50,7 @@ async function compare() {
   finally { comparing.value = false; }
 }
 async function remove() {
-  try { await ElMessageBox.confirm(`删除选中的 ${selected.value.length} 条历史及截图、日志快照？原始报告文件不受影响。`, '删除历史结果', { type: 'warning', confirmButtonText: '确定', cancelButtonText: '取消' }); }
+  try { await ElMessageBox.confirm(`删除选中的 ${selected.value.length} 条历史及截图、日志快照和回放视频？原始报告将无法再播放已删除的视频。`, '删除历史结果', { type: 'warning', confirmButtonText: '确定', cancelButtonText: '取消' }); }
   catch { return; }
   loading.value = true;
   try {
@@ -98,6 +99,7 @@ onMounted(load);
           <el-table-column prop="deviceId" label="设备" min-width="140" />
           <el-table-column label="结果" width="85"><template #default="{ row }">{{ labels[row.status as keyof typeof labels] }}</template></el-table-column>
           <el-table-column label="耗时" width="100"><template #default="{ row }">{{ seconds(row.durationMs) }}</template></el-table-column>
+          <el-table-column label="录像" width="70"><template #default="{ row }"><el-tooltip v-if="row.video" content="播放回放视频"><el-button :icon="VideoPlay" aria-label="播放回放视频" @click="videoRun = row" /></el-tooltip></template></el-table-column>
         </el-table>
         <h3>失败节点分布</h3>
         <el-table :data="stats.failures" max-height="220" empty-text="暂无节点失败记录">
@@ -129,6 +131,9 @@ onMounted(load);
         </div>
       </section>
     </div>
+    <el-dialog :model-value="Boolean(videoRun)" title="回放视频" width="min(800px, 90vw)" align-center append-to-body destroy-on-close @close="videoRun = undefined">
+      <video v-if="videoRun" :src="`${base}/${encodeURIComponent(videoRun.id)}/video`" controls preload="metadata" style="width:100%;max-height:70vh" />
+    </el-dialog>
   </el-dialog>
 </template>
 

package/src/appium-recorder/action-descriptions.ts

@@ -26,7 +26,7 @@ export const actionDescriptions: Record<InsertAction, string> = {
   checkboxState: '读取原生 Checkbox 的 checked 状态，按 true/false 分支执行。',
   radioButtonState: '读取原生 RadioButton 的 checked 状态，按 true/false 分支执行。',
   checkedState: '读取 Checkbox、RadioButton 或 Switch 的真实勾选状态，按 true/false 分支执行。不支持仅用图片表示状态的普通 ImageView。',
-  aiRecognition: '用配置的模型判断当前画面，返回 true/false。适合语义、提示含义和复杂画面判断；可直接读取的组件属性优先使用原生判断。需要配置 AI 节点模型。',
+  aiRecognition: '此操作已移除，请使用图像判断或原生组件判断。',
   textClick: '在组件树中按指定文字精确或模糊匹配并点击，进入匹配到文字或未匹配到文字分支。不识别图片或自绘画面中的文字。',
   tapIfExists: '找到目标组件时点击，未找到则跳过并继续后续流程。',
   inputIfExists: '找到目标输入组件时写入文字，未找到则跳过。支持 {{变量名}} 引用。',

package/src/appium-recorder/api.ts

@@ -1,6 +1,5 @@
 import { APP_BASE } from '../api';
 import type { AppiumRecordedScript, AppiumRecordedStep } from './types';
-import type { AiRecognitionResult } from './ai-recognition';
 import type { TestVariable } from './variables';
 import type { AppiumVisualChangeRegion } from './types';
 
@@ -73,13 +72,6 @@ export async function getAppiumScripts() {
   return readJson<{ scripts: AppiumRecordedScript[] }>(response);
 }
 
-export async function testAiRecognition(input: { deviceId: string; prompt: string; timeoutMs?: number }, signal?: AbortSignal) {
-  const response = await fetch(`${APP_BASE}/api/appium-recorder/ai-recognition/test`, {
-    method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(input), signal,
-  });
-  return readJson<AiRecognitionResult & { imageBase64: string }>(response);
-}
-
 export function saveAppiumScript(input: {
   variables?: import('./variables').TestVariable[];
   id?: string;
@@ -115,6 +107,7 @@ export async function downloadAppiumScript(id: string) {
 }
 
 type ReplayResult = {
+  videoPath?: string;
   success: boolean;
   stopped?: boolean;
   output: string;
@@ -131,7 +124,7 @@ type ReplayStreamEvent =
   | { type: 'error'; message: string };
 
 export async function replayAppiumScript(
-  input: { id: string; deviceId?: string; parameters?: import('./variables').TestVariable[] },
+  input: { id: string; deviceId?: string; recordVideo?: boolean; parameters?: import('./variables').TestVariable[] },
   onOutput?: (line: string) => void,
 ) {
   const response = await fetch(`${APP_BASE}/api/appium-recorder/scripts/${encodeURIComponent(input.id)}/replay`, {
@@ -140,7 +133,7 @@ export async function replayAppiumScript(
       'Content-Type': 'application/json',
       Accept: 'application/x-ndjson',
     },
-    body: JSON.stringify({ deviceId: input.deviceId, parameters: input.parameters }),
+    body: JSON.stringify({ deviceId: input.deviceId, parameters: input.parameters, recordVideo: input.recordVideo }),
   });
   if (!response.ok || !response.body) return readJson<ReplayResult>(response);
 

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

@@ -0,0 +1,23 @@
+<script setup lang="ts">
+import type { AppiumRecordedStep } from '../types';
+import { flowBranchLabel } from '../flow-labels';
+defineProps<{ step: AppiumRecordedStep; disabled?: boolean }>();
+defineEmits<{ update: [value: NonNullable<AppiumRecordedStep['timeoutBranch']>] }>();
+</script>
+
+<template>
+  <el-form-item label="超时后处理">
+    <el-select class="branch-timeout-select" size="small" popper-class="branch-timeout-popper" :model-value="step.timeoutBranch || 'stop'" :disabled="disabled" @update:model-value="$emit('update', $event)">
+      <el-option label="未配置分支（超时终止）" value="stop" />
+      <el-option :label="`进入左侧分支（${flowBranchLabel(step, 'yes')}）`" value="yes" />
+      <el-option :label="`进入右侧分支（${flowBranchLabel(step, 'no')}）`" value="no" />
+    </el-select>
+  </el-form-item>
+</template>
+
+<style>
+.el-select.branch-timeout-select { width: 240px; max-width: 100%; flex: none; }
+.branch-timeout-popper .el-select-dropdown__list { padding: 4px 0; }
+.branch-timeout-popper .el-select-dropdown__item { height: 28px; line-height: 28px; padding: 0 12px; font-size: 12px; }
+.branch-timeout-popper .el-select-dropdown__item.is-selected { color: var(--el-color-primary); }
+</style>

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

@@ -2,7 +2,6 @@
 import { computed, nextTick, onBeforeUnmount, onMounted, shallowRef, watch } from 'vue';
 import { Handle, Position } from '@vue-flow/core';
 import { CopyDocument, Delete, Edit, Plus, VideoPlay, View, WarningFilled, Connection, RefreshLeft } from '@element-plus/icons-vue';
-import { AI_MODEL_CONFIG_HINT } from '../ai-recognition';
 import type { AppiumRecordedStep } from '../types';
 import {
   PASTE_COMMAND,
@@ -176,8 +175,8 @@ watch(() => props.data, () => {
         @click="handleStepClick"
       >
         <span class="appium-flow-step-card__content">
-          <el-tooltip v-if="data.missingAiModel" :content="AI_MODEL_CONFIG_HINT" placement="top">
-            <el-icon class="appium-ai-model-warning" color="var(--el-color-danger)" role="img" aria-label="AI 识别模型未配置" tabindex="0">
+          <el-tooltip v-if="data.missingAiModel" content="AI 识别操作已移除，请删除此节点并改用图像判断或原生组件判断" placement="top">
+            <el-icon class="appium-ai-model-warning" color="var(--el-color-danger)" role="img" aria-label="AI 识别操作已移除" tabindex="0">
               <WarningFilled />
             </el-icon>
           </el-tooltip>

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

@@ -5,6 +5,8 @@ import { normalizeVisualChangeConfig } from '../visual-change';
 import { longPressMode } from '../long-press';
 import { defaultFlowKind, isBooleanCondition } from '../flow-labels';
 import TextClickSettings from './TextClickSettings.vue';
+import BranchTimeoutSettings from './BranchTimeoutSettings.vue';
+import { DEFAULT_NODE_TIMEOUT_MS } from '../node-timeout';
 import LongPressSettings from './LongPressSettings.vue';
 import StageLogSettings from './StageLogSettings.vue';
 import LoopSettings from './LoopSettings.vue';
@@ -116,8 +118,7 @@ function patchVisualRegion(key: keyof VisualChangeConfig['region'], value: unkno
 }
 
 function patchTimeout(value: unknown) {
-  const timeout = Math.max(0, toInteger(value, props.step.timeoutMs || 0));
-  patchStep({ timeoutMs: timeout || undefined });
+  patchStep({ timeoutMs: value == null || value === '' ? undefined : Math.max(0, toInteger(value, DEFAULT_NODE_TIMEOUT_MS)) });
 }
 
 const showSelector = computed(() => props.step.type !== 'loop' && props.step.selector && (
@@ -152,21 +153,10 @@ function patchSelector(patch: Partial<AppiumSelector>) {
           @update:model-value="patchStep({ note: String($event) || undefined })"
         />
       </el-form-item>
-      <div class="appium-flow-editor__grid">
-        <el-form-item label="节点类型">
-          <el-select
-            :model-value="defaultKind()"
-            :disabled="disabled || isBooleanCondition(step) || step.type === 'stopApp' || 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" />
-            <el-option label="判断" value="condition" />
-            <el-option label="校验" value="assertion" />
-          </el-select>
-        </el-form-item>
+      <div>
         <el-form-item v-if="!['longPress', 'stopApp', 'log', 'openGallery', 'endFlow', 'loop', 'breakLoop'].includes(step.type)" label="超时时间 ms">
           <el-input-number
-            :model-value="step.timeoutMs || undefined"
+            :model-value="step.timeoutMs ?? (step.type === 'delay' ? 1000 : DEFAULT_NODE_TIMEOUT_MS)"
             :disabled="disabled"
             :min="0"
             :max="999999"
@@ -174,6 +164,7 @@ function patchSelector(patch: Partial<AppiumSelector>) {
             @update:model-value="patchTimeout($event)"
           />
         </el-form-item>
+        <BranchTimeoutSettings v-if="defaultKind() === 'condition'" :step="step" :disabled="disabled" @update="patchStep({ timeoutBranch: $event })" />
       </div>
       <LongPressSettings v-if="step.type === 'longPress'" :step="step" :disabled="disabled" @update="patchStep" />
       <el-form-item v-if="['waitActivity', 'launchApp', 'stopApp', 'clearAppData'].includes(step.type)" :label="step.type === 'waitActivity' ? '目标 Activity' : '目标 APP 包名'">
@@ -206,12 +197,6 @@ function patchSelector(patch: Partial<AppiumSelector>) {
       <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" />
-      <el-form-item v-if="step.type === 'aiRecognition'" label="识别内容">
-        <el-input
-          :model-value="step.value || ''" type="textarea" :rows="3" maxlength="4000"
-          :disabled="disabled" @update:model-value="patchStep({ value: String($event) })"
-        />
-      </el-form-item>
       <el-form-item
         v-if="step.type === 'input' || step.type === 'inputIfExists' || step.type === 'assertText'"
         label="文本内容"

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

@@ -4,9 +4,11 @@ import { ElMessage } from 'element-plus';
 import { Aim, Camera, Upload, QuestionFilled } from '@element-plus/icons-vue';
 import { IMAGE_CHECK_MODES, validateImageCheck, imageTemplateSize, imageTemplateRegionIssue, expandedImageTemplateRegion, type ImageCheckConfig } from '../image-check';
 import { captureImageCheckRegion } from '../api';
+import BranchTimeoutSettings from './BranchTimeoutSettings.vue';
+import type { AppiumRecordedStep } from '../types';
 
-const props = defineProps<{ config: ImageCheckConfig; deviceId: string; hasElement: boolean; editing: boolean; picking: boolean }>();
-const emit = defineEmits<{ update: [config: ImageCheckConfig]; close: []; confirm: []; pick: []; useElement: [] }>();
+const props = defineProps<{ config: ImageCheckConfig; deviceId: string; hasElement: boolean; editing: boolean; picking: boolean; timeoutBranch?: AppiumRecordedStep['timeoutBranch'] }>();
+const emit = defineEmits<{ update: [config: ImageCheckConfig]; timeoutBranch: [value: NonNullable<AppiumRecordedStep['timeoutBranch']>]; close: []; confirm: []; pick: []; useElement: [] }>();
 const busy = ref(false);
 const regionIssue = computed(() => imageTemplateRegionIssue(props.config));
 const expandedRegion = computed(() => expandedImageTemplateRegion(props.config));
@@ -16,7 +18,7 @@ const slots = computed(() => props.config.mode === 'state'
   ? [{ key: 'template' as const, label: '选中模板' }, { key: 'negativeTemplate' as const, label: '未选中模板' }]
   : props.config.mode === 'template' ? [{ key: 'template' as const, label: '模板' }] : []);
 const numericFields = computed(() => [
-  ...(['template', 'state'].includes(props.config.mode) ? [{ key: 'threshold' as const, label: '匹配得分阈值', min: 0.01, max: 1, step: 0.01 }] : []),
+  ...(['template', 'state'].includes(props.config.mode) ? [{ key: 'threshold' as const, label: '匹配严格度 (%)', min: 1, max: 100, step: 1 }] : []),
   ...(props.config.mode === 'state' ? [{ key: 'minScoreGap' as const, label: '两种状态最小得分差', min: 0.001, max: 1, step: 0.01 }] : []),
   ...(['black', 'color', 'change'].includes(props.config.mode) ? [
     { key: 'tolerance' as const, label: props.config.mode === 'black' ? '暗色亮度阈值 (0–255)' : 'RGB 通道容差 (0–255)', min: 0, max: 255, step: 1 },
@@ -108,10 +110,10 @@ async function upload(event: Event) {
       <el-alert v-if="regionIssue" :title="regionIssue" type="warning" show-icon :closable="false" class="image-check-region-warning">
         <el-button v-if="expandedRegion" size="small" @click="patch({ region: expandedRegion })">扩大检测区域</el-button>
       </el-alert>
-      <el-form-item v-if="config.mode === 'template' || config.mode === 'change'" label="判断条件">
+      <el-form-item v-if="config.mode === 'template' || config.mode === 'change'" :label="config.mode === 'template' ? '预期匹配结果' : '判断条件'">
         <el-radio-group :model-value="config.expectation" @update:model-value="patch({ expectation: $event as 'present' | 'absent' })">
-          <el-radio-button value="present">{{ config.mode === 'template' ? '图片存在' : '画面有变化' }}</el-radio-button>
-          <el-radio-button value="absent">{{ config.mode === 'template' ? '图片不存在' : '持续无明显变化' }}</el-radio-button>
+          <el-radio-button value="present">{{ config.mode === 'template' ? '匹配到模板' : '画面有变化' }}</el-radio-button>
+          <el-radio-button value="absent">{{ config.mode === 'template' ? '未匹配到模板' : '持续无明显变化' }}</el-radio-button>
         </el-radio-group>
       </el-form-item>
       <el-form-item v-if="config.mode === 'color'" label="目标颜色 #RRGGBB">
@@ -119,10 +121,29 @@ async function upload(event: Event) {
         <el-input :model-value="config.color" maxlength="7" @update:model-value="patch({ color: $event })" />
       </el-form-item>
       <div class="image-check-grid">
-        <el-form-item v-for="field in numericFields" :key="field.key" :label="field.label">
-          <el-input-number :model-value="config[field.key]" :min="field.min" :max="field.max" :step="field.step" controls-position="right" @update:model-value="$event !== undefined && patch({ [field.key]: $event })" />
-        </el-form-item>
+        <template v-for="field in numericFields" :key="field.key">
+          <el-form-item :label="field.label">
+            <template v-if="field.key === 'threshold'" #label>
+              <span class="image-check-threshold-label">{{ field.label }}
+                <el-tooltip effect="dark" placement="top" :show-after="200">
+                  <template #content>
+                    <div class="image-check-threshold-help">
+                      当前画面与参考模板的匹配得分达到此值，才算匹配成功，得分不是正确概率。
+                      数值越高越严格，可能漏掉有细微变化的目标；越低越宽松，可能误认相似图案。
+                      例如设为 98%，需要匹配得分达到 98%。设为 100% 时，极细微的像素差异也会判为不匹配。图片状态判断还会结合两种模板的最小得分差，得分太接近时无法判定。
+                    </div>
+                  </template>
+                  <el-button class="image-check-threshold-button" :icon="QuestionFilled" text aria-label="匹配严格度说明" @click.prevent />
+                </el-tooltip>
+              </span>
+            </template>
+            <el-input-number :model-value="field.key === 'threshold' ? Number((config.threshold * 100).toFixed(8)) : config[field.key]" :min="field.min" :max="field.max" :step="field.step" controls-position="right" @update:model-value="$event !== undefined && patch({ [field.key]: field.key === 'threshold' ? $event / 100 : $event })" />
+            <el-alert v-if="field.key === 'threshold' && config.threshold === 1" title="100% 要求完全匹配，极细微的像素差异也会判为不匹配。" type="warning" :closable="false" show-icon class="image-check-strict-warning" />
+          </el-form-item>
+          <BranchTimeoutSettings v-if="field.key === 'durationMs'" style="grid-column: 1 / -1" :step="{ id: '', label: '', type: 'imageCheck', timeoutBranch }" :disabled="busy" @update="emit('timeoutBranch', $event)" />
+        </template>
       </div>
+      <BranchTimeoutSettings v-if="config.mode === 'state'" :step="{ id: '', label: '', type: 'imageCheck', timeoutBranch }" :disabled="busy" @update="emit('timeoutBranch', $event)" />
     </el-form>
     <template #footer><el-button :disabled="busy" @click="emit('close')">取消</el-button><el-button type="primary" :disabled="busy" @click="confirm">{{ editing ? '保存' : '添加' }}</el-button></template>
   </el-dialog>
@@ -135,9 +156,17 @@ async function upload(event: Event) {
 .image-check-dialog .el-input-number { width: 100%; }
 .image-check-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 0 12px; }
 .image-check-help { margin-left: 8px; color: #606266; }
+.image-check-grid .el-form-item__label { display: flex; align-items: center; min-height: 20px; }
+.image-check-threshold-label { display: inline-flex; align-items: center; gap: 4px; }
+.image-check-dialog .el-button.image-check-threshold-button { flex: 0 0 20px; width: 20px; height: 20px; min-height: 20px; padding: 0; font-size: 14px; }
+.image-check-threshold-help { max-width: min(300px, calc(100vw - 40px)); font-size: 12px; line-height: 1.7; overflow-wrap: anywhere; }
+.image-check-strict-warning { margin-top: 6px; }
 .image-check-template { display: grid; gap: 6px; margin-bottom: 16px; min-width: 0; }
 .image-check-size { color: #606266; font-size: 12px; }
 .image-check-region-warning { margin-bottom: 16px; }
 .image-check-template .el-image, .image-check-empty { height: 96px; width: 100%; background: #eff5f3; border: 1px solid #d5dfdb; border-radius: 4px; }
 .image-check-empty { display: grid; place-items: center; color: #606266; }
+@media (max-width: 480px) {
+  .image-check-grid { grid-template-columns: minmax(0, 1fr); }
+}
 </style>

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

@@ -119,7 +119,6 @@ const actionGroups: Array<{ title: string; actions: Array<{ type: InsertAction;
     actions: [
       { type: 'delay', label: '添加延时' },
       { type: 'popupCondition', label: '判断存在' },
-      { type: 'aiRecognition', label: 'AI 识别' },
       { type: 'imageCheck', label: '图像判断' },
       { type: 'tapIfExists', label: '存在则点击' },
       { type: 'inputIfExists', label: '存在则输入' },

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

@@ -89,7 +89,6 @@ const insertActionGroups: FlowActionGroup[] = [
     actions: [
       { type: 'delay', label: '添加延时' },
       { type: 'popupCondition', label: '判断存在' },
-      { type: 'aiRecognition', label: 'AI 识别' },
       { type: 'imageCheck', label: '图像判断' },
       { type: 'tapIfExists', label: '存在则点击' },
       { type: 'inputIfExists', label: '存在则输入' },

package/src/appium-recorder/flow-graph.ts

@@ -460,8 +460,8 @@ export function buildFlowGraph(
           && item.step.type !== 'clearAppData'
           && item.step.visualChange?.role !== 'end',
         canEditInput: ['input', 'inputIfExists', 'imageCheck', 'runScript'].includes(item.step.type),
-        canExecute: item.step.type === 'launchApp' || item.step.type === 'clearAppData' || item.step.type === 'aiRecognition',
-        missingAiModel: item.step.type === 'aiRecognition' && !options.aiRecognitionModelConfigured,
+        canExecute: item.step.type === 'launchApp' || item.step.type === 'clearAppData',
+        missingAiModel: item.step.type === 'aiRecognition',
       },
     });
   };