feat: 新增 archive.create/list 压缩文件命令

README.archive.md

@@ -1,27 +1,74 @@
 # archive - 压缩文件
 
-自动识别压缩格式并解压，不用记 `tar -xzf` / `tar -xjf` / `unzip` 的区别。
+创建、查看、解压压缩文件，不用记 `tar -czf` / `tar -xzf` / `unzip` 的区别。
 
 ## 命令
 
 | 命令 | 作用 |
 | --- | --- |
+| `kopsc archive create <路径> [选项]` | 创建压缩文件 |
+| `kopsc archive list <文件>` | 列出压缩文件内容（不解压） |
 | `kopsc archive extract <文件> [--dir 目录]` | 自动识别格式并解压 |
 
 别名：`kopsc archive unzip`、`kopsc archive untar`
 
 ## 支持的格式
 
-| 扩展名 | 解压方式 |
-| --- | --- |
-| `.tar.gz` / `.tgz` | Go 内置实现 |
-| `.tar.bz2` / `.tbz2` | 调用 `bzip2 -dc` + tar 解析 |
-| `.tar.xz` / `.txz` | 调用 `xz -dc` + tar 解析 |
-| `.tar` | Go 内置实现 |
-| `.zip` / `.jar` / `.war` | Go 内置实现 |
-| `.gz` | Go 内置 gzip 解压 |
+| 扩展名 | 创建 | 查看 | 解压 |
+| --- | --- | --- | --- |
+| `.tar.gz` / `.tgz` | ✓ | ✓ | ✓ |
+| `.tar` | ✓ | ✓ | ✓ |
+| `.zip` | ✓ | ✓ | ✓ |
+| `.tar.bz2` / `.tbz2` | - | - | ✓ |
+| `.tar.xz` / `.txz` | - | - | ✓ |
+| `.gz` | - | - | ✓ |
 
-## 示例
+## 创建压缩文件（archive.create）
+
+```bash
+# 压缩目录为 tar.gz（默认格式）
+kopsc archive create ./mydir
+
+# 压缩为 zip 格式
+kopsc archive create ./mydir --format zip
+
+# 指定输出文件名
+kopsc archive create ./mydir -o backup.tar.gz
+
+# 压缩单个文件
+kopsc archive create config.yaml
+```
+
+### 选项
+
+| 选项 | 默认值 | 说明 |
+| --- | --- | --- |
+| `--format` / `-f` | `tar.gz` | 压缩格式（`tar.gz` / `tgz` / `tar` / `zip`） |
+| `--output` / `-o` | `<目录名>.<格式>` | 输出文件名 |
+
+## 查看压缩文件内容（archive.list）
+
+```bash
+# 列出 tar.gz 内容
+kopsc archive list backup.tar.gz
+
+# 列出 zip 内容
+kopsc archive list app.zip
+```
+
+输出示例：
+
+```
+权限        大小       修改时间               名称
+------------------------------------------------------------
+d0755       0         2026-11-05 10:30:00  mydir/
+-0644       1234      2026-11-05 10:30:00  mydir/file1.txt
+-0755       5678      2026-11-05 10:30:00  mydir/script.sh
+------------------------------------------------------------
+共 3 项，总大小 6.9K
+```
+
+## 解压文件（archive.extract）
 
 ```bash
 # 解压到当前目录
@@ -34,7 +81,7 @@ kopsc archive extract backup.zip --dir /opt/backup
 kopsc archive extract data.tar.bz2
 ```
 
-## 选项
+### 选项
 
 | 选项 | 说明 |
 | --- | --- |