@wwkit/opm 1.0.1 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wwkit/opm",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "author": "bluesliu <langcai163@163.com>",
   "description": "Unified CLI — package management (npm/pip/dnf/apt) + config view + opencode maintenance",
   "type": "module",
@@ -32,6 +32,7 @@
   ],
   "license": "MIT",
   "dependencies": {
+    "basic-ftp": "^6.2.1",
     "extract-zip": "^2.0.1",
     "@wwkit/shared": "1.0.5"
   },

package/src/cli/groups/docker.js

@@ -0,0 +1,116 @@
+/**
+ * docker 命令组 — 管理 Docker 自身与 daemon
+ *
+ * 继承 ToolManagerGroup 复用 version/installed/install/upgrade/uninstall/dir，
+ * 额外增加 status/start/stop/restart/open。
+ * 跨平台：Linux 用便捷脚本，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)',
+      hasRegistry: false,
+      isInstalled: () => isDockerInstalled(),
+      getPath: () => getDockerDir(),
+      versionCmd: () => 'docker --version',
+      parseVersion: (out) => {
+        const m = out.match(/Docker version\s+(\S+)/)
+        return m ? m[1] : out.trim()
+      },
+      install: () => installDocker(),
+      upgrade: () => upgradeDocker(),
+      uninstall: () => uninstallDocker(),
+      usage: 'opm docker <action> [options]',
+      actions: [
+        ['version', 'Show Docker version'],
+        ['installed', 'Check if Docker is installed'],
+        ['install', 'Install Docker (Linux: get.docker.com, 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 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/wsl.js

@@ -0,0 +1,220 @@
+/**
+ * wsl 命令组 — 管理 WSL2 自身与发行版
+ *
+ * 继承 ToolManagerGroup 复用 version/installed/upgrade/uninstall/dir，
+ * 额外增加发行版管理动作（list/available/remove/start/stop/stop-all/
+ * set-default/default/status/open）与带可选参数的 install。
+ * 仅 Windows 可用；wsl.exe 输出为 UTF-16LE，需 override _version/_installed。
+ */
+
+import { execSync } from 'node:child_process'
+import { ToolManagerGroup } from './version-manager.js'
+import { parseFlags } from '../helpers/args.js'
+import { output } from '../../formatter.js'
+import {
+  isWslInstalled,
+  getWslVersion,
+  installWsl,
+  updateWsl,
+  uninstallWsl,
+  getWslDir,
+  listDistros,
+  listAvailable,
+  installDistro,
+  removeDistro,
+  startDistro,
+  stopDistro,
+  stopAll,
+  setDefaultDistro,
+  getDefaultDistro,
+  getWslStatus,
+  openWsl,
+} from '../../managers/wsl.js'
+
+export class WslGroup extends ToolManagerGroup {
+  constructor() {
+    super({
+      name: 'wsl',
+      desc: 'WSL2 manager (install/upgrade/list/open distros)',
+      hasRegistry: false,
+      isInstalled: () => isWslInstalled(),
+      getPath: () => getWslDir(),
+      versionCmd: () => 'wsl.exe --version',
+      parseVersion: (out) => out.trim().split('\n')[0].trim(),
+      install: () => installWsl(),
+      upgrade: () => updateWsl(),
+      uninstall: () => uninstallWsl(),
+      usage: 'opm wsl <action> [args] [options]',
+      actions: [
+        ['version', 'Show WSL version'],
+        ['installed', 'Check if WSL is installed'],
+        ['install [distro]', 'Install WSL2 (or a specific distribution)'],
+        ['upgrade', 'Update WSL kernel (wsl --update)'],
+        ['uninstall', 'Show uninstall instructions'],
+        ['dir', 'Show WSL data directory'],
+        ['list', 'List installed distributions'],
+        ['available', 'List available distributions'],
+        ['remove <distro>', 'Remove a distribution'],
+        ['start [distro]', 'Start a distribution in current terminal'],
+        ['stop <distro>', 'Stop a distribution'],
+        ['stop-all', 'Stop all distributions'],
+        ['set-default <distro>', 'Set default distribution'],
+        ['default', 'Show default distribution'],
+        ['status', 'Show WSL status'],
+        ['open [distro]', 'Open PowerShell window and enter WSL'],
+        ['help', 'Show this help'],
+      ],
+      examples: [
+        'opm wsl version',
+        'opm wsl installed',
+        'opm wsl install',
+        'opm wsl install Ubuntu',
+        'opm wsl list',
+        'opm wsl available',
+        'opm wsl open',
+        'opm wsl open Ubuntu',
+        'opm wsl start Ubuntu',
+        'opm wsl stop Ubuntu',
+        'opm wsl stop-all',
+        'opm wsl set-default Ubuntu',
+        'opm wsl default',
+        'opm wsl status',
+        'opm wsl dir',
+      ],
+    })
+  }
+
+  async run(argv) {
+    const [action, ...rest] = argv
+
+    if (!action || action === '-h' || action === '--help' || action === 'help') {
+      this.printHelp()
+      return
+    }
+
+    switch (action) {
+      case 'list':
+        return this._list()
+      case 'available':
+        return this._available()
+      case 'remove':
+        return this._remove(parseFlags(rest))
+      case 'start':
+        return this._start(parseFlags(rest))
+      case 'stop':
+        return this._stop(parseFlags(rest))
+      case 'stop-all':
+        return this._stopAll()
+      case 'set-default':
+        return this._setDefault(parseFlags(rest))
+      case 'default':
+        return this._default()
+      case 'status':
+        return this._status()
+      case 'open':
+        return this._open(parseFlags(rest))
+      case 'install':
+        return this._installDistro(parseFlags(rest))
+    }
+
+    return super.run(argv)
+  }
+
+  _version() {
+    if (!isWslInstalled()) {
+      output('')
+      return
+    }
+    try {
+      output(getWslVersion())
+    } catch {
+      output('')
+    }
+  }
+
+  _installed() {
+    const installed = isWslInstalled()
+    const result = { name: 'wsl', installed }
+    if (installed) {
+      result.path = getWslDir()
+      try {
+        result.version = getWslVersion()
+      } catch {}
+    }
+    output(result)
+  }
+
+  _installDistro(parsed) {
+    const distro = parsed.positional[0]
+    if (distro) {
+      output(installDistro(distro))
+      return
+    }
+    if (isWslInstalled()) {
+      output({ name: 'wsl', installed: true, hint: 'WSL already installed, use "opm wsl install <distro>" to install a distribution' })
+      return
+    }
+    output(installWsl())
+  }
+
+  _list() {
+    output(listDistros())
+  }
+
+  _available() {
+    output(listAvailable().map((name) => ({ name })))
+  }
+
+  _remove(parsed) {
+    const distro = parsed.positional[0]
+    if (!distro) {
+      console.error('Usage: opm wsl remove <distro>')
+      process.exit(1)
+    }
+    output(removeDistro(distro))
+  }
+
+  _start(parsed) {
+    const distro = parsed.positional[0] || getDefaultDistro()
+    if (!distro) {
+      console.error('Usage: opm wsl start [distro]')
+      process.exit(1)
+    }
+    output(startDistro(distro))
+  }
+
+  _stop(parsed) {
+    const distro = parsed.positional[0]
+    if (!distro) {
+      console.error('Usage: opm wsl stop <distro>')
+      process.exit(1)
+    }
+    output(stopDistro(distro))
+  }
+
+  _stopAll() {
+    output(stopAll())
+  }
+
+  _setDefault(parsed) {
+    const distro = parsed.positional[0]
+    if (!distro) {
+      console.error('Usage: opm wsl set-default <distro>')
+      process.exit(1)
+    }
+    output(setDefaultDistro(distro))
+  }
+
+  _default() {
+    output({ default: getDefaultDistro() })
+  }
+
+  _status() {
+    output(getWslStatus())
+  }
+
+  _open(parsed) {
+    const distro = parsed.positional[0] || getDefaultDistro()
+    output(openWsl(distro || ''))
+  }
+}

package/src/cli/index.js

@@ -15,7 +15,10 @@ import { NvmGroup } from './groups/nvm.js'
 import { PhpenvGroup } from './groups/phpenv.js'
 import { UvGroup } from './groups/uv.js'
 import { HomebrewGroup } from './groups/homebrew.js'
+import { WslGroup } from './groups/wsl.js'
+import { DockerGroup } from './groups/docker.js'
 import { EnsureGroup } from './groups/ensure.js'
+import { FtpGroup } from '../tools/ftp/index.js'
 import { HarnessGroup } from '../harnesses/base.js'
 import { opencodeHarness } from '../harnesses/opencode/index.js'
 import { CftGroup } from '../binaries/cft/index.js'
@@ -33,6 +36,9 @@ const GROUPS = {
   apt: new PackageGroup('apt'),
   brew: new PackageGroup('brew'),
   homebrew: new HomebrewGroup(),
+  wsl: new WslGroup(),
+  docker: new DockerGroup(),
+  ftp: new FtpGroup(),
   composer: new PackageGroup('composer'),
   bun: new PackageGroup('bun'),
   winget: new PackageGroup('winget'),

package/src/config.json5

@@ -155,4 +155,19 @@
       active: "npmmirror",
     },
   },
+
+  // FTP 连接配置
+  // password 用 {env:XXX} 引用环境变量，不硬编码
+  // pasv: false — 阿里云虚拟主机必须用主动模式
+  ftp: {
+    host: "wh-nxb3pizm7zyfvpv4113.my3w.com",
+    port: 21,
+    user: "{env:FTP_USER}",
+    password: "{env:FTP_PASSWORD}",
+    remote_root: "/htdocs/webwork",
+    base_url: "http://deepbluenet.com/webwork",
+    timeout: 120,
+    max_retries: 2,
+    pasv: false,
+  },
 }

package/src/index.js

@@ -16,6 +16,10 @@ export { CftGroup } from './binaries/cft/index.js'
 export { NvmGroup } from './cli/groups/nvm.js'
 export { PhpenvGroup } from './cli/groups/phpenv.js'
 export { UvGroup } from './cli/groups/uv.js'
+export { HomebrewGroup } from './cli/groups/homebrew.js'
+export { WslGroup } from './cli/groups/wsl.js'
+export { DockerGroup } from './cli/groups/docker.js'
+export { FtpGroup } from './tools/ftp/index.js'
 export { ToolManagerGroup } from './cli/groups/version-manager.js'
 export { parseFlags } from './cli/helpers/args.js'
 
@@ -31,6 +35,17 @@ export { BunManager } from './managers/bun.js'
 export { NodeManager, isNvmInstalled, getNvmSh } from './managers/node.js'
 export { PhpManager, isPhpenvInstalled, getPhpenvBin } from './managers/php.js'
 export { PythonManager, isUvInstalled, getUvBin } from './managers/python.js'
+export {
+  isWslInstalled, getWslVersion, parseWslVersionOutput, parseDistroList,
+  parseAvailableList, listDistros, listAvailable, installDistro, removeDistro,
+  startDistro, stopDistro, stopAll, setDefaultDistro, getDefaultDistro,
+  getWslStatus, openWsl, installWsl, updateWsl, uninstallWsl, getWslDir,
+} from './managers/wsl.js'
+export {
+  isDockerInstalled, getDockerVersion, installDocker, upgradeDocker,
+  uninstallDocker, getDockerDir, getDockerStatus, startDocker, stopDocker,
+  restartDocker, openDocker,
+} from './managers/docker.js'
 
 export {
   NPM_PRESETS, PIP_PRESETS, DNF_PRESETS, APT_PRESETS, BREW_PRESETS, COMPOSER_PRESETS,