前言¶
在 DeepSeek Harness（DSH）里做智能体，常见做法是单独维护一套「生图脚本 + 本地 Playground」，模型侧再手写 HTTP 封装。图多了以后，提示词、配置档、异步任务和落盘路径很容易对不上，智能体也很难稳定地「自己调生图」。
下面介绍社区插件 dsh-gpt-image（维护者 yyfabab1）。它把 GPT Image Playground（gpt-image2ground）里的能力模型搬进 DSH：多服务商、多配置档、文生图与图生图、异步轮询、自定义接口模板，并扩展成面向游戏素材的流水线（规格校验、审核、装机、像素画处理等）。插件在 SkillHub 分类为「模型推理」，当前 GitHub 约 3 stars；npm 包名 @dsh-external/dsh-gpt-image，版本 1.11.0，MIT 许可证，运行时仅依赖 Node ≥20 的 node: 内置模块，装进 profile 不需要再拉依赖树。
DSH 生态是「一切皆插件」；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-gpt-image 的定位是「GPT Image 出图台」：把出图能力暴露为 DSH 工具（README 自检为 27 个工具、4 个侧栏页），浏览器可访问面板 http://127.0.0.1:3080/gpt-image 查看历史与核对结果。原「素材锻造炉」已并入本插件，README 建议 DSH 里只保留这一个生图插件。
与 Playground 对齐的部分包括：profiles 配置档、config 的 import/export（兼容 gpt-image-config.json）、generate（Images / Responses 模式）、edit（图生图与蒙版局部重绘）、generate + job 的异步任务，以及按项目落盘（<素材名>_序号.png、<素材名>.json、图片清单.md）。
核心功能¶
生成与编辑¶
- 文生图：
generate，支持apiMode: images或 Responses 下的image_generation工具。 - 图生图 / 局部重绘：
edit，multipart 传image[]与mask。 - 异步任务：
generate设wait_s=0取得task_id，再用job查询或等待完成。 - 生视频：
video工具支持文生视频，以及keyframe、reference等模式；first_frame/images可直接传本地路径（插件侧处理公网 URL）。README 说明视频走 Agnes 等异步接口，与出图线路不同。 - 多服务商：内置 openai / sb2api 异步 / fal 等模板，也可自定义
provider声明式模板。
素材流水线与质量¶
- 质量地基（
quality工具）：规格校验与自动修复、像素画净化与真像素判定、协调性、派生变体、图集、视觉标签、评分路由、偏好与回归等（README 归纳为 A–E 组能力）。 - 规格即代码：
resolveSpec按内置默认 →<游戏目录>/asset-specs.json→ 「待画素材清单.md」→ 显式参数解析；能自动修的尺寸、透明、留白、毛边先修，不能修的再进人工。 - 自动化编排（
auto）：声明式 YAML 流水线（后处理、切片、校验、路由、自动审核、装机等），配合 DSH 任务看板 cron 可做auto action=maintenance日常维护。插件无常驻进程，定时与目录监听需借助外部调度（README 有说明）。 - 素材工作室（
studio）：模板、变体矩阵、成本、引用完整性、备份回滚、风格库等（F–J 组）。 - 审核与装机：画廊以磁盘为准；人主要在「审核」与「冲突」环节介入，合格素材可走
install装机；侧栏提供生图画廊、核对徽章（达标 / 规格不符 / 没被引用 / 用不上）。
界面与运维¶
- 左侧栏「生图」图标与会话头部「生图」按钮打开同一套画廊（浮层版
Esc关闭）。 - 花费闸门、免费档记账、磁盘守卫、预览图
*_labeled.png体积控制等，见 README 各节。 - 自检：
node scripts\inventory.mjs核对 27 工具 / 32 路由 / 4 侧栏页配对；npm test为单元测试入口。
安装与启用¶
推荐从 DSH 内置商店添加插件源（README「从 DSH 商店装」）：
https://gcore.jsdelivr.net/gh/yyfabab1/dsh-gpt-image@main/market-index.json
路径：设置 → 插件 → 发现（Discover）→ 添加插件源，填入上列地址。
Windows 可在插件包内使用一键脚本（先检查、再安装）：
一键安装.bat check
一键安装.bat
脚本会检查 Windows / Node 20+、定位 DSH profile、自检工具与侧栏，建目录链接（失败则复制），并重启 DSH；跳过重启可设 set AUTO_NORESTART=1。README 注明仅在作者本机（Windows + Node 22）验证过，风险见包内 安装说明.html。
手动安装（README 原文）：
dsh plugin --profile web add @dsh-external/dsh-gpt-image
本地开发可用目录联接指向源码（Windows 示例）：
mklink /J "%USERPROFILE%\.dsh\profiles\web\node_modules\@dsh-external\dsh-gpt-image" "D:\你的路径\dsh-gpt-image"
装完重启 DSH。模型侧会出现 _dsh_external_dsh_gpt_image_* 前缀工具。API Key 与各家 baseUrl、模型名见仓库 docs/API_KEYS.md 或 安装说明.html。
典型用法¶
智能体通过工具调用即可复现 README 中的示例（参数为 JSON 风格示意，实际以 DSH 工具 schema 为准）。
文生图并落盘到项目：
generate(prompt="像素风塔防的火焰塔，俯视，游戏素材", project="tower-defense", name="tower_fire",
size="1024x1024", quality="low", n=4)
图生图：
edit(prompt="把背景换成雪山夜景", image="D:\games\art\hero.png", project="rpg", name="hero_night")
异步出图：
generate(prompt="一张海报", project="poster", wait_s=0)
job(task_id="task_abc", action="wait")
像素画（自动补网格约束进提示词）：
generate(prompt="火焰塔图标", name="tower_fire", project="td",
pixel={ width: 32, height: 32, palette: 16 })
导入本地图生成视频：
video(prompt="以 <Picture 1> 的角色为参考，在花田中奔跑，低机位跟拍",
mode="reference", images=["D:\\games\\art\\hero.png"], seconds=5)
声明式素材流水线（节选，改 YAML 不改代码）：
name: 我的素材流水线
on: [manual, new_asset]
steps:
- id: postprocess
use: postprocess
opts: {defringe: true, sharpen: true}
- id: slice
use: slice
- id: validate
use: validate
- id: route
use: route
- id: auto_review
use: auto_review
opts: {min_confidence: 0.85, sample_after_approve: 0.1}
- id: install
use: install
落盘规则（README）：
<输出根>/<项目>/<素材名>_1.png
<输出根>/<项目>/<素材名>.json
<输出根>/<项目>/图片清单.md
适用场景与注意¶
适合谁：需要在 DSH 里让模型稳定调用生图/改图/视频 API，并把产出纳入「项目目录 + 规格 + 审核 + 装机」闭环的开发者；独立游戏或工具链里批量出 UI、图标、精灵表、动画相关素材时，README 中的核对与 quality / assets / install 工具较对口。
使用前请知悉：
- 插件以当前 DSH 进程权限读写本机文件与调用你配置的网络接口；安装前请阅读源码与 MIT 许可证，自行评估 API Key 与花费闸门设置。
- 调用 OpenAI、fal、Agnes 等第三方服务会产生费用或受队列限制；README 对免费档、视频队列 503 等有实测说明，以当时服务商政策为准。
- 部分能力（玩家行为分析、真实 A/B、常驻目录监听、自动推送告警）在单机或无回传场景会降级或需 DSH cron / webhook 配合，勿当成已内置的运维后台。
- 一键安装脚本与商店索引由维护者发布；非 Windows 环境以
dsh plugin add与商店源为主。
结尾¶
经过上面的步骤，你可以在 DSH 里用统一工具面完成从出图、改图、视频到像素画净化与素材装机的长链路，并把 Playground 熟悉的配置档与模板语法延续过来。进一步细节以仓库 README 为准。
