前言¶
在 Cursor、Claude Code 等環境裏做短視頻原型，常見做法是手寫火山引擎 Ark 請求、自己輪詢任務再把文件落盤。參數（時長、比例、分辨率、模型檔位）和提示詞模板往往散落在腳本里，改一次就要動多處代碼。
下面介紹 SkillHub 上的社區技能 seedance2-0（@user_1da200f4/seedance2-0，當前版本 1.0.4）。它把 Seedance 2.0 相關能力封裝成 Agent 可讀的 SKILL.md 與可執行腳本，用環境變量配置密鑰，並約定生成前需向用戶收集的參數字段。
這是什麼¶
seedance2-0 定位爲：基於字節跳動 Seedance 2.0 的 AI 視頻生成技能，官方簡介寫明支持文生圖、文生視頻，並提供快速生成封裝。
- 座標：
@user_1da200f4/seedance2-0 - 來源：SkillHub 社區（
community） - 分類：
design-media - 發佈者：
user_1da200f4 - 標籤：
requires_api_key=true（使用前需配置 API 密鑰）
SkillHub 頁面當前展示：評分 100000，下載 1300 次（數據以 SkillHub 爲準）。
官方入口：
- API 索引：https://api.skillhub.cn/user_1da200f4/seedance2-0
- 技能頁：https://www.skillhub.cn/skills/user_1da200f4/seedance2-0
核心功能¶
以下能力均來自技能包內 SKILL.md 與實現腳本，可與安裝後文檔對照。
- 快速生成：封裝 Ark API 調用，支持常見場景提示詞模板（如宣傳、活動預告、vlog、科普、營銷等）的配置化組合。
- 參數可配：模型檔位（
pro/fast/lite）、時長（5s / 10s / 15s）、畫面比例（9:16 / 16:9 / 1:1）、分辨率（720p / 1080p）等。 - 結果落盤：生成後下載視頻到本地，併產出可臨時訪問的鏈接（技能說明中的行爲描述）。
- Agent 工作流約束：在用戶要生成視頻時，先按固定模板確認「視頻內容、時長、比例、分辨率」四項入參，再執行生成。
默認模型 ID 爲 doubao-seedance-2-0-260128；fast、lite 對應技能內配置的其它模型標識。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（含默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
說明文檔：https://skillhub.cn/install/skillhub.md
2. 安裝 seedance2-0 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄，否則默認裝到 ./skills/ 可能不會被 Agent 加載。
skillhub install seedance2-0 --namespace user_1da200f4 --dir <你的 skills 目錄>
常用路徑（來自 SkillHub 安裝說明）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
也可在對話中讓 Agent 按 https://skillhub.cn/install/skillhub.md 安裝 @user_1da200f4/seedance2-0。
3. 配置環境與依賴¶
技能通過環境變量讀取火山引擎 Ark 配置：
ARK_API_KEY：火山引擎 API 密鑰（控制台獲取）ARK_BASE_URL：默認https://ark.cn-beijing.volces.com/api/v3
可在技能目錄下的 .env 中寫入上述變量（實現腳本會通過 dotenv 加載）。
技能 package.json 中聲明 OpenClaw 側安裝步驟爲 bun install，運行入口爲 bun seedance2.0.ts。若你的環境走腳本直跑，需本機具備 bun 並在技能目錄執行依賴安裝。
安裝或更新 skills 後，按你所用客戶端說明重啓或刷新 Agent，使新技能被識別。
典型用法¶
在對話裏觸發（推薦）¶
技能文檔給出的自然語言示例：
用seedance生成視頻，提示詞：...
生成前，Agent 應引導用戶按下列模板補全參數：
視頻內容：XXX
時長：5s/10s/15s
比例：9:16/16:9/1:1
分辨率：720p/1080p
可選擴展包括：模型選擇（pro / fast / lite），以及技能實現裏支持的參考圖、參考視頻、參考音頻等字段（見 seedance2.0.ts 中的 SeedanceOptions）。
命令行（技能自帶腳本）¶
在已安裝的技能目錄中，可通過 bun 運行主腳本（package.json 中 start / help 指向 seedance2.0.ts）：
bun install
bun seedance2.0.ts --help
具體 CLI 參數以 --help 輸出爲準；調用前確保 ARK_API_KEY 已設置。
適用場景與注意¶
適合誰
- 已在火山引擎 Ark 開通 Seedance 2.0 相關能力，希望在 Agent 對話裏完成「收集參數 → 調 API → 下載結果」閉環的開發者或創作者。
- 需要複用內置提示詞模板（宣傳、活動、vlog 等）快速出片，而不是每次從零寫 HTTP 客戶端的同學。
限制與注意
- 必須配置密鑰：未設置
ARK_API_KEY時，腳本會報錯退出；SkillHub 標籤也標明requires_api_key=true。 - 合規與審覈：技能要求遵守內容安全（涉黃、涉恐、涉敏等）及版權約束（未授權 IP、公衆人物、版權音樂等），生成前應自檢提示詞與素材。
- 社區技能：來源爲
community，集成前建議在 SkillHub 查看版本與說明，並在內網/生產環境按自有安全規範評估。 - 簡介與實現側重：商店簡介提到文生圖；當前包內
SKILL.md以文生視頻流程與參數模板爲主，文生圖細節以安裝後文檔與腳本能力爲準。
結尾¶
seedance2-0 把 Seedance 2.0 的視頻生成封裝成 Agent Skill：統一環境變量、默認模型與生成前參數清單，減少手寫 Ark 調用的重複勞動。若你要在 Cursor 等環境裏試 Seedance 2.0，可從 SkillHub 安裝 @user_1da200f4/seedance2-0，配置 ARK_API_KEY 後按技能模板發起生成。
官方地址：https://www.skillhub.cn/skills/user_1da200f4/seedance2-0
