android-midscene-automation 0.2.3 → 1.1.0

package/bin/android-midscene-automation.js

@@ -1,15 +1,11 @@
 #!/usr/bin/env node
 import { spawn } from 'node:child_process';
-import { createRequire } from 'node:module';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-const require = createRequire(import.meta.url);
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const viteRoot = path.dirname(require.resolve('vite/package.json'));
-const viteBin = path.join(viteRoot, 'bin', 'vite.js');
 const args = process.argv.slice(2);
 const userRoot = process.cwd();
 const githubUrl = 'https://github.com/oooooooko/android-midscene-automation';
@@ -90,7 +86,7 @@ console.log(`\nGitHub 源码 / 二次修改：${githubUrl}`);
 console.log(`问题反馈 / 功能建议：${githubUrl}/issues\n`);
 console.log(`本地数据目录：${dataRoot}\n`);
 
-const child = spawn(process.execPath, [viteBin, ...args], {
+const child = spawn(process.execPath, [path.join(packageRoot, 'bin/start-dev.mjs'), ...args], {
   cwd: packageRoot,
   env: {
     ...process.env,

package/bin/artemis-config.mjs

@@ -0,0 +1,15 @@
+import { constants, copyFileSync, existsSync, mkdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+export function ensureArtemisConfig(projectDir) {
+  const configDir = resolve(projectDir, 'config');
+  const target = resolve(configDir, 'artemis.jsonc');
+  if (existsSync(target)) return;
+  mkdirSync(configDir, { recursive: true });
+  try {
+    copyFileSync(resolve(configDir, 'artemis.example.jsonc'), target, constants.COPYFILE_EXCL);
+  } catch (error) {
+    // Never overwrite a user's configuration, including concurrent first starts.
+    if (error.code !== 'EEXIST') throw error;
+  }
+}

package/bin/artemis-embedded.py

@@ -0,0 +1,56 @@
+"""Launch an unmodified Artemis checkout with an explicit frame-ancestor allowlist."""
+
+import os
+from pathlib import Path
+import sys
+from urllib.parse import urlsplit
+
+
+def frame_policy(origins: str) -> str:
+    allowed = []
+    for value in origins.split(','):
+        origin = value.strip()
+        parsed = urlsplit(origin)
+        if (parsed.scheme not in {'http', 'https'} or not parsed.hostname
+                or parsed.username or parsed.password or parsed.path not in {'', '/'}
+                or parsed.query or parsed.fragment
+                or any(char in origin for char in " \t\r\n;*'")):
+            raise ValueError(f'Invalid ARTEMIS_EMBED_ORIGINS origin: {origin!r}')
+        allowed.append(f'{parsed.scheme}://{parsed.netloc}')
+    return "frame-ancestors 'self' " + ' '.join(allowed)
+
+
+class EmbedBoundary:
+    def __init__(self, app, policy: str):
+        self.app = app
+        self.policy = policy.encode('ascii')
+
+    async def __call__(self, scope, receive, send):
+        async def send_headers(message):
+            if message['type'] == 'http.response.start':
+                # Replace only the framing restriction; retain Host/Origin checks
+                # and all other headers installed by Artemis's inner middleware.
+                headers = [(key, value) for key, value in message.get('headers', [])
+                           if key.lower() != b'x-frame-options']
+                # Multiple CSP headers are enforced together by the browser.
+                headers.append((b'content-security-policy', self.policy))
+                message = {**message, 'headers': headers}
+            await send(message)
+
+        await self.app(scope, receive, send_headers)
+
+
+if __name__ == '__main__':
+    policy = frame_policy(os.environ.get(
+        'ARTEMIS_EMBED_ORIGINS',
+        'http://127.0.0.1:5173,http://localhost:5173,'
+        'http://127.0.0.1:4173,http://localhost:4173',
+    ))
+    sys.path.insert(0, str(Path(os.environ['ARTEMIS_PROJECT_DIR']).resolve()))
+    from apps.admin_console.server import app, run_ui_server
+    from artemis.interfaces.cli.commands.ui import ensure_showcase_built
+    from rich.console import Console
+
+    ensure_showcase_built(Console())
+    app.add_middleware(EmbedBoundary, policy=policy)
+    run_ui_server(host='127.0.0.1', port=int(os.environ.get('ARTEMIS_PORT', '8000')))

package/bin/start-artemis.mjs

@@ -0,0 +1,30 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { ensureArtemisConfig } from './artemis-config.mjs';
+
+const binDir = dirname(fileURLToPath(import.meta.url));
+const projectDir = resolve(process.env.ARTEMIS_PROJECT_DIR || resolve(binDir, '../artemis-main'));
+if (!existsSync(resolve(projectDir, 'pyproject.toml'))) {
+  console.error('找不到 Artemis 源码。请将源码放在 artemis-main，或设置 ARTEMIS_PROJECT_DIR。');
+  process.exit(1);
+}
+
+ensureArtemisConfig(projectDir);
+
+const child = spawn('uv', ['run', '--project', projectDir, 'python', resolve(binDir, 'artemis-embedded.py')], {
+  cwd: projectDir,
+  stdio: 'inherit',
+  env: { ...process.env, ARTEMIS_PROJECT_DIR: projectDir },
+});
+child.once('error', error => {
+  console.error(`Artemis 启动失败，请确认已安装 uv：${error.message}`);
+  process.exitCode = 1;
+});
+for (const signal of ['SIGINT', 'SIGTERM']) {
+  process.on(signal, () => child.kill(signal));
+}
+child.once('exit', (code, signal) => {
+  process.exitCode = code ?? (signal ? 1 : 0);
+});

package/bin/start-dev.mjs

@@ -0,0 +1,112 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const require = createRequire(import.meta.url);
+const binDir = dirname(fileURLToPath(import.meta.url));
+const projectRoot = resolve(binDir, '..');
+const args = process.argv.slice(2);
+const portIndex = args.indexOf('--port');
+const vitePort = args.find(arg => arg.startsWith('--port='))?.slice(7)
+  || (portIndex >= 0 ? args[portIndex + 1] : '5173');
+const artemisPort = process.env.ARTEMIS_PORT || '8000';
+const localArtemisUrl = `http://127.0.0.1:${artemisPort}`;
+const env = {
+  ...process.env,
+  ARTEMIS_URL: process.env.ARTEMIS_URL || localArtemisUrl,
+  ARTEMIS_EMBED_ORIGINS: process.env.ARTEMIS_EMBED_ORIGINS
+    || `http://127.0.0.1:${vitePort},http://localhost:${vitePort},http://127.0.0.1:4173,http://localhost:4173`,
+};
+const children = new Set();
+let stopping = false;
+let killTimer;
+
+function signalChild(child, signal) {
+  try {
+    if (!child.devProcessGroup) child.kill(signal);
+    else process.kill(-child.pid, signal);
+  } catch (error) {
+    if (error.code !== 'ESRCH') console.error(`停止开发服务失败：${error.message}`);
+  }
+}
+
+function stop(code = 0) {
+  if (stopping) return;
+  stopping = true;
+  process.exitCode = code;
+  for (const child of children) signalChild(child, 'SIGTERM');
+  // uv and Python belong to the launcher group, so descendants are cleaned too.
+  killTimer = setTimeout(() => {
+    for (const child of children) signalChild(child, 'SIGKILL');
+  }, 5000);
+  killTimer.unref();
+}
+
+function start(script, scriptArgs, required) {
+  const devProcessGroup = !required && process.platform !== 'win32';
+  const child = spawn(process.execPath, [script, ...scriptArgs], {
+    cwd: projectRoot, env, stdio: 'inherit', detached: devProcessGroup,
+  });
+  child.devProcessGroup = devProcessGroup;
+  children.add(child);
+  child.once('error', error => {
+    console.error(`${required ? '主项目' : 'Artemis'} 启动失败：${error.message}`);
+    children.delete(child);
+    if (required) stop(1);
+  });
+  child.once('exit', code => {
+    // Clean any descendants even if their direct parent has already exited.
+    signalChild(child, 'SIGTERM');
+    children.delete(child);
+    if (!children.size) clearTimeout(killTimer);
+    if (stopping) return;
+    if (required) stop(code ?? 1);
+    else console.warn('Artemis 服务已退出，主项目继续运行；排查上方日志后可执行 npm run artemis 重试。');
+  });
+}
+
+// npm may forward a signal already delivered by the terminal; keep both handlers.
+process.on('SIGINT', () => stop());
+process.on('SIGTERM', () => stop());
+process.on('exit', () => {
+  for (const child of children) signalChild(child, 'SIGTERM');
+});
+
+async function startArtemis() {
+  if (env.ARTEMIS_AUTO_START === '0') return;
+  try {
+    const response = await fetch(new URL('/api/status', env.ARTEMIS_URL), {
+      signal: AbortSignal.timeout(1500), redirect: 'error',
+    });
+    const data = await response.json();
+    if (response.ok && data.model_info) {
+      console.log(`复用已运行的 Artemis：${env.ARTEMIS_URL}`);
+      return;
+    }
+  } catch { /* No running Artemis; try the local launcher below. */ }
+  if (stopping) return;
+  const target = new URL(env.ARTEMIS_URL);
+  if (!['127.0.0.1', 'localhost'].includes(target.hostname)
+      || target.protocol !== 'http:' || (target.port || '80') !== artemisPort) {
+    console.warn('ARTEMIS_URL 指向外部或不同端口的服务，请单独启动该服务；主项目继续运行。');
+    return;
+  }
+  const projectDir = resolve(env.ARTEMIS_PROJECT_DIR || resolve(projectRoot, 'artemis-main'));
+  if (!existsSync(resolve(projectDir, 'pyproject.toml'))) {
+    console.warn('未找到 Artemis 源码，跳过自动启动。请准备 artemis-main 或设置 ARTEMIS_PROJECT_DIR；主项目继续运行。');
+    return;
+  }
+  console.log(`正在自动启动 Artemis：${localArtemisUrl}`);
+  start(resolve(binDir, 'start-artemis.mjs'), [], false);
+}
+
+const viteBin = resolve(dirname(require.resolve('vite/package.json')), 'bin/vite.js');
+// Keep the port fixed so iframe origins match the actual dev server.
+start(viteBin, ['--host', '127.0.0.1', '--strictPort', ...args], true);
+try {
+  await startArtemis();
+} catch (error) {
+  console.warn(`Artemis 自动启动失败：${error.message}；主项目继续运行。`);
+}

package/bin/test_artemis_embedded.py

@@ -0,0 +1,44 @@
+import asyncio
+import importlib.util
+from pathlib import Path
+import unittest
+
+spec = importlib.util.spec_from_file_location('embedded', Path(__file__).with_name('artemis-embedded.py'))
+embedded = importlib.util.module_from_spec(spec)
+spec.loader.exec_module(embedded)
+
+
+class EmbedTests(unittest.TestCase):
+    def test_only_explicit_origins(self):
+        self.assertEqual(embedded.frame_policy('http://localhost:5173/'),
+                         "frame-ancestors 'self' http://localhost:5173")
+        for origin in ['*', 'https://*.example.com', 'http://localhost:5173;script-src *',
+                       'http://user:pass@localhost:5173', 'http://localhost/path', 'null']:
+            with self.subTest(origin=origin), self.assertRaises(ValueError):
+                embedded.frame_policy(origin)
+
+    def test_preserves_origin_rejection_and_other_headers(self):
+        async def run():
+            async def app(scope, receive, send):
+                await send({'type': 'http.response.start', 'status': 403, 'headers': [
+                    (b'x-frame-options', b'DENY'), (b'x-content-type-options', b'nosniff'),
+                    (b'content-security-policy', b"script-src 'self'"),
+                ]})
+                await send({'type': 'http.response.body', 'body': b'Forbidden'})
+            messages = []
+            async def send(message):
+                messages.append(message)
+            await embedded.EmbedBoundary(app, embedded.frame_policy('http://localhost:5173'))(
+                {'type': 'http'}, None, send)
+            self.assertEqual(messages[0]['status'], 403)
+            self.assertEqual(messages[1]['body'], b'Forbidden')
+            headers = messages[0]['headers']
+            self.assertIn((b'x-content-type-options', b'nosniff'), headers)
+            self.assertIn((b'content-security-policy', b"script-src 'self'"), headers)
+            self.assertNotIn((b'x-frame-options', b'DENY'), headers)
+            self.assertIn((b'content-security-policy', b"frame-ancestors 'self' http://localhost:5173"), headers)
+        asyncio.run(run())
+
+
+if __name__ == '__main__':
+    unittest.main()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "android-midscene-automation",
-  "version": "0.2.3",
+  "version": "1.1.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/oooooooko/android-midscene-automation.git"
@@ -14,6 +14,7 @@
     "android-midscene-automation": "bin/android-midscene-automation.js"
   },
   "files": [
+    "artemis-main",
     "bin",
     "index.html",
     "remote-agent",
@@ -29,7 +30,8 @@
     "CHANGELOG.md"
   ],
   "scripts": {
-    "dev": "vite --host 127.0.0.1",
+    "artemis": "node bin/start-artemis.mjs",
+    "dev": "node bin/start-dev.mjs",
     "prepack": "node bin/sync-readme-docs.mjs",
     "remote-agent": "tsx remote-agent/index.ts",
     "build": "vue-tsc -b && vite build",
@@ -45,12 +47,12 @@
     "mediabunny": "1.58.0",
     "@dagrejs/dagre": "1.1.5",
     "@element-plus/icons-vue": "2.3.2",
-    "@midscene/android": "https://registry.npmjs.org/@midscene/android/-/android-1.12.7.tgz",
-    "@midscene/android-playground": "https://registry.npmjs.org/@midscene/android-playground/-/android-playground-1.12.7.tgz",
-    "@midscene/core": "https://registry.npmjs.org/@midscene/core/-/core-1.12.7.tgz",
-    "@midscene/playground": "https://registry.npmjs.org/@midscene/playground/-/playground-1.12.7.tgz",
-    "@midscene/shared": "https://registry.npmjs.org/@midscene/shared/-/shared-1.12.7.tgz",
-    "@midscene/web": "https://registry.npmjs.org/@midscene/web/-/web-1.12.7.tgz",
+    "@midscene/android": "https://registry.npmjs.org/@midscene/android/-/android-1.14.0.tgz",
+    "@midscene/android-playground": "https://registry.npmjs.org/@midscene/android-playground/-/android-playground-1.14.0.tgz",
+    "@midscene/core": "https://registry.npmjs.org/@midscene/core/-/core-1.14.0.tgz",
+    "@midscene/playground": "https://registry.npmjs.org/@midscene/playground/-/playground-1.14.0.tgz",
+    "@midscene/shared": "https://registry.npmjs.org/@midscene/shared/-/shared-1.14.0.tgz",
+    "@midscene/web": "https://registry.npmjs.org/@midscene/web/-/web-1.14.0.tgz",
     "@techstark/opencv-js": "5.0.0-release.1",
     "@vitejs/plugin-vue": "6.0.7",
     "@vue-flow/core": "1.48.2",

package/server/artemis.ts

@@ -0,0 +1,34 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { appPath } from './paths';
+
+export async function getArtemisVersion() {
+  try {
+    const projectDir = process.env.ARTEMIS_PROJECT_DIR || appPath('artemis-main');
+    const source = await readFile(resolve(projectDir, 'pyproject.toml'), 'utf8');
+    const project = source.split(/^\[project\]\s*$/m)[1]?.split(/^\[/m)[0] || '';
+    const version = project.match(/^version\s*=\s*["']([^"']+)["']/m)?.[1];
+    return { version: version || '', message: version ? '本地 Artemis 源码版本' : '未找到 Artemis 版本信息' };
+  } catch {
+    return { version: '', message: '未找到本地 Artemis 源码，请检查 ARTEMIS_PROJECT_DIR' };
+  }
+}
+
+export async function getArtemisStatus() {
+  const configuredUrl = process.env.ARTEMIS_URL || 'http://127.0.0.1:8000';
+  try {
+    const url = new URL(configuredUrl);
+    const response = await fetch(new URL('/api/status', url), {
+      signal: AbortSignal.timeout(3000),
+      redirect: 'error',
+    });
+    const data = await response.json() as { model_info?: unknown };
+    if (!response.ok || !data.model_info) throw new Error('服务响应不是 Artemis 控制台');
+    const policy = response.headers.get('content-security-policy') || '';
+    const ancestors = response.headers.get('x-frame-options')
+      ? [] : policy.match(/(?:^|;)\s*frame-ancestors\s+([^;]+)/)?.[1].split(/\s+/) || [];
+    return { url: url.origin, available: true, ancestors, message: '' };
+  } catch {
+    return { url: '', available: false, ancestors: [], message: '未连接到 Artemis，请先在项目根目录运行 npm run artemis，并检查 ARTEMIS_URL 配置。' };
+  }
+}

package/server/http-api.ts

@@ -1,4 +1,5 @@
 import { getTestAnalytics } from './analytics';
+import { getArtemisStatus, getArtemisVersion } from './artemis';
 import { readBody, readRawBody, requestErrorStatus } from './request-body';
 import { canManageConfig, publicConfig, resolveSavedModelKey } from './config-access';
 import { resolveReportSummary } from '../src/appium-recorder/report-summary';
@@ -79,7 +80,7 @@ function delay(ms: number) {
   });
 }
 
-// Work around @midscene/android-playground v1.12.x ESM __dirname usage on Node 24.
+// Keep the Android Playground launcher compatible with Node 24 ESM execution.
 const START_ANDROID_PLAYGROUND_WITHOUT_BROWSER = [
   "import { createRequire } from 'node:module';",
   'const require = createRequire(import.meta.url);',
@@ -615,6 +616,17 @@ export function createApiMiddleware() {
     const requestUrl = new URL(req.url || '/', 'http://localhost');
     const pathname = requestUrl.pathname;
     const allowLocalDevice = isLocalRequest(req);
+    if (['/api/artemis/status', '/api/artemis/version'].includes(pathname) && req.method === 'GET') {
+      res.setHeader('Content-Type', 'application/json; charset=utf-8');
+      res.setHeader('Cache-Control', 'no-store');
+      if (!canManageConfig(req)) {
+        res.statusCode = 403;
+        res.end(JSON.stringify({ message: 'Artemis 集成仅允许在本机页面访问' }));
+      } else {
+        res.end(JSON.stringify(await (pathname.endsWith('/version') ? getArtemisVersion() : getArtemisStatus())));
+      }
+      return;
+    }
     if ((pathname === '/api/config' || pathname.startsWith('/api/config/') || pathname === '/api/test-model') && !canManageConfig(req)) {
       res.statusCode = 403;
       res.setHeader('Content-Type', 'application/json; charset=utf-8');

package/src/App.vue

@@ -36,9 +36,11 @@ import { useDevicePreview } from './composables/use-device-preview';
 import { useScriptExecution } from './composables/use-script-execution';
 import { useInitialResource } from './composables/use-initial-resource';
 import AppSidebar from './components/AppSidebar.vue';
+import MidsceneMaintenanceNotice from './components/MidsceneMaintenanceNotice.vue';
 const AnalysisPage = defineAsyncComponent(() => import('./pages/AnalysisPage.vue'));
 const AutomationPage = defineAsyncComponent(() => import('./pages/AutomationPage.vue'));
 const AppiumPage = defineAsyncComponent(() => import('./appium-recorder/AppiumPage.vue'));
+const ArtemisPage = defineAsyncComponent(() => import('./pages/ArtemisPage.vue'));
 const ConfigPage = defineAsyncComponent(() => import('./pages/ConfigPage.vue'));
 const GeneratorPage = defineAsyncComponent(() => import('./pages/GeneratorPage.vue'));
 const HelpCenter = defineAsyncComponent(() => import('./components/help/HelpCenter.vue'));
@@ -50,7 +52,7 @@ import type {
 } from './types';
 
 const ACTIVE_MENU_STORAGE_KEY = 'android-midscene-automation:active-menu';
-const menuKeys: MenuKey[] = ['analysis', 'generator', 'automation', 'config', 'appium', 'about'];
+const menuKeys: MenuKey[] = ['appium', 'artemis', 'generator', 'automation', 'analysis', 'config', 'about'];
 const storedMenu = window.localStorage.getItem(ACTIVE_MENU_STORAGE_KEY) as MenuKey | null;
 const activeMenu = ref<MenuKey>(storedMenu && menuKeys.includes(storedMenu) ? storedMenu : 'generator');
 const activeGeneratorMode = ref<GeneratorMode>('ai');
@@ -110,8 +112,9 @@ const { isRunningScript, isStoppingScript, executionLog, executionProcess, lastR
 const visitedMenus = reactive(new Set<MenuKey>([activeMenu.value]));
 const openMenus = ref<MenuKey[]>([...menuKeys]);
 const visibleMenuItems = computed(() => openMenus.value.map(key => menuItems.find(item => item.key === key)!));
-function closeMenu(key: MenuKey) {
+async function closeMenu(key: MenuKey) {
   if (openMenus.value.length === 1) return;
+  if (key === 'generator' && !(await confirmUnsavedGeneratorNavigation())) return;
   const index = openMenus.value.indexOf(key);
   openMenus.value.splice(index, 1);
   if (activeMenu.value === key) activeMenu.value = openMenus.value[Math.max(0, index - 1)];
@@ -119,10 +122,11 @@ function closeMenu(key: MenuKey) {
 
 const sidebarCollapsed = shallowRef(false);
 const menuItems = [
-  { key: 'analysis', label: '分析页', icon: DataAnalysis },
+  { key: 'appium', label: 'Appium', icon: Monitor },
+  { key: 'artemis', label: 'Artemis', icon: Monitor },
   { key: 'generator', label: '测试脚本生成', icon: Operation },
   { key: 'automation', label: '自动化测试', icon: Monitor },
-  { key: 'appium', label: 'Appium', icon: Monitor },
+  { key: 'analysis', label: '分析页', icon: DataAnalysis },
   { key: 'config', label: '参数配置', icon: Setting },
   { key: 'about', label: '关于', icon: InfoFilled },
 ] as const;
@@ -144,6 +148,23 @@ const appPromptPrefix = computed(() => {
 const effectiveSourcePrompt = computed(() => `${appPromptPrefix.value}${sourcePrompt.value}`.trim());
 const generatedCodeFromSteps = computed(() => buildScript(form, steps.value));
 const generatedCode = computed(() => generatedCodeOverride.value ?? generatedCodeFromSteps.value);
+const generatorContentSnapshot = computed(() => JSON.stringify({
+  form: {
+    promptTitle: form.promptTitle,
+    testName: form.testName,
+    appPresetId: form.appPresetId,
+  },
+  sourcePrompt: sourcePrompt.value,
+  steps: steps.value,
+  generatedCodeOverride: generatedCodeOverride.value,
+  generatedCodeDraft: generatedCodeEditing.value ? generatedCodeDraft.value : '',
+}));
+const savedGeneratorSnapshot = shallowRef('');
+const generatorHasUnsavedContent = computed(() => (
+  showGeneratedCode.value
+  && Boolean(generatedCode.value.trim())
+  && generatorContentSnapshot.value !== savedGeneratorSnapshot.value
+));
 const selectedScript = computed(() => savedScripts.value.find((item) => item.id === selectedScriptId.value));
 const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
 const deviceActions = [
@@ -155,8 +176,11 @@ const deviceActions = [
   { key: 'tasks', label: '任务', icon: tasksIcon, keyCode: 187 },
 ] as const;
 
-const selectMenu = (key: string) => {
-  activeMenu.value = key as MenuKey;
+const selectMenu = async (key: string) => {
+  const nextMenu = key as MenuKey;
+  if (nextMenu === activeMenu.value) return;
+  if (activeMenu.value === 'generator' && !(await confirmUnsavedGeneratorNavigation())) return;
+  activeMenu.value = nextMenu;
 };
 
 const resetGeneratedCodeEditor = () => {
@@ -166,11 +190,6 @@ const resetGeneratedCodeEditor = () => {
   generatedCodeEditSaving.value = false;
 };
 
-watch(activeGeneratorMode, () => {
-  showGeneratedCode.value = false;
-  resetGeneratedCodeEditor();
-});
-
 function formatScriptTime(value: string) {
   if (!value) return '';
   const date = new Date(value);
@@ -455,16 +474,16 @@ const buildSourcePromptForSave = () => {
 
 const saveCurrentScript = async () => {
   const validInput = validateCurrentGeneratorInputs();
-  if (!validInput) return;
+  if (!validInput) return false;
 
   if (generatedCodeEditing.value) {
     ElMessage.error('请先保存或撤回代码修改');
-    return;
+    return false;
   }
 
   if (!showGeneratedCode.value || !generatedCode.value.trim()) {
     ElMessage.error('请先点击 AI 生成，生成代码后再保存脚本');
-    return;
+    return false;
   }
 
   const { scriptName, promptTitle } = validInput;
@@ -478,7 +497,7 @@ const saveCurrentScript = async () => {
         cancelButtonText: '取消',
       });
     } catch {
-      return;
+      return false;
     }
   }
 
@@ -495,10 +514,34 @@ const saveCurrentScript = async () => {
     });
 
     await loadSavedScripts(payload.script?.id || '');
+    savedGeneratorSnapshot.value = generatorContentSnapshot.value;
     await sleep(Math.max(0, 1200 - (Date.now() - startedAt)));
     closeActionDialog();
+    return true;
   } catch (error) {
     failActionDialog(error instanceof Error ? error.message : '保存脚本失败');
+    return false;
+  }
+};
+
+const confirmUnsavedGeneratorNavigation = async () => {
+  if (!generatorHasUnsavedContent.value) return true;
+
+  try {
+    await ElMessageBox.confirm(
+      '当前生成内容尚未保存。可以先保存脚本，或暂不保存并继续切换页面。',
+      '未保存的测试脚本',
+      {
+        type: 'warning',
+        confirmButtonText: '保存脚本',
+        cancelButtonText: '暂不保存',
+        distinguishCancelAndClose: true,
+        closeOnClickModal: false,
+      },
+    );
+    return await saveCurrentScript();
+  } catch (action) {
+    return action === 'cancel';
   }
 };
 
@@ -554,7 +597,7 @@ const generateWithModel = async () => {
   errorMessage.value = '';
   const controller = new AbortController();
   aiGenerateAbortController = controller;
-  openActionDialog('AI生成', {
+  openActionDialog('AI 生成', {
     canRunInBackground: true,
     canCancel: true,
     cancelText: '终止',
@@ -674,7 +717,7 @@ watch(activeMenu, menu => {
   if (!openMenus.value.includes(menu)) openMenus.value.push(menu);
 }, { flush: 'sync' });
 const warnBeforeUnload = (event: BeforeUnloadEvent) => {
-  if (!appiumAutoSave.dirty.value) return;
+  if (!appiumAutoSave.dirty.value && !generatorHasUnsavedContent.value) return;
   event.preventDefault();
   event.returnValue = '';
 };
@@ -695,7 +738,9 @@ onUnmounted(() => {
     <el-dialog
       v-model="actionDialog.visible"
       :title="actionDialog.title"
-      width="360px"
+      width="min(440px, calc(100vw - 32px))"
+      align-center
+      append-to-body
       :close-on-click-modal="false"
       :close-on-press-escape="!actionDialog.loading"
       :show-close="!actionDialog.loading"
@@ -712,7 +757,7 @@ onUnmounted(() => {
         <div v-if="actionDialog.loading" class="action-dialog__footer-actions">
           <el-button
             v-if="actionDialog.canCancel"
-            class="action-dialog__footer-button action-dialog__footer-button--secondary"
+            class="action-dialog__footer-button"
             :icon="VideoPause"
             :loading="actionDialog.canceling"
             @click="stopGenerateWithModel"
@@ -721,7 +766,8 @@ onUnmounted(() => {
           </el-button>
           <el-button
             v-if="actionDialog.canRunInBackground"
-            class="action-dialog__footer-button action-dialog__footer-button--primary"
+            type="primary"
+            class="action-dialog__footer-button"
             @click="sendActionDialogToBackground"
           >
             后台处理
@@ -729,7 +775,8 @@ onUnmounted(() => {
         </div>
         <el-button
           v-else
-          class="action-dialog__footer-button action-dialog__footer-button--primary"
+          type="primary"
+          class="action-dialog__footer-button"
           @click="closeActionDialog"
         >
           关闭
@@ -831,6 +878,7 @@ onUnmounted(() => {
         </div>
       </nav>
 
+      <MidsceneMaintenanceNotice v-if="activeMenu === 'generator' || activeMenu === 'automation'" />
       <div v-if="connectionError" class="connection-status" role="status">
         <span>{{ connectionError }}</span><el-button link type="primary" :loading="reconnecting" @click="reconnect">重新连接</el-button>
       </div>
@@ -841,12 +889,12 @@ onUnmounted(() => {
       <main
         class="page-body"
         :class="{
-          'page-body--fixed': activeMenu === 'generator' && activeGeneratorMode === 'ai',
           'page-body--appium': activeMenu === 'appium',
           'page-body--config': activeMenu === 'config',
+          'page-body--artemis': activeMenu === 'artemis',
         }"
       >
-        <el-alert v-if="activeMenu !== 'appium' && activeMenu !== 'config' && activeMenu !== 'about' && errorMessage" type="error" :closable="false" show-icon class="page-alert">
+        <el-alert v-if="activeMenu !== 'appium' && activeMenu !== 'artemis' && activeMenu !== 'config' && activeMenu !== 'about' && errorMessage" type="error" :closable="false" show-icon class="page-alert">
           <template #title>{{ errorMessage }}</template>
         </el-alert>
 
@@ -962,6 +1010,7 @@ onUnmounted(() => {
         />
 
         <HelpCenter v-if="visitedMenus.has('about')" v-show="activeMenu === 'about'" :active="activeMenu === 'about'" />
+        <ArtemisPage v-if="visitedMenus.has('artemis')" v-show="activeMenu === 'artemis'" :active="activeMenu === 'artemis'" />
       </main>
     </div>
 

package/src/api.ts

@@ -48,6 +48,11 @@ export async function getAppiumVersion() {
   return readJson<AppiumVersionInfo>(response);
 }
 
+export async function getArtemisVersion() {
+  const response = await fetch(`${APP_BASE}/api/artemis/version`, { signal: AbortSignal.timeout(8000) });
+  return readJson<{ version: string; message: string }>(response);
+}
+
 // 读取已保存的脚本列表，自动化测试页面左侧脚本列表使用。
 export async function getScripts() {
   const response = await fetch(`${APP_BASE}/api/scripts`);