Files
jackwener__opencli/docs/adapters/browser/deepseek.md
Benjamin Liu 094ff0da80 feat(deepseek): add vision mode support
* feat(deepseek): add vision mode support

DeepSeek added a third model "识图模式" (Vision Mode) that accepts
image uploads for visual understanding. Add vision to the --model
choices, update selectModel to use explicit index mapping for all
three models, skip the search toggle in vision mode (not available),
and extend waitForFilePreview to detect image thumbnails via send
button state since vision mode shows a preview image instead of a
filename label.

Also catch "Not allowed" errors from setFileInput (Cloudflare may
block CDP file operations) so the DataTransfer fallback can run.

Closes #1215

* fix(deepseek): harden vision upload mode

---------

Co-authored-by: jackwener <jakevingoo@gmail.com>
2026-05-01 20:03:01 +08:00

2.7 KiB

DeepSeek

Mode: Browser · Domain: chat.deepseek.com

Commands

Command Description
opencli deepseek ask <prompt> Send a prompt and get the response
opencli deepseek new Start a new conversation
opencli deepseek status Check login state and page availability
opencli deepseek read Read the current conversation
opencli deepseek history List conversation history from sidebar

Usage Examples

# Ask a question
opencli deepseek ask "explain quicksort in 3 sentences"

# Start a new chat before asking
opencli deepseek ask "hello" --new

# Use Expert model instead of Instant
opencli deepseek ask "prove that sqrt(2) is irrational" --model expert

# Use Vision model with an image
opencli deepseek ask "describe this image" --model vision --file ./image.png

# Enable DeepThink mode
opencli deepseek ask "prove that sqrt(2) is irrational" --think

# Enable web search
opencli deepseek ask "latest news about AI" --search

# Attach a file
opencli deepseek ask "summarize this document" --file ./report.pdf

# Combine modes
opencli deepseek ask "what happened today?" --model expert --think --search --new

# Custom timeout (default: 120s)
opencli deepseek ask "write a long essay" --timeout 180

# JSON output
opencli deepseek ask "hello" -f json

# Check login status
opencli deepseek status

# Start a fresh conversation
opencli deepseek new

# Read current conversation
opencli deepseek read

# List recent conversations
opencli deepseek history --limit 10

Options (ask)

Option Description
<prompt> The message to send (required, positional)
--timeout Wait timeout in seconds (default: 120)
--new Start a new chat before sending (default: false)
--model Model to use: instant, expert, or vision (default: instant)
--think Enable DeepThink mode (default: false)
--search Enable web search (default: false)
--file Attach a file (PDF, image, text) with the prompt (max 100 MB)

Prerequisites

Caveats

  • This adapter drives the DeepSeek web UI in the browser, not an API
  • Default mode is Instant with DeepThink and Search disabled; each flag (--model, --think, --search) is synced on every invocation so omitting a flag resets it
  • Vision mode does not support --search; use --model instant or --model expert for web search
  • Long responses (code, essays) may need a higher --timeout
  • File upload prefers the browser file-input path, falls back to base64 injection when needed, and rejects files over 100 MB