dsh-tool-image-gen

dsh-tool-image-gen

一个 DeepSeek Harness 图像生成工具插件：对接 ToAPIs 异步图像 API（GPT-Image-2 等），提供两个模型可调用工具：

• image_gen：文生图 / 图生图。提交任务 → 轮询 → 下载到工作区 generated/，返回本地路径 + 公开 URL。
• image_upload：把本地图片上传到 ToAPIs，换取公开 URL（可作 image_gen 的参考图）。

特性

• 异步任务管理：POST /v1/images/generations 建任务，轮询 GET /v1/images/generations/{id} 取结果。
• 本地参考图自动上传：image_gen 的 referenceImages 直接接受本地文件路径（自动走上传接口换 URL），也接受公开 URL。
• 内联预览：结果注册进 DSH 附件系统（超 5MB 自动用 sips 压缩 JPEG），并在文本里附带 Markdown 图片链接。
• 凭据：key 从环境变量或 ~/.dsh/.credentials.yaml 读取（TOAPIS_API_KEY），永不进对话。
• 尺寸 1:1/3:2/2:3/4:3/3:4/5:4/4:5/16:9/9:16/2:1/1:2/21:9/9:21，分辨率 1k/2k/4k，n 张数。

安装

# 1. 装进 profile
cd ~/.dsh/profiles
npm install dsh-tool-image-gen
# 或者本地开发：npm link dsh-tool-image-gen

# 2. 接线（cordis.patch.yml，本包自带 bundle manifest，dsh plugin add 可自动接线）
# - insert:
#     - id: image-gen
#       name: 'dsh-tool-image-gen'

# 3. 配 key：~/.dsh/.credentials.yaml 里加
# TOAPIS_API_KEY: 你的key
# chmod 600 ~/.dsh/.credentials.yaml

# 4. 重启 dsh

配置

字段	默认	说明
apiKeyEnv	TOAPIS_API_KEY	凭据引用名
baseURL	https://toapis.com/v1	API 基址
model	gpt-image-2	模型 id（也可用 gpt-image-2-vip、gemini 系列等）
size	1:1	默认比例
resolution	1k	默认分辨率
pollIntervalMs / maxAttempts	3000 / 60	轮询策略
timeoutMs	600000	协作超时
outputDir	<cwd>/generated	图片落盘目录

用法

// 文生图
{ "prompt": "赛博朋克城市夜景海报", "size": "16:9", "resolution": "2k" }

// 图生图（本地路径自动上传）
{ "prompt": "把这张图改成水彩画风格", "referenceImages": ["/path/to/photo.png"] }

// 上传换 URL
{ "filePath": "/path/to/photo.png" }

注意

• ToAPIs 为第三方 API 平台（按量计费），获取 key：https://toapis.com/console/token
• 上传上限 10MB，支持 jpg/png/webp/gif