@wwkit/opm 1.0.1

package/docs/managers/composer.md

@@ -0,0 +1,96 @@
+# composer 命令对照表
+
+`@wwkit/opm` 统一命令与 Composer（PHP）原始命令的映射关系。
+
+## 命令对照
+
+| 统一命令 | 原始命令 | 说明 |
+|---------|---------|------|
+| `opm composer version` | `composer --version` | 查看 composer 本身版本 |
+| `opm composer registry` | 读 `~/.config/opm/config.json5` 的 `composer.registry.active` | 查询配置中的激活镜像（不读系统配置） |
+| `opm composer registry set <url\|preset>` | 写 `~/.config/opm/config.json5` 的 `composer.registry.active` | 设置激活镜像（支持预设名；镜像作用于 search/info/versions 的 P2 元数据拉取） |
+| `opm composer registry presets` | — | 列出可用镜像预设 |
+| `opm composer search <name>` | `{registry}/p2/{name}.json` | 查询包在源是否可用（返回最新版本 + 版本列表） |
+| `opm composer search <name> <version>` | `{registry}/p2/{name}.json` | 查询指定版本是否可用 |
+| `opm composer view <name>` | 读 `vendor/composer/installed.json` | 查询包是否已安装（项目本地） |
+| `opm composer info <name>` | `{registry}/p2/{name}.json` | 查询包详情（描述/作者/主页/许可证等） |
+| `opm composer versions <name>` | `{registry}/p2/{name}.json` | 列出所有可用版本 |
+| `opm composer list` | 读 `vendor/composer/installed.json` | 列出所有已安装包 |
+| `opm composer outdated` | `composer outdated --format=json` | 列出过期包 |
+| `opm composer install <name>` | `composer require <name> --no-interaction` | 安装包 |
+| `opm composer install <name> <version>` | `composer require <name>:<version> --no-interaction` | 安装指定版本约束 |
+| `opm composer uninstall <name>` | `composer remove <name> --no-interaction` | 卸载包 |
+| `opm composer upgrade <name>` | `composer update <name> --no-interaction` | 升级包 |
+| `opm composer cache clean` | `composer clear-cache` | 清理缓存 |
+| `opm composer help` | — | 显示 composer 命令清单 |
+
+## 镜像预设
+
+| 预设名 | 地址 |
+|--------|------|
+| `official` | `https://repo.packagist.org` |
+| `aliyun` | `https://mirrors.aliyun.com/composer` |
+| `tencent` | `https://mirrors.cloud.tencent.com/composer` |
+
+> 镜像作用于 search/info/versions 的 Packagist P2 元数据拉取（`{base}/p2/{vendor}/{package}.json`）。
+> install/upgrade 使用 composer CLI 自身的仓库配置（项目 composer.json / 全局 config）。
+
+## 选项
+
+| 选项 | 说明 |
+|------|------|
+| `-h, --help` | 显示帮助 |
+
+> 所有命令默认以 JSON 格式输出。
+
+## 示例
+
+```bash
+# 查看 composer 版本
+opm composer version
+
+# 查询当前镜像
+opm composer registry
+
+# 切换到阿里云镜像
+opm composer registry set aliyun
+
+# 查询 monolog/monolog 是否在源中可用
+opm composer search monolog/monolog
+
+# 查询 monolog/monolog:3.9.0 是否可用
+opm composer search monolog/monolog 3.9.0
+
+# 查看 monolog/monolog 是否已安装
+opm composer view monolog/monolog
+
+# 查看 monolog/monolog 详情
+opm composer info monolog/monolog
+
+# 列出 monolog/monolog 所有可用版本
+opm composer versions monolog/monolog
+
+# 列出所有已安装包
+opm composer list
+
+# 列出过期包
+opm composer outdated
+
+# 安装 monolog/monolog
+opm composer install monolog/monolog
+
+# 安装指定版本约束
+opm composer install monolog/monolog ^3.0
+
+# 卸载 monolog/monolog
+opm composer uninstall monolog/monolog
+
+# 升级 monolog/monolog
+opm composer upgrade monolog/monolog
+
+# 清理缓存
+opm composer cache clean
+
+# 显示帮助
+opm composer help
+```

package/docs/managers/config.md

@@ -0,0 +1,32 @@
+# config 命令对照
+
+`@wwkit/opm` 统一命令查看合并后的用户配置。
+
+## 命令对照
+
+| 统一命令 | 说明 |
+|---------|------|
+| `opm config` | 显示合并后的完整配置（内置默认 → 用户 `~/.config/opm/config.json5` → `OPM_CONFIG_CONTENT`） |
+| `opm config proxy` | 查看代理预设 + `active`（空 = 不使用代理） |
+| `opm config <section>` | 查看任意段（如 `npm` / `npm.registry` / `composer` / `composer.registry`） |
+| `opm config <未知段>` | 报错并列出全部可用段名 |
+
+> 可用段名由合并配置动态生成：每个 top-level 段 + 含 `registry` 的 `.registry` 子段。新增配置段无需改动代码。
+
+## 配置合并顺序（低 → 高）
+
+1. 内置默认 `src/config.json5`
+2. 用户文件 `~/.config/opm/config.json5`（或 `$XDG_CONFIG_HOME/opm/config.json5`）
+3. `OPM_CONFIG_CONTENT` 环境变量注入层
+
+字符串中的 `{env:XXX}` 占位符会在读取时替换为环境变量。
+
+## 示例
+
+```bash
+opm config
+opm config proxy
+opm config npm.registry
+opm config node.registry
+opm config python.registry
+```

package/docs/managers/dnf.md

@@ -0,0 +1,46 @@
+# dnf 命令对照表
+
+`@wwkit/opm` 统一命令管理 dnf 包（Fedora / RHEL / EulerOS 等 rpm 系，系统级）。
+
+## 命令对照
+
+| 统一命令 | 原始命令 | 说明 |
+|---------|---------|------|
+| `opm dnf version` | `dnf --version` | 查看 dnf 版本 |
+| `opm dnf registry` | 读 `/etc/yum.repos.d/opm.repo` | 查询当前启用仓库 |
+| `opm dnf registry set <url\|preset>` | 写 `/etc/yum.repos.d/opm.repo` + `dnf clean` | 设置镜像仓库 |
+| `opm dnf registry presets` | — | 列出可用镜像预设 |
+| `opm dnf search <name>` | `dnf search` | 查询包在源是否可用 |
+| `opm dnf view <name>` | `dnf list installed` | 查询包是否已安装 |
+| `opm dnf info <name>` | `dnf info` | 包详情 |
+| `opm dnf versions <name>` | `dnf list --showduplicates` | 所有可用版本 |
+| `opm dnf list` | `dnf list installed` | 已安装包列表 |
+| `opm dnf outdated` | `dnf check-update` | 过期包 |
+| `opm dnf install <name>` | `dnf install` | 安装 |
+| `opm dnf uninstall <name>` | `dnf remove` | 卸载 |
+| `opm dnf upgrade <name>` | `dnf upgrade` | 升级 |
+| `opm dnf cache clean` | `dnf clean all` | 清理缓存 |
+
+## 镜像预设
+
+| 预设名 | 地址 |
+|--------|------|
+| `hce` | `http://his-mirrors.huawei.com/install/hce/2.0/os/x86_64/` |
+| `hce-updates` | `http://his-mirrors.huawei.com/install/hce/2.0/updates/x86_64/` |
+| `fedora` | `https://download.fedoraproject.org/pub/fedora/linux/releases/$releasever/Everything/$basearch/os/` |
+| `fedora-updates` | `https://download.fedoraproject.org/pub/fedora/linux/updates/$releasever/Everything/$basearch/` |
+| `epel` | `https://dl.fedoraproject.org/pub/epel/$releasever/Everything/$basearch/` |
+| `epel-testing` | `https://dl.fedoraproject.org/pub/epel/testing/$releasever/Everything/$basearch/` |
+
+## 示例
+
+```bash
+opm dnf version
+opm dnf registry set hce-updates
+opm dnf search vim-enhanced
+opm dnf info vim-enhanced
+opm dnf install htop
+opm dnf uninstall htop
+opm dnf upgrade htop
+opm dnf cache clean
+```

package/docs/managers/node.md

@@ -0,0 +1,49 @@
+# node 命令对照表
+
+`@wwkit/opm` 统一命令通过 nvm 管理 Node.js 版本。
+
+## 命令对照
+
+| 统一命令 | 原始命令 | 说明 |
+|---------|---------|------|
+| `opm node version` | `nvm current` | 当前激活的 Node.js 版本 |
+| `opm node registry` | 读 `~/.config/opm/config.json5` 的 `node.registry.active` | 查询 Node.js dist 镜像 |
+| `opm node registry set <url\|preset>` | 写 `~/.config/opm/config.json5` | 设置 Node.js dist 镜像（传给 `NVM_NODEJS_ORG_MIRROR`） |
+| `opm node registry presets` | — | 列出可用镜像预设 |
+| `opm node search <version>` | `nvm ls-remote` 过滤 | 查询版本是否可下载 |
+| `opm node view <version>` | `nvm ls` 过滤 | 查询版本是否已安装 |
+| `opm node versions` | `nvm ls-remote` | 列出所有可用版本 |
+| `opm node list` | `nvm ls` | 列出已安装版本 |
+| `opm node install <version>` | `nvm install <version>` | 安装 Node.js 版本 |
+| `opm node uninstall <version>` | `nvm uninstall <version>` | 卸载 Node.js 版本 |
+| `opm node upgrade` | `nvm install --lts` | 安装最新 LTS |
+| `opm node use <version>` | `nvm use <version>` | 切换当前版本 |
+| `opm node current` | `nvm current` | 显示当前版本 |
+| `opm node default <version>` | `nvm alias default <version>` | 设置默认版本 |
+
+## 镜像预设
+
+| 预设名 | 地址 |
+|--------|------|
+| `official` | `https://nodejs.org/dist` |
+| `taobao` | `https://npmmirror.com/mirrors/node` |
+| `tsinghua` | `https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/` |
+
+> 镜像通过 `NVM_NODEJS_ORG_MIRROR` 环境变量传递给 nvm install。
+
+## 示例
+
+```bash
+opm node current
+opm node version
+opm node list
+opm node versions
+opm node install 20
+opm node install --lts
+opm node use 20
+opm node default 20
+opm node search v20.20.2
+opm node view v20.20.2
+opm node uninstall 18
+opm node upgrade
+```

package/docs/managers/npm.md

@@ -0,0 +1,100 @@
+# npm 命令对照表
+
+`@wwkit/opm` 统一命令与 npm 原始命令的映射关系。
+
+## 命令对照
+
+| 统一命令 | 原始命令 | 说明 |
+|---------|---------|------|
+| `opm npm version` | `npm --version` | 查看 npm 本身版本 |
+| `opm npm registry` | 读 `~/.config/opm/config.json5` 的 `npm.registry.active` | 查询配置中的激活镜像（不读系统配置） |
+| `opm npm registry set <url\|preset>` | 写 `~/.config/opm/config.json5` 的 `npm.registry.active` | 设置激活镜像（支持预设名，install/upgrade 自动带 `--registry`） |
+| `opm npm registry presets` | — | 列出可用镜像预设 |
+| `opm npm search <name>` | `npm view <name>` | 查询包在源是否可用（返回最新版本 + 版本列表） |
+| `opm npm search <name> <version>` | `npm view <name>@<version>` | 查询指定版本是否可用 |
+| `opm npm view <name>` | `npm list <name>` / 读 `node_modules/<name>/package.json` | 查询包是否已安装 |
+| `opm npm info <name>` | `npm view <name>` | 查询包详情（描述/作者/主页/许可证等） |
+| `opm npm versions <name>` | `npm view <name> versions` | 列出所有可用版本 |
+| `opm npm list` | `npm list --depth=0` | 列出所有已安装包 |
+| `opm npm outdated` | `npm outdated` | 列出过期包 |
+| `opm npm install <name>` | `npm install <name>` | 安装包 |
+| `opm npm install <name> <version>` | `npm install <name>@<version>` | 安装指定版本 |
+| `opm npm install -g <name>` | `npm install -g <name>` | 全局安装 |
+| `opm npm uninstall <name>` | `npm uninstall <name>` | 卸载包 |
+| `opm npm uninstall -g <name>` | `npm uninstall -g <name>` | 全局卸载 |
+| `opm npm upgrade <name>` | `npm install <name>@latest` | 升级包到最新版本 |
+| `opm npm upgrade -g <name>` | `npm install -g <name>@latest` | 全局升级 |
+| `opm npm cache clean` | `npm cache clean --force` | 清理缓存 |
+| `opm npm help` | — | 显示 npm 命令清单 |
+
+## 镜像预设
+
+| 预设名 | 地址 |
+|--------|------|
+| `official` | `https://registry.npmjs.org/` |
+| `taobao` | `https://registry.npmmirror.com/` |
+| `huawei` | `https://cmc.centralrepo.rnd.huawei.com/artifactory/api/npm/npm-central-repo/` |
+
+## 选项
+
+| 选项 | 说明 |
+|------|------|
+| `-g, --global` | 全局操作（仅 install/uninstall/upgrade） |
+| `-h, --help` | 显示帮助 |
+
+> 所有命令默认以 JSON 格式输出。
+
+## 示例
+
+```bash
+# 查看 npm 版本
+opm npm version
+
+# 查询当前镜像
+opm npm registry
+
+# 切换到淘宝镜像
+opm npm registry set taobao
+
+# 查询 axios 是否在源中可用
+opm npm search axios
+
+# 查询 axios@1.7.9 是否可用
+opm npm search axios 1.7.9
+
+# 查看 axios 是否已安装
+opm npm view axios
+
+# 查看 axios 详情
+opm npm info axios
+
+# 列出 axios 所有版本
+opm npm versions axios
+
+# 列出所有已安装包
+opm npm list
+
+# 列出过期包
+opm npm outdated
+
+# 安装 axios
+opm npm install axios
+
+# 安装 axios@1.7.9
+opm npm install axios 1.7.9
+
+# 全局安装 typescript
+opm npm install -g typescript
+
+# 卸载 axios
+opm npm uninstall axios
+
+# 升级 axios
+opm npm upgrade axios
+
+# 清理缓存
+opm npm cache clean
+
+# 显示帮助
+opm npm help
+```

package/docs/managers/nvm.md

@@ -0,0 +1,34 @@
+# nvm 命令对照表
+
+`@wwkit/opm` 统一命令管理 nvm 自身（安装/升级/卸载）。
+
+## 命令对照
+
+| 统一命令 | 原始命令 | 说明 |
+|---------|---------|------|
+| `opm nvm version` | `nvm --version` | 查看 nvm 版本 |
+| `opm nvm registry` | 读 `~/.config/opm/config.json5` 的 `nvm.registry.active` | 查询 nvm git 镜像 |
+| `opm nvm registry set <url\|preset>` | 写 `~/.config/opm/config.json5` | 设置 nvm git 镜像 |
+| `opm nvm registry presets` | — | 列出可用镜像预设 |
+| `opm nvm install` | `git clone <mirror> ~/.nvm` + 写 shell profile | 安装 nvm |
+| `opm nvm upgrade` | `cd ~/.nvm && git pull --tags` | 更新 nvm |
+| `opm nvm uninstall` | `rm -rf ~/.nvm` | 卸载 nvm |
+| `opm nvm dir` | 返回 `~/.nvm` 安装目录 |
+
+## 镜像预设
+
+| 预设名 | 地址 |
+|--------|------|
+| `official` | `https://github.com/nvm-sh/nvm.git` |
+| `gitee` | `https://gitee.com/mirrors/nvm.git` |
+
+## 示例
+
+```bash
+opm nvm version
+opm nvm registry set gitee
+opm nvm install
+opm nvm upgrade
+opm nvm dir
+opm nvm uninstall
+```

package/docs/managers/php.md

@@ -0,0 +1,48 @@
+# php 命令对照表
+
+`@wwkit/opm` 统一命令通过 phpenv 管理 PHP 版本。
+
+## 命令对照
+
+| 统一命令 | 原始命令 | 说明 |
+|---------|---------|------|
+| `opm php version` | `phpenv version` | 当前激活的 PHP 版本 |
+| `opm php registry` | 读 `~/.config/opm/config.json5` 的 `php.registry.active` | 查询 PHP dist 镜像 |
+| `opm php registry set <url\|preset>` | 写 `~/.config/opm/config.json5` | 设置 PHP dist 镜像（传给 `PHP_BUILD_MIRROR_URL`） |
+| `opm php registry presets` | — | 列出可用镜像预设 |
+| `opm php search <version>` | `phpenv install --list` 过滤 | 查询版本是否可下载 |
+| `opm php view <version>` | `phpenv versions` 过滤 | 查询版本是否已安装 |
+| `opm php versions` | `phpenv install --list` | 列出所有可用版本 |
+| `opm php list` | `phpenv versions` | 列出已安装版本 |
+| `opm php install <version>` | `phpenv install <version>` | 安装 PHP 版本 |
+| `opm php uninstall <version>` | `phpenv uninstall <version>` | 卸载 PHP 版本 |
+| `opm php upgrade` | `phpenv install <latest>` | 安装最新版本 |
+| `opm php use <version>` | `phpenv global <version>` | 切换当前版本 |
+| `opm php current` | `phpenv version` | 显示当前版本 |
+| `opm php default <version>` | `phpenv global <version>` | 设置默认版本 |
+
+## 镜像预设
+
+| 预设名 | 地址 |
+|--------|------|
+| `official` | `https://www.php.net/distributions` |
+| `tsinghua` | `https://mirrors.tuna.tsinghua.edu.cn/php` |
+| `ustc` | `https://mirrors.ustc.edu.cn/php` |
+
+> 镜像通过 `PHP_BUILD_MIRROR_URL` 环境变量传递给 php-build。
+
+## 示例
+
+```bash
+opm php current
+opm php version
+opm php list
+opm php versions
+opm php install 8.3
+opm php use 8.3
+opm php default 8.3
+opm php search 8.3.13
+opm php view 8.3.13
+opm php uninstall 8.2
+opm php upgrade
+```

package/docs/managers/phpenv.md

@@ -0,0 +1,34 @@
+# phpenv 命令对照表
+
+`@wwkit/opm` 统一命令管理 phpenv 自身（安装/升级/卸载）。
+
+## 命令对照
+
+| 统一命令 | 原始命令 | 说明 |
+|---------|---------|------|
+| `opm phpenv version` | `phpenv --version` | 查看 phpenv 版本 |
+| `opm phpenv registry` | 读 `~/.config/opm/config.json5` 的 `phpenv.registry.active` | 查询 phpenv git 镜像 |
+| `opm phpenv registry set <url\|preset>` | 写 `~/.config/opm/config.json5` | 设置 phpenv git 镜像 |
+| `opm phpenv registry presets` | — | 列出可用镜像预设 |
+| `opm phpenv install` | `git clone <mirror> ~/.phpenv` + `git clone php-build` + 写 shell profile | 安装 phpenv + php-build 插件 |
+| `opm phpenv upgrade` | `cd ~/.phpenv && git pull` + `cd plugins/php-build && git pull` | 更新 phpenv + php-build |
+| `opm phpenv uninstall` | `rm -rf ~/.phpenv` | 卸载 phpenv |
+| `opm phpenv dir` | 返回 `~/.phpenv` 安装目录 |
+
+## 镜像预设
+
+| 预设名 | 地址 |
+|--------|------|
+| `official` | `https://github.com/phpenv/phpenv.git` |
+| `gitee` | `https://gitee.com/mirrors/phpenv.git` |
+
+## 示例
+
+```bash
+opm phpenv version
+opm phpenv registry set gitee
+opm phpenv install
+opm phpenv upgrade
+opm phpenv dir
+opm phpenv uninstall
+```

package/docs/managers/pip.md

@@ -0,0 +1,98 @@
+# pip 命令对照表
+
+`@wwkit/opm` 统一命令与 pip 原始命令的映射关系。
+
+## 命令对照
+
+| 统一命令 | 原始命令 | 说明 |
+|---------|---------|------|
+| `opm pip version` | `pip --version` | 查看 pip 本身版本 |
+| `opm pip registry` | 读 `~/.config/opm/config.json5` 的 `pip.registry.active` | 查询配置中的激活镜像（不读系统配置） |
+| `opm pip registry set <url\|preset>` | 写 `~/.config/opm/config.json5` 的 `pip.registry.active` | 设置激活镜像（支持预设名，install/upgrade 自动带 `--index-url`） |
+| `opm pip registry presets` | — | 列出可用镜像预设 |
+| `opm pip search <name>` | PyPI JSON API / simple index | 查询包在源是否可用（返回最新版本 + 版本列表） |
+| `opm pip search <name> <version>` | PyPI JSON API / simple index | 查询指定版本是否可用 |
+| `opm pip view <name>` | `pip show <name>` | 查询包是否已安装 |
+| `opm pip info <name>` | PyPI JSON API / `pip show <name>` | 查询包详情（描述/作者/主页/许可证等） |
+| `opm pip versions <name>` | PyPI JSON API / simple index | 列出所有可用版本 |
+| `opm pip list` | `pip list --format=freeze` | 列出所有已安装包 |
+| `opm pip outdated` | `pip list --outdated` | 列出过期包 |
+| `opm pip install <name>` | `pip install <name>` | 安装包 |
+| `opm pip install <name> <version>` | `pip install <name>==<version>` | 安装指定版本 |
+| `opm pip uninstall <name>` | `pip uninstall -y <name>` | 卸载包 |
+| `opm pip upgrade <name>` | `pip install --upgrade <name>` | 升级包到最新版本 |
+| `opm pip cache clean` | `pip cache purge` | 清理缓存 |
+| `opm pip help` | — | 显示 pip 命令清单 |
+
+## 镜像预设
+
+| 预设名 | 地址 |
+|--------|------|
+| `official` | `https://pypi.org/simple` |
+| `tsinghua` | `https://pypi.tuna.tsinghua.edu.cn/simple` |
+| `huawei` | `https://cmc.centralrepo.rnd.huawei.com/artifactory/api/pypi/pypi-repo/simple` |
+
+## 选项
+
+| 选项 | 说明 |
+|------|------|
+| `-h, --help` | 显示帮助 |
+
+> 所有命令默认以 JSON 格式输出。
+
+## 示例
+
+```bash
+# 查看 pip 版本
+opm pip version
+
+# 查询当前镜像
+opm pip registry
+
+# 切换到清华镜像
+opm pip registry set tsinghua
+
+# 查询 requests 是否在源中可用
+opm pip search requests
+
+# 查询 requests==2.31.0 是否可用
+opm pip search requests 2.31.0
+
+# 查看 requests 是否已安装
+opm pip view requests
+
+# 查看 requests 详情
+opm pip info requests
+
+# 列出 requests 所有版本
+opm pip versions requests
+
+# 列出所有已安装包
+opm pip list
+
+# 列出过期包
+opm pip outdated
+
+# 安装 requests
+opm pip install requests
+
+# 安装 requests==2.31.0
+opm pip install requests 2.31.0
+
+# 卸载 requests
+opm pip uninstall requests
+
+# 升级 requests
+opm pip upgrade requests
+
+# 清理缓存
+opm pip cache clean
+
+# 显示帮助
+opm pip help
+```
+
+## 技术说明
+
+- **源查询**：优先使用 PyPI JSON API（`/pypi/<name>/json`），当镜像不支持 JSON API 时自动回退到 simple index HTML 解析
+- **版本排序**：simple index 方式提取的版本使用内置版本比较算法排序，自动排除 dev/rc/alpha/beta 等预发布版本作为 latest

package/docs/managers/python.md

@@ -0,0 +1,53 @@
+# python 命令对照表
+
+`@wwkit/opm` 统一命令通过 uv 管理 Python 版本。
+
+## 命令对照
+
+| 统一命令 | 原始命令 | 说明 |
+|---------|---------|------|
+| `opm python version` | `python3 --version` | 当前 Python 版本 |
+| `opm python registry` | 读 `~/.config/opm/config.json5` 的 `python.registry.active` | 查询 Python dist 镜像 |
+| `opm python registry set <url\|preset>` | 写 `~/.config/opm/config.json5` | 设置 Python dist 镜像（传给 `UV_PYTHON_INSTALL_MIRROR`） |
+| `opm python registry presets` | — | 列出可用镜像预设 |
+| `opm python search <version>` | `uv python list` 过滤 | 查询版本是否可下载 |
+| `opm python view <version>` | `uv python list --only-installed` 过滤 | 查询版本是否已安装 |
+| `opm python versions` | `uv python list` | 列出所有可用版本 |
+| `opm python list` | `uv python list --only-installed` | 列出已安装版本 |
+| `opm python install <version>` | `uv python install <version>` | 安装 Python 版本 |
+| `opm python uninstall <version>` | `uv python uninstall <version>` | 卸载 Python 版本 |
+| `opm python upgrade` | `uv python install <latest>` | 安装最新版本 |
+| `opm python use <version>` | `uv python pin <version>` | 固定当前目录 Python 版本 |
+| `opm python current` | `python3 --version` | 显示当前版本 |
+| `opm python default <version>` | 写 `~/.python-version` | 设置全局默认版本 |
+
+## 镜像预设
+
+| 预设名 | 地址 |
+|--------|------|
+| `official` | `https://github.com/astral-sh/python-build-standalone/releases/download` |
+| `ghproxy` | `https://ghproxy.com/https://github.com/astral-sh/python-build-standalone/releases/download` |
+
+> 镜像通过 `UV_PYTHON_INSTALL_MIRROR` 环境变量传递给 uv。
+
+## 与 pip 的关系
+
+- `opm pip` 保持独立，直接调用 pip CLI（不受 uv 影响）
+- 如需使用 `uv pip`（更快的 pip 替代），请直接调用 `uv pip install/list/...`
+- 两者可共存，互不干扰
+
+## 示例
+
+```bash
+opm python current
+opm python version
+opm python list
+opm python versions
+opm python install 3.12
+opm python use 3.12
+opm python default 3.12
+opm python search 3.12.4
+opm python view 3.12.4
+opm python uninstall 3.11
+opm python upgrade
+```

package/docs/managers/uv.md

@@ -0,0 +1,27 @@
+# uv 命令对照表
+
+`@wwkit/opm` 统一命令管理 uv 自身（安装/升级/卸载）。
+
+uv 是 Astral 出品的快速 Python 包/版本管理器（Rust 实现），替代 pyenv + pip。
+
+## 命令对照
+
+| 统一命令 | 原始命令 | 说明 |
+|---------|---------|------|
+| `opm uv version` | `uv --version` | 查看 uv 版本 |
+| `opm uv install` | `curl -LsSf https://astral.sh/uv/install.sh \| sh` | 安装 uv |
+| `opm uv upgrade` | `uv self update` | 更新 uv |
+| `opm uv uninstall` | `rm ~/.local/bin/uv` + `rm -rf ~/.local/share/uv` | 卸载 uv |
+| `opm uv dir` | 返回 uv 安装目录 |
+
+> uv 无镜像源，故无 registry action。
+
+## 示例
+
+```bash
+opm uv version
+opm uv install
+opm uv upgrade
+opm uv dir
+opm uv uninstall
+```