@wwkit/opm 1.0.2 → 1.0.4

package/src/harnesses/opencode/index.js

@@ -3,14 +3,26 @@
  *
  * opencode 是 AI coding agent，通过 npm 全局包 opencode-ai 安装（binary: opencode）。
  * 数据目录跨平台（db.js），会话清理复用 clear.js。
+ * env 命令管理 OPENCODE_CONFIG_DIR / OPENCODE_CONFIG_CONTENT 环境变量。
+ * open 命令在指定工作目录启动 opencode TUI（自动注入 env 变量）。
  */
 
 import fs from 'node:fs'
 import path from 'node:path'
 import os from 'node:os'
+import { spawn } from 'node:child_process'
+import { Shell } from '@wwkit/shared'
+import { getConfig } from '../../config.js'
 import { getDataDir, getDbPath, getLogPath } from './db.js'
 import { runClear } from './clear.js'
 
+const shell = new Shell()
+
+/**
+ * opencode 专属环境变量名
+ */
+const ENV_VARS = ['OPENCODE_CONFIG_DIR', 'OPENCODE_CONFIG_CONTENT']
+
 /**
  * 查找 opencode 配置文件路径（优先 .jsonc，其次 .json）
  * @returns {string|null}
@@ -25,6 +37,47 @@ function findConfigFile() {
   return null
 }
 
+/**
+ * 获取 env 变量当前值
+ * 优先级：系统环境变量 > opm config opencode.env
+ * @returns {Record<string, string>}
+ */
+function getEnvVars() {
+  const cfgEnv = (getConfig().opencode?.env) || {}
+  const result = {}
+  for (const key of ENV_VARS) {
+    result[key] = process.env[key] || cfgEnv[key] || ''
+  }
+  return result
+}
+
+/**
+ * 在指定工作目录启动 opencode TUI
+ * 自动注入有值的环境变量（系统 env > opm config）
+ * @param {string} workDir - 工作目录
+ */
+function openTui(workDir) {
+  const env = { ...process.env }
+  const cfgEnv = getEnvVars()
+  for (const key of ENV_VARS) {
+    if (cfgEnv[key]) {
+      env[key] = cfgEnv[key]
+    }
+  }
+
+  const cmd = shell.isWindows ? 'opencode.exe' : 'opencode'
+  const child = spawn(cmd, [], {
+    cwd: workDir,
+    stdio: 'inherit',
+    env,
+    shell: shell.shellForExec(false),
+  })
+  child.on('error', (err) => {
+    console.error(`Failed to start opencode: ${err.message}`)
+    process.exit(1)
+  })
+}
+
 export const opencodeHarness = {
   name: 'opencode',
   desc: 'opencode AI coding agent',
@@ -43,4 +96,7 @@ export const opencodeHarness = {
     ['--backup', 'Backup the DB before deleting (default: off)'],
     ['--db <path>', 'Override the opencode database path'],
   ],
+  envVars: ENV_VARS,
+  getEnvVars,
+  open: openTui,
 }

package/src/index.js

@@ -19,7 +19,12 @@ 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 { PingGroup } from './cli/groups/ping.js'
+export { ProcGroup } from './cli/groups/proc.js'
 export { FtpGroup } from './tools/ftp/index.js'
+export { GitGroup } from './tools/git/index.js'
+export { ShareGroup } from './tools/share/index.js'
+export { WebworkGroup } from './tools/webwork/index.js'
 export { ToolManagerGroup } from './cli/groups/version-manager.js'
 export { parseFlags } from './cli/helpers/args.js'
 
@@ -50,6 +55,7 @@ export {
 export {
   NPM_PRESETS, PIP_PRESETS, DNF_PRESETS, APT_PRESETS, BREW_PRESETS, COMPOSER_PRESETS,
   BUN_PRESETS, NVM_PRESETS, NODE_PRESETS, PHPENV_PRESETS, PHP_PRESETS, PYTHON_PRESETS,
+  UV_PRESETS, DOCKER_PRESETS, HOMEBREW_PRESETS,
   getPresets, resolveRegistryInput,
 } from './presets.js'
 export { PROXY_PRESETS } from './proxy-presets.js'

package/src/managers/brew.js

@@ -12,9 +12,6 @@ import fs from 'node:fs'
 import { PackageManager } from './base.js'
 import { getActiveRegistry, getPresets, setActiveRegistry } from '../config.js'
 
-const BREW_INSTALL_URL = 'https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh'
-const BREW_UNINSTALL_URL = 'https://raw.githubusercontent.com/Homebrew/uninstall/HEAD/uninstall.sh'
-
 /**
  * 定位 brew 可执行文件（兼容 Intel / Apple Silicon 路径），找不到时退回 PATH
  * @returns {string}
@@ -40,14 +37,17 @@ export function isHomebrewInstalled() {
 }
 
 /**
- * 安装 Homebrew（curl 官方安装脚本）
+ * 安装 Homebrew（curl 官方安装脚本；脚本 URL 来自 homebrew.registry.active）
+ * @param {string} [proxy] - 代理地址
  * @returns {{ action: string, hint: string }}
  */
-export function installHomebrew() {
+export function installHomebrew(proxy) {
   if (process.platform === 'win32') {
     throw new Error('Homebrew is not supported on Windows (use WSL)')
   }
-  execSync(`curl -fsSL "${BREW_INSTALL_URL}" | bash`, { stdio: 'inherit', shell: true })
+  const installUrl = getActiveRegistry('homebrew') || 'https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh'
+  const proxyArg = proxy ? ` -x "${proxy}"` : ''
+  execSync(`curl -fsSL${proxyArg} "${installUrl}" | bash`, { stdio: 'inherit', shell: true })
   return { action: 'installed', hint: 'Restart shell or ensure /opt/homebrew/bin (or /usr/local/bin) is in PATH' }
 }
 

package/src/managers/docker.js

@@ -16,8 +16,7 @@ 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'
+import { getActiveRegistry } from '../config.js'
 
 /**
  * 检查 docker 命令是否可用
@@ -43,18 +42,22 @@ export function getDockerVersion() {
 }
 
 /**
- * 在 Linux 环境中执行 Docker 便捷脚本
+ * 在 Linux 环境中执行 Docker 便捷脚本（脚本 URL 来自 docker.registry.active）
+ * @param {string} [proxy] - 代理地址
  * @private
  */
-function runConvenienceScript() {
-  execSync(`curl -fsSL ${DOCKER_INSTALL_URL} | sh`, { stdio: 'inherit', shell: true })
+function runConvenienceScript(proxy) {
+  const installUrl = getActiveRegistry('docker') || 'https://get.docker.com'
+  const proxyArg = proxy ? ` -x "${proxy}"` : ''
+  execSync(`curl -fsSL${proxyArg} ${installUrl} | sh`, { stdio: 'inherit', shell: true })
 }
 
 /**
  * 安装 Docker
+ * @param {string} [proxy] - 代理地址
  * @returns {{ action: string, method: string, hint?: string }}
  */
-export function installDocker() {
+export function installDocker(proxy) {
   const platform = process.platform
 
   if (platform === 'linux') {
@@ -91,7 +94,7 @@ export function upgradeDocker() {
         execSync('dnf upgrade -y docker-ce', { stdio: 'inherit', shell: true })
         return { action: 'upgraded', method: 'dnf' }
       } catch {
-        runConvenienceScript()
+    runConvenienceScript(proxy)
         return { action: 'upgraded', method: 'convenience-script' }
       }
     }

package/src/managers/node.js

@@ -44,12 +44,18 @@ export function isNvmInstalled() {
 
 /**
  * 安装 nvm（git clone + 写 shell profile）
+ * @param {string} [proxy] - 代理地址
  * @returns {{ action: string, profile: string, hint: string }}
  */
-export function installNvm() {
+export function installNvm(proxy) {
   const mirror = getActiveRegistry('nvm')
   const nvmDir = getNvmDir()
-  execSync(`git clone "${mirror}" "${nvmDir}"`, { stdio: 'inherit', shell: shell.resolveBash() })
+  const env = { ...process.env }
+  if (proxy) {
+    env.http_proxy = proxy
+    env.https_proxy = proxy
+  }
+  execSync(`git clone "${mirror}" "${nvmDir}"`, { stdio: 'inherit', shell: shell.resolveBash(), env })
   const lines = [
     `export NVM_DIR="${nvmDir}"`,
     `[ -s "\\$NVM_DIR/nvm.sh" ] && \\. "\\$NVM_DIR/nvm.sh"`,

package/src/managers/proc.js

@@ -0,0 +1,424 @@
+/**
+ * proc 管理器 — 进程与系统信息管理
+ *
+ * 基于 systeminformation 库 + netstat 回退，提供：
+ *   系统信息、进程列表、进程搜索、端口列表、进程终止、进程树、进程详情
+ *
+ * 端口映射：优先 systeminformation.networkConnections()，
+ * 回退 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()
+
+/**
+ * MB 字节数转换
+ * @param {number} bytes
+ * @returns {number}
+ */
+function toMB(bytes) {
+  return Math.round(bytes / 1024 / 1024)
+}
+
+/**
+ * 获取端口→进程映射
+ * @returns {Promise<Map<number, {pid: number, name: string}>>}
+ */
+export async function getPortMap() {
+  const map = new Map()
+
+  try {
+    const conns = await si.networkConnections()
+    for (const c of conns) {
+      if (c.state === 'listen' && c.localPort && c.pid) {
+        if (!map.has(c.localPort)) {
+          map.set(c.localPort, { pid: c.pid, name: c.process || '' })
+        }
+      }
+    }
+    if (map.size > 0) return map
+  } catch {}
+
+  const fallback = shell.isWindows ? 'netstat' : 'netstat'
+  const args = shell.isWindows ? ['-ano'] : ['-tlnp']
+
+  return new Promise((resolve) => {
+    const child = spawn(fallback, args, { stdio: ['pipe', 'pipe', 'pipe'] })
+    let stdout = ''
+    child.stdout.on('data', (d) => { stdout += d })
+    child.on('close', () => {
+      const lines = stdout.split('\n')
+      for (const line of lines) {
+        if (!line.includes('LISTEN')) continue
+        let port = null
+        let pid = null
+        let name = ''
+
+        if (shell.isWindows) {
+          const m = line.match(/(\d+)\s*$/)
+          if (m) pid = parseInt(m[1], 10)
+          const addrMatch = line.match(/[:\.](\d+)\s/)
+          if (addrMatch) port = parseInt(addrMatch[1], 10)
+        } else {
+          const parts = line.trim().split(/\s+/)
+          if (parts.length >= 6) {
+            const localAddr = parts[3] || parts[1] || ''
+            const portMatch = localAddr.match(/:(\d+)$/)
+            if (portMatch) port = parseInt(portMatch[1], 10)
+            const pidPart = parts[parts.length - 1] || ''
+            const pidMatch = pidPart.match(/^(\d+)\/(.+)/)
+            if (pidMatch) {
+              pid = parseInt(pidMatch[1], 10)
+              name = pidMatch[2]
+            }
+          }
+        }
+
+        if (port && pid && !map.has(port)) {
+          map.set(port, { pid, name })
+        }
+      }
+      resolve(map)
+    })
+    child.on('error', () => resolve(map))
+  })
+}
+
+/**
+ * 获取系统信息
+ * @returns {Promise<object>}
+ */
+export async function getSystemInfo() {
+  const [osInfo, cpuInfo, memInfo, fsInfo, timeInfo] = await Promise.all([
+    si.osInfo(),
+    si.cpu(),
+    si.mem(),
+    si.fsSize(),
+    si.time(),
+  ])
+
+  return {
+    os: {
+      platform: osInfo.platform,
+      distro: osInfo.distro,
+      release: osInfo.release,
+      arch: osInfo.arch,
+      hostname: osInfo.hostname,
+      kernel: osInfo.kernel,
+    },
+    cpu: {
+      manufacturer: cpuInfo.manufacturer,
+      brand: cpuInfo.brand,
+      cores: cpuInfo.cores,
+      speed: cpuInfo.speed ? `${cpuInfo.speed}GHz` : '',
+    },
+    memory: {
+      total: toMB(memInfo.total),
+      used: toMB(memInfo.active),
+      available: toMB(memInfo.available),
+      unit: 'MB',
+    },
+    disk: fsInfo.map((f) => ({
+      fs: f.fs,
+      mount: f.mount,
+      total: toMB(f.size),
+      used: toMB(f.used),
+      available: toMB(f.available),
+      use: f.use,
+      unit: 'MB',
+    })),
+    uptime: Math.round(timeInfo.uptime),
+  }
+}
+
+/**
+ * 获取进程列表（排序后取前 N 个）
+ * @param {number} count - 数量
+ * @param {'mem'|'cpu'} sortBy - 排序字段
+ * @returns {Promise<object>}
+ */
+export async function listProcesses(count, sortBy) {
+  const [procs, portMap] = await Promise.all([
+    si.processes(),
+    getPortMap(),
+  ])
+
+  const pidToPorts = new Map()
+  for (const [port, info] of portMap) {
+    const arr = pidToPorts.get(info.pid) || []
+    arr.push(port)
+    pidToPorts.set(info.pid, arr)
+  }
+
+  const list = procs.list.map((p) => ({
+    pid: p.pid,
+    parentPid: p.parentPid,
+    name: p.name,
+    mem: Math.round(p.memRss / 1024),
+    memPercent: Math.round(p.mem * 100) / 100,
+    cpu: Math.round(p.cpu * 100) / 100,
+    ports: pidToPorts.get(p.pid) || [],
+    user: p.user || '',
+    state: p.state || '',
+    started: p.started || '',
+  }))
+
+  list.sort((a, b) => {
+    if (sortBy === 'cpu') return b.cpu - a.cpu
+    return b.mem - a.mem
+  })
+
+  return {
+    count,
+    sortBy,
+    processes: list.slice(0, count),
+  }
+}
+
+/**
+ * 搜索进程
+ * @param {{name?: string, port?: string, exact?: boolean}} opts
+ * @returns {Promise<object>}
+ */
+export async function searchProcesses({ name, port, exact }) {
+  const [procs, portMap] = await Promise.all([
+    si.processes(),
+    getPortMap(),
+  ])
+
+  const pidToPorts = new Map()
+  for (const [p, info] of portMap) {
+    const arr = pidToPorts.get(info.pid) || []
+    arr.push(p)
+    pidToPorts.set(info.pid, arr)
+  }
+
+  let list = procs.list.map((p) => ({
+    pid: p.pid,
+    parentPid: p.parentPid,
+    name: p.name,
+    mem: Math.round(p.memRss / 1024),
+    memPercent: Math.round(p.mem * 100) / 100,
+    cpu: Math.round(p.cpu * 100) / 100,
+    ports: pidToPorts.get(p.pid) || [],
+    user: p.user || '',
+    state: p.state || '',
+    started: p.started || '',
+    command: p.command,
+    params: p.params,
+  }))
+
+  if (name) {
+    if (exact) {
+      list = list.filter((p) => p.name === name || p.command === name)
+    } else {
+      const lower = name.toLowerCase()
+      list = list.filter((p) =>
+        p.name.toLowerCase().includes(lower) ||
+        (p.command && p.command.toLowerCase().includes(lower))
+      )
+    }
+  }
+
+  if (port) {
+    const portNum = parseInt(port, 10)
+    list = list.filter((p) => p.ports.includes(portNum))
+  }
+
+  return {
+    name: name || null,
+    port: port || null,
+    exact: !!exact,
+    count: list.length,
+    processes: list,
+  }
+}
+
+/**
+ * 列出监听端口
+ * @param {string} [portFilter] - 可选端口过滤
+ * @returns {Promise<object>}
+ */
+export async function listPorts(portFilter) {
+  const portMap = await getPortMap()
+  const procs = await si.processes()
+  const procMap = new Map(procs.list.map((p) => [p.pid, p]))
+
+  let entries = []
+  for (const [port, info] of portMap) {
+    const proc = procMap.get(info.pid)
+    entries.push({
+      port,
+      pid: info.pid,
+      name: info.name || (proc ? proc.name : ''),
+      user: proc ? proc.user : '',
+      state: proc ? proc.state : '',
+      started: proc ? proc.started : '',
+    })
+  }
+
+  entries.sort((a, b) => a.port - b.port)
+
+  if (portFilter) {
+    const portNum = parseInt(portFilter, 10)
+    entries = entries.filter((e) => e.port === portNum)
+  }
+
+  return {
+    port: portFilter || null,
+    count: entries.length,
+    ports: entries,
+  }
+}
+
+/**
+ * 终止进程
+ * @param {number} pid
+ * @param {'SIGTERM'|'SIGKILL'} signal
+ * @returns {Promise<object>}
+ */
+export async function killByPid(pid, signal) {
+  try {
+    process.kill(pid, signal)
+    return { pid, signal, killed: true }
+  } catch (err) {
+    return { pid, signal, killed: false, error: err.message }
+  }
+}
+
+/**
+ * 按端口终止进程
+ * @param {number} port
+ * @param {'SIGTERM'|'SIGKILL'} signal
+ * @returns {Promise<object>}
+ */
+export async function killByPort(port, signal) {
+  const portMap = await getPortMap()
+  const info = portMap.get(port)
+  if (!info) {
+    return { port, signal, killed: [], error: `No process listening on port ${port}` }
+  }
+  const result = await killByPid(info.pid, signal)
+  return { port, signal, killed: [{ pid: info.pid, name: info.name, ...result }] }
+}
+
+/**
+ * 按名称终止进程
+ * @param {string} name - 进程名
+ * @param {'SIGTERM'|'SIGKILL'} signal
+ * @returns {Promise<object>}
+ */
+export async function killByName(name, signal) {
+  const procs = await si.processes()
+  const lower = name.toLowerCase()
+  const matched = procs.list.filter((p) =>
+    p.name.toLowerCase().includes(lower) ||
+    (p.command && p.command.toLowerCase().includes(lower))
+  )
+
+  if (matched.length === 0) {
+    return { name, signal, killed: [], error: `No process found matching "${name}"` }
+  }
+
+  const results = []
+  for (const p of matched) {
+    const result = await killByPid(p.pid, signal)
+    results.push({ pid: p.pid, name: p.name, ...result })
+  }
+
+  return { name, signal, killed: results }
+}
+
+/**
+ * 获取进程树
+ * @param {number} [rootPid] - 根 PID（可选，不传则显示所有顶层进程）
+ * @returns {Promise<object>}
+ */
+export async function getProcessTree(rootPid) {
+  const procs = await si.processes()
+  const procMap = new Map(procs.list.map((p) => [p.pid, p]))
+  const childrenMap = new Map()
+  for (const p of procs.list) {
+    const arr = childrenMap.get(p.parentPid) || []
+    arr.push(p)
+    childrenMap.set(p.parentPid, arr)
+  }
+
+  function buildNode(pid) {
+    const proc = procMap.get(pid)
+    if (!proc) return null
+    const children = (childrenMap.get(pid) || []).map((c) => buildNode(c.pid)).filter(Boolean)
+    return {
+      pid: proc.pid,
+      parentPid: proc.parentPid,
+      name: proc.name,
+      mem: Math.round(proc.memRss / 1024),
+      cpu: Math.round(proc.cpu * 100) / 100,
+      state: proc.state || '',
+      children,
+    }
+  }
+
+  if (rootPid) {
+    const tree = buildNode(rootPid)
+    return { rootPid, tree }
+  }
+
+  const topPids = procs.list
+    .filter((p) => !procMap.has(p.parentPid))
+    .map((p) => p.pid)
+    .sort((a, b) => a - b)
+
+  const trees = topPids.map((pid) => buildNode(pid)).filter(Boolean)
+  return { rootPid: null, trees }
+}
+
+/**
+ * 获取进程详情
+ * @param {number} pid
+ * @returns {Promise<object>}
+ */
+export async function getProcessDetail(pid) {
+  const [procs, portMap] = await Promise.all([
+    si.processes(),
+    getPortMap(),
+  ])
+
+  const proc = procs.list.find((p) => p.pid === pid)
+  if (!proc) {
+    return { pid, error: `Process ${pid} not found` }
+  }
+
+  const pidToPorts = new Map()
+  for (const [port, info] of portMap) {
+    if (info.pid === pid) {
+      const arr = pidToPorts.get(pid) || []
+      arr.push(port)
+      pidToPorts.set(pid, arr)
+    }
+  }
+
+  const childCount = procs.list.filter((p) => p.parentPid === pid).length
+
+  return {
+    pid: proc.pid,
+    parentPid: proc.parentPid,
+    name: proc.name,
+    command: proc.command,
+    params: proc.params,
+    path: proc.path,
+    user: proc.user,
+    state: proc.state,
+    priority: proc.priority,
+    mem: Math.round(proc.memRss / 1024),
+    memVsz: Math.round(proc.memVsz / 1024),
+    memPercent: Math.round(proc.mem * 100) / 100,
+    cpu: Math.round(proc.cpu * 100) / 100,
+    started: proc.started,
+    ports: pidToPorts.get(pid) || [],
+    childCount,
+  }
+}

package/src/managers/python.js

@@ -17,8 +17,8 @@ import fs from 'node:fs'
 import path from 'node:path'
 import os from 'node:os'
 import { RuntimeManager } from './runtime.js'
+import { getActiveRegistry } from '../config.js'
 
-const UV_INSTALL_URL = 'https://astral.sh/uv/install.sh'
 const UV_INSTALL_PS_URL = 'https://astral.sh/uv/install.ps1'
 
 /**
@@ -45,10 +45,13 @@ export function isUvInstalled() {
 }
 
 /**
- * 安装 uv（curl 安装脚本）
+ * 安装 uv（curl 安装脚本；脚本 URL 来自 uv.registry.active）
+ * @param {string} [proxy] - 代理地址
  * @returns {{ action: string, hint: string }}
  */
-export function installUv() {
+export function installUv(proxy) {
+  const installUrl = getActiveRegistry('uv') || 'https://astral.sh/uv/install.sh'
+  const proxyArg = proxy ? ` -x "${proxy}"` : ''
   if (process.platform === 'win32') {
     const r = spawnSync(
       'powershell',
@@ -59,7 +62,7 @@ export function installUv() {
       throw new Error('uv install failed (powershell exited non-zero)')
     }
   } else {
-    execSync(`curl -LsSf "${UV_INSTALL_URL}" | sh`, { stdio: 'inherit', shell: true })
+    execSync(`curl -LsSf${proxyArg} "${installUrl}" | sh`, { stdio: 'inherit', shell: true })
   }
   return { action: 'installed', hint: 'Restart shell or ensure ~/.local/bin is in PATH' }
 }

package/src/presets.js

@@ -19,6 +19,9 @@ export const NODE_PRESETS = _getPresets('node')
 export const PHPENV_PRESETS = _getPresets('phpenv')
 export const PHP_PRESETS = _getPresets('php')
 export const PYTHON_PRESETS = _getPresets('python')
+export const UV_PRESETS = _getPresets('uv')
+export const DOCKER_PRESETS = _getPresets('docker')
+export const HOMEBREW_PRESETS = _getPresets('homebrew')
 
 export const getPresets = _getPresets
 export const resolveRegistryInput = _resolveRegistryInput