前言¶

电商和 Listing 团队做家具、DIY 类产品时，常会有一组按顺序拍好的组装步骤照。要把它们变成可投放的短视频，常见做法是手工在剪辑软件里逐段做动效、再拼接时间线，步骤多、改一帧就要重导整条片。

下面介绍 SkillHub 上的 组装步骤视频·一步一镜（@beatra-ai/assembly-one-step-clip）。它把「卖家提供的步骤事实 + 已授权静帧」约束成工作流：每张静帧对应一次图生视频调用，按步骤顺序交付多条短片，而不是在 Agent 里发明拼接工具。

这是什么¶

组装步骤视频·一步一镜 是 beatra 发布的企业源 Skill（design-media），当前版本 0.1.9。SkillHub 页面简介与包内 SKILL.md 一致：按卖家提供的步骤事实，为每张静帧做成一条一步一镜短片，并按步骤顺序交付产品组装短视频与步骤视频。

底层能力通过随包脚本连接 Beatra MCP（https://mcp.beatra.cn/mcp），使用 beatra.videos.animate 等工具；SkillHub 标签标明 requires_api_key=false，但首次使用仍需在本机完成 Beatra 设备授权（见下文），视频生成按 Beatra 积分计费。

核心功能¶

根据已安装的 SKILL.md 与 references/workflow.md，可核实的能力包括：

1. 一步一镜规划：只依据卖家事实与静帧可见内容编写带标注的步骤计划；缺信息处标为缺口，不编造扭矩、工具或警告。规划结果免费可见，且不等于用户批准付费生成。
2. 静帧检查与上传：记录 MIME、宽高、画幅、大小、alpha 等；本地文件经 scripts/mcp_client.py upload 上传为 artifact，禁止把本地路径直接传给 beatra.videos.animate。
3. 模型与约束核对：调用 beatra.models.list（capability: image_to_video），确认支持无 driving_audio 的首帧图；默认 model: "auto"，时长在用户选择的 2–15 秒整数内，未指定时用 5 秒。
4. 付费前生产卡：任意 beatra.videos.animate 前须展示六字段确认卡（做什么、单价、笔数、每帧独立 client_request_id、停在此处仍保留计划、余额不足时的官方说明与充值链接），用户确认后再提交。
5. 按步交付：每帧一次 animate，用 beatra.tasks.get 轮询至终态；按步骤顺序交付短片及实际尺寸、时长、billing.net_charged_credits；不要拼接、concat 或虚构剪辑工具。
6. 账户与恢复：只读查询可用 beatra.wallet.get / beatra.wallet.ledger；任务丢失时通过 beatra.tasks.list 与冻结载荷恢复；余额不足时保留链接，用户确认充值后再用同一标识重试。

相邻路线在 Skill 内写清：商品照口播成片用 product-video-studio，房源房间静帧用 listing-room-video-pack，非组装通用静帧用 image-to-motion。

安装与启用¶

1. 安装 SkillHub CLI（若尚未安装）¶

按 SkillHub 安装说明 检查或安装 CLI：

command -v skillhub && skillhub --version

未安装时可执行文档中的 curl 安装脚本（完整安装或 --cli-only）。

2. 安装本 Skill¶

官方页面提示：根据 https://skillhub.cn/install/skillhub.md 安装 @beatra-ai/assembly-one-step-clip。

在终端中，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别：

skillhub install assembly-one-step-clip --namespace beatra-ai --dir <你的 Agent skills 目录>

常用路径（来自同一安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装完成后，若宿主仅在会话启动时加载 Skill，需新开一次 Agent 会话。

3. Beatra 授权¶

在已安装的本 Skill 目录下运行（需 Python 3.10+，随包脚本仅用标准库）：

python3 scripts/authorize.py

凭证保存在 ~/.beatra/credentials.json（与 ~/.beatra/installation.json 配合）；勿将 Device Token 写入对话或日志。成功后会输出 Beatra is ready。连接验证示例：

python3 scripts/mcp_client.py verify
python3 scripts/mcp_client.py tools

若从 SkillHub 安装，首次连通后可按对话线索记录安装来源（可选）：

python3 scripts/mcp_client.py install-source --guess skillhub

典型用法¶

下面步骤摘自包内工作流，可在安装目录中复现。

1. 上传步骤静帧

python3 scripts/mcp_client.py upload ./step-01-attach-leg.jpg --mime-type image/jpeg

保留输出的 artifact ID，后续 animate 使用 artifact 引用，而非本地路径。

2. 读取当前图生视频模型卡

python3 scripts/mcp_client.py call beatra.models.list

标准输入 JSON：

{"capability": "image_to_video"}

3. 用户确认生产卡后，单帧提交 animate

printf '%s' '{
  "image": {"type": "artifact", "artifact_id": "art-step-01"},
  "prompt": "A restrained camera hold on this assembly step. Keep the shown part and action in place. Do not add unstated tools or warnings.",
  "duration": 5,
  "client_request_id": "opaque-assembly-step-01"
}' | python3 scripts/mcp_client.py call beatra.videos.animate

4. 轮询任务并按步骤顺序交付

对每次创建响应使用 beatra.tasks.get 直至终态；多帧时保持步骤顺序，并核对与标注计划是否一致。

所有远程 Beatra 调用均通过随包 scripts/mcp_client.py 完成，不要配置宿主 Beatra Connector，也不要改用 REST/OpenAPI 作为降级。

适用场景与注意¶

适合谁

• 卖家或 Listing 团队已有按步骤拍摄的组装静帧，且能给出每步的零件、动作或序号等事实。
• 需要「一张图一条短片」的组装教程素材，按步骤顺序交给后期或投放，而不是单条长片内由 Agent 拼接。

限制与注意

• 硬输入不足（无静帧、无步骤事实）时应补问，不能从公开帖子或相似 SKU 臆造步骤。
• 每张静帧对应一次付费 beatra.videos.animate；批量中途积分耗尽时，随包更新说明会停止后续批次并提示充值（见 manifest.json changelog）。
• 默认不带 driving_audio；需要口播商品视频应走其他 Beatra Skill 路线。
• 包内客户端可每 24 小时静默检查更新；可用 python3 scripts/mcp_client.py update --check 等子命令管理自动更新行为。

SkillHub 侧（抓取资料）：分类 design-media，发布者 beatra，来源 enterprise，评分 100000，下载 4980；页面与 CLI 搜索均显示版本 0.1.9。

结尾¶

组装步骤视频·一步一镜 把组装短视频生产收敛为「步骤事实 + 静帧上传 + 按帧图生视频 + 顺序交付」，并在付费前用生产卡和独立 client_request_id 约束批量行为。若你的工作流正是「一步一镜、不拼接」，可在 SkillHub 安装该 Skill 并按包内 SKILL.md 执行。

• SkillHub 页面：https://www.skillhub.cn/skills/beatra-ai/assembly-one-step-clip
• 官方 API 路径：https://api.skillhub.cn/beatra-ai/assembly-one-step-clip
• Beatra 技能主页（manifest）：https://www.beatra.cn/skills/assembly-one-step-clip