@mobileaidev/ai-app-bridge 0.2.13 → 0.2.14

package/README.md

@@ -121,11 +121,14 @@ on many Android 16 devices; ASCII text can still fall back to ADB when an older
 bridge runtime is running.
 
 When `screenshot` or `smoke` runs without `--out-file`, the CLI writes a unique
-PNG under `build/ai_app_bridge_artifacts` instead of reusing a stable filename
-or creating files in the project root.
-It keeps the newest 20 generated screenshots for each command prefix. Use
-`--artifact-dir` to choose that directory, or `--out-file` when a fixed path is
-intentional.
+PNG under a git-ignored project artifact directory. Gradle, Android, and Flutter
+projects normally use `build/ai_app_bridge_artifacts`; Node projects can use
+`node_modules/.cache/ai_app_bridge_artifacts`; Swift projects can use
+`.build/ai_app_bridge_artifacts`. If the current git worktree has no ignored
+artifact candidate, generated defaults go under `.git/ai_app_bridge_artifacts`
+so they cannot dirty the repository root. It keeps the newest 20 generated
+screenshots for each command prefix. Use `--artifact-dir` to choose an ignored
+directory, or `--out-file` when a fixed path is intentional.
 
 `launch-app` queries Android LAUNCHER activities before starting the app. If a
 debug dependency exposes multiple launcher entries, it returns

package/bin/ai-app-bridge.js

@@ -7,6 +7,13 @@ const net = require('net');
 const os = require('os');
 const path = require('path');
 const { IOSBridgeProvider } = require('./ios-provider');
+const {
+  artifactTimestamp,
+  defaultArtifactDirectory,
+  defaultArtifactPath,
+  sanitizeArtifactExtension,
+  sanitizeArtifactName,
+} = require('./artifact-paths');
 
 const generatedArtifactRetention = 20;
 
@@ -2392,17 +2399,6 @@ function screenshotOutputPath(options = {}, prefix = 'ai_app_bridge_screenshot')
   return defaultArtifactPath(prefix, 'png', { artifactDir: options.artifactDir });
 }
 
-function defaultArtifactPath(prefix, extension, options = {}) {
-  const directory = path.resolve(options.artifactDir || defaultArtifactDirectory());
-  const suffix = [
-    artifactTimestamp(options.now || new Date()),
-    String(options.pid || process.pid),
-    options.randomSuffix || Math.random().toString(36).slice(2, 8),
-  ].join('-');
-  const name = `${sanitizeArtifactName(prefix)}-${suffix}.${sanitizeArtifactExtension(extension)}`;
-  return path.join(directory, name);
-}
-
 async function pruneGeneratedArtifacts(options = {}) {
   const keep = generatedArtifactRetention;
   const result = {
@@ -2475,34 +2471,6 @@ async function pruneGeneratedArtifacts(options = {}) {
   return result;
 }
 
-function artifactTimestamp(date) {
-  const value = date instanceof Date ? date : new Date(date);
-  const pad = (number, size = 2) => String(number).padStart(size, '0');
-  return [
-    value.getUTCFullYear(),
-    pad(value.getUTCMonth() + 1),
-    pad(value.getUTCDate()),
-    '-',
-    pad(value.getUTCHours()),
-    pad(value.getUTCMinutes()),
-    pad(value.getUTCSeconds()),
-    '-',
-    pad(value.getUTCMilliseconds(), 3),
-  ].join('');
-}
-
-function sanitizeArtifactName(value) {
-  return String(value || 'artifact').replace(/[^a-zA-Z0-9_.-]+/g, '_').replace(/^_+|_+$/g, '') || 'artifact';
-}
-
-function sanitizeArtifactExtension(value) {
-  return sanitizeArtifactName(String(value || 'bin').replace(/^\.+/, '')) || 'bin';
-}
-
-function defaultArtifactDirectory() {
-  return path.join(process.cwd(), 'build', 'ai_app_bridge_artifacts');
-}
-
 function escapeRegExp(value) {
   return String(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }

package/bin/artifact-paths.js

@@ -0,0 +1,129 @@
+const { execFileSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const artifactDirectoryName = 'ai_app_bridge_artifacts';
+
+function defaultArtifactDirectory(options = {}) {
+  const cwd = path.resolve(options.cwd || process.cwd());
+  const gitRoot = gitOutput(cwd, ['rev-parse', '--show-toplevel']);
+  if (!gitRoot) {
+    return path.join(cwd, 'build', artifactDirectoryName);
+  }
+
+  for (const directory of artifactDirectoryCandidates(gitRoot)) {
+    if (isGitIgnored(gitRoot, directory)) {
+      return directory;
+    }
+  }
+
+  const gitDirectory = gitOutput(cwd, ['rev-parse', '--absolute-git-dir']);
+  return path.join(gitDirectory || path.join(gitRoot, '.git'), artifactDirectoryName);
+}
+
+function defaultArtifactPath(prefix, extension, options = {}) {
+  const directory = path.resolve(options.artifactDir || defaultArtifactDirectory({ cwd: options.cwd }));
+  const suffix = [
+    artifactTimestamp(options.now || new Date()),
+    String(options.pid || process.pid),
+    options.randomSuffix || Math.random().toString(36).slice(2, 8),
+  ].join('-');
+  const name = `${sanitizeArtifactName(prefix)}-${suffix}.${sanitizeArtifactExtension(extension)}`;
+  return path.join(directory, name);
+}
+
+function artifactDirectoryCandidates(gitRoot) {
+  const root = path.resolve(gitRoot);
+  const candidates = [];
+
+  if (hasAny(root, ['settings.gradle', 'settings.gradle.kts', 'build.gradle', 'build.gradle.kts', 'gradlew', 'pubspec.yaml'])) {
+    candidates.push(path.join(root, 'build', artifactDirectoryName));
+  }
+  if (hasAny(root, ['Package.swift'])) {
+    candidates.push(path.join(root, '.build', artifactDirectoryName));
+  }
+  if (hasAny(root, ['pubspec.yaml'])) {
+    candidates.push(path.join(root, '.dart_tool', artifactDirectoryName));
+  }
+  if (hasAny(root, ['package.json'])) {
+    candidates.push(path.join(root, 'node_modules', '.cache', artifactDirectoryName));
+  }
+  if (hasAny(root, ['Cargo.toml'])) {
+    candidates.push(path.join(root, 'target', artifactDirectoryName));
+  }
+
+  candidates.push(
+    path.join(root, 'build', artifactDirectoryName),
+    path.join(root, '.build', artifactDirectoryName),
+    path.join(root, '.dart_tool', artifactDirectoryName),
+    path.join(root, 'node_modules', '.cache', artifactDirectoryName),
+    path.join(root, 'target', artifactDirectoryName),
+  );
+
+  return [...new Set(candidates)];
+}
+
+function hasAny(root, fileNames) {
+  return fileNames.some((fileName) => fs.existsSync(path.join(root, fileName)));
+}
+
+function isGitIgnored(gitRoot, directory) {
+  const relative = path.relative(gitRoot, directory);
+  if (!relative || relative.startsWith('..') || path.isAbsolute(relative)) {
+    return false;
+  }
+  try {
+    execFileSync('git', ['-C', gitRoot, 'check-ignore', '-q', '--', relative], {
+      stdio: 'ignore',
+      timeout: 2000,
+    });
+    return true;
+  } catch (_) {
+    return false;
+  }
+}
+
+function gitOutput(cwd, args) {
+  try {
+    return execFileSync('git', ['-C', cwd, ...args], {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+      timeout: 2000,
+    }).trim();
+  } catch (_) {
+    return '';
+  }
+}
+
+function artifactTimestamp(date) {
+  const value = date instanceof Date ? date : new Date(date);
+  const pad = (number, size = 2) => String(number).padStart(size, '0');
+  return [
+    value.getUTCFullYear(),
+    pad(value.getUTCMonth() + 1),
+    pad(value.getUTCDate()),
+    '-',
+    pad(value.getUTCHours()),
+    pad(value.getUTCMinutes()),
+    pad(value.getUTCSeconds()),
+    '-',
+    pad(value.getUTCMilliseconds(), 3),
+  ].join('');
+}
+
+function sanitizeArtifactName(value) {
+  return String(value || 'artifact').replace(/[^a-zA-Z0-9_.-]+/g, '_').replace(/^_+|_+$/g, '') || 'artifact';
+}
+
+function sanitizeArtifactExtension(value) {
+  return sanitizeArtifactName(String(value || 'bin').replace(/^\.+/, '')) || 'bin';
+}
+
+module.exports = {
+  artifactDirectoryCandidates,
+  artifactTimestamp,
+  defaultArtifactDirectory,
+  defaultArtifactPath,
+  sanitizeArtifactExtension,
+  sanitizeArtifactName,
+};

package/bin/ios-provider.js

@@ -4,6 +4,7 @@ const http = require('http');
 const os = require('os');
 const path = require('path');
 const { URL } = require('url');
+const { defaultArtifactPath } = require('./artifact-paths');
 
 const defaultRuntimePort = 18080;
 const runtimePortSearchCount = 50;
@@ -304,7 +305,7 @@ class IOSBridgeProvider {
     const device = await this.requireDevice(args);
     const outFile = args.outFile
       ? path.resolve(args.outFile)
-      : defaultArtifactPath('ios-screenshot', 'png', args.artifactDir);
+      : defaultArtifactPath('ios-screenshot', 'png', { artifactDir: args.artifactDir });
     await fs.promises.mkdir(path.dirname(outFile), { recursive: true });
     const command = [
       'device',
@@ -1164,15 +1165,6 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-function defaultArtifactPath(prefix, extension, artifactDir) {
-  const dir = artifactDir ? path.resolve(artifactDir) : path.join(process.cwd(), 'build', 'ai_app_bridge_artifacts');
-  return path.join(dir, `${prefix}-${artifactTimestamp()}.${extension}`);
-}
-
-function artifactTimestamp(date = new Date()) {
-  return date.toISOString().replace(/[-:]/g, '').replace(/\.\d{3}Z$/, 'Z');
-}
-
 module.exports = {
   IOSBridgeProvider,
   formatHostForUrl,

package/bin/mcp-server.js

@@ -6,6 +6,7 @@ const path = require('path');
 const packageInfo = require('../package.json');
 const { IOSBridgeProvider } = require('./ios-provider');
 const { WebBridgeProvider } = require('./web-provider');
+const { defaultArtifactDirectory } = require('./artifact-paths');
 const bridgeDir = __dirname;
 const cliScript = path.join(bridgeDir, 'ai-app-bridge.js');
 const nodeBinary = process.env.AI_APP_BRIDGE_NODE || process.execPath;
@@ -1146,7 +1147,7 @@ async function runSmoke(args) {
 function defaultArtifactDirFor(command, args) {
   if (args.outFile) return '';
   if (command !== 'screenshot' && command !== 'smoke') return '';
-  return path.join(process.cwd(), 'build', 'ai_app_bridge_artifacts');
+  return defaultArtifactDirectory();
 }
 
 function addCommonArgs(cliArgs, args) {
@@ -1289,6 +1290,7 @@ if (require.main === module) {
 module.exports = {
   buildBridgeCliArgs,
   commandDomains,
+  defaultArtifactDirFor,
   mcpHelpText,
   readNextMessage,
   runBatch,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobileaidev/ai-app-bridge",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "Desktop CLI and MCP server for AI App Bridge across Android, iOS, Flutter, WebView, and Web targets.",
   "repository": {
     "type": "git",
@@ -17,6 +17,7 @@
   },
   "files": [
     "bin/ai-app-bridge.js",
+    "bin/artifact-paths.js",
     "bin/mcp-server.js",
     "bin/ios-provider.js",
     "bin/web-provider.js",

package/skills/ai-app-bridge-use/SKILL.md

@@ -30,7 +30,8 @@ AI App Bridge 支持 Android native apps、Android WebView/H5/CDP、Flutter apps
 3. 选择命令路径：按任务类型选 `core`、`app`、`action`、`flutter`、`webview`、`ios`、`web`、`diagnostics` 或 `advanced` 域；不要先退回原始 `adb`、浏览器脚本或坐标猜测。
 4. 用 `batch` 串联相关步骤：观察、操作、等待、截图、tree 验证尽量放进一次 MCP 调用。
 5. 验证可见结果：界面变化必须用 `screenshot` 加 `tree`/`uia-tree` 交叉确认。
-6. 只在需要稳定动态画面时使用 `freeze-app`/`thaw-app`；如果本轮冻结过 app，最终回复前必须解冻。
+6. 生成截图等默认产物时，让 AI Bridge 自动选择会被当前项目 git 忽略的目录；只有确实需要固定路径时才传 `outFile`/`artifactDir`，且路径必须在 `build`、`.build`、`.dart_tool`、`node_modules/.cache`、`target` 或其他已忽略目录内。
+7. 只在需要稳定动态画面时使用 `freeze-app`/`thaw-app`；如果本轮冻结过 app，最终回复前必须解冻。
 
 ## 能力发现和调用