@taole/dd-playwright 0.1.7 → 0.1.8

package/README.md

@@ -3,6 +3,7 @@
 增强型 stdio MCP 服务与 CLI 工具：Playwright 浏览器自动化 + 隔离 whistle 代理 + 点点账号 storageState 免登注入。
 可挂载到任意 AI 客户端（omp / Cursor / Claude Desktop / Codex 等）使用，不依赖任何特定宿主项目。
 
+> 📖 **团队知识库与使用手册**：[dd-playwright 钉钉在线文档](https://alidocs.dingtalk.com/i/nodes/14lgGw3P8vL9wkv1FnOLZAlkV5daZ90D?utm_scene=person_space)（持续同步最新工具契约与最佳实践）
 ## 能力
 
 | 工具 | 说明 |
@@ -64,6 +65,9 @@ dd-pw statusweb
 # 停止后台运行的服务：
 dd-pw stopweb
 
+# 一键检查并升级到最新版本：
+dd-pw update
+
 # （可选）前台阻塞运行（Ctrl+C 退出）：
 dd-pw serve [--port 12309]
 ```

package/bin/cli.mjs

@@ -7,6 +7,7 @@ import {
   stopWebDaemon,
   getWebDaemonStatus,
 } from "../src/server/daemon.mjs";
+import { handleUpdateCommand } from "../src/updater.mjs";
 
 const args = process.argv.slice(2);
 const command = args[0];
@@ -20,6 +21,7 @@ dd-playwright (别名: dd-pw) CLI
   dd-pw stopweb                        停止后台运行的 Web 控制台
   dd-pw statusweb                      查看后台 Web 控制台运行状态与端口
   dd-pw serve [--port 12309]           前台阻塞启动 Web 控制台（按 Ctrl+C 退出）
+  dd-pw update                         检查远端最新版本并自动升级
   dd-pw mcp                            以 stdio 模式启动 MCP 浏览器服务
   dd-pw --help, -h                     查看帮助信息
 
@@ -158,6 +160,8 @@ async function main() {
       console.error(`[dd-playwright] 启动失败:`, err);
       process.exit(1);
     }
+  } else if (command === "update" || command === "upgrade") {
+    await handleUpdateCommand();
   } else if (command === "mcp") {
     // 转发至 mcp-server.mjs
     await import("./mcp-server.mjs");

package/bin/mcp-server.mjs

@@ -11,7 +11,7 @@ import { resolveConfig } from "../src/config.mjs";
 import { PlaywrightBrowserManager } from "../src/browser-manager.mjs";
 import { pathToFileURL } from "node:url";
 
-export const MCP_VERSION = "0.1.7";
+export const MCP_VERSION = "0.1.8";
 
 function textResult(payload) {
   return {

package/package.json

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

package/src/updater.mjs

@@ -0,0 +1,111 @@
+import { readFileSync, existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
+
+export const PACKAGE_NAME = "@taole/dd-playwright";
+
+/**
+ * 比较两个语义化版本号 (semver)
+ * @param {string} v1
+ * @param {string} v2
+ * @returns {number} 1: v1 > v2; -1: v1 < v2; 0: v1 == v2
+ */
+export function compareSemver(v1, v2) {
+  const parse = (v) =>
+    (v || "")
+      .replace(/^v/i, "")
+      .split("-")[0]
+      .split(".")
+      .map((n) => parseInt(n, 10) || 0);
+
+  const [maj1, min1, pat1] = parse(v1);
+  const [maj2, min2, pat2] = parse(v2);
+
+  if (maj1 !== maj2) return maj1 > maj2 ? 1 : -1;
+  if (min1 !== min2) return min1 > min2 ? 1 : -1;
+  if (pat1 !== pat2) return pat1 > pat2 ? 1 : -1;
+  return 0;
+}
+
+/**
+ * 获取本地安装的版本号
+ * @returns {string}
+ */
+export function getLocalVersion() {
+  try {
+    const pkgPath = fileURLToPath(new URL("../package.json", import.meta.url));
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    return pkg.version || "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+
+/**
+ * 查询 NPM 远端最新版本号
+ * @returns {Promise<string|null>}
+ */
+export async function getRemoteLatestVersion() {
+  const registries = [
+    "https://registry.npmjs.org/",
+    "https://registry.npmmirror.com/",
+  ];
+
+  for (const reg of registries) {
+    try {
+      const url = `${reg}${PACKAGE_NAME}/latest`;
+      const res = await fetch(url, {
+        headers: { Accept: "application/json" },
+        signal: AbortSignal.timeout(4000),
+      });
+      if (res.ok) {
+        const data = await res.json();
+        if (data.version) return data.version;
+      }
+    } catch {}
+  }
+  return null;
+}
+
+/**
+ * 执行 update 命令核心流程
+ */
+export async function handleUpdateCommand(overrideCurrentVersion = null) {
+  const currentVersion = overrideCurrentVersion || getLocalVersion();
+  console.log(`[dd-playwright] 正在检查 npm 远端最新版本...`);
+
+  const latestVersion = await getRemoteLatestVersion();
+  if (!latestVersion) {
+    console.warn(`[dd-playwright] 无法连接到 npm 注册表查询最新版本，请检查网络。`);
+    console.log(`您可直接尝试执行手动更新命令：\n  npm install -g ${PACKAGE_NAME}@latest\n`);
+    return;
+  }
+
+  const cmp = compareSemver(latestVersion, currentVersion);
+  if (cmp <= 0) {
+    console.log(`🎉 恭喜！当前已是最新版本 (v${currentVersion})，无需更新。\n`);
+    return;
+  }
+
+  console.log(`\n==================================================`);
+  console.log(`  🚀 发现新版本可用: v${currentVersion} -> v${latestVersion}`);
+  console.log(`==================================================\n`);
+
+  console.log(`[dd-playwright] 正在尝试自动执行全局升级 (npm install -g ${PACKAGE_NAME}@latest)...`);
+
+  try {
+    // 优先尝试自动升级
+    execSync(`npm install -g ${PACKAGE_NAME}@latest`, {
+      stdio: "inherit",
+      windowsHide: true,
+    });
+    console.log(`\n🎉 自动更新完成！已成功升级至最新版本 v${latestVersion}。\n`);
+    console.log(`提示：若当前后台正在运行 Web 服务，建议重启生效：`);
+    console.log(`  dd-pw stopweb && dd-pw startweb\n`);
+  } catch (err) {
+    // 若因系统权限不足等原因报错，优雅降级，打印完整手工升级命令
+    console.warn(`\n⚠️ 自动升级未完成（可能需要管理员权限或当前终端权限受限）。`);
+    console.log(`请复制下方命令并在终端中执行升级：\n`);
+    console.log(`👉  npm install -g ${PACKAGE_NAME}@latest\n`);
+  }
+}