android-midscene-automation 0.1.2 → 0.1.5

package/bin/android-midscene-automation.js

@@ -9,6 +9,7 @@ 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();
 
 if (!args.includes('--host')) {
   args.unshift('127.0.0.1');
@@ -17,7 +18,11 @@ if (!args.includes('--host')) {
 
 const child = spawn(process.execPath, [viteBin, ...args], {
   cwd: packageRoot,
-  env: process.env,
+  env: {
+    ...process.env,
+    ANDROID_MIDSCENE_PACKAGE_ROOT: process.env.ANDROID_MIDSCENE_PACKAGE_ROOT || packageRoot,
+    ANDROID_MIDSCENE_DATA_ROOT: process.env.ANDROID_MIDSCENE_DATA_ROOT || userRoot,
+  },
   stdio: 'inherit',
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "android-midscene-automation",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "type": "module",
   "bin": {
     "android-midscene-automation": "./bin/android-midscene-automation.js"
@@ -30,7 +30,6 @@
     "@vitejs/plugin-vue": "^6.0.1",
     "element-plus": "^2.11.1",
     "openai": "^5.12.2",
-    "playwright": "^1.54.1",
     "tsx": "^4.20.3",
     "typescript": "^5.8.3",
     "vite": "^7.0.4",

package/server/appium-recorder/appium-runner.ts

@@ -2,6 +2,7 @@ import { execFile } from 'node:child_process';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import type { AppiumRecordedScriptRecord, AppiumRecordedStepRecord } from './repository';
+import { appDataPath } from '../paths';
 
 type AppiumSessionResponse = {
   value?: {
@@ -240,7 +241,7 @@ async function waitForElementGone(sessionId: string, step: AppiumRecordedStepRec
 async function saveScreenshot(sessionId: string) {
   const payload = await appiumRequest<AppiumValueResponse<string>>(`/session/${sessionId}/screenshot`);
   if (!payload.value) throw new Error('Appium 未返回截图数据');
-  const dir = join(process.cwd(), '.midscene-app', 'screenshots');
+  const dir = appDataPath('.midscene-app', 'screenshots');
   await mkdir(dir, { recursive: true });
   const file = join(dir, `appium-${Date.now()}.png`);
   await writeFile(file, Buffer.from(payload.value, 'base64'));

package/server/config-store.ts

@@ -1,8 +1,5 @@
-import { execFileSync } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-import { appPath } from './paths';
 import type { AppConfig } from './config';
+import { querySql, runSql, sqlString } from './storage/sqlite';
 
 export type AppPresetRecord = {
   id: string;
@@ -20,39 +17,12 @@ type AppPresetRow = {
   updated_at: string;
 };
 
-const dbPath = appPath('.midscene-app', 'script-cache.sqlite');
-const sqliteBin = process.env.SQLITE3_BIN || '/usr/bin/sqlite3';
 let initialized = false;
 
 function createId() {
   return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
 }
 
-function ensureDbDir() {
-  fs.mkdirSync(path.dirname(dbPath), { recursive: true });
-}
-
-function sqlString(value: string) {
-  return `'${value.replace(/'/g, "''")}'`;
-}
-
-function runSql(sql: string) {
-  ensureDbDir();
-  execFileSync(sqliteBin, [dbPath], {
-    input: sql,
-    maxBuffer: 20 * 1024 * 1024,
-  });
-}
-
-function querySql<T>(sql: string) {
-  ensureDbDir();
-  const output = execFileSync(sqliteBin, ['-json', dbPath, sql], {
-    encoding: 'utf8',
-    maxBuffer: 20 * 1024 * 1024,
-  });
-  return JSON.parse(output || '[]') as T[];
-}
-
 function rowToAppPreset(row: AppPresetRow): AppPresetRecord {
   return {
     id: row.id,

package/server/config.ts

@@ -1,7 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import YAML from 'yaml';
-import { appPath } from './paths';
+import { appDataPath } from './paths';
 import { loadModelConfigFromDb, saveModelConfigToDb } from './config-store';
 
 export type AppConfig = {
@@ -25,8 +25,8 @@ export type AppConfig = {
 };
 
 let cachedConfig: AppConfig | null = null;
-const configPath = appPath('config.json');
-const legacyConfigPath = appPath('config.yaml');
+const configPath = appDataPath('config.json');
+const legacyConfigPath = appDataPath('config.yaml');
 
 function defaultConfig(): AppConfig {
   return {

package/server/http-api.ts

@@ -94,6 +94,10 @@ function writeNdjson(res: ServerResponse, event: RunGeneratedScriptEvent | { typ
   res.write(`${JSON.stringify(event)}\n`);
 }
 
+function npxCommand() {
+  return process.platform === 'win32' ? 'npx.cmd' : 'npx';
+}
+
 type AndroidDevice = {
   id: string;
   status: string;
@@ -506,7 +510,7 @@ export function createApiMiddleware() {
       };
     }
 
-    playgroundProcess = spawn('npx', ['--yes', '@midscene/android-playground'], {
+    playgroundProcess = spawn(npxCommand(), ['--yes', '@midscene/android-playground'], {
       cwd: appPath(),
       env: {
         ...process.env,
@@ -515,6 +519,10 @@ export function createApiMiddleware() {
       stdio: 'ignore',
       detached: false,
     });
+    playgroundProcess.once('error', (error) => {
+      console.warn(`Android Playground 启动失败：${error.message}`);
+      playgroundProcess = null;
+    });
     playgroundProcess.once('exit', () => {
       playgroundProcess = null;
     });

package/server/model-call-usage-importer.ts

@@ -1,6 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
-import { appPath } from './paths';
+import { appDataPath } from './paths';
 import { saveModelUsageRecord } from './model-usage-repository';
 
 type MidsceneModelConfig = {
@@ -31,7 +31,7 @@ type ModelCallRecord = {
 };
 
 function modelRequestDir() {
-  return appPath('midscene_run', 'model-requests');
+  return appDataPath('midscene_run', 'model-requests');
 }
 
 function numberValue(value: unknown) {

package/server/paths.ts

@@ -9,11 +9,15 @@
 // the standalone flow behaves exactly as before.
 import path from 'node:path';
 
-let appRoot = process.cwd();
+let appRoot = process.env.ANDROID_MIDSCENE_PACKAGE_ROOT || process.cwd();
+let appDataRoot = process.env.ANDROID_MIDSCENE_DATA_ROOT || appRoot;
 
 /** Point all app runtime paths at an explicit root (used by the DSH plugin). */
 export function setAppRoot(root: string) {
   appRoot = root;
+  if (!process.env.ANDROID_MIDSCENE_DATA_ROOT) {
+    appDataRoot = root;
+  }
 }
 
 /** The current app root (defaults to process.cwd()). */
@@ -25,3 +29,8 @@ export function getAppRoot() {
 export function appPath(...segments: string[]) {
   return path.resolve(appRoot, ...segments);
 }
+
+/** Resolve one or more segments under the writable user data root. */
+export function appDataPath(...segments: string[]) {
+  return path.resolve(appDataRoot, ...segments);
+}

package/server/script-db.ts

@@ -1,7 +1,7 @@
-import { execFileSync } from 'node:child_process';
 import fs from 'node:fs';
-import path from 'node:path';
 import { appPath } from './paths';
+import { appDataPath } from './paths';
+import { querySql, runSql, sqlString, sqlJson } from './storage/sqlite';
 
 export type ScriptStepRecord = {
   id?: string;
@@ -39,40 +39,14 @@ type ScriptRow = {
   updated_at: string;
 };
 
-const dbPath = appPath('.midscene-app', 'script-cache.sqlite');
-const legacyJsonPath = appPath('midscene_run', 'script-db.json');
-const sqliteBin = process.env.SQLITE3_BIN || '/usr/bin/sqlite3';
+const dbPath = appDataPath('.midscene-app', 'script-cache.sqlite');
+const legacyJsonPath = appDataPath('midscene_run', 'script-db.json');
 let initialized = false;
 
 function createId() {
   return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
 }
 
-function ensureDbDir() {
-  fs.mkdirSync(path.dirname(dbPath), { recursive: true });
-}
-
-function sqlString(value: string) {
-  return `'${value.replace(/'/g, "''")}'`;
-}
-
-function runSql(sql: string) {
-  ensureDbDir();
-  execFileSync(sqliteBin, [dbPath], {
-    input: sql,
-    maxBuffer: 20 * 1024 * 1024,
-  });
-}
-
-function querySql<T>(sql: string) {
-  ensureDbDir();
-  const output = execFileSync(sqliteBin, ['-json', dbPath, sql], {
-    encoding: 'utf8',
-    maxBuffer: 20 * 1024 * 1024,
-  });
-  return JSON.parse(output || '[]') as T[];
-}
-
 function rowToRecord(row: ScriptRow): ScriptRecord {
   return {
     id: row.id,

package/server/script-runner.ts

@@ -1,9 +1,10 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
 import { pathToFileURL } from 'node:url';
 import ts from 'typescript';
-import { appPath } from './paths';
+import { appDataPath, appPath } from './paths';
 import {
   getScriptRecord,
   removeScriptRecord,
@@ -14,6 +15,8 @@ import {
 
 const STEP_EVENT_PREFIX = '__MIDSCENE_STEP_EVENT__';
 const SCRIPT_TIMEOUT_MS = Number(process.env.MIDSCENE_SCRIPT_TIMEOUT_MS || 600_000);
+const require = createRequire(import.meta.url);
+const tsxBin = path.join(path.dirname(require.resolve('tsx/package.json')), 'dist', 'cli.mjs');
 
 function injectMidsceneEnv(code: string) {
   const configModuleUrl = pathToFileURL(appPath('server', 'config.ts')).href;
@@ -27,7 +30,7 @@ function toScriptFileName(scriptName: string) {
 }
 
 export function checkGeneratedScriptExists(input: { scriptName: string }) {
-  const outputDir = appPath('scripts-output');
+  const outputDir = appDataPath('scripts-output');
   const filePath = path.join(outputDir, toScriptFileName(input.scriptName));
   return {
     exists: fs.existsSync(filePath),
@@ -44,7 +47,7 @@ export function saveGeneratedScript(input: {
 }) {
   validateGeneratedScriptCode(input.code);
 
-  const outputDir = appPath('scripts-output');
+  const outputDir = appDataPath('scripts-output');
   fs.mkdirSync(outputDir, { recursive: true });
 
   const filePath = path.join(outputDir, toScriptFileName(input.scriptName));
@@ -129,7 +132,7 @@ export function deleteGeneratedScript(input: { id: string }) {
     };
   }
 
-  const outputDir = appPath('scripts-output');
+  const outputDir = appDataPath('scripts-output');
   const filePath = path.resolve(record.filePath);
   const canDeleteFile = filePath.startsWith(`${outputDir}${path.sep}`) && fs.existsSync(filePath);
   if (canDeleteFile) {
@@ -432,8 +435,8 @@ export async function runGeneratedScript(input: {
   fs.writeFileSync(filePath, injectMidsceneEnv(resolveExecutableCode(input)), 'utf8');
 
   return await new Promise<{ success: boolean; output: string; filePath: string }>((resolve) => {
-    const child = spawn('npx', ['tsx', filePath], {
-      cwd: appPath(),
+    const child = spawn(process.execPath, [tsxBin, filePath], {
+      cwd: appDataPath(),
       env: {
         ...process.env,
         MIDSCENE_RECORD_MODEL_CALL: 'true',

package/server/storage/sqlite.ts

@@ -1,10 +1,12 @@
 import { execFileSync } from 'node:child_process';
 import fs from 'node:fs';
+import { createRequire } from 'node:module';
 import path from 'node:path';
-import { appPath } from '../paths';
+import { appDataPath } from '../paths';
 
-const dbPath = appPath('.midscene-app', 'script-cache.sqlite');
-const sqliteBin = process.env.SQLITE3_BIN || '/usr/bin/sqlite3';
+const dbPath = appDataPath('.midscene-app', 'script-cache.sqlite');
+const require = createRequire(import.meta.url);
+let databaseSyncCtor: unknown;
 
 export function getRuntimeDbPath() {
   return dbPath;
@@ -30,20 +32,81 @@ function ensureDbDir() {
   fs.mkdirSync(path.dirname(dbPath), { recursive: true });
 }
 
-// 使用 sqlite3 CLI 保持项目零新增依赖；所有运行态功能共用同一个 SQLite 文件。
+function getSqliteBin() {
+  return process.env.SQLITE3_BIN || (process.platform === 'win32' ? 'sqlite3.exe' : 'sqlite3');
+}
+
+function getDatabaseSync() {
+  if (databaseSyncCtor !== undefined) {
+    return databaseSyncCtor as null | { new (filename: string): { exec(sql: string): void; prepare(sql: string): { all(): unknown[] }; close(): void } };
+  }
+
+  try {
+    databaseSyncCtor = (require('node:sqlite') as {
+      DatabaseSync?: { new (filename: string): { exec(sql: string): void; prepare(sql: string): { all(): unknown[] }; close(): void } };
+    }).DatabaseSync || null;
+  } catch {
+    databaseSyncCtor = null;
+  }
+
+  return databaseSyncCtor as null | { new (filename: string): { exec(sql: string): void; prepare(sql: string): { all(): unknown[] }; close(): void } };
+}
+
+function runWithNodeSqlite<T>(callback: (db: InstanceType<NonNullable<ReturnType<typeof getDatabaseSync>>>) => T) {
+  const DatabaseSync = getDatabaseSync();
+  if (!DatabaseSync) {
+    return null;
+  }
+
+  const db = new DatabaseSync(dbPath);
+  try {
+    return callback(db as InstanceType<NonNullable<ReturnType<typeof getDatabaseSync>>>);
+  } finally {
+    db.close();
+  }
+}
+
+function explainSqliteCliError(error: unknown) {
+  if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {
+    throw error;
+  }
+
+  throw new Error(
+    `未找到 sqlite3 命令。请安装 sqlite3 并加入 PATH，或通过 SQLITE3_BIN 指定 sqlite3 可执行文件路径。当前尝试执行：${getSqliteBin()}`,
+  );
+}
+
+// 优先使用 Node 24 内置 sqlite；旧 Node 再回退到 sqlite3 CLI。
 export function runSql(sql: string) {
   ensureDbDir();
-  execFileSync(sqliteBin, [dbPath], {
-    input: sql,
-    maxBuffer: 40 * 1024 * 1024,
+  const result = runWithNodeSqlite((db) => {
+    db.exec(sql);
+    return true;
   });
+  if (result) return;
+
+  try {
+    execFileSync(getSqliteBin(), [dbPath], {
+      input: sql,
+      maxBuffer: 40 * 1024 * 1024,
+    });
+  } catch (error) {
+    explainSqliteCliError(error);
+  }
 }
 
 export function querySql<T>(sql: string) {
   ensureDbDir();
-  const output = execFileSync(sqliteBin, ['-json', dbPath, sql], {
-    encoding: 'utf8',
-    maxBuffer: 40 * 1024 * 1024,
-  });
-  return JSON.parse(output || '[]') as T[];
+  const result = runWithNodeSqlite((db) => db.prepare(sql).all() as T[]);
+  if (result) return result;
+
+  try {
+    const output = execFileSync(getSqliteBin(), ['-json', dbPath, sql], {
+      encoding: 'utf8',
+      maxBuffer: 40 * 1024 * 1024,
+    });
+    return JSON.parse(output || '[]') as T[];
+  } catch (error) {
+    explainSqliteCliError(error);
+  }
 }