dsh-image-tools 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-image-tools 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-image-tools 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-image-tools 还在维护吗？

GitHub 1 星。最近一次上游提交在 2026/8/17。

多服务图片生成 JuneLearn/dsh-image-tools

DeepSeek Harness

JuneLearn78 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

调用多家图像服务生成与编辑图片，故障自动切换

27.7/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/9/16 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add JuneLearn/dsh-image-tools

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么

dsh 原生插件 · vision

装得上吗

本站已真实安装成功

非静态推断

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 78 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件写入剪贴板(不计风险)发起外部网络请求

查看扫描证据（共 9 处，展示前 9 条）

发起网络请求
lib/client.js:150
const response = await fetch(path, body === undefined ? undefined : {
写入剪贴板
lib/client.js:467
h('button', { type: 'button', className: 'dsh-it-link', onClick: () => void navigator.clipboard.writeText(asset.assetId) }, '复制引用'),
读取本地文件
lib/assets.js:93
if (existsSync(candidate)) return candidate
读取本地文件
lib/assets.js:107
try { stat = statSync(path) } catch { throw new ImageToolsError('reference_not_found', `参考图不存在或不可读：${text}`) }
读取本地文件
lib/assets.js:111
const data = readFileSync(path)
写入本地文件
lib/assets.js:146
mkdirSync(root, { recursive: true })
读取本地文件
lib/assets.js:150
while (existsSync(resolve(root, `${stem}${info.extension}`)) || existsSync(resolve(root, `${stem}.json`))) {
写入本地文件
lib/assets.js:156
writeFileSync(imagePath, data, { flag: 'wx' })
写入本地文件
lib/assets.js:168
writeFileSync(metadataPath, `${JSON.stringify(record, null, 2)}\n`, { encoding: 'utf8', flag: 'wx' })

扫描于 2026/11/3（0 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/dsh-attachment@deepseek-ai/dsh-credentials@deepseek-ai/dsh-settings@deepseek-ai/dsh-tools

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

调用多家图像服务
生成与编辑图片
故障自动转移

DeepSeek Harness 多服务商图片生成与编辑插件，支持 OpenAI Images、Gemini Interactions 和顺序故障转移。

README

由 DeepSeek 最新模型翻译生成

DSH Image Tools 为 DeepSeek Harness 提供统一的多服务图片生成与编辑能力，通过中性的 image-generate 和 image-edit 工具连接 OpenAI Images 兼容服务与 Google Gemini Interactions API。 DSH Image Tools 生成的蓝色鲸鱼女仆示例由插件调用 image-generate 生成，展示 16:9 图片输出效果。第三方服务推荐（含邀请链接）如果你正在寻找支持 OpenAI 兼容接口的 API 中转服务，可以了解一下 WPIronman API 中转站。这是我的邀请链接；通过该链接注册可能会为我带来邀请奖励，具体活动规则和优惠以服务商页面为准。本插件与该服务相互独立，不要求使用任何指定中转站，请根据价格、稳定性和隐私政策自行选择。新用户可使用兑换码 99F509ABC6C38F77 兑换赠送额度。

展开完整文档（README 剩余 1 节）

DSH Image Tools

为 DeepSeek Harness 提供统一的多服务图片生成与编辑能力，通过中性的 image-generate 和 image-edit 工具连接 OpenAI Images 兼容服务与 Google Gemini Interactions API。

DSH Image Tools 生成的蓝色鲸鱼女仆示例

由插件调用 image-generate 生成，展示 16:9 图片输出效果。

第三方服务推荐（含邀请链接）

如果你正在寻找支持 OpenAI 兼容接口的 API 中转服务，可以了解一下 WPIronman API 中转站。这是我的邀请链接；通过该链接注册可能会为我带来邀请奖励，具体活动规则和优惠以服务商页面为准。本插件与该服务相互独立，不要求使用任何指定中转站，请根据价格、稳定性和隐私政策自行选择。

新用户可使用兑换码 99F509ABC6C38F77 兑换赠送额度。

目录

- 第三方服务推荐（含邀请链接）
- 安装
- 使用
- 功能
- 支持的协议
- 从 dsh-image2-draw 迁移
- 资产与元数据
- 失败与计费安全
- 贡献
- 测试
- 兼容性
- 支持
- 致谢
- 许可证

安装

环境要求

- Node.js 20 或更高版本，建议 Node.js 24 LTS；
- Git；
- pnpm；
- DeepSeek Harness 0.1.0-rc.6。

从源码克隆并运行

下面是从 git clone 到可运行的最短路径，不要求已有 Harness 源码仓库：

git clone https://github.com/JuneLearn/dsh-image-tools.git
cd dsh-image-tools
npm install
npm test
npx --yes -p @deepseek-ai/dsh dsh plugin --profile web add .
npx --yes -p @deepseek-ai/dsh dsh web

Web 默认监听 http://127.0.0.1:3080。

直接从 GitHub 安装

不需要本地克隆时：

corepack enable
npx --yes -p @deepseek-ai/dsh dsh plugin --profile web add github:JuneLearn/dsh-image-tools
npx --yes -p @deepseek-ai/dsh dsh web

使用 Harness 源码仓库时，可在 D:\deepseek-harness 中运行：

pnpm install
pnpm dsh plugin --profile web add github:JuneLearn/dsh-image-tools
pnpm dsh web

包内的 dsh.bundle 声明会自动挂载 Host 和 Web 客户端，不需要手工编辑 profile patch。

使用

1. 配置图片服务

1. 打开“设置 > 插件 > 插件配置 > 图片工具”。
2. 点击“添加服务”，在独立编辑页选择 OpenAI 官方、OpenAI 兼容或 Google Gemini。
3. 填写服务名称、接口地址、API Key 和模型名并保存。
4. 可选：点击“测试连接”验证已保存的 URL、Key 和模型；测试不会触发图片生成。

API Key 通过 DSH credentials 保存，普通设置状态不会返回密钥。多个服务按列表从上到下排列；未显式指定服务时，第一项拥有最高优先级。

DSH Image Tools 有序服务配置界面

2. 生成图片

配置完成后，不需要写工具名、模型名或参数，直接在聊天中说你想要什么：

帮我生成一个蓝色鲸鱼女仆萌系图片

DSH 会自动调用 image-generate，并按设置中的服务顺序寻找可用服务。想控制数量、比例或画质时，也可以继续用自然语言描述，例如：

帮我生成两张 16:9 的未来城市电影概念图，画质高一点。

查看可用工具参数

- prompt：必填提示词；
- profile：可选服务 ID；省略时按配置顺序尝试，指定时只调用该服务；
- count：1~8，默认 1；
- size：auto、square、portrait、landscape、OpenAI WIDTHxHEIGHT，或 Gemini 分辨率档位；
- aspect_ratio：auto 或模型支持的 W:H；
- resolution：Gemini 的 auto、0.5K、1K、2K、4K；
- quality、output_format、compression、background：仅在模型能力支持时可用。

指定画面比例时优先只传 aspect_ratio。为兼容模型偶尔生成的冗余参数，同方向组合（如 portrait + 3:4）会采用更具体的 aspect_ratio；方向相反时仍会拒绝。

3. 编辑图片

生成后可以在同一段对话里直接接着修改：

把刚才那张图的背景改成海底城堡，角色保持不变。

DSH 会自动引用上一张结果并调用 image-edit。也可以上传当前会话工作目录中的本地图片作为参考图。

查看图片编辑参数

- refs：必填数组；接受当前会话工作目录内的相对路径或 asset:image-；
- mask：可选；必须是与第一张参考图同尺寸且带 alpha 通道的 PNG，并且模型支持蒙版。

不接受远程 URL 参考图，也不允许路径越出当前会话工作目录。

4. 管理服务顺序

设置列表只显示每个服务的名称、类型、模型、API Key 状态和行操作。使用上移、下移按钮调整故障转移顺序；添加或编辑时会进入独立详情页。OpenAI 兼容中转不支持模型列表时，连接测试会显示“服务可达，但无法验证模型”。

功能

- 管理多个有序图片服务，每个服务使用独立 API Key 和一个模型名；
- 提供 OpenAI 官方、OpenAI 兼容和 Google Gemini 三种配置预设；
- 支持文生图、图生图、多参考图、蒙版和最多 8 张的顺序批量生成；
- 支持尺寸、宽高比、分辨率、质量、格式、压缩和背景参数，实际能力由协议和模型决定；
- 在聊天中预览结果，并将图片保存到会话工作目录的 outputs/images/；
- 为每张图片生成稳定的 asset:image- 引用和脱敏 JSON 元数据；
- 对连接类错误按服务顺序故障转移，不自动重试可能已经计费的请求。

支持的协议

| 协议 | 鉴权 | 生成 | 编辑 | 主要输出控制 |
| OpenAI Images | Authorization: Bearer | /images/generations | /images/edits | 尺寸、质量、格式、压缩、背景、蒙版 |
| Gemini Interactions | x-goog-api-key | /v1beta/interactions | 同一端点携带参考图 | 宽高比、分辨率、格式 |

OpenAI 兼容服务的实际模型和参数支持取决于服务商实现。插件会在请求前校验参数，不会静默忽略不支持的选项。Gemini 请求固定使用 store=false，不依赖供应商会话状态。

从 dsh-image2-draw 迁移

这是一个新包和新设置命名空间，不读取旧插件的配置、工具结果或结果卡。先卸载旧包，再安装新包：

npx --yes -p @deepseek-ai/dsh dsh plugin --profile web remove dsh-image2-draw
npx --yes -p @deepseek-ai/dsh dsh plugin --profile web add github:JuneLearn/dsh-image-tools

旧 API Key 不会自动复制。安装后请在“设置 > 插件 > 插件配置 > 图片工具”中重新建立服务。

资产与元数据

每张输出图片都带有同名 JSON sidecar：

outputs/images/image-YYYYMMDD-HHMMSS-xxxxxxxx.png
outputs/images/image-YYYYMMDD-HHMMSS-xxxxxxxx.json

asset:image-YYYYMMDD-HHMMSS-xxxxxxxx 可跨进程重新解析。文件使用随机后缀和独占写入，不会覆盖已有结果。JSON 记录提示词、档案 ID、协议、模型、参数、时间、耗时、图片尺寸、 asset ID，以及可用的 revised prompt、request ID 和非敏感 usage；不会记录 API Key、完整响应正文或请求头。

失败与计费安全

- 批量请求按顺序逐张执行，单次上游请求固定只取一张图片；
- 未指定 profile 时，首张图片因网络、超时、429、5xx、鉴权或缺少 Key 失败，会尝试下一个服务；单个服务内部不重试；
- 参数错误、能力不匹配、无效参考图或蒙版、内容审核和取消不会触发服务切换；
- 某个服务已经生成至少一张图片后，后续失败会返回部分结果，不再切换服务；
- 显式指定 profile 时只调用该服务；
- 超时和其他可能已经计费的错误不会自动重试。

贡献

欢迎通过 issue 报告可复现的问题或提出功能建议，也欢迎提交范围清晰的 pull request。
提交前请运行下方测试，并避免在测试、日志或示例配置中提交真实 API Key。

测试

npm install
npm test
npm pack --dry-run

自动化测试使用模拟 HTTP 响应，不调用真实图片 API。真实 API 冒烟测试应由开发者使用专用凭据和低成本提示词显式执行。

兼容性

当前目标为 DeepSeek Harness 0.1.0-rc.6 的公开双端插件、settings、credentials、 attachments、tools、client slots 和 WebServer 接口。Harness 仍处于 Developer Preview；升级后若插件无法加载，应先核对这些接口与 dsh.client.inject 声明。

支持

请在 GitHub Issues 提交问题。报告中请包含 Harness 与 Node.js 版本、所选协议、脱敏后的错误代码和复现步骤，不要公开 API Key。

致谢

聊天内附件和专用结果卡的部分实现思路源自 MIT 许可的 dsh-multimodal，详见 THIRD_PARTY_NOTICES.md。

许可证

本项目采用 MIT License，与仓库中的 LICENSE 文件一致。