feat: 新增 pkg.install/remove/search/info 包管理命令

2026-11-03 22:05:00 +08:00
parent d05096e29a
commit 0e89ed3248
5 changed files with 572 additions and 56 deletions
@@ -2,13 +2,28 @@

 > 返回 [README.md](README.md)

-刷新系统包管理器的软件源索引，或列出已安装的软件包。
+管理软件包：列出、搜索、安装、卸载、刷新索引。

 ```bash
 kopsc pkg list              # 列出已安装的软件包
-kopsc pkg refreshindex      # 刷新包管理器索引（dnf/apt/apk/brew/winget，按平台自动选）
+kopsc pkg search nginx      # 搜索软件包
+kopsc pkg install nginx     # 安装软件包
+kopsc pkg remove nginx      # 卸载软件包
+kopsc pkg info nginx        # 查看软件包详情
+kopsc pkg refreshindex      # 刷新包管理器索引
 ```

+## 命令一览
+
+| 命令 | 作用 |
+| --- | --- |
+| `kopsc pkg list` | 列出已安装的软件包 |
+| `kopsc pkg search <关键字>` | 搜索软件包 |
+| `kopsc pkg install <包名>` | 安装软件包（需 `--yes`） |
+| `kopsc pkg remove <包名>` | 卸载软件包（需 `--yes`） |
+| `kopsc pkg info <包名>` | 查看软件包详情 |
+| `kopsc pkg refreshindex` | 刷新包管理器索引 |
+
 ## 列出已安装的软件包（pkg.list）

 ```bash
@@ -25,6 +40,75 @@ kopsc pkg list
 | macOS | `brew list` |
 | Windows | `winget list` |

+## 搜索软件包（pkg.search）
+
+```bash
+kopsc pkg search nginx
+kopsc pkg search redis
+```
+
+在软件源中搜索匹配关键字的软件包。
+
+| 平台 | 实际执行 |
+| --- | --- |
+| Linux（Debian/Ubuntu） | `apt-cache search` |
+| Linux（CentOS/RHEL/Fedora） | `dnf search` |
+| Linux（Alpine） | `apk search` |
+| macOS | `brew search` |
+| Windows | `winget search` |
+
+## 安装软件包（pkg.install）
+
+```bash
+kopsc pkg install nginx              # 预览将执行的操作
+kopsc pkg install nginx --yes        # 确认安装
+kopsc pkg install nginx redis -y     # 安装多个包
+```
+
+安装指定的软件包。这是破坏性命令，需要 `--yes` 确认。
+
+| 平台 | 实际执行 |
+| --- | --- |
+| Linux（Debian/Ubuntu） | `apt-get install` |
+| Linux（CentOS/RHEL/Fedora） | `dnf install` |
+| Linux（Alpine） | `apk add` |
+| macOS | `brew install` |
+| Windows | `winget install` |
+
+## 卸载软件包（pkg.remove）
+
+```bash
+kopsc pkg remove nginx              # 预览将执行的操作
+kopsc pkg remove nginx --yes        # 确认卸载
+```
+
+卸载指定的软件包。这是破坏性命令，需要 `--yes` 确认。
+
+| 平台 | 实际执行 |
+| --- | --- |
+| Linux（Debian/Ubuntu） | `apt-get remove` |
+| Linux（CentOS/RHEL/Fedora） | `dnf remove` |
+| Linux（Alpine） | `apk del` |
+| macOS | `brew uninstall` |
+| Windows | `winget uninstall` |
+
+## 查看软件包详情（pkg.info）
+
+```bash
+kopsc pkg info nginx
+kopsc pkg info python3
+```
+
+显示指定软件包的详细信息（版本、描述、依赖等）。
+
+| 平台 | 实际执行 |
+| --- | --- |
+| Linux（Debian/Ubuntu） | `apt show`（回退 `dpkg -s`） |
+| Linux（CentOS/RHEL/Fedora） | `rpm -qi` |
+| Linux（Alpine） | `apk info -a` |
+| macOS | `brew info` |
+| Windows | `winget show` |
+
 ## 刷新软件源索引（pkg.refreshindex）

 `kopsc pkg refreshindex` 刷新本机包管理器的软件源索引，**只更新索引，不升级也不安装任何软件包**。