agent-Specialization/scripts/strip_fallback.py

#!/usr/bin/env python3
"""
strip_fallback.py —— 安全剥离 var(--DEFINED_TOKEN, fallback) 的 fallback。

仅当 token 在 _tokens.scss 中已定义时才剥离（此时 fallback 永不生效，剥离=零视觉变化）。
未定义 token（fallback 是真实值）一律跳过。
带 --write 才落盘，否则只 dry-run 报告。

安全校验：每个被改的位置，改动后只是去掉了 ", fallback"，token 名和其余内容不变。
"""
import sys, re, glob, os

def load_defined():
    txt = open('static/src/styles/base/_tokens.scss', encoding='utf-8').read()
    return set(re.findall(r'(--[a-z0-9-]+)\s*:', txt))

def find_var_spans(s):
    """返回所有 var(...) 的 (start, end, inner) ，支持嵌套，end 是右括号下一位。"""
    spans = []
    i = 0
    while True:
        m = re.search(r'var\(', s[i:])
        if not m:
            break
        start = i + m.start()
        # 从 'var(' 的左括号开始做括号匹配
        depth = 0
        j = start + 3  # points at '('
        assert s[j] == '('
        k = j
        while k < len(s):
            if s[k] == '(':
                depth += 1
            elif s[k] == ')':
                depth -= 1
                if depth == 0:
                    break
            k += 1
        inner = s[j+1:k]
        spans.append((start, k+1, inner))
        i = k + 1
    return spans

def strip_one(s, defined):
    """对字符串 s 处理最外层 var()，递归处理 inner。返回 (新串, 改动数)。"""
    spans = find_var_spans(s)
    if not spans:
        return s, 0
    out = []
    last = 0
    changes = 0
    for start, end, inner in spans:
        out.append(s[last:start])
        # 先递归处理 inner（处理嵌套 var）
        new_inner, c_inner = strip_one(inner, defined)
        changes += c_inner
        # 解析最外层 var(--tok, fallback?) —— 在顶层逗号处分割
        mtok = re.match(r'\s*(--[a-z0-9-]+)\s*', new_inner)
        if mtok:
            tok = mtok.group(1)
            rest = new_inner[mtok.end():]
            if rest.startswith(','):
                # 有 fallback。token 已定义 → 剥离
                if tok in defined:
                    out.append(f'var({tok})')
                    changes += 1
                else:
                    out.append(f'var({new_inner})')
            else:
                out.append(f'var({new_inner})')
        else:
            out.append(f'var({new_inner})')
        last = end
    out.append(s[last:])
    return ''.join(out), changes

def process_file(path, defined, write):
    src = open(path, encoding='utf-8').read()
    new, ch = strip_one(src, defined)
    if ch and write:
        open(path, 'w', encoding='utf-8').write(new)
    return ch, src, new

def verify(src, new):
    """校验：去掉所有空白后，new 必须是 src 删除若干 ', fallback' 的结果。
    粗校验：new 的非空白字符是 src 非空白字符的子序列，且行数不变。"""
    if src.count('\n') != new.count('\n'):
        return False, "行数变化"
    # 每行：new 行必须是 old 行的子序列（只删不增）
    for o, n in zip(src.splitlines(), new.splitlines()):
        oi = 0
        for ch in n:
            oi = o.find(ch, oi)
            if oi == -1:
                return False, f"非子序列: {o!r} -> {n!r}"
            oi += 1
    return True, "ok"

def main():
    write = '--write' in sys.argv
    args = [a for a in sys.argv[1:] if not a.startswith('--')]
    defined = load_defined()
    files = args or (glob.glob('static/src/**/*.scss', recursive=True) +
                     glob.glob('static/src/**/*.vue', recursive=True))
    files = [f for f in files if '_tokens' not in f and '_virtual-monitor' not in f]
    total = 0
    for f in sorted(files):
        ch, src, new = process_file(f, defined, write=False)
        if not ch:
            continue
        ok, msg = verify(src, new)
        flag = "OK" if ok else f"FAIL({msg})"
        print(f"{ch:3d} strips  [{flag}]  {f}")
        if ok and write:
            open(f, 'w', encoding='utf-8').write(new)
        total += ch
    print(f"\n{'已写入' if write else 'DRY-RUN'} 总剥离: {total} 处")

if __name__ == '__main__':
    main()