前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」。在构建基于 DSH 的智能体应用时，把外部能力接入 Agent 工具链或 Web 界面，是常见需求。视频生成作为典型场景，需要处理异步任务、结果轮询、流媒体播放与本地持久化。本文介绍一个社区维护的插件：dsh-videogen，它把智谱 CogVideoX 的文生视频能力接进 DSH 的 Web 界面与 Agent 工具链。
是什么¶
dsh-videogen 是一个 DeepSeek Harness 插件，分类为模型推理。它仅适配智谱 CogVideoX 协议，不依赖第三方构建工具，通过内置任务队列与 Range 流媒体，在宿主重启后不遗留僵尸任务，并提供 Web 面板与 Agent 工具，方便开发者把视频生成能力集成到工作流中。
核心功能¶
- 渠道管理：内置智谱 CogVideoX 协议适配（
POST /videos/generations+GET /async-result/{id}异步轮询），支持多渠道、多模型别名。密钥只存本地，浏览器读到的是掩码。 - 任务队列：提交后后台轮询，任务记录（最近 200 条）与成品视频（
videos/<taskId>.mp4）落盘在~/.dsh/dsh-videogen/；宿主重启后未完成任务标记失败，不会出现永远转圈的卡片。 - Web 面板：左下角 🎬 按钮 → 提交表单（模型/尺寸/时长/画质/声音）+ 渠道设置 + 任务列表 + 播放器。桌面壳经结构化注入行加载（whale-widget 同款通道，注入失败不影响启动），Web 端走 tapIndex。
- 流媒体：
/dsh-videogen/media?taskId=支持 HTTP Range，视频可拖动进度条。 - Agent 工具：
videogen_generate（提交并等待，超时返回 timedOut 可稍后查询）、videogen_tasks（查询单个/最近任务与可用模型）。
安装与启用¶
插件要求 DSH 版本 >=0.2.1-rc.2 <0.3.0-0、Node.js >=22.19.0，无第三方依赖。
从本地目录安装进目标 profile（web / desktop）：
dsh plugin --profile web add "file:/绝对路径/dsh-videogen"
或先从 GitHub 克隆：
git clone https://github.com/pink-sys/dsh-videogen.git
dsh plugin --profile web add "file:$PWD/dsh-videogen"
桌面版（DSH Desktop）的 profile 由应用独占管理，命令行安装会报错；请用 设置 → 内置插件 → 添加插件 走图形界面。
装好后重启 DSH，左下角出现 🎬 按钮即生效。
典型用法¶
- 点左下角 🎬 → ⚙ 渠道设置 → 填入智谱 API 地址（默认
https://open.bigmodel.cn/api/paas/v4）与 API Key → 保存。 - 在面板中写描述并生成视频；或在对话里让 Agent 调
videogen_generate。
适用场景与注意¶
- 适合需要快速在 DSH 中接入智谱 CogVideoX，并希望拥有本地任务队列与 Range 流媒体播放的开发者。
- 本插件以当前 DSH 进程权限运行，生成结果保存在
~/.dsh/dsh-videogen/videos/，不会自动写进工作区，需要长期留存请自行复制。 - 依赖未公开的宿主接口（桌面壳注入行与
webServer.register/tapIndex），DSH 升级可能破坏它们，因此版本范围被收窄到 0.2.x。 - 图生视频未实现（面板与工具目前只有文生视频）。
- 未在 web profile 上实测，仅在 desktop profile 验证。
短结尾¶
dsh-videogen 提供了一个轻量、零构建的视频生成接入方案，适合作为「自己接一家新上游」的参考实现。若要开箱即用的成品，社区还有功能更全的视频生成插件可供选择。
- 插件目录页：https://www.skillhub.cn/plugins/pink-sys/dsh-videogen
- GitHub：https://github.com/pink-sys/dsh-videogen
