前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」。對於在本地跑大模型、需要繪圖能力的開發者來說，把現有的文生圖服務註冊成 DSH 原生工具是一個常見需求。本機已有 ComfyUI，通常是通過對話返回文件路徑，體驗割裂。dsh-text2img 插件的目標是把 ComfyUI 的文生圖能力掛載成 DSH 的原生 text2img 工具，讓 Agent 在對話中自然調用，生成的圖片直接作爲會話附件返回，無需上傳到雲端。
是什麼¶
dsh-text2img 是一個由 bgfhsnm 維護的 DSH 插件，把本機 ComfyUI 的文生圖能力註冊成 DSH 原生工具 text2img。它支持 FLUX.1 Dev、Qwen-Image、SDXL 三種模型，圖片不經過網絡，直接在本地生成並進入會話，不消耗 API 額度。插件本身是純掛載，不修改內核、無構建步驟。
核心功能¶
- 三種模型可選：FLUX.1 Dev（畫質/遵循度最好）、Qwen-Image（圖內可讀文字最強）、SDXL（最快）。
- 零雲端依賴：ComfyUI 跑在本地 127.0.0.1:8188，圖片落本地磁盤。
- 圖片直接進對話：通過 DSH 的 attachments 服務變成會話附件，返回
{ type: 'image', attachment: {...} }內容塊。 - 自動拉起 ComfyUI：服務未運行時自動執行啓動腳本並輪詢就緒（最多 120 秒）。
- 不覆蓋舊圖：ComfyUI 按 output 目錄編號，目標存在時自動加
_2、_3後綴。 - 降級安全：附件服務缺席時退化爲返回文件路徑，工具本身不會失敗。
工具參數¶
| 參數 | 類型 | 說明 |
|---|---|---|
prompt |
string，必填 | 詳細提示詞，建議英文長句 |
model |
flux / qwen / sdxl |
默認 flux |
width / height |
integer | 默認 1024 × 1024 |
steps |
integer | 默認 20（flux/qwen）或 25（sdxl） |
seed |
integer | 固定種子可復現同一張圖 |
guidance |
number | FLUX 專用，默認 3.5 |
negative |
string | 負向提示詞（qwen/sdxl 生效，FLUX 忽略） |
output_name |
string | 輸出文件名前綴 |
安裝與啓用¶
本插件是純插件掛載，不改內核、無構建步驟。先把包放到 DSH profile 的 plugins/ 目錄，然後在 profile 的 package.json 裏登記兩處：
$dest = "$env:USERPROFILE\.dsh\profiles\desktop\plugins\dsh-text2img"
New-Item -ItemType Directory -Force -Path $dest | Out-Null
Copy-Item .\* $dest -Recurse -Force
在 package.json 中加入：
{
"dependencies": {
"dsh-text2img": "file:./plugins/dsh-text2img"
},
"dsh": {
"profile": {
"bundles": [
// ……原有的 bundle……
"dsh-text2img"
]
}
}
}
重啓 DSH 後，模型選擇器旁的工具欄裏會出現 text2img 工具。
典型用法¶
在對話中直接調用 text2img 工具，例如：
{
"tool": "text2img",
"arguments": {
"prompt": "A cyberpunk city street at night, neon lights, rain, highly detailed",
"model": "flux",
"width": 1024,
"height": 1024,
"steps": 20,
"seed": 123456
}
}
工具會通過環境變量 TEXT2IMG_COMFY_URL、TEXT2IMG_COMFY_OUTPUT、TEXT2IMG_OUT_DIR、TEXT2IMG_START_BAT 指定 ComfyUI 地址、輸出目錄、最終保存目錄以及未運行時的啓動腳本。默認值對應作者本機佈局，換機器時可全部覆蓋。
適用場景與注意¶
適合需要本地可控文生圖、不希望上傳圖片到雲端的場景，例如內部知識庫可視化、敏感數據標註、離線工作流等。
注意：插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證（MIT）。模型文件需按 ComfyUI 標準目錄放置，具體路徑見前置條件。
結尾¶
dsh-text2img 讓本機 ComfyUI 的文生圖能力無縫接入 DSH 對話，Agent 可以自然地「畫一張圖」，圖片直接在會話中展示。如果你已經在本地跑 ComfyUI，這個插件可以減少一次文件路徑傳遞的割裂體驗。
- 目錄頁：https://www.skillhub.cn/plugins/bgfhsnm/dsh-text2img
- GitHub：https://github.com/bgfhsnm/dsh-text2img
