前言¶
当 DeepSeek Harness(DSH)的 agent 需要在对话中生成图像时,开发者通常已经有一些 OpenAI 兼容的图像生成端点,但不同服务的模型名、请求路径和可用模型列表并不一致。dsh-draw-router 是一个 DSH 插件,目标是把这类绘图能力收敛到 agent tools 中:注册 draw_image 和 draw_list_sources,自动发现可用的图像模型,并让 agent 可以在对话中直接调用。
这是什么¶
dsh-draw-router 是 DeepSeek Harness 统一绘图路由器:自动识别任意 OpenAI 兼容端点的绘图模型。维护者为 xiaozhe7772222,许可证为 MIT。它把图像生成封装成 DSH agent 可调用的工具,同时提供 REST API,用于管理 draw sources 和发起绘图请求。
环境信息¶
- 包版本:
0.1.1 - Node:
>= 18 - DeepSeek Harness:
0.1.0--rc.6
上面三项来自 README badge 和 package.json 的版本信息。
核心功能¶
下面介绍已核实的功能点。
Agent 工具¶
插件注册两个 agent tools:
draw_image:在对话中生成图像draw_list_sources:查看可用的绘图来源
DSH agent 可以在对话中原生调用 draw_image,例如用户提出“帮我画一张流程图,展示API调用过程”时,agent 可以调用类似:
draw_image(source='sensenova', prompt='...')
自动模型发现¶
插件会调用:
GET /v1/models
并基于名称模式匹配自动检测图像模型,不依赖固定模型清单。插件支持手动添加模型,适合未通过 /v1/models 暴露图像模型的服务。
多提供商¶
插件支持以下 OpenAI 兼容端点或提供商:SenseNova、StepFun、Agnes、Qwen/Tongyi Wanxiang、Jimeng/Seedream、Hunyuan、GPT Image、Flux、Stable Diffusion、Imagen 等。
配置 baseURL 时给 API root,插件自动追加:
/images/generations
/models
REST API¶
插件提供 REST API,可用于增删/探测 draw sources。绘图接口为:
POST /dsh-draw-router/draw
来源验证接口示例:
curl http://127.0.0.1:3080/dsh-draw-router/sources
API 响应不暴露完整 API key。
配置持久化¶
配置会持久化到:
draw-config.json
这样重启后仍然可以继续使用已配置的 draw sources。
安装与启用¶
先添加插件,再重启 DSH,最后验证 HTTP 服务。
添加插件¶
如果插件已发布到 npm registry,可运行:
dsh plugin add dsh-draw-router --profile web
重启 DSH¶
npx @deepseek-ai/dsh web
验证 HTTP 服务¶
curl http://127.0.0.1:3080/dsh-draw-router/sources
如果插件已启动,可以查看 sources 列表。
典型用法¶
对话调用¶
下面是一个对话示例:
User: 帮我画一张流程图,展示API调用过程
Agent: 调用 draw_image(source='sensenova', prompt='...')
该示例展示 agent 通过 draw_image 调用指定 source 完成绘图。
静态配置¶
静态配置通过 cordis.patch.yml 配置 sources,例如为 stepfun、sensenova、agnes 配置 baseUrl 和 apiKey:
sources:
stepfun:
baseUrl: <stepfun-base-url>
apiKey: <stepfun-api-key>
sensenova:
baseUrl: <sensenova-base-url>
apiKey: <sensenova-api-key>
agnes:
baseUrl: <agnes-base-url>
apiKey: <agnes-api-key>
这里使用占位符,避免在文档中写真实密钥。配置中的 baseURL 给 API root 即可。
运行时管理¶
也可以通过 REST API 管理 draw sources,并用 POST /dsh-draw-router/draw 发起绘图。
适用场景与注意¶
适合已有 OpenAI 兼容图像生成端点、希望 DSH agent 在对话中直接绘图的使用者。它适合把多个图像 API 收敛到同一个 DSH 工作流中,减少 agent 端对模型名和请求细节的耦合。
注意以下几点:
- 插件以当前 DSH 进程权限运行。安装前建议检查源码、依赖和许可证。
- 配置会保存
baseUrl和apiKey,应把draw-config.json和相关配置文件按敏感信息处理。 - API 响应不暴露完整 API key,不代表密钥在本地完全不可见。
- DSH 插件生态强调“一切皆插件”,社区目录用于查找插件,不是官方应用商店。
获取信息¶
- 社区目录:https://www.skillhub.cn/plugins/xiaozhe7772222/dsh-draw-router
- GitHub:https://github.com/xiaozhe7772222/dsh-draw-router