前言¶
DSH 的理念是「一切皆插件」。對需要把長流程任務拆成可觀察、可重試、可審計步驟的開發者來說，插件化比一次性調用更便於控制。dsh-video-studio（Whale/鯨影）把 AI 視頻與漫劇生產接到 DSH 裏，提供七段導演流水線、多賬號額度池、提示詞自優化與自我審計，目標是質量優先、成本其次。
這是什麼¶
一句話定位：DSH 原生 AI 視頻與漫劇生產插件。
倉庫路徑中的 owner 爲 hackerFish；package.json 包名爲 @hackerfish/dsh-video-studio。版本爲 0.2.0，許可證爲 MIT。
它解決的是：把故事、劇本、分鏡、素材、視頻生成和最終剪輯的長鏈路放進同一個插件裏管理，並保留分步執行、額度調度、提示詞優化和審計記錄。
七段導演流水線¶
Whale 的 pipeline 爲七段：
story → script → storyboard → master asset → shot assets → video → final cut
前三段是 LLM 階段。資料寫明：前三段由 DSH 會話模型執行，插件不調用外部 LLM。也就是說，當前會話模型承擔 story、script、storyboard，後續素材、視頻和剪輯由插件調度。
多賬號額度池與憑證庫¶
Whale 提供多賬號額度池/調度器，能力包括多賬號輪換、每日上限、指數退避、失敗回退，以及完整審計記錄。
憑證庫位置爲：
~/.whale/whale.json
資料標註該憑證庫使用 0600 權限、原子寫入，並跟隨 $DSH_HOME。API 響應做掩碼處理。賬號管理 UI 在插件設置的「鯨影賬號」tab 中。
賬號管理接口如下：
GET /dsh-video-studio/accounts
POST /dsh-video-studio/accounts
DELETE /dsh-video-studio/accounts
用途分別是列出賬號並掩碼、添加賬號、刪除賬號。
提示詞工程與評分回寫¶
Whale 的提示詞工程分爲四層：參數化專業模板庫、可組合質量增強項、本地提示詞優化、評分回寫。
常用工具：
whale_optimize_prompt
whale_quality_review
whale_optimize_prompt 用於在本地將草稿提示詞升級爲 pro-grade prompt。whale_quality_review 用於規則級 QC。評分回寫會把鏡頭評分與增強項組合寫回記錄，供優化器按歷史表現選擇。
風格記憶與一致性資產¶
Whale 有風格基因組/記憶：風格 DNA、鏡頭模板評分演化、重試反饋，跨會話保留。
一致性資產庫包含角色/場景主資產與每鏡頭變體，並自動注入參考圖。
並行鏡頭¶
並行鏡頭支持批量提交、併發輪詢、可配置併發。
供應商適配與狀態¶
下面列出的 provider 來自已覈實資料。即時可用性可能依賴真實 key、GPU 或平臺狀態，未全部驗證。
| Provider | 已覈實狀態 |
|---|---|
jimeng |
text-to-video queue 保持 SystemBusy（off-peak，0 credits consumed）；當前免費路線爲 wanx images → image-to-video |
tongyi-wanx |
free tier 爲 text-to-image；video needs membership |
kling official |
尚未用真實 key 測試 |
kling via DashScope |
尚未用真實 key 測試 |
kling-lipsync |
尚未用真實 key 測試 |
DashScope wan video |
live-verified；按 ¥0.70/s（1080p）計費，不是免費額度 |
doubao |
尚未用真實 key 測試 |
doubao-web |
Pro-tier free quota 爲 7-day window；image bot 耗盡時暫停，text 繼續工作 |
ComfyUI local |
real GPU pending |
kling web |
documented/deferred |
最終剪輯與配音¶
Whale 的最終剪輯能力包括 ffmpeg 自動渲染、JianYing/剪映草稿導出、可選脣形同步，以及 say TTS 或外部 voiceFile。
脣形同步爲可選能力；失敗時回退原 clip，不阻塞渲染。鏡頭也可以攜帶預先錄製好的 voiceFile，跳過本地 TTS。
分發包面向 4 箇中國平臺，提供規格與合規預檢。
DSH 集成接口¶
模型工具：
whale_story_presets
whale_storyboard
whale_generate_video
whale_optimize_prompt
whale_quality_review
whale_comfyui_workflow
whale_self_audit
Host routes：
/dsh-video-studio/health
/dsh-video-studio/runs
/dsh-video-studio/accounts
Client UI：
鯨影（狀態）
鯨影工作臺（運行進度）
鯨影賬號（賬號庫管理）
典型用法¶
下面按可復現程度列出。
1、預置漫劇包 mock 運行¶
資料標註支持 5 個題材，支持 whale_story_presets 和 scripts/demo-presets.ts 端到端 mock 運行。
scripts/demo-presets.ts 使用 mock provider 零 key 運行預置包。
2、把 preset 變成 pipeline-ready script¶
使用：
whale_story_presets
將一個 preset id 轉爲 pipeline-ready script。
3、本地優化提示詞¶
使用：
whale_optimize_prompt
將草稿提示詞升級爲 pro-grade prompt。
4、執行 provider routing/視頻生成¶
使用：
whale_generate_video
5、規則級 QC¶
使用：
whale_quality_review
6、生成 ComfyUI workflow JSON¶
使用：
whale_comfyui_workflow
7、自我審計¶
使用工具：
whale_self_audit
或運行：
npm run self-audit
會掃描倉庫並寫入：
docs/AUDIT-REPORT.md
8、賬號管理¶
通過 UI 或 host route 添加、列出、刪除賬號：
POST /dsh-video-studio/accounts
GET /dsh-video-studio/accounts
DELETE /dsh-video-studio/accounts
安裝與啓用¶
已覈實資料未提供官方安裝命令。爲避免憑名稱拼接，這裏不寫 dsh plugin add ... 一類命令。
可覈實的包信息如下：
{
"name": "@hackerfish/dsh-video-studio",
"version": "0.2.0",
"license": "MIT"
}
安裝前，先確認插件目錄頁或倉庫提供的安裝說明。插件會以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
適用場景與注意¶
適合需要把 AI 視頻/漫劇生成流程接入 DSH 的場景，尤其是需要分步執行、多賬號額度調度、提示詞優化、審計記錄和本地剪輯導出的情況。
注意：
- 部分 provider 尚未用真實 key 或真實 GPU 測試，即時可用性依賴平臺狀態。
DashScope wan video按¥0.70/s（1080p）計費，不是免費額度。tongyi-wanxfree tier 爲 text-to-image；video needs membership。jimeng的 text-to-video queue 可能保持SystemBusy；資料中的當前免費路線爲wanx images → image-to-video。- 脣形同步是可選能力，失敗會回退原 clip，不阻塞渲染。
鏈接¶
- 插件目錄頁：
https://www.skillhub.cn/plugins/hackerFish/dsh-video-studio - GitHub：
https://github.com/hackerFish/dsh-video-studio
