@wwkit/opm 1.0.18 → 1.0.19

package/README.md

@@ -69,6 +69,9 @@ pnpm opm <command> [args] [options]
 | `ping <host|proxy|registry>` | 验证主机、代理或所有 registry 的可访问性 |
 | `env <action>` | 环境变量管理（list/get/set，跨平台：Unix profile / Windows user 级注册表） |
 | `config [section]` | 查看常用配置（proxy + 各 registry 段，段名动态生成） |
+| `share <action>` | 文本分享服务（upload/zip/get/view/open/list/delete/clear/server） |
+| `copy` | 系统剪切板 → 服务器（id=clipboard；剪切板为空时提示停止） |
+| `paste` | 服务器 clipboard → 系统剪切板并显示（`opm share get clipboard` 的快捷） |
 | `opencode <action>` | opencode 运维命令（安装/升级/清理/env）；裸 `opm opencode` 启动 TUI |
 | `harness <action>` | @wwkit/harness 插件管理（安装/升级/list/status/env/dir） |
 
@@ -94,16 +97,16 @@ pnpm opm <command> [args] [options]
 
 | Action | 说明 |
 |--------|------|
-| `version [name]` | 无 name 查看管理器本身版本；有 name 显示包在全局与项目作用域的版本（仅包管理器） |
+| `version [name]` | 无 name 查看管理器本身版本；有 name 显示包在全局与项目作用域的版本号（仅包管理器；完整安装状态见 `view`） |
 | `registry` | 查询当前镜像地址 |
 | `registry set <url\|preset>` | 设置镜像地址（支持预设名） |
 | `registry presets` | 列出可用镜像预设 |
-| `search <name> [version]` | 查询包在源是否可用 |
-| `view <name>` | 查询包在全局与项目作用域的安装信息（仅包管理器；运行时查询版本是否已安装） |
+| `search <name>[@<version>]` | 查询包在源是否可用 |
+| `view <name>` | 查询包是否已安装，已安装显示基本信息（包管理器：全局+项目双作用域；运行时：指定版本是否已安装） |
 | `info <name>` | 查询包详情 |
 | `versions <name>` | 列出所有可用版本 |
-| `list` | 列出所有已安装包（仅运行时 node/php/python 与工具组 nvm/phpenv/uv 支持） |
-| `install <name> [version]` | 安装包 |
+| `list [-g]` | 列出已安装包（包管理器：项目作用域，`-g` 全局；运行时/工具组：已安装版本，数组输出） |
+| `install <name>[@<version>]` | 安装包（版本用 `@` 连接，业界惯例） |
 | `uninstall <name>` | 卸载包 |
 | `upgrade <name>` | 升级包 |
 | `cache clean` | 清理缓存 |
@@ -122,15 +125,15 @@ pnpm opm <command> [args] [options]
 | `opencode env` | 显示环境变量（OPENCODE_CONFIG_DIR / CONTENT） |
 | `opencode [-d <dir>]` | 启动 TUI（默认 cwd），自动注入环境变量；可透传 args 给 opencode |
 | `opencode clear` | 清理过期会话并 VACUUM 压缩数据库（缺省 `-d 1`，只保留今天） |
-| `opencode clear -d, --days <n>` | 保留最近 n 天（对齐本地零点，含今天） |
-| `opencode clear -h, --hours <n>` | 保留最近 n 小时（滚动窗口） |
+| `opencode clear -d, --days <n>` | 保留最近 n 天（整数对齐本地零点含今天；小数 = 小时窗口，`0.5` = 12 小时） |
 | `opencode clear -n, --num <n>` | 保留最新 n 个会话 |
 | `opencode clear --dry-run` | 仅预览，不修改任何数据 |
 | `opencode clear -y` | 跳过确认提示 |
 | `opencode clear --backup` | 删除前备份数据库 |
 | `opencode clear --db <path>` | 覆盖 opencode 数据库路径 |
+| `opencode clear -h` | 显示帮助（`-h` 不再表示 hours） |
 
-保留策略参数（`--days` / `--hours` / `--num`）三选一，互斥。
+保留策略参数（`--days` / `--num`）二选一，互斥。
 
 ## 选项
 
@@ -151,12 +154,12 @@ opm npm registry                         # 查看配置中的激活 registry
 opm npm registry set taobao              # 设置激活镜像为 taobao（写入 opm 配置）
 opm npm registry presets                 # 列出可用镜像预设
 opm npm search axios                     # 查询 axios 是否可用
-opm npm search axios 1.7.9               # 查询指定版本
+opm npm search axios@1.7.9               # 查询指定版本
 opm npm view axios                       # 查询全局与项目作用域安装信息
 opm npm info axios                       # 包详情
 opm npm versions axios                   # 所有版本
 opm npm install axios                    # 安装
-opm npm install axios 1.7.9             # 安装指定版本
+opm npm install axios@1.7.9             # 安装指定版本
 opm npm install -g typescript            # 全局安装
 opm npm uninstall axios                  # 卸载
 opm npm upgrade axios                    # 升级
@@ -173,7 +176,7 @@ opm pip view requests                    # 查询全局与项目作用域安装
 opm pip info requests                    # 包详情
 opm pip versions requests                # 所有版本
 opm pip install requests                 # 安装
-opm pip install requests 2.31.0          # 安装指定版本
+opm pip install requests@2.31.0          # 安装指定版本
 opm pip uninstall requests               # 卸载
 opm pip upgrade requests                 # 升级
 opm pip cache clean                      # 清理缓存
@@ -191,7 +194,7 @@ opm dnf view vim-enhanced                # 查询全局作用域安装信息（
 opm dnf info vim-enhanced                # 包详情
 opm dnf versions vim-enhanced            # 所有可用版本
 opm dnf install htop                     # 安装
-opm dnf install vim-enhanced 9.0         # 安装指定版本
+opm dnf install vim-enhanced@9.0         # 安装指定版本
 opm dnf uninstall htop                   # 卸载
 opm dnf upgrade htop                     # 升级
 opm dnf cache clean                      # 清理缓存
@@ -209,7 +212,7 @@ opm apt view curl                       # 查询全局作用域安装信息（
 opm apt info curl                       # 包详情
 opm apt versions curl                   # 所有可用版本
 opm apt install htop                    # 安装
-opm apt install curl 7.68.0-1ubuntu2.7  # 安装指定版本
+opm apt install curl@7.68.0-1ubuntu2.7  # 安装指定版本
 opm apt uninstall htop                  # 卸载
 opm apt upgrade htop                    # 升级
 opm apt cache clean                     # 清理缓存
@@ -227,7 +230,7 @@ opm brew view wget                     # 查询全局作用域安装信息（无
 opm brew info wget                     # 包详情
 opm brew versions wget                 # 所有可用版本
 opm brew install wget                  # 安装
-opm brew install python 3.12           # 安装指定版本（versioned formula）
+opm brew install python@3.12           # 安装指定版本（versioned formula）
 opm brew uninstall wget                # 卸载
 opm brew upgrade wget                  # 升级
 opm brew cache clean                   # 清理缓存
@@ -241,12 +244,12 @@ opm composer registry                   # 查看配置中的激活镜像
 opm composer registry set aliyun        # 设置为阿里云镜像
 opm composer registry presets           # 列出可用镜像预设
 opm composer search monolog/monolog     # 查询包是否可用
-opm composer search monolog/monolog 3.9.0  # 查询指定版本
+opm composer search monolog/monolog@3.9.0  # 查询指定版本
 opm composer view monolog/monolog       # 查询项目作用域安装信息（无全局作用域）
 opm composer info monolog/monolog       # 包详情
 opm composer versions monolog/monolog   # 所有可用版本
 opm composer install monolog/monolog    # 安装（composer require）
-opm composer install monolog/monolog ^3.0  # 安装指定版本约束
+opm composer install monolog/monolog@^3.0  # 安装指定版本约束
 opm composer uninstall monolog/monolog  # 卸载（composer remove）
 opm composer upgrade monolog/monolog    # 升级（composer update）
 opm composer cache clean                # 清理缓存
@@ -531,9 +534,9 @@ opm ping registry -d                   # 输出完整 JSON 数组
 ```bash
 opm env list                         # 列出 opm 管理的环境变量（含配置文件路径）
 opm env list --all                   # 追加 process.env 全量，每条标注 managed: true/false
-opm env get PATH                     # 根据 key 取值（先查 opm 管理源，回退 process.env）
-opm env set FOO bar                  # 设置环境变量（替换已存在的）
-opm env set MY_API_KEY secret123     # 设置 API 密钥
+opm env get -k PATH                  # 根据 key 取值（先查 opm 管理源，回退 process.env）
+opm env set -k FOO -v bar            # 设置环境变量（替换已存在的；仅命名参数）
+opm env set -k MY_API_KEY -v secret123  # 设置 API 密钥
 opm env search api                   # 按关键词匹配 key 或 value（忽略大小写）
 opm env search api --all             # 同时搜索 process.env
 opm env help                         # 通用介绍
@@ -544,10 +547,10 @@ opm env help                         # 通用介绍
 ```bash
 opm env list                         # 简化文本（按来源分组）
 opm env list --json                  # JSON 数组
-opm env get PATH                     # 简化：PATH = /usr/bin:/bin
-opm env get PATH --json              # JSON 对象（含 source/scope）
-opm env set FOO bar                  # 简化：FOO = bar
-opm env set FOO bar --json           # JSON 对象（含 written/source）
+opm env get -k PATH                  # 简化：PATH = /usr/bin:/bin
+opm env get -k PATH --json           # JSON 对象（含 source/scope）
+opm env set -k FOO -v bar            # 简化：FOO = bar
+opm env set -k FOO -v bar --json     # JSON 对象（含 written/source）
 opm env search api                   # 简化：匹配项按来源分组
 opm env search api --json            # JSON 数组
 ```

package/bin/index.js

@@ -2,6 +2,7 @@
 
 import fs from 'node:fs'
 import path from 'node:path'
+import { getUserConfigFile, mergeBuiltinConfig } from '../src/config.js'
 
 let dir = process.cwd()
 for (let i = 0; i < 10; i++) {
@@ -23,6 +24,13 @@ for (let i = 0; i < 10; i++) {
   dir = parent
 }
 
+// Lazy-init: if user config doesn't exist (postinstall skipped), create it now
+if (!fs.existsSync(getUserConfigFile())) {
+  if (mergeBuiltinConfig()) {
+    console.log(`opm: config initialized at ${getUserConfigFile()}`)
+  }
+}
+
 import { CLI } from '../src/cli/index.js'
 
 const cli = new CLI()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wwkit/opm",
-  "version": "1.0.18",
+  "version": "1.0.19",
   "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.23"
+    "@wwkit/shared": "1.0.25"
   },
   "devDependencies": {
     "jest": "^29.7.0"

package/src/binaries/base.js

@@ -277,16 +277,11 @@ async _dir() {
   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),
-      })),
-    })
+    output(list.map(({ version }) => ({
+      version,
+      current: version === active,
+      install: this._versionRoot(version),
+    })))
   }
 
   async _install(rest) {

package/src/cli/groups/env.js

@@ -3,8 +3,9 @@
  *
  * 用法：
  *   opm env list [--all]      列出 opm 管理的环境变量（含配置文件路径）；--all 追加 process.env 全量
- *   opm env get <key>         根据 key 取值（先查 opm 管理的配置源，回退 process.env）
- *   opm env set <key> <value> 设置值（替换已存在的）
+ *   opm env get -k <key>      根据 key 取值（先查 opm 管理的配置源，回退 process.env）
+ *   opm env set -k <key> -v <value>  设置值（替换已存在的；仅命名参数，不用位置参数）
+ *   opm env search <keyword>  按关键词搜索（key 或 value 包含，忽略大小写）
  *   opm env help              通用介绍
  *
  * 跨平台策略（复用 @wwkit/shared 的 Shell）：
@@ -320,9 +321,9 @@ export class EnvGroup {
    * @param {{ flags: object, positional: string[] }} parsed
    */
   async _get(parsed) {
-    const key = parsed.positional[0] || parsed.flags.k || parsed.flags.key || ''
+    const key = parsed.flags.k || parsed.flags.key || ''
     if (!key) {
-      console.error('Usage: opm env get <key>')
+      console.error('Usage: opm env get -k <key>')
       console.error('Missing required <key>')
       process.exit(1)
     }
@@ -349,11 +350,11 @@ export class EnvGroup {
    * @param {{ flags: object, positional: string[] }} parsed
    */
   async _set(parsed) {
-    const key = parsed.positional[0] || parsed.flags.k || parsed.flags.key || ''
-    const value = parsed.positional[1] ?? parsed.flags.v ?? parsed.flags.value ?? ''
+    const key = parsed.flags.k || parsed.flags.key || ''
+    const value = parsed.flags.v ?? parsed.flags.value ?? ''
 
     if (!key) {
-      console.error('Usage: opm env set <key> <value>')
+      console.error('Usage: opm env set -k <key> -v <value>')
       console.error('Missing required <key>')
       process.exit(1)
     }
@@ -361,8 +362,8 @@ export class EnvGroup {
       console.error(`Invalid env key: "${key}" (must start with letter/underscore, only letters/digits/underscore)`)
       process.exit(1)
     }
-    if (parsed.positional.length < 2 && !(parsed.flags.v || parsed.flags.value)) {
-      console.error('Usage: opm env set <key> <value>')
+    if (!(parsed.flags.v || parsed.flags.value)) {
+      console.error('Usage: opm env set -k <key> -v <value>')
       console.error('Missing required <value>')
       process.exit(1)
     }
@@ -411,8 +412,8 @@ Actions:
   list [--all]            List opm-managed env vars with their config file path
                           (default: only vars set via "opm env set";
                            --all appends all process.env vars, each tagged managed: true/false)
-  get <key>               Get value by key (checks opm-managed sources first, then process.env)
-  set <key> <value>       Set value, replacing any existing one
+  get -k <key>            Get value by key (checks opm-managed sources first, then process.env)
+  set -k <key> -v <value> Set value, replacing any existing one
                           (Unix: shell profile marker block; Windows: setx user-level registry)
   search <keyword> [--all]  Search env vars whose key or value contains keyword (case-insensitive)
                           (default: opm-managed vars; --all also searches process.env)
@@ -440,9 +441,9 @@ Platform behavior:
 Examples:
   opm env list
   opm env list --all              # all process.env vars, tagged managed
-  opm env get PATH
-  opm env set FOO bar
-  opm env set MY_API_KEY secret123
+  opm env get -k PATH
+  opm env set -k FOO -v bar
+  opm env set -k MY_API_KEY -v secret123
   opm env search api              # match key or value containing "api" (case-insensitive)
   opm env search api --all        # also search process.env
   opm env help

package/src/cli/groups/overlay.js

@@ -38,7 +38,7 @@ export class OverlayGroup {
 
     const dryRun = parsed.flags['dry-run'] === 'true'
 
-    const from = path.resolve(parsed.flags.f || parsed.flags.from || process.cwd())
+    const from = path.resolve(parsed.flags.from || process.cwd())
     if (!fs.existsSync(from) || !fs.statSync(from).isDirectory()) {
       output({ error: 'Source directory does not exist or is not a directory', from })
       process.exit(1)
@@ -56,7 +56,7 @@ export class OverlayGroup {
       process.exit(1)
     }
 
-    const to = parsed.flags.t || parsed.flags.to
+    const to = parsed.flags.to
     let globalRoot
     if (to) {
       globalRoot = path.resolve(to)
@@ -154,16 +154,16 @@ overwriting existing files. Useful for testing local changes without
 publishing.
 
 Options:
-  -f, --from <dir>    Source package directory (default: current directory)
-  -t, --to <dir>      Target node_modules directory (default: npm root -g)
+  --from <dir>        Source package directory (default: current directory)
+  --to <dir>          Target node_modules directory (default: npm root -g)
   --dry-run           Preview files to copy without writing
   -h, --help          Show this help
 
 Examples:
   opm overlay                            Overlay cwd package to global install
-  opm overlay -f /path/to/package         Overlay specific package
-  opm overlay -t /custom/node_modules     Overlay to custom target
-  opm overlay --dry-run                   Preview what would be copied
+  opm overlay --from /path/to/package    Overlay specific package
+  opm overlay --to /custom/node_modules  Overlay to custom target
+  opm overlay --dry-run                  Preview what would be copied
 `)
   }
 }

package/src/cli/groups/package.js

@@ -35,6 +35,27 @@ const MANAGERS = {
   python: () => new PythonManager(),
 }
 
+/**
+ * 解析业界惯例的 `<name>[@<version>]` 输入
+ * 统一对外格式：版本跟随包名用 @ 连接（npm/pip 等业界惯例）。
+ * 兼容 scoped 包（@babel/core@7.0.0 → name=@babel/core, version=7.0.0）。
+ * 若输入无 @（或 @ 在开头即 scoped 前缀），返回 name 与 fallbackVersion。
+ * @param {string|undefined} input
+ * @param {string} [fallbackVersion] - 旧式第二个位置参数（<name> <version>）兼容
+ * @returns {{ name: string, version: string }}
+ */
+export function parseNameVersion(input, fallbackVersion = '') {
+  if (!input) return { name: input || '', version: fallbackVersion || '' }
+  const idx = input.lastIndexOf('@')
+  if (idx > 0) {
+    const version = input.slice(idx + 1)
+    if (version) {
+      return { name: input.slice(0, idx), version }
+    }
+  }
+  return { name: input, version: fallbackVersion || '' }
+}
+
 const MANAGER_DESC = {
   npm: 'npm package manager',
   pip: 'pip package manager',
@@ -54,9 +75,10 @@ const ACTIONS = {
   installed:  { desc: 'Check if the manager itself is installed' },
   registry:   { desc: 'Query or set registry/mirror address' },
   search:     { desc: 'Check if a package is available in the source' },
-  view:       { desc: 'Check package in global and project scopes' },
+  view:       { desc: 'Check if a package is installed (global + project scopes)' },
   info:       { desc: 'Show package details' },
   versions:   { desc: 'List all available versions of a package' },
+  list:       { desc: 'List installed packages (default: project scope, -g for global)' },
   install:    { desc: 'Install a package' },
   uninstall:  { desc: 'Uninstall a package' },
   upgrade:    { desc: 'Upgrade a package' },
@@ -126,11 +148,13 @@ export class PackageGroup {
       case 'version': {
         const name = positional[0]
         if (name) {
+          // version 名副其实：只输出版本号（空串 = 该作用域未安装）；
+          // 完整安装状态见 view
           const result = await manager.scopedInstalled(name, { proxy: opts.proxy })
           output({
             name: result.name,
-            global: { installed: result.global.installed, ...(result.global.version ? { version: result.global.version } : {}) },
-            project: { installed: result.project.installed, ...(result.project.version ? { version: result.project.version } : {}) },
+            global: { version: result.global.installed ? (result.global.version || '') : '' },
+            project: { version: result.project.installed ? (result.project.version || '') : '' },
           })
         } else {
           const result = await manager.getVersion()
@@ -166,10 +190,9 @@ export class PackageGroup {
       }
 
       case 'search': {
-        const name = positional[0]
-        const version = positional[1]
+        const { name, version } = parseNameVersion(positional[0], positional[1])
         if (!name) {
-          console.error(`Usage: opm ${this.name} search <name> [version]`)
+          console.error(`Usage: opm ${this.name} search <name>[@<version>]`)
           process.exit(1)
         }
         await this._printEndpoint(manager, opts.proxy)
@@ -179,7 +202,7 @@ export class PackageGroup {
       }
 
       case 'view': {
-        const name = positional[0]
+        const { name } = parseNameVersion(positional[0])
         if (!name) {
           console.error(`Usage: opm ${this.name} view <name>`)
           process.exit(1)
@@ -190,7 +213,7 @@ export class PackageGroup {
       }
 
       case 'info': {
-        const name = positional[0]
+        const { name } = parseNameVersion(positional[0])
         if (!name) {
           console.error(`Usage: opm ${this.name} info <name>`)
           process.exit(1)
@@ -202,7 +225,7 @@ export class PackageGroup {
       }
 
       case 'versions': {
-        const name = positional[0]
+        const { name } = parseNameVersion(positional[0])
         if (!name) {
           console.error(`Usage: opm ${this.name} versions <name>`)
           process.exit(1)
@@ -213,11 +236,16 @@ export class PackageGroup {
         break
       }
 
+      case 'list': {
+        const result = await manager.listInstalled({ global: !!opts.global })
+        output(result)
+        break
+      }
+
       case 'install': {
-        const name = positional[0]
-        const version = positional[1]
+        const { name, version } = parseNameVersion(positional[0], positional[1])
         if (!name) {
-          console.error(`Usage: opm ${this.name} install <name> [version]`)
+          console.error(`Usage: opm ${this.name} install <name>[@<version>]`)
           process.exit(1)
         }
         await this._printEndpoint(manager, opts.proxy)
@@ -227,7 +255,7 @@ export class PackageGroup {
       }
 
       case 'uninstall': {
-        const name = positional[0]
+        const { name } = parseNameVersion(positional[0])
         if (!name) {
           console.error(`Usage: opm ${this.name} uninstall <name>`)
           process.exit(1)
@@ -238,7 +266,7 @@ export class PackageGroup {
       }
 
       case 'upgrade': {
-        const name = positional[0]
+        const { name } = parseNameVersion(positional[0])
         if (!name) {
           console.error(`Usage: opm ${this.name} upgrade <name>`)
           process.exit(1)
@@ -281,11 +309,12 @@ Actions:
   registry                   Show active registry (from opm config)
   registry set <url|preset>  Set active registry (writes opm config)
   registry presets           List available mirror presets
-  search <name> [version]    Check package availability in source
-  view <name>                Show package in global and project scopes
+  search <name>[@<version>]  Check package availability in source
+  view <name>                Check if a package is installed (global + project scopes)
   info <name>                Show package details
   versions <name>            List all available versions
-  install <name> [version]   Install a package
+  list [-g]                  List installed packages (default: project scope, -g for global)
+  install <name>[@<version>] Install a package
   uninstall <name>           Uninstall a package
   upgrade <name>             Upgrade a package to latest
   cache clean                Clean cache
@@ -301,11 +330,12 @@ Options:
 Examples:
   opm ${this.name} registry
   opm ${this.name} registry set <preset|url>
-  opm ${this.name} search <name>
+  opm ${this.name} search <name>[@<version>]
   opm ${this.name} view <name>
   opm ${this.name} info <name>
   opm ${this.name} versions <name>
-  opm ${this.name} install <name>
+  opm ${this.name} list
+  opm ${this.name} install <name>[@<version>]
   opm ${this.name} uninstall <name>
   opm ${this.name} upgrade <name>
   opm ${this.name} cache clean
@@ -381,7 +411,7 @@ export class RuntimeGroup extends PackageGroup {
       return
     }
 
-    const runtimeActions = new Set(['use', 'current', 'default', 'installed', 'dir', 'install', 'upgrade', 'search', 'versions', 'version', 'view', 'list'])
+    const runtimeActions = new Set(['use', 'current', 'default', 'installed', 'dir', 'install', 'upgrade', 'search', 'versions', 'version', 'view', 'list', 'info', 'cache'])
     if (runtimeActions.has(action)) {
       const manager = MANAGERS[this.name]()
       const parsed = parseFlags(rest)
@@ -510,6 +540,16 @@ export class RuntimeGroup extends PackageGroup {
         break
       }
 
+      case 'info': {
+        const result = await manager.packageInfo(this.name, { proxy: opts.proxy })
+        let current = ''
+        try {
+          current = (await manager.currentVersion()).current || ''
+        } catch {}
+        output({ name: this.name, ...result, current })
+        break
+      }
+
       default:
         return super._dispatch(manager, action, parsed, opts)
     }
@@ -541,6 +581,8 @@ Actions:
   use <version>             Switch to a ${label} version (${useHint})
   current                   Show current active ${label} version (${currentHint})
   default <version>         Set default ${label} version (${defaultHint})
+  info                      Show ${label} metadata and current version
+  cache clean               Clean ${label} cache (where the underlying tool supports it)
   dir                       Show ${label} install directory
   help                      Show this help