下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-3zj9kart--popto-hot-structure-dismantle-v2.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @org-3zj9kart/popto-hot-structure-dismantle-v2。使用 Popto 爆款结构拆解能力（https://popto.cn/features/hot_structure_dismantle）分析抖音、小红书、微信视频号分享链接或可公开访问的视频 URL，异步获取 Hook、节奏、CTA、受众画像、结构分段、爆款归因、六维评分和运营建议报告。用户要求拆解热门短视频、分析爆款原因、获取可复刻策略，或需要恢复已有 Popto 分析任务时使用。
阅读全文 （展开查看完整说明）
概述
Popto 爆款结构拆解
功能介绍页面：https://popto.cn/features/hot_structure_dismantle
使用脚本 [scripts/analyze_hot_structure.py](scripts/analyze_hot_structure.py) 调用 Popto OpenAPI，提交一次独立的爆款结构拆解任务，轮询异步任务，并把结构化结果交付为 Markdown 报告。接口和字段细节见 [references/api.md](references/api.md)。
执行前准备
- 从技能目录的
config.json读取POPTO_API_KEY；没有时回退到环境变量POPTO_API_KEY。不要猜测、编造或在日志中打印 API Key。 - API Key 必须是 Popto 工作台创建的开放 API Key。若缺失，提示用户在工作台的 API密钥 页面 https://popto.cn/workspace/api 创建密钥，并让用户把密钥直接发来；收到后只写入技能目录的
config.json，再继续执行。 - 请求地址固定为线上正式域名
https://popto.cn，不得切换。 - 新建任务会消耗积分。运行脚本前先向用户确认：预计消耗约 15 点（视频分析 5 + 爆款结构拆解 10；开启
--split-video时通常再加 2），实际以账号免费权益和后台计费配置为准。用户没有明确确认时不要提交任务。使用--task-id恢复任务不重复扣费，也不需要再次确认。
输入范围
单次只处理一个输入。支持：
- 抖音链接或分享文本中的抖音链接（
douyin.com、iesdouyin.com、v.douyin.com）； - 小红书链接或短链（
xiaohongshu.com、xhslink.com）； - 微信视频号分享链接（
weixin.qq.com/sph/...、channels.weixin.qq.com/...）； - Popto 可直接读取的公开视频 URL，当前项目默认接受 Popto CDN URL（
cdn.ipalfish.com）。
本 Skill 的开放 API 只接收 URL，不直接上传本地文件。用户若提供本地视频路径，提示先在 Popto 工作台的“爆款结构拆解”页面上传，或将文件放到 Popto 可访问的 HTTPS 地址后再提交该 URL。不要把本地路径当作 url 发给接口。
若未提供输入、输入不是 http(s) URL、平台不在上述范围，先让用户改正。不要把 YouTube、B 站、Instagram 等链接强行提交；项目后端会返回不支持的来源。
运行流程
新任务：
python3 scripts/analyze_hot_structure.py "<视频链接>"可选参数：
--split-video：请求额外生成时间线切片 URL，通常会额外消耗视频剪切积分；只在用户需要逐段播放时开启。--out PATH：将 Markdown 报告写到指定文件；传入目录时自动生成hot_structure_<task_id>.md。--interval SECONDS：轮询间隔，默认 4 秒。--max-wait SECONDS：最长等待时间，默认 900 秒。超时后保留 task ID 供恢复。--task-id ID：跳过提交，直接查询已有任务；不要和新的输入混用。
脚本会：
- 检查 API Key 和输入，并通过
POST /api/open/v1/toolbox/hot_structure_dismantle提交任务。项目服务端会自动识别来源，并强制开启hot_analysis。 - 立即在 stderr 提示任务已提交，再按
POST /api/open/v1/task/batch_get轮询状态。状态为pending/running时简短转述；不要把处理中误报为失败。 - 任务成功后分别读取
outputs.result.markdown（通用 AI 视频分析）和outputs.hot_result.markdown（爆款结构拆解）；旧结果缺少爆款 Markdown 时，脚本按hot_result结构化字段生成兼容报告。 - 按“AI 视频分析 → 爆款结构拆解”的顺序把两段报告正文渲染给用户，同时保存 Markdown 文件。爆款部分包含基本信息、受众画像、结构拆解、爆款归因、六维评分、爆款公式、竞品洞察和运营建议（字段缺失时如实标注）。
成功输出使用以下标记，便于宿主截取 Markdown：
POPTO_HOT_TOOL_ID=<tool_id>
POPTO_HOT_TASK_ID=<task_id>
POPTO_HOT_VIDEO_URL=<outputs.video_row.video_url 原始视频链接；服务端未返回时省略>
POPTO_HOT_REPORT_FILE=<absolute path>
POPTO_HOT_DISPLAY_URL=https://popto.cn/workspace/toolbox/hot_structure_dismantle?tool_id=<tool_id>
=== POPTO_HOT_REPORT_START ===
<Markdown report>
=== POPTO_HOT_REPORT_END ===任务成功后，如果返回了 tool_id，还要提示用户可以通过展示页地址访问：https://popto.cn/workspace/toolbox/hot_structure_dismantle?tool_id=<tool_id>。脚本会通过 POPTO_HOT_DISPLAY_URL 输出该地址；使用 --task-id 恢复任务时，只有服务端返回了 tool_id 才输出展示页地址，避免拼接错误链接。如果成功结果的 outputs.video_row.video_url 有值，脚本会通过 POPTO_HOT_VIDEO_URL 输出原始视频链接并在日志中提示；字段缺失时不编造或回填其他链接。
接口不会返回本次实际扣除积分，成功交付时只能说明“预计约 15 点，实际以 Popto 账户账单/后台配置为准”，不要声称一个未经接口返回的实际扣点数。
失败与恢复
按脚本退出码处理，不要自行改写服务端错误：
| 退出码 | 含义 | 处理 |
|---|---|---|
| 0 | 完成并有报告 | 渲染报告，给出保存路径。 |
| 2 | 输入错误 | 让用户修正 URL；任务尚未创建，不涉及扣费。 |
| 3 | API Key 缺失、无效或用户未注册 | 按“执行前准备”重新创建/配置 Key。 |
| 4 | 提交失败（包括积分不足） | 展示服务端消息；积分不足时引导用户充值后重试。若任务尚未返回 task ID，不要声称已扣费。 |
| 5 | 任务进入 failed | 展示 error_msg，并明确告知用户“任务处理失败，本次任务已扣除的积分会自动返还到 Popto 账户”。服务端会按任务 ID 幂等返还已预扣的积分；接口不返回退款金额，不要声称具体返还数量。 |
| 5 | 任务进入 cancelled | 展示 error_msg 并说明任务已取消；不要套用失败任务的退款提示，除非服务端明确返回退款信息。 |
| 6 | 查询网络错误、限流或任务不存在 | 保留 task ID，稍后用 --task-id 重试；不要重复提交新任务。 |
| 7 | 任务成功但 result.markdown 与 hot_result.markdown 均为空 | 先用同一 task ID 再轮询一次；仍为空时提示用户联系 Popto，避免编造分析内容。 |
| 124 | 超过等待上限 | 告知任务可能仍在运行，并用 --task-id <id> 恢复；恢复不重复扣费。 |
网络短暂失败由脚本有限重试；持续失败时停止并保留 task ID。报告文件写入失败但 stdout 仍有报告时，照常交付对话中的报告，并说明文件未保存。
