用途:本技能是 yike 命令的 Agent 操作协议,围绕阿里云易客 CLI(单一二进制工具),管理媒体上传、图片/视频生成、任务生命周期与账户认证。使用时按用户意图加载对应 references 子模块再执行命令。
主要能力:本地图片/视频上传并转为 mediaId;独立图片或视频生成;基于本地附件、参考图、参考视频、URL 或 mediaId 生成;查询 mediaId 的 URL、状态、时长、分辨率、文件大小;对结果做质量门禁;继续、恢复或排查指定 jobId/resumeCommand;检查登录、账户、配置、版本,列出或安装内置技能包;查询模型、分辨率、比例、尺寸、时长等参数及参考媒体类型与数量限制。
使用方式:所有执行需先确认认证与上下文,运行 yike auth status --format json 和 yike config get --format json;未登录则先 yike auth login --format json。解析、决策、恢复或交付类命令均显式加 --format json,未知用法先跑 --help。生成顺序为:组装参数并先执行 --dry-run --format json(不同时传 --yes 或 --wait/--interval/--timeout),读取 estimation.credits、balance、insufficient、warnings 并向用户展示,等待明确确认;确认后保持影响积分与结果的参数不变,将 --dry-run 换为 --yes 提交,需要等待时加 --wait 及轮询参数。提交后从 stdout JSON 读取 jobId 与 resumeCommand,超时后执行返回的 resumeCommand。成功终态后用 yike media info <mediaId> --format json 交付,需要质量门禁时运行 media doctor。上传产生 mediaId(Normal 状态)后供生成使用;图片参考一律走 --reference-image,视频参考走 --reference-video,类型不得由模型名或 taskType 推断。同任务内复用已记录的 path→mediaId 映射。
错误处理:Throttling 按 2s/4s/8s 自动重试最多 3 次;InternalError 3 秒后重试一次;Forbidden/NoPermission 与 InvalidParameter 不重试,直接报告。用户明确要求“自动执行”等时可跳过确认、直接执行并使用非交互参数。缺少路径、mediaId、jobId 等必要信息时须向用户询问,不得猜测或使用占位值。安全边界:可用 YIKE_API_TOKEN 配置令牌,禁止读取浏览器 Cookie/LocalStorage/配置文件凭据,不得输出令牌明文。
限制与未提供信息:资料未说明具体支持模型清单、积分定价规则、平台可用区域、并发或配额上限,也暂未提供完整命令参数手册。