refactor(log): 日志分级+组件标签，静默嵌套自调用降噪

- common.sh: log() 引入 DEBUG/INFO/WARN/ERROR 级别与 LOG_LEVEL
  阈值过滤，日志行加 [组件] 标签 (LOG_TAG)
- service.sh/switch.sh: 折叠成对横幅为单行里程碑；内部嵌套调用
  (重启同步、跨订阅回退重启) 加 LOG_LEVEL=WARN 静默，消除重复
  的切换/启停日志
- api.sh: 非 GET 请求失败 ERROR→DEBUG，避免预期内 400 回退误报
- service.sh(core): 启动概要 4 行合 1，过程提示降 DEBUG
- service.sh(boot): 环境信息细节降 DEBUG，版本保留单行 INFO
- 各脚本设 LOG_TAG (service/switch/sub/ipset/gms/boot/post-fs/action)
- 排错时 LOG_LEVEL=DEBUG 可调出全部中间步骤

Author: Fanju6

src/module/action.sh

@@ -12,6 +12,7 @@ readonly MODDIR="${0%/*}"                                  # 模块根目录 (
 readonly SERVICE_SCRIPT="$MODDIR/scripts/core/service.sh"  # 服务管理脚本
 readonly LOG_FILE="$MODDIR/logs/service.log"               # 服务日志
 readonly SING_BOX_BIN="$MODDIR/bin/sing-box"               # sing-box 二进制
+readonly LOG_TAG="action"                                  # 日志组件标签
 
 . "$MODDIR/scripts/utils/common.sh"
 

src/module/post-fs-data.sh

@@ -12,10 +12,11 @@ set -e  # 命令失败立即退出
 readonly MODDIR="${0%/*}"                          # 模块根目录 (脚本所在目录)
 readonly MODULE_CONF="$MODDIR/config/module.conf"  # 模块配置
 readonly LOG_FILE="$MODDIR/logs/service.log"       # 服务日志
+readonly LOG_TAG="post-fs"                         # 日志组件标签
 
 . "$MODDIR/scripts/utils/common.sh"
 
-log "INFO" "post-fs-data阶段"
+log "INFO" "post-fs-data 阶段"
 
 # 加载集成的 IPSET 内核驱动
 sh "$MODDIR/scripts/utils/ipset.sh" load

src/module/scripts/core/service.sh

@@ -23,6 +23,7 @@ readonly RUNTIME_DIR="$SINGBOX_DIR/runtime"           # 运行时生成目录
 readonly SWITCH_SCRIPT="$MODDIR/scripts/core/switch.sh"     # 模式/节点切换脚本
 readonly TPROXY_SCRIPT="$MODDIR/scripts/network/tproxy.sh"  # 透明代理脚本
 readonly KILL_TIMEOUT=5                               # 等待进程退出的秒数上限
+readonly LOG_TAG="service"                            # 日志组件标签
 
 . "$MODDIR/scripts/utils/common.sh"
 . "$MODDIR/scripts/utils/config.sh"
@@ -77,9 +78,9 @@ do_start() {
   local node_path
 
   if [ "$skip_tproxy" = "1" ]; then
-    log "INFO" "========== 开始启动 sing-box 核心服务 (跳过 tproxy) =========="
+    log "DEBUG" "启动 sing-box 核心服务 (跳过 tproxy)"
   else
-    log "INFO" "========== 开始启动 sing-box 服务 =========="
+    log "INFO" "启动 sing-box 服务"
   fi
   verify_environment
 
@@ -98,10 +99,8 @@ do_start() {
 
   [ "$RUNTIME_NODE_COUNT" -gt 0 ] || die "当前节点目录没有可加载的节点配置: $CUR_OUTBOUND_DIR"
 
-  log "INFO" "当前节点目录: $CUR_OUTBOUND_DIR"
-  log "INFO" "路由模式: $CUR_OUTBOUND_MODE"
-  log "INFO" "选择模式: $CUR_SELECTOR_MODE"
-  log "INFO" "已加载节点: $RUNTIME_NODE_COUNT，跳过无效节点: $RUNTIME_SKIPPED_COUNT"
+  # 节点与模式概要 (单行)
+  log "INFO" "节点目录=$CUR_OUTBOUND_DIR 模式=$CUR_OUTBOUND_MODE 选择=$CUR_SELECTOR_MODE 已加载=$RUNTIME_NODE_COUNT 跳过=$RUNTIME_SKIPPED_COUNT"
 
   # 构造启动参数：先基础参数，再逐个追加节点配置，最后追加运行时出站
   set -- run -C "$CONFDIR"
@@ -114,7 +113,7 @@ EOF
   set -- "$@" -c "$runtime_outbounds"
 
   # 以 root:net_admin 身份后台启动进程
-  log "INFO" "正在启动 sing-box 进程..."
+  log "DEBUG" "正在启动 sing-box 进程..."
   cd "$SINGBOX_DIR" || die "无法进入配置目录: $SINGBOX_DIR"
   nohup "$BUSYBOX" setuidgid root:net_admin "$SING_BOX_BIN" "$@" > "$SINGBOX_LOG_FILE" 2>&1 &
 
@@ -128,21 +127,21 @@ EOF
     die "sing-box 启动失败，请检查日志: $SINGBOX_LOG_FILE"
   fi
 
-  # 等待控制接口就绪后同步运行模式
+  # 等待控制接口就绪后同步运行模式 (内部同步步骤静默)
   api_wait_available 60 1 || die "控制接口不可用，启动失败"
-  LOG_STDERR=0 SWITCH_ALLOW_RESTART=0 sh "$SWITCH_SCRIPT" mode "$CUR_OUTBOUND_MODE" || die "运行模式同步失败，启动中止"
+  LOG_STDERR=0 LOG_LEVEL=WARN SWITCH_ALLOW_RESTART=0 sh "$SWITCH_SCRIPT" mode "$CUR_OUTBOUND_MODE" || die "运行模式同步失败，启动中止"
   # 手动选择模式下额外同步当前节点
   if [ "$CUR_SELECTOR_MODE" = "manual" ] || [ "$CUR_SELECTOR_MODE" = "selector" ] || [ "$CUR_SELECTOR_MODE" = "手动选择" ] || [ "$CUR_SELECTOR_MODE" = "手动" ]; then
-    LOG_STDERR=0 SWITCH_ALLOW_RESTART=0 sh "$SWITCH_SCRIPT" config "$CUR_OUTBOUND_CONFIG" || die "节点配置同步失败，启动中止"
+    LOG_STDERR=0 LOG_LEVEL=WARN SWITCH_ALLOW_RESTART=0 sh "$SWITCH_SCRIPT" config "$CUR_OUTBOUND_CONFIG" || die "节点配置同步失败，启动中止"
   fi
 
   # 非跳过模式下加载透明代理规则
   if [ "$skip_tproxy" != "1" ]; then
-    log "INFO" "正在加载透明代理规则..."
+    log "DEBUG" "正在加载透明代理规则..."
     "$TPROXY_SCRIPT" start -d "$TPROXY_CONF_DIR" >> "$LOG_FILE" 2>&1 || die "透明代理规则加载失败"
   fi
 
-  log "INFO" "========== sing-box 服务启动完成 =========="
+  log "INFO" "sing-box 服务启动完成"
 }
 
 #######################################
@@ -156,28 +155,27 @@ do_stop() {
   local pid count
 
   if [ "$skip_tproxy" = "1" ]; then
-    log "INFO" "========== 开始停止 sing-box 核心服务 (跳过 tproxy) =========="
+    log "DEBUG" "停止 sing-box 核心服务 (跳过 tproxy)"
   else
-    log "INFO" "========== 开始停止 sing-box 服务 =========="
+    log "INFO" "停止 sing-box 服务"
   fi
   verify_environment
 
   # 先清理透明代理规则 (非跳过模式)
   if [ "$skip_tproxy" != "1" ]; then
-    log "INFO" "正在清理透明代理规则..."
+    log "DEBUG" "正在清理透明代理规则..."
     "$TPROXY_SCRIPT" stop -d "$TPROXY_CONF_DIR" >> "$LOG_FILE" 2>&1 || true
   fi
 
   # 进程不存在则清理运行时文件后返回，保证幂等
   pid="$(get_pid "$SING_BOX_BIN")"
   if [ -z "$pid" ]; then
-    log "INFO" "未发现运行中的 sing-box 进程"
+    log "DEBUG" "未发现运行中的 sing-box 进程"
     cleanup_runtime_files
-    log "INFO" "========== sing-box 服务停止完成 =========="
     return 0
   fi
 
-  log "INFO" "正在停止 sing-box 进程 (PID: $pid)..."
+  log "DEBUG" "正在停止 sing-box 进程 (PID: $pid)..."
 
   # 先发送 SIGTERM，超时未退出再强制 SIGKILL
   if kill "$pid" 2> /dev/null; then
@@ -198,13 +196,11 @@ do_stop() {
   # 最终确认进程是否已退出，未退出则视为停止失败
   if kill -0 "$pid" 2> /dev/null; then
     log "ERROR" "sing-box 进程仍在运行 (PID: $pid)，停止失败"
-    log "INFO" "========== sing-box 服务停止完成 =========="
     return 1
   fi
 
   cleanup_runtime_files
-  log "INFO" "sing-box 进程已停止"
-  log "INFO" "========== sing-box 服务停止完成 =========="
+  log "INFO" "sing-box 服务已停止"
 }
 
 #######################################
@@ -220,9 +216,9 @@ do_restart() {
   # core 模式仅重启核心进程
   if [ "$target" = "core" ]; then
     skip_tproxy=1
-    log "INFO" "========== 开始重启 sing-box 核心服务 (跳过 tproxy) =========="
+    log "DEBUG" "重启 sing-box 核心服务 (跳过 tproxy)"
   else
-    log "INFO" "========== 开始重启 sing-box 服务 =========="
+    log "INFO" "重启 sing-box 服务"
   fi
 
   do_stop "$skip_tproxy"

src/module/scripts/core/subscription.sh

@@ -16,6 +16,7 @@ readonly OUTBOUNDS_DIR="$MODDIR/config/singbox/outbounds"  # 出站节点根目
 readonly DEFAULT_DIR="$OUTBOUNDS_DIR/default"              # 默认节点目录
 readonly PROXYLINK_BIN="$MODDIR/bin/proxylink"            # proxylink 二进制
 readonly LOG_FILE="$MODDIR/logs/subscription.log"         # 订阅日志文件
+readonly LOG_TAG="sub"                                    # 日志组件标签
 
 . "$MODDIR/scripts/utils/common.sh"
 . "$MODDIR/scripts/utils/nodes.sh"

src/module/scripts/core/switch.sh

@@ -17,6 +17,7 @@ readonly MODULE_CONF="$MODDIR/config/module.conf"           # 模块配置
 readonly SERVICE_SCRIPT="$MODDIR/scripts/core/service.sh"   # 服务管理脚本
 readonly SING_BOX_BIN="$MODDIR/bin/sing-box"               # sing-box 二进制
 readonly LOG_FILE="$MODDIR/logs/service.log"               # 服务日志
+readonly LOG_TAG="switch"                                  # 日志组件标签
 # 是否允许通过重启服务来应用配置 (启动阶段会置 0，防止递归重启)
 readonly SWITCH_ALLOW_RESTART="${SWITCH_ALLOW_RESTART:-1}"
 
@@ -42,8 +43,8 @@ is_service_running() {
 #######################################
 restart_service_if_allowed() {
   if [ "$SWITCH_ALLOW_RESTART" = "1" ]; then
-    log "INFO" "正在重启 sing-box 核心服务以应用配置..."
-    LOG_STDERR=0 sh "$SERVICE_SCRIPT" restart core || die "重启 sing-box 服务失败"
+    log "DEBUG" "回退方式：重启核心服务以应用配置"
+    LOG_STDERR=0 LOG_LEVEL=WARN sh "$SERVICE_SCRIPT" restart core || die "重启 sing-box 服务失败"
   else
     log "WARN" "当前阶段不允许通过重启应用配置"
     return 1
@@ -59,44 +60,42 @@ restart_service_if_allowed() {
 #######################################
 switch_config() {
   local config_file="$1"
-  local target_tag
+  local target_tag node_name
 
   require_file "$MODULE_CONF" "模块配置文件不存在: $MODULE_CONF"
   require_file "$config_file" "节点配置文件不存在: $config_file"
 
-  log "INFO" "========== 开始切换 sing-box 节点配置 =========="
-  log "INFO" "目标节点文件: $config_file"
+  node_name="${config_file##*/}"
+  log "INFO" "切换节点: $node_name"
 
   # 持久化当前节点路径并读取其出站标签
   set_conf "$MODULE_CONF" "CURRENT_CONFIG" "$(quote_conf "$config_file")"
   target_tag="$(detect_outbound_tag "$config_file" || true)"
 
   # 服务未运行时仅持久化，下次启动生效
   if ! is_service_running; then
-    log "INFO" "sing-box 未运行，新的节点配置将在下次启动时生效"
-    log "INFO" "========== 节点配置切换完成 =========="
+    log "INFO" "服务未运行，节点将在下次启动时生效"
     return 0
   fi
 
   # 有标签时优先通过控制接口热切换
   if [ -n "$target_tag" ]; then
     if api_select_proxy "$target_tag"; then
-      log "INFO" "已通过控制接口切换到节点: $target_tag"
-      log "INFO" "========== 节点配置切换完成 =========="
+      log "INFO" "节点切换完成: $target_tag"
       return 0
     fi
-    log "INFO" "当前运行实例未加载目标节点或控制接口切换失败，准备重启服务"
+    log "WARN" "运行实例未加载该节点，回退重启服务"
   else
-    log "INFO" "无法读取目标节点标签，准备重启服务"
+    log "WARN" "无法读取目标节点标签，回退重启服务"
   fi
 
   # 热切换失败则回退为重启服务
   restart_service_if_allowed || {
-    log "WARN" "本次仅完成配置持久化，等待下次服务重启生效"
+    log "WARN" "仅完成配置持久化，等待下次重启生效"
     return 1
   }
 
-  log "INFO" "========== 节点配置切换完成 =========="
+  log "INFO" "节点切换完成: $node_name"
 }
 
 #######################################
@@ -119,32 +118,30 @@ switch_mode() {
 
   require_file "$MODULE_CONF" "模块配置文件不存在: $MODULE_CONF"
 
-  log "INFO" "========== 开始切换 sing-box 出站模式: $target_mode =========="
+  log "INFO" "切换出站模式: $target_mode"
   # 持久化目标模式
   set_conf "$MODULE_CONF" "OUTBOUND_MODE" "$target_mode"
 
   # 服务未运行时仅持久化，下次启动生效
   if ! is_service_running; then
-    log "INFO" "sing-box 未运行，新的出站模式将在下次启动时生效"
-    log "INFO" "========== 出站模式切换完成 =========="
+    log "INFO" "服务未运行，模式将在下次启动时生效"
     return 0
   fi
 
   # 优先通过控制接口切换
   if api_set_mode "$target_mode"; then
-    log "INFO" "已通过控制接口切换出站模式"
-    log "INFO" "========== 出站模式切换完成 =========="
+    log "INFO" "出站模式切换完成: $target_mode"
     return 0
   fi
 
   # 接口切换失败则回退为重启服务
-  log "WARN" "控制接口切换模式失败，准备重启服务"
+  log "WARN" "控制接口切换模式失败，回退重启服务"
   restart_service_if_allowed || {
-    log "WARN" "本次仅完成模式持久化，等待下次服务重启生效"
+    log "WARN" "仅完成模式持久化，等待下次重启生效"
     return 1
   }
 
-  log "INFO" "========== 出站模式切换完成 =========="
+  log "INFO" "出站模式切换完成: $target_mode"
 }
 
 #######################################

src/module/scripts/utils/api.sh

@@ -118,9 +118,9 @@ api_request() {
     fi
     return 0
   else
-    # 非 GET：仅校验状态码，失败时记录日志
+    # 非 GET：仅校验状态码；失败记 DEBUG (是否严重由调用方判定)
     if [ $status -ne 0 ] || ! printf "%s" "$status_line" | grep -q -E '^HTTP/[0-9.]+ 2[0-9][0-9]'; then
-      log "ERROR" "[控制接口错误] 请求失败: $method $path，状态行: $status_line"
+      log "DEBUG" "[控制接口] 请求失败: $method $path，状态行: $status_line"
       return 1
     fi
     return 0

src/module/scripts/utils/common.sh

@@ -12,6 +12,22 @@ NL='
 TAB="$(printf '\t')"  # 制表符
 CR="$(printf '\r')"   # 回车符
 
+#######################################
+# 将日志级别名映射为数字 severity
+# 参数:
+#   $1  级别名 (DEBUG/INFO/WARN/ERROR)
+# 返回: 标准输出打印对应数字 (未知级别按 INFO=20 处理)
+#######################################
+log_level_value() {
+  case "$1" in
+    DEBUG) printf "10" ;;
+    INFO) printf "20" ;;
+    WARN) printf "30" ;;
+    ERROR) printf "40" ;;
+    *) printf "20" ;;
+  esac
+}
+
 #######################################
 # 写入标准日志
 # 参数:
@@ -20,22 +36,28 @@ CR="$(printf '\r')"   # 回车符
 # 全局:
 #   LOG_FILE   日志文件路径 (存在时追加写入)
 #   LOG_STDERR 是否输出到 stderr (0=否，默认输出)
+#   LOG_LEVEL  输出阈值级别 (默认 INFO)，低于该级别的消息被丢弃
+#   LOG_TAG    来源组件标签 (缺省取脚本名)
 # 返回: 无
 #######################################
 log() {
   local level="INFO"
   local message="$1"
-  local timestamp log_content
+  local timestamp tag
 
   # 传入两个参数时，第一个作为日志级别
   if [ $# -ge 2 ]; then
     level="$1"
     message="$2"
   fi
 
-  # 组装带时间戳的日志行
+  # 低于阈值的消息直接丢弃 (文件与 stderr 均不写)
+  [ "$(log_level_value "$level")" -ge "$(log_level_value "${LOG_LEVEL:-INFO}")" ] || return 0
+
+  # 组装带时间戳与组件标签的日志行
   timestamp="$(date '+%Y-%m-%d %H:%M:%S')"
-  log_content="[$timestamp] [$level] $message"
+  tag="${LOG_TAG:-${0##*/}}"
+  local log_content="[$timestamp] [$level] [$tag] $message"
 
   # 写入日志文件 (若已配置)
   [ -n "${LOG_FILE:-}" ] && printf "%s\n" "$log_content" >> "$LOG_FILE"

src/module/scripts/utils/gms_fix.sh

@@ -12,6 +12,7 @@ set -u  # 引用未定义变量报错
 # 模块根目录与日志文件
 readonly MODDIR="$(cd "$(dirname "$0")/../.." && pwd)"
 readonly LOG_FILE="$MODDIR/logs/service.log"
+readonly LOG_TAG="gms"  # 日志组件标签
 
 . "$MODDIR/scripts/utils/common.sh"
 
@@ -128,9 +129,9 @@ EOF
 main() {
   case "${1:-run}" in
     run)
-      log "INFO" "========== 开始执行设备兼容性修复 =========="
+      log "INFO" "执行设备兼容性修复"
       fix_by_device
-      log "INFO" "========== 设备兼容性修复完成 =========="
+      log "INFO" "设备兼容性修复完成"
       ;;
     -h | --help | help)
       show_usage

src/module/scripts/utils/ipset.sh

@@ -14,6 +14,7 @@ readonly MODDIR="$(cd "$(dirname "$0")/../.." && pwd)"
 readonly LOG_FILE="$MODDIR/logs/service.log"          # 服务日志
 readonly NETFILTER_DIR="/data/adb/netfilter"          # 驱动 .ko 存放目录
 readonly KO_LOADER="$MODDIR/bin/IPSET-LKM/ko-loader"  # 内核模块加载器
+readonly LOG_TAG="ipset"                              # 日志组件标签
 
 . "$MODDIR/scripts/utils/common.sh"