v0.4.1 — 适配 DeepSeek Harness 0.2.1

0.4.1 — 2026-10-17

变更

• 适配 DeepSeek Harness 0.2.1：peerDependencies 中 @deepseek-ai/dsh-client-ui-plugin-manager 追加 ^0.2.1-rc.1，@deepseek-ai/dsh-tools 追加 ^0.2.1-rc.1。此前宿主升级到 0.2.1-rc.1 后，插件的 peer 范围不覆盖该版本，会被 DSH 的插件兼容性门禁整体跳过，image2_generate 不会注册。
• 新增英文说明文档 README.en.md，README 顶部加语言切换链接。

说明

• 插件代码未改动，仅版本与 peer 范围调整；0.2.0-rc.2 及更早版本仍然兼容。

v0.4.0 — 图生图（参考图引导）

0.4.0 — 图生图

新增

• 图生图（参考图引导生成）：image2_generate 新增 image 参数，传本地参考图路径即改走 POST /images/edits（multipart/form-data 上传）；不传仍是文生图 POST /images/generations。
• 新增 aspectRatio 参数（以 aspect_ratio 字段发出），给只认宽高比、忽略 size 的中转站用。
• 新增 responseFormat 配置项（默认 b64_json）：设 url 让插件下载中转站返回的链接，设为空字符串则完全不发该字段。

修复

• 中转站返回自家 CDN 临时链接且本机连不上该域名时，可用 responseFormat: b64_json 让图片字节内联回传。

测试

• test/smoke.js 扩到 13 项，新增 multipart 上传、魔术字节校验、responseFormat 两条通道三个用例。

完整变更：CHANGELOG.md

v0.3.0 — 内联预览 + 发布素材

亮点

• 内联媒体预览：安装时一并安装 @wisdoverse/dsh-inline-media-viewer 1.0.12，生成的图片直接渲染在对话回复下方，不再需要点开交付卡片。
• 图形化配置行（侧边栏 Plugins 页）+ cordis.patch.yml 双通道配置，apiKey 为遮蔽密钥字段。
• 生成后用原生 read_image 复核真实文件，不把「接口成功」当成「视觉合格」。
• autoGenerateAssets 默认关闭，普通开发任务不会悄悄消耗生图额度；输出限制在会话目录内。

安装

# 官方通用方式（推荐）
dsh plugin --profile <profile> add dsh-image2-tool

# 或用本页附件
dsh plugin --profile <profile> add ./dsh-image2-tool-0.3.0.tgz

装完重启 DSH，工具表里出现 image2_generate。详细配置见仓库 README。

附件校验

SHA256SUMS.txt 内为各附件的 SHA-256；本版 dsh-image2-tool-0.3.0.tgz 为 d4a0d0e5875f6722e0a11c1b997dd6567048cc875e844e7163f20133080f5f82。

变更

见 CHANGELOG.md。