@remixmate/cli 0.1.0 → 0.1.2

package/skills/web-capture/scripts/_media_screenshot/template.py

@@ -0,0 +1,119 @@
+"""Storyboard JSON template engine.
+
+Templates live in ``skills/media-screenshot/templates/<name>.json``.
+Each template is a regular storyboard JSON optionally prefixed with a ``_meta``
+block describing the variables it accepts. ``{{var_name}}`` placeholders inside
+string values are replaced; when a string consists of a single placeholder its
+substituted value is auto-coerced to int / float / bool / null so e.g.
+``"scale": "{{zoom_scale}}"`` becomes a number after rendering.
+"""
+from __future__ import annotations
+
+import json
+import re
+import sys
+from pathlib import Path
+from typing import Any
+
+_TEMPLATES_DIR = Path(__file__).resolve().parent.parent.parent / "templates"
+_PLACEHOLDER_RE = re.compile(r"\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}")
+_SOLE_PLACEHOLDER_RE = re.compile(
+    r"^\s*\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}\s*$"
+)
+
+
+def _coerce(s: str) -> Any:
+    low = s.strip().lower()
+    if low == "true":
+        return True
+    if low == "false":
+        return False
+    if low in ("null", "none"):
+        return None
+    try:
+        return int(s)
+    except ValueError:
+        pass
+    try:
+        return float(s)
+    except ValueError:
+        pass
+    return s
+
+
+def _substitute(value: Any, params: dict[str, str]) -> Any:
+    if isinstance(value, str):
+        m = _SOLE_PLACEHOLDER_RE.match(value)
+        if m:
+            key = m.group(1)
+            if key not in params:
+                raise SystemExit(f"模板缺少参数：{key}")
+            return _coerce(str(params[key]))
+
+        def repl(m: re.Match) -> str:
+            key = m.group(1)
+            if key not in params:
+                raise SystemExit(f"模板缺少参数：{key}")
+            return str(params[key])
+
+        return _PLACEHOLDER_RE.sub(repl, value)
+    if isinstance(value, list):
+        return [_substitute(v, params) for v in value]
+    if isinstance(value, dict):
+        return {k: _substitute(v, params) for k, v in value.items()}
+    return value
+
+
+def list_templates() -> list[Path]:
+    if not _TEMPLATES_DIR.exists():
+        return []
+    return sorted(_TEMPLATES_DIR.glob("*.json"))
+
+
+def load_template(name: str) -> dict:
+    """Resolve a template name (or path) to its parsed JSON."""
+    p = Path(name)
+    if not p.exists():
+        p = _TEMPLATES_DIR / f"{name}.json"
+    if not p.exists():
+        avail = ", ".join(t.stem for t in list_templates()) or "(none)"
+        raise SystemExit(f"模板不存在：{name}\n可用模板：{avail}")
+    try:
+        return json.loads(p.read_text())
+    except json.JSONDecodeError as e:
+        raise SystemExit(f"模板 JSON 解析失败 {p}: {e}")
+
+
+def render_template(name: str, params: dict[str, str]) -> dict:
+    """Load, validate against ``_meta.params``, render, return the storyboard."""
+    tpl = load_template(name)
+    meta = tpl.pop("_meta", {})
+    declared = meta.get("params", {}) or {}
+
+    final: dict[str, str] = {}
+    for key, spec in declared.items():
+        if isinstance(spec, dict) and "default" in spec:
+            final[key] = str(spec["default"])
+    for key, val in params.items():
+        if declared and key not in declared:
+            print(
+                f"[template] 警告：参数 {key} 未在 _meta.params 中声明",
+                file=sys.stderr,
+            )
+        final[key] = val
+    for key, spec in declared.items():
+        if isinstance(spec, dict) and spec.get("required") and key not in final:
+            raise SystemExit(
+                f"模板 {name} 要求参数 {key}（{spec.get('description', '')}）"
+            )
+    return _substitute(tpl, final)
+
+
+def parse_param_pairs(pairs: list[str] | None) -> dict[str, str]:
+    out: dict[str, str] = {}
+    for raw in pairs or []:
+        if "=" not in raw:
+            raise SystemExit(f'--param 需要 "key=value" 格式：{raw}')
+        k, v = raw.split("=", 1)
+        out[k.strip()] = v
+    return out

package/skills/web-capture/scripts/_media_screenshot/trim.py

@@ -0,0 +1,82 @@
+"""End-anchored ffmpeg trim for storyboard videos.
+
+Playwright's recorded video timeline does NOT align 1:1 with Python wall-clock —
+recording starts before the first navigation finishes and the file is typically
+a few seconds longer than the wall-clock window we measured. The storyboard
+ends right before ``context.close()``, which IS the video's tail. So we anchor
+on the END.
+"""
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+
+def _probe_duration(path: Path) -> float | None:
+    if not shutil.which("ffprobe"):
+        return None
+    r = subprocess.run(
+        [
+            "ffprobe", "-v", "error", "-show_entries", "format=duration",
+            "-of", "default=noprint_wrappers=1:nokey=1", str(path),
+        ],
+        capture_output=True, text=True, check=False,
+    )
+    try:
+        return float(r.stdout.strip())
+    except ValueError:
+        return None
+
+
+def trim_video(out: Path, start_ms: int, end_ms: int) -> None:
+    if not shutil.which("ffmpeg"):
+        print(
+            "[record] 安装 ffmpeg 可自动裁剪开头加载段。",
+            file=sys.stderr,
+        )
+        return
+    if end_ms <= start_ms:
+        return
+
+    storyboard_ms = end_ms - start_ms
+    lead_ms = 80
+    tail_ms = 200
+    keep_ms = storyboard_ms + lead_ms + tail_ms
+
+    video_dur = _probe_duration(out)
+    if video_dur is None:
+        # Fallback: start-anchored (legacy, may be off if recording drifts).
+        start_s = max(0.0, (start_ms - lead_ms) / 1000.0)
+        duration_s = keep_ms / 1000.0
+    else:
+        # End-anchored: video tail == storyboard end == context.close.
+        start_s = max(0.0, video_dur - keep_ms / 1000.0)
+        duration_s = video_dur - start_s
+
+    tmp = out.with_suffix(out.suffix + ".trim.webm")
+    cmd = [
+        "ffmpeg", "-y", "-loglevel", "error",
+        "-ss", f"{start_s:.3f}", "-i", str(out),
+        "-t", f"{duration_s:.3f}",
+        "-c:v", "libvpx", "-b:v", "2M",
+        "-deadline", "realtime", "-cpu-used", "4",
+        "-an", str(tmp),
+    ]
+    print(
+        f"[record] ffmpeg trim (re-encode, end-anchored): "
+        f"skip {start_s:.2f}s, keep {duration_s:.2f}s "
+        f"(video={video_dur and f'{video_dur:.2f}s'}, storyboard={storyboard_ms/1000:.2f}s)",
+        file=sys.stderr,
+    )
+    r = subprocess.run(cmd, check=False)
+    if r.returncode == 0 and tmp.exists() and tmp.stat().st_size > 0:
+        os.replace(tmp, out)
+    else:
+        try:
+            tmp.unlink(missing_ok=True)
+        except OSError:
+            pass
+        print("[record] ffmpeg 裁剪失败，保留原始视频。", file=sys.stderr)

package/skills/web-capture/scripts/record.py

@@ -0,0 +1,186 @@
+#!/usr/bin/env python3
+"""Playwright 录屏入口（薄壳，逻辑在 _media_screenshot 包）。
+
+模式：
+  - 固定时长 / 条件停止（--duration / --stop-when-*）
+  - 自动滚动（--scroll-through）
+  - 自定义分镜（--storyboard <json>）
+  - 模板分镜（--template <name> --param k=v ...）
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+from _media_screenshot import (  # noqa: E402
+    cli_args,
+    do_record,
+    do_storyboard,
+    template,
+    trim,
+)
+
+
+def main() -> None:
+    ap = argparse.ArgumentParser(
+        description="通过 Playwright Python API 对网页录屏，输出 .webm。"
+    )
+    ap.add_argument(
+        "-u", "--url",
+        help="待录制的页面 URL（如未指定，模板/storyboard 必须包含 url）",
+    )
+    ap.add_argument(
+        "-o", "--output", default="recording.webm",
+        help="本地输出 .webm 路径（默认 recording.webm）",
+    )
+
+    # plain recording stop conditions
+    ap.add_argument("--duration", type=int, help="固定录制时长（毫秒）")
+    ap.add_argument("--stop-when-selector", help="选择器出现就停")
+    ap.add_argument("--stop-when-hidden", help="选择器消失就停")
+    ap.add_argument(
+        "--max-duration", type=int, default=60000,
+        help="安全上限（ms），用 stop-when-* 时防挂死",
+    )
+
+    # scroll-through
+    ap.add_argument(
+        "--scroll-through", action="store_true",
+        help="录制时自动从顶部平滑滚到底部",
+    )
+    ap.add_argument("--scroll-step", type=int, default=60)
+    ap.add_argument("--scroll-interval", type=int, default=50)
+    ap.add_argument("--scroll-pause-top", type=int, default=800)
+    ap.add_argument("--scroll-pause-bottom", type=int, default=1200)
+
+    # storyboard / template
+    ap.add_argument("--storyboard", help="分镜 JSON 文件路径")
+    ap.add_argument(
+        "--template",
+        help="使用 templates/<name>.json 模板，配合 --param 传参",
+    )
+    ap.add_argument(
+        "--param", action="append", default=[], metavar="KEY=VALUE",
+        help="给模板传参，可重复",
+    )
+    ap.add_argument(
+        "--list-templates", action="store_true",
+        help="列出可用模板并退出",
+    )
+
+    cli_args.add_common_args(ap)
+
+    args = ap.parse_args()
+
+    if args.list_templates:
+        for tpl in template.list_templates():
+            print(tpl.stem)
+        return
+
+    if args.template and args.storyboard:
+        print("--template 与 --storyboard 互斥，请二选一。", file=sys.stderr)
+        sys.exit(2)
+
+    if not (
+        args.duration or args.stop_when_selector or args.stop_when_hidden
+        or args.scroll_through or args.storyboard or args.template
+    ):
+        print(
+            "需至少提供 --duration / --stop-when-selector / --stop-when-hidden "
+            "/ --scroll-through / --storyboard / --template 之一。",
+            file=sys.stderr,
+        )
+        sys.exit(2)
+
+    if not args.output.lower().endswith(".webm"):
+        print(
+            "提示：Playwright 录屏输出为 webm，建议 --output 用 .webm 后缀。",
+            file=sys.stderr,
+        )
+
+    storage_path, is_temp = cli_args.build_storage(args)
+
+    cfg: dict = {
+        "output": str(Path(args.output).resolve()),
+        "browser": args.browser or "chromium",
+        "maxDuration": args.max_duration,
+    }
+    if args.url:
+        cfg["url"] = args.url
+    cli_args.common_args_to_cfg(args, cfg)
+    if storage_path:
+        cfg["storageState"] = storage_path
+
+    story: dict | None = None
+    if args.template:
+        params = template.parse_param_pairs(args.param)
+        story = template.render_template(args.template, params)
+    elif args.storyboard:
+        try:
+            story = json.loads(Path(args.storyboard).read_text())
+        except (OSError, json.JSONDecodeError) as e:
+            print(f"--storyboard 读取/解析失败：{e}", file=sys.stderr)
+            sys.exit(2)
+
+    if story is not None:
+        for key in ("scenes", "transition"):
+            if key in story:
+                cfg[key] = story[key]
+        for key in (
+            "url", "viewport", "device", "colorScheme", "userAgent",
+            "ignoreHttpsErrors", "waitForSelector", "waitForTimeout",
+            "waitForReadySelectors", "settleMs",
+        ):
+            if key in story:
+                cfg[key] = story[key]
+
+    if args.duration:
+        cfg["duration"] = args.duration
+    if args.stop_when_selector:
+        cfg["stopWhenSelector"] = args.stop_when_selector
+    if args.stop_when_hidden:
+        cfg["stopWhenHidden"] = args.stop_when_hidden
+    if args.scroll_through:
+        cfg["scrollThrough"] = True
+        cfg["scrollStep"] = args.scroll_step
+        cfg["scrollInterval"] = args.scroll_interval
+        cfg["scrollPauseTop"] = args.scroll_pause_top
+        cfg["scrollPauseBottom"] = args.scroll_pause_bottom
+
+    if not cfg.get("url"):
+        print(
+            "必须提供 URL：通过 --url，或在模板 / storyboard JSON 里定义 url。",
+            file=sys.stderr,
+        )
+        sys.exit(2)
+
+    is_storyboard = story is not None
+    print(
+        f"[runner] mode={'storyboard' if is_storyboard else 'record'}",
+        file=sys.stderr,
+    )
+    try:
+        if is_storyboard:
+            out, start_ms, end_ms = do_storyboard(cfg)
+            trim.trim_video(out, start_ms, end_ms)
+        else:
+            out = do_record(cfg)
+    finally:
+        if is_temp and storage_path:
+            try:
+                os.unlink(storage_path)
+            except OSError:
+                pass
+
+    if not out.exists():
+        print(f"录屏未生成：{out}", file=sys.stderr)
+        sys.exit(1)
+    print(str(out))
+
+
+if __name__ == "__main__":
+    main()

package/skills/web-capture/scripts/screenshot.py

@@ -0,0 +1,94 @@
+#!/usr/bin/env python3
+"""Playwright 截屏入口（薄壳，逻辑在 _media_screenshot 包）。"""
+from __future__ import annotations
+
+import argparse
+import os
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+from _media_screenshot import cli_args, do_screenshot  # noqa: E402
+
+
+def main() -> None:
+    ap = argparse.ArgumentParser(
+        description="通过 Playwright 对网页进行截屏，仅落盘到本地路径。"
+    )
+    ap.add_argument("-u", "--url", required=True, help="待截屏的页面 URL")
+    ap.add_argument(
+        "-o", "--output", default="screenshot.png",
+        help="本地输出路径（默认 screenshot.png）",
+    )
+    ap.add_argument("--full-page", action="store_true", help="整页截屏")
+    ap.add_argument("--selector", help='截某个 CSS 元素本身（如 ".card"）')
+    ap.add_argument(
+        "--clip",
+        help='区域截屏 "x,y,w,h"（像素）。与 --selector 同设时以元素 boundingBox 为基点偏移。',
+    )
+    ap.add_argument(
+        "--no-scroll-into-view", action="store_true",
+        help="--selector 模式下关闭自动滚动",
+    )
+    ap.add_argument(
+        "--hide-selector", action="append", default=[],
+        help='截屏前 display:none 该 CSS 选择器（隐藏 cookie banner、登录浮层等）。可重复。',
+    )
+    ap.add_argument(
+        "--mask-selector", action="append", default=[],
+        help='截屏时用 Playwright 原生 mask 涂盖该 CSS 选择器（默认粉色块）。可重复。',
+    )
+    ap.add_argument(
+        "--mask-color",
+        help='--mask-selector 的填充色（如 "#000" / "rgba(0,0,0,0.9)"），默认 Playwright 粉色。',
+    )
+    ap.add_argument(
+        "--annotate",
+        help='注释 JSON 文件或字符串：在截屏前用 storyboard 场景（highlight/arrow/caption/title-card/sequence/redact 等）画注解。'
+        ' 顶层可为数组或 {"annotations": [...], "settleMs": 900}。',
+    )
+    cli_args.add_common_args(ap)
+
+    args = ap.parse_args()
+    storage_path, is_temp = cli_args.build_storage(args)
+
+    cfg: dict = {
+        "url": args.url,
+        "output": str(Path(args.output).resolve()),
+        "browser": args.browser or "chromium",
+        "fullPage": bool(args.full_page),
+        "scrollIntoView": not args.no_scroll_into_view,
+    }
+    cli_args.common_args_to_cfg(args, cfg)
+    if storage_path:
+        cfg["storageState"] = storage_path
+    if args.selector:
+        cfg["selector"] = args.selector
+    if args.clip:
+        cfg["clip"] = cli_args.parse_clip(args.clip)
+    if args.hide_selector:
+        cfg["hideSelectors"] = list(args.hide_selector)
+    if args.mask_selector:
+        cfg["maskSelectors"] = list(args.mask_selector)
+    if args.mask_color:
+        cfg["maskColor"] = args.mask_color
+    if args.annotate:
+        cfg["annotate"] = args.annotate
+
+    try:
+        out = do_screenshot(cfg)
+    finally:
+        if is_temp and storage_path:
+            try:
+                os.unlink(storage_path)
+            except OSError:
+                pass
+
+    if not out.exists():
+        print(f"截屏未生成：{out}", file=sys.stderr)
+        sys.exit(1)
+    print(str(out))
+
+
+if __name__ == "__main__":
+    main()

package/skills/web-capture/skill.json

@@ -2,27 +2,28 @@
   "name": "web-capture",
   "toolName": "web_capture",
   "tier": "tool",
+  "category": "consuming",
   "title": "Web Page Capture",
-  "description": "Drive a headless browser (Playwright) to capture a web page: viewport/full-page screenshots, or a smooth top-to-bottom scrolling video. Produces PNG / MP4 assets that feed the screen-walkthrough template.",
+  "description": "Drive a headless browser (Playwright Python) to capture any URL to local files: full-page / element / region screenshots, fixed-duration / condition-triggered / auto-scroll recordings, and storyboard videos (highlight / focus / zoom / scroll / virtual-cursor click / caption / title-card / arrow / numbered sequence / redact / code-line highlight). Two entry scripts: scripts/screenshot.py (stills) and scripts/record.py (webm video, storyboards, templates).",
   "envVars": ["WEB_CAPTURE_BROWSER", "WEB_CAPTURE_OUTPUT_BASE", "WEB_CAPTURE_NO_SANDBOX", "WEB_CAPTURE_ALLOW_PRIVATE_HOSTS", "PLAYWRIGHT_BROWSERS_PATH"],
-  "scriptPath": "scripts/web_capture.py",
+  "entry": { "type": "python", "scriptPath": "scripts/screenshot.py" },
+  "scriptPath": "scripts/screenshot.py",
   "parameters": {
     "type": "object",
     "properties": {
       "url": { "type": "string", "description": "Target page URL (http/https)" },
-      "mode": { "type": "string", "description": "screenshot | scroll-video | record-video (default screenshot)" },
-      "output_dir": { "type": "string", "description": "Output directory (default ./web_capture_<timestamp>)" },
-      "width": { "type": "number", "description": "Viewport width in px (default 1280)" },
-      "height": { "type": "number", "description": "Viewport height in px (default 720)" },
-      "device_scale_factor": { "type": "number", "description": "Device pixel ratio for crisp/retina output (default 2)" },
-      "full_page": { "type": "boolean", "description": "screenshot mode: capture the whole scrollable page" },
-      "selector": { "type": "string", "description": "screenshot mode: capture only the element matching this CSS selector" },
-      "fps": { "type": "number", "description": "scroll/record video frames per second (default 30)" },
-      "scroll_duration": { "type": "number", "description": "Seconds for the full top-to-bottom scroll (default 8)" },
+      "output": { "type": "string", "description": "Local output path (screenshot.py: *.png, default screenshot.png)" },
       "browser": { "type": "string", "description": "chromium | firefox | webkit (default chromium)" },
-      "wait_until": { "type": "string", "description": "load | domcontentloaded | networkidle (default networkidle)" },
-      "wait_ms": { "type": "number", "description": "Extra wait after load before capture, in ms (default 1500)" },
-      "json_output": { "type": "boolean", "description": "Pipeline mode — emit only the manifest JSON on stdout" }
+      "device": { "type": "string", "description": "Device emulation name, e.g. 'iPhone 15 Pro'" },
+      "viewport": { "type": "string", "description": "Viewport as 'width,height', e.g. '1280,800'" },
+      "full_page": { "type": "boolean", "description": "screenshot.py: capture the whole scrollable page" },
+      "selector": { "type": "string", "description": "screenshot.py: capture only the element matching this CSS selector" },
+      "clip": { "type": "string", "description": "screenshot.py: region clip 'x,y,w,h' (combined with selector = offset from element box)" },
+      "wait_for_selector": { "type": "string", "description": "Wait for this CSS selector before acting" },
+      "wait_for_timeout": { "type": "number", "description": "Fixed wait (ms) before acting" },
+      "annotate": { "type": "string", "description": "screenshot.py: annotation JSON file or string (array or {annotations, settleMs})" },
+      "storage_state": { "type": "string", "description": "storageState JSON file path (logged-in capture)" },
+      "cookies": { "type": "string", "description": "Playwright cookies JSON string or file (top-level array)" }
     },
     "required": ["url"]
   }

package/skills/web-capture/templates/github-code-tour.json

@@ -0,0 +1,59 @@
+{
+  "_meta": {
+    "description": "GitHub 代码导览：跳转到指定文件 → 高亮行范围 → 字幕解说。适合讲解一段关键代码。",
+    "params": {
+      "file_url": {
+        "required": true,
+        "description": "GitHub blob 文件 URL，如 https://github.com/user/repo/blob/main/src/x.py"
+      },
+      "start_line": {
+        "required": true,
+        "description": "起始行号（含）"
+      },
+      "end_line": {
+        "required": true,
+        "description": "结束行号（含）"
+      },
+      "label": {
+        "default": "关键代码",
+        "description": "行高亮旁的标签"
+      },
+      "caption_text": {
+        "default": "重点看这里",
+        "description": "下方字幕条文字"
+      },
+      "highlight_color": {
+        "default": "#ff9500",
+        "description": "行高亮颜色"
+      },
+      "line_pattern": {
+        "default": "[data-line-number=\"{n}\"]",
+        "description": "行选择器模板（{n} 替换为行号）。新版 React Blob 默认值即可；旧版 blob 表格用 \"#LC{n}\""
+      }
+    }
+  },
+  "url": "{{file_url}}",
+  "viewport": [1440, 900],
+  "waitForReadySelectors": [
+    "[data-line-number=\"1\"], #LC1"
+  ],
+  "settleMs": 1500,
+  "transition": { "fadeOutMs": 280, "gapMs": 150 },
+  "scenes": [
+    {
+      "type": "code-lines",
+      "startLine": "{{start_line}}",
+      "endLine": "{{end_line}}",
+      "linePattern": "{{line_pattern}}",
+      "color": "{{highlight_color}}",
+      "label": "{{label}}",
+      "duration": 4000
+    },
+    {
+      "type": "caption",
+      "text": "{{caption_text}}",
+      "position": "bottom",
+      "duration": 3500
+    }
+  ]
+}

package/skills/web-capture/templates/github-readme-tour.json

@@ -0,0 +1,77 @@
+{
+  "_meta": {
+    "description": "GitHub 仓库 README 巡览：开场标题卡 → 项目名高亮 → ⭐ Star 点击演示 → README 滚动 → 结尾呼吁。",
+    "params": {
+      "repo_url": {
+        "required": true,
+        "description": "GitHub 仓库完整 URL"
+      },
+      "title": {
+        "default": "项目介绍",
+        "description": "开场大标题"
+      },
+      "subtitle": {
+        "default": "60s 速览",
+        "description": "开场副标题"
+      },
+      "outro_text": {
+        "default": "感兴趣？点 ⭐ 支持一下！",
+        "description": "结尾大字"
+      },
+      "scroll_duration": {
+        "default": "12000",
+        "description": "README 滚动时长（ms）"
+      },
+      "accent_color": {
+        "default": "#ff3b30",
+        "description": "标题卡 accent / 高亮主色"
+      }
+    }
+  },
+  "url": "{{repo_url}}",
+  "viewport": [1440, 900],
+  "waitForReadySelectors": [
+    "article.markdown-body",
+    "#repo-stars-counter-star"
+  ],
+  "settleMs": 1200,
+  "transition": { "fadeOutMs": 320, "gapMs": 180 },
+  "scenes": [
+    {
+      "type": "title-card",
+      "title": "{{title}}",
+      "subtitle": "{{subtitle}}",
+      "accent": "{{accent_color}}",
+      "duration": 2200
+    },
+    {
+      "type": "highlight",
+      "selector": "strong[itemprop=\"name\"] a",
+      "color": "{{accent_color}}",
+      "lineWidth": 5,
+      "padding": 10,
+      "label": "项目名称",
+      "duration": 2500
+    },
+    {
+      "type": "hover",
+      "selector": "#repo-stars-counter-star",
+      "moveMs": 700,
+      "holdMs": 1800
+    },
+    {
+      "type": "scroll",
+      "fromSelector": "article.markdown-body",
+      "step": 50,
+      "interval": 70,
+      "duration": "{{scroll_duration}}",
+      "holdAtEnd": 800
+    },
+    {
+      "type": "title-card",
+      "title": "{{outro_text}}",
+      "accent": "{{accent_color}}",
+      "duration": 2500
+    }
+  ]
+}