@wwkit/opm 1.0.17 → 1.0.19

package/src/managers/bun.js

@@ -272,6 +272,29 @@ export class BunManager extends PackageManager {
     return { action: 'cache cleaned' }
   }
 
+  /**
+   * 列出已安装包（bun pm ls 文本树解析；-g 列全局）
+   * @param {{ global?: boolean }} [opts]
+   * @returns {Promise<{ name: string, version: string }[]>}
+   */
+  async listInstalled(opts = {}) {
+    const args = opts.global ? ['pm', 'ls', '-g', '--all'] : ['pm', 'ls', '--all']
+    const out = this._exec(args, { allowNonZero: true })
+    const items = []
+    for (const line of out.split('\n')) {
+      const cleaned = line.replace(/^[\s├└─│]+/, '').trim()
+      if (!cleaned) continue
+      // scoped 包：@babel/core@7.0.0 → 最后一个 @ 为版本分隔
+      const idx = cleaned.lastIndexOf('@')
+      if (idx > 0) {
+        const name = cleaned.slice(0, idx)
+        const version = cleaned.slice(idx + 1)
+        if (name && version) items.push({ name, version: version.replace(/^v/, '') })
+      }
+    }
+    return items
+  }
+
   /**
    * 查询 bun 安装路径和包目录
    * @returns {{ name: string, install: string, globalDir: string, cacheDir: string }}

package/src/managers/composer.js

@@ -344,6 +344,17 @@ export class ComposerManager extends PackageManager {
     return { action: 'cache cleaned' }
   }
 
+  /**
+   * 列出已安装包（缺省读当前项目 vendor/composer/installed.json，global 读全局 installed.json）
+   * @param {{ global?: boolean }} [opts]
+   * @returns {Promise<{ name: string, version: string }[]>}
+   */
+  async listInstalled(opts = {}) {
+    const packages = opts.global ? this._readGlobalInstalledJson() : this._readInstalledJson()
+    if (!packages) return []
+    return packages.map((p) => ({ name: p.name, version: p.version || 'unknown' }))
+  }
+
   /**
    * 查询 composer 安装路径和包目录
    * @returns {{ name: string, install: string, globalHome: string, vendorDir: string }}

package/src/managers/dnf.js

@@ -342,6 +342,22 @@ export class DnfManager extends PackageManager {
     return { action: 'cache cleaned' }
   }
 
+  /**
+   * 列出系统已安装包（系统级管理器，无项目作用域）
+   * @returns {Promise<{ name: string, version: string }[]>}
+   */
+  async listInstalled(opts = {}) {
+    if (opts.global === false) return []
+    const out = this._exec(['list', 'installed', '--quiet'], { allowNonZero: true })
+    const items = []
+    // 行格式: name.arch  version  repo
+    for (const line of out.split('\n')) {
+      const m = line.trim().match(/^(\S+?)\.\S+\s+(\S+)\s+\S+/)
+      if (m) items.push({ name: m[1], version: m[2] })
+    }
+    return items
+  }
+
   /**
    * 查询 dnf 安装路径和包目录
    * @returns {{ name: string, install: string, cacheDir: string, repoDir: string }}

package/src/managers/npm.js

@@ -505,6 +505,18 @@ export class NpmManager extends PackageManager {
     return { action: 'cache cleaned' }
   }
 
+  /**
+   * 列出已安装包
+   * @param {{ global?: boolean }} [opts] - global=true 列全局，缺省列当前项目
+   * @returns {Promise<{ name: string, version: string }[]>}
+   */
+  async listInstalled(opts = {}) {
+    const args = opts.global ? ['ls', '-g', '--depth=0'] : ['ls', '--depth=0']
+    const data = this._execJson(args)
+    const deps = (data && data.dependencies) || {}
+    return Object.entries(deps).map(([name, d]) => ({ name, version: (d.version || '').replace(/^v/, '') }))
+  }
+
   /**
    * 查询 npm 安装路径和包目录
    * @returns {{ name: string, install: string, globalDir: string, localDir: string, cacheDir: string, prefix: string }}

package/src/managers/pip.js

@@ -557,6 +557,22 @@ export class PipManager extends PackageManager {
     return { action: 'cache cleaned' }
   }
 
+  /**
+   * 列出已安装包
+   * @param {{ global?: boolean }} [opts] - global=true 用系统级 Python 环境，缺省当前环境
+   * @returns {Promise<{ name: string, version: string }[]>}
+   */
+  async listInstalled(opts = {}) {
+    const out = this._execPip(['list', '--format=json', '--disable-pip-version-check'], { allowNonZero: true, global: opts.global })
+    try {
+      const data = JSON.parse(out)
+      if (!Array.isArray(data)) return []
+      return data.map((i) => ({ name: i.name, version: i.version || '' }))
+    } catch {
+      return []
+    }
+  }
+
   /**
    * 查询 pip 安装路径和包目录
    * @returns {{ name: string, install: string, sitePackages: string, userSite: string }}

package/src/managers/winget.js

@@ -242,6 +242,18 @@ export class WingetManager extends PackageManager {
     return { action: 'winget has no cache clean command' }
   }
 
+  /**
+   * 列出系统已安装包（winget list 表格解析）
+   * @returns {Promise<{ name: string, version: string }[]>}
+   */
+  async listInstalled(opts = {}) {
+    const out = this._exec(['list'], { allowNonZero: true })
+    const rows = this._parseTable(out)
+    return rows
+      .filter((r) => r.Name)
+      .map((r) => ({ name: r.Name, version: r.Version || '' }))
+  }
+
   /**
    * 查询 winget 安装路径
    * @returns {{ name: string, install: string }}

package/src/tools/clipboard.js

@@ -0,0 +1,68 @@
+/**
+ * 系统剪切板读写工具
+ *
+ * 跨平台读取/写入系统级剪切板：
+ *   - darwin: pbpaste / pbcopy
+ *   - linux:  优先 wl-paste / wl-copy（Wayland），回退 xclip / xsel
+ *   - win32:  PowerShell Get-Clipboard / Set-Clipboard
+ * 读取失败（命令不存在/非零退出）返回空字符串，调用方用 trim 判断空。
+ */
+
+import { spawnSync } from 'node:child_process'
+
+/**
+ * 执行外部命令并捕获输出
+ * @param {string} cmd
+ * @param {string[]} args
+ * @param {{input?: string}} [opts]
+ * @returns {{ok: boolean, stdout: string, stderr: string}}
+ */
+function run(cmd, args, opts = {}) {
+  const res = spawnSync(cmd, args, { encoding: 'utf8', ...opts })
+  if (res.error) {
+    return { ok: false, stdout: '', stderr: res.error.message }
+  }
+  return { ok: res.status === 0, stdout: res.stdout || '', stderr: res.stderr || '' }
+}
+
+/**
+ * 读取系统剪切板内容（失败返回空字符串）
+ * @returns {string}
+ */
+export function readClipboard() {
+  const p = process.platform
+  if (p === 'darwin') {
+    return run('pbpaste', []).stdout
+  }
+  if (p === 'win32') {
+    const r = run('powershell', [
+      '-NoProfile', '-Command',
+      '[Console]::Out.Write((Get-Clipboard -Raw -ErrorAction SilentlyContinue))',
+    ])
+    return r.ok ? r.stdout : ''
+  }
+  // linux
+  const r = run('bash', [
+    '-c',
+    'wl-paste --no-newline 2>/dev/null || xclip -selection clipboard -o 2>/dev/null || xsel --clipboard --output 2>/dev/null',
+  ])
+  return r.ok ? r.stdout : ''
+}
+
+/**
+ * 写入系统剪切板
+ * @param {string} text
+ */
+export function writeClipboard(text) {
+  const input = String(text ?? '')
+  const p = process.platform
+  if (p === 'darwin') {
+    run('pbcopy', [], { input })
+    return
+  }
+  if (p === 'win32') {
+    run('powershell', ['-NoProfile', '-Command', 'Set-Clipboard -Value $input'], { input })
+    return
+  }
+  run('bash', ['-c', 'wl-copy 2>/dev/null || xclip -selection clipboard 2>/dev/null || xsel --clipboard --input 2>/dev/null'], { input })
+}

package/src/tools/ftp/index.js

@@ -196,7 +196,7 @@ export class FtpGroup {
       console.error('Usage: opm ftp upload <file> [-n name] [-s subdir]')
       process.exit(1)
     }
-    const name = parsed.flags.name || parsed.flags.n || ''
+    const name = parsed.flags.name || ''
     const subdir = parsed.flags.subdir || parsed.flags.s || ''
     const cfg = getFtpConfig()
 
@@ -242,14 +242,14 @@ export class FtpGroup {
   async _rsync(parsed) {
     const local = parsed.positional[0]
     if (!local) {
-      console.error('Usage: opm ftp rsync <local> [-s subdir] [-x pattern] [--dry-run] [--prune]')
+      console.error('Usage: opm ftp rsync <local> [-s subdir] [-x pattern] [--dry-run] [--delete]')
       process.exit(1)
     }
     const subdir = parsed.flags.subdir || parsed.flags.s || ''
     const excludes = parsed.flags.exclude || parsed.flags.x || []
     const excludeList = Array.isArray(excludes) ? excludes : [excludes]
     const dryRun = parsed.flags['dry-run'] === 'true'
-    const prune = parsed.flags.prune === 'true'
+    const deleteRemote = parsed.flags.delete === 'true'
 
     const cfg = getFtpConfig()
     const localDir = path.resolve(local)
@@ -282,7 +282,7 @@ export class FtpGroup {
     }
 
     const deletePlan = []
-    if (prune) {
+    if (deleteRemote) {
       for (const [rel] of remoteFiles) {
         if (!toUpload.includes(rel)) {
           deletePlan.push(rel)
@@ -335,9 +335,9 @@ export class FtpGroup {
       skippedSame: skippedSame.length,
       skippedExcluded,
       failed,
-      pruned: deleted.length,
-      prunedFiles: deleted,
-      pruneFailed: deleteFailed,
+      deleted: deleted.length,
+      deletedFiles: deleted,
+      deleteFailed,
     })
   }
 
@@ -370,7 +370,7 @@ Actions:
   uninstall                            Uninstall basic-ftp
   upgrade                              Upgrade basic-ftp to latest (uses opm npm registry + proxy)
   connect                              Test FTP connection
-  upload <file> [-n name] [-s subdir]  Upload file (local path or HTTP URL)
+  upload <file> [--name name] [-s subdir]  Upload file (local path or HTTP URL)
   rsync <local> [options]              Recursive upload directory (FTP-side dedup)
   download <remote> <local>            Download file from FTP
   root                                 Show configured remote root directory
@@ -380,7 +380,7 @@ rsync options:
   -s, --subdir <dir>                   Remote subdirectory (under remote_root)
   -x, --exclude <pattern>              Exclude glob pattern (repeatable)
   --dry-run                            Preview without uploading
-  --prune                              Delete remote files not in local
+  --delete                             Delete remote files not in local
 
 Options:
   -p, --proxy <url>                   Proxy for install/upgrade (overrides config proxy.active)
@@ -393,12 +393,12 @@ Examples:
   opm ftp upgrade
   opm ftp connect
   opm ftp upload ./img.png
-  opm ftp upload ./img.png -n cover -s banner
+  opm ftp upload ./img.png --name cover -s banner
   opm ftp upload https://example.com/a.jpg -n cover.jpg
   opm ftp rsync ./webwork/
   opm ftp rsync ./webwork/ -s deploy -x "vendor/*" -x "*.log"
   opm ftp rsync ./webwork/ --dry-run
-  opm ftp rsync ./webwork/ --prune
+  opm ftp rsync ./webwork/ --delete
   opm ftp download 20260913/cover.jpg ./cover.jpg
   opm ftp root
 `)

package/src/tools/git/index.js

@@ -40,6 +40,20 @@ export class GitGroup {
     this.desc = 'Git config management (init/config/user/log/export)'
   }
 
+  /**
+   * 当前 action 下的上下文布尔标志
+   * 同名标志在不同 action 中语义不同（-f：init=force / export=from；--unset：config 带值 / export mark 布尔），
+   * 由 action 决定解析方式，避免布尔标志吞掉后续参数。
+   * @param {string} action
+   * @returns {string[]}
+   * @private
+   */
+  _booleanFlags(action) {
+    if (action === 'init') return ['f', 'force']
+    if (action === 'export') return ['remove', 'unset']
+    return []
+  }
+
   async run(argv) {
     const [action, ...rest] = argv
 
@@ -48,7 +62,7 @@ export class GitGroup {
       return
     }
 
-    const parsed = parseFlags(rest)
+    const parsed = parseFlags(rest, { booleans: this._booleanFlags(action) })
 
     switch (action) {
       case 'version':
@@ -146,7 +160,7 @@ export class GitGroup {
 
   async _user(parsed) {
     const scope = this._getScope(parsed)
-    const name = parsed.flags.n || parsed.flags.name || ''
+    const name = parsed.flags.name || ''
     const email = parsed.flags.e || parsed.flags.email || ''
 
     if (name || email) {
@@ -209,7 +223,7 @@ export class GitGroup {
     const workDir = parsed.flags.d || parsed.flags.dir || process.cwd()
     const ref = parsed.positional[1]
 
-    if (parsed.flags.unset === 'true') {
+    if (parsed.flags.remove === 'true' || parsed.flags.unset === 'true') {
       const ok = unsetMark(workDir)
       output({ mark: 'removed', ok })
       return
@@ -230,7 +244,7 @@ export class GitGroup {
       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 mark --remove     # remove current mark')
       console.error('  opm git export                  # export diff (mark -> HEAD)')
       this._printRecentLog(workDir)
       return
@@ -250,7 +264,7 @@ export class GitGroup {
       process.exit(1)
     }
 
-    const fromRaw = parsed.flags.f || parsed.flags.from || ''
+    const fromRaw = parsed.flags.from || ''
     let fromRef
     if (fromRaw) {
       const n = parseInt(fromRaw, 10)
@@ -271,7 +285,7 @@ export class GitGroup {
     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 name = 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()
@@ -331,7 +345,7 @@ 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 mark --remove [-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)
@@ -344,11 +358,15 @@ Options:
   -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)
+  --from <n>|<ref>               Override from ref (export)
   -f, --force                    Force overwrite existing config (init)
-  --unset <key>                  Unset a config key (config)
+  --unset <key>                  Unset a config key (config only)
+  --remove                       Remove the diff base mark (export mark)
   -h, --help                     Show this help
 
+Note: -n 在 log 中为 --count 数量，user/export 中用 --name 名称（无短形式）；
+      -f 在 init 中为 --force 布尔，export 中用 --from 带值（无短形式）。
+
 Examples:
   opm git version                Show installed git version
   opm git install                Install git via system package manager
@@ -365,12 +383,11 @@ Examples:
   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 mark --remove   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 --from 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 export --name 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/index.js

@@ -18,9 +18,11 @@ import { getConfig, getSection, getUserConfigDir } from '../../config.js'
 import { output } from '../../formatter.js'
 import { getShareServer, pingServer, uploadShare, getShare, getLatestShare, getHtmlUrl, listShares, deleteShare, clearShares } from './client.js'
 import { startServer } from './server.js'
+import { readClipboard, writeClipboard } from '../clipboard.js'
 
 const DEFAULT_PASSWORD = '0000'
 const ZIP_TMP_PREFIX = 'opm-share-'
+const CLIPBOARD_ID = 'clipboard'
 
 /**
  * 生成默认标题（内容前 30 字符折叠空白 + ...，≤30 用原文）
@@ -109,9 +111,11 @@ const ACTIONS = {
   open:   { desc: 'Open shared content in browser (id optional; defaults to latest)' },
   list:   { desc: 'List recent shares (-n count, default 10)' },
   delete: { desc: 'Delete a share by id' },
-  clear:  { desc: 'Clean up shares by days and/or keep count' },
+  clear:  { desc: 'Keep shares by days and/or count (--days n keeps last n days, --keep n keeps n most recent)' },
   config: { desc: 'Show current share config section' },
   server:  { desc: 'Manage local server (start/stop/status)' },
+  copy:   { desc: 'Copy system clipboard to server (id=clipboard; skips when clipboard is empty)' },
+  paste:  { desc: 'Fetch server clipboard (id=clipboard) back into system clipboard and print' },
   help:   { desc: 'Show this help' },
 }
 
@@ -152,6 +156,10 @@ export class ShareGroup {
         return this._config(parsed)
       case 'server':
         return this._server(parsed)
+      case 'copy':
+        return this._copy(parsed)
+      case 'paste':
+        return this._paste(parsed)
       default:
         return this._upload(parseFlags([action, ...rest]))
     }
@@ -188,7 +196,7 @@ export class ShareGroup {
    * @returns {string}
    */
   _resolvePassword(parsed, positional = '') {
-    const flag = parsed.flags.p || parsed.flags.password || ''
+    const flag = parsed.flags.password || ''
     if (flag && flag !== 'true') return flag
     const cfgPassword = this._getShareConfig().password
     if (cfgPassword) return cfgPassword
@@ -234,7 +242,7 @@ export class ShareGroup {
 
   async _upload(parsed) {
     const title = parsed.flags.t || parsed.flags.title || ''
-    const file = parsed.flags.f || parsed.flags.file || ''
+    const file = parsed.flags.file || ''
     const id = parsed.flags.i || parsed.flags.id || ''
     const password = this._resolvePassword(parsed)
 
@@ -271,7 +279,7 @@ export class ShareGroup {
   }
 
   async _zip(parsed) {
-    const inputPath = parsed.positional[0] || parsed.flags.f || parsed.flags.file || ''
+    const inputPath = parsed.positional[0] || parsed.flags.file || ''
     const title = parsed.flags.t || parsed.flags.title || ''
     const id = parsed.flags.i || parsed.flags.id || ''
     const password = this._resolvePassword(parsed)
@@ -477,12 +485,12 @@ export class ShareGroup {
   }
 
   async _clear(parsed) {
-    const days = parseInt(parsed.flags.days || '0', 10) || 0
+    const days = parseFloat(parsed.flags.days || '0') || 0
     const keep = parseInt(parsed.flags.keep || parsed.flags.n || '0', 10) || 0
 
     if (!days && !keep) {
       console.error('Usage: opm share clear [--days <n>] [--keep <n>]')
-      console.error('  --days <n>  Delete shares older than n days')
+      console.error('  --days <n>  Keep shares from the last n days (integer = aligned to local midnight, fraction = hour window; default keeps today)')
       console.error('  --keep <n>  Keep only the most recent n shares')
       console.error('  Both can be combined: clear --days 7 --keep 50')
       process.exit(1)
@@ -667,6 +675,50 @@ Environment variables (for server.js direct execution):
     output({ running: true, ...pidInfo })
   }
 
+  /**
+   * opm copy — 将系统剪切板内容以 id=clipboard 上传到服务器
+   * 剪切板为空（trim 后）时提示并停止。
+   * @param {object} parsed
+   */
+  async _copy(parsed) {
+    const content = readClipboard()
+    if (!content.trim()) {
+      console.error('[opm share] Clipboard is empty, nothing to upload.')
+      process.exit(1)
+    }
+
+    const password = this._resolvePassword(parsed)
+    const baseUrl = await this._ensureReachable()
+    const result = await uploadShare(baseUrl, {
+      title: defaultTitle(content),
+      content,
+      password,
+      id: CLIPBOARD_ID,
+    })
+    output({ ...result, copied: true })
+  }
+
+  /**
+   * opm paste — 取回服务器上 id=clipboard 的内容，写回系统剪切板并显示
+   * @param {object} parsed
+   */
+  async _paste(parsed) {
+    const password = this._resolvePassword(parsed, parsed.positional[0] || '')
+    const baseUrl = await this._ensureReachable()
+    const result = await getShare(baseUrl, CLIPBOARD_ID, password)
+
+    const content = result.content || ''
+    writeClipboard(content)
+    output({
+      pasted: true,
+      id: result.id,
+      title: result.title,
+      created: result.created,
+      length: content.length,
+      content,
+    })
+  }
+
   printHelp() {
     const actionLines = Object.entries(ACTIONS)
       .map(([sig, { desc }]) => `  ${sig.padEnd(12)} ${desc}`)
@@ -690,9 +742,9 @@ Shorthand:
 
 Options:
   -t, --title <title>                  Title (default: first 30 chars of content)
-  -f, --file <path>                    Read content from file
+  --file <path>                        Read content from file
   -i, --id <id>                        Custom share id (upload/zip; easier to remember)
-  -p, --password <password>            Password (default: config share.password, fallback 0000)
+  --password <password>               Password (default: config share.password, fallback 0000)
   -n, --count <n>                      Number of items (list, default: 10)
   -d, --dir <dir>                      Extract zip to this directory (get)
   -h, --help                           Show this help
@@ -703,14 +755,18 @@ Server config (config.json5):
   share.serve.host / .port / .dataDir  Local serve parameters
 
 Examples:
+  opm share copy                        Copy system clipboard to server (id=clipboard)
+  opm share paste                       Fetch server clipboard back to system clipboard
+  opm copy                              Top-level shortcut for "opm share copy"
+  opm paste                             Top-level shortcut for "opm share paste"
   opm share config                     Show current share config
   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
-  opm share -f doc.md                  Upload file (title auto from content)
+  opm share "hello world" --password 1234      Upload text with password override
+  opm share --file doc.md                  Upload file (title auto from content)
   opm share -f doc.md -t "README"      Upload file with custom title
   echo "hello" | opm share             Upload from stdin
   opm share zip ./src                  Upload folder as zip
@@ -718,7 +774,7 @@ Examples:
   opm share get                        Get the latest share (JSON)
   opm share get myid                   Get share by custom id
   opm share get abc12345               Get share by random id
-  opm share get abc12345 -p 1234       Get with password override
+  opm share get abc12345 --password 1234       Get with password override
   opm share get abc12345 -d ./out      Download and extract zip to ./out
   opm share view                       View the latest share content
   opm share view myid                  View share by custom id
@@ -727,7 +783,7 @@ Examples:
   opm share list                       List recent 10 shares
   opm share list -n 5                  List recent 5 shares
   opm share delete abc12345            Delete a share by id
-  opm share clear --days 7             Delete shares older than 7 days
+  opm share clear --days 7             Keep shares from the last 7 days
   opm share clear --keep 50            Keep only the most recent 50 shares
   opm share clear --days 7 --keep 50   Both combined
 `)

package/src/tools/share/server.js

@@ -300,8 +300,18 @@ function handleDelete(req, res, dataDir, id) {
   sendJson(res, 200, { deleted: true, id })
 }
 
+/**
+ * 某毫秒时间戳所在「天」的本地零点（与 opencode clear 语义一致）
+ * @param {number} ts - epoch ms
+ * @returns {number}
+ */
+function startOfDayLocal(ts) {
+  const d = new Date(ts)
+  return new Date(d.getFullYear(), d.getMonth(), d.getDate()).getTime()
+}
+
 function handleClear(req, res, dataDir, url) {
-  const days = parseInt(url.searchParams.get('days') || '0', 10) || 0
+  const days = parseFloat(url.searchParams.get('days') || '0') || 0
   const keep = parseInt(url.searchParams.get('keep') || '0', 10) || 0
 
   let files = fs.readdirSync(dataDir)
@@ -315,7 +325,11 @@ function handleClear(req, res, dataDir, url) {
   const now = Date.now()
 
   if (days > 0) {
-    const cutoff = now - days * 24 * 60 * 60 * 1000
+    // 语义与 opencode clear 统一：保留最近 n 天（含今天）。
+    // 整数天对齐本地零点（删除 今天零点-(n-1)天 之前）；小数天 = 小时级滚动窗口（0.5 = 12h）
+    const cutoff = Number.isInteger(days)
+      ? startOfDayLocal(now) - (days - 1) * 86400000
+      : now - days * 86400000
     for (const f of files) {
       const createdMs = new Date(f.created).getTime()
       if (createdMs < cutoff) {

package/src/tools/webwork/index.js

@@ -33,7 +33,7 @@ const COMPONENTS = [
 
 const ACTIONS = {
   version:   { desc: 'Show installed version of each component' },
-  versions:  { desc: 'Show latest available versions (default 10, -n <num>)' },
+  versions:  { desc: 'Show latest available versions (default 10, -n <count>)' },
   installed: { desc: 'Show install status (true/false) of each component' },
   install:   { desc: 'Mirror check + ensure runtime + write registry env + blues-lib + ww init' },
   uninstall: { desc: 'Uninstall all components in reverse order' },
@@ -96,7 +96,7 @@ export class WebworkGroup {
 
   async _versions(parsed) {
     const proxy = this._resolveProxy(parsed)
-    const num = parseInt(parsed.flags.n || parsed.flags.num || '10', 10)
+    const num = parseInt(parsed.flags.n || parsed.flags.count || parsed.flags.num || '10', 10)
 
     const result = {}
 
@@ -274,6 +274,10 @@ export class WebworkGroup {
     await this._runBatch('uninstall', reversed, proxy, (key, p) => this._uninstallComponent(key, p))
   }
 
+  // TODO(P2-6): webwork 自身需要提供真正的 uninstall 命令。
+  // 当前 _uninstall 仅卸载 blues-lib（python/node 作为系统依赖跳过）；
+  // 自身的完整卸载方案（registry env 清理、ww 相关配置移除等）待实现。
+
   /**
    * 检查镜像可达性（HEAD 请求，不可达则抛错）
    * 必查：npm / pip（blues-lib 依赖，环境必然可用）