---

name: book-video-pipeline

description: "小紅書薦書影片自動產生v3 - Seedance 2.0 原生音訊+字幕，從選書到發佈全自動"

license: MIT

invoke: "/book-video"

---

# 小紅書薦書影片自動產生Pipeline v3

book-video-pipeline

## 概述

基於火山方舟Seedance 2.0 API 的小紅書薦書影片全自動產生流程。

**v3 改進（基於官方提示詞指南）：**

- **原生音訊** — prompt 內直接指定旁白，Seedance 自動產生語音（不再用edge-tts）

- **原生子幕** — prompt 裡指定字幕內容，Seedance 在影片內產生同步字幕

- **封面標題卡** — pan/zoom 效果+ 靜音音訊軌道，保證拼接相容

- **鍊式產生** — 每段用前一段尾幀做起始圖，畫面更連貫

- **crossfade 拼接** — 視訊xfade + 音訊acrossfade，音畫同步過渡

**核心流程：選書→ 詳情/封面→ 腳本→ 分鏡→ 影片產生（含音訊字幕）→ 拼接→ 預覽→ 發佈**

---

## 靜默執行協議

- Do not ask for confirmation to proceed. 不要要求確認以繼續。

- Generate the full output in one go. 一次產生完整輸出。

- If data is missing, use the defined defaults. 如果資料缺失，使用預設值。

- Never say "是否繼續"、"需要我幫你..."、"請確認" 等中斷性語句。

---

## 環境要求

| 依賴| 安裝|

|------|------|

| 火山方舟API Key | 環境變數`VOLCENGINE_API_KEY` |

| imageio-ffmpeg | `pip install imageio-ffmpeg`（自備ffmpeg） |

| Docker (xiaohongshu-mcp) | 發佈時需在`localhost:18060` 運作|

---

## 執行流程

**觸發方式：`/book-video` 或`/book-video 《書名》`**

### 步驟1：選書

**情況A - 使用者指定了書名：** 直接使用。

**情況B - 未指定書名：** 執行搜尋腳本（優先低粉爆款）：

『`bash

python "D:\skills\xiaohongshu-book-publisher\scripts\search_hot_books_v2.py"

```

從「低粉爆款」分類自動選Top 1（排除`[已發布]`）。

**錯誤處理：** 腳本逾時→ 快取→ WebSearch → 預設《被討厭的勇氣》

---

### 步驟2：取得書籍詳情和封面

**2.1 豆瓣取得詳情**

```

WebFetch: https://search.douban.com/book/subject_search?search_text={書名}

擷取：書名、作者、豆瓣評分、內容簡介、金句/核心觀點、封面URL

```

**2.2 下載封面（英文檔名！）**

『`bash

curl -o "D:\xiaohongshu_data\cover_{english_name}.jpg" -H "Referer: https://book.douban.com/" "封面URL"

```

curl 失敗則用：

『`bash

python "D:\skills\xiaohongshu-book-publisher\scripts\get_cover_playwright.py" "{書名}"

```

---

### 步驟3：產生薦書腳本+ 分鏡

基於書籍詳情，產生**口語化影片腳本**。

**提示詞公式（基於Seedance 2.0 官方指南）：**

每個分鏡prompt 由三個部分組成：

1. **音訊指令** — `產生帶有畫外音的影片。一個{voice_type}說："旁白文字"`

2. **視覺描述** — `主體+ 動作+ 環境+ 鏡頭運動+ 氛圍`

3. **字幕指令** — `畫面底部出現字幕，字幕內容為"旁白文字"，字幕需與音訊節奏完全同步。 `

**腳本模板（6-7 個分鏡，~35 秒）：**

```markdown

## 薦書影片腳本

**書名**：《{書名}》

**風格**：治癒系（溫暖金色調）

### 分鏡1 - 開場懸念（5秒）

**旁白**：{一句吸引眼球的開場白}

**畫面**：{50-80字英文視覺描述：主體+動作+環境+鏡頭+氛圍}

### 分鏡2 - 書籍亮相（5秒）

**旁白**：{一句話介紹這本書}

**畫面**：{英文，與書相關的場景}

### 分鏡3 - 作者/背景（5秒）

**旁白**：{作者背景或創作故事}

**畫面**：{英文，寫作場景、書房等}

### 分鏡4 - 核心觀點1（5秒）

**旁白**：{一個打動人心的觀點或金句}

**畫面**：{英文，與觀點相符的視覺隱喻}

### 分鏡5 - 核心觀點2（5秒）

**旁白**：{另一個打動人心的觀點或金句}

**畫面**：{英文，與觀點相符的視覺隱喻}

### 分鏡6 - 個人感想（5秒）

**旁白**：{真實感受，讀完後的改變}

**畫面**：{英文，情感場景}

### 分鏡7 - 推薦號召（5秒）

**旁白**：{號召行動}

**畫面**：{英文，溫暖的結尾場景}

```

**畫面描述規則：**

- **必須英文**，50-80 字

- 按公式：主體+ 正在做什麼動作+ 在什麼環境+ 什麼光線/氛圍+ 鏡頭怎麼移動

- **不要提到封面圖/書名文字**（文字透過字幕產生）

- 盡量描述具體的場景，避免抽象概念

**可選聲音類型：**

- 療癒系：`溫柔平靜的女聲`

- 懸疑系：`深沉低沉的男聲`

- 清新系：`輕快活潑的女聲`

---

### 步驟4：呼叫pipeline 生成視頻

**4.1 儲存分鏡JSON**

```json

[

{"scene_id": 1, "prompt": "英文視覺描述...", "narration": "中文旁白"},

{"scene_id": 2, "prompt": "英文視覺描述...", "narration": "中文旁白"},

……

]

```

儲存到`D:\xiaohongshu_data\storyboard_{english_name}.json`。

**4.2 呼叫完整pipeline v3**

『`python

import sys, json

sys.path.insert(0, r"D:\skills\book-video-pipeline\scripts")

from seedance_client import SeedanceClient

client = SeedanceClient(api_key="YOUR_API_KEY")

with open(r"D:\xiaohongshu_data\storyboard_xxx.json", encoding="utf-8") as f:

storyboard = json.load(f)

result = client.generate_full_video(

storyboard=storyboard,

cover_path=r"D:\xiaohongshu_data\cover_xxx.jpg",

book_title="書名",

output_dir=r"D:\xiaohongshu_data",

voice_type="溫柔平靜的女聲",

with_subtitles=True,

)

print(f"Video: {result['video_path']} ({result['size_kb']}KB, ~{result['duration']}s, audio: {result['has_audio']})")

```

**pipeline v3 自動執行：**

1. 封面→ 標題卡（3秒pan/zoom + 靜音音訊軌）

2. 順序產生影片片段（每段包含原生音訊+ 字幕）

3. crossfade 拼接（視訊xfade + 音訊acrossfade）

4. 輸出最終視頻

**API Key 配置：**

『`bash

set VOLCENGINE_API_KEY=ark-xxx

```

---

### 步驟5：預覽

產生HTML 預覽頁面`D:\preview_video_{name}_{date}.html`，包含：

- 視訊播放器

- 書名、作者、評分

- 旁白文字版

- 小紅書粉色系樣式

『`bash

start "" "D:\preview_video_xxx.html"

```

**等用戶確認。 ** 不滿意可：

- 調整分鏡prompt → 重新生成

- 換聲音類型→ 重新生成

- 調整視覺描述→ 只改prompt

---

### 步驟6：發佈到小紅書

**6.1 檢查登入** → MCP `check_login_status`

**6.2 產生視訊筆記文案**（不是影片腳本！）

- 標題≤20 字，第一人稱有情感

- 正文200-300 字，20+ emoji

- 標籤10-15 帶# 號

**6.3 MCP 發布**

『`python

MCP_URL = 'http://localhost:18060'

# 初始化→ publish_content(title, content, video, tags)

# 視訊路徑用容器內路徑: /app/data/xxx.mp4

```

**6.4 記錄已發布** → `published_books.json` 加`"type": "video"`

---

## 輸出格式

```markdown

## 薦書影片產生完成

**書名**：《{書名}》

**作者**：{作者} | **豆瓣**：{評分}

### 視訊訊息

- 長度：~{N} 秒（標題卡3s + {M} 個分鏡x 5s）

- 比例：9:16 豎屏

- 解析度：720p

- 檔案大小：{N} MB

- 音訊：有/無

- 字幕：內嵌/無

- 路徑：`D:\xiaohongshu_data\{name}_final.mp4`

### 發布訊息

- 標題：{標題}

- 標籤：{標籤}

- 狀態：{成功/失敗}

```

---

## 關鍵規則

1. **原生音訊優先** — Seedance 2.0 原生支援音訊生成，prompt 裡指定旁白即可

2. **原生子螢幕** — prompt 裡指定字幕內容，Seedance 自動產生同步字幕

3. **尾幀串聯** — 每段用前一段最後一幀做起始圖，畫面更連貫

4. **分鏡畫面用英文** — Seedance 英文畫面效果更好

5. **聲音類型統一** — 全片以同一個聲音類型

6. **影片比例9:16** — 小紅書豎屏

7. **發布前必須用戶確認** — 展示預覽後等OK

8. **圖片檔案名稱必須英文** — 中文會導致上傳逾時

9. **影片腳本≠ 圖文筆記** — 腳本是口語化的，不是文章

10. **拼接保留音訊** — xfade 視訊過渡+ acrossfade 音訊過渡

## 提示詞參考（Seedance 2.0 指南）

### 音訊指令模板

```

產生帶有畫外音的影片。一個{voice_type}說："{旁白內容}"

```

### 字幕指令模板

```

畫面底部出現字幕，字幕內容為"{字幕內容}"，字幕需與音訊節奏完全同步。

```

### 完整場景提示詞範例

```

產生帶有畫外音的影片。一個溫柔平靜的女聲說："你有沒有想過，為什麼我們總是活在別人的期待裡？" A solitary figure standing at a crossroads on a misty forest path, sunlight filtering through tall tr​​ees, warm golden hour lighting, slow depfield in shallow.畫面底部出現字幕，字幕內容為"你有沒有想過，為什麼我們總是活在別人的期待裡？"，字幕需與音頻節奏完全同步。

```

## 檔案引用

| 文件| 用途|

|------|------|

| `D:\skills\book-video-pipeline\scripts\seedance_client.py` | Seedance API + 原生音訊/字幕+ 拼接（v3） |

| `D:\skills\xiaohongshu-book-publisher\scripts\search_hot_books_v2.py` | 熱門書籍搜尋|

| `D:\skills\xiaohongshu-book-publisher\scripts\published_books.json` | 已發布記錄|

| `D:\skills\xiaohongshu-book-publisher\scripts\get_cover_playwright.py` | 封面取得（備用） |

| `D:\xiaohongshu_data\` | 影片與封面輸出目錄|

## API 配置

| 參數| 值|

|------|-----|

| 視訊模型| `doubao-seedance-2-0-fast-260128` |

| 聲音類型| `溫柔平靜的女聲`（預設） |

| 比例| `9:16` |

| 單段長度| 5 秒|

| 標題卡| 3 秒pan/zoom + 靜音音訊|

| crossfade | 0.5 秒過渡（視訊+音訊） |