软件加固前梳理 Feature Flag 与 Kill Switch 的必要性：默认值、离线行为与责任归属

#!/usr/bin/env python3
import json
import sys
import re

def validate_flags(flags):
    valid_behaviors = {"fallback_default", "keep_last", "exception"}
    errors = []
    for i, f in enumerate(flags):
        fid = f.get("flag_id", f"index {i}")
        owner = f.get("owner", "")
        if not owner:
            errors.append(f"{fid}: owner 缺失")
        dv = f.get("default_value")
        if not isinstance(dv, bool):
            errors.append(f"{fid}: default_value 必须是布尔")
        vr = f.get("applicable_version_range", "")
        if not re.match(r'^(>=?)?\d+(\.\d+){1,2}(-\d+(\.\d+){1,2})?$', vr):
            errors.append(f"{fid}: applicable_version_range 格式错误：{vr}")
        ob = f.get("offline_behavior", "")
        if ob not in valid_behaviors:
            errors.append(f"{fid}: offline_behavior 无效：{ob}")
        ksr = f.get("kill_switch_responsible", "")
        if not ksr:
            errors.append(f"{fid}: kill_switch_responsible 缺失")
    return errors

if __name__ == "__main__":
    if len(sys.argv) != 2:
        print("Usage: feature-flag-validator.py flags.json")
        sys.exit(1)
    try:
        with open(sys.argv[1], 'r', encoding='utf-8') as fh:
            data = json.load(fh)
    except FileNotFoundError:
        print(f"ERROR: File {sys.argv[1]} not found")
        sys.exit(1)
    except json.JSONDecodeError:
        print(f"ERROR: Invalid JSON in {sys.argv[1]}")
        sys.exit(1)
    errs = validate_flags(data)
    if errs:
        for e in errs:
            print(f"ERROR: {e}")
        sys.exit(1)
    else:
        print("All flags valid.")
        sys.exit(0)