在 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 的插件,仓库需公开。
插件源码与目录页见下方链接。