docs: 完善 README.md，添加功能特性、系统兼容性、使用说明等

2026-07-29 00:13:21 +08:00
parent ed878c4641
commit 70521112f5
1 changed files with 92 additions and 2 deletions
@@ -1,2 +1,92 @@
-# swapbuilder
-linux一键式swap管理命令
+# Swap Builder
+
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+GNU/Linux Swap 一键管理工具 — 交互式设置 Swap 与 swappiness，兼容主流发行版。
+
+## 快速开始
+
+```bash
+curl -sSL swap.fangqihang.cn/install.sh | sudo bash
+```
+
+复制到终端即可启动交互式 Swap 管理工具。
+
+## 功能特性
+
+- **Swap 大小设置** — 支持创建、调整、关闭 Swap 文件，自动检测磁盘空间，兼容 `fallocate` / `dd` 两种创建方式，自动写入 `/etc/fstab` 实现开机自启
+- **swappiness 调节** — 灵活调整内核 swappiness 参数（0~100），控制 Swap 使用策略，修改后自动持久化到 `/etc/sysctl.conf`，重启不失效
+- **安全防护机制** — 操作前自动备份 `/etc/fstab`，严格输入校验，关键操作二次确认，所有修改均可回滚
+- **实时状态展示** — 菜单界面实时显示当前 Swap 设备、内存使用量、swappiness 值
+- **彩色交互界面** — 终端彩色输出，菜单式选择无需记忆命令
+
+## 系统兼容性
+
+| 操作系统 | 适配版本 |
+|---------|---------|
+| CentOS | 7 / 8 / 9 |
+| Ubuntu | 18.04 / 20.04 / 22.04 / 24.04 |
+| Debian | 10 / 11 / 12 |
+| Anolis OS（龙蜥） | 8 / 23 |
+| AlmaLinux | 8 / 9 / 10 |
+| Rocky Linux | 8 / 9 / 10 |
+| openEuler（开源欧拉） | 20 ~ 25 |
+
+## 使用说明
+
+### 一键执行（推荐）
+
+```bash
+curl -sSL swapbuilder.fangqihang.cn/install.sh | sudo bash
+```
+
+直接管道运行，自动进入交互式菜单。
+
+### 手动下载运行
+
+```bash
+# 下载脚本
+curl -sSL swapbuilder.fangqihang.cn/install.sh -o swapbuilder.sh
+# 添加执行权限
+chmod +x swapbuilder.sh
+# 以 root 运行
+sudo bash swapbuilder.sh
+```
+
+先下载到本地查看源码，确认安全后再执行，适合生产环境。
+
+## 运行效果
+
+```
+==================================================
+          Swap Builder - Swap 管理工具
+==================================================
+        夏日之瓜 × 仰望星辰工作室 出品
+==================================================
+
+---------- 当前系统状态 ----------
+
+[Swap 设备]
+NAME      TYPE SIZE USED PRIO
+/www/swap file   4G 1.2G   -2
+
+[内存使用]
+              total        used        free      shared  buff/cache   available
+Mem:          1.8Gi       972Mi       593Mi       3.0Mi       463Mi       898Mi
+Swap:         4.0Gi       1.2Gi       2.8Gi
+
+[swappiness] 当前值：70
+
+-----------------------------------
+
+请选择操作：
+  1) 设置 Swap
+  2) 设置优先度（swappiness）
+  0) 退出
+
+请输入选项 [0-2]:
+```
+
+## 开源协议
+
+本项目采用 [MIT License](LICENSE) 开源。欢迎 Star、Fork 与提交 Issue。