video-digestlisted
Install: claude install-skill tmjwjx/tmjwjx-skills
# video-digest 视频内容提取
调 TikHub 解析视频,再把视频(公网直链或本地文件 base64)交给智谱多模态模型(GLM-5.3-Flash)做画面+语音的完整提取,输出结构化 markdown。
## 配置
密钥在 skill 目录 `.env`(`~/.claude/skills/video-digest/.env`),格式 `KEY=VALUE`,环境变量优先:
- `TIKHUB_API_KEY` — tikhub.io 的 API Key
- `ZHIPU_API_KEY` — 智谱开放平台 API Key
- `ZHIPU_MODEL` — 默认 `glm-5.3-flash`
## 用法
```bash
python3 ~/.claude/skills/video-digest/scripts/video_digest.py "<视频链接或BV号>"
python3 ~/.claude/skills/video-digest/scripts/video_digest.py "<链接>" --frames 15 # 配图上限(默认 10)
python3 ~/.claude/skills/video-digest/scripts/video_digest.py "<链接>" --no-frames # 不要配图
python3 ~/.claude/skills/video-digest/scripts/video_digest.py "<链接>" --parse-only # 只解析不调智谱
python3 ~/.claude/skills/video-digest/scripts/video_digest.py "<链接>" "额外提取要求" --out /tmp/note.md
```
抖音整段分享文本可直接传入(脚本自动抠链接)。
## 产物(带配图的文档笔记)
- `<输出>/note.md`:内容提取(主题/画面/口播/结论/标签)+ 画面截图区(每张带时间戳与说明)
- `<输出>/frames/`:场景切换抽帧(过滤黑屏小帧、按最小间隔去连拍)
- 图片用相对路径 `frames/xxx.jpg` 引用;入库知识库时把 frames 语义化改名挪进 `Attachments/` 并修链接
- 输出:stdout 打印完整 markdown,同时默认存到 `/tmp/video-digest/<视频ID>.md`
- 提取 prompt 已内置(主题概述/画面内容逐段梳理/口播要点/关键结论/标签);要自定义提取侧重点时,把要求追加为第二个参数即可
## 平台支持与内部链路(排查时看)
| 平台 | 链路 |
|---|---|
| 抖音 | TikHub `/douyin/app/v3/fetch_one_video_by_share_url` 解析 → 无水印直链 → 直链传智谱 `video_url`(失败自动回退:curl 下载 → base64) |
| B站(BV/链接) | TikHub `fetch_one_video` + `fetch_video_playurl` 拿 DASH 双流 → curl 带 Referer 下载 → ffmpeg 合成 → base64 传智谱 |
| mp4 直链 | 不经 TikHub,直接传智谱;超 100MB 或智谱拉取失败则本机下载转 base64 |
**长视频(>5 分钟)自动分块**: