用途:aip-setup 用于完成 AI Producer 的初始设置。它的目标是一次性打通账户连接并启动第一个项目,成功标志是 AI Producer 已接受项目并开始准备视频素材,而不是产出已剪辑的视频。后续剪辑、字幕和动态图形属于 aip 技能的范围。该技能可安全重复运行,每次从第 1 步开始并跳过已完成的部分;在新对话中说“continue AI Producer setup”会从用户上次中断处继续。
主要能力:
- 连接检查:调用 get_pricing(无参数、免费、不读取项目数据)判断连接是否可用。返回价格表即表示连接正常;工具缺失或拒绝登录表示账户未连接;网络错误、超时或服务故障则不是登录问题,不应引导用户重新登录。
- 账户连接引导:连接只能由用户在各自客户端完成。ChatGPT(Chat 或 Work)通过授权提示或 Settings > Apps & Connectors 连接;Codex 在终端运行 codex mcp login ai-producer;Claude Code 运行 /mcp 并选择 plugin:aip:ai-producer;Cursor 通过 Customize > MCPs > ai-producer > Authenticate。连接后会再次调用 get_pricing 确认,用户口头声称已登录不能作为连接成功的依据。
- 素材与目标收集:请用户附上一条视频并用一句话说明想要的结果;一次一个项目,多段视频时询问先做哪一个;风格、字幕、音乐等细节留给 aip 技能在剪辑开始时确定。
- 提交前说明:视频格式、时长和大小由服务端在提交时校验,拒绝信息会说明哪一项不符;开始项目的费用依据 get_pricing 返回的 start_project_from_attachment 行和计费说明,可能收费时需在提交前用平实语言告知用户及按视频时长计价的方式。
- 提交项目:调用 start_project_from_attachment 一次,传入用户附件的视频、用户原话目标,仅在用户要求时填 aspect_ratio。只有返回 project_id 和 task_id 才表示项目已存在。不同拒绝原因有对应处理,例如附件无法下载、视频不支持或过大、额度用尽、服务繁忙可重试、需要重新登录等。调用超时或连接中断不算拒绝,项目可能已启动,应通过 list_projects 查询而不是重复提交。
- 交接:项目启动后依次告知用户项目正在准备素材、返回 page_url(不得给出 agent_page_url)、说明后续剪辑需要在具备命令与文件能力的对话中进行并粘贴项目链接,至此设置完成。
使用方式:在支持该技能的客户端中触发初始化流程,按其步骤操作即可。不同对话环境适用不同流程:具备命令或文件能力的对话(ChatGPT Work、Codex、Claude Code 及启用了命令/文件工具的 Cursor)在步骤 1 至 3 后直接交接给 aip 技能的新项目流程;无计算机能力的 ChatGPT Chat 走完整六步,视频以附件形式由服务器下载;Cursor 若没有命令或文件访问权限,需要用户切换到 Agent 模式后继续。
适用场景:首次安装 AI Producer 后需要连接账户并启动首个项目;需要在新对话中继续未完成的设置;需要通过附件方式从 ChatGPT Chat 提交视频。
限制:连接必须由用户本人完成,技能不能代替登录,也不应构建授权链接、建议重装插件或修改 MCP 配置;不得自行测量、转码或猜测视频限制,不得凭记忆报价;每次只处理一个视频;调用超时后不应重复提交,因为可能产生第二个项目并再次计费。