@wwkit/opm 1.0.18 → 1.0.20

package/src/cli/groups/ping.js

@@ -51,8 +51,8 @@ function isUrl(addr) {
 
 // HTTP 状态码 → 可达性判断：2xx/3xx 视为可达，allowlist 中的状态码
 // 虽非成功响应但证明服务器已响应（如 404 表示主机/代理存活，
-// 429 表示临时限流，服务器实际存活）
-const REACHABLE_ALLOWLIST = [404, 429]
+// 405 表示 git 仓库不允许 GET 但服务器存活，429 表示临时限流）
+const REACHABLE_ALLOWLIST = [404, 405, 429]
 
 function httpReachable(httpCode) {
   return (httpCode >= 200 && httpCode < 400) || REACHABLE_ALLOWLIST.includes(httpCode)
@@ -91,7 +91,9 @@ function checkByPing(host, count) {
 
     let child
     try {
-      child = spawn('ping', args, { stdio: ['pipe', 'pipe', 'pipe'], shell: true })
+      // 直接传 args（不经 shell 拼接）：ping.exe 为真实可执行文件，
+      // Windows 下 shell:true 会走 cmd.exe，存在参数被二次解析的风险
+      child = spawn('ping', args, { stdio: ['pipe', 'pipe', 'pipe'] })
     } catch {
       resolve({
         reachable: false, sent: count, received: 0, loss: count,
@@ -159,6 +161,47 @@ function checkByPing(host, count) {
   })
 }
 
+/**
+ * 解析 curl writeout 输出（-w '%{http_code} %{time_total}'）
+ *
+ * 兜底：writeout 输出缺失/被破坏（httpCode 0）时，退出码 0 仍代表成功收到
+ * HTTP 响应（curl 未加 -f，404/429 等也算正常完成），不应误判 FAIL。
+ * 修复背景：spawn 经 shell 拼接时，%{} 与空格被 shell/cmd 破坏导致 stdout
+ * 为空，镜像实际可达却全部报 HTTP 0。
+ *
+ * @param {string} stdout - curl stdout
+ * @param {number} code - curl 进程退出码
+ * @returns {{ httpCode: number, timeTotal: number, writeoutBroken: boolean, proxyAuthRequired: boolean, reachable: boolean, rttMs: string, raw: string }}
+ */
+function parseCurlWriteout(stdout, code) {
+  const parts = String(stdout || '').trim().split(/\s+/)
+  const httpCode = parseInt(parts[0], 10) || 0
+  const timeTotal = parseFloat(parts[1]) || 0
+  const writeoutBroken = httpCode === 0 && code === 0
+  const proxyAuthRequired = httpCode === 407
+  const reachable = writeoutBroken || httpReachable(httpCode)
+  const rttMs = reachable && timeTotal > 0 ? String(Math.round(timeTotal * 1000)) : ''
+  const raw = writeoutBroken
+    ? 'OK (curl exit 0; writeout unavailable)'
+    : `HTTP ${httpCode} (${timeTotal}s)`
+  return { httpCode, timeTotal, writeoutBroken, proxyAuthRequired, reachable, rttMs, raw }
+}
+
+/**
+ * 构造 curl 探活参数（导出：win32 命令行往返测试直接锁定同一份生产参数，
+ * 避免测试与真实 args 漂移；Windows 上含空白的参数由 libuv 双引号包裹，
+ * cmd 不参与，%{} 与空格原样到达 curl.exe）
+ * @param {string} url - 完整 URL（含协议）
+ * @param {string} [proxy] - 代理地址，设置时追加 -x <proxy>
+ * @returns {string[]}
+ */
+function buildCurlArgs(url, proxy) {
+  const args = ['-k', '-L', '-s', '-o', NULL_DEV, '-w', '%{http_code} %{time_total}', '--connect-timeout', '2', '--max-time', '5']
+  if (proxy) args.push('-x', proxy)
+  args.push(url)
+  return args
+}
+
 /**
  * 用 curl 检查 URL 可访问性（HTTP，跳过 SSL 校验，跟随跳转）
  * @param {string} url - 完整 URL
@@ -167,12 +210,13 @@ function checkByPing(host, count) {
  */
 function checkByCurl(url, proxy) {
   return new Promise((resolve) => {
-    const args = ['-k', '-L', '-s', '-o', NULL_DEV, '-w', '%{http_code} %{time_total}', '--connect-timeout', '2', '--max-time', '5']
-    if (proxy) args.push('-x', proxy)
-    args.push(url)
+    const args = buildCurlArgs(url, proxy)
     let child
     try {
-      child = spawn('curl', args, { stdio: ['pipe', 'pipe', 'pipe'], shell: true })
+      // 直接传 args（不经 shell 拼接）：-w 格式串含 %{} 与空格，
+      // shell 模式会按空白拆参并交由 cmd/sh 做变量展开，导致 stdout 无法解析
+      // （Windows cmd 下实测输出空 → HTTP 0 (0s)，镜像实际可达也被误判 FAIL）
+      child = spawn('curl', args, { stdio: ['pipe', 'pipe', 'pipe'] })
     } catch {
       resolve({
         reachable: false, sent: 1, received: 0, loss: 1,
@@ -185,23 +229,18 @@ function checkByCurl(url, proxy) {
     child.stdout.on('data', (d) => { stdout += d })
     child.stderr.on('data', (d) => { stderr += d })
     child.on('close', (code) => {
-      const parts = stdout.trim().split(/\s+/)
-      const httpCode = parseInt(parts[0], 10) || 0
-      const timeTotal = parseFloat(parts[1]) || 0
-      const proxyAuthRequired = httpCode === 407
-      const reachable = httpReachable(httpCode)
-      const rttMs = reachable ? String(Math.round(timeTotal * 1000)) : ''
+      const r = parseCurlWriteout(stdout, code)
       resolve({
-        reachable,
-        proxyAuthRequired,
+        reachable: r.reachable,
+        proxyAuthRequired: r.proxyAuthRequired,
         sent: 1,
-        received: reachable ? 1 : 0,
-        loss: reachable ? 0 : 1,
-        lossPercent: reachable ? 0 : 100,
-        rttMin: rttMs,
-        rttAvg: rttMs,
-        rttMax: rttMs,
-        raw: `HTTP ${httpCode} (${timeTotal}s)`,
+        received: r.reachable ? 1 : 0,
+        loss: r.reachable ? 0 : 1,
+        lossPercent: r.reachable ? 0 : 100,
+        rttMin: r.rttMs,
+        rttAvg: r.rttMs,
+        rttMax: r.rttMs,
+        raw: r.raw,
       })
     })
     child.on('error', () => {
@@ -228,7 +267,7 @@ function checkByWget(url, proxy) {
     args.push(url)
     let child
     try {
-      child = spawn('wget', args, { stdio: ['pipe', 'pipe', 'pipe'], shell: true })
+      child = spawn('wget', args, { stdio: ['pipe', 'pipe', 'pipe'] })
     } catch {
       resolve({
         reachable: false, sent: 1, received: 0, loss: 1,
@@ -302,7 +341,7 @@ async function checkReachability(address, tool, count, proxy) {
   return { reachable: false, sent: 0, received: 0, loss: 0, lossPercent: 0, rttMin: '', rttAvg: '', rttMax: '', raw: 'No tool available' }
 }
 
-export { checkReachability, extractHostPort, httpReachable }
+export { checkReachability, extractHostPort, httpReachable, parseCurlWriteout, buildCurlArgs }
 
 export class PingGroup {
   constructor() {
@@ -311,7 +350,7 @@ export class PingGroup {
   }
 
   async run(argv) {
-    const parsed = parseFlags(argv)
+    const parsed = parseFlags(argv, { booleans: ['detail'] })
     const [target] = parsed.positional
 
     if (!target || target === '-h' || target === '--help' || target === 'help') {
@@ -327,7 +366,7 @@ export class PingGroup {
 
     const count = parseInt(parsed.flags.c || parsed.flags.count || '4', 10)
     const n = (isNaN(count) || count < 1) ? 4 : count
-    const detail = !!(parsed.flags.d || parsed.flags.detail)
+    const detail = !!(parsed.flags.detail)
 
     let proxy = parsed.flags.proxy || parsed.flags.p || ''
     if (proxy === 'true') proxy = ''
@@ -342,7 +381,9 @@ export class PingGroup {
     }
 
     if (target === 'source') {
-      return this._pingSource()
+      console.error('[opm] Example check commands have moved into `opm ping help`.')
+      this.printHelp()
+      return
     }
 
     if (proxy) {
@@ -434,58 +475,6 @@ export class PingGroup {
     output(detail ? items : items.map(compact))
   }
 
-  async _pingSource() {
-    const url = getActiveRegistry('npm')
-    const activeProxy = getActiveProxy()
-    const tool = shell.getNetProbeTool()
-
-    if (!tool) {
-      console.error('[opm] No network check tool available (ping/curl/wget).')
-      return
-    }
-
-    const cleanProxy = activeProxy.replace(/^(https?:\/\/)[^@]*@/, '$1')
-    const authProxy = cleanProxy.replace(/^(https?:\/\/)/, '$1user:password@')
-
-    if (tool === 'curl') {
-      console.log(`# tool: ${tool}
-# Windows (PowerShell)
-curl.exe -k --max-time 10 ${url}
-curl.exe -k --max-time 10 --proxy ${cleanProxy} ${url}
-curl.exe -k --max-time 10 --proxy ${authProxy} ${url}
-
-# Linux / macOS
-curl -k --max-time 10 ${url}
-curl -k --max-time 10 --proxy ${cleanProxy} ${url}
-curl -k --max-time 10 --proxy ${authProxy} ${url}`)
-      return
-    }
-
-    if (tool === 'wget') {
-      console.log(`# tool: ${tool}
-# Windows (PowerShell)
-wget.exe -q --spider --timeout=10 ${url}
-wget.exe -q --spider --timeout=10 -e use_proxy=yes -e https_proxy=${cleanProxy} ${url}
-wget.exe -q --spider --timeout=10 -e use_proxy=yes -e https_proxy=${authProxy} ${url}
-
-# Linux / macOS
-wget -q --spider --timeout=10 ${url}
-wget -q --spider --timeout=10 -e use_proxy=yes -e https_proxy=${cleanProxy} ${url}
-wget -q --spider --timeout=10 -e use_proxy=yes -e https_proxy=${authProxy} ${url}`)
-      return
-    }
-
-    if (tool === 'ping') {
-      const { host } = extractHostPort(url)
-      console.log(`# tool: ${tool}
-# Windows
-ping -n 4 -w 10000 ${host}
-
-# Linux / macOS
-ping -c 4 -W 10 ${host}`)
-    }
-  }
-
   printHelp() {
     console.log(`
 Usage: opm ping <host|proxy|registry|source> [options]
@@ -494,13 +483,13 @@ Actions:
   ping <host>              Check a host, IP, or URL for accessibility
   ping proxy               Check the active proxy address (from config)
   ping registry            Check all tools' active registry addresses in parallel
-  ping source              Print example system commands (npm active registry)
+  ping source              Show this help (example system commands listed below)
 
 Options:
   -c, --count <n>          Number of packets to send (ping only; default: 4)
   -p, --proxy <url>        Proxy address for the check (overrides config proxy.active;
                            routes curl/wget requests through the proxy and pre-validates usability)
-  -d, --detail             Output full JSON details (default: compact [{tool, address, proxy, reachable}])
+  --detail                 Output full JSON details (default: compact [{tool, address, proxy, reachable}])
   -h, --help               Show this help
 
 Tool detection: curl > wget > ping (auto-detected)
@@ -514,11 +503,20 @@ Examples:
   opm ping https://mirrors.tools.huawei.com/npm/
   opm ping proxy
   opm ping registry
-  opm ping source
   opm ping 8.8.8.8 -c 2
-  opm ping proxy -d
-  opm ping registry -d
-  opm ping sample -d
+  opm ping proxy --detail
+  opm ping registry --detail
+  opm ping sample --detail
+
+Manual check commands (for reference; run manually in your shell):
+  # curl (npm active registry, proxy variants)
+  curl -k --max-time 10 https://registry.npmjs.org/
+  curl -k --max-time 10 --proxy http://proxy:port https://registry.npmjs.org/
+  curl -k --max-time 10 --proxy http://user:password@proxy:port https://registry.npmjs.org/
+  # wget
+  wget -q --spider --timeout=10 https://registry.npmjs.org/
+  # ping
+  ping -c 4 -W 10 registry.npmjs.org
 `)
   }
 }

package/src/cli/groups/proc.js

@@ -52,7 +52,7 @@ export class ProcGroup {
       return
     }
 
-    const parsed = parseFlags(rest)
+    const parsed = parseFlags(rest, { booleans: ['f', 'force', 'exact'] })
 
     switch (action) {
       case 'info':
@@ -91,8 +91,8 @@ export class ProcGroup {
   }
 
   async _search(parsed) {
-    const name = parsed.flags.n || parsed.flags.name || ''
-    const port = parsed.flags.p || parsed.flags.port || ''
+    const name = parsed.flags.name || ''
+    const port = parsed.flags.port || ''
     const exact = parsed.flags.exact === 'true'
 
     if (!name && !port) {
@@ -106,15 +106,15 @@ export class ProcGroup {
   }
 
   async _port(parsed) {
-    const port = parsed.flags.p || parsed.flags.port || ''
+    const port = parsed.flags.port || ''
     const result = await listPorts(port || undefined)
     output(result)
   }
 
   async _kill(parsed) {
     const id = parsed.flags.i || parsed.flags.id || ''
-    const port = parsed.flags.p || parsed.flags.port || ''
-    const name = parsed.flags.n || parsed.flags.name || ''
+    const port = parsed.flags.port || ''
+    const name = parsed.flags.name || ''
     const force = parsed.flags.f === 'true' || parsed.flags.force === 'true'
     const yes = parsed.flags.y === 'true' || parsed.flags.yes === 'true'
     const signal = force ? 'SIGKILL' : 'SIGTERM'
@@ -203,9 +203,9 @@ ${actionLines}
 
 Options:
   -n, --count <n>       Number of processes (list, default: 10)
-  -n, --name <name>     Process name pattern (search/kill, fuzzy by default)
+  --name <name>         Process name pattern (search/kill, fuzzy by default)
   -b, --by <mem|cpu>    Sort by memory or CPU (list, default: mem)
-  -p, --port <port>     Port number (search/kill/port)
+  --port <port>         Port number (search/kill/port)
   -i, --id <pid>        Process ID (kill)
   --exact               Exact match (search, default: fuzzy)
   -f, --force           Use SIGKILL instead of SIGTERM (kill)
@@ -216,14 +216,14 @@ Examples:
   opm proc info
   opm proc list
   opm proc list -n 20 -b cpu
-  opm proc search -n node
-  opm proc search -n node -p 3000
-  opm proc search -n node --exact
+  opm proc search --name node
+  opm proc search --name node --port 3000
+  opm proc search --name node --exact
   opm proc port
-  opm proc port -p 8080
+  opm proc port --port 8080
   opm proc kill -i 1234
-  opm proc kill -p 8080 -f -y
-  opm proc kill -n node -y
+  opm proc kill --port 8080 -f -y
+  opm proc kill --name node -y
   opm proc tree
   opm proc tree 1234
   opm proc detail 1234

package/src/cli/groups/version-manager.js

@@ -47,7 +47,7 @@ export class ToolManagerGroup {
   }
 
   async run(argv) {
-    const parsed = parseFlags(argv)
+    const parsed = parseFlags(argv, { booleans: ['force'] })
     const [action, ...rest] = parsed.positional
 
     if (!action || action === '-h' || action === '--help' || action === 'help') {
@@ -198,25 +198,21 @@ const out = execSync(this.cfg.versionCmd(), { encoding: 'utf8', shell: shell.she
   }
 
   /**
-   * 列出工具已安装的版本
+   * 列出工具已安装的版本（数组格式输出）
    * @returns {void}
    * @private
    */
   _list() {
-    if (!this.cfg.isInstalled()) {
-      output({ name: this.name, installed: false, hint: `Run \`opm ${this.name} install\` first` })
-      return
-    }
-    if (!this.cfg.listCmd) {
-      output({ name: this.name, count: 0, versions: [] })
+    if (!this.cfg.isInstalled() || !this.cfg.listCmd) {
+      output([])
       return
     }
     try {
       const out = execSync(this.cfg.listCmd(), { encoding: 'utf8', shell: shell.shellForExec(this.cfg.needsBash) })
       const versions = this.cfg.parseList ? this.cfg.parseList(out) : []
-      output({ name: this.name, count: versions.length, versions })
+      output(versions)
     } catch {
-      output({ name: this.name, count: 0, versions: [] })
+      output([])
     }
   }
 

package/src/cli/helpers/args.js

@@ -1,49 +1,7 @@
 /**
- * 共享命令行参数解析器
+ * opm 参数解析器 — 从 @wwkit/shared re-export
  *
- * 支持以下格式的参数：
- *   --flag value        长标志（空格分隔）
- *   --flag=value        长标志（等号形式）
- *   -f value           短标志（空格分隔）
- *   -f=value           短标志（等号形式）
- *   positional         位置参数（不以 - 开头）
- *
- * @param {string[]} argv - 原始参数数组
- * @returns {{ flags: Record<string, string>, positional: string[] }}
+ * parseFlags 已提升到 @wwkit/shared（packages/shared/src/args.js），
+ * 此文件保留 re-export 以维持 opm 内部 import 路径不变（向后兼容）。
  */
-export function parseFlags(argv) {
-  const flags = {}
-  const positional = []
-
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i]
-
-    if (arg.startsWith('--') && arg.includes('=')) {
-      const idx = arg.indexOf('=')
-      flags[arg.slice(2, idx)] = arg.slice(idx + 1)
-    } else if (arg.startsWith('--')) {
-      const next = argv[i + 1]
-      if (next !== undefined && !next.startsWith('-')) {
-        flags[arg.slice(2)] = next
-        i++
-      } else {
-        flags[arg.slice(2)] = 'true'
-      }
-    } else if (arg.startsWith('-') && arg.includes('=')) {
-      const idx = arg.indexOf('=')
-      flags[arg.slice(1, idx)] = arg.slice(idx + 1)
-    } else if (arg.startsWith('-') && arg.length > 1) {
-      const next = argv[i + 1]
-      if (next !== undefined && !next.startsWith('-')) {
-        flags[arg.slice(1)] = next
-        i++
-      } else {
-        flags[arg.slice(1)] = 'true'
-      }
-    } else {
-      positional.push(arg)
-    }
-  }
-
-  return { flags, positional }
-}
+export { parseFlags, DEFAULT_BOOLEAN_FLAGS } from '@wwkit/shared'

package/src/cli/index.js

@@ -70,6 +70,18 @@ const GROUPS = {
   env: new EnvGroup(),
 }
 
+// share 快捷命令：s<action> → share <action>（前缀 s，业界惯例同 git gco/kubectl kgp）
+const SHARE_SHORTCUTS = {
+  supload: 'upload',
+  szip: 'zip',
+  sget: 'get',
+  sunzip: 'unzip',
+  ssync: 'sync',
+  sopen: 'open',
+  scopy: 'copy',
+  spaste: 'paste',
+}
+
 class CLI {
   async run(argv) {
     const [groupName, ...rest] = argv
@@ -101,6 +113,12 @@ if (groupName === 'version' || groupName === '-v' || groupName === '--version')
       return
     }
 
+    // share 快捷命令 → share 组对应 action
+    const shortcutAction = SHARE_SHORTCUTS[groupName]
+    if (shortcutAction) {
+      return GROUPS.share.run([shortcutAction, ...rest])
+    }
+
     const group = GROUPS[groupName]
     if (!group) {
       console.error(`Unknown command: ${groupName}`)
@@ -126,13 +144,16 @@ Usage: opm <command> [args] [options]
 
 Commands:
 ${groupLines}
+  supload/szip/sget                Share shortcuts: upload / zip / get
+  sunzip/ssync/sopen               Share shortcuts: unzip / sync / open
+  scopy/spaste                     Share shortcuts: copy / paste (clipboard)
   version                   Show opm version
   upgrade                   Upgrade opm itself (npm install -g @wwkit/opm@latest)
   doc                       Build docs HTML and open in browser
 
 Options:
-  -g, --global    Global operation (npm: global node_modules; pip: system Python)
-  -p, --proxy <url>  Proxy address (search/info/versions/install/upgrade)
+  -g, --global    Global operation (package managers only: npm global node_modules; pip system Python)
+  -p, --proxy <url>  Proxy address (network commands: search/info/versions/install/upgrade)
   -h, --help      Show help
 
 Run "opm <command> help" for command details.
@@ -143,6 +164,7 @@ Examples:
   opm config                           Show common config (proxy + registries)
   opm opencode clear                   Clean up opencode sessions before today
   opm opencode clear --days 7          Keep sessions from the last 7 days
+  opm opencode clear --days 0.5        Keep sessions from the last 12 hours
 `)
   }
 }

package/src/harnesses/base.js

@@ -211,7 +211,8 @@ export class HarnessGroup {
 
   async _clear(rest) {
     const parsed = parseFlags(rest)
-    if (parsed.flags.help === 'true') {
+    // -h 统一表示 help（各 harness clear 实现不再占用 -h 作为业务参数）
+    if (parsed.flags.help === 'true' || parsed.flags.h === 'true') {
       this.printHelp()
       return
     }

package/src/harnesses/opencode/clear.js

@@ -9,10 +9,10 @@
  *   5. 删除过期会话（event_sequence + session）并 VACUUM
  *   6. 清空日志、报告清理结果
  *
- * 保留策略参数（三选一，缺省 -d 1 即只保留今天）：
- *   -d/--days <n>   保留最近 n 天（对齐本地零点，含今天）
- *   -h/--hours <n>  保留最近 n 小时（滚动窗口）
- *   -n/--num <n>    保留最近 n 个会话（按 time_created 倒序取最新 n 个）
+ * 保留策略参数（二选一，互斥；缺省 --days 1 即只保留今天）：
+ *   --days <n>   保留最近 n 天（整数对齐本地零点含今天；小数 = 小时级滚动窗口，如 0.5 = 12 小时）
+ *   -n, --keep <n>  保留最近 n 个会话（按 time_created 倒序取最新 n 个）
+ *   -h/--help       显示帮助
  */
 
 import fs from 'node:fs'
@@ -35,15 +35,19 @@ export function startOfDayLocal(ts) {
 }
 
 /**
- * 解析 -d/--days | -h/--hours | -n/--num 的计数参数
+ * 解析 --days | -n/--keep 的计数参数
  * @param {string|undefined} value
- * @param {string} name - 参数名（days/hours/num），用于报错提示
- * @returns {number|null} 未提供返回 null，否则返回正整数
+ * @param {string} name - 参数名（days/keep），用于报错提示
+ * @param {{ allowFraction?: boolean }} [opts] - allowFraction=true 时接受正小数（days 支持小时级）
+ * @returns {number|null} 未提供返回 null，否则返回正数
  */
-export function parseCount(value, name) {
+export function parseCount(value, name, { allowFraction = false } = {}) {
   if (value === undefined) return null
   const n = Number(value)
-  if (!Number.isInteger(n) || n < 1) {
+  if (!Number.isFinite(n) || n <= 0) {
+    throw new Error(`invalid --${name} value: "${value}" (expect ${allowFraction ? 'a positive number' : 'a positive integer'})`)
+  }
+  if (!allowFraction && !Number.isInteger(n)) {
     throw new Error(`invalid --${name} value: "${value}" (expect a positive integer)`)
   }
   return n
@@ -51,18 +55,18 @@ export function parseCount(value, name) {
 
 /**
  * 计算时间清理边界（毫秒）
- * days: 最近 n 天，对齐本地零点（含今天），边界 = 今天零点 - (n-1) 天
- * hours: 最近 n 小时，滚动窗口，边界 = now - n 小时
- * @param {{ days?: number|null, hours?: number|null }} opts
+ * days: 整数 = 最近 n 天，对齐本地零点（含今天），边界 = 今天零点 - (n-1) 天；
+ *       小数 = 小时级滚动窗口，边界 = now - n*24h（如 0.5 = 最近 12 小时）
+ * @param {{ days?: number|null }} opts
  * @returns {number}
  */
-export function computeBoundary({ days = null, hours = null } = {}) {
+export function computeBoundary({ days = null } = {}) {
   const now = Date.now()
   if (days !== null) {
-    return startOfDayLocal(now) - (days - 1) * 86400000
-  }
-  if (hours !== null) {
-    return now - hours * 3600000
+    if (Number.isInteger(days)) {
+      return startOfDayLocal(now) - (days - 1) * 86400000
+    }
+    return now - days * 86400000
   }
   return startOfDayLocal(now)
 }
@@ -148,17 +152,16 @@ export async function runClear(argv) {
   const backup = flags.backup === 'true'
   const dbPath = flags.db || getDbPath()
 
-  const days = parseCount(flags.days ?? flags.d, 'days')
-  const hours = parseCount(flags.hours ?? flags.h, 'hours')
-  const num = parseCount(flags.num ?? flags.n, 'num')
+  const days = parseCount(flags.days, 'days', { allowFraction: true })
+  const num = parseCount(flags.keep ?? flags.num ?? flags.n, 'keep')
 
-  const given = ['days', 'hours', 'num'].filter((k) => ({ days, hours, num })[k] !== null)
+  const given = ['days', 'keep'].filter((k) => ({ days, keep: num })[k] !== null)
   if (given.length > 1) {
-    throw new Error('--days / --hours / --num are mutually exclusive')
+    throw new Error('--days / --keep are mutually exclusive')
   }
 
   const mode = given[0] || 'days'
-  const count = mode === 'days' ? (days ?? 1) : mode === 'hours' ? hours : num
+  const count = mode === 'days' ? (days ?? 1) : num
 
   if (!fs.existsSync(dbPath)) {
     throw new Error(`opencode database not found: ${dbPath}`)
@@ -170,15 +173,15 @@ export async function runClear(argv) {
     let scopeDesc
     let boundary = null
 
-    if (mode === 'num') {
+    if (mode === 'keep') {
       const all = driver.listSessionsAsc()
       const keep = Math.min(count, all.length)
       rows = all.slice(0, all.length - keep)
       scopeDesc = `仅保留最新 ${keep} 个会话`
     } else {
-      boundary = computeBoundary({ days, hours })
+      boundary = computeBoundary({ days })
       rows = driver.listBefore(boundary)
-      scopeDesc = `删除 ${mode === 'days' ? `最近 ${count} 天` : `最近 ${count} 小时`}（${formatLocal(boundary)}）之前的会话`
+      scopeDesc = `删除最近 ${count} 天（${formatLocal(boundary)}）之前的会话`
     }
 
     console.log(`==> DB: ${dbPath}`)

package/src/harnesses/opencode/index.js

@@ -93,8 +93,7 @@ export const opencodeHarness = {
   getLogPath,
   clear: runClear,
   clearOptions: [
-    ['-d, --days <n>', 'Keep sessions from the last n days (default 1)'],
-    ['-h, --hours <n>', 'Keep sessions from the last n hours'],
+    ['-d, --days <n>', 'Keep sessions from the last n days (default 1); integer = aligned to local midnight, fraction = hour window (0.5 = 12h)'],
     ['-n, --num <n>', 'Keep the most recent n sessions'],
     ['--dry-run', 'Preview only, do not modify anything'],
     ['-y, --yes', 'Skip the confirmation prompt'],

package/src/managers/apt.js

@@ -349,6 +349,22 @@ export class AptManager 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'], { allowNonZero: true })
+    const items = []
+    // 行格式: name/arch  version  status
+    for (const line of out.split('\n')) {
+      const m = line.trim().match(/^(\S+?)\/\S+\s+(\S+)\s+\S*installed/)
+      if (m) items.push({ name: m[1], version: m[2] })
+    }
+    return items
+  }
+
   /**
    * 查询 apt 安装路径和包目录
    * @returns {{ name: string, install: string, listsDir: string, sourcesList: string, sourcesDir: string }}