@wwkit/opm 1.0.1 → 1.0.2

package/src/managers/docker.js

@@ -0,0 +1,295 @@
+/**
+ * Docker 管理器
+ *
+ * 跨平台安装策略：
+ * - Linux: 官方便捷脚本 get.docker.com
+ * - macOS: brew install --cask docker (Docker Desktop)
+ * - Windows: WSL2 内跑便捷脚本（WSL 当作 Linux）
+ *
+ * daemon 管理：
+ * - Linux: systemctl start/stop/restart docker
+ * - macOS: open/quit Docker Desktop app
+ * - Windows: wsl -e systemctl start/stop/restart docker
+ */
+
+import { execSync, spawnSync } from 'node:child_process'
+import fs from 'node:fs'
+import { getBrewBin } from './brew.js'
+import { openWsl } from './wsl.js'
+
+const DOCKER_INSTALL_URL = 'https://get.docker.com'
+
+/**
+ * 检查 docker 命令是否可用
+ * @returns {boolean}
+ */
+export function isDockerInstalled() {
+  try {
+    execSync('docker --version', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 获取 docker 版本
+ * @returns {string}
+ */
+export function getDockerVersion() {
+  const out = execSync('docker --version', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+  const m = out.match(/Docker version\s+(\S+)/)
+  return m ? m[1] : out.trim()
+}
+
+/**
+ * 在 Linux 环境中执行 Docker 便捷脚本
+ * @private
+ */
+function runConvenienceScript() {
+  execSync(`curl -fsSL ${DOCKER_INSTALL_URL} | sh`, { stdio: 'inherit', shell: true })
+}
+
+/**
+ * 安装 Docker
+ * @returns {{ action: string, method: string, hint?: string }}
+ */
+export function installDocker() {
+  const platform = process.platform
+
+  if (platform === 'linux') {
+    runConvenienceScript()
+    return { action: 'installed', method: 'convenience-script' }
+  }
+
+  if (platform === 'darwin') {
+    execSync(`${getBrewBin()} install --cask docker`, { stdio: 'inherit', shell: true })
+    return { action: 'installed', method: 'brew-cask', hint: 'Start Docker Desktop from Applications' }
+  }
+
+  if (platform === 'win32') {
+    execSync('wsl.exe -e bash -c "curl -fsSL https://get.docker.com | sh"', { stdio: 'inherit', shell: true })
+    return { action: 'installed', method: 'wsl-convenience-script', hint: 'Docker installed inside WSL2' }
+  }
+
+  throw new Error(`Unsupported platform: ${platform}`)
+}
+
+/**
+ * 升级 Docker
+ * @returns {{ action: string, method: string }}
+ */
+export function upgradeDocker() {
+  const platform = process.platform
+
+  if (platform === 'linux') {
+    try {
+      execSync('apt-get update && apt-get upgrade -y docker-ce', { stdio: 'inherit', shell: true })
+      return { action: 'upgraded', method: 'apt' }
+    } catch {
+      try {
+        execSync('dnf upgrade -y docker-ce', { stdio: 'inherit', shell: true })
+        return { action: 'upgraded', method: 'dnf' }
+      } catch {
+        runConvenienceScript()
+        return { action: 'upgraded', method: 'convenience-script' }
+      }
+    }
+  }
+
+  if (platform === 'darwin') {
+    execSync(`${getBrewBin()} upgrade --cask docker`, { stdio: 'inherit', shell: true })
+    return { action: 'upgraded', method: 'brew-cask' }
+  }
+
+  if (platform === 'win32') {
+    execSync('wsl.exe -e bash -c "sudo apt-get update && sudo apt-get upgrade -y docker-ce"', { stdio: 'inherit', shell: true })
+    return { action: 'upgraded', method: 'wsl-apt' }
+  }
+
+  throw new Error(`Unsupported platform: ${platform}`)
+}
+
+/**
+ * 卸载 Docker
+ * @returns {{ action: string, hint: string }}
+ */
+export function uninstallDocker() {
+  const platform = process.platform
+
+  if (platform === 'linux') {
+    try {
+      execSync('apt-get purge -y docker-ce docker-ce-cli containerd.io', { stdio: 'inherit', shell: true })
+    } catch {
+      execSync('dnf remove -y docker-ce docker-ce-cli containerd.io', { stdio: 'inherit', shell: true })
+    }
+    return { action: 'uninstalled', hint: 'Images/containers left in /var/lib/docker, remove manually if needed' }
+  }
+
+  if (platform === 'darwin') {
+    execSync(`${getBrewBin()} uninstall --cask docker`, { stdio: 'inherit', shell: true })
+    return { action: 'uninstalled', hint: 'Docker Desktop app removed' }
+  }
+
+  if (platform === 'win32') {
+    return {
+      action: 'uninstall',
+      hint: 'Run in WSL: sudo apt-get purge -y docker-ce docker-ce-cli containerd.io',
+    }
+  }
+
+  throw new Error(`Unsupported platform: ${platform}`)
+}
+
+/**
+ * 获取 Docker 数据目录
+ * @returns {string}
+ */
+export function getDockerDir() {
+  const platform = process.platform
+
+  if (platform === 'linux') {
+    return '/var/lib/docker'
+  }
+
+  if (platform === 'darwin') {
+    const home = process.env.HOME || ''
+    return `${home}/.docker`
+  }
+
+  if (platform === 'win32') {
+    const localAppData = process.env.LOCALAPPDATA || ''
+    return localAppData ? `${localAppData}\\Docker` : ''
+  }
+
+  return ''
+}
+
+/**
+ * 获取 Docker 状态（docker info 摘要）
+ * @returns {{ installed: boolean, running?: boolean, info?: string }}
+ */
+export function getDockerStatus() {
+  if (!isDockerInstalled()) return { installed: false }
+  try {
+    const out = execSync('docker info --format "{{.ServerVersion}} {{.OperatingSystem}} {{.Containers}} {{.Images}}"', {
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+    })
+    const [serverVersion, operatingSystem, containers, images] = out.trim().split(' ')
+    return {
+      installed: true,
+      running: true,
+      serverVersion,
+      operatingSystem,
+      containers: parseInt(containers, 10) || 0,
+      images: parseInt(images, 10) || 0,
+    }
+  } catch {
+    return { installed: true, running: false, hint: 'Docker daemon not running' }
+  }
+}
+
+/**
+ * 启动 Docker daemon
+ * @returns {{ action: string, method: string }}
+ */
+export function startDocker() {
+  const platform = process.platform
+
+  if (platform === 'linux') {
+    execSync('sudo systemctl start docker', { stdio: 'inherit', shell: true })
+    return { action: 'started', method: 'systemctl' }
+  }
+
+  if (platform === 'darwin') {
+    execSync('open -a Docker', { stdio: 'inherit', shell: true })
+    return { action: 'started', method: 'docker-desktop' }
+  }
+
+  if (platform === 'win32') {
+    execSync('wsl.exe -e sudo systemctl start docker', { stdio: 'inherit', shell: true })
+    return { action: 'started', method: 'wsl-systemctl' }
+  }
+
+  throw new Error(`Unsupported platform: ${platform}`)
+}
+
+/**
+ * 停止 Docker daemon
+ * @returns {{ action: string, method: string }}
+ */
+export function stopDocker() {
+  const platform = process.platform
+
+  if (platform === 'linux') {
+    execSync('sudo systemctl stop docker', { stdio: 'inherit', shell: true })
+    return { action: 'stopped', method: 'systemctl' }
+  }
+
+  if (platform === 'darwin') {
+    execSync('osascript -e \'quit app "Docker"\'', { stdio: 'inherit', shell: true })
+    return { action: 'stopped', method: 'docker-desktop' }
+  }
+
+  if (platform === 'win32') {
+    execSync('wsl.exe -e sudo systemctl stop docker', { stdio: 'inherit', shell: true })
+    return { action: 'stopped', method: 'wsl-systemctl' }
+  }
+
+  throw new Error(`Unsupported platform: ${platform}`)
+}
+
+/**
+ * 重启 Docker daemon
+ * @returns {{ action: string, method: string }}
+ */
+export function restartDocker() {
+  const platform = process.platform
+
+  if (platform === 'linux') {
+    execSync('sudo systemctl restart docker', { stdio: 'inherit', shell: true })
+    return { action: 'restarted', method: 'systemctl' }
+  }
+
+  if (platform === 'darwin') {
+    execSync('osascript -e \'quit app "Docker"\' && sleep 1 && open -a Docker', { stdio: 'inherit', shell: true })
+    return { action: 'restarted', method: 'docker-desktop' }
+  }
+
+  if (platform === 'win32') {
+    execSync('wsl.exe -e sudo systemctl restart docker', { stdio: 'inherit', shell: true })
+    return { action: 'restarted', method: 'wsl-systemctl' }
+  }
+
+  throw new Error(`Unsupported platform: ${platform}`)
+}
+
+/**
+ * 打开终端并确保 docker 可用
+ * - Linux: 新开终端
+ * - macOS: 打开 Terminal.app
+ * - Windows: 打开 PowerShell → WSL2（docker 装在 WSL 内）
+ * @returns {{ action: string, method: string }}
+ */
+export function openDocker() {
+  const platform = process.platform
+
+  if (platform === 'linux') {
+    const shell = process.env.SHELL || 'bash'
+    spawnSync(shell, [], { stdio: 'inherit' })
+    return { action: 'opened', method: 'shell' }
+  }
+
+  if (platform === 'darwin') {
+    execSync('open -a Terminal', { stdio: 'inherit', shell: true })
+    return { action: 'opened', method: 'terminal-app' }
+  }
+
+  if (platform === 'win32') {
+    openWsl('')
+    return { action: 'opened', method: 'wsl-powershell' }
+  }
+
+  throw new Error(`Unsupported platform: ${platform}`)
+}

package/src/managers/wsl.js

@@ -0,0 +1,258 @@
+/**
+ * WSL2 管理器（Windows Subsystem for Linux）
+ *
+ * 通过 wsl.exe CLI 管理自身与发行版。仅 Windows 可用。
+ * wsl.exe 输出为 UTF-16LE 编码，需用对应 encoding 读取。
+ */
+
+import { execSync, spawnSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+
+const WSL_EXE = 'wsl.exe'
+
+/**
+ * 要求 Windows 平台，否则抛出
+ * @private
+ */
+function requireWindows() {
+  if (process.platform !== 'win32') {
+    throw new Error('WSL is only available on Windows')
+  }
+}
+
+/**
+ * 检查 WSL 是否已安装（wsl.exe 是否可用）
+ * @returns {boolean}
+ */
+export function isWslInstalled() {
+  if (process.platform !== 'win32') return false
+  try {
+    execSync(`${WSL_EXE} --version`, { encoding: 'utf16le', stdio: ['pipe', 'pipe', 'pipe'] })
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 解析 wsl --version 输出，提取 WSL 版本号
+ * @param {string} out
+ * @returns {string}
+ */
+export function parseWslVersionOutput(out) {
+  const m = out.match(/WSL\s+(?:版本|version)[:\s]\s*([\d.]+)/i)
+  return m ? m[1] : out.trim().split('\n')[0].trim()
+}
+
+/**
+ * 获取 WSL 版本号
+ * @returns {string}
+ */
+export function getWslVersion() {
+  requireWindows()
+  const out = execSync(`${WSL_EXE} --version`, { encoding: 'utf16le', stdio: ['pipe', 'pipe', 'pipe'] })
+  return parseWslVersionOutput(out)
+}
+
+/**
+ * 安装 WSL2（含默认发行版）
+ * @returns {{ action: string, hint: string }}
+ */
+export function installWsl() {
+  requireWindows()
+  execSync(`${WSL_EXE} --install`, { stdio: 'inherit', shell: true })
+  return { action: 'installed', hint: 'Restart may be required' }
+}
+
+/**
+ * 更新 WSL 内核
+ * @returns {{ action: string }}
+ */
+export function updateWsl() {
+  requireWindows()
+  execSync(`${WSL_EXE} --update`, { stdio: 'inherit', shell: true })
+  return { action: 'updated' }
+}
+
+/**
+ * 卸载 WSL 提示（需通过 Windows 设置操作）
+ * @returns {{ action: string, hint: string }}
+ */
+export function uninstallWsl() {
+  return {
+    action: 'uninstall',
+    hint: 'Go to Settings > Apps > Optional Features > "Windows Subsystem for Linux" to uninstall',
+  }
+}
+
+/**
+ * 获取 WSL 数据目录
+ * @returns {string}
+ */
+export function getWslDir() {
+  if (process.platform !== 'win32') return ''
+  const localAppData = process.env.LOCALAPPDATA || ''
+  if (!localAppData) return ''
+  const packagesDir = path.join(localAppData, 'Packages')
+  try {
+    const entries = fs.readdirSync(packagesDir)
+    const wslEntry = entries.find((e) => /CanonicalGroupLimited|Microsoft\.WSL/i.test(e))
+    if (wslEntry) return path.join(packagesDir, wslEntry)
+  } catch {}
+  return packagesDir
+}
+
+/**
+ * 解析 wsl -l -v 输出为发行版列表
+ * @param {string} out
+ * @returns {{ name: string, state: string, version: string, default: boolean }[]}
+ */
+export function parseDistroList(out) {
+  const lines = out.split('\n').map((l) => l.trim()).filter(Boolean)
+  const distros = []
+  for (const line of lines) {
+    if (/NAME/i.test(line) && /STATE/i.test(line)) continue
+    const parts = line.split(/\s+/)
+    if (parts.length >= 3) {
+      const isDefault = parts[0] === '*'
+      const name = isDefault ? parts[1] : parts[0]
+      const state = isDefault ? parts[2] : parts[1]
+      const version = isDefault ? parts[3] : parts[2]
+      distros.push({ name, state, version, default: isDefault })
+    }
+  }
+  return distros
+}
+
+/**
+ * 列出已安装的发行版
+ * @returns {{ name: string, state: string, version: string, default: boolean }[]}
+ */
+export function listDistros() {
+  requireWindows()
+  const out = execSync(`${WSL_EXE} -l -v`, { encoding: 'utf16le', stdio: ['pipe', 'pipe', 'pipe'] })
+  return parseDistroList(out)
+}
+
+/**
+ * 解析 wsl -l -o 输出为可用发行版名称列表
+ * @param {string} out
+ * @returns {string[]}
+ */
+export function parseAvailableList(out) {
+  const lines = out.split('\n').map((l) => l.trim()).filter(Boolean)
+  return lines.slice(1).map((l) => l.split(/\s+/)[0]).filter(Boolean)
+}
+
+/**
+ * 列出可安装的发行版
+ * @returns {string[]}
+ */
+export function listAvailable() {
+  requireWindows()
+  const out = execSync(`${WSL_EXE} -l -o`, { encoding: 'utf16le', stdio: ['pipe', 'pipe', 'pipe'] })
+  return parseAvailableList(out)
+}
+
+/**
+ * 安装指定发行版
+ * @param {string} name
+ * @returns {{ name: string, action: string }}
+ */
+export function installDistro(name) {
+  requireWindows()
+  execSync(`${WSL_EXE} --install -d ${name}`, { stdio: 'inherit', shell: true })
+  return { name, action: 'installed' }
+}
+
+/**
+ * 移除指定发行版
+ * @param {string} name
+ * @returns {{ name: string, action: string }}
+ */
+export function removeDistro(name) {
+  requireWindows()
+  execSync(`${WSL_EXE} --unregister ${name}`, { stdio: 'inherit', shell: true })
+  return { name, action: 'removed' }
+}
+
+/**
+ * 在当前终端启动发行版
+ * @param {string} name
+ * @returns {{ name: string, action: string }}
+ */
+export function startDistro(name) {
+  requireWindows()
+  execSync(`${WSL_EXE} -d ${name}`, { stdio: 'inherit', shell: true })
+  return { name, action: 'started' }
+}
+
+/**
+ * 停止指定发行版
+ * @param {string} name
+ * @returns {{ name: string, action: string }}
+ */
+export function stopDistro(name) {
+  requireWindows()
+  execSync(`${WSL_EXE} --terminate ${name}`, { stdio: 'inherit', shell: true })
+  return { name, action: 'stopped' }
+}
+
+/**
+ * 停止所有发行版
+ * @returns {{ action: string }}
+ */
+export function stopAll() {
+  requireWindows()
+  execSync(`${WSL_EXE} --shutdown`, { stdio: 'inherit', shell: true })
+  return { action: 'all stopped' }
+}
+
+/**
+ * 设置默认发行版
+ * @param {string} name
+ * @returns {{ name: string, action: string }}
+ */
+export function setDefaultDistro(name) {
+  requireWindows()
+  execSync(`${WSL_EXE} --set-default ${name}`, { stdio: 'inherit', shell: true })
+  return { name, action: 'default set' }
+}
+
+/**
+ * 获取当前默认发行版名称
+ * @returns {string}
+ */
+export function getDefaultDistro() {
+  if (!isWslInstalled()) return ''
+  const distros = listDistros()
+  const def = distros.find((d) => d.default)
+  return def ? def.name : ''
+}
+
+/**
+ * 获取 WSL 状态
+ * @returns {{ installed: boolean, status?: string }}
+ */
+export function getWslStatus() {
+  if (!isWslInstalled()) return { installed: false }
+  try {
+    const out = execSync(`${WSL_EXE} --status`, { encoding: 'utf16le', stdio: ['pipe', 'pipe', 'pipe'] })
+    return { installed: true, status: out.trim() }
+  } catch {
+    return { installed: true, status: '' }
+  }
+}
+
+/**
+ * 打开 PowerShell 窗口并进入 WSL
+ * @param {string} [distro] - 发行版名称（空则用默认）
+ * @returns {{ distro: string, action: string }}
+ */
+export function openWsl(distro) {
+  requireWindows()
+  const wslCmd = distro ? `wsl -d ${distro}` : 'wsl'
+  spawnSync('cmd.exe', ['/c', 'start', '"WSL"', 'powershell', '-NoExit', '-Command', wslCmd], { stdio: 'inherit' })
+  return { distro: distro || 'default', action: 'opened' }
+}