From 53bc354a63466021bf99d27504dd3b20f333f194 Mon Sep 17 00:00:00 2001
From: Lystran <49083828+LystranG@users.noreply.github.com>
Date: Sat, 17 Jan 2026 21:36:46 +0800
Subject: [PATCH] doc: add 7z commands (#1018)

* doc: add 7zip

* doc: update docs/7zip.md
---
 README.md    |   1 +
 docs/7zip.md | 183 +++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 184 insertions(+)
 create mode 100644 docs/7zip.md

diff --git a/README.md b/README.md
index 96597a7c..6a195a13 100644
--- a/README.md
+++ b/README.md
@@ -286,6 +286,7 @@ Quick Reference
 [Tmux](./docs/tmux.md)<!--rehype:style=background:rgb(99 99 99);-->
 [Taskset](./docs/taskset.md)<!--rehype:style=background:rgb(99 99 99);-->
 [tar](./docs/tar.md)<!--rehype:style=background:rgb(215 89 62);&class=tag&data-lang=解压缩-->
+[7zip](./docs/7zip.md)<!--rehype:style=background:rgb(99 99 99);&class=tag&data-lang=解压缩-->
 [Yazi](./docs/yazi.md)<!--rehype:style=background:rgb(255 165 0);&class=tag&data-lang=文件管理器;&class=contributing-->
 [Zip](./docs/zip.md)<!--rehype:style=background:rgb(99 99 99);&class=tag&data-lang=解压缩-->
 <!--rehype:class=home-card-->
diff --git a/docs/7zip.md b/docs/7zip.md
new file mode 100644
index 00000000..3bf2aa2a
--- /dev/null
+++ b/docs/7zip.md
@@ -0,0 +1,183 @@
+7zip 备忘清单
+====
+
+7z（7-Zip / p7zip）命令用于创建、更新、查看与解压压缩包，常见格式包括 `7z`、`zip`、`tar` 等。
+
+入门
+----
+
+### 7z 用法
+
+```shell
+$ 7z <命令> [<开关>..] <压缩包名称> [<文件名>..]
+```
+<!--rehype:className=wrap-text-->
+
+常见命令：
+
+- `a` 添加文件到压缩包（创建/追加）
+- `x` 解压（保留完整路径）
+- `e` 解压（不保留目录结构）
+- `l` 列出压缩包内容
+- `t` 测试压缩包完整性
+
+安装：
+
+```shell
+# Debian/Ubuntu
+$ sudo apt install p7zip-full
+
+# RHEL/CentOS/Fedora
+$ sudo yum install p7zip p7zip-plugins
+
+# macOS (Homebrew)
+$ brew install sevenzip
+```
+
+### 命令
+<!--rehype:wrap-class=col-span-2-->
+
+参数 | 描述 | 参数 | 描述
+:--- | :--- | :--- | :---
+`a` | **add：** 添加/创建压缩包 | `x` | **extract：** 解压（保留完整路径）
+`e` | **extract：** 解压（不保留目录名） | `l` | **list：** 列出压缩包内容
+`t` | **test：** 测试压缩包完整性 | `h` | **hash：** 计算文件哈希
+`u` | **update：** 更新压缩包内文件 | `d` | **delete：** 从压缩包中删除文件
+`rn` | **rename：** 重命名压缩包内文件 | `i` | **info：** 查看支持的格式信息
+`b` | **benchmark：** 性能测试 | &nbsp; | &nbsp;
+
+### 语法形式和选项
+
+:- | :-
+:- | :-
+**基本语法** | `7z <命令> [开关...] 压缩包 [文件...]`
+**创建 7z 压缩包** | `7z a -t7z archive.7z 文件/目录...`
+**创建 zip 压缩包** | `7z a -tzip archive.zip 文件/目录...`
+**解压（保留路径）** | `7z x archive.7z -o输出目录`
+**解压（不保留目录）** | `7z e archive.7z -o输出目录`
+**列出内容** | `7z l archive.7z`
+**测试完整性** | `7z t archive.7z`
+**计算哈希** | `7z h -scrcSHA256 文件...`
+**创建分卷压缩包** | `7z a archive.7z 大文件.iso -v1g`
+<!--rehype:className=style-list-arrow-->
+
+### 常用开关示例
+<!--rehype:wrap-class=col-span-2 row-span-1-->
+
+参数 | 描述 | 参数 | 描述
+:--- | :--- | :--- | :---
+`--` | 停止解析后续参数为开关 | `-t{Type}` | 指定压缩格式（如 `-t7z` / `-tzip`），默认为`7z`
+`-o{目录}` | 指定输出目录（解压） | `-p{密码}` | 设置密码
+`-r[-\|0]` | 递归子目录（`-r` / `-r-` / `-r0`） | `-mx[N]` | 压缩等级：`-mx0`（不压缩） `-mx1`（最快）… `-mx9`（最强）
+`-mmt[N]` | 线程数（如 `-mmt4`） | `-y` | 所有询问默认回答 Yes
+`-ao{a\|s\|t\|u}` | 覆盖策略：a 全覆盖 / s 跳过 / t 仅覆盖旧文件 / u 自动重命名 | &nbsp; | &nbsp;
+`-v{Size}[b\|k\|m\|g]` | 分卷（如 `-v1g` / `-v500m`） | `-sdel` | 压缩后删除源文件
+`-sfx[{name}]` | 生成自解压压缩包（SFX） | `-bd` | 关闭进度指示器
+`-bb[0-3]` | 输出日志等级 | `-bt` | 输出执行时间统计
+`-so` | 输出到 stdout | `-si[{name}]` | 从 stdin 读入数据
+`-scrc[CRC64\|SHA1\|SHA256\|*]` | 指定校验/哈希算法（用于 `x/e/h`） | `@listfile` | 从列表文件读取文件名
+`-i...` | 仅包含匹配项（include） | `-x...` | 排除匹配项（exclude）
+`-slt` | `l` 命令输出技术信息 | `-spf` | 使用绝对路径
+
+7z 压缩示例
+--------
+
+### 创建新的 7z 压缩包
+
+```shell
+$ 7z a -t7z archive.7z file1 file2 dir1/
+```
+
+### 创建分卷压缩包
+
+```shell
+$ 7z a big.7z big.iso -v1g
+```
+
+压缩时会自动根据文件名后缀判断压缩格式，所以可以忽略 `-t` 开关
+
+### 设置压缩等级与线程数
+
+```shell
+$ 7z a archive.7z dir1/ -mx9 -mmt4
+```
+
+### 排除目录或文件
+<!--rehype:wrap-class=col-span-2-->
+
+```shell
+$ 7z a archive.7z example/ '-x!example/node_modules/*' '-x!example/dist/*'
+```
+<!--rehype:className=wrap-text-->
+
+### 从列表文件读取待压缩文件
+
+```shell
+$ 7z a archive.7z @files.txt
+```
+
+`files.txt` 每行一个文件路径（相对或绝对路径均可）。
+
+### 压缩后删除源文件
+
+```shell
+$ 7z a archive.7z dir1/ -sdel
+```
+
+7z 解压示例
+--------
+
+### 解压并保留目录结构（推荐）
+
+```shell
+$ 7z x archive.7z
+```
+
+### 解压到指定目录
+
+```shell
+$ 7z x archive.7z -o./output
+```
+
+### 解压但不保留目录结构
+
+```shell
+$ 7z e archive.7z -o./output
+```
+
+### 解压时覆盖策略
+
+```shell
+$ 7z x archive.7z -o./output -aoa
+```
+
+### 仅解压匹配的文件
+
+```shell
+$ 7z x archive.7z '*.log' -o./output
+```
+
+### 列出压缩包内容（含技术信息）
+
+```shell
+$ 7z l archive.7z -slt
+```
+
+### 测试压缩包完整性
+
+```shell
+$ 7z t archive.7z
+```
+
+### 计算文件哈希（SHA256）
+
+```shell
+$ 7z h -scrcSHA256 file1 file2
+```
+
+另见
+----
+
+- [7-Zip 官网](https://www.7-zip.org/) _(7-zip.org)_
+- [7-Zip 简体中文网站](https://sparanoid.com/lab/7z/) _(7-zip.org)_
+- [7z 命令帮助文档](https://jaywcjlove.github.io/linux-command/c/7z.html) _(linux-command)_