xlight/deepseek-visionary
101Last commit Aug 14, 2026
deepseek-visionary DSH plugin
A Rust rewrite of the Python deepseek-vision-mcp project, providing a single native binary for multiple platforms. DSH users can install the @xlight-oss/visionary-dsh plugin to register 4 native tools, enabling image analysis without manual token setup.
How to install the deepseek-visionary DSH plugin
dsh plugin --profile web add @xlight-oss/visionary-dshCopying does not run this command. Review the repository and version before installing the deepseek-visionary DSH plugin.
deepseek-visionary DSH plugin data source
deepseek-visionary DSH plugin snapshot date: Aug 16, 2026
discovered
What the deepseek-visionary DSH plugin can do
- Browser auto-login (CDP-controlled Chrome/Chromium/Edge) to capture DeepSeek credentials
- CLI tool with vision, status, login, logout, skill install, init, doctor commands
- MCP stdio service for integration with Zed, OpenCode, Codex, Claude Code, Cursor, Claude Desktop
- DSH native plugin (@xlight-oss/visionary-dsh) registering deepseek_vision, deepseek_vision_status, deepseek_vision_login, deepseek_vision_logout
- Multi-turn conversation support with continue_conversation and session_id parameters
- Agent skill installation (CLI + skill) for zero-MCP-config usage in AI agents
Where the deepseek-visionary DSH plugin fits
- Call DeepSeek vision model directly from DSH via native tools in chat or workflows
- Add image analysis to MCP hosts like Zed, Cursor, or Claude Desktop
- Quickly analyze images from terminal or scripts using the visionary-server CLI
- Enable AI agents to describe images by installing the CLI skill
- Compare multiple images in a multi-turn conversation with the same session
Who the deepseek-visionary DSH plugin is for
- DSH users who want native vision capabilities without API keys
- AI agent developers using MCP-compatible hosts (Zed, Cursor, Codex, etc.)
- Developers who need scriptable image analysis with structured JSON output
- Users of DeepSeek's web model who want programmatic access
deepseek-visionary DSH plugin limitations
- Requires Chrome/Chromium/Edge installed for automatic browser login
- Depends on DeepSeek web backend; a valid DeepSeek account is needed
- Early-stage Rust rewrite; may have stability or edge-case issues
- visionary-server binary must be in PATH or specified via DEEPSEEK_VISIONARY_BIN for DSH plugin
- Browser auto-login only works on systems with a supported browser (macOS, Linux, Windows)
deepseek-visionary DSH plugin: from the repository README
Quoted from the xlight/deepseek-visionary README, the upstream source of the deepseek-visionary DSH plugin. Copyright remains with the original authors.
在任意支持 MCP 的 AI agent（Zed、OpenCode、Codex、Claude Code、Cursor、Claude Desktop）、DeepSeek Harness（DSH，原生插件或 skill + CLI）中使用 **DeepSeek 网页版的原生多模态视觉模型**，支持**浏览器自动登录**（无需手动复制 token）。 这是 Python 版 `deepseek-vision-mcp` 的 Rust 全量重写：单原生二进制，多平台分发。DSH 用户另有原生插件包 `@xlight-oss/visionary-dsh`（`dsh plugin` 一键安装，无需 API key）。 ## 架构 ```mermaid graph TD subgraph 宿主[任意 MCP 宿主] AG["Zed / OpenCode / Codex / Claude Code / Cursor / Claude Desktop"] AG -->|spawn 独立进程| SRV end subgraph DSH[DeepSeek Harness] DP["@xlight-oss/visionary-dsh 插件<br/>deepseek_vision 等 4 个原生工具"] DP -->|宿主进程 spawn| SRV end subgraph visionary-server 原生二进制 SRV["CLI + MCP stdio 服务<br/>vision / status / login / logout / skill / init / doctor<br/>mcp-stdio CLI"] CFG["~/.deepseek-visionary/config.json<br/>token + smidV2 + cf_clearance + 会话"] SRV --> CFG end SRV -->|HTTPS| DS["DeepSeek 网页后端"] SRV -->|CDP 启动 + 监听| BRO["Chrome 系浏览器<br/>仅登录时出现"] ``` - **visionary-server**：单二进制，默认 CLI 模式（`vision` / `status` / `login` / `logout` / `skill` / `init` / `doctor`），`mcp-stdio` 子命令显式启动 MCP stdio 服务；实现完整 vision 流水线（PoW → 上传 → fork → HIF 签名 → SSE 流式 completion）与 CDP 自
Read the full READMEThe repository declares no license. Check with the authors before using it.
deepseek-visionary DSH plugin questions
How do I install the DeepSeek Visionary plugin for DeepSeek Harness?
First install the visionary-server binary via curl, Homebrew, or npm. Then run `dsh plugin --profile web add @xlight-oss/visionary-dsh`. Restart DSH and the four native tools (deepseek_vision, etc.) will appear in the tool catalog. The binary must be in PATH or pointed to by DEEPSEEK_VISIONARY_BIN.
Do I need an API key to use DeepSeek Visionary?
No, you do not need an API key. The plugin uses your DeepSeek web account credentials obtained via browser auto-login. You just need to run `visionary-server login` once to authenticate, or use the deepseek_vision_login tool from DSH.
Can I use DeepSeek Visionary with Cursor or Zed?
Yes, after installing the visionary-server binary, run `visionary-server init cursor` or `visionary-server init zed` (or for Zed, install the extension from the marketplace). The tool exposes the deepseek_vision MCP tool in those hosts.
What if my browser doesn't open automatically during login?
The login command requires Chrome/Chromium/Edge installed on your system. If the browser doesn't open, check that one of these browsers is available. You can also manually copy your userToken from chat.deepseek.com DevTools → Local Storage and paste it into ~/.deepseek-visionary/config.json as user_token.
How do I update the plugin to the latest version?
Update the visionary-server binary (e.g., run the install script again or brew upgrade). Then refresh the DSH plugin by running `dsh plugin --profile web update @xlight-oss/visionary-dsh`. If you installed via npm, run `npm update -g @xlight-oss/visionary-server`.