前言¶
DeepSeek Harness(DSH)允许开发者构建智能体,但原生只支持文本交互。imgpost 插件解决了这一限制,它让 DSH 能够在对话中发送图片,并能调用视觉接口读懂图片内容。
简介¶
imgpost 是一个客户端插件,由 hige6 维护,开源协议为 MIT。它通过几个工具函数,让 DSH 能够处理本地图片、网页链接、AI 生成的图片,以及对外进行视觉识别。
核心功能¶
- send_image:把本地文件 / 网页 URL / base64 图片发进对话,作为持久附件展示。
- generate_image:调用任意 OpenAI 兼容的
/images/generations接口生图并直接发送。 - imgpost_read_image:用外部视觉 API 读懂图片 —— 文字 OCR、场景、排版等,结果会按图片指纹磁盘缓存。
- imgpost_check_backend:报告生图端点的 baseURL / 模型 / key 是否齐备,缺哪一项说得清清楚楚。
- vision provider wrap:透明通道,自动给不带视觉的文本模型包一层通道,让任何模型都能“看见”图片。
- 设置页管理:在 DSH 设置里直接管理识图后端(主/备)与上游包装名单,保存即生效。
安装¶
使用官方脚本进行安装。
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1
配置与使用¶
- 配置文件:位于
~/.dsh/vision-sender.。 - 默认配置:默认预选 DeepSeek 官方模型。
- 安全注意:apiKey 永不回传浏览器,接口自带门禁(自定义头、同源校验)。
- 依赖:依赖
@deepseek-ai/cordis: ^4.0.1,零第三方依赖。
注意事项¶
- 插件以当前 DSH 进程权限运行,安装前应检查源码与许可证。
- 插件注册的路由在宿主 token 鉴权之外,接口做了三层校验。
结尾¶
更多细节请参考 GitHub 仓库:https://github.com/hige6/imgpost