前言¶
在 DeepSeek Harness（DSH）里做智能体或日常开发时，经常需要出图：有时希望对话模型根据自然语言直接调用工具生成，有时又希望在侧边栏里挑参考图、换模型和比例，且不占对话轮次。把生图逻辑塞进自定义脚本或外部服务，往往还要自己管密钥、落盘路径和会话里的「上一张图」引用。
dsh-image-lite 是社区维护者 yupaoa 发布的 DSH 生图插件（分类：模型推理），提供对话模式与工作台模式两条入口，共用同一套模型库与快速配置；插件自包含、无额外 runtime 依赖，密钥经 DSH 核心凭据服务解析。下面介绍它的定位、能力与安装用法。
这是什么¶
dsh-image-lite 面向已使用 DSH 的开发者：在任意会话中让对话模型通过 image_generate_lite 工具文生图或带参考图迭代，或在右栏「生图工作台」里手动完成同一套生图流程。
- 维护者：yupaoa
- 仓库：github.com/yupaoa/dsh-image-lite
- 社区目录页：skillhub.cn/plugins/yupaoa/dsh-image-lite
- 当前 package 版本：0.1.0；许可证：MIT
环境要求（README 原文）：DSH >= 0.2.1-rc.2，Node.js ^22.19.0 || >= 24.0.0（随宿主）。低于该版本的 DSH 不保证可用：插件依赖的 configForms、右栏标签注册等接口在 0.2.1 系列才稳定。
核心功能¶
对话模式¶
在任意会话里说「画一张…」「出个图」「来张 16:9 的」等，对话模型会自动调用 image_generate_lite：
- 不带参考图 → 文生图。
- 说「把这张改成…」「参考刚才那张」 → 带
referenceImages图生图。 - 结果文本内嵌 refs JSON，下一轮可继续「用这张继续」，支持链式图生图。
工作台模式¶
通过会话 header 的「生图」角标或右栏引导卡片，打开右栏「生图工作台」tab：
- 参考图：本会话最近结果「用这张继续」、上传或粘贴（经 attachment admission）。
- 换模型、选比例可实时调整，写入同一插件入口，热生效。
- 描述 → 生成 → 结果图库与灯箱 → 选中结果继续迭代。
- 右上角红色「清空」可一键复位参考图、描述与结果。
全程不占对话轮次。
共用配置与存储¶
两种模式共用插件入口 image-gen-lite（volatile 热生效）。在插件页 → dsh-image-lite → 插件配置（plugins.bundle.config 卡片）可配置：
- 模型库：增删改供应商/模型（name、baseUrl、接口格式、密钥环境变量、模型列表，每行
id或id 显示名）。 - 快速配置：默认模型与默认图片规格（7 档比例 + auto），下一次
image_generate_lite调用即生效。 - 图片存放位置：留空为
<会话工作区>/generate/image，也可填绝对路径，并可用「打开文件夹」调用系统选择器。 - 侧边栏 · 在侧边栏中使用生图工作台（开关，默认开）：关闭后立即隐藏右栏「生图工作」标签、引导卡片与会话 header 的「生图」按钮（
image_generate_lite不受影响）；重新开启后刷新窗口即恢复。
模型库、默认项、输出目录、侧边栏开关落在 DSH profile 配置里的 image-gen-lite 段（README 记载本机实测落盘为 ~/.dsh/profiles/<profile>/cordis.patch.yml）。API 密钥在 DSH 凭据服务中按环境变量名索引（如 IMAGE_GEN_AGNES_API_KEY，配置里只留变量名与掩码）。生成的图片在默认或你指定的输出目录；换机时带上 profile 与凭据存储即可带走模型库与密钥，卸载插件不会删除它们。
工作原理（简述）¶
两种入口共用一条链路：读设置 → 换密钥 → 向 {baseUrl}/images/generations 发一次 HTTPS（openai-images 约定）→ 解码 b64_json 或按 url 下载后落盘并登记会话附件。工作台经 DSH web server 上 /image-gen-lite/* 本地 RPC（受 DSH 登录令牌保护）走同一套逻辑。网络出口仅为配置的供应商 baseUrl 及结果图 URL；README 明确无遥测、不访问其它站点。
安装与启用¶
README 给出的安装方式为本地 link 包（需先将插件目录放到本机，再替换路径）：
# 从 DSH 桌面端 CLI / 插件页安装本地包（link: 方式）：
dsh plugin --profile desktop add link:D:\path\to\dsh-image-lite
重启 DSH（或 HMR 生效时自动重组合）后：
- 插件页 → dsh-image-lite：添加供应商/模型、在供应商卡片粘贴密钥，选默认模型与规格。
- 对话模式：在会话里说「画一张…」即自动调用
image_generate_lite。 - 工作台模式：会话 header 出现「生图」角标，点开进入右栏「生图工作」tab（插件页「侧边栏」开关可关闭角标与 tab，工具调用仍可用）。
典型用法¶
对话文生图：在会话中直接描述画面与比例，例如要求 16:9，由模型调用 image_generate_lite 出图。
链式改图：生成后说「参考刚才那张，把背景改成…」，插件会带 referenceImages 再请求一轮。
工作台迭代：打开「生图工作台」，上传或粘贴参考图，切换模型与比例，填写描述后生成；在图库中选中结果继续改，或用「清空」重新开始。
密钥在插件页供应商卡片粘贴即可，存入 DSH 凭据服务，配置中仅保留环境变量名与掩码（示例形式：sk-0****7890）。
适用场景与注意¶
适合需要在 DSH 会话内与生图 UI 中统一模型库、又希望密钥不落插件明文、输出路径可控的场景。工作台适合反复调参、不想消耗对话 token 的出图任务；对话模式适合让模型根据上下文自动决定是否带参考图。
使用前请注意：
- 插件以当前 DSH 进程权限运行，安装前应在 GitHub 查看源码与 MIT 许可证，并理解 README 中的读/写/网络边界（例如参考图仅认显式传入的附件，生成图路径有白名单）。
- 社区目录 skillhub.cn 为独立生态站点，与 DeepSeek / 幻方无官方从属关系，插件亦非官方内置组件。
- 卸载插件不会删除已生成图片与凭据中的密钥；彻底清理需自行删除 profile 里
image-gen-lite段、对应凭据环境变量名及输出目录。
结尾¶
dsh-image-lite 把 DSH 里的生图收敛为「对话工具 + 侧边栏工作台」双入口，配置与密钥跟 profile 走，请求与落盘路径在文档中有明确边界。进一步了解可访问 社区目录页 与 GitHub 仓库。
