前言¶
做培訓課、口播或講解類內容時，數字人往往要分別對接形象、聲音和視頻合成幾套能力，腳本和參數也容易散落在不同工具裏。若希望在與代碼、文檔同一套對話環境裏，用自然語言驅動「形象克隆 → 視頻合成 → 聲音克隆 → 音頻合成」整條鏈路，可以把 SkillHub 上的社區 Skill「數字人-學員版」裝進當前 Agent，由 Skill 內的 SKILL.md 約束調用方式。下面介紹它是什麼、能做什麼，以及如何安裝啓用。
這是什麼¶
「數字人-學員版」是 SkillHub 座標 @user_af5300c4/zsdlszr 上的 Agent Skill，當前版本 v1.0.28，來源爲 community，分類 design-media，由發佈者 user_af5300c4 維護。
官方簡介將其定位爲 知識頂流（ZSDL）數字人視頻生成助手，面向在對話中完成數字人相關生產任務，而不是單獨再開一套桌面客戶端。SkillHub 頁面標註標籤 requires_api_key=true，表示使用前通常需要配置與 ZSDL 服務相關的 API 密鑰；具體變量名與申請方式以安裝後包內 SKILL.md 爲準，本文不臆造配置項。
核心功能¶
依據 SkillHub 與已抓取元數據，已覈實的能力邊界如下：
- 形象克隆：基於素材生成或綁定數字人形象，供後續視頻使用。
- 視頻合成：將形象與內容合成爲數字人視頻。
- 聲音克隆：從參考音頻建立可用的聲音模型或音色。
- 音頻合成：用克隆或選定音色生成配音，與視頻環節銜接。
上述四項在官方文案中表述爲「全流程」支持；各步驟的請求格式、參數與限制以 Skill 文檔及 ZSDL 接口說明爲準。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式。SkillHub 官方建議：讓 AI 閱讀 SkillHub 安裝說明，並安裝 @user_af5300c4/zsdlszr。
1、安裝 SkillHub CLI（如尚未安裝）¶
先檢查本機是否已有 CLI：
command -v skillhub && skillhub --version
若未安裝，可按官方文檔執行完整安裝（含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝本 Skill 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前客戶端識別的 skills 目錄；默認裝到 ./skills/ 時，部分 Agent 不會加載。
skillhub install @user_af5300c4/zsdlszr --dir <skills 目錄>
常用路徑（摘自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
示例（Cursor）：
skillhub install @user_af5300c4/zsdlszr --dir ~/.cursor/skills/
安裝完成後，按所用客戶端要求重啓或刷新 Agent，使新 Skill 生效。
3、API 密鑰¶
元數據標記 requires_api_key=true。在對話中首次使用數字人相關能力前，應按 SKILL.md 完成密鑰配置；未在公開頁面覈對到的字段名與端點地址，請勿自行假設。
典型用法¶
公開 SkillHub 頁面未附帶可逐條複製的業務 API 示例；可復現的入口如下。
- 完成上一節的 CLI 安裝與
skillhub install。 - 在 Agent 對話中說明目標，例如：上傳參考視頻做形象克隆、用指定文案合成口播視頻、或先聲音克隆再生成配音。Agent 應讀取已安裝目錄下的
SKILL.md，按 ZSDL 流程組織步驟。 - 若 Skill 要求先配置 API Key，在對話中按文檔提示補齊後再發起生成任務。
更細的接口名、請求體與錯誤處理以安裝包內文檔爲準；本文不編造調用樣例。
適用場景與注意¶
適合誰
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的環境，希望用對話驅動數字人生產鏈路的同學。
- 接受社區來源 Skill（community），並自行評估 ZSDL 服務條款與密鑰安全的人。
限制與注意
- 依賴外網 API 與有效密鑰；無密鑰或配額不足時，流程會在 Skill 文檔定義的環節失敗。
- SkillHub 統計（截至資料抓取）：評分 100000，下載 2117；安裝計數爲 0 僅表示平臺側 install 字段，不代表本地不可用。
- 版本以 SkillHub 爲準（當前 1.0.28）；升級可用
skillhub對同一座標更新，並再次指定正確的--dir。
結尾¶
「數字人-學員版」把 ZSDL 側的形象、視頻、聲音與音頻合成能力收斂爲一個 Agent Skill，適合在開發環境中用自然語言串起數字人制作步驟。安裝與優先源規則見 skillhub.cn/install/skillhub.md；Skill 詳情與座標見 SkillHub 頁面，API 入口爲 https://api.skillhub.cn/user_af5300c4/zsdlszr。
