DeepSeek Harness 图片多模态描述插件 (`sd1g1/dsh-image-describe`)

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在开发智能体或进行模型推理时，常遇到主模型仅支持纯文本输入、无法直接处理图片的情况。sd1g1/dsh-image-describe 插件旨在解决这一痛点，它通过向模型注入 describe_image 工具，让纯文本模型具备“看图”和描述的能力。

插件介绍¶

该插件由用户 sd1g1 维护，采用 MIT 许可证。它是一个 DeepSeek Harness 宿主插件，主要功能是通过 describe_image 工具，让不支持图片输入（纯文本）的主模型支持图片输入。

核心功能¶

工具注入：提供 describe_image 工具，允许模型调用。
多输入方式：支持 attachmentId（引用会话中的图片）和本地文件路径两种输入方式。
自动缩放：支持图片自动缩放处理（autoResize）。
自动配置：首次启动自动创建配置文件。

安装与启用¶

通过 DSH 的插件管理命令安装。确保环境满足依赖要求（Node >= 20）。

npx @deepseek-ai/dsh plugin --profile web add github:sd1g1/dsh-image-describe

配置¶

首次启动插件会自动创建配置文件，路径遵循 $DSH_HOME（通常为 ~/.dsh/image-describe.json）。配置文件包含视觉模型的配置项。若不填写，插件将处于休眠状态。

默认配置模板如下：

{
  "vision": { "provider": "my-vision-provider", "model": "vision-model" },
  "prompt": "请详细描述这张图片的内容",
  "maxTokens": 1500,
  "image": { "autoResize": true }
}

配置项说明：
* vision.provider / vision.model：必填。留空则插件休眠，不影响正常请求。
* prompt：可选，默认为图片描述指令。
* maxTokens：可选，默认 1500。
* image.autoResize：可选，默认 true。开启后会对图片进行预处理。

典型用法¶

插件安装并配置完成后，主模型即可调用 describe_image 工具。

1. 使用本地图片路径：

describe_image({ path: '/绝对路径/图片.png' })

2. 使用会话中的附件 ID：

describe_image({ attachment: 'attachmentId' })

注意事项与适用场景¶

权限检查：插件以当前 DSH 进程的权限运行，安装前建议检查源码与许可证。
格式支持：支持 png、jpeg、webp、gif 格式的图片。
失败回退：处理失败时会自动回退原图，不影响基本看图功能。
必填项：必须配置 vision.provider 和 vision.model 才能激活插件。

总结¶

sd1g1/dsh-image-describe 插件为 DeepSeek Harness 提供了多模态描述能力，通过简单的配置和调用方式，扩展了纯文本模型的应用边界。

插件目录 | GitHub 仓库