前言¶
DeepSeek Harness (DSH) 默认不具备识图能力。这个插件允许接入本地已有的识图模型，使助手能够识别图片内容。数据仅发送至本地模型，不经过云端，适合注重隐私的场景。
核心功能¶
- local_vision 工具：读取本地图片，调用 OpenAI 兼容接口进行分析，返回文字描述。
- 图形化设置界面：无需修改配置文件，直接在设置页填入接口地址、模型名和 API Key。
- 数据不出本机：图片仅发送给本地运行的服务，保证隐私安全。
- OpenAI 兼容接口：支持标准接口，可接入 LM Studio、Ollama、vLLM 等本地服务。
安装与启用¶
使用官方命令安装：
dsh plugin --profile web add "github:TIPSONG/dsh-vision-api-localorweb#main"
安装后重启 Web 客户端生效。
配置方法¶
打开 设置 → 可接入识图模型 API，填入以下信息：
| 字段 | 说明 | 示例 |
|---|---|---|
| 接口地址 | OpenAI 兼容的 base URL | http://localhost:1234/v1 |
| 模型名 | 本地加载的模型 ID | gemma-4-e4b |
| API Key | 可选鉴权头，本地服务留空 | (空) |
若接口地址留空，识图功能将被禁用。
使用方式¶
- 启用识图：配置好接口地址和模型名后，保存设置。
- 提供图片：在对话中告诉助手图片路径，例如：
看看这张图：
C:\Users\me\Desktop\photo.png，描述一下内容 - 获取结果：助手会调用
local_vision工具读取图片，并返回描述文本。
注意事项¶
- 发图限制：拖拽或粘贴发图可能被拒绝，建议使用图片路径进行识图。
- 隐私安全：图片只发送给自己本地模型，不会上传至云端。
- 兼容模型：需确保本地服务提供 OpenAI 兼容的
/v1/chat/completions接口，且支持图片输入。
生态背景¶
DSH 采用插件化架构。此插件由社区贡献，与 DeepSeek 官方无从属关系。更多详情请访问 GitHub 或 社区目录。
