dsh-official-vision：直连 DeepSeek 官方视觉 API 的 DSH 插件

前言¶

DeepSeek Harness (DSH) 插件生态允许开发者扩展能力。当前市面上多数视觉插件通过桥接第三方模型（如 GLM、Gemini、InternVL）来实现多模态交互。本插件填补了这一空白，它直接对接 DeepSeek 官方视觉 API，注册 deepseek-v4-flash-vision-exp 路由，将图片流式传输至 api.deepseek.com，不经过任何中间模型。

这是什么¶

名称：dsh-official-vision
维护者：wilianyichen
分类：模型推理
定位：直连官方视觉 API 的 DSH 插件，注册官方多模态模型为 provider 路由。

核心功能¶

直连官方 API：图片直接送入 DeepSeek 官方接口，无第三方模型介入。
模型注册：自动注册 deepseek-v4-flash-vision-exp 路由。
格式支持：支持 JPEG、PNG、GIF、WebP 格式。
传输方式：
- Base64 内联（默认）：适用于本地图片，单图 ≤ 32MiB。
- Files API：适用于大图（> 32MiB），支持单图 ≤ 64MiB。
无图透传：纯文本请求时，自动透传至官方 deepseek 路由，无额外开销。

安装与启用¶

使用官方安装命令添加插件：

dsh plugin --profile web add dsh-official-vision

配置说明¶

在 DSH 的设置界面（插件 -> dsh-official-vision）或 profile 的 cordis.patch.yml 中配置以下项：

- id: dsh-official-vision
  name: 'dsh-official-vision'
  config:
    apiKeyEnv: DEEPSEEK_API_KEY      # 环境变量名，需提前配置
    baseURL: https://api.deepseek.com
    delegateProvider: deepseek       # 无图请求委托的路由
    detail: auto                     # low | high | original | auto
    maxImagesPerRequest: 600         # 单次请求最大图片数
    preferFilesApi: false            # true = 使用 Files API 处理大图

典型用法¶

在模型选择器中选择 DeepSeek-V4-Flash-Vision-Exp 路由。
直接将图片粘贴到输入框进行提问。

注意事项与限制¶

计费：图片按 token 计费，单张图片最多转 384 tokens，价格同 V4-Flash。
大小限制：
- 请求体 ≤ 48MiB
- Base64 模式单图 ≤ 32MiB
- Files API 模式单图 ≤ 64MiB
- 单请求最大图片数 ≤ 600
依赖要求：
- @deepseek-ai/cordis >= 4.0.1
- @deepseek-ai/dsh-invariants >= 0.1.0-rc.5
- @deepseek-ai/dsh-llm >= 0.1.0-rc.5

结尾¶

该插件解决了现有视觉插件依赖第三方模型的问题，提供了一条通往 DeepSeek 官方多模态能力的直接路径。源码与目录信息如下：
* 目录页：https://www.skillhub.cn/plugins/wilianyichen/dsh-official-vision
* GitHub：https://github.com/wilianyichen/dsh-official-vision