@taole/dd-playwright 0.2.0 → 0.3.0

package/README.md

@@ -75,6 +75,12 @@ dd-pw version
 # 一键检查并升级到最新版本：
 dd-pw update
 
+# 环境诊断（Node 版本 / Chromium 内核 / 账号库 / Web 服务 / 版本检查）：
+dd-pw doctor
+
+# 诊断并自动修复安全项（当前为缺失的 Chromium 内核）：
+dd-pw doctor --fix
+
 # （可选）前台阻塞运行（Ctrl+C 退出）：
 dd-pw serve [--port 12309]
 ```

package/bin/cli.mjs

@@ -9,6 +9,7 @@ import {
   getStoredWebPort,
 } from "../src/server/daemon.mjs";
 import { getLocalVersion, handleUpdateCommand } from "../src/updater.mjs";
+import { runDoctor, formatDoctorReport } from "../src/doctor.mjs";
 
 const args = process.argv.slice(2);
 const command = args[0];
@@ -23,6 +24,7 @@ dd-playwright (别名: dd-pw) CLI
   dd-pw statusweb                      查看后台 Web 控制台运行状态与端口
   dd-pw serve [--port 12309]           前台阻塞启动 Web 控制台（按 Ctrl+C 退出）
   dd-pw version, --version, -v         查看当前版本
+  dd-pw doctor [--fix]                  诊断环境（Node/Chromium/数据库/Web 服务/版本）
   dd-pw update                         检查远端最新版本并自动升级
   dd-pw mcp                            以 stdio 模式启动 MCP 浏览器服务
   dd-pw --help, -h                     查看帮助信息
@@ -167,6 +169,15 @@ async function main() {
       console.error(`[dd-playwright] 启动失败:`, err);
       process.exit(1);
     }
+  } else if (command === "doctor") {
+    const report = await runDoctor({
+      config: resolveConfig(),
+      fix: args.includes("--fix"),
+    });
+    console.log(formatDoctorReport(report));
+    // 用 exitCode 而非 process.exit()：Windows 下显式退出与在途 fetch 的
+    // handle 关闭竞争会触发 uv async.c 断言崩溃
+    process.exitCode = report.ok ? 0 : 1;
   } else if (command === "update" || command === "upgrade") {
     await handleUpdateCommand();
   } else if (command === "mcp") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taole/dd-playwright",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Standalone stdio MCP & CLI: Playwright browser automation + isolated whistle proxy + diandian account storageState injection",
   "type": "module",
   "license": "ISC",

package/src/doctor.mjs

@@ -0,0 +1,160 @@
+/**
+ * dd-pw doctor：环境健康度诊断。只读检查，不启动浏览器/代理，不做修复。
+ * 每项检查返回 { name, ok, detail, hint }；exit code 由汇总结果决定。
+ */
+import { existsSync, accessSync, constants, readFileSync } from "node:fs";
+import { DatabaseSync } from "node:sqlite";
+import { join } from "node:path";
+import { getChromiumMetadata } from "./browser-check.mjs";
+import { getLocalVersion, getRemoteLatestVersion, compareSemver } from "./updater.mjs";
+import { getStoredWebPort, getStoredWebPid } from "./server/daemon.mjs";
+
+const MIN_NODE = [22, 13, 0];
+
+function check(name, fn) {
+  return Promise.resolve()
+    .then(fn)
+    .then((r) => ({ name, ok: r.ok !== false, detail: r.detail ?? "", hint: r.hint ?? "" }))
+    .catch((err) => ({ name, ok: false, detail: String(err.message || err), hint: "" }));
+}
+
+function checkNodeVersion() {
+  const [maj, min, pat] = process.versions.node.split(".").map((n) => parseInt(n, 10));
+  const ok =
+    maj > MIN_NODE[0] ||
+    (maj === MIN_NODE[0] && min > MIN_NODE[1]) ||
+    (maj === MIN_NODE[0] && min === MIN_NODE[1] && pat >= MIN_NODE[2]);
+  return {
+    detail: `当前 ${process.version}，要求 >= ${MIN_NODE.join(".")}`,
+    ok,
+    hint: ok ? "" : "升级 Node.js 后重试（依赖内置 node:sqlite）",
+  };
+}
+
+async function checkChromium(fix) {
+  const meta = await getChromiumMetadata();
+  if (meta.installed && meta.version) {
+    return { detail: `${meta.version} (${meta.executablePath})` };
+  }
+  const hint = "执行 npx playwright install chromium 补齐内核";
+  if (fix) {
+    const { ensureChromiumInstalled } = await import("./browser-check.mjs");
+    const done = await ensureChromiumInstalled({ silent: true });
+    if (done) {
+      const after = await getChromiumMetadata();
+      return { detail: `已自动修复：${after.version} (${after.executablePath})` };
+    }
+  }
+  return { ok: false, detail: meta.error || `内核缺失：${meta.executablePath || "未知路径"}`, hint };
+}
+
+function checkDataDir(config) {
+  const dir = config.dataDir;
+  if (!existsSync(dir)) {
+    return { ok: true, detail: `${dir} 尚不存在（首次使用时自动创建）` };
+  }
+  accessSync(dir, constants.R_OK | constants.W_OK);
+  return { detail: `${dir} 可读写` };
+}
+
+function checkDatabase(config) {
+  const dbPath = config.dbPath;
+  if (!existsSync(dbPath)) {
+    return { ok: true, detail: `${dbPath} 不存在（未绑定账号属正常）` };
+  }
+  const db = new DatabaseSync(dbPath, { readOnly: true });
+  try {
+    const tables = db
+      .prepare("SELECT name FROM sqlite_master WHERE type='table'")
+      .all()
+      .map((r) => r.name);
+    const missing = ["diandian_accounts", "app_settings"].filter((t) => !tables.includes(t));
+    if (missing.length) {
+      return {
+        ok: false,
+        detail: `数据库缺少表：${missing.join(", ")}`,
+        hint: "数据库可能来自旧版本或已损坏；可备份后删除 runtime.db 重新扫码绑定",
+      };
+    }
+    const row = db
+      .prepare("SELECT account_id, nickname, storage_state FROM diandian_accounts WHERE is_active = 1 LIMIT 1")
+      .get();
+    if (!row) {
+      return { ok: true, detail: "数据库正常，未设置激活账号" };
+    }
+    try {
+      JSON.parse(row.storage_state);
+      return { detail: `激活账号 ${row.account_id}（${row.nickname || "未知昵称"}），storageState 可解析` };
+    } catch {
+      return {
+        ok: false,
+        detail: `激活账号 ${row.account_id} 的 storageState 无法解析`,
+        hint: "在 Web 控制台重新扫码绑定该账号",
+      };
+    }
+  } finally {
+    db.close();
+  }
+}
+
+async function checkWebDaemon(config) {
+  const pid = getStoredWebPid(config.webPidFile);
+  if (!pid) {
+    return { ok: true, detail: "后台 Web 控制台未运行（dd-pw startweb 启动）" };
+  }
+  const storedPort = getStoredWebPort(config.dataDir) || 12309;
+  try {
+    const res = await fetch(`http://127.0.0.1:${storedPort}/api/accounts`, {
+      signal: AbortSignal.timeout(2000),
+    });
+    if (res.ok) {
+      return { detail: `运行中 PID=${pid}，http://127.0.0.1:${storedPort} 可访问` };
+    }
+    return { ok: false, detail: `PID=${pid} 存在但端口 ${storedPort} 响应 ${res.status}`, hint: "dd-pw stopweb 后重新 startweb" };
+  } catch {
+    return { ok: false, detail: `PID=${pid} 存在但端口 ${storedPort} 不可访问`, hint: "PID 文件可能残留，执行 dd-pw stopweb 清理后重新 startweb" };
+  }
+}
+
+async function checkVersion() {
+  const local = getLocalVersion();
+  const remote = await getRemoteLatestVersion();
+  if (!remote) {
+    return { ok: true, detail: `本地 ${local}，远端版本查询失败（网络问题，不影响使用）` };
+  }
+  const cmp = compareSemver(local, remote);
+  if (cmp < 0) {
+    return { ok: false, detail: `本地 ${local} 落后于远端 ${remote}`, hint: "执行 dd-pw update 升级" };
+  }
+  return { detail: `本地 ${local} 已是最新` };
+}
+
+/**
+ * 执行全部诊断
+ * @param {object} options
+ * @param {object} options.config resolveConfig() 结果
+ * @param {boolean} [options.fix] 允许自动修复安全项（当前仅 Chromium 内核缺失）
+ * @returns {Promise<{ok: boolean, results: Array}>}
+ */
+export async function runDoctor({ config, fix = false }) {
+  const results = await Promise.all([
+    check("Node 版本", checkNodeVersion),
+    check("Chromium 内核", () => checkChromium(fix)),
+    check("数据目录", () => checkDataDir(config)),
+    check("账号数据库", () => checkDatabase(config)),
+    check("Web 控制台", () => checkWebDaemon(config)),
+    check("包版本", checkVersion),
+  ]);
+  return { ok: results.every((r) => r.ok), results };
+}
+
+export function formatDoctorReport({ ok, results }) {
+  const lines = results.map((r) => {
+    const mark = r.ok ? "✔" : "✘";
+    let line = `${mark} ${r.name}: ${r.detail}`;
+    if (!r.ok && r.hint) line += `\n    建议: ${r.hint}`;
+    return line;
+  });
+  lines.push(ok ? "\n全部检查通过。" : `\n发现 ${results.filter((r) => !r.ok).length} 项问题。`);
+  return lines.join("\n");
+}

package/src/updater.mjs

@@ -122,6 +122,15 @@ export async function handleUpdateCommand(overrideCurrentVersion = null) {
     });
     console.log(`\n🎉 自动升级成功！已成功升级至最新版本 v${latestVersion}。\n`);
 
+    // 升级后 Playwright 期望的 Chromium revision 可能变化，自动补齐内核，
+    // 避免下次启动 MCP 时报“浏览器二进制缺失”
+    try {
+      const { ensureChromiumInstalled } = await import("./browser-check.mjs");
+      await ensureChromiumInstalled();
+    } catch (err) {
+      console.warn(`[dd-playwright] Chromium 内核自动补齐失败: ${err.message}`);
+      console.log(`可稍后执行 dd-pw doctor --fix 重试。\n`);
+    }
     if (wasWebRunning) {
       console.log(`[dd-playwright] 正在自动为您重启后台 Web 服务...`);
       const restartRes = await startWebDaemon({