@wwkit/opm 1.0.2 → 1.0.4

package/src/tools/git/index.js

@@ -0,0 +1,378 @@
+/**
+ * opm git 命令组 — Git 配置管理
+ *
+ * 命令：init / config / user / log / export / import / help
+ * 聚焦冷门或多步骤操作，log 支持指定 workdir 免切换目录查看提交历史。
+ * export 保存两个 commit 之间的差异到文件，默认从 mark 到 HEAD。
+ * mark 用 lightweight git tag 标记基准 commit，对用户透明。
+ */
+
+import path from 'node:path'
+import fs from 'node:fs'
+import { execSync } from 'node:child_process'
+import { parseFlags } from '../../cli/helpers/args.js'
+import { output } from '../../formatter.js'
+import {
+  listConfig, getConfigValue, setConfigValue, unsetConfigValue,
+  getUser, setUser,
+  initGitConfig, saveDiff, importDiff,
+  getMark, setMark, unsetMark,
+  getGitVersion, installGit, uninstallGit, upgradeGit,
+} from './config.js'
+
+const ACTIONS = {
+  version:   { desc: 'Show installed git version' },
+  install:   { desc: 'Install git via system package manager (dnf/yum/apt/apk)' },
+  uninstall: { desc: 'Uninstall git via system package manager' },
+  upgrade:   { desc: 'Upgrade git via system package manager' },
+  init:     { desc: 'Initialize git global config from opm config (user/ssl/pull.rebase)' },
+  config:   { desc: 'View/set/unset git config (with --scope global|local|system)' },
+  user:     { desc: 'View/set user.name and user.email' },
+  log:      { desc: 'Show commit history (with -d/--dir for workdir, -n for count)' },
+  export:   { desc: 'Export diff to file (default: mark -> HEAD, or -f <n> override)' },
+  import:   { desc: 'Import diff file into working tree (git apply --reject)' },
+  help:     { desc: 'Show this help' },
+}
+
+export class GitGroup {
+  constructor() {
+    this.name = 'git'
+    this.desc = 'Git config management (init/config/user/log/export)'
+  }
+
+  async run(argv) {
+    const [action, ...rest] = argv
+
+    if (!action || action === '-h' || action === '--help' || action === 'help') {
+      this.printHelp()
+      return
+    }
+
+    const parsed = parseFlags(rest)
+
+    switch (action) {
+      case 'version':
+        return this._version()
+      case 'install':
+        return this._install(parsed)
+      case 'uninstall':
+        return this._uninstall()
+      case 'upgrade':
+        return this._upgrade(parsed)
+      case 'init':
+        return this._init(parsed)
+      case 'config':
+        return this._config(parsed)
+      case 'user':
+        return this._user(parsed)
+      case 'log':
+        return this._log(parsed)
+      case 'export':
+        return this._export(parsed)
+      case 'import':
+        return this._import(parsed)
+      default:
+        console.error(`Unknown action: ${action}`)
+        this.printHelp()
+        process.exit(1)
+    }
+  }
+
+  _resolveProxy(parsed) {
+    let proxy = parsed.flags.p || parsed.flags.proxy || ''
+    if (proxy === 'true') proxy = ''
+    return proxy
+  }
+
+  _version() {
+    const result = getGitVersion()
+    output(result)
+  }
+
+  _install(parsed) {
+    const proxy = this._resolveProxy(parsed)
+    const result = installGit(proxy)
+    output(result)
+  }
+
+  _uninstall() {
+    const result = uninstallGit()
+    output(result)
+  }
+
+  _upgrade(parsed) {
+    const proxy = this._resolveProxy(parsed)
+    const result = upgradeGit(proxy)
+    output(result)
+  }
+
+  _getScope(parsed) {
+    return parsed.flags.scope || 'global'
+  }
+
+  async _init(parsed) {
+    const force = parsed.flags.f === 'true' || parsed.flags.force === 'true'
+    const result = await initGitConfig(force)
+    output(result)
+  }
+
+  async _config(parsed) {
+    const scope = this._getScope(parsed)
+    const unsetKey = parsed.flags.unset || ''
+
+    if (unsetKey) {
+      const ok = unsetConfigValue(unsetKey, scope)
+      output({ scope, key: unsetKey, unset: ok })
+      return
+    }
+
+    const [key, value] = parsed.positional
+
+    if (key && value) {
+      const ok = setConfigValue(key, value, scope)
+      output({ scope, key, value, set: ok })
+      return
+    }
+
+    if (key) {
+      const val = getConfigValue(key, scope)
+      output({ scope, key, value: val })
+      return
+    }
+
+    const result = listConfig(scope)
+    output({ scope, ...result })
+  }
+
+  async _user(parsed) {
+    const scope = this._getScope(parsed)
+    const name = parsed.flags.n || parsed.flags.name || ''
+    const email = parsed.flags.e || parsed.flags.email || ''
+
+    if (name || email) {
+      const result = setUser(name, email, scope)
+      output({ scope, ...result })
+      return
+    }
+
+    const result = getUser(scope)
+    output({ scope, ...result })
+  }
+
+  _log(parsed) {
+    const workDir = parsed.flags.d || parsed.flags.dir || process.cwd()
+    const resolvedDir = path.resolve(workDir)
+    if (!this._getGitDir(resolvedDir)) {
+      console.error(`Not a git repository: ${resolvedDir}`)
+      process.exit(1)
+    }
+    const n = parseInt(parsed.flags.n || parsed.flags.count || '10', 10) || 10
+    const opts = { encoding: 'utf8', timeout: 5000, cwd: resolvedDir, stdio: ['pipe', 'pipe', 'pipe'] }
+    const raw = execSync(`git log --oneline -${n}`, opts).trim()
+    if (!raw) {
+      output({ commits: [], message: 'No commits yet' })
+      return
+    }
+    const commits = raw.split('\n').map((line) => {
+      const idx = line.indexOf(' ')
+      return { hash: line.slice(0, idx), subject: line.slice(idx + 1) }
+    })
+    output({ dir: resolvedDir, count: commits.length, commits })
+  }
+
+  _printRecentLog(workDir, count = 5) {
+    const resolvedDir = path.resolve(workDir)
+    if (!this._getGitDir(resolvedDir)) return
+    const opts = { encoding: 'utf8', timeout: 5000, cwd: resolvedDir, stdio: ['pipe', 'pipe', 'pipe'] }
+    try {
+      const raw = execSync(`git log --oneline -${count}`, opts).trim()
+      if (raw) {
+        console.error(`\nRecent ${count} commits:`)
+        for (const line of raw.split('\n')) {
+          console.error(`  ${line}`)
+        }
+      }
+    } catch {}
+  }
+
+  async _export(parsed) {
+    const [sub] = parsed.positional
+
+    if (sub === 'mark') {
+      return this._exportMark(parsed)
+    }
+
+    return this._exportDiff(parsed)
+  }
+
+  _exportMark(parsed) {
+    const workDir = parsed.flags.d || parsed.flags.dir || process.cwd()
+    const ref = parsed.positional[1]
+
+    if (parsed.flags.unset === 'true') {
+      const ok = unsetMark(workDir)
+      output({ mark: 'removed', ok })
+      return
+    }
+
+    if (!ref) {
+      const mark = getMark(workDir)
+      if (!mark) {
+        output({ mark: 'not-set' })
+        console.error('\nTips: mark not set, set a diff base first:')
+        console.error('  opm git export mark HEAD        # mark current HEAD as diff base')
+        console.error('  opm git export mark <commit>   # mark a commit as diff base')
+        console.error('  opm git log -d <dir> -n 10     # view commit history without cd')
+        this._printRecentLog(workDir)
+        return
+      }
+      output({ mark: 'set', ...mark })
+      console.error('\nTips:')
+      console.error('  opm git log -d <dir> -n 10     # view commit history without cd')
+      console.error('  opm git export mark <commit>   # change diff base to another commit')
+      console.error('  opm git export mark --unset     # remove current mark')
+      console.error('  opm git export                  # export diff (mark -> HEAD)')
+      this._printRecentLog(workDir)
+      return
+    }
+
+    const resolvedRef = ref === '0' || ref.toLowerCase() === 'head' ? 'HEAD' : ref
+    const result = setMark(workDir, resolvedRef)
+    output({ mark: 'set', ...result })
+  }
+
+  _exportDiff(parsed) {
+    const workDir = parsed.flags.d || parsed.flags.dir || process.cwd()
+    const resolvedDir = path.resolve(workDir)
+    const gitDir = this._getGitDir(resolvedDir)
+    if (!gitDir) {
+      console.error(`Not a git repository: ${resolvedDir}`)
+      process.exit(1)
+    }
+
+    const fromRaw = parsed.flags.f || parsed.flags.from || ''
+    let fromRef
+    if (fromRaw) {
+      const n = parseInt(fromRaw, 10)
+      fromRef = isNaN(n) ? fromRaw : `HEAD~${n}`
+    } else {
+      const mark = getMark(resolvedDir)
+      if (!mark) {
+        console.error('No mark found. Set a mark first:')
+        console.error('  opm git export mark HEAD        # mark current HEAD as diff base')
+        console.error('  opm git export mark <commit>   # mark a commit as diff base')
+        console.error('  opm git log -d <dir> -n 10     # view commit history without cd')
+        process.exit(1)
+      }
+      fromRef = mark.commit
+    }
+
+    let outFile = parsed.flags.o || parsed.flags.output || ''
+    if (!outFile) {
+      const opts = { encoding: 'utf8', timeout: 5000, cwd: resolvedDir, stdio: ['pipe', 'pipe', 'pipe'] }
+      const gitRoot = execSync('git rev-parse --show-toplevel', opts).trim()
+      const name = parsed.flags.n || parsed.flags.name || ''
+      const fileName = name ? `${name}.diff` : (() => {
+        const fromShort = execSync(`git rev-parse --short ${fromRef}`, opts).trim()
+        const toShort = execSync('git rev-parse --short HEAD', opts).trim()
+        return `changes-${fromShort}-to-${toShort}.diff`
+      })()
+      outFile = path.join(gitRoot, '.webwork', 'git', fileName)
+    }
+
+    const filePath = path.resolve(outFile)
+    const dir = path.dirname(filePath)
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true })
+
+    const result = saveDiff(resolvedDir, filePath, fromRef)
+    output(result)
+  }
+
+  async _import(parsed) {
+    const diffFile = parsed.positional[0]
+    if (!diffFile) {
+      console.error('Usage: opm git import <difffile> [-d <workdir>]')
+      process.exit(1)
+    }
+
+    const workDir = parsed.flags.d || parsed.flags.dir || process.cwd()
+    const resolvedDir = path.resolve(workDir)
+    const gitDir = this._getGitDir(resolvedDir)
+    if (!gitDir) {
+      console.error(`Not a git repository: ${resolvedDir}`)
+      process.exit(1)
+    }
+
+    const result = importDiff(resolvedDir, diffFile)
+    output(result)
+  }
+
+  _getGitDir(dir) {
+    try {
+      execSync('git rev-parse --git-dir', { encoding: 'utf8', timeout: 5000, cwd: dir, stdio: ['pipe', 'pipe', 'pipe'] })
+      return true
+    } catch {
+      return false
+    }
+  }
+
+  printHelp() {
+    const actionLines = Object.entries(ACTIONS)
+      .map(([sig, { desc }]) => `  ${sig.padEnd(12)} ${desc}`)
+      .join('\n')
+
+    console.log(`
+Usage: opm git <action> [options]
+
+Actions:
+${actionLines}
+
+Export subcommands:
+  export mark [-d dir]            Show current diff base mark
+  export mark 0|HEAD [-d dir]     Set diff base mark to current HEAD
+  export mark <commit> [-d dir]   Set diff base mark to a commit
+  export mark --unset [-d dir]    Remove the diff base mark
+  export [-d dir]               Export diff (mark -> HEAD)
+  export -f <n> [-d dir]        Export diff (HEAD~n -> HEAD, override mark)
+  export -f <ref> [-d dir]      Export diff (<ref> -> HEAD, override mark)
+
+Options:
+  -d, --dir <dir>               Git repository directory (default: cwd)
+  -p, --proxy <url>             Proxy for install/upgrade
+  --scope <global|local|system>  Config scope (default: global)
+  -n, --name <name>              User name (user) / diff file name (export)
+  -n, --count <n>                Number of commits to show (log, default: 10)
+  -e, --email <email>            User email (user)
+  -o, --output <file>            Output file path (export)
+  -f, --from <n>|<ref>           Override from ref (export)
+  -f, --force                    Force overwrite existing config (init)
+  --unset <key>                  Unset a config key (config)
+  -h, --help                     Show this help
+
+Examples:
+  opm git version                Show installed git version
+  opm git install                Install git via system package manager
+  opm git upgrade                Upgrade git to latest
+  opm git uninstall              Uninstall git
+  opm git init                  Initialize global config from opm config
+  opm git config                 List all global config
+  opm git config pull.rebase true      Set pull to use rebase
+  opm git user                  Show current user.name and user.email
+  opm git log                    Show recent 10 commits (cwd)
+  opm git log -n 5               Show recent 5 commits (cwd)
+  opm git log -d /path/to/repo   Show commits in specified repo
+  opm git export mark             Show current diff base mark (cwd)
+  opm git export mark 0           Set diff base to current HEAD (cwd)
+  opm git export mark HEAD        Set diff base to current HEAD (cwd)
+  opm git export mark 3af967b   Set diff base at commit (cwd)
+  opm git export mark --unset   Remove diff base mark (cwd)
+  opm git export mark abc -d /repo  Set diff base at commit in /repo
+  opm git export                Export diff in current repo (mark -> HEAD)
+  opm git export -f 2           Override: HEAD~2 -> HEAD (current repo)
+  opm git export -d /path/to/repo  Export diff in specified repo
+  opm git export -n feature     Save as feature.diff
+  opm git import file.diff      Import diff file (current repo)
+  opm git import file.diff -d /repo  Import diff file into specified repo
+`)
+  }
+}

package/src/tools/share/.htaccess

@@ -0,0 +1,20 @@
+# opm share server — Apache URL rewrite
+# 将所有 /share/* 请求路由到 server.php
+
+<IfModule mod_rewrite.c>
+  RewriteEngine On
+
+  # 如果请求的是已存在的文件，直接返回
+  RewriteCond %{REQUEST_FILENAME} -f [OR]
+  RewriteCond %{REQUEST_FILENAME} -d
+  RewriteRule ^ - [L]
+
+  # /share/* 路由到 server.php
+  RewriteRule ^share/?$ server.php [L,QSA]
+  RewriteRule ^share/(.+)$ server.php [L,QSA]
+</IfModule>
+
+# 保护 data 目录，禁止直接访问
+<IfModule mod_rewrite.c>
+  RewriteRule ^data/ - [F]
+</IfModule>

package/src/tools/share/client.js

@@ -0,0 +1,172 @@
+/**
+ * share HTTP 客户端 — 上传/取回/列表
+ *
+ * 通过 fetch 调用 share server API。
+ * 服务地址由 config.share.server.active 解析（key → URL，URL 原样返回）。
+ */
+
+/**
+ * 解析 active server URL
+ * @param {object} shareConfig - config.share 段
+ * @returns {string} base URL（无尾斜杠）
+ */
+export function getShareServer(shareConfig) {
+  const server = shareConfig?.server ?? {}
+  const active = server.active
+  if (!active) return server.official || ''
+  return server[active] || active
+}
+
+/**
+ * ping 检测 server 可达性
+ * @param {string} baseUrl
+ * @returns {Promise<{reachable: boolean, status: number, message: string}>}
+ */
+export async function pingServer(baseUrl) {
+  try {
+    const res = await fetch(`${baseUrl}/share/list?n=1`, {
+      signal: AbortSignal.timeout(5000),
+    })
+    if (res.ok) {
+      return { reachable: true, status: res.status, message: 'OK' }
+    }
+    if (res.status === 404) {
+      return { reachable: true, status: res.status, message: 'OK (404 on list endpoint is acceptable)' }
+    }
+    return { reachable: false, status: res.status, message: `HTTP ${res.status}` }
+  } catch (err) {
+    return { reachable: false, status: 0, message: err.message }
+  }
+}
+
+/**
+ * 上传分享内容
+ * @param {string} baseUrl
+ * @param {{title?: string, content: string, password?: string, id?: string, type?: string, filename?: string}} data
+ * @returns {Promise<{id: string, url: string, htmlUrl: string}>}
+ */
+export async function uploadShare(baseUrl, data) {
+  const res = await fetch(`${baseUrl}/share`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(data),
+    signal: AbortSignal.timeout(30000),
+  })
+  if (!res.ok) {
+    const body = await res.text()
+    throw new Error(`Upload failed: HTTP ${res.status} ${body}`)
+  }
+  return res.json()
+}
+
+/**
+ * 取回分享内容
+ * @param {string} baseUrl
+ * @param {string} id
+ * @param {string} [password]
+ * @returns {Promise<{id: string, title: string, content: string, created: string}>}
+ */
+export async function getShare(baseUrl, id, password) {
+  const url = password
+    ? `${baseUrl}/share/${id}/${password}`
+    : `${baseUrl}/share/${id}`
+  const res = await fetch(url, {
+    headers: { 'Accept': 'application/json' },
+    signal: AbortSignal.timeout(10000),
+  })
+  if (!res.ok) {
+    const body = await res.text()
+    throw new Error(`Get failed: HTTP ${res.status} ${body}`)
+  }
+  return res.json()
+}
+
+/**
+ * 取回最近一条分享内容
+ * @param {string} baseUrl
+ * @param {string} [password]
+ * @returns {Promise<{id: string, title: string, content: string, created: string}>}
+ */
+export async function getLatestShare(baseUrl, password) {
+  const url = password
+    ? `${baseUrl}/share/latest/${password}`
+    : `${baseUrl}/share/latest`
+  const res = await fetch(url, {
+    headers: { 'Accept': 'application/json' },
+    signal: AbortSignal.timeout(10000),
+  })
+  if (!res.ok) {
+    const body = await res.text()
+    throw new Error(`Get latest failed: HTTP ${res.status} ${body}`)
+  }
+  return res.json()
+}
+
+/**
+ * 获取 HTML 页面 URL
+ * @param {string} baseUrl
+ * @param {string} id
+ * @param {string} [password]
+ * @returns {string}
+ */
+export function getHtmlUrl(baseUrl, id, password) {
+  return password
+    ? `${baseUrl}/share/html/${id}/${password}`
+    : `${baseUrl}/share/html/${id}`
+}
+
+/**
+ * 列出最近分享
+ * @param {string} baseUrl
+ * @param {number} n
+ * @returns {Promise<{count: number, items: Array<{id: string, title: string, created: string}>}>}
+ */
+export async function listShares(baseUrl, n) {
+  const res = await fetch(`${baseUrl}/share/list?n=${n}`, {
+    signal: AbortSignal.timeout(10000),
+  })
+  if (!res.ok) {
+    const body = await res.text()
+    throw new Error(`List failed: HTTP ${res.status} ${body}`)
+  }
+  return res.json()
+}
+
+/**
+ * 删除指定分享
+ * @param {string} baseUrl
+ * @param {string} id
+ * @returns {Promise<{deleted: boolean, id: string}>}
+ */
+export async function deleteShare(baseUrl, id) {
+  const res = await fetch(`${baseUrl}/share/delete/${id}`, {
+    method: 'POST',
+    signal: AbortSignal.timeout(10000),
+  })
+  if (!res.ok) {
+    const body = await res.text()
+    throw new Error(`Delete failed: HTTP ${res.status} ${body}`)
+  }
+  return res.json()
+}
+
+/**
+ * 清理过期/超额分享
+ * @param {string} baseUrl
+ * @param {{days?: number, keep?: number}} opts
+ * @returns {Promise<{deleted: number, ids: string[]}>}
+ */
+export async function clearShares(baseUrl, opts) {
+  const params = new URLSearchParams()
+  if (opts.days) params.set('days', String(opts.days))
+  if (opts.keep) params.set('keep', String(opts.keep))
+  const res = await fetch(`${baseUrl}/share/clear?${params}`, {
+    method: 'POST',
+    signal: AbortSignal.timeout(30000),
+  })
+  if (!res.ok) {
+    const body = await res.text()
+    throw new Error(`Clear failed: HTTP ${res.status} ${body}`)
+  }
+  return res.json()
+}