抖音视频文案提取与总结 Workflow\r

\r

📋 概述\r

\r 本 Skill 用于从抖音分享文案中自动提取视频链接，利用云端大模型极速转录视频语音，并对文案进行结构化总结。\r \r 适用场景： 用户发送包含抖音短网址（如 v.douyin.com/...）的杂乱分享文案，希望快速获取视频核心内容。\r \r 默认行为： 自动正则提取链接 -> 下载视频 -> 调用硅基流动极速提取文案 -> 直接总结。如用户明确要求只输出完整文案则只输出原文。\r \r ---\r \r

🔧 前置条件与 Agent 约束 (🚨 必读)\r

\r

1. 脚本位置与寻址指令\r

本 Skill 目录下的 douyin_skill.py（始终与你正在阅读的 SKILL.md 同目录）。\r \r

🚨 Agent 寻址约束：\r 在执行任何 Python 命令前，你必须先通过 cd 命令切换到当前这份 SKILL.md 所在的绝对路径（在 OpenClaw 环境下通常为 ~/.openclaw/workspace/skills/douyin_extractor/）。\r \r

2. 环境依赖与安装策略\r

运行脚本需要以下 Python 包：\r \r

\r
requests\r
yt-dlp\r
\r
```\r
\r
> 🚨 Agent 依赖安装约束：\r
> 绝对不要在每次执行前主动安装依赖！\r
> 只有当你运行 `douyin_skill.py` 时明确遇到了 `ModuleNotFoundError` 报错，你才被允许执行以下安装命令并重试：\r
> `pip install requests yt-dlp --target=/tmp/pylibs`\r
\r
### 3. 环境变量\r
音频极速转录依赖的 API 密钥需由人类开发者在 `~/.openclaw/.env` 中配置：\r
\r
```bash\r
SF_API_KEY=sk-你的硅基流动API密钥\r
```\r
\r
---\r
\r
## 🚀 标准执行流程\r
\r
### Step 1：提取与转录\r
\r
确保已 `cd` 到本技能目录后，直接将用户发送的**整段原始分享文案**作为参数传入执行。\r
\r
命令模板 (Agent 严格遵守)：\r
\r
> 注意：命令会自动尝试加载系统的 .env 文件获取真实密钥。你绝不能在命令中自行捏造或填写 `SF_API_KEY=sk-xxx` 这样的明文参数。\r
\r
```bash\r
# 自动寻找并加载环境变量，然后使用相对路径执行脚本\r
if [ -f ~/.openclaw/.env ]; then source ~/.openclaw/.env; fi && PYTHONPATH=/tmp/pylibs python3 douyin_skill.py "\x3C包含链接的整段分享文案>"\r
```\r
\r
执行时长预估： 5秒～15秒（取决于视频长度和网络下载速度）\r
\r
### Step 2：自动总结（默认行为）\r
\r
提取文案完成后（读取终端中返回的 `【视频标题】` 和 `【原始转录文案】` 纯文本），默认进行总结，使用以下提示词自我要求：\r
\r
```\r
你是一个高效的信息处理和投资/知识提炼助手，阅读这段转录文本，精准总结核心思想。排版要清晰，直击要点。\r
\r
要求：\r
1. 核心观点：用一句话高度概括。\r
2. 关键要点：提取视频里的核心论点或事实（使用列表说明）。\r
3. 高光金句：提取最具价值的一句话（如段永平的投资建议等）。\r
4. 滤除杂音：忽略视频中可能存在的无意义语气词或片头片尾口播。\r
\r
```\r
\r
### Step 3：用户要求完整内容时\r
\r
仅当用户明确要求"完整输出"、"不要总结"、"给我原始文案"时，才完整输出转录内容，不做任何总结。\r
\r
提示词：\r
\r
```\r
请完整输出上方提取的视频标题和原始转录文案，不要做任何总结或删减。\r
```\r
\r
---\r
\r
## ⚠️ 注意事项\r
\r
### 1. 链接自动提取\r
\r
脚本内部已包含针对混乱文案的正则表达式，Agent **无需**自己去抠链接，直接把用户发的原话（如 `5.10 复制打开抖音，看看... https://v.douyin.com/... QkC:/ [email protected]`）用双引号包裹传给脚本即可。\r
\r
### 2. 环境变量问题 (Agent 注意)\r
\r
绝对不要在命令中显式传入你瞎猜的 API Key。如果脚本返回 `执行失败：系统未配置硅基流动 API Key`，说明开发者未正确配置，请直接按照下方的"故障排查"回复用户。\r
\r
### 3. 视频下载与清理\r
\r
* 脚本采取极轻量级方案，直接下载 `.mp4` 原文件并提交给硅基流动，不使用 FFmpeg 进行音视频分离。\r
* 提取完成后，脚本会自动删除 `./temp_douyin` 目录下的临时视频。\r
* 如发现异常残留，Agent 可通过命令清理：\r
\r
```bash\r
rm -rf ./temp_douyin/*.mp4\r
```\r
\r
---\r
\r
## 📝 总结模板示例\r
\r
```markdown\r
# 🎬 视频总结：[视频标题]\r
\r
## 🎯 核心观点\r
> [一句话概括视频想表达的核心思想]\r
\r
## 📝 关键要点提炼\r
- [提取关键点 1]\r
- [提取关键点 2]\r
- [提取关键点 3]\r
\r
## 💡 高光金句\r
[提取视频中最具启发性、最核心的一句话，或你作为专家的总结陈词]\r
\r
---\r
*附：原视频链接* [提取出的纯净 URL]\r
```\r
\r
---\r
\r
## 🔄 完整对话流程示例\r
\r
```\r
用户：帮我看看这个 5.10 复制打开抖音，看看【段永平投资之道】... [https://v.douyin.com/LlSh03J3OIY/](https://v.douyin.com/LlSh03J3OIY/) QkC:/ [email protected]\r
\r
助手：\r
[定位到技能目录并完整传入文案执行脚本]\r
[等待脚本下载并返回纯文本]\r
[自动排版并总结核心投资观点]\r
\r
用户：请给我这段视频完整的原话，不要总结。\r
\r
助手：\r
[直接完整输出带有【原始转录文案】标记的纯文本，不做任何附加说明]\r
```\r
\r
---\r
\r
## 🛠️ 故障排查与应急话术 (Agent 必读)\r
\r
遇到以下错误时，Agent 应立即停止重试，并向用户反馈对应的话术：\r
\r
| 错误表现 / 终端日志 | 解决方案与 Agent 话术 |\r
| --- | --- |\r
| `ModuleNotFoundError: No module named 'yt_dlp'` | Agent 自行执行 `pip install yt-dlp requests --target=/tmp/pylibs` 然后重试。 |\r
| `执行失败：系统未配置硅基流动 API Key` | 告知用户："系统缺少 API 密钥，请检查 `~/.openclaw/.env` 配置文件中是否已正确写入 `SF_API_KEY`。" |\r
| `执行失败：未在您的输入中检测到有效的 http/https 链接` | 告知用户无法提取，提示其检查发送的文案中是否包含完整的网址。 |\r
| `API识别报错: 401 / 403 / 429` | 告知用户："硅基流动 API 额度不足或 Key 无效，请检查账号状态。" |\r
| `临时视频文件残留` | Agent 自行执行 `rm -rf ./temp_douyin/*.mp4` 进行清理。 |\r