@wwkit/opm 1.0.4 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wwkit/opm",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "author": "bluesliu <langcai163@163.com>",
   "description": "Unified CLI — package management (npm/pip/dnf/apt) + config view + opencode maintenance",
   "type": "module",
@@ -35,7 +35,7 @@
     "basic-ftp": "^6.2.1",
     "extract-zip": "^2.0.1",
     "systeminformation": "^5.23.0",
-    "@wwkit/shared": "1.0.7"
+    "@wwkit/shared": "1.0.8"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",

package/src/cli/groups/ping.js

@@ -250,6 +250,8 @@ async function checkReachability(address, tool, count, proxy) {
   return { reachable: false, sent: 0, received: 0, loss: 0, lossPercent: 0, rttMin: '', rttAvg: '', rttMax: '', raw: 'No tool available' }
 }
 
+export { checkReachability, extractHostPort }
+
 export class PingGroup {
   constructor() {
     this.name = 'ping'

package/src/managers/npm.js

@@ -437,12 +437,39 @@ export class NpmManager extends PackageManager {
     }
   }
 
+  /**
+   * 查询 npm 主版本号（缓存），用于判断是否支持 --allow-scripts（npm >= 11）
+   * @returns {number}
+   * @private
+   */
+  _npmMajor() {
+    if (this._npmMajorCache !== undefined) return this._npmMajorCache
+    try {
+      const v = this._exec(['--version'], { allowNonZero: true }).trim()
+      this._npmMajorCache = parseInt(v.split('.')[0], 10) || 0
+    } catch {
+      this._npmMajorCache = 0
+    }
+    return this._npmMajorCache
+  }
+
+  /**
+   * 构造 --allow-scripts 参数（仅 npm >= 11 支持）
+   * @param {string} name - 包名
+   * @returns {string[]}
+   * @private
+   */
+  _allowScriptsArgs(name) {
+    return this._npmMajor() >= 11 ? [`--allow-scripts=${name}`] : []
+  }
+
   async install(name, version, opts = {}) {
     const spec = version ? `${name}@${version}` : name
     const args = ['install', spec]
     if (opts.global) args.push('-g')
     args.push(...this._proxyArgs(opts.proxy))
     args.push(...this._registryArgs())
+    if (opts.allowScripts) args.push(...this._allowScriptsArgs(name))
 
     this._execInherit(args)
     return { name, version: version || 'latest', action: 'installed' }
@@ -461,6 +488,7 @@ export class NpmManager extends PackageManager {
     if (opts.global) args.push('-g')
     args.push(...this._proxyArgs(opts.proxy))
     args.push(...this._registryArgs())
+    if (opts.allowScripts) args.push(...this._allowScriptsArgs(name))
 
     this._execInherit(args)
     return { name, version: 'latest', action: 'upgraded' }

package/src/tools/share/index.js

@@ -1,11 +1,11 @@
 /**
  * opm share 命令组 — 文本分享服务
  *
- * 命令：upload / zip / get / view / open / list / delete / clear / config / serve / help
+ * 命令：upload / zip / get / view / open / list / delete / clear / config / server / help
  * 服务地址由 config.share.server.active 解析（不支持命令行 -s 参数）。
  * 需要服务调用的命令执行前先 ping 验证可达性；
  * 若 active=local 且服务未启动，自动后台启动后再执行。
- * serve 子命令：start（后台启动）/ stop（停止）/ status（查询状态）。
+ * server 子命令：start（后台启动）/ stop（停止）/ status（查询状态）。
  * zip 上传文件/文件夹（压缩为 zip 后 base64 上传），get -d 下载并解压。
  */
 
@@ -65,7 +65,7 @@ function openBrowser(url) {
 }
 
 /**
- * 获取 serve 状态文件路径
+ * 获取 server 状态文件路径
  * @returns {string}
  */
 function getServePidFile() {
@@ -73,7 +73,7 @@ function getServePidFile() {
 }
 
 /**
- * 读取 serve PID 文件
+ * 读取 server PID 文件
  * @returns {{pid: number, url: string, host: string, port: number, dataDir: string, started: string}|null}
  */
 function readServePid() {
@@ -111,14 +111,14 @@ const ACTIONS = {
   delete: { desc: 'Delete a share by id' },
   clear:  { desc: 'Clean up shares by days and/or keep count' },
   config: { desc: 'Show current share config section' },
-  serve:  { desc: 'Manage local server (start/stop/status)' },
+  server:  { desc: 'Manage local server (start/stop/status)' },
   help:   { desc: 'Show this help' },
 }
 
 export class ShareGroup {
   constructor() {
     this.name = 'share'
-    this.desc = 'Text sharing service (upload/get/open/list/serve)'
+    this.desc = 'Text sharing service (upload/get/open/list/server)'
   }
 
   async run(argv) {
@@ -150,8 +150,8 @@ export class ShareGroup {
         return this._clear(parsed)
       case 'config':
         return this._config(parsed)
-      case 'serve':
-        return this._serve(parsed)
+      case 'server':
+        return this._server(parsed)
       default:
         return this._upload(parseFlags([action, ...rest]))
     }
@@ -228,7 +228,7 @@ export class ShareGroup {
       }
     }
 
-    console.error(`[opm share] Failed to start local server. Run "opm share serve status" to check.`)
+    console.error(`[opm share] Failed to start local server. Run "opm share server status" to check.`)
     process.exit(1)
   }
 
@@ -498,31 +498,31 @@ export class ShareGroup {
     output(cfg)
   }
 
-  async _serve(parsed) {
+  async _server(parsed) {
     const [sub] = parsed.positional
 
     if (sub === 'start') {
-      return this._serveStart()
+      return this._serverrStart()
     }
     if (sub === 'stop') {
-      return this._serveStop()
+      return this._serverrStop()
     }
     if (sub === 'status' || !sub) {
-      return this._serveStatus()
+      return this._serverrStatus()
     }
     if (sub === 'help' || sub === '-h' || sub === '--help') {
-      this._serveHelp()
+      this._serverrHelp()
       return
     }
 
-    console.error(`Unknown serve subcommand: ${sub}`)
-    console.error('Usage: opm share serve [start|stop|status|help]')
+    console.error(`Unknown server subcommand: ${sub}`)
+    console.error('Usage: opm share server [start|stop|status|help]')
     process.exit(1)
   }
 
-  _serveHelp() {
+  _serverrHelp() {
     console.log(`
-Usage: opm share serve <subcommand>
+Usage: opm share server <subcommand>
 
 Subcommands:
   start     Start local server (background, reads host/port/dataDir from config)
@@ -531,9 +531,9 @@ Subcommands:
   help      Show this help
 
 Local development:
-  opm share serve start                Start in background (reads config)
-  opm share serve status               Check status
-  opm share serve stop                 Stop server
+  opm share server start                Start in background (reads config)
+  opm share server status               Check status
+  opm share server stop                 Stop server
   opm share config                     Show current config (host/port/dataDir)
 
   # Or run server.js directly (foreground):
@@ -549,7 +549,7 @@ Deploy to server:
   #    share.server.active = "official"  # or a custom URL
 
   # 3. Start the server (foreground or via process manager)
-  opm share serve start
+  opm share server start
   # Or with custom env:
   OPM_SHARE_HOST=0.0.0.0 OPM_SHARE_PORT=80 OPM_SHARE_DATA_DIR=/var/lib/opm/share node src/tools/share/server.js
 
@@ -587,7 +587,7 @@ Environment variables (for server.js direct execution):
 `)
   }
 
-  _serveStart() {
+  _serverrStart() {
     const existing = readServePid()
     if (existing && isProcessAlive(existing.pid)) {
       output({ running: true, pid: existing.pid, url: existing.url, host: existing.host, port: existing.port, dataDir: existing.dataDir, started: existing.started, message: 'Server already running' })
@@ -595,7 +595,7 @@ Environment variables (for server.js direct execution):
     }
 
     this._startBackground()
-    output({ started: true, message: 'Server started in background. Run "opm share serve status" to check.' })
+    output({ started: true, message: 'Server started in background. Run "opm share server status" to check.' })
   }
 
   _startBackground() {
@@ -628,10 +628,10 @@ Environment variables (for server.js direct execution):
     fs.writeFileSync(pidFile, JSON.stringify(pidInfo, null, 2), 'utf8')
   }
 
-  _serveStop() {
+  _serverrStop() {
     const pidInfo = readServePid()
     if (!pidInfo) {
-      output({ stopped: true, message: 'No serve process found (pid file missing)' })
+      output({ stopped: true, message: 'No server process found (pid file missing)' })
       return
     }
 
@@ -650,10 +650,10 @@ Environment variables (for server.js direct execution):
     output({ stopped: true, pid: pidInfo.pid, url: pidInfo.url, message: 'Server stopped' })
   }
 
-  _serveStatus() {
+  _serverrStatus() {
     const pidInfo = readServePid()
     if (!pidInfo) {
-      output({ running: false, message: 'No serve process found' })
+      output({ running: false, message: 'No server process found' })
       return
     }
 
@@ -678,10 +678,10 @@ Usage: opm share <action> [args] [options]
 Actions:
 ${actionLines}
 
-Serve subcommands:
-  serve start                  Start local server (background)
-  serve stop                   Stop local server
-  serve status                 Check local server status
+Server subcommands:
+  server start                 Start local server (background)
+  server stop                  Stop local server
+  server status                Check local server status
 
 Shorthand:
   opm share "<content>" [-t title]     Upload (without "upload" keyword)
@@ -704,9 +704,9 @@ Server config (config.json5):
 
 Examples:
   opm share config                     Show current share config
-  opm share serve start                Start local server (background)
-  opm share serve status               Check if server is running
-  opm share serve stop                 Stop local server
+  opm share server start                Start local server (background)
+  opm share server status               Check if server is running
+  opm share server stop                 Stop local server
   opm share "hello world" -t test      Upload text
   opm share "hello world" -i myid      Upload text with custom id "myid"
   opm share "hello world" -p 1234      Upload text with password override

package/src/tools/share/server.js

@@ -15,9 +15,9 @@
  *   pm2 save && pm2 startup
  *
  * 方式三：opm 内置管理
- *   opm share serve start    # 后台启动（读取 config.json5 中 share.serve 配置）
- *   opm share serve stop
- *   opm share serve status
+ *   opm share server start    # 后台启动（读取 config.json5 中 share.serve 配置）
+ *   opm share server stop
+ *   opm share server status
  *
  * ──────────────────────────────────────────────────────────────
  * 可配置常量（集中在此，按需修改）

package/src/tools/share/server.php

@@ -44,7 +44,7 @@ $LISTEN_PORT = 8787;
 // 以下为服务实现，通常无需修改
 // ──────────────────────────────────────────────────────────────
 
-// 环境变量优先于常量（兼容 opm share serve 后台启动注入的场景）
+// 环境变量优先于常量（兼容 opm share server 后台启动注入的场景）
 
 function resolveDataDir() {
     global $DATA_DIR;

package/src/tools/webwork/index.js

@@ -10,19 +10,27 @@
  *   6. harness（npm 全局安装 @wwkit/harness，已安装则跳过）
  *   7. sshproxy（npm 全局安装 @wwkit/sshproxy，已安装则跳过）
  *
- * 命令: version / versions / installed / install / uninstall / upgrade / help
+ * install 流程：镜像可达检查 → 安装组件 → 初始化 → 验证
+ * init 流程：ww config init → ww webdriver init → ww opencode init → ww sqlite init
+ * verify 流程：ww sqlite debug → ww run debug → ww web status → ww webdriver debug
+ *
+ * 命令: version / versions / installed / install / init / verify / uninstall / upgrade / help
  */
 
 import { execSync } from 'node:child_process'
 
+import { Shell } from '@wwkit/shared'
 import { parseFlags } from '../../cli/helpers/args.js'
 import { output } from '../../formatter.js'
-import { getActiveProxy, getConfig } from '../../config.js'
+import { getActiveProxy, getConfig, getActiveRegistry } from '../../config.js'
 import { NpmManager } from '../../managers/npm.js'
 import { PipManager } from '../../managers/pip.js'
 import { PythonManager, isUvInstalled, installUv } from '../../managers/python.js'
 import { NodeManager, isNvmInstalled, installNvm } from '../../managers/node.js'
 import { CftGroup } from '../../binaries/cft/index.js'
+import { checkReachability } from '../../cli/groups/ping.js'
+
+const shell = new Shell()
 
 const COMPONENTS = [
   { key: 'python', label: 'Python' },
@@ -44,8 +52,10 @@ const ACTIONS = {
   version:   { desc: 'Show installed version of each component' },
   versions:  { desc: 'Show latest available version of each component (remote)' },
   installed: { desc: 'Show install status (true/false) of each component' },
-  install:   { desc: 'Install all components in order (python -> blues-lib -> cft -> node -> opencode -> harness -> sshproxy)' },
-  uninstall: { desc: 'Uninstall all components in reverse order (sshproxy -> harness -> opencode -> node -> cft -> blues-lib)' },
+  install:   { desc: 'Install all components + init + verify' },
+  init:      { desc: 'Initialize runtime (config/webdriver/opencode/sqlite)' },
+  verify:    { desc: 'Verify installation (sqlite/run/web/webdriver)' },
+  uninstall: { desc: 'Uninstall all components in reverse order' },
   upgrade:   { desc: 'Upgrade all components to latest' },
   help:      { desc: 'Show this help' },
 }
@@ -75,6 +85,10 @@ export class WebworkGroup {
         return this._installed()
       case 'install':
         return this._install(parsed)
+      case 'init':
+        return this._init(parsed)
+      case 'verify':
+        return this._verify(parsed)
       case 'uninstall':
         return this._uninstall(parsed)
       case 'upgrade':
@@ -183,7 +197,16 @@ export class WebworkGroup {
 
   async _install(parsed) {
     const proxy = this._resolveProxy(parsed)
+
+    console.log('\n========== 步骤 1/3: 检查镜像可达性 ==========')
+    await this._checkMirrors(proxy)
+
+    console.log('\n========== 步骤 2/3: 安装组件 ==========')
     await this._runBatch('install', COMPONENTS, proxy, (key, p) => this._installComponent(key, p))
+
+    console.log('\n========== 步骤 3/3: 初始化 + 验证 ==========')
+    await this._init(parsed)
+    await this._verify(parsed)
   }
 
   async _uninstall(parsed) {
@@ -197,6 +220,139 @@ export class WebworkGroup {
     await this._runBatch('upgrade', COMPONENTS, proxy, (key, p) => this._upgradeComponent(key, p))
   }
 
+  /**
+   * 检查所有镜像可达性（HEAD 请求，不可达则抛错）
+   * @param {string} proxy
+   */
+  async _checkMirrors(proxy) {
+    const tool = shell.getNetProbeTool()
+    if (!tool) {
+      console.log('  [WARN] No network probe tool (ping/curl/wget), skipping mirror check')
+      return
+    }
+
+    const checks = [
+      { name: 'npm', url: getActiveRegistry('npm') },
+      { name: 'pip', url: getActiveRegistry('pip') },
+    ]
+
+    if (!isNvmInstalled()) {
+      checks.push({ name: 'nvm', url: getActiveRegistry('nvm') })
+      checks.push({ name: 'node', url: getActiveRegistry('node') })
+    }
+
+    const tool2 = new CftGroup()
+    if (tool2._listInstalled().length === 0) {
+      const config = getConfig()
+      const cftUrl = config.cft?.registry?.active || config.cft?.registry?.npmmirror || ''
+      if (cftUrl) checks.push({ name: 'cft', url: cftUrl })
+    }
+
+    let allOk = true
+    for (const { name, url } of checks) {
+      if (!url) {
+        console.log(`  [SKIP] ${name}: no active registry`)
+        continue
+      }
+      try {
+        const result = await checkReachability(url, tool, 1, proxy)
+        if (result.reachable) {
+          console.log(`  [OK] ${name}: ${url}`)
+        } else {
+          console.error(`  [FAIL] ${name}: ${url} (${result.raw})`)
+          allOk = false
+        }
+      } catch (err) {
+        console.error(`  [FAIL] ${name}: ${err.message}`)
+        allOk = false
+      }
+    }
+
+    if (!allOk) {
+      throw new Error('Some mirrors unreachable, aborting. Check network or set proxy with -p')
+    }
+  }
+
+  /**
+   * 运行时初始化（依赖 blues-lib 已安装）
+   * @param {object} parsed
+   */
+  async _init(parsed) {
+    const steps = [
+      { name: 'config', cmd: 'ww config init', required: true },
+      { name: 'webdriver', cmd: 'ww webdriver init', required: true, hint: 'Downloads Chrome for Testing (~200MB)' },
+      { name: 'opencode', cmd: 'ww opencode init', required: true },
+      { name: 'sqlite', cmd: 'ww sqlite init', required: true },
+    ]
+
+    for (const step of steps) {
+      console.log(`  [INIT] ${step.name}...`)
+      try {
+        execSync(step.cmd, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+        console.log(`  [OK] ${step.name}`)
+      } catch (err) {
+        if (step.required) {
+          throw new Error(`${step.name} init failed: ${err.message}`)
+        }
+        console.error(`  [WARN] ${step.name}: ${err.message}`)
+      }
+    }
+  }
+
+  /**
+   * 验证安装结果
+   * @param {object} parsed
+   */
+  async _verify(parsed) {
+    const checks = [
+      { name: 'sqlite', cmd: 'ww sqlite debug', pattern: /访问成功|ok|success/i },
+      { name: 'run', cmd: 'ww run debug', pattern: /run debug/i },
+      { name: 'web', cmd: 'ww web status', pattern: /running/i, optional: true },
+    ]
+
+    for (const check of checks) {
+      console.log(`  [VERIFY] ${check.name}...`)
+      try {
+        const out = execSync(check.cmd, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+        if (check.pattern.test(out)) {
+          console.log(`  [OK] ${check.name}`)
+        } else {
+          if (check.optional) {
+            console.log(`  [WARN] ${check.name}: not running (optional)`)
+          } else {
+            console.error(`  [FAIL] ${check.name}: output doesn't match expected pattern`)
+          }
+        }
+      } catch (err) {
+        if (check.optional) {
+          console.log(`  [WARN] ${check.name}: ${err.message}`)
+        } else {
+          console.error(`  [FAIL] ${check.name}: ${err.message}`)
+        }
+      }
+    }
+
+    try {
+      const staticIndex = execSync(
+        `python3 -c "import os, blues_lib.web; print(os.path.join(os.path.dirname(blues_lib.web.__file__), 'static', 'index.html'))"`,
+        { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }
+      ).trim()
+      if (staticIndex) {
+        console.log(`  [VERIFY] webdriver...`)
+        const out = execSync(`ww webdriver debug -u file://${staticIndex} --headless`, {
+          encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'], timeout: 60000
+        })
+        if (/webwork/i.test(out)) {
+          console.log(`  [OK] webdriver`)
+        } else {
+          console.error(`  [FAIL] webdriver: output doesn't contain 'webwork'`)
+        }
+      }
+    } catch (err) {
+      console.error(`  [WARN] webdriver: ${err.message}`)
+    }
+  }
+
   async _installComponent(key, proxy) {
     switch (key) {
       case 'python':
@@ -516,12 +672,12 @@ export class WebworkGroup {
     if (existing.installed) {
       return { action: 'skipped', reason: `${name} ${existing.version} already installed`, version: existing.version }
     }
-    return npm.install(name, null, { global: true, proxy })
+    return npm.install(name, null, { global: true, proxy, allowScripts: name.startsWith('@wwkit/') })
   }
 
   async _upgradeNpmPackage(name, proxy) {
     const npm = new NpmManager()
-    return npm.upgrade(name, { global: true, proxy })
+    return npm.upgrade(name, { global: true, proxy, allowScripts: name.startsWith('@wwkit/') })
   }
 
   async _uninstallNpmPackage(name) {
@@ -550,7 +706,9 @@ Examples:
   opm webwork version       Show installed versions of all components
   opm webwork versions      Show latest available versions (remote)
   opm webwork installed     Show install status of all components
-  opm webwork install       Install all components in order
+  opm webwork install       Full install (mirror check + components + init + verify)
+  opm webwork init          Initialize runtime only (config/webdriver/opencode/sqlite)
+  opm webwork verify        Verify installation only
   opm webwork uninstall     Uninstall all components in reverse order
   opm webwork upgrade       Upgrade all components to latest
 `)