22-dsh-vision-bridge · DSH 视觉桥接

DSH 插件：本仓库已打上 dsh-plugin 标签，可在 DeepSeek Harness 官方插件发现页被检索到。

让 DeepSeek Harness（DSH） 里没有视觉能力的主模型（如 deepseek-v4-pro）能够"看图"：

1. 会话直接收图：用户在会话里发送图片不再被"模型不支持图片"拦截；
2. 消息保留图片：用户消息框显示图片缩略图，转换不在用户消息上发生；
3. 内部自动转文字：图片在模型请求组装层被自动交给视觉模型转成文字描述，主模型只收到文字；
4. 自觉看图工具：view_image 工具供模型在需要看图时自行调用（支持本地路径 / URL / data URL）。

快速开始（30 秒）

没装过 DeepSeek Harness？先看官方快速开始：

1. 准备一个视觉接口（网址 + 密钥），例如 OpenAI 官方：网址 https://api.openai.com/v1、模型 gpt-5.1、密钥环境变量 OPENAI_API_KEY（先 setx OPENAI_API_KEY "sk-..."）；

2. 运行安装脚本，带上接口参数：

   powershell -ExecutionPolicy Bypass -File install.ps1 -ApiBase https://api.openai.com/v1 -ApiKeyEnv OPENAI_API_KEY -VisionModel gpt-5.1
   

   没有参数也可以直接运行，脚本会逐步询问网址 / 模型名 / 密钥。

3. 重启 dsh web，在任意会话里发一张图片——消息框显示图片、模型能读出内容，即安装成功。

详细配置说明见下文"配置视觉接口（必做）"。

前置条件

• DeepSeek Harness 已安装且 dsh web 启动过至少一次（~/.dsh/profiles/web/ 存在）；
• 主模型走 dsh-llm-pi-ai 适配器（settings.yaml 里 llm-pi-ai.providers. 已配置），或 你愿意手工在 settings 里声明图片输入；
• 一个视觉接口（网址 + API 密钥）——本插件不内置任何服务商，必须显式配置，例如：
  • OpenAI 官方：https://api.openai.com/v1 + OPENAI_API_KEY；
  • xAI Grok：https://api.x.ai/v1 + XAI_API_KEY；
  • 任何 OpenAI 兼容 Responses API（本地网关、中转等）。

一键安装（推荐）

视觉接口是必做步骤：带参数直接写配置，不带参数会交互询问。

# OpenAI 官方（推荐方式：密钥走环境变量）
powershell -ExecutionPolicy Bypass -File install.ps1 -ApiBase https://api.openai.com/v1 -ApiKeyEnv OPENAI_API_KEY -VisionModel gpt-5.1

# xAI Grok
powershell -ExecutionPolicy Bypass -File install.ps1 -ApiBase https://api.x.ai/v1 -ApiKeyEnv XAI_API_KEY -VisionModel grok-4-fast

# 交互式：脚本逐步询问网址 / 模型名 / 密钥
powershell -ExecutionPolicy Bypass -File install.ps1

安装脚本依次完成：复制插件文件 → 在 profile 的 cordis.patch.yml 登记插件行 → 在 给主模型声明图片输入 → （参数或交互）→ 打 pi-ai 适配器补丁 → 自测。