feat(vps-xray): 重启计划配置解析与旧字段迁移

新增 normalize_restart_time / resolve_restart_config，
XRAY_RESTART_EVERY_DAYS 缺失时才回退读 XRAY_DAILY_RESTART。
附单元测试，不需要 root 与 systemd。

vps-xray/deploy.sh

@@ -74,12 +74,60 @@ if [[ "$MODE" != "reality" && "$MODE" != "fast" ]]; then
     exit 1
 fi
 
-# 布尔开关归一化：容忍 true/TRUE/True/yes/on/1 等写法，
-# 避免用户按直觉写了 TRUE 却被静默当成关闭
-case "$(printf '%s' "${XRAY_DAILY_RESTART:-false}" | tr '[:upper:]' '[:lower:]')" in
-    true|yes|on|1) DAILY_RESTART=1 ;;
-    *)             DAILY_RESTART=0 ;;
-esac
+# ===== 定时重启配置 =====
+# 可覆盖路径，测试时指向临时目录
+SYSTEMD_DIR="${SYSTEMD_DIR:-/etc/systemd/system}"
+GUARD_BIN="${GUARD_BIN:-/usr/local/bin/xray-restart-guard}"
+RESTART_STATE_FILE="${RESTART_STATE_FILE:-/var/lib/xray/last-restart}"
+
+RESTART_EVERY_DAYS=0
+RESTART_TIME="04:00"
+RESTART_TZ="Asia/Shanghai"
+
+# 把 4:00 / 04:00 统一成两位小时的 HH:MM，不合法返回 1。
+# 归一化的意义：OnCalendar 字符串格式统一，.env 内容可预测。
+normalize_restart_time() {
+    local t="${1:-}"
+    [[ "$t" =~ ^([01]?[0-9]|2[0-3]):([0-5][0-9])$ ]] || return 1
+    # 10# 前缀避免 08/09 被当成八进制
+    printf '%02d:%s' "$((10#${BASH_REMATCH[1]}))" "${BASH_REMATCH[2]}"
+}
+
+resolve_restart_config() {
+    local days="${XRAY_RESTART_EVERY_DAYS:-}"
+
+    # 旧字段迁移：仅当新字段完全未设置时才回退去读，
+    # 这样 .env 里显式写 0 能覆盖遗留的 XRAY_DAILY_RESTART=true
+    if [ -z "$days" ]; then
+        case "$(printf '%s' "${XRAY_DAILY_RESTART:-false}" | tr '[:upper:]' '[:lower:]')" in
+            true|yes|on|1) days=1 ;;
+            *)             days=0 ;;
+        esac
+    fi
+
+    if ! [[ "$days" =~ ^[0-9]+$ ]]; then
+        error "XRAY_RESTART_EVERY_DAYS 必须是非负整数，当前为 '${days}'"
+        return 1
+    fi
+    RESTART_EVERY_DAYS="$days"
+
+    local t
+    if ! t=$(normalize_restart_time "${XRAY_RESTART_TIME:-04:00}"); then
+        error "XRAY_RESTART_TIME 必须是 HH:MM（00:00~23:59），当前为 '${XRAY_RESTART_TIME:-}'"
+        return 1
+    fi
+    RESTART_TIME="$t"
+
+    RESTART_TZ="${XRAY_RESTART_TIMEZONE-Asia/Shanghai}"
+    if [ -z "$RESTART_TZ" ]; then
+        error "XRAY_RESTART_TIMEZONE 不能为空"
+        return 1
+    fi
+
+    return 0
+}
+
+resolve_restart_config || exit 1
 
 XRAY_PORT="${XRAY_PORT:-443}"