@sophiacyl/dsh-plugin-waves 0.0.0-stage → 0.1.0-beta.2

package/service/tools/update_plugins.py

@@ -0,0 +1,212 @@
+#!/usr/bin/env python3
+"""拉取/更新上游插件。
+
+插件目录保持上游原样(带 .git), 更新就是 git pull。本地差异全在 rover/hooks.py,
+不改插件源码, 所以更新不会冲突。
+GitHub 不可达时自动改走 cnb.cool 镜像。
+"""
+
+import argparse
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+from typing import Optional
+
+PLUGINS_DIR = Path(__file__).resolve().parents[1] / "plugins"
+
+REPOS = {
+    "XutheringWavesUID": {
+        "github": "https://github.com/Loping151/XutheringWavesUID.git",
+        "cnb": "https://cnb.cool/gscore-mirror/XutheringWavesUID.git",
+    },
+    "RoverSign": {
+        "github": "https://github.com/Loping151/RoverSign.git",
+        "cnb": "https://cnb.cool/gscore-mirror/RoverSign.git",
+    },
+    "ScoreEcho": {
+        "github": "https://github.com/Loping151/ScoreEcho.git",
+        "cnb": "https://cnb.cool/gscore-mirror/ScoreEcho.git",
+    },
+}
+
+# clone/pull 卡住太久也算不可达, 好切镜像
+CLONE_TIMEOUT = 90
+PULL_TIMEOUT = 60
+
+_UNREACHABLE = (
+    "could not resolve host",
+    "failed to connect",
+    "connection timed out",
+    "operation timed out",
+    "network is unreachable",
+    "no route to host",
+    "unable to access",
+    "connection reset",
+    "connection refused",
+    "the remote end hung up unexpectedly",
+    "early eof",
+    "rpc failed",
+    "gnutlsrecv error",
+    "openssl ssl_connect",
+    "ssl_connect",
+    "tls connect error",
+    "couldn't connect to server",
+    "empty reply from server",
+    "proxy connect aborted",
+    "failed to connect to github.com",
+)
+
+
+def run(args, cwd=None, timeout: Optional[int] = None) -> subprocess.CompletedProcess:
+    env = os.environ.copy()
+    env.setdefault("GIT_TERMINAL_PROMPT", "0")
+    try:
+        return subprocess.run(
+            args,
+            cwd=cwd,
+            capture_output=True,
+            text=True,
+            encoding="utf-8",
+            errors="replace",
+            timeout=timeout,
+            env=env,
+        )
+    except subprocess.TimeoutExpired as e:
+        out = e.stdout.decode("utf-8", "replace") if isinstance(e.stdout, bytes) else (e.stdout or "")
+        err = e.stderr.decode("utf-8", "replace") if isinstance(e.stderr, bytes) else (e.stderr or "")
+        return subprocess.CompletedProcess(
+            args, 124, out, (err + "\nconnection timed out").strip()
+        )
+
+
+def is_unreachable(result: subprocess.CompletedProcess) -> bool:
+    if result.returncode == 0:
+        return False
+    text = f"{result.stderr} {result.stdout}".lower()
+    return any(token in text for token in _UNREACHABLE)
+
+
+def _rm_incomplete(dest: Path) -> None:
+    if dest.exists():
+        shutil.rmtree(dest, ignore_errors=True)
+
+
+def clone_with_fallback(name: str, dest: Path, github: str, cnb: str) -> str:
+    result = run(["git", "clone", "--depth", "1", github, str(dest)], timeout=CLONE_TIMEOUT)
+    source = "github"
+    if result.returncode:
+        _rm_incomplete(dest)
+        if not is_unreachable(result):
+            raise RuntimeError(f"{name}: 克隆失败 {result.stderr.strip()[:160]}")
+        print(f"{name}: GitHub 不可达, 改用 cnb {cnb}")
+        result = run(["git", "clone", "--depth", "1", cnb, str(dest)], timeout=CLONE_TIMEOUT)
+        source = "cnb"
+        if result.returncode:
+            _rm_incomplete(dest)
+            raise RuntimeError(f"{name}: cnb 克隆也失败 {result.stderr.strip()[:160]}")
+    head = run(["git", "log", "--oneline", "-1"], cwd=dest).stdout.strip()
+    return f"{name}: 已克隆 ({source}) {head}"
+
+
+def _other_remote(origin: str, github: str, cnb: str):
+    """当前 origin 不可达时该换去哪一边; 第三方 origin 不擅自改。"""
+    if "github.com" in origin:
+        return cnb, "cnb"
+    if "cnb.cool" in origin:
+        return github, "GitHub"
+    return None, ""
+
+
+def pull_with_fallback(name: str, dest: Path, github: str, cnb: str) -> Optional[str]:
+    """origin 不可达时切到另一个源再拉一次(两边互为备份)。失败返回错误文案。"""
+    result = run(["git", "pull", "--ff-only"], cwd=dest, timeout=PULL_TIMEOUT)
+    if result.returncode == 0:
+        return None
+    if not is_unreachable(result):
+        return f"{name}: 拉取失败 {result.stderr.strip()[:160]}"
+    origin = run(["git", "remote", "get-url", "origin"], cwd=dest).stdout.strip()
+    other, label = _other_remote(origin, github, cnb)
+    if not other:
+        return f"{name}: 拉取失败 {result.stderr.strip()[:160]}"
+    print(f"{name}: 当前源不可达, origin 改为 {label}")
+    setu = run(["git", "remote", "set-url", "origin", other], cwd=dest)
+    if setu.returncode:
+        return f"{name}: 无法改 origin {setu.stderr.strip()[:120]}"
+    result = run(["git", "pull", "--ff-only"], cwd=dest, timeout=PULL_TIMEOUT)
+    if result.returncode:
+        return f"{name}: {label} 拉取也失败 {result.stderr.strip()[:160]}"
+    return None
+
+
+def sync_one(name: str, urls: dict) -> str:
+    dest = PLUGINS_DIR / name
+    github, cnb = urls["github"], urls["cnb"]
+    if not (dest / ".git").is_dir():
+        if dest.exists():
+            raise RuntimeError(f"{name}: 目录已存在但不是 git 仓库, 请手工处理 {dest}")
+        return clone_with_fallback(name, dest, github, cnb)
+
+    dirty = run(["git", "status", "--porcelain"], cwd=dest).stdout
+    local_edits = [ln for ln in dirty.splitlines() if not ln.startswith("??")]
+    if local_edits:
+        return f"{name}: 有本地改动, 已跳过(本地差异应写进 rover/hooks.py):\n    " + "\n    ".join(
+            local_edits[:5]
+        )
+
+    before = run(["git", "rev-parse", "--short", "HEAD"], cwd=dest).stdout.strip()
+    err = pull_with_fallback(name, dest, github, cnb)
+    if err:
+        raise RuntimeError(err)
+    after = run(["git", "rev-parse", "--short", "HEAD"], cwd=dest).stdout.strip()
+    if before == after:
+        return f"{name}: 已是最新 {after}"
+    log = run(["git", "log", "--oneline", f"{before}..{after}"], cwd=dest).stdout.strip()
+    return f"{name}: {before} → {after}\n    " + "\n    ".join(log.splitlines()[:8])
+
+
+def check_compat() -> int:
+    """更新后自检: 上游有没有用到本运行时还没提供的模块。"""
+    sys.path.insert(0, str(PLUGINS_DIR.parent))
+    from rover import compat
+
+    absent = [name for name in REPOS if not (PLUGINS_DIR / name / name / "__init__.py").is_file()]
+    if absent:
+        print("\n上游插件未完整安装: " + ", ".join(absent))
+        return 1
+    missing = compat.missing_imports(PLUGINS_DIR)
+    if missing:
+        print("\n运行时缺少这些上游模块, 需要在 rover/compat.py 补映射:")
+        for name in missing:
+            print(f"  {name}")
+        return 1
+    print("\n兼容层自检通过")
+    return 0
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--check-only", action="store_true", help="只做兼容层自检, 不拉取")
+    args = parser.parse_args()
+
+    PLUGINS_DIR.mkdir(parents=True, exist_ok=True)
+    (PLUGINS_DIR / "__init__.py").touch()
+
+    sync_failed = False
+    if not args.check_only:
+        for name, urls in REPOS.items():
+            try:
+                print(sync_one(name, urls))
+            except RuntimeError as error:
+                sync_failed = True
+                print(str(error), file=sys.stderr)
+
+    code = 1 if sync_failed else check_compat()
+    if not args.check_only:
+        print("\n更新后请重启服务, 并跑 tools/regression.py 自检。")
+    sys.exit(code)
+
+
+if __name__ == "__main__":
+    main()

package/service/tools/verify_actions.py

@@ -0,0 +1,104 @@
+#!/usr/bin/env python3
+"""校验点击命令与卡片里的角色是否一一对上: 用每个格子后面的等级/共鸣链回查上下文。"""
+
+import asyncio
+import re
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
+
+CASES = {
+    "ww深塔": "abyss/abyss_card.html",
+    "ww海墟": "abyss/slash_card.html",
+    "ww矩阵": "abyss/matrix_detail_card.html",
+    "ww全息": "abyss/challenge_card.html",
+}
+
+_CELL = re.compile(
+    r'<div class="role-mini[^>]*?(?:data-ww-cmd="(?P<cmd>[^"]*)")?[^>]*>(?P<body>.*?)(?=<div class="role-mini|</div>\s*</div>\s*</div>)',
+    re.S,
+)
+
+
+def local_user() -> str:
+    """本机使用者标识, 从配置里取, 不写死。"""
+    from rover.config import core_config
+
+    masters = core_config.get_config("masters") or []
+    return str(masters[0]) if masters else "local"
+
+
+async def main() -> None:
+    from rover import html_actions
+
+    captured = []
+    original = html_actions.annotate_html
+
+    def spy(html, template_name, context):
+        out = original(html, template_name, context)
+        captured.append((template_name, context, out))
+        return out
+
+    html_actions.annotate_html = spy
+
+    from rover.app_life import load_plugins
+    from rover.handler import build_message, dispatch
+    from rover.server import core_start_before_execute
+    from rover.utils.database.base_models import init_database
+    from rover.utils.database.startup import init_all
+
+    await init_database()
+    load_plugins()
+    await init_all()
+    await core_start_before_execute()
+
+    # hooks 里的渲染函数按值抓过 annotate_html, 载入之后再把间谍塞进去
+    import sys as _sys
+
+    for module in list(_sys.modules.values()):
+        if getattr(module, "annotate_html", None) is original:
+            module.annotate_html = spy
+
+    failures = 0
+    for command, template in CASES.items():
+        captured.clear()
+        await dispatch(build_message(command, user_id=local_user()))
+        hit = [c for c in captured if c[0] == template]
+        if not hit:
+            print(f"{command}: 未渲染 {template}")
+            failures += 1
+            continue
+        _, context, html = hit[-1]
+        roles = html_actions._EXTRACTORS[template](context)
+        expect = [
+            (html_actions._role_command(r), str(r.get("level") or ""), str(r.get("chain_name") or ""))
+            for r in roles
+        ]
+        cells = [m.group(0) for m in html_actions._ROLE_TAG.finditer(html)]
+        got_cmds = [
+            (re.search(r'data-ww-cmd="([^"]+)"', c).group(1) if 'data-ww-cmd=' in c else None)
+            for c in cells
+        ]
+        mismatch = []
+        for i, (want, _lvl, _chain) in enumerate(expect):
+            if i >= len(got_cmds):
+                mismatch.append(f"#{i} 缺格子")
+            elif got_cmds[i] != want:
+                mismatch.append(f"#{i} 期望{want} 实得{got_cmds[i]}")
+        extra = len(got_cmds) - len(expect)
+        names = [c for c in got_cmds if c][:3]
+        status = "对齐" if not mismatch and extra == 0 else "错位"
+        if mismatch or extra:
+            failures += 1
+        print(f"{command}: 格子={len(got_cmds)} 上下文={len(expect)} {status} 示例={names}")
+        for m in mismatch[:5]:
+            print(f"    {m}")
+        if extra:
+            print(f"    多出 {extra} 个格子")
+
+    print("\n结果:", "全部对齐" if failures == 0 else f"{failures} 项需修")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

package/service/tools/verify_card.py

@@ -0,0 +1,82 @@
+#!/usr/bin/env python3
+"""在真实浏览器里打开一张卡片, 检查渲染尺寸、字体与点击回传。"""
+
+import argparse
+import json
+import sys
+import urllib.request
+
+
+def fetch_card(base: str, command: str) -> str:
+    body = json.dumps({"command": command}).encode()
+    req = urllib.request.Request(
+        f"{base}/api/chat", data=body, headers={"content-type": "application/json"}
+    )
+    with urllib.request.urlopen(req, timeout=180) as resp:
+        data = json.loads(resp.read())
+    for seg in data.get("segments") or []:
+        if seg.get("type") == "html":
+            return seg["url"]
+    sys.exit(f"{command} 没有返回 HTML 卡片")
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--base", default="http://127.0.0.1:9777")
+    parser.add_argument("--command", default="ww深塔")
+    parser.add_argument("--shot", default="/tmp/waves-card.png")
+    args = parser.parse_args()
+
+    url = args.base + fetch_card(args.base, args.command)
+    from playwright.sync_api import sync_playwright
+
+    with sync_playwright() as p:
+        browser = p.chromium.launch()
+        page = browser.new_page(viewport={"width": 1200, "height": 900})
+        messages = []
+        page.expose_function("__wwCapture", lambda m: messages.append(m))
+        page.add_init_script(
+            "window.parent.postMessage = (m) => window.__wwCapture(JSON.stringify(m));"
+        )
+        errors = []
+        page.on("pageerror", lambda e: errors.append(str(e)))
+        page.goto(url, wait_until="load", timeout=60000)
+        page.wait_for_timeout(1500)
+
+        size = page.evaluate(
+            "() => { const el = document.querySelector('.container') || document.body;"
+            " const r = el.getBoundingClientRect();"
+            " return { w: Math.round(r.width), h: Math.round(el.scrollHeight) }; }"
+        )
+        clickable = page.locator("[data-ww-cmd]")
+        count = clickable.count()
+        font_ok = page.evaluate(
+            "() => [...document.styleSheets].some(s => { try { return s.href && s.href.includes('fonts.css') }"
+            " catch(e) { return false } }) || document.fonts.size > 0"
+        )
+
+        first_cmd = clickable.first.get_attribute("data-ww-cmd") if count else None
+        if count:
+            clickable.first.click()
+            page.wait_for_timeout(400)
+
+        page.screenshot(path=args.shot, full_page=False)
+        browser.close()
+
+    sizes = [m for m in messages if '"size"' in m]
+    commands = [json.loads(m) for m in messages if '"command"' in m]
+    print(f"卡片: {url}")
+    print(f"渲染尺寸: {size['w']}x{size['h']}  字体已加载: {font_ok}")
+    print(f"可点击角色: {count} 个, 首个命令: {first_cmd}")
+    print(f"尺寸回传: {len(sizes)} 次")
+    print(f"点击回传: {commands}")
+    print(f"页面错误: {errors or '无'}")
+    print(f"截图: {args.shot}")
+
+    ok = count > 0 and commands and commands[0].get("command") == first_cmd and not errors
+    print("\n结论:", "交互正常" if ok else "需检查")
+    sys.exit(0 if ok else 1)
+
+
+if __name__ == "__main__":
+    main()