前言¶
做培训课、口播或讲解类内容时，数字人往往要分别对接形象、声音和视频合成几套能力，脚本和参数也容易散落在不同工具里。若希望在与代码、文档同一套对话环境里，用自然语言驱动「形象克隆 → 视频合成 → 声音克隆 → 音频合成」整条链路，可以把 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。
