mcpField
U
ui2v

ui2v

github.com/illli-studio创意与媒体143106 次安装6 周前更新
代码仓库

关于 ui2v

用于处理 UI2V 动效包注册表任务的技能，通过 `ui2v` 命令行工具搜索、安装、发布和同步资源。它明确区分资源分发与 HyperFrames 的创作、预览和渲染职责。

主要功能

  1. 01搜索动效包
  2. 02安装和更新资源包
  3. 03发布和同步资源包
  4. 04检查包元数据
  5. 05CLI 开发与发布指导

适用场景

  1. 01为项目查找动效包
  2. 02安装或更新注册表资源包
  3. 03发布已完成的动效包
  4. 04排查 CLI 或包发布问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/illli-studio/ui2v --skill ui2v

安装后在 Claude Code 中输入/ui2v确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
cleanup.md
package-format.md
positioning.md
publish.md
release.md

详细介绍

ui2v Skill

UI2V 是面向 AI 工作流的 视频动效资源库。它帮助用户发现、安装、复用和分享 HyperFrames 动效包；实际的视频创作、预览和渲染由 HyperFrames 完成。

若要了解项目定位、README 文案、npm 文案、网站文案或发布／宣传文案，请阅读 references/positioning.md。

心智模型

HyperFrames authoring -> package folder -> ui2v login -> ui2v motion publish -> ui2v.com
层级工具
编写 / 预览 / 渲染HyperFrames（/hyperframes 和相关技能）
搜索 / 安装 / 发布 / 同步ui2v CLI（npm 包 @ui2v/cli，bin ui2v）

不要使用已弃用的 @ui2v/[email protected] JSON 渲染／预览工具链（doctor、validate、preview、render、animation.json、@ui2v/core、@ui2v/engine、@ui2v/producer）。当前的 @ui2v/cli 包是注册表客户端。

任务路由

注册表相关工作和 CLI／包维护请使用此技能：

  • 在 ui2v.com 上发布／分享／安装／搜索动效 → 使用此技能和 ui2v CLI。
  • 修复或扩展 UI2V CLI → 检查 packages/ui2v/src/cli，更新针对性测试，然后运行下方的仓库验证命令。
  • 修复注册表包元数据或发布失败问题 → 阅读 references/package-format.md 和 references/publish.md。
  • 更新网站、README、npm 或宣传文案 → 阅读 references/positioning.md；包引用应保留为 npm @ui2v/cli，bin 命令 ui2v，以及 npx 命令 npx @ui2v/cli@latest ...。
  • 清理项目结构 → 阅读 references/cleanup.md；移除旧版 JSON 渲染器示例／脚本，或将其从当前工作流中分离；不要把它们描述为当前 UI2V 功能。
  • 准备或说明发布 → 阅读 references/release.md；核实版本、测试、构建和 npm 文案。

如果用户没有在进行注册表相关工作，请转到其他技能：

  • 制作／编辑／预览／渲染视频合成 → 使用 HyperFrames 技能，而非此 CLI。
  • 旧版 JSON ui2v 项目 → 不要恢复旧版 JSON 工具链。迁移到 HyperFrames 包，然后使用 ui2v 发布。

CLI 版本检查

在执行依赖当前 CLI 行为的发布／安装／同步操作前：

ui2v --cli-version
npm view @ui2v/cli version
  • 缺少 CLI → 安装：npm install -g @ui2v/cli@latest（或 bun install -g @ui2v/cli）
  • 不是最新版本 → 运行 ui2v upgrade（别名 self-update），或运行 npm install -g @ui2v/cli@latest
  • 在 --no-input 模式下，如果 CLI 版本过旧，ui2v upgrade 只会打印安装命令并以非零状态码退出

npm view 只用于查看元数据。除非缺少 CLI、版本过旧而无法完成任务、CLI 出现故障，或用户要求使用最新版本，否则不要把升级作为常规第一步。

从此单体仓库发布前：

cd packages/ui2v && bun run build && node bin/ui2v.js --cli-version

单体仓库开发工作流

在此仓库中修改 CLI 源码时：

bun install
bun run build
bun run test
bun run --filter "@ui2v/cli" verify
node packages/ui2v/bin/ui2v.js --help
node packages/ui2v/bin/ui2v.js --cli-version

迭代时，优先先运行范围最小且有用的测试：

cd packages/ui2v
bun run test:src
bun run verify:build
bun run test:artifact

包结构

动效文件夹必须包含：

  • 带有 type: "hyperframes:block" 的 registry-item.json
  • 入口合成 HTML（index.html 或清单中列出的合成文件）
  • 可选的 assets/、README.md、缩略图

详情请见：references/package-format.md。

项目定位

介绍项目时，请使用以下核心表述：

让 AI 帮你发现、安装和分享 UI2V 视频动效资源：
搜索并安装现成动效，发布原创作品，让动画像依赖一样轻松复用。

不要称 UI2V 为渲染器。请明确区分：

  • HyperFrames 用于创建、预览和渲染动效。
  • UI2V 通过搜索、安装、发布、同步和检查工作流分发已完成的动效包。

发布流程

ui2v login
ui2v motion publish ./my-motion --version 1.0.0
# optional: ui2v sync

别名：ui2v skill publish、旧版 ui2v publish。

完整检查清单：references/publish.md。

发布版本流程

准备 npm 发布时，请使用 references/release.md。不要随意发布或升级版本；首先确认所需版本并运行本地验证。

常用注册表命令

ui2v search "logo sting"
ui2v install <slug>
ui2v list
ui2v update --all
ui2v explore
ui2v inspect <slug>
ui2v upgrade

网站上显示的安装命令：npx @ui2v/cli@latest install <slug>。

故障排查手册

  • 找不到 CLI → 安装 @ui2v/cli，然后确认 ui2v --cli-version。
  • CLI 版本过旧 → 运行 ui2v upgrade 或 npm install -g @ui2v/cli@latest。
  • 身份验证失败 → 运行 ui2v login；自动化场景中，仅当用户提供令牌时才使用 ui2v login --token clh_...。
  • 发布时拒绝版本 → 确保 --version 符合有效的 semver 格式，且高于已发布版本。
  • 缺少入口 HTML → 检查 index.html、第一个 files[] 组合路径，或 {name}.html。
  • 清单验证失败 → 参照 references/package-format.md 检查 type: "hyperframes:block"、尺寸、时长和 files[]。
  • 出现渲染/预览请求 → 停止使用 UI2V 命令，并转至 HyperFrames。

评论

支持 Markdown