Skip to content

Terry12138qy/dsh-vision

30Last commit Aug 14, 2026

dsh-vision DSH plugin

dsh-vision is a bundle plugin for DeepSeek Harness that enables models without native vision capabilities to understand images. It accepts local file paths or network URLs, sends them to a primary multi-modal model (DashScope qwen3.5-omni-plus) with automatic fallback to a backup model (Zhipu glm-4.6v-flash) on failure. The tool is registered as `vision` and can be called in Code Mode.

How to install the dsh-vision DSH plugin

dsh plugin --profile web add github:Terry12138qy/dsh-vision

Copying does not run this command. Review the repository and version before installing the dsh-vision DSH plugin.

dsh-vision DSH plugin data source

dsh-vision DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-vision DSH plugin can do

  • Accepts both local image file paths and network URLs as input.
  • Automatically switches to a backup model when the primary model fails (quota exhausted, overdue, or rate-limited).
  • Integrates seamlessly with DeepSeek Harness Code Mode via `await tools.vision(...)`.
  • Supports cancellation via `exec.signal` as required by DSH tool contract.

Where the dsh-vision DSH plugin fits

  • Let a non-vision DSH model describe the contents of an image in Chinese.
  • Analyze screenshots or photos uploaded to the DSH chat interface.
  • Extract textual information from images (e.g., signs, documents) in a DSH workflow.
  • Use as a fallback vision tool when the base model lacks multi-modal support.

Who the dsh-vision DSH plugin is for

  • DeepSeek Harness users who need image understanding capabilities.
  • Developers building DSH plugins who want to integrate vision functionality.

dsh-vision DSH plugin limitations

  • Relies on external API services (DashScope and Zhipu) – requires valid API keys.
  • Only supports Chinese language output for image descriptions.
  • Fallback model may introduce additional latency on failure.
  • The plugin is in early development; no specific image format restrictions are documented.

dsh-vision DSH plugin: from the repository README

Quoted from the Terry12138qy/dsh-vision README, the upstream source of the dsh-vision DSH plugin. Copyright remains with the original authors.

> 给不具备原生识图能力的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 模型装上「眼睛」。 把图片(本地路径或网络 URL)发送给多模态大模型,返回中文文字描述。主模型为阿里云百炼(DashScope)`qwen3.5-omni-plus`,调用失败(额度用尽 / 欠费 / 限流)时自动切换智谱 `glm-4.6v-flash` 备用模型。 ## 原始来源与适配说明 - **原始项目**:[asuojun/claude-vision-skill](https://github.com/asuojun/claude-vision-skill) —— 面向 Claude Code 的识图 skill,核心是 `vision.js`(读图 → base64 → 调 OpenAI 兼容接口 → 返回文字描述,主模型失败自动切备用模型)。 - **本项目**:专门为 **DeepSeek Harness** 做了适配,把原来的 Claude skill 重写为 DSH 的 **bundle 插件**,注册一个 `vision` 工具。识图主流程(读图 → base64 → 调 API → 返回文字、主/备模型自动切换)**原样保留**。 相较原版的主要改动: - 打包成 DSH bundle(`dsh.bundle.patch`),可通过 `dsh plugin` 安装; - 注册为 DSH 的 `vision` 工具(Code Mode 里 `await tools.vision(...)` 可直接调用); - CJS → ESM;配置改为「环境变量 > cordis.patch.yml config > 默认值」(原 `.env` 语义不变); - 增加 `exec.signal` 取消支持(DSH 工具契约要求)。 ## 安装 ```sh dsh plugin --profile web add github:Terry12138qy/dsh-vision ``` 或本地路径: ```sh dsh plugin --profile web add file:/绝对/路径/dsh-vision ``` 安装后**重启** `dsh web` 生效。发布到 GitHub 后,记得给仓库添加 [`dsh-plugin`](https://github.com/topics/dsh-plugin) 主题,方便被 DeepSeek Harness 生态发现。 ## 配置 密钥通过**环境变量**(推荐,避免密钥进仓库)或编辑 `cordis.patch.yml` 的 `config`: | 用途 | 环境变量 | config 字段 | | ---- |

Read the full READMERepository license: MIT

dsh-vision DSH plugin questions

How do I install dsh-vision?

Run `dsh plugin --profile web add github:Terry12138qy/dsh-vision` and restart `dsh web`. You can also use a local path: `dsh plugin --profile web add file:/absolute/path/dsh-vision`.

What API keys do I need to configure?

You need at least a DashScope API key for the primary model (set `DASHSCOPE_API_KEY` environment variable). Optionally, set a fallback API key for Zhipu (`FALLBACK_API_KEY`) to enable automatic failover. All configuration variables are listed in the README.

Can I use a different model as the primary vision model?

Yes. You can set the `VISION_MODEL` environment variable or `model` config field to any model supported by DashScope’s OpenAI-compatible endpoint. The default is `qwen3.5-omni-plus`.

What happens if the primary model fails?

The plugin automatically switches to the backup model (default: Zhipu glm-4.6v-flash) and retries the request. You need to configure `FALLBACK_API_KEY` and related variables for the fallback to work.

Does the plugin support image URLs from the internet?

Yes, you can pass a network URL directly. The plugin fetches the image, converts it to base64, and sends it to the API. Local file paths are also supported.