技能介绍

解决什么问题

爱奇艺号开放平台提供了完整的创作者接口，但通过脚本调用时，开发者需要自己处理令牌轮转、分片上传、qipuId 查询、数据拉取等细节，每个环节都可能出现参数错误或鉴权失败。iqiyihao-toolkit 把这些流程封装成一个面向 Agent 与脚本的 CLI 技能包，默认输出非交互式 JSON，方便程序直接解析。

首次部署时容易遇到 command not found 或 tarball 不完整
上传大文件需要分片与断点处理，手工拼参数易错
发布后拿到的 qipuId 常被淹没在原始响应里

核心能力

技能把 7 个能力聚合在同一个入口：安装与升级 CLI、保存或轮换 iq- 前缀的 token、上传并发布视频、按状态搜索视频、查询播放数据、删除视频。每个能力对应一份参考文档，按场景跳转。

令牌与自检：iqiyihao auth 写入 ~/.iqiyihao-creator-open/secrets/，iqiyihao check 输出健康状态
视频发布：publish 处理常规上传，publish-large 走分片，成功后会展示 qipuId 并附带后台链接
检索与数据：iqiyihao search 支持草稿与已发布筛选；iqiyihao data user 与 iqiyihao data video 拉取近 7/30 天趋势
排查顺序：先确认 CLI 是否装好，再看认证、本地参数、网络，最后核对 platformCode

适用边界

它只覆盖 CLI 路径。如果你直接用 Python / Java / Go SDK 调开放平台，这个技能帮不上忙。其他视频平台的运营也不在范围内。发布类命令在重试时不保证幂等，半途失败的视频可能已经落库，重试前建议先 iqiyihao search --status publishing 确认。评论、审核状态等运营数据请去创作者后台查看。