ZenoTV 视频生产平台 · 账号绑定
> 绑定完成后、用户开始使用生成能力前，务必先读同目录 USE.md——那是 10+ 生成工具
> 的完整使用工作流（调用顺序、素材 curl 直传契约、常见错误补救）。
> 不读它容易把本地文件硬塞给 MCP 工具、编造 model 名、提交后不等待，浪费用户积分。
绑定你的 ZenoTV（千帧）账号到 ZenoTV MCP，全自动：登录一次后，AI 工具即可
调用 ZenoTV 的生图 / 生视频 / 生音乐能力，消耗你自己的积分。
执行步骤
1. 发起绑定
curl -s --max-time 20 https://mcp.qzwx.cn/bind/device/start -X POST -H "Content-Type: application/json" -d "{}"
响应：{"device_code": "...", "user_code": "XXXXXX", "confirm_url": "/bind/confirm?dc=...", "expires_in": 300}
2. 告知用户核对码，并打开确认页
先把 user_code（6 位核对码）展示给用户，然后用系统默认浏览器打开确认页：
- Windows:
start "" "https://mcp.qzwx.cn/bind/confirm?dc=<device_code>" - macOS:
open "https://mcp.qzwx.cn/bind/confirm?dc=<device_code>" - Linux:
xdg-open "https://mcp.qzwx.cn/bind/confirm?dc=<device_code>"
告诉用户：浏览器已打开。请先核对页面上的确认码与本消息中的核对码一致，再登录你的 qzwx 账号（手机号+密码+验证码），点确认绑定。
3. 轮询结果（每 3 秒，最多 100 次 ≈ 5 分钟）
curl -s https://mcp.qzwx.cn/bind/device/poll -X POST -H "Content-Type: application/json" \
-d '{"device_code": "<device_code>"}'
{"status": "pending"}→ 继续轮询，提醒用户完成浏览器里的操作{"status": "completed", "key": "...", "install_url": "..."}→ 进入第 4 步{"status": "expired"}→ 从第 1 步重来，告诉用户"超时了，重新发起一次即可"
4. 写入 MCP 配置
拿到 key 后，把 qzwx 写进当前工具的 MCP 配置（URL 带 key，免配 header）：
- ZCode：编辑
~/.zcode/cli/config.json，在mcp.servers加（保留原有内容）：
json "qzwx": { "type": "http", "url": "https://mcp.qzwx.cn/mcp?key=<KEY>" } - Claude Code：
claude mcp add --transport http qzwx "https://mcp.qzwx.cn/mcp?key=<KEY>" - Codex：
~/.codex/config.toml加：
toml [mcp_servers.qzwx] url = "https://mcp.qzwx.cn/mcp?key=<KEY>" - 其他/不确定：在浏览器打开
https://mcp.qzwx.cn+install_url，页面里有全部工具的现成配置。
写入前先检查：如果 qzwx 条目已存在，更新其 url 为新 key 的 URL（不要重复添加）。
5. 收尾提示
绑定完成，告诉用户：
1. ✅ 已绑定 + 已写入配置，重启本工具后即可用（说"用 qzwx 生成…"）
2. ⚠️ 使用期间不要在浏览器/App 登录这个 qzwx 账号（会互踢导致生成失败；误踢了重新跑本 skill 即可）
3. 生成消耗用户自己的 qzwx 积分；get_balance 查余额，get_quota 查项目预算
注意
- 全程不需要管理员参与；不要让用户手动复制 key
- 轮询期间 agent 应保持响应（不要阻塞用户提问）
- 若 5 分钟未完成，让用户重跑本 skill（device_code 5 分钟有效）
- 绑定账号若需新积分额度/项目权限，联系千帧管理员
本地素材上传（生成时引用用户本地图片/视频）
生成工具的参考素材只收公网 URL。用户本机文件用 curl 直传原始字节（不要用 base64）：
curl -sS -X POST --data-binary "@本地文件.png" \
-H "Authorization: Bearer <key>" \
"https://mcp.qzwx.cn/upload?group_id=<gid>&file_name=文件.png"
group_id先调 MCP 工具list_asset_groups获取；file_name带扩展名（推断类型用），只传文件名不带路径- ≤50MB；返回
{asset_id, url}，把url填进generate_image的image_urls/generate_video的video_url - Windows PowerShell 环境用
curl.exe（避免curl别名指向 Invoke-WebRequest）
