DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。对于需要处理多媒体内容的智能体开发者而言,将零散的模型调用、提示词工程和流程编排整合成一个稳定的自动化工作流,通常需要编写大量胶水代码。dsh-media-gen 旨在解决这一问题,它将媒体简报直接转化为模型选择、生产就绪的提示词,以及(可选的)Atlas Cloud 可执行工作流。
简介¶
这是一个由 AtlasCloudAI 维护的独立 DSH 配置包,覆盖图像、视频、音频和 3D 工作流。安装后,三个核心技能将变得可用,同时包含可选的 Atlas Cloud MCP 桥接功能。该插件主要解决以下问题:
- 模型选择:确定 Atlas Cloud 针对图像、视频、音频、3D、ASR 或 LLM 工作应使用的具体模型 ID、API 和 Schema。
- 视频规划:使用 Seedance 技能规划可控、一致的视频镜头和参考关系,输出故事板和连续性方案。
- 提示词生成:将一个通用的视频简报转化为跨模型的通用提示词规范,以及针对特定模型的编译版本。
- 执行桥接:通过 MCP 桥接,使 DSH 能直接调用 Atlas Cloud 的模型查询、媒体上传、生成提交及账号使用检查等操作。
安装与配置¶
- 安装插件:
将插件安装到你指定的 DSH 配置文件中(例如web):
dsh plugin --profile web add 'github:AtlasCloudAI/dsh-media-gen#v0.2.0'
dsh --profile web --dump-config
- 设置凭证:
插件安装和技能发现不需要 Atlas Cloud 凭证,但执行生成操作需要。从 Atlas Cloud 控制台 获取密钥并在启动 DSH 的进程中设置:
export ATLASCLOUD_API_KEY="<your-key>"
- 启用 MCP 桥接(可选):
MCP 桥接默认出于安全原因处于禁用状态,因为它是一个在沙箱外运行的受信任子进程。若需启用,需在目标配置文件目录的$DSH_HOME/profiles/<profile>/cordis.patch.yml中添加以下行:
- id: atlascloud-mcp
disabled: false
重启配置文件后,DSH 将暴露如 `mcp__atlascloud__atlas_list_models` 等工具名称。
典型用法¶
在激活了该插件的 DSH 会话中,可以直接输入指令让插件处理媒体简报。例如:
Plan an 8-second coffee product video. Compare Seedance with one available alternative, recommend a model, and produce a three-shot storyboard, final prompt, and exact parameters. Do not submit generation; wait for my confirmation.
DSH 会利用内置技能,分析简报,对比模型方案,并输出包含镜头故事板、最终提示词及参数的详细方案,而不会自动提交生成请求。
注意事项¶
- 许可证:本项目遵循 MIT 许可证。
- 兼容性:DSH 配置包使用
dsh.bundle.patch和 Cordis MCP 行,与 OpenAI/Codex 插件使用不同的主机清单。虽然技能内容可以复用,但主机集成不能直接互换,必须使用package.json及相应的 DSH 配置格式。 - 安全:MCP 服务器默认禁用,建议仅在受信任的环境中启用以避免潜在的安全风险。
- 验证:安装前建议检查源码与许可证。
总结¶
dsh-media-gen 通过将 Atlas Cloud 的能力封装为 DSH 技能,实现了从需求分析到执行落地的流程自动化。更多技术细节与源码可参考其 GitHub 仓库 或 技能目录页。