opm CLI 命令

用户配置

安装后自动生成 ~/.config/opm/config.json5（或 $XDG_CONFIG_HOME/opm/config.json5），用户可直接编辑：

• 合并读取：内置默认（src/config.json5）→ 用户文件 → OPM_CONFIG_CONTENT 环境变量注入层（最高优先级）；字符串中 {env:XXX} 占位符替换为环境变量
• proxy — 代理预设 + active（当前激活代理；默认空 = 不使用代理，可改为预设 key 或完整 URL。命令行 -p/--proxy 传入时优先使用传入值）
• npm / pip / dnf / apt / brew / composer / bun / nvm / node / phpenv / php / python / uv / docker / homebrew 的 registry — 镜像预设 + active（当前激活镜像）

active 可以是预设 key（如 "taobao"），也可以是完整 URL：

{
  npm: {
    registry: {
      official: "https://registry.npmjs.org/",
      taobao: "https://registry.npmmirror.com/",
      active: "taobao",   // 预设 key，或直接写 URL
    },
  },
}

• opm config 显示合并后的配置文件（不读系统配置；可用段名由配置动态生成，opm config <段> 可查看任意段）
• opm <manager> registry set <key|url> 更新配置文件中的 active
• install / upgrade 默认使用配置中的 active 镜像（npm 传 --registry，pip 传 --index-url；dnf/apt 通过 registry set 同步写入系统 repo 文件；brew 传 HOMEBREW_API_DOMAIN / HOMEBREW_BOTTLE_DOMAIN，不改系统配置；node 传 NVM_NODEJS_ORG_MIRROR；php 传 PHP_BUILD_MIRROR_URL；python 传 UV_PYTHON_INSTALL_MIRROR；bun 传 BUN_CONFIG_REGISTRY）

用法

# 开发阶段（项目内直接运行）
node bin <command> [args] [options]
node bin config [section]

# 全局安装后
opm <command> [args] [options]

# 从 monorepo 根目录
pnpm opm <command> [args] [options]

Commands

| Command | 说明 | |---------|------| | npm <action> | npm 包管理器 | | pip <action> | pip 包管理器 | | dnf <action> | dnf 包管理器（Fedora / RHEL / EulerOS 等 rpm 系） | | apt <action> | apt 包管理器（Debian / Ubuntu 等 dpkg 系） | | brew <action> | brew 包管理器（macOS / Homebrew） | | composer <action> | composer 包管理器（PHP） | | bun <action> | bun 包管理器（Bun runtime，npm 兼容源） | | winget <action> | winget 包管理器（Windows） | | nvm <action> | nvm 自身管理（安装/升级/卸载 nvm；list 列出已安装 Node.js 版本） | | node <action> | node 版本管理（基于 nvm 安装/切换/卸载 Node.js 版本） | | phpenv <action> | phpenv 自身管理（安装/升级/卸载 phpenv；list 列出已安装 PHP 版本） | | php <action> | php 版本管理（基于 phpenv 安装/切换/卸载 PHP 版本） | | uv <action> | uv 自身管理（安装/升级/卸载 uv；list 列出已安装 Python 版本） | | python <action> | python 版本管理（基于 uv 安装/切换/卸载 Python 版本） | | docker <action> | Docker 自身管理（安装/升级/启停/open，含 daemon 状态） | | homebrew <action> | Homebrew 自身管理（安装/升级/卸载 brew） | | wsl <action> | WSL2 管理（安装/升级/列表/启停/打开发行版） | | cft <action> | Chrome for Testing 安装器（chrome + chromedriver） | | git <action> | git 安装/配置/diff 导出导入 | | proc <action> | 进程与系统信息管理（列表/搜索/终止/端口/进程树） | | ftp <action> | FTP 文件管理（上传/rsync/下载） | | ensure <runtime> [version] | 确保运行时已安装（node/php/python） | | 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） |

Managers

| Manager | 说明 | |---------|------| | npm | npm 包管理器（registry 镜像，global/local 概念） | | pip | pip 包管理器（index-url 镜像，global 为系统 Python） | | dnf | dnf 包管理器（系统级，所有操作作用于系统，无全局/local 概念） | | apt | apt 包管理器（系统级，所有操作作用于系统，无全局/local 概念） | | brew | brew 包管理器（macOS，系统级，所有操作作用于系统，无全局/local 概念） | | composer | composer 包管理器（PHP，项目级，install/upgrade 作用于当前项目 composer.json） | | bun | bun 包管理器（Bun runtime，使用 npm 兼容 registry，global/local 概念） | | nvm | nvm 自身管理（安装/升级/卸载 nvm，git clone + shell profile） | | node | node 版本管理（基于 nvm，install/use/uninstall Node.js 版本，镜像 via NVM_NODEJS_ORG_MIRROR） | | phpenv | phpenv 自身管理（安装/升级/卸载 phpenv + php-build 插件，git clone + shell profile） | | php | php 版本管理（基于 phpenv，install/global 切换 PHP 版本，镜像 via PHP_BUILD_MIRROR_URL） | | uv | uv 自身管理（安装/升级/卸载 uv，curl 安装脚本走 uv.registry.active + uv self update） | | python | python 版本管理（基于 uv，install/pin/uninstall Python 版本，镜像 via UV_PYTHON_INSTALL_MIRROR） |

Actions

| Action | 说明 | |--------|------| | version [name] | 无 name 查看管理器本身版本；有 name 显示包在全局与项目作用域的版本号（仅包管理器；完整安装状态见 view） | | registry | 查询当前镜像地址 | | registry set <url\|preset> | 设置镜像地址（支持预设名） | | registry presets | 列出可用镜像预设 | | search <name>[@<version>] | 查询包在源是否可用 | | view <name> | 查询包是否已安装，已安装显示基本信息（包管理器：全局+项目双作用域；运行时：指定版本是否已安装） | | info <name> | 查询包详情 | | versions <name> | 列出所有可用版本 | | list [-g] | 列出已安装包（包管理器：项目作用域，-g 全局；运行时/工具组：已安装版本，数组输出） | | install <name>[@<version>] | 安装包（版本用 @ 连接，业界惯例） | | uninstall <name> | 卸载包 | | upgrade <name> | 升级包 | | cache clean | 清理缓存 |

Opencode 运维

| 命令 | 说明 | |------|------| | opencode version | 已安装版本 | | opencode installed | 检查是否已安装 | | opencode install | 安装（使用 opm npm 镜像 + proxy） | | opencode uninstall | 卸载 | | opencode upgrade | 升级（使用 opm npm 镜像 + proxy） | | opencode config | 显示配置文件内容 | | opencode dir | 显示 data/db/log/config 路径 | | opencode env | 显示环境变量（OPENCODE_CONFIG_DIR / CONTENT） | | opencode [-d <dir>] | 启动 TUI（默认 cwd），自动注入环境变量；可透传 args 给 opencode | | opencode clear | 清理过期会话并 VACUUM 压缩数据库（缺省 -d 1，只保留今天） | | 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 / --num）二选一，互斥。

选项

| 选项 | 说明 | |------|------| | -g, --global | 全局操作（npm: global node_modules; pip: system Python） | | -p, --proxy <url> | 代理地址（search/info/versions/install/upgrade）；未传时默认使用配置 proxy.active（为空则不启用代理） | | -h, --help | 显示帮助 |

所有命令默认以 JSON 格式输出。

示例

npm

opm npm registry                         # 查看配置中的激活 registry
opm npm registry set taobao              # 设置激活镜像为 taobao（写入 opm 配置）
opm npm registry presets                 # 列出可用镜像预设
opm npm search axios                     # 查询 axios 是否可用
opm npm search [email protected]               # 查询指定版本
opm npm view axios                       # 查询全局与项目作用域安装信息
opm npm info axios                       # 包详情
opm npm versions axios                   # 所有版本
opm npm install axios                    # 安装
opm npm install [email protected]             # 安装指定版本
opm npm install -g typescript            # 全局安装
opm npm uninstall axios                  # 卸载
opm npm upgrade axios                    # 升级
opm npm cache clean                      # 清理缓存

pip

opm pip registry                         # 查看当前 index-url
opm pip registry set tsinghua            # 设置为清华镜像
opm pip search requests                  # 查询 requests 是否可用
opm pip view requests                    # 查询全局与项目作用域安装信息
opm pip info requests                    # 包详情
opm pip versions requests                # 所有版本
opm pip install requests                 # 安装
opm pip install [email protected]          # 安装指定版本
opm pip uninstall requests               # 卸载
opm pip upgrade requests                 # 升级
opm pip cache clean                      # 清理缓存

dnf

opm dnf version                          # 查看 dnf 版本
opm dnf registry                         # 查看当前启用仓库
opm dnf registry set hce-updates         # 写入 opm.repo 指向 hce-updates 镜像
opm dnf registry presets                 # 列出可用镜像预设
opm dnf search vim-enhanced              # 查询包在源是否可用
opm dnf view vim-enhanced                # 查询全局作用域安装信息（无项目作用域）
opm dnf info vim-enhanced                # 包详情
opm dnf versions vim-enhanced            # 所有可用版本
opm dnf install htop                     # 安装
opm dnf install [email protected]         # 安装指定版本
opm dnf uninstall htop                   # 卸载
opm dnf upgrade htop                     # 升级
opm dnf cache clean                      # 清理缓存

apt

opm apt version                         # 查看 apt 版本
opm apt registry                        # 查看当前启用源
opm apt registry set ubuntu-tsinghua    # 写入 /etc/apt/sources.list.d/opm.list
opm apt registry presets                # 列出可用镜像预设
opm apt search curl                     # 查询包在源是否可用
opm apt view curl                       # 查询全局作用域安装信息（无项目作用域）
opm apt info curl                       # 包详情
opm apt versions curl                   # 所有可用版本
opm apt install htop                    # 安装
opm apt install [email protected]  # 安装指定版本
opm apt uninstall htop                  # 卸载
opm apt upgrade htop                    # 升级
opm apt cache clean                     # 清理缓存

brew

opm brew version                       # 查看 brew 版本
opm brew registry                      # 查看配置中的激活镜像
opm brew registry set tsinghua         # 设置为清华镜像（install/upgrade 传 HOMEBREW_*_DOMAIN）
opm brew registry presets              # 列出可用镜像预设
opm brew search wget                   # 查询 wget 是否可用
opm brew view wget                     # 查询全局作用域安装信息（无项目作用域）
opm brew info wget                     # 包详情
opm brew versions wget                 # 所有可用版本
opm brew install wget                  # 安装
opm brew install [email protected]           # 安装指定版本（versioned formula）
opm brew uninstall wget                # 卸载
opm brew upgrade wget                  # 升级
opm brew cache clean                   # 清理缓存

composer

opm composer version                    # 查看 composer 版本
opm composer registry                   # 查看配置中的激活镜像
opm composer registry set aliyun        # 设置为阿里云镜像
opm composer registry presets           # 列出可用镜像预设
opm composer search monolog/monolog     # 查询包是否可用
opm composer search monolog/[email protected]  # 查询指定版本
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 uninstall monolog/monolog  # 卸载（composer remove）
opm composer upgrade monolog/monolog    # 升级（composer update）
opm composer cache clean                # 清理缓存

bun

opm bun version                       # 查看 bun 版本
opm bun registry                      # 查看配置中的激活 registry
opm bun registry set taobao           # 设置为 taobao 镜像（传 BUN_CONFIG_REGISTRY）
opm bun search axios                  # 查询 axios 是否可用
opm bun view axios                    # 查询全局与项目作用域安装信息
opm bun info axios                    # 包详情
opm bun versions axios                # 所有可用版本
opm bun install axios                 # 安装（bun add）
opm bun uninstall axios               # 卸载（bun remove）
opm bun upgrade axios                 # 升级（bun update）
opm bun cache clean                   # 清理缓存（bun pm cache rm）

nvm

opm nvm version                       # 查看 nvm 版本
opm nvm registry set gitee            # 设置 nvm git 镜像为 gitee
opm nvm install                       # 安装 nvm（git clone + shell profile）
opm nvm upgrade                       # 更新 nvm（git pull）
opm nvm list                          # 列出已安装 Node.js 版本
opm nvm view                          # 检查 nvm 是否已安装
opm nvm uninstall                     # 卸载 nvm

node

opm node current                      # 当前 Node.js 版本
opm node version                      # 同上
opm node list                         # 已安装版本列表
opm node versions                     # 所有可用版本
opm node install 20                   # 安装 Node.js 20
opm node install --lts                # 安装最新 LTS
opm node use 20                       # 切换到 Node.js 20
opm node default 20                   # 设置默认版本
opm node search v20.20.2              # 查询版本是否可下载
opm node view v20.20.2                # 查询版本是否已安装
opm node uninstall 18                 # 卸载 Node.js 18
opm node upgrade                      # 安装最新 LTS

phpenv

opm phpenv version                    # 查看 phpenv 版本
opm phpenv registry set gitee         # 设置 phpenv git 镜像为 gitee
opm phpenv install                    # 安装 phpenv（git clone + php-build 插件 + shell profile）
opm phpenv upgrade                    # 更新 phpenv + php-build 插件
opm phpenv list                       # 列出已安装 PHP 版本
opm phpenv view                       # 检查 phpenv 是否已安装
opm phpenv uninstall                  # 卸载 phpenv

php

opm php current                       # 当前 PHP 版本
opm php list                          # 已安装版本列表
opm php versions                      # 所有可用版本
opm php install 8.3                   # 安装 PHP 8.3
opm php use 8.3                       # 切换全局版本（phpenv global）
opm php default 8.3                   # 设置默认版本
opm php search 8.3.13                 # 查询版本是否可下载
opm php view 8.3.13                   # 查询版本是否已安装
opm php uninstall 8.2                 # 卸载 PHP 8.2
opm php upgrade                       # 安装最新版本

uv

opm uv version                        # 查看 uv 版本
opm uv registry                       # 查询激活的安装脚本 URL
opm uv registry set <url|preset>      # 设置安装脚本 URL（写 uv.registry.active）
opm uv registry presets               # 列出可用镜像预设
opm uv install                        # 安装 uv（curl 执行 active 脚本 URL）
opm uv upgrade                        # 更新 uv（uv self update）
opm uv list                           # 列出已安装 Python 版本
opm uv view                           # 检查 uv 是否已安装
opm uv uninstall                      # 卸载 uv

docker

opm docker version                    # 查看 Docker 版本
opm docker registry                   # 查询激活的安装脚本 URL
opm docker registry set <url|preset>  # 设置安装脚本 URL（写 docker.registry.active）
opm docker install                    # 安装 Docker（Linux 用 active 便捷脚本）
opm docker status                     # 查看 daemon 状态
opm docker start / stop / restart     # 启停 daemon
opm docker dir                        # 查看数据目录
opm docker uninstall                  # 卸载 Docker

homebrew

opm homebrew version                  # 查看 Homebrew 版本
opm homebrew registry                 # 查询激活的安装脚本 URL
opm homebrew registry set <url|preset># 设置安装脚本 URL（写 homebrew.registry.active）
opm homebrew install                  # 安装 Homebrew（curl 执行 active 脚本 URL）
opm homebrew upgrade                  # 更新（brew update）
opm homebrew dir                      # 查看安装目录
opm homebrew uninstall                # 卸载 Homebrew

python

opm python current                    # 当前 Python 版本
opm python list                       # 已安装版本列表
opm python versions                   # 所有可用版本
opm python install 3.12               # 安装 Python 3.12
opm python use 3.12                   # 固定当前目录版本（uv python pin）
opm python default 3.12               # 设置默认版本（写 ~/.python-version）
opm python search 3.12.4              # 查询版本是否可下载
opm python view 3.12.4                # 查询版本是否已安装
opm python uninstall 3.11             # 卸载 Python 3.11
opm python upgrade                    # 安装最新版本

pip 与 python 互不干扰：opm pip 直接调用 pip CLI；opm python 通过 uv 管版本；如需更快的 pip 替代，可直用 uv pip。

git

opm git version                         # 查看已安装版本
opm git install                         # 安装 git（系统包管理器）
opm git upgrade                         # 升级 git
opm git init                            # 从 opm 配置初始化全局 git 配置
opm git config                           # 列出全局配置
opm git config pull.rebase true          # 设置配置项
opm git user                             # 查看用户信息
opm git export mark                      # 查看当前 diff 基准
opm git export mark 0                    # 标记当前 HEAD 为 diff 基准
opm git export mark 3af967b             # 标记指定 commit
opm git export mark --unset             # 删除基准
opm git export                           # 导出 diff（基准 -> HEAD）
opm git export -f 2                     # 导出 diff（HEAD~2 -> HEAD）
opm git import file.diff                # 导入 diff 文件

proc

opm proc info                            # 系统信息（OS/CPU/内存/磁盘）
opm proc list                            # Top 10 进程（按内存）
opm proc list -n 20 -b cpu              # Top 20 按 CPU 排序
opm proc search -n node                  # 搜索 node 进程
opm proc port                            # 所有监听端口
opm proc kill -i 1234                    # 终止 PID 1234
opm proc kill -p 8080 -f -y             # 强制终止 8080 端口进程
opm proc tree                            # 进程树
opm proc detail 1234                     # PID 1234 详情

wsl

opm wsl version                          # WSL 版本
opm wsl installed                        # 检查是否已安装
opm wsl install                          # 安装 WSL2
opm wsl install Ubuntu                   # 安装指定发行版
opm wsl list                             # 已安装发行版列表
opm wsl available                        # 可用发行版列表
opm wsl start Ubuntu                     # 启动发行版
opm wsl stop Ubuntu                      # 停止发行版
opm wsl open                             # 打开 WSL
opm wsl status                           # WSL 状态

docker

opm docker version                       # Docker 版本
opm docker install                       # 安装 Docker
opm docker upgrade                       # 升级 Docker
opm docker status                        # daemon 状态
opm docker start / stop / restart        # 启停 daemon
opm docker dir                           # 数据目录
opm docker uninstall                     # 卸载 Docker

homebrew

opm homebrew version                     # Homebrew 版本
opm homebrew install                     # 安装 Homebrew
opm homebrew upgrade                     # 更新（brew update）
opm homebrew dir                         # 安装目录
opm homebrew uninstall                   # 卸载 Homebrew

cft

opm cft version                          # 查看已安装版本
opm cft install                          # 安装 Chrome for Testing
opm cft status                           # 查看安装状态
opm cft clear                            # 清理安装文件
opm cft dir                              # 查看安装目录

ftp

opm ftp connect                          # 测试 FTP 连接
opm ftp upload ./img.png                 # 上传文件
opm ftp upload ./img.png -n cover -s banner  # 上传并重命名到子目录
opm ftp upload https://example.com/a.jpg -n cover.jpg  # 从 URL 上传
opm ftp rsync ./webwork/                 # 递归上传目录
opm ftp rsync ./webwork/ -s deploy -x "vendor/*"  # 排除模式
opm ftp rsync ./webwork/ --dry-run       # 预览
opm ftp rsync ./webwork/ --prune         # 删除远端多余文件
opm ftp download 20260913/cover.jpg ./cover.jpg  # 下载文件
opm ftp root                             # 远程根目录
opm ftp config                           # FTP 配置

ensure

opm ensure node                          # 确保 Node.js 已安装
opm ensure node 22                       # 确保 Node.js 22 已安装
opm ensure php 8.3                       # 确保 PHP 8.3 已安装
opm ensure python 3.12                   # 确保 Python 3.12 已安装

config

opm config                               # 查看合并后的用户配置（proxy + registries）
opm config proxy                         # 查看代理预设 + active（空 = 不使用代理）
opm config npm.registry                  # 查看 npm registry 预设 + active
opm config pip.registry                  # 查看 pip registry 预设 + active
opm config dnf.registry                  # 查看 dnf registry 预设 + active
opm config apt.registry                  # 查看 apt registry 预设 + active
opm config brew.registry                 # 查看 brew registry 预设 + active
opm config composer.registry             # 查看 composer registry 预设 + active
opm config bun.registry                  # 查看 bun registry 预设 + active
opm config nvm.registry                  # 查看 nvm registry 预设 + active
opm config node.registry                 # 查看 node registry 预设 + active
opm config phpenv.registry               # 查看 phpenv registry 预设 + active
opm config php.registry                  # 查看 php registry 预设 + active
opm config python.registry                 # 查看 python registry 预设 + active
opm config uv.registry                     # 查看 uv registry 预设 + active
opm config docker.registry                 # 查看 docker registry 预设 + active
opm config homebrew.registry               # 查看 homebrew registry 预设 + active

opm config [section] 的可用段名由合并配置动态生成（每个 top-level 段 + 含 registry 的 .registry 子段），opm config <未知段> 会列出全部可用段。

ping

opm ping 8.8.8.8                       # Ping 指定 IP（默认精简数组）
opm ping proxyhm-hk.security.huawei.com # Ping 指定主机
opm ping proxy                         # Ping 当前 active 代理的主机
opm ping registry                      # Ping 所有工具 registry active 主机（并行）
opm ping source                        # 打印示例系统命令（npm active registry）
opm ping 8.8.8.8 -c 2                  # 发送 2 个包
opm ping proxy -d                      # 输出完整 JSON
opm ping registry -d                   # 输出完整 JSON 数组

默认输出精简数组 [{tool, address, proxy, reachable}]；-d/--detail 输出完整 JSON（含 sent/received/loss/rtt/raw 等）。 opm ping proxy 从 proxy.active 解析代理 URL，提取主机名后 ping。 opm ping registry 遍历所有含 registry 配置的工具，并行 ping 各 active 地址的主机。

env

opm env list                         # 列出 opm 管理的环境变量（含配置文件路径）
opm env list --all                   # 追加 process.env 全量，每条标注 managed: true/false
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                         # 通用介绍

输出格式：默认输出简化文本（list/search 按来源分组：配置文件路径 行 + key = value 行；get/set 输出单行 key = value）；加 -j/--json 输出完整 JSON。

opm env list                         # 简化文本（按来源分组）
opm env list --json                  # JSON 数组
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 数组

list/search 默认只作用于 opm env set 管理的变量（Unix 的 # >>> wwkit NAME >>> 标记块 / Windows manifest）；--all 在其基础上追加 process.env 全量，并给每条标注 managed: true/false 与来源。 search <keyword> 匹配 key 或 value 是否包含关键词（忽略大小写），可用 -q/--query 替代位置参数。 跨平台：Unix 读写 shell profile（.zshrc/.bashrc/.profile/fish config），用 # >>> wwkit NAME >>> 标记块管理；Windows 用 setx 写 user 级注册表（HKCU\Environment），list 用 reg query 读取。 Windows 上 setx 不留标记，opm 通过 ~/.config/opm/env-managed.json 记录哪些 user 级变量由 opm 管理；set 始终写入 user 级（无需管理员权限）。

opencode

opm opencode version                   # 查看已安装版本
opm opencode installed                 # 检查是否已安装
opm opencode install                   # 安装 opencode
opm opencode upgrade                   # 升级到最新
opm opencode config                    # 显示配置文件内容
opm opencode dir                       # 查看数据/日志/DB路径
opm opencode env                       # 查看环境变量
opm opencode                           # 在当前目录启动 TUI
opm opencode -d /path/to/project       # 在指定目录启动 TUI
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                  # 跳过确认直接执行

harness

opm harness version                    # 查看已安装版本
opm harness installed                  # 检查是否已安装
opm harness install                    # 安装（使用 opm npm 镜像 + proxy）
opm harness upgrade                    # 升级到最新
opm harness dir                        # 查看安装路径 + skills/agents/commands 目录
opm harness list                       # 列出包提供的 skills/agents/commands
opm harness status                     # 健康检查（安装 + env + 内容完整性）
opm harness env                        # 查看环境变量（OPENCODE_CONFIG_DIR 等）

npm scripts

| 命令 | 说明 | |------|------| | npm run check | 语法检查（node --check bin/index.js） | | npm run test | 运行测试 | | npm run release | 发布（复用 @wwkit/shared 的单包发布） |