@wwkit/opm 1.0.1 → 1.0.3

package/src/cli/groups/docker.js

@@ -0,0 +1,121 @@
+/**
+ * docker 命令组 — 管理 Docker 自身与 daemon
+ *
+ * 继承 ToolManagerGroup 复用 version/installed/registry/install/upgrade/uninstall/dir，
+ * 额外增加 status/start/stop/restart/open。
+ * 跨平台：Linux 用便捷脚本（URL 由 docker.registry.active 提供），macOS 用 brew cask，Windows 走 WSL2。
+ */
+
+import { ToolManagerGroup } from './version-manager.js'
+import { parseFlags } from '../helpers/args.js'
+import { output } from '../../formatter.js'
+import {
+  isDockerInstalled,
+  getDockerVersion,
+  installDocker,
+  upgradeDocker,
+  uninstallDocker,
+  getDockerDir,
+  getDockerStatus,
+  startDocker,
+  stopDocker,
+  restartDocker,
+  openDocker,
+} from '../../managers/docker.js'
+
+export class DockerGroup extends ToolManagerGroup {
+  constructor() {
+    super({
+      name: 'docker',
+      desc: 'Docker manager (install/upgrade/start/stop/open)',
+      isInstalled: () => isDockerInstalled(),
+      getPath: () => getDockerDir(),
+      versionCmd: () => 'docker --version',
+      parseVersion: (out) => {
+        const m = out.match(/Docker version\s+(\S+)/)
+        return m ? m[1] : out.trim()
+      },
+      install: (proxy) => installDocker(proxy),
+      upgrade: () => upgradeDocker(),
+      uninstall: () => uninstallDocker(),
+      usage: 'opm docker <action> [options]',
+      actions: [
+        ['version', 'Show Docker version'],
+        ['installed', 'Check if Docker is installed'],
+        ['registry', 'Show active Docker install script URL (from opm config)'],
+        ['registry set <url|preset>', 'Set active Docker install script URL (writes opm config)'],
+        ['registry presets', 'List available mirror presets'],
+        ['install', 'Install Docker (Linux: script from active registry, macOS: brew cask, Windows: WSL2)'],
+        ['upgrade', 'Upgrade Docker'],
+        ['uninstall', 'Uninstall Docker'],
+        ['dir', 'Show Docker data directory'],
+        ['status', 'Show Docker daemon status'],
+        ['start', 'Start Docker daemon'],
+        ['stop', 'Stop Docker daemon'],
+        ['restart', 'Restart Docker daemon'],
+        ['open', 'Open terminal with Docker ready'],
+        ['help', 'Show this help'],
+      ],
+      examples: [
+        'opm docker version',
+        'opm docker installed',
+        'opm docker registry',
+        'opm docker registry set official',
+        'opm docker registry presets',
+        'opm docker install',
+        'opm docker upgrade',
+        'opm docker status',
+        'opm docker start',
+        'opm docker stop',
+        'opm docker restart',
+        'opm docker open',
+        'opm docker dir',
+        'opm docker uninstall',
+      ],
+    })
+  }
+
+  async run(argv) {
+    const [action, ...rest] = argv
+
+    if (!action || action === '-h' || action === '--help' || action === 'help') {
+      this.printHelp()
+      return
+    }
+
+    switch (action) {
+      case 'status':
+        return this._status()
+      case 'start':
+        return this._start()
+      case 'stop':
+        return this._stop()
+      case 'restart':
+        return this._restart()
+      case 'open':
+        return this._open()
+    }
+
+    return super.run(argv)
+  }
+
+  _status() {
+    output(getDockerStatus())
+  }
+
+  _start() {
+    output(startDocker())
+  }
+
+  _stop() {
+    output(stopDocker())
+  }
+
+  _restart() {
+    output(restartDocker())
+  }
+
+  _open() {
+    output(openDocker())
+  }
+}

package/src/cli/groups/homebrew.js

@@ -2,9 +2,8 @@
  * homebrew 命令组 — 管理 Homebrew（brew）自身
  *
  * Homebrew 无独立版本管理器，通过官方 shell 脚本安装/卸载。
- * 安装方式：curl 管道执行 install.sh（与 uv 同模式）；
+ * 安装方式：curl 管道执行 install.sh（URL 由 homebrew.registry.active 提供）；
  * upgrade = brew update；uninstall = curl 管道执行 uninstall.sh。
- * brew 自身无镜像源（包镜像走 opm brew registry），故无 registry action。
  * 仅支持 macOS / Linux，Windows 不支持。
  */
 
@@ -30,7 +29,6 @@ export class HomebrewGroup extends ToolManagerGroup {
     super({
       name: 'homebrew',
       desc: 'Homebrew manager (install/upgrade/uninstall brew itself)',
-      hasRegistry: false,
       isInstalled: () => isHomebrewInstalled(),
       getPath: () => getBrewRoot(),
       versionCmd: () => `${getBrewBin()} --version`,
@@ -38,7 +36,7 @@ export class HomebrewGroup extends ToolManagerGroup {
         const m = out.trim().match(/^Homebrew\s+(\S+)/)
         return m ? m[1] : out.trim()
       },
-      install: () => installHomebrew(),
+      install: (proxy) => installHomebrew(proxy),
       upgrade: () => {
         execSync(`${getBrewBin()} update`, { stdio: 'inherit' })
         return { action: 'upgraded' }
@@ -54,7 +52,10 @@ export class HomebrewGroup extends ToolManagerGroup {
       actions: [
         ['version', 'Show Homebrew version'],
         ['installed', 'Check if Homebrew is installed'],
-        ['install', 'Install Homebrew (curl installer from GitHub)'],
+        ['registry', 'Show active install script URL (from opm config)'],
+        ['registry set <url|preset>', 'Set active install script URL (writes opm config)'],
+        ['registry presets', 'List available mirror presets'],
+        ['install', 'Install Homebrew (curl installer from active registry)'],
         ['upgrade', 'Update Homebrew (brew update)'],
         ['uninstall', 'Remove Homebrew (curl uninstaller from GitHub)'],
         ['dir', 'Show Homebrew install directory'],
@@ -63,6 +64,9 @@ export class HomebrewGroup extends ToolManagerGroup {
       examples: [
         'opm homebrew version',
         'opm homebrew installed',
+        'opm homebrew registry',
+        'opm homebrew registry set official',
+        'opm homebrew registry presets',
         'opm homebrew install',
         'opm homebrew upgrade',
         'opm homebrew dir',

package/src/cli/groups/nvm.js

@@ -35,9 +35,13 @@ export class NvmGroup extends ToolManagerGroup {
       getPath: () => getNvmDir(),
       versionCmd: () => `source "${path.join(getNvmDir(), 'nvm.sh')}" && nvm --version`,
       parseVersion: (out) => out.trim(),
-      install: () => installNvm(),
+      install: (proxy) => installNvm(proxy),
       upgrade: () => {
-        execSync(`cd "${getNvmDir()}" && git remote set-url origin "${getActiveRegistry('nvm')}" && git pull --tags`, {
+        const nvmDir = getNvmDir()
+        if (!fs.existsSync(path.join(nvmDir, '.git'))) {
+          throw new Error(`${nvmDir} is not a git repository (nvm was not installed via git clone). Run \`opm nvm uninstall -y\` then \`opm nvm install\` to reinstall.`)
+        }
+        execSync(`cd "${nvmDir}" && git remote set-url origin "${getActiveRegistry('nvm')}" && git pull --tags`, {
           stdio: 'inherit',
           shell: shell.resolveBash(),
         })

package/src/cli/groups/ping.js

@@ -0,0 +1,461 @@
+/**
+ * ping 命令组 — 验证主机、代理或 registry 的可访问性
+ *
+ * 用法：
+ *   opm ping <host>        Ping 指定主机/IP/URL
+ *   opm ping proxy         Ping 当前 active 代理地址的主机
+ *   opm ping registry      Ping 所有工具 registry active 地址的主机
+ *
+ * 自动检测可用工具（ping > curl > wget），无工具时提示并退出。
+ * 默认输出精简数组 [{tool, address, proxy, reachable}]；-d/--detail 输出完整 JSON。
+ */
+
+import { spawn } from 'node:child_process'
+import { Shell } from '@wwkit/shared'
+import { parseFlags } from '../helpers/args.js'
+import { output } from '../../formatter.js'
+import { getActiveProxy, getActiveRegistry, getConfig } from '../../config.js'
+
+const shell = new Shell()
+
+/**
+ * 从 URL 或 deb 行中提取主机名和端口（用于 ping 目标）
+ * @param {string} url
+ * @returns {{ host: string, port: string }}
+ */
+function extractHostPort(url) {
+  let cleaned = url
+  const debMatch = url.match(/^deb\s+(https?:\/\/\S+)/)
+  if (debMatch) cleaned = debMatch[1]
+  try {
+    const u = new URL(cleaned)
+    return { host: u.hostname, port: u.port || (u.protocol === 'https:' ? '443' : '80') }
+  } catch {
+    const m = cleaned.match(/^https?:\/\/([^:/]+)(?::(\d+))?/)
+    if (m) return { host: m[1], port: m[2] || '80' }
+    return { host: '', port: '' }
+  }
+}
+
+/**
+ * 判断地址是否为 URL（含协议前缀）
+ * @param {string} addr
+ * @returns {boolean}
+ */
+function isUrl(addr) {
+  return /^https?:\/\//i.test(addr)
+}
+
+/**
+ * 获取所有含 registry 配置的工具名列表
+ * @returns {string[]}
+ */
+function getRegistryTools() {
+  const config = getConfig()
+  return Object.keys(config).filter((k) => config[k] && typeof config[k] === 'object' && config[k].registry)
+}
+
+/**
+ * 从完整结果中提取精简版（仅 tool, address, proxy, reachable）
+ * @param {object} item
+ * @returns {{tool: string, address: string, proxy: string, reachable: boolean}}
+ */
+function compact(item) {
+  return { tool: item.tool, address: item.address, proxy: item.proxy, reachable: item.reachable }
+}
+
+/**
+ * 用 ICMP ping 检查主机可访问性
+ * @param {string} host - 主机名或 IP
+ * @param {number} count - 发送包数量
+ * @returns {Promise<object>}
+ */
+function checkByPing(host, count) {
+  return new Promise((resolve) => {
+    const isWin = shell.isWindows
+    const args = isWin
+      ? ['-n', String(count), '-w', '2000', host]
+      : ['-c', String(count), '-W', '2', host]
+
+    const child = spawn('ping', args, { stdio: ['pipe', 'pipe', 'pipe'] })
+    let stdout = ''
+    let stderr = ''
+    child.stdout.on('data', (d) => { stdout += d })
+    child.stderr.on('data', (d) => { stderr += d })
+    child.on('close', () => {
+      const raw = stdout + stderr
+      let received = 0
+      let rttMin = ''
+      let rttAvg = ''
+      let rttMax = ''
+
+      const recvMatch = raw.match(/(\d+)\s+packets?\s+received/)
+      if (recvMatch) received = parseInt(recvMatch[1], 10)
+
+      if (!isWin) {
+        const rttMatch = raw.match(/rtt min\/avg\/max(?:\/mdev)?\s*=\s*([\d.]+)\/([\d.]+)\/([\d.]+)/)
+        if (rttMatch) {
+          rttMin = rttMatch[1]
+          rttAvg = rttMatch[2]
+          rttMax = rttMatch[3]
+        }
+      } else {
+        const msMatch = raw.match(/Minimum\s*=\s*(\d+)ms.*?Maximum\s*=\s*(\d+)ms.*?Average\s*=\s*(\d+)ms/s)
+        if (msMatch) {
+          rttMin = msMatch[1]
+          rttAvg = msMatch[3]
+          rttMax = msMatch[2]
+        }
+      }
+
+      resolve({
+        reachable: received > 0,
+        sent: count,
+        received,
+        loss: count - received,
+        lossPercent: Math.round(((count - received) / count) * 100),
+        rttMin,
+        rttAvg,
+        rttMax,
+        raw: raw.trim(),
+      })
+    })
+    child.on('error', () => {
+      resolve({
+        reachable: false, sent: count, received: 0, loss: count,
+        lossPercent: 100, rttMin: '', rttAvg: '', rttMax: '', raw: 'ping command failed to execute',
+      })
+    })
+  })
+}
+
+/**
+ * 用 curl 检查 URL 可访问性（HTTP，跳过 SSL 校验，跟随跳转）
+ * @param {string} url - 完整 URL
+ * @param {string} [proxy] - 代理地址，设置时通过 -x 路由
+ * @returns {Promise<object>}
+ */
+function checkByCurl(url, proxy) {
+  return new Promise((resolve) => {
+    const args = ['-k', '-L', '-s', '-o', '/dev/null', '-w', '%{http_code} %{time_total}', '--connect-timeout', '2', '--max-time', '5']
+    if (proxy) args.push('-x', proxy)
+    args.push(url)
+    const child = spawn('curl', args, { stdio: ['pipe', 'pipe', 'pipe'] })
+    let stdout = ''
+    let stderr = ''
+    child.stdout.on('data', (d) => { stdout += d })
+    child.stderr.on('data', (d) => { stderr += d })
+    child.on('close', (code) => {
+      const parts = stdout.trim().split(/\s+/)
+      const httpCode = parseInt(parts[0], 10) || 0
+      const timeTotal = parseFloat(parts[1]) || 0
+      const proxyAuthRequired = httpCode === 407
+      const allowlist = [404]
+      const reachable = (httpCode >= 200 && httpCode < 400) || allowlist.includes(httpCode)
+      const rttMs = reachable ? String(Math.round(timeTotal * 1000)) : ''
+      resolve({
+        reachable,
+        proxyAuthRequired,
+        sent: 1,
+        received: reachable ? 1 : 0,
+        loss: reachable ? 0 : 1,
+        lossPercent: reachable ? 0 : 100,
+        rttMin: rttMs,
+        rttAvg: rttMs,
+        rttMax: rttMs,
+        raw: `HTTP ${httpCode} (${timeTotal}s)`,
+      })
+    })
+    child.on('error', () => {
+      resolve({
+        reachable: false, sent: 1, received: 0, loss: 1,
+        lossPercent: 100, rttMin: '', rttAvg: '', rttMax: '', raw: 'curl failed to execute',
+      })
+    })
+  })
+}
+
+/**
+ * 用 wget --spider 检查 URL 可访问性
+ * @param {string} url - 完整 URL
+ * @param {string} [proxy] - 代理地址，设置时通过 -e 路由
+ * @returns {Promise<object>}
+ */
+function checkByWget(url, proxy) {
+  return new Promise((resolve) => {
+    const args = ['-q', '--spider', '--timeout=5']
+    if (proxy) {
+      args.push('-e', `use_proxy=yes`, '-e', `https_proxy=${proxy}`, '-e', `http_proxy=${proxy}`)
+    }
+    args.push(url)
+    const child = spawn('wget', args, { stdio: ['pipe', 'pipe', 'pipe'] })
+    let stdout = ''
+    let stderr = ''
+    child.stdout.on('data', (d) => { stdout += d })
+    child.stderr.on('data', (d) => { stderr += d })
+    child.on('close', (code) => {
+      const reachable = code === 0
+      resolve({
+        reachable,
+        sent: 1,
+        received: reachable ? 1 : 0,
+        loss: reachable ? 0 : 1,
+        lossPercent: reachable ? 0 : 100,
+        rttMin: '',
+        rttAvg: '',
+        rttMax: '',
+        raw: stderr.trim() || (reachable ? 'OK' : 'Failed'),
+      })
+    })
+    child.on('error', () => {
+      resolve({
+        reachable: false, sent: 1, received: 0, loss: 1,
+        lossPercent: 100, rttMin: '', rttAvg: '', rttMax: '', raw: 'wget failed to execute',
+      })
+    })
+  })
+}
+
+/**
+ * 统一检查入口：根据可用工具选择检查方式
+ * @param {string} address - 完整地址（URL 或纯主机名/IP）
+ * @param {string} tool - 检测到的工具 ('ping' | 'curl' | 'wget')
+ * @param {number} count - ping 包数量（仅 ping 用）
+ * @param {string} [proxy] - 代理地址，设置时通过代理路由请求（仅 curl/wget）
+ * @returns {Promise<object>}
+ */
+async function checkReachability(address, tool, count, proxy) {
+  if (tool === 'ping') {
+    let host = address
+    if (isUrl(address)) {
+      const extracted = extractHostPort(address)
+      host = extracted.host
+    }
+    if (!host) {
+      return { reachable: false, sent: count, received: 0, loss: count, lossPercent: 100, rttMin: '', rttAvg: '', rttMax: '', raw: 'Could not parse host from address' }
+    }
+    return checkByPing(host, count)
+  }
+
+  let url = address
+  const debMatch = address.match(/^deb\s+(https?:\/\/\S+)/)
+  if (debMatch) {
+    url = debMatch[1]
+  } else if (!isUrl(url)) {
+    url = `http://${url}`
+  }
+
+  if (tool === 'curl') return checkByCurl(url, proxy)
+  if (tool === 'wget') return checkByWget(url, proxy)
+  return { reachable: false, sent: 0, received: 0, loss: 0, lossPercent: 0, rttMin: '', rttAvg: '', rttMax: '', raw: 'No tool available' }
+}
+
+export class PingGroup {
+  constructor() {
+    this.name = 'ping'
+    this.desc = 'Ping host, active proxy, or all registries to verify accessibility'
+  }
+
+  async run(argv) {
+    const parsed = parseFlags(argv)
+    const [target] = parsed.positional
+
+    if (!target || target === '-h' || target === '--help' || target === 'help') {
+      this.printHelp()
+      return
+    }
+
+    const tool = shell.getNetProbeTool()
+    if (!tool) {
+      console.error('[opm] No network check tool available (ping/curl/wget). Please install one.')
+      process.exit(1)
+    }
+
+    const count = parseInt(parsed.flags.c || parsed.flags.count || '4', 10)
+    const n = (isNaN(count) || count < 1) ? 4 : count
+    const detail = !!(parsed.flags.d || parsed.flags.detail)
+
+    let proxy = ''
+    if ('p' in parsed.flags || 'proxy' in parsed.flags) {
+      let raw = parsed.flags.proxy || parsed.flags.p || ''
+      if (raw === 'true') raw = ''
+      proxy = raw || getActiveProxy()
+    }
+
+    if (target === 'proxy') {
+      return this._pingProxy(n, detail, tool)
+    }
+
+    if (target === 'registry') {
+      return this._pingRegistry(n, detail, proxy, tool)
+    }
+
+    if (target === 'source') {
+      return this._pingSource()
+    }
+
+    if (proxy) {
+      const usable = await this._checkProxyUsable(proxy, tool, n)
+      if (!usable.ok) {
+        console.error(`[opm] Proxy not usable: ${usable.reason}`)
+        process.exit(1)
+      }
+    }
+
+    const result = await checkReachability(target, tool, n, proxy)
+    const item = { tool: 'host', address: target, proxy, ...result }
+    output(detail ? [item] : [compact(item)])
+  }
+
+  /**
+   * 检查代理是否可用：通过代理访问 npm active registry 测试
+   * @returns {{ ok: boolean, reason: string }}
+   */
+  async _checkProxyUsable(proxyUrl, tool, count) {
+    const testUrl = getActiveRegistry('npm')
+    const result = await checkReachability(testUrl, tool, count, proxyUrl)
+    if (result.proxyAuthRequired) {
+      return { ok: false, reason: 'authentication required (HTTP 407)' }
+    }
+    if (!result.reachable) {
+      return { ok: false, reason: result.raw }
+    }
+    return { ok: true, reason: 'OK' }
+  }
+
+  async _pingProxy(count, detail, tool) {
+    const proxyUrl = getActiveProxy()
+    if (!proxyUrl) {
+      const item = { tool: 'proxy', address: '(no active proxy)', proxy: '', reachable: false, sent: 0, received: 0, loss: 0, lossPercent: 0, rttMin: '', rttAvg: '', rttMax: '', raw: 'No active proxy configured (proxy.active is empty)' }
+      output(detail ? [item] : [compact(item)])
+      return
+    }
+
+    const usable = await this._checkProxyUsable(proxyUrl, tool, count)
+    const item = {
+      tool: 'proxy',
+      address: proxyUrl,
+      proxy: '',
+      reachable: usable.ok,
+      sent: 1,
+      received: usable.ok ? 1 : 0,
+      loss: usable.ok ? 0 : 1,
+      lossPercent: usable.ok ? 0 : 100,
+      rttMin: '',
+      rttAvg: '',
+      rttMax: '',
+      raw: usable.reason,
+    }
+    output(detail ? [item] : [compact(item)])
+  }
+
+  async _pingRegistry(count, detail, proxy, tool) {
+    const tools = getRegistryTools()
+
+    if (proxy) {
+      const usable = await this._checkProxyUsable(proxy, tool, 1)
+      if (!usable.ok) {
+        console.error(`[opm] Proxy not usable: ${usable.reason}`)
+        process.exit(1)
+      }
+    }
+
+    const items = await Promise.all(tools.map(async (t) => {
+      const url = getActiveRegistry(t)
+      if (!url) {
+        return { tool: t, address: '', proxy, reachable: false, sent: 0, received: 0, loss: 0, lossPercent: 0, rttMin: '', rttAvg: '', rttMax: '', raw: 'No active registry' }
+      }
+      const result = await checkReachability(url, tool, count, proxy)
+      return { tool: t, address: url, proxy, ...result }
+    }))
+
+    output(detail ? items : items.map(compact))
+  }
+
+  async _pingSource() {
+    const url = getActiveRegistry('npm')
+    const activeProxy = getActiveProxy()
+    const tool = shell.getNetProbeTool()
+
+    if (!tool) {
+      console.error('[opm] No network check tool available (ping/curl/wget).')
+      return
+    }
+
+    const cleanProxy = activeProxy.replace(/^(https?:\/\/)[^@]*@/, '$1')
+    const authProxy = cleanProxy.replace(/^(https?:\/\/)/, '$1user:password@')
+
+    if (tool === 'curl') {
+      console.log(`# tool: ${tool}
+# Windows (PowerShell)
+curl.exe -k --max-time 10 ${url}
+curl.exe -k --max-time 10 --proxy ${cleanProxy} ${url}
+curl.exe -k --max-time 10 --proxy ${authProxy} ${url}
+
+# Linux / macOS
+curl -k --max-time 10 ${url}
+curl -k --max-time 10 --proxy ${cleanProxy} ${url}
+curl -k --max-time 10 --proxy ${authProxy} ${url}`)
+      return
+    }
+
+    if (tool === 'wget') {
+      console.log(`# tool: ${tool}
+# Windows (PowerShell)
+wget.exe -q --spider --timeout=10 ${url}
+wget.exe -q --spider --timeout=10 -e use_proxy=yes -e https_proxy=${cleanProxy} ${url}
+wget.exe -q --spider --timeout=10 -e use_proxy=yes -e https_proxy=${authProxy} ${url}
+
+# Linux / macOS
+wget -q --spider --timeout=10 ${url}
+wget -q --spider --timeout=10 -e use_proxy=yes -e https_proxy=${cleanProxy} ${url}
+wget -q --spider --timeout=10 -e use_proxy=yes -e https_proxy=${authProxy} ${url}`)
+      return
+    }
+
+    if (tool === 'ping') {
+      const { host } = extractHostPort(url)
+      console.log(`# tool: ${tool}
+# Windows
+ping -n 4 -w 10000 ${host}
+
+# Linux / macOS
+ping -c 4 -W 10 ${host}`)
+    }
+  }
+
+  printHelp() {
+    console.log(`
+Usage: opm ping <host|proxy|registry|source> [options]
+
+Actions:
+  ping <host>              Check a host, IP, or URL for accessibility
+  ping proxy               Check the active proxy address (from config)
+  ping registry            Check all tools' active registry addresses in parallel
+  ping source              Print example system commands (npm active registry)
+
+Options:
+  -c, --count <n>          Number of packets to send (ping only; default: 4)
+  -p, --proxy <url>        Record proxy used for the check (informational)
+  -d, --detail             Output full JSON details (default: compact [{tool, address, proxy, reachable}])
+  -h, --help               Show this help
+
+Tool detection: ping > curl > wget (auto-detected)
+
+Output:
+  default (no -d)          [{ "tool": "npm", "address": "https://...", "proxy": "", "reachable": true }]
+  -d / --detail            [{ "tool": "npm", "address": "https://...", "proxy": "", "reachable": true, "sent": 1, "received": 1, "loss": 0, "lossPercent": 0, "rttMin": "...", "rttAvg": "...", "rttMax": "...", "raw": "..." }]
+
+Examples:
+  opm ping 8.8.8.8
+  opm ping https://mirrors.tools.huawei.com/npm/
+  opm ping proxy
+  opm ping registry
+  opm ping source
+  opm ping 8.8.8.8 -c 2
+  opm ping proxy -d
+  opm ping registry -d
+  opm ping sample -d
+`)
+  }
+}