@taloswork/ose-shared 0.1.9 → 0.1.11

package/skills/cozy-static-svg/scripts/artkit.py

@@ -1,321 +0,0 @@
-#!/usr/bin/env python3
-"""静态 SVG 插画质检：结构校验 + 画风合规报告（秒级，直出 SVG，不转 PNG）。
-
-跨平台：macOS / Linux / Windows 都能跑，只用 Python 标准库（需 Python 3.9+）。
-
-    macOS / Linux   python3 scripts/artkit.py 作品.svg
-    Windows         py -3 scripts\\artkit.py 作品.svg
-
-批量质检（两个平台写法一致：目录和通配符都行，PowerShell 不必自己展开）：
-    python3 scripts/artkit.py .                 # 当前目录下全部 .svg（递归）
-    python3 scripts/artkit.py "out/*.svg"       # 通配符由脚本自己展开
-    py -3 scripts\\artkit.py 作品目录 --strict
-
-- 结构：命名空间 / 尺寸 / viewBox / title·desc / role·aria / 唯一标识 /
-  内部引用 / 禁用动态与外链 / 数值合法。
-- 画风：全部内容位于圆角裁切内（画布圆角约定）/ 字体栈 / 调色清单 /
-  文案清单 / 文案克制。
-- 退出码：0 通过（可含提示）；1 存在不合格项；--strict 时提示也算不合格。
-"""
-from __future__ import annotations
-
-import argparse
-import glob
-import re
-import sys
-import xml.etree.ElementTree as ET
-from collections import Counter
-from pathlib import Path
-
-if sys.version_info < (3, 9):
-    sys.exit(
-        "需要 Python 3.9 或更新版本（当前 %d.%d）；"
-        "Windows 请用 py -3 运行，或到 python.org 安装新版。" % sys.version_info[:2]
-    )
-
-# Windows 控制台默认是 GBK，直接 print 中文可能抛 UnicodeEncodeError → 强制 UTF-8 输出
-if hasattr(sys.stdout, "reconfigure"):
-    try:
-        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
-    except (AttributeError, ValueError):
-        pass
-
-SVG_NS = "http://www.w3.org/2000/svg"
-BLOCKED = {
-    "script", "animate", "animatetransform", "animatemotion", "animatecolor",
-    "set", "discard", "foreignobject", "image", "iframe", "audio", "video", "a",
-}
-URL_RE = re.compile(r"url\(\s*(['\"]?)(.*?)\1\s*\)", re.I)
-CSS_MOTION = re.compile(
-    r"@keyframes\b|@import\b|(?:^|[;{\s])(?:-\w+-)?(?:animation|transition)(?:-[\w-]+)?\s*:",
-    re.I,
-)
-SIZE_RE = re.compile(r"(?:\d+(?:\.\d+)?|\.\d+)(?:px)?")
-NAN_RE = re.compile(r"\bNaN\b|\bInfinity\b", re.I)
-CJK_RE = re.compile(r"[\u4e00-\u9fff]")
-CJK_FACES = (
-    "pingfang sc", "noto sans cjk", "microsoft yahei", "heiti sc", "simhei",
-    "source han sans", "wenquanyi",
-)
-COUNT_ORDER = [
-    "g", "path", "circle", "ellipse", "rect", "line", "polygon", "polyline",
-    "text", "tspan", "use", "linearGradient", "radialGradient", "clipPath", "mask",
-]
-CLIP_REF_RE = re.compile(r"url\(\s*#([^)\s]+)\s*\)")
-
-
-def local(tag: str) -> str:
-    return tag.rsplit("}", 1)[-1]
-
-
-def local_attr(key: str) -> str:
-    return key.rsplit("}", 1)[-1].lower()
-
-
-def shorten(text: str, limit: int = 26) -> str:
-    return text if len(text) <= limit else text[:limit] + "…"
-
-
-def inspect(source: Path) -> dict:
-    """质检一个 SVG；不合格时抛出 ValueError，通过时返回报告数据。"""
-    raw = source.read_text(encoding="utf-8")
-    if re.search(r"<!DOCTYPE|<!ENTITY|<\?xml-stylesheet", raw, re.I):
-        raise ValueError("不接受 DTD、实体声明或外部样式表。")
-    root = ET.fromstring(raw)
-    if root.tag != f"{{{SVG_NS}}}svg":
-        raise ValueError("根节点必须是含正确命名空间的 SVG。")
-    vb = [float(x) for x in re.split(r"[\s,]+", root.get("viewBox", "").strip()) if x]
-    if len(vb) != 4 or vb[2] <= 0 or vb[3] <= 0:
-        raise ValueError("viewBox 必须包含四个数，宽高须为正数。")
-    for attr in ("width", "height"):
-        value = root.get(attr, "")
-        if not SIZE_RE.fullmatch(value) or float(value.removesuffix("px")) <= 0:
-            raise ValueError(f"请显式填写正数 {attr}（数字或 px）。")
-    canvas_w = float(root.get("width").removesuffix("px"))
-    canvas_h = float(root.get("height").removesuffix("px"))
-    for tag in ("title", "desc"):
-        node = root.find(f"{{{SVG_NS}}}{tag}")
-        if node is None or not "".join(node.itertext()).strip():
-            raise ValueError(f"缺少非空的 {tag}。")
-    if root.get("role") != "img" or not root.get("aria-labelledby", "").strip():
-        raise ValueError("请填写 role=img 和 aria-labelledby。")
-
-    elements = list(root.iter())
-    ids = [e.get("id") for e in elements if e.get("id") is not None]
-    if any(not i for i in ids) or len(ids) != len(set(ids)):
-        raise ValueError("存在空标识或重复标识。")
-    refs = set(root.get("aria-labelledby", "").split())
-    colors = Counter()
-    for node in elements:
-        tag = local(node.tag).lower()
-        if tag in BLOCKED or not node.tag.startswith("{" + SVG_NS + "}"):
-            raise ValueError(f"不接受的节点：{tag}。")
-        for key, value in node.attrib.items():
-            name = local_attr(key)
-            if name.startswith("on") or name == "base":
-                raise ValueError(f"不接受事件处理器或基址属性：{name}。")
-            if NAN_RE.search(value):
-                raise ValueError(f"属性含非法数值（NaN/Infinity）：{name}。")
-            if name == "href":
-                if not value.startswith("#") or len(value) < 2:
-                    raise ValueError("href 只能使用非空的内部 #标识引用。")
-                refs.add(value[1:])
-            if name in {"aria-labelledby", "aria-describedby"}:
-                refs.update(value.split())
-            if name == "style" and CSS_MOTION.search(value):
-                raise ValueError("不接受 CSS 动画、过渡或导入规则。")
-            for _, target in URL_RE.findall(value):
-                if not target.startswith("#") or len(target) < 2:
-                    raise ValueError("url() 只能使用内部 #标识引用。")
-                refs.add(target[1:])
-            if name in {"fill", "stroke", "stop-color"}:
-                plain = value.strip().lower()
-                if plain and not plain.startswith("url(") and plain not in {
-                    "none", "currentcolor", "transparent", "inherit",
-                }:
-                    colors[plain] += 1
-        if tag == "style":
-            css = "".join(node.itertext())
-            if CSS_MOTION.search(css):
-                raise ValueError("不接受 CSS 动画、过渡或导入规则。")
-            for _, target in URL_RE.findall(css):
-                if not target.startswith("#") or len(target) < 2:
-                    raise ValueError("样式只能引用内部资源。")
-                refs.add(target[1:])
-    missing = refs - set(ids)
-    if missing:
-        raise ValueError("未定义的引用：" + "、".join(sorted(missing)))
-
-    # 画风约定：全部内容（含文字）位于圆角裁切分组内
-    rounded_clips = {}
-    for clip in root.iter(f"{{{SVG_NS}}}clipPath"):
-        for child in clip:
-            if local(child.tag) == "rect" and child.get("rx"):
-                try:
-                    rx = float(child.get("rx"))
-                except ValueError:
-                    continue
-                if rx >= 10:
-                    rounded_clips[clip.get("id")] = (rx, child)
-    if not rounded_clips:
-        raise ValueError("缺少全幅圆角裁切：未找到含 rx≥10 矩形的 clipPath（画风约定：全幅统一圆角）。")
-    warns = []
-    frame_rx = None
-    for child in root:
-        tag = local(child.tag)
-        if tag in {"title", "desc", "defs", "metadata", "style"}:
-            continue
-        if tag == "g":
-            match = CLIP_REF_RE.fullmatch((child.get("clip-path") or "").strip())
-            target = match.group(1) if match else None
-            if target in rounded_clips:
-                rx, rect = rounded_clips[target]
-                if frame_rx is None:
-                    frame_rx = rx
-                rw, rh = rect.get("width"), rect.get("height")
-                if rw and rh:
-                    try:
-                        if abs(float(rw) - canvas_w) > 0.5 or abs(float(rh) - canvas_h) > 0.5:
-                            warns.append(
-                                f"圆角裁切 {rw}×{rh} 与画布 {canvas_w:g}×{canvas_h:g} 不完全一致"
-                            )
-                    except ValueError:
-                        pass
-                continue
-        raise ValueError(
-            f"最外层存在未纳入圆角裁切的 {tag}：全部内容（含文字）都应放在"
-            "引用圆角 clipPath 的 <g> 内。"
-        )
-    if frame_rx is None:
-        raise ValueError("找不到包住全部内容的圆角裁切分组。")
-
-    # 字体栈与文案
-    parents = {child: parent for parent in root.iter() for child in parent}
-    texts = []
-    for node in root.iter(f"{{{SVG_NS}}}text"):
-        content = "".join(node.itertext()).strip()
-        if content:
-            texts.append(content)
-        stack = node.get("font-family")
-        cursor = node
-        while stack is None and cursor in parents:
-            cursor = parents[cursor]
-            stack = cursor.get("font-family")
-        if not stack:
-            raise ValueError("有文字缺少 font-family（请在 <g> 或 <text> 上给出系统中文字体栈）。")
-        if CJK_RE.search(content) and not any(face in stack.lower() for face in CJK_FACES):
-            warns.append(f"字体栈可能缺少中文回退：「{shorten(content, 12)}」")
-    if len(texts) > 5:
-        warns.append(f"文案 {len(texts)} 处，注意克制（建议标题＋一句注脚）")
-
-    counts = Counter(local(e.tag) for e in elements)
-    return {
-        "width": canvas_w,
-        "height": canvas_h,
-        "nodes": len(elements),
-        "ids": len(ids),
-        "refs": len(refs),
-        "rx": frame_rx,
-        "texts": texts,
-        "colors": colors,
-        "counts": counts,
-        "warns": warns,
-    }
-
-
-def collect_sources(items: list[str]) -> list[Path]:
-    """把命令行参数展开成 SVG 文件列表：文件 / 目录 / 通配符都接受。
-
-    Windows 的 PowerShell 与 cmd 不会替命令展开 *.svg，所以通配符在这里自己展开，
-    两个平台的命令写法才能真正一致。
-    """
-    found: list[Path] = []
-    for item in items:
-        text = str(item)
-        path = Path(text)
-        if path.is_dir():
-            found.extend(
-                sorted(
-                    p
-                    for p in path.rglob("*")
-                    if p.is_file() and p.suffix.lower() == ".svg"
-                )
-            )
-            continue
-        if any(ch in text for ch in "*?["):
-            found.extend(
-                sorted(
-                    Path(m)
-                    for m in glob.glob(text, recursive=True)
-                    if Path(m).is_file() and Path(m).suffix.lower() == ".svg"
-                )
-            )
-            continue
-        found.append(path)
-
-    unique: list[Path] = []
-    seen: set[str] = set()
-    for p in found:
-        try:
-            key = str(p.resolve())
-        except OSError:
-            key = str(p)
-        if key not in seen:
-            seen.add(key)
-            unique.append(p)
-    return unique
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(
-        description="静态 SVG 质检：结构校验 + 画风合规报告（跨平台，纯标准库）",
-        epilog="参数可以是文件、目录或通配符；目录会递归查找全部 .svg。",
-    )
-    parser.add_argument("svgs", nargs="+", help="待质检的 SVG（文件 / 目录 / 通配符）")
-    parser.add_argument("--strict", action="store_true", help="提示也视为不合格")
-    args = parser.parse_args()
-
-    sources = collect_sources(args.svgs)
-    if not sources:
-        print("没有找到任何 .svg —— 检查一下路径，或改用目录 / 通配符批量指定。")
-        return 1
-
-    failed = 0
-    warned = 0
-    for index, svg in enumerate(sources, 1):
-        print(f"[{index}/{len(sources)}] {svg.name}")
-        if not svg.is_file():
-            print(f"    ✗ 文件不存在或不是文件：{svg}")
-            failed += 1
-            continue
-        try:
-            report = inspect(svg)
-        except (OSError, ValueError, ET.ParseError) as exc:
-            print(f"    ✗ 检查未通过：{exc}")
-            failed += 1
-            continue
-        counts = report["counts"]
-        parts = " · ".join(f"{tag} {counts[tag]}" for tag in COUNT_ORDER if counts.get(tag))
-        top = " · ".join(f"{color}×{n}" for color, n in report["colors"].most_common(10))
-        print(f"    ✓ 结构：{report['width']:g}×{report['height']:g}；title/desc/role 齐全；无动态与外链")
-        print(f"    ✓ 引用：{report['ids']} 个标识 / {report['refs']} 处引用，全部有效")
-        print(f"    ✓ 裁切：全部内容位于圆角裁切内（rx≈{report['rx']:g}）")
-        print(f"    ✓ 字体：{len(report['texts'])} 处文字字体栈完整")
-        print(f"    元素 {report['nodes']}｜{parts}")
-        print(f"    调色 {len(report['colors'])} 种｜{top}")
-        print("    文案｜" + ("｜".join(shorten(t) for t in report["texts"]) or "无"))
-        if report["warns"]:
-            warned += 1
-            print("    ⚠ 提示｜" + "；".join(report["warns"]))
-        else:
-            print("    提示｜无")
-    passed = len(sources) - failed
-    tail = "；存在提示" if warned and not failed else ""
-    print(f"总计：{passed}/{len(sources)} 通过质检{tail}。")
-    if failed or (args.strict and warned):
-        return 1
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

package/skills/cozy-static-svg/scripts/to_png.py

@@ -1,333 +0,0 @@
-#!/usr/bin/env python3
-"""SVG → PNG（跨平台：macOS / Windows / Linux 同一条命令，纯标准库 + 系统已有工具）。
-
-仅当用户明确要 PNG 时才用，默认工作流仍是「直出原生 SVG，不转 PNG」。
-
-用法（两个平台写法一致）：
-    macOS / Linux   python3 scripts/to_png.py 作品.svg
-    Windows         py -3 scripts\\to_png.py 作品.svg
-    python3 scripts/to_png.py --scale 2 .          # 目录下全部 SVG，2 倍图
-    py -3 scripts\\to_png.py -o out --width 2400 作品目录
-    python3 scripts/to_png.py --backend inkscape 作品.svg
-
-后端自动探测，找到哪个用哪个（也可用 --backend 指定）：
-    1. rsvg-convert       与手绘流程同源，最推荐
-                          macOS: brew install librsvg ｜ Windows: MSYS2 / scoop 自行安装
-    2. inkscape           Inkscape 1.x，装了图形界面就自带命令行
-    3. cairosvg           pip install cairosvg（纯 Python 依赖）
-    4. chrome / edge      系统自带浏览器无头截图，零安装兜底
-
-其它参数：
-    -o DIR        输出目录（默认与源文件同目录）
-    --scale N     相对 SVG 原始尺寸的倍数（默认 1）
-    --width / --height   指定像素尺寸（只给一边则按比例算另一边）
-    --background  RRGGBB 铺不透明底色（默认保留透明，圆角外仍是透明的）
-"""
-from __future__ import annotations
-
-import argparse
-import glob
-import os
-import re
-import shutil
-import subprocess
-import sys
-import tempfile
-import xml.etree.ElementTree as ET
-from pathlib import Path
-
-if sys.version_info < (3, 9):
-    sys.exit(
-        "需要 Python 3.9 或更新版本（当前 %d.%d）；"
-        "Windows 请用 py -3 运行，或到 python.org 安装新版。" % sys.version_info[:2]
-    )
-
-if hasattr(sys.stdout, "reconfigure"):  # Windows 控制台默认 GBK，强制 UTF-8 输出
-    try:
-        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
-    except (AttributeError, ValueError):
-        pass
-
-CHROME_CANDIDATES = {
-    "darwin": [
-        "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
-        "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
-        "/Applications/Chromium.app/Contents/MacOS/Chromium",
-    ],
-    "win32": [
-        r"%PROGRAMFILES%\Google\Chrome\Application\chrome.exe",
-        r"%PROGRAMFILES(X86)%\Google\Chrome\Application\chrome.exe",
-        r"%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe",
-        r"%PROGRAMFILES(X86)%\Microsoft\Edge\Application\msedge.exe",
-        r"%PROGRAMFILES%\Microsoft\Edge\Application\msedge.exe",
-    ],
-}
-CHROME_ON_PATH = ["chrome", "google-chrome", "chromium", "chromium-browser", "msedge"]
-
-
-# ---------- 输入展开（与 artkit.py 同规则：文件 / 目录 / 通配符） ----------
-
-def collect_sources(items: list[str]) -> list[Path]:
-    found: list[Path] = []
-    for item in items:
-        text = str(item)
-        path = Path(text)
-        if path.is_dir():
-            found.extend(
-                sorted(
-                    p
-                    for p in path.rglob("*")
-                    if p.is_file() and p.suffix.lower() == ".svg"
-                )
-            )
-            continue
-        if any(ch in text for ch in "*?["):
-            found.extend(
-                sorted(
-                    Path(m)
-                    for m in glob.glob(text, recursive=True)
-                    if Path(m).is_file() and Path(m).suffix.lower() == ".svg"
-                )
-            )
-            continue
-        found.append(path)
-
-    unique: list[Path] = []
-    seen: set[str] = set()
-    for p in found:
-        try:
-            key = str(p.resolve())
-        except OSError:
-            key = str(p)
-        if key not in seen:
-            seen.add(key)
-            unique.append(p)
-    return unique
-
-
-# ---------- 后端探测 ----------
-
-def _which(*names: str) -> str | None:
-    for name in names:
-        hit = shutil.which(name)
-        if hit:
-            return hit
-    return None
-
-
-def find_chrome() -> str | None:
-    for raw in CHROME_CANDIDATES.get(sys.platform, []):
-        path = os.path.expandvars(raw)
-        if Path(path).is_file():
-            return path
-    return _which(*CHROME_ON_PATH)
-
-
-def find_backends() -> dict[str, str]:
-    """返回 {后端名: 可执行路径或说明}；cairosvg 用 'python' 表示模块可用。"""
-    backends: dict[str, str] = {}
-    if (rsvg := _which("rsvg-convert")):
-        backends["rsvg"] = rsvg
-    if (ink := _which("inkscape")) or Path(
-        "/Applications/Inkscape.app/Contents/MacOS/inkscape"
-    ).is_file():
-        backends["inkscape"] = ink or "/Applications/Inkscape.app/Contents/MacOS/inkscape"
-    try:
-        import cairosvg  # noqa: F401
-
-        backends["cairosvg"] = "python-module"
-    except ImportError:
-        pass
-    if (chrome := find_chrome()):
-        backends["chrome"] = chrome
-    return backends
-
-
-# ---------- 尺寸 ----------
-
-def svg_size(src: Path) -> tuple[float, float] | None:
-    try:
-        root = ET.parse(src).getroot()
-    except (ET.ParseError, OSError):
-        return None
-    size = re.compile(r"^\s*(\d+(?:\.\d+)?)")
-    out = []
-    for attr in ("width", "height"):
-        match = size.match(root.get(attr) or "")
-        if not match:
-            return None
-        out.append(float(match.group(1)))
-    return out[0], out[1]
-
-
-def target_size(src: Path, scale: float, width: float | None, height: float | None):
-    base = svg_size(src) or (1200.0, 900.0)
-    w, h = base[0] * scale, base[1] * scale
-    if width and height:
-        return width, height
-    if width:
-        return width, round(w and h * width / w)
-    if height:
-        return round(w * height / h), height
-    return round(w), round(h)
-
-
-# ---------- 各后端转换 ----------
-
-def convert_rsvg(exe: str, src: Path, out: Path, size, background: str | None) -> None:
-    cmd = [exe, "-w", str(size[0]), "-h", str(size[1])]
-    if background:
-        cmd += ["-b", f"#{background.lstrip('#')}"]
-    cmd += [str(src), "-o", str(out)]
-    subprocess.run(cmd, check=True, capture_output=True)
-
-
-def convert_inkscape(exe: str, src: Path, out: Path, size, background: str | None) -> None:
-    cmd = [
-        exe,
-        "--export-type=png",
-        f"--export-filename={out}",
-        f"--export-width={size[0]}",
-        f"--export-height={size[1]}",
-    ]
-    if background:
-        cmd += [f"--export-background=#{background.lstrip('#')}", "--export-background-opacity=255"]
-    cmd.append(str(src))
-    subprocess.run(cmd, check=True, capture_output=True)
-
-
-def convert_cairosvg(src: Path, out: Path, size, background: str | None) -> None:
-    import cairosvg
-
-    cairosvg.svg2png(
-        url=str(src),
-        write_to=str(out),
-        output_width=size[0],
-        output_height=size[1],
-        background_color=f"#{background.lstrip('#')}" if background else None,
-    )
-
-
-def convert_chrome(exe: str, src: Path, out: Path, size, background: str | None) -> None:
-    markup = src.read_text(encoding="utf-8")
-    markup = re.sub(r"<\?xml[^>]*\?>", "", markup, count=1).strip()
-    if background:
-        markup = markup.replace(
-            "<svg ", f'<svg style="background:#{background.lstrip("#")}" ', 1
-        )
-    html = (
-        "<!doctype html><html><head><meta charset=\"utf-8\"><style>"
-        "html,body{margin:0;padding:0;overflow:hidden;background:transparent}"
-        "svg{display:block;width:100vw;height:100vh}</style></head><body>"
-        + markup
-        + "</body></html>"
-    )
-    with tempfile.TemporaryDirectory() as tmp:
-        page = Path(tmp) / "page.html"
-        page.write_text(html, encoding="utf-8")
-        common = [
-            f"--screenshot={out}",
-            f"--window-size={size[0]},{size[1]}",
-            "--hide-scrollbars",
-            "--force-device-scale-factor=1",
-            "--virtual-time-budget=2000",
-            "--default-background-color=00000000",
-            page.resolve().as_uri(),
-        ]
-        for headless in ("--headless=new", "--headless"):
-            try:
-                subprocess.run(
-                    [exe, headless, *common], check=True, capture_output=True, timeout=120
-                )
-                if out.is_file():
-                    return
-            except (subprocess.CalledProcessError, subprocess.TimeoutExpired):
-                continue
-    raise RuntimeError("无头浏览器没有产出截图（可换 --backend inkscape 或 rsvg）")
-
-
-# ---------- 主流程 ----------
-
-def main() -> int:
-    parser = argparse.ArgumentParser(
-        description="SVG → PNG（跨平台，自动选择可用后端）",
-        epilog="参数可以是文件、目录或通配符。默认保留透明底，输出与源文件同目录。",
-    )
-    parser.add_argument("svgs", nargs="+", help="待转换的 SVG（文件 / 目录 / 通配符）")
-    parser.add_argument("-o", "--outdir", type=Path, help="输出目录")
-    parser.add_argument("--scale", type=float, default=1.0, help="相对原始尺寸的倍数（默认 1）")
-    parser.add_argument("--width", type=float, help="输出宽度（像素）")
-    parser.add_argument("--height", type=float, help="输出高度（像素）")
-    parser.add_argument("--background", help="铺底色，如 FFFFFF（默认透明）")
-    parser.add_argument(
-        "--backend",
-        choices=["auto", "rsvg", "inkscape", "cairosvg", "chrome"],
-        default="auto",
-        help="指定后端（默认 auto：rsvg → inkscape → cairosvg → chrome）",
-    )
-    args = parser.parse_args()
-
-    if args.outdir:
-        args.outdir.mkdir(parents=True, exist_ok=True)
-
-    sources = collect_sources(args.svgs)
-    if not sources:
-        print("没有找到任何 .svg —— 检查路径，或用目录 / 通配符批量指定。")
-        return 1
-
-    backends = find_backends()
-    order = ["rsvg", "inkscape", "cairosvg", "chrome"]
-    if args.backend != "auto":
-        if args.backend not in backends:
-            print(f"指定的后端 {args.backend} 在本机没找到。可用：{', '.join(backends) or '无'}")
-            print(_install_hint())
-            return 1
-        chosen = args.backend
-    else:
-        chosen = next((name for name in order if name in backends), None)
-    if not chosen:
-        print("没有找到任何可用的转换后端。")
-        print(_install_hint())
-        return 1
-
-    print(f"后端：{chosen}（{backends[chosen]}）")
-    failed = 0
-    for index, src in enumerate(sources, 1):
-        name = src.name
-        if not src.is_file():
-            print(f"[{index}/{len(sources)}] {name} ✗ 文件不存在")
-            failed += 1
-            continue
-        size = target_size(src, args.scale, args.width, args.height)
-        out = (args.outdir or src.parent) / (src.stem + ".png")
-        try:
-            if chosen == "rsvg":
-                convert_rsvg(backends["rsvg"], src, out, size, args.background)
-            elif chosen == "inkscape":
-                convert_inkscape(backends["inkscape"], src, out, size, args.background)
-            elif chosen == "cairosvg":
-                convert_cairosvg(src, out, size, args.background)
-            else:
-                convert_chrome(backends["chrome"], src, out, size, args.background)
-            print(f"[{index}/{len(sources)}] {name} → {out.name}（{size[0]:g}×{size[1]:g}）")
-        except (subprocess.CalledProcessError, RuntimeError, OSError, ValueError) as exc:
-            print(f"[{index}/{len(sources)}] {name} ✗ 转换失败：{exc}")
-            failed += 1
-
-    ok = len(sources) - failed
-    print(f"总计：{ok}/{len(sources)} 张转成 PNG。")
-    return 1 if failed else 0
-
-
-def _install_hint() -> str:
-    return (
-        "装一个就行：\n"
-        "  macOS   brew install librsvg   （或 brew install --cask inkscape）\n"
-        "  Windows choco/scoop 装 librsvg，或装 Inkscape，或 pip install cairosvg\n"
-        "     —— 其实系统自带的 Edge 就能当后端，装不了工具时用 --backend chrome\n"
-        "  Linux   apt install librsvg2-bin / dnf install librsvg2-tools"
-    )
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())