Beatra AI 影片工作室 是做什麼的?
概述
Beatra AI 影片工作室是 Beatra 官方為 AI 短片工作提供的代理套件,功能包括:文字轉影片、圖片轉影片、首尾幀內插、參考引導生成,以及編輯或擴展現有片段。影片將在 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 無署名 (MIT-0) |
該壓縮檔包含 17 個一般檔案(無符號連結、無執行權限、無二進位檔案),且每個檔案與該提交的原始碼樹位元組完全一致。
何時使用此技能
- 當使用者明確表示想要在 Beatra 上製作一個 AI 短片,並同意該工作是付費的且在託管服務上執行時。
- 當需要將靜態圖片動畫化、對兩幀進行內插,或透過 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:複製進去並在執行任何其他指令前停用自我更新
請求第二次、獨立的核准,因為這會變更代理設定。然後將審查過的目錄樹複製到主機的技能目錄(以 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 帳戶並產生一個 API 金鑰。代理不應擅自決定或跳過此步驟。在獲得使用者明確許可後:
python3 "$dest/scripts/authorize.py"
此指令會將金鑰儲存在 ~/.beatra/credentials 中。
安全與注意事項
| 類別 | 詳細說明 |
|---|---|
| 網路 | 所有視覺工作均透過 HTTPS 將提示詞與媒體檔案傳送至 mcp.beatra.ai。authorize.py 會開啟瀏覽器連線至 beatra.ai。mcp_client.py 會檢查 api.beatra.ai 以取得套件更新資訊。 |
| 憑證 | API 金鑰以明文形式儲存在 ~/.beatra/credentials 中。除非使用者明確請求,否則不應讀取或轉發此金鑰。 |
| 本地狀態 | 設定與工作記錄寫入 ~/.beatra/。manifest.json 定義了可透過 MCP 存取的 tools。 |
| 遙測 | 除工作 API 呼叫外,不收集任何遙測資料。無 beacon 請求,無 stdout 以外的分析報告。 |
| 自我更新 | mcp_client.py update --check 會連線至 api.beatra.ai 以取得版本清單,並可下載及套用新套件。版本 1.2.5 預設啟用此功能。安裝過程中的步驟 3 會將其關閉;但複製、移動或還原目錄可能會使其恢復預設值。此技能僅在進行中的工作過程中或使用者明確要求時才應執行 update。 |
解除安裝
python3 "$dest/scripts/uninstall.py"
rm -rf "$dest"
uninstall.py 會從 ~/.beatra/ 中移除所有設定與工作記錄。建議之後也移除憑證檔案:rm -f ~/.beatra/credentials。