DeepSeek Harness 插件

dsh-image-describe

DeepSeek Harness 宿主插件:让不支持图片输入的纯文本主模型也能"看图"(describe_image 工具 + 图片标记替换)(英文原文)

跳到安装方式

来源信息

GitHub 仓库
sd1g1/dsh-image-describe
最近更新
2026年8月21日
分类
视觉与多模态
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/sd1g1/dsh-image-describe
插件名:dsh-image-describe
作者:sd1g1

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-image-describe

DeepSeek Harness 宿主插件:让不支持图片输入(纯文本)的主模型也能通过 describe_image 工具“看图”。

安装

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

配置

首次启动会自动创建 ~/.dsh/image-describe.json(路径遵循 $DSH_HOME)。模板把 vision.provider / vision.model 留空,此时插件休眠,不影响正常请求;填写视觉模型后保存即热生效,无需重启:

{
  "vision": { "provider": "my-vision-provider", "model": "vision-model" },
  "prompt": "请详细描述这张图片的内容",
  "maxTokens": 1500,
  "image": { "autoResize": true }
}
  • vision.provider / vision.model:必填;留空 = 休眠
  • prompt:可选,默认兜底指令
  • maxTokens:可选,默认 1500
  • image.autoResize:可选,默认 true。发送给视觉模型前沿用 pi-coding-agent 的图片处理方法:大图先缩到 2000x2000,再在 PNG/多档 JPEG 中选最小编码;处理失败时回退原图,不影响看图。设为 false 关闭

调用方式

describe_imageattachmentpath 二选一:

  • attachment:使用之前标记里出现过的 attachmentId,无需用户重新发送图片。插件会依次搜索当前会话的派生消息、完整事件日志(被压缩的历史仍可解析)以及当前已加载的其他会话。
  • path:直接描述本地图片文件(绝对路径,或相对会话 cwd 的相对路径;支持 png/jpeg/webp/gif)。插件通过宿主 fs 服务读取文件,再交给附件服务校验并转为视觉模型可读的引用;与 attachment 一样,描述前会按 image.autoResize 预处理。

验证

  • 给纯文本模型发送一张图片:请求会被替换为 attachmentId 标记,模型可调用 describe_image 获取图片描述;之后让模型直接凭该 attachmentId 再次调用,也应成功。
  • 让模型调用 describe_image({ path: "/绝对路径/图片.png" }),应返回该图片的描述。

卸载

npx @deepseek-ai/dsh plugin --profile web remove @local/dsh-image-describe