前言¶
在 DeepSeek Harness（DSH）里做智能体时，若希望模型「说画就画」、并把结果直接出现在当前会话，常见做法是外接独立绘图服务或手动复制 prompt 到 NovelAI 类 WebUI。链路长、上下文容易断。下面介绍社区插件 dsh-nai-artist（维护者 xianshu-virtuous）：把 paint 工具、自然语言到 NAI tags 的翻译，以及同源 WebUI 工作台接到 DSH web 客户端，生成图以对话内卡片形式展示（与 sticker 同类机制）。
这是什么¶
dsh-nai-artist 是 DSH 的客户端类外部插件（npm 包名 @dsh-external/dsh-nai-artist，当前 README 对应版本 0.2.0）。一句话定位：自然语言描述 → 翻译成 NAI tags → 调用 NovelAI 系（及 README 列出的其它）生图模型 → 图片渲染进对话；同时提供 /nai-artist 工作台做参数微调与历史管理。
目录页：SkillHub - dsh-nai-artist
源码与说明：GitHub - xianshu-virtuous/dsh-nai-artist
核心功能¶
paint 工具¶
对 Harness 中的模型使用自然语言即可，例如「画一张……」。插件暴露 paint 工具，传入描述后完成翻译与生图，结果以卡片形式出现在对话里，无需离开当前会话。
WebUI 工作台¶
两种入口：
- GUI 输入框右侧的绘画按钮（README 中以 🎨 标识）；
- 直接访问路径
/nai-artist。
工作台支持：翻译预览、手动编辑 NAI tags、调整模型/分辨率/steps/seed/scale/采样器/base tags/负向 prompt、发起生图、浏览历史画廊。
画廊与本地存储¶
生成图片写入插件目录下的 gallery/。WebUI 可查看、删除；超出上限时自动淘汰最旧作品。
安装与启用¶
官方 README 的安装方式面向 web profile，不是 dsh plugin add github:... 一类命令。步骤如下。
- 在 web profile 的
~/.dsh/profiles/web/package.json的dependencies中加入本地 link（路径按你本机插件源码位置修改；README 示例为 Windows 路径）：
"@dsh-external/dsh-nai-artist": "link:F:/dsh/dsh-nai-artist"
-
在
~/.dsh/settings.yaml的 bundle 部分插入cordis.patch.yml（或按 DSH 外部插件挂载流程操作）。 -
执行
pnpm install，并重启 DSH web 进程。
运行环境：package.json 要求 Node ^22.19.0 || >=24.0.0。
配置¶
凭证¶
在 ~/.dsh/.credentials.yaml 中配置 README 给出的 key（注释说明了用途）：
IKUN_PAINT_API_KEY: sk-xxx # 生图 key（gpt-image-2 / nai-* 模型）
IKUN_DEEPSEEK_API_KEY: sk-xxx # 翻译 key（deepseek-v4-flash-tokenrhythm）
README 提到需配置「三个 key」，但同一段仅列出上述两项；第三类 key 请以仓库最新 README 或源码为准，此处不臆造名称。
服务与绘画默认参数¶
- 服务级选项走
settings.yaml里llm-pi-ai插件配置（如enabled、baseURL、translateModel、paintModels、defaultModel等）。 - 绘画默认参数（base tags、负向 prompt、分辨率、采样参数等）在 WebUI 中编辑，保存于
<plugin home>/config.json。
生图模型¶
默认生图模型为 nai-v5-full-limit。WebUI 可选模型包括（以 README 为准）：
nai-v5-full、nai-v5-full-limitnai-v5-curated、nai-v5-curated-limitnai-v4.5-full、nai-v4.5-full-limitnai-v4.5-curated-limitgpt-image-2-lyc
典型用法¶
对话内生图¶
在 web 客户端与模型对话时，用自然语言描述画面，让模型调用 paint 工具。经过上面的配置与安装步骤后，生成结果会以卡片形式出现在当前会话。
工作台精调¶
需要预览翻译结果、改 tags 或固定 seed/采样器时，打开 /nai-artist 或输入框旁的绘画入口，在 WebUI 中调整后生图；历史可在画廊中管理。
适用场景与注意¶
适合谁：已在 DSH web 端跑智能体、希望把 NovelAI 风格生图嵌进对话与同一 Web 服务的开发者或自用部署者。
权限与安全：插件随当前 DSH 进程权限运行，会读写插件 home（含 gallery/、config.json）并调用外部生图/翻译 API。安装前请阅读 GitHub 仓库 源码与 LICENSE，自行评估密钥存放与网络出站策略。
生态说明：DSH 强调「一切皆插件」；SkillHub 为社区目录，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-nai-artist 把「描述 → tags → 生图 → 对话内展示」收进一条链路，并保留完整 WebUI 工作台，适合在 Harness 里做可视化创作而不拆会话上下文。详情与更新以仓库 README 为准：
- 目录页：https://www.skillhub.cn/plugins/xianshu-virtuous/dsh-nai-artist
- GitHub：https://github.com/xianshu-virtuous/dsh-nai-artist
