Skip to content

2654400439/Paper2Seminar / skills/paper-ppt-orchestrator

paper-ppt-orchestrator

Verified

Build complete fixed-layout academic-paper presentations from a PDF with bundled PPTX and one-page HTML templates. Use for full paper reading, complexity-aware slide budgeting, subsection coverage mapping, figure extraction, TikZ or Matplotlib evidence visuals, deterministic PPTX assembly, and final QA. Trigger for requests to turn a paper PDF into a discussion-group deck, especially 12-16+ page systems, security, networking, or measurement papers.

FileKindSize
SKILL.mdskill md17.9 KB
agents/openai.yamlconfig296 B
assets/one-page-summary.htmlother7.8 KB
assets/seminar-template.pptxbinary572.7 KB
references/content-design.mdmarkdown5.7 KB
references/data-viz.schema.jsonconfig2.9 KB
references/deck-plan.schema.jsonconfig8.5 KB
references/deck-sizing.mdmarkdown3.4 KB
references/environment-compatibility.mdmarkdown2.8 KB
references/feature-registry.jsonconfig1.4 KB
references/figure-extraction.mdmarkdown5.1 KB
references/job-request.defaults.jsonconfig1.6 KB
references/job-request.schema.jsonconfig7.5 KB
references/one-page-template.mdmarkdown3.1 KB
references/qa-gates.mdmarkdown10.0 KB
references/speaker-notes.mdmarkdown3.1 KB
references/template-contract.mdmarkdown5.1 KB
references/tikz-layout.mdmarkdown12.2 KB
references/visual-selection.mdmarkdown6.5 KB
references/workflow.mdmarkdown9.8 KB
requirements-doclayout.txtmarkdown238 B
requirements-ui.txtmarkdown39 B
requirements.txtmanifest68 B
scripts/apply_speaker_notes.pyscript6.1 KB
scripts/build_ppt.pyscript16.3 KB
scripts/crop_author_block.pyscript7.9 KB
scripts/crop_image_region.pyscript2.4 KB
scripts/export_pptx_pages.ps1script1.3 KB
scripts/extract_paper_assets.pyscript22.3 KB
scripts/job_request.pyscript17.1 KB
scripts/make_contact_sheet.pyscript4.0 KB
scripts/paper_ppt.pyscript17.1 KB
scripts/preflight_capabilities.pyscript8.3 KB
scripts/render_data_viz.pyscript14.6 KB
scripts/render_deck_overview.pyscript2.4 KB
scripts/render_one_page_html.pyscript13.4 KB
scripts/render_readability.pyscript4.1 KB
scripts/update_qa_status.pyscript10.1 KB
scripts/validate_deck_plan.pyscript33.9 KB
webapp/__init__.pyscript49 B
webapp/backend.pyscript14.5 KB
webapp/job_runner.pyscript3.2 KB
webapp/streamlit_app.pyscript17.3 KB

scripts/render_one_page_html.py

View on GitHub
#!/usr/bin/env python3
"""Render the bundled one-page HTML template to a tightly cropped PNG."""

from __future__ import annotations

import argparse
import hashlib
import json
import os
import platform
import re
import signal
import shutil
import subprocess
import sys
import tempfile
from pathlib import Path

from PIL import Image, ImageChops


REQUIRED_LABELS = ["问题归类", "威胁模型", "边界与局限", "组内启发", "算法学习"]
BROWSER_COMMANDS = (
    "msedge",
    "microsoft-edge",
    "microsoft-edge-stable",
    "google-chrome",
    "google-chrome-stable",
    "chromium",
    "chromium-browser",
    "chrome",
)


class RenderError(RuntimeError):
    pass


def _append_candidate(candidates: list[Path], value: str | Path | None) -> None:
    if not value:
        return
    path = Path(value).expanduser()
    if path.is_file():
        resolved = path.resolve()
        if resolved not in candidates:
            candidates.append(resolved)


def browser_candidates(override: Path | None = None) -> list[Path]:
    if override:
        browser = override.resolve()
        if browser.is_file():
            return [browser]
        raise RenderError(f"browser executable does not exist: {browser}")

    candidates: list[Path] = []
    for variable in ("PAPER_PPT_BROWSER", "CHROME_PATH", "EDGE_PATH"):
        _append_candidate(candidates, os.environ.get(variable))
    for command in BROWSER_COMMANDS:
        _append_candidate(candidates, shutil.which(command))

    system = platform.system()
    if system == "Windows":
        roots = [
            os.environ.get("PROGRAMFILES"),
            os.environ.get("PROGRAMFILES(X86)"),
            os.environ.get("LOCALAPPDATA"),
        ]
        relative_paths = (
            "Microsoft/Edge/Application/msedge.exe",
            "Google/Chrome/Application/chrome.exe",
            "Chromium/Application/chrome.exe",
        )
        for root in roots:
            if root:
                for relative in relative_paths:
                    _append_candidate(candidates, Path(root) / relative)
    elif system == "Darwin":
        for candidate in (
            "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
            "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
            "/Applications/Chromium.app/Contents/MacOS/Chromium",
        ):
            _append_candidate(candidates, candidate)
    else:
        for candidate in (
            "/usr/bin/google-chrome",
            "/usr/bin/google-chrome-stable",
            "/usr/bin/microsoft-edge",
            "/usr/bin/chromium",
            "/usr/bin/chromium-browser",
            "/snap/bin/chromium",
        ):
            _append_candidate(candidates, candidate)
    return candidates


def find_browser(override: Path | None) -> Path:
    candidates = browser_candidates(override)
    if candidates:
        return candidates[0]
    raise RenderError(
        "no Chromium-family browser found; set PAPER_PPT_BROWSER or pass --browser"
    )


def browser_version(browser: Path) -> str:
    try:
        completed = subprocess.run(
            [str(browser), "--version"],
            text=True,
            encoding="utf-8",
            errors="replace",
            capture_output=True,
            check=False,
            timeout=10,
        )
    except (OSError, subprocess.TimeoutExpired):
        return "unknown"
    combined = "\n".join((completed.stdout, completed.stderr))
    for line in combined.splitlines():
        if "ERROR:" not in line and re.search(r"(?:Chrome|Chromium|Edge).*[0-9]+\.[0-9]+", line):
            return line.strip()[:240]
    return "unknown"


def build_browser_attempts(
    profile: Path,
    screenshot: Path,
    allow_no_sandbox: bool = False,
) -> list[tuple[str, list[str]]]:
    common = [
        "--hide-scrollbars",
        "--no-first-run",
        "--no-default-browser-check",
        "--force-device-scale-factor=2",
        "--window-size=1100,1600",
        f"--user-data-dir={profile}",
        f"--screenshot={screenshot}",
    ]
    if platform.system() == "Linux":
        common.append("--disable-dev-shm-usage")
    attempts = [
        ("modern-headless", ["--headless=new", "--disable-gpu", *common]),
        (
            "compatibility-headless",
            [
                "--headless",
                "--disable-gpu",
                "--disable-gpu-compositing",
                "--disable-software-rasterizer",
                "--disable-features=Vulkan,UseSkiaRenderer",
                *common,
            ],
        ),
    ]
    if allow_no_sandbox:
        attempts.append(("no-sandbox-fallback", ["--no-sandbox", *attempts[-1][1]]))
    return attempts


def run_browser_command(command: list[str], timeout_seconds: int) -> subprocess.CompletedProcess[str]:
    popen_options: dict[str, object] = {
        "text": True,
        "encoding": "utf-8",
        "errors": "replace",
        "stdout": subprocess.PIPE,
        "stderr": subprocess.PIPE,
    }
    if os.name == "nt":
        popen_options["creationflags"] = getattr(subprocess, "CREATE_NEW_PROCESS_GROUP", 0)
    else:
        popen_options["start_new_session"] = True
    process = subprocess.Popen(command, **popen_options)
    try:
        stdout, stderr = process.communicate(timeout=timeout_seconds)
    except subprocess.TimeoutExpired:
        if os.name == "nt" and shutil.which("taskkill"):
            subprocess.run(
                ["taskkill", "/PID", str(process.pid), "/T", "/F"],
                stdout=subprocess.DEVNULL,
                stderr=subprocess.DEVNULL,
                check=False,
            )
        elif os.name != "nt":
            try:
                os.killpg(process.pid, signal.SIGKILL)
            except OSError:
                pass
        try:
            process.kill()
        except OSError:
            pass
        process.communicate()
        raise
    return subprocess.CompletedProcess(command, process.returncode, stdout, stderr)


def choose_temp_root(output: Path, override: Path | None = None) -> Path:
    candidates = [override, output.parent, Path(tempfile.gettempdir())]
    failures: list[str] = []
    seen: set[Path] = set()
    for candidate in candidates:
        if candidate is None:
            continue
        root = candidate.expanduser().resolve()
        if root in seen:
            continue
        seen.add(root)
        try:
            root.mkdir(parents=True, exist_ok=True)
            with tempfile.TemporaryDirectory(prefix="paper-ppt-probe-", dir=root):
                pass
            return root
        except OSError as exc:
            failures.append(f"{root}: {exc}")
    raise RenderError("no writable temporary directory: " + "; ".join(failures))


def validate_html(path: Path) -> None:
    text = path.read_text(encoding="utf-8")
    if 'class="page"' not in text:
        raise RenderError("HTML does not contain the canonical .page element")
    for label in REQUIRED_LABELS:
        if label not in text:
            raise RenderError(f"HTML is missing required row label: {label}")
    if text.count("<tr") != 6:
        raise RenderError("canonical one-page HTML must contain one header row and five body rows")


def crop_page(screenshot: Path, output: Path) -> tuple[int, int]:
    with Image.open(screenshot) as source:
        image = source.convert("RGB")
        background = Image.new("RGB", image.size, (245, 247, 250))
        difference = ImageChops.difference(image, background).convert("L")
        mask = difference.point(lambda value: 255 if value > 5 else 0)
        bbox = mask.getbbox()
        if not bbox:
            raise RenderError("browser screenshot is blank")
        left, top, right, bottom = bbox
        if right - left < 1200 or bottom - top < 600:
            raise RenderError(f"detected page region is unexpectedly small: {bbox}")
        cropped = image.crop((left, top, right, bottom))
        output.parent.mkdir(parents=True, exist_ok=True)
        cropped.save(output, format="PNG", optimize=True)
        return cropped.size


def render(
    html: Path,
    output: Path,
    browser_override: Path | None = None,
    *,
    temp_dir: Path | None = None,
    timeout_seconds: int = 30,
    allow_no_sandbox: bool = False,
) -> dict[str, object]:
    html = html.resolve()
    output = output.resolve()
    validate_html(html)
    browsers = browser_candidates(browser_override)
    if not browsers:
        raise RenderError(
            "no Chromium-family browser found; set PAPER_PPT_BROWSER or pass --browser"
        )
    output.parent.mkdir(parents=True, exist_ok=True)
    temp_root = choose_temp_root(output, temp_dir)
    attempt_log: list[dict[str, object]] = []
    selected_browser: Path | None = None
    selected_strategy = ""
    output_size: tuple[int, int] | None = None

    for browser in browsers:
        browser_timed_out = False
        with tempfile.TemporaryDirectory(prefix="paper-ppt-one-page-", dir=temp_root) as directory:
            temporary = Path(directory)
            screenshot = temporary / "viewport.png"
            profile = temporary / "browser-profile"
            for strategy, flags in build_browser_attempts(
                profile, screenshot, allow_no_sandbox=allow_no_sandbox
            ):
                screenshot.unlink(missing_ok=True)
                command = [str(browser), *flags, html.as_uri()]
                try:
                    completed = run_browser_command(command, timeout_seconds)
                    detail = (completed.stderr.strip() or completed.stdout.strip())[:1200]
                    status = "failed"
                    if completed.returncode == 0 and screenshot.is_file():
                        try:
                            output_size = crop_page(screenshot, output)
                            status = "succeeded"
                        except RenderError as exc:
                            detail = str(exc)
                    attempt_log.append(
                        {
                            "browser": str(browser),
                            "strategy": strategy,
                            "returncode": completed.returncode,
                            "status": status,
                            "detail": detail,
                        }
                    )
                except subprocess.TimeoutExpired:
                    browser_timed_out = True
                    attempt_log.append(
                        {
                            "browser": str(browser),
                            "strategy": strategy,
                            "returncode": None,
                            "status": "timeout",
                            "detail": f"exceeded {timeout_seconds} seconds",
                        }
                    )
                except OSError as exc:
                    attempt_log.append(
                        {
                            "browser": str(browser),
                            "strategy": strategy,
                            "returncode": None,
                            "status": "launch_error",
                            "detail": str(exc),
                        }
                    )
                if output_size is not None:
                    selected_browser = browser
                    selected_strategy = strategy
                    break
                if browser_timed_out:
                    break
        if output_size is not None:
            break

    if output_size is None or selected_browser is None:
        summary = "; ".join(
            f"{Path(str(item['browser'])).name}/{item['strategy']}: {item['status']} {item['detail']}"
            for item in attempt_log
        )
        raise RenderError(f"all headless browser render attempts failed: {summary}")

    manifest = {
        "renderer": "paper-ppt-one-page-html/0.3.0",
        "html": str(html),
        "html_sha256": hashlib.sha256(html.read_bytes()).hexdigest(),
        "browser": str(selected_browser),
        "browser_version": browser_version(selected_browser),
        "strategy": selected_strategy,
        "platform": platform.platform(),
        "attempts": attempt_log,
        "output": str(output),
        "output_size": list(output_size),
        "required_rows": REQUIRED_LABELS,
    }
    manifest_path = output.with_suffix(".manifest.json")
    manifest_path.write_text(json.dumps(manifest, ensure_ascii=False, indent=2), encoding="utf-8")
    return manifest


def main() -> int:
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("html", type=Path)
    parser.add_argument("-o", "--output", type=Path, required=True)
    parser.add_argument("--browser", type=Path)
    parser.add_argument("--temp-dir", type=Path)
    parser.add_argument("--timeout", type=int, default=30)
    parser.add_argument(
        "--allow-no-sandbox",
        action="store_true",
        help="allow a final Chromium --no-sandbox attempt for isolated CI containers",
    )
    args = parser.parse_args()
    try:
        manifest = render(
            args.html,
            args.output,
            args.browser,
            temp_dir=args.temp_dir,
            timeout_seconds=args.timeout,
            allow_no_sandbox=args.allow_no_sandbox,
        )
    except (OSError, RenderError, UnicodeError) as exc:
        print(f"ERROR: {exc}", file=sys.stderr)
        return 1
    print(f"Rendered fixed one-page HTML: {manifest['output']}")
    print(f"Size: {manifest['output_size'][0]}x{manifest['output_size'][1]}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 196kUpdated Claude CodeCodexVerifiedInstall