前言¶
在 DeepSeek Harness（DSH）里做智能体或日常对话时，常见做法是另开脚本、单独调各家图像 API，再把文件路径贴回会话。链路长、密钥分散，也不利于在 transcript 里直接看到结果。dsh-shengtu 把「对话内生图」和「输入框旁的可视面板」放在同一套配置里，面向已在用 DSH 的开发者。
这是什么¶
dsh-shengtu 是社区维护的 DSH 插件（维护者 xuhairui-dzz，GitHub 仓库 xuhairui-dzz/dsh-shengtu，目录分类为模型推理）。定位是 Multi-engine image generation for DeepSeek Harness：在会话中完成生图，并支持火山引擎 Ark、SiliconFlow 以及 OpenAI 兼容端点。当前 package 版本为 0.4.4，许可证 MIT，要求 DSH >=0.2.1-rc.3。
核心功能¶
插件做两件事（README 原文表述）：
- Agent 工具
generate_image：在对话里说「画一张……」，生成图直接出现在 transcript 里。 - Composer 下方「Image generation」按钮：打开面板，含 Generate、Config 两个标签页，以及开关；面板与 agent 工具共用一份引擎配置和凭证引用。
引擎可在面板 Config → Engine 切换，切换后立即生效。预设包括：
| Engine | 凭证环境变量 | 默认 endpoint / model |
|---|---|---|
| Doubao · Volcengine Ark | ARK_API_KEY |
https://ark.cn-beijing.volces.com/api/v3 / doubao-seedream-5-0-flash-260915 |
| SiliconFlow | GUIJI_API_KEY |
https://api.siliconflow.cn/v1 / Kwai-Kolors/Kolors |
| OpenAI | OPENAI_API_KEY |
https://api.openai.com/v1 / gpt-image-1（模板） |
| Custom | 任意 | 任意暴露 POST {baseURL}/images/generations 的服务 |
配置项（节选，含义以 README 为准）：
| Key | 含义 |
|---|---|
engine |
预设：ark / siliconflow / openai / custom |
baseURL, model |
端点与模型名 |
credentialRef |
凭证变量名，各引擎有默认值 |
size, watermark, timeoutMs |
尺寸、水印、超时 |
outDir |
输出目录；空则使用会话工作目录下的 generated/ |
pricePerImage |
本地记账用的单价（CNY/张）；为 0 时只统计张数 |
密钥不会写入配置文件：通过 Harness 凭证服务读取（设置里的 credential store、Shell 环境或 .env）。面板 API Key 字段会直接写入 credential store。
面板标题会显示 N today · M total（设置了单价时才显示金额）。这是本地统计，不是云厂商账单。
安全边界（README 说明）：密钥仅在 Host 侧读取，浏览器端只见 ready / missing；下载图片有字节上限与 PNG/JPEG/WebP 签名校验；面板图片路由只服务 outDir 内文件并拒绝路径穿越。
安装与启用¶
插件市场上架后可从市场安装；也可直接从仓库安装。官方命令如下：
dsh plugin add github:xuhairui-dzz/dsh-shengtu
安装后刷新页面（Ctrl+R）。包声明了 dsh.bundle，会在 profile 里以普通 bundle 激活。
若需固定 revision 而非跟踪 main，在命令后追加 commit：
dsh plugin add github:xuhairui-dzz/dsh-shengtu#<40-char-sha>
典型用法¶
对话内生图：启用插件后，在会话中自然语言描述画面，由 agent 调用 generate_image，结果出现在当前 transcript。
面板生图：点击 composer 下方的 Image generation，在 Generate 里提交提示词；在 Config 里选引擎、填 API Key（或事先在环境变量 / credential store 配置对应变量）、调整 size 等项。需要临时关闭能力时，用面板上的 on/off 开关即可。
仓库提供离线行为测试（开发用）：
node test/toggle-test.mjs
适用场景与注意¶
适合已经在 DSH 里跑对话或智能体、希望统一接 Ark / SiliconFlow / OpenAI 兼容生图 API 的用户。多引擎共用一套配置，适合在国产云与 OpenAI 形态之间切换对比。
安装前请自行查看仓库源码与 MIT 许可证。DSH 插件以当前 dsh 进程权限运行，凭证与写盘行为应纳入你自己的安全评估。社区插件目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；生态理念是「一切皆插件」，本文不将其描述为官方应用商店。
结尾¶
dsh-shengtu 把 agent 工具与 composer 面板绑在同一套多引擎配置上，减少「对话外另开生图脚本」的重复劳动。进一步了解可访问目录页 https://www.skillhub.cn/plugins/xuhairui-dzz/dsh-shengtu 与 GitHub https://github.com/xuhairui-dzz/dsh-shengtu。
