Communitygithub.com

网页视频嵌入优化

将现有视频优化并嵌入为快速、清晰、自动播放的网站英雄区/背景/循环视频。适用于添加或替换营销网站视频时,文件过大、无法自动播放(尤其在移动端/Safari 上)、出现编解码器错误或画质模糊的场景——将其转码为具有正确像素格式、快速启动、视网膜适配尺寸和封面帧的 Web 安全 H.264 视频,然后嵌入并验证其实际播放效果。此技能处理的是已有素材的优化与嵌入,而非创建/制作动画视频(如需创建请使用 remotion/moviepy/motion-canvas)。当用户说“把这个视频添加到网站上”、“英雄区视频太大/无法播放/不清晰”、“替换首页视频”或“让它在落地页上循环播放”时使用。

网页视频嵌入优化 是什么?

该技能专注于将原始视频素材高效优化为适用于网站的英雄区、背景或循环演示视频。它通过自动探测视频参数,并利用 FFmpeg 进行转码,生成视网膜适配的 H.264 视频(像素格式为 yuv420p,启用快速启动标记),从而显著减小文件大小并解决跨平台特别是 Safari 浏览器上的自动播放问题。转码过程中,它会按照 CSS 显示宽度的约 2 倍进行缩放,并通过恒定质量参数确保画质无损。此外,技能还会生成一个代表性的封面帧,并提供标准的 HTML 嵌入代码(包含 autoplay、muted、playsinline 等必备属性)。最终,它会利用 Chrome DevTools Protocol 在无用户手势要求的环境下验证视频的实际播放状态,确保 readyState、paused 和 currentTime 等指标符合预期。该技能适用于 Claude Code、Cursor、Codex 等 AI 代理平台,能够自动化处理网站视频优化与嵌入的完整流程。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ever-just/agentskills/tree/HEAD/skills/web-embed-video-optimization

在你喜欢的 AI 中提问

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

预览

来自技能 README

文档

Web 视频嵌入优化

将原始剪辑(屏幕录制、手机导出、HEVC 渲染)转换为快速、清晰、可靠自动播放的英雄区/背景/循环视频并嵌入。通常能带来显著收益:视网膜适配的 H.264 在合理的 CRF 下可将 1080p 屏幕录制从约 8 MB 降至约 1.5 MB,且无明显画质损失,并修复自动播放/编解码器问题。

如需创建或制作动画视频,请改用 [[remotion]] / [[moviepy]] / [[motion-canvas]]——本技能仅优化您已有的素材。

何时使用

  • 在网站上添加/替换英雄区、背景或循环演示视频。
  • 视频文件太大、无法自动播放(移动端/Safari)、编解码器报错或画质模糊。

操作步骤

1. 先探测

ffprobe -v error -select_streams v:0 \
  -show_entries stream=codec_name,width,height,r_frame_rate,duration,pix_fmt,profile \
  -of default=noprint_wrappers=1 in.mp4
ffprobe -v error -select_streams a -show_entries stream=codec_name -of csv=p=0 in.mp4   # 是否有音频?
# faststart 检查:'moov' 是否在 'mdat' 之前?(moov 在末尾 = 启动慢)

2. 转码(Web 安全 + 视网膜适配)

ffmpeg -y -i in.mp4 -vf "scale=1600:-2" \
  -c:v libx264 -profile:v high -pix_fmt yuv420p -crf 23 -preset slow \
  -movflags +faststart -an -r 30 out.mp4
  • -pix_fmt yuv420p — Safari 和广泛兼容所必需(yuv444/422 无法播放)。
  • -movflags +faststart — 将 moov 原子移到文件开头,以便在完全下载前就能开始播放。没有它,自动播放的英雄区视频会在慢速链接上卡顿。
  • -an — 去除音频;静音背景循环从来不需要(文件更小)。
  • scale=1600:-2 — 编码为大约 CSS 显示宽度的 2 倍,而非原生 1080p/4K 分辨率。在 ≤820px 宽的框架中,1600px 既达到视网膜清晰度又更轻量。-2 保持高度为偶数(H.264 的要求)。
  • -crf 23 -preset slow — 高质量,出色压缩。屏幕/UI 内容压缩效果特别好;如果文件仍然太大才将 CRF 提高到 25–26。

3. 封面帧

ffmpeg -y -ss 3 -i in.mp4 -vframes 1 -vf "scale=1600:-2" -q:v 3 poster.jpg

选择一个有代表性的瞬间(-ss),而不是空白的开场帧。

4. 嵌入

<video autoplay muted loop playsinline preload="auto" poster="/path/poster.jpg">
  <source src="/path/out.mp4" type="video/mp4"/>
</video>
  • muted + playsinline + autoplay — 移动端自动播放都需要这些属性。
  • 容器 CSS:video{display:block;width:100%;height:auto} 让 16:9 剪辑自行设置高度;用 overflow:hidden;border-radius 的 div 包裹。

5. 服务端(Odoo 租户)

存储为公共 ir.attachment,并通过 /web/content/<id>(视频)和 /web/image/<id>(封面)引用——参见 [[everjust-website-customization]]。通过 docker cp 传输二进制文件(Shell 在容器内运行)。使用新的附件 ID 并重新指向视图,而不是覆盖旧 ID,以避免浏览器/CDN 缓存过期。视图编辑后需要重启容器才能生效。

验证(必须执行)

使用 [[cdp-render-verification]] 确认视频确实能播放——用 --autoplay-policy=no-user-gesture-required 启动 Chrome,然后读取 <video> 元素:

  • readyState === 4(HAVE_ENOUGH_DATA),paused === false,短暂等待后 currentTime > 0(正在前进),且 videoWidth/videoHeight 与编码参数匹配。
  • 检查桌面端和移动端,并确保页面没有水平溢出。

相关

  • [[everjust-website-customization]] — 通过 Odoo 附件服务 + 视图嵌入。
  • [[cdp-render-verification]] — 播放验证方法。
  • [[remotion]] / [[moviepy]] — 创建/制作动画视频(相反的任务)。

Individual skills in this repo

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

ever-just/agentskills

> Declarative animations for React. Springs, gestures, layout animations, and page transitions. GPU-accelerated, production-ready.

ever-just/agentskills

> Create animated logos, icons, and micro-interactions as lightweight Lottie JSON files. No After Effects needed — build animations entirely in code.

ever-just/agentskills

> A TypeScript library using generators to program animations with a real-time editor. Ideal for explainer videos, code walkthroughs, and educational content.

ever-just/agentskills

> Add animated subtitles and captions to Remotion videos from .SRT files. TikTok-style word-by-word highlights, karaoke effects, and more.

ever-just/agentskills

> Create videos programmatically using React components. The most mature framework for code-driven video production.

ever-just/agentskills

> Copy-paste video components for Remotion. Intros, text effects, transitions, and full scene templates. Like shadcn/ui but for video.

ever-just/agentskills

Extract actionable intelligence from video content across YouTube, Vimeo, and company websites. Video reveals what text sources cannot: facility scale, team composition, product demonstrations, signage, event attendance, and operational reality.

ever-just/agentskills

Full conversion audit for any homepage or landing page. Use when someone asks to "review my homepage," "audit my landing page," "why isn't my page converting," "check my website," or wants feedback on their marketing page. Requires URL or screenshot before proceeding.

ever-just/agentskills

Automatically fetch YouTube video transcripts, generate structured summaries, and send full transcripts to messaging platforms. Detects YouTube URLs and provides metadata, key insights, and downloadable transcripts.

相关技能