前言¶
在 DeepSeek Harness（DSH）裏做智能體或日常對話時，常見做法是另開腳本、單獨調各家圖像 API，再把文件路徑貼回會話。鏈路長、密鑰分散，也不利於在 transcript 裏直接看到結果。dsh-shengtu 把「對話內生圖」和「輸入框旁的可視面板」放在同一套配置裏，面向已在用 DSH 的開發者。
這是什麼¶
dsh-shengtu 是社區維護的 DSH 插件（維護者 xuhairui-dzz，GitHub 倉庫 xuhairui-dzz/dsh-shengtu，目錄分類爲模型推理）。定位是 Multi-engine image generation for DeepSeek Harness：在會話中完成生圖，並支持火山引擎 Ark、SiliconFlow 以及 OpenAI 兼容端點。當前 package 版本爲 0.4.4，許可證 MIT，要求 DSH >=0.2.1-rc.3。
核心功能¶
插件做兩件事（README 原文表述）：
- Agent 工具
generate_image：在對話裏說「畫一張……」，生成圖直接出現在 transcript 裏。 - Composer 下方「Image generation」按鈕：打開面板，含 Generate、Config 兩個標籤頁，以及開關；面板與 agent 工具共用一份引擎配置和憑證引用。
引擎可在面板 Config → Engine 切換，切換後立即生效。預設包括：
| Engine | 憑證環境變量 | 默認 endpoint / model |
|---|---|---|
| Doubao · Volcengine Ark | ARK_API_KEY |
https://ark.cn-beijing.volces.com/api/v3 / doubao-seedream-5-0-flash-260915 |
| SiliconFlow | GUIJI_API_KEY |
https://api.siliconflow.cn/v1 / Kwai-Kolors/Kolors |
| OpenAI | OPENAI_API_KEY |
https://api.openai.com/v1 / gpt-image-1（模板） |
| Custom | 任意 | 任意暴露 POST {baseURL}/images/generations 的服務 |
配置項（節選，含義以 README 爲準）：
| Key | 含義 |
|---|---|
engine |
預設：ark / siliconflow / openai / custom |
baseURL, model |
端點與模型名 |
credentialRef |
憑證變量名，各引擎有默認值 |
size, watermark, timeoutMs |
尺寸、水印、超時 |
outDir |
輸出目錄；空則使用會話工作目錄下的 generated/ |
pricePerImage |
本地記賬用的單價（CNY/張）；爲 0 時只統計張數 |
密鑰不會寫入配置文件：通過 Harness 憑證服務讀取（設置裏的 credential store、Shell 環境或 .env）。面板 API Key 字段會直接寫入 credential store。
面板標題會顯示 N today · M total（設置了單價時才顯示金額）。這是本地統計，不是雲廠商賬單。
安全邊界（README 說明）：密鑰僅在 Host 側讀取，瀏覽器端只見 ready / missing；下載圖片有字節上限與 PNG/JPEG/WebP 簽名校驗；面板圖片路由只服務 outDir 內文件並拒絕路徑穿越。
安裝與啓用¶
插件市場上架後可從市場安裝；也可直接從倉庫安裝。官方命令如下：
dsh plugin add github:xuhairui-dzz/dsh-shengtu
安裝後刷新頁面（Ctrl+R）。包聲明瞭 dsh.bundle，會在 profile 裏以普通 bundle 激活。
若需固定 revision 而非跟蹤 main，在命令後追加 commit：
dsh plugin add github:xuhairui-dzz/dsh-shengtu#<40-char-sha>
典型用法¶
對話內生圖：啓用插件後，在會話中自然語言描述畫面，由 agent 調用 generate_image，結果出現在當前 transcript。
面板生圖：點擊 composer 下方的 Image generation，在 Generate 裏提交提示詞；在 Config 裏選引擎、填 API Key（或事先在環境變量 / credential store 配置對應變量）、調整 size 等項。需要臨時關閉能力時，用面板上的 on/off 開關即可。
倉庫提供離線行爲測試（開發用）：
node test/toggle-test.mjs
適用場景與注意¶
適合已經在 DSH 裏跑對話或智能體、希望統一接 Ark / SiliconFlow / OpenAI 兼容生圖 API 的用戶。多引擎共用一套配置，適合在國產雲與 OpenAI 形態之間切換對比。
安裝前請自行查看倉庫源碼與 MIT 許可證。DSH 插件以當前 dsh 進程權限運行，憑證與寫盤行爲應納入你自己的安全評估。社區插件目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；生態理念是「一切皆插件」，本文不將其描述爲官方應用商店。
結尾¶
dsh-shengtu 把 agent 工具與 composer 面板綁在同一套多引擎配置上，減少「對話外另開生圖腳本」的重複勞動。進一步瞭解可訪問目錄頁 https://www.skillhub.cn/plugins/xuhairui-dzz/dsh-shengtu 與 GitHub https://github.com/xuhairui-dzz/dsh-shengtu。
