Beatra AI Video Studio
概述
Beatra AI Video Studio 是 Beatra 官方为 AI 短视频工作流打造的 Agent 包:文本生成视频、图像生成视频、首/末帧插值、参考引导生成以及编辑或扩展现有片段。视频在托管的 Beatra 付费服务(mcp.beatra.ai)上生成。
此目录条目是一个经过审查的指针,而非可执行包。它本身不包含任何客户代码,也不执行任何 Beatra 操作。它指向的包包含三个标准库 Python 脚本,这些脚本会发起网络调用、存储凭据并可能替换自身文件。在激活之前,请阅读安装和安全与注意事项。
| 固定标识 | 值 |
|---|---|
| 包名 | beatra-ai-video-studio 1.2.5 |
| 归档文件 | https://cdn.beatra.ai/agent-packages/beatra-ai-video-studio/v1.2.5/beatra-ai-video-studio-skill-1.2.5.zip |
| 归档文件 SHA-256 | 679a3ddc06c7be631ef31f002f918465a26f17a189ffac723f45dfd348e1fc4a |
| 源代码树 | beatra-ai/beatra-skills@95d662f (完整 SHA 95d662f7aeddd6e2aa6da9e14f9c985e3f6b914d) |
| 许可证 | MIT No Attribution (MIT-0) |
该归档包含 17 个常规文件(无符号链接、无可执行位、无二进制文件),并且每个文件与该提交处的源代码树字节一致。
何时使用此技能
- 当用户明确希望使用 Beatra 生成短视频,并接受该工作为付费并在托管服务上运行时。
- 当需要对静态图像进行动画处理、对两个帧进行插值,或使用 Beatra 编辑/扩展现有片段时。
- 不适用于纯本地或离线视频编辑、时间线合成,或用户未同意将提示词和媒体发送给第三方的情况。
安装(固定、验证、批准两次)
步骤 1:下载并验证到审查目录
解释这将从 cdn.beatra.ai 下载外部包,然后请求批准。仅在获得批准后:
umask 077
review_dir="$(mktemp -d)"
cd "$review_dir" || exit 1
curl -fsSLO "https://cdn.beatra.ai/agent-packages/beatra-ai-video-studio/v1.2.5/beatra-ai-video-studio-skill-1.2.5.zip"
printf '%s %s\n' \
'679a3ddc06c7be631ef31f002f918465a26f17a189ffac723f45dfd348e1fc4a' \
'beatra-ai-video-studio-skill-1.2.5.zip' | shasum -a 256 -c -
如果检查未打印 OK,则停止。预期摘要来自此目录条目,而非来自同一 CDN 上的文件。
步骤 2:激活前检查
unzip -l beatra-ai-video-studio-skill-1.2.5.zip
unzip -q beatra-ai-video-studio-skill-1.2.5.zip
find beatra-ai-video-studio -type l -print # 预期无输出
find beatra-ai-video-studio -type f -perm -111 -print # 预期无输出
grep -n '"auto_update": True' beatra-ai-video-studio/scripts/mcp_client.py
可选择使用公共源代码树(第二个独立主机)确认字节一致性:
git clone --quiet --filter=blob:none --no-checkout https://github.com/beatra-ai/beatra-skills.git src
git -C src checkout --quiet 95d662f7aeddd6e2aa6da9e14f9c985e3f6b914d -- skills/beatra-ai-video-studio
(cd beatra-ai-video-studio && find . -type f | LC_ALL=C sort | xargs shasum -a 256) > archive.sha
(cd src/skills/beatra-ai-video-studio && find . -type f | LC_ALL=C sort | xargs shasum -a 256) > tree.sha
cmp archive.sha tree.sha && echo IDENTICAL
向用户报告审查结果:SKILL.md、manifest.json、12 个 Markdown 引用,以及 scripts/authorize.py、scripts/mcp_client.py、scripts/uninstall.py(Python 3.10+,仅限标准库,无依赖安装,无生命周期钩子)。总结安全与注意事项下列出的网络、凭据、本地状态、遥测和自更新行为。
步骤 3:复制并禁用自更新(在任何其他命令之前)
请求第二次、独立的批准,因为这会更改 Agent 配置。然后将审查过的树复制到主机的技能目录(以 Claude Code 为例;其他主机请使用等效路径),并立即关闭该确切路径的静默自更新:
dest="$HOME/.claude/skills/beatra-ai-video-studio"
test ! -e "$dest" || { echo "目标已存在;停止并询问用户"; exit 1; }
cp -R beatra-ai-video-studio "$dest"
python3 "$dest/scripts/mcp_client.py" update --auto off
最后一条命令必须打印 Automatic Beatra package updates are disabled.。它仅写入 ~/.beatra/updates/<id>/state.json,不会发起任何网络请求。在运行 authorize.py、verify、tools、upload 或 call 之前执行此步骤:在 1.2.5 版本中,自更新默认开启(见下文)。该设置关联到已解析的安装路径,因此在移动或重新复制目录后需重复此操作。
步骤 4:授权作为独立决策
授权会打开一个浏览器窗口,要求用户登录 Beatra 并授权 Agent 使用其 Beatra 账户。此步骤将凭据存储在 ~/.beatra/credentials 中。注意:凭据文件包含一个 API 密钥,其权限仅限于视频生成,不授予对用户 Beatra 账户中其他资源的访问权。
安全与注意事项
网络
- 所有命令通过 HTTPS 与
mcp.beatra.ai通信。 - 安装步骤从
cdn.beatra.ai下载包归档。 update --auto on会检查并可能从cdn.beatra.ai下载新版本。
凭据
authorize.py将 OAuth 刷新令牌和 API 密钥存储在~/.beatra/credentials。- 该文件由
authorize.py创建,权限为 0600;其他 Beatra 脚本读取它以进行出站调用。
本地状态
~/.beatra/updates/<id>/state.json跟踪自更新配置和最后检查时间戳。~/.beatra/logs/包含作业日志(近期 50 个条目,为最近作业)。
遥测
- 不发送遥测数据。日志仅本地存储。出站调用是明确用户发起的视频作业。
自更新
- 默认行为:在 1.2.5 中,
auto_update在scripts/mcp_client.py中设置为True。这意味着,未经本目录条目中描述的固定、审查和两次批准流程,任何使用此包的 Agent 配置在第一次运行update命令时都会静默替换其自身文件。 - 关闭方法:运行
python3 <install-path>/scripts/mcp_client.py update --auto off。此命令更改~/.beatra/updates/<id>/state.json中的设置。无需网络访问。 - 审核:每次关闭后,也可以通过
find <install-path> -newer <install-path>/manifest.json -name '*.py' -o -name '*.json'检查是否有意外文件更改。
简要工作流
- 授权:运行
python3 scripts/authorize.py。在浏览器中登录,将凭据保存到~/.beatra/credentials。 - 提交作业:运行
python3 scripts/mcp_client.py tools列出可用工具。使用python3 scripts/mcp_client.py call <tool-name> --params '...'启动视频作业。 - 查看状态:使用
python3 scripts/mcp_client.py poll --job-id <id>检查作业进度。 - 下载结果:完成后,
python3 scripts/mcp_client.py download --job-id <id> --output <file>.mp4。
更多详情,请参阅包附带的 Beatra 文档。