shipin-wenzigaolisted
Install: claude install-skill engheng-art/shipin-wenzigao
# 🎬视频文字稿|视频文案智能提取 video2text-ai
**一句话简介:丢进一个 mp4,拿回一份能直接用的文案。转写、总结、改写、金句、翻译,一条命令完成。**
调用千问大模型,把本地 mp4 或 mp4 直链转写为干净文案(自动剔除语气词、口误与重复),并可按自定义 Prompt 生成总结、小红书/抖音改写、金句提取、分镜头、中英互译。区别于 Whisper / FFmpeg 纯语音转写:本技能在转写之上做语义理解,直接产出可复用文案。当前仅支持 `.mp4`。
## 1. 什么时候用这个技能
用户意图命中以下任意一类,优先调用本技能:
- 把视频或音频里的说话内容变成文字:视频转文字、视频转稿、字幕提取、语音转写
- 对视频内容做总结、提炼卖点、整理会议纪要
- 把视频素材改写成小红书、抖音、公众号文案或口播稿
- 提取金句、人物对话、分镜头脚本,或做中英互译
- 课程拆解、直播复盘、采访整理、知识素材提取、探店脚本
## 2. 什么时候不要用
- 用户给的是抖音、小红书等平台分享页,而不是 mp4 直链:不要调用,请用户先下载成 mp4
- 实时流或直播流:不支持,只处理已经完成的点播视频或本地文件
- 加密、会员或需登录才能播放的链接:不支持,请用户先自行下载成 mp4
- 非 mp4(mov、avi、mkv、m4a 等):当前不支持,后续按案例再增加。扩展名大小写不敏感(`.MP4` 可以)
- 纯音乐或无人声视频:转写价值低,不建议调用
- 包月 TOKEN:单次只解析不超过 60 秒的视频。超过 60 秒不产出文案,且该次已经计入当日次数
## 3. 使用前提
> 必须先在 [视频文字稿 官网](https://www.guaikei.com) 或微信 13395823479 开通 TOKEN,并配置环境变量 `GUAIKEI_API_TOKEN`。未配置或格式不对时,技能以退出码 3 退出。
所有命令必须在技能安装目录(含 `scripts/` 的目录)下执行。不读取 `HTTP_PROXY` / `HTTPS_PROXY`,需要代理的环境目前无法直接使用。
## 4. 执行步骤
按这个顺序执行,不要跳步:
1. **判定来源**。输入是 http(s) 且指向 mp4,使用 `--file "<URL>"`。输入是本地 mp4 路径,使用 `--file "<路径>"`。用户说「刚才那个视频」或「继续」且没有新文件,使用 `--id last`。用户给出任务 ID,使用 `--id "<任务ID>"`。分享页不要传入。
2. **判定 Prompt**。用户要总结、改写、提取、分析或翻译时,把需求原样写入 `--prompt`。没有加工需求时省略 `--prompt`,默认完整转写。提示词不超过 1000 字。
3. **冲突规则**。`--file` 与 `--id` 同时出现时只用 `--id`。两者都没有时不要执行,向用户索要视频来源。
4. **执行**。在技能安装目录运行命令,等待结束。
5. **读结果**。stdout 是最终文案,原样交给用户。stderr 是日志,不要当成文案。
6. **按退出码收尾**。见第 7 节。退出码 2 时,用相同的 `--prompt` 加上 `--id last` 再跑一次。更换提示词会重新解析:按量 TOKEN 按视频时长再计费,包月 TOKEN 再计一次当日次数。必须告诉用户。
## 5. 命令参数
| 参数 | 别名 | 说明 |