前言¶
DSH 的插件化思路允许在宿主层补充交互能力。对 DeepSeek Harness 的纯文本模型部署来说,一个常见限制是:用户希望上传图片并让模型理解内容,但模型本身只处理文本。
dsh-dseyes 解决这个问题:让图片以附件形式进入 Web GUI 会话,并在发送给 DeepSeek 前由 host 端调用智谱 GLM 免费视觉模型生成图片描述,再把描述交给文本模型。
这是什么¶
dsh-dseyes 是一个 DSH 插件,由 Okkay712 维护,许可证为 MIT。
它的基本流程是:
- 用户在 Web GUI 聊天框粘贴或拖入图片。
- 图片作为缩略图附件显示,聊天历史中保留原图。
- host 端在调用 DeepSeek 前自动调用智谱 GLM 视觉模型识别图片。
- 图片内容块被替换为文字描述,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_KEY 与 GLM_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