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

core/runner.sh

@@ -1,56 +1,55 @@
 #!/bin/bash
 
 # ==========================================================
-# 脚本名称: runner.sh (IP-Sentinel 主控调度引擎 - 动态锚点版)
-# 核心功能: 防并发延迟启动、功能开关(Feature Flag)自适应、多模块概率轮盘调度
+# 脚本名称: runner.sh
+# 核心功能: 主控调度枢纽，管理防并发锁与 Feature Flag 概率轮盘
 # ==========================================================
 
 INSTALL_DIR="/opt/ip_sentinel"
 CONFIG_FILE="${INSTALL_DIR}/config.conf"
 
-# 1. 检查并加载本地冷数据配置
+# --- [基础环境构建] ---
 if [ ! -f "$CONFIG_FILE" ]; then
     echo "配置文件丢失，请重新运行 install.sh"
     exit 1
 fi
 source "$CONFIG_FILE"
 
-# ================== [新增: 文件排他锁，防止并发重入引发内存雪崩] ==================
+# ==========================================================
+# [防线 1] 进程排他锁管控
+# 严格防止高频并发重入引发的底层内存雪崩与死锁
+# ==========================================================
 exec 200>"/tmp/ip_sentinel_runner.lock"
 if ! flock -n 200; then
     echo "[$(date)] ⚠️ 上一轮巡逻任务尚未结束，本次触发自动取消。" >> "$LOG_FILE"
     exit 0
 fi
-# ==================================================================================
 
-# 2. 全局日志写入函数 (导出给子进程共享使用，v3.4.0 引入版本探针)
+# --- [系统级日志通道] ---
 log() {
     local module=$1
     local level=$2
     local msg=$3
-    # [v3.4.0 核心] 提取当前配置中的版本锚点
     local local_ver="${AGENT_VERSION:-未知}"
     
-    # 保证日志目录存在
     mkdir -p "${INSTALL_DIR}/logs"
     
-    # 日志格式注入 [版本号] 追踪标识
     local core_msg=$(printf "[v%-5s] [%-5s] [%-7s] [%s] %s" "$local_ver" "$level" "$module" "$REGION_CODE" "$msg")
     echo "[$(date -u '+%Y-%m-%d %H:%M:%S UTC')] $core_msg" >> "$LOG_FILE"
 
-    # 强制推送到 Systemd Journal (如果系统支持)
     if command -v logger >/dev/null 2>&1; then
         logger -t ip-sentinel "$core_msg"
     else
-        # 降级输出到 stdout，让 Systemd 捕获
         echo "$core_msg"
     fi
 }
 export -f log
 export CONFIG_FILE INSTALL_DIR
 
-# 3. 防僵尸网络特征 (Cron Jitter) - 核心隐蔽逻辑
-# 配合每 20 分钟的调度周期，将随机休眠控制在 0 到 180 秒内，彻底打散全球并发请求
+# ==========================================================
+# [防线 2] 行为学隐蔽 (Cron Jitter)
+# 彻底消除僵尸网络同频定时唤醒特征，自然打散全球并发请求
+# ==========================================================
 if [ -t 1 ]; then
     log "SYSTEM" "INFO " "💻 检测到人工终端干预，跳过静默休眠，立即执行任务！"
 else
@@ -59,15 +58,17 @@ else
     sleep $JITTER_TIME
 fi
 
-# 4. 唤醒并读取功能开关，执行智能调度 (Feature Flag)
+# ==========================================================
+# 智能轮盘赌调度系统 (基于 Feature Flag)
+# ==========================================================
 log "SYSTEM" "INFO" "休眠结束，开始计算本轮任务轮盘..."
 
 TARGET_MOD=""
 MOD_NAME=""
 
-# 智能轮盘赌算法
+# 概率任务分配模型
 if [ "$ENABLE_GOOGLE" == "true" ] && [ "$ENABLE_TRUST" == "true" ]; then
-    # 双管齐下: 70% 概率跑 Google 稳固定位，30% 概率跑 Trust 洗刷风控分
+    # 优先锚定地理画像，辅助洗刷风控分
     ROLL=$((RANDOM % 100 + 1))
     if [ $ROLL -le 70 ]; then
         TARGET_MOD="mod_google.sh"
@@ -87,11 +88,12 @@ else
     exit 0
 fi
 
-# 5. 拉起选定的业务模块
+# ----------------------------------------------------------
+# 安全执行与资源剥离
+# ----------------------------------------------------------
 if [ -n "$TARGET_MOD" ] && [ -x "${INSTALL_DIR}/core/${TARGET_MOD}" ]; then
     log "SYSTEM" "INFO" "命中触发条件，加载并执行子模块: ${MOD_NAME}"
-    # 核心降耗逻辑：使用 nice -n 19 赋予进程最低 CPU 优先级，绝不抢占 VPS 正常业务的资源
-    # [安全修复] 注入 200>&-，强行关闭子进程对排他锁的继承权！防止子进程假死导致全局死锁
+    # [进程隔离与降耗] 赋予最低 CPU 优先级，并强制剥离排他锁的继承权，防止子进程假死拖垮全局
     nice -n 19 bash "${INSTALL_DIR}/core/${TARGET_MOD}" 200>&-
 else
     log "SYSTEM" "ERROR" "配置了模块 ${MOD_NAME}，但未找到对应的可执行脚本: ${TARGET_MOD}"