@wwkit/opm 1.0.1

package/docs/packages/opencode.md

@@ -0,0 +1,41 @@
+# opencode 命令对照
+
+`@wwkit/opm` 统一命令管理 opencode 运维操作。
+
+## 命令对照
+
+| 统一命令 | 原始命令 | 说明 |
+|---------|---------|------|
+| `opm opencode clear` | — | 清理 opencode 会话并 VACUUM 压缩数据库 |
+| `opm opencode clear -d, --days <n>` | — | 保留最近 n 天（对齐本地零点，含今天；默认 `-d 1`） |
+| `opm opencode clear -h, --hours <n>` | — | 保留最近 n 小时（滚动窗口） |
+| `opm opencode clear -n, --num <n>` | — | 保留最新 n 个会话 |
+| `opm opencode clear --dry-run` | — | 仅预览，不修改任何数据 |
+| `opm opencode clear -y` | — | 跳过确认提示 |
+| `opm opencode config` | — | 显示 opencode 配置文件内容（优先 `opencode.jsonc`，其次 `opencode.json`） |
+| `opm opencode version` | `npm list -g opencode-ai` | 已安装版本 |
+| `opm opencode install` | `npm install -g opencode-ai` | 安装（使用 opm npm 镜像 + proxy） |
+| `opm opencode uninstall` | `npm uninstall -g opencode-ai` | 卸载 |
+| `opm opencode upgrade` | `npm install -g opencode-ai@latest` | 升级（使用 opm npm 镜像 + proxy） |
+| `opm opencode dir` | — | 显示 data/db/log/config 路径 |
+
+> `--days` / `--hours` / `--num` 三选一，互斥。
+
+## 实现说明
+
+- `src/harnesses/opencode/db.js` — 数据目录 / DB / 日志路径
+- `src/harnesses/opencode/sqlite.js` — 跨平台 SQLite 驱动（Node >= 22.5 内置 `node:sqlite`，否则回退 sqlite3 CLI）
+- `src/harnesses/opencode/clear.js` — 清理流程（保留策略计算 + 删除 + VACUUM）
+- `src/harnesses/base.js` — `HarnessGroup` 统一命令组基类（version/install/uninstall/upgrade/config/clear/dir）
+
+## 示例
+
+```bash
+opm opencode clear                    # 只保留今天创建的会话
+opm opencode clear -d 7               # 保留最近 7 天会话
+opm opencode clear -h 24              # 保留最近 24 小时会话
+opm opencode clear -n 10              # 保留最新 10 个会话
+opm opencode clear --dry-run          # 仅预览
+opm opencode clear -y                 # 跳过确认直接执行
+opm opencode config                   # 显示 opencode 配置文件内容
+```

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@wwkit/opm",
+  "version": "1.0.1",
+  "author": "bluesliu <langcai163@163.com>",
+  "description": "Unified CLI — package management (npm/pip/dnf/apt) + config view + opencode maintenance",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "opm": "./bin/index.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "docs",
+    "scripts",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "opm",
+    "pkg",
+    "npm",
+    "pip",
+    "apt",
+    "dnf",
+    "registry",
+    "mirror",
+    "opencode",
+    "cli"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "extract-zip": "^2.0.1",
+    "@wwkit/shared": "1.0.5"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "check": "node --check bin/index.js",
+    "start": "node bin/index.js",
+    "test": "node --test \"tests/**/*.test.js\"",
+    "test:all": "node --test \"tests/**/*.test.js\"",
+    "doc": "node -e \"import('./src/cli/doc.js').then(m => m.generateDocHtml({ open: false }))\"",
+    "release": "node ../../packages/shared/bin/release-pkg.js"
+  }
+}

package/scripts/postinstall.js

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

package/src/binaries/base.js

@@ -0,0 +1,508 @@
+/**
+ * 二进制工具命令组基类
+ *
+ * 处理「下载 zip 二进制工具 → 解压 → chmod → Linux 依赖检查 → 多版本目录管理」。
+ * 与 AI harness（opm opencode，走 npm 全局包）性质不同，故独立成组。
+ *
+ * 通用动作（数据驱动，子类/配置描述工具差异）：
+ *   version / installed / home / versions / list / install / status / clear / registry
+ *
+ * 新增二进制工具：在 src/binaries/<name>/ 下提供 config 后 new BinaryGroup(cfg) 注册即可。
+ * cfg 给出 artifacts（下载地址/目录/二进制名）、默认版本来源、registry 段名等。
+ */
+
+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'
+import { getActiveRegistry, setActiveRegistry, getPresets, getActiveProxy, getUserConfigDir } from '../config.js'
+import { fetchText, downloadToFile } from '../managers/http.js'
+import { getOs, OS_TYPES } from './platform.js'
+import { find as findExe } from './exefinder.js'
+import { verify as verifyDeps } from './depchecker.js'
+
+const ACTIONS = {
+  version:    { desc: 'Show current (active) version' },
+  installed:  { desc: 'Check if a version is installed' },
+  dir:        { desc: 'Show install dir + binary paths of the active version' },
+  versions:   { desc: 'List all available versions (remote, known-good JSON)' },
+  list:       { desc: 'List installed versions' },
+  install:    { desc: 'Install a version (default: config default version)' },
+  status:     { desc: 'Show install status of a version (default: all)' },
+  clear:      { desc: 'Remove a version (default: all versions)' },
+  registry:   { desc: 'Query or set registry/mirror address' },
+  help:       { desc: 'Show this help' },
+}
+
+/**
+ * @typedef {Object} BinaryToolConfig
+ * @property {string} name - 命令名/配置段名（如 "cft"）
+ * @property {string} desc - 顶层帮助描述
+ * @property {() => string} getDefaultVersion - 返回默认安装版本
+ * @property {Object[]} artifacts - 下载产物描述
+ * @property {string} artifacts[].id - 产物 id（chrome/chromedriver/...）
+ * @property {string} artifacts[].binName - exefinder 查找名
+ * @property {(registry: string, version: string, os: string) => string} artifacts[].buildUrl
+ * @property {(os: string) => string} artifacts[].dirName - 解压目标目录名
+ * @property {string} [versionsFile] - 远程版本 JSON 相对路径（默认 known-good-versions-with-downloads.json）
+ */
+
+export class BinaryGroup {
+  /**
+   * @param {BinaryToolConfig} cfg
+   */
+  constructor(cfg) {
+    this.name = cfg.name
+    this.desc = cfg.desc
+    this.cfg = cfg
+  }
+
+  /**
+   * 安装根目录：~/.config/opm/<name>/
+   * @returns {string}
+   * @private
+   */
+  _installRoot() {
+    return path.join(getUserConfigDir(), this.name)
+  }
+
+  /**
+   * 某版本的安装目录
+   * @param {string} version
+   * @returns {string}
+   * @private
+   */
+  _versionRoot(version) {
+    return path.join(this._installRoot(), version)
+  }
+
+  /**
+   * 激活版本 manifest 路径
+   * @returns {string}
+   * @private
+   */
+  _manifestPath() {
+    return path.join(this._installRoot(), 'manifest.json')
+  }
+
+  /**
+   * 读取激活版本
+   * @returns {string}
+   * @private
+   */
+  _readActive() {
+    try {
+      const raw = JSON.parse(fs.readFileSync(this._manifestPath(), 'utf8'))
+      return raw.active || ''
+    } catch {
+      return ''
+    }
+  }
+
+  /**
+   * 写激活版本
+   * @param {string} version
+   * @private
+   */
+  _writeActive(version) {
+    const root = this._installRoot()
+    fs.mkdirSync(root, { recursive: true })
+    fs.writeFileSync(this._manifestPath(), `${JSON.stringify({ active: version }, null, 2)}\n`, 'utf8')
+  }
+
+  /**
+   * 列出已安装版本目录（含 installed.json 的 <version>/ 目录）
+   * @returns {{ version: string, root: string }[]}
+   * @private
+   */
+  _listInstalled() {
+    const root = this._installRoot()
+    if (!fs.existsSync(root)) return []
+    const items = []
+    for (const entry of fs.readdirSync(root, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue
+      if (!fs.existsSync(path.join(root, entry.name, 'installed.json'))) continue
+      items.push({ version: entry.name, root: path.join(root, entry.name) })
+    }
+    items.sort((a, b) => b.version.localeCompare(a.version, undefined, { numeric: true }))
+    return items
+  }
+
+  /**
+   * 读取某版本 installed.json
+   * @param {string} version
+   * @returns {Object|null}
+   * @private
+   */
+  _readInstalledInfo(version) {
+    const file = path.join(this._versionRoot(version), 'installed.json')
+    if (!fs.existsSync(file)) return null
+    try {
+      return JSON.parse(fs.readFileSync(file, 'utf8'))
+    } catch {
+      return null
+    }
+  }
+
+  /**
+   * 解析代理（-p/--proxy 优先，否则回退配置 active proxy）
+   * @param {string[]} argv
+   * @returns {string}
+   * @private
+   */
+  _resolveProxy(argv) {
+    const parsed = parseFlags(argv)
+    let proxy = parsed.flags.proxy || parsed.flags.p || ''
+    if (proxy === 'true') proxy = ''
+    if (!proxy) proxy = getActiveProxy()
+    return proxy
+  }
+
+  async run(argv) {
+    const [action, ...rest] = argv
+
+    if (!action || action === '-h' || action === '--help' || action === 'help') {
+      this.printHelp()
+      return
+    }
+
+    switch (action) {
+      case 'version':
+        return this._version()
+      case 'installed':
+        return this._installed()
+      case 'dir':
+        return this._dir()
+      case 'versions':
+        return this._versions(rest)
+      case 'list':
+        return this._list()
+      case 'install':
+        return this._install(rest)
+      case 'status':
+        return this._status(rest)
+      case 'clear':
+        return this._clear(rest)
+      case 'registry':
+        return this._registry(rest)
+      default:
+        console.error(`Unknown action: ${action}`)
+        this.printHelp()
+        process.exit(1)
+    }
+  }
+
+  /**
+   * 拉取远程可用版本（known-good JSON）
+   * @param {string} proxy
+   * @returns {Promise<{ name: string, versions: string[], registry: string, os: string }>}
+   * @private
+   */
+  async _fetchVersions(proxy) {
+    const registry = getActiveRegistry(this.name)
+    const os = getOs()
+    const file = this.cfg.versionsFile || 'known-good-versions-with-downloads.json'
+    const url = `${registry.replace(/\/$/, '')}/${file}`
+    const text = await fetchText(url, { proxy })
+    if (!text) {
+      throw new Error(`无法获取可用版本列表: ${url}（请检查 registry / 网络 / 代理）`)
+    }
+    let data
+    try {
+      data = JSON.parse(text)
+    } catch {
+      throw new Error(`known-good JSON 解析失败: ${url}`)
+    }
+    const versions = []
+    for (const item of data.versions || []) {
+      if (!item.version) continue
+      const dl = item.downloads || {}
+      if (dl.chrome?.some((d) => d.platform === os)) {
+        versions.push(item.version)
+      }
+    }
+    return { name: this.name, versions, registry, os }
+  }
+
+  async _version() {
+    const active = this._readActive()
+    const info = active ? this._readInstalledInfo(active) : null
+    output(info ? active.replace(/^v/, '') : '')
+  }
+
+  async _installed() {
+    const list = this._listInstalled()
+    const active = this._readActive()
+    output({
+      name: this.name,
+      installed: list.length > 0,
+      active: active || undefined,
+      versions: list.map(({ version }) => version),
+      count: list.length,
+    })
+  }
+
+async _dir() {
+    const active = this._readActive()
+    const info = active ? this._readInstalledInfo(active) : null
+    output({
+      name: this.name,
+      install: active ? this._versionRoot(active) : this._installRoot(),
+      ...(info?.chrome_path ? { chrome: info.chrome_path } : {}),
+      ...(info?.chromedriver_path ? { chromedriver: info.chromedriver_path } : {}),
+      ...(active ? {} : { hint: `No version installed, run \`opm ${this.name} install\`` }),
+    })
+  }
+
+  async _versions(rest) {
+    const parsed = parseFlags(rest)
+    let proxy = parsed.flags.proxy || parsed.flags.p || ''
+    if (proxy === 'true') proxy = ''
+    if (!proxy) proxy = getActiveProxy()
+    try {
+      output(await this._fetchVersions(proxy))
+    } catch (err) {
+      console.error(err.message)
+      process.exit(1)
+    }
+  }
+
+  async _list() {
+    const list = this._listInstalled()
+    const active = this._readActive()
+    output({
+      name: this.name,
+      count: list.length,
+      active: active || undefined,
+      versions: list.map(({ version }) => ({
+        version,
+        current: version === active,
+        install: this._versionRoot(version),
+      })),
+    })
+  }
+
+  async _install(rest) {
+    const parsed = parseFlags(rest)
+    const version = parsed.positional[0] || this.cfg.getDefaultVersion()
+    if (!version) {
+      console.error(`Usage: opm ${this.name} install [version]`)
+      process.exit(1)
+    }
+    const proxy = this._resolveProxy(rest)
+    const existing = this._readInstalledInfo(version)
+    if (existing) {
+      output({ name: this.name, version, installed: true, action: 'skipped (already installed)', install: this._versionRoot(version) })
+      return
+    }
+
+    const os = getOs()
+    const registry = getActiveRegistry(this.name)
+    const targetRoot = this._versionRoot(version)
+    fs.mkdirSync(targetRoot, { recursive: true })
+
+    const result = { version, os }
+    for (const artifact of this.cfg.artifacts) {
+      const url = artifact.buildUrl(registry, version, os)
+      const dirName = artifact.dirName(os)
+      const extractDir = path.join(targetRoot, dirName)
+      const zipPath = path.join(targetRoot, `${artifact.id}.zip`)
+
+      console.log(`  下载 ${artifact.id} ${version} (${os})`)
+      await this._downloadArtifact(artifact, url, zipPath, targetRoot, dirName, proxy)
+      console.log(`  ${artifact.id} 就绪: ${extractDir}`)
+
+      const binPath = findExe(extractDir, artifact.binName)
+      if (binPath) {
+        result[`${artifact.id}_path`] = binPath
+        console.log(`  ${artifact.id} 路径: ${binPath}`)
+      }
+    }
+
+    if (result.chrome_path && verifyDeps) {
+      const depResult = verifyDeps(result.chrome_path)
+      if (!depResult.ok) {
+        console.log(`  系统依赖: ${depResult.missing.join(', ')}`)
+      }
+    }
+
+    fs.writeFileSync(path.join(targetRoot, 'installed.json'), `${JSON.stringify({ ...result, location: targetRoot }, null, 2)}\n`, 'utf8')
+    this._writeActive(version)
+    output({ name: this.name, version, installed: true, action: 'installed', install: targetRoot, ...result })
+  }
+
+  /**
+   * 下载单个 artifact 并解压（zip 内自带 <dirName>/ 目录，解压到目标根即可）
+   * @param {Object} artifact
+   * @param {string} url
+   * @param {string} zipPath - 下载的临时 zip 路径（解压后删除）
+   * @param {string} extractRoot - 解压目标根目录（版本目录）
+   * @param {string} dirName - zip 内目录名（解压目标）
+   * @param {string} proxy
+   * @returns {Promise<void>}
+   * @private
+   */
+  async _downloadArtifact(artifact, url, zipPath, extractRoot, dirName, proxy) {
+    const extractDir = path.join(extractRoot, dirName)
+    if (fs.existsSync(extractDir)) {
+      fs.rmSync(extractDir, { recursive: true, force: true })
+    }
+    if (fs.existsSync(zipPath)) {
+      fs.rmSync(zipPath, { force: true })
+    }
+    await downloadToFile(url, zipPath, { proxy })
+    try {
+      await extractZip(zipPath, { dir: extractRoot })
+    } finally {
+      if (fs.existsSync(zipPath)) {
+        fs.rmSync(zipPath, { force: true })
+      }
+    }
+    this._chmodExecDir(extractDir)
+  }
+
+  /**
+   * 递归赋可执行权限
+   * @param {string} directory
+   * @private
+   */
+  _chmodExecDir(directory) {
+    if (!directory || !fs.existsSync(directory) || !fs.statSync(directory).isDirectory()) return
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+      const fullPath = path.join(directory, entry.name)
+      if (entry.isDirectory()) {
+        this._chmodExecDir(fullPath)
+      } else {
+        try { fs.chmodSync(fullPath, 0o755) } catch {}
+      }
+    }
+  }
+
+  async _status(rest) {
+    const parsed = parseFlags(rest)
+    const version = parsed.positional[0]
+    const active = this._readActive()
+    const list = this._listInstalled()
+
+    if (version) {
+      const info = this._readInstalledInfo(version)
+      if (!info) {
+        output({ name: this.name, version, installed: false, hint: `Run \`opm ${this.name} install ${version}\`` })
+        return
+      }
+      const chromeOk = info.chrome_path ? fs.existsSync(info.chrome_path) : false
+      const driverOk = info.chromedriver_path ? fs.existsSync(info.chromedriver_path) : false
+      output({
+        name: this.name,
+        version,
+        installed: true,
+        current: version === active,
+        install: this._versionRoot(version),
+        ...(info.chrome_path ? { chrome: info.chrome_path, chrome_ok: chromeOk } : {}),
+        ...(info.chromedriver_path ? { chromedriver: info.chromedriver_path, chromedriver_ok: driverOk } : {}),
+      })
+      return
+    }
+
+    output({
+      name: this.name,
+      count: list.length,
+      active: active || undefined,
+      versions: list.map(({ version }) => {
+        const info = this._readInstalledInfo(version)
+        return {
+          version,
+          current: version === active,
+          install: this._versionRoot(version),
+          ...(info?.chrome_path ? { chrome: info.chrome_path, chrome_ok: fs.existsSync(info.chrome_path) } : {}),
+          ...(info?.chromedriver_path ? { chromedriver: info.chromedriver_path, chromedriver_ok: fs.existsSync(info.chromedriver_path) } : {}),
+        }
+      }),
+    })
+  }
+
+  async _clear(rest) {
+    const parsed = parseFlags(rest)
+    const version = parsed.positional[0]
+    const list = this._listInstalled()
+
+    const targets = version
+      ? [{ version }].filter((t) => list.some((i) => i.version === t.version))
+      : list
+
+    if (targets.length === 0) {
+      output({ name: this.name, action: 'nothing to clear' })
+      return
+    }
+
+    for (const { version: v } of targets) {
+      const dir = this._versionRoot(v)
+      if (fs.existsSync(dir)) {
+        fs.rmSync(dir, { recursive: true, force: true })
+        console.log(`  ✓ 已删除 ${v}`)
+      }
+    }
+
+    const remaining = this._listInstalled()
+    const active = this._readActive()
+    if (active && !remaining.some((i) => i.version === active)) {
+      try {
+        fs.rmSync(this._manifestPath(), { force: true })
+      } catch {}
+    }
+
+    output({ name: this.name, action: 'cleared', removed: targets.map((t) => t.version), remaining: remaining.map((i) => i.version) })
+  }
+
+  async _registry(rest) {
+    const parsed = parseFlags(rest)
+    const [sub, ...args] = parsed.positional
+    if (sub === 'set') {
+      const url = args[0]
+      if (!url) {
+        console.error(`Usage: opm ${this.name} registry set <url|preset>`)
+        process.exit(1)
+      }
+      output({ registry: setActiveRegistry(this.name, url) })
+    } else if (sub === 'presets') {
+      const items = Object.entries(getPresets(this.name)).map(([n, u]) => ({ name: n, url: u }))
+      output(items)
+    } else {
+      output({ registry: getActiveRegistry(this.name) })
+    }
+  }
+
+  printHelp() {
+    const actionLines = Object.entries(ACTIONS)
+      .map(([sig, { desc }]) => `  ${sig.padEnd(25)} ${desc}`)
+      .join('\n')
+    console.log(`
+Usage: opm ${this.name} <action> [args] [options]
+
+Actions:
+${actionLines}
+
+Options:
+  -p, --proxy <url>  Proxy for versions/install (overrides config proxy.active)
+  -h, --help         Show this help
+
+Examples:
+  opm ${this.name} version
+  opm ${this.name} dir
+  opm ${this.name} list
+  opm ${this.name} versions
+  opm ${this.name} install
+  opm ${this.name} install <version>
+  opm ${this.name} status
+  opm ${this.name} status <version>
+  opm ${this.name} clear
+  opm ${this.name} clear <version>
+  opm ${this.name} registry
+  opm ${this.name} registry set <preset|url>
+`)
+  }
+}
+
+export { OS_TYPES }

package/src/binaries/cft/index.js

@@ -0,0 +1,35 @@
+/**
+ * cft（Chrome for Testing）二进制工具配置
+ *
+ * 安装当前系统适配版本的 chrome + chromedriver 为独立可执行二进制，
+ * 与 opm 的 npm 全局包 harness 不同，直接下载 zip → 解压 → chmod。
+ */
+
+import { BinaryGroup } from '../base.js'
+import { getConfig } from '../../config.js'
+
+const cft = {
+  name: 'cft',
+  desc: 'Chrome for Testing binary installer (chrome + chromedriver)',
+  getDefaultVersion: () => getConfig().cft?.defaultVersion || '',
+  artifacts: [
+    {
+      id: 'chrome',
+      binName: 'chrome',
+      dirName: (os) => `chrome-${os}`,
+      buildUrl: (registry, version, os) => `${registry}/${version}/${os}/chrome-${os}.zip`,
+    },
+    {
+      id: 'chromedriver',
+      binName: 'chromedriver',
+      dirName: (os) => `chromedriver-${os}`,
+      buildUrl: (registry, version, os) => `${registry}/${version}/${os}/chromedriver-${os}.zip`,
+    },
+  ],
+}
+
+export class CftGroup extends BinaryGroup {
+  constructor() {
+    super(cft)
+  }
+}