How to use dsh-vision
Adds visual capabilities to plain-text DeepSeek: defaults to Doubao Web free channel, supports automatic fallback across multiple channels, and enables structured evidence memory reuse across conversation turns.
This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.
This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.
Quick start
dsh-vision
— source: plugin_wiki.wiki_content
Install & verify
dsh plugin --profile web add dsh-vision-web
Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.
— source: plugins.install
Key points
-
- id: vision
- 一次登录:在桥接用的 Chrome profile 里登录一次豆包,之后一直复用。
- Windows→WSL localhost 转发承载队列通信,无需改防火墙。
- 桥接以
bridge.mjs随仓库分发——在 DSH 旁边跑一次(node bridge.mjs),永久轮询。 - WSL 无法直连 Windows 端口,所以队列放在 WSL 侧、桥接从 Windows 侧主动轮询。
— source: plugin_wiki.readme_en (fallback readme_raw)
FAQ
Can I use it directly after installation?
The default channel is Doubao Web (zero cost, no API key required). For WSL environment, you need to run node bridge.mjs once on the Windows side, and log into Doubao in that opened Chrome, then you can paste images.
Can I use it without a Windows browser?
Yes, but you need to switch channels. Configure genlangKey (Gemini API) or cockpitKey (Cockpit reverse proxy), then change defaultChannel to the corresponding channel; Antigravity channel is only available when running that IDE.
Will asking about the same image repeatedly cause double charges or re-processing?
No. The plugin calculates the cache key based on image byte hash + prompt + gear + mode + region + model + channel + prompt version, and within the same process, the same request only recognizes the image once (src/vision-core.ts:124).
What's the maximum number of images I can upload at once?
Up to 8 images, single image not exceeding 8MB, total size not exceeding 32MB, HTTP request body not exceeding 48MB; OCR/region/compare modes have additional validation (src/index.ts:731,902-904,1004).
Why doesn't the web channel connect directly to Chrome on WSL?
WSL cannot actively connect to Windows ports by default, so the plugin opens a queue service on the WSL side (default 127.0.0.1:9340), and bridge.mjs on the Windows side actively polls and drives the logged-in Chrome (src/web-channels.ts:43, README.md:113-127).
How to uninstall?
The config file is at ~/.dsh/dsh-vision.json (read by loadOverrides); deleting this file clears local key/path overrides. The plugin itself can be uninstalled via dsh plugin --profile web remove dsh-vision-web (src/index.ts:109-122).
— source: plugin_wiki.faq_json
Compatibility
- DSH: >=0.1.0
- Node: >=20
— source: plugin_wiki.compatibility_json
Pitfalls
Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.
— source: general rule