dsh-creative-plugin
DSH 创意模式插件：注册 creative_generate_image 工具，将 DeepSeek Harness 会话连接到任何兼容 OpenAI 的文生图端点（默认：StepFun step-image-edit-2）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:xiaohuo130/dsh-creative-plugin#0bccfd21b3648c8fb889a7a39d3a7a6f7eb3d970Creative Plugin 以 dsh-creative-plugin 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →给 DSH（DeepSeek Harness） 的 AI 会话装上「画图」能力：装好后直接对 AI 说「帮我画一张 XXX」，它就会调用外部文生图接口，把图片存到你电脑上。
An image-generation plugin for DSH. It registers a host tool
creative_generate_imagethat bridges the AI session to any OpenAI-compatible text-to-image endpoint (default: StepFunstep-image-edit-2).
装上本插件后，DSH 里的 AI 助手会多出一个工具 creative_generate_image。你只要用自然语言说：
AI 就会自动组织提示词、调用图像接口、把 PNG 保存到本地，并把保存路径告诉你。你不需要自己写命令。
除 DSH 之外，lib/gen.mjs 也能当成普通命令行脚本独立使用（见下文【命令行用法】），不装 DSH 一样能出图。
dsh plugin --profile web add github:xiaohuo130/dsh-creative-plugin -w
git clone https://github.com/xiaohuo130/dsh-creative-plugin.git
cd dsh-creative-plugin
dsh plugin --profile web add link:<克隆到的绝对路径> -w
安装后重启 DSH（客户端插件补丁在启动时加载），新会话里即可使用 creative_generate_image。
fetch，无任何第三方依赖）插件按下面的顺序找 Key，找到即用：
STEPFUN_API_KEY~/.dsh/.credentials.yaml 里的 STEPFUN_API_KEY# Windows PowerShell（当前窗口临时生效）
$env:STEPFUN_API_KEY = 'sk-xxxx'
# 或写入 ~/.dsh/.credentials.yaml
STEPFUN_API_KEY: sk-xxxx
⚠️ Key 由使用者自备。不要把 Key 提交到仓库，也不要把带 Key 的截图发出去。
creative_generate_image）| 参数 | 必填 | 说明 | 默认值 |
|---|---|---|---|
prompt | ✅ | 图片提示词（英文描述通常效果更好） | — |
out | — | 输出 PNG 的本地路径 | ~/Pictures/dsh-creative/creative-<时间戳>.png |
model | — | 图像模型名 | step-image-edit-2 |
baseUrl | — | 图像服务基础地址（不含 /images/generations） | https://api.stepfun.com/step_plan/v1 |
返回体形如：
{ "ok": true, "message": "Image generated: C:\\Users\\me\\Pictures\\dsh-creative\\creative-2026-10-11T13-20-05.png", "path": "...", "logs": "IMAGE_BYTES: 1234567\nSAVED: ...\nDONE" }
失败时返回 { "ok": false, "message": "...", "error": { "name": ..., "message": ..., "stderr": ... } }，其中 stderr 是 gen.mjs 打印的原始错误（如 API_ERROR 401 {...}）。
# 直接出图（默认走 StepFun Step Plan 套餐端点，保存到指定路径）
node lib/gen.mjs --prompt "a red apple on a wooden table, photo" --out ./out.png
# 从文件读提示词（适合长提示词）
node lib/gen.mjs --prompt-file prompt.txt --out ./out.png
# 换服务：任何 OpenAI 兼容的 /images/generations 都能用
node lib/gen.mjs --prompt "cat in space" --base-url https://api.example.com/v1 --model your-image-model --out ./cat.png
| 参数 | 说明 | 默认值 |
|---|---|---|
--prompt <文本> | 提示词（与 --prompt-file 二选一） | — |
--prompt-file <文件> | 从 UTF-8 文件读取提示词 | — |
--out <路径> | PNG 保存路径；不传则只打印字节数不落盘 | 不保存 |
--model <模型名> | 图像模型名 | step-image-edit-2 |
--base-url <地址> | 服务基础地址（不含 /images/generations） | https://api.stepfun.com/step_plan/v1 |
用户说「画一张 XXX」
↓
DSH 会话 → 工具 creative_generate_image（lib/index.js）
↓ 以子进程方式调用（execFile，参数走数组，不经 shell）
node lib/gen.mjs --prompt ... --out ...
↓ POST <base-url>/images/generations
{ model, prompt, response_format: "b64_json", text_mode: true, cfg_scale: 1.0, steps: 8 }
↓ 取响应 data[0].b64_json
base64 解码 → 写入 PNG 文件
POST /images/generations（OpenAI 兼容），所以任何提供该接口的服务都能接。model / prompt / response_format 外的字段（text_mode / cfg_scale / steps）是 StepFun 的调优参数，其它服务若报「未知参数」，直接编辑 lib/gen.mjs 的请求体即可。b64_json，gen.mjs 会明确报 NO_B64_JSON in response。dsh-creative-plugin/
├── package.json # 插件清单（dsh.bundle / dsh.client / exports）
├── cordis.patch.yml # Cordis 补丁声明（把插件挂进 profile）
├── LICENSE # MIT
├── lib/
│ ├── index.js # 服务端入口：注册 creative_generate_image 工具
│ ├── client.js # Web 客户端入口壳
│ └── gen.mjs # ★ 生图核心：调接口 + 落盘，零依赖，可独立当 CLI
└── README.md
Q：DSH 里调用工具报 STEPFUN_API_KEY not found？
Key 没配到。检查环境变量是否在启动 DSH 的那个进程里生效（Windows 下在旧窗口设的变量不会传给已启动的 DSH），或改用 ~/.dsh/.credentials.yaml。
Q：报 API_ERROR 401 / 403？
Key 无效或没有该模型的权限。
Q：报 NO_B64_JSON in response？
该服务/套餐不返回 base64。换支持 response_format: "b64_json" 的模型或服务。
Q：图片存到哪了？
默认 ~/Pictures/dsh-creative/creative-<时间戳>.png；调用时传 out 可指定任意路径。工具返回的 path 字段就是实际保存位置。
Q：能用来做图生图 / 指定参考图吗？
本插件走的是 POST /images/generations（纯文生图）。图生图需要走 POST /images/edits（multipart 上传参考图）——注意 generations 接口即使传了 image 字段也会被静默忽略，别在这条路上试。
lib/index.js 真正注册宿主工具 creative_generate_image（0.1.0 的入口只是空壳，装上也用不了）gen.mjs 路径改为按模块相对位置解析，不再写死 ~/.dsh/plugins/...~/Pictures/dsh-creative/execFileSync(process.execPath, argv)，去掉拼 shell 字符串package.json：移除已被官方删除的 @deepseek-ai/dsh-client-runtime 依赖、补 license / repository / keywords / filesgen.mjs 命令行生图可用）MIT © xiaohuo130