前言¶
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
