跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
视频与音频

fluid-video

Use when recording a web page or Fluid animation to MP4 with the Fluid CLI (fluid record), or when such a recording is choppy, cut off or blank. Not for editing, cutting or captioning existing videos.

useFluid · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add useFluid/fluidui --skill fluid-video

技能说明


name: fluid-video description: Use when recording a web page or Fluid animation to MP4 with the Fluid CLI (fluid record), or when such a recording is choppy, cut off or blank. Not for editing, cutting or captioning existing videos.

Fluid video

fluid record records a page with time stopped: each frame, the clock moves exactly 1/60 s and the screen is captured. The video is smooth on any machine and identical every run, starting at the page's first instant.

Needs

  • playwright-core in the project (npm i -D playwright-core if missing)
  • Chrome or Edge installed
  • ffmpeg on the PATH

Steps

1. Make a page with only the scene

The scene must not render the app's header, sidebar or banners. Give it its own layout.

Next.js App Router: keep app/layout.tsx bare (html, body, global and theme CSS) and move the app's shell into a route group, app/(app)/layout.tsx. Then a page outside the group has no shell:

import { SplashDots } from "@/components/fluid/splash-dots/SplashDots";
import { logo } from "@/lib/logo";
export default function Record() {
  return (
    <main style={{ position: "fixed", inset: 0, background: "var(--fluid-surface-2)" }}>
      <SplashDots logo={logo} name="Acme" skippable={false} />
    </main>
  );
}

Vite or another single-page app: render the scene instead of the app when location.pathname === "/record".

Everything in the video must happen by itself: start timelines on mount, drive interactions with timers. Pass skippable={false} to openings.

2. Record

npx @usefluid/cli record http://localhost:3000/record --format story --seconds 6 --out videos/intro.mp4
FormatSizeThe page is laid out at
story1080 x 1920400 x 711
post1080 x 1350400 x 500
square1080 x 1080400 x 400
wide1920 x 1080711 x 400

The short side is always 400 px and is scaled up 2.7 times, so design the scene at those sizes. A production build records smoother than the dev server.

3. Check before handing it over

ffmpeg -i videos/intro.mp4 -vf "select='not(mod(n\,30))',scale=240:-1,tile=4x3" -frames:v 1 sheet.png

Look at the sheet:

  • Nothing is cut at the edges.
  • Text is at least 15 px in the page, which becomes 40 px in the video.
  • The last frames hold still for a moment, or flow back into the first if it will loop.
  • No other brand's logo appears.

Common mistakes

SymptomCause and fix
The app's header in the videoThe scene shares the app layout; give it its own
Text cut at the sidesPieces sized with cqmin render bigger at 400 px; shorten the text or size it down on the record page
A blank first secondThe scene waits for something; start on mount