@wwkit/opm 1.0.1

package/src/binaries/depchecker.js

@@ -0,0 +1,172 @@
+import { execSync } from 'node:child_process'
+import fs from 'node:fs'
+import process from 'node:process'
+
+const APT_MAP = {
+  'libnss3.so': 'libnss3',
+  'libatk-1.0.so.0': 'libatk1.0-0t64',
+  'libatk-bridge-2.0.so.0': 'libatk-bridge2.0-0t64',
+  'libcups.so.2': 'libcups2t64',
+  'libdrm.so.2': 'libdrm2',
+  'libgbm.so.1': 'libgbm1',
+  'libxkbcommon.so.0': 'libxkbcommon0',
+  'libXcomposite.so.1': 'libxcomposite1',
+  'libXdamage.so.1': 'libxdamage1',
+  'libXfixes.so.3': 'libxfixes3',
+  'libXrandr.so.2': 'libxrandr2',
+  'libasound.so.2': 'libasound2t64',
+  'libpango-1.0.so.0': 'libpango-1.0-0',
+  'libcairo.so.2': 'libcairo2',
+  'libpangoft2-1.0.so.0': 'libpangoft2-1.0-0',
+  'libharfbuzz.so.0': 'libharfbuzz0b',
+  'libXss.so.1': 'libxss1',
+  'libatspi.so.0': 'libatspi2.0-0t64',
+  'libxcb.so.1': 'libxcb1',
+  'libX11.so.6': 'libx11-6',
+  'libXext.so.6': 'libxext6',
+  'libnssutil3.so': 'libnss3',
+  'libsmime3.so': 'libnss3',
+  'libnspr4.so': 'libnspr4',
+  'libdbus-1.so.3': 'libdbus-1-3',
+  'libexpat.so.1': 'libexpat1',
+  'libxrender.so.1': 'libxrender1',
+  'libglib-2.0.so.0': 'libglib2.0-0',
+  'libgobject-2.0.so.0': 'libglib2.0-0',
+}
+
+const DNF_MAP = {
+  'libnss3.so': 'nss',
+  'libatk-1.0.so.0': 'atk',
+  'libatk-bridge-2.0.so.0': 'at-spi2-atk',
+  'libcups.so.2': 'libcups',
+  'libdrm.so.2': 'libdrm',
+  'libgbm.so.1': 'mesa-libgbm',
+  'libxkbcommon.so.0': 'libxkbcommon',
+  'libXcomposite.so.1': 'libXcomposite',
+  'libXdamage.so.1': 'libXdamage',
+  'libXfixes.so.3': 'libXfixes',
+  'libXrandr.so.2': 'libXrandr',
+  'libasound.so.2': 'alsa-lib',
+  'libpango-1.0.so.0': 'pango',
+  'libcairo.so.2': 'cairo',
+  'libpangoft2-1.0.so.0': 'pango',
+  'libharfbuzz.so.0': 'harfbuzz',
+  'libXss.so.1': 'libXScrnSaver',
+  'libatspi.so.0': 'at-spi2-core',
+  'libxcb.so.1': 'libxcb',
+  'libX11.so.6': 'libX11',
+  'libXext.so.6': 'libXext',
+  'libnssutil3.so': 'nss',
+  'libsmime3.so': 'nss',
+  'libnspr4.so': 'nspr',
+  'libdbus-1.so.3': 'dbus-libs',
+  'libexpat.so.1': 'expat',
+  'libxrender.so.1': 'libXrender',
+  'libglib-2.0.so.0': 'glib2',
+  'libgobject-2.0.so.0': 'glib2',
+}
+
+export function isSupported() {
+  return process.platform === 'linux'
+}
+
+export function check(binaryPath) {
+  if (!isSupported()) return []
+  if (!binaryPath || !fs.existsSync(binaryPath)) return []
+  try {
+    execSync('which ldd', { stdio: 'pipe' })
+  } catch {
+    return []
+  }
+  let result
+  try {
+    result = execSync(`ldd "${binaryPath}"`, { stdio: 'pipe', timeout: 20000 })
+  } catch {
+    return []
+  }
+  const stdout = result.stdout?.toString() || ''
+  const missing = []
+  for (const line of stdout.split('\n')) {
+    const m = line.match(/^\s*(\S+)\s+=>\s+not found/)
+    if (m) missing.push(m[1])
+  }
+  return missing
+}
+
+export function mapToPackages(libs, packageManager) {
+  if (packageManager !== 'apt' && packageManager !== 'dnf') {
+    return { packages: [], unknown: [...libs] }
+  }
+  const table = packageManager === 'apt' ? APT_MAP : DNF_MAP
+  const packages = []
+  const unknown = []
+  const seen = new Set()
+  for (const lib of libs) {
+    const pkg = table[lib]
+    if (pkg && !seen.has(pkg)) {
+      seen.add(pkg)
+      packages.push(pkg)
+    } else if (!pkg) {
+      unknown.push(lib)
+    }
+  }
+  return { packages, unknown }
+}
+
+export function fallbackPackages(packages, packageManager) {
+  if (packageManager !== 'apt') return []
+  const fb = packages.map((p) => p.replace(/t64$/, ''))
+  return fb.some((p, i) => p !== packages[i]) ? fb : []
+}
+
+function runInstall(packages, packageManager) {
+  const tool = packageManager === 'apt' ? 'apt-get' : 'dnf'
+  const args = [tool, 'install', '-y', ...packages]
+  const cmd = process.getuid && process.getuid() === 0 ? args : ['sudo', ...args]
+  try {
+    execSync(cmd.join(' '), { stdio: 'pipe', timeout: 600000 })
+    return true
+  } catch {
+    return false
+  }
+}
+
+export function install(packages, packageManager) {
+  if (!packages.length) return true
+  if (packageManager !== 'apt' && packageManager !== 'dnf') return false
+  if (runInstall(packages, packageManager)) return true
+  const fb = fallbackPackages(packages, packageManager)
+  return fb.length ? runInstall(fb, packageManager) : false
+}
+
+export function detectPackageManager() {
+  try { execSync('which apt-get', { stdio: 'pipe' }); return 'apt' } catch {}
+  try { execSync('which dnf', { stdio: 'pipe' }); return 'dnf' } catch {}
+  return null
+}
+
+export function verify(binaryPath) {
+  if (!isSupported()) {
+    return { missing: [], packages: [], unknown: [], ok: true }
+  }
+  const packageManager = detectPackageManager()
+  const missing = check(binaryPath)
+  const result = { missing, packages: [], unknown: [], ok: !missing.length }
+  if (!missing.length) return result
+
+  const { packages, unknown } = mapToPackages(missing, packageManager)
+  result.packages = packages
+  result.unknown = unknown
+
+  if (packages.length) {
+    if (install(packages, packageManager)) {
+      const stillMissing = check(binaryPath)
+      result.ok = !stillMissing.length
+    } else {
+      result.ok = false
+    }
+  } else {
+    result.ok = false
+  }
+  return result
+}

package/src/binaries/exefinder.js

@@ -0,0 +1,110 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import process from 'node:process'
+
+function getPossibleNames(baseName) {
+  const names = new Set()
+  if (baseName === 'chrome') {
+    ['chrome', 'google chrome', 'google chrome for testing'].forEach(n => {
+      names.add(n.toLowerCase())
+      names.add(n.toLowerCase() + '.exe')
+    })
+  } else if (baseName === 'chromedriver') {
+    names.add('chromedriver')
+    names.add('chromedriver.exe')
+  } else {
+    names.add(baseName.toLowerCase())
+    names.add(baseName.toLowerCase() + '.exe')
+  }
+  return names
+}
+
+function findFallback(directory, baseName, isMacos) {
+  if (baseName === 'chrome' && isMacos) {
+    const paths = [
+      path.join(directory, 'Google Chrome for Testing.app', 'Contents', 'MacOS', 'Google Chrome for Testing'),
+      path.join(directory, 'Chrome.app', 'Contents', 'MacOS', 'Chrome'),
+      path.join(directory, 'Google Chrome.app', 'Contents', 'MacOS', 'Google Chrome'),
+    ]
+    for (const p of paths) {
+      if (fs.existsSync(p)) return p
+    }
+  } else if (baseName === 'chromedriver') {
+    const paths = [
+      path.join(directory, 'chromedriver'),
+      path.join(directory, 'chromedriver.exe'),
+    ]
+    for (const p of paths) {
+      if (fs.existsSync(p)) return p
+    }
+  }
+  return null
+}
+
+function setAppPermissions(appBundlePath) {
+  if (!fs.existsSync(appBundlePath)) return
+  for (const entry of fs.readdirSync(appBundlePath, { withFileTypes: true })) {
+    const fullPath = path.join(appBundlePath, entry.name)
+    if (entry.isDirectory()) {
+      setAppPermissions(fullPath)
+    } else {
+      try { fs.chmodSync(fullPath, 0o755) } catch {}
+    }
+  }
+}
+
+function ensureExecutable(filePath, isMacos = false, baseName = '') {
+  if (process.platform === 'win32') return filePath
+  try {
+    fs.accessSync(filePath, fs.constants.X_OK)
+    return filePath
+  } catch {}
+  try {
+    fs.chmodSync(filePath, 0o755)
+    if (isMacos && baseName === 'chrome') {
+      const parts = filePath.split('/Contents/MacOS/')
+      if (parts.length > 1 && parts[0].endsWith('.app')) {
+        setAppPermissions(parts[0])
+      }
+    }
+  } catch {}
+  return filePath
+}
+
+export function find(directory, baseName) {
+  const isMacos = process.platform === 'darwin'
+
+  if (!fs.existsSync(directory)) {
+    throw new Error(`Directory not found: ${directory}`)
+  }
+
+  if (fs.statSync(directory).isFile()) {
+    try {
+      fs.accessSync(directory, fs.constants.X_OK)
+      return ensureExecutable(directory)
+    } catch {}
+  }
+
+  const possibleNames = getPossibleNames(baseName)
+
+  function walkDir(dir) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const fullPath = path.join(dir, entry.name)
+      if (entry.isDirectory()) {
+        const result = walkDir(fullPath)
+        if (result) return result
+      } else if (possibleNames.has(entry.name.toLowerCase())) {
+        return fullPath
+      }
+    }
+    return null
+  }
+
+  const found = walkDir(directory)
+  if (found) return ensureExecutable(found, isMacos, baseName)
+
+  const fallback = findFallback(directory, baseName, isMacos)
+  if (fallback) return ensureExecutable(fallback, isMacos, baseName)
+
+  throw new Error(`Executable not found: ${baseName} in ${directory}`)
+}

package/src/binaries/platform.js

@@ -0,0 +1,17 @@
+import process from 'node:process'
+
+export const OS_TYPES = ['linux64', 'win64', 'mac-x64', 'mac-arm64']
+
+export function getOs() {
+  const platform = process.platform
+  const arch = process.arch
+  if (platform === 'win32') return 'win64'
+  if (platform === 'darwin') return arch === 'arm64' ? 'mac-arm64' : 'mac-x64'
+  if (platform === 'linux') {
+    if (arch !== 'x64') {
+      throw new Error(`Chrome for Testing 不提供 linux-${arch} 构建（上游仅支持 linux64/x86_64）。请改用系统 Chromium：apt/dnf install chromium chromium-driver`)
+    }
+    return 'linux64'
+  }
+  throw new Error(`Unsupported platform: ${platform}`)
+}

package/src/cli/doc.js

@@ -0,0 +1,335 @@
+/**
+ * 文档生成器 — 将 docs/ 下的 markdown 转为单个 HTML（左侧菜单 + 右侧内容），
+ * 写入 docs/opm.html 并自动用浏览器打开。
+ *
+ * 无外部依赖：markdown → HTML 转换为最小化内联实现（标题/表格/代码块/列表/段落）。
+ * 发布时由 prepublishOnly 调用 generateDocHtml({ open: false }) 重新生成。
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import { execSync } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const DOCS_DIR = path.resolve(__dirname, '..', '..', 'docs')
+const OUTPUT = path.join(DOCS_DIR, 'opm.html')
+
+/**
+ * 收集 docs/ 下所有 .md 文件（递归），返回 [{ name, relPath, content }]
+ * @returns {{ name: string, relPath: string, content: string }[]}
+ */
+function collectDocs() {
+  const result = []
+  function walk(dir, prefix) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true })
+    for (const e of entries) {
+      if (e.name.startsWith('.') || e.name === 'opm.html') continue
+      const full = path.join(dir, e.name)
+      if (e.isDirectory()) {
+        walk(full, prefix ? `${prefix}/${e.name}` : e.name)
+      } else if (e.name.endsWith('.md')) {
+        const base = e.name.replace(/\.md$/, '')
+        result.push({
+          name: prefix ? `${prefix}/${base}` : base,
+          relPath: prefix ? `${prefix}/${base}` : base,
+          content: fs.readFileSync(full, 'utf8'),
+        })
+      }
+    }
+  }
+  walk(DOCS_DIR, '')
+  return result
+}
+
+/** 按未转义的 | 分割表格行（\| 视为字面量） */
+function splitPipes(line) {
+  const parts = []
+  let current = ''
+  for (let j = 0; j < line.length; j++) {
+    if (line[j] === '|' && j > 0 && line[j - 1] === '\\') {
+      current = current.slice(0, -1) + '|'
+    } else if (line[j] === '|') {
+      parts.push(current)
+      current = ''
+    } else {
+      current += line[j]
+    }
+  }
+  parts.push(current)
+  return parts.map((s) => s.trim()).filter(Boolean)
+}
+
+/**
+ * 极简 markdown → HTML 转换（支持标题/表格/代码块/列表/段落/加粗/行内代码）
+ * @param {string} md
+ * @returns {string}
+ */
+function mdToHtml(md) {
+  const lines = md.split('\n')
+  const out = []
+  let i = 0
+  while (i < lines.length) {
+    const line = lines[i]
+    // 代码块
+    if (line.trim().startsWith('```')) {
+      const lang = line.trim().slice(3)
+      const code = []
+      i++
+      while (i < lines.length && !lines[i].trim().startsWith('```')) {
+        code.push(lines[i])
+        i++
+      }
+      i++
+      out.push(`<pre><code class="lang-${lang}">${esc(code.join('\n'))}</code></pre>`)
+      continue
+    }
+    // 表格
+    if (line.includes('|') && i + 1 < lines.length && lines[i + 1].includes('---')) {
+      const headers = splitPipes(line)
+      i += 2
+      const rows = []
+      while (i < lines.length && lines[i].includes('|')) {
+        rows.push(splitPipes(lines[i]))
+        i++
+      }
+      const thead = `<thead><tr>${headers.map((h) => `<th>${inline(h)}</th>`).join('')}</tr></thead>`
+      const tbody = `<tbody>${rows.map((r) => `<tr>${r.map((c) => `<td>${inline(c)}</td>`).join('')}</tr>`).join('')}</tbody>`
+      out.push(`<table>${thead}${tbody}</table>`)
+      continue
+    }
+    // 标题
+    const h = line.match(/^(#{1,6})\s+(.*)/)
+    if (h) {
+      const level = h[1].length
+      out.push(`<h${level}>${inline(h[2])}</h${level}>`)
+      i++
+      continue
+    }
+    // 无序列表
+    if (line.match(/^\s*[-*]\s+/)) {
+      const items = []
+      while (i < lines.length && lines[i].match(/^\s*[-*]\s+/)) {
+        items.push(`<li>${inline(lines[i].replace(/^\s*[-*]\s+/, ''))}</li>`)
+        i++
+      }
+      out.push(`<ul>${items.join('')}</ul>`)
+      continue
+    }
+    // 引用
+    if (line.startsWith('> ')) {
+      const quotes = []
+      while (i < lines.length && lines[i].startsWith('> ')) {
+        quotes.push(inline(lines[i].slice(2)))
+        i++
+      }
+      out.push(`<blockquote>${quotes.join('<br>')}</blockquote>`)
+      continue
+    }
+    // 空行
+    if (line.trim() === '') {
+      i++
+      continue
+    }
+    // 段落
+    out.push(`<p>${inline(line)}</p>`)
+    i++
+  }
+  return out.join('\n')
+}
+
+/** HTML 转义 */
+function esc(s) {
+  return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+}
+
+/** 行内格式化（加粗、行内代码、链接） */
+function inline(s) {
+  return esc(s)
+    .replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>')
+    .replace(/`(.+?)`/g, '<code>$1</code>')
+    .replace(/\[(.+?)\]\((.+?)\)/g, '<a href="$2">$1</a>')
+}
+
+/**
+ * 生成 docs/opm.html 并在浏览器打开
+ * @param {{ open?: boolean }} [opts] — open 默认 true；发布构建时传 false
+ */
+export function generateDocHtml(opts = {}) {
+  const open = opts.open !== false
+  const docs = collectDocs()
+  if (docs.length === 0) {
+    console.error('No .md files found under docs/')
+    process.exit(1)
+  }
+
+  const sections = {}
+  for (const doc of docs) {
+    const parts = doc.relPath.split('/')
+    const category = parts.length > 1 ? parts[0] : 'root'
+    if (!sections[category]) sections[category] = []
+    sections[category].push(doc)
+  }
+
+  const menuItems = []
+  const contentDivs = []
+  let first = true
+
+  for (const [category, items] of Object.entries(sections)) {
+    menuItems.push(`<div class="menu-category">${esc(category)}</div>`)
+    for (const doc of items) {
+      const id = doc.relPath.replace(/[^a-zA-Z0-9]/g, '_')
+      const label = parts_last(doc.relPath)
+      menuItems.push(`<a class="menu-item" href="#" onclick="show('${id}');return false;">${esc(label)}</a>`)
+      contentDivs.push(`<div id="${id}" class="doc-content" style="display:${first ? 'block' : 'none'};">${mdToHtml(doc.content)}</div>`)
+      first = false
+    }
+  }
+
+  const html = `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>OPM — Once Package Manager</title>
+<style>
+  :root {
+    --bg: #ffffff;
+    --bg-soft: #f8f9fb;
+    --bg-sidebar: #1a1b26;
+    --bg-header: #1a1b26;
+    --text: #1e2030;
+    --text-soft: #6b7290;
+    --text-sidebar: #a9b1d6;
+    --text-sidebar-dim: #565f89;
+    --accent: #7aa2f7;
+    --accent-soft: #b4f9f8;
+    --border: #e2e4ee;
+    --code-bg: #1a1b26;
+    --code-text: #c0caf5;
+  }
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  html, body { height: 100%; }
+  body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Noto Sans SC", sans-serif; display: flex; flex-direction: column; height: 100vh; }
+
+  /* ---- header ---- */
+  #header {
+    height: 52px; flex-shrink: 0;
+    background: var(--bg-header);
+    display: flex; align-items: center; gap: 12px;
+    padding: 0 24px;
+    box-shadow: 0 1px 4px rgba(0,0,0,.15);
+    z-index: 10;
+  }
+  #header .logo {
+    font-size: 13px; font-weight: 700; letter-spacing: 1px;
+    color: #1a1b26; background: var(--accent);
+    padding: 3px 10px; border-radius: 4px;
+  }
+  #header .title { color: #c0caf5; font-size: 15px; font-weight: 500; }
+  #header .title .sub { color: var(--text-sidebar-dim); font-size: 13px; margin-left: 8px; }
+
+  /* ---- body layout ---- */
+  #body-row { display: flex; flex: 1; overflow: hidden; }
+
+  /* ---- sidebar ---- */
+  #sidebar { width: 220px; background: var(--bg-sidebar); overflow-y: auto; padding: 8px 0; flex-shrink: 0; }
+  .menu-category { padding: 10px 16px 4px; font-size: 10px; text-transform: uppercase; letter-spacing: .5px; color: var(--text-sidebar-dim); }
+  .menu-item { display: block; padding: 5px 20px; color: var(--text-sidebar); text-decoration: none; font-size: 13px; border-left: 2px solid transparent; transition: background .15s, border-color .15s; }
+  .menu-item:hover { background: rgba(122,162,247,.08); }
+  .menu-item.active { border-left-color: var(--accent); color: var(--accent); background: rgba(122,162,247,.06); }
+
+  /* ---- content ---- */
+  #content { flex: 1; overflow-y: auto; padding: 28px 40px; background: var(--bg); }
+  .doc-content { width: 100%; }
+
+  .doc-content h1 { margin: 20px 0 14px; font-size: 24px; font-weight: 700; color: var(--text); border-bottom: 2px solid var(--accent); padding-bottom: 8px; }
+  .doc-content h2 { margin: 18px 0 10px; font-size: 19px; font-weight: 600; color: var(--text); }
+  .doc-content h3 { margin: 14px 0 8px; font-size: 16px; font-weight: 600; color: var(--text); }
+  .doc-content p { margin: 8px 0; line-height: 1.7; color: var(--text); font-size: 14px; }
+  .doc-content a { color: var(--accent); text-decoration: none; }
+  .doc-content a:hover { text-decoration: underline; }
+  .doc-content strong { font-weight: 600; }
+
+  /* table */
+  .doc-content table { border-collapse: collapse; width: 100%; margin: 14px 0; font-size: 13px; box-shadow: 0 1px 3px rgba(0,0,0,.06); }
+  .doc-content th, .doc-content td { border: 1px solid var(--border); padding: 8px 12px; text-align: left; }
+  .doc-content th { background: var(--bg-soft); font-weight: 600; color: var(--text); white-space: nowrap; }
+  .doc-content td { color: var(--text); }
+  .doc-content tbody tr:hover { background: rgba(122,162,247,.04); }
+  .doc-content td code { white-space: nowrap; }
+
+  /* code */
+  .doc-content pre { background: var(--code-bg); color: var(--code-text); padding: 14px 18px; border-radius: 8px; overflow-x: auto; margin: 14px 0; font-size: 13px; line-height: 1.5; box-shadow: 0 2px 8px rgba(0,0,0,.1); }
+  .doc-content pre code { font-family: "SF Mono", "Fira Code", Menlo, monospace; }
+  .doc-content code { font-family: "SF Mono", "Fira Code", Menlo, monospace; font-size: 12.5px; background: var(--bg-soft); padding: 1px 5px; border-radius: 3px; color: #db4b4b; }
+  .doc-content pre code { background: none; color: inherit; padding: 0; border-radius: 0; font-size: inherit; }
+
+  /* list */
+  .doc-content ul { margin: 8px 0 8px 22px; }
+  .doc-content li { margin: 5px 0; color: var(--text); font-size: 14px; line-height: 1.6; }
+
+  /* blockquote */
+  .doc-content blockquote { border-left: 3px solid var(--accent); padding: 6px 14px; margin: 10px 0; background: var(--bg-soft); border-radius: 0 4px 4px 0; color: var(--text-soft); font-size: 13px; }
+</style>
+</head>
+<body>
+<div id="header">
+  <span class="logo">OPM</span>
+  <span class="title">Once Package Manager<span class="sub">— unified CLI docs</span></span>
+</div>
+<div id="body-row">
+<div id="sidebar">
+${menuItems.join('\n')}
+</div>
+<div id="content">
+${contentDivs.join('\n')}
+</div>
+</div>
+<script>
+function show(id) {
+  document.querySelectorAll('.doc-content').forEach(el => el.style.display = 'none');
+  document.getElementById(id).style.display = 'block';
+  document.querySelectorAll('.menu-item').forEach(el => el.classList.remove('active'));
+  const link = document.querySelector('.menu-item[onclick*="' + id + '"]');
+  if (link) link.classList.add('active');
+}
+// 默认激活第一个
+(function() {
+  var first = document.querySelector('.menu-item');
+  if (first) first.classList.add('active');
+})();
+</script>
+</body>
+</html>`
+
+  fs.writeFileSync(OUTPUT, html, 'utf8')
+  console.log(`Generated ${OUTPUT} (${docs.length} docs)`)
+
+  if (open) {
+    openInBrowser(OUTPUT)
+  }
+}
+
+/** 取路径最后一段（不含扩展名） */
+function parts_last(relPath) {
+  const parts = relPath.split('/')
+  return parts[parts.length - 1]
+}
+
+/** 跨平台打开浏览器 */
+function openInBrowser(url) {
+  const platform = os.platform()
+  try {
+    if (platform === 'darwin') {
+      execSync(`open "${url}"`)
+    } else if (platform === 'win32') {
+      execSync(`start "" "${url}"`, { shell: 'cmd.exe' })
+    } else {
+      execSync(`xdg-open "${url}"`)
+    }
+  } catch {
+    console.error(`Failed to open browser. HTML at: ${url}`)
+  }
+}