🎬 影片工作室
為系統新增三項原本沒有的功能:移除內嵌字幕、頻道分析及重新上傳管道。其餘階段(下載影片、提取字幕、翻譯、TTS)則位於其他擴充功能中 — 詳見下方規則。
🛑 重要規則:當工具缺失時,引導使用者,不要說「做不到」
多數影片階段由選用擴充功能處理。如果使用者要求某個尚未安裝的擴充功能:
- 不要給出「我沒有這個能力」這類泛泛的回答。
- 發出
{"action": "video_capabilities"}以取得確切的清單。 - 將結果原封不動交給使用者 — 其中會列出確切需要安裝哪個擴充功能、描述每個擴充功能,並提醒他們前往市集 (
/market) 然後重新啟動伺服器。
工作 → 所需擴充功能:
| 工作 | 所需擴充功能 |
|---|---|
| 下載影片 | video_downloader |
| 提取字幕 / 翻譯 / 燒錄字幕 | subtitle_extractor |
| 語音合成 (TTS) | tts_vibevoice |
| 移除原始字幕 · 分析頻道 · 管道 | video_studio (已安裝) |
| 完整重新上傳管道 | 以上全部 4 個 |
📥 video_capabilities — 查看可執行的操作
{"action": "video_capabilities"}
在拒絕任何影片要求前先使用此動作。
📥 analyze_channel — 分析頻道,提供內容建議
{"action": "analyze_channel", "url": "https://www.youtube.com/@tenkenh"}
回傳:主題、受眾、語氣、熱門影片的標題公式,以及 5–8 個附帶 Hook 的新影片點子。當使用者問「這個頻道在講什麼」、「我下一步該做什麼影片」時使用。
📥 remove_hardsub — 移除內嵌字幕
{"action": "remove_hardsub", "video_path": "C:/path/video.mp4", "mode": "delogo"}
mode:delogo (預設 — 從周邊邊界插值;在純色背景上文字會消失而不留下痕跡)、blur、pixel、fill。
📥 reup_video — 執行完整鏈路
{"action": "reup_video", "url": "https://v.douyin.com/xxxx"}
下載 → 提取字幕 → 翻譯 → 遮罩原始字幕 → 語音合成 → 燒錄新字幕。建立一個等待審核的 Codex 任務 — 將任務編號回報給使用者,並提醒他們執行 approve <n>。不要說它已經執行完畢;它只是剛剛被排入佇列。
🌐 HTTP API
| 方法 | 端點 | 工作 |
|---|---|---|
| GET | /api/v1/video-studio/capabilities | 可以執行什麼 / 缺少什麼 |
| GET | /api/v1/video-studio/capabilities/{job} | 單一工作的詳細資料 |
| POST | /api/v1/video-studio/hardsub/detect | 僅偵測字幕區域,不修改影片 |
| POST | /api/v1/video-studio/hardsub/remove | 偵測 + 遮罩 |
| POST | /api/v1/video-studio/channel/analyze | 分析頻道 |
| POST | /api/v1/video-studio/pipeline/plan | 查看管道將執行哪些步驟 |
| POST | /api/v1/video-studio/pipeline/reup | 將管道排入 Codex 任務佇列 |
💡 範例
使用者:「https://www.youtube.com/@abc 這個頻道在講什麼內容?」
{"action": "analyze_channel", "url": "https://www.youtube.com/@abc"}
使用者:「幫我把這部影片重新上傳成越南語 https://v.douyin.com/xxx」
{"action": "reup_video", "url": "https://v.douyin.com/xxx"}
使用者:「幫我提取這部影片的字幕」— 但 subtitle_extractor 尚未安裝:
{"action": "video_capabilities"}
→ 然後將原始結果交給使用者,讓他們知道需要安裝什麼。