前言¶

當 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