前言¶
DeepSeek Harness（DSH）的設計理念是「一切皆插件」。在開發智能體或調試過程中，有時需要直接生成視覺內容。現有的方案往往需要額外的配置或獨立的 UI，且與開發環境割裂。
下面介紹 muze63096/dsh-draw-plugin。這是一個運行在 DSH 客戶端的插件，側邊欄增加了一個整頁面板。你只需輸入提示詞，即可在本地或通過雲端服務出圖。
插件概況¶
這是一個由 muze63096 維護的開源插件，目前在生態目錄收錄。核心價值在於將文生圖能力集成到 DSH 的側邊欄中，提供即寫即畫的體驗。
- 名稱：muze63096/dsh-draw-plugin
- 許可：MIT
- 核心能力：側邊欄整頁面板、寫提示詞即出圖、Q版/正常兩檔畫風、三個出圖引擎、零運行時依賴、本機引擎一鍵安裝、支持 LoRA、中文提示詞自動譯成英文、限流自動重試、按真實格式落盤、歷史縮略圖、自定義保存位置。
安裝與啓用¶
插件通過 npm 安裝到 DSH 的 profile 中。
# 從 npm 安裝
dsh plugin --profile web add dsh-draw-plugin
# 從本地目錄安裝（必須加 -w）
dsh plugin --profile web add -w "D:\path\to\dsh-draw-plugin"
注意：
-w參數是必須的。DSH 的 profile 目錄本身就是 pnpm 的 workspace root，不加此參數會報錯。安裝完成後，需重啓 DSH 的 web app，因爲客戶端 bundle 會在啓動時組圖。
核心功能¶
安裝完成後，側邊欄底部會出現一個鉛筆圖標的「畫圖」面板。
- 多引擎支持：支持三種出圖引擎，Key 由使用者自行填入。
- 免費引擎：Pollinations，開箱可用，無需配置 Key。
- 硅基流動：提供 Kolors 等模型，需在硅基流動控制台創建 Key。
- 自定義接口：對接任意 OpenAI 兼容的
/images/generations端點。 - 本機引擎：直接調用本地部署的 Stable Diffusion 推理端。
- 畫風與提示詞：
- 提供「Q版」和「正常」兩檔畫風預設，畫風詞默認置於提示詞最前方以增強效果。
- 支持中文提示詞自動譯成英文，這是爲了適配本地底模（本地底模通常按 Danbooru 英文標籤訓練，看不懂純中文）。
- 本地化與 LoRA：
- 本機引擎支持一鍵安裝。插件不代管 ComfyUI，需要你本機先啓動推理端。
- 支持 LoRA。在 ComfyUI 模式下，可在面板下拉選擇；在輕量版 SD.cpp 模式下，需在提示詞中寫入
<lora:名字:0.8>。
- 穩定性與落盤：
- 免費引擎的限流（402/429）會觸發自動重試機制。
- 支持按真實格式落盤，後綴與 Content-Type 一致。
- 支持自定義保存位置，填過即記住。
典型用法¶
- 基礎使用：點擊側邊欄的鉛筆圖標進入面板。
- 免費出圖：默認使用免費引擎，直接輸入中文提示詞並點擊生成即可。
- 切換引擎：切換到「硅基流動」或「自定義接口」，填入對應的 API Key。Key 也可以存儲在工作區的
.dsh-draw-key.txt文件中。 - 固定角色：在「固定角色」輸入框寫入一段描述，每張圖都會自動帶上這段描述，適合反覆生成同一角色。
- 使用預設：在提示詞框上方使用預設按鈕，一鍵填好畫風、尺寸和負面提示詞。
本機引擎與本地部署¶
本機引擎支持兩種模式，磁盤佔用與安裝難度差異較大。
1. 輕量版（SD.cpp）¶
- 體積：約 29 MB 引擎 + 2 GB 模型（總計 ~2.5 GB）。
- 速度：RTX 4050 / 512×512 / 20 步，約 9.5 秒。
- 要求：Windows + 支持 Vulkan 的顯卡（N 卡、A 卡、核顯均可）。
- 接口：自帶 OpenAI 兼容與 A1111 兼容接口，插件接入無需額外代碼。
2. 完整版（ComfyUI）¶
- 體積：約 5 GB（含 CUDA 版 PyTorch）+ 2 GB 模型（總計 ~12 GB）。
- 速度：RTX 4050 / 512×512 / 20 步，約 10 秒。
- 要求：Windows + NVIDIA 顯卡（CUDA）。
- 生態：完整的 ComfyUI 生態，支持自定義節點和工作流。
安裝本機引擎時，面板會提供「一鍵安裝」按鈕。對於 ComfyUI，它會自動下載嵌入式 Python、ComfyUI 源碼、CUDA 版 PyTorch 及默認底模（全部走國內可達源）。安裝位置默認爲 $DSH_HOME/comfyui。
保存位置與配置¶
默認保存目錄爲 $DSH_HOME/dsh-draw。面板上的「保存到」輸入框支持自定義路徑：
* 留空：使用默認目錄。
* 相對路徑（如 my-pics）：按 $DSH_HOME 解析。
* 絕對路徑（如 D:\pics\draw）：直接使用。
* 家目錄（如 ~/pics）：解析爲用戶家目錄下的 pics。
配置會保存在 $DSH_HOME/dsh-draw.config.json 中。生成的圖片文件名格式爲 img-<seed>-<ts>.jpg（後綴隨實際格式變化）。
適用場景與注意¶
- 適用場景：DSH 開發者需要快速生成視覺反饋、調試多模態智能體、或需要複用特定角色的畫風。
- 注意事項：本機底模通常按 Danbooru 英文標籤訓練，強烈建議開啓中文自動譯成英文。如果使用輕量版 SD.cpp，LoRA 需手動寫入標籤格式。Key 在硅基流動創建，與 DeepSeek 的 API Key 互不通用。
