Agent Skill

视频号爆款短视频拆解(付费版:全能)【零一数科·出品】

【零一数科·出品】视频号爆款短视频拆解(全能版)(付费版)。视频号爆款短视频拆解(付费版:全能)。一键拆解爆款,把一条视频号视频拆成结构分段、爆款归因、六维评分和可借鉴策略,照着学照着抄。支持视频号分享链接和本地视频,付费全能版远端分析,1–5 分钟出可视化 HTML 报告。

内容创作·零一数科·来自 skill_hub·skillhub.cn ↗
skillhub install @org-28ib33ph/lingyi-wx-video-decomposer-plus
122 Stars·108.1万 综合热度·5,942 字文档·源站更新 2026-11-22

README 文档

5,942 字

视频号爆款短视频拆解(全能版)

版本:v0.6.0 · 作者:CoderPig、Awen、小风

使用远端服务拆解微信视频号视频。支持两种输入:微信视频号分享链接,或本地视频文件路径。本地视频会先上传到服务端,再发起拆解任务。脚本 scripts/analyzewxvideo.py 负责全部 HTTP 调用,接口说明见 references/api.md。

执行流程

按以下顺序执行,每一步都对应后续章节的细节:

  1. 取 API Key:读技能目录下 config.json 的 LYAPIKEY(回退环境变量)。缺失或不合法时,按「鉴权」流程引导用户获取并写入,再继续。
  2. 识别输入:判断用户提供的是视频号分享链接还是本地视频文件路径。无效或缺失时,按「引导话术」对应场景引导用户更正。
  3. 扣点确认:首次执行(非 --task-id 恢复)时,运行脚本前向用户说明「本次拆解预计扣点约 128 点,实际扣点视任务复杂程度而定」,请用户确认后再继续;用户未确认不要运行脚本。恢复超时任务不重复扣点,跳过本步。详见「扣点与确认」。
  4. (仅本地视频)上传:本地文件走 预签名 → 直传 → 确认 三步换 video_id。上限 100MB,超限以退出码 2 退出。
  5. 发起拆解:shareurl 或 videoid 二选一调发起接口(body 带 outputtype: "html"),取得 analysistask_id。
  6. 轮询等待:按 --interval 轮询状态,进度变了简短转述给用户;通常 1–5 分钟。
  7. 交付报告:终态完成后,把 WXVIDEOREPORT_FILE= 指向的 HTML 报告文件交付给用户(给出绝对路径并引导用浏览器打开),告知本次实际扣点。markdown 回退时才在对话里渲染正文。详见「输出交付」。

若是恢复已超时的任务,跳过 1 之后的鉴权检查后直接用 --task-id <id> 从第 5 步恢复轮询。

任一步异常按「退出码处理」表对号入座,不要自行判定失败。

鉴权

Token 取「技能目录」(SKILL.md 所在目录)下 config.json 里的 LYAPIKEY 字段,回退到环境变量 LYAPIKEY。脚本请求头使用 Authorization: Bearer <api_key>,裸 key,不带 Bearer。config.json 形如:

{ "LY_API_KEY": "你的密钥" }

运行脚本前,先按下面的流程确认 key 就绪。任何时候都不要编造或猜测 key。

  1. 检查是否已有 key。 读技能目录下的 config.json,看 LYAPIKEY 是否为非空字符串;若没有,再看环境变量 LYAPIKEY。两者任一有值即视为就绪,直接进入后续流程。
  2. 缺失则引导用户获取。 若都没有,停下来提示用户前往 <https://claw.lingyishuke.com/webapps/01claw-auth/index.html?source=workbuddy> 获取 API Key,并让用户把拿到的 Key 直接发给你。在拿到 key 之前不要运行脚本。
  3. 记录用户发来的 key。 收到 key 后,把它写入技能目录下的 config.json 的 LYAPIKEY 字段(保留文件其它内容),然后再运行脚本。该文件已被 .gitignore 忽略,不会入库。
  4. 鉴权失败(退出码 3)时。 多半是 key 失效或过期。提示用户重新前往上述地址获取新 key,按第 3 步覆盖写入 config.json 后重试;不要反复用同一个失效 key 重跑。

若运行报 SSL 证书错误(CERTIFICATEVERIFYFAILED 等,常见于 macOS 缺证书或企业代理环境),可设环境变量 LYSKIPSSL_VERIFY=1 后重试。注意:跳过证书校验有中间人风险,仅在受控环境临时使用。

输入识别

单次只处理一条输入:

  • 微信视频号分享链接:host 为 weixin.qq.com,典型链接如 https://weixin.qq.com/sph/...。直接把链接传给脚本。
  • 本地视频文件路径:文件存在,扩展名为 .mp4 .mov .m4v .avi .mkv .webm .flv .wmv,且大小不超过 100MB。脚本会自动上传并换取 video_id。

不要处理其它平台链接。若用户给出非微信视频号链接,按「引导话术 > 非微信平台链接」引导。若未提供输入、本地文件不存在、格式不支持、文件超过 100MB,按「引导话术」对应场景引导。若一次给出多条或同时给出链接和本地文件,先让用户指定一条。

引导话术

当用户触发本技能但未提供有效输入、或输入有误时,按以下场景引导。语气亲和自然,不要罗列技术参数。

未提供输入

技能已就绪 ✅ 这个技能能帮你把一条视频号视频拆成一份爆款文案分析报告——包含结构分段、脚本类型判断、爆款归因、六维评分和可借鉴策略,直接照着学/抄 📊

随时可以开拆,把下面任意一种发给我即可:

  1. 视频号分享链接 — 微信里打开要拆的视频,点右上角「···」→「复制链接」,把链接贴过来
  2. 本地视频文件 — 已下载到电脑的视频,直接把文件拖进来或把路径发给我(支持 mp4 / mov / m4v / mkv / avi / webm / flv / wmv,100MB 以内)

拿到后我立刻提交拆解,通常 1–5 分钟出报告 📊

非微信平台链接

目前这个技能只支持微信视频号的视频哦,暂时没法直接处理 [抖音/B站/YouTube 等] 的链接。

不过你可以先把视频下载到电脑上,然后把本地文件路径发给我,我一样可以帮你拆解分析 😊

文件问题(不存在 / 格式不对 / 太大)

  • 文件不存在:找不到这个文件,麻烦检查一下路径是否正确?可以直接把文件拖到对话框里试试。
  • 格式不支持:这个文件格式暂时处理不了,支持的视频格式有:mp4、mov、m4v、avi、mkv、webm、flv、wmv。
  • 文件过大:这个视频有点大(超过 100MB 了),可以先用剪辑工具压缩一下再发给我。

缺少 API Key

拆解视频需要调用远端的付费拆解服务,首次使用得配置一下 API Key 🔑

👉 打开这个链接登录/注册 01Claw 账号并获取 Key:https://claw.lingyishuke.com/webapps/01claw-auth/index.html?source=workbuddy

拿到 Key 后直接粘贴发给我(一串字符即可),我会帮你存好,之后拆解视频就不用再管它了。这个服务按次计费,余额不足时我会提醒你充值。

扣点与确认

本技能每次「新发起」拆解任务会消耗点数,整条链路对用户的扣点感知由你(assistant)来贯穿:

  • 执行前确认(仅新任务,非 --task_id 恢复):识别成有效输入、API Key 就绪后,运行脚本前向用户说明并请其确认:

本次拆解预计扣点约 128 点,实际扣点视任务复杂程度而定。是否继续?

等用户明确确认后再运行脚本;用户未确认、未回应或要求改主意时,不要运行脚本。

  • 执行成功后回告实际扣点:见「输出交付」,把脚本透出的 WXVIDEOPOINTS_USED 作为实际扣点告诉用户,并给出查看报告的方式。
  • 执行失败后告知点数返还:见「退出码处理」,任务已发起但未成功产出报告时,告知用户「因网络原因本次任务执行失败,相应点数已返还」并询问是否重试。

恢复已有任务(--task_id)时点数已在发起时扣除,本次仅继续轮询,不重复扣点、不需再次确认。

运行方式

在 skill 目录下运行:

python3 scripts/analyze_wx_video.py "<share_url 或 本地视频路径>"

恢复超时的任务(跳过输入/上传/创建,直接轮询):

python3 scripts/analyze_wx_video.py --task-id "<task_id>"

可选参数:

  • --task-id ID:已有的任务 ID,跳过输入识别/上传/创建,直接进入轮询。用于超时后恢复。
  • --out PATH:报告输出路径,目录或文件均可;缺省写 wx-video-<task_id>.html(markdown 回退时为 .md),html 输出时 .md 后缀会被自动改为 .html。
  • --max-wait:等待上限秒,默认 600。
  • --interval:轮询间隔秒,默认 4。

本地视频上传

本地视频分支由脚本自动完成:

  1. POST /api/v1/content-ops/videos/public-upload-url 获取预签名上传地址;
  2. 直传文件字节到预签名地址;
  3. POST /api/v1/content-ops/videos/public-upload-confirm 确认上传并取得 video_id;
  4. 使用 video_id 发起拆解任务。

上传上限为 100MB。脚本会在上传前校验大小,超限以退出码 2 退出,不发任何请求。上传进度写到 stderr,必要时转述给用户。

发起拆解与轮询

脚本向 POST /api/v1/social-analytics/collector/wx-video-analyses 发起任务,shareurl 与 videoid 二选一必填。成功后取得 analysistaskid,再轮询:

GET /api/v1/social-analytics/collector/wx-video-analyses/{analysis_task_id}

进度写到 stderr,报告写到 stdout。每当 status、currentstage 或 progressmessage 变化时,可以简短转述给用户,让用户知道任务仍在推进。状态枚举见 references/api.md。

远端拆解通常需要 1-5 分钟。运行脚本后,立即告诉用户"已提交拆解任务,服务端正在处理,预计需要几分钟",避免长时间沉默让用户误以为卡住。脚本运行期间不需要做其他操作,等待脚本返回即可。

若发起任务时余额不足,脚本以退出码 4 退出。引导用户前往 <https://claw.lingyishuke.com/webapps/01claw-auth/index.html?source=workbuddy> 充值;充值前不要继续轮询。

输出交付

成功时 stdout 形如:

WX_VIDEO_POINTS_USED=<本次实际扣点,可能为空>
WX_VIDEO_OUTPUT_TYPE=<html 或 markdown>
WX_VIDEO_REPORT_FILE=<报告文件绝对路径或空>
=== WX_VIDEO_REPORT_START ===
<html 且已落盘时此处为空;markdown 回退或写盘失败时为报告正文>
=== WX_VIDEO_REPORT_END ===

先看 WXVIDEOOUTPUT_TYPE,按输出类型交付:

html(主路径)

报告是后端渲染的自包含 HTML 报告页(结构分段、爆款归因、六维评分等排版都在页内),已落盘为 .html,正文不在 stdout 里。交付三步:

  1. 交付报告文件:读 WXVIDEOREPORT_FILE= 的绝对路径,告诉用户「拆解报告已生成:<路径>」,并引导用浏览器打开(macOS 可 open <路径>;宿主支持预览 HTML 就直接打开给用户看)。不要贴 HTML 源码,也不要把 HTML 转写成 Markdown 复述。
  2. 告知实际扣点:若 WXVIDEOPOINTS_USED 非空,告诉用户「本次任务实际扣除 {点数} 点」;为空时说「本次任务约扣 128 点(实际以服务端扣点为准,可在 01Claw 账户查看)」。
  3. 极端兜底:仅当 WXVIDEOREPORT_FILE 为空(写盘失败)时,分隔符之间才是 HTML 源码——先保存成 .html 文件再按第 1 步交付。

markdown(回退路径,后端未启用 html 时)

分隔符之间是完整 Markdown 报告,按旧约定交付:

  1. 渲染报告:截取两个分隔符之间的 Markdown 渲染给用户(不展示分隔符行和 WXVIDEO*= 协议行)。
  2. 告知实际扣点:同上。
  3. 告知查看方式:文件路径见 WXVIDEOREPORT_FILE(.md),可直接打开查看或归档;若文件写入失败但 stdout 有正文,仍在对话中交付报告并说明扣点。

退出码处理

码含义处理
0成功按「输出交付」处理(按 WXVIDEOOUTPUT_TYPE 交付 HTML 文件或渲染 markdown)。
2输入错误让用户更正链接、路径、格式或文件大小;超限时提示压缩或裁剪后重试。任务未发起,不扣点。
3缺 key 或鉴权失败按「鉴权」流程处理:引导用户前往 https://claw.lingyishuke.com/webapps/01claw-auth/index.html?source=workbuddy 获取 key,收到后写入 config.json 再重试。任务未发起,不扣点。
4发起拆解失败,含余额不足展示服务端 message;余额不足时引导用户前往 https://claw.lingyishuke.com/webapps/01claw-auth/index.html?source=workbuddy 充值,有服务端充值链接则优先用它。任务未成功发起,不扣点。
5任务失败告知用户「因网络原因本次任务执行失败,相应点数已返还」;转述 stderr 中的失败原因,并询问是否重试一次。
6发起拆解或轮询阶段的网络 / 限流 / 任务失效停止并告知用户「因网络原因本次任务执行失败,相应点数已返还」;说明网络、限流、服务端不可用或任务失效等实际原因;附 stderr 中具体信息,询问是否重试。
7完成但报告为空(html/markdown 均缺失)多为报告落库的短暂延迟(脚本已内置宽限等待,多数能自动补齐),少数是服务端解析未提取到正文。仍为空时:转述 stderr 中的 currentstage/progressmessage/error_message(若有);建议稍候用 --task-id <id> 重新轮询一次,仍为空则改用本地文件方式重新发起。任务已发起,按实际扣点处理。
9本地视频上传失败告知失败步骤,可让用户稍后重试。任务未发起,不扣点。
124超时说明任务可能仍在进行,附 task_id,用 --task-id <id> 重新轮询恢复。若用户放弃恢复,告知「因网络原因任务执行失败,相应点数已返还」并询问是否重试。

一句话:任务已发起但未成功产出报告(退出码 5、6,以及放弃恢复后的 124),统一告知用户「因网络原因本次任务执行失败,相应点数已返还」并询问是否重试;任务未发起到位的(2、3、4、9)不涉及扣点。

未知状态不要自行判定失败;脚本会原样透出 progress_message,继续按轮询结果处理。

同分类其他技能

查看全部 ›