dsh-dseyes:给 DeepSeek Harness 的纯文本模型提供原生图片上传体验

前言

DSH 的插件化思路允许在宿主层补充交互能力。对 DeepSeek Harness 的纯文本模型部署来说,一个常见限制是:用户希望上传图片并让模型理解内容,但模型本身只处理文本。

dsh-dseyes 解决这个问题:让图片以附件形式进入 Web GUI 会话,并在发送给 DeepSeek 前由 host 端调用智谱 GLM 免费视觉模型生成图片描述,再把描述交给文本模型。

这是什么

dsh-dseyes 是一个 DSH 插件,由 Okkay712 维护,许可证为 MIT

它的基本流程是:

  1. 用户在 Web GUI 聊天框粘贴或拖入图片。
  2. 图片作为缩略图附件显示,聊天历史中保留原图。
  3. host 端在调用 DeepSeek 前自动调用智谱 GLM 视觉模型识别图片。
  4. 图片内容块被替换为文字描述,DeepSeek 基于文字描述回答。

核心功能

图片附件体验

  • 支持在 Web GUI 聊天框粘贴或拖入图片。
  • 图片以缩略图附件显示。
  • 聊天历史中保留原图,并可点击放大。

host 端读图

  • 在发送给 DeepSeek 前,host 端自动调用智谱 GLM 免费视觉模型识别图片内容。
  • 支持自动降级链:
glm-4v-flash → glm-4.6v-flash → glm-4.1v-thinking-flash
  • 同一张图多次出现时,复用读图结果。

文本模型基于描述回答

  • 将图片内容块替换为 GLM 生成的文字描述。
  • DeepSeek 基于该描述回答。
  • 会话中仍保留原图。

Key 配置与自检

  • 支持 GLM_API_KEY / ZHIPU_API_KEY
  • 可经进程环境变量或 secrets 文件配置。
  • Windows 兼容注册表读取。
  • 提供自检接口:
GET /dsh-dseyes/diag
  • 读图失败时降级为说明文字,对话不中断。

安装与启用

前提条件

需要:

Node >= 22

需要智谱 GLM API key。资料称 glm-4v-flash 免费,注册即用。

配置 key

可以使用进程环境变量:

GLM_API_KEY=你的key

也可以写入 secrets 文件:

~/.dsh/secrets/media-tools.env

文件内容:

GLM_API_KEY=你的key

ZHIPU_API_KEYGLM_API_KEY 等价。

安装插件

执行:

dsh plugin --profile web add dsh-dseyes

安装后重启 DSH Web GUI。

典型用法

1、在聊天输入框粘贴(Ctrl+V)或拖入图片。

2、输入问题并发送。

3、查看 DeepSeek 的回答;聊天历史中保留原图,可点击放大。

自检与排障

本机浏览器打开诊断地址:

http://127.0.0.1:<dsh端口>/dsh-dseyes/diag

该接口用于自查 key 与智谱连通性。

若读图失败,对话不会中断,模型消息中会包含说明文字。

适用场景与注意

适合在 DSH Web GUI 中需要让文本模型理解图片内容的场景。

使用前注意:

  • 插件以当前 DSH 进程权限运行;安装前应检查源码与许可证。
  • 许可证为 MIT
  • 需要 Node >= 22
  • 需要智谱 GLM API key;资料称 glm-4v-flash 免费,注册即用。
  • GLM API key 只存本机环境变量/secrets 文件,由 host 端持有。
  • 资料称 key 永不写入本仓库、不进入浏览器。
  • 图片只发送给智谱官方 API 用于识别内容:
open.bigmodel.cn
  • 读图结果只在模型请求中使用,不上传任何第三方。
  • 可选 peerDependencies 包括:
@deepseek-ai/cordis
@deepseek-ai/dsh-host-webserver
@deepseek-ai/dsh-llm
@deepseek-ai/dsh-attachment
  • DSH 的插件生态强调“一切皆插件”;社区目录是独立站点,不代表与 DeepSeek 或幻方有官方从属关系。

链接

GitHub:

https://github.com/Okkay712/DSH-dseyes

目录页线索,未在本机资料中进一步核实:

https://www.skillhub.cn/plugins/Okkay712/DSH-dseyes
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜