refactor(docs): 启动架构文档全量重构，统一 V4.1.1 工业级防渗透注释标准，彻底抹除历史版本碎片

master/uninstall_master.sh

@@ -1,13 +1,13 @@
 #!/bin/bash
 
 # ==========================================================
-# 脚本名称: uninstall_master.sh (IP-Sentinel Master 一键卸载脚本 - 动态锚点版)
-# 核心功能: 终止调度进程、清理看门狗定时任务、抹除数据库与配置
+# 脚本名称: uninstall_master.sh
+# 核心功能: 司令部无痕销毁、调度进程抹杀、SQLite 资产库安全覆写
 # ==========================================================
 
-# ==========================================================
-# 🛑 核心权限防线: 检查是否以 root 权限运行
-# ==========================================================
+# ----------------------------------------------------------
+# [权限鉴权] 防止非管理员误触导致中枢组件挂起或卸载不全
+# ----------------------------------------------------------
 if [ "$EUID" -ne 0 ]; then
   echo -e "\033[31m❌ 权限被拒绝: 卸载 IP-Sentinel 需要最高系统权限。\033[0m"
   echo -e "💡 请切换到 root 用户 (执行 su root 或 sudo -i) 后重新运行指令。"
@@ -20,7 +20,7 @@ CONF_FILE="${MASTER_DIR}/master.conf"
 echo "========================================================"
 echo "      🗑️ 准备卸载 IP-Sentinel Master (控制中枢)"
 
-# [v3.4.0 优化] 卸载前读取并播报中枢版本号
+# [态势感知] 卸载前动态提取并播报当前中枢内核版本
 if [ -f "$CONF_FILE" ]; then
     MASTER_VER=$(grep "^MASTER_VERSION=" "$CONF_FILE" | cut -d'"' -f2)
     [ -n "$MASTER_VER" ] && echo "        📍 目标版本: v${MASTER_VER}"
@@ -34,11 +34,13 @@ if [[ ! "$CONFIRM_DEL" =~ ^[Yy]$ ]]; then
     exit 0
 fi
 
-# 1. 停止并删除 Systemd 服务 (适配新架构)
+# ----------------------------------------------------------
+# [进程抹杀] 阻塞并卸除底层 Systemd 强绑定服务单元
+# ----------------------------------------------------------
 echo "[1/4] 正在停止并删除 Systemd 服务..."
 if command -v systemctl >/dev/null 2>&1; then
     echo "💡 检测到 Systemd 环境，正在抹除 Systemd 服务单元..."
-    # [防死锁修复] 先发送 SIGKILL 瞬间抹杀，防止卡死
+    # 强制压制守护状态，发送 SIGKILL 剥夺其产生遗言及重启的机会
     systemctl kill --signal=SIGKILL ip-sentinel-master.service >/dev/null 2>&1 || true
     systemctl disable --now ip-sentinel-master.service >/dev/null 2>&1
     rm -f /etc/systemd/system/ip-sentinel-master.service
@@ -48,16 +50,22 @@ else
     echo "💡 未检测到 Systemd，跳过此步骤..."
 fi
 
-# 2. 停止运行中的 Master 守护进程 (兜底清理老版进程)
+# ----------------------------------------------------------
+# [内存清洗] 全面追踪并镇压游离状态的中枢调度进程
+# ----------------------------------------------------------
 echo "[2/4] 正在终止后台中枢调度进程..."
 pkill -9 -f "tg_master.sh" >/dev/null 2>&1 || true
 
-# 3. 清除看门狗定时任务 (Cron)
+# ----------------------------------------------------------
+# [任务清洗] 基于内存管道流彻底擦除系统底层看门狗劫持
+# ----------------------------------------------------------
 echo "[3/4] 正在清理系统定时任务 (Cron)..."
-# [终极防御] 内存管道流过滤，绝不写硬盘
+# 内存管道流原位清洗，不留中间文件，免疫提权探测
 crontab -l 2>/dev/null | grep -v "tg_master.sh" | crontab - >/dev/null 2>&1 || true
 
-# 4. 删除所有文件、配置与数据库
+# ----------------------------------------------------------
+# [物理销毁] 抹杀持久化特征，彻底销毁档案库与配置容器
+# ----------------------------------------------------------
 echo "[4/4] 正在抹除核心程序、配置文件与 SQLite 数据库..."
 if [ -d "$MASTER_DIR" ]; then
     rm -rf "$MASTER_DIR"