DeepSeek Harness 插件：ygunoil/dsh-va-studio

前言¶

DeepSeek Harness（DSH）采用「一切皆插件」的架构，让开发者通过插件扩展 Agent 能力。本地或云端运行的视频生成与剧本工具 VA Studio，是很多创意工作流的后端。但 Agent 要直接调用这些能力，需要把 DSH 的 Agent 接到 VA Studio 后端上。下面介绍的就是这样一个插件，它把本地 VA Studio 后端接进 DSH，让 Agent 可以直接生成短剧、图片、视频、小说和剧本，以及反推提示词。

这是什么¶

ygunoil/dsh-va-studio 是一个 DSH 插件，维护者是 ygunoil，分类为模型推理。它不内置模型，也不保存生成结果，而是把 DSH 的 Agent 接到你已经配置好模型和素材库的 VA Studio 后端上。

插件装上之后，Agent 可以直接：

• 自动生成短剧（一句话 → 项目 + 分镜）
• 自动生成图片（文生图 / 图生图，1–4 张，可指定画幅与分辨率）
• 自动生成视频（单条 4–30 秒文生/图生视频；短剧项目一键成片）
• 自动生成小说（含章节/字数控制，生成后取完整正文）
• 自动生成剧本（从创意或已有小说改编）
• 提示词反推（图片/视频 → 可直接使用的提示词、分镜、角色制作包）
• 提示词扩写（几个词 → 完整生图/生视频提示词）

核心功能¶

插件提供以下能力：

• 短剧生成：一句话剧情 → 短剧项目 + 分镜
• 图片生成：文生图 / 图生图，1–4 张，支持 9:16/16:9/1:1 等画幅
• 视频生成：单条 4–30 秒视频（文生/图生）
• 短剧项目一键成片：定妆/关键帧/视频/配音/压片
• 小说生成：含章节/字数控制，返回完整 Markdown
• 剧本生成：从创意或已有小说改编，返回市场版全文
• 提示词反推：图片/视频 → 提示词、分镜、角色制作包
• 提示词扩写：短提示词 → 生产级提示词
• 任务查询：继续等待/查询任意生成任务，完成后取回正文

安装与启用¶

前置条件：

1. DeepSeek Harness 0.2.1-rc.2（engines.dsh 限定 >=0.2.1-rc.2 <0.3.0）。
2. 一个可访问的 VA Studio 后端（默认 http://127.0.0.1:8790），且已登录账号有对应功能权限。
3. VA Studio 管理端已配置生成所需模型密钥（剧本需要 screenplay 功能权限）。

从 GitHub 安装：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
  plugin --profile desktop add github:ygunoil/dsh-va-studio

也可以在 DSH 的 Plugins → Add plugin 里填 github:ygunoil/dsh-va-studio，或填 release 里的 .tgz 地址。

从本地 tarball 安装（推荐在 DSH 的 Plugins 页安装）：

# 打包
cd /Users/mac/Desktop/xxt/dsh-va-studio
npm pack --cache /tmp/npm-cache-va-studio --pack-destination dist
# 得到 dist/dsh-va-studio-0.2.0.tgz

安装后如果界面没有立即出现新入口，按提示重启 Harness。配置入口有两个：Settings → Plugins → VA Studio，或 Plugins → dsh-va-studio → Configure。

配置连接¶

打开 设置 → 插件 → VA Studio：

点「保存并验证」会先调用后端健康检查，再验证登录；通过后配置才会落盘。

安装后可用的工具¶

长任务采用 wait_seconds 预算：超时不会失败，而是返回 jobId，让 Agent 继续用 va_studio_job 轮询。

随包技能¶

技能里写清了成本确认、输出归档、错误码处理和工作流顺序。

工作方式¶

DSH Agent
  ├─ 加载 va-studio 技能
  ├─ 调用 va_studio_generate_*（Host 半）
  │    ├─ ctx.credentials 取连接配置（密码/令牌只在 Host）
  │    ├─ POST /api/auth/login → 内存缓存 token（6 天）
  │    ├─ 提交异步任务 → 轮询 /api/drama/jobs/{id}
  │    └─ 取回正文/分镜/视频地址，经 render 返回给模型
  └─ 设置页（Client 半）读写 /api/va-studio.settings|save|test

• 凭据：ctx.credentials 单条记录（dsh-va-studio/connection），只暴露 configured/writable，不回传明文。
• 本地上传：只允许读当前会话工作区内的普通文件（图片 ≤20MB、视频 ≤120MB），防止把任意主机文件上传出去。
• 错误分类：AUTH / PERMISSION / INSUFFICIENT_POINTS / CONFLICT / VALIDATION / TIMEOUT / CONFIRM_REQUIRED 等稳定错误码，技能里带处理建议。
• 不自动重试昂贵操作：一键成片、出片类任务失败后不会自动重提。

适用场景与注意¶

本插件适合已经在使用 VA Studio 作为后端的开发者或团队，希望让 DSH Agent 直接调用其视频、图片、剧本生成能力的场景。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证（MIT）。

已知边界：

• 视频“方案生成”（文本/小说 → 多条视频方案）暂未做成独立工具，当前视频能力是单条片段与短剧项目成片。
• 视频反推使用同步接口：超长视频请先剪短或降低 max_frames；异步反推会额外生成角色身份板/故事板图并产生额外成本，本插件暂不调用。
• 生成任务在 VA Studio 服务端继续执行，插件超时或取消不会取消服务端任务；可用 jobId 回 VA Studio 任务中心查看。
• 需要登录的媒体文件（项目内文件、成片下载）在浏览器里打开时使用 VA Studio 自己的登录态。

短结尾¶

这个插件把 DSH 的 Agent 接到 VA Studio 后端，让 Agent 可以直接生成短剧、图片、视频、小说和剧本，以及反推提示词。如果你已经有 VA Studio 后端，可以安装这个插件，让 DSH Agent 直接调用其能力。更多细节见插件目录页与 GitHub 仓库。

目录¶

• 标题
• 前言
• 这是什么
• 核心功能
• 安装与启用
• 配置连接
• 安装后可用的工具
• 随包技能
• 工作方式
• 适用场景与注意
• 短结尾