@reconcrap/boss-recommend-mcp 2.0.50 → 2.0.52

package/README.md

@@ -134,8 +134,8 @@ node src/cli.js start
 
 全局 npm 安装会自动运行 `boss-recommend-mcp install`。该安装器会在 Windows 和 macOS 上自动检测 Trae / Trae CN / OpenClaw / QClaw 的常见配置目录：
 
-- Windows: `%APPDATA%\Trae*\User\mcp.json`、`%USERPROFILE%\.trae*\mcp.json`、`%USERPROFILE%\.openclaw\mcp.json`、`%APPDATA%\OpenClaw\User\mcp.json`、`%USERPROFILE%\.qclaw\openclaw.json`
-- macOS: `~/Library/Application Support/Trae*/User/mcp.json`、`~/.trae*/mcp.json`、`~/.openclaw/mcp.json`、`~/Library/Application Support/OpenClaw/User/mcp.json`
+- Windows: `%APPDATA%\Trae*\User\mcp.json`、`%USERPROFILE%\.trae*\mcp.json`、`%USERPROFILE%\.openclaw\mcp.json`、`%USERPROFILE%\.openclaw\openclaw.json`、`%APPDATA%\OpenClaw\User\mcp.json`、`%USERPROFILE%\.qclaw\openclaw.json`
+- macOS: `~/Library/Application Support/Trae*/User/mcp.json`、`~/.trae*/mcp.json`、`~/.openclaw/mcp.json`、`~/.openclaw/openclaw.json`、`~/Library/Application Support/OpenClaw/User/mcp.json`
 
 如果检测到 legacy Boss server entries，installer 会：
 

package/config/screening-config.example.json

@@ -1,4 +1,4 @@
-{
+{
   "baseUrl": "https://api.openai.com/v1",
   "apiKey": "replace-with-openai-api-key",
   "model": "gpt-4.1-mini",

package/package.json

@@ -1,120 +1,120 @@
-{
-  "name": "@reconcrap/boss-recommend-mcp",
-  "version": "2.0.50",
-  "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
-  "keywords": [
-    "boss",
-    "mcp",
-    "codex",
-    "recruiting",
-    "boss-zhipin",
-    "recommend"
-  ],
-  "type": "module",
-  "main": "src/index.js",
-  "bin": {
-    "boss-recommend-mcp": "bin/boss-recommend-mcp.js"
-  },
-  "scripts": {
-    "start": "node src/index.js",
-    "cli": "node src/cli.js",
-    "install:local": "node src/cli.js install",
-    "postinstall": "node scripts/postinstall.cjs",
-    "test:parser": "node src/test-parser.js",
-    "test:run-state": "node src/test-run-state.js",
-    "test:cdp-browser": "node src/test-cdp-browser.js",
-    "test:core-capture": "node src/test-core-capture.js",
-    "test:core-cv-capture-target": "node src/test-core-cv-capture-target.js",
-    "test:core-cv-acquisition": "node src/test-core-cv-acquisition.js",
-    "test:core-greet-quota": "node src/test-core-greet-quota.js",
-    "test:core-infinite-list": "node src/test-core-infinite-list.js",
-    "test:core-reporting": "node src/test-core-reporting.js",
-    "test:core-run": "node src/test-core-run.js",
-    "test:core-screening": "node src/test-core-screening.js",
-    "test:core-self-heal": "node src/test-core-self-heal.js",
-    "test:installer-migration": "node src/test-installer-migration.js",
-    "test:recommend-actions": "node src/test-recommend-actions.js",
-    "test:recommend-domain": "node src/test-recommend-domain.js",
-    "test:recommend-run-service": "node src/test-recommend-run-service.js",
-    "test:recommend-mcp": "node src/test-recommend-mcp.js",
-    "test:recruit-domain": "node src/test-recruit-domain.js",
-    "test:recruit-mcp": "node src/test-recruit-mcp.js",
-    "test:chat-domain": "node src/test-chat-domain.js",
-    "test:chat-run-service": "node src/test-chat-run-service.js",
-    "test:chat-mcp": "node src/test-chat-mcp.js",
-    "test:async": "node src/test-index-async.js",
-    "test:runtime-scan": "node src/test-runtime-scan.js",
-    "scan:runtime": "node scripts/scan-forbidden-runtime.js",
-    "scan:runtime:json": "node scripts/scan-forbidden-runtime.js --json",
-    "scan:runtime:strict": "node scripts/scan-forbidden-runtime.js --fail-on-findings",
-    "scan:runtime:package": "node scripts/scan-forbidden-runtime.js --package-surface",
-    "scan:runtime:package:strict": "node scripts/scan-forbidden-runtime.js --package-surface --fail-on-legacy",
-    "scan:legacy-boundary": "node scripts/scan-legacy-boundary.js",
-    "scan:package-boundary": "node scripts/scan-package-boundary.js",
-    "gate:phase9-static": "node scripts/phase9-static-gate.js",
-    "gate:phase10-complete": "node scripts/phase10-completion-gate.js",
-    "live:cdp-smoke": "node scripts/live-cdp-smoke.js",
-    "live:run-lifecycle": "node scripts/live-run-lifecycle-smoke.js",
-    "live:screening": "node scripts/live-screening-smoke.js",
-    "live:detail": "node scripts/live-detail-smoke.js",
-    "live:infinite-list": "node scripts/live-infinite-list-smoke.js",
-    "live:scroll-end": "node scripts/live-scroll-end-screenshot.js",
-    "live:refresh-round": "node scripts/live-refresh-round-smoke.js",
-    "live:recommend-recovery": "node scripts/live-recommend-recovery-smoke.js",
-    "live:self-heal": "node scripts/live-self-heal-smoke.js",
-    "live:recommend-actions": "node scripts/live-recommend-actions-smoke.js",
-    "live:recommend-phase10-full": "node scripts/live-recommend-phase10-full.js",
-    "live:recommend-domain": "node scripts/live-recommend-domain-smoke.js",
-    "live:recommend-run-service": "node scripts/live-recommend-run-service-smoke.js",
-    "live:recommend-mcp": "node scripts/live-recommend-mcp-smoke.js",
-    "live:search-phase10-full": "node scripts/live-search-phase10-full.js",
-    "live:recruit-domain": "node scripts/live-recruit-domain-smoke.js",
-    "live:recruit-run-service": "node scripts/live-recruit-run-service-smoke.js",
-    "live:recruit-mcp": "node scripts/live-recruit-mcp-smoke.js",
-    "live:chat-domain": "node scripts/live-chat-domain-smoke.js",
-    "live:chat-run-service": "node scripts/live-chat-run-service-smoke.js",
-    "live:chat-mcp": "node scripts/live-chat-mcp-smoke.js",
-    "live:cv-capture-target": "node scripts/live-cv-capture-target-smoke.js",
-    "live:chat-phase10-full": "node scripts/live-chat-phase10-full.js",
-    "live:chat-image-screening": "node scripts/live-chat-image-screening-smoke.js"
-  },
-  "files": [
-    "bin",
-    "config/screening-config.example.json",
-    "skills",
-    "scripts/postinstall.cjs",
-    "src/core",
-    "src/domains",
-    "src/chat-mcp.js",
-    "src/chat-runtime-config.js",
-    "src/cli.js",
-    "src/index.js",
-    "src/parser.js",
-    "src/recommend-mcp.js",
-    "src/recruit-mcp.js",
-    "src/run-state.js",
-    "README.md"
-  ],
-  "dependencies": {
-    "chrome-remote-interface": "^0.33.3",
-    "sharp": "^0.34.4",
-    "ws": "^8.19.0"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "license": "MIT",
-  "devDependencies": {},
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/reconcrap-cpu/boss-recommend-mcp.git"
-  },
-  "author": "",
-  "bugs": {
-    "url": "https://github.com/reconcrap-cpu/boss-recommend-mcp/issues"
-  },
-  "homepage": "https://github.com/reconcrap-cpu/boss-recommend-mcp#readme"
-}
+{
+  "name": "@reconcrap/boss-recommend-mcp",
+  "version": "2.0.52",
+  "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
+  "keywords": [
+    "boss",
+    "mcp",
+    "codex",
+    "recruiting",
+    "boss-zhipin",
+    "recommend"
+  ],
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "boss-recommend-mcp": "bin/boss-recommend-mcp.js"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "cli": "node src/cli.js",
+    "install:local": "node src/cli.js install",
+    "postinstall": "node scripts/postinstall.cjs",
+    "test:parser": "node src/test-parser.js",
+    "test:run-state": "node src/test-run-state.js",
+    "test:cdp-browser": "node src/test-cdp-browser.js",
+    "test:core-capture": "node src/test-core-capture.js",
+    "test:core-cv-capture-target": "node src/test-core-cv-capture-target.js",
+    "test:core-cv-acquisition": "node src/test-core-cv-acquisition.js",
+    "test:core-greet-quota": "node src/test-core-greet-quota.js",
+    "test:core-infinite-list": "node src/test-core-infinite-list.js",
+    "test:core-reporting": "node src/test-core-reporting.js",
+    "test:core-run": "node src/test-core-run.js",
+    "test:core-screening": "node src/test-core-screening.js",
+    "test:core-self-heal": "node src/test-core-self-heal.js",
+    "test:installer-migration": "node src/test-installer-migration.js",
+    "test:recommend-actions": "node src/test-recommend-actions.js",
+    "test:recommend-domain": "node src/test-recommend-domain.js",
+    "test:recommend-run-service": "node src/test-recommend-run-service.js",
+    "test:recommend-mcp": "node src/test-recommend-mcp.js",
+    "test:recruit-domain": "node src/test-recruit-domain.js",
+    "test:recruit-mcp": "node src/test-recruit-mcp.js",
+    "test:chat-domain": "node src/test-chat-domain.js",
+    "test:chat-run-service": "node src/test-chat-run-service.js",
+    "test:chat-mcp": "node src/test-chat-mcp.js",
+    "test:async": "node src/test-index-async.js",
+    "test:runtime-scan": "node src/test-runtime-scan.js",
+    "scan:runtime": "node scripts/scan-forbidden-runtime.js",
+    "scan:runtime:json": "node scripts/scan-forbidden-runtime.js --json",
+    "scan:runtime:strict": "node scripts/scan-forbidden-runtime.js --fail-on-findings",
+    "scan:runtime:package": "node scripts/scan-forbidden-runtime.js --package-surface",
+    "scan:runtime:package:strict": "node scripts/scan-forbidden-runtime.js --package-surface --fail-on-legacy",
+    "scan:legacy-boundary": "node scripts/scan-legacy-boundary.js",
+    "scan:package-boundary": "node scripts/scan-package-boundary.js",
+    "gate:phase9-static": "node scripts/phase9-static-gate.js",
+    "gate:phase10-complete": "node scripts/phase10-completion-gate.js",
+    "live:cdp-smoke": "node scripts/live-cdp-smoke.js",
+    "live:run-lifecycle": "node scripts/live-run-lifecycle-smoke.js",
+    "live:screening": "node scripts/live-screening-smoke.js",
+    "live:detail": "node scripts/live-detail-smoke.js",
+    "live:infinite-list": "node scripts/live-infinite-list-smoke.js",
+    "live:scroll-end": "node scripts/live-scroll-end-screenshot.js",
+    "live:refresh-round": "node scripts/live-refresh-round-smoke.js",
+    "live:recommend-recovery": "node scripts/live-recommend-recovery-smoke.js",
+    "live:self-heal": "node scripts/live-self-heal-smoke.js",
+    "live:recommend-actions": "node scripts/live-recommend-actions-smoke.js",
+    "live:recommend-phase10-full": "node scripts/live-recommend-phase10-full.js",
+    "live:recommend-domain": "node scripts/live-recommend-domain-smoke.js",
+    "live:recommend-run-service": "node scripts/live-recommend-run-service-smoke.js",
+    "live:recommend-mcp": "node scripts/live-recommend-mcp-smoke.js",
+    "live:search-phase10-full": "node scripts/live-search-phase10-full.js",
+    "live:recruit-domain": "node scripts/live-recruit-domain-smoke.js",
+    "live:recruit-run-service": "node scripts/live-recruit-run-service-smoke.js",
+    "live:recruit-mcp": "node scripts/live-recruit-mcp-smoke.js",
+    "live:chat-domain": "node scripts/live-chat-domain-smoke.js",
+    "live:chat-run-service": "node scripts/live-chat-run-service-smoke.js",
+    "live:chat-mcp": "node scripts/live-chat-mcp-smoke.js",
+    "live:cv-capture-target": "node scripts/live-cv-capture-target-smoke.js",
+    "live:chat-phase10-full": "node scripts/live-chat-phase10-full.js",
+    "live:chat-image-screening": "node scripts/live-chat-image-screening-smoke.js"
+  },
+  "files": [
+    "bin",
+    "config/screening-config.example.json",
+    "skills",
+    "scripts/postinstall.cjs",
+    "src/core",
+    "src/domains",
+    "src/chat-mcp.js",
+    "src/chat-runtime-config.js",
+    "src/cli.js",
+    "src/index.js",
+    "src/parser.js",
+    "src/recommend-mcp.js",
+    "src/recruit-mcp.js",
+    "src/run-state.js",
+    "README.md"
+  ],
+  "dependencies": {
+    "chrome-remote-interface": "^0.33.3",
+    "sharp": "^0.34.4",
+    "ws": "^8.19.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "devDependencies": {},
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reconcrap-cpu/boss-recommend-mcp.git"
+  },
+  "author": "",
+  "bugs": {
+    "url": "https://github.com/reconcrap-cpu/boss-recommend-mcp/issues"
+  },
+  "homepage": "https://github.com/reconcrap-cpu/boss-recommend-mcp#readme"
+}

package/src/cli.js

@@ -7,10 +7,10 @@ import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
 import {
   assertNoForbiddenCdpCalls,
-  buildBossChromeLaunchArgs,
   bringPageToFront,
   connectToChromeTarget,
   enableDomains,
+  ensureChromeDebugPort,
   getDocumentRoot,
   querySelector,
   sleep as sleepMs
@@ -88,6 +88,10 @@ function getPackageVersion() {
 }
 
 const packageVersion = getPackageVersion();
+const detachedRecommendMcpEnv = {
+  BOSS_RECOMMEND_CDP_DETACHED: "1",
+  BOSS_RECOMMEND_RUN_HEARTBEAT_MS: "10000"
+};
 
 function isInstalledPackageRoot(rootPath = packageRoot) {
   const normalized = path.resolve(String(rootPath || ""))
@@ -726,6 +730,25 @@ function parseMcpClientTargets(rawValue) {
   return unique;
 }
 
+function isPlainObject(value) {
+  return value && typeof value === "object" && !Array.isArray(value);
+}
+
+function shouldDefaultRecommendDetachedMcpEnv(options = {}) {
+  const client = normalizeMcpClientName(options.client);
+  const agent = normalizeAgentName(options.agent);
+  return client === "openclaw"
+    || client === "qclaw"
+    || agent === "openclaw"
+    || agent === "qclaw";
+}
+
+function getDefaultMcpEnv(options = {}) {
+  return shouldDefaultRecommendDetachedMcpEnv(options)
+    ? { ...detachedRecommendMcpEnv }
+    : {};
+}
+
 function getAgentConfigOutputDir(options = {}) {
   if (typeof options["output-dir"] === "string" && options["output-dir"].trim()) {
     return path.resolve(options["output-dir"]);
@@ -745,12 +768,29 @@ function buildMcpLaunchConfig(options = {}) {
       ? ["start"]
       : buildDefaultMcpArgs(options);
   const launchConfig = { command, args: launchArgs };
-  if (env && typeof env === "object" && !Array.isArray(env) && Object.keys(env).length > 0) {
-    launchConfig.env = env;
+  const mergedEnv = {
+    ...getDefaultMcpEnv(options),
+    ...(isPlainObject(env) ? env : {})
+  };
+  if (Object.keys(mergedEnv).length > 0) {
+    launchConfig.env = mergedEnv;
   }
   return launchConfig;
 }
 
+function mergeExistingMcpEntryEnv(existingEntry, launchConfig) {
+  if (!isPlainObject(existingEntry?.env) || !isPlainObject(launchConfig)) {
+    return launchConfig;
+  }
+  return {
+    ...launchConfig,
+    env: {
+      ...existingEntry.env,
+      ...(isPlainObject(launchConfig.env) ? launchConfig.env : {})
+    }
+  };
+}
+
 function buildMcpConfigFileContent(options = {}) {
   const serverName = typeof options["server-name"] === "string" && options["server-name"].trim()
     ? options["server-name"].trim()
@@ -872,7 +912,7 @@ function getKnownExternalMcpConfigPathsByAgent() {
     trae: [...traeConfigPaths, path.join(home, ".trae", "mcp.json"), path.join(home, ".trae-cn", "mcp.json")],
     "trae-cn": [...traeConfigPaths, path.join(home, ".trae-cn", "mcp.json"), path.join(home, ".trae", "mcp.json")],
     claude: [path.join(home, ".claude", "mcp.json")],
-    openclaw: [path.join(home, ".openclaw", "mcp.json"), ...openClawConfigPaths],
+    openclaw: [path.join(home, ".openclaw", "mcp.json"), path.join(home, ".openclaw", "openclaw.json"), ...openClawConfigPaths],
     qclaw: [path.join(home, ".qclaw", "openclaw.json")]
   };
 }
@@ -920,9 +960,12 @@ function mergeMcpServerConfigFile(filePath, options = {}) {
   const nextConfig = buildMcpConfigFileContent({ ...options, client: useQClawShape ? "qclaw" : options.client });
   const nextServers = useQClawShape ? nextConfig.mcp?.servers : nextConfig.mcpServers;
   const serverName = Object.keys(nextServers || {})[0] || defaultMcpServerName;
-  const launchConfig = nextServers?.[serverName] || buildMcpLaunchConfig(options);
   const existingServers = getMcpServersFromConfig(current, useQClawShape);
   const existingEntry = existingServers[serverName];
+  const launchConfig = mergeExistingMcpEntryEnv(
+    existingEntry,
+    nextServers?.[serverName] || buildMcpLaunchConfig(options)
+  );
   const retainedServers = {};
   const migratedLegacyServers = [];
   for (const [name, config] of Object.entries(existingServers)) {
@@ -2209,51 +2252,38 @@ async function launchChrome(options = {}) {
   const port = parsePositivePort(options.port) || parsePositivePort(process.env.BOSS_RECOMMEND_CHROME_PORT) || 9222;
   process.env.BOSS_RECOMMEND_CHROME_PORT = String(port);
   const timing = getLaunchChromeTiming(options);
-
-  const initialState = await inspectBossRecommendPageStateCdp(port, {
-    timeoutMs: timing.initialTimeoutMs,
-    pollMs: timing.pollMs
-  });
-  if (initialState.state !== "DEBUG_PORT_UNREACHABLE") {
-    console.log(`Reusing existing Chrome debug instance on port ${port}`);
-    const pageState = await ensureBossRecommendPageReadyCdp(port, {
-      attempts: 2,
-      inspectTimeoutMs: timing.inspectTimeoutMs,
-      pollMs: timing.pollMs,
-      settleMs: timing.settleMs
+  const userDataDir = getChromeUserDataDir(port);
+  let chromeGuard = null;
+  try {
+    chromeGuard = await ensureChromeDebugPort({
+      port,
+      url: bossUrl,
+      slowLive: Boolean(options["slow-live"] || options.slowLive),
+      launchIfMissing: true,
+      userDataDir
     });
-    if (pageState.ok) {
-      console.log("Boss recommend page is ready.");
-      const frontResult = await bringBossRecommendTabToFrontCdp(port);
-      if (frontResult.ok) {
-        console.log(`CDP methods: ${frontResult.method_log.join(", ") || "none"}`);
-      }
-    } else {
-      console.log(pageState.page_state?.message || "Boss recommend page is not ready.");
+  } catch (error) {
+    console.error(error?.message || String(error || "Chrome launch failed"));
+    if (error?.chrome_guard) {
+      console.error(JSON.stringify(error.chrome_guard, null, 2));
     }
-    return;
-  }
-
-  const chromePath = getChromeExecutable();
-  if (!chromePath) {
-    console.error("Chrome executable not found. Set BOSS_RECOMMEND_CHROME_PATH or install Google Chrome.");
     process.exitCode = 1;
     return;
   }
 
-  const userDataDir = getChromeUserDataDir(port);
-  const args = buildBossChromeLaunchArgs({ port, userDataDir, url: bossUrl });
-  const child = spawn(chromePath, args, {
-    detached: true,
-    stdio: "ignore",
-    windowsHide: false
-  });
-  child.unref();
-  console.log(`Chrome launched with remote debugging port ${port}`);
-  console.log(`User data dir: ${userDataDir}`);
-  await sleepMs(timing.settleMs + 1200);
+  if (chromeGuard.replaced) {
+    console.log(`Replaced Chrome debug instance on port ${port} because required flags were missing: ${chromeGuard.missing_flags.join(", ")}`);
+  } else if (chromeGuard.launched) {
+    console.log(`Chrome launched with remote debugging port ${port}`);
+  } else {
+    console.log(`Reusing existing Chrome debug instance on port ${port} with required flags`);
+  }
+  console.log(`User data dir: ${chromeGuard.user_data_dir || userDataDir}`);
+  if (chromeGuard.launched || chromeGuard.replaced) {
+    await sleepMs(timing.settleMs + 1200);
+  }
   const pageState = await ensureBossRecommendPageReadyCdp(port, {
-    attempts: 6,
+    attempts: chromeGuard.launched || chromeGuard.replaced ? 6 : 2,
     inspectTimeoutMs: timing.inspectTimeoutMs,
     pollMs: timing.pollMs,
     settleMs: timing.settleMs
@@ -2382,15 +2412,30 @@ async function printDoctor(options = {}) {
   const configResolution = getBossScreenConfigResolution(workspaceRoot);
   const calibrationResolution = getFeaturedCalibrationResolutionLocal(workspaceRoot);
   const timing = getLaunchChromeTiming(options);
+  const slowLive = Boolean(options["slow-live"] || options.slowLive);
+  let chromeGuard = null;
+  let chromeGuardError = null;
+  try {
+    chromeGuard = await ensureChromeDebugPort({
+      port,
+      url: bossUrl,
+      slowLive,
+      launchIfMissing: true,
+      userDataDir: getChromeUserDataDir(port)
+    });
+  } catch (error) {
+    chromeGuardError = error;
+    chromeGuard = error?.chrome_guard || null;
+  }
   let pageState = await inspectBossRecommendPageStateCdp(port, {
-    timeoutMs: options["slow-live"] || options.slowLive ? timing.initialTimeoutMs : 2000,
-    pollMs: options["slow-live"] || options.slowLive ? timing.pollMs : 500
+    timeoutMs: slowLive ? timing.initialTimeoutMs : 2000,
+    pollMs: slowLive ? timing.pollMs : 500
   });
   if (pageState.state === "RECOMMEND_READY") {
     pageState = await verifyRecommendPageStableCdp(port, {
-      settleMs: options["slow-live"] || options.slowLive ? timing.settleMs : 800,
-      recheckTimeoutMs: options["slow-live"] || options.slowLive ? timing.inspectTimeoutMs : 3000,
-      pollMs: options["slow-live"] || options.slowLive ? timing.pollMs : 500
+      settleMs: slowLive ? timing.settleMs : 800,
+      recheckTimeoutMs: slowLive ? timing.inspectTimeoutMs : 3000,
+      pollMs: slowLive ? timing.pollMs : 500
     });
   }
   const resolvedConfigPath = configResolution.resolved_path || configResolution.writable_path;
@@ -2407,6 +2452,28 @@ async function printDoctor(options = {}) {
       ? `检测到配置文件（resolved_path）：${resolvedConfigPath}`
       : "用户配置不存在（可通过 `boss-recommend-mcp init-config` 创建模板，或 `boss-recommend-mcp config set` 写入真实值）"
   });
+  const requiredFlags = chromeGuard?.required_flags || [];
+  const missingFlags = chromeGuard?.missing_flags || [];
+  const chromeFlagsOk = Boolean(chromeGuard && !chromeGuardError && chromeGuard.required_flags_ok);
+  checks.push({
+    key: "chrome_required_flags",
+    ok: chromeFlagsOk,
+    path: `http://localhost:${port}`,
+    required_flags: requiredFlags,
+    missing_flags: missingFlags,
+    replaced: Boolean(chromeGuard?.replaced),
+    close_method: chromeGuard?.close_method || null,
+    relaunch: chromeGuard?.relaunch || null,
+    message: chromeFlagsOk
+      ? chromeGuard?.replaced
+        ? `Chrome 调试端口 ${port} 原实例缺少必需 flags，已自动关闭并用正确 flags 重新启动。`
+        : chromeGuard?.launched
+          ? `Chrome 调试端口 ${port} 已用必需 flags 启动。`
+          : `Chrome 调试端口 ${port} 已确认包含必需 flags。`
+      : chromeGuardError
+        ? `Chrome 必需 flags 检查失败：${chromeGuardError.message}`
+        : `Chrome 调试端口 ${port} 未确认包含必需 flags。`
+  });
   checks.push({
     key: "chrome_debug_port",
     ok: pageState.state !== "DEBUG_PORT_UNREACHABLE",