dsh-vidgen-plugin · DSH 官方插件包
为 DeepSeek Harness(DSH) Web GUI 开发的 AI 视频/图片生成插件,以官方插件包形式安装。
- host:
lib/index.js—— 注册tools / webServer / settings / shell,暴露 24 个 RPC + 3 个 agent 工具,服务端口POST /dsh-vidgen/rpc - client:
lib/client.js——window.__ModuleLoader__风格,挂载侧栏入口 / 设置卡 / 工作室 overlay / 工具面板 slots - scripts:
scripts/*.js—— 子进程辅助(配置读写 / 画布快照 / 历史 / HTTP / 清理),无第三方依赖,纯 Node 调用
安装(DSH 官方方式)
1. 把仓库放到本地(任意位置)
git clone https://github.com/xsluck/dsh-vidgen-plugin.git
cd dsh-vidgen-plugin
2. 用 pnpm link 装进当前 DSH profile
# 进入 DSH profile 的 package.json 目录
cd ~/.dsh/profiles/web
把仓库加进 dependencies + dsh.profile.bundles:
{
"dependencies": {
"dsh-vidgen-plugin": "link:/绝对路径/到/dsh-vidgen-plugin"
},
"dsh": {
"profile": {
"bundles": ["dsh-vidgen-plugin"]
}
}
}
然后:
pnpm install # 建立 symlink
3. 重启 DSH
npx @deepseek-ai/dsh web
重启后:
- 侧栏 footer 多一个 🎬 入口(打开生成工作室)
- 设置页多一段「视频生成」卡片(多提供者配置)
- agent 工具列表多三个:list_video_models / generate_video / poll_video_task
> ⚠️ 修改 lib/ 或 scripts/ 后必须重启才会生效 —— 这是官方插件方式的标准生命周期。
功能
🎬 节点画布工作室
- 六种节点:文生图 / 图生图·多图合成 / 图源 / 文生视频 / 图生视频 / 关键帧
- 节点连线(拖右侧 🟠 圆点);1 张 = 图生图,2+ 张 = 多图合成(图生图与多图合成共用
extra_body.image数组) - 关键帧 2~3 张(实测 3 张可出片)
- 本地图片上传(≤8MB,base64 仅支持图生图链路;视频链路需先经图生图转平台图)
- 缩放 / 平移 / 全屏悬浮工作室 / 图片点击放大
- 单节点运行 + 「⚡ 运行全部」(图片节点按依赖层并行)
- 生成历史最近 12 条,跨重启保留
- 画布快照:新画布自动存档,可保存 / 加载 / 删除快照(最多 20 份)
⚙️ 多提供者设置页
- 视频 / 图片各自独立的提供者列表,每段任意多个平台,可「⭐ 设为当前」
- 提供者管理:新建 / 保存 / 删除 / 加载当前 / 测试连接 / 清除全部用户提供者
- 「🔄 获取模型」:用编辑框的 apiUrl + Key(留空则用当前)请求
GET {apiUrl}/models,自动过滤出视频/图片模型;拉到后第一个自动填入默认模型(无需手动选) - 系统兜底场景下保存默认模型时,自动从当前 active 注入 apiKey(无需用户重复填 Key)
- 配置文件:
~/.dsh/vidgen-config.json(优先)或系统临时目录 - 读取优先级:用户提供者(active) → settings.yaml(dsh-video / dsh-imagegen 段) → 生图插件 draw-config.json → 系统兜底
🤖 模型工具(供 Agent 直接调用)
list_video_models— 列出当前视频提供者的可用视频模型generate_video— 文生视频(默认)/ 图生视频(image_url)/ 关键帧(mode="keyframes"+image_urls2~3 张);wait=true时轮询至完成,返回 mp4 URLpoll_video_task— 按task_id/video_id查询任务状态
🌐 API 兼容
OpenAI 风格 /videos、/images/generations、/models 接口。视频轮询走 {base}/agnesapi?video_id=…&model_name=…。
目录结构
dsh-vidgen-plugin/
├── package.json # 官方插件包元数据(dsh.bundle.patch + client.inject + dependencies)
├── cordis.patch.yml # 官方 bundle patch(注入 vidgen plugin row)
├── lib/
│ ├── index.js # 官方 host 入口(tools + REST /dsh-vidgen/rpc)
│ └── client.js # 官方 client bundle(ModuleLoader)
├── scripts/ # 宿主子进程辅助脚本(纯 Node,无第三方依赖)
│ ├── vidgen-cfg-v3.js # 配置读取(多提供者 v3)
│ ├── vidgen-save-v3.js # 配置保存 / 切换 / 删除 / 清除
│ ├── httpscript.js # 子进程 HTTP(json body 参数化,支持 stdin)
│ ├── cleanscript.js # 清理临时配置
│ ├── histscript.js # 生成历史持久化
│ ├── graphscript.js # 画布持久化
│ ├── snapscript.js # 画布快照持久化
│ └── runner.js # 旧脚本包装器
└── README.md
开发
语法检查
npm test # 等价于 node --check lib/index.js && node --check lib/client.js
调试子进程脚本
任一脚本支持两种 payload 传参方式:
- 命令行:node script.js ''(小 payload 方便)
- stdin:echo '' | node script.js(大 payload / 含特殊字符推荐,自动规避 ARG_MAX 与 shell 转义)
数据文件位置
| 内容 | 路径 |
|---|---|
| 配置(多提供者) | ~/.dsh/vidgen-config.json |
| 画布快照 | ~/.dsh/vidgen-snapshots.json |
| 生成历史 | ~/.dsh/vidgen-history.json |
| 当前画布 | ~/.dsh/vidgen-graph.json |
(都优先写到 ~/.dsh/,无权限则回退到系统临时目录)
卸载
cd ~/.dsh/profiles/web
# 移除 package.json 里的 dsh-vidgen-plugin dependency + dsh.profile.bundles 里的同名项
pnpm install
重启 DSH 即可彻底下线。
License
MIT
