dddzzz123-dz/dsh-read-image-plugin

DSH Read Image 插件

English README

为 DeepSeek Harness（DSH）提供按模型能力自动分流的图片输入：

- 当前模型声明支持 image：隐藏本插件按钮，使用 DSH 原生附件。
- 当前模型是纯文本模型：显示备用图片按钮，通过 read_image_via_ark 把图片交给已配置的火山方舟视觉模型，再把文字结果返回当前模型。

因此，DeepSeek Vision Exp、方舟多模态模型以及未来新增的原生视觉模型会直接接收图片；纯文本模型继续使用方舟代理。

功能

- 在对话输入区增加图片按钮，并支持粘贴图片。
- 图片上传到 DSH 主机后，以本地路径交给工具。
- 复用 DSH 的 volcengine provider、凭据、模型和 API 协议。
- 支持 OpenAI Responses 和 Chat Completions 兼容接口。
- 单张图片上限为 20 MB。
- 根据模型的 inputModalities 自动隐藏或显示代理按钮。

安装

插件包含 host 模块和 Web 客户端包：

dsh-read-image-plugin/
host.mjs
pkg/

1. 将 pkg 安装或链接到 Web profile 的 node_modules/@local/dsh-read-image。
2. 在 Web profile 的客户端配置中启用 @local/dsh-read-image/client。
3. 在 cordis.patch.yml 中加载 host 模块：

- insert:
- id: read-image
name: 'file:///absolute/path/to/dsh-read-image-plugin/host.mjs'

4. 重启 DSH Web UI。

DSH 的 profile 目录和配置格式可能随版本变化。请优先遵循当前版本的插件加载方式，并把上面的绝对路径替换为本机实际路径。

配置

在 DSH 模型设置中配置 volcengine provider。插件优先读取：

- provider 的 baseURL
- provider 的 api
- provider 的第一个模型 ID
- provider 的 apiKeyEnv 对应凭据

可选环境变量：

ARK_API_KEY
ARK_BASE_URL
ARK_VISION_MODEL
DSH_UPLOAD_DIR

建议通过 DSH 凭据设置保存 API Key，不要把密钥写入代码、YAML 或提交到 Git。

使用

- 原生支持图片的模型：使用 DSH 自带的附件按钮。
- 纯文本模型：点击本插件的图片按钮或粘贴图片，然后发送自动生成的 read_image_via_ark 指令。
- 模型也可以直接调用 read_image_via_ark，参数 image 支持本地绝对路径或 HTTP(S) URL。

限制

- 本插件不是视觉模型，只负责把图片转交给方舟视觉模型。
- 需要能够访问火山方舟 API，并可能产生模型调用费用。
- 本地路径必须能被运行 DSH host 的机器读取。
- 客户端集成依赖 DSH Web UI 的插槽与模型目录 API，DSH 大版本升级后可能需要适配。
- 当前主要在 Windows 上验证；Linux/macOS 理论上可用，但安装路径和 profile 配置需要自行调整。

隐私

图片会上传到本机 DSH host，并在调用工具时发送到已配置的火山方舟服务。请根据图片敏感程度和服务条款决定是否使用。

License

MIT