前言¶
DeepSeek Harness (DSH) 默认的 DeepSeek adapter 声明模型纯文本，上传图片会被 MODEL_DOES_NOT_SUPPORT_IMAGES 拦截。sjakdhasdh/dsh-vision 插件旨在解决这一痛点，为 DSH 添加视觉识别能力。它支持本地图片路径、网络图片 URL，通过 OpenAI 兼容格式调用视觉大模型，默认使用阿里云百炼的 qwen3.7-flash 模型。
核心功能¶
- 输入支持：支持本地图片绝对路径（如
C:\a.png）或网络图片 URL。 - 厂商解耦：采用 OpenAI 兼容格式，不绑定特定厂商，默认使用阿里云百炼。
- 配置优先级：插件 config > 环境变量 > 默认值。
- 零依赖：零额外运行时依赖，仅使用 Node 内置
fetch。
安装与启用¶
在插件目录下执行以下命令即可完成安装：
dsh plugin --profile web add ./dsh-vision
执行命令后，重启 DSH，在新建会话中即可使用 vision 工具。
配置方式¶
插件支持通过环境变量或 profile 补丁层进行配置。
方式一：环境变量¶
在运行环境设置以下变量：
export DASHSCOPE_API_KEY=sk-xxx
export VISION_MODEL=qwen3.7-flash-2026-07-15
export DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
方式二：Profile 补丁层¶
在 ~/.dsh/profiles/<name>/cordis.patch.yml 中添加配置：
- id: dsh-vision
config:
apiKey: sk-xxx
model: qwen3.7-flash-2026-07-15
baseURL: https://dashscope.aliyuncs.com/compatible-mode/v1
使用说明¶
模型会自动调用 vision 工具。调用时需提供以下参数：
| 参数 | 必填 | 说明 |
|---|---|---|
image |
✅ | 本地图片绝对路径或 http(s) URL |
prompt |
❌ | 识别要求，默认为“请详细描述这张图片的内容” |
注意事项¶
- 模型限制：DeepSeek Harness 默认的 DeepSeek adapter 声明模型纯文本，上传图片会被拦截。
- 直接粘贴图片：要让用户能直接粘贴图片（图片块渲染为
[图片附件: sha256:...]标记），需要对dsh-llm-deepseek打一个小补丁（参见官方文档或社区讨论）。 - 许可证：该插件基于 MIT 许可证开源。
生态与资源¶
DSH 的理念是「一切皆插件」。该插件是社区开发者 sjakdhasdh 提供的独立项目，与 DeepSeek / 幻方无官方从属关系。
