Skip to content

armgit / andee

Public Imported from GitHub
0

Andee lives on your phone or Mac and uses any app like you do—no integrations, no root, any model; memory and passwords never leave your device | Andee 住进你的手机或 Mac,像你一样操作任何 App——无需集成、无需 Root、支持任意模型,记忆和密码绝不离开设备。

9.3 KB
Raw Blame
#!/usr/bin/env python3
"""把 cutie_lab_probe.js 注入奶油球实验室,用 headless Chrome 跑一遍,打印验收表。

⚠️ **这份工具还没在本机跑通过一次。** 写它的时候 headless Chrome 在这台机器上
连一个空白页都 dump 不出来(`--dump-dom` 90 秒超时,加不加沙箱都一样),所以
下面的判据阈值是**照着参数推的,不是量出来的**。第一次跑通之前,不要把它的
输出当作验收结论,也不要在提交信息里引用它。参数本身另有 `check_look_sync.py`
逐位核对,那一份是可靠的。

和 verify_faces_lab.py 同一套路(同一个 Chrome 定位逻辑、同一套
`--enable-unsafe-swiftshader`,**不要**加 `--disable-gpu`,那会让
getContext('webgl') 返回 null)。差别只在判据:这里量的是耳朵(和眉,如果这个
形象还有眉的话 —— 奶油球 2026-09-30 删掉了,见 `_brow_checks`)。

判据写在**这一侧**,不在探针里 —— 阈值是要反复调的,改 python 比改 JS 省事,
而且探针只负责"把数拿出来",职责单一。

用法:
    python3 tools/verify_cutie_lab.py [页面路径]
"""
import json
import re
import subprocess
import sys
import tempfile
from pathlib import Path

ROOT = Path(__file__).resolve().parent.parent
PAGE = Path(sys.argv[1]) if len(sys.argv) > 1 else ROOT / "reports" / "ball-cutie-lab.html"
PROBE = ROOT / "tools" / "cutie_lab_probe.js"

# 验收线。改了造型就得回来看这三个数,别让它们默默漂走。
MIN_EAR_OUT_FRAC = 0.08     # 耳朵出轮廓的宽度 ÷ 球直径
MIN_BROW_PX = 300           # 眉毛造成差异的像素数(68 列字符画下约 5 笔)
MAX_UNEXPECTED_PX = 40      # 轮廓内、眉毛带以下的差异 —— 球体本身不许被动
MIN_BROW_ABOVE_EYE_PX = 2.0  # 眉差异的质心必须比眼睛中心高多少像素


def _find_chrome() -> str:
    import os
    import shutil

    fallback = "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
    candidates = [
        os.environ.get("CHROME_PATH"),
        fallback,
        "/Applications/Chromium.app/Contents/MacOS/Chromium",
        "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
        "/usr/bin/google-chrome",
        "/usr/bin/chromium",
        "/usr/bin/chromium-browser",
        "/snap/bin/chromium",
    ]
    candidates += [
        shutil.which(name)
        for name in ("google-chrome", "google-chrome-stable", "chromium", "chromium-browser", "chrome")
    ]
    for path in candidates:
        if path and Path(path).exists():
            return path
    return fallback


CHROME = _find_chrome()

FLAGS = [
    "--headless=new",
    "--no-sandbox",
    "--enable-unsafe-swiftshader",
    "--window-size=1500,3600",
    "--hide-scrollbars",
]


def run_probe() -> dict:
    html = PAGE.read_text(encoding="utf-8")
    probe = PROBE.read_text(encoding="utf-8")
    if "</body>" not in html:
        raise SystemExit("页面里没有 </body>,不知道该把探针插在哪。")
    html = html.replace("</body>", f"<script>\n{probe}\n</script>\n</body>", 1)

    tmp = Path(tempfile.mkdtemp(prefix="cutie-lab-"))
    harness = tmp / "lab-verify.html"
    harness.write_text(html, encoding="utf-8")

    # Chrome 不给 --user-data-dir 就会去 ~/Library/Application Support/Google/
    # Chrome-headless 建一个临时 profile,跑完还要删掉它 —— 在受限环境里那一
    # 步会被删除规则拦下,表现为"整条命令没有任何输出"。给它一个自己的目录,
    # 写和清都在 temp 里完成。
    profile = tmp / "chrome-profile"
    proc = subprocess.run(
        [CHROME, *FLAGS, f"--user-data-dir={profile}",
         "--virtual-time-budget=20000", "--dump-dom", harness.as_uri()],
        capture_output=True, text=True, timeout=240,
    )
    dom = proc.stdout

    # 探针源码自己就在 DOM 里,注释里也有 `<pre id="zh-probe"` 这个字符串,
    # 所以不能取第一个匹配 —— 要取**能解析成 JSON** 的那一个。
    for raw in re.findall(r'<pre id="zh-probe"[^>]*>(.*?)</pre>', dom, re.S):
        raw = raw.strip()
        if not raw.startswith("{"):
            continue
        try:
            return json.loads(raw)
        except json.JSONDecodeError:
            continue

    print("探针没有留下结果 —— 页面大概在 build() 阶段就挂了。", file=sys.stderr)
    err = re.search(r'<div id="err"[^>]*>(.*?)</div>', dom, re.S)
    if err and err.group(1).strip():
        print("页面自己的错误框:", file=sys.stderr)
        print(err.group(1)[:4000], file=sys.stderr)
    raise SystemExit(2)


def _brow_checks(m: dict, f: dict) -> list:
    """眉的那两条断言,按"这个形象到底有没有眉"来选。

    奶油球 2026-09-30 把眉删掉了(browW 0)。探针的两组 A/B 里,`browOff` 是
    `{browW:0}`,而预设本身现在也是 0 —— 两次拍的是**同一个配置**,browDiffPx
    恒为 0。原来那两条"看得见、且高于眼睛"的断言拿 0 去比 300px 的阈值,会稳定
    FAIL。阈值没写错,是世界变了,所以要改的是断言不是数。

    分成两支:有眉查"看得见且位置对";没眉查反向的"关掉前后必须一模一样"。

    ⚠️ 说清第二支有多弱:它是**接近重言式**的 —— 两次拍同一配置,本来就该相等。
    它挡不住"某个分支在偷偷画一笔",只挡得住"渲染本身不确定"(未初始化状态、
    随机抖动)。真正的"删干净了没有"要靠字符画那一栏人眼看。别把它当强验证。
    """
    if f["browW"] > 0:
        return [
            ("眉毛在眼睛上方留下可见的一笔",
             m["browDiffPx"] >= MIN_BROW_PX,
             f"{m['browDiffPx']}px ≥ {MIN_BROW_PX}px,最大通道差 {m['browDiffMaxDelta']}"),
            ("眉差异的质心高于眼睛中心",
             (m["browDiffCentroidFromTop"] or 0) <= f["eyeRowFromTop"] - MIN_BROW_ABOVE_EYE_PX,
             f"质心行 {m['browDiffCentroidFromTop']:.1f} ≤ 眼睛行 {f['eyeRowFromTop']:.1f} "
             f"− {MIN_BROW_ABOVE_EYE_PX:.0f}"),
        ]
    return [
        ("本形象没有眉:关眉前后应完全一致(弱检查,见 docstring)",
         m["browDiffPx"] == 0,
         f"关眉前后差异 {m['browDiffPx']}px,应为 0"),
    ]


def main() -> int:
    if not PAGE.exists():
        print(f"找不到页面:{PAGE}", file=sys.stderr)
        return 2
    if not Path(CHROME).exists():
        print(f"找不到 Chrome:{CHROME}", file=sys.stderr)
        return 2

    R = run_probe()
    if R.get("fatal"):
        print("页面/探针抛异常:", file=sys.stderr)
        print(R["fatal"], file=sys.stderr)
        return 2

    print(f"奶油球 · 耳朵验收  (探针 {R.get('version')})")
    print("=" * 72)

    m, f = R["measure"], R["facts"]
    print("─ 参数 ─")
    print(f"  球半径(含描边) {f['bodyRadiusPx']:.1f}px  1 世界单位 = {f['pxPerUnit']:.1f}px")
    print(f"  眼睛中心在第 {f['eyeRowFromTop']:.1f} 行(自上而下)")
    print(f"  earH={f['earH']} earX={f['earX']} earY={f['earY']} earTilt={f['earTilt']}° "
          f"earBend={f['earBend']}° earShade={f['earShade']}")
    print(f"  browW={f['browW']} browH={f['browH']} browY={f['browY']} browTilt={f['browTilt']}°")
    print()
    print("─ 量 ─")
    rp = m["radiusPx"]
    print(f"  最大半径  全开 {rp['both']:.1f}  只关眉 {rp['browOff']:.1f}  "
          f"只关耳 {rp['earOff']:.1f}  基线 {rp['none']:.1f}")
    print(f"  耳朵伸出轮廓 {m['earOutPx']:.1f}px  = 球直径的 {m['earOutFracOfDiameter']*100:.1f}%"
          f"   (为它多出的像素 {m['earNewPx']})")
    print(f"  眉毛差异 {m['browDiffPx']}px  最大通道差 {m['browDiffMaxDelta']}"
          f"  质心在第 {m['browDiffCentroidFromTop']:.1f} 行(眼睛在第 {f['eyeRowFromTop']:.1f} 行)")
    print(f"  轮廓内 / 眉毛带以下的意外差异 {m['unexpectedPx']}px   (总差异 {m['allDiffPx']}px)")
    print()
    print("─ 差异逐行分布(自上而下,28 行)─")
    mk = max(1, max(m["allDiffRows"]))
    for i, v in enumerate(m["allDiffRows"]):
        bar = "▉" * int(round(v / mk * 46))
        print(f"  {i:2d} {v:5d} {bar}")
    print()

    checks = [
        ("耳朵伸出轮廓",
         m["earOutFracOfDiameter"] >= MIN_EAR_OUT_FRAC,
         f"{m['earOutFracOfDiameter']*100:.1f}% ≥ {MIN_EAR_OUT_FRAC*100:.0f}%(球直径)"),
        ("耳朵确实落在轮廓外(不是只在里面换色)",
         m["earNewPx"] >= 100,
         f"新增像素 {m['earNewPx']} ≥ 100"),
    ] + _brow_checks(m, f) + [
        ("球体本身没有被意外改动",
         m["unexpectedPx"] <= MAX_UNEXPECTED_PX,
         f"意外差异 {m['unexpectedPx']}px ≤ {MAX_UNEXPECTED_PX}px"),
    ]

    failed = 0
    for name, ok, detail in checks:
        if not ok:
            failed += 1
        print(f"[{'PASS' if ok else 'FAIL'}] {name}")
        print(f"       {detail}")
    print("=" * 72)
    print(f"{len(checks) - failed}/{len(checks)} 通过")

    if R.get("rows"):
        print()
        for row in R["rows"]:
            print(f"── {row['label']} ──")
            for line in row["ascii"]:
                print("  " + line)
            print()
    return 1 if failed else 0


if __name__ == "__main__":
    sys.exit(main())