dsh-draw-router:给 DeepSeek Harness 增加统一绘图路由

前言

当 DeepSeek Harness(DSH)的 agent 需要在对话中生成图像时,开发者通常已经有一些 OpenAI 兼容的图像生成端点,但不同服务的模型名、请求路径和可用模型列表并不一致。dsh-draw-router 是一个 DSH 插件,目标是把这类绘图能力收敛到 agent tools 中:注册 draw_imagedraw_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,例如为 stepfunsensenovaagnes 配置 baseUrlapiKey

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 进程权限运行。安装前建议检查源码、依赖和许可证。
  • 配置会保存 baseUrlapiKey,应把 draw-config.json 和相关配置文件按敏感信息处理。
  • API 响应不暴露完整 API key,不代表密钥在本地完全不可见。
  • DSH 插件生态强调“一切皆插件”,社区目录用于查找插件,不是官方应用商店。

获取信息

  • 社区目录:https://www.skillhub.cn/plugins/xiaozhe7772222/dsh-draw-router
  • GitHub:https://github.com/xiaozhe7772222/dsh-draw-router
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye