前言¶
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 互不通用。
