前言¶
在 DSH 這類「一切皆插件」的插件體系裏，常見痛點是：DeepSeek 文本模型能讀文件，但不能直接看圖片。錯誤截圖、UI 稿、圖表如果只能靠人工轉述，效率低且容易失真。deepseek-vl-support 的思路是：不要求文本模型原生看圖，而是在它嘗試讀圖時，把圖片交給一個可選的視覺服務，再把文字描述回傳給模型。
這是什麼¶
limccn/deepseek-vl-support 是由 limccn 維護的 MIT 許可插件，npm 包名爲 @limccn/deepseek-vl-support。它把圖片讀取請求攔截下來，發送到所選的 OpenAI-compatible vision endpoint，再將結果以文本形式返回給模型。
核心功能¶
- 爲 DeepSeek 文本模型提供圖片理解路徑：當模型讀取圖片時，插件把圖片發往選定的視覺服務。
- 返回給模型的內容爲固定格式：
[Vision of screenshot.png]: <description>。 - 支持 OpenAI-compatible vision endpoints，包括 OpenRouter、SiliconFlow、DashScope、Ollama、llama.cpp、VLLM 和 LM Studio。
- 支持多個 agent，包括 Claude Code、Codex、DeepSeek Harness、Cursor、GitHub Copilot、VS Code、OpenCode 和 Trae。
- 提供一次性安裝嚮導、按 agent 安裝命令，以及
doctor檢查命令。 - 附帶
deepseek-visionskill，採用標準 Agent Skills 佈局。 - 對 DeepSeek Harness 通過 in-process bundle patch 提供支持。
安裝與啓用¶
先確認環境：
- Node.js 18 或更新版本。
- 一個視覺服務賬號和 API key。安裝器會詢問一次，只保存在本機。
在項目目錄運行安裝嚮導：
cd path/to/your/project
npx @limccn/deepseek-vl-support@latest install
安裝完成後，重啓會話。可選檢查：
npx @limccn/deepseek-vl-support@latest doctor # look for [OK]
按 agent 安裝¶
如果只需要給某個 agent 啓用，可使用對應命令。
Claude Code：
npx @limccn/deepseek-vl-support@latest install --target claude
Codex：
npx @limccn/deepseek-vl-support@latest install --target codex
DeepSeek Harness：
dsh plugin --profile web add @limccn/deepseek-vl-support@latest
其他安裝方式¶
如果只需要 deepseek-vision skill，可以使用 Agent Skills CLI：
npx skills add https://github.com/limccn/deepseek-vl-support
如果 agent 支持 Agent Plugins 標準，也可以在對話裏說：
Install the plugin from https://github.com/limccn/deepseek-vl-support and enable it
從 GitHub 安裝後，再用一次命令配置視覺 endpoint：
npx @limccn/deepseek-vl-support@latest install --target <your agent>
典型用法¶
安裝並重啓會話後，讓模型讀取一張圖片即可。工具會把視覺服務返回的描述交給模型，格式如下：
[Vision of screenshot.png]: <description>
模型隨後基於這段描述繼續回答。
從 0.2.x 遷移到 0.3.0¶
0.3.0 將 npm 包移動到 @limccn/deepseek-vl-support，併發布到 npmjs 和 GitHub Packages。CLI 命令、配置、緩存、skill 文件和標記保持不變；0.2.x 包保持凍結。
已有 0.2.x 時，可運行：
npx @limccn/deepseek-vl-support@latest install --update
然後檢查：
npx @limccn/deepseek-vl-support@latest doctor
適用場景與注意¶
適合在 DSH、Claude Code、Codex 等 agent 中使用 DeepSeek 文本模型，並需要理解錯誤截圖、UI 稿、圖表等圖片內容的場景。一次配置後，不需要額外維護模型設置或配置文件。
使用前建議：
- 確認所選視覺服務可用，API key 只用於本機存儲和調用。
- 在 DSH 中啓用時，插件以當前 dsh 進程權限運行；安裝前檢查源碼與 MIT 許可證。
- 安裝或遷移後重啓對應會話，再執行
doctor或實際讀圖驗證。
結尾¶
deepseek-vl-support 的價值在於：保留 DeepSeek 文本模型的工作流，同時通過外部視覺服務補上圖片理解。GitHub 倉庫地址爲 https://github.com/limccn/deepseek-vl-support ；在 DSH 社區目錄中可按倉庫名 limccn/deepseek-vl-support 檢索。
