AI video skill for Claude Code & Codex — cinematic, editable product promos with Remotion: 124 shot recipe cards, 150 motion previews, beat sync, sound design, Motion Workbench & JianYing (CapCut CN) export.
TypeScript agent-skillsai-agentsai-videoclaude-codeclaude-code-skillsclaude-skillscodexmotion-designmotion-graphicsproduct-videopromo-videoremotionvideo-generationvideo-production
import React, { useEffect, useRef, useState } from "react";
import { Player, type PlayerRef } from "@remotion/player";
import type { CardDef } from "../cards/types";
import { cardFps, cardSize } from "../cards/types";
import { themedProps } from '../theme';
import { CARD_LIST } from "../cards/registry";
import { DEMO_CATEGORIES } from "../cards/demoCards";
import { MANIFEST } from "../cards/projectCards";
import { importProject, useStore } from "../store";
import { sfxUsage } from "../projectImport";
import { BGM_LIB, MEDIA_ITEMS, SFX_LIB } from "../mediaManifest";
import { PROJ_DIR, PROJ_HAS_MANIFEST, PROJ_LINKED } from "../projMeta";
import { setDragPayload } from "../dnd";
import { ThemePanel } from './ThemePanel';
import { cardName, cardSummary, useT, useTx } from "../i18n";
const TABS = [
{ id: "media", key: "lib.tab.media" },
{ id: "cards", key: "lib.tab.cards" },
{ id: "sfx", key: "lib.tab.sfx" },
{ id: "themes", key: "lib.tab.themes" },
] as const;
type TabId = (typeof TABS)[number]["id"];
/** 不进动效库的分类:成片单元只在素材 tab;媒体走素材 / 音效 tab;预设幕底卡不进素材库
* (已有工程里的幕底 clip 仍由注册表渲染) */
const NON_MOTION_CATS = new Set(["成片单元", "音频", "素材", "背景"]);
/** 进入视口才挂载重内容(预览视频 / 实时 Player) */
const useVisible = () => {
const ref = useRef<HTMLDivElement>(null);
const [visible, setVisible] = useState(false);
useEffect(() => {
const el = ref.current;
if (!el) return;
const io = new IntersectionObserver(([en]) => setVisible(en.isIntersecting), {
rootMargin: "100px",
});
io.observe(el);
return () => io.disconnect();
}, []);
return { ref, visible };
};
/** 进入视口才加载并循环播放的预览视频 */
const LazyLoopVideo: React.FC<{ src: string }> = ({ src }) => {
const ref = useRef<HTMLVideoElement>(null);
const [visible, setVisible] = useState(false);
const [loaded, setLoaded] = useState(false);
useEffect(() => {
const el = ref.current;
if (!el) return;
const io = new IntersectionObserver(([en]) => setVisible(en.isIntersecting), {
rootMargin: "100px",
});
io.observe(el);
return () => io.disconnect();
}, []);
useEffect(() => {
if (visible) setLoaded(true);
}, [visible]);
useEffect(() => {
const el = ref.current;
if (!el || !loaded) return;
if (visible) el.play().catch(() => {});
else el.pause();
}, [visible, loaded]);
return (
<video
ref={ref}
className="lib-thumb"
src={loaded ? src : undefined}
muted
loop
playsInline
autoPlay
preload="none"
/>
);
};
/** 没有预渲染视频的卡:可见时用实时 Player 当缩略图——**静止在 45% 处的定妆帧**,鼠标悬停才循环播放。
* 曾经默认自动循环:十几个 1080p 场景同时跑、闪白转场卡每 0.3s 白一次、字卡每 1.8s 淡出重来,
* 首屏像在闪光灯下;大图反复解码还刷出一串 EncodingError。 */
const LazyCardLoop: React.FC<{ card: CardDef }> = ({ card }) => {
const themeId = useStore(s => s.project.themeId);
const themeColors = useStore(s => s.project.themeColors);
const { ref, visible } = useVisible();
const { width, height } = cardSize(card);
const player = useRef<PlayerRef>(null);
const [hover, setHover] = useState(false);
const total = Math.max(2, card.durationInFrames);
const poster = Math.min(total - 1, Math.round(total * 0.45));
// .lib-thumb 本身 pointer-events:none(让拖拽落到 .lib-cell 上),悬停监听挂到所属 cell
useEffect(() => {
const cell = ref.current?.closest(".lib-cell");
if (!cell) return;
const on = () => setHover(true);
const off = () => setHover(false);
cell.addEventListener("pointerenter", on);
cell.addEventListener("pointerleave", off);
return () => {
cell.removeEventListener("pointerenter", on);
cell.removeEventListener("pointerleave", off);
};
}, [ref]);
useEffect(() => {
const p = player.current;
if (!p) return;
if (hover) {
p.seekTo(0);
p.play();
} else {
p.pause();
p.seekTo(poster);
}
}, [hover, poster, visible]);
return (
<div ref={ref} className="lib-thumb" style={{ position: "relative" }}>
{visible && (
<Player
ref={player}
component={card.component}
inputProps={themedProps(MANIFEST, card, themeId, {}, themeColors)}
durationInFrames={total}
compositionWidth={width}
compositionHeight={height}
fps={cardFps(card)}
initialFrame={poster}
loop
controls={false}
initiallyMuted
numberOfSharedAudioTags={0}
style={{ width: "100%", height: "100%", pointerEvents: "none" }}
acknowledgeRemotionLicense
/>
)}
</div>
);
};
const groupBy = <T,>(items: T[], key: (t: T) => string) => {
const m = new Map<string, T[]>();
for (const it of items) {
const k = key(it);
const g = m.get(k);
if (g) g.push(it);
else m.set(k, [it]);
}
return [...m.entries()];
};
export const LibraryPanel: React.FC = () => {
const t = useT();
const tx = useTx();
const setPreview = useStore((s) => s.setPreview);
const [tab, setTab] = useState<TabId>(PROJ_LINKED ? "media" : "cards");
// 折叠分组默认收起,点击标题展开
const [openCats, setOpenCats] = useState<Set<string>>(new Set());
const toggleCat = (cat: string) =>
setOpenCats((prev) => {
const next = new Set(prev);
if (next.has(cat)) next.delete(cat);
else next.add(cat);
return next;
});
/** 网格单元通用外壳:点击=中屏预览,拖拽=上轨 */
const Cell: React.FC<{
name: string;
meta?: string;
title?: string;
onClick: () => void;
payload: Parameters<typeof setDragPayload>[1];
children: React.ReactNode;
}> = ({ name, meta, title, onClick, payload, children }) => (
<div
className="lib-cell"
draggable
onDragStart={(e) => setDragPayload(e, payload)}
onClick={onClick}
title={`${name}${title ? `\n${title}` : ""}\n${t("lib.cellHint")}`}
>
{children}
<div className="lib-cell-name">{name}</div>
{meta && <div className="lib-cell-meta dim">{meta}</div>}
</div>
);
/** 动效卡网格单元 */
const CardCell: React.FC<{ card: CardDef }> = ({ card }) => (
<Cell
name={cardName(card)}
meta={`${(card.durationInFrames / cardFps(card)).toFixed(1)}s${card.schema.length > 0 ? t("lib.tunable") : ""}`}
title={cardSummary(card)}
onClick={() => setPreview({ kind: "card", cardId: card.id })}
payload={{ cardId: card.id }}
>
{card.preview ? <LazyLoopVideo src={`/${card.preview}`} /> : <LazyCardLoop card={card} />}
</Cell>
);
/** 音效等无画面素材的列表行 */
const Row: React.FC<{
dot: string;
name: string;
meta?: string;
onClick: () => void;
payload: Parameters<typeof setDragPayload>[1];
}> = ({ dot, name, meta, onClick, payload }) => (
<div
className="lib-card"
draggable
onDragStart={(e) => setDragPayload(e, payload)}
onClick={onClick}
title={`${name} · ${t("lib.cellHint")}`}
>
<span className="lib-dot" style={{ background: dot }} />
<span className="lib-name">{name}</span>
{meta && <span className="lib-dur">{meta}</span>}
</div>
);
/** 可折叠分组标题 */
const Group: React.FC<{ id: string; label: string; count: number; children: React.ReactNode; defaultOpen?: boolean }> =
({ id, label, count, children, defaultOpen }) => {
const open = defaultOpen ? !openCats.has(id) : openCats.has(id);
return (
<div>
<button className="lib-cat-toggle" onClick={() => toggleCat(id)}>
<span className={`caret${open ? " open" : ""}`}>▸</span>
{label}
<span className="dim" style={{ marginLeft: "auto" }}>{count}</span>
</button>
{open && children}
</div>
);
};
const motionCards = CARD_LIST.filter((c) => !NON_MOTION_CATS.has(c.category));
const projectCards = CARD_LIST.filter((c) => c.category === "成片单元");
const usage = sfxUsage(MANIFEST);
const projectAudio = MEDIA_ITEMS.filter((m) => m.kind === "audio");
const projectVisual = MEDIA_ITEMS.filter((m) => m.kind !== "audio");
// 动效库:工作台原生卡靳前,然后按画廊分类
const motionGroups = ["工作台", ...DEMO_CATEGORIES]
.map((cat) => ({ cat, cards: motionCards.filter((c) => c.category === cat) }))
.filter((g) => g.cards.length > 0);
const audioPayload = (file: string, label: string, volume: number, duration: number) =>
({ cardId: "audio-clip", props: { file, volume }, label, duration }) as const;
return (
<div className="library">
<div className="lib-tabs">
{TABS.map((tb) => (
<button
key={tb.id}
className={`lib-tab${tab === tb.id ? " on" : ""}`}
aria-pressed={tab === tb.id}
onClick={() => {
setTab(tb.id);
if (tb.id === 'themes') setPreview(null);
}}
>
{t(tb.key)}
</button>
))}
</div>
<div className="library-list">
{tab === 'themes' && <ThemePanel />}
{tab === "media" && (
<>
{MANIFEST ? (
<button
className="btn wide"
title={t("lib.importFilm.title", { dir: PROJ_DIR })}
onClick={() => importProject()}
>
{t("lib.importFilm", { name: MANIFEST.name })}
</button>
) : (
<div className="lib-cat" style={{ whiteSpace: "normal", lineHeight: 1.5 }}>
{PROJ_LINKED ? t("lib.linkedNoManifest", { dir: PROJ_DIR }) : t("lib.notLinked")}
</div>
)}
{projectCards.length > 0 && (
<>
<div className="lib-cat">{t("lib.filmUnits")}</div>
<div className="lib-grid">
{projectCards.map((card) => (
<Cell
key={card.id}
name={cardName(card)}
meta={`${(card.durationInFrames / cardFps(card)).toFixed(1)}s${card.schema.length ? t("lib.tunable") : ""}`}
onClick={() => setPreview({ kind: "card", cardId: card.id })}
payload={{ cardId: card.id }}
>
<LazyCardLoop card={card} />
</Cell>
))}
</div>
</>
)}
{projectVisual.length > 0 && <div className="lib-cat">{t("lib.mediaFiles")}</div>}
{groupBy(projectVisual, (m) => m.dir || "/").map(([dir, items]) => (
<Group key={dir} id={`media:${dir}`} label={dir} count={items.length} defaultOpen={items.length <= 12}>
<div className="lib-grid">
{items.map((m) => (
<Cell
key={m.file}
name={m.name}
meta={m.kind === "video" ? t("lib.video") : t("lib.image")}
onClick={() => setPreview({ kind: m.kind, file: m.file, label: m.name })}
payload={
m.kind === "video"
? { cardId: "video-clip", props: { file: m.file }, label: m.name, duration: 150 }
: { cardId: "image-clip", props: { file: m.file }, label: m.name, duration: 90 }
}
>
{m.kind === "video" ? (
<LazyLoopVideo src={`/${m.file}`} />
) : (
<img className="lib-thumb" src={`/${m.file}`} />
)}
</Cell>
))}
</div>
</Group>
))}
</>
)}
{tab === "cards" &&
motionGroups.map((g) => (
<Group key={g.cat} id={`cat:${g.cat}`} label={tx(g.cat)} count={g.cards.length} defaultOpen={g.cat === "工作台"}>
<div className="lib-grid">
{g.cards.map((card) => (
<CardCell key={card.id} card={card} />
))}
</div>
</Group>
))}
{tab === "sfx" && (
<>
{projectAudio.length > 0 && (
<Group id="sfx:proj" label={t("lib.projectAudio")} count={projectAudio.length} defaultOpen>
{projectAudio.map((m) => (
<Row
key={m.file}
dot="#ff9f0a"
name={m.name}
meta={usage.has(m.file) ? t("lib.usedIn", { n: usage.get(m.file) ?? 0 }) : t("lib.unused")}
onClick={() => setPreview({ kind: "audio", file: m.file, label: m.name })}
payload={audioPayload(m.file, m.name.replace(/\.[^.]+$/, ""), 0.4, 90)}
/>
))}
</Group>
)}
{BGM_LIB.length > 0 && (
<Group id="sfx:bgm" label={t("lib.bgm")} count={BGM_LIB.length}>
{BGM_LIB.map((b) => (
<Row
key={b.file}
dot="#bf5af2"
name={b.name}
onClick={() => setPreview({ kind: "audio", file: b.file, label: b.name })}
payload={audioPayload(b.file, b.name, 0.35, 900)}
/>
))}
</Group>
)}
{groupBy(SFX_LIB, (s) => s.cat).map(([cat, items]) => (
<Group key={cat} id={`sfx:${cat}`} label={t("lib.sfxLib", { cat: tx(cat) })} count={items.length}>
{items.map((s) => (
<Row
key={s.file}
dot="#ff9f0a"
name={s.name}
onClick={() => setPreview({ kind: "audio", file: s.file, label: s.name })}
payload={audioPayload(s.file, s.name, 0.4, 90)}
/>
))}
</Group>
))}
</>
)}
</div>
<div className="lib-foot dim">
{tab === 'themes' ? t("lib.foot.themes") : <>
{t("lib.foot.cards", { n: motionCards.length, m: motionCards.filter((c) => c.schema.length > 0).length })}
{t("lib.foot.sfx", { n: SFX_LIB.length })}
{PROJ_LINKED && PROJ_HAS_MANIFEST ? t("lib.foot.units", { n: projectCards.length }) : ""}
<br />
{t("lib.foot.hint")}
</>}
</div>
</div>
);
};