@wwkit/opm 1.0.4 → 1.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wwkit/opm",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "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.9"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",

package/scripts/postinstall.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
-import { copyBuiltinConfig, getUserConfigFile } from '../src/config.js'
+import { mergeBuiltinConfig, getUserConfigFile } from '../src/config.js'
 
-if (copyBuiltinConfig()) {
-  console.log(`opm: wrote default config to ${getUserConfigFile()}`)
-}
+if (mergeBuiltinConfig()) {
+  console.log(`opm: config updated at ${getUserConfigFile()}`)
+}

package/src/binaries/base.js

@@ -13,7 +13,6 @@
 
 import fs from 'node:fs'
 import path from 'node:path'
-import extractZip from 'extract-zip'
 
 import { parseFlags } from '../cli/helpers/args.js'
 import { output } from '../formatter.js'
@@ -23,6 +22,12 @@ import { getOs, OS_TYPES } from './platform.js'
 import { find as findExe } from './exefinder.js'
 import { verify as verifyDeps } from './depchecker.js'
 
+let _extractZip = null
+async function loadExtractZip() {
+  if (!_extractZip) _extractZip = (await import('extract-zip')).default
+  return _extractZip
+}
+
 const ACTIONS = {
   version:    { desc: 'Show current (active) version' },
   installed:  { desc: 'Check if a version is installed' },
@@ -354,6 +359,7 @@ async _dir() {
     }
     await downloadToFile(url, zipPath, { proxy })
     try {
+      const extractZip = await loadExtractZip()
       await extractZip(zipPath, { dir: extractRoot })
     } finally {
       if (fs.existsSync(zipPath)) {

package/src/cli/groups/package.js

@@ -63,6 +63,7 @@ const ACTIONS = {
   uninstall:  { desc: 'Uninstall a package' },
   upgrade:    { desc: 'Upgrade a package' },
   cache:      { desc: 'Clean cache' },
+  dir:        { desc: 'Show install and package directories' },
   help:       { desc: 'Show help for this manager' },
 }
 
@@ -236,6 +237,12 @@ export class PackageGroup {
         break
       }
 
+      case 'dir': {
+        const result = manager.getDir()
+        output({ name: this.name, ...result })
+        break
+      }
+
       default:
         console.error(`Unknown action: ${action}`)
         process.exit(1)
@@ -262,6 +269,7 @@ Actions:
   uninstall <name>           Uninstall a package
   upgrade <name>             Upgrade a package to latest
   cache clean                Clean cache
+  dir                        Show install and package directories
   help                       Show this help
 
 Options:

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/config.js

@@ -47,6 +47,14 @@ export function copyBuiltinConfig() {
   return _loader.copyBuiltinConfig()
 }
 
+/**
+ * 合并内置配置到用户配置文件（追加缺失 key，不覆盖已有值）
+ * @returns {boolean} 是否写入了文件
+ */
+export function mergeBuiltinConfig() {
+  return _loader.mergeBuiltinConfig()
+}
+
 /**
  * 按点分路径取配置子节点
  * @param {object} config - getConfig 的返回结果

package/src/harnesses/base.js

@@ -27,7 +27,6 @@ const ACTIONS = {
   clear:      { desc: 'Clear sessions / data' },
   dir:        { desc: 'Show data / db / log / config paths' },
   env:        { desc: 'Show harness environment variables' },
-  open:       { desc: 'Open TUI in a work directory (with env vars injected)' },
   help:       { desc: 'Show this help' },
 }
 
@@ -57,11 +56,15 @@ export class HarnessGroup {
   async run(argv) {
     const [action, ...rest] = argv
 
-    if (!action || action === '-h' || action === '--help' || action === 'help') {
+    if (action === '-h' || action === '--help' || action === 'help') {
       this.printHelp()
       return
     }
 
+    if (!action || !ACTIONS[action]) {
+      return this._open(argv)
+    }
+
     switch (action) {
       case 'version':
         return this._version()
@@ -81,8 +84,6 @@ export class HarnessGroup {
         return this._dir()
       case 'env':
         return this._env()
-      case 'open':
-        return this._open(rest)
       default:
         console.error(`Unknown action: ${action}`)
         this.printHelp()
@@ -190,14 +191,30 @@ export class HarnessGroup {
       console.error(`open is not supported for ${this.cfg.name}`)
       process.exit(1)
     }
-    const parsed = parseFlags(rest)
-    const workDir = parsed.flags.d || parsed.flags.dir || process.cwd()
+    let workDir = process.cwd()
+    const passThrough = []
+    for (let i = 0; i < rest.length; i++) {
+      const arg = rest[i]
+      if (arg === '-d' || arg === '--dir') {
+        const next = rest[i + 1]
+        if (next !== undefined && !next.startsWith('-')) {
+          workDir = next
+          i++
+        } else {
+          passThrough.push(arg)
+        }
+      } else if (arg.startsWith('-d=') || arg.startsWith('--dir=')) {
+        workDir = arg.slice(arg.indexOf('=') + 1)
+      } else {
+        passThrough.push(arg)
+      }
+    }
     const resolved = path.resolve(workDir)
     if (!fs.existsSync(resolved)) {
       console.error(`Directory not found: ${resolved}`)
       process.exit(1)
     }
-    this.cfg.open(resolved)
+    this.cfg.open(resolved, passThrough)
   }
 
   printHelp() {
@@ -221,7 +238,7 @@ ${actionLines}
 ${clearSection}
 Options:
   -p, --proxy <url>  Proxy for install/upgrade (overrides config proxy.active)
-  -d, --dir <dir>     Working directory for open (default: cwd)
+  -d, --dir <dir>     Working directory for direct launch (default: cwd)
   -h, --help          Show this help
 
 Examples:
@@ -232,8 +249,9 @@ Examples:
   opm ${this.cfg.name} clear
   opm ${this.cfg.name} dir
   opm ${this.cfg.name} env
-  opm ${this.cfg.name} open                  Open in current directory
-  opm ${this.cfg.name} open -d /path/to/project
+  opm ${this.cfg.name}                           Launch TUI in current directory
+  opm ${this.cfg.name} -d /path/to/project
+  opm ${this.cfg.name} -c config --agent work    Pass through args to opencode
 `)
   }
 }

package/src/harnesses/opencode/index.js

@@ -55,8 +55,9 @@ function getEnvVars() {
  * 在指定工作目录启动 opencode TUI
  * 自动注入有值的环境变量（系统 env > opm config）
  * @param {string} workDir - 工作目录
+ * @param {string[]} [passThroughArgs=[]] - Extra args passed to opencode
  */
-function openTui(workDir) {
+function openTui(workDir, passThroughArgs = []) {
   const env = { ...process.env }
   const cfgEnv = getEnvVars()
   for (const key of ENV_VARS) {
@@ -65,17 +66,20 @@ function openTui(workDir) {
     }
   }
 
-  const cmd = shell.isWindows ? 'opencode.exe' : 'opencode'
-  const child = spawn(cmd, [], {
+  const cmd = 'opencode'
+  const child = spawn(cmd, passThroughArgs, {
     cwd: workDir,
     stdio: 'inherit',
     env,
-    shell: shell.shellForExec(false),
+    shell: shell.isWindows,
   })
   child.on('error', (err) => {
     console.error(`Failed to start opencode: ${err.message}`)
     process.exit(1)
   })
+  child.on('close', (code) => {
+    process.exit(code ?? 0)
+  })
 }
 
 export const opencodeHarness = {

package/src/managers/apt.js

@@ -374,4 +374,24 @@ export class AptManager extends PackageManager {
     this._execInherit(['get', 'clean'])
     return { action: 'cache cleaned' }
   }
+
+  /**
+   * 查询 apt 安装路径和包目录
+   * @returns {{ name: string, install: string, listsDir: string, sourcesList: string, sourcesDir: string }}
+   */
+  getDir() {
+    const which = process.platform === 'win32' ? 'where' : 'which'
+    let install = ''
+    try {
+      install = execSync(`${which} apt`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim().split('\n')[0]
+    } catch {}
+
+    return {
+      name: 'apt',
+      install,
+      listsDir: '/var/lib/apt/lists',
+      sourcesList: SOURCES_LIST,
+      sourcesDir: SOURCES_DIR,
+    }
+  }
 }

package/src/managers/base.js

@@ -164,4 +164,12 @@ export class PackageManager {
   async cleanCache() {
     throw new Error(`${this.name}: cleanCache not implemented`)
   }
+
+  /**
+   * 查询管理器安装路径和包目录
+   * @returns {{ name: string, install: string, [key: string]: string }}
+   */
+  getDir() {
+    return { name: this.name, install: '' }
+  }
 }

package/src/managers/brew.js

@@ -371,4 +371,24 @@ export class BrewManager extends PackageManager {
     this._execInherit(['cleanup', '-s', '--prune=all'])
     return { action: 'cache cleaned' }
   }
+
+  /**
+   * 查询 brew 安装路径和包目录
+   * @returns {{ name: string, install: string, prefix: string, cellar: string }}
+   */
+  getDir() {
+    const install = getBrewBin()
+
+    let prefix = ''
+    try {
+      prefix = execSync(`${install} --prefix`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim()
+    } catch {}
+
+    let cellar = ''
+    try {
+      cellar = execSync(`${install} --cellar`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim()
+    } catch {}
+
+    return { name: 'brew', install, prefix, cellar }
+  }
 }

package/src/managers/bun.js

@@ -8,6 +8,7 @@
 
 import { execSync, spawnSync } from 'node:child_process'
 import fs from 'node:fs'
+import os from 'node:os'
 import path from 'node:path'
 import { PackageManager } from './base.js'
 import { getActiveRegistry, setActiveRegistry } from '../config.js'
@@ -339,4 +340,25 @@ export class BunManager extends PackageManager {
     this._execInherit(['pm', 'cache', 'rm'])
     return { action: 'cache cleaned' }
   }
+
+  /**
+   * 查询 bun 安装路径和包目录
+   * @returns {{ name: string, install: string, globalDir: string, cacheDir: string }}
+   */
+  getDir() {
+    const which = process.platform === 'win32' ? 'where' : 'which'
+    let install = ''
+    try {
+      install = execSync(`${which} bun`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim().split('\n')[0]
+    } catch {}
+
+    const bunHome = path.join(os.homedir(), '.bun')
+
+    return {
+      name: 'bun',
+      install,
+      globalDir: path.join(bunHome, 'install', 'global'),
+      cacheDir: path.join(bunHome, 'install', 'cache'),
+    }
+  }
 }

package/src/managers/composer.js

@@ -277,4 +277,25 @@ export class ComposerManager extends PackageManager {
     this._execInherit(['clear-cache'])
     return { action: 'cache cleaned' }
   }
+
+  /**
+   * 查询 composer 安装路径和包目录
+   * @returns {{ name: string, install: string, globalHome: string, vendorDir: string }}
+   */
+  getDir() {
+    const which = process.platform === 'win32' ? 'where' : 'which'
+    let install = ''
+    try {
+      install = execSync(`${which} composer`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim().split('\n')[0]
+    } catch {}
+
+    let globalHome = ''
+    try {
+      globalHome = this._exec(['config', '--global', 'home'], { allowNonZero: true }).trim()
+    } catch {}
+
+    const vendorDir = fs.existsSync(path.join(process.cwd(), 'vendor')) ? path.join(process.cwd(), 'vendor') : ''
+
+    return { name: 'composer', install, globalHome, vendorDir }
+  }
 }

package/src/managers/dnf.js

@@ -367,4 +367,23 @@ export class DnfManager extends PackageManager {
     this._execInherit(['clean', 'all'])
     return { action: 'cache cleaned' }
   }
+
+  /**
+   * 查询 dnf 安装路径和包目录
+   * @returns {{ name: string, install: string, cacheDir: string, repoDir: string }}
+   */
+  getDir() {
+    const which = process.platform === 'win32' ? 'where' : 'which'
+    let install = ''
+    try {
+      install = execSync(`${which} dnf`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim().split('\n')[0]
+    } catch {}
+
+    return {
+      name: 'dnf',
+      install,
+      cacheDir: '/var/cache/dnf',
+      repoDir: REPO_DIR,
+    }
+  }
 }

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' }
@@ -470,4 +498,38 @@ export class NpmManager extends PackageManager {
     this._execInherit(['cache', 'clean', '--force'])
     return { action: 'cache cleaned' }
   }
+
+  /**
+   * 查询 npm 安装路径和包目录
+   * @returns {{ name: string, install: string, globalDir: string, localDir: string, cacheDir: string, prefix: string }}
+   */
+  getDir() {
+    const which = process.platform === 'win32' ? 'where' : 'which'
+    let install = ''
+    try {
+      install = execSync(`${which} npm`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim().split('\n')[0]
+    } catch {}
+
+    let globalDir = ''
+    try {
+      globalDir = this._exec(['root', '-g'], { allowNonZero: true }).trim()
+    } catch {}
+
+    let localDir = ''
+    try {
+      localDir = this._exec(['root'], { allowNonZero: true }).trim()
+    } catch {}
+
+    let cacheDir = ''
+    try {
+      cacheDir = this._exec(['config', 'get', 'cache'], { allowNonZero: true }).trim()
+    } catch {}
+
+    let prefix = ''
+    try {
+      prefix = this._exec(['config', 'get', 'prefix'], { allowNonZero: true }).trim()
+    } catch {}
+
+    return { name: 'npm', install, globalDir, localDir, cacheDir, prefix }
+  }
 }

package/src/managers/php.js

@@ -113,10 +113,16 @@ export class PhpManager extends RuntimeManager {
    * @returns {string}
    */
   getInstallDir() {
+    // 优先 phpenv 管理的版本
     try {
       const out = this._exec(['which'], { allowNonZero: true }).trim()
-      if (!out) return ''
-      return path.dirname(path.dirname(out))
+      if (out) return path.dirname(path.dirname(out))
+    } catch {}
+    // 回退到系统级 php
+    try {
+      const which = process.platform === 'win32' ? 'where' : 'which'
+      const out = execSync(`${which} php`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim().split('\n')[0]
+      if (out) return path.dirname(path.dirname(out))
     } catch {}
     return ''
   }

package/src/managers/pip.js

@@ -552,4 +552,28 @@ export class PipManager extends PackageManager {
     this._execInherit(['cache', 'purge'])
     return { action: 'cache cleaned' }
   }
+
+  /**
+   * 查询 pip 安装路径和包目录
+   * @returns {{ name: string, install: string, sitePackages: string, userSite: string }}
+   */
+  getDir() {
+    const which = process.platform === 'win32' ? 'where' : 'which'
+    let install = ''
+    try {
+      install = execSync(`${which} pip`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim().split('\n')[0]
+    } catch {}
+
+    let sitePackages = ''
+    try {
+      sitePackages = execSync('python -c "import site; print(site.getsitepackages()[0])"', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim()
+    } catch {}
+
+    let userSite = ''
+    try {
+      userSite = execSync('python -c "import site; print(site.getusersitepackages())"', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim()
+    } catch {}
+
+    return { name: 'pip', install, sitePackages, userSite }
+  }
 }

package/src/managers/proc.js

@@ -8,12 +8,17 @@
  * 回退 netstat -tlnp（Linux）/ netstat -ano（Windows）。
  */
 
-import si from 'systeminformation'
 import { spawn } from 'node:child_process'
 import { Shell } from '@wwkit/shared'
 
 const shell = new Shell()
 
+let _si = null
+async function loadSi() {
+  if (!_si) _si = (await import('systeminformation')).default
+  return _si
+}
+
 /**
  * MB 字节数转换
  * @param {number} bytes
@@ -28,6 +33,7 @@ function toMB(bytes) {
  * @returns {Promise<Map<number, {pid: number, name: string}>>}
  */
 export async function getPortMap() {
+  const si = await loadSi()
   const map = new Map()
 
   try {
@@ -92,6 +98,7 @@ export async function getPortMap() {
  * @returns {Promise<object>}
  */
 export async function getSystemInfo() {
+  const si = await loadSi()
   const [osInfo, cpuInfo, memInfo, fsInfo, timeInfo] = await Promise.all([
     si.osInfo(),
     si.cpu(),
@@ -141,6 +148,7 @@ export async function getSystemInfo() {
  * @returns {Promise<object>}
  */
 export async function listProcesses(count, sortBy) {
+  const si = await loadSi()
   const [procs, portMap] = await Promise.all([
     si.processes(),
     getPortMap(),
@@ -184,6 +192,7 @@ export async function listProcesses(count, sortBy) {
  * @returns {Promise<object>}
  */
 export async function searchProcesses({ name, port, exact }) {
+  const si = await loadSi()
   const [procs, portMap] = await Promise.all([
     si.processes(),
     getPortMap(),
@@ -243,6 +252,7 @@ export async function searchProcesses({ name, port, exact }) {
  * @returns {Promise<object>}
  */
 export async function listPorts(portFilter) {
+  const si = await loadSi()
   const portMap = await getPortMap()
   const procs = await si.processes()
   const procMap = new Map(procs.list.map((p) => [p.pid, p]))
@@ -312,6 +322,7 @@ export async function killByPort(port, signal) {
  * @returns {Promise<object>}
  */
 export async function killByName(name, signal) {
+  const si = await loadSi()
   const procs = await si.processes()
   const lower = name.toLowerCase()
   const matched = procs.list.filter((p) =>
@@ -338,6 +349,7 @@ export async function killByName(name, signal) {
  * @returns {Promise<object>}
  */
 export async function getProcessTree(rootPid) {
+  const si = await loadSi()
   const procs = await si.processes()
   const procMap = new Map(procs.list.map((p) => [p.pid, p]))
   const childrenMap = new Map()
@@ -382,6 +394,7 @@ export async function getProcessTree(rootPid) {
  * @returns {Promise<object>}
  */
 export async function getProcessDetail(pid) {
+  const si = await loadSi()
   const [procs, portMap] = await Promise.all([
     si.processes(),
     getPortMap(),

package/src/managers/python.js

@@ -103,10 +103,20 @@ export class PythonManager extends RuntimeManager {
    * @returns {string}
    */
   getInstallDir() {
+    // 优先 uv 管理的版本
     try {
       const out = this._exec(['python', 'find'], { allowNonZero: true }).trim()
-      if (!out) return ''
-      return path.dirname(path.dirname(out))
+      if (out) return path.dirname(path.dirname(out))
+    } catch {}
+    // 回退到系统级 python3 / python
+    try {
+      const which = process.platform === 'win32' ? 'where' : 'which'
+      for (const cmd of ['python3', 'python']) {
+        try {
+          const out = execSync(`${which} ${cmd}`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim().split('\n')[0]
+          if (out) return path.dirname(path.dirname(out))
+        } catch {}
+      }
     } catch {}
     return ''
   }

package/src/managers/winget.js

@@ -265,4 +265,17 @@ export class WingetManager extends PackageManager {
   async cleanCache() {
     return { action: 'winget has no cache clean command' }
   }
+
+  /**
+   * 查询 winget 安装路径
+   * @returns {{ name: string, install: string }}
+   */
+  getDir() {
+    let install = ''
+    try {
+      install = execSync('where winget', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'], shell: true }).trim().split('\r?\n')[0]
+    } catch {}
+
+    return { name: 'winget', install }
+  }
 }

package/src/tools/ftp/client.js

@@ -5,11 +5,17 @@
  * 自动重试 + 超时 + 被动模式由配置驱动。
  */
 
-import ftp from 'basic-ftp'
 import { Readable } from 'node:stream'
 import { getConfig } from '../../config.js'
 
-const { Client } = ftp
+let _Client = null
+async function loadClient() {
+  if (!_Client) {
+    const ftp = (await import('basic-ftp')).default
+    _Client = ftp.Client
+  }
+  return _Client
+}
 
 /**
  * 从 opm config 读取 FTP 配置
@@ -36,6 +42,7 @@ export function getFtpConfig() {
  */
 export async function connect() {
   const cfg = getFtpConfig()
+  const Client = await loadClient()
   const client = new Client(cfg.timeout * 1000)
   await client.access({
     host: cfg.host,

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
 `)