DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。当主模型（如 deepseek-v4-flash）为纯文本模型时，在聊天框中拖入或粘贴图片会被系统以“模型不支持图片输入”为由阻断。dsh-sensenova-vision-aid 是一个非官方插件，旨在解决这一痛点。
插件简介¶
该插件由 modesthub 维护，开源协议为 MIT。它通过全局静默读图桥和显式工具调用两种方式，让纯文本主模型也能处理图片。它通过后台调用 SenseNova 视觉模型生成描述文本供主模型参考，同时保持用户界面始终显示原图。
核心功能¶
全局静默读图桥（默认开启）¶
插件在 agent/pre-step 钩子中拦截图片输入。图片会被发送到视觉链处理，生成 【视觉观察：...】 文本。主模型看到的是这段文本，而用户界面始终显示原图。
配置项 bridgeMode 支持三种模式：
* on：恒接管，默认模式。
* auto：主模型支持视觉时，让其直接看原图。
* off：关闭桥，仅使用工具。
全局工具¶
提供三个 MCP 兼容的全局工具：
* describe_image(image, prompt?)：描述单张图片。
* describe_images(images, prompt?)：批量描述多张图片。
* chat(text)：纯文本对话，用于验证 API Key 和端点连通性。
直连视觉链与故障转移¶
图片识别支持故障转移链路：
* sensenova-6.8-flash-lite → deepseek-flash → kimi-k3
首个成功的模型即返回结果。
凭据复用¶
默认开启 reuseFreeapiCredentials，自动复用 dsh-sensenova-freeapi 插件配置的凭据，无需手动配置第二把 Key。
安装与启用¶
使用官方命令安装：
dsh plugin --profile <name> add github:modesthub/dsh-sensenova-vision-aid
安装后，需要在 profile 重启后才能生效（bundle/patch 层不支持热加载）。
典型用法¶
1. 拖图直接对话¶
在纯文本模型（如 deepseek-v4-flash）的聊天框中拖入图片，不再提示“模型不支持图片输入”。发送后，主模型会收到【视觉观察：…】文本并基于此回答。
2. 显式调用工具¶
在 Prompt 中调用 describe_image 或 describe_images 进行图片分析。
3. 配置模式¶
在设置面板中调整 bridgeMode：
* 若需恒定接管图片处理，保持 on。
* 若主模型原生支持视觉，设置为 auto 以减轻视觉模型压力。
注意事项¶
- 依赖与重启：安装后必须重启 profile 才能生效。
- 推荐组合：推荐搭配
dsh-sensenova-freeapi使用，以获得免费额度池和凭据管理。 - 安全与权限：API Key 经 DSH 凭据服务存储，永不写入日志或回显明文。视觉模型只具备读图能力，无工具或执行权限。
- 仅模型可见替换：用户界面始终显示原图，模型只看到观察文本。
总结¶
该插件通过全局桥接和工具集，为纯文本主模型提供了统一的视觉处理能力，配合 dsh-sensenova-freeapi 可实现高效的图文协同。
