book2vido-videolisted
Install: claude install-skill xingtu1996/xingtu-skills
# book2vido · 文本/PDF → 竖屏短视频
本地跑、不花一分钱、不需要任何 API key(配音用 edge-tts 免费接口,画面用 Pillow 现画,合成用 FFmpeg)。
## 何时用
- 用户给一个 PDF / md / txt,想要一条能发的短视频
- 用户说「按第 3 章出片」「把这本书做成视频」
- 用户想批量把长文转视频
## 前置检查(必做,别跳过)
按这个顺序确认,缺哪个就明确告诉用户缺哪个:
| 依赖 | 检查命令 | 缺失时 |
|---|---|---|
| book2vido 仓库 | `--repo` 指向的目录里有 `src/book2vido/` | 让用户给路径 |
| Python 依赖 | 仓库里能 `python -m book2vido.gui --help` | 见仓库 README 的安装步骤 |
| FFmpeg | `which ffmpeg` | `brew install ffmpeg` |
| Ollama(可选) | `curl -s localhost:11434/api/tags` | 不装也能跑,会降级到规则分镜(质量下降,提前说明) |
**环境体检可以直接问服务**:`b2v.py start` 后 `curl http://127.0.0.1:<port>/api/check-env`,它会一次性回报 ffmpeg/ollama 状态。
## 一条龙(最常用)
```bash
python3 ~/.workbuddy/skills/book2vido-video/scripts/b2v.py \
auto /path/to/书.pdf \
--repo /path/to/book2vido \
-o ~/Movies/out.mp4
```
脚本会自动:探测空闲端口启动 GUI → 上传文件 → 发起任务 → 轮询进度 → 下载成片。
只出某一章(PDF 才会分章;md/txt 整篇当一章):
```bash
... auto 书.pdf --repo /path/to/book2vido --chapter 3 -o ch03.mp4
```
## 分步(需要中间控制时用)
```bash
B2V=~/.workbuddy/skills/book2vido-video/scripts/b2v.py
$B2V start --repo /path/to/book2vido # 打印 http://127.0.0.1:<port>
$B2V upload /path/to/书.pdf # 返回服务端 path
$B2V run <服务器返回的 path> --chapter 3 # 返回 job_id,自动轮询到 done
$B2V status <job_id> # 单独查进度
$B2V fetch <video_name> -o out.mp4 # 下载成片
$B2V stop # 用完关掉
```
## 服务端 API(脚本封装的就是这几个,需要时可裸调)
| 端点 | 作用 |
|---|---|
| `POST /api/upload` | multipart 上传,存到仓库 `uploads/` |
| `GET /api