dsh-creative-plugin

Name: xiaohuo130/dsh-creative-plugin
Author: xiaohuo130

给 DSH（DeepSeek Harness）的 AI 会话装上「画图」能力：装好后直接对 AI 说「帮我画一张 XXX」，它就会调用外部文生图接口，把图片存到你电脑上。

An image-generation plugin for DSH. It registers a host tool creative_generate_image that bridges the AI session to any OpenAI-compatible text-to-image endpoint (default: StepFun step-image-edit-2).

它能干什么

装上本插件后，DSH 里的 AI 助手会多出一个工具 creative_generate_image。你只要用自然语言说：

「帮我画一张水墨风格的竹子，宣纸背景」
「生成一个像素风游戏角色图标，透明背景」
「画一张北欧极简风的咖啡店招牌插画，16:9」

AI 就会自动组织提示词、调用图像接口、把 PNG 保存到本地，并把保存路径告诉你。你不需要自己写命令。

除 DSH 之外，lib/gen.mjs 也能当成普通命令行脚本独立使用（见下文【命令行用法】），不装 DSH 一样能出图。

安装

方式一：从 GitHub 安装（推荐）

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。

环境要求

Node.js ≥ 18（脚本用内置 fetch，无任何第三方依赖）
DSH ≥ 0.1.2（0.2.x 亦可）
一个图像生成服务的 API Key（自备）

配置 API Key

插件按下面的顺序找 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 {...}）。

命令行用法（不装 DSH 也能用）

# 直接出图（默认走 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 的请求体即可。
若服务返回的是 URL 而不是 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 字段也会被静默忽略，别在这条路上试。

更新日志

0.2.0
- 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 / files
- README 重写：补全工具参数表、命令行用法、返回体与常见问题
0.1.0 首个版本（gen.mjs 命令行生图可用）

License

MIT © xiaohuo130

dsh-creative-plugin

给 DSH（DeepSeek Harness）的 AI 会话装上「画图」能力：装好后直接对 AI 说「帮我画一张 XXX」，它就会调用外部文生图接口，把图片存到你电脑上。

An image-generation plugin for DSH. It registers a host tool creative_generate_image that bridges the AI session to any OpenAI-compatible text-to-image endpoint (default: StepFun step-image-edit-2).

它能干什么

装上本插件后，DSH 里的 AI 助手会多出一个工具 creative_generate_image。你只要用自然语言说：

「帮我画一张水墨风格的竹子，宣纸背景」
「生成一个像素风游戏角色图标，透明背景」
「画一张北欧极简风的咖啡店招牌插画，16:9」

AI 就会自动组织提示词、调用图像接口、把 PNG 保存到本地，并把保存路径告诉你。你不需要自己写命令。

除 DSH 之外，lib/gen.mjs 也能当成普通命令行脚本独立使用（见下文【命令行用法】），不装 DSH 一样能出图。

安装

方式一：从 GitHub 安装（推荐）

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。

环境要求

Node.js ≥ 18（脚本用内置 fetch，无任何第三方依赖）
DSH ≥ 0.1.2（0.2.x 亦可）
一个图像生成服务的 API Key（自备）

配置 API Key

插件按下面的顺序找 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 {...}）。

命令行用法（不装 DSH 也能用）

# 直接出图（默认走 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 的请求体即可。
若服务返回的是 URL 而不是 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：报 API_ERROR 401 / 403？ Key 无效或没有该模型的权限。

Q：报 NO_B64_JSON in response？ 该服务/套餐不返回 base64。换支持 response_format: "b64_json" 的模型或服务。

Q：图片存到哪了？ 默认 ~/Pictures/dsh-creative/creative-<时间戳>.png；调用时传 out 可指定任意路径。工具返回的 path 字段就是实际保存位置。

更新日志

0.2.0
- 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 / files
- README 重写：补全工具参数表、命令行用法、返回体与常见问题
0.1.0 首个版本（gen.mjs 命令行生图可用）

xiaohuo130/dsh-creative-plugin

dsh-creative-plugin

它能干什么

安装

方式一：从 GitHub 安装（推荐）

方式二：克隆后以本地目录安装

环境要求

配置 API Key

工具参数（`creative_generate_image`）

命令行用法（不装 DSH 也能用）

原理

目录结构

常见问题

更新日志

License

Community comments

xiaohuo130/dsh-creative-plugin

dsh-creative-plugin

它能干什么

安装

方式一：从 GitHub 安装（推荐）

方式二：克隆后以本地目录安装

环境要求

配置 API Key

工具参数（`creative_generate_image`）

命令行用法（不装 DSH 也能用）

原理

目录结构

常见问题

更新日志

License

Community comments

xiaohuo130/dsh-creative-plugin

dsh-creative-plugin

它能干什么

安装

方式一：从 GitHub 安装（推荐）

方式二：克隆后以本地目录安装

环境要求

配置 API Key

工具参数（creative_generate_image）

命令行用法（不装 DSH 也能用）

原理

目录结构

常见问题

更新日志

License

Community comments

xiaohuo130/dsh-creative-plugin

dsh-creative-plugin

它能干什么

安装

方式一：从 GitHub 安装（推荐）

方式二：克隆后以本地目录安装

环境要求

配置 API Key

工具参数（creative_generate_image）

命令行用法（不装 DSH 也能用）

原理

目录结构

常见问题

更新日志

License

Community comments

工具参数（`creative_generate_image`）

工具参数（`creative_generate_image`）