插件目录 / Developer / deepseek-vl-support
deepseek-vl-support
未验证 limccn
功能简介
Give DeepSeek (text-only) models **vision** in Claude Code and Codex by routing image files to any OpenAI-compatible vision endpoint (OpenRouter, SiliconFlow, DashScope, Ollama, llama.cpp, vLLM, LM Studio, …). Zero runtime dependencies, MIT licensed.
未验证 — 尚未实测
Give DeepSeek (text-only) models **vision** in Claude Code and Codex by routing image files to any OpenAI-compatible vision endpoint (OpenRouter, SiliconFlow, DashScope, Ollama, llama.cpp, vLLM, LM Studio, …). Zero runtime dependencies, MIT licensed. 尚未验证——请自行安装测试。
「未验证」表示我们的自动化 CI 尚未安装过该插件。功能描述与版本兼容性均为作者声明。这不是安全审计，也不代表对第三方代码的背书。
README
deepseek-vl-support
中文说明 → docs/README.zh-CN.md
What this does
Some AI models (like DeepSeek) can read your files, but they cannot see pictures.
Screenshots of errors, UI mockups, charts — invisible to them.
This small tool gives them "eyes". Once installed, whenever the model tries to read a
picture, the tool sends it to a vision service of your choice (Moonshot, OpenRouter,
SiliconFlow, Ollama …), receives a detailed text description, and hands it to the model —
as if the model could see the picture.
Model reads screenshot.png
→ the tool intercepts the read
→ picture → vision service → detailed text description comes back
→ the model receives: "[Vision of screenshot.png]: <description>"
→ the model answers from the description
No model settings to change, no config files to write — it works automatically after a
one-time setup. One command to install, one command to remove. MIT licensed.
Who this is for
You use a text-only model (such as DeepSeek) in any AI coding agent or IDE and want it
to understand pictures: error screenshots, UI mockups, charts, photos of notes. Pick your
tool in the install wizard below — there is a one-command install
for every supported agent, including Claude Code, Codex, Cursor, GitHub Copilot, VS Code,
OpenCode, Trae, Qwen Code, and 14 more.
Before you start (what you need)
- Node.js 18 or newer — check with
node -v. Not installed? Get it at
https://nodejs.org. - An account at a vision service, plus its API key — a vision service is the "eyes
provider": a website that looks at pictures for you. Cloud options: Moonshot,
OpenRouter, MiniMax, Zhipu GLM, StepFun, OpenCode Zen, SiliconFlow, DashScope. Free
local options (run on your own computer): Ollama, llama.cpp, vLLM, LM Studio. The API
key is a secret code from that service (usually under "API keys"); the installer asks
for it once and stores it only on your computer. - Your AI agent installed — any of the supported ones below.
Quick install wizard
Open a terminal in your project folder and run:
cd path/to/your/project
npx deepseek-vl-support@latest install
That's the whole install — the wizard auto-detects the agents on your machine and asks 7
short questions. Almost every question has a sensible default: just press Enter. The
two that matter: which agents should get vision (pre-selected) and which vision service +
API key to use (choose Decide later, the last option, if you want to sort that out
afterwards).
When it finishes, restart your session — the installer prints this reminder, and it is
required for the effect to kick in. Optional check:
npx deepseek-vl-support@latest doctor # look for [OK]
Re-running on the same project? It asks whether to keep your current settings — Enter
keeps them.
No terminal? Ask your agent to install it. If you use a tool that supports the Agent
Plugins standard (GitHub Copilot, Cursor, Kiro, OpenClaw, Hermes Agent, VS Code, ChatGPT &
Codex, Grok Bot, NanoClaw, and other spec-compliant agents), just say in the conversation:
Install the plugin from https://github.com/limccn/deepseek-vl-support and enable it
After a GitHub install, configure the vision endpoint once withnpx deepseek-vl-support@latest install --target <your agent> (or environment variables —
see Changing settings).
One-command install per agent
Everything below is equivalent to the wizard above — just narrowed to one agent. Pick
yours:
Claude Code
1. Install
npx deepseek-vl-support@latest install --target claude
2. After install — restart your session, then read any picture: the description
arrives automatically (/vision path.png for manual use).
Codex
1. Ask Codex to install it
Install the plugin from https://github.com/limccn/deepseek-vl-support and enable it
2. Or install via npx
npx deepseek-vl-support@latest install --target codex
3. After install — restart Codex, then ask it to describe a picture.
OpenCode
1. Install
npx deepseek-vl-support@latest install --target opencode
2. After install — restart OpenCode.
Trae
1. Install
npx deepseek-vl-support@latest install --target trae
2. After install — import the skill once: Settings → Rules & Skills → Create/Import.
Pi Coding Agent
1. Native install (recommended) — skill + extension in one command
pi install npm:deepseek-vl-support
2. Or install via npx
npx deepseek-vl-support@latest install --target pi
3. After install — restart Pi.
Oh My Pi
1. Native install (recommended)
omp install npm:deepseek-vl-support
2. Or install via npx
npx deepseek-vl-support@latest install --target omp
3. After install — run /reload-plugins (no restart needed).
DeepSeek Harness
1. Native install (recommended) — in-process tools, no subprocess
dsh plugin --profile web add deepseek-vl-support@latest
2. Or install via npx
npx deepseek-vl-support@latest install --target dsh
3. After install — restart the dsh web session.
Qwen Code
1. Install
npx deepseek-vl-support@latest install --target qwen
2. After install — restart Qwen Code.
Reasonix
1. Install
npx deepseek-vl-support@latest install --target reasonix
2. After install — restart Reasonix.
Kilo Code
1. Install
npx deepseek-vl-support@latest install --target kilo
2. After install — restart Kilo Code.
WorkBuddy (CodeBuddy Code)
1. Install
npx deepseek-vl-support@latest install --target workbuddy
2. After install — restart WorkBuddy.
Devin
1. Install
npx deepseek-vl-support@latest install --target devin
2. After install — restart Devin. (Devin's CLI has no official npm package — download
it from https://devin.ai/download.)
GitHub Copilot
1. Ask Copilot to install it
Install the plugin from https://github.com/limccn/deepseek-vl-support and enable it
2. Or install via npx
npx deepseek-vl-support@latest install --target copilot
3. After install — check copilot plugin list.
Cursor
1. Ask Cursor to install it
Install the plugin from https://github.com/limccn/deepseek-vl-support and enable it
2. Or install via npx
npx deepseek-vl-support@latest install --target cursor
3. After install — reload the window (Developer → Reload Window).
Kiro
1. Ask Kiro to install it
Install the plugin from https://github.com/limccn/deepseek-vl-support and enable it
2. Or install via npx
npx deepseek-vl-support@latest install --target kiro
3. After install — import once: Kiro → Powers → Add Custom Power → Import from folder
→ ~/.deepseek-vl/plugin.
OpenClaw
1. Ask OpenClaw to install it
Install the plugin from https://github.com/limccn/deepseek-vl-support and enable it
2. Or install via npx
npx deepseek-vl-support@latest install --target openclaw
3. After install — restart the gateway, verify with openclaw plugins list.
Hermes Agent
1. Ask Hermes to install it
Install the plugin from https://github.com/limccn/deepseek-vl-support and enable it
2. Or install via npx
npx deepseek-vl-support@latest install --target hermes
3. After install — verify with hermes plugins list.
VS Code
1. Ask in a VS Code chat
Install the plugin from https://github.com/limccn/deepseek-vl-support and enable it
2. Or install via npx
npx deepseek-vl-support@latest install --target vscode
3. After install — reload the window.
ChatGPT & Codex
1. Ask ChatGPT or Codex to install it
Install the plugin from https://github.com/limccn/deepseek-vl-support and enable it
2. Or install via npx
npx deepseek-vl-support@latest install --target chatgpt-codex
3. After install — start a new Codex thread or ChatGPT session.
Grok Bot
1. Ask Grok to install it
Install the plugin from https://github.com/limccn/deepseek-vl-support and enable it
2. Or install via npx
npx deepseek-vl-support@latest install --target grok
3. After install — press r in the Plugins tab or start a new session.
NanoClaw
1. Ask NanoClaw to install it
Install the plugin from https://github.com/limccn/deepseek-vl-support and enable it
2. Or install via npx
npx deepseek-vl-support@latest install --target nanoclaw
3. After install — run ncl wirings create per the printed guidance.
Other agents (Agent Plugins open standard)
1. Ask Agent to install it
Install the plugin from https://github.com/limccn/deepseek-vl-support and enable it
2. Or install via npx
npx deepseek-vl-support@latest install --target other
Mixed setup — install for several agents at once
Any combination works, comma-separated:
npx deepseek-vl-support@latest install --target claude,copilot
Or all 10 plugin clients in one run:
npx deepseek-vl-support@latest install --target copilot,cursor,kiro,openclaw,hermes,vscode,chatgpt-codex,grok,nanoclaw,other
All supported agents at a glance:
| Agent | --target |
|---|---|
| Claude Code | claude |
| Codex | codex |
| OpenCode | opencode |
| Trae | trae |
| Pi Coding Agent | pi |
| Oh My Pi | omp |
| DeepSeek Harness | dsh |
| Qwen Code | qwen |
| Reasonix | reasonix |
| Kilo Code | kilo |
| WorkBuddy (CodeBuddy Code) | workbuddy |
| Devin | devin |
| GitHub Copilot | copilot |
| Cursor | cursor |
| Kiro | kiro |
| OpenClaw | openclaw |
| Hermes Agent | hermes |
| VS Code | vscode |
| ChatGPT & Codex | chatgpt-codex |
| Grok Bot | grok |
| NanoClaw | nanoclaw |
| Other agents | other |
Try it out
Fastest check — describe a picture directly in the terminal:
npx deepseek-vl-support@latest describe path/to/a/picture.png
A good text description comes back → everything is wired up. From then on, just read
pictures in your agent as usual — the description arrives automatically.
Choosing a vision service
The installer offers the same services as presets — no need to remember these URLs unless
you configure manually:
| Service | base URL | Example model |
|---|---|---|
| Moonshot | https://api.moonshot.cn/v1 |
moonshot-v1-32k-vision-preview |
| OpenRouter | https://openrouter.ai/api/v1 |
qwen/qwen2.5-vl-72b-instruct |
| MiniMax | https://api.minimaxi.com/v1 |
MiniMax-VL-01 |
| Zhipu GLM | https://open.bigmodel.cn/api/paas/v4 |
glm-4v-flash |
| StepFun | https://api.stepfun.com/v1 |
step-1o-turbo-vision |
| OpenCode Zen | https://opencode.ai/zen/v1 |
mimo-v2.5-free |
| SiliconFlow | https://api.siliconflow.cn/v1 |
Qwen/Qwen2.5-VL-72B-Instruct |
| DashScope | https://dashscope.aliyuncs.com/compatible-mode/v1 |
qwen-vl-max |
| Ollama (local) | http://localhost:11434/v1 |
qwen2.5vl:7b (run ollama pull qwen2.5vl:7b first) |
| llama.cpp (local) | http://localhost:8080/v1 |
llava (llama-server -m llava.gguf) |
| vLLM (local) | http://localhost:8000/v1 |
deepseek-ai/deepseek-vl2 |
| LM Studio (local) | http://localhost:1234/v1 |
qwen2.5-vl-7b-instruct |
Everyday commands
| What you want | Command |
|---|---|
| Install | npx deepseek-vl-support@latest install |
| Health check | npx deepseek-vl-support@latest doctor |
| Describe a picture now | npx deepseek-vl-support@latest describe picture.png |
| See current settings | npx deepseek-vl-support@latest config get |
| Change a setting | npx deepseek-vl-support@latest config set maxBytes 5242880 |
| Remove the tool | npx deepseek-vl-support@latest uninstall |
Changing settings
Your answers are saved in .deepseek-vl/config.json inside the project folder — usually
you never need to touch it. The two settings worth knowing:
| Setting | Meaning | Default |
|---|---|---|
maxBytes |
Pictures bigger than this are skipped (saves time and money) | 10485760 (10 MB) |
timeoutMs |
How long to wait for one description | 120000 (2 minutes) |
Example — skip pictures over 5 MB:
npx deepseek-vl-support@latest config set maxBytes 5242880
Describing the same picture twice is free: results are cached on your machine (64 MB
limit). Change the picture and it gets described again. Everything can also be set with
environment variables (VISION_MODEL, VISION_BASE_URL, …) — see
CLAUDE.md for the full reference.
Troubleshooting
| Symptom | What to do |
|---|---|
| The model still doesn't describe pictures | Restart the session (required after install), then run … doctor and look for [OK]. |
doctor says no model configured |
You chose Decide later during install. Configure a model now: config set model <id> (plus config set baseUrl <url> if not using the default). |
doctor shows "unreachable" / no [OK] |
The service address or key is wrong — check the base URL ends with /v1 and the API key is correct. |
| "image too large" hint | Compress or crop the picture (e.g. under 5 MB, long side ~2000 px), or raise the limit with config set maxBytes …. |
| Descriptions are slow | Lower the limit or switch to a faster service (see the table above). |
| Pasted (Ctrl+V) pictures are not described | Pasted images bypass the read path — save the picture as a file first, then read it (or use /vision / describe_image). |
More edge cases (Windows encoding, Codex-specific quirks, reasoning-model notes) live in
CLAUDE.md and docs/README.zh-CN.md.
Acknowledgements
This project was inspired by
pi-deepseek-vision — thanks to
psychobarge for the open-source work.
Contributing
Contributions are welcome — see CONTRIBUTING.md for how to report
issues and set up a development environment.
License
安装
装一次目录插件，之后本站所有插件都能让 DeepSeek Harness 自动找、自动装：
dsh plugin add dshbase-catalog然后对 agent 说「帮我装 deepseek-vl-support」，它会在目录里找到并自动安装。文档：dshbase-catalog · 已验证场景包。
该插件是 GitHub 源码（未发 npm）——直接从仓库装：
Web profile：
dsh plugin --profile web add github:limccn/deepseek-vl-supportHeadless（CLI）profile：
dsh plugin --profile headless add github:limccn/deepseek-vl-support实测报告
尚未 L3 验证——若已跑过，见下方失败备注。
分享徽章
把这枚徽章粘进 README——它会链回本页，实测状态变化时自动更新：
[](https://dshbase.com/zh/plugins/deepseek-vl-support/)<a href="https://dshbase.com/zh/plugins/deepseek-vl-support/"><img src="https://dshbase.com/badges/deepseek-vl-support.svg" alt="dshbase 已收录"></a>