Communitygithub.com

Manavv007/S.A.R.A.L.-方案访问检索分析层-

HyperFrames CLI 开发循环。用于执行 npx hyperframes init、add、catalog、capture、lint、validate、inspect、layout、snapshot、preview、play、render、publish、lambda、doctor、browser、info、upgrade、skills、compositions、docs、benchmark、telemetry、transcribe、tts 或 remove-background 等命令,或排查 HyperFrames 构建/渲染环境问题时使用。也是 AWS Lambda 云端渲染(`hyperframes lambda deploy / render / progress / destroy / policies`)的入口点。

S.A.R.A.L.-方案访问检索分析层- 是什么?

此技能作为 HyperFrames CLI 的中央开发循环入口,涵盖了从项目初始化到最终渲染的完整工作流。它指导 AI 代理和开发者使用特定命令顺序(初始化、编写、lint、validate、inspect、preview、render)来高效构建视频项目,并通过集成 lint、validate 和 inspect 等检查机制,确保在预览前捕获常见错误,如缺失的 data-composition-id、重叠轨道、CSS 问题以及跨文件子组件挂载失败。该技能支持多种渲染途径,包括本地迭代、最终交付、Docker 跨主机复现以及用于大型或长时间任务的 AWS Lambda 云端渲染,并提供详细的 CI/CD 集成指南。核心优势在于其严格的验证门控和明确的代理约定,例如所有命令都支持 `--json` 输出、非 TTY 模式自动检测、渲染前必须先进入 preview 阶段供用户审查,以及渲染后的输出文件验证。它通过将操作分门别类到各个参考文档,并明确定义与其他技能(如 hyperframes-core、hyperframes-registry、hyperframes-media)的交接点,实现了模块化扩展。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-/tree/HEAD/.agents/skills/hyperframes-cli

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

HyperFrames CLI

所有操作都通过 npx hyperframes 执行,除非项目说明指定了本地包装器(wrapper)。必须严格遵守本地包装器的指示。需要 Node.js >= 22 和 FFmpeg。

工作流

  1. 脚手架搭建 — npx hyperframes init my-video(或从 URL 执行 capture)
  2. 编写 — 编写 HTML 合成(参见 hyperframes-core 技能)
  3. 代码检查 — npx hyperframes lint
  4. 验证 — npx hyperframes validate(运行时错误 + 对比度)
  5. 可视化检查 — npx hyperframes inspect
  6. 预览 — npx hyperframes preview 打开 Studio,这是一个时间线编辑器,用户可以在其中手动编辑任何内容(而不仅仅是观看)。在此处审查,然后请求进行渲染。
  7. 渲染 — 选择变体:
    • 迭代:npx hyperframes render --quality draft
    • 交付:npx hyperframes render --quality high --output out.mp4
    • CI / 跨主机复现:npx hyperframes render --docker --strict --output out.mp4
    • 云(长/大型):npx hyperframes lambda render ./my-project --width 1920 --height 1080 --wait(参见下面的 Lambda)

在预览之前运行 lint、validate 和 inspect。lint 可捕获缺失的 data-composition-id、重叠轨道以及未注册的时间线。validate 在无头 Chrome 中加载合成,并报告运行时控制台错误以及 WCAG 对比度问题。inspect 会遍历时间线,并报告文本溢出气泡/容器或画布的情况——并且,当存在 *.motion.json 伴生文件时,它会根据相同的遍历时间线验证运动意图(入场在 seek 时触发、交错顺序、在帧内、活跃性)。

对于运动密集型工作,建议优先使用基于快照(snapshot)的迭代和 *.motion.json 伴生文件——有关规范和实践,请参阅 references/lint-validate-inspect.md。

代理约定

适用于每个命令的交叉规则:

  • --json 在所有命令上都可用,但 render、preview 和 play 除外。 对于任何代理/CI 调用的支持命令,请使用它;输出包含一个 _meta 信封(cli 版本、最新可用版本、更新建议)。render 仅通过 stdout + 退出码报告状态——通过下面的渲染后检查验证成功;preview / play 是服务器,不支持 JSON。
  • doctor --json 始终以 0 退出,即使环境已损坏。通过检查载荷的 ok 字段来判定:npx hyperframes doctor --json | jq -e '.ok' > /dev/null。这可以使流水线免受 CLI 版本更新的影响。
  • 非 TTY 模式是自动检测的。 当 stdout 不是 TTY(CI、代理、管道输出)时,CLI 会自动切换到非交互模式;此时 init 需要 --example。传递 --non-interactive 以在 TTY 上强制启用此模式。
  • CI 渲染门控:--strict 在 lint 错误时失败,--strict-all 在警告时也失败,--strict-variables 在未声明的 --variables 键上失败。
  • --json 中的路径会被清除 — $HOME 变成字面量 $HOME,以便输出可以安全地粘贴到错误报告和代理上下文中。
  • 渲染需用户许可。 检查通过后绝不要自动渲染。在 preview 处暂停,告知用户视频在 Studio 中可编辑,并且仅在他们批准后才渲染。
  • 渲染后验证。 在 render 返回退出码 0 后,请确认输出文件存在且大小合理,然后再报告成功:[ -s "$OUTPUT" ] || echo "render produced no output"。CLI 成功时会打印 ◇ <path>;对于长时间渲染,还可以使用 ffprobe -i "$OUTPUT" -show_format -v error 做健全性检查。

路由

目的…请阅读
搭建项目脚手架(init、capture、skills)references/init-and-scaffold.md
检查正确性(lint、validate、inspect、snapshot)references/lint-validate-inspect.md
预览或渲染(preview、play、render、publish)references/preview-render.md
诊断环境(doctor、browser)references/doctor-browser.md
在 AWS Lambda 上进行云端渲染(lambda deploy / sites / render / progress / destroy / policies)references/lambda.md
其他一切(info、upgrade、compositions、docs、benchmark、telemetry、资源预处理)references/upgrade-info-misc.md

跨技能交接

  • Tailwind 项目(init --tailwind)→ 在编辑类或主题令牌之前,使用 hyperframes-core(Tailwind 参考)。
  • 注册表块/组件(hyperframes add、hyperframes catalog)→ 使用 hyperframes-registry 获取安装路径、子合成接线和代码片段合并。
  • 资源预处理(tts、transcribe、remove-background)→ 使用 hyperframes-media 进行语音选择、Whisper 模型规则、字幕以及 TTS 到字幕的链式处理。
  • 参数化渲染(--variables)→ 通过 <html> 上的 data-composition-variables 声明;完整架构请参见 hyperframes-core。

Lambda(云端渲染)

hyperframes lambda 将分布式渲染部署到 AWS Lambda,并从您的笔记本电脑或 CI 驱动渲染。端到端需要三个命令:

npx hyperframes lambda deploy                                             # 配置 SAM 堆栈(Lambda + Step Functions + S3)
npx hyperframes lambda render ./my-project --width 1920 --height 1080 --wait
npx hyperframes lambda destroy                                            # 拆除(S3 存储桶会被保留)

当一个渲染对于单个主机而言太长/太大(多分钟视频、4K、大量并行批次)并且您已配置 AWS 凭据时,请使用 Lambda。对于开发循环迭代,请坚持使用本地 render。

有关先决条件、全部 6 个子命令(deploy、sites create、render、progress、destroy、policies)、IAM 策略验证、状态文件以及成本/清理规则,请参阅 references/lambda.md。

最小完成门控

静态门控

npx hyperframes lint
npx hyperframes validate

对于布局敏感的工作,添加 inspect;在 CI 中添加 render --strict 以便在 lint 错误时失败。

视觉冒烟测试——当项目使用子合成时必需

lint / validate / inspect 各自独立地评估每个合成。它们从不加载 index.html 并通过 data-composition-src 挂载子合成,因此它们无法捕获跨文件挂载失败(参见 hyperframes-core → references/sub-compositions.md,“常见陷阱”)。唯一能捕获它们的门控是实际加载 index.html 并遍历时间线的门控。

使用 hyperframes snapshot——它加载项目的方式与 render 相同(因此它执行相同的挂载路径),但只捕获您请求的时间戳,因此只需几秒钟而不是完整渲染:

# 在每个子合成的中点捕获一帧。
# 中点 = index.html 中每个宿主插槽的 data-start + data-duration/2。
npx hyperframes snapshot --at <t1>,<t2>,<t3>,...

# 或者,如果您不需要针对每个场景,可以使用均匀间隔的样本:
npx hyperframes snapshot --frames 9

输出位于 snapshots/frame-NN-at-Xs.png。目视检查每一帧是否与场景计划相符。

每帧的红色标记(每个都对应静态门控遗漏的特定失败模式):

您看到的内容根本原因
文本在左上角显示为微小且无样式<style> 块被留在 <head> 中,位于 <template> 之外(陷阱 1)——没有 CSS 到达实时 DOM
SVG/图标元素放大到画布尺寸同上——未应用宽度/高度约束
场景的主角元素完全缺失;仅背景和水印可见宿主 id ≠ 模板 id(陷阱 2)——时间线从未运行,帧在初始状态捕获
快照命令记录 Sub-composition timelines not registered after 45000ms陷阱 2——直接确认

snapshots/ 可以在目视检查后删除;面向用户的最终渲染是另一个独立的 npx hyperframes render 过程。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

Manavv007/S.A.R.A.L.-Scheme-Access-Retrieval-Analysis-Layer-

S.A.R.A.L. is an advanced AI-powered platform designed to bridge the "information gap" between rural Indian citizens and government welfare. While thousands of schemes exist, the complex language of official PDFs often makes them inaccessible to the common man.

相关技能