Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
#!/usr/bin/env node
// 启动当前 worktree 的 Metro(dev-client 模式),并把当前 git branch/commit 注入
// EXPO_PUBLIC_XDT_GIT_*,这样 __DEV__ build label 能显示"分支 · 版本 · Metro host:port"。
//
// 为什么用 EXPO_PUBLIC_* 而不是 app.config.js 注入:app.config.js 改动会进
// @expo/fingerprint → 每个 commit 都改 runtimeVersion、破坏 OTA(实测);EXPO_PUBLIC_*
// 是 JS bundle 层注入,不进 fingerprint。
//
// 端口策略(重要):本 app **不含 expo-dev-client**,装好的 debug 包只会连它编译时的默认
// packager 端口(8081)。所以这里**坚持用 8081**,不会自动挪到 8082+ —— 否则 Metro 起在
// 8083、app 还连 8081,反而制造"看着像新版、其实是旧 bundle"的坑(正是本工具要消灭的)。
// - 8081 空闲 → 起在 8081。
// - 8081 已被**本 worktree** 占 → 说明 Metro 已在跑,直接 Fast Refresh 即可,不重开。
// - 8081 被**别的 worktree** 占 → 默认明确报错;传 `--takeover` 时仅在确认占用者是
// Cindy Metro(cwd 以 /apps/mobile 结尾 + 注入了源码指纹)后停止它。不要求对方
// 磁盘上的 git 指纹仍与启动时一致;对方目录已删则视为孤儿 Metro,同样可接管。
// 未知进程 / 非 Metro 即使带 `--takeover` 也 fail closed。
// 确实要换端口请 `--port <p>` 显式指定(你需自行把模拟器里的 app 指过去,如 dev menu)。
//
// 用法(仓库根):
// pnpm mobile:sim:start # Global,起在 8081(app 默认连这个)
// pnpm mobile:sim:start:cn # 中国大陆版;Windows 同时启动 cindy-api36
// pnpm mobile:sim:start -- --region=cn # 中国大陆版
// pnpm mobile:sim:start -- --region=cn --takeover # 显式接管另一个 Metro
// pnpm mobile:sim:start -- --mock # 免登录的 UI 模拟数据(docs/dev-rules/ui-mock-data.md)
// pnpm mobile:sim:start -- --port 8082 # 显式换端口(透传给 expo;需自行把 app 指过去)
// pnpm mobile:sim:start -- --no-emulator # Windows 只启动 Metro
import { execFileSync, spawn } from 'node:child_process';
import { existsSync } from 'node:fs';
import { applySimMockArg, readSimEnvironment } from './lib/sim-environment.mjs';
import { dirname, resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
import { mobileClientBundleEnv } from '../../../scripts/shared/client-endpoint-build-env.mjs';
import {
resolvePnpmInvocation,
usablePnpmExecPath,
} from '../../../scripts/shared/pnpm-invocation.mjs';
import { ensureMobileEnv, formatMobileEnvStatus } from './ensure-mobile-env.mjs';
import {
ensureWindowsAndroidEmulator,
extractAndroidSimulatorArgs,
} from './lib/android-simulator.mjs';
import {
extractMobileDevRegionArgs,
withLocalMobileRegionConfig,
} from './lib/mobile-dev-region.mjs';
import {
classifySimMetroListener,
extractSimMetroPortArgs,
extractSimTakeoverArgs,
resolveSimMetroHandoff,
} from './lib/sim-whoami.mjs';
import {
ensureMobileLocalRegionConfig,
formatMobileLocalConfigStatus,
} from './lib/mobile-local-config.mjs';
import {
clearMetroOwner,
gitSourceIdentity,
isMetroPid,
portInUse,
probeMetroOwnership,
terminateMetro,
writeMetroOwner,
} from './sim-metro.mjs';
const mobileDir = resolve(dirname(fileURLToPath(import.meta.url)), '..');
const worktreeRoot = resolve(mobileDir, '../..');
const DEFAULT_PORT = 8081;
const { region, passthrough: regionPassthrough } = extractMobileDevRegionArgs(applySimMockArg(process.argv.slice(2)));
const { takeover, passthrough: takeoverPassthrough } = extractSimTakeoverArgs(regionPassthrough);
const androidArgs = extractAndroidSimulatorArgs(takeoverPassthrough);
const portArgs = extractSimMetroPortArgs(androidArgs.passthrough, DEFAULT_PORT);
if (takeover && portArgs.explicit) {
console.error(`✗ --takeover 只用于隐式默认端口 ${DEFAULT_PORT},不能和显式 --port 混用。`);
process.exit(1);
}
const localConfigResult = ensureMobileLocalRegionConfig({ mobileDir });
const localConfigStatus = formatMobileLocalConfigStatus(localConfigResult, worktreeRoot);
if (localConfigStatus) console.log(localConfigStatus);
const buildEnv = withLocalMobileRegionConfig(
mobileClientBundleEnv({ authRegion: region }),
);
const envResult = ensureMobileEnv({ mobileDir, authRegion: region, endpointEnv: buildEnv });
console.log(formatMobileEnvStatus(envResult, worktreeRoot));
const envChanged = envResult.created || envResult.addedKeys.length > 0;
const { loginScenario, uiMock, envFingerprint } = readSimEnvironment(mobileDir, buildEnv);
if (uiMock) console.log('› --mock:免登录的 UI 模拟数据(docs/dev-rules/ui-mock-data.md)');
function git(args) {
try {
return execFileSync('git', args, { cwd: mobileDir, encoding: 'utf8' }).trim();
} catch {
return '';
}
}
const branch = git(['branch', '--show-current']) || git(['rev-parse', '--short', 'HEAD']);
const commit = git(['rev-parse', '--short', 'HEAD']);
const sourceIdentity = gitSourceIdentity(worktreeRoot);
async function ensureAndroidTarget() {
if (!androidArgs.startEmulator) return;
await ensureWindowsAndroidEmulator({ avd: androidArgs.avd, port: portArgs.port });
}
// 默认端口始终执行身份闸门;显式其它端口由开发者自行把 App 指过去。
const args = ['exec', 'expo', 'start', '--dev-client', ...portArgs.passthrough];
if (portArgs.port === DEFAULT_PORT) {
if (await portInUse(DEFAULT_PORT)) {
const ownership = probeMetroOwnership(DEFAULT_PORT);
const pid = ownership?.pid ?? null;
const cwd = ownership?.cwd ?? null;
const runningSource = ownership?.source ?? null;
const listener = classifySimMetroListener({
cwd,
source: runningSource,
targetWorktree: worktreeRoot,
});
const listenerWorktreeExists = Boolean(listener.worktree && existsSync(listener.worktree));
const decision = resolveSimMetroHandoff({
port: DEFAULT_PORT,
cwd,
takeover,
envChanged,
currentSource: sourceIdentity,
runningSource,
currentRegion: region,
runningRegion: ownership?.region,
currentEnvFingerprint: envFingerprint,
runningEnvFingerprint: ownership?.envFingerprint,
listener,
listenerWorktreeExists,
});
if (decision.action === 'reuse') {
for (const line of decision.lines) console.log(line);
await ensureAndroidTarget();
process.exit(0);
}
if (decision.action === 'refuse') {
for (const line of decision.lines) console.error(line);
process.exit(1);
}
const confirmedMetro = process.platform === 'win32'
? Boolean(ownership?.cwd && ownership?.source)
: Boolean(pid && isMetroPid(pid));
if (!pid || !confirmedMetro) {
console.error(`✗ ${DEFAULT_PORT} 上的进程不是可确认的 Metro,拒绝接管。`);
process.exit(1);
}
const stopped = await terminateMetro(ownership?.launcherPid ?? pid, { worktreeRoot: listener.worktree });
if (!stopped) {
console.error(`✗ 无法在限定时间内停止旧 Metro(pid=${pid}),拒绝继续。`);
process.exit(1);
}
if (decision.code === 'occupied-orphan') {
console.log(`✓ 已停止已删除 worktree 的孤儿 Metro(pid=${pid}, cwd=${cwd})。`);
} else if (listener.isTarget) {
console.log(`✓ 已重启当前 worktree 的 Metro(pid=${pid}, cwd=${cwd})。`);
} else {
console.log(`✓ 已接管其他 Cindy worktree 的 Metro(pid=${pid}, cwd=${cwd})。`);
}
}
} else if (await portInUse(portArgs.port)) {
// Do not let a failed second launcher overwrite (then clear) the live owner.
console.error(`✗ Metro port ${portArgs.port} is already in use; stop its owner or choose another --port.`);
process.exit(1);
}
await ensureAndroidTarget();
// 统一规范化成 Expo 明确支持的 `--port <n>`,避免 `--port=<n>` 被本工具识别、
// 却在端口归属检查和启动参数之间产生分歧。
args.push('--port', String(portArgs.port));
console.log(`› sim:start — region=${region} source=${sourceIdentity}`);
const portArgIdx = args.indexOf('--port');
if (portArgIdx >= 0) console.log(` Metro 端口:${args[portArgIdx + 1]}(模拟器 build label 会显示 host:port,确认没连错分支)`);
console.log(' 注入 EXPO_PUBLIC_XDT_GIT_SOURCE / EXPO_PUBLIC_XDT_GIT_BRANCH / EXPO_PUBLIC_XDT_GIT_COMMIT 给 __DEV__ build label\n');
// 用 `pnpm exec expo`:pnpm 不在 apps/mobile/node_modules/.bin 放 expo bin,但 pnpm exec
// 能按包依赖解析到 expo CLI(直接 node node_modules/.bin/expo 会 MODULE_NOT_FOUND)。
const invocation = resolvePnpmInvocation(args, {
npmExecPath: usablePnpmExecPath(process.env.npm_execpath, existsSync),
});
const child = spawn(invocation.command, invocation.args, {
cwd: mobileDir,
stdio: 'inherit',
env: {
...process.env,
...buildEnv,
...(invocation.env ?? {}),
EXPO_PUBLIC_XDT_GIT_BRANCH: branch,
EXPO_PUBLIC_XDT_GIT_COMMIT: commit,
EXPO_PUBLIC_XDT_GIT_SOURCE: sourceIdentity,
},
shell: invocation.shell,
windowsVerbatimArguments: invocation.windowsVerbatimArguments,
});
if (Number.isInteger(child.pid)) {
writeMetroOwner(portArgs.port, {
pid: child.pid,
launcherPid: child.pid,
source: sourceIdentity,
region,
loginScenario,
envFingerprint,
worktreeRoot,
});
child.once('exit', () => clearMetroOwner(portArgs.port, child.pid));
}
child.once('error', (error) => {
console.error(`✗ 无法启动 Metro: ${error.message}`);
process.exit(1);
});
child.on('exit', (code) => process.exit(code ?? 0));