用途
本技能用于参考热门视频的结构、节奏和风格，为目标商品生成热门同款营销视频。当用户要求参考热门视频制作同款内容时使用本技能，兼容识别历史称呼「爆款裂变」「爆款克隆」等。
主要能力
- 热门同款：参考热门视频，为目标商品生成同款营销视频。
- 任务进度查询：查询指定任务 ID 的状态或结果。
- 独立素材入库：将本地素材上传到 KickArt、创建媒资或保存到素材库，并查询媒资。
- 视频参考：校验并记录本地绝对路径或公网 URL，作为热门同款任务的前置输入。
- 数字形象：校验并记录本地绝对路径或公网 URL，用于在热门同款任务中指定角色出镜。
使用方式
强制前置校验流程
所有 KickArt 操作必须先完成 CLI 可用性与 OAuth 登录态检查：
- 读取 references/CLI前置校验指南.md。
- 使用 command -v npm 检查 npm exec 是否可用。所有命令通过 npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x kickart-open-cli 调用固定版本，无需全局或项目级安装。
- 执行 npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x kickart-open-cli auth_token >/dev/null 检查登录态，禁止展示、记录或持久化 token。
- 尚未登录或凭据失效时，执行 npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x kickart-open-cli auth_login 获取授权链接并展示给用户；该命令立即返回，不会轮询授权状态。
- 等待用户明确确认已完成网页授权后，单次执行 npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x kickart-open-cli auth_complete 获取 token 并完成登录，再次检查登录态；禁止自动轮询或在用户确认前执行。
- npm exec 下载包失败或 CLI 仍不可用时，反馈脱敏后的 npm 错误并终止操作。
不要求用户提供长期密钥，不读取或回显 OAuth token，禁止直接请求 OpenAPI。
意图识别与任务执行
结合当前用户输入和历史记录判断意图后，必须严格读取并遵循对应的执行依据指南，不可凭空猜测执行步骤。
- 进度查询（最高优先级）：用户提及「查询进度」「查看结果」「生成怎么样了」「好了吗」或查询某个具体任务 ID 的状态时，读取 references/任务查询指南.md，执行 npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x kickart-open-cli query_task_v2 --task-id <ID> --source ad_variations --auto-publish true，解析 stdout JSON 并输出当前状态或结果。需从会话上下文获取对应任务 ID；无有效 ID 时直接告知用户未查询到相关任务。
- 独立素材入库：用户明确要求「上传到 KickArt」「创建媒资」「保存到素材库」或「查询媒资」，且不是在为生成任务提供输入素材时，读取 references/素材上传指南.md，执行 npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x kickart-open-cli material_pipeline_v2 --file-path <绝对路径>，从 stdout JSON 输出 created.media_id 和 origin_url。生成任务中的图片和视频不得触发本流程；本地素材由提交命令自动上传。
- 热门同款：用户提及「同款视频」「生成同款」「热门同款」或表达希望制作和某热门视频一样的内容的等价意图时，读取 references/爆款裂变指南.md，执行 npm exec -y --registry=https://registry.npmjs.org --package @volcengine/kickart-open-mcp@1.1.x kickart-open-cli submit_viral_task_v2，解析 stdout JSON 并输出任务 ID；后续通过 query_task_v2 获取结果。必须严格按照指南 Phase 0 逐步收集参考视频、商品信息和语言；角色图片、场景图片、创意提示词、字幕、字幕擦除、明水印等可选参数也必须逐一询问。完成信息收集后必须展示成片信息，并进行二次确认与合规提示，未确认前严禁提交。
- 视频参考：用户主动提供参考视频、视频链接，或表示要上传视频时，读取 references/视频参考指南.md，校验并记录本地绝对路径或公网 URL；不预先上传。获取可直接传给 submit_viral_task_v2 --ref-video 的素材值。用户触发热门同款意图时首要的前置步骤。
- 数字形象：用户提及「添加模特」「自定义角色」「模特出镜」「数字人」「自定义模特」时，读取 references/数字形象指南.md，校验并记录本地绝对路径或公网 URL；不预先上传。获取可直接传给 submit_viral_task_v2 --model-images 的图片列表。用户在热门同款任务中需要指定角色出镜时触发。
适用场景
- 需要参考热门视频制作同款营销视频的电商或营销场景。
- 需要查询已提交任务进度或结果的场景。
- 需要将本地素材上传到 KickArt 素材库的场景。
- 需要在热门同款任务中指定角色出镜或使用数字形象的场景。
限制
- 所有操作必须先完成 CLI 可用性与 OAuth 登录态检查。
- 不要求用户提供长期密钥，不读取或回显 OAuth token，禁止直接请求 OpenAPI。
- 热门同款任务必须严格按指南 Phase 0 收集信息，展示成片信息并二次确认与合规提示，未确认前严禁提交。
- 参考视频需满足：时长 >5 秒且 ≤60 秒、分辨率 ≥480p、格式为 MP4 或 MOV、文件大小 ≤50MB。
- 支持的语言枚举值：zh、en、en-us、pt-br、ja、es-mx、id、ms、tl。
- 任务超时时间为 1 小时。
- 错误处理需明确告知原因和可执行解决方案，禁止模糊提示；部分错误禁止自动重试，需重新展示成片信息并取得二次确认。
错误处理
通用错误码包括：0 成功、1000 任务运行中、1300 OAuth 认证失败、1400 参数错误、1401 并发超限、1402 创点不足、1403/1404 无权限套餐不足、1410 模板不存在、1412 图片格式错误、1413 媒体 URL 无效、1418 无效时长参数、1422 商品信息获取失败、1423 参考视频分辨率错误、1424 参考视频时长错误、1425 参考视频格式错误、1426 参考视频大小错误、1427 参考视频链接错误、1428 语言枚举值错误、1450 模板入参校验失败、1500 内部错误、1600 任务不存在、1601 任务超时、2000 任务失败、x01401 令牌获取失败。各错误码对应具体处理建议，详见技能文档。