用途:该技能用于 FrameVideo 注册表条目的安装与接入。适用场景包括用 framevideo add <block-name> 安装可复用合成,用 framevideo add <component-name> 安装效果片段,把已安装 block 接入宿主合成,把 component 片段粘贴进现有 HTML,发现注册表可用条目,以及管理 framevideo.json 注册表配置。
不适合:示例模板应使用 framevideo init --example <name>;编写自定义合成使用 framevideo skill;素材预处理使用 framevideo-media;init、render 等 CLI 命令使用 framevideo-cli。
主要能力:安装 block 与 component、接入 block、合并 component、发现注册表条目、配置注册表。
用法:安装 block 可运行 npx framevideo add data-chart;安装 component 可运行 npx framevideo add grain-overlay。常用参数包括 --dir 指定项目、--json 输出机器可读结果、--no-clipboard 跳过剪贴板(CI/无头环境)。安装后 CLI 会打印写入的文件和可粘贴到宿主合成的片段。
Block 与 Component 区别:Block 是独立子合成,默认安装到 compositions/<name>.html,通过 data-composition-src 引入;Component 是效果片段,默认安装到 compositions/components/<name>.html,直接粘贴进 HTML,不使用 data-composition-src。
接入 block:在宿主 index.html 中使用带 data-composition-src 的元素,并设置 data-composition-id(须与 block 内部 ID 匹配)、data-start、data-duration、data-width、data-height、data-track-index(数值越大越靠前)等属性。
接入 component:读取已安装文件,将 HTML 元素复制进合成,将 style 复制进样式,将 script 内容复制进脚本(位于时间线代码之前);若片段带有 GSAP 时间线集成说明,需加入相应调用。
配置:安装路径可在 framevideo.json 中配置,如 registry、paths.blocks、paths.components、paths.assets。
发现:可读取注册表清单 registry.json;每个条目的 registry-item.json 含 name、type、title、description、tags,block 还含 dimensions、duration 及文件列表。
限制:framevideo add 仅适用于 block 和 component,不用于示例。片段为起点,接入 block 时仍需补齐属性。未提供收费、价格、平台与效果的明确信息。