siegfly/dsh-deepseek-vision 预览 preview

siegfly/dsh-deepseek-vision

DeepSeek Harness 的视觉语言网关插件 - 粘贴图片,DeepSeek 即可识别文字

Project Overview项目介绍

This is a native visual language gateway plugin built exclusively for DeepSeek Harness (DSH). It adds image processing support for pure-text DeepSeek coding models running inside DSH, and can be installed directly via DSH’s official plugin CLI command. It supports installation from multiple sources including npm, git, local directories and tarballs, and works with both DSH’s web and headless profiles out of the box. It adds a new dedicated provider route that handles incoming images: images are passed directly to natively supported visual models, while pure-text models get converted image descriptions from a user-configured VL endpoint.

After installation, you just need to restart DSH, then select the new "DeepSeek + Vision" provider from the model picker menu. Next, you enter your VL endpoint URL and API key in the plugin settings page, and can then paste or drag images directly into the chat window to process them. The plugin caches image descriptions in an in-process LRU cache to avoid duplicate processing and duplicate billing, and retains original images in session logs for history replay and session reconstruction. It is targeted at DSH users who need to process images with pure-text DeepSeek models.

This plugin is released under the open-source MIT license, so it is free to use, modify and distribute. It does not require any extra local dependencies like Python, local large language models, or third-party proxy services, and all image processing only goes through the VL endpoint that you configure yourself. It does not lock to a specific official DSH version, runs compatibility checks before installation to give clear error messages instead of silent failures, and any access issues with old image sessions after uninstall can be fixed by simply reinstalling the plugin.

这是一个专为 DeepSeek Harness (DSH) 开发的原生视觉语言网关插件,用于给纯文本 DeepSeek 编程模型添加图片处理能力。它通过 DSH 官方插件 CLI 命令安装,同时支持 web 和 headless 两种 profile,通过新增的专用 provider 路由图片:原生支持图片的模型可以直接接收图片,纯文本模型则会先经可配置的 VL 模型把图片转成文字描述再转发。

安装完成后,重启 DSH 即可在模型选择页看到新增的「DeepSeek + Vision」选项,用户填入自己配置的 VL 模型端点和密钥后,就可以直接在聊天窗口粘贴或拖入图片使用。它采用进程内 LRU 缓存复用同一张图片的描述,避免重复计费,同时会保留原始图片到会话日志,不影响历史回放和重构,适合需要让纯文本 DeepSeek 模型处理图片的 DSH 用户。

该插件采用 MIT 许可开源,免费使用,不需要依赖 Python、本地大模型或第三方中转服务,所有图片只经过用户自己配置的 VL 端点处理。它不锁定官方 DSH 版本,安装前会做兼容性检查,明确给出错误提示不会静默失败。卸载后原含图历史会话无法选择文本模型属于预期行为,重装插件后即可恢复。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 9 stars - very few users, little community feedback星标只有 9,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-deepseek-vision@0.1.7

把 siegfly/dsh-deepseek-vision 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-deepseek-vision

安装: dsh plugin --profile web add dsh-deepseek-vision

dsh-deepseek-vision 是给 DeepSeek Harness 的视觉语言网关插件。 纯文本的 DeepSeek 编程模型 通过一个"网关"provider 路由获得贴图能力:默认 native-first,目录声明支持 image 的模型 图片直通原生视觉端点;其余模型先由可配置的视觉模型 (默认 Qwen-VL)逐字描述成文字,再交给 DeepSeek 继续写代码。官方仓库零改动、跨机器 安装不锁官方版本。同类方案里它是最薄的桥:不注入 agent 工具、不经过第三方中转、 不依赖本地模型。

English | 中文

目录

亮点

  • 贴图即用,不用换模型: 注册独立路由 deepseek-vision(显示名 DeepSeek + Vision), 真实声明 inputModalities: ['text','image']——聊天窗贴图、tool-fs read_image、浏览器 截图、MCP 工具返回的图片、ACP 客户端内联图片全部放行。
  • 同代图片只描述一次: 按“完整 VL 配置代际 + attachmentId”进程内 LRU 缓存,重试、上下文压缩、后续轮次 复用同一份描述,不重复计费。
  • 会话不变量保持: 原始图片仍持久化进 session log,历史 / 回放 / 重构不受影响。
  • 官方机制安装: bundle 声明 + dsh plugin add,四种 spec(npm / git / 目录 / tarball)、 web 与 headless 双 profile,与官方插件完全同一路径。
  • 换 VL 模型零改码: 端点 / 模型 / 提示词 / 密钥全在设置卡片,兼容任意 OpenAI 风格 /chat/completions 网关(DashScope、vLLM、OpenRouter、LM Studio…)。
  • 失败语义明确: 默认 fail-closed,稳定错误码(AUTH / TIMEOUT / TRANSPORT / IMAGE_TOO_LARGE…),或 placeholder 降级为文字占位继续。
  • 跨版本不锁死: 发布版不锁定官方 dsh 版本。无 CLI 复刻路径(pnpm install-profile)在目标机用自己的 dsh 重建,构建成功即兼容证明,装前分级 提示、绝不静默失败;官方 CLI 路径(dsh plugin add)直接安装发布产物,不在 目标机重建——运行时依赖经 healed fallback 解析,但兼容性未经目标机验证 (见版本对齐)。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-evolve 下一个 Next deepseek-harness-desktop-Install →