dsh-plugin-novelai
> 像聊天一样生图，把想象直接说成画面。 告别枯燥的提示词工程——描述你脑海里的画面，AI 自动按专业规则写好 NovelAI V4.5 提示词并出图，不用再手搓 Danbooru tags。
NovelAI Diffusion V4.5 Full 生图插件 for DeepSeek Harness（DSH）。
在对话里描述你想要的图片，AI 会按内置的 NovelAI 提示词设计规则（参考并改进了 ChatChatBar 的 NOVELAI_IMAGE_PROMPT_SYSTEM）写好提示词，然后调用 nai_generate_image 工具真正生成。生成的 PNG 保存到本地文件，工具结果只含文本，纯文本模型适配器不会收到图片内容块。
安装
# 从 GitHub（生产推荐）
dsh plugin --profile web add github:ysysz0343-web/dsh-plugin-novelai
# 从 npm
dsh plugin --profile web add @scope/dsh-plugin-novelai
# 本地开发：用 file: 前缀（复制安装）。裸路径会被 pnpm 当作 link: 软链，
# 软链跟随真实路径，导致 @deepseek-ai/* peer 依赖无法通过 profiles/node_modules 回退解析。
dsh plugin --profile web add file:./path/to/dsh-plugin-novelai
> 仓库需公开；dsh-plugin topic 是第三方插件目录（deepseek-harness-plugin.com）收录的要求，非官方硬性要求。
> 本插件是纯 JavaScript（无 TypeScript 构建步骤），git 安装直接可用、无需任何构建授权（不同于需要 prepare 脚本的 TypeScript 插件）。
> 安装后部分版本需要重启 Harness（dsh web）才生效。
验证：
dsh plugins list
配置 NovelAI Token
三种方式（优先级从高到低，任选其一）：
- 直接在对话里把 API 发给 AI —— 最简单：把
pst-xxxx粘贴到对话里，AI 生成时会自动带上； - 在
cordis.patch.yml的config.token里配置（一劳永逸）； - 配置环境变量
NOVELAI_API_KEY，或写入$DSH_HOME/.credentials.yaml（DSH 原生密钥库，推荐，比 env 更持久安全）。
使用方法
配置好 Token 后，直接在对话里说，例如：
> 帮我生成一张 nai4.5f 图：雨夜里银发少女撑着红伞站在霓虹窄巷，湿漉漉的裙摆，侧后方视角
AI 会设计好 base_caption / characters / size_preset，调用 nai_generate_image，图片保存到会话工作区的 nai-images 目录（默认），工具结果里会返回文件路径。
设计提示词时，AI 会先用 nai_tag_suggest 查询 Danbooru 官方 tag（角色/动作/体位/镜头/环境等，支持中文/英文/拼音）来规范化提示词，避免凭印象拼写错 tag。
工具
| 工具 | 说明 |
|---|---|
nai_generate_image |
按设计规则生成 NovelAI V4.5 Full 图片 |
nai_tag_suggest |
查询 Danbooru tag 建议（中文/英文/拼音），用于规范化提示词 |
nai_reverse_prompt |
图片提示词反推：读本地图片，用识图 LLM 描述并按 NAI 规范反推出提示词 |
图片提示词反推（需配置识图 LLM）
nai_reverse_prompt 读取一张本地图片，调用你配置的识图 LLM（任意 OpenAI 兼容的多模态端点）描述画面并按 NAI 规范反推出提示词。在 settings.yaml 里填（热加载，改完即生效）：
novelai-image:
visionBaseUrl: http://127.0.0.1:8080/v1 # base URL（本地 llama.cpp 或在线服务）
visionApiKey: "" # API Key（本地可留空）
visionModel: Qwen3.8-27B-Uncensored-noMTP-Q4_K_M.gguf # 模型名
> 任意 OpenAI 兼容端点都行：本地 llama.cpp、SiliconFlow、gptsapi、OpenAI 等。
用法：反推 E:\path\to\image.png 的提示词，得到提示词后可再让 AI 用它生成同风格图。
nai_generate_image 参数
| 参数 | 类型 | 说明 |
|---|---|---|
base_caption |
string (必填) | 整体画面 caption，以人数开头（1girl / 2girls / 1boy, 1girl） |
characters |
array | 每个角色的 caption（外观标签，最多 6 个），可选 center 坐标 |
size_preset |
string | PORTRAIT=832x1216 / SQUARE=1024x1024 / HORIZONTAL=1216x832 |
negative_prompt |
string | 负向提示词，留空用内置默认 |
seed |
number | 随机种子，留空随机 |
batch_size |
number | 生成张数 1-4，默认 1 |
token |
string | 可选，临时 Token 覆盖 |
proxy |
string | 可选，HTTP 代理（默认 http://127.0.0.1:2080；none/空 = 直连） |
实现说明
- 端点
POST https://image.novelai.net/ai/generate-image-stream，模型nai-diffusion-4-5-full，请求体逐字段对齐 ChatChatBar 项目的 V4 实现（params_version:3、28 steps、scale 8、k_euler_ancestral、Karras、v4_prompt/v4_negative_prompt等）。 - 响应是 MessagePack 二进制流（4 字节大端长度前缀帧），插件内置纯 JS 解码器解析
intermediate/final/error。 - 请求走 Windows 自带
curl.exe（-x支持代理），因为 DSH 的web.fetch只支持 GET 文本。 - Token 不落盘；插件进程内不持久化任何凭据。
安全提示
插件会调用外部 API（image.novelai.net）并使用你的 NovelAI Token。安装来自 GitHub 的插件前请先检查源码。
License
MIT
