在 DeepSeek Harness (DSH) 中構建具備視覺能力的智能體時，直接調用 NovelAI V4.5 Full 生成圖片是一個常見需求。手動編寫 Danbooru 標籤的提示詞往往耗時且容易出錯。dsh-plugin-novelai 旨在解決這一痛點，讓智能體能夠直接在對話中描述畫面，由插件負責處理提示詞工程和 API 調用。
這是一個由 ysysz0343-web 維護的模型推理插件，支持 NovelAI Diffusion V4.5 Full 規則。它集成了提示詞自動編寫、Danbooru 標籤查詢以及圖片提示詞反推功能。
安裝¶
通過官方 CLI 進行安裝：
dsh plugin --profile web add github:ysysz0343-web/dsh-plugin-novelai
安裝後部分版本需要重啓 Harness (dsh web) 才能生效。
配置 Token¶
插件需要 NovelAI 的 API Token。配置優先級從高到低：
- 在對話中直接發送 API Key（如
pst-xxxx），AI 生成時會自動帶上； - 在
cordis.patch.yml的config.token中配置； - 使用環境變量
NOVELAI_API_KEY或寫入$DSH_HOME/.credentials.yaml（DSH 原生密鑰庫）。
使用方法¶
配置好 Token 後，直接在對話中描述即可。AI 會自動按規則編寫提示詞並調用生成工具。
- 生成圖片示例：幫我生成一張 nai4.5f 圖：雨夜裏銀髮少女撐着紅傘站在霓虹窄巷，溼漉漉的裙襬，側後方視角
- 反推提示詞示例：反推 E:\path\to\image.png 的提示詞
插件內置了以下工具：
nai_generate_image：按規則生成 NovelAI V4.5 Full 圖片。nai_tag_suggest：查詢 Danbooru 標籤建議（支持中文/英文/拼音），用於規範化提示詞。nai_reverse_prompt：圖片提示詞反推。需在settings.yaml中配置識圖 LLM。
反推功能的配置示例如下：
novelai-image:
visionBaseUrl: http://127.0.0.1:8080/v1
visionApiKey: ""
visionModel: Qwen3.8-27B-Uncensored-noMTP-Q4_K_M.gguf
說明與限制¶
- 安全：Token 不落盤，插件進程內不持久化任何憑據。
- 請求方式：使用 Windows 自帶
curl.exe發送請求。 - 數據格式：響應爲 MessagePack 二進制流，插件內置解碼器解析。
- 倉庫要求：安裝自 GitHub 的插件，倉庫需公開。
插件源碼與目錄頁見下方鏈接。
