DeepSeek Harness 插件

ximengxiaolan/dsh-vision-bridge

Star 数 ★ 1 分类 工具与能力 收录于 2026-08-14

输入框贴图自动识别:由 OpenAI 兼容视觉模型转成文字描述后,再交给纯文本 DeepSeek 模型处理。

安装

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:ximengxiaolan/dsh-vision-bridge

GitHub 来源的插件在安装时会在你的机器上执行构建脚本。请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

让纯文本模型(DeepSeek V4 / V4-Flash)在对话里"看见"图片:在输入框直接粘贴图片并发送,插件自动调用一个 OpenAI 兼容的视觉模型(VLM)把图片识别成文字描述,再把描述喂给 DeepSeek 继续处理。

会话中图片照常显示;只有发给模型的内容变成文字。

原理

DSH 对纯文本模型会在提交时拒绝图片(MODEL_DOES_NOT_SUPPORT_IMAGES)。本插件打通两个官方扩展点:

  1. 准入放行:给 ctx.llm.resolveModelInfo 打补丁,声明当前模型支持 image 输入,让图片附件能进入会话。
  2. 发模型前转换:包装 llm.streamWithRegistration,每次请求发往模型前扫描所有消息中的图片块,调用配置的 VLM 生成文字描述,替换成:
[用户附上的图片已由视觉模型自动识别(qwen-vl-max)]
<描述内容>

如果路由到的模型原生支持图片,则放行原图、不做转换。

安装

# 前置:dsh CLI 与 pnpm
dsh plugin --profile web add dsh-vision-bridge
# 或从 git 安装:
dsh plugin --profile web add https://github.com/<your-name>/dsh-vision-bridge

安装后重启 profile(dsh web)。

配置

唯一需要的是一个 OpenAI 兼容多模态模型/chat/completions + image_url),例如阿里云百炼 qwen-vl-max、智谱 GLM-4V 等。

环境变量:

$env:VISION_API_KEY  = "sk-..."
$env:VISION_BASE_URL = "https://dashscope.aliyuncs.com/compatible-mode/v1"
$env:VISION_MODEL    = "qwen-vl-max"
$env:VISION_LANG     = "zh"   # zh | en

或在 profile 的 cordis.patch.yml 中配置(优先于环境变量):

- id: dsh-vision-bridge
  config:
    apiKey: 'sk-...'
    baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1'
    model: 'qwen-vl-max'
    lang: zh
    timeoutMs: 180000
    enabled: true

使用

重启后直接在输入框粘贴图片并发送即可。DeepSeek 会基于视觉模型的描述继续处理。

说明

  • 同一张图片(按 attachmentId)在同一进程内缓存描述,重复发送不重复计费。
  • VLM 调用失败时降级为 [图片识别失败: 原因],对话不会中断。
  • 子智能体会话(subagent)仍受 DSH 内核限制,不支持贴图。

License

MIT

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →