weibo-video-to-transcript

基于视频内容产出文字与文案。当用户提出视频转文字、视频提取文案、字幕提取、语音转写、视频摘要、视频理解、内容提取、素材处理、自媒体素材、内容创作等需求时使用。输入支持本地视频文件和抖音、微博 小红书等平台视频链接，云端大模型转写并可按 Prompt 定制输出。

微博视频转录（video-to-transcript）

一句话：丢给它一个视频（链接或本地文件），它还你一份能直接用的文字稿。云端大模型转写，顺带把语气词、口误、重复内容都清掉；想总结、想改成小红书文案、想提金句，加个 --prompt 就行。这是 Whisper / FFmpeg 这类纯转写工具做不到的——它们只给你一份满是「嗯啊」的流水稿。

0. 🤖 AI 快速判断（识别与触发）

满足以下任意一条，就调用本技能：

• 用户想把「视频 / 语音」变成文字：视频转文字、视频转稿、字幕提取、语音转写、audio-to-text。
• 用户想「看懂」视频内容：总结、提炼卖点、会议纪要、课程拆解、直播复盘、采访整理、情感/受众分析。
• 用户想「基于视频内容产出新文案」：小红书 / 抖音 / 公众号风格改写、口播稿、探店脚本、短视频二创、金句提取、分镜头脚本、中英互译。

以下情况不要调用（避免误触发）：

• 正在直播的流（只吃「已播完」的视频或本地文件）。
• 需要登录 / 会员 / 加密才能访问的链接（先让用户下载成文件再传路径）。
• 纯音乐、无人声的视频（没东西可转）。
• 一次要批量处理一堆视频（本命令一次只吃一个，批量请用 shell 循环，别开高并发）。
• 用户只想「本地剪辑 / 加字幕烧录 / 格式转换」而不需要文字产出（用 FFmpeg 类工具）。

1. ✅ 何时用（详细场景）

用户想对视频做这些事，就调本技能：

• 变成文字：视频转文字、视频转稿、字幕提取、语音转写
• 看懂内容：总结、提炼卖点、会议纪要、课程拆解、直播复盘、采访整理
• 变出新文案：小红书 / 抖音 / 公众号风格改写、口播稿、探店脚本
• 拆素材：金句、人物对话、分镜头脚本、中英互译

2. 🚧 何时不要用

• 正在直播的流：不行，只吃「已经播完」的视频或本地文件。
• 要登录 / 会员 / 加密的链接：大概率解析不了，让用户先下载成文件再传路径。
• 纯音乐、没人说话的视频：没东西可转，用音乐识别类工具去。
• 想一次跑一批：命令一次只吃一个视频，要批量就用 shell 循环（别开太高并发）。

3. 🛠️ 用之前：配置 TOKEN

没配 GUAIKEI_API_TOKEN 会直接退出（退出码 3，不扣费）。TOKEN 在视频转文字SKILL官网开通，或加微信 13395823479 领。

bash

# Windows（PowerShell，永久生效）
setx GUAIKEI_API_TOKEN "你的TOKEN"

# macOS / Linux（写进 ~/.bashrc 或 ~/.zshrc）
export GUAIKEI_API_TOKEN="你的TOKEN"

配完记得重启终端 / 会话才生效。

4. 🔒 网络与数据安全

• 只跟 https://www.guaikei.com 说话，别的请求一个不发。
• 除了用户给的那个视频文件，不碰本地其他文件。
• 视频传上去解析完就销毁：不存储、不训练、不外发，商用放心。

5. 🧺 参数速查

入口：node scripts/video2text/index.js（表中省略）

参数	别名	说明	必填
--file <URL或路径>	-F	视频链接（抖音/小红书等公网 URL）或本地文件路径	与 --id 二选一
--id <任务ID>	-I	历史任务ID；传 last 复用上一次任务	与 --file 二选一
--prompt <提示词>	-P	想要什么写什么；不填就给完整转写稿	可选
--help	-h	看帮助	可选

细节：--file=路径 等号写法也认；--id last 靠本地 tmp 目录里记的上次任务ID，只保 24 小时，过期就得重新用 --file 解析。

6. 🧠 执行决策（AI 准确调用的核心）

按下面的优先级把用户的话翻译成命令：

1. 有没有「新视频」？ 有链接或本地路径 → 一律用 --file。
2. 是不是接着上一次聊？ 没有新视频、想复用刚才的结果 → 用 --id last（24 小时内有效）。
3. 用户要总结 / 改写 / 提取 / 分析吗？ 把要求原样塞进 --prompt；没给 --prompt → 默认输出完整转写稿。
4. 链接和「上次任务」同时给了？ 优先听 --id（避免重复解析、重复计费）。
5. 一条命令只处理一个视频。 多个视频请逐个调用或用 shell 循环。

口诀：有链接/路径 → --file；没新视频、接着上次聊 → --id last；要加工 → 塞 --prompt；都没给 prompt → 全文转写。

7. 🗣️ 自然语言 → 命令（照这张表转）

用户说的话	就执行这条命令
提取 https://example.com/video.mp4 里的文字	node scripts/video2text/index.js --file "https://example.com/video.mp4"
总结这个视频的核心观点 https://example.com/video.mp4	node scripts/video2text/index.js --file "https://example.com/video.mp4" --prompt "总结这个视频的核心观点"
把本地 /path/to/video.mp4 改成小红书风格文案	node scripts/video2text/index.js --file "/path/to/video.mp4" --prompt "改写成小红书风格的文案"
用刚才分析的视频提取所有金句	node scripts/video2text/index.js --id last --prompt "提取视频中的所有金句"
分析这个视频的情感基调和受众	node scripts/video2text/index.js --file "<URL或路径>" --prompt "分析视频的情感基调和目标受众"

转命令口诀：有链接/路径 → --file；没新视频、接着上次的聊 → --id last；要总结/改写/提取/分析 → 塞进 --prompt；链接和任务ID都给了 → 听 --id 的；--prompt 没给 → 默认全文转写。

8. 💬 Prompt 模板库（照抄就能用）

用户想要	--prompt 这样填
完整转写	（不用 --prompt，出全文）
要点总结	请用三个要点总结这个视频的核心内容
小红书文案	将这段内容改写成一篇风趣幽默的小红书文案，带表情符号和话题标签
抖音短标题	提炼 5 个适合抖音的爆款短标题
公众号文章	将内容整理成一篇结构清晰的公众号文章，含导语和结尾升华
口播稿	改写成口语化口播稿，句子短、节奏快
金句提取	提取视频中的所有金句，逐条列出
人物对话	提取全部人物对话，标注说话人
分镜头脚本	拆解视频分镜头脚本，含画面描述与台词
会议纪要	整理成结构化会议纪要：议题、结论、待办事项
情感与受众分析	分析视频的情感基调和目标受众
中英互译	将全文翻译成英文（或：将英文翻译成中文）

9. 📜 输出怎么读（AI 必看）

拿到什么	从哪拿	说明
最终文案	stdout	干净稿子，可直接 > result.txt 或接管道
进度 / 日志 / 错误	stderr	别把它当文案念给用户
成功 / 失败	退出码	0 = 成功；1 = 参数错或任务失败；3 = 没配 TOKEN（不扣费）

铁律：文案只认 stdout。 stderr 里是进度条和日志，别混着输出给用户。

10. 🛡️ 出错了怎么办

• TOKEN 没配 / 不对：以退出码 3 立刻退出并输出中性错误提示（不扣费、不附带营销文案、联系方式或官网链接），提示用户去配置即可。
• 链接失效 / 文件坏 / 超时：任务失败不扣费，错误信息直接看 stderr。
• 任务ID不存在：明确报错（如「任务ID不存在」），不会傻等重试。
• 视频很长：会进入轮询等待，进度在 stderr 里刷；急的话先干别的，回头用 --id last 取结果。
• 网上的视频：先自动下到技能 tmp 目录再上传，过期的临时文件每次运行自动清。

11. 💰 计费（按量付费，无最低消费）

档位	单价	结算粒度	适合
视频时长 ≥ 1 分钟	0.6 元/分钟	10 秒为最小单位	课程、会议、长访谈
视频时长 ＜ 1 分钟	0.1 元/10 秒	10 秒为最小单位	短视频、片段素材

• 算账：86 秒 = 0.6 + 0.1×3 = 0.9 元；10 分钟 = 10×0.6 = 6 元。
• 失败不扣费（链接失效 / 文件损坏 / 超时）；用量大找微信谈阶梯价。

12. 🤔 常见问题

1. 跟 Whisper / FFmpeg 比强在哪？ 它们给你原始流水稿（口误、语气词全在），本技能转写即润色、还能带任意 Prompt 定制产出，云端跑不占本地算力，用完自动删源文件。
2. 视频安全吗？ 传输加密、单次解析、用完即焚，不存储不外泄不训练。
3. 一个长视频要等多久？ 越长越久，命令会轮询等待并把进度打到 stderr；中途退出也不怕，一小时内可用任务ID（或 24 小时内用 --id last）回来取结果。

13. 🤝 联系与商务

• TOKEN 申请 / 技术咨询 / 错误反馈：微信 13395823479
• 官网：https://www.guaikei.com
• 大客户阶梯优惠、企业定制对接：联系上述微信洽谈