android-midscene-automation 0.1.26 → 0.1.28

package/server/appium-recorder/routes.ts

@@ -1,7 +1,6 @@
 import { execFile } from 'node:child_process';
-import fs from 'node:fs/promises';
-import os from 'node:os';
-import path from 'node:path';
+import { recognizeDeviceScreen } from './ai-recognition';
+import { readFreshWindowHierarchy } from './tree-dump';
 import type { IncomingMessage, ServerResponse } from 'node:http';
 import {
   deleteAppiumRecordedScript,
@@ -14,6 +13,7 @@ import {
 import { clearAppDataOnDevice, launchAppOnDevice, replayAppiumScript } from './appium-runner';
 import { isRemoteDeviceId, sendRemoteCommand } from '../remote-agents/registry';
 import { getAdbCommand } from '../android-sdk';
+import { createAppiumScriptExport } from './script-export';
 
 const treeDumpTasks = new Map<string, Promise<string>>();
 const replayingDevices = new Set<string>();
@@ -25,13 +25,6 @@ function sendJson(res: ServerResponse, payload: unknown, statusCode = 200) {
   res.end(JSON.stringify(payload));
 }
 
-function sendJsonDownload(res: ServerResponse, payload: unknown, fileName: string) {
-  res.statusCode = 200;
-  res.setHeader('Content-Type', 'application/json; charset=utf-8');
-  res.setHeader('Content-Disposition', `attachment; filename="appium-script.json"; filename*=UTF-8''${encodeURIComponent(fileName)}`);
-  res.end(JSON.stringify(payload, null, 2));
-}
-
 function sendStreamEvent(res: ServerResponse, payload: unknown) {
   res.write(`${JSON.stringify(payload)}\n`);
 }
@@ -64,17 +57,7 @@ async function dumpWindowHierarchy(deviceId: string) {
   const activeTask = treeDumpTasks.get(deviceId);
   if (activeTask) return activeTask;
 
-  const task = (async () => {
-    const localPath = path.join(os.tmpdir(), `midscene-appium-${deviceId.replace(/[^\w.-]/g, '_')}-${Date.now()}.xml`);
-    const remotePath = '/data/local/tmp/midscene_appium_uidump.xml';
-    await execFileText(getAdbCommand(), ['-s', deviceId, 'shell', 'uiautomator', 'dump', remotePath]);
-    await execFileText(getAdbCommand(), ['-s', deviceId, 'pull', remotePath, localPath]);
-    try {
-      return await fs.readFile(localPath, 'utf8');
-    } finally {
-      await fs.unlink(localPath).catch(() => undefined);
-    }
-  })();
+  const task = readFreshWindowHierarchy(deviceId, getAdbCommand(), execFileText);
   treeDumpTasks.set(deviceId, task);
   try {
     return await task;
@@ -134,6 +117,7 @@ export async function handleAppiumRecorderRequest(
     };
 
     if (pathname === '/api/appium-recorder/tree' && req.method === 'GET') {
+      res.setHeader('Cache-Control', 'no-store');
       const deviceId = requestUrl.searchParams.get('deviceId')?.trim() || selectedDeviceId;
       if (!deviceId) throw new Error('未检测到可用设备');
       assertDeviceAllowed(deviceId);
@@ -192,6 +176,24 @@ export async function handleAppiumRecorderRequest(
       return true;
     }
 
+    if (pathname === '/api/appium-recorder/ai-recognition/test' && req.method === 'POST') {
+      const parsed = await readBody<{ deviceId?: string; prompt?: unknown; timeoutMs?: number }>(req);
+      const deviceId = parsed.deviceId?.trim() || selectedDeviceId;
+      if (!deviceId) throw new Error('请选择设备');
+      assertDeviceAllowed(deviceId);
+      if (isRemoteDeviceId(deviceId)) throw new Error('远程设备暂不支持 AI 识别测试');
+      if (replayingDevices.has(deviceId)) { sendJson(res, { message: '设备正在回放，请稍后测试' }, 409); return true; }
+      const controller = new AbortController();
+      const abort = () => controller.abort();
+      res.once('close', abort);
+      try {
+        sendJson(res, await recognizeDeviceScreen({ deviceId, prompt: parsed.prompt, timeoutMs: parsed.timeoutMs, signal: controller.signal }));
+      } finally {
+        res.off('close', abort);
+      }
+      return true;
+    }
+
     if (pathname === '/api/appium-recorder/launch-app' && req.method === 'POST') {
       const parsed = await readBody<{ deviceId?: string; packageName?: string }>(req);
       const deviceId = parsed.deviceId?.trim() || selectedDeviceId;
@@ -277,17 +279,14 @@ export async function handleAppiumRecorderRequest(
     if (exportMatch && req.method === 'GET') {
       const script = getAppiumRecordedScript(decodeURIComponent(exportMatch[1]));
       if (!script) throw new Error('Appium 录制脚本不存在');
-      sendJsonDownload(res, {
-        schemaVersion: 1,
-        exportedAt: new Date().toISOString(),
-        script: {
-          name: script.name,
-          appPackage: script.appPackage,
-          appActivity: script.appActivity,
-          deviceId: script.deviceId,
-          steps: script.steps,
-        },
-      }, `${script.name}.json`);
+      const exported = await createAppiumScriptExport(script, getAppiumRecordedScript);
+      const fileName = encodeURIComponent(exported.fileName)
+        .replace(/['()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`);
+      res.statusCode = 200;
+      res.setHeader('Content-Type', exported.contentType);
+      res.setHeader('Content-Disposition', `attachment; filename="appium-script.${exported.contentType === 'application/zip' ? 'zip' : 'json'}"; filename*=UTF-8''${fileName}`);
+      res.setHeader('Content-Length', exported.body.length);
+      res.end(exported.body);
       return true;
     }
 

package/server/appium-recorder/screenshot.ts

@@ -0,0 +1,21 @@
+import { execFile } from 'node:child_process';
+import { getAdbCommand } from '../android-sdk';
+
+// 直接读取设备截图，不使用预览缓存，也不进入 Appium 命令队列。
+export function adbScreenshotBase64(deviceId: string, signal?: AbortSignal) {
+  return new Promise<string>((resolve, reject) => {
+    execFile(
+      getAdbCommand(),
+      ['-s', deviceId, 'exec-out', 'screencap', '-p'],
+      { encoding: 'buffer', maxBuffer: 20 * 1024 * 1024, timeout: 8000, signal },
+      (error, stdout, stderr) => {
+        if (error) {
+          reject(new Error(stderr?.toString('utf8').trim() || error.message || 'ADB 截图失败'));
+          return;
+        }
+        if (!stdout.length) { reject(new Error('ADB 未返回截图内容')); return; }
+        resolve(stdout.toString('base64'));
+      },
+    );
+  });
+}

package/server/appium-recorder/script-export.ts

@@ -0,0 +1,67 @@
+import { buffer } from 'node:stream/consumers';
+import archiver from 'archiver';
+import type { AppiumRecordedScriptRecord } from './repository';
+
+function safeExportName(name: string) {
+  const base = Array.from(name.trim().replace(/[<>:"/\\|?*\u0000-\u001f]/g, '_'))
+    .slice(0, 80).join('').replace(/[. ]+$/, '') || 'script';
+  return /^(con|prn|aux|nul|com[1-9]|lpt[1-9])(\.|$)/i.test(base) ? `_${base}` : base;
+}
+
+export async function createAppiumScriptExport(
+  root: AppiumRecordedScriptRecord,
+  getScript: (id: string) => AppiumRecordedScriptRecord | null,
+) {
+  const scripts = [root];
+  const visited = new Set([root.id]);
+  // 按脚本 ID 去重，既保留所有分支的依赖，也避免重复引用和循环连接无限展开。
+  for (const script of scripts) {
+    for (const step of script.steps) {
+      if (step.type !== 'runScript') continue;
+      const targetId = step.value || '';
+      if (!targetId) throw new Error(`脚本「${script.name}」的「${step.label}」缺少连接脚本 ID，无法导出`);
+      if (visited.has(targetId)) continue;
+      const target = getScript(targetId);
+      if (!target) throw new Error(`脚本「${script.name}」连接的脚本不存在（${targetId}），无法导出完整脚本包`);
+      visited.add(targetId);
+      scripts.push(target);
+    }
+  }
+
+  const exportedAt = new Date().toISOString();
+  const serialize = (script: AppiumRecordedScriptRecord) => JSON.stringify({
+    schemaVersion: 1,
+    exportedAt,
+    script: {
+      id: script.id,
+      name: script.name,
+      appPackage: script.appPackage,
+      appActivity: script.appActivity,
+      deviceId: script.deviceId,
+      steps: script.steps,
+    },
+  }, null, 2);
+  const baseName = safeExportName(root.name);
+  if (!root.steps.some((step) => step.type === 'runScript')) {
+    return {
+      fileName: `${baseName}.json`,
+      contentType: 'application/json; charset=utf-8',
+      body: Buffer.from(serialize(root)),
+    };
+  }
+
+  const archive = archiver('zip', { zlib: { level: 9 } });
+  const usedNames = new Set<string>();
+  for (const script of scripts) {
+    const name = safeExportName(script.name);
+    let fileName = `${name}.json`;
+    let suffix = 2;
+    // 清理非法字符后可能重名，Windows 解压时还需忽略大小写进行去重。
+    while (usedNames.has(fileName.toLowerCase())) fileName = `${name} (${suffix++}).json`;
+    usedNames.add(fileName.toLowerCase());
+    archive.append(serialize(script), { name: fileName });
+  }
+  // 生成完整压缩包后再发送响应，压缩失败仍可返回普通 JSON 错误。
+  const [body] = await Promise.all([buffer(archive), archive.finalize()]);
+  return { fileName: `${baseName}.zip`, contentType: 'application/zip', body };
+}

package/server/appium-recorder/tree-dump.ts

@@ -0,0 +1,22 @@
+import { randomUUID } from 'node:crypto';
+
+type ExecText = (command: string, args: string[]) => Promise<string>;
+
+export async function readFreshWindowHierarchy(deviceId: string, adb: string, execText: ExecText) {
+  // dump 失败可能仍以 0 退出。每次独立文件，避免误读上一次成功抓取的树。
+  const remotePath = `/data/local/tmp/midscene_uidump_${randomUUID()}.xml`;
+  const run = (args: string[]) => execText(adb, ['-s', deviceId, ...args]);
+  try {
+    const output = await run(['shell', 'uiautomator', 'dump', remotePath]);
+    if (/ERROR:|could not|failed/i.test(output)) throw new Error(output.trim());
+    const xml = await run(['shell', 'cat', remotePath]);
+    if (!xml.includes('<hierarchy') || !xml.includes('</hierarchy>')) {
+      throw new Error('设备未返回有效的组件树');
+    }
+    return xml;
+  } catch (error) {
+    throw new Error(`刷新组件树失败：${error instanceof Error ? error.message : String(error)}`);
+  } finally {
+    await run(['shell', 'rm', '-f', remotePath]).catch(() => undefined);
+  }
+}

package/server/appium-recorder/visual-change.ts

@@ -0,0 +1,184 @@
+import { PNG } from 'pngjs';
+import pixelmatch from 'pixelmatch';
+
+export type VisualChangeRegion = {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+};
+
+export type VisualChangeCheckInput = {
+  captureScreenshot: () => Promise<Buffer>;
+  wait: (ms: number) => Promise<void>;
+  region: VisualChangeRegion;
+  durationMs: number;
+  intervalMs: number;
+  changeRatioThreshold: number;
+  pixelmatchThreshold: number;
+};
+
+export type VisualChangeFrameCompareInput = {
+  baselineScreenshot: Buffer;
+  comparisonScreenshot: Buffer;
+  region: VisualChangeRegion;
+  changeRatioThreshold: number;
+  pixelmatchThreshold: number;
+};
+
+export type VisualChangeCheckResult = {
+  passed: boolean;
+  region: VisualChangeRegion;
+  durationMs: number;
+  intervalMs: number;
+  sampleCount: number;
+  changeRatioThreshold: number;
+  maxChangeRatio: number;
+  baselineBase64: string;
+  comparisonBase64: string;
+  diffBase64: string;
+  message: string;
+};
+
+function clampInteger(value: number, min: number, max: number) {
+  return Math.max(min, Math.min(max, Math.round(value)));
+}
+
+function normalizeRegion(region: VisualChangeRegion, imageWidth: number, imageHeight: number) {
+  const x = clampInteger(region.x, 0, Math.max(0, imageWidth - 1));
+  const y = clampInteger(region.y, 0, Math.max(0, imageHeight - 1));
+  const width = clampInteger(region.width, 1, imageWidth - x);
+  const height = clampInteger(region.height, 1, imageHeight - y);
+  return { x, y, width, height };
+}
+
+function readPng(buffer: Buffer) {
+  try {
+    return PNG.sync.read(buffer);
+  } catch (error) {
+    throw new Error('截图不是有效的 PNG 数据', { cause: error });
+  }
+}
+
+function cropPng(source: PNG, region: VisualChangeRegion) {
+  const crop = new PNG({ width: region.width, height: region.height });
+  for (let row = 0; row < region.height; row += 1) {
+    const sourceStart = ((region.y + row) * source.width + region.x) * 4;
+    const sourceEnd = sourceStart + region.width * 4;
+    const targetStart = row * region.width * 4;
+    source.data.copy(crop.data, targetStart, sourceStart, sourceEnd);
+  }
+  return crop;
+}
+
+function pngToBase64(png: PNG) {
+  return PNG.sync.write(png).toString('base64');
+}
+
+function compareCroppedImages(
+  baseline: PNG,
+  current: PNG,
+  pixelmatchThreshold: number,
+) {
+  const diff = new PNG({ width: baseline.width, height: baseline.height });
+  const differentPixels = pixelmatch(
+    baseline.data,
+    current.data,
+    diff.data,
+    baseline.width,
+    baseline.height,
+    {
+      threshold: pixelmatchThreshold,
+      includeAA: true,
+    },
+  );
+  const totalPixels = baseline.width * baseline.height;
+  return {
+    diff,
+    changedRatio: totalPixels ? (differentPixels / totalPixels) * 100 : 0,
+  };
+}
+
+// Screenshots can contain tiny encoding or antialiasing differences, so the
+// caller provides a ratio threshold instead of expecting exact image equality.
+export function compareVisualChangeFrames(input: VisualChangeFrameCompareInput): VisualChangeCheckResult {
+  const baselineScreenshot = readPng(input.baselineScreenshot);
+  const comparisonScreenshot = readPng(input.comparisonScreenshot);
+  const region = normalizeRegion(
+    input.region,
+    Math.min(baselineScreenshot.width, comparisonScreenshot.width),
+    Math.min(baselineScreenshot.height, comparisonScreenshot.height),
+  );
+  const baseline = cropPng(baselineScreenshot, region);
+  const comparison = cropPng(comparisonScreenshot, region);
+  const diff = compareCroppedImages(baseline, comparison, input.pixelmatchThreshold);
+  const passed = diff.changedRatio >= input.changeRatioThreshold;
+  return {
+    passed,
+    region,
+    durationMs: 0,
+    intervalMs: 0,
+    sampleCount: 2,
+    changeRatioThreshold: input.changeRatioThreshold,
+    maxChangeRatio: diff.changedRatio,
+    baselineBase64: pngToBase64(baseline),
+    comparisonBase64: pngToBase64(comparison),
+    diffBase64: pngToBase64(diff.diff),
+    message: passed
+      ? `起止节点截图发生变化，变化比例 ${diff.changedRatio.toFixed(2)}%，达到阈值 ${input.changeRatioThreshold}%`
+      : `起止节点截图未发生明显变化，变化比例 ${diff.changedRatio.toFixed(2)}%，低于阈值 ${input.changeRatioThreshold}%`,
+  };
+}
+
+export async function detectVisualChange(input: VisualChangeCheckInput): Promise<VisualChangeCheckResult> {
+  const firstScreenshot = readPng(await input.captureScreenshot());
+  const region = normalizeRegion(input.region, firstScreenshot.width, firstScreenshot.height);
+  const baseline = cropPng(firstScreenshot, region);
+  let sampleCount = 0;
+  let maxChangeRatio = 0;
+  let comparison = baseline;
+  let diffImage = new PNG({ width: baseline.width, height: baseline.height });
+  const startedAt = Date.now();
+  const deadline = startedAt + Math.max(1000, input.durationMs);
+  const intervalMs = Math.max(200, input.intervalMs);
+
+  while (Date.now() < deadline) {
+    await input.wait(Math.min(intervalMs, Math.max(0, deadline - Date.now())));
+    const currentScreenshot = readPng(await input.captureScreenshot());
+    const current = cropPng(currentScreenshot, region);
+    const diff = compareCroppedImages(baseline, current, input.pixelmatchThreshold);
+    sampleCount += 1;
+    comparison = current;
+    diffImage = diff.diff;
+    maxChangeRatio = Math.max(maxChangeRatio, diff.changedRatio);
+    if (diff.changedRatio >= input.changeRatioThreshold) {
+      return {
+        passed: true,
+        region,
+        durationMs: input.durationMs,
+        intervalMs,
+        sampleCount,
+        changeRatioThreshold: input.changeRatioThreshold,
+        maxChangeRatio,
+        baselineBase64: pngToBase64(baseline),
+        comparisonBase64: pngToBase64(comparison),
+        diffBase64: pngToBase64(diffImage),
+        message: `检测到画面变化，最大变化比例 ${maxChangeRatio.toFixed(2)}%，达到阈值 ${input.changeRatioThreshold}%`,
+      };
+    }
+  }
+
+  return {
+    passed: false,
+    region,
+    durationMs: input.durationMs,
+    intervalMs,
+    sampleCount,
+    changeRatioThreshold: input.changeRatioThreshold,
+    maxChangeRatio,
+    baselineBase64: pngToBase64(baseline),
+    comparisonBase64: pngToBase64(comparison),
+    diffBase64: pngToBase64(diffImage),
+    message: `${input.durationMs}ms 内目标区域未发生明显变化，最大变化比例 ${maxChangeRatio.toFixed(2)}%，低于阈值 ${input.changeRatioThreshold}%`,
+  };
+}

package/server/config.ts

@@ -4,8 +4,10 @@ import path from 'node:path';
 import YAML from 'yaml';
 import { appDataPath } from './paths';
 import { loadModelConfigFromDb, saveModelConfigToDb } from './config-store';
+import type { AiRecognitionModel } from '../src/appium-recorder/ai-recognition';
 
 export type AppConfig = {
+  appium: { model: AiRecognitionModel };
   runtime: {
     androidSdkPath: string;
     reportOutputPath: string;
@@ -43,6 +45,7 @@ export class ConfigValidationError extends Error {
 
 function defaultConfig(): AppConfig {
   return {
+    appium: { model: { baseUrl: '', apiKey: '', name: '' } },
     runtime: {
       androidSdkPath: '',
       reportOutputPath: '',
@@ -78,6 +81,13 @@ function normalizeEnv(env: unknown): Record<string, string> {
 function normalizeConfig(config: Partial<AppConfig> | null | undefined): AppConfig {
   const fallback = defaultConfig();
   return {
+    // 旧配置没有 Appium 模型时保留空值，不借用其他模型或改变已有配置。
+    appium: {
+      model: Object.fromEntries(['baseUrl', 'apiKey', 'name'].map((key) => {
+        const value = config?.appium?.model?.[key as keyof AiRecognitionModel];
+        return [key, typeof value === 'string' ? value.trim() : ''];
+      })) as AiRecognitionModel,
+    },
     runtime: {
       androidSdkPath: config?.runtime?.androidSdkPath?.trim() || fallback.runtime.androidSdkPath,
       reportOutputPath: config?.runtime?.reportOutputPath?.trim() || fallback.runtime.reportOutputPath,

package/server/http-api.ts

@@ -106,10 +106,9 @@ const START_ANDROID_PLAYGROUND_WITHOUT_BROWSER = [
   "const { androidPlaygroundPlatform, ScrcpyServer } = require('@midscene/android-playground');",
   "const { launchPreparedPlaygroundPlatform } = require('@midscene/playground');",
   'const STABLE_PREVIEW_OPTIONS = {',
-  '  maxFps: 15,',
-  '  maxSize: 1024,',
-  '  videoBitRate: 3000000,',
-  "  videoCodecOptions: 'i-frame-interval=0',",
+  '  maxFps: 10,',
+  '  maxSize: 800,',
+  '  videoBitRate: 1000000,',
   '};',
   'async function main() {',
   '  const scrcpyServer = new ScrcpyServer();',
@@ -1071,7 +1070,7 @@ export function createApiMiddleware() {
     if (req.url === '/api/test-model' && req.method === 'POST') {
       try {
         const parsed = await readBody<{
-          modelKey?: 'midscene' | 'scriptOptimizer';
+          modelKey?: 'midscene' | 'scriptOptimizer' | 'appium';
           model?: {
             provider?: 'custom' | 'codex';
             baseUrl?: string;

package/src/App.vue

@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { isAiRecognitionModelConfigured } from './appium-recorder/ai-recognition';
 import { computed, onMounted, onUnmounted, reactive, ref, shallowRef, watch } from 'vue';
 import { ElMessage, ElMessageBox } from 'element-plus';
 import {
@@ -99,7 +100,9 @@ const appPresets = ref<AppPreset[]>([]);
 const modelTestStatus = reactive({
   midscene: '',
   scriptOptimizer: '',
+  appium: '',
 });
+const aiRecognitionModelConfigured = shallowRef(false);
 const actionDialog = reactive({
   visible: false,
   title: '',
@@ -149,6 +152,7 @@ const appPresetForm = reactive({
 });
 
 const configForm = reactive<ConfigForm>({
+  appium: { model: { baseUrl: '', apiKey: '', name: '' } },
   runtime: {
     androidSdkPath: '',
     reportOutputPath: '',
@@ -656,6 +660,8 @@ const loadConfig = async () => {
   });
   Object.assign(configForm.midscene.env, payload.midscene.env || {});
   Object.assign(configForm.scriptOptimizer.model, payload.scriptOptimizer.model);
+  Object.assign(configForm.appium.model, payload.appium?.model || { baseUrl: '', apiKey: '', name: '' });
+  aiRecognitionModelConfigured.value = isAiRecognitionModelConfigured(configForm.appium.model);
   if (configForm.midscene.model.provider !== 'codex') {
     rememberCustomMidsceneModel();
   }
@@ -692,7 +698,7 @@ const getMidsceneModelConfigError = () => {
   if (model.provider !== 'codex' && !model.apiKey.trim()) missing.push('API Key');
 
   if (!missing.length) return '';
-  return `Midscene 模型配置不完整：缺少 ${missing.join('、')}。请在“参数配置 > Midscene 模型”中选择“使用 Codex”，或补齐自定义提供方后保存。`;
+  return `Midscene 模型配置不完整：缺少 ${missing.join('、')}。请在“参数配置 > Midscene配置 > Midscene 模型”中选择“使用 Codex”，或补齐自定义提供方后保存。`;
 };
 
 const saveModelConfig = async () => {
@@ -700,7 +706,10 @@ const saveModelConfig = async () => {
   errorMessage.value = '';
   openActionDialog('保存参数配置');
   try {
-    await api.saveConfig(configForm);
+    // 保存的是本次提交快照，不能把请求期间尚未保存的改动标记为已配置。
+    const snapshot = JSON.parse(JSON.stringify(configForm)) as ConfigForm;
+    await api.saveConfig(snapshot);
+    aiRecognitionModelConfigured.value = isAiRecognitionModelConfigured(snapshot.appium.model);
     closeActionDialog();
     ElMessage.success('参数配置已保存');
   } catch (error) {
@@ -776,14 +785,11 @@ const removeAppPreset = async (id: string) => {
   }
 };
 
-const testModel = async (key: 'midscene' | 'scriptOptimizer') => {
+const testModel = async (key: 'midscene' | 'scriptOptimizer' | 'appium') => {
   testingModelKey.value = key;
   errorMessage.value = '';
   modelTestStatus[key] = '';
-  const model =
-    key === 'midscene'
-      ? configForm.midscene.model
-      : configForm.scriptOptimizer.model;
+  const model = configForm[key].model;
 
   try {
     const payload = await api.testModel({ modelKey: key, model });
@@ -1557,6 +1563,7 @@ onUnmounted(() => {
           v-show="activeMenu === 'appium'"
           :active="activeMenu === 'appium'"
           :app-presets="appPresets"
+          :ai-recognition-model-configured="aiRecognitionModelConfigured"
           :device-actions="deviceActions"
           :playground-available="playgroundAvailable"
           :playground-device-id="playgroundDeviceId"

package/src/api.ts

@@ -116,7 +116,7 @@ export function saveConfig(input: ConfigForm) {
 
 // 测试指定模型配置是否可用，通常用于保存前验证 baseUrl/apiKey/model。
 export function testModel(input: {
-  modelKey: 'midscene' | 'scriptOptimizer';
+  modelKey: 'midscene' | 'scriptOptimizer' | 'appium';
   model: {
     provider?: 'custom' | 'codex';
     baseUrl: string;